动态提取与排序 WordPress ACF 关键词并生成索引链接

function keywords_post_list() {
    // 函数体将在此处填充
}

    $args = array(
        'post_type'      => 'post',         // 查询文章类型为 'post'
        'posts_per_page' => -1,             // 获取所有符合条件的文章，不限制数量
        'meta_query'     => array(
            array(
                'key'     => 'keyword',     // **请将 'keyword' 替换为您的实际 ACF 字段名称**
                'value'   => '',            // 匹配非空值
                'compare' => '!='           // 比较操作符，表示不等于空
            )
        )
    );

    $query = new WP_Query($args);
    global $post; // 声明全局 $post 变量，以便在循环中使用 get_the_permalink 等函数
    $items = array(); // 用于存储关键词和链接的数组

    if($query->have_posts()):
        while($query->have_posts()):
            $query->the_post(); // 设置当前文章数据，以便后续函数使用

            // 获取当前文章的关键词字段值
            // **请将 'keyword' 替换为您的实际 ACF 字段名称**
            $keyword = get_post_meta($post->ID, 'keyword', true);
            // 获取当前文章的永久链接
            $link = get_the_permalink($post->ID);

            // 将关键词和链接作为关联数组添加到 $items 数组中
            $items[] = array('keyword'=> $keyword, 'link' => $link);
        endwhile;
    endif;
    wp_reset_postdata(); // 恢复全局 $post 变量到主查询状态，避免影响其他查询

    // 根据 'keyword' 键的值对 $items 数组进行升序排序 (ASC)
    array_multisort(array_column($items, 'keyword'), SORT_ASC, $items);

    // 如果需要降序排序 (DESC)，可以使用以下代码并注释掉上面的升序代码
    // array_multisort(array_column($items, 'keyword'), SORT_DESC, $items);

    if($items): // 确保有数据才进行输出
        echo '<ol class="keyword-list">'; // 可以添加 CSS 类名以便样式定制
        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;

<?php
/**
 * 生成全站 ACF 关键词索引列表
 *
 * 该函数查询所有包含指定 ACF 字段（例如 'keyword'）的文章，
 * 提取关键词和文章链接，按关键词字母顺序排序，并输出为有序列表。
 *
 * @param string $meta_key ACF 字段的名称，默认为 'keyword'。
 */
function keywords_post_list($meta_key = 'keyword') {
    // 构建 WP_Query 参数，查询包含指定 meta_key 且值不为空的文章
    $args = array(
        'post_type'      => 'post',
        'posts_per_page' => -1, // 获取所有文章
        'meta_query'     => array(
            array(
                'key'     => $meta_key,
                'value'   => '',
                'compare' => '!='
            )
        )
    );

    $query = new WP_Query($args);
    global $post; // 声明全局 $post 变量
    $items = array(); // 初始化存储关键词和链接的数组

    if($query->have_posts()):
        while($query->have_posts()):
            $query->the_post();

            // 获取关键词和文章链接
            $keyword = get_post_meta($post->ID, $meta_key, true);
            $link = get_the_permalink($post->ID);

            // 确保关键词不为空，并且可以根据需要添加其他过滤条件
            if (!empty($keyword)) {
                $items[] = array('keyword'=> $keyword, 'link' => $link);
            }
        endwhile;
    endif;
    wp_reset_postdata(); // 恢复全局 $post 变量

    // 根据关键词进行字母升序排序
    array_multisort(array_column($items, 'keyword'), SORT_ASC, $items);

    // 输出 HTML 列表
    if($items):
        echo '<ol class="keyword-list">';
        foreach($items as $item):
            $keyword = esc_html($item['keyword']);
            $link = esc_url($item['link']);
            echo '<li><a href="'.$link.'">'.$keyword.'</a></li>';
        endforeach;
        echo '</ol>';
    else:
        echo '<p>暂无关键词数据。</p>'; // 当没有关键词时显示提示
    endif;
}
?>

<?php keywords_post_list(); ?>

<?php keywords_post_list('my_custom_tag'); ?>

function keywords_post_list_shortcode($atts) {
    ob_start(); // 开启输出缓冲
    $atts = shortcode_atts( array(
        'meta_key' => 'keyword', // 默认 ACF 字段名
    ), $atts, 'keywords_list' );

    keywords_post_list($atts['meta_key']);
    return ob_get_clean(); // 返回缓冲内容
}
add_shortcode('keywords_list', 'keywords_post_list_shortcode');

[keywords_list]

[keywords_list meta_key="your_acf_field_name"]