本文详解如何通过 WordPress 短代码实现按 mnp_is_new_post() 元值（true/false）分组排序、统一分页显示文章，避免两次独立查询导致分页失效，并提供健壮的参数校验与兼容性处理。
本文详解如何通过 wordpress 短代码实现按 `mnp_is_new_post()` 元值（true/false）分组排序、统一分页显示文章，避免两次独立查询导致分页失效，并提供健壮的参数校验与兼容性处理。
在 WordPress 中，若需通过短代码（shortcode）展示文章，并按自定义布尔型元字段（如 mnp_is_new_post）优先显示“新文章”（值为 1 或 true），再显示“非新文章”（值为 0 或 false），关键在于避免分两次查询——否则无法实现真正的全局分页（例如每页 10 篇，第 1 页应含前 5 篇 true + 后 5 篇 false，而非各自分页）。
正确做法是：单次 WP_Query，利用 meta_value_num 按数值升序/降序排序。由于 mnp_is_new_post 通常以整数 1/0 存储（推荐），或可强制转换为数字类型，因此可直接使用 'orderby' => 'meta_value_num' 实现逻辑分组：
function mnp_display_posts_shortcode($atts) {
// 默认参数与安全校验
$atts = shortcode_atts([
'per_page' => 10,
'post_type' => 'post'
], $atts);
// 获取当前分页页码（兼容主循环与子查询）
$paged = (get_query_var('paged')) ? get_query_var('paged') : 1;
if (is_front_page()) {
$paged = (get_query_var('page')) ? get_query_var('page') : 1;
}
$query_args = [
'post_type' => $atts['post_type'],
'posts_per_page' => (int) $atts['per_page'],
'paged' => $paged,
'meta_key' => 'mnp_is_new_post',
'orderby' => 'meta_value_num', // 按数值排序：1 > 0 → true 在前
'order' => 'DESC', // 降序确保 1（true）排在前面
'meta_query' => [
[
'key' => 'mnp_is_new_post',
'compare' => 'EXISTS' // 排除无该字段的文章，保证结果纯净
]
],
'no_found_rows' => false // 必须设为 false，才能支持分页计算
];
$query = new WP_Query($query_args);
$output = '';
if ($query->have_posts()) {
$output .= '<div class="mnp-posts-loop">';
while ($query->have_posts()) {
$query->the_post();
$is_new = (bool) get_post_meta(get_the_ID(), 'mnp_is_new_post', true);
$output .= sprintf(
'<article class="post-item %s"><h3><a href="%s">%s</a></h3>
<p>%s</p></article>',
$is_new ? 'is-new' : 'is-regular',
esc_url(get_permalink()),
esc_html(get_the_title()),
wp_trim_words(get_the_excerpt(), 20)
);
}
$output .= '</div>';
// 添加分页导航（需主题支持或手动实现）
$output .= paginate_links([
'total' => $query->max_num_pages,
'current' => $paged,
'mid_size' => 2,
'prev_text' => __('« Previous'),
'next_text' => __('Next »'),
'type' => 'list',
'end_size'=> 1
]);
} else {
$output = '<p>' . esc_html__('No posts found.', 'your-textdomain') . '</p><div class="aritcle_card flexRow artxards">
<div class="artcardd flexRow">
<a class="aritcle_card_img" rel="nofollow" href="/xiazai/skill10848" title="图片转Word"><img
src="https://img.php.cn/upload/skill/001/246/273/6adaf20e695c2374.jpg" alt="图片转Word" onerror="this.onerror='';this.src='/static/lhimages/moren/morentu.png'" ></a>
<div class="aritcle_card_info flexColumn">
<a rel="nofollow" href="/xiazai/skill10848" title="图片转Word" class="overflowclass">图片转Word</a>
<p class="overflowclass">将扫描图像、截图或表单、文档及以文字为主的图片内容，转换为可编辑的 Word（.docx）文件。
当用户提供包含文本内容的图片，并要求将其转为 Word 文档时，应使用此技能；
或用户表达类似“把图片搞成 word 文字版”、“convert image to docx”、“extract text from image to Word”等需求时，也应调用此技能。</p>
</div>
<a rel="nofollow" href="/xiazai/skill10848" title="图片转Word" class="aritcle_card_btn flexRow flexcenter"><b></b><span>下载</span>
</a>
</div>
</div>';
}
wp_reset_postdata(); // 重置全局 $post 对象，防止干扰后续内容
return $output;
}
add_shortcode('mnp_posts', 'mnp_display_posts_shortcode');
✅ 重要注意事项：
- 元字段存储规范：务必确保 mnp_is_new_post 以整数 1 或 0 存储（而非字符串 'true'/'false'），否则 meta_value_num 排序将失效。可通过 update_post_meta($id, 'mnp_is_new_post', 1) 统一写入。
- 分页兼容性：短代码内必须手动处理 paged 参数（尤其在首页或静态页面），并调用 wp_reset_postdata() 避免污染主循环。
- 性能优化：若数据量大，建议为 mnp_is_new_post 字段添加数据库索引（通过插件如 Index WP MySQL For Speed 或手动执行 SQL）。
- 备选方案：若元值必须存为字符串，可改用 WP_Query 的 meta_query 多条件排序（需自定义 posts_orderby 过滤器），但复杂度显著上升，不推荐。
此方案以简洁、标准、可维护的方式达成「分组+全局分页」目标，无需 AJAX 或二次请求，完全符合 WordPress 最佳实践。
