WordPress <--> GitHub Sync

A WordPress plugin to sync content with a GitHub repository (or Jekyll site)

Ever wish you could collaboratively author content for you WordPress site (or expose change history publicly and accept pull requests from your readers)?

Looking to tinker with Jekyll, but wish you could use WordPress's best-of-breed web editing interface instead of Atom? (gasp!)

Well, now you can! Introducing WordPress <--> GitHub Sync! ✨

1. Allows content publishers to version their content in GitHub, exposing "who made what change when" to readers

2. Allows readers to submit proposed improvements to WordPress-served content via GitHub's Pull Request model

3. Allows non-technical writers to draft and edit a Jekyll site in WordPress's best-of-breed editing interface

• Allow teams to collaboratively write and edit posts using GitHub (e.g., pull requests, issues, comments)

• Allow you to sync the content of two different WordPress installations via GitHub

• Allow you to stage and preview content before "deploying" to your production server

The sync action is based on two hooks:

1. A per-post sync fired in response to WordPress's save_post hook which pushes content to GitHub

2. A sync of all changed files trigged by GitHub's push webhook (outbound API call)

⚠️ Still a work in progress, but we'd love your help making it better. ⚠️

1. Install the plugin and activate it via WordPress's plugin settings page
2. Create a personal oauth token with the public_repo scope (you can also create a bot account for this, if you'd prefer)
3. Configure your GitHub host, repository, secret, and OAuth Token on the WordPress <--> GitHub sync settings page within WordPress's administrative interface
4. Create a WebHook within you repository with the provided callback URL and callback secret

Found a bug? Want to take a stab at one of the open issues? We'd love your help!

See the contributing documentation for details.

• WordPress Post Forking
• WordPress to Jekyll exporter
• Writing in public, syncing with GitHub