Pipeline is a Wordpress plugin which allows you to create a dashboard for your gitHub project. The intended use case for this tool is to provide an intuitive interface for non-technical members of the team. It is not intended to be a SCRUM board, or a full-featured project management tool. The name Pipeline refers to the fact that we make it easy to "pipe in" information from gitHub. Which information you pipe in, and how you present it, is entirely up to you.
Requirements:
- A GitHub repository (private or public)
- A working Wordpress installation (docs here) using PHP 5.5+
快速开始
- Activate the plugin
- Add your GitHub repository information to the plugin settings page under Settings > gitHub.
- If the GitHub repository is private,
- In the repository settings page, Register an application
- Copy the Client ID and Client Secret into the plugin settings page. Click the button to "Authorize Github."
- Add shortcodes to pages to start presenting gitHub information
短码
[gh_issues labels="foo,bar" state="all|OPEN|closed" per_page="NULL|#" show_body="FALSE|true|toggle" ]
[gh_milestones state="OPEN|closed|all"] sort="DUE_ON|completeness" direction="ASC|desc"
[gh_searchform labels="foo,bar" state="ALL|open|closed"]
NOTE: The GitHub API only allows 10 unauthenticated requests pre minute to the search API. If you register an app (required for private repositories) the limit is increased to 30 requests per minute.
You can also use
[gh_searchform]
in combination with
[gh_issues]
. The issues will appear on the page until the user enters a search, then the page will display the results from the search.
分页
By default, issues will not be paginated and all results will appear on a single screen. This can be cumbersome if there are a lot of screens. The optional
per_page=n
attribute will cause the results to be paginated into groups of
n
issues. The maximum size page length is 50 (this is a quirk of the GitHub API).
小提示
- Wordpress offers many ways to manage access/privacy. But If you are setting up a tool for internal use by your team only, a plugin like Private Only may come in handy.
Acknowlegements.
This tool wraps the lovely
PHP GitHub API by KNP Labs