Advanced Custom Fields(以下ACF)を使用していると様々なトラブルに見舞われます。

ACFのトラブルとして多いのは主に以下かと思われます。

  • フィールドの値が取得できない
  • 管理画面にフィールドが出てこない
  • 保存したはずのデータが保存されていない

今回はその中でも「管理画面にフィールドが出てこない」にフォーカスを当ててお話しします。

ちなみに、これを書くに当たって色々な記事をあさりましたが、解決せず数時間無駄にしました。

表示ルールの間違い」「ディアクティブ状態」「タブが閉じているだけ」など
様々ありましたが、どれも異なりました。

結局はフィールドグループ名に使用してはいけない文字列が含まれていたことによるものでしたが、
その点も踏まえてご紹介します。

# この記事で解決できること

ACFで設定したフィールドが管理画面の編集ページに出てこない現象を解決できます。

前提

今回はACFについて書いていきますが、使用しているのはACF Proになります。

おそらく無料版のACFでもそこまでかわりはないと思いますが、
念のためACF Pro用の記事であることをご了承ください。

それでは、原因一覧です。

表示ルールの間違い

表示ルールとは、「ACF -> フィールドグループ -> 編集」の下部の
「設定」にある「Location Rules」で設定できる内容です。

通常、特定の投稿タイプやページにのみにフィールドを表示させる場合に使用します。

ですが、初期状態で「投稿タイプが投稿に等しい」が設定されており、
条件を変更することはできても破棄することができません。

この箇所を「等しい」の状態で一つでも設定していると、その条件下でのみ表示されるようになります。

# 解決方法

目的にあった投稿タイプやページ名などを指定すれば表示されます

ディアクティブ状態である

ディアクティブ状態とは、アクティブでないことを指します。

「ACF -> フィールドグループ -> 編集」の下部の
「設定」にある「Group Settings」で設定できる内容です。

自分で設定しない限りは常に「有効」状態なので、これが原因である可能性は非常に薄いと言えます。

# 解決方法

「有効」にするだけです

タブが閉じているだけ

上記の例では、よくある質問ページによくある質問というフィールドを用意しています。

ですが、フィールドが開いていないことがわかります。

# 解決方法

赤枠の「▼」ボタンを押せばフィールドが開きます
※赤枠の左のボタンはフィールドの位置を上下させるボタンですので、お間違い無きよう

表示オプションにチェックが入っていない

上記の例では、よくある質問ページによくある質問というフィールドを用意しています。

ですが、ページ右上の表示オプションボタンから表示している要素を表示すると、
肝心の「よくある質問」にチェックが付いていません。

そのため、上記の状態ではフィールドが表示されていないことになります。

# 解決方法

表示させたい項目(例ではよくある質問)にチェックを入れる

フィールドグループに使用できない文字列が入っている

さて、今回の記事を書くきっかけになった原因です。

フィールドグループの名前は「ACF -> フィールドグループ -> 編集」の
上部で編集できる赤枠の箇所となります。

ちなみに上記の例ではフィールドは表示されません。

今回判明した使用できない文字列は「<>(半角)」となります。

# 解決方法

「<>」を全角にする

その他調査結果

他にも*/\{}[]など色々と調べましたが、
当てはまるのは上記の例だけでした。

尚、<>を使用していても、その後に文字列がある場合や、
片一方のみを使用している場合はフィールドの表示が確認できました。

ex. <HOME>HOME<HOME>テストフィールド

ちなみに、<HOME>テストフィールドの場合は、
フィールドのタイトルにテストフィールドのみ表示されますので、
管理的に<>を使用するのはありかもしれないですね。。。


※なにか起きたら面倒なので、もちろん推奨しません

最後に

無事解決されましたでしょうか?

私はACFを使用してかれこれ10年近くになりますが、
管理画面で設定したフィールドが表示されない場合は書きを確認すればほぼ解決するはずです。

# 主な原因

  • 表示ルールの間違い
  • ディアクティブ状態である
  • タブが閉じているだけ
  • 表示オプションにチェックが入っていない
  • フィールドグループに使用できない文字列が入っている

    みなさんもACFを使いこなして、更新性の高いHP運用を目指してみてください。

    それでは、よいWPライフを!

    あわせて読みたい記事

    ACFで複数の投稿オブジェクトを一番簡単にforeachで出力・表示する方法
    ACFで複数の投稿オブジェクトを一番簡単にforeachで出力・表示する方法
    AdvancedeCustomFieldの投稿オブジェクト(複数選択時)を一番簡単にforeachで出力する方法を紹介しています
    MWWPFORM+ACFでdatepickerに定休日と営業期間を追加した話
    MWWPFORM+ACFでdatepickerに定休日と営業期間を追加した話
    MWWPFORMでdatepickerの定休日や営業期間(特定の日付や曜日を非選択化)を設定する方法を紹介しています