WordPress短代码[featured_posts_by_tag]无法识别tags参数问题求助

嘿，我一眼就看到你代码里的两个小问题，正是它们导致标签筛选失效，咱们一步步来修正：

问题1：语法错误——数组键值对用错了符号 #

在构建tax_query的时候，你写了：

'terms' -> $tags

这是PHP里访问对象属性的箭头符号，但这里咱们是在定义数组，必须用=>来关联键和值，不然terms参数根本不会被正确传入，标签筛选自然不起作用。

问题2：标签匹配字段不匹配 #

你在短代码里传的是标签的slug（My-Featured-Post），但代码里把tax_query的field设成了term_id——这会让WordPress去匹配标签的ID，而不是你传入的slug，所以即使语法对了，也找不到对应的帖子。得把field改成slug才行。

修正后的完整代码 #

<?php
add_shortcode('featured_posts_by_tag', function($atts) {
    // 提取短代码参数，设置默认值
    extract(shortcode_atts( array(
        'post_type' => 'post',
        'numberposts' => 3,
        'tags' => ''
    ), $atts ));

    $args = [
        'post_type' => $post_type,
        'posts_per_page' => $numberposts, // 推荐用posts_per_page替代旧的numberposts
        'fields' => 'ids'
    ];

    if($tags){
        $args['tax_query'] = array(
            array( // 规范写法：tax_query应为数组嵌套数组，方便后续扩展多分类筛选
                'taxonomy' => 'post_tag',
                'field' => 'slug', // 改成匹配slug
                'terms' => $tags // 修正为=>符号
            )
        );
    }

    $posts = get_posts($args);
    ob_start();

    if($posts) : ?>
        <ul class="featured-posts-by-tag-list">
            <?php foreach($posts as $post_id) : ?>
                <li <?php echo post_class('featured-post-by-tag', $post_id); ?>>
                    <a href="<?php echo esc_url(get_the_permalink($post_id)); ?>">
                        <?php if(has_post_thumbnail($post_id)) : ?>
                            <img <?php echo post_img_src_data(get_post_thumbnail_id($post_id), 'medium'); ?> >
                        <?php endif; ?>
                    </a>
                    <h4>
                        <a class="featured-post-title" href="<?php echo esc_url(get_the_permalink($post_id)); ?>">
                            <?php echo esc_html(get_the_title($post_id)); ?>
                        </a>
                    </h4>
                    <p>
                        <a class="read-more" href="<?php echo esc_url(get_the_permalink($post_id)); ?>">read more ></a>
                    </p>
                </li>
            <?php endforeach; ?>
        </ul>
    <?php endif;

    $output = ob_get_clean();
    return $output;
});
?>

额外优化说明 #

• 我把numberposts换成了posts_per_page，这是WordPress推荐的参数（numberposts是旧版兼容参数），功能完全一致但更规范。
• 给所有输出的URL和标题加上了esc_url()和esc_html()，避免XSS安全风险，这是WordPress开发的最佳实践。
• 调整了tax_query的结构为数组嵌套数组——如果以后需要添加多个标签或分类筛选，这种写法能避免逻辑错误，扩展性更好。

现在你再用[featured_posts_by_tag numberposts="5" tags="My-Featured-Post"]（或者用posts_per_page="5"），就能正常显示5篇带有指定标签和缩略图的文章啦！

内容的提问来源于stack exchange，提问作者Anna