update_field()


WordPressのupdate_field()関数は、特定のカスタムフィールドの値を更新するために使用されます。この関数は、Advanced Custom Fields (ACF)プラグインと連携して動作します。

シンタックス

update_field( string $field_key_or_name, mixed $value, mixed $post_id );

引数の説明

  • $field_key_or_name (string) — 更新するフィールドのキーまたは名前。
  • $value (mixed) — 設定する値。
  • $post_id (mixed) — 値を更新する投稿のID、または投稿オブジェクト。

例 1: 投稿のカスタムフィールドを更新する

特定の投稿のカスタムフィールドを更新します。

update_field( 'field_123abc', '新しい値', get_the_ID() );

例 2: オプションページのフィールドを更新する

オプションページのカスタムフィールドを更新します。

update_field( 'field_456def', '設定値', 'options' );

例 3: 配列を使用して値を設定する

複数の値を持つフィールドに配列を設定します。

update_field( 'field_789ghi', array( '項目1', '項目2', '項目3' ), get_the_ID() );

例 4: リレーショナルフィールドを更新する

リレーショナルフィールドの値を設定します。

update_field( 'field_abc123', array( 12, 34, 56 ), get_the_ID() );

例 5: 投稿が存在する場合にのみフィールドを更新する

投稿が存在するかどうかを確認した上でフィールドを更新します。

if ( get_post( get_the_ID() ) ) {
    update_field( 'field_def456', '条件付き更新', get_the_ID() );
}

注意事項

  • $field_key_or_nameに間違った値を渡すと、更新が失敗します。
  • $post_idが正しく指定されていない場合、意図した結果が得られない可能性があります。

関連機能：