WordPressのショートコードが文字のまま表示される｜消す前に確認する5つの原因

WordPressの公開ページに、問い合わせフォームや予約表ではなく、角括弧で囲まれたショートコードが文字のまま表示されることがあります。

この状態でショートコードを削除すると、本来表示するはずだった機能まで失われます。先に、コードを発行したプラグイン、設置場所、直前に行った更新を確認します。

編集画面で文字に見えるだけなら異常とは限らない

ショートコードは、編集画面では次のような文字列として表示されます。

[contact_form]

公開ページやプレビューでフォームなどに変換されていれば、問題はありません。

不具合を判断するときは、次の3か所を分けて確認します。

編集画面だけを見て修正を始めず、公開ページで文字列がそのまま出ているか確認します。

問い合わせフォーム、予約カレンダー、商品一覧などのショートコードは、プラグインによって登録されていることがあります。

そのプラグインが停止、削除、エラーのいずれかで動かなくなると、WordPressがショートコードを認識できません。

確認する項目は次のとおりです。

プラグインを再度有効にする前に、停止された理由も確認します。エラーや互換性の問題で自動停止している場合、すぐに戻すとサイト全体へ影響する可能性があります。

独自のショートコードが、以前のテーマや子テーマ内に作られている場合があります。

テーマを変更すると、旧テーマに書かれていた処理は読み込まれません。その結果、記事内のショートコードだけが残ります。

次の状況なら、テーマとの関係を確認します。

旧テーマからコードをそのままコピーするのは避けます。現在のテーマで動くか、セキュリティ上の問題がないかを確認してから移します。

コピー時の欠落や書き換えでも認識されなくなります。

よくある違いは次のとおりです。

元のプラグインや設定画面にショートコードが表示されているなら、手入力せずにもう一度コピーします。

ショートコードは、貼り付ける場所によって処理方法が異なります。

投稿や固定ページでは動いても、次の場所ではそのまま表示されることがあります。

まず、通常の固定ページにショートコードブロックを置き、同じコードが動くか確認します。

通常ページでは動き、特定の場所だけで文字になるなら、ショートコード自体より設置場所の問題です。

独自プラグインやテーマが同じ名前のショートコードを登録していると、読み込まれる順番によって別の処理へ置き換わることがあります。

次のような場合は重複を疑います。

重複しているコード名を特定し、片方の名前を変更するか、不要な登録を解除します。