The [github-repo-list] shortcode pulls a list of your repositories from GitHub and displays them in a page friendly manner. The shortcode supports the following attributes.
| username |
Required Your github username, used to pull your repositories. No default. |
|---|---|
| order |
The repository detail to sort by (more details on repository detail below). Default: name |
| title_wrapper |
The tag that you want to wrap the repository titles with, just the tag, the rest of the formatting and classes are automatically added. Default: h2 |
| link_target |
The target that will be given to the repository links. Default: _blank |
| strip_name_dashes |
Wether or not to string the dashes from repository names, can be either true or anything else for false. Default: true |
| filtered_repos |
A comma seperated list of repositories to be filtered out regardless of other settings, use the official GitHub name. Default: none |
In addition to these settings you can filter against any repository detail except owner. A full list of details can be viewed by accessing the the API feed from https://api.github.com/users/{{your_username_here}}/repos. The only default repository attribute filter is fork="false", this can be overridden by passing a blank to the fork attribute.
An example of a propert shortcode might look something like this: [github-repo-list username="pgooch" title_wrapper="h4" ], which is very similar to the one I use on my site and pulls a list of all my repositories (except forks of other peoples) and wraps the title in an h4 tag instead of the default h2 tag.
| Having trouble getting the plug-in working? Expected results? Feel like direction your repentant rage at someone far far away? Just have a general usage question? You can try the plug-ins support form or, if you want an answer from the source, feel free to email me at phillip.gooch@gmail.com. | |
| Want to see how it all works, you can check out the on the WordPress SVN or, even better, fork it on GitHub. Feel free to make changes and submit pull requests, good ideas will be added to the master branch. | |
| Donate | Like the plug-in and want to support further development? Thanks, thats just awesome! Consider buying me a coffee to support further open source development or if you're looking to get some work done yourself get in touch and we'll talk code. |