WordPressのタクソノミーページで「画像が表示されない」「Undefined variable の警告が出る」といったトラブルは、テンプレートの構造が複雑になったときに起こりやすい不具合の一つです。

特に、複数カテゴリを1つのテンプレートファイルで管理している場合、変数のスコープや配列の上書きが原因で、突然表示が崩れることがあります。

今回は、タクソノミーごとに画像やテーブルを出し分けている構造で発生した不具合の原因と、再発防止を意識した修正対応についてまとめます。

今回のご相談内容

タクソノミーページの一部で、

• 製品画像が表示されない
• ページ上部の表示が崩れている
• PHPのWarningが出ている

というご相談をいただきました。

以前は正常に表示されていたため、「どこかの修正が影響している可能性が高い」状況でした。

発生していた症状・エラー内容

確認したところ、以下の状態が発生していました。

• 特定タクソノミーで画像が表示されない
• Undefined variable の警告が表示される
• 条件分岐（elseif）が大量に並んでいる

表示だけの問題ではなく、テンプレート内部の構造が崩れ始めている状態でした。

原因の特定ポイント

今回の原因は、主に以下の3点でした。

1. 変数のスコープ問題

テンプレート内で定義した変数を、関数内でそのまま使用していました。
PHPでは、関数外で定義した変数は自動的には参照できません。

そのため、関数内で未定義扱いとなり、Warningが発生していました。

2. 配列の上書き

画像用の配列を途中で再定義してしまい、それまで設定していた画像情報が消えていました。

これにより、該当タクソノミーで画像が表示されなくなっていました。

3. 条件分岐の肥大化

if / elseif が大量に並んでおり、修正のたびに構造が複雑化していました。

この状態では、

• 1か所の変更が他へ影響
• 重複定義
• 見落とし

が起きやすくなります。

実際に行った対応内容

今回の対応では、単なる修正ではなく、「今後壊れにくい構造」へ再設計しました。
具体的には、

• 画像管理を配列（slug => path）に統一
• 画像出力を専用関数に一本化
• 条件分岐を整理
• 未定義変数が出ない構造へ修正

といった対応を行いました。

これにより、画像表示ロジックが1箇所で管理できる状態になりました。

対応後の結果・改善点

修正後は、

• 画像が正常表示
• Warningが完全に消失
• コードの可読性向上
• 今後の追加機種も配列1行追加で対応可能

という状態になりました。

見た目だけでなく、内部構造も安定しました。

今回の対応から分かったこと

今回あらためて感じたのは、
「動いているから大丈夫」ではなく
「壊れにくい構造かどうか」が重要だということです。

テンプレートが大きくなるほど、配列管理や関数化による整理は不可欠になります。

後から直すより、早めに構造を整える方が結果的に安全です。

同様のトラブルを防ぐために

以下のような状態になっている場合は注意が必要です。

• elseifが何十行も続いている
• 同じ変数名を何度も再定義している
• 画像やリンクが直書きで散らばっている

このような構造は、将来的なトラブルの温床になります。

一度整理しておくことで、保守コストも大きく下がります。

メディアプライムスタイルのサポートについて

メディアプライムスタイルでは、

• WordPressの表示崩れ修正
• テンプレート構造の整理
• 壊れにくい設計への再構築
• 保守を見据えたコード改善

などの対応を行っています。

「急に表示がおかしくなった」
「エラーは出ているけど原因が分からない」

そんなときは、無理に触らず一度ご相談ください。
内部構造まで含めて、丁寧に整えていきます。