acf_append_data()

WordPressのacf_append_data()関数は、Advanced Custom Fields（ACF）プラグインで使用される関数で、カスタムフィールドにデータを追加するために利用されます。

構文

acf_append_data( int $post_id, string $field_name, mixed $value );

引数の説明:

• $post_id (int) — データを追加する投稿のID。
• $field_name (string) — データを追加するカスタムフィールドの名前。
• $value (mixed) — 追加するデータの値。

例1: カスタムフィールドにデータを追加

特定の投稿のカスタムフィールドにデータを追加する基本的な例です。

acf_append_data( get_the_ID(), 'my_custom_field', '新しいデータ' );

例2: 配列データを追加

カスタムフィールドに配列データを追加する例です。

acf_append_data( get_the_ID(), 'my_custom_field', array( 'data1', 'data2' ) );

例3: 数値データを追加

カスタムフィールドに数値データを追加する例です。

acf_append_data( get_the_ID(), 'my_custom_field', 12345 );

例4: 既存のデータに追加

既存のカスタムフィールドデータに新しいデータを追加する例です。

$existing_data = get_field( 'my_custom_field', get_the_ID() );
$new_data = array_merge( $existing_data, array( '追加データ' ) );
acf_append_data( get_the_ID(), 'my_custom_field', $new_data );

例5: 複数のフィールドにデータを追加

複数のカスタムフィールドに一度にデータを追加する例です。

acf_append_data( get_the_ID(), 'field1', 'データ1' );
acf_append_data( get_the_ID(), 'field2', 'データ2' );

注意点

• カスタムフィールドが存在しない場合、データは追加されません。
• データの型がフィールドの型と一致しない場合、エラーが発生する可能性があります。