2026年5月20日

2026年5月20日

WordPressプラグインのバージョンをダウングレードする方法

はじめに

プラグインを更新したらサイトに不具合が発生した場合、以前のバージョンに戻す(ダウングレード)必要があります。WP-CLI、管理画面経由のzip上書き、専用プラグインを使った3つの方法を解説します。

解決手順

ステップ1:WP-CLIで特定バージョンにダウングレードする

# 特定バージョンをインストール(--force で現在版を上書き)
wp plugin install contact-form-7 --version=5.8 --force

# ダウングレード後に自動更新を無効化(再更新を防ぐ)
wp plugin auto-updates disable contact-form-7

# 現在のバージョンを確認
wp plugin get contact-form-7 --field=version

ステップ2:WP Rollbackプラグインを使う(最も手軽)

# WP Rollbackプラグインをインストール
wp plugin install wp-rollback --activate

有効化後、プラグイン → インストール済みプラグイン でロールバックしたいプラグインの「Rollback」リンクをクリックし、バージョン一覧から戻したいバージョンを選択します。

ステップ3:zip手動インストールでダウングレードする

# WordPress.orgから旧バージョンをダウンロード
# URL形式: https://downloads.wordpress.org/plugin/{slug}.{version}.zip
wget https://downloads.wordpress.org/plugin/contact-form-7.5.8.zip

# WP-CLIでインストール
wp plugin install contact-form-7.5.8.zip --force

# または管理画面: プラグイン → 新規追加 → プラグインのアップロード

ステップ4:ダウングレード後の自動更新を停止する

// functions.php — 特定プラグインの自動更新を無効化
add_filter('auto_update_plugin', function($update, $item) {
    // 自動更新を止めたいプラグインのslugを指定
    $excluded = ['contact-form-7', 'woocommerce'];
    if (in_array($item->slug, $excluded, true)) {
        return false;
    }
    return $update;
}, 10, 2);
// wp-config.php — 全プラグインの自動更新を無効化
define('AUTOMATIC_UPDATER_DISABLED', true);

ステップ5:過去のバージョン一覧を確認する

# WordPress.orgのAPIでバージョン一覧を取得
curl "https://api.wordpress.org/plugins/info/1.0/contact-form-7.json" \
     | python3 -c "import sys,json; d=json.load(sys.stdin); print('\n'.join(d['versions'].keys()))"

# WP-CLIで利用可能なバージョンを確認(最新版のみ表示される場合あり)
wp plugin get contact-form-7

注意事項

  • ダウングレード後は脆弱性が修正されたバージョンに戻れない場合があります。セキュリティ修正版かどうかをリリースノートで確認してください
  • 有料プラグインはWordPress.orgのAPIではなく、各プロバイダーの変更履歴ページを確認してください
  • データベースのスキーマがバージョンによって異なる場合、ダウングレードでDBが壊れる場合があります

まとめ

プラグインのダウングレードは wp plugin install --version=X.X --force が最も確実です。繰り返し更新が必要な場合は WP Rollback プラグインが便利で、再更新を防ぐには auto_update_plugin フィルタで自動更新を無効化してください。

お気軽にご相談ください

お見積りへ お問い合わせへ