ACF 6.2.7 で HTML がエスケープされるようになった:script タグなどを前と同じに出す方法

広告WordPress・PHP を学べる本

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

概要説明

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

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公式リリースページ

関連機能

  1. WordPress現在表示しているページのプログラムファイルを表示させるプラグイン Show Current Template

  2. WordPress の管理画面の投稿の一覧にアイキャッチ画像を出す:Admin Columns と、プラグインを使わないコード

  3. 一部の要素にラベル要素が関連付けられていません。PageSpeed Insights対応

サイドバー

よく使うカスタマイズ

最近の記事

Profile

PAGE TOP