
プラグイン更新でテーマの色設定が消えた時の原因と戻し方
プラグインを更新した直後に、テーマのカスタマイザーやページビルダーで設定したリンク色やボタン色がデフォルトに戻る現象は、プラグインが出力する CSS の読み込み順序やスタイルの上書きルールが更新によって変わったことが主な原因だ。まずは設定パネルで該当の色をもう一度選んで保存し、サーバーキャッシュとブラウザキャッシュを完全にクリアすれば、多くのケースは即座に解決する。
更新後にテーマの色やスタイルが消えるのはなぜか

プラグインのアップデートでは新機能の追加やバグ修正だけでなく、内部で使う CSS クラス名の変更やスタイルシートの構造そのものが刷新される場合がある。とくにページビルダー系のプラグインや、テーマが提供する「グローバルカラー」機能を拡張するアドオンでは、アップデートによって優先度の高い新しいデフォルトスタイルが追加され、それまでサイトの表示に適用されていたユーザー定義の色指定が打ち消されてしまう。
管理画面の設定パネル上では、以前に選んだ紫色や緑色が「選択中」として残っているように見えるのに、実際のフロントエンドではプラグインが用意したデフォルトの青色や無指定状態に戻ってしまうのはこのためだ。設定データ自体がデータベースから消えたわけではなく、CSS の読み込み優先順位の変化によって見た目だけが元に戻っている状態と理解するとよい。
ユーザー指定の紫色(#9b59b6)が矢印やリンクに反映されている
プラグイン追加のデフォルト青(#1976d2)がユーザー指定を上書きしてしまう
上の図のように、データベースに保存された色の設定値は更新後も消えていない。プラグインが出力する CSS の層が一枚増えて、その層のデフォルト指定が手前にかぶさっているだけの状態だ。この仕組みを理解しておけば、むやみにテーマ全体を作り直す必要はないとわかる。
色設定を元に戻すための具体的な4つの手順

設定データが無事なら、原因の多くは CSS の読み込み順序の衝突とキャッシュの残留だ。小手先の修正を重ねるよりも、この4ステップを順番に試していく方が結果的に早い。
STEP 1|設定を再保存してキャッシュをすべて消す
該当のプラグイン設定画面を開き、色指定のフィールドでいったん別の色を選んでから再度目的の色に設定し直し、「変更を保存」ボタンを押す。この操作でプラグインは最新バージョンの CSS 生成ロジックを使って、現在の設定値を CSS として書き出す。
保存後は以下の3つのキャッシュを完全に削除する。どれか一つでも残っていると、古い表示のまま問題が続いているように見える。
- プラグインやサーバー側で使っているキャッシュ(WP Rocket や W3 Total Cache など)をすべて削除する
- CDN(Cloudflare など)を使っている場合は、CDN のキャッシュもパージする
- ブラウザのキャッシュを削除するか、シークレットウィンドウで表示を確認する
ここまで実施して色が戻れば、問題は一時的な読み込み順序の不整合だったことになる。これで直らない場合は、次にプラグイン同士の競合を疑う。
STEP 2|全プラグインを停止して問題の範囲を絞る
更新したプラグイン以外にも、CSS や JavaScript を操作するプラグインが複数入っていると、スタイルの打ち消し合いが起こることがある。トラブルシューティングの基本として、更新したプラグインだけを有効にし、それ以外のプラグインをすべて無効化した状態で表示を確認する。
この状態で正しい色が表示されれば、他のプラグインとの競合が原因だ。一つずつ再有効化して、問題が再発するタイミングを特定する。操作は本番環境ではなく、必ずステージング環境かローカル環境で行う。本番サイトでプラグインをまとめて停止すると、レイアウト崩れや機能停止が起こる可能性がある。
STEP 3|セーフモードでクリーンな状態を作る
WordPress 5.2 以降に搭載されたサイトヘルス機能の一部として「致命的エラーからの保護(リカバリーモード)」がある。更新後に画面が真っ白になったり「このサイトで重大なエラーが発生しました」というメッセージが出た場合は、この仕組みが自動で発動し、管理者宛てにリカバリーモード用のリンクがメールで届く。
リカバリーモードでは、問題のプラグインが無効化された状態で管理画面に入れる。ここで該当プラグインの設定を開き、色指定を再保存してからプラグインを再有効化することで、破損したキャッシュや不完全な更新ファイルが原因の不具合を解消できる場合がある。
STEP 4|プラグインを旧バージョンに戻す
STEP 1〜3 で解決しない場合や、どうしてもサイトを今すぐ正常な見た目に戻す必要がある場合は、WP Rollback などの専用プラグインを使って該当プラグインを更新前のバージョンに戻す。この方法を取れば、開発者側の修正パッチがリリースされるまでの間もサイトの見た目を維持できる。
旧バージョンへのロールバックは一時的な回避策であり、セキュリティ修正や脆弱性対策が含まれるアップデートの場合は注意が必要だ。ロールバックを実施したら、必ずプラグインの公式サポートフォーラムや変更履歴を確認し、次の安定版がリリースされたタイミングで速やかに更新すること。
修正パッチを適用する際の注意点

プラグイン開発者から修正版の ZIP ファイルが提供される場合がある。通常の管理画面から「プラグイン」→「新規追加」→「プラグインのアップロード」でインストールできるが、すでに同名のプラグインが存在する場合は「上書きインストール」を求められる。
上書きインストールの前に、必ずサイト全体のバックアップ(データベースとファイル)を取得しておく。ZIP ファイルのアップロード時に「500 Internal Server Error」が発生した場合は、サーバーの PHP メモリ不足やアップロードサイズ制限が原因の可能性が高い。サーバーのエラーログを確認し、必要に応じて `php.ini` や `.htaccess` でメモリ上限や実行時間の設定を一時的に引き上げる。
FTP が使える環境なら、管理画面からのアップロードではなく、ZIP を解凍してプラグインフォルダ(`/wp-content/plugins/プラグイン名/`)に直接アップロードする方法もある。この場合はファイルの上書きミスを防ぐため、既存フォルダをリネームして退避させてから新しいファイルを配置する方が安全だ。
よくある質問
プラグインを更新前のバージョンに戻すにはどうすればよいか
「WP Rollback」プラグインをインストールすると、プラグイン一覧画面に「Rollback」リンクが追加される。クリックすると過去のバージョン一覧が表示され、任意のバージョンにワンクリックで戻せる。手動で戻す場合は、プラグインの公式ディレクトリにある「Previous Versions」から旧バージョンの ZIP をダウンロードし、FTP で上書きアップロードする。
色設定が毎回のアップデートで消えるのを防ぐ方法はあるか
プラグインのグローバルカラー機能に頼らず、子テーマの `style.css` にカスタム CSS として直接色指定を書いておく方法が最も安定する。テーマやプラグインのアップデートでは子テーマのファイルは上書きされないため、色指定が勝手にリセットされる心配がなくなる。
キャッシュを削除しても色が戻らない場合はどうするか
ブラウザの「検証ツール(F12キー)」を開き、色が変わってしまった要素をクリックして Styles パネルを確認する。目的の色指定に打消し線が入っていて、別の CSS ルールが優先されている場合は、そのルールの出どころ(プラグイン名やファイル名)を特定できる。特定できたら、より強いセレクタ(ID セレクタや `!important`)を使って子テーマ側で上書きする。
プラグイン更新後にサイト全体が真っ白になった時の対処法は
「このサイトで重大なエラーが発生しました」と表示される場合は、FTP で `/wp-content/plugins/該当プラグインのフォルダ/` をリネームして無効化し、管理画面にアクセスできる状態を確保する。その後、`wp-config.php` に `define(‘WP_DEBUG’, true);` を追加してデバッグモードを有効にし、具体的なエラー内容を確認してから対応を進める。
自動更新を止めておくことは可能か
特定のプラグインだけ自動更新を無効化するには、`wp-config.php` に手を加えるか、Easy Updates Manager のような管理プラグインを使う。ただし自動更新を止めるとセキュリティ修正の適用も遅れるため、本番環境では更新前にステージング環境で動作確認する運用体制を整えておくことが現実的な対策になる。
この記事のポイント
- プラグイン更新で色が消えるのは、設定データの消失ではなく CSS の読み込み順序や優先度が変わったことが原因
- 設定の再保存とキャッシュ完全削除でほとんどは即座に解決する
- 直らない場合はプラグイン競合の切り分けやリカバリーモードを試す
- 恒久対策として、重要な色指定は子テーマの CSS に直接書いておくとアップデートに左右されない

・ Reddit、Stack Overflow、WordPress.org フォーラムを日々巡回し、現場の悩みを拾い上げて記事化
・ WordPress、WooCommerce、Next.js などモダンWeb制作領域のトラブルシューティングが専門
・ 「検索しても答えが見つからなかった」を一つでも減らすことが目標
・ エラーメッセージから根本原因にたどり着く粘り強い調査が得意
・ 初心者がつまずきやすい箇所を先回りで解決する記事作りを心がけている

WordPressで「Duplicate entry ‘0’ for key ‘PRIMARY’」エラーが発生したときのデータベース修復手順
MailPoetなどのプラグインで「An exception occurred while executing a query: Duplicate entry ‘0’ for key ‘PRIMARY’」というエラーが発生しプラグインを再インストールしても直らない場合、原因はデータベーステーブルの主キーからAUTO_INCREMENT属性が失われていることだ。phpMyAdminでテーブル構造を直接修復すれば解決する。
なぜ再インストールではこのエラーが直らないのか

「Duplicate entry ‘0’ for key ‘PRIMARY’」は、データベースの主キー(PRIMARY KEY)に同じ値「0」を重複して挿入しようとしたときにMySQLが返すエラーだ。通常、主キーにはAUTO_INCREMENTが設定されており、新しい行が追加されるたびに自動で一意の番号(1、2、3…)が振られる。しかしテーブル構造が破損したり、何らかの操作でAUTO_INCREMENT属性が外れたりすると、WordPressやプラグインは新しい行を追加する際に主キーへ「0」や重複した値を挿入しようとして失敗する。
MailPoetを管理画面から削除して再インストールしても、プラグインが使用するカスタムテーブルは削除されずに残ることが多い。テーブルが残っていれば破損した構造もそのままだ。結果として、何度インストールし直しても同じエラーが再発するという状況に陥る。
↑ AUTO_INCREMENTが欠落
→ 新規行のidが常に0になる
↑ 自動で一意の番号が振られる
→ 正常にデータを追加できる
エラーが発生しているテーブルは、エラーメッセージに直接表示されないことも多い。MailPoetの場合、mailpoet_で始まる複数のテーブルのいずれかでこの問題が起きている可能性が高い。具体的にはmailpoet_subscribersやmailpoet_segmentsなど、データを頻繁に追加するテーブルで発生しやすい。
phpMyAdminでデータベーステーブルを修復する手順

レンタルサーバーの管理画面からphpMyAdminにアクセスし、以下の手順でテーブル構造を修復する。操作は数分で完了し、特別な技術知識は不要だ。
対象のデータベースとテーブルを特定する
phpMyAdminを開いたら、左側のデータベース一覧からWordPressサイトが使用しているデータベースをクリックする。データベース名がわからない場合は、WordPressインストールディレクトリのwp-config.phpファイルを開き、DB_NAMEの値を確認する。またはサーバー管理画面の「データベース」セクションでWordPressに関連付けられたデータベース名を探す。
データベースを選択するとテーブルの一覧が表示される。MailPoetのテーブルはmailpoet_という接頭辞で始まる(例:wp_mailpoet_subscribers、wp_mailpoet_newslettersなど)。エラーの原因となっているテーブルを特定するには、まずmailpoet_subscribersなど主要なテーブルの「構造」タブを開き、主キー(通常はidカラム)の「AUTO_INCREMENT」が有効かどうかを確認する。
主キーにAUTO_INCREMENTを再設定する具体的なSQL操作
テーブルの「構造」タブでidカラムの「変更」リンク(鉛筆アイコン)をクリックする。表示された編集画面で「A_I」(AUTO_INCREMENT)チェックボックスにチェックを入れ、「保存」をクリックする。これで主キーにAUTO_INCREMENT属性が再設定される。
もしphpMyAdminのGUI操作でエラーが出る場合は、SQLタブを開いて直接SQL文を実行する。以下のSQLを実行する(テーブル名は実際のものに置き換える)。
ALTER TABLE wp_mailpoet_subscribers MODIFY COLUMN id INT(11) NOT NULL AUTO_INCREMENT;このSQL文は、wp_mailpoet_subscribersテーブルのidカラムをAUTO_INCREMENT付きで再定義する。同じ問題が他のMailPoetテーブルでも発生している可能性があるため、mailpoet_で始まるすべてのテーブルの構造を確認し、idカラムのAUTO_INCREMENTが外れているものがあれば同様に修正する。
操作後はphpMyAdminの「操作」タブから、そのテーブルのAUTO_INCREMENTの現在値を適切な値に設定しておくとより安全だ。テーブル内の既存データの最大IDより大きい値(例:既存の最大IDが150なら151)をAUTO_INCREMENT欄に入力して「実行」をクリックする。
データベースに直接アクセスできない場合の代替手段
レンタルサーバーによってはphpMyAdminが提供されていなかったり、セキュリティ上の理由でデータベースへの直接アクセスが制限されている場合がある。その場合は以下の方法を試す。
WP-CLIが利用できる環境なら、以下のコマンドでデータベースに直接SQLを実行できる。
wp db query "ALTER TABLE wp_mailpoet_subscribers MODIFY COLUMN id INT(11) NOT NULL AUTO_INCREMENT;"WP-CLIもphpMyAdminも使えない共有サーバーの場合は、「Advanced Database Cleaner」や「WP-DBManager」のようなWordPressプラグインを使ってSQLクエリを実行する方法もある。ただし多くのレンタルサーバーにはphpMyAdminが標準で用意されているため、まずはサーバー管理画面を確認するのが確実だ。
MailPoetテーブルを完全にリセットして再インストールする方法

テーブル構造の修復が難しい場合や、破損が広範囲に及んでいる場合は、MailPoetの全テーブルを手動で削除してからプラグインを再インストールする方法もある。この方法では既存の購読者データやニュースレターの設定は失われるため、事前にバックアップがある場合のみ選択する。
テーブルを削除するには、phpMyAdminで各mailpoet_テーブルにチェックを入れ、下部の「処理」ドロップダウンから「削除(DROP)」を選択して実行する。MailPoetのテーブルは数が多いため、一つずつ選択するか、以下のようなSQLを実行して一括削除することもできる。
DROP TABLE IF EXISTS wp_mailpoet_subscribers, wp_mailpoet_segments, wp_mailpoet_newsletters;すべてのMailPoetテーブル名はphpMyAdminのテーブル一覧で確認できる。DROP TABLEは取り消せない操作のため、実行前に必ずデータベース全体のバックアップ(エクスポート)を取得する。その後WordPress管理画面からMailPoetプラグインを削除し、改めて「プラグイン」→「新規追加」からインストールすれば、正常なテーブル構造でプラグインが初期化される。
他のプラグインでも発生する同様のエラーと共通の対処法

「Duplicate entry ‘0’ for key ‘PRIMARY’」はMailPoetに限らず、WooCommerce、BuddyPress、LearnDashなど、独自のカスタムテーブルを作成するあらゆるプラグインで発生する可能性がある。根本原因は常に同じで、主キーのAUTO_INCREMENT属性が失われていることだ。
WooCommerceの場合はwp_woocommerce_order_itemsやwp_woocommerce_downloadable_product_permissionsなど、BuddyPressではwp_bp_activityやwp_bp_notificationsで発生しやすい。エラーメッセージが表示されたら、まずメッセージ内で言及されているクエリからテーブル名を特定し、そのテーブルの主キー構造をphpMyAdminで確認する手順は同じだ。
WordPressのメジャーアップデートやサーバーのMySQLバージョンアップグレード後にこのエラーが突然発生した場合は、複数のカスタムテーブルで同様の破損が起きている可能性が高い。その際は一つずつ修復するよりも、データベース全体のバックアップを取った上で、DB管理ツールの「テーブルの修復」機能を使うのが効率的だ。phpMyAdminではデータベースを選択後、全テーブルにチェックを入れて「処理」から「テーブルの修復」を選択すると、破損したテーブルを一括で修復できる。
今後の再発を防ぐための予防策
AUTO_INCREMENT属性が外れる根本原因は、MySQLの不整合やプラグインの不完全なアップデート処理にあることが多い。完全に防ぐことは難しいが、以下の対策でリスクを低減できる。
プラグインのアップデート前にデータベースのバックアップを必ず取得する習慣をつける。多くのレンタルサーバーでは管理画面からワンクリックでバックアップを取得できる。また「UpdraftPlus」などのバックアッププラグインを導入し、自動バックアップをスケジュールしておくと、問題発生時に迅速に復元できる。
プラグインのメジャーアップデート(1.xから2.xなど大幅なバージョンアップ)を適用する際は、可能であればステージング環境で事前テストを行う。これにより本番環境でテーブル破損が発生するリスクを大幅に減らせる。ステージング機能を提供しているレンタルサーバーも増えている。
よくある質問
エラーメッセージにテーブル名が表示されない場合はどうすればいいか
WordPressのデバッグモードを有効にすると、より詳細なエラー情報が表示される。wp-config.phpにdefine('WP_DEBUG', true);とdefine('WP_DEBUG_LOG', true);を追加し、wp-content/debug.logに出力されるエラーログを確認する。ログにはクエリ全体が記録されるため、テーブル名が特定できる。
phpMyAdminでAUTO_INCREMENTのチェックボックスがグレーアウトして変更できない
主キーが正しく設定されていない可能性がある。まず「構造」タブでidカラムが「PRIMARY」と表示されているか確認する。表示されていない場合は、そのテーブルのSQLタブでALTER TABLE テーブル名 ADD PRIMARY KEY (id);を実行してから再度AUTO_INCREMENTの設定を試す。
テーブルを修復したが同じエラーが別のテーブルで発生する
プラグインが使用する全テーブルを確認する必要がある。MailPoetは40以上のテーブルを使用しており、idカラムを持つテーブルすべてで同様の問題が起きている可能性がある。phpMyAdminの検索機能で「id」を含むテーブル構造を横断的に確認するか、前述の全テーブル削除と再インストールを検討する。
データベース操作に不慣れでSQLの実行が不安な場合の安全な方法はあるか
レンタルサーバーのサポートに依頼するのが最も安全だ。「WordPressプラグインのデータベーステーブルでAUTO_INCREMENTが破損しているため修復してほしい」と伝えれば、多くのサーバー会社では技術サポートが対応してくれる。またphpMyAdminの「エクスポート」で事前にSQLバックアップを取得しておけば、操作ミスがあっても復元できる。
この記事のポイント
- 「Duplicate entry ‘0’ for key ‘PRIMARY’」は主キーのAUTO_INCREMENT属性欠落が原因
- プラグイン再インストールだけではテーブル構造は修復されない
- phpMyAdminで対象テーブルのidカラムにAUTO_INCREMENTを再設定すれば解決する
- MailPoet以外のプラグイン(WooCommerce、BuddyPress等)でも同じ対処法が有効
- 事前のデータベースバックアップとデバッグモード活用で早期発見と安全な修復が可能

・ Reddit、Stack Overflow、WordPress.org フォーラムを日々巡回し、現場の悩みを拾い上げて記事化
・ WordPress、WooCommerce、Next.js などモダンWeb制作領域のトラブルシューティングが専門
・ 「検索しても答えが見つからなかった」を一つでも減らすことが目標
・ エラーメッセージから根本原因にたどり着く粘り強い調査が得意
・ 初心者がつまずきやすい箇所を先回りで解決する記事作りを心がけている

WC Vendors 2.7.0アップグレードでfatal errorが出た時の対処法
WC Vendors 2.7.0 にアップグレードした直後、サイト全体が「このサイトで重大なエラーが発生しました」の表示になり管理画面にもアクセスできなくなった場合、wcvendors_capability_product_types オプションの値が配列ではなく文字列で保存されていることが原因だ。WP-CLI を使えるかどうかで復旧手順を分けて対処する。
WC Vendors 2.7.0で管理画面にすら入れなくなる原因は何か

この問題は、プラグイン内部の関数 wcv_is_all_product_types_hidden() が array_diff() を呼び出す際、引数として文字列を渡してしまうことで発生する。PHP 8 環境では型宣言が厳密になったため、ここで TypeError(致命的エラー)が起こり、サイト全体が HTTP 500 エラーで停止する。
関数に渡されるのは wcvendors_capability_product_types というオプションの値だ。このオプションは本来、商品タイプの配列(['simple', 'variable'] など)を保持すべきだが、古いバージョンの WC Vendors(特に 1.x 系)から移行してきたサイトでは、内部的に「simple」のような文字列のまま残っているケースがある。2.7.0 で追加された新しい関数には配列へのキャスト処理が含まれておらず、長期間眠っていた不正なデータが一気に致命的エラーとして表面化した。
(array) によるキャストがあり、文字列でも配列として扱われていたarray_diff() に文字列が直接渡され、PHP 8 で TypeErrorエラーのトリガーは wp_loaded フックで、これは WordPress の読み込みのかなり早い段階で実行される。そのため管理画面もフロントエンドも一切表示されず、ダッシュボードからプラグインを無効化するという通常の復旧手段が使えなくなってしまう。
管理画面にログインできない場合の応急処置(WP-CLI を使う)

サーバーに SSH でアクセスできる環境であれば、WP-CLI を使って不正なオプション値を直接修正するのが最も確実な回復方法だ。管理画面に入れなくても、この操作でサイトは即座に復旧する。
wp option update wcvendors_capability_product_types '["simple"]' --format=json上記コマンドは wcvendors_capability_product_types オプションの値を強制的に JSON 配列として上書きする。["simple"] の部分は、自サイトで実際に有効にしていた商品タイプのスラッグに置き換える。可変商品や外部商品を使っていた場合は、["simple","variable","external"] のようにカンマ区切りで列挙する。値は連想配列ではなく、単純なリスト形式でなければならない。
WP-CLI を使えない場合のエラー復旧手順(FTP/ファイルマネージャー)

レンタルサーバーでは SSH が利用できず、WP-CLI も使えないケースが多い。その場合は FTP またはサーバー付属のファイルマネージャーを使ってプラグインを一時的に無効化し、管理画面にアクセスできる状態に戻す。
- FTP クライアントまたはファイルマネージャーで
/wp-content/plugins/ディレクトリにアクセスする wc-vendorsディレクトリを探し、名前をwc-vendors-disabledに変更する- ブラウザで管理画面の URL(
yourdomain.com/wp-admin/)を開く - 管理画面にログインできたら、
wc-vendors-disabledをもとのwc-vendorsに戻す(ただし有効化はしない) - 管理画面の「プラグイン」で WC Vendors が「無効」になっていることを確認し、データベースの該当オプションを修正する手順に進む
ディレクトリ名の変更によってプラグインが強制的に無効化される仕組みを利用している。ファイル自体は削除せず、リネームするだけなので元に戻せる。管理画面に戻ったら、次のセクションで説明する根本的なオプション修正を行う。現時点で WC Vendors を再度有効化すると、同じエラーが再発するので有効化してはいけない。
根本的な修正をプラグインのアップデート前に済ませておく

WC Vendors の開発チームはこの問題を認識しており、将来のリリースで修正が反映される見込みだ。しかしアップデートを待つだけでは、同じサイトで別の箇所が再び同様のエラーを起こす可能性を抱えたままになる。管理画面にログインできる状態にしたら、データベース上のオプション値を正規化してしまおう。
最も簡便な方法は、先ほど WP-CLI で実行したコマンドと同じ操作を、データベース管理ツール(phpMyAdmin など)やカスタムスクリプトで行うことだ。具体的には wp_options テーブルを開き、option_name が wcvendors_capability_product_types の行を探す。option_value カラムが文字列(例 simple)になっている場合、a:1:{i:0;s:6:"simple";} のようにシリアライズされた配列表現に書き換える。
PHP のシリアライズ形式を手書きするのはミスが怖い場合は、次のような安心な手順をとる。
- WC Vendors が無効化されていることを確認する
- 管理画面の「設定」→「WC Vendors」→「販売」→「商品タイプ」に進み、チェックボックスで適切な商品タイプを選んで保存する(これで正常な配列としてオプションが上書きされる)
- WC Vendors を有効化する
この方法は管理画面を使うため、データベースを直接触る必要がなく安全だ。ただしバージョン 2.7.0 では有効化した瞬間に wp_loaded フックのエラーが再発する可能性があるため、あらかじめプラグインファイルの該当行を一時的に修正するか、前述のキャストを適用しておくと確実だ。
よくある質問
エラーログを確認するにはどうすればよいか
サーバーのエラーログには wp-content/debug.log(WordPress のデバッグログ)や、Apache/Nginx のエラーログがある。WP-CLI が使えれば wp config set WP_DEBUG true --raw と wp config set WP_DEBUG_LOG true --raw でログ出力を有効にした上で、エラーを再現させて wp-content/debug.log を確認する。共有サーバーではホスティングの管理画面からエラーログが見られることも多い。
WC Vendors をアップグレードする前に何か注意すべきことはあるか
メジャーバージョンアップを行う場合は、本番サイトに適用する前に必ずステージング環境でテストする。どうしても本番で行うなら、事前にデータベースのバックアップを取り、wcvendors_capability_product_types オプションの現在の値を確認しておく。WP-CLI で wp option get wcvendors_capability_product_types --format=json を実行し、値が配列形式になっていることを確かめればリスクを大幅に減らせる。
PHP のバージョンが 7.x 系ならこの問題は起きないか
PHP 7.x では array_diff() に文字列を渡しても Warning は出るが Fatal Error にはならないため、サイトが完全停止することはない。ただしエラー自体の根本原因は同じであり、動作は予期しない結果になる可能性が高い。推奨される PHP のバージョンは 8.x 系へ移行することであり、その前に対処しておくことが望ましい。
WC Vendors Free と Pro のどちらでも発生するのか
この問題は WC Vendors の無料版(Free)のコア機能部分で発生している。Pro 版を併用している場合でも、同じオプション値を読み込むため影響を受ける可能性が高い。特に 1.x 系からバージョンを重ねてきたサイトは要注意だ。
この記事のポイント
- WC Vendors 2.7.0 へのアップグレードでサイトが停止するのは
array_diff()の型不一致が原因 - 古いサイトでは
wcvendors_capability_product_typesが文字列で残っているケースがある - WP-CLI を使えるなら
wp option updateで即座に復旧できる - WP-CLI が使えない場合はプラグインディレクトリをリネームして管理画面に復帰する
- 根本的には設定画面で商品タイプを保存し直すか、データベースの値を配列に正規化する

・ Reddit、Stack Overflow、WordPress.org フォーラムを日々巡回し、現場の悩みを拾い上げて記事化
・ WordPress、WooCommerce、Next.js などモダンWeb制作領域のトラブルシューティングが専門
・ 「検索しても答えが見つからなかった」を一つでも減らすことが目標
・ エラーメッセージから根本原因にたどり着く粘り強い調査が得意
・ 初心者がつまずきやすい箇所を先回りで解決する記事作りを心がけている

WooCommerce Social Loginに深刻度9.8の脆弱性。管理者アカウント乗っ取りの危険
WooCommerce Social Loginプラグインに、未認証の攻撃者が任意のユーザーアカウントにログインできる重大な脆弱性が報告された。CVSSスコアは9.8と最高クラスの深刻度であり、管理者権限の奪取も可能になる。バージョン2.8.7以下を利用しているすべてのサイトが対象だ。
この脆弱性はAppleログイン処理に存在し、攻撃者は特別な権限を必要としない。正規のユーザーのメールアドレスさえ知っていれば、管理者を含む任意のアカウントに不正ログインできる。2026年8月1日に公開されたCVE-2026-8457として識別されており、即時対応が求められる。
深刻度9.8の認証バイパス脆弱性と影響範囲

Wordfenceのセキュリティ研究者によって発見されたこの脆弱性は、WooCommerce Social LoginのAppleサインイン機能に潜んでいた。ユーザーがAppleアカウントでログインする際、プラグインはAppleから返されるIDトークンの正当性を検証していなかった。このため攻撃者は、なりすましたいユーザーのメールアドレスを含む偽のトークンを作成し、認証をすり抜けられる。
被害を受けるのはWooCommerce Social Loginのバージョン2.8.7以下の全インストールだ。プラグインを有効化しているサイトであれば、特別な設定ミスがなくても攻撃が成立する。攻撃者はユーザー名やパスワードを一切知る必要がなく、標的のメールアドレスさえ分かれば管理者権限でログイン可能になる。
一般的なWordPressの脆弱性では、攻撃者が何らかの権限をあらかじめ持っていたり、管理者がリンクをクリックするなどの操作が必要になることが多い。しかし今回は、攻撃者が標的サイトにリクエストを送るだけで管理者アカウントにログインできてしまう。いわゆる「認証なしの管理者乗っ取り」に分類され、CVSS 9.8という評価はその直接的な危険性を反映している。
なぜこれほど危険なのか

認証バイパスにより管理者権限を取得した攻撃者は、WooCommerceサイトの全データを自由に操作できる。具体的には、顧客情報や注文データの窃取、不正な管理者アカウントの追加、プラグインやテーマの改ざんによるマルウェア注入、支払い情報への介入などが考えられる。さらに、サイトのSEO評価を意図的に下げるスパムリンクの埋め込みや、Googleからのインデックス削除といった攻撃も容易に行われてしまう。
WooCommerceを利用するECサイトでは、顧客の個人情報や購入履歴が保存されている。こうしたデータが流出した場合、個人情報保護法やGDPRなどの規制違反に発展する可能性もある。サイトの信用失墜だけでなく、法的なリスクや多額の損害賠償にまでつながりかねない。
WooCommerceのコア機能や他の決済プラグインでは、こうした認証処理に対する検証が厳格に行われている。しかし、Social LoginプラグインのAppleログイン部分だけが例外的に署名検証を欠いていた。そのため、攻撃の標的として非常に狙われやすい。
Appleログイン処理の具体的な問題点

Appleサインインでは、ユーザーが認証を完了すると、AppleのサーバーからIDトークンと呼ばれるデータがサイト側に送られる。このトークンにはユーザーのメールアドレスなどの情報が含まれ、改ざんを防ぐためにAppleの秘密鍵で電子署名が付与されている。プラグインは本来、Appleが公開している鍵を使ってこの署名を検証し、トークンが本物であることを確認しなければならない。
ところが、WooCommerce Social Loginはこの署名検証のステップを実装しておらず、受け取ったメールアドレスをそのまま信頼してログイン処理に使っていた。結果として、攻撃者が偽のIDトークンを作り、その中に標的ユーザーのメールアドレスを入れて送信するだけで、そのユーザーとして認証が通ってしまう状態になっていた。
Wordfenceの調査によると、管理者ロールかどうかのチェックも行われていなかった。攻撃者が管理者のメールアドレスを指定すれば、管理画面へのフルアクセスが即座に与えられる。これはIDトークンに含まれる「email」フィールドを、ログインにそのまま使う実装ミスに起因している。
つまり、IDトークンの署名確認という重要な防御ラインがまるごと欠落していたわけだ。この種の不備は、OpenID ConnectやOAuth 2.0を利用するソーシャルログイン実装では絶対にあってはならないものであり、Wordfenceの報告では「未認証の攻撃者が、偽造したid_tokenのペイロードに対象ユーザーの電子メールアドレスを含めて送信するだけで、管理者を含む任意のアカウントでログインできる」と指摘されている。
影響を受けるバージョンと今すぐ取るべき対策

この脆弱性の影響を受けるのは、WooCommerce Social Loginバージョン2.8.7以下のすべてのリリースだ。8月1日の公開後、プラグイン開発元はすぐに修正版2.8.8をリリースしている。Wordfenceは、該当バージョンを使用しているユーザーに対して、2.8.8またはそれ以降のバージョンへの即時アップデートを強く推奨している。
アップデートを適用しないまま放置すると、攻撃者に管理者権限を奪取された後に、バックドアを仕込まれたり、サイトの完全な乗っ取りが発生する可能性が高い。特にWooCommerceサイトでは決済情報や顧客データが絡むため、被害が拡大する前に一刻も早く更新を済ませてほしい。
- WordPress管理画面から「プラグイン」→「インストール済みプラグイン」を開く
- 「WooCommerce Social Login」を探し、利用可能なアップデートがあれば「今すぐ更新」をクリック
- バージョンが2.8.8以上になっていることを確認する
- 万が一、プラグインをすぐに更新できない事情がある場合は、一時的にプラグインを無効化する
また、サイトの管理者アカウントに不正なログインがなかったかどうか、アクセスログやユーザー一覧を至急確認してほしい。身に覚えのない管理者アカウントが追加されている場合は、すでに攻撃を受けている可能性がある。その場合は、プラグインの更新だけでなく、全ユーザーのパスワードリセットや、サイト全体のマルウェアスキャンも併せて実施する必要がある。
この記事のポイント
- WooCommerce Social Login 2.8.7以下にCVSS 9.8の認証バイパス脆弱性が存在する
- AppleログインのIDトークン署名検証が行われておらず、攻撃者が任意のユーザーになりすませる
- 管理者アカウントも標的になるため、ECサイトの全データが危険にさらされる
- 修正版2.8.8への即時アップデートが必須
- すでに攻撃を受けた可能性がある場合は、ユーザー一覧の確認とサイト全体のセキュリティチェックを推奨

・ 複数業界における17年間のデジタルビジネス開発経験
・ ウェブサイト開発のためのHTML、PHP、CSS、JavaScript等の実用的知識
・ 15ヶ国語対応の多言語SaaSの開発経験
・ 17年間にも及ぶ、Eコマース長期運営経験
・ 幅広い業界でのSEO最適化の豊富な経験

WordPress 7.0 ブロックエディターで多言語プラグイン Bogo 有効時に REST API 500 エラーが出る原因と対処
WordPress の多言語プラグイン Bogo を有効化した状態でブロックエディターを開くと、カテゴリーなどのタクソノミーパネルが空になり、REST API が 500 Internal Server Error を返す症状は、Bogo が REST API に付与する lang パラメータと WordPress 7.0 のブロックエディター側のリクエスト処理が競合していることが主な原因だ。
なぜ Bogo とブロックエディターの組み合わせで REST API が 500 エラーを返すのか

この問題の核心は、ブロックエディターが内部で使用する REST API エンドポイントに対するリクエストにある。ブロックエディターは編集画面を表示する際、/wp-json/wp/v2/taxonomies や /wp-json/wp/v2/users/〜 といった複数のエンドポイントに同時にリクエストを送信し、カテゴリー一覧や投稿者情報を取得している。
Bogo は多言語対応のために、これらの REST API リクエストに対して自動的に lang クエリパラメータを付与する。たとえば ?lang=en や ?lang=ja といった具合だ。このパラメータ追加の処理が、ブロックエディターの特定の内部リクエストと組み合わさった際に、サーバー側で PHP の致命的エラーを引き起こしている。
データベースから要求された言語のデータを取得しようとするが、ブロックエディターのコンテキストでは想定外の引数が渡され、結果として WP_Query やタクソノミー取得関数が WP_Error オブジェクトを返す。これが REST API のレスポンス生成時に適切にハンドリングされず、500 エラーとして表面化する。
エラーの切り分けと原因特定の手順

まずは問題が本当に Bogo とブロックエディターの組み合わせに限定されているのかを確認する。以下のフローに沿ってテストを進めると、原因の特定がスムーズになる。
上記の最小構成でもエラーが再現する場合、Bogo とブロックエディターの直接的な競合と判断できる。なお、クラシックエディタープラグインをインストールして同じ操作を行った際に問題が発生しないことも、ブロックエディター固有の問題であることの強い証拠になる。
実用的な回避策と当面の対応

根本的な修正は Bogo プラグイン側のアップデートを待つ必要があるが、運用を止めずにしのぐ方法はいくつか存在する。状況に応じて以下を使い分ける。
クラシックエディターへの一時的な切り替え
最も確実で即効性のある回避策は、クラシックエディタープラグインをインストールして旧来の編集画面を使うことだ。クラシックエディターは REST API に依存したデータ取得を行わないため、Bogo の lang パラメータ付与が問題を引き起こす余地がない。
→ ブロックエディターの内部リクエストが lang パラメータと競合
→ REST API 非依存のため競合が発生しない
クラシックエディターは WordPress の公式プラグインディレクトリから無料でインストールできる。インストール後は「設定」→「投稿設定」からデフォルトのエディターを切り替えられる。
REST API への lang パラメータ付与をフィルターフックで制限する
Bogo は REST API リクエストに言語パラメータを付与する際、rest_dispatch_request や rest_pre_dispatch といったフィルターフックを経由している。子テーマの functions.php に以下のようなコードを追加することで、管理画面からのリクエストに対して言語パラメータの付与を抑制できる。
add_filter( 'rest_dispatch_request', function( $dispatch_result, $request, $route, $handler ) {
// 管理画面からの REST API リクエストの場合、Bogo の言語処理をスキップ
if ( is_admin() || ( defined( 'REST_REQUEST' ) && REST_REQUEST && strpos( $route, '/wp/v2/' ) === 0 ) ) {
remove_filter( 'rest_dispatch_request', 'bogo_rest_dispatch_request', 10 );
}
return $dispatch_result;
}, 5, 4 );このコードは、/wp/v2/ から始まる REST API ルート(ブロックエディターが使用する主要なエンドポイント)に対して、Bogo が持つ bogo_rest_dispatch_request フィルターを一時的に除去する。ただし、この方法は Bogo の内部実装に依存しているため、プラグインのバージョンアップによって動作が変わる可能性がある点に注意が必要だ。
プラグインのダウングレードまたはフォーク版の利用を検討する
Bogo 3.9.2 で問題が顕在化したのであれば、1つ前のバージョンである 3.9.1 にダウングレードすることで問題が回避できる可能性がある。ただし、ダウングレードはセキュリティ上のリスクを伴うため、あくまで開発者側の対応を待つ間の暫定策と位置づける。
代替の多言語プラグインへの移行を検討する
Bogo はシンプルな多言語化プラグインとして長く使われているが、ブロックエディターとの相性問題が続くようであれば、Polylang や WPML、TranslatePress といった代替プラグインへの移行も選択肢に入る。これらのプラグインはブロックエディターとの互換性テストがより積極的に行われており、多言語サイトの構築で実績も豊富だ。
デバッグモードで詳細なエラー情報を取得する

REST API の 500 エラーは、通常の PHP エラーとは異なり debug.log に記録されない場合がある。そのため、wp-config.php に以下の定数を追加して、より詳細なエラー情報を取得する。
define( 'WP_DEBUG', true );
define( 'WP_DEBUG_LOG', true );
define( 'WP_DEBUG_DISPLAY', false );
define( 'SAVEQUERIES', true );さらに、ブラウザの開発者ツールで「ネットワーク」タブを開き、500 エラーを返している REST API リクエストを特定する。該当するリクエストの「レスポンス」タブを確認すると、サーバーから返された HTML のエラーページや JSON エラーオブジェクトが表示される。WordPress 7.0 では「このサイトで重大なエラーが発生しました」というメッセージが返ってくることが多い。
どうしてもエラーの詳細が取得できない場合は、wp-config.php に以下のコードを追加し、REST API エラー専用のログファイルを作成する方法もある。
add_action( 'rest_api_init', function() {
set_error_handler( function( $errno, $errstr, $errfile, $errline ) {
$log = sprintf( '[%s] %s:%d %s', date( 'Y-m-d H:i:s' ), $errfile, $errline, $errstr );
file_put_contents( WP_CONTENT_DIR . '/rest-api-errors.log', $log . PHP_EOL, FILE_APPEND );
});
}, 1 );このコードは REST API の初期化時にカスタムエラーハンドラを登録し、発生したエラーをすべて wp-content/rest-api-errors.log に記録する。問題が解決したら必ず削除すること。
よくある質問
Bogo の代わりに Polylang を使っても同様のエラーは出るか
Polylang は REST API との統合が設計段階から考慮されており、ブロックエディターとの組み合わせでも同様の 500 エラーが発生する可能性は極めて低い。実際に多くの多言語サイトで Polylang とブロックエディターの組み合わせが問題なく運用されている。移行を検討する価値は十分にある。
この問題は WordPress 7.0 以前のバージョンでも発生するのか
WordPress 6.x 系では報告が少なく、7.0 へのアップデート後に顕在化したケースが多い。ブロックエディターの内部実装が 7.0 で変更され、特定の REST API エンドポイントに対するリクエストのタイミングやパラメータの扱いが変わったことが影響していると考えられる。
クラシックエディターに切り替えた後、再びブロックエディターに戻せるのか
問題なく戻せる。クラシックエディターで作成した投稿は、ブロックエディターに戻した際に自動的にクラシックブロックとして読み込まれる。Bogo プラグイン側のアップデートで問題が修正されたら、クラシックエディタープラグインを無効化してブロックエディターに戻せばよい。
REST API のエラーはフロントエンドの表示にも影響するのか
今回の問題は管理画面のブロックエディター内に限定されており、公開済みサイトのフロントエンド表示には影響しない。カテゴリー一覧や投稿一覧の表示、多言語切り替え機能は通常どおり動作する。ただし、ブロックエディターでカテゴリーを選択・編集できないため、投稿の作成や編集作業に支障が出る。
functions.php にフィルターフックを追加する方法がわからない場合はどうすればよいか
最も安全な方法は、FTP クライアントまたはレンタルサーバーのファイルマネージャーを使い、子テーマの functions.php ファイルを編集することだ。操作に不安がある場合は、Code Snippets プラグインを利用して管理画面からコードを追加する方法もある。誤ったコードの追加はサイト全体に影響するため、必ず事前にバックアップを取得してから作業すること。
この記事のポイント
- Bogo 有効時にブロックエディターのカテゴリーパネルが空になるのは、REST API への lang パラメータ付与が競合を起こすため
- クラシックエディターに一時的に切り替えることで、即座に問題を回避できる
- functions.php にフィルターフックを追加し、管理画面からの REST API リクエストに対して Bogo の言語処理を抑制する方法もある
- 根本解決には Bogo プラグイン側のアップデートが必要で、状況によっては代替プラグインへの移行も検討する
- REST API の 500 エラーは debug.log に記録されないことがあるため、専用のエラーログ取得を設定すると原因特定が早まる

・ Reddit、Stack Overflow、WordPress.org フォーラムを日々巡回し、現場の悩みを拾い上げて記事化
・ WordPress、WooCommerce、Next.js などモダンWeb制作領域のトラブルシューティングが専門
・ 「検索しても答えが見つからなかった」を一つでも減らすことが目標
・ エラーメッセージから根本原因にたどり着く粘り強い調査が得意
・ 初心者がつまずきやすい箇所を先回りで解決する記事作りを心がけている

WooCommerceのメールが届かない時はWP Mail SMTPの「Force From Email」を確認
WP Mail SMTPのテストメールは届くのに、WooCommerceの注文確認や処理完了のメールだけが届かない場合、原因のほとんどはWP Mail SMTPで「Force From Email(送信元アドレスを強制)」の設定が無効になっていることだ。この設定を有効にし、WooCommerce側の送信元アドレスも確認すれば、数分で解決する。
なぜテストメールは届くのにWooCommerceのメールだけ届かないのか

WP Mail SMTPのテストメール機能は、管理画面から手動で送信した単体のメールだ。このとき、WP Mail SMTPは自分が設定されたSMTPサーバー情報(サーバー名、ポート番号、ユーザー名、パスワード)と認証用のメールアドレスを使ってメールを送る。テストが成功しているということは、SMTPサーバーとの通信自体は正常で、認証情報も間違っていない。
一方、WooCommerceが自動で生成するメール(新規注文、処理中、完了など)は、SMTPサーバーに直接接続するわけではない。内部的にWordPressのwp_mail()関数を呼び出し、WP Mail SMTPがそれをフックしてSMTP経由で配送する。この過程で問題になるのが送信元(From)アドレスの不一致だ。
多くのSMTPサービス(SendGrid、Gmail SMTP、Microsoft 365など)は、なりすまし防止のため、メールのFromヘッダーが認証済みのアドレスと一致しているか厳しくチェックする。WooCommerceはデフォルトで「wordpress@あなたのドメイン」のようなアドレスを送信元に設定するが、これがSMTP認証に使ったアドレスと違うと、SMTPサーバー側で送信が拒否される。テストメールはWP Mail SMTPが認証アドレスを直接使うので届く。ここが分かれ目だ。
上の図のように、WP Mail SMTPの認証アドレスとWooCommerceが使う送信元アドレスが異なると、SMTPサーバーは「このメールのFromは本当に認証された持ち主か?」と判断できず、配送を止めてしまう。解決にはWP Mail SMTP側でこの不一致を強制的に揃える設定が必要になる。
WP Mail SMTPの「Force From Email」を有効にする手順

まず試すべきは、WP Mail SMTPの設定画面にある「Force From Email」オプションを有効にすることだ。この設定は、WooCommerceを含むすべてのプラグインが生成するメールの送信元アドレスを、WP Mail SMTPに登録した認証アドレスで上書きする働きを持つ。これにより、SMTPサーバーがアドレスの不一致でメールを拒否する問題が解消される。
「Force From Email」が表示されない場合の確認ポイント
WP Mail SMTPの無料版(Free)には「Force From Email」のオプションが存在しないバージョンもある。設定画面の「From Email」セクションに項目が見当たらない場合は、以下の点を確認する。
- WP Mail SMTPが最新バージョンに更新されているか
- 有料版(Pro)を使っているか、無料版で機能が制限されていないか
- 「From Email」欄に認証アドレスと完全に同じメールアドレスを手動で入力しているか
無料版で「Force From Email」が使えない場合は、「From Email」欄にSMTP認証で使っているアドレスをそのまま手入力し、さらに後述のWooCommerce側の送信元設定も同じアドレスに揃える方法で対応できる。
WooCommerce側の送信元アドレス設定も揃える

WP Mail SMTPの「Force From Email」が有効でも、設定が競合したり予期しない挙動でうまくいかないケースがある。念のため、WooCommerce自体のメール送信元設定もSMTP認証アドレスに揃えておくと確実だ。
WooCommerceの「差出人アドレス」を変更する
管理画面の「WooCommerce」→「設定」→「メール」タブを開く。ページ上部に「差出人アドレス(From Address)」という項目がある。ここにWP Mail SMTPで認証したメールアドレスとまったく同じアドレスを入力する。デフォルトではドメイン名から自動生成されたアドレスが入っていることが多いので、上書きする。
同じ画面のすぐ上にある「差出人(From Name)」はショップ名など任意の表示名でかまわない。ここは認証とは関係なく、受信者のメールソフト上で「誰からのメールか」として表示されるだけだ。
個別のメールテンプレート設定は通常変更不要
「メール」タブの下部には「新規注文」「処理中」「完了」など個別のメール通知一覧がある。ここで各メールの「受信者アドレス」を設定できるが、送信元アドレスを個別に指定する項目は標準ではない。そのため、通常は上部の「差出人アドレス」だけ修正すれば十分だ。もし個別テンプレートをカスタマイズするプラグインを入れている場合は、そのプラグイン側でFromアドレスが上書きされていないか確認する。
その他の確認ポイント

WooCommerceからテストメールを送る方法
WP Mail SMTPのテストメールだけでなく、WooCommerce側からもメール送信をトリガーして確認したい場合は、管理画面の「WooCommerce」→「ステータス」→「ツール」タブを開き、「メールをテスト」機能を使う。ここで任意のメール種別(例「新しい注文」)を選んで「送信」ボタンを押すと、実際のWooCommerceメールが送信される。Force From Emailの設定後、このテストで届くかどうかを見るのが最も確実だ。
プラグインの競合を疑う
稀に、他のSMTPプラグインやメール関連プラグイン(メールテンプレートカスタマイザー、メールログプラグインなど)が共存していると、WP Mail SMTPのフックより先にメール処理を横取りしてしまうことがある。「Force From Email」とWooCommerce側の設定を合わせても改善しない場合は、以下の手順で切り分けを行う。
- WP Mail SMTP以外のメール関連プラグインをすべて無効化する
- 標準テーマ(Twenty Twenty-Fiveなど)に一時的に切り替える
- WooCommerceの「メールをテスト」で再度送信を試す
ここで届くようになれば、テーマかプラグインのどちらかに原因がある。1つずつ再有効化して原因を特定する。
SMTPサーバー側の送信ログを確認する
上記すべてを試しても解決しない場合、SMTPサーバー側でメールがどう処理されているかを確認する。SendGridやGmail SMTP、Microsoft 365など、利用しているSMTPサービスには管理画面があり、送信ログやアクティビティログを確認できる。WooCommerceが送信を試みた形跡があるか、エラーが出ているかを見ることで、問題の所在がWP Mail SMTPより先か後かを切り分けられる。
よくある質問
「Force From Email」を有効にしてもメールが届かない場合は?
WooCommerce側の「差出人アドレス」が認証アドレスと一致しているか再度確認する。また、WP Mail SMTPの「Force From Name」も併せて有効にすると、名前の不一致によるフィルタリングを回避できることがある。それでも改善しなければ、他のメール関連プラグインを無効化して競合を確認する。
SMTP認証のメールアドレスはどのアドレスを使うべきか
自社ドメイン(例 info@自社ドメイン.com)を使うのが最も信頼性が高い。Gmailの無料アカウントでも送れるが、1日の送信制限があり、ビジネス用途ではGoogle WorkspaceやSendGridなどの専用SMTPサービスが推奨される。いずれの場合も、認証に使ったアドレスと完全に同じものを送信元アドレスとして使う必要がある。
迷惑メールフォルダに入ってしまう場合はどうするか
SMTP認証を使っていても、SPFレコードやDKIM署名がドメインのDNSに正しく設定されていないと、迷惑メールに分類されることがある。WP Mail SMTPの設定画面から「メールテスト」を送った際に表示される診断結果で、SPFやDKIMの状態を確認できる。これらが未設定または失敗している場合は、利用しているSMTPサービスの指示に従ってDNSレコードを追加する。
この記事のポイント
- WP Mail SMTPのテスト成功はSMTP通信が正常な証拠で、問題は送信元アドレス不一致にある
- 「Force From Email」を有効にすれば、全プラグインの送信元アドレスが認証アドレスに強制統一される
- WooCommerce側の「差出人アドレス」設定も同じ認証アドレスに手動で揃えるとさらに確実
- 改善しない場合はメール関連プラグインの競合やSMTPサーバー側のログを確認する
- SPFやDKIMのDNS設定も合わせて確認すると、迷惑メール対策まで完結する

・ Reddit、Stack Overflow、WordPress.org フォーラムを日々巡回し、現場の悩みを拾い上げて記事化
・ WordPress、WooCommerce、Next.js などモダンWeb制作領域のトラブルシューティングが専門
・ 「検索しても答えが見つからなかった」を一つでも減らすことが目標
・ エラーメッセージから根本原因にたどり着く粘り強い調査が得意
・ 初心者がつまずきやすい箇所を先回りで解決する記事作りを心がけている

REST APIに非ログイン状態でアクセスできなくなった時の原因と解決手順
プラグインや本体のアップデートを機に、外部サービスからのREST APIリクエストが「Only authenticated users can access the REST API.」というエラーで拒否されるようになった場合、多くのケースではプラグインの認証設定が更新によって変更されている。まずは該当プラグインの「REST APIアクセスを許可する」設定を見直し、それでも改善しなければバージョン固有の不具合を疑う。
なぜアップデート後にREST APIが突然使えなくなるのか

WordPressのREST APIは、外部アプリやサービスとサイトがデータをやり取りするための共通の窓口だ。決済ゲートウェイの通知(ウェブフック)、モバイルアプリからの記事取得、別サーバーとの在庫連携など、多様な自動処理がREST APIを通じて動いている。
プラグインのバージョンアップでアクセスが遮断される原因は、大きく分けて二つある。ひとつはセキュリティ強化を目的とした仕様変更で、非ログインユーザー(未認証リクエスト)に対する制限が新たに追加、あるいは既定で有効化されたケースだ。もうひとつは、アップデート時のコードの不具合で「REST APIを許可する」設定が内部的に無視されてしまうケースである。
いずれの場合も、ウェブフックを受け取るサイト側では「ログインしていない外部からのPOSTリクエスト」として扱われるため、認証エラーが返ってしまう。ECサイトの決済通知や予約システムの在庫更新など、リアルタイム性が求められる連携ほど被害が大きい。
プラグイン設定でREST APIのアクセス制御を確認する

最初に行うべきは、該当プラグインの設定画面にREST API関連の項目が存在するかどうかの確認だ。多くのセキュリティ系プラグインやユーザー管理プラグインには「REST APIへのアクセスを制限する」「未認証ユーザーをブロックする」といったチェックボックスが用意されている。
管理画面から該当プラグインの設定ページを開き、「REST API」「APIアクセス」「外部リクエスト」「認証」などのキーワードを含む項目を探す。もし「未認証ユーザーのREST APIアクセスを無効にする」といった設定がオンになっていれば、これをオフに切り替えて保存し、外部からのリクエストが再び通るかをテストする。
設定項目の名称や位置はプラグインによって異なる。セキュリティタブの中にあったり、詳細設定の一番下に隠れていたりすることも多い。見つからない場合はプラグインのドキュメントや公式サポートフォーラムで「REST API permission」をキーに検索する。
プラグインのバージョンを切り戻して検証する

設定が正しく「許可」になっているにもかかわらずAPIが機能しない場合、プラグイン自体の不具合を疑う段階に入る。管理画面上は許可しているように見えて、内部的な処理では設定値を正しく読み取れていない可能性がある。
まずは該当プラグインの安定していた旧バージョンを入手し、手動でインストールし直す。公式プラグインディレクトリの「以前のバージョン」セクションや、プラグイン開発者がGitHubでリリースしているアーカイブからダウンロードできる。
切り戻しは次の手順で進める。プラグイン一覧画面で問題のプラグインを一度無効化し、削除する(設定データは残るため心配は不要)。続いて旧バージョンのZIPファイルを「プラグイン」→「新規追加」→「プラグインのアップロード」からインストールし有効化する。この状態で外部からのAPIリクエストが正常に処理されるかテストし、復旧を確認したら開発元に不具合報告を送る。
どうしても旧バージョンが入手できない場合は、WP Rollbackプラグインを使って管理画面から直接ダウングレードする方法もある。ただし本番サイトでの使用は慎重に行い、必ず事前にバックアップを取得しておく。
特定エンドポイントだけを許可するカスタム対応

セキュリティ上の理由からREST API全体を無制限に開放したくない場合は、必要なエンドポイントだけを選択的に許可する方法が有効だ。たとえば決済ゲートウェイのウェブフックは特定のルート(/wp-json/wc/v3/ordersなど)だけ通ればよい。
テーマのfunctions.phpに以下のようなフィルターを追加すれば、特定のRESTルートに対して認証要件を緩和できる。コードを直接書く場合は必ず子テーマを利用する。
add_filter( 'rest_authentication_errors', function( $result ) {
if ( ! empty( $result ) ) {
return $result;
}
if ( strpos( $_SERVER['REQUEST_URI'], '/wp-json/my-plugin/v1/webhook' ) !== false ) {
return true;
}
return $result;
});このコードは、指定したパス(上の例では/my-plugin/v1/webhook)へのアクセスに対して認証チェックをスキップし、それ以外のエンドポイントは通常の認証を維持する。プラグイン本体を修正せずに済むため、アップデートが来ても上書きされる心配がない。
フィルターを追加した後は必ず、許可したエンドポイントに外部からcurlコマンドやPostmanでテストリクエストを送り、意図したとおりに動作することを確認する。想定外のエンドポイントが開放されていないかも併せてチェックする。
リバースプロキシやWAFがリクエストを遮断していないか調べる

プラグインの設定もバージョンも問題ないのにAPIが機能しない場合、サーバー環境側でリクエストが遮断されている可能性がある。CDNのWAF(ウェブアプリケーションファイアウォール)、ホスティング側のセキュリティモジュール、あるいは.htaccessの記述が原因で、外部からのPOSTリクエストがブロックされているケースは意外に多い。
確認すべきはログだ。WAFを導入している場合はその管理画面で遮断ログを検索し、APIリクエストが誤検知でブロックされていないか調べる。サーバーのアクセスログでは、対象のエンドポイントにリクエストが到達しているかどうか、到達している場合のHTTPステータスコード(401や403なら認証・権限の問題、200系ならアプリケーション側で正常処理後にエラーが発生している)をチェックする。
とくに管理画面のURLを変更するプラグインや、xmlrpc.phpを無効化する設定が、間接的にREST APIのエンドポイントにまで影響を与えていることもある。これらの設定も一時的に解除してテストを行う。
よくある質問
どのプラグインがREST APIに影響を与えているか特定するには
全プラグインを一度無効化し、問題のエンドポイントに外部からアクセスして正常応答を確認する。その後、プラグインを1つずつ有効化しながら再テストすれば、原因のプラグインを絞り込める。テーマのfunctions.phpのカスタムコードも疑わしい場合は、標準テーマに一時的に切り替えて検証する。
外部サービスが受け取るエラーの内容を詳しく知るには
WordPressのREST APIは認証エラー時にJSON形式のエラーオブジェクトを返す。外部サービス側でHTTPレスポンスボディをログに残せるなら、codeとmessageの値を取得すれば原因の手がかりになる。ログが取れない場合は、curlで手動リクエストを送り、curl -vでレスポンスボディを直接確認する。
REST API全体を無効化せずにセキュリティを保つ方法はあるか
特定のIPアドレスからのみアクセスを許可する.htaccessの設定、APIキーやアプリケーションパスワードを使った認証の義務付け、あるいは必要なエンドポイントだけをホワイトリスト登録するカスタムコードで対応できる。無制限の全面開放は避け、必要最小限の権限に絞ることが安全面でも推奨される。
プラグインをダウングレードしても問題はないのか
セキュリティ修正や脆弱性対策を含むアップデートを巻き戻すことになるため、ダウングレードはあくまで一時的な回避策と位置づける。復旧を確認したら速やかに開発元へ報告し、修正バージョンがリリースされたらすぐに更新する。ダウングレード期間中はサイト全体の監視を強化する。
アップデート前のバージョンが不明な場合はどうするか
プラグイン一覧画面の「詳細を表示」から「開発」タブを開くと、過去のバージョン履歴が参照できる。または公式プラグインディレクトリの「Advanced View」に「Previous Version」のリンクが用意されている。どうしてもわからない場合は、バックアップから前回正常に動作していたプラグインファイルを復元する。
この記事のポイント
- プラグイン更新後にREST APIが遮断されたら、まず設定画面のアクセス制御項目を確認する
- 設定が正しくても動かない場合は、旧バージョンに切り戻して不具合を検証する
- 必要なエンドポイントだけをfunctions.phpのフィルターで選択的に開放できる
- WAFやサーバー設定がリクエストをブロックしていないかログで確認する
- ダウングレードは一時的な対策とし、修正版のリリースを待って更新する

・ Reddit、Stack Overflow、WordPress.org フォーラムを日々巡回し、現場の悩みを拾い上げて記事化
・ WordPress、WooCommerce、Next.js などモダンWeb制作領域のトラブルシューティングが専門
・ 「検索しても答えが見つからなかった」を一つでも減らすことが目標
・ エラーメッセージから根本原因にたどり着く粘り強い調査が得意
・ 初心者がつまずきやすい箇所を先回りで解決する記事作りを心がけている

WPManageNinjaプラグイン更新で不正コード混入 全亜種を検出するSQLと駆除手順
WPManageNinja のプラグインを更新したら不正なコードが紛れ込んだ場合、最も確実な検出方法はデータベースのオプション値を直接検索することだ。apii.observer というドメイン名を探す SQL クエリを実行すれば、影響を受ける全13プラグインの亜種を一網打尽にできる。
なぜ通常のプラグイン更新でバックドアが入り込んだのか

2026年7月31日、WordPress 用プラグインを多数提供する WPManageNinja 社の旧アップデートサーバーが侵害された。同社は以前に販売プラットフォームを移行しており、本来は停止しているはずの旧サーバーが生き残り、かつプロキシが一部の更新トラフィックをそちらに転送し続けていた。この時間帯に管理画面で「更新」ボタンを押したユーザーは、正規の更新チャネルを通じて悪意あるパッケージを受け取ってしまったのだ。
パスワード突破でも脆弱性攻撃でもなく、ただの更新作業が侵入口になった。このサプライチェーン攻撃の怖さは、更新ボタンを押したこと自体はまったく正常な運用であり、疑いようがない点にある。
影響を受ける13のプラグインを確認する

WPManageNinja 社が公開したインシデント対応資料には13のプラグインプロファイルが含まれている。一方、当初の告知では一部しか公表されていなかった。注意すべきなのは以下の全リストだ。
- azonpress
- fluent-affiliate-pro
- fluent-boards-pro
- fluent-booking-pro
- fluent-community-pro
- fluent-player-pro
- fluent-support-pro
- fluentcampaign-pro(FluentCRM)
- fluentform-signature
- fluentformpro
- ninja-tables
- wp-payment-form-pro(Paymattic)
- wp-social-ninja-pro
これら13種類のいずれかを利用しているサイトは、更新履歴の有無にかかわらず直ちに調査が必要だ。WPManageNinja 社からドメインリストがメールで送られていたとしても、それを鵜呑みにしてはいけない。実際に、リストに載っていないサイトからも感染が確認されている。
侵入されたサイトに見られる具体的な症状と隠蔽の仕組み

バックドアは、正規プラグインのフォルダ内に PHP ファイルを1つ追加し、既存のファイルの末尾に小さなローダーコードを追記する形で設置される。Fluent Forms Pro の例では、以下のようになっていた。
fluentformpro/libs/ に class-license-sync.php(39,743バイト)が存在
fluentformpro.php の22〜24行目に不正な require_once とクラス呼び出しが追記
正規のプラグインファイルのみ存在し、不正ファイルは削除済み
fluentformpro.php の行数がクリーンな状態に戻っている
このデモは Fluent Forms Pro におけるバックドアの有無を視覚化したものだ。
データベースには _wp_update_meta_cache や _site_transient_update_meta といったオプション名が書き込まれる。これらの名称は WordPress コアが使う一時データ(Transient)に酷似しており、ひと目見ただけでは異常と気づきにくい。オプションの値には攻撃者のコマンド&コントロールサーバーである apii.observer が含まれ、さらにサイト固有のトークンとログインキーが保存されていた。このログインキーはパスワードなしで WordPress 管理画面にログインできる「万能鍵」であり、ファイルを削除するだけでは不正アクセスのリスクは消えない。
全亜種を一発で検出するデータベースクエリ(WP-CLI)

63個のオプション名や26個の cron フックを個別に調べる必要はない。すべての亜種に共通する特徴は、C2 サーバーアドレス apii.observer をオプションの値として持っていることだ。したがって、次の1行のクエリで全13プラグインの感染を一括検出できる。
PREFIX=$(wp db prefix)
wp db query "SELECT option_name FROM ${PREFIX}options \
WHERE option_value LIKE '%apii.observer%'" --skip-column-namescron ジョブまで同時に調べたい場合は以下のように拡張する。
wp db query "SELECT option_name FROM ${PREFIX}options \
WHERE option_value LIKE '%apii.observer%' \
OR option_value LIKE '%wp_update_check_schedule%'" --skip-column-names
wp cron event list --fields=hook,next_run_relative \
| grep -E "wp_update_check_schedule|wp_license_verify_schedule"このアプローチの本質は「マルウェアが自らのサーバーと通信しなければならない」という不変の事実を突く点にある。シグネチャリストは古くなるが、通信先のドメインはそう簡単には変わらない。覚えておいて損はない手法だ。
sFTP しか使えない場合のファイルチェック方法

レンタルサーバーによっては SSH が提供されず、WP-CLI も使えないことがある。その場合は sFTP 経由でファイルを確認する。Python の paramiko ライブラリを使った検出スクリプトが有効だが、重要なのは「確実に読めたと言える状態だけをクリーンと判定する」ことだ。
この判定フローは、読み取り失敗を「感染していない」と誤認させないための安全策だ。
より確実な方法として、販売元のアカウントからクリーンなプラグイン ZIP をダウンロードし、サーバー上のファイル群とファイルサイズを比較する手段もある。手元のクリーンコピーに存在しないファイルや、サイズが異なるファイルがあれば、それが不正コードの証拠になる。
安全かつ完全な駆除手順(ファイルとデータベースの順序が重要)

駆除で最も失敗しやすいのが「データベースから先に削除する」手順だ。残ったファイルの cron が再度データベースに不正な行を書き込んでしまう。必ず以下の順序で実施する。
1. 感染したプラグインフォルダを削除し、クリーンな ZIP から再インストールする
wp plugin delete fluentformpro
wp plugin install /path/to/fluentformpro-clean.zip --activate
wp plugin get fluentformpro --field=versionバージョン番号を必ず確認し、6.2.8 や 6.2.9 といったアップデータ経由の古い番号が表示されたら、ZIP からの再インストールが正しく行われていない可能性がある。
2. データベースから不正なオプションと cron を削除する
PREFIX=$(wp db prefix)
# まず内容を確認
wp db query "SELECT option_name FROM ${PREFIX}options \
WHERE option_value LIKE '%apii.observer%'"
# 削除実行
wp db query "DELETE FROM ${PREFIX}options \
WHERE option_value LIKE '%apii.observer%'"
# cron イベントも削除
wp cron event delete wp_update_check_schedule
wp cron event delete wp_license_verify_schedule3. ソルトを変更し、すべてのセッションを無効化する
wp config shuffle-salts で wp-config.php に定義されたソルト(8つのキー)を新しい値に置き換える。これにより、攻撃者が入手したログインキーを含むすべての既存セッションが強制ログアウトされる。
wp config shuffle-saltsその後、管理者パスワードを手動で変更する。ソルトの更新はパスワードそのものを上書きしないからだ。
4. 駆除後は状態を読み取って必ず検証する
削除コマンドの成功メッセージを信用してはいけない。cron 削除が正常に受け付けられても、実際には実行されずにスケジュールが残っているケースがある。再度クエリを実行し、返却行数がゼロであることを目視確認する。
wp db query "SELECT option_name FROM ${PREFIX}options \
WHERE option_value LIKE '%apii.observer%'" --skip-column-names
# 出力が完全に空であることを確認
wp cron event list --fields=hook,next_run_relative \
| grep -E "wp_update_check_schedule|wp_license_verify_schedule"
# 同じく出力が空であることを確認最後に wp option get blogname やサイトのトップページ表示で WordPress が正常に起動していることを確かめる。
WP-CLI が使えない環境でのソルト変更と安全策

レンタルサーバーの制限や独自コネクターの仕様で wp config shuffle-salts が使えない場合は、FTP 経由で wp-config.php を直接編集する。このとき、次の点を徹底する。
- 現在の wp-config.php を必ずローカルにバックアップする。
- WordPress.org のソルト生成 API から新しい値を取得し、8つの define 文すべてを置換する。
- 8つすべてを見つけられなかった場合は作業を中断する。部分的な置換はサイトを破壊する。
- 置換後のファイルサイズが数百バイト以上変化していないか確認する。
- アップロード後にサーバーからファイルを読み戻し、意図した内容かをバイト単位で比較する。
- データベースパスワードを含むため、ファイル内容をログやターミナルに絶対に出力しない。
複数サイトをスクリプトで一括処理する場合は、1サイトごとに別プロセスで実行し、数秒の待機を挟む。連続したリクエストはサーバーのアンチボット機能にブロックされる原因になる。HTTP 202 や 429 が返ったら即座に全処理を停止する。
よくある質問
プラグインを更新していないのに感染する可能性はあるか
今回の経路は更新操作に限られる。ただし、過去に更新したタイミングが問題の時間帯と重なっていれば、更新していないつもりでも感染している場合がある。cron による自動更新が有効なら、手動更新していなくても該当する。
wp-config.php のソルトを変更するとどうなるか
そのサイトにログインしているすべてのユーザーが強制的にログアウトされる。パスワードは変わらないため、同じパスワードで再ログインは可能だ。「Remember Me」で保存されたセッションも無効になる。
感染したかどうか管理画面から判断できるか
見た目にはまったく変化がない。管理画面の表示や動作に異常が出ないよう設計されているため、プラグイン一覧や更新画面から気づくことはほぼ不可能だ。
データベースのバックアップから復元しても大丈夫か
バックアップの中に不正オプションが含まれていれば、復元で再感染する。リストア前に必ずバックアップの SQL を確認し、apii.observer を含む行がないか検索しておく必要がある。
WAF やセキュリティプラグインで防げたか
この攻撃は正規の更新チャネルを経由しているため、一般的な WAF やマルウェアスキャナーでは検知できない。実際に複数のセキュリティプラグインが稼働している状態でも、バックドアファイルを無害と判断した事例が報告されている。今回の経験から、セキュリティプラグインの「異常なし」を鵜呑みにしないことが重要だ。
この記事のポイント
- WPManageNinja の当該13プラグインを利用しているサイトは、更新の有無にかかわらず即座に調査する。
- 全亜種の検出は
apii.observerを含むオプション値を SQL で LIKE 検索するのが最速かつ確実。 - 駆除は「プラグインフォルダの再インストール」→「データベース削除」→「ソルト変更とパスワード変更」の順序厳守。
- 削除後は成功メッセージを信じず、再度クエリを実行してゼロ件を目視確認する。
- ソルト変更だけではパスワードは変わらない。管理者パスワードも忘れずに変更する。

・ Reddit、Stack Overflow、WordPress.org フォーラムを日々巡回し、現場の悩みを拾い上げて記事化
・ WordPress、WooCommerce、Next.js などモダンWeb制作領域のトラブルシューティングが専門
・ 「検索しても答えが見つからなかった」を一つでも減らすことが目標
・ エラーメッセージから根本原因にたどり着く粘り強い調査が得意
・ 初心者がつまずきやすい箇所を先回りで解決する記事作りを心がけている

Premium Addonsの更新で重大なエラーが出た時の原因と対処法
Premium Addons for Elementor の更新後に「このサイトで重大なエラーが発生しました」と表示されサイトが落ちる場合、原因は更新パッケージのファイル欠損や破損にある。is_widget() メソッドが見つからないエラーがログに記録されているなら、プラグインの手動再インストールで解決する可能性が高い。
なぜ Premium Addons の更新で致命的エラーが起きるのか

Premium Addons 4.11.91 から 4.11.93 への更新中に「このサイトで重大なエラーが発生しました」が表示されるケースでは、エラーログに Call to undefined method PremiumAddons\Modules\Woocommerce\Module::is_widget() が記録される。
このエラーは、WordPress の自動更新や管理画面からのワンクリック更新を実行した際に、プラグインのファイル一式が完全に展開されず、一部の PHP ファイルが欠損した状態でバージョンだけが切り替わった場合に発生する。module-base.php が is_widget() メソッドを呼び出そうとしたタイミングで、その定義が存在せず PHP が致命的エラーを返す仕組みだ。
この種のエラーは Premium Addons に限らず、大規模なアドオン系プラグインの更新時に時折見られる。サーバーの実行時間制限やメモリ不足が引き金になることもあるが、今回は開発元が更新パッケージの不備を認めて修正版を再提供している。つまり原因は利用者側の環境ではなく、配信された更新ファイル自体の不備だ。
PremiumAddons\Modules\Woocommerce\Module::is_widget()
このデモは、ファイル欠損が原因で起こる典型的なエラーパターンとその解消後の状態を示している。
手動でプラグインを再インストールする手順

自動更新でエラーが起きた場合、有効な解決策は修正版の ZIP ファイルを入手し手動でアップロードすることだ。以下の手順で進める。
手動アップロードによる上書き更新は、ファイルの破損や欠損を確実に修復できる方法だ。
公式サイトから ZIP を入手する
Premium Addons は WordPress.org の公式プラグインディレクトリで配布されている。検索エンジンで「Premium Addons for Elementor WordPress」を検索し、プラグインページの「ダウンロード」ボタンから ZIP ファイルを取得する。有料版を使っている場合は、購入元のアカウントページから最新バージョンをダウンロードする。
管理画面から ZIP をアップロードする
「プラグイン」→「新規追加」を開き、ページ上部の「プラグインのアップロード」ボタンをクリックする。ファイル選択画面で先ほどダウンロードした ZIP を選び、「今すぐインストール」を押す。WordPress が「すでにインストールされています」と検出した場合、「現在のものをアップロードしたものに置き換える」という選択肢が出るのでそれを選ぶ。
キャッシュを完全にクリアする
プラグインの上書きが完了したら、サイトのキャッシュを徹底的に削除する。キャッシュ系プラグイン(W3 Total Cache や WP Super Cache など)の「全キャッシュ削除」機能を実行し、さらにブラウザのキャッシュもクリアする。サーバー側で Nginx FastCGI キャッシュや Redis オブジェクトキャッシュを使っている場合はそれらも合わせてクリアする。
それでもエラーが続く場合の追加対応

エラーログの詳細を確認する
手動再インストール後もエラーが続くなら、まず WooCommerce のステータスログを開く。「WooCommerce」→「ステータス」→「ログ」タブから、fatal-errors で始まる最新のログを確認する。別のメソッドやファイルでエラーが出ている場合、プラグインの競合が原因である可能性が高い。
プラグイン競合の切り分けを実施する
Premium Addons 以外の全プラグインを一時的に無効化し、WordPress の標準テーマ(Twenty Twenty-Five など)に切り替える。その状態で Premium Addons だけを有効にしてエラーが再現するか確認する。ここで問題が解消すれば、無効化したプラグインの中に競合相手がいる。
開発元に修正版をリクエストする
公式リポジトリのバージョンでもエラーが解消しない場合は、Premium Addons のサポートフォーラムにエラーログ全文と環境情報(WordPress バージョン、PHP バージョン、Elementor バージョン)を添えて報告する。開発元が個別の修正パッケージを提供してくれることがある。
よくある質問
管理画面すら開けない状態でどうやって直せばいいか
FTP クライアントまたはレンタルサーバーのファイルマネージャーで /wp-content/plugins/premium-addons-for-elementor/ ディレクトリを一旦リネームする。これでプラグインが無効化され管理画面にアクセスできるようになる。その後、正しい ZIP を展開し直して元のディレクトリ名に戻し、管理画面から有効化する。
WooCommerce を無効にすればエラーは出なくなるのか
エラーの発生箇所が WooCommerce 用モジュールであるため、WooCommerce 本体を無効化すればこの特定のエラーは止まる。しかしショップ機能が完全に停止するため、恒久対応にはならない。あくまで緊急避難として認識し、速やかに Premium Addons の修正を行うべきだ。
自動更新を止めて手動更新に切り替えるべきか
Premium Addons に限って一時的に自動更新を無効化するのは有効な予防策だ。「プラグイン」画面で該当プラグインの「自動更新を有効化」のチェックを外せば、次回以降の更新は手動で制御できる。問題が完全に解決したと確認できた後に再度自動更新を有効化すればよい。
PHP のバージョンが原因ということはあるか
Premium Addons は PHP 8.3 に対応しているため、今回の is_widget() エラーは PHP バージョンに起因するものではない。ただし PHP 8.x 系ではメソッドの未定義エラーが例外ではなく致命的エラーとして扱われるようになったため、以前の PHP 7.x 系では警告で済んでいた問題がサイト停止に直結するようになっている。
この記事のポイント
- Premium Addons 更新後の重大なエラーは、更新ファイルの欠損や破損で定義されていないメソッドを呼び出すのが原因
- 手動で最新の ZIP ファイルをアップロードして上書きすれば解決する
- キャッシュの全削除を忘れずに行う
- 再発防止として自動更新の一時停止や更新前のバックアップが有効
- FTP からのプラグイン無効化は管理画面にアクセスできないときの最終手段

・ Reddit、Stack Overflow、WordPress.org フォーラムを日々巡回し、現場の悩みを拾い上げて記事化
・ WordPress、WooCommerce、Next.js などモダンWeb制作領域のトラブルシューティングが専門
・ 「検索しても答えが見つからなかった」を一つでも減らすことが目標
・ エラーメッセージから根本原因にたどり着く粘り強い調査が得意
・ 初心者がつまずきやすい箇所を先回りで解決する記事作りを心がけている

PHP 8.5で(boolean)キャストの非推奨警告が出た時のWordPressでの対処法
PHP 8.5にバージョンアップしたWordPressサイトで「Non-canonical cast (boolean) is deprecated」という警告が表示されたら、(boolean)と書かれたキャストを(bool)に置き換えるだけで解消する。これはPHP 8.5で非正規のスカラー型キャストが非推奨になったためで、テーマやプラグインのコードを修正する必要がある。
PHP 8.5で非推奨になった(boolean)キャストとは

PHPは長らく、変数の型を変換するために(boolean)や(integer)といった別名のキャスト記法を受け入れてきた。しかしPHP 8.5から、これらの「正式でない(non-canonical)」表記は非推奨として扱われ、実行時にDeprecation警告が発生する。ブーリアン型へのキャストは(boolean)ではなく(bool)を、整数型は(integer)ではなく(int)を使うようPHP本体が求めるようになったのだ。
この変更は将来のバージョンで古い記法を完全に削除するための前段階で、今のうちに修正しないと、PHP 9.0以降で致命的エラーに変わる可能性がある。WordPressのテーマやプラグインのコードにこうした古いキャストが残っていると、サイトのエラーログに大量の警告が出力されたり、デバッグモードで画面に表示されたりする。
この警告がWordPressサイトで発生するケース

実際にWordPressでこの警告が出るのは、プラグインが原因であることがほとんどだ。たとえばカスタムフィールドを拡張する有名な「Pods」プラグインの古いバージョンでは、オートコンプリートフィールドの必須設定などを処理する部分で(boolean)キャストを使っており、PHP 8.5環境では次のような警告が発生する(実例を簡略化して示す)。
Deprecated: Non-canonical cast (boolean) is deprecated, use the (bool) cast instead in /var/www/example.com/wp-content/plugins/pods/classes/fields/pick.php on line 1113同じ警告は、他のカスタムプラグインや古いテーマでも起こり得る。共通するのは「(boolean)」「(integer)」といったエイリアス表記がコード内に存在し、かつサーバーのPHPバージョンが8.5以上になっているという条件だ。PHP 8.4までなら問題なく動作していたサイトが、アップグレードした途端に警告まみれになる典型例といえる。
警告を解消するための具体的な対処法

解決の根本は、警告が指摘するファイル内の(boolean)を(bool)に書き換える一手間だけだ。ただし、プラグイン本体を直接編集するとアップデートで上書きされてしまうため、一時的な対処か、プラグイン開発者へ修正を依頼するのが本筋になる。ここではサイト管理画面からFTPやファイルマネージャーでアクセスできる場合の手順を示す。
修正が必要なファイルと行を特定する
警告メッセージにはファイルのパスと行番号が明示されている。たとえば「/var/www/example.com/wp-content/plugins/pods/classes/fields/pick.php on line 1113」のように表示されるので、そのパスを頼りに該当ファイルを開く。サーバー上のパスはサイトのドキュメントルートからの絶対パスで示されるため、FTPクライアントやサーバー管理ツールのファイルマネージャーで同じディレクトリを探せばよい。
コードエディタで(boolean)を(bool)に置換する
該当行を開いたら、まずバックアップを取った上で編集を始める。書き換えは極めて単純で、(boolean)という文字列を(bool)に置き換えるだけだ。同じファイル内に複数箇所ある可能性が高いので、エディタの検索機能を使って「(boolean)」をすべて検索し、該当行をまとめて修正すると確実に警告を一掃できる。もし(integer)や(real)など他の非推奨キャストも見つかれば、それぞれ(int)や(float)へ変更しておく。
修正後に動作確認とログのチェックを行う
ファイルを上書き保存したら、必ずWordPressのデバッグモードを有効にしてwp-config.phpにdefine('WP_DEBUG', true);を設定し、サイトを数ページ表示して同種の警告が消えたことを確認する。デバッグモードを無効にしていてもサーバーのPHPエラーログには記録されるため、ログを監視している場合はそちらでも最終チェックを行う。修正が完了したら、デバッグモードは元に戻しておく。
プラグイン開発者向けの恒久対応と注意点

自作プラグインの開発者や、クライアントワークで修正依頼を受ける制作者は、より根本的な対応を検討すべきだ。PHP 8.5の非推奨変更は、コード全体にわたって古いキャストが使われていないか一括でチェックする良い機会になる。
エディタの正規表現検索で「\(boolean\)」「\(integer\)」「\(real\)」「\(double\)」といったパターンを検索し、それぞれ(bool)、(int)、(float)、(float)へ置き換えると効率的だ。なお(real)と(double)はどちらも浮動小数点数型を意味するエイリアスで、いずれも(float)が正式なキャストになる。
ただし、プラグインの互換性を保つために、PHP 8.5専用のコードに一気に書き換えるのではなく、バージョン分岐と組み合わせる方法もある。if (version_compare(PHP_VERSION, '8.5', '>=')) {で新しいキャストを使い、それ以前は従来の記法を残すといった対応だ。とはいえ(bool)自体はPHP 4から存在する極めて古い正式キャストなので、事実上すべてのバージョンで動作する。互換性を気にする必要はほとんどない。
よくある質問
PHP 8.5以外のバージョンでもこの警告は出るのか
いいや、PHP 8.5で初めて「Non-canonical cast」の非推奨警告が導入された。PHP 8.4以下では(boolean)は問題なく動作し、警告も出ない。ただしPHP 9.0ではエラーに格上げされる見込みのため、早めに対処しておくと将来的に安全だ。
警告を放置してもサイトの動作に問題はないのか
現時点ではDeprecation警告であり、サイトの表示や動作が止まることはない。しかしデバッグモードがオンの場合、画面上部に警告が表示されてレイアウトが崩れたり、エラーログが膨大になってサーバーのディスクを圧迫する可能性がある。長期的にはPHPのバージョンアップでエラーになるため、放置は推奨しない。
プラグインのアップデートで自動的に修正されるのか
プラグイン開発者が修正をリリースすれば、アップデートするだけで警告は解消される。たとえばPodsプラグインでは既にこの問題が報告されており、近いバージョンで(bool)への書き換えが行われる可能性が高い。開発者にフィードバックを送ることも有効な手段だ。
警告を非表示にするだけの対処は可能か
wp-config.phpでdefine('WP_DEBUG', false);にすれば管理画面やフロントエンドへの表示は止められる。ただしPHPのエラーログには記録され続けるため、根本解決にはならない。また、error_reportingを変更してDeprecationを抑制する方法もあるが、他の重要な非推奨警告も見逃すためおすすめできない。コードを修正するのが最も確実で手間も少ない。
子テーマや自作コードがない場合、どこを修正すればいいのか
該当するプラグインのファイルを直接編集しなければならないが、前述のとおりアップデートで上書きされるリスクがある。恒久的な対策としては、プラグインの開発者に修正を依頼するか、GitHubなどでプルリクエストを送るのが理想的だ。どうしてもすぐに警告を消したい場合は、修正後にプラグインの自動更新を停止しておき、次期バージョンで公式対応されるまで手動管理する手もある。
この記事のポイント
- PHP 8.5で
(boolean)キャストは非推奨になりDeprecation警告が出る (boolean)を(bool)に書き換えれば警告は消える- 警告メッセージのファイルパスと行番号を頼りに修正箇所を探す
- 修正は単純な置換だがバックアップを取ってから行う
- プラグイン本体の編集はアップデートで上書きされる点に注意

・ Reddit、Stack Overflow、WordPress.org フォーラムを日々巡回し、現場の悩みを拾い上げて記事化
・ WordPress、WooCommerce、Next.js などモダンWeb制作領域のトラブルシューティングが専門
・ 「検索しても答えが見つからなかった」を一つでも減らすことが目標
・ エラーメッセージから根本原因にたどり着く粘り強い調査が得意
・ 初心者がつまずきやすい箇所を先回りで解決する記事作りを心がけている
