WordPress自定义页面模板分页功能失效求助，已尝试多种方案未果

我看到你在制作Home页面模板时，自定义循环的分页始终显示为空，已经尝试了多种方案但没解决问题。这里帮你拆解几个核心问题，以及对应的修复方案：

核心问题分析 #

1. offset参数破坏分页逻辑：你在第二个循环里用了offset => 4，这会直接打乱WordPress的分页计算——WP_Query的paged参数是基于posts_per_page来计算跳过的文章数，额外的offset会让分页链接指向的内容完全错位，甚至无法生成分页结构。
2. 分页函数依赖错误的查询对象：你的pagination_bar()大概率是基于全局的$wp_query生成链接，但你用的是自定义$query，两者参数不匹配，导致分页无法正确渲染。
3. 重置查询的方式不正确：wp_reset_query()是用来恢复被query_posts()修改的主查询，而WP_Query之后应该用wp_reset_postdata()来恢复全局$post变量。

修复后的完整代码 #

下面是调整后的模板代码，解决了上述所有问题：

<?php /* Template Name: Home */ ?>
<div>
    <?php 
    // 第一个循环：固定显示前4篇，同时收集这些文章ID用于后续排除
    $categories = 'category-name1,category-name2';
    $first_query = new WP_Query( array( 
        'posts_per_page' => 4, 
        'category_name' => $categories 
    ) ); 

    // 存储第一个循环的文章ID，替代offset实现"跳过前4篇"的效果
    $excluded_posts = array();
    ?>
    <div>
        <?php if ( $first_query->have_posts() ) : while ( $first_query->have_posts() ) : $first_query->the_post(); 
            $excluded_posts[] = get_the_ID(); // 收集已显示的文章ID
        ?>
        <div>
            <?php get_template_part( 'entry-boxes-1' ); ?>
        </div>
        <?php endwhile; wp_reset_postdata(); endif; ?>
    </div>
</div>
<div>
    <?php 
    // 获取当前页码：静态页面模板用'page'参数，归档/文章页用'paged'
    $paged = ( get_query_var( 'page' ) ) ? absint( get_query_var( 'page' ) ) : 1;
    
    $second_query = new WP_Query( array( 
        'posts_per_page' => 6, 
        'paged' => $paged, 
        'category_name' => $categories,
        'post__not_in' => $excluded_posts, // 用排除ID替代offset，不破坏分页
        'ignore_sticky_posts' => true // 可选：忽略置顶文章，避免干扰分页逻辑
    ) );
    ?>
    <?php if ( $second_query->have_posts() ) : while ( $second_query->have_posts() ) : $second_query->the_post(); ?>
    <div>
        <?php get_template_part( 'entry-boxes-1' ); ?>
    </div>
    <?php endwhile; endif; ?>

    <?php 
    // 传入自定义查询对象给分页函数，确保分页逻辑基于当前循环
    pagination_bar( $second_query ); 
    ?>
</div>

调整分页函数适配自定义查询 #

你需要修改pagination_bar()函数，让它接收自定义查询对象作为参数，这样才能获取到正确的总页数和当前页码：

function pagination_bar( $query ) {
    $total_pages = $query->max_num_pages;
    $big = 999999999; // 用大数字作为占位符生成正确的分页链接格式

    if ($total_pages > 1){
        $current_page = max(1, get_query_var('page'));

        echo paginate_links(array(
            'base' => str_replace( $big, '%#%', esc_url( get_pagenum_link( $big ) ) ),
            'format' => '?page=%#%',
            'current' => $current_page,
            'total' => $total_pages,
            'prev_text'    => __('« Prev'),
            'next_text'    => __('Next »'),
        ));
    }
}

额外说明 #

• 后续做AJAX分页时，只需要在AJAX请求中传递page参数，然后在AJAX处理函数中使用和前端完全一致的WP_Query参数即可获取对应页码的内容。
• 如果需要添加更多自定义循环，都可以用这种"收集已显示ID+排除ID"的方式，避免offset干扰分页。

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