はじめに
ここでは、WordPressの管理画面でJavaScriptが正常に動作しない場合の対処法について解説します。JavaScriptが動かない状況は、プラグインやテーマの不具合、サーバー設定の問題などにより発生することがあります。
症状・背景
この記事が必要になる主な場面:
- WordPress管理画面で一部の機能が使用できない
- JavaScript関連のエラーメッセージが表示される
- テーマやプラグインを更新した後
- サイトを移転（引っ越し）した直後
手順・設定方法
ステップ1: ファイルのパーミッションを確認する
# WordPressディレクトリの権限を確認します。
ls -l /var/www/html/wordpress/
# 必要に応じて、wp-contentディレクトリの権限を変更します。
chown -R www-data:www-data /var/www/html/wordpress/wp-content
chmod -R 755 /var/www/html/wordpress/wp-contentステップ2: ファイルのキャッシュをクリアする
# wp-cliを使用してオブジェクトキャッシュを削除します。
wp cache flush
# .htaccessファイルのキャッシュをクリアします（必要に応じて）。
rm -f /var/www/html/wordpress/.htaccessステップ3: テーマとプラグインをデバッグモードで有効にする
# wp-config.phpファイルを開き、次の行を追加または修正します。
define('SCRIPT_DEBUG', true);
# WordPressの管理画面からテーマやプラグインの更新を行います。ステップ4: プラグインとテーマの不具合を切り分ける
# アクティブなすべてのプラグインを一時的に無効化します。
wp plugin deactivate --all
# WordPress標準テーマ（Twenty Twenty-Twoなど）に切替えて、問題が解消するか確認します。注意事項
- サーバー設定の変更は必ずバックアップから行う
- PHPバージョンが古い場合やPHP設定が原因の場合もあるので、それを確認することを忘れないでください
- 一部のプラグインは最新版に更新されていることを確認してください
- テスト用のサブドメインや子ディレクトリで動作確認を行うと安心です
まとめ
1. ファイルパーミッション: WordPressディレクトリとwp-contentディレクトリの権限を適切に設定することが重要です。
2. キャッシュクリア: キャッシュが原因でJavaScriptが正常に動かない場合があります。定期的にキャッシュをクリアしましょう。
3. デバッグモード: テーマやプラグインの問題を特定するためには、デバッグモードを有効にしてログを確認することが役立ちます。
4. プラグイン無効化: 一部のプラグインが原因でJavaScriptが動かない場合があります。個々のプラグインを無効にし、影響のあるものを特定します。
関連記事: