acf_get_local_field_groups()

WordPressのacf_get_local_field_groups()関数は、ローカルに保存されたフィールドグループを取得するために使用されます。この関数は、ACF（Advanced Custom Fields）プラグインが有効になっている環境で利用可能です。

構文

acf_get_local_field_groups( array $args = array() );

• $args(array) — フィールドグループをフィルタリングするための引数を指定します。デフォルトは空の配列です。

例1: すべてのローカルフィールドグループを取得する

この例では、すべてのローカルフィールドグループを取得します。

$field_groups = acf_get_local_field_groups(); foreach($field_groups as $field_group) { echo $field_group['title']; }

例2: 特定のキーを持つフィールドグループを取得する

特定のキーを持つフィールドグループを取得します。

$field_groups = acf_get_local_field_groups(array('key' => 'group_12345')); foreach($field_groups as $field_group) { echo $field_group['title']; }

例3: 特定の投稿タイプに関連するフィールドグループを取得する

特定の投稿タイプに関連するフィールドグループを取得します。

$field_groups = acf_get_local_field_groups(array('post_type' => 'post')); foreach($field_groups as $field_group) { echo $field_group['title']; }

例4: 特定のタクソノミーに関連するフィールドグループを取得する

特定のタクソノミーに関連するフィールドグループを取得します。

$field_groups = acf_get_local_field_groups(array('taxonomy' => 'category')); foreach($field_groups as $field_group) { echo $field_group['title']; }

例5: 特定のオプションページに関連するフィールドグループを取得する

特定のオプションページに関連するフィールドグループを取得します。

$field_groups = acf_get_local_field_groups(array('options_page' => 'theme-options')); foreach($field_groups as $field_group) { echo $field_group['title']; }

例6: 複数の条件を組み合わせてフィールドグループを取得する

複数の条件を組み合わせてフィールドグループを取得します。

$field_groups = acf_get_local_field_groups(array('post_type' => 'post', 'taxonomy' => 'category')); foreach($field_groups as $field_group) { echo $field_group['title']; }

注意点

• この関数は、ローカルに保存されたフィールドグループのみを取得します。データベースに保存されたフィールドグループを取得する場合は、acf_get_field_groups()を使用してください。
• フィールドグループが存在しない場合、空の配列が返されます。