本文介绍如何修改 WordPress 自定义短代码函数，将按邮政编码分组的用户积分总和结果，以积分从高到低的顺序输出，核心是使用 arsort() 对关联数组进行值排序并保留键名映射。
本文介绍如何修改 wordpress 自定义短代码函数，将按邮政编码分组的用户积分总和结果，以积分从高到低的顺序输出，核心是使用 `arsort()` 对关联数组进行值排序并保留键名映射。
在 WordPress 开发中，常需基于用户元数据（如邮政编码、积分等）生成聚合排行榜。原始代码虽能遍历所有唯一 ZIP 码并计算对应用户的 mycred_default_total 积分总和，但直接在循环内 echo 输出会导致结果按 ZIP 码首次出现顺序排列，无法满足“按积分高低排序”的业务需求。
解决的关键在于：分离数据收集与呈现逻辑。应先将 ZIP 码作为键（key）、积分总和作为值（value）存入一个关联数组，再对该数组按值降序排序，最后统一输出。
以下是优化后的完整实现：
function total_actions_map_leaderboard() {
// 获取全部用户（不限数量）
$user_args = array(
'number' => -1,
'meta_key' => 'User Zip Code',
);
$user_query = new WP_User_Query($user_args);
// 提取所有用户 ZIP 码
$zipCode = array();
foreach ($user_query->get_results() as $user) {
$zipCode[] = get_user_meta($user->ID, 'User Zip Code', true);
}
// 去重获取唯一 ZIP 码列表
$unique_zc = array_unique($zipCode);
$zc_with_points = array(); // 关联数组：['ZIP' => 总积分]
// 遍历每个唯一 ZIP，查询对应用户并累加积分
foreach ($unique_zc as $zip) {
if (empty($zip)) continue; // 跳过空 ZIP，避免无效查询
$zc_args = array(
'meta_query' => array(
array(
'key' => 'User Zip Code',
'value' => $zip,
'compare' => '='
)
),
);
$zc_query = new WP_User_Query($zc_args);
$sum = 0;
foreach ($zc_query->get_results() as $zc_user) {
$balance = get_user_meta($zc_user->ID, 'mycred_default_total', true);
$sum += (float) $balance; // 强制转为浮点数，避免字符串拼接
}
$zc_with_points[$zip] = $sum;
}
// 按积分总和降序排序（保持 ZIP 码与积分的映射关系）
arsort($zc_with_points);
// 输出排序后结果
foreach ($zc_with_points as $zip => $points) {
printf('<div class="leaderboard-item">%s <span class="points">%s</span>
</div>',
esc_html($zip),
number_format_i18n((int) round($points)));
}
}
add_shortcode('map-leaderboard', 'total_actions_map_leaderboard');
✅ 关键改进说明：
Cn Password Generator
下载
安全的随机密码生成器。支持自定义长度、字符类型（大写/小写字母、数字、特殊符号），排除相似字符，批量生成。纯 Python 标准库，无需 API 密钥。
- 使用
$zc_with_points[$zip] = $sum构建关联数组，确保 ZIP 码与积分一一对应； -
arsort()对数组按值（积分）降序排序，同时保留键（ZIP）关联，这是实现“按积分排 ZIP”的核心； - 输出前增加
esc_html()和number_format_i18n()，提升安全性与可读性； - 添加空值校验（
if (empty($zip)) continue）和类型强制转换（(float) $balance），增强健壮性。
⚠️ 注意事项：
- 该方案在数据量较大时可能存在性能瓶颈（多次
WP_User_Query）。如需优化，建议改用$wpdb直接 SQL 聚合查询（GROUP BY zip_code, SUM(balance)），一次获取全部结果； - 确保
'User Zip Code'和'mycred_default_total'元键名与实际数据库一致，区分大小写； - 若 ZIP 码含前导零（如
'02138'），PHP 数组键会自动转为整型导致丢失，建议统一用字符串处理或存储为VARCHAR类型元值。
通过此重构，短代码 [map-leaderboard] 即可稳定输出按积分从高到低排序的 ZIP 码排行榜，兼顾可维护性与功能性。
