acf_updates()


WordPressの関数acf_updates()は、Advanced Custom Fields (ACF)プラグインで使用され、カスタムフィールドの更新を処理するために使用されます。

構文

acf_updates( int $post_id, array $fields );

引数の説明:

  • $post_id (int) — 更新対象の投稿またはページのID
  • $fields (array) — 更新するカスタムフィールドのキーと値の連想配列

例1: 投稿IDとカスタムフィールドを使ってフィールドを更新

このコードは、投稿IDが123の投稿のカスタムフィールドを更新します。

<?php acf_updates( 123, array( 'field_name' => '新しい値' ) ); ?>

例2: 複数のカスタムフィールドを一度に更新

複数のカスタムフィールドを更新する場合の例です。

<?php acf_updates( 123, array( 'field_name_1' => '値1', 'field_name_2' => '値2' ) ); ?>

例3: 投稿IDを動的に取得してカスタムフィールドを更新

現在の投稿IDを使ってフィールドを更新します。

<?php acf_updates( get_the_ID(), array( 'custom_field' => '新しい値' ) ); ?>

例4: 条件に基づいてカスタムフィールドを更新

条件を満たす場合にのみカスタムフィールドを更新します。

<?php
if( is_single() ) {
    acf_updates( get_the_ID(), array( 'field_name' => '値' ) );
}
?>

例5: 投稿IDが指定されている場合のみカスタムフィールドを更新

指定された投稿IDが存在する場合にのみフィールドを更新します。

<?php
if( get_post( 123 ) ) {
    acf_updates( 123, array( 'field_name' => '新しい値' ) );
}
?>

注意点

  • acf_updates()は、カスタムフィールドの更新を行う関数ですが、事前にACFプラグインが有効になっていることを確認してください。
  • 引数として渡す$fieldsは、カスタムフィールドのキーと値のペアである必要があります。