WordPress首页分页失效跳转问题及短码分页添加需求

这是静态首页下自定义短码分页的典型坑——WordPress默认会把静态首页的page/2这类路由直接重定向到首页，因为它默认认为静态页不需要分页逻辑。下面分两步帮你彻底解决：

第一步：取消静态首页的分页重定向，让WP识别分页参数 #

首先要拦截WordPress的默认重定向行为，同时把分页参数传递给WP的查询系统。把这段代码加到主题的functions.php里：

add_action('template_redirect', 'fix_static_home_pagination_redirect');
function fix_static_home_pagination_redirect() {
    // 仅针对静态首页，且存在分页参数时生效
    if (is_front_page() && get_query_var('page')) {
        // 移除默认的规范重定向动作
        remove_action('template_redirect', 'redirect_canonical');
        // 把静态页的page参数映射为文章分页用的paged参数
        set_query_var('paged', get_query_var('page'));
    }
}

简单解释：WordPress的redirect_canonical函数会把静态首页的分页URL强制重定向到首页，我们先干掉这个动作；然后把URL里的page参数转成WP文章查询用的paged参数，这样后续的短码查询就能正确获取页码。

第二步：更新[lastposts]短码，添加完整分页功能 #

替换你原来的短码函数为以下代码，让它支持分页查询并输出分页导航：

add_shortcode('lastposts', 'custom_lastposts_shortcode_with_pagination');
function custom_lastposts_shortcode_with_pagination($atts) {
    // 短码默认属性，支持自定义每页文章数
    $atts = shortcode_atts(array(
        'posts_per_page' => 5,
    ), $atts);

    // 获取当前页码，优先用第一步映射的paged参数，默认显示第一页
    $paged = get_query_var('paged') ? get_query_var('paged') : 1;

    // 构建文章查询参数
    $args = array(
        'post_type'      => 'post',
        'posts_per_page' => $atts['posts_per_page'],
        'paged'          => $paged,
        'post_status'    => 'publish',
        'orderby'        => 'date',
        'order'          => 'DESC',
    );

    $query = new WP_Query($args);

    ob_start(); // 开启输出缓冲，避免短码输出顺序混乱

    if ($query->have_posts()) {
        // 输出文章列表（你可以根据自己的需求修改HTML结构）
        echo '<ul class="last-posts-list">';
        while ($query->have_posts()) {
            $query->the_post();
            echo '<li>';
            echo '<h3><a href="' . get_permalink() . '">' . get_the_title() . '</a></h3>';
            echo '<p>' . wp_trim_words(get_the_content(), 20) . '</p>';
            echo '</li>';
        }
        echo '</ul>';

        // 输出分页导航
        echo '<div class="pagination">';
        echo paginate_links(array(
            'base'      => get_pagenum_link(1) . '%_%',
            'format'    => 'page/%#%/',
            'current'   => max(1, $paged),
            'total'     => $query->max_num_pages,
            'prev_text' => __('« 上一页'),
            'next_text' => __('下一页 »'),
        ));
        echo '</div>';

        wp_reset_postdata(); // 重置查询，避免影响后续内容
    } else {
        echo '<p>暂时没有发布的文章</p>';
    }

    return ob_get_clean(); // 返回缓冲的HTML内容
}

代码细节说明： #

1. 自定义属性：你可以通过[lastposts posts_per_page=6]来修改每页显示的文章数，默认是5篇。
2. 分页参数匹配：通过get_query_var('paged')获取页码，和第一步的参数映射完全对应。
3. 标准分页导航：用WP内置的paginate_links()生成符合规范的分页链接，自动适配你的首页URL（比如example.com/page/2/）。
4. 输出缓冲：确保短码返回的是完整的HTML内容，不会出现内容提前输出的问题。

第三步：测试与样式优化 #

1. 保存代码后刷新首页，就能看到带分页导航的文章列表；点击“下一页”会跳转到example.com/page/2/，不会再重定向到首页。
2. 如果分页样式太朴素，可以给主题的style.css加一段CSS美化：

.pagination {
    margin: 2rem 0;
    text-align: center;
}
.pagination a, .pagination span {
    padding: 0.5rem 0.8rem;
    margin: 0 0.2rem;
    border: 1px solid #e0e0e0;
    border-radius: 4px;
    text-decoration: none;
    color: #333;
}
.pagination .current {
    background-color: #0073aa;
    color: #fff;
    border-color: #0073aa;
}
.pagination a:hover {
    background-color: #f5f5f5;
}

这样就能完美实现你要的功能了。

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