';
- echo '
' . esc_html(sprintf(__('共 %s 项', 'aksrt'), number_format_i18n($total))) . '';
- if ($max_pages > 1) {
+ echo '
' . esc_html(sprintf(__('共 %s 项', 'aksrt'), number_format_i18n((int) $data['total']))) . '';
+ if ((int) $data['max_pages'] > 1) {
echo paginate_links([
- 'base' => add_query_arg('paged', '%#%'),
- 'format' => '',
- 'current' => (int) $data['page'],
- 'total' => $max_pages,
- 'type' => 'plain',
- 'prev_text' => '«',
- 'next_text' => '»',
- ]); // phpcs:ignore WordPress.Security.EscapeOutput -- paginate_links 自行转义。
+ 'base' => add_query_arg('paged', '%#%', $filter_url), 'format' => '',
+ 'current' => (int) $data['page'], 'total' => (int) $data['max_pages'],
+ 'type' => 'plain', 'prev_text' => '«', 'next_text' => '»',
+ ]);
}
echo '
';
NativeUi::card_close();
echo '';
}
-
- /** 添加视图：系统自动生成 / 文本导入 二选一。 */
- private function render_invite_codes_add(string $this_url, string $nonce): void {
- NativeUi::header(
- __('添加邀请码', 'aksrt'),
- '',
- 'dashicons-tickets-alt'
- );
- printf(
- '
',
- esc_url($this_url),
- esc_html__('返回列表', 'aksrt')
- );
-
- NativeUi::card_open(__('添加邀请码', 'aksrt'));
- echo '
';
- NativeUi::card_close();
- }
- /** 使用奖励字段集：经验值 / 积分 / 余额 / VIP 会员与赠送时长。 */
- private function render_invite_reward_fields(): void {
- echo '
';
- echo '
'
- . ''
- . ''
- . ''
- . '
';
- echo '
';
- echo '
'
- . '' . esc_html__('仅在上方选择 VIP 会员等级后生效', 'aksrt') . '
';
- echo '
';
- }
-
- /** 导出视图：状态 / 格式 选择后提交下载。 */
- private function render_invite_codes_export(string $this_url, string $nonce): void {
- NativeUi::header(
- __('导出邀请码', 'aksrt'),
- '',
- 'dashicons-download'
- );
- printf(
- '
',
- esc_url($this_url),
- esc_html__('返回列表', 'aksrt')
- );
-
- NativeUi::card_open();
- echo '
';
- NativeUi::card_close();
- }
}
diff --git a/src/Admin/Native/UsersMenusInviteForms.php b/src/Admin/Native/UsersMenusInviteForms.php
new file mode 100644
index 00000000..275888c4
--- /dev/null
+++ b/src/Admin/Native/UsersMenusInviteForms.php
@@ -0,0 +1,92 @@
+invite_dialog_open('aksrt-inv-add', __('添加邀请码', 'aksrt'), __('批量生成新邀请码，或导入已有的邀请码数据。', 'aksrt'), 'post', 'aksrt_invite_add', $nonce);
+ echo '
';
+
+ echo '
';
+ $this->invite_dialog_close(__('生成邀请码', 'aksrt'), ' data-aksrt-inv-add-submit data-auto-label="' . esc_attr__('生成邀请码', 'aksrt') . '" data-import-label="' . esc_attr__('导入邀请码', 'aksrt') . '" data-busy-label="' . esc_attr__('正在添加…', 'aksrt') . '"');
+ }
+
+ private function render_invite_reward_fields(): void {
+ echo '
';
+ }
+
+ private function render_invite_codes_export(string $nonce): void {
+ $status = in_array(($_GET['status'] ?? 'all'), ['all', 'unused', 'used'], true) ? (string) $_GET['status'] : 'all';
+ $this->invite_dialog_open('aksrt-inv-export', __('导出邀请码', 'aksrt'), __('选择使用状态与文件格式，导出后可在本地保存或分发。', 'aksrt'), 'get', 'aksrt_invite_export', $nonce);
+ echo '
';
+ echo '
' . esc_html__('每次最多导出最新的 10,000 条记录。导出仅按上方使用状态筛选，不受列表关键词、标识或勾选项影响。', 'aksrt') . '
';
+ $this->invite_dialog_close(__('导出并下载', 'aksrt'));
+ }
+
+ private function invite_dialog_open(string $id, string $title, string $description, string $method, string $action, string $nonce): void {
+ echo '
';
+ }
+}
diff --git a/src/Payment/InviteCode.php b/src/Payment/InviteCode.php
index 836a3cc5..b06866ee 100644
--- a/src/Payment/InviteCode.php
+++ b/src/Payment/InviteCode.php
@@ -293,7 +293,7 @@ final class InviteCode {
}
/**
- * 文本导入邀请码（对齐 Zibll 格式）：一行一码，`邀请码<分隔符>奖励<分隔符>标识`。
+ * 文本导入邀请码：一行一码，`邀请码<分隔符>奖励<分隔符>标识`。
* 奖励参数串：points=20&balance=30&vip=1&vip_time=5&level_integral=100（balance 单位为元），"无" 或留空表示无奖励。
*
* @return array{imported:int,failed:int,failed_codes:array
}|\WP_Error
@@ -305,6 +305,11 @@ final class InviteCode {
return new \WP_Error('aksrt_invite_db', __('数据表不可用', 'aksrt'), ['status' => 500]);
}
$raw = (string) ($args['data'] ?? '');
+ $lines = preg_split('/\r\n|\r|\n/', $raw) ?: [];
+ $lines = array_filter(array_map('trim', $lines), static fn($line) => $line !== '');
+ if (count($lines) > 1000) {
+ return new \WP_Error('aksrt_invite_import_limit', __('单次最多导入 1000 行，请拆分后重试。', 'aksrt'), ['status' => 400]);
+ }
$division = trim((string) ($args['division'] ?? ' '));
if ($division === '') {
$division = ' ';
@@ -316,15 +321,10 @@ final class InviteCode {
$created_by = get_current_user_id();
$created_at = current_time('mysql');
- $lines = array_slice(preg_split('/\r\n|\r|\n/', $raw) ?: [], 0, 1000);
$imported = 0;
$failed = 0;
$failed_codes = [];
foreach ($lines as $line) {
- $line = trim((string) $line);
- if ($line === '') {
- continue;
- }
$parts = $division === ' ' ? preg_split('/\s+/', $line, 3) : explode($division, (string) $line, 3);
$code = strtoupper(preg_replace('/[^A-Za-z0-9_-]/', '', (string) ($parts[0] ?? '')));
if ($code === '') {
@@ -365,7 +365,7 @@ final class InviteCode {
return ['imported' => $imported, 'failed' => $failed, 'failed_codes' => array_slice($failed_codes, 0, 20)];
}
- /** Zibll 兼容奖励参数串 → 归一化奖励 JSON（"无"/空串 → 全零）。 */
+ /** 导入/导出的奖励参数串 → 归一化奖励 JSON（"无"/空串 → 全零）。 */
private function parse_reward_string(string $reward): string {
$reward = trim($reward);
if ($reward === '' || in_array($reward, ['无', 'none', '0'], true)) {
@@ -435,7 +435,7 @@ final class InviteCode {
/**
* 服务端列表查询：状态筛选 / 关键字搜索 / 标识定位 / 可排序 / 分页。
*
- * @return array{items:array>,total:int,counts:array{all:int,unused:int,used:int},page:int,per_page:int,max_pages:int,orderby:string,desc:string}
+ * @return array{items:array>,total:int,page:int,per_page:int,max_pages:int,orderby:string,desc:string}
*/
public function list_codes(array $args): array {
global $wpdb;
@@ -449,7 +449,7 @@ final class InviteCode {
$orderby = $orderby_map[sanitize_key((string) ($args['orderby'] ?? ''))] ?? 'updated_at';
$desc = strtoupper((string) ($args['desc'] ?? 'DESC')) === 'ASC' ? 'ASC' : 'DESC';
if ($table === '') {
- return ['items' => [], 'total' => 0, 'counts' => ['all' => 0, 'unused' => 0, 'used' => 0], 'page' => $page, 'per_page' => $per_page, 'max_pages' => 1, 'orderby' => $orderby, 'desc' => $desc];
+ return ['items' => [], 'total' => 0, 'page' => $page, 'per_page' => $per_page, 'max_pages' => 1, 'orderby' => $orderby, 'desc' => $desc];
}
[$status_sql, $status_params] = $this->status_where($status);
@@ -466,9 +466,8 @@ final class InviteCode {
}
$where_sql = implode(' AND ', $where);
- $count_row = $params
- ? $wpdb->get_row($wpdb->prepare("SELECT COUNT(*) AS all_count, COALESCE(SUM(used_count = 0), 0) AS unused_count, COALESCE(SUM(used_count > 0), 0) AS used_count FROM {$table} WHERE {$where_sql}", $params), ARRAY_A)
- : $wpdb->get_row("SELECT COUNT(*) AS all_count, COALESCE(SUM(used_count = 0), 0) AS unused_count, COALESCE(SUM(used_count > 0), 0) AS used_count FROM {$table}", ARRAY_A);
+ $count_sql = "SELECT COUNT(*) AS all_count FROM {$table} WHERE {$where_sql}";
+ $count_row = $wpdb->get_row($params ? $wpdb->prepare($count_sql, $params) : $count_sql, ARRAY_A);
$total = (int) ($count_row['all_count'] ?? 0);
$rows = $wpdb->get_results($wpdb->prepare(
@@ -501,11 +500,6 @@ final class InviteCode {
return [
'items' => $items,
'total' => $total,
- 'counts' => [
- 'all' => (int) ($count_row['all_count'] ?? 0),
- 'unused' => (int) ($count_row['unused_count'] ?? 0),
- 'used' => (int) ($count_row['used_count'] ?? 0),
- ],
'page' => $page,
'per_page' => $per_page,
'max_pages' => max(1, (int) ceil($total / $per_page)),
@@ -591,12 +585,12 @@ final class InviteCode {
}
/** 管理操作入口守卫：权限 + nonce，通过后回跳带结果的列表页。 */
- private function guard_and_redirect(string $tab = ''): string {
+ private function guard_and_redirect(): string {
if (!current_user_can('edit_users')) {
wp_die(esc_html__('您没有权限执行此操作。', 'aksrt'), '', ['response' => 403]);
}
check_admin_referer('aksrt_invite_admin', 'aksrt_nonce');
- return admin_url('users.php?page=aksrt_invite_codes' . ($tab !== '' ? '&tab=' . $tab : ''));
+ return admin_url('users.php?page=aksrt_invite_codes');
}
private function redirect_with_notice(string $url, string $title, string $message, bool $is_error = false): never {
@@ -608,9 +602,9 @@ final class InviteCode {
exit;
}
- /** 添加视图提交：系统自动生成 或 文本导入。 */
+ /** 添加弹窗提交：系统自动生成或文本导入，结果返回列表。 */
public function handle_add(): void {
- $back = $this->guard_and_redirect('add');
+ $back = $this->guard_and_redirect();
$add_type = ($_POST['add_type'] ?? 'auto') === 'import' ? 'import' : 'auto';
if ($add_type === 'import') {
@@ -664,14 +658,14 @@ final class InviteCode {
$this->redirect_with_notice($back, __('删除完成', 'aksrt'), sprintf(__('已删除%d个邀请码', 'aksrt'), $deleted));
}
- /** 导出视图提交：文本（可回流导入）或 Excel/CSV 表格。 */
+ /** 导出弹窗提交：文本（可回流导入）或 Excel/CSV 表格。 */
public function handle_export(): void {
if (!current_user_can('edit_users')) {
wp_die(esc_html__('您没有权限执行此操作。', 'aksrt'), '', ['response' => 403]);
}
check_admin_referer('aksrt_invite_admin', 'aksrt_nonce');
$status = in_array(($_GET['status'] ?? 'all'), ['all', 'unused', 'used'], true) ? (string) $_GET['status'] : 'all';
- $format = ($_GET['export_format'] ?? 'xls') === 'text' ? 'text' : 'xls';
+ $format = ($_GET['export_format'] ?? 'csv') === 'text' ? 'text' : 'csv';
$division = trim((string) wp_unslash($_GET['text_division'] ?? ' '));
if ($division === '') {
$division = ' ';
diff --git a/tests/widget-system/invite-admin-contract.test.cjs b/tests/widget-system/invite-admin-contract.test.cjs
new file mode 100644
index 00000000..8e5ef471
--- /dev/null
+++ b/tests/widget-system/invite-admin-contract.test.cjs
@@ -0,0 +1,198 @@
+'use strict';
+
+const assert = require('node:assert/strict');
+const fs = require('node:fs');
+const path = require('node:path');
+const { spawnSync } = require('node:child_process');
+const test = require('node:test');
+
+const root = path.resolve(__dirname, '../..');
+const read = (...segments) => fs.readFileSync(path.join(root, ...segments), 'utf8');
+let rendered;
+function harness() {
+ if (!rendered) {
+ const result = spawnSync('php', [path.join(__dirname, 'invite-admin-harness.php')], { encoding: 'utf8' });
+ assert.equal(result.status, 0, `${result.stderr}${result.stdout}`);
+ rendered = JSON.parse(result.stdout);
+ }
+ return rendered;
+}
+function dialog(html, id) {
+ const match = html.match(new RegExp(`]*\\bid="${id}"[^>]*>[\\s\\S]*?<\\/dialog>`));
+ assert.ok(match, `missing ${id} dialog`);
+ return match[0];
+}
+function input(html, name) {
+ const match = html.match(new RegExp(`]*\\bname="${name}"[^>]*>`));
+ assert.ok(match, `missing input ${name}`);
+ return match[0];
+}
+function fieldset(html, dependency) {
+ const tags = [...html.matchAll(/]*data-aksrt-inv-dep="([^"]+)"[^>]*>/g)];
+ const found = tags.find(([, value]) => value === dependency);
+ assert.ok(found, `missing conditional fieldset ${dependency}`);
+ return found[0];
+}
+function attr(tag, name, value) {
+ assert.match(tag, new RegExp(`\\b${name}="${value.replace(/[.*+?^${}()|[\\]\\\\]/g, '\\$&')}"`));
+}
+function hasBooleanAttr(tag, name) {
+ assert.match(tag, new RegExp(`(?:\\s|^)${name}(?:\\s|>|$)`));
+}
+
+test('page renders add and export dialogs beside, not inside, the list form', () => {
+ const { html } = harness();
+ const listMarker = html.indexOf('data-aksrt-inv-list');
+ assert.ok(listMarker > 0, 'list form is rendered');
+ const listStart = html.lastIndexOf('', listMarker);
+ const addStart = html.indexOf('= 0 && listEnd > listStart);
+ assert.ok(listEnd < addIndex, 'the list form closes before the add dialog');
+ assert.ok(addIndex < exportIndex, 'add and export dialogs are rendered as adjacent page siblings');
+ assert.ok(html.indexOf('', addIndex) < exportIndex);
+ assert.ok(addStart < 0 || addStart === addIndex, 'dialog extraction begins at its opening tag');
+ assert.doesNotMatch(addDialog, /]*>[^]*