ernilambar/gitvise

WordPress plugin updater from GitHub releases

1.0.0 2026-02-24 12:10 UTC

Requires

• php: >=7.4

Requires (Dev)

• phpunit/phpunit: ^9.0 || ^10.0
• squizlabs/php_codesniffer: ^3.0
• wp-coding-standards/wpcs: ^3.0

MIT

README

WordPress PHP library for plugin updates from GitHub releases: uses the latest release tag as the version and the release ZIP (or zipball) as the package.

Requirements: PHP 7.4+, WordPress 5.0+

Installation

composer require ernilambar/gitvise

In your plugin, load the library via its entry point:

require_once __DIR__ . '/vendor/ernilambar/gitvise/init.php';

Usage

use Nilambar\Gitvise\Updater;

$updater = new Updater( 'your-github-user/your-repo-name', __FILE__ );
$updater->init();

Optional: Third argument = custom update slug (when plugin dir name differs from desired slug). Fourth argument = GitHub personal access token (for higher API rate limit).

$updater = new Updater( 'user/repo', __FILE__, 'repo-slug', 'ghp_your_token' );
$updater->init();

How it works

On each update check, the library fetches the latest release from the GitHub API, compares the tag (e.g. v1.2.3 → 1.2.3) with the installed version from WordPress’s transient, and populates the update with the first ZIP asset or the zipball URL. The plugins_api filter is handled so “View details” shows release info.

License

MIT. See LICENSE.