WordPress分类foreach分页异常求助：分页功能失效修复

问题梳理 #

• 点击「Next」按钮后，URL变为/page/2但子分类列表无变化，重复点击问题依旧
• 点击「Previous」按钮后，列表跳转到最后5个子分类（对应第13页），页码显示缺失当前值（仅显示Page: of 13）
• 无法实现多页码链接样式（仅支持上/下一页）

问题根源 #

1. 页码参数获取错误：WordPress固定链接模式下，paged参数不会通过$_GET传递，需用get_query_var('paged')获取当前页码
2. 链接输出错误：原代码中home_url()未用echo输出，导致分页链接为空，跳转逻辑失效
3. 多页码链接未实现：原代码仅处理上/下一页，未添加页码循环生成逻辑

修复后的完整代码 #

<?php
    // 获取ID为1的分类下所有子分类
    $descendant = array('child_of' => 1);
    $cats = get_categories($descendant);

    $limit = 5;
    $total = count($cats);
    $pages = ceil($total / $limit);

    // 正确获取当前页码：兼容固定链接和普通链接模式
    $current = get_query_var('paged') ? get_query_var('paged') : 1;
    $next = $current < $pages ? $current + 1 : null;
    $previous = $current > 1 ? $current - 1 : null;

    // 计算偏移量，截取当前页的子分类
    $offset = ($current - 1) * $limit;
    $cats = array_slice($cats, $offset, $limit);
?>

<div class="container">
    <?php foreach ($cats as $cat) { ?>
        <div>
            <a href="<?php echo esc_url( get_category_link( $cat->term_id ) ); ?>"><?php echo $cat->name; ?></a>
            <?php 
                $post_count = $cat->count;
                $post_count_text = $post_count == 1 ? ' Post' : ' Posts';
                echo '(' . $post_count . $post_count_text . ')';
            ?>
        </div>
    <?php } ?>
    <br>
    <p>(Page: <?php echo $current; ?> of <?php echo $pages; ?>)</p>
    <br>

    <!-- 上一页按钮 -->
    <?php if($previous): ?>
        <a href="<?php echo get_pagenum_link($previous); ?>">Previous</a>
    <?php endif; ?>

    <!-- 多页码链接 -->
    <?php for ($i = 1; $i <= $pages; $i++) : ?>
        <?php if ($i == $current) : ?>
            <span class="current-page"><?php echo $i; ?></span>
        <?php else : ?>
            <a href="<?php echo get_pagenum_link($i); ?>"><?php echo $i; ?></a>
        <?php endif; ?>
    <?php endfor; ?>

    <!-- 下一页按钮 -->
    <?php if($next) : ?>
        <a href="<?php echo get_pagenum_link($next); ?>">Next</a>
    <?php endif; ?>
</div>

关键修复点说明 #

1. 页码参数获取：改用get_query_var('paged')，兼容WordPress所有链接模式，确保当前页码正确读取
2. 链接生成优化：使用WordPress内置函数get_pagenum_link()生成分页链接，自动适配固定链接结构，避免手动拼接URL出错
3. 多页码链接实现：通过for循环生成所有页码按钮，当前页码用高亮样式区分（可自定义current-page类的CSS样式）
4. 代码精简：优化文章数量文本的生成逻辑，减少冗余代码

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