WordPress中高效获取并索引所有文章的ACF字段值

<?php
/**
 * 获取所有文章中指定ACF字段的值，并生成按字母排序的索引列表
 *
 * @param string $meta_key 您要获取的ACF字段的键名，例如 'keyword'。
 * @return void 直接输出HTML列表。
 */
function display_acf_field_index_list($meta_key = 'keyword') {
    // 构建 WP_Query 参数，查询所有包含指定 meta_key 且其值不为空的文章
    $args = array(
        'post_type'      => 'post',         // 查询文章类型，可根据需要修改为 'page', 'custom_post_type' 等
        'posts_per_page' => -1,             // 获取所有符合条件的文章，不分页
        'meta_query'     => array(          // 元数据查询
            array(
                'key'     => $meta_key,     // 指定要查询的自定义字段键名
                'value'   => '',            // 匹配值为空的，但 compare 是 '!='，所以实际上是查询值不为空的
                'compare' => '!='           // 比较操作符，表示字段值不等于空
            )
        ),
        'fields'         => 'ids',          // 仅获取文章ID，提高性能
    );

    $query = new WP_Query($args);
    $items = array(); // 用于存储收集到的关键词和链接

    if ($query->have_posts()) :
        foreach ($query->posts as $post_id) :
            // 循环遍历每篇文章，收集指定的ACF字段值和文章链接
            // 注意：这里使用 get_post_meta()，ACF字段也存储为 post meta。
            // 如果需要使用 ACF 特有的 get_field() 函数，可以改为：
            // $field_value = get_field($meta_key, $post_id);
            $field_value = get_post_meta($post_id, $meta_key, true);
            $post_link   = get_the_permalink($post_id);

            // 确保字段值不为空且为字符串类型，避免潜在问题
            if (!empty($field_value) && is_string($field_value)) {
                $items[] = array(
                    'value' => $field_value,
                    'link'  => $post_link
                );
            }
        endforeach;
    endif;

    // 重置文章数据，以防影响后续的WordPress查询
    wp_reset_postdata();

    // 根据字段值进行字母排序 (升序 ASC)
    // array_column() 用于从多维数组中提取指定键的所有值作为新数组
    // array_multisort() 用于对多个数组或多维数组进行排序
    array_multisort(array_column($items, 'value'), SORT_ASC, SORT_NATURAL | SORT_FLAG_CASE, $items);

    // 如果需要降序排序 (DESC)，请取消注释下面一行并注释掉上面一行
    // array_multisort(array_column($items, 'value'), SORT_DESC, SORT_NATURAL | SORT_FLAG_CASE, $items);

    // 输出排序后的列表
    if (!empty($items)) :
        echo '<ol class="acf-field-index-list">';
        foreach ($items as $item) :
            $value = esc_html($item['value']); // 对输出的文本进行HTML实体编码，防止XSS
            $link  = esc_url($item['link']);   // 对URL进行转义，确保安全

            echo '<li><a href="' . $link . '">' . $value . '</a></li>';
        endforeach;
        echo '</ol>';
    else :
        echo '<p>暂无相关内容。</p>';
    endif;
}

<?php
// 调用函数，如果您的ACF字段键名是 'keyword'，则无需传递参数
display_acf_field_index_list();

// 如果您的ACF字段键名是 'product_category'，则需要传递参数
// display_acf_field_index_list('product_category');
?>

add_shortcode('acf_field_index', 'display_acf_field_index_list');

[acf_field_index]

[acf_field_index meta_key="your_custom_field_name"]

function display_acf_field_index_list($atts) {
    // 解析短代码属性，设置默认值
    $atts = shortcode_atts(array(
        'meta_key' => 'keyword', // 默认的ACF字段键名
    ), $atts, 'acf_field_index');

    $meta_key = $atts['meta_key'];

    // ... 函数的其余部分保持不变 ...
    // 将函数开头 $meta_key = 'keyword' 这一行删除或注释掉
    // 并在 WP_Query 的 meta_query 中使用 $meta_key 变量
    // $args = array(
    //     ...
    //     'meta_query' => array(
    //         array(
    //             'key'     => $meta_key, // 使用传入的 meta_key
    //             'value'   => '',
    //             'compare' => '!='
    //         )
    //     ),
    //     ...
    // );
    // ...
}