acf_get_option_meta()


WordPressのacf_get_option_meta()関数は、Advanced Custom Fields(ACF)プラグインを使用して保存されたオプションフィールドのメタデータを取得するために使用されます。

構文

acf_get_option_meta( $post_id, $field_name );

引数の説明:

  • $post_id(int|string) — オプションフィールドが保存されている投稿IDまたはオプションページのスラッグ。
  • $field_name(string) — 取得したいフィールドの名前。

例1: オプションフィールドのメタデータを取得

この例では、オプションフィールドのメタデータを取得します。

$meta_value = acf_get_option_meta( 'options', 'custom_field' );

例2: 投稿IDを指定してメタデータを取得

特定の投稿IDに関連するオプションフィールドのメタデータを取得します。

$meta_value = acf_get_option_meta( get_the_ID(), 'custom_field' );

例3: オプションページのスラッグを使用

オプションページのスラッグを使用してメタデータを取得します。

$meta_value = acf_get_option_meta( 'theme_options', 'theme_color' );

例4: 取得したメタデータを出力

取得したメタデータを直接出力します。

echo acf_get_option_meta( 'options', 'header_text' );

例5: メタデータが存在するか確認

メタデータが存在するかどうかを確認し、存在する場合にのみ処理を行います。

if ( $meta_value = acf_get_option_meta( 'options', 'footer_text' ) ) { echo $meta_value; }

注意点

  • フィールド名が正しく指定されていない場合、関数はfalseを返します。