自定义模板页面WP_Query分页功能失效问题求助

我来帮你搞定这个分页不工作的问题！看了你的代码，问题出在**offset参数**上——这个参数会直接打乱WP_Query的分页计算逻辑，导致分页链接错位、总页数计算错误。下面给你两种可行的解决方案：

方法一：用post__not_in替代offset（推荐） #

如果你的offset=1是为了跳过分类里最新的1篇文章，那用post__not_in排除这篇文章的ID，完全不会影响分页逻辑，是最稳妥的做法：

<?php
// 先获取要排除的最新1篇文章ID（只取ID，提升效率）
$exclude_post = get_posts(array(
    'category_name' => 'recent-news',
    'posts_per_page' => 1,
    'fields' => 'ids'
));

// 处理分页参数：首页用page，其他页面用paged
$paged = (get_query_var('paged')) ? get_query_var('paged') : (get_query_var('page') ? get_query_var('page') : 1);

// 初始化自定义查询
$frontpageNews = new WP_Query(array(
    'category_name' => 'recent-news',
    'posts_per_page' => 3,
    'paged' => $paged,
    'post__not_in' => $exclude_post // 替代offset，排除指定文章
));

// 循环输出文章
if ($frontpageNews->have_posts()) {
    while ($frontpageNews->have_posts()) {
        $frontpageNews->the_post();
        ?>
        <h3><?php the_title(); ?></h3>
        <!-- 这里可以添加文章摘要、发布时间等内容 -->
        <?php
    }

    // 输出分页导航
    echo paginate_links(array(
        'total' => $frontpageNews->max_num_pages,
        'current' => $paged,
        'prev_text' => __('« 上一页'),
        'next_text' => __('下一页 »'),
        'mid_size' => 2 // 显示当前页前后的页码数量
    ));

    // 重置查询，避免影响后续内容
    wp_reset_postdata();
} else {
    echo '<p>暂无更多文章</p>';
}
?>

方法二：手动修正offset导致的分页计算错误 #

如果你一定要保留offset参数，那就得手动调整查询的偏移量和总页数计算，让分页逻辑恢复正常：

<?php
$posts_per_page = 3;
$fixed_offset = 1; // 你原本的offset值
$paged = (get_query_var('paged')) ? get_query_var('paged') : (get_query_var('page') ? get_query_var('page') : 1);

// 计算当前页的实际偏移量：基础offset + 每页偏移
$current_offset = $fixed_offset + (($paged - 1) * $posts_per_page);

// 初始化查询，注意no_found_rows要设为false才能获取总帖子数
$frontpageNews = new WP_Query(array(
    'category_name' => 'recent-news',
    'posts_per_page' => $posts_per_page,
    'offset' => $current_offset,
    'no_found_rows' => false
));

// 修正总帖子数和最大页数：减去固定offset后再计算
$total_valid_posts = $frontpageNews->found_posts - $fixed_offset;
$frontpageNews->found_posts = $total_valid_posts;
$frontpageNews->max_num_pages = ceil($total_valid_posts / $posts_per_page);

// 输出文章和分页
if ($frontpageNews->have_posts()) {
    while ($frontpageNews->have_posts()) {
        $frontpageNews->the_post();
        ?>
        <h3><?php the_title(); ?></h3>
        <?php
    }

    echo paginate_links(array(
        'total' => $frontpageNews->max_num_pages,
        'current' => $paged,
        'prev_text' => __('« 上一页'),
        'next_text' => __('下一页 »')
    ));

    wp_reset_postdata();
}
?>

几个关键注意事项： #

• 一定要调用wp_reset_postdata()，重置当前文章的全局变量，避免后续的循环或查询出错
• 如果是在静态首页（Front Page），分页参数是page而不是paged，所以代码里要做兼容判断
• 可以给paginate_links()添加mid_size、end_size等参数，调整分页导航的显示样式
• 如果你的主题没有默认的分页样式，记得添加CSS美化分页链接，比如给.page-numbers类加样式

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