acf_punctify()


WordPressのacf_punctify()関数は、ACF(Advanced Custom Fields)のフィールド値に対して、句読点や記号を自動的に追加または整形するために使用されます。

構文

acf_punctify( string $field_name, string $before = '', string $after = '', bool $echo = true );

引数の説明:

  • $field_name(string) — 整形したいACFフィールドの名前。
  • $before(string) — フィールド値の前に追加するテキスト。
  • $after(string) — フィールド値の後に追加するテキスト。
  • $echo(bool) — 結果を直接出力するかどうか。デフォルトはtrue

例1: 基本的な使用法

ACFフィールド「description」の値に句読点を追加します。

<?php acf_punctify('description'); ?>

例2: 前後にテキストを追加

ACFフィールド「description」の値の前後にテキストを追加します。

<?php acf_punctify('description', '説明:', '。'); ?>

例3: 結果を変数に格納

ACFフィールド「description」の値を変数に格納します。

<?php $description = acf_punctify('description', '', '', false); ?>

例4: 複数のフィールドを整形

複数のACFフィールドを連続して整形します。

<?php acf_punctify('field1'); acf_punctify('field2', '前テキスト', '後テキスト'); ?>

例5: 条件付きでフィールドを整形

特定の条件が満たされた場合にのみフィールドを整形します。

<?php if ( get_field('show_description') ) { acf_punctify('description'); } ?>

注意点

  • 結果を変数に格納する場合は、$echofalseに設定してください。