acf_is_local_field_group_key()


WordPressの関数acf_is_local_field_group_key()は、指定されたフィールドグループのキーがローカルなものであるかどうかをチェックするために使用されます。

シンタックス

acf_is_local_field_group_key( string $key );
  • $key (string) — チェックするフィールドグループのキー

使用例1: フィールドグループがローカルかどうかを確認する

以下のコードは、指定されたフィールドグループキーがローカルかどうかを確認します。

<?php
if( acf_is_local_field_group_key('group_123abc') ) {
    echo 'ローカルフィールドグループです';
} else {
    echo 'ローカルフィールドグループではありません';
}
?>

使用例2: 投稿のフィールドグループがローカルかどうかを確認する

投稿に関連付けられたフィールドグループがローカルであるかを確認します。

<?php
$post_id = get_the_ID();
$field_group_key = get_field('field_group_key', $post_id);
if( acf_is_local_field_group_key($field_group_key) ) {
    echo 'この投稿のフィールドグループはローカルです';
}
?>

使用例3: ページのカスタムフィールドがローカルかどうかを確認する

ページに関連するフィールドグループのキーがローカルかどうかを確認します。

<?php
$page_id = get_page_id();
$field_group_key = get_field('custom_field_group_key', $page_id);
if( acf_is_local_field_group_key($field_group_key) ) {
    echo 'ページのカスタムフィールドグループはローカルです';
}
?>

使用例4: ローカルフィールドグループが存在する場合に処理を実行する

ローカルフィールドグループが存在する場合に特定の処理を実行するコードです。

<?php
$field_group_key = 'group_abc123';
if( acf_is_local_field_group_key($field_group_key) ) {
    // ローカルフィールドグループが存在する場合に実行する処理
    do_action('do_something');
}
?>

使用例5: グローバルフィールドグループとローカルフィールドグループを区別する

グローバルフィールドグループとローカルフィールドグループを区別して、異なる処理を行う例です。

<?php
$field_group_key = 'group_xyz789';
if( acf_is_local_field_group_key($field_group_key) ) {
    echo 'ローカルフィールドグループです';
} else {
    echo 'グローバルフィールドグループです';
}
?>

注意点

  • この関数は、フィールドグループがローカルかどうかを判定するために、フィールドグループのキーが正しく設定されていることが前提です。
  • ローカルフィールドグループは、通常、カスタムフィールドとして保存されたフィールドグループです。