acf_get_field_group_visibility()

WordPress関数acf_get_field_group_visibility()は、特定のフィールドグループの表示設定を取得するために使用されます。この関数は主にカスタムフィールド管理に関連する操作で役立ちます。

構文

acf_get_field_group_visibility( array $args );

• $args (array) — フィールドグループの特定条件を指定するための配列。

返り値:

• true — フィールドグループが表示可能な場合。
• false — フィールドグループが非表示の場合。

例 1: 指定したフィールドグループが表示可能か確認する

特定のフィールドグループIDの表示状態を取得します。

<?php
if ( acf_get_field_group_visibility( array( 'field_group' => get_the_ID() ) ) ) {
    echo 'このフィールドグループは表示可能です。';
}
?>

例 2: 投稿タイプに基づいてフィールドグループを確認する

投稿タイプが特定の条件に一致する場合にフィールドグループの可視性をチェックします。

<?php
$args = array(
    'post_type' => 'custom_post_type'
);
if ( acf_get_field_group_visibility( $args ) ) {
    echo 'この投稿タイプのフィールドグループは表示可能です。';
}
?>

例 3: ユーザー権限に基づくフィールドグループの可視性

現在のユーザーが管理者かどうかに基づいて確認します。

<?php
$args = array(
    'role' => 'administrator'
);
if ( acf_get_field_group_visibility( $args ) ) {
    echo '管理者用フィールドグループが表示されています。';
}
?>

例 4: 条件付きロジックを使用したフィールドグループの表示

特定の条件付きロジックを適用してフィールドグループの可視性を確認します。

<?php
$args = array(
    'conditional_logic' => array(
        'param' => 'post_category',
        'value' => 'news',
        'operator' => '=='
    )
);
if ( acf_get_field_group_visibility( $args ) ) {
    echo 'このカテゴリーに基づいてフィールドグループが表示されます。';
}
?>

例 5: 現在の投稿に基づくフィールドグループの表示

現在の投稿が特定のカテゴリーに属しているかどうかを確認します。

<?php
$args = array(
    'post_id' => get_the_ID()
);
if ( acf_get_field_group_visibility( $args ) ) {
    echo '現在の投稿のフィールドグループは表示されています。';
}
?>

注意事項

この関数は、Advanced Custom Fieldsプラグインがインストールされている環境でのみ動作します。プラグインが有効であることを確認してください。また、条件が一致しない場合にはfalseが返されるため、適切なエラーハンドリングを行うことをお勧めします。