本文介绍在 WordPress 自定义字段（ACF Repeater）场景下，如何将多客户、多付款记录的扁平化数据统一提取并按支付日期升序排序，避免重构数据结构，仅通过 PHP 数组暂存与 usort() 实现高效、可维护的排序方案。
本文介绍在 wordpress 自定义字段（acf repeater）场景下，如何将多客户、多付款记录的扁平化数据统一提取并按支付日期升序排序，避免重构数据结构，仅通过 php 数组暂存与 `usort()` 实现高效、可维护的排序方案。
在 WordPress 开发中，当使用 ACF（Advanced Custom Fields）创建「客户」自定义文章类型，并为其配置 payments 重复字段（含 date 和 amount 子字段）时，常见需求是：不按客户分组展示，而是将所有付款记录拉平为一条时间线，按支付日期统一排序。此时，直接嵌套 WP_Query + foreach 的原始逻辑无法实现跨客户排序——因为外层循环按客户顺序执行，内层仅处理单客户数据。
解决思路并非强制改用「每笔付款为独立文章」的重型建模，而是采用数据收集 → 内存排序 → 渲染输出的轻量策略：先遍历全部客户及其付款项，将每条付款抽象为标准化数组元素，存入一个统一的数据容器；再调用 usort() 配合 strtotime() 对日期字符串进行解析与比较，最终按时间先后顺序渲染表格。
以下是完整、可直接集成的实现代码：
<?php
// 步骤1：初始化空数组用于收集所有付款记录
$data = [];
// 步骤2：查询所有客户（clients）文章
$args = [
'post_type' => 'clients',
'posts_per_page' => -1,
'post_status' => 'publish'
];
$post_query = new WP_Query($args);
if ($post_query->have_posts()) {
while ($post_query->have_posts()) {
$post_query->the_post();
$payments = get_field('payments'); // 获取当前客户的 payments 重复字段
if ($payments) {
foreach ($payments as $payment) {
// 确保 date 字段格式兼容 strtotime()（推荐使用 Y-m-d 格式存储）
$date = isset($payment['date']) ? trim($payment['date']) : '';
$amount = isset($payment['amount']) ? $payment['amount'] : 0;
// 将每笔付款构造成标准关联数组，便于后续排序与输出
$data[] = [
'title' => get_the_title(), // 客户名称
'date' => $date,
'amount' => $amount
];
}
}
}
wp_reset_postdata(); // 关键：重置主循环全局变量，避免影响后续查询
}
// 步骤3：按 payment date 升序排序（strtotime 支持多种常见日期格式，如 'd/m/Y' 或 'Y-m-d'）
usort($data, function($a, $b) {
$timeA = $a['date'] ? strtotime($a['date']) : 0;
$timeB = $b['date'] ? strtotime($b['date']) : 0;
return $timeA - $timeB; // 升序：较早日期排前
});
// 步骤4：渲染已排序的付款表格
?>
<table border="1" class="wp-list-table widefat">
<thead>
<tr>
<th>客户</th>
<th>付款日期</th>
<th>金额</th>
</tr>
</thead>
<tbody>
<?php foreach ($data as $item): ?>
<tr>
<td><?php echo esc_html($item['title']); ?></td>
<td><?php echo esc_html($item['date']); ?></td>
<td><?php echo esc_html($item['amount']) . '€'; ?></td>
</tr>
<?php endforeach; ?>
</tbody>
</table>✅ 关键注意事项：
- 日期格式兼容性：strtotime() 能解析 '2022-01-12'、'12/01/2022' 等格式，但强烈建议在 ACF 字段设置中将 date 子字段的「返回格式」设为 Y-m-d（ISO 标准），以规避地区格式歧义导致的解析错误。
- 安全性增强：使用 esc_html() 输出用户数据，防止 XSS；若金额需格式化（如千分位、小数位），可用 number_format() 处理。
- 性能考量：该方法适用于中等规模数据（数百条付款记录）。若数据量极大（>5000 条），建议迁移至独立 payment 自定义文章类型，配合原生 WP_Query 排序与分页。
- 空值防御：代码中已加入 isset() 和空值校验，确保 date 缺失时不引发 strtotime(false) 警告。
总结而言，面对 ACF Repeater 的“一对多”嵌套结构，无需推翻现有数据模型，只需一次内存级聚合与排序，即可优雅实现跨实体的时间轴视图——这是 WordPress 主题/插件开发中兼顾灵活性与可维护性的典型实践。
