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.⌉⌊Commits shortcode in action. An un-
onrdered list of the latest commits is displayed, that you can style as you please
using CSS.⌉[

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 settings page once you
are connected to Github.⌉[

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 commits widget that you can use on any sidebar to deliver live
updates for your projects.⌉[

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 cache preview system. You can manually
refresh the cached data and you can view examples for the commits shortcode.⌉[

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.⌉⌊The chart preview system. Currently
in beta.⌉[

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)