WordPress子比主题分类页排版不对称问题解决办法

对于使用WordPress子比主题的网站，尤其是内容丰富的博客或社区，分类页面的文章展示是用户浏览体验的关键环节。然而，当分类页面同时存在“置顶文章”和普通文章时，WordPress默认的查询机制可能会导致一个常见的排版问题：如果置顶文章占据了页面的一部分位置，而普通文章的数量又不足以填满剩余空位，就会出现每页文章数量不完整、页面看起来不对称的尴尬情况。这不仅影响美观，也降低了用户的浏览体验。

核心问题：

• WordPress分类页在有置顶文章时，每页显示的普通文章数量会减少，导致实际显示的文章总数少于设定的“每页显示数量”。
• 这种不完整的显示造成页面排版不对称，视觉上不友好。
• 分页逻辑可能也受影响，导致分页不准确。

修改前：

修改后：

解决方案：动态调整分类页文章查询和分页逻辑

为了解决这一问题，主题铺提供一段优化代码，通过WordPress的pre_get_posts和wp钩子，动态调整分类页的文章查询和分页逻辑，确保即使有置顶文章，每页的普通文章也能完整显示，保持排版对称。

主题铺提醒：

• 请将以下代码添加到WordPress子比主题的子主题的functions.php文件中。如果您的网站没有使用子主题，可以将其添加到WordPress子比主题根目录的func.php文件（如果该文件存在且用于自定义代码），但请注意，直接修改主题文件在主题更新后可能会被覆盖。
• 在进行任何代码修改前，务必备份您的网站文件和数据库。

优化代码：

<?php
// 主题铺提醒：如果您的文件已包含<?php标签，请勿重复添加

// 1. 分类页面置顶数量动态调整
function modify_pre_get_posts($query) {
    // 确保只在分类归档页面的主查询中执行
    if ($query->is_category() && $query->is_main_query()) {
        // 获取当前分类ID
        $current_category = get_queried_object_id();

        // 获取全站置顶文章ID列表
        $all_sticky_posts = get_option('sticky_posts');
        // 如果没有置顶文章，则直接返回，无需处理
        if (empty($all_sticky_posts)) {
             return;
        }

        // 筛选出属于当前分类的置顶文章
        $category_sticky_posts = array();
        foreach ($all_sticky_posts as $post_id) {
            // 检查置顶文章是否属于当前分类
            if (has_category($current_category, $post_id)) {
                $category_sticky_posts[] = $post_id;
            }
        }

        $sticky_count = count($category_sticky_posts); // 当前分类的置顶文章数量
        $posts_per_page = get_option('posts_per_page'); // 网站后台设置的每页文章数量

        // 如果是第一页
        if (!$query->is_paged()) {
            if ($sticky_count > 0) {
                // 计算第一页需要显示的普通文章数量，确保至少显示1篇
                $normal_posts_count = max(1, $posts_per_page - $sticky_count);
                // 设置第一页查询的普通文章数量，以弥补置顶文章占据的位置
                $query->set('posts_per_page', $normal_posts_count);
            }
        } else { // 如果是分页页面（非第一页）
            if (!empty($category_sticky_posts)) {
                // 分页页面不显示置顶文章，将它们排除
                $query->set('post__not_in', $category_sticky_posts);
                // 重新计算分页偏移量，因为第一页已经显示了部分普通文章
                // 这里的逻辑是：(当前页码 - 1) * 每页文章数 - 置顶文章数
                $offset = ($query->query_vars['paged'] - 1) * $posts_per_page - $sticky_count;
                // 确保偏移量不为负数
                $query->set('offset', max(0, $offset));
            }
        }
        // 强制WordPress忽略置顶文章的特殊处理，由我们自定义处理
        $query->set('ignore_sticky_posts', true);
    } 
}
add_action('pre_get_posts', 'modify_pre_get_posts', 20); // 优先级设置为20，确保在其他插件或主题修改前执行

// 2. 调整分页总页数，确保分页链接准确
function adjust_pagination() {
    // 确保只在分类归档页面执行
    if (is_category()) {
        global $wp_query; // 获取全局查询对象

        // 获取当前分类ID
        $current_category = get_queried_object_id();

        // 获取全站置顶文章ID列表
        $all_sticky_posts = get_option('sticky_posts');
        $category_sticky_posts = array();

        if (!empty($all_sticky_posts)) {
            foreach ($all_sticky_posts as $post_id) {
                // 筛选出属于当前分类的置顶文章
                if (has_category($current_category, $post_id)) {
                    $category_sticky_posts[] = $post_id;
                }
            }
        }

        $sticky_count = count($category_sticky_posts); // 当前分类的置顶文章数量
        $posts_per_page = get_option('posts_per_page'); // 网站后台设置的每页文章数量

        // 获取当前分类的非置顶文章总数，用于计算总页码
        $args = array(
            'post_type' => 'post',
            'post_status' => 'publish',
            'cat' => $current_category,
            'post__not_in' => $category_sticky_posts, // 排除置顶文章
            'fields' => 'ids', // 只获取文章ID，提高效率
            'posts_per_page' => -1, // 获取所有非置顶文章
            'no_found_rows' => true, // 不计算总行数，进一步提高效率
        );
        $non_sticky_query = new WP_Query($args);
        $non_sticky_count = $non_sticky_query->post_count; // 非置顶文章总数

        // 计算第一页实际显示的普通文章数
        $first_page_posts = max(0, $posts_per_page - $sticky_count); // 确保不为负数

        // 剩余需要分页的普通文章数
        $remaining_posts = max(0, $non_sticky_count - $first_page_posts);

        // 计算总页数：第一页（包含置顶和普通文章） + 剩余普通文章所需页数
        if ($non_sticky_count > 0) { // 如果有任何非置顶文章
            if ($first_page_posts > 0) { // 如果第一页显示了普通文章
                $total_pages = 1 + ceil($remaining_posts / $posts_per_page);
            } else { // 如果第一页只显示置顶文章，或者没有空间显示普通文章
                 $total_pages = ceil($non_sticky_count / $posts_per_page); // 从第二页开始计算
            }
        } else {
            $total_pages = 1; // 如果没有非置顶文章，只有置顶文章或无文章
        }

        // 如果只有置顶文章且数量不足以填满一页，也算一页
        if ($sticky_count > 0 && $non_sticky_count == 0 && $total_pages == 0) {
            $total_pages = 1;
        }

        // 更新全局查询对象的最大页数，以影响分页链接的生成
        $wp_query->max_num_pages = max(1, $total_pages); // 确保至少为1页
    }
}
add_action('wp', 'adjust_pagination'); // 在'wp'钩子中执行，确保全局查询已设置

代码详解：

1. modify_pre_get_posts($query) 函数：
   • 作用： 在WordPress执行主查询之前，修改查询参数。
   • 逻辑：
     • 首先判断当前是否为分类页面的主查询。
     • 获取当前分类ID和所有置顶文章ID。
     • 筛选出属于当前分类的置顶文章。
     • 针对第一页： 如果存在当前分类的置顶文章，它会计算出第一页还需要多少篇普通文章来填满“每页显示数量”的空位，然后设置posts_per_page来查询这些普通文章。这样，第一页就能显示“置顶文章 + 足够数量的普通文章 = 完整的每页文章数”。
     • 针对分页页（非第一页）： 排除所有置顶文章，并根据第一页已经显示的普通文章数量，重新调整分页的偏移量（offset），确保分页从正确的普通文章开始，避免重复或遗漏。
     • 最后设置ignore_sticky_posts为true，让WordPress不再自动处理置顶文章，由我们代码接管。
2. adjust_pagination() 函数：
   • 作用： 在WordPress主查询执行后，调整全局$wp_query对象的max_num_pages属性，以确保分页链接的正确生成。
   • 逻辑：
     • 同样判断是否为分类页面。
     • 获取当前分类ID和属于当前分类的置顶文章。
     • 重新查询当前分类下所有“非置顶文章”的总数。
     • 根据“每页显示数量”、置顶文章数和非置顶文章总数，精确计算出总共应该有多少页。
     • 将计算出的总页数赋值给$wp_query->max_num_pages，这样WordPress生成分页链接时就会使用这个修正后的总页数，确保分页导航的准确性。

使用方法：

1. 打开文件： 使用FTP客户端或宝塔面板/1Panel等文件管理器，找到您的WordPress主题目录。
   • 推荐： 进入您的子主题目录（例如/wp-content/themes/zibll-child/），找到并打开functions.php文件。
   • 次选： 如果没有子主题，可以尝试在子比主题根目录（/wp-content/themes/zibll/）下寻找func.php文件，并将其添加到该文件中。
2. 复制粘贴： 将上方提供的完整优化代码复制并粘贴到文件的末尾（确保在<?php和?>标签之间，如果文件末尾没有?>则直接粘贴）。
3. 保存文件： 保存您的修改。
4. 清除缓存： 如果您的网站使用了缓存插件（如WP Fastest Cache, LiteSpeed Cache等），请务必清除所有缓存。
5. 验证效果： 刷新您的分类页面，查看置顶文章和普通文章的排版是否已对称完整，并且分页链接是否正常。

主题铺点评： 这段代码巧妙地解决了WordPress子比主题分类页在置顶文章场景下的排版不对称和分页不准确问题。通过深度介入WordPress的查询和分页机制，它确保了用户在浏览分类内容时能获得更流畅、更专业的视觉体验。对于那些希望提升网站细节品质和用户体验的WordPress子比主题用户，这项优化是不可或缺的。它不仅解决了美观问题，也提升了网站的整体专业度。