acf_setup_meta()


WordPressのacf_setup_meta()関数は、ACF(Advanced Custom Fields)のメタデータをセットアップするために使用されます。この関数は、カスタムフィールドのメタデータを配列として設定し、それらを特定の投稿に関連付けることができます。

構文

acf_setup_meta( array $meta, int|string $post_id, bool $is_main = false );

引数の説明:

  • $meta (array) — メタデータの配列。
  • $post_id (int|string) — メタデータを関連付ける投稿ID。
  • $is_main (bool) — メタデータがメインの投稿に関連付けられているかどうかを示すフラグ。

例1: 基本的なメタデータのセットアップ

この例では、特定の投稿にメタデータをセットアップします。

acf_setup_meta( array( 'field_name' => 'value' ), get_the_ID() );

例2: メイン投稿のメタデータをセットアップ

メイン投稿に関連付けるメタデータをセットアップします。

acf_setup_meta( array( 'field_name' => 'value' ), get_the_ID(), true );

例3: 複数のメタデータをセットアップ

複数のフィールドを含むメタデータをセットアップします。

acf_setup_meta( array( 'field1' => 'value1', 'field2' => 'value2' ), get_the_ID() );

例4: カスタム投稿タイプのメタデータをセットアップ

カスタム投稿タイプの投稿にメタデータをセットアップします。

acf_setup_meta( array( 'custom_field' => 'custom_value' ), get_post( get_the_ID() )->ID );

例5: メタデータのセットアップと取得

メタデータをセットアップし、その後でその値を取得します。

acf_setup_meta( array( 'field_name' => 'value' ), get_the_ID() ); echo get_field( 'field_name' );

注意点

  • メタデータをセットアップする際は、正しい投稿IDを指定することが重要です。
  • メタデータの配列が正しくフォーマットされていることを確認してください。
  • メイン投稿のメタデータをセットアップする場合、$is_mainフラグをtrueに設定します。