Title: WP GitHub Tools
Author: vilmosioo
Published: <strong>février 24, 2013</strong>
Last modified: août 11, 2016

---

Search plugins

![](https://ps.w.org/wp-github-tools/assets/banner-772x250.png?rev=672718)

This plugin **hasn’t been tested with the latest 3 major releases of WordPress**.
It may no longer be maintained or supported and may have compatibility issues when
used with more recent versions of WordPress.

![](https://s.w.org/plugins/geopattern-icon/wp-github-tools_1f1f1f.svg)

# WP GitHub Tools

 By [vilmosioo](https://profiles.wordpress.org/vilmosioo/)

[Download](https://downloads.wordpress.org/plugin/wp-github-tools.1.4.4.zip)

 * [Details](https://tah.wordpress.org/plugins/wp-github-tools/#description)
 * [Reviews](https://tah.wordpress.org/plugins/wp-github-tools/#reviews)
 *  [Installation](https://tah.wordpress.org/plugins/wp-github-tools/#installation)
 * [Development](https://tah.wordpress.org/plugins/wp-github-tools/#developers)

 [Support](https://wordpress.org/support/plugin/wp-github-tools/)

## Description

Use the custom GitHub Commit widget to display a list of the latest updates from
a repository. Additionally, you can use shortcodes to add commit lists or embed 
any gist.
 The plugin will cache the GitHub response for a certain time period. 
You can change this value to any wordpress schedules you have isntalled (default:
hourly, half-day, daily). To get more time frames you will need an additional plugin
that extends the cron schedules.

#### Shortcodes

**[gist id=’_gist\_id_‘ ]**

Embeds a gist in your post. Parameters:

 * _id_ (required) The id of the gist you want to embed.

**[commits repository=’your-repository’ count=’max-count’ title=’your-title’]**

Displays the latest commits from your repository. Parameters:

 * _repository_ (required) The name of the repository you wish to get.
 * _count_ (optional) The number of commits to retrieve (order by date). Default:
   5
 * _title_ (optional) A title to display before the list (_h2_). Default: none

**[releases repository=’your-repository’ count=’max-count’ title=’your-title’]**

Displays the latest releases from your repository. Parameters:

 * _repository_ (required) The name of the repository you wish to get.
 * _count_ (optional) The number of releases to retrieve (order by date). Default:
   5
 * _title_ (optional) A title to display before the list (_h2_). Default: none

**[chart repository=’your-repository’ width=’chart-width’ height=’chart-height’ 
class=’additional-css-classes’ color=’bar-color’ background=’chart-background’ count
=’commit-count’ title=’your-title’]**

Displays an activity chart for the given repository. Parameters:

 * _repository_ (required) The name of the repository you wish to get.
 * _width_ (optional) The width of the chart. Default: auto
 * _height_ (optional) The height of the chart. Default: auto
 * _class_ (optional) Additional CSS classes to add to the chart element. Default:»
 * _color_ (optional) The chart bar colors. Must be a valid color string (rgb, hex
   or name). Default: ‘#f17f49’
 * _background_ (optional) The chart background color. Must be a valid color string(
   rgb, hex or name). Default: ‘transparent’
 * _count_ (optional) The number of commits to retrieve (order by date). Default:
   30
 * _title_ (optional) A title to display before the list (_h2_). Default: none

#### PHP functions

Feel free to use the Gihub helper class in your theme or plugin development.

    ```
    <?php WP_Github_Tools_API::get_repos($user, $access_token); ?>

    <?php WP_Github_Tools_API::get_user($user, $access_token); ?>

    <?php WP_Github_Tools_API::get_commits($repo, $user, $access_token); ?>

    <?php WP_Github_Tools_API::get_releases($repo, $user, $access_token); ?>

    <?php WP_Github_Tools_API::get_gists($user, $access_token); ?>
    ```

#### Contribute!

If you have suggestions for a new add-on, feel free to contact me on [Twitter](http://twitter.com/vilmosioo).
Alternatively, you can fork the plugin from [Gihub](https://github.com/vilmosioo/Github-Tools-for-WordPress)

## Screenshots

 * [[
 * Commits shortcode in action. An un-onrdered list of the latest commits is displayed,
   that you can style as you please using CSS.
 * [[
 * The settings page once you are connected to Github.
 * [[
 * The commits widget that you can use on any sidebar to deliver live updates for
   your projects.
 * [[
 * The cache preview system. You can manually refresh the cached data and you can
   view examples for the commits shortcode.
 * [[
 * The chart preview system. Currently in beta.

## Installation

 1. Download the plugin files and upload them to your `/wp-content/plugins/` directory
 2.  a. Activate the plugin through the ‘Plugins’ menu in WordPress
     b. Create a Github application (make sure the redirect url points back to the github
        tools settings page)
     c. Add your client ID and secret
     d. Connect to Github
     e. Ready to go!

## FAQ

Send any questions directly to [me](http://twitter.com/vilmosioo)!

## Reviews

There are no reviews for this plugin.

## Contributors & Developers

“WP GitHub Tools” is open source software. The following people have contributed
to this plugin.

Contributors

 *   [ vilmosioo ](https://profiles.wordpress.org/vilmosioo/)

[Translate “WP GitHub Tools” into your language.](https://translate.wordpress.org/projects/wp-plugins/wp-github-tools)

### Interested in development?

[Browse the code](https://plugins.trac.wordpress.org/browser/wp-github-tools/), 
check out the [SVN repository](https://plugins.svn.wordpress.org/wp-github-tools/),
or subscribe to the [development log](https://plugins.trac.wordpress.org/log/wp-github-tools/)
by [RSS](https://plugins.trac.wordpress.org/log/wp-github-tools/?limit=100&mode=stop_on_copy&format=rss).

## Changelog

#### 1.4

 * Provides access to private repos. Current users will need to re-authorize their
   repository.
 * Markdown-formatted release notes are rendered into HTML.

#### 1.3

 * Added custom widget to display repository releases.
 * Implemented custom shortcode to display repository releases.

#### 1.2

 * Added Chart functionality (beta) that allows users to display their commit activity
   using a graph.
 * Enabled automatic build to deliver updates more quickly.
 * Minifying assets for greater performance.

#### 1.1

 * Using OAuth to connect to Github
 * Improved settings page
 * Better caching system

#### 1.0

 * Added custom widget to display repository commits.
 * Implemented custom shortcode to display repository commits.
 * Implemented custom shortcode to embed gists.
 * Customizable cache system.
 * Live validation of GitHub usernames.

## Meta

 *  Version **1.4.4**
 *  Last updated **10 années ago**
 *  Active installations **10+**
 *  WordPress version ** 3.3 or higher **
 *  Tested up to **4.5.33**
 *  Language
 * [English (US)](https://wordpress.org/plugins/wp-github-tools/)
 * Tags
 * [commit](https://tah.wordpress.org/plugins/tags/commit/)[Github](https://tah.wordpress.org/plugins/tags/github/)
   [repository](https://tah.wordpress.org/plugins/tags/repository/)[tool](https://tah.wordpress.org/plugins/tags/tool/)
   [widget](https://tah.wordpress.org/plugins/tags/widget/)
 *  [Advanced View](https://tah.wordpress.org/plugins/wp-github-tools/advanced/)

## Ratings

No reviews have been submitted yet.

[Add my review](https://wordpress.org/support/plugin/wp-github-tools/reviews/#new-post)

[See all reviews](https://wordpress.org/support/plugin/wp-github-tools/reviews/)

## Contributors

 *   [ vilmosioo ](https://profiles.wordpress.org/vilmosioo/)

## Support

Got something to say? Need help?

 [View support forum](https://wordpress.org/support/plugin/wp-github-tools/)

## Donate

Would you like to support the advancement of this plugin?

 [ Donate to this plugin ](https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=4K8F8YQMP84CJ)