Skip to content

WordPress.org Directory

Andy Fragen edited this page Nov 9, 2018 · 8 revisions

This plugin is not allowed in the wp.org repo. :frowning:

Hosting Plugin in WP.org Directory

If you develop your plugin or theme on GitHub and it also resides in the WP.org repo, the plugin or theme will preferentially pull updates from WP.org if branch is master. If the current branch is anything other than master then the update will pull from GitHub or other git server.

This presumes that the repository slug and the WP.org slug are identical.

The same applies for Bitbucket, GitLab or other git server hosted plugins.

Overriding WP.org Directory Updates

Rarely there is a plugin or theme on the WP.org directory that has an identical slug to a plugin or theme you are developing. Under normal circumstances if the version number of the plugin on WP.org is higher; GitHub Updater will update from the higher version number. This will cause your plugin or theme to be overwritten by the plugin or theme on WP.org.

There's a filter hook to set which plugins or themes should override WP.org for updating. This filter hook mitigates that potential conflict.

The filter hook github_updater_override_dot_org provides a method of returning an array of plugin/theme data to override dot org. It should return an array.

add_filter( 'github_updater_override_dot_org', function() {
    return [ 
        'the-events-calendar-category-colors/the-events-calendar-category-colors.php', //plugin format
        'my-popular-theme' // theme slug
    ];
});
You can’t perform that action at this time.