acf_get_field()


WordPressのacf_get_field()関数は、Advanced Custom Fields(ACF)プラグインで使用される関数で、指定されたフィールドの設定データを取得します。この関数は、フィールドキーまたはフィールド名を使用してフィールド情報を取得するために使用されます。

構文

acf_get_field( string $field_key );

引数の説明:

  • $field_key (string) — 取得したいフィールドのキー(必須)

例1: フィールド値を取得する

特定のフィールドキーに対応するフィールドの情報を取得する基本的な例です。

<?php $field = acf_get_field('field_123abc'); ?>
<?php echo $field['label']; ?>

例2: フィールド設定の詳細を取得する

フィールドの詳細設定を取得する方法です。例えば、ラベルやタイプなどの設定が含まれます。

<?php $field = acf_get_field('field_123abc'); ?>
<?php echo $field['type']; ?>

例3: 繰り返しフィールドの値を取得する

繰り返しフィールド(Repeater)を使用して、繰り返し項目を取得する方法です。

<?php $field = acf_get_field('field_123abc'); ?>
<?php foreach($field['sub_fields'] as $sub_field) { echo $sub_field['label']; } ?>

例4: フィールドのラベルを表示する

フィールドのラベルを簡単に表示する方法です。

<?php $field = acf_get_field('field_123abc'); ?>
<?php echo $field['label']; ?>

例5: フィールドタイプを取得する

フィールドのタイプ(テキスト、画像、日付など)を取得する例です。

<?php $field = acf_get_field('field_123abc'); ?>
<?php echo $field['type']; ?>

例6: フィールドの表示設定を確認する

フィールドが表示される設定かどうかを確認する方法です。

<?php $field = acf_get_field('field_123abc'); ?>
<?php echo $field['visibility']; ?>

例7: フィールド設定を配列で取得する

フィールドのすべての設定を配列として取得する方法です。

<?php $field = acf_get_field('field_123abc'); ?>
<?php print_r($field); ?>

例8: 条件付き論理の設定を取得する

条件付き論理の設定を取得し、特定の条件に基づいてフィールドの表示を制御する方法です。

<?php $field = acf_get_field('field_123abc'); ?>
<?php print_r($field['conditional_logic']); ?>

注意点:

  • フィールドキーは必須で、正しいキーを指定しないとエラーになります。
  • 返される値はフィールドの設定に応じて異なるため、適切にチェックを行うことが重要です。
  • この関数はACFプラグインが有効になっている場合にのみ動作します。