2026年5月20日

WordPressのプラグインをGitHubからインストールする方法

プラグイン関連

はじめに

WordPressの公式リポジトリに登録されていないプラグインをGitHubからインストールする方法は主に3つあります。zipダウンロード・WP-CLI・GitHub Updaterプラグインを使う方法です。

症状・原因

GitHubにあるプラグインをWordPressにインストールしたい
公式リポジトリ未登録のプラグインを使いたい
GitHubのプラグインを自動更新したい
開発中のプラグインをローカル環境にデプロイしたい

解決手順

ステップ1：GitHubからzipをダウンロードしてインストールする

方法①：管理画面からアップロード:
1. GitHubリポジトリ →「Code」→「Download ZIP」
2. WordPress管理画面 → プラグイン → 新規追加
3.「プラグインのアップロード」→ ZIPファイルを選択
4.「今すぐインストール」→「プラグインを有効化」

注意: ダウンロードされるzipのフォルダー名に
「-main」や「-master」が含まれる場合、
プラグインが認識されないことがある
→ フォルダー名をプラグインのスラッグ名に変更して再zip

ステップ2：WP-CLIでGitHub zipからインストールする

# GitHubのリリースzipを直接インストール
wp plugin install https://github.com/author/plugin-name/archive/refs/heads/main.zip \
  --activate

# 特定バージョン（タグ）を指定してインストール
wp plugin install https://github.com/author/plugin-name/archive/refs/tags/v1.2.3.zip \
  --activate

# プライベートリポジトリ（Personal Access Token使用）
wp plugin install "https://TOKEN@github.com/author/plugin-name/archive/main.zip" \
  --activate

# インストール確認
wp plugin list --format=table

ステップ3：GitHub Updaterで自動更新を有効にする

# GitHub Updater プラグインをインストール
wp plugin install https://github.com/afragen/github-updater/archive/refs/heads/master.zip \
  --activate

GitHub Updater 設定:
→ 設定 → GitHub Updater:
→「GitHub Access Token」: GitHubのPersonal Access Tokenを入力
  （Settings → Developer settings → Personal access tokens → repo権限）
→「変更を保存」

プラグインのメインファイルに GitHub Plugin URI を追記する：

<?php
/**
 * Plugin Name: My Custom Plugin
 * Version:     1.0.0
 * GitHub Plugin URI: https://github.com/author/my-custom-plugin
 * GitHub Branch:     main
 */

これにより通常のWordPressプラグイン更新画面からGitHubの更新が受け取れます。

ステップ4：Composerでプラグインを管理する

# composer.json にWordPress Packagistを追加
composer require wpackagist-plugin/contact-form-7

# GitHubリポジトリのプラグインをcomposerで管理
# composer.json に追記:

{
  "repositories": [
    {
      "type": "vcs",
      "url": "https://github.com/author/my-plugin"
    }
  ],
  "require": {
    "author/my-plugin": "^1.0"
  }
}

composer install
# plugins/ ディレクトリにインストールされる

ステップ5：開発中プラグインをシンボリックリンクで管理する

# 開発ディレクトリからWordPressプラグインディレクトリへシンボリックリンク
ln -s /home/user/dev/my-plugin /var/www/html/wp-content/plugins/my-plugin

# WP-CLIで有効化
wp plugin activate my-plugin

# Gitで変更を管理（プラグインディレクトリに直接コミット）
cd /home/user/dev/my-plugin
git pull origin main
wp plugin deactivate my-plugin && wp plugin activate my-plugin

ステップ6：GitHub ActionsでWordPressにデプロイする

# .github/workflows/deploy.yml
name: Deploy Plugin
on:
  push:
    branches: [main]
jobs:
  deploy:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - name: Deploy via rsync
        run: |
          rsync -avz --delete ./ \
            user@server:/var/www/html/wp-content/plugins/my-plugin/
      - name: Flush cache
        run: |
          ssh user@server "wp cache flush --path=/var/www/html"

注意事項

GitHubから直接インストールしたプラグインはWordPress公式のセキュリティレビューを受けていません。信頼できる作者のリポジトリのみ使用してください
GitHub Updaterのトークンはリポジトリ読み取り権限（repo）のみに制限してください
zip名のフォルダー名がプラグインスラッグと異なる場合は認識されないことがあります

まとめ

GitHubプラグインのインストールは wp plugin install {GitHub_zip_URL} が最も手軽です。継続的な更新管理にはGitHub Updaterプラグインが便利で、プラグインヘッダーに GitHub Plugin URI を追記するだけで自動更新が有効になります。

Post Views: 9