ACF 6.2.7 で the_field() の script タグが消える・エスケープされるときの直し方

WordPress 6.4.3
広告WordPress・PHP を学べる本

Amazonのアソシエイトとして、WordPress functions.phpは適格販売により収入を得ています。

概要説明

ACFにて追加したカスタムフィールド内の情報を表示させる際に一部タグが消えてしまうといった時に行ったカスタマイズ。バージョンアップの影響によるものではありますが影響範囲は広いように思いますのでscriptタグが表示されなくなった、エスケープ表示なったという場合はこちらの方法を試してください。

ACF 6.2.7 から the_field() と the_sub_field() の出し方が変わった

ACF — ACF now automatically escapes unsafe HTML when rendered by the_field or the ACF shortcode. We’ve detected the output of some of your fields has been modified by this change, but this may not be a breaking change.

カスタムフィールドにタグを保存していると、エスケープされたり消されたりするので、対策が必要です。

解決方法 the_field() から get_field() に変更

// こちらの記述を使っている場合は
the_field()

// 下記の記述に変更することで今まで通りの内容を出力できます
echo get_field()

※ get_field() を echo すると、ACF が設けている XSS(悪いスクリプト)の守りを外すことになります。編集者・投稿者など、管理者以外の人が値を入力できる欄では使わないでください。出してよいタグが決まっているなら、wp_kses() で許すタグを指定して出す方法もあります。

プログラムの修正箇所が多い場合&問題となりそうな項目が特定できる場合

functions.php
/*----------------------------------------------------
 プログラムを直していくのは大変という場合
 カスタムフィールド名を指定してエスケープを回避
----------------------------------------------------*/
add_filter( 'acf/the_field/allow_unsafe_html', function( $allowed, $selector ) {
    if ( $selector === "カスタムフィールド名" ) {
        return true;
    }
    return $allowed;
}, 10, 2);

ACF公式リリースページ

SiteBeacon(サイトビーコン)

サイトが止まったら、すぐに気づける。

ホームページを 5 分ごとにチェックして、止まったとき・エラーが出たとき・SSL やドメインの期限が近いときに、メールでお知らせします。2 サイトまでは、ずっと無料で使えます。

SiteBeacon を見る サイトを直す相談をする

監視で気づいたあとの直す作業も、同じ担当がお受けします。