ensure_cap(); NativeUi::page_open(); NativeUi::header(__('订单明细', 'aksrt'), '', 'dashicons-list-view'); $this->render_flash(); if (!class_exists('\AKSRT\Payment\OrderRepository')) { echo '

' . esc_html__('订单服务不可用。', 'aksrt') . '

'; NativeUi::page_close(); return; } $detail_order = isset($_GET['order']) ? sanitize_text_field((string) wp_unslash($_GET['order'])) : ''; if ($detail_order !== '') { $this->render_order_detail_page($detail_order); NativeUi::page_close(); return; } $type_tabs = [ '' => __('全部类型', 'aksrt'), \AKSRT\Core\DomainModel::ORDER_PRODUCT_READING => __('付费阅读', 'aksrt'), \AKSRT\Core\DomainModel::ORDER_PRODUCT_DOWNLOAD => __('付费下载', 'aksrt'), \AKSRT\Core\DomainModel::ORDER_PRODUCT_IMAGE => __('付费图片', 'aksrt'), \AKSRT\Core\DomainModel::ORDER_PRODUCT_VIDEO => __('付费视频', 'aksrt'), \AKSRT\Core\DomainModel::ORDER_PRODUCT_VIP => __('购买会员', 'aksrt'), \AKSRT\Core\DomainModel::ORDER_PRODUCT_RECHARGE => __('余额充值', 'aksrt'), \AKSRT\Core\DomainModel::ORDER_PRODUCT_POINTS => __('购买积分', 'aksrt'), ]; $method_tabs = [ '' => __('支付方式', 'aksrt'), 'balance' => __('余额', 'aksrt'), 'points' => __('积分', 'aksrt'), 'gateway' => __('第三方网关支付', 'aksrt'), ]; $status = isset($_GET['status']) ? sanitize_key((string) wp_unslash($_GET['status'])) : ''; $search = isset($_GET['s']) ? sanitize_text_field((string) wp_unslash($_GET['s'])) : ''; $product_type = isset($_GET['product_type']) ? sanitize_key((string) wp_unslash($_GET['product_type'])) : ''; $product_id = isset($_GET['product_id']) ? max(0, (int) $_GET['product_id']) : 0; $user_id = isset($_GET['user_id']) ? max(0, (int) $_GET['user_id']) : 0; $pay_method = isset($_GET['payment_method']) ? sanitize_key((string) wp_unslash($_GET['payment_method'])) : ''; $date_from = isset($_GET['date_from']) ? sanitize_text_field((string) wp_unslash($_GET['date_from'])) : ''; $date_to = isset($_GET['date_to']) ? sanitize_text_field((string) wp_unslash($_GET['date_to'])) : ''; $page_num = max(1, (int) ($_GET['paged'] ?? 1)); $per_page = AdminListPagination::DEFAULT_PER_PAGE; if (!array_key_exists($product_type, $type_tabs)) { $product_type = ''; } if (!array_key_exists($pay_method, $method_tabs)) { $pay_method = ''; } $repo = \AKSRT\Payment\OrderRepository::get_instance(); $args = [ 'limit' => $per_page, 'offset' => ($page_num - 1) * $per_page, 'date_from' => $date_from, 'date_to' => $date_to, ]; if ($status !== '' && $status !== 'all') { $args['status'] = $status; } if ($product_type !== '') { $args['product_type'] = $product_type; } if ($product_id > 0) { $args['product_id'] = $product_id; } if ($user_id > 0) { $args['user_id'] = $user_id; } if ($pay_method === 'gateway') { $args['payment_methods'] = $this->third_party_gateway_ids(); } elseif ($pay_method !== '') { $args['payment_methods'] = [$pay_method]; } $items = $repo->get_orders_admin($args, $search); $total = $repo->get_orders_count($args, $search); $pages = max(1, (int) ceil($total / $per_page)); $labels = class_exists('\AKSRT\Core\DomainModel') ? \AKSRT\Core\DomainModel::order_status_labels() : []; // 页码越界（手工改 URL、或筛选后总数变小）会让 offset 落到数据之外：表格空掉 // 且分页条不输出，只能手改 URL 退出。回退到最后一页重查一次。 if ($page_num > $pages) { $page_num = $pages; $args['offset'] = ($page_num - 1) * $per_page; $items = $repo->get_orders_admin($args, $search); } // 当前筛选参数（不含 paged）：标签页链接与翻页链接共用同一份，避免两处漂移。 $query_args = array_filter([ 'product_type' => $product_type !== '' ? $product_type : null, 'product_id' => $product_id > 0 ? $product_id : null, 'user_id' => $user_id > 0 ? $user_id : null, 'payment_method' => $pay_method !== '' ? $pay_method : null, 'status' => ($status !== '' && $status !== 'all') ? $status : null, 'date_from' => $date_from !== '' ? $date_from : null, 'date_to' => $date_to !== '' ? $date_to : null, 's' => $search !== '' ? $search : null, ], static function ($value): bool { return $value !== null; }); // Type tabs. echo '

'; foreach ($type_tabs as $tkey => $tlabel) { $url = $this->page_url('aksrt_orders', array_filter( ['product_type' => $tkey !== '' ? $tkey : null] + $query_args, static function ($value): bool { return $value !== null; } )); $cls = ($product_type === $tkey) ? ' is-active' : ''; echo '' . esc_html($tlabel) . ''; } echo '

'; // Payment method quick tabs. echo '

'; foreach ($method_tabs as $mkey => $mlabel) { $url = $this->page_url('aksrt_orders', array_filter( ['payment_method' => $mkey !== '' ? $mkey : null] + $query_args, static function ($value): bool { return $value !== null; } )); $cls = ($pay_method === $mkey) ? ' is-active' : ''; echo '' . esc_html($mlabel) . ''; } echo '

'; NativeUi::card_open(__('筛选', 'aksrt')); echo '

'; echo ''; if ($product_type !== '') { echo ''; } if ($product_id > 0) { echo ''; } if ($pay_method !== '') { echo ''; } echo '' . esc_html__('开始日期', 'aksrt') . ' '; echo '' . esc_html__('结束日期', 'aksrt') . ' '; echo ' '; echo ' '; echo ' '; submit_button(__('筛选', 'aksrt'), 'secondary', '', false); if ($product_id > 0 || $product_type !== '' || $user_id > 0 || $pay_method !== '' || $date_from !== '' || $date_to !== '') { $filter_bits = []; if ($product_type !== '') { $filter_bits[] = sprintf(__('类型=%s', 'aksrt'), $product_type); } if ($product_id > 0) { $filter_bits[] = sprintf(__('商品ID=%d', 'aksrt'), $product_id); } if ($user_id > 0) { $filter_bits[] = sprintf(__('用户=%d', 'aksrt'), $user_id); } if ($pay_method !== '') { $filter_bits[] = sprintf(__('支付方式=%s', 'aksrt'), $method_tabs[$pay_method]); } if ($date_from !== '') $filter_bits[] = sprintf(__('开始日期=%s', 'aksrt'), $date_from); if ($date_to !== '') $filter_bits[] = sprintf(__('结束日期=%s', 'aksrt'), $date_to); echo ' ' . esc_html(implode(' · ', $filter_bits)) . ''; echo ' ' . esc_html__('清除过滤', 'aksrt') . ''; } echo '

'; // Closed-order cleanup. echo ''; NativeUi::card_close(); $status_map = $this->status_badge_map($labels); NativeUi::table_card_open(__('订单明细', 'aksrt')); echo ''; echo ''; echo ''; echo ''; echo ''; echo ''; echo ''; echo ''; echo ''; echo ''; if (!$items) { echo NativeUi::empty_row(7, __('暂无订单', 'aksrt')); } foreach ($items as $row) { $order_number = (string) ($row['order_number'] ?? ''); $user_id = (int) ($row['user_id'] ?? 0); $status_key = (string) ($row['status'] ?? ''); $product_id = (int) ($row['product_id'] ?? 0); $product_type = sanitize_key((string) ($row['product_type'] ?? '')); $type_labels = \AKSRT\Core\DomainModel::order_product_type_labels(); $meta = is_array($row['meta_payload'] ?? null) ? $row['meta_payload'] : []; $product_title = (string) ($meta['product_title'] ?? $meta['title'] ?? $meta['package_title'] ?? ''); if ($product_title === '' && $product_id > 0 && $product_type === \AKSRT\Core\DomainModel::ORDER_PRODUCT_RESOURCE) { $product_title = (string) get_the_title($product_id); } echo ''; echo ''; echo ''; echo ''; echo ''; echo ''; echo ''; echo ''; echo ''; } echo '

' . esc_html__('订单号', 'aksrt') . '	' . esc_html__('用户', 'aksrt') . '	' . esc_html__('商品信息', 'aksrt') . '	' . esc_html__('金额 / 支付方式', 'aksrt') . '	' . esc_html__('状态', 'aksrt') . '	' . esc_html__('创建 / 支付时间', 'aksrt') . '	' . esc_html__('操作', 'aksrt') . '
`' . esc_html($order_number) . '`	' . NativeUi::user_cell($user_id) . '	' . esc_html($product_title !== '' ? $product_title : ($type_labels[$product_type] ?? $product_type)) . ' ' . esc_html($type_labels[$product_type] ?? $product_type) . ($product_id > 0 ? ' #' . esc_html((string) $product_id) : '') . '	' . esc_html($this->order_amount($row)) . ' ' . esc_html((string) ($row['payment_method'] ?? '')) . '	' . NativeUi::status_badge($status_key, $status_map) . '	' . esc_html((string) ($row['created_at'] ?? '')) . ' ' . esc_html((string) ($row['paid_at'] ?? '') ?: '—') . '	'; echo '' . esc_html__('详情', 'aksrt') . ''; // 已支付是已退款的唯一前置状态。 if ($status_key === \AKSRT\Core\DomainModel::ORDER_STATUS_PAID) { echo ' '; echo ''; echo ''; wp_nonce_field('aksrt_pay_refund_order_' . $order_number); submit_button(__('退款', 'aksrt'), 'small', '', false); echo ' '; } $this->render_order_quick_status_buttons($order_number, $status_key); if ($status_key === 'closed') { echo ' '; echo ''; echo ''; wp_nonce_field('aksrt_pay_delete_order_' . $order_number); submit_button(__('删除', 'aksrt'), 'small', '', false); echo ' '; } echo '

'; NativeUi::table_wrap_close(); AdminListPagination::render(self::PAGE_SLUG, $total, $page_num, $per_page, $query_args); NativeUi::card_close(); NativeUi::page_close(); } /** * 订单状态键 → [文案, 色调] 映射，供 NativeUi::status_badge() 用。 * * @param array $labels DomainModel::order_status_labels() * @return array */ private function status_badge_map(array $labels): array { $tones = [ \AKSRT\Core\DomainModel::ORDER_STATUS_PENDING => 'warning', \AKSRT\Core\DomainModel::ORDER_STATUS_PAID => 'success', \AKSRT\Core\DomainModel::ORDER_STATUS_REFUNDED => 'info', \AKSRT\Core\DomainModel::ORDER_STATUS_CLOSED => 'neutral', ]; $map = []; foreach ($labels as $key => $label) { $map[$key] = [(string) $label, $tones[$key] ?? 'neutral']; } return $map; } private function render_order_detail_page(string $order_number): void { $repo = \AKSRT\Payment\OrderRepository::get_instance(); $order = $repo->get($order_number); if (!$order) { echo '

' . esc_html__('订单不存在。', 'aksrt') . '

'; echo '

' . esc_html__('返回订单列表', 'aksrt') . '

'; return; } $labels = class_exists('\AKSRT\Core\DomainModel') ? \AKSRT\Core\DomainModel::order_status_labels() : []; $context = $repo->get_admin_order_context($order_number); $user_id = (int) ($order['user_id'] ?? 0); $user = $user_id > 0 ? get_userdata($user_id) : null; $status = (string) ($order['status'] ?? ''); $meta = is_array($order['meta_payload'] ?? null) ? $order['meta_payload'] : []; $customer_note = (string) ($context['customer_note'] ?? $order['note_text'] ?? ''); $admin_note = is_array($meta) ? (string) ($meta['admin_note'] ?? '') : ''; if ($admin_note === '' && $customer_note === '' && !empty($order['note']) && !is_array(json_decode((string) $order['note'], true))) { $admin_note = (string) $order['note']; } $back = NativeUi::button_link(__('返回订单列表', 'aksrt'), $this->page_url('aksrt_orders'), false, 'dashicons-arrow-left-alt'); NativeUi::card_open(sprintf(__('订单 %s', 'aksrt'), $order_number), $back); echo ''; $rows = [ __('订单号', 'aksrt') => esc_html($order_number), __('用户', 'aksrt') => $user_id > 0 ? NativeUi::user_cell($user_id) : esc_html((string) $user_id), __('商品类型', 'aksrt') => esc_html(\AKSRT\Core\DomainModel::order_product_type_labels()[(string) ($order['product_type'] ?? '')] ?? (string) ($order['product_type'] ?? '')), __('商品 ID', 'aksrt') => esc_html((string) ($order['product_id'] ?? '')), __('金额', 'aksrt') => esc_html($this->order_amount($order)), __('状态', 'aksrt') => NativeUi::status_badge($status, $this->status_badge_map($labels)), __('支付方式', 'aksrt') => esc_html((string) ($order['payment_method'] ?? '')), __('渠道交易号', 'aksrt') => esc_html((string) ($order['payment_transaction_id'] ?? '')), __('创建时间', 'aksrt') => esc_html((string) ($order['created_at'] ?? '')), __('支付时间', 'aksrt') => esc_html((string) ($order['paid_at'] ?? '')), __('买家备注', 'aksrt') => esc_html($customer_note), ]; foreach ($rows as $label => $value) { echo ''; } if (!empty($context)) { echo ''; } echo '

' . esc_html($label) . '	' . $value . '
' . esc_html__('附加上下文', 'aksrt') . '	' . esc_html(wp_json_encode($context, JSON_UNESCAPED_UNICODE \| JSON_PRETTY_PRINT)) . '

'; NativeUi::card_close(); NativeUi::card_open(__('运营备注', 'aksrt')); echo ''; NativeUi::card_close(); NativeUi::card_open(__('更新状态', 'aksrt')); echo ''; NativeUi::card_close(); } public function handle_update_order_status(): void { if (!current_user_can(self::CAPABILITY)) { wp_die(esc_html__('权限不足', 'aksrt')); } $order_number = isset($_POST['order_number']) ? sanitize_text_field((string) wp_unslash($_POST['order_number'])) : ''; $new_status = isset($_POST['new_status']) ? sanitize_key((string) wp_unslash($_POST['new_status'])) : ''; check_admin_referer('aksrt_pay_update_order_status_' . $order_number); $ok = false; if ($order_number !== '' && $new_status !== '' && class_exists('\AKSRT\Payment\OrderRepository')) { $ok = \AKSRT\Payment\OrderRepository::get_instance()->update_status($order_number, $new_status); } $args = ['aksrt_pay_msg' => $ok ? 'order_updated' : 'order_failed']; $redirect_order = isset($_POST['redirect_order']) ? sanitize_text_field((string) wp_unslash($_POST['redirect_order'])) : ''; if ($redirect_order !== '') { $args['order'] = $redirect_order; } wp_safe_redirect($this->page_url('aksrt_orders', $args)); exit; } /** * 订单列表「退款」：把已支付订单推到已退款。 * * 退款闸门只剩「订单当前为已支付」——工单系统与订单退款已解耦， * 不再要求先有一条进行中的工单。 */ public function handle_refund_order(): void { if (!current_user_can(self::CAPABILITY)) { wp_die(esc_html__('权限不足', 'aksrt')); } $order_number = isset($_POST['order_number']) ? sanitize_text_field((string) wp_unslash($_POST['order_number'])) : ''; check_admin_referer('aksrt_pay_refund_order_' . $order_number); $code = 'order_refund_failed'; if ($order_number !== '' && class_exists('\AKSRT\Payment\OrderRepository')) { $repo = \AKSRT\Payment\OrderRepository::get_instance(); $order = $repo->get($order_number); if (!is_array($order)) { $code = 'order_refund_missing'; } elseif ((string) ($order['status'] ?? '') !== \AKSRT\Core\DomainModel::ORDER_STATUS_PAID) { $code = 'order_refund_not_paid'; } else { $ok = $repo->update_status($order_number, \AKSRT\Core\DomainModel::ORDER_STATUS_REFUNDED, [ 'allow_refund' => true, 'note' => __('管理员在订单列表中标记退款', 'aksrt'), ]); $code = $ok ? 'order_refunded' : 'order_refund_failed'; } } wp_safe_redirect($this->page_url('aksrt_orders', ['aksrt_pay_msg' => $code])); exit; } public function handle_update_order_note(): void { if (!current_user_can(self::CAPABILITY)) { wp_die(esc_html__('权限不足', 'aksrt')); } $order_number = isset($_POST['order_number']) ? sanitize_text_field((string) wp_unslash($_POST['order_number'])) : ''; $admin_note = isset($_POST['admin_note']) ? sanitize_textarea_field((string) wp_unslash($_POST['admin_note'])) : ''; check_admin_referer('aksrt_pay_update_order_note_' . $order_number); $ok = false; if ($order_number !== '' && class_exists('\AKSRT\Payment\OrderRepository')) { $ok = \AKSRT\Payment\OrderRepository::get_instance()->update_admin_note($order_number, $admin_note); } wp_safe_redirect($this->page_url('aksrt_orders', [ 'order' => $order_number, 'aksrt_pay_msg' => $ok ? 'order_note_updated' : 'order_note_failed', ])); exit; } public function handle_clear_closed_orders(): void { if (!current_user_can(self::CAPABILITY)) { wp_die(esc_html__('权限不足', 'aksrt')); } check_admin_referer('aksrt_pay_clear_closed_orders'); $days = isset($_POST['days']) ? max(1, min(3650, (int) $_POST['days'])) : 14; $deleted = 0; if (class_exists('\AKSRT\Payment\OrderRepository')) { $repo = \AKSRT\Payment\OrderRepository::get_instance(); $deleted = $repo->clear_closed_orders($days); } wp_safe_redirect($this->page_url('aksrt_orders', [ 'aksrt_pay_msg' => $deleted > 0 ? 'orders_cleared' : 'orders_clear_empty', 'cleared' => $deleted, ])); exit; } public function handle_delete_order(): void { if (!current_user_can(self::CAPABILITY)) { wp_die(esc_html__('权限不足', 'aksrt')); } $order_number = isset($_POST['order_number']) ? sanitize_text_field((string) wp_unslash($_POST['order_number'])) : ''; check_admin_referer('aksrt_pay_delete_order_' . $order_number); $ok = false; if ($order_number !== '' && class_exists('\AKSRT\Payment\OrderRepository')) { $repo = \AKSRT\Payment\OrderRepository::get_instance(); $order = $repo->get($order_number); $status = is_array($order) ? (string) ($order['status'] ?? '') : ''; // Only allow hard-delete of closed rows (safety). if ($status === 'closed') { $ok = $repo->delete_order($order_number); } } wp_safe_redirect($this->page_url('aksrt_orders', [ 'aksrt_pay_msg' => $ok ? 'order_deleted' : 'order_delete_failed', ])); exit; } private function render_order_quick_status_buttons(string $order_number, string $current_status, bool $redirect_detail = false): void { $labels = [ 'paid' => __('确认收款', 'aksrt'), 'closed' => __('关闭订单', 'aksrt'), ]; $transitions = \AKSRT\Core\DomainModel::order_transitions(); foreach ((array) ($transitions[$current_status] ?? []) as $status) { if ($status === \AKSRT\Core\DomainModel::ORDER_STATUS_REFUNDED) continue; $label = $labels[$status] ?? $status; $confirm = sprintf(__('确认将订单状态改为“%s”？', 'aksrt'), $label); echo ''; } } private function ensure_cap(): void { if (!current_user_can(self::CAPABILITY)) { wp_die(esc_html__('您没有权限访问此页面。', 'aksrt')); } } private function cash_decimal(string $value): string { try { return \AKSRT\Ledger\AssetAmount::balance($value)->decimal(); } catch (\InvalidArgumentException $e) { return '0.00'; } } /** @return string[] */ private function third_party_gateway_ids(): array { return array_values(array_diff( array_keys(\AKSRT\Payment\Gateway::get_instance()->get_all()), ['balance', 'points'] )); } /** @param array $order */ private function order_amount(array $order): string { $currency = sanitize_key((string) ($order['currency'] ?? '')); $method = sanitize_key((string) ($order['payment_method'] ?? '')); if ($currency === 'points' || $method === 'points') { return max(0, (int) ($order['amount'] ?? 0)) . ' ' . __('积分', 'aksrt'); } return $this->cash_decimal((string) ($order['amount'] ?? '0')) . ' ' . strtoupper((string) ($order['currency'] ?? 'CNY')); } private function render_flash(): void { if (empty($_GET['aksrt_pay_msg'])) { return; } $code = sanitize_key((string) wp_unslash($_GET['aksrt_pay_msg'])); $map = [ 'order_updated' => __('订单状态已更新。', 'aksrt'), 'order_failed' => __('订单状态更新失败。', 'aksrt'), 'order_refunded' => __('订单已标记为已退款。', 'aksrt'), 'order_refund_failed' => __('订单标记退款失败。', 'aksrt'), 'order_refund_missing' => __('订单不存在。', 'aksrt'), 'order_refund_not_paid' => __('仅已支付订单可以标记退款。', 'aksrt'), 'order_note_updated' => __('订单备注已保存。', 'aksrt'), 'order_note_failed' => __('订单备注保存失败。', 'aksrt'), 'orders_cleared' => sprintf( /* translators: %d deleted count */ __('已清理 %d 条关闭订单。', 'aksrt'), max(0, (int) ($_GET['cleared'] ?? 0)) ), 'orders_clear_empty' => __('没有可清理的关闭订单。', 'aksrt'), 'order_deleted' => __('订单已删除。', 'aksrt'), 'order_delete_failed' => __('订单删除失败（仅允许删除已关闭订单）。', 'aksrt'), 'shipping_updated' => __('物流状态已更新。', 'aksrt'), 'shipping_failed' => __('物流状态更新失败。', 'aksrt'), 'shipping_created' => __('发货记录已创建。', 'aksrt'), 'shipping_create_failed' => __('发货记录创建失败。', 'aksrt'), ]; if (!isset($map[$code])) { return; } $class = str_contains($code, 'failed') ? 'notice-error' : 'notice-success'; echo '

' . esc_html($map[$code]) . '

'; } private function page_url(string $slug, array $args = []): string { return add_query_arg(array_merge(['page' => $slug], $args), admin_url('admin.php')); } }