本文介绍如何在 wordpress 自定义短代码中判断查询到的文章总数，并仅在文章数超过指定阈值（如 3 篇）时动态渲染“加载更多”按钮，同时确保按钮与内容结构语义正确、可扩展。
本文介绍如何在 wordpress 自定义短代码中判断查询到的文章总数，并仅在文章数超过指定阈值（如 3 篇）时动态渲染“加载更多”按钮，同时确保按钮与内容结构语义正确、可扩展。
在 WordPress 开发中，短代码常用于灵活嵌入动态内容。但需注意：WP_Query::$post_count 仅表示本次查询实际返回的文章数量（即 posts_per_page 限制后的结果数），而非站点中符合条件的总文章数。因此，若目标是“当后台存在 >3 篇可发布文章时显示按钮”，必须使用 found_posts 属性——它代表满足查询条件的总匹配数（忽略分页限制）。
以下是优化后的完整实现：
function display_posts_shortcode() {
// 查询前 3 篇文章（用于展示）
$args = array(
'posts_per_page' => 3,
'orderby' => 'post_date',
'order' => 'DESC',
'post_type' => 'post',
'post_status' => 'publish',
'no_found_rows' => false // 关键：启用 total count 计算
);
$query = new WP_Query($args);
$output = '';
// 渲染文章列表
if ($query->have_posts()) {
$output .= '<div class="posts-list">';
while ($query->have_posts()) {
$query->the_post();
$output .= sprintf(
'<article class="post-item"><h3><a href="%s">%s</a></h3></article>',
esc_url(get_permalink()),
esc_html(get_the_title())
);
}
$output .= '</div>';
wp_reset_postdata(); // 必须调用，避免主循环污染
}
// ✅ 正确判断：使用 found_posts 判断全局匹配数是否 > 3
if ($query->found_posts > 3) {
$output .= '<button type="button" id="loadmore-posts" class="btn btn-primary">加载更多文章</button>';
}
// 预留容器供 AJAX 加载后续内容
$output .= '<div class="more-posts" data-current-page="1" data-total-posts="' . intval($query->found_posts) . '"></div>';
return $output;
}
add_shortcode('display_posts', 'display_posts_shortcode');在模板中调用时，直接输出即可（无需额外 <div> 包裹）：<pre class="brush:php;toolbar:false;"><div class="row latest-blog-posts_content d-flex flex-wrap justify-content-between align-items-center">
<?php echo do_shortcode('[display_posts]'); ?>
</div></pre><p>⚠️ <strong>关键注意事项</strong>：</p>
<ul>
<li>
<code>no_found_rows => false 是启用 $query->found_posts 的前提，默认为 true（性能优化），此处必须显式关闭；
wp_reset_postdata()，防止短代码影响后续主循环；found_posts（总匹配数），而非 post_count（本次获取数），否则永远为 3；return，避免直接 echo——这是短代码开发最佳实践，确保内容可被过滤、缓存及安全处理。该方案兼顾可维护性与扩展性，既满足当前条件渲染需求，也为后续 AJAX 加载、分页控制或自定义参数（如 max_posts="5"）预留了清晰接口。
