GitHub Updater

What it does:

Allows me to push changes of plugins installed on client websites.

How to use:

  • Install plugin
  • Install a plugin that you want to push updates to, if not already installed
  • Click on the Bitbucket tab > Enter your Bitbucket Username and Password
  • You should see all plugins listed below Bitbucket Private Repositories
  • Check off all listed. If you are missing a plugin in this list, your plugin is not created correctly (see How to structure themes and plugins below)
  • If listed, now plugins should show updates available when you edit the version number in the main file and push to master

How to structure themes and plugins

See: Social Posts Plugin for a working example

Naming Conventions

Folder/Directory slugs and plugin/theme slugs must be identical. The main plugin file or theme style.css file may not be in a subfolder. It must be in the root of the directory.

Example for naming conventions

As an example, if the repository for plugin you want to install and update with the GitHub Updater is located at https://github.com/user/good-plugin, its directory and file structure should look something like this:

├── good-plugin.php
├── readme.txt
├── README.md
├── CHANGES.md
├── includes
|    ├── ...
|    └── queries.php
├── ...
└── ...

Plugins

There must be a GitHub Plugin URIBitbucket Plugin URIGitLab Plugin URI, or Gitea Plugin URI declaration in the plugin’s header.

/**
 Plugin Name:          Plugin Social Posts
 Plugin URI:           https://bitbucket.org/cj3wilso/plugin-social_posts
 Description:          Demonstrates how to write custom administration pages in WordPress.
 Version:              1.0.0
 Author:               Christine Wilson
 Text Domain:          plugin-social-posts
 Bitbucket Plugin URI: https://bitbucket.org/cj3wilso/plugin-social_posts
 */ 

Themes

There must be a GitHub Theme URIBitbucket Theme URIGitLab Theme URI, or Gitea Theme URI declaration in the style.css file. When initially adding a theme, the directory must be identical to the repo name.

/**
 * Theme Name:          SouthLake
 * Version:             1.0.0
 * Description:         Child theme of framework.
 * Author:              Christine Wilson
 * Author URI:          https://christinewilson.ca
 * Template:            framework
 * Bitbucket Theme URI: https://bitbucket.org/cj3wilso/southlake
 */

Bitbucket Support

Instead of the GitHub Plugin URI header you will need to use the Bitbucket Plugin URI header.

Instead of the GitHub Theme URI header you will need to use the Bitbucket Theme URI header.