acf_numval()

WordPressの関数acf_numval()は、Advanced Custom Fields (ACF) プラグインでカスタムフィールドの数値を取得するために使用されます。この関数は、数値を取得する際に非常に便利です。

シンタックス

acf_numval( string $field_name, int $post_id = 0 );

引数の説明

• $field_name (string) — 取得するACFフィールドの名前。
• $post_id (int, optional) — フィールドを取得する投稿のID。デフォルトは現在の投稿ID。

例1: 投稿の数値フィールドを取得

投稿に保存されている数値フィールドを取得します。

<?php $value = acf_numval('custom_field_name'); ?>

例2: 特定の投稿から数値フィールドを取得

特定の投稿IDから数値フィールドを取得する例です。

<?php $value = acf_numval('custom_field_name', 123); ?>

例3: フィールドが空の場合のデフォルト値を設定

ACFフィールドが空の場合、デフォルト値を設定する方法です。

<?php $value = acf_numval('custom_field_name', 0) ?: 100; ?>

例4: 数値フィールドを表示

取得した数値を表示します。

<?php echo acf_numval('custom_field_name'); ?>

例5: 他の投稿タイプから数値フィールドを取得

カスタム投稿タイプから数値フィールドを取得する方法です。

<?php $value = acf_numval('custom_field_name', get_the_ID()); ?>

注意点

• 投稿IDが指定されていない場合、現在の投稿IDが使用されます。
• フィールドが数値でない場合、関数は0を返します。
• 空のフィールドに対してはデフォルト値が使用されることがあります。