WordPress 自定义主题中实现正确分页的完整教程-php教程-PHP中文网

WordPress 自定义主题中实现正确分页的完整教程

使用 get_posts() 无法触发 WordPress 内置分页函数（如 the_posts_pagination()），因其不修改全局 $wp_query；需改用 WP_Query 并传入 'paged' => get_query_var('paged')，才能使分页数据生效。

使用 `get_posts()` 无法触发 wordpress 内置分页函数（如 `the_posts_pagination()`），因其不修改全局 `$wp_query`；需改用 `wp_query` 并传入 `'paged' => get_query_var('paged')`，才能使分页数据生效。

在 WordPress 主题开发中，若你从零构建主题并手动查询文章（例如展示最新 9 篇博客），却始终无法显示分页控件（如「上一页」「下一页」或页码导航），问题根源往往在于错误地使用了 get_posts() 函数。

get_posts() 是一个便捷的辅助函数，它返回数组形式的文章对象，但完全绕过主查询（main query）机制——这意味着全局 $wp_query 对象中的关键分页字段（如 found_posts、max_num_pages、paged）不会被设置。而 the_posts_pagination()、paginate_links() 等函数正是依赖这些字段生成 HTML 分页链接。因此，无论你如何调用它们，结果都是空白或报错。

✅ 正确做法是：使用 WP_Query 实例替代 get_posts()，并显式传递分页参数：

unity3d游戏开发之相机切换中文WORD版

本文档主要讲述的是unity3d游戏开发之相机切换；希望对大家会有帮助；感兴趣的朋友可以过来看看

下载

<?php global $wp_query;

// 保存原始 $wp_query（重要！用于后续恢复）
$original_query = $wp_query;

$args = array(
    'posts_per_page' => 9,
    'post_type'      => 'post',
    'post_status'    => 'publish',
    'orderby'        => 'date',
    'order'          => 'DESC',
    // 关键：获取当前请求的页码（支持 /page/2/ 或 ?paged=2）
    'paged'          => get_query_var('paged') ?: 1,
    // 注意：避免使用 'offset' 与 'paged' 同时存在，否则分页逻辑失效
);

$wp_query = new WP_Query($args);
?>

<div class="row">
<?php if ($wp_query->have_posts()) : ?>
    <?php while ($wp_query->have_posts()) : $wp_query->the_post(); ?>
        <div class="col-md-4 col-sm-12 mt-3">
            <div class="bg-gray h-100 blog-cards">
                <a href="<?php%20the_permalink();%20?>" title="مشاهده مطلب">
                    <div>
                        <div class="archive-img">
                            <?php echo get_the_post_thumbnail(null, 'large', ['class' => 'img-fluid']); ?>
                        </div>
                        <h3 class="upper mb-0 px-3 pt-3 pb-0 text-dark"><?php the_title(); ?></h3>
                        <div class="p-3 pt-0">
                            <?php the_excerpt(); ?><div class="mt-2">
                                <?php foreach (get_the_category() as $cat) : ?><a href="<?php%20echo%20esc_url(get_category_link(%24cat->term_id));%20?>">
                                        <?php echo esc_html($cat->name); ?>
                                    </a>
                                    <?php if (!$loop->is_last()) echo ' | '; ?>
                                <?php endforeach; ?>
</div>
                            <span class="text-muted">
                                مدت زمان مطالعه: <?php echo esc_html(get_field('duration') ?: '۳'); ?> دقیقه
                            </span>
                        </div>
                    </div>
                </a>
            </div>
        </div>
    <?php endwhile; ?><!-- ✅ 此处 now works --><div class="col-12 mt-5">
        <?php the_posts_pagination(array(
            'mid_size'  => 2,
            'prev_text' => __('قبلی', 'your-textdomain'),
            'next_text' => __('بعدی', 'your-textdomain'),
            'screen_reader_text' => __('صفحات ناوبری', 'your-textdomain')
        )); ?>
    </div>

<?php else : ?><div class="col-12">
        <p><?php _e('مطلبی یافت نشد.', 'your-textdomain'); ?></p>
    </div>
<?php endif; ?><?php // ⚠️ 关键步骤：恢复原始 $wp_query，避免影响 footer 或其他区域
$wp_query = $original_query;
wp_reset_postdata();
?><p>? <strong>重要注意事项：</strong>  </p>
<ul>
<li>
<strong>勿混用 offset 和 paged</strong>：二者逻辑冲突，会导致分页失效；如需跳过前 N 篇，请改用 WP_Query 的 'offset' + 手动计算页码，或更推荐使用 'paged' 配合标准分页。  </li>
<li>
<strong>始终调用 wp_reset_postdata()</strong>：它重置全局 $post 变量，确保后续模板（如页脚小工具）能正常工作。  </li>
<li>
<strong>主题需启用重写规则</strong>：确保 WordPress 设置 → 固定链接已保存（即使未更改），以支持 /page/2/ 这类结构化分页 URL。  </li>
<li>
<strong>自定义查询慎用 suppress_filters => true</strong>：该参数会禁用所有查询过滤器（如缓存、权限、SEO 插件钩子），除非明确需要，否则建议移除。  </li>
<li>
<strong>国际化支持</strong>：示例中已加入 __('قبلی', 'your-textdomain')，请将 'your-textdomain' 替换为你主题实际的文本域。</li>
</ul>
<p>通过以上重构，你的分页将不仅显示，还能正确响应用户点击、适配移动端，并与 WordPress 核心分页样式及插件（如 Yoast SEO、WP-PageNavi）无缝兼容。</p>
</div>