WordPress総合ポータルテーマ開発のトラブルシューティング
テーマ開発中によく遭遇するトラブルとその対処法をまとめました。エラーの種類ごとに、まず確認すべきポイントを解説します。
真っ白な画面（500エラー・White Screen of Death）
PHPの構文エラーが最も多い原因です。wp-config.phpに以下を追記してデバッグモードを有効化し、エラーメッセージを確認してください。
define('WP_DEBUG', true);
define('WP_DEBUG_LOG', true);
define('WP_DEBUG_DISPLAY', false);
本番環境では必ず無効化WP_DEBUG_DISPLAYをtrueのままにすると、エラー詳細が訪問者に表示されてしまいます。デバッグ後は必ずfalseに戻してください。
CSSが反映されない
wp_enqueue_style()が正しく呼び出されているか確認- ブラウザのキャッシュをクリアして再読み込み
- キャッシュプラグインを使っている場合は、プラグイン側のキャッシュもクリア
作成したテンプレートが読み込まれない
テンプレート階層のルールに従ってファイル名が正しいか確認してください（例：single-case_study.phpのようにポストタイプ名が正確か）。パーマリンク設定を一度「保存」し直すと解決する場合もあります。
「関数が見つかりません」エラー
関数名の重複、またはfunctions.php内での記述順序（関数を使う前に定義していない）が原因であることが多いです。同名の関数がプラグイン側で既に定義されていないかも確認してください。