acf_is_local_field_group()


WordPressのacf_is_local_field_group()関数は、Advanced Custom Fields (ACF) プラグインを使用して、特定のフィールドグループがローカル(サイト固有)であるかどうかを確認するために使用されます。この関数は、ACFフィールドグループがインポートされたものか、ローカルで作成されたものかを判定します。

構文

acf_is_local_field_group( int|string $field_group );
  • $field_group (int|string) — フィールドグループのIDまたは名前。

例1: フィールドグループIDでチェック

このコードは、指定されたフィールドグループIDがローカルであるかどうかをチェックします。

<?php 
if( acf_is_local_field_group( 123 ) ) {
    echo 'このフィールドグループはローカルです';
} else {
    echo 'このフィールドグループはインポートされました';
}
?>

例2: フィールドグループの名前でチェック

このコードは、指定されたフィールドグループ名がローカルであるかどうかをチェックします。

<?php 
if( acf_is_local_field_group( 'my_custom_group' ) ) {
    echo 'このフィールドグループはローカルです';
} else {
    echo 'このフィールドグループはインポートされました';
}
?>

例3: フィールドグループがローカルの場合の処理

フィールドグループがローカルの場合にのみ、特定のアクションを実行します。

<?php 
if( acf_is_local_field_group( 'my_custom_group' ) ) {
    // ローカルフィールドグループに対する処理
    echo 'フィールドグループはローカルです';
}
?>

例4: 他の条件と組み合わせてチェック

他の条件と組み合わせてフィールドグループがローカルかどうかを確認する方法。

<?php 
if( acf_is_local_field_group( 123 ) && is_admin() ) {
    echo '管理画面でローカルフィールドグループが確認されました';
}
?>

例5: フィールドグループの存在確認

フィールドグループが存在する場合にそのIDがローカルであるかを確認します。

<?php 
$field_group_id = acf_get_field_group('my_custom_group');
if( acf_is_local_field_group( $field_group_id ) ) {
    echo 'このフィールドグループはローカルです';
}
?>

注意点:

  • ローカルフィールドグループ — インポートしたフィールドグループと区別されます。ACFでエクスポートしたフィールドグループはインポートされ、ローカルには含まれません。
  • フィールドグループID — ACFで設定されたフィールドグループのIDを使用します。IDがわからない場合は、フィールドグループ名を使用できます。