2026年6月17日

Git UpdaterでGitHubのWordPressプラグインを更新する方法（ヘッダー・タグ・非公開リポジトリ）

プラグイン関連

Git Updater は、GitHub などの Git ホスティングに置いたプラグインやテーマを、WordPress の通常の更新の仕組みで更新できるようにするプラグインです。WordPress.org のディレクトリに出していない自作プラグインや、クライアント向けに作ったテーマを、他のプラグインと同じように「更新」画面から更新できます。

この記事では、Git Updater の導入から、リポジトリ側の準備、新しいバージョンの出し方、非公開リポジトリの扱いまでを説明します。内容は Git Updater 14.5.0（2026年11月時点）と公式のナレッジベースで確認しています。

Git Updater でできること・できないこと

最初に役割を整理します。

できること: プラグインのヘッダーに書いたリポジトリを確認し、新しいバージョンがあれば WordPress の「ダッシュボード」→「更新」やプラグイン一覧に更新を表示する。更新は通常のプラグインと同じ操作で行え、WP-CLI の wp plugin update でも更新できる
できないこと: サイトのファイルを Git リポジトリにしたり、サイト側の変更をコミット・プッシュしたりはしない。あくまで「リポジトリから配布物を受け取る側」の道具

対応するホスティングは、本体だけで GitHub、別途の API プラグイン（アドオン）を入れると Bitbucket・GitLab・Gitea・Gist です。アドオンは Git Updater の設定画面の「Add-Ons」タブから入れられます。

Git Updater 14.5.0 の動作要件は WordPress 5.9 以上、PHP 8.0 以上です（プラグインのヘッダーの記載、2026年11月時点）。

手順1：Git Updater をインストールする

Git Updater は WordPress.org のプラグインディレクトリにはありません。配布元の GitHub から入手します。

管理画面から入れる場合は、次の手順です。

GitHub の最新リリース（https://github.com/afragen/git-updater/releases/latest）から ZIP をダウンロードする
「プラグイン」→「プラグインを追加」→「プラグインのアップロード」で ZIP をアップロードする
「有効化」を押す

手作業で置く場合は、展開したフォルダーを git-updater という名前で wp-content/plugins/ に置きます。

WP-CLI では、公式に案内されている次のコマンドで入れられます。

wp plugin install --activate https://github.com/afragen/git-updater/archive/master.zip

有効化すると、「設定」→「Git Updater」に設定画面が追加されます（マルチサイトではネットワーク管理の「設定」の下）。

手順2：リポジトリ側にヘッダーを書く

Git Updater に管理させたいプラグインは、メインの PHP ファイルのヘッダーに GitHub Plugin URI を追加します。テーマの場合は style.css に GitHub Theme URI を書きます。

<?php
/**
 * Plugin Name:       My Custom Plugin
 * Description:       自社サイト用の機能をまとめたプラグイン
 * Version:           1.2.0
 * Requires at least: 6.5
 * Requires PHP:      8.1
 * GitHub Plugin URI: https://github.com/your-account/my-custom-plugin
 * Primary Branch:    main
 */

各ヘッダーの意味は次のとおりです。

ヘッダー	必須	内容
`Version`	必須	現在のバージョン。リモートの値がローカルより大きいときに更新が表示される
`GitHub Plugin URI`	必須	`https://github.com/所有者/リポジトリ名` の形。末尾に `.git` を付けない
`Primary Branch`	主ブランチが `master` 以外なら必須	GitHub の既定の `main` を使っているなら `main` と書く。無いと確認時にエラーになる
`Release Asset`	任意	`true` にすると、リリースに添付した ZIP を配布物として使う

Primary Branch は書き忘れが多い項目です。GitHub で新しく作ったリポジトリの既定のブランチは main なので、多くの場合は必要になります。

手順3：新しいバージョンを出す

Git Updater は既定で主ブランチを見ますが、タグがあれば最新のタグを更新の配布物として使います。運用では、次のように「ヘッダーの Version を上げる→同じ番号のタグを付ける」をセットにします。

# メインの PHP ファイルの Version を 1.2.1 に書き換えたあと
git add my-custom-plugin.php
git commit -m "Release 1.2.1"
git tag 1.2.1
git push origin main
git push origin 1.2.1

タグ名はヘッダーの Version と同じ文字列にします。主ブランチ以外のブランチではタグは無視され、そのブランチの最新のコミットが使われます。

サイト側では、Git Updater が定期的にリポジトリを確認し、更新があれば「ダッシュボード」→「更新」に表示されます。すぐに確認したいときは、Git Updater の設定画面の「Refresh Cache」を押すか、次のコマンドでキャッシュを消します。

wp git-updater cache delete
wp plugin list --fields=name,version,update,update_version

update の列が available になれば、通常どおり管理画面か wp plugin update my-custom-plugin で更新できます。

ビルドが必要なプラグインの場合

Composer の vendor や、ビルドした JavaScript・CSS をリポジトリに含めていない場合、リポジトリをそのまま ZIP にした配布物では動きません。その場合は、ビルド済みの ZIP をリリースに添付し、ヘッダーに Release Asset: true を書きます。リリースはタグ付きである必要があり、添付ファイルが複数あるときは リポジトリ名-*.zip の形の名前にします。

リポジトリからプラグインを新しく入れる

まだサイトに無いプラグインは、Git Updater の設定画面の「Install Plugin」タブで、リポジトリの URL を指定してインストールできます。WP-CLI では install-git サブコマンドを使います。

# 公開リポジトリから入れる
wp plugin install-git https://github.com/your-account/my-custom-plugin

# ブランチを指定して入れる
wp plugin install-git https://github.com/your-account/my-custom-plugin --branch=develop

ステージング環境で開発中のブランチを試すときは、ブランチの切り替えも使えます（設定画面で「Enable Branch Switching」を有効にしておく）。

wp plugin branch-switch my-custom-plugin develop

非公開リポジトリを使う場合とライセンス

非公開（プライベート）リポジトリから更新するには、GitHub のアクセストークンが必要です。

GitHub でトークンを作る。Fine-grained トークンなら、対象のリポジトリだけに絞り、権限は Contents と Metadata の読み取りだけにできる
Git Updater の設定画面の GitHub のタブにトークンを入力する
組織が所有するリポジトリでは、組織側で発行したトークンを使う

ここで注意が必要なのがライセンスです。公式の案内（2023年4月）では、Git Updater は v12.0.0 から有料版の機能を本体に統合し、ライセンス無しでも動作する一方、トークンを使う「認証付きの API リクエスト」には年額の有償ライセンスが必要になりました。14.5.0 のコードでも、ライセンスが無い場合は保存したトークンを削除する処理があります（2026年11月時点）。

つまり、非公開リポジトリを使うにはライセンスを購入する必要があります。公開リポジトリだけなら、ライセンス無しで使えます。価格や条件は公式サイト（https://git-updater.com/）で確認してください。

なお、認証なしの GitHub API には回数の上限があります。管理するプラグインが多いサイトや、同じ IP アドレスから多数のサイトが確認する環境では、確認が失敗することがあります。

運用の注意

まずステージングで試す: 新しいバージョンのタグを打つ前に、ステージング環境で更新と動作を確認します。タグを打つと、管理しているすべてのサイトで、次の確認時に更新が表示されます
Version とタグのずれを防ぐ: 手作業に頼ると、タグの付け忘れやヘッダーの上げ忘れが起きます。リリース用のスクリプトや GitHub Actions で、Version の書き換えとタグ付けを一度に行うと安全です
更新前のバックアップ: 通常のプラグインと同様に、更新前にファイルとデータベースのバックアップを取ります
WordPress.org と同じ名前のプラグイン: WordPress.org に同じスラッグのプラグインがある場合でも、GitHub Plugin URI を書いたプラグインは Git のリポジトリから更新されます。意図せず公開版に置き換わる事故を防げる反面、どちらから更新されるかを把握しておく必要があります

まとめ

Git Updater は、GitHub などに置いたプラグイン・テーマを WordPress の通常の更新画面で更新できるようにする
本体は WordPress.org に無いため、GitHub のリリースか WP-CLI で入れる
リポジトリ側では GitHub Plugin URI、Version、必要なら Primary Branch をヘッダーに書く
新しいバージョンは、Version を上げて同じ番号のタグを付けて出す
非公開リポジトリにはトークンと有償ライセンスが必要（2026年11月時点）

WordPressテーマをGitでバージョン管理する方法（.gitignore・タグ・デプロイ）