acf_update_value()

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

構文

acf_update_value( mixed $value, string $post_id, array $field );

引数の説明:

• $value (mixed) — 更新する新しい値。
• $post_id (string) — フィールドが関連付けられている投稿またはオブジェクトのID。
• $field (array) — フィールドの詳細情報を含む配列。

例 1: 投稿タイトルを更新

以下のコードは、特定の投稿のカスタムフィールド値を更新します。

acf_update_value( '新しいタイトル', get_the_ID(), array( 'key' => 'field_123456' ) );

例 2: 数値フィールドを更新

投稿に関連する数値フィールドを更新します。

acf_update_value( 100, get_the_ID(), array( 'key' => 'field_654321' ) );

例 3: 条件付きで値を更新

特定の条件が満たされた場合に値を更新します。

if ( get_post_meta( get_the_ID(), 'key_name', true ) < 50 ) {
    acf_update_value( 50, get_the_ID(), array( 'key' => 'field_abcdef' ) );
}

例 4: ユーザー関連のフィールドを更新

ユーザーIDを使用してカスタムフィールド値を更新します。

acf_update_value( '新しい値', 'user_1', array( 'key' => 'field_userfield' ) );

例 5: 配列の値を更新

配列形式の値を持つフィールドを更新します。

acf_update_value( array( '項目1', '項目2' ), get_the_ID(), array( 'key' => 'field_array' ) );

注意事項

• acf_update_value()を使用する際は、正しいフィールドキーと投稿IDを指定してください。