WordPress中获取所有文章的ACF字段值并生成索引列表

function keywords_post_list() {
    // 1. 构建WP_Query查询参数
    // 我们需要查询所有文章类型为'post'的文章，且这些文章的'keyword'自定义字段不为空。
    $args = array(
        'post_type'      => 'post',          // 指定文章类型为'post'
        'posts_per_page' => -1,              // 获取所有符合条件的文章
        'meta_query'     => array(           // 定义元数据查询
            'key'     => 'keyword',          // 替换为你的ACF字段名称
            'value'   => '',                 // 查找值不为空的字段
            'compare' => '!='                // 比较操作符：不等于
        )
    );

    // 2. 执行WP_Query查询
    $query = new WP_Query($args);

    // 3. 初始化数据存储数组
    $items = array();

    // 4. 遍历查询结果，收集数据
    if ($query->have_posts()) :
        while ($query->have_posts()) :
            $query->the_post(); // 设置当前文章数据

            // 获取当前文章的ACF字段值和永久链接
            $keyword = get_post_meta(get_the_ID(), 'keyword', true); // 获取ACF字段'keyword'的值
            $link    = get_the_permalink(get_the_ID());             // 获取文章永久链接

            // 将关键词和链接存储到数组中
            $items[] = array('keyword' => $keyword, 'link' => $link);
        endwhile;
    endif;

    // 5. 恢复全局文章数据，避免影响后续查询
    wp_reset_postdata();

    // 6. 对收集到的数据进行排序
    // 使用array_multisort和array_column按关键词进行升序排序
    // array_column用于从二维数组中提取指定键的所有值，形成一维数组
    // array_multisort则根据这个一维数组对原始二维数组进行排序
    array_multisort(array_column($items, 'keyword'), SORT_ASC, $items);

    // 如果需要降序排序，可以使用 SORT_DESC：
    // array_multisort(array_column($items, 'keyword'), SORT_DESC, $items);

    // 7. 输出HTML列表
    if (!empty($items)) :
        echo '<ol class="keyword-list">'; // 使用有序列表包裹
        foreach ($items as $item) :
            $keyword = esc_html($item['keyword']); // 对关键词进行HTML实体编码，防止XSS
            $link    = esc_url($item['link']);     // 对链接进行URL编码和验证
            echo '<li><a href="' . $link . '">' . $keyword . '</a></li>';
        endforeach;
        echo '</ol>';
    endif;
}