Pipeline is a Wordpress plugin which allows you to create a customizable 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've 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+

Installation

Install the plugin on a Wordpress site using any of the following methods.

• [COMING SOON:] Use the Wordpress plugin interface to search for the plugin in the plugin library.
• Fork and/or Clone the repo from here and to run composer install to get the dependencies. This is ideal if you plan to contribute.

Quick Start

1. Activate the plugin
2. Add your GitHub repository information to the plugin settings page under Settings > gitHub.
3. If the GitHub repository is private,
4. In the repository settings page, Register an application
5. Copy the Client ID and Client Secret into the plugin settings page. Click the button to "Authorize Github."
6. Add shortcodes to pages to start presenting gitHub information

Shortcodes

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

Pagination

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 pages length is 50 (this is a quirk of the GitHub API).

Hooks

• Filter: github_issues_list receives the list of issues returned by [gh_issues]. Currently it only applies when per_page attribute is not used.

Tips

• 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 PHP GitHub API by KNP Labs

TODO:

• Finish tests
• Make CSS include optional
• View issue comments
• Delete options on uninstall hook
• Allow GitHub users to authenticate as themselves
• Allow users to make comments