Title: WP GitHub Tools
Author: vilmosioo
Published: <strong>2013 年 2 月 24 日</strong>
Last modified: 2016 年 8 月 11 日

---

搜索插件

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

**该插件尚未通过WordPress的最新3个主要版本进行测试**。 当与较新版本的WordPress一起
使用时，可能不再受到维护或支持，并且可能会存在兼容性问题。

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

# WP GitHub Tools

 作者：[vilmosioo](https://profiles.wordpress.org/vilmosioo/)

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

 * [详情](https://cn.wordpress.org/plugins/wp-github-tools/#description)
 * [评价](https://cn.wordpress.org/plugins/wp-github-tools/#reviews)
 *  [安装](https://cn.wordpress.org/plugins/wp-github-tools/#installation)
 * [开发进展](https://cn.wordpress.org/plugins/wp-github-tools/#developers)

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

## 描述

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)

## 屏幕截图

 * [[
 * 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.

## 安装

 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!

## 常见问题

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

## 评价

此插件暂无评价。

## 贡献者及开发者

「WP GitHub Tools」是开源软件。 以下人员对此插件做出了贡献。

贡献者

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

[帮助将「WP GitHub Tools」翻译成简体中文。](https://translate.wordpress.org/projects/wp-plugins/wp-github-tools)

### 对开发感兴趣吗?

您可以[浏览代码](https://plugins.trac.wordpress.org/browser/wp-github-tools/)，查看
[SVN仓库](https://plugins.svn.wordpress.org/wp-github-tools/)，或通过[RSS](https://plugins.trac.wordpress.org/log/wp-github-tools/?limit=100&mode=stop_on_copy&format=rss)
订阅[开发日志](https://plugins.trac.wordpress.org/log/wp-github-tools/)。

## 更新日志

#### 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.

## 额外信息

 *  版本 **1.4.4**
 *  最后更新：**10 年前**
 *  活跃安装数量 **10+**
 *  WordPress 版本 ** 3.3 或更高版本 **
 *  已测试的最高版本为 **4.5.33**
 *  语言
 * [English (US)](https://wordpress.org/plugins/wp-github-tools/)
 * 标签
 * [commit](https://cn.wordpress.org/plugins/tags/commit/)[Github](https://cn.wordpress.org/plugins/tags/github/)
   [repository](https://cn.wordpress.org/plugins/tags/repository/)[tool](https://cn.wordpress.org/plugins/tags/tool/)
   [widget](https://cn.wordpress.org/plugins/tags/widget/)
 *  [高级视图](https://cn.wordpress.org/plugins/wp-github-tools/advanced/)

## 评级

尚未提交反馈。

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

[查看全部评论](https://wordpress.org/support/plugin/wp-github-tools/reviews/)

## 贡献者

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

## 支持

有话要说吗？是否需要帮助？

 [查看支持论坛](https://wordpress.org/support/plugin/wp-github-tools/)

## 捐助

您愿意支持这个插件的发展吗?

 [ 捐助此插件 ](https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=4K8F8YQMP84CJ)