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 フィルタで自動更新を無効化してください。