kate522
7b83893cf6
七个支付中心列表页（订单明细 / 售后服务 / 付费文章 / 优惠码 / 创作分成 /
提现审核 / 卡密管理）的分页收敛到共享助手 AdminListPagination，改用 WP 原生
paginate_links() 渲染。
- 基准 URL 显式以 page 参数 + 当前筛选参数拼装，不再让两个参数的
add_query_arg('paged', ...) 退回 $_SERVER['REQUEST_URI']：链接不再随当前
请求形态漂移，列条件也不再丢失
- 售后服务从写死的 limit => 100 改为 limit/offset 分页，总数接上原本零调用的
AfterSaleService::count()；after_sale_status 先按状态常量归一，保证 count()
与 admin_list() 口径一致，分页条不说谎
- 每页 20 条，统一来自 AdminListPagination::DEFAULT_PER_PAGE
- 每页在查询前夹取页码，越界时回退到最后一页并重查，杜绝「空表且没有分页条」
的死胡同；页码夹取与早退也一并收敛到助手
- 提现审核的翻页链接排除 retry_id / retry_key 两个一次性动作参数
- 订单明细的标签页与翻页链接共用同一份筛选参数，不再各写一份
清理死代码：五个页面里近乎复制的 render_pagination()（其中订单明细与提现审核
两份从未被调用）、两页重复的内联 paginate_links 块、卡密管理的 render_pagenavi()
及其 docblock、PayChargeCards::DEFAULT_PER_PAGE 常量，以及只服务自定义禁用
按钮的 .tablenav-pages a.disabled 规则。
验证：tests/admin/ 76 项通过（新增 pay-pages-pagination.test.cjs，重写
charge-cards-pagination.test.cjs）；用 git show HEAD 取出原文件对比，订单明细
与售后服务两页在新旧实现下渲染输出逐字节相同。
298 lines
13 KiB
PHP
298 lines
13 KiB
PHP
<?php
|
||
/**
|
||
* @package AKSRT
|
||
*/
|
||
|
||
namespace AKSRT\Admin\Native;
|
||
|
||
defined('ABSPATH') || exit;
|
||
|
||
class PayWithdrawals {
|
||
|
||
public const CAPABILITY = 'manage_options';
|
||
public const PAGE_SLUG = 'aksrt_withdraw';
|
||
|
||
private static $instance = null;
|
||
|
||
public static function get_instance(): self {
|
||
if (null === self::$instance) {
|
||
self::$instance = new self();
|
||
}
|
||
return self::$instance;
|
||
}
|
||
|
||
public function init(): void {
|
||
if (!is_admin()) {
|
||
return;
|
||
}
|
||
add_action('admin_post_aksrt_pay_update_withdrawal', [$this, 'handle_update_withdrawal']);
|
||
}
|
||
|
||
public function render_withdrawals_page(): void {
|
||
$this->ensure_cap();
|
||
$this->render_header(__('提现审核', 'aksrt'));
|
||
|
||
if (!class_exists('\AKSRT\Payment\Withdrawal')) {
|
||
echo '<div class="notice notice-error"><p>' . esc_html__('提现模块未初始化。', 'aksrt') . '</p></div>';
|
||
$this->render_footer();
|
||
return;
|
||
}
|
||
|
||
$status = isset($_GET['status']) ? sanitize_key((string) wp_unslash($_GET['status'])) : '';
|
||
$keyword = isset($_GET['s']) ? sanitize_text_field((string) wp_unslash($_GET['s'])) : '';
|
||
$user_filter = isset($_GET['user_id']) ? max(0, (int) $_GET['user_id']) : 0;
|
||
$date_from = isset($_GET['date_from']) ? $this->sanitize_date((string) wp_unslash($_GET['date_from'])) : '';
|
||
$date_to = isset($_GET['date_to']) ? $this->sanitize_date((string) wp_unslash($_GET['date_to'])) : '';
|
||
$page_num = max(1, (int) ($_GET['paged'] ?? 1));
|
||
$per_page = AdminListPagination::DEFAULT_PER_PAGE;
|
||
$svc = \AKSRT\Payment\Withdrawal::get_instance();
|
||
$stats = $svc->get_stats();
|
||
$retry_id = isset($_GET['retry_id']) ? max(0, (int) $_GET['retry_id']) : 0;
|
||
$retry_key = isset($_GET['retry_key']) ? sanitize_text_field((string) wp_unslash($_GET['retry_key'])) : '';
|
||
if (!wp_is_uuid($retry_key)) {
|
||
$retry_key = '';
|
||
}
|
||
|
||
echo '<p>' . esc_html(sprintf(
|
||
/* translators: 1: total 2: pending 3: completed 4: paid */
|
||
__('共 %1$d 条 · 待处理 %2$d · 处理中 %3$d · 已完成 %4$d · 已拒绝 %5$d · 已打款 %6$s', 'aksrt'),
|
||
(int) ($stats['total'] ?? 0),
|
||
(int) ($stats['pending'] ?? 0),
|
||
(int) ($stats['processing'] ?? 0),
|
||
(int) ($stats['completed'] ?? 0),
|
||
(int) ($stats['rejected'] ?? 0),
|
||
(string) ($stats['total_paid'] ?? '0.00')
|
||
)) . '</p>';
|
||
|
||
echo '<form method="get" style="margin:12px 0;">';
|
||
echo '<input type="hidden" name="page" value="aksrt_withdraw" />';
|
||
echo '<select name="status">';
|
||
$status_options = [
|
||
'' => __('全部状态', 'aksrt'),
|
||
'pending' => __('待处理', 'aksrt'),
|
||
'processing' => __('处理中', 'aksrt'),
|
||
'completed' => __('已完成', 'aksrt'),
|
||
'rejected' => __('已拒绝', 'aksrt'),
|
||
];
|
||
foreach ($status_options as $key => $label) {
|
||
printf(
|
||
'<option value="%s"%s>%s</option>',
|
||
esc_attr($key),
|
||
selected($status, $key, false),
|
||
esc_html($label)
|
||
);
|
||
}
|
||
echo '</select> ';
|
||
echo '<input type="search" name="s" value="' . esc_attr($keyword) . '" placeholder="' . esc_attr__('订单号 / 用户 ID', 'aksrt') . '" /> ';
|
||
echo '<input type="number" min="1" name="user_id" value="' . esc_attr($user_filter > 0 ? (string) $user_filter : '') . '" placeholder="' . esc_attr__('用户 ID', 'aksrt') . '" class="small-text" /> ';
|
||
echo '<label>' . esc_html__('从', 'aksrt') . ' <input type="date" name="date_from" value="' . esc_attr($date_from) . '"></label> ';
|
||
echo '<label>' . esc_html__('至', 'aksrt') . ' <input type="date" name="date_to" value="' . esc_attr($date_to) . '"></label> ';
|
||
submit_button(__('筛选', 'aksrt'), 'secondary', '', false);
|
||
if ($status !== '' || $keyword !== '' || $user_filter > 0 || $date_from !== '' || $date_to !== '') {
|
||
echo ' <a class="button" href="' . esc_url($this->page_url(self::PAGE_SLUG)) . '">' . esc_html__('清除条件', 'aksrt') . '</a>';
|
||
}
|
||
echo '</form>';
|
||
|
||
$items = $svc->get_all([
|
||
'status' => $status,
|
||
'keyword' => $keyword,
|
||
'user_id' => $user_filter,
|
||
'date_from' => $date_from,
|
||
'date_to' => $date_to,
|
||
'limit' => $per_page,
|
||
'offset' => ($page_num - 1) * $per_page,
|
||
]);
|
||
$total = $svc->get_count([
|
||
'status' => $status,
|
||
'keyword' => $keyword,
|
||
'user_id' => $user_filter,
|
||
'date_from' => $date_from,
|
||
'date_to' => $date_to,
|
||
]);
|
||
$pages = max(1, (int) ceil($total / $per_page));
|
||
|
||
// 页码越界（手工改 URL、或筛选后总数变小）会让 offset 落到数据之外：表格空掉
|
||
// 且分页条不输出，只能手改 URL 退出。回退到最后一页重查一次。
|
||
if ($page_num > $pages) {
|
||
$page_num = $pages;
|
||
$items = $svc->get_all([
|
||
'status' => $status,
|
||
'keyword' => $keyword,
|
||
'user_id' => $user_filter,
|
||
'date_from' => $date_from,
|
||
'date_to' => $date_to,
|
||
'limit' => $per_page,
|
||
'offset' => ($page_num - 1) * $per_page,
|
||
]);
|
||
}
|
||
|
||
// 翻页链接显式带上当前筛选条件（不含 paged），口径与上方筛选表单一致。
|
||
// retry_id / retry_key 是一次性动作参数，绝不能进翻页链接。
|
||
$query_args = array_filter([
|
||
'status' => $status !== '' ? $status : null,
|
||
's' => $keyword !== '' ? $keyword : null,
|
||
'user_id' => $user_filter > 0 ? $user_filter : null,
|
||
'date_from' => $date_from !== '' ? $date_from : null,
|
||
'date_to' => $date_to !== '' ? $date_to : null,
|
||
], static function ($value): bool {
|
||
return $value !== null;
|
||
});
|
||
|
||
echo '<table class="wp-list-table widefat fixed striped">';
|
||
echo '<thead><tr>';
|
||
echo '<th>' . esc_html__('订单号', 'aksrt') . '</th>';
|
||
echo '<th>' . esc_html__('用户', 'aksrt') . '</th>';
|
||
echo '<th>' . esc_html__('金额明细', 'aksrt') . '</th>';
|
||
echo '<th>' . esc_html__('渠道 / 账户', 'aksrt') . '</th>';
|
||
echo '<th>' . esc_html__('状态', 'aksrt') . '</th>';
|
||
echo '<th>' . esc_html__('申请 / 处理时间', 'aksrt') . '</th>';
|
||
echo '<th>' . esc_html__('操作', 'aksrt') . '</th>';
|
||
echo '</tr></thead><tbody>';
|
||
|
||
if (!$items) {
|
||
echo '<tr><td colspan="7">' . esc_html__('暂无提现记录', 'aksrt') . '</td></tr>';
|
||
}
|
||
|
||
foreach ($items as $row) {
|
||
$id = (int) ($row['id'] ?? 0);
|
||
$user_id = (int) ($row['user_id'] ?? 0);
|
||
$user = $user_id > 0 ? get_userdata($user_id) : null;
|
||
$st = (string) ($row['status'] ?? '');
|
||
$gross = (string) ($row['gross_amount'] ?? '0.00');
|
||
$net = (string) ($row['amount'] ?? '0.00');
|
||
$fee = (int) ($row['fee_rate'] ?? 0);
|
||
$acct = (string) ($row['display_account'] ?? $row['account_info'] ?? '');
|
||
$amount_txt = sprintf(
|
||
/* translators: 1: gross 2: net 3: fee percent */
|
||
__('申请 %1$s / 到账 %2$s（手续费 %3$d%%）', 'aksrt'),
|
||
$gross,
|
||
$net,
|
||
$fee
|
||
);
|
||
|
||
echo '<tr>';
|
||
echo '<td><code>' . esc_html((string) ($row['withdrawal_number'] ?? '')) . '</code></td>';
|
||
echo '<td>' . ($user ? esc_html($user->display_name . ' (#' . $user_id . ')') : esc_html((string) $user_id)) . '</td>';
|
||
echo '<td>' . esc_html($amount_txt) . '</td>';
|
||
echo '<td><strong>' . esc_html((string) ($row['method'] ?? '')) . '</strong><br><span class="description">' . esc_html($acct) . '</span></td>';
|
||
echo '<td>' . esc_html($status_options[$st] ?? $st) . '</td>';
|
||
echo '<td>' . esc_html((string) ($row['created_at'] ?? '')) . '<br><span class="description">' . esc_html((string) ($row['processed_at'] ?? '') ?: '—') . '</span></td>';
|
||
echo '<td>';
|
||
$next_statuses = $st === 'pending' ? ['processing', 'rejected'] : ($st === 'processing' ? ['completed', 'rejected'] : []);
|
||
if ($next_statuses === []) {
|
||
echo '—';
|
||
echo '</td>';
|
||
echo '</tr>';
|
||
continue;
|
||
}
|
||
$request_key = $retry_id === $id && $retry_key !== '' ? $retry_key : wp_generate_uuid4();
|
||
echo '<form method="post" action="' . esc_url(admin_url('admin-post.php')) . '" style="display:flex;gap:4px;flex-wrap:wrap;align-items:center;">';
|
||
echo '<input type="hidden" name="action" value="aksrt_pay_update_withdrawal" />';
|
||
echo '<input type="hidden" name="withdrawal_id" value="' . esc_attr((string) $id) . '" />';
|
||
echo '<input type="hidden" name="idempotency_key" value="' . esc_attr($request_key) . '" />';
|
||
wp_nonce_field('aksrt_pay_update_withdrawal_' . $id);
|
||
echo '<select name="new_status">';
|
||
foreach ($next_statuses as $key) {
|
||
$label = $status_options[$key];
|
||
printf(
|
||
'<option value="%s"%s>%s</option>',
|
||
esc_attr($key),
|
||
selected($st, $key, false),
|
||
esc_html($label)
|
||
);
|
||
}
|
||
echo '</select>';
|
||
echo '<input type="text" name="note" placeholder="' . esc_attr__('备注', 'aksrt') . '" value="" />';
|
||
submit_button(__('更新', 'aksrt'), 'small', '', false);
|
||
echo '</form>';
|
||
echo '</td>';
|
||
echo '</tr>';
|
||
}
|
||
|
||
echo '</tbody></table>';
|
||
|
||
AdminListPagination::render(self::PAGE_SLUG, $total, $page_num, $per_page, $query_args);
|
||
|
||
$this->render_footer();
|
||
}
|
||
|
||
public function handle_update_withdrawal(): void {
|
||
if (!current_user_can(self::CAPABILITY)) {
|
||
wp_die(esc_html__('权限不足', 'aksrt'));
|
||
}
|
||
|
||
$id = isset($_POST['withdrawal_id']) ? (int) $_POST['withdrawal_id'] : 0;
|
||
$new_status = isset($_POST['new_status']) ? sanitize_key((string) wp_unslash($_POST['new_status'])) : '';
|
||
$note = isset($_POST['note']) ? sanitize_textarea_field((string) wp_unslash($_POST['note'])) : '';
|
||
$request_key = isset($_POST['idempotency_key']) ? sanitize_text_field((string) wp_unslash($_POST['idempotency_key'])) : '';
|
||
check_admin_referer('aksrt_pay_update_withdrawal_' . $id);
|
||
|
||
$msg = 'withdraw_failed';
|
||
if ($id > 0 && $new_status !== '' && wp_is_uuid($request_key) && class_exists('\AKSRT\Payment\Withdrawal')) {
|
||
$operation_key = \AKSRT\Ledger\OperationKey::deterministic('admin-withdraw-transition', [get_current_user_id(), strtolower($request_key)]);
|
||
$result = \AKSRT\Payment\Withdrawal::get_instance()->process_status_change($id, $new_status, $note, $operation_key);
|
||
if (!is_wp_error($result) && $result) {
|
||
$msg = 'withdraw_updated';
|
||
} elseif (is_wp_error($result) && $result->get_error_code() === 'aksrt_balance_insufficient') {
|
||
$msg = 'withdraw_refund_failed';
|
||
}
|
||
}
|
||
|
||
$redirect_args = ['aksrt_pay_msg' => $msg];
|
||
if ($msg !== 'withdraw_updated' && wp_is_uuid($request_key)) {
|
||
$redirect_args['retry_id'] = $id;
|
||
$redirect_args['retry_key'] = $request_key;
|
||
}
|
||
wp_safe_redirect($this->page_url('aksrt_withdraw', $redirect_args));
|
||
exit;
|
||
}
|
||
|
||
/* ------------------------------------------------------------------
|
||
* Income
|
||
* ----------------------------------------------------------------*/
|
||
|
||
|
||
|
||
private function ensure_cap(): void {
|
||
if (!current_user_can(self::CAPABILITY)) {
|
||
wp_die(esc_html__('您没有权限访问此页面。', 'aksrt'));
|
||
}
|
||
}
|
||
|
||
private function render_header(string $title): void {
|
||
echo '<div class="wrap">';
|
||
echo '<h1>' . esc_html($title) . '</h1>';
|
||
$this->render_flash();
|
||
}
|
||
|
||
private function render_footer(): void {
|
||
echo '</div>';
|
||
}
|
||
|
||
private function render_flash(): void {
|
||
if (empty($_GET['aksrt_pay_msg'])) {
|
||
return;
|
||
}
|
||
$code = sanitize_key((string) wp_unslash($_GET['aksrt_pay_msg']));
|
||
$map = [
|
||
'withdraw_updated' => __('提现状态已更新。', 'aksrt'),
|
||
'withdraw_failed' => __('提现状态更新失败。', 'aksrt'),
|
||
'withdraw_refund_failed' => __('状态未更新：余额退回失败，请检查钱包后重试。', 'aksrt'),
|
||
];
|
||
if (!isset($map[$code])) {
|
||
return;
|
||
}
|
||
$class = str_contains($code, 'failed') ? 'notice-error' : 'notice-success';
|
||
echo '<div class="notice ' . esc_attr($class) . ' is-dismissible"><p>' . esc_html($map[$code]) . '</p></div>';
|
||
}
|
||
|
||
private function page_url(string $slug, array $args = []): string {
|
||
return add_query_arg(array_merge(['page' => $slug], $args), admin_url('admin.php'));
|
||
}
|
||
|
||
private function sanitize_date(string $date): string {
|
||
return preg_match('/^\d{4}-\d{2}-\d{2}$/', $date) === 1 ? $date : '';
|
||
}
|
||
|
||
}
|