Cocoon設定の各設定タブを押しても表示されない問題と解決方法

WordPress(ワードプレス)のテーマCocoonのCocoon設定画面の各設定タブを選択しても、設定画面が何も表示されない問題が発生したので、その時の解決方法についてメモ程度に書いています。あと、PHPとWordPressのエラー・警告ログの画面出力の設定についても説明しています。

※ 本ページはプロモーションが含まれています。

目的(エラー内容)と動作環境

最終更新日:2022/2/28

WordPressで人気テーマ(外観)のCocoonをインストールしてみたのですが、WordPress管理画面(ダッシュボード)の左サイドバーの"Cocoon設定"を選択してCocoon設定画面を開くと各種設定タブは表示されるけど、この各種タブを選択しても何の反応もなく設定画面がまったく表示されない問題が発生したので、この問題の解決するためにやった事を書いていきます。
(WordPress)テーマCocoon設定で各種設定タブを押しても何も表示されないエラー発生

また、PHPとWordPressのエラーや警告のログを画面に出力する設定についても説明しています。

■環境は以下の通りです。
OS:CentOS Linux 7.9
WordPress:5.9
ウェブサーバ:Apache2.4
PHP:7.4
MariaDB:10.6

上記環境は、自分のPCのVagrant上で各ミドルウェアをインストールしてWordPressの動作環境を構築しました。その時の環境構築については別ページで書いていますので、良ければ参考にしてください。
WordPress環境構築サイトマップ

PHPやWordPressのエラーログを画面に出力してみる(php.iniとwp-config.phpの設定)

まず、Cocoon設定の各タブを押しても何も表示されず、うんともすんとも言わない状況だったので、とりあえずエラーや警告があるなら出力させてみようと考えて、PHPとWordPressのエラーや警告ログが画面に出力するように設定してみました。ただ結論から言うと、エラー・警告ログを画面に出力するようにしても何も出力されなかったので、問題解決の糸口にはなりませんでした。

ただ、ここでエラー・警告ログを画面に出力させるようにした設定についてメモ書き程度に書いておきます。

PHPのエラーログの画面出力のために、php.iniファイルの"display_errors"をOffからOnに変更します(php.iniファイルのパスは各々の環境によると思いますが、シェル上で"php --ini"、"php --info"コマンドかPHPのphpinfo()関数でわかります)。
・変更前

display_errors = Off
・変更後
display_errors = On

また、php.iniの"error_reporting"の値も変更して、PHPのエラー・警告、注意箇所を出力するようにします。
・変更前

error_reporting = E_ALL & ~E_DEPRECATED & ~E_STRICT
・変更後
error_reporting = E_ALL | E_STRICT

php.iniファイルを変更したら、Apacheを再起動して変更を反映させます(たぶん再起動'restart'でなくても、リロード'reload'でも反映すると思う)。

$ sudo systemctl restart httpd

あと、WordPressのエラーログの出力のために、WordPress本体ディレクトリの直下にあるwp-config.phpファイルの"WP_DEBUG"を、falseからtrueへ変更します。
・変更前

define( 'WP_DEBUG', false );
・変更後
define( 'WP_DEBUG', true );

以上のログ出力設定をしてみたけど結局エラーや警告は何も出力される事はなく問題を発見できませんでした。
あと設定変更をして試し終わったら、設定を戻す事を忘れないようにしましょう。

[広告] WordPressのセキュリティ本の紹介

WordPressセキュリティ大全

WordPress運営者向けのセキュリティ本です。WordPressのセキュリティ脆弱性・基本知識についてや、WordPressのセキュリティ対策の設定やセキュリティ対策のプラグインなどが紹介されています。
WordPressのセキュリティが気になっていたり、基本的な事を抑えておきたい、セキュリティについて自信がない入門者・初心者向けの1冊です。

php-xmlをインストールしてみる

次に、クライアント環境(MacOS+Chrome)の問題かもしれないと考えて、Chromeのデベロッパーツール「Developer Tools」でJavaScriptのエラーログが何か出てないか確認してみたけど、それらしいエラーログは一切出ていませんでした。

そもそも同じクライアント環境(MacOS+Chrome)で別環境(レンタルサーバ)のWordPressのCocoon設定を確認したら、問題なく各設定タブの表示はされたのでクライアント環境は関係ないと思いこの線も終了。

次に、ネットで調べていたらPHPのモジュールの"php-xml"が必要かもしれないという情報があったのでインストールしてみました(remi-php74リポジトリを指定)。

$ sudo yum --enablerepo=remi-php74 install php-xml

リポジトリを指定する必要がない環境なら、このコマンドで良いと思います。

$ sudo yum install php-xml

php-xmlのインストールが終わったら、Apacheを再起動します。

$ sudo systemctl restart httpd

これでCocoon設定画面を開いて各設定タブを押したら、ちゃんと設定画面が表示されるようになりました。