WordPress自定义分类法foreach循环分页失效问题求助

我仔细看了你的代码，发现几个关键问题导致分页无法正常显示，咱们一步步来修正：

核心问题分析 #

• 页码变量混淆：你用了get_query_var('page')，但WordPress里用于列表/存档分页的参数是paged，page是给单篇文章内部分页（比如<!--nextpage-->）用的，这会导致分页无法正确识别当前页码。
• 总数量与总页数计算错误：你用count(get_terms('categories'))获取总分类数，但实际查询的是wcpv_product_vendors分类，别名不匹配导致总数错误；同时你直接用全局$wp_query->max_num_pages作为总页数，但这里你没有使用WP_Query，这个值完全无效。
• paginate_links参数错误：current参数你填了get_query_var('number')，这完全不对，应该传入当前的页码值；format参数也要和你用的分页参数paged对应上。

修正后的完整代码 #

1. 获取分页后的分类数据 #

// 用正确的分页参数paged，替代page
$paged = (get_query_var('paged')) ? get_query_var('paged') : 1;
$per_page = 2;

// 获取目标分类的总数量（注意要和查询的分类别名一致）
$total_terms = count(get_terms(array(
    'taxonomy' => 'wcpv_product_vendors',
    'hide_empty' => false, // 根据需求调整是否隐藏空分类
)));

// 计算分页偏移量
$offset = ($paged - 1) * $per_page;

// 查询分页后的分类列表
$term_args = array(
    'taxonomy' => 'wcpv_product_vendors',
    'number' => $per_page,
    'offset' => $offset,
    'hide_empty' => false, // 和上面的设置保持一致
);
$terms = get_terms($term_args);

// 循环处理分类内容
foreach ($terms as $term) {
    $term_meta = get_term_meta($term->term_id);
    $admin = unserialize($term_meta['vendor_data'][0]);
    
    // 处理管理员ID
    $user_id = is_array($admin['admins']) ? $admin['admins'][0] : $admin['admins'];
    
    // 处理Logo ID，增加容错
    $logo_id = isset($admin['logo']) ? $admin['logo'] : '';
    
    // 获取用户数据，增加容错避免报错
    $user = get_userdata($user_id);
    $user_name = $user ? $user->data->display_name : '未知管理员';
    
    $term_name = $term->name;
    $attachment = get_post($logo_id);
    
    // 这里添加你的内容输出代码，比如渲染Logo、用户名等
}

2. 正确的分页显示代码 #

<?php
$big = 999999999;
// 手动计算总页数
$total_pages = ceil($total_terms / $per_page);

echo paginate_links(array(
    'base' => str_replace($big, '%#%', esc_url(get_pagenum_link($big))),
    'format' => '?paged=%#%',
    'prev_next' => true,
    'current' => max(1, $paged), // 使用正确的当前页码变量
    'total' => $total_pages, // 使用自己计算的总页数
    'type' => 'list', // 可选，让分页显示为列表样式，更美观
));
?>

额外注意事项 #

• 如果是自定义页面模板，要确保WordPress能识别paged参数，测试时可以手动在URL后加?paged=2验证是否能加载第二页内容。
• 增加了多处容错处理（比如用户不存在、Logo不存在的情况），避免出现PHP报错影响页面显示。
• WordPress 4.5+版本推荐用数组形式传递get_terms参数，明确指定taxonomy，代码更清晰也更兼容。

这样修改后，分页应该就能正常显示和工作了。

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