How Can We Help?
WordPress.org Directory
This plugin is not allowed in the wp.org repo. 😔
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
or the Primary Branch. 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; Git 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 gu_override_dot_org
provides a method of returning an array of plugin/theme data to override dot org. It must return an array.
add_filter(
'gu_override_dot_org',
function( $overrides ) {
return array_merge(
$overrides,
array(
'the-events-calendar-category-colors/the-events-calendar-category-colors.php', // plugin format
'my-popular-theme', // theme slug
)
);
}
);
You may want to use a standalone plugin to add these overrides as this will continue to work even if the plugin requiring the override is deactivated. This standalone plugin can be a mu-plugin.
If you want to override dot org completely thereby updating completely from the git host, ie GitHub, you may use the following hook. If you have set the gu_api_domain
hook, then this will be overridden.
add_filter( 'gu_ignore_dot_org', '__return_true' );
The default return is false
.
If you are running WP 5.8 or later you may add the Update URI
header to avoid seeing updates from WP.org.