acf_search_fields()

WordPressの関数acf_search_fields()は、Advanced Custom Fields (ACF) プラグインを使用して、カスタムフィールドに基づいて検索を行うために使われます。

シンタックス

acf_search_fields( array $args );

• $args (array) — 検索クエリをカスタマイズするための引数の配列。post_typeやposts_per_pageなどのパラメータを含むことができます。

例1: 基本的な使用法

ACFフィールドを検索するための基本的な例です。ここでは、カスタムフィールド「color」で検索します。

<?php 
$args = array(
    'post_type' => 'post',
    'meta_query' => array(
        array(
            'key' => 'color',
            'value' => 'red',
            'compare' => 'LIKE',
        ),
    ),
);
$results = acf_search_fields( $args );
?>

例2: 複数のフィールドを検索

ここでは、複数のカスタムフィールド「color」と「size」に基づいて検索します。

<?php 
$args = array(
    'post_type' => 'product',
    'meta_query' => array(
        'relation' => 'AND',
        array(
            'key' => 'color',
            'value' => 'red',
            'compare' => 'LIKE',
        ),
        array(
            'key' => 'size',
            'value' => 'large',
            'compare' => 'LIKE',
        ),
    ),
);
$results = acf_search_fields( $args );
?>

例3: 投稿数の制限

検索結果の表示数を制限する例です。

<?php 
$args = array(
    'post_type' => 'post',
    'posts_per_page' => 5,
    'meta_query' => array(
        array(
            'key' => 'color',
            'value' => 'blue',
            'compare' => 'LIKE',
        ),
    ),
);
$results = acf_search_fields( $args );
?>

例4: カスタム投稿タイプの検索

カスタム投稿タイプ「event」に基づいて検索する例です。

<?php 
$args = array(
    'post_type' => 'event',
    'meta_query' => array(
        array(
            'key' => 'date',
            'value' => '2025-01-30',
            'compare' => '>=',
        ),
    ),
);
$results = acf_search_fields( $args );
?>

例5: キーワードでの検索

「title」フィールドとカスタムフィールド「color」で検索を行う例です。

<?php 
$args = array(
    's' => 'event',
    'post_type' => 'post',
    'meta_query' => array(
        array(
            'key' => 'color',
            'value' => 'green',
            'compare' => 'LIKE',
        ),
    ),
);
$results = acf_search_fields( $args );
?>