kate522/wordpress-theme-aksrt
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

feat(admin): plate moderator roles, advanced limits, coupon scope edit/batch

Browse Source
This commit is contained in:
kate522
2026-07-15 03:30:08 +08:00
parent 733a1670ec
commit deee48245f
8 changed files with 849 additions and 338 deletions
Download Patch File Download Diff File Expand all files Collapse all files
docs/zibll-gap-matrix.md
+2 -2
View File
@@ -99,8 +99,8 @@ Note: zibll「商品管理」`zibpay_product_page` is **paid article sales**, no
| 2b Shipping/after-sale/coupons/income/rebate | done |
| 3 users.php submenus | done |
| 4 SPA strip | done (ops routes redirect to native) |
| 5+ behavior parity | in progress — shipping list create + pending-to-ship board + express timeline query; after-sale filters/actions; order note/quick actions; coupons field parity + batch/enable + product_scope; charge-cards expires + code dump + search/labels; product meta shipping/service/limit fields; plate allow_view/add_limit; topic visibility column |
| 5 remaining | deeper forum runtime (moderator roles UI, advanced plate options); coupon product_scope batch/edit |
| 5+ behavior parity | in progress — shipping list create + pending-to-ship board + express timeline query; after-sale filters/actions; order note/quick actions; coupons field parity + batch/enable + product_scope create/edit/batch (native module split); charge-cards expires + code dump + search/labels; product meta shipping/service/limit fields; plate allow_view/add_limit/follow/role + moderator roles UI; topic visibility column |
| 5 remaining | optional plate icon/sort native fields; further pay-menus modular split (shipping/charge-card still in shell); zibll pay-hide/points plate options out of scope |
## Dual-UI rule
functions.php
+3
View File
@@ -356,6 +356,9 @@ if (class_exists('AKSRT_User_Credits_Admin')) {
if (is_admin() && class_exists('AKSRT_Admin_Pay_Menus')) {
AKSRT_Admin_Pay_Menus::get_instance()->init();
}
if (is_admin() && class_exists('AKSRT_Admin_Pay_Coupons')) {
AKSRT_Admin_Pay_Coupons::get_instance()->init();
}
// WordPress 原生用户菜单：消息/邀请码/认证/禁封（zibll users.php 子菜单对齐）
if (is_admin() && class_exists('AKSRT_Admin_Users_Menus')) {
inc/bootstrap.php
+1
View File
@@ -173,6 +173,7 @@ require_once AKSRT_DIR . '/inc/classes/class-aksrt-update-checker.php';
require_once AKSRT_DIR . '/inc/classes/class-aksrt-category-rewrite.php';
require_once AKSRT_DIR . '/inc/classes/admin/class-aksrt-admin-message-controller.php';
require_once AKSRT_DIR . '/inc/classes/admin/native/class-aksrt-admin-pay-menus.php';
require_once AKSRT_DIR . '/inc/classes/admin/native/class-aksrt-admin-pay-coupons.php';
require_once AKSRT_DIR . '/inc/classes/admin/native/class-aksrt-admin-users-menus.php';
require_once AKSRT_DIR . '/inc/classes/class-aksrt-admin.php';
inc/classes/admin/native/class-aksrt-admin-pay-coupons.php
+478
View File
@@ -0,0 +1,478 @@
<?php
/**
* Native WP admin: coupon list / create / batch / edit (product_scope).
*
* Extracted from AKSRT_Admin_Pay_Menus to keep pay-menus shell smaller.
*
* @package AKSRT
*/
defined('ABSPATH') || exit;
class AKSRT_Admin_Pay_Coupons {
public const CAPABILITY = 'manage_options';
public const PAGE_SLUG = 'aksrt_coupons';
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_create_coupon', [$this, 'handle_create_coupon']);
add_action('admin_post_aksrt_pay_batch_coupons', [$this, 'handle_batch_coupons']);
add_action('admin_post_aksrt_pay_update_coupon', [$this, 'handle_update_coupon']);
add_action('admin_post_aksrt_pay_disable_coupon', [$this, 'handle_disable_coupon']);
add_action('admin_post_aksrt_pay_enable_coupon', [$this, 'handle_enable_coupon']);
}
public function render_page(): void {
$this->ensure_cap();
$this->render_header(__('优惠码', 'aksrt'));
if (!class_exists('AKSRT_Coupon')) {
echo '<div class="notice notice-error"><p>' . esc_html__('优惠码模块未初始化。', 'aksrt') . '</p></div>';
$this->render_footer();
return;
}
$svc = AKSRT_Coupon::get_instance();
$edit_id = isset($_GET['edit_id']) ? (int) $_GET['edit_id'] : 0;
$edit_row = $edit_id > 0 ? $svc->get($edit_id) : null;
if ($edit_id > 0 && $edit_row) {
$this->render_edit_form($edit_row);
} elseif ($edit_id > 0) {
echo '<div class="notice notice-error"><p>' . esc_html__('优惠码不存在。', 'aksrt') . '</p></div>';
}
$this->render_create_form();
$this->render_batch_form();
$this->render_generated_dump();
$this->render_list($svc);
$this->render_footer();
}
/**
* @param array<string,mixed> $row
*/
private function render_edit_form(array $row): void {
$id = (int) ($row['id'] ?? 0);
$scope = is_array($row['product_scope'] ?? null) ? $row['product_scope'] : [];
$scope_type = sanitize_key((string) ($scope['type'] ?? ''));
$scope_ids = array_map('intval', (array) ($scope['ids'] ?? []));
$expires = (string) ($row['expires_at'] ?? '');
$expires_local = $expires !== '' ? str_replace(' ', 'T', substr($expires, 0, 16)) : '';
echo '<h2>' . esc_html(sprintf(
/* translators: %d coupon id */
__('编辑优惠码 #%d', 'aksrt'),
$id
)) . '</h2>';
echo '<p><a href="' . esc_url($this->page_url()) . '">&larr; ' . esc_html__('返回列表', 'aksrt') . '</a></p>';
echo '<form method="post" action="' . esc_url(admin_url('admin-post.php')) . '" style="margin-bottom:20px;display:flex;gap:8px;flex-wrap:wrap;align-items:end;">';
echo '<input type="hidden" name="action" value="aksrt_pay_update_coupon" />';
echo '<input type="hidden" name="coupon_id" value="' . esc_attr((string) $id) . '" />';
wp_nonce_field('aksrt_pay_update_coupon_' . $id);
echo '<p><label>' . esc_html__('代码', 'aksrt') . '<br><input type="text" value="' . esc_attr((string) ($row['code'] ?? '')) . '" class="regular-text" readonly /></label></p>';
echo '<p><label>' . esc_html__('类型', 'aksrt') . '<br><select name="type">';
foreach (['fixed' => __('固定金额', 'aksrt'), 'percent' => __('折扣百分比', 'aksrt')] as $k => $label) {
printf('<option value="%s"%s>%s</option>', esc_attr($k), selected((string) ($row['type'] ?? ''), $k, false), esc_html($label));
}
echo '</select></label></p>';
echo '<p><label>' . esc_html__('面值', 'aksrt') . '<br><input type="number" step="0.01" name="value" value="' . esc_attr((string) ($row['value'] ?? 0)) . '" /></label></p>';
echo '<p><label>' . esc_html__('最低消费', 'aksrt') . '<br><input type="number" step="0.01" name="min_amount" value="' . esc_attr((string) ($row['min_amount'] ?? 0)) . '" /></label></p>';
echo '<p><label>' . esc_html__('最高优惠(百分比用)', 'aksrt') . '<br><input type="number" step="0.01" name="max_discount" value="' . esc_attr((string) ($row['max_discount'] ?? 0)) . '" /></label></p>';
echo '<p><label>' . esc_html__('总次数(0=不限)', 'aksrt') . '<br><input type="number" name="usage_limit" value="' . esc_attr((string) ($row['usage_limit'] ?? 0)) . '" /></label></p>';
echo '<p><label>' . esc_html__('每人限次(0=不限)', 'aksrt') . '<br><input type="number" name="per_user_limit" value="' . esc_attr((string) ($row['per_user_limit'] ?? 0)) . '" /></label></p>';
$this->render_scope_fields($scope_type, implode(',', $scope_ids));
echo '<p><label>' . esc_html__('过期时间', 'aksrt') . '<br><input type="datetime-local" name="expires_at" value="' . esc_attr($expires_local) . '" /></label></p>';
submit_button(__('保存修改', 'aksrt'), 'primary', '', false);
echo '</form><hr>';
}
private function render_create_form(): void {
echo '<h2>' . esc_html__('新建优惠码', 'aksrt') . '</h2>';
echo '<form method="post" action="' . esc_url(admin_url('admin-post.php')) . '" style="margin-bottom:20px;display:flex;gap:8px;flex-wrap:wrap;align-items:end;">';
echo '<input type="hidden" name="action" value="aksrt_pay_create_coupon" />';
wp_nonce_field('aksrt_pay_create_coupon');
echo '<p><label>' . esc_html__('代码', 'aksrt') . '<br><input type="text" name="code" required /></label></p>';
echo '<p><label>' . esc_html__('类型', 'aksrt') . '<br><select name="type"><option value="fixed">' . esc_html__('固定金额', 'aksrt') . '</option><option value="percent">' . esc_html__('折扣百分比', 'aksrt') . '</option></select></label></p>';
echo '<p><label>' . esc_html__('面值', 'aksrt') . '<br><input type="number" step="0.01" name="value" value="0" /></label></p>';
echo '<p><label>' . esc_html__('最低消费', 'aksrt') . '<br><input type="number" step="0.01" name="min_amount" value="0" /></label></p>';
echo '<p><label>' . esc_html__('最高优惠(百分比用)', 'aksrt') . '<br><input type="number" step="0.01" name="max_discount" value="0" /></label></p>';
echo '<p><label>' . esc_html__('总次数(0=不限)', 'aksrt') . '<br><input type="number" name="usage_limit" value="0" /></label></p>';
echo '<p><label>' . esc_html__('每人限次(0=不限)', 'aksrt') . '<br><input type="number" name="per_user_limit" value="0" /></label></p>';
$this->render_scope_fields('', '');
echo '<p><label>' . esc_html__('过期时间', 'aksrt') . '<br><input type="datetime-local" name="expires_at" /></label></p>';
submit_button(__('创建', 'aksrt'), 'primary', '', false);
echo '</form>';
}
private function render_batch_form(): void {
echo '<h2>' . esc_html__('批量生成优惠码', 'aksrt') . '</h2>';
echo '<form method="post" action="' . esc_url(admin_url('admin-post.php')) . '" style="margin-bottom:20px;display:flex;gap:8px;flex-wrap:wrap;align-items:end;">';
echo '<input type="hidden" name="action" value="aksrt_pay_batch_coupons" />';
wp_nonce_field('aksrt_pay_batch_coupons');
echo '<p><label>' . esc_html__('数量', 'aksrt') . '<br><input type="number" name="count" min="1" max="100" value="10" /></label></p>';
echo '<p><label>' . esc_html__('长度', 'aksrt') . '<br><input type="number" name="length" min="6" max="24" value="10" /></label></p>';
echo '<p><label>' . esc_html__('前缀', 'aksrt') . '<br><input type="text" name="prefix" value="" /></label></p>';
echo '<p><label>' . esc_html__('类型', 'aksrt') . '<br><select name="type"><option value="fixed">' . esc_html__('固定金额', 'aksrt') . '</option><option value="percent">' . esc_html__('折扣百分比', 'aksrt') . '</option></select></label></p>';
echo '<p><label>' . esc_html__('面值', 'aksrt') . '<br><input type="number" step="0.01" name="value" value="10" /></label></p>';
echo '<p><label>' . esc_html__('最低消费', 'aksrt') . '<br><input type="number" step="0.01" name="min_amount" value="0" /></label></p>';
echo '<p><label>' . esc_html__('最高优惠', 'aksrt') . '<br><input type="number" step="0.01" name="max_discount" value="0" /></label></p>';
echo '<p><label>' . esc_html__('总次数(0=不限)', 'aksrt') . '<br><input type="number" name="usage_limit" value="1" /></label></p>';
echo '<p><label>' . esc_html__('每人限次', 'aksrt') . '<br><input type="number" name="per_user_limit" value="1" /></label></p>';
$this->render_scope_fields('', '');
echo '<p><label>' . esc_html__('过期时间', 'aksrt') . '<br><input type="datetime-local" name="expires_at" /></label></p>';
submit_button(__('批量生成', 'aksrt'), 'secondary', '', false);
echo '</form>';
}
private function render_scope_fields(string $selected_type, string $ids_text): void {
echo '<p><label>' . esc_html__('适用范围', 'aksrt') . '<br><select name="scope_type">';
foreach ([
'' => __('全部商品', 'aksrt'),
'include' => __('仅指定商品 ID', 'aksrt'),
'exclude' => __('排除商品 ID', 'aksrt'),
'category' => __('指定分类 ID', 'aksrt'),
] as $k => $label) {
printf('<option value="%s"%s>%s</option>', esc_attr($k), selected($selected_type, $k, false), esc_html($label));
}
echo '</select></label></p>';
echo '<p><label>' . esc_html__('范围 ID', 'aksrt') . '<br><input type="text" name="scope_ids" class="regular-text" value="' . esc_attr($ids_text) . '" placeholder="' . esc_attr__('逗号分隔，如 12,34', 'aksrt') . '" /></label></p>';
}
private function render_generated_dump(): void {
if (!empty($_GET['aksrt_coupon_generated'])) {
$generated = (int) $_GET['aksrt_coupon_generated'];
echo '<div class="notice notice-success"><p>' . esc_html(sprintf(
/* translators: %d count */
__('成功生成 %d 个优惠码。', 'aksrt'),
$generated
)) . '</p></div>';
}
$generated_codes = get_transient('aksrt_pay_coupon_codes_' . get_current_user_id());
if (is_array($generated_codes) && $generated_codes) {
delete_transient('aksrt_pay_coupon_codes_' . get_current_user_id());
echo '<div class="notice notice-info"><p><strong>' . esc_html__('本次生成优惠码（请及时复制保存）：', 'aksrt') . '</strong></p>';
echo '<textarea class="large-text code" rows="' . esc_attr((string) min(12, max(3, count($generated_codes)))) . '" readonly onclick="this.select();">' . esc_textarea(implode("\n", $generated_codes)) . '</textarea>';
echo '</div>';
}
}
private function render_list(AKSRT_Coupon $svc): void {
$status = isset($_GET['status']) ? sanitize_key((string) wp_unslash($_GET['status'])) : '';
$search = isset($_GET['s']) ? sanitize_text_field((string) wp_unslash($_GET['s'])) : '';
$page_num = max(1, (int) ($_GET['paged'] ?? 1));
$per_page = 20;
$type_labels = [
'fixed' => __('固定金额', 'aksrt'),
'percent' => __('折扣百分比', 'aksrt'),
];
$status_labels = [
'active' => __('可用', 'aksrt'),
'disabled' => __('已禁用', 'aksrt'),
];
echo '<form method="get" style="margin:12px 0;">';
echo '<input type="hidden" name="page" value="' . esc_attr(self::PAGE_SLUG) . '" />';
echo '<select name="status">';
foreach (['' => __('全部状态', 'aksrt'), 'active' => __('可用', 'aksrt'), 'disabled' => __('已禁用', 'aksrt')] 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($search) . '" placeholder="' . esc_attr__('搜索代码', 'aksrt') . '" /> ';
submit_button(__('筛选', 'aksrt'), 'secondary', '', false);
echo '</form>';
$result = $svc->get_list([
'status' => $status,
'search' => $search,
'limit' => $per_page,
'offset' => ($page_num - 1) * $per_page,
]);
$items = $result['items'] ?? [];
$pages = max(1, (int) ($result['total_pages'] ?? 1));
echo '<table class="wp-list-table widefat fixed striped"><thead><tr>';
echo '<th>ID</th><th>' . esc_html__('代码', 'aksrt') . '</th><th>' . esc_html__('类型', 'aksrt') . '</th><th>' . esc_html__('面值', 'aksrt') . '</th><th>' . esc_html__('门槛/封顶', 'aksrt') . '</th><th>' . esc_html__('范围', 'aksrt') . '</th><th>' . esc_html__('已用/上限/每人', 'aksrt') . '</th><th>' . esc_html__('状态', 'aksrt') . '</th><th>' . esc_html__('过期', 'aksrt') . '</th><th>' . esc_html__('操作', 'aksrt') . '</th>';
echo '</tr></thead><tbody>';
if (!$items) {
echo '<tr><td colspan="10">' . esc_html__('暂无优惠码', 'aksrt') . '</td></tr>';
}
foreach ($items as $row) {
$id = (int) ($row['id'] ?? 0);
$st = (string) ($row['status'] ?? '');
$row_type = (string) ($row['type'] ?? '');
echo '<tr>';
echo '<td>' . esc_html((string) $id) . '</td>';
echo '<td><code>' . esc_html((string) ($row['code'] ?? '')) . '</code></td>';
echo '<td>' . esc_html($type_labels[$row_type] ?? $row_type) . '</td>';
echo '<td>' . esc_html((string) ($row['value'] ?? '')) . ($row_type === 'percent' ? '%' : '') . '</td>';
echo '<td>' . esc_html((string) ($row['min_amount'] ?? 0)) . ' / ' . esc_html((string) ($row['max_discount'] ?? 0)) . '</td>';
echo '<td>' . esc_html($this->format_scope_label($row['product_scope'] ?? [])) . '</td>';
echo '<td>' . esc_html((string) ((int) ($row['used_count'] ?? 0)) . '/' . (string) ((int) ($row['usage_limit'] ?? 0)) . '/' . (string) ((int) ($row['per_user_limit'] ?? 0))) . '</td>';
echo '<td>' . esc_html($status_labels[$st] ?? $st) . '</td>';
echo '<td>' . esc_html((string) ($row['expires_at'] ?? '')) . '</td>';
echo '<td style="display:flex;gap:6px;flex-wrap:wrap;align-items:center;">';
echo '<a class="button button-small" href="' . esc_url($this->page_url(['edit_id' => $id])) . '">' . esc_html__('编辑', 'aksrt') . '</a>';
if ($st === 'active') {
echo '<form method="post" action="' . esc_url(admin_url('admin-post.php')) . '" style="display:inline;">';
echo '<input type="hidden" name="action" value="aksrt_pay_disable_coupon" />';
echo '<input type="hidden" name="coupon_id" value="' . esc_attr((string) $id) . '" />';
wp_nonce_field('aksrt_pay_disable_coupon_' . $id);
submit_button(__('禁用', 'aksrt'), 'small', '', false);
echo '</form>';
} elseif ($st === 'disabled') {
echo '<form method="post" action="' . esc_url(admin_url('admin-post.php')) . '" style="display:inline;">';
echo '<input type="hidden" name="action" value="aksrt_pay_enable_coupon" />';
echo '<input type="hidden" name="coupon_id" value="' . esc_attr((string) $id) . '" />';
wp_nonce_field('aksrt_pay_enable_coupon_' . $id);
submit_button(__('启用', 'aksrt'), 'small', '', false);
echo '</form>';
}
echo '</td></tr>';
}
echo '</tbody></table>';
$this->render_pagination($pages, $page_num);
}
public function handle_create_coupon(): void {
if (!current_user_can(self::CAPABILITY)) {
wp_die(esc_html__('权限不足', 'aksrt'));
}
check_admin_referer('aksrt_pay_create_coupon');
$ok = false;
if (class_exists('AKSRT_Coupon')) {
$id = AKSRT_Coupon::get_instance()->create([
'code' => sanitize_text_field((string) wp_unslash($_POST['code'] ?? '')),
'type' => sanitize_key((string) wp_unslash($_POST['type'] ?? 'fixed')),
'value' => (float) ($_POST['value'] ?? 0),
'min_amount' => (float) ($_POST['min_amount'] ?? 0),
'max_discount' => (float) ($_POST['max_discount'] ?? 0),
'usage_limit' => (int) ($_POST['usage_limit'] ?? 0),
'per_user_limit' => (int) ($_POST['per_user_limit'] ?? 0),
'product_scope' => $this->parse_product_scope_from_request(),
'expires_at' => $this->normalize_expires_from_request(),
]);
$ok = $id > 0;
}
wp_safe_redirect($this->page_url(['aksrt_pay_msg' => $ok ? 'coupon_created' : 'coupon_create_failed']));
exit;
}
public function handle_batch_coupons(): void {
if (!current_user_can(self::CAPABILITY)) {
wp_die(esc_html__('权限不足', 'aksrt'));
}
check_admin_referer('aksrt_pay_batch_coupons');
$ok = false;
$created = 0;
$codes = [];
if (class_exists('AKSRT_Coupon')) {
$result = AKSRT_Coupon::get_instance()->batch_create([
'type' => sanitize_key((string) wp_unslash($_POST['type'] ?? 'fixed')),
'value' => (float) ($_POST['value'] ?? 0),
'min_amount' => (float) ($_POST['min_amount'] ?? 0),
'max_discount' => (float) ($_POST['max_discount'] ?? 0),
'usage_limit' => (int) ($_POST['usage_limit'] ?? 0),
'per_user_limit' => (int) ($_POST['per_user_limit'] ?? 0),
'product_scope' => $this->parse_product_scope_from_request(),
'expires_at' => $this->normalize_expires_from_request(),
], (int) ($_POST['count'] ?? 10), (int) ($_POST['length'] ?? 10), sanitize_text_field((string) wp_unslash($_POST['prefix'] ?? '')));
$created = (int) ($result['created'] ?? 0);
$codes = is_array($result['codes'] ?? null) ? $result['codes'] : [];
$ok = $created > 0;
if ($ok) {
set_transient('aksrt_pay_coupon_codes_' . get_current_user_id(), $codes, 10 * MINUTE_IN_SECONDS);
}
}
wp_safe_redirect($this->page_url([
'aksrt_pay_msg' => $ok ? 'coupon_batch_ok' : 'coupon_batch_failed',
'aksrt_coupon_generated' => $created,
]));
exit;
}
public function handle_update_coupon(): void {
if (!current_user_can(self::CAPABILITY)) {
wp_die(esc_html__('权限不足', 'aksrt'));
}
$id = isset($_POST['coupon_id']) ? (int) $_POST['coupon_id'] : 0;
check_admin_referer('aksrt_pay_update_coupon_' . $id);
$ok = false;
if ($id > 0 && class_exists('AKSRT_Coupon')) {
$ok = AKSRT_Coupon::get_instance()->update($id, [
'type' => sanitize_key((string) wp_unslash($_POST['type'] ?? 'fixed')),
'value' => (float) ($_POST['value'] ?? 0),
'min_amount' => (float) ($_POST['min_amount'] ?? 0),
'max_discount' => (float) ($_POST['max_discount'] ?? 0),
'usage_limit' => (int) ($_POST['usage_limit'] ?? 0),
'per_user_limit' => (int) ($_POST['per_user_limit'] ?? 0),
'product_scope' => $this->parse_product_scope_from_request(),
'expires_at' => $this->normalize_expires_from_request(),
]);
}
wp_safe_redirect($this->page_url([
'aksrt_pay_msg' => $ok ? 'coupon_updated' : 'coupon_update_failed',
'edit_id' => $id,
]));
exit;
}
public function handle_disable_coupon(): void {
if (!current_user_can(self::CAPABILITY)) {
wp_die(esc_html__('权限不足', 'aksrt'));
}
$id = isset($_POST['coupon_id']) ? (int) $_POST['coupon_id'] : 0;
check_admin_referer('aksrt_pay_disable_coupon_' . $id);
$ok = $id > 0 && class_exists('AKSRT_Coupon') && AKSRT_Coupon::get_instance()->disable($id);
wp_safe_redirect($this->page_url(['aksrt_pay_msg' => $ok ? 'coupon_disabled' : 'coupon_failed']));
exit;
}
public function handle_enable_coupon(): void {
if (!current_user_can(self::CAPABILITY)) {
wp_die(esc_html__('权限不足', 'aksrt'));
}
$id = isset($_POST['coupon_id']) ? (int) $_POST['coupon_id'] : 0;
check_admin_referer('aksrt_pay_enable_coupon_' . $id);
$ok = $id > 0 && class_exists('AKSRT_Coupon') && AKSRT_Coupon::get_instance()->enable($id);
wp_safe_redirect($this->page_url(['aksrt_pay_msg' => $ok ? 'coupon_enabled' : 'coupon_failed']));
exit;
}
/**
* @return array<string,mixed>
*/
private function parse_product_scope_from_request(): array {
$type = isset($_POST['scope_type']) ? sanitize_key((string) wp_unslash($_POST['scope_type'])) : '';
if ($type === '' || !in_array($type, ['include', 'exclude', 'category'], true)) {
return [];
}
$raw = isset($_POST['scope_ids']) ? (string) wp_unslash($_POST['scope_ids']) : '';
$parts = preg_split('/[\s,;]+/', $raw) ?: [];
$ids = array_values(array_unique(array_filter(array_map('intval', $parts))));
if (!$ids) {
return [];
}
$scope = [
'type' => $type,
'ids' => $ids,
];
if ($type === 'category') {
$scope['taxonomies'] = ['aksrt_product_cat', 'category'];
}
return $scope;
}
private function normalize_expires_from_request(): string {
$expires = isset($_POST['expires_at']) ? sanitize_text_field((string) wp_unslash($_POST['expires_at'])) : '';
if ($expires === '') {
return '';
}
$expires = str_replace('T', ' ', $expires);
if (strlen($expires) === 16) {
$expires .= ':00';
}
return $expires;
}
/**
* @param mixed $scope
*/
private function format_scope_label($scope): string {
if (is_string($scope) && $scope !== '') {
$decoded = json_decode($scope, true);
$scope = is_array($decoded) ? $decoded : [];
}
if (!is_array($scope) || empty($scope)) {
return __('全部', 'aksrt');
}
$type = sanitize_key((string) ($scope['type'] ?? ''));
$ids = array_map('intval', (array) ($scope['ids'] ?? []));
$id_text = $ids ? implode(',', $ids) : '—';
$map = [
'include' => __('含商品', 'aksrt'),
'exclude' => __('排除商品', 'aksrt'),
'category' => __('分类', 'aksrt'),
];
$label = $map[$type] ?? $type;
return $label . ':' . $id_text;
}
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 = [
'coupon_created' => __('优惠码已创建。', 'aksrt'),
'coupon_create_failed' => __('优惠码创建失败（可能重复）。', 'aksrt'),
'coupon_batch_ok' => __('优惠码批量生成完成。', 'aksrt'),
'coupon_batch_failed' => __('优惠码批量生成失败。', 'aksrt'),
'coupon_updated' => __('优惠码已更新。', 'aksrt'),
'coupon_update_failed' => __('优惠码更新失败。', 'aksrt'),
'coupon_disabled' => __('优惠码已禁用。', 'aksrt'),
'coupon_enabled' => __('优惠码已启用。', 'aksrt'),
'coupon_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>';
}
/**
* @param array<string,mixed> $args
*/
private function page_url(array $args = []): string {
return add_query_arg(array_merge(['page' => self::PAGE_SLUG], $args), admin_url('admin.php'));
}
private function render_pagination(int $pages, int $page_num): void {
if ($pages <= 1) {
return;
}
echo '<div class="tablenav"><div class="tablenav-pages">';
echo paginate_links([
'base' => add_query_arg('paged', '%#%'),
'format' => '',
'prev_text' => '&laquo;',
'next_text' => '&raquo;',
'total' => $pages,
'current' => $page_num,
]);
echo '</div></div>';
}
}
inc/classes/admin/native/class-aksrt-admin-pay-menus.php
+8 -299
View File
@@ -41,10 +41,7 @@ class AKSRT_Admin_Pay_Menus {
add_action('admin_post_aksrt_pay_update_after_sale', [$this, 'handle_update_after_sale']);
add_action('admin_post_aksrt_pay_create_after_sale', [$this, 'handle_create_after_sale']);
add_action('admin_post_aksrt_pay_after_sale_action', [$this, 'handle_after_sale_action']);
add_action('admin_post_aksrt_pay_create_coupon', [$this, 'handle_create_coupon']);
add_action('admin_post_aksrt_pay_batch_coupons', [$this, 'handle_batch_coupons']);
add_action('admin_post_aksrt_pay_disable_coupon', [$this, 'handle_disable_coupon']);
add_action('admin_post_aksrt_pay_enable_coupon', [$this, 'handle_enable_coupon']);
// Coupon admin_post handlers live in AKSRT_Admin_Pay_Coupons.
add_action('admin_post_aksrt_pay_settle_income', [$this, 'handle_settle_income']);
add_action('admin_post_aksrt_pay_settle_rebate', [$this, 'handle_settle_rebate']);
add_action('admin_post_aksrt_pay_cancel_rebate', [$this, 'handle_cancel_rebate']);
@@ -78,7 +75,13 @@ class AKSRT_Admin_Pay_Menus {
'coupons' => [
'slug' => 'aksrt_coupons',
'title' => __('优惠码', 'aksrt'),
'callback' => [$this, 'render_coupons_page'],
'callback' => static function (): void {
if (class_exists('AKSRT_Admin_Pay_Coupons')) {
AKSRT_Admin_Pay_Coupons::get_instance()->render_page();
return;
}
wp_die(esc_html__('优惠码模块未初始化。', 'aksrt'));
},
],
'charge_cards' => [
'slug' => 'aksrt_charge_cards',
@@ -221,13 +224,6 @@ class AKSRT_Admin_Pay_Menus {
'after_sale_failed' => __('售后状态更新失败。', 'aksrt'),
'after_sale_created' => __('售后工单已创建。', 'aksrt'),
'after_sale_create_failed' => __('售后工单创建失败。', 'aksrt'),
'coupon_created' => __('优惠码已创建。', 'aksrt'),
'coupon_create_failed'=> __('优惠码创建失败（可能重复）。', 'aksrt'),
'coupon_batch_ok' => __('优惠码批量生成完成。', 'aksrt'),
'coupon_batch_failed' => __('优惠码批量生成失败。', 'aksrt'),
'coupon_disabled' => __('优惠码已禁用。', 'aksrt'),
'coupon_enabled' => __('优惠码已启用。', 'aksrt'),
'coupon_failed' => __('优惠码操作失败。', 'aksrt'),
'income_settled' => __('分成已结算。', 'aksrt'),
'income_failed' => __('分成结算失败。', 'aksrt'),
'rebate_settled' => __('返佣已结算。', 'aksrt'),
@@ -1608,246 +1604,6 @@ class AKSRT_Admin_Pay_Menus {
exit;
}
public function render_coupons_page(): void {
$this->ensure_cap();
$this->render_header(__('优惠码', 'aksrt'));
if (!class_exists('AKSRT_Coupon')) {
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'])) : '';
$search = isset($_GET['s']) ? sanitize_text_field((string) wp_unslash($_GET['s'])) : '';
$page_num = max(1, (int) ($_GET['paged'] ?? 1));
$per_page = 20;
$svc = AKSRT_Coupon::get_instance();
$type_labels = [
'fixed' => __('固定金额', 'aksrt'),
'percent' => __('折扣百分比', 'aksrt'),
];
$status_labels = [
'active' => __('可用', 'aksrt'),
'disabled' => __('已禁用', 'aksrt'),
];
echo '<h2>' . esc_html__('新建优惠码', 'aksrt') . '</h2>';
echo '<form method="post" action="' . esc_url(admin_url('admin-post.php')) . '" style="margin-bottom:20px;display:flex;gap:8px;flex-wrap:wrap;align-items:end;">';
echo '<input type="hidden" name="action" value="aksrt_pay_create_coupon" />';
wp_nonce_field('aksrt_pay_create_coupon');
echo '<p><label>' . esc_html__('代码', 'aksrt') . '<br><input type="text" name="code" required /></label></p>';
echo '<p><label>' . esc_html__('类型', 'aksrt') . '<br><select name="type"><option value="fixed">' . esc_html__('固定金额', 'aksrt') . '</option><option value="percent">' . esc_html__('折扣百分比', 'aksrt') . '</option></select></label></p>';
echo '<p><label>' . esc_html__('面值', 'aksrt') . '<br><input type="number" step="0.01" name="value" value="0" /></label></p>';
echo '<p><label>' . esc_html__('最低消费', 'aksrt') . '<br><input type="number" step="0.01" name="min_amount" value="0" /></label></p>';
echo '<p><label>' . esc_html__('最高优惠(百分比用)', 'aksrt') . '<br><input type="number" step="0.01" name="max_discount" value="0" /></label></p>';
echo '<p><label>' . esc_html__('总次数(0=不限)', 'aksrt') . '<br><input type="number" name="usage_limit" value="0" /></label></p>';
echo '<p><label>' . esc_html__('每人限次(0=不限)', 'aksrt') . '<br><input type="number" name="per_user_limit" value="0" /></label></p>';
echo '<p><label>' . esc_html__('适用范围', 'aksrt') . '<br><select name="scope_type">';
echo '<option value="">' . esc_html__('全部商品', 'aksrt') . '</option>';
echo '<option value="include">' . esc_html__('仅指定商品 ID', 'aksrt') . '</option>';
echo '<option value="exclude">' . esc_html__('排除商品 ID', 'aksrt') . '</option>';
echo '<option value="category">' . esc_html__('指定分类 ID', 'aksrt') . '</option>';
echo '</select></label></p>';
echo '<p><label>' . esc_html__('范围 ID', 'aksrt') . '<br><input type="text" name="scope_ids" class="regular-text" placeholder="' . esc_attr__('逗号分隔，如 12,34', 'aksrt') . '" /></label></p>';
echo '<p><label>' . esc_html__('过期时间', 'aksrt') . '<br><input type="datetime-local" name="expires_at" /></label></p>';
submit_button(__('创建', 'aksrt'), 'primary', '', false);
echo '</form>';
echo '<h2>' . esc_html__('批量生成优惠码', 'aksrt') . '</h2>';
echo '<form method="post" action="' . esc_url(admin_url('admin-post.php')) . '" style="margin-bottom:20px;display:flex;gap:8px;flex-wrap:wrap;align-items:end;">';
echo '<input type="hidden" name="action" value="aksrt_pay_batch_coupons" />';
wp_nonce_field('aksrt_pay_batch_coupons');
echo '<p><label>' . esc_html__('数量', 'aksrt') . '<br><input type="number" name="count" min="1" max="100" value="10" /></label></p>';
echo '<p><label>' . esc_html__('长度', 'aksrt') . '<br><input type="number" name="length" min="6" max="24" value="10" /></label></p>';
echo '<p><label>' . esc_html__('前缀', 'aksrt') . '<br><input type="text" name="prefix" value="" /></label></p>';
echo '<p><label>' . esc_html__('类型', 'aksrt') . '<br><select name="type"><option value="fixed">' . esc_html__('固定金额', 'aksrt') . '</option><option value="percent">' . esc_html__('折扣百分比', 'aksrt') . '</option></select></label></p>';
echo '<p><label>' . esc_html__('面值', 'aksrt') . '<br><input type="number" step="0.01" name="value" value="10" /></label></p>';
echo '<p><label>' . esc_html__('最低消费', 'aksrt') . '<br><input type="number" step="0.01" name="min_amount" value="0" /></label></p>';
echo '<p><label>' . esc_html__('最高优惠', 'aksrt') . '<br><input type="number" step="0.01" name="max_discount" value="0" /></label></p>';
echo '<p><label>' . esc_html__('总次数(0=不限)', 'aksrt') . '<br><input type="number" name="usage_limit" value="1" /></label></p>';
echo '<p><label>' . esc_html__('每人限次', 'aksrt') . '<br><input type="number" name="per_user_limit" value="1" /></label></p>';
echo '<p><label>' . esc_html__('过期时间', 'aksrt') . '<br><input type="datetime-local" name="expires_at" /></label></p>';
submit_button(__('批量生成', 'aksrt'), 'secondary', '', false);
echo '</form>';
if (!empty($_GET['aksrt_coupon_generated'])) {
$generated = (int) $_GET['aksrt_coupon_generated'];
echo '<div class="notice notice-success"><p>' . esc_html(sprintf(
/* translators: %d count */
__('成功生成 %d 个优惠码。', 'aksrt'),
$generated
)) . '</p></div>';
}
$generated_codes = get_transient('aksrt_pay_coupon_codes_' . get_current_user_id());
if (is_array($generated_codes) && $generated_codes) {
delete_transient('aksrt_pay_coupon_codes_' . get_current_user_id());
echo '<div class="notice notice-info"><p><strong>' . esc_html__('本次生成优惠码（请及时复制保存）：', 'aksrt') . '</strong></p>';
echo '<textarea class="large-text code" rows="' . esc_attr((string) min(12, max(3, count($generated_codes)))) . '" readonly onclick="this.select();">' . esc_textarea(implode("\n", $generated_codes)) . '</textarea>';
echo '</div>';
}
echo '<form method="get" style="margin:12px 0;">';
echo '<input type="hidden" name="page" value="aksrt_coupons" />';
echo '<select name="status">';
foreach (['' => __('全部状态', 'aksrt'), 'active' => __('可用', 'aksrt'), 'disabled' => __('已禁用', 'aksrt')] 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($search) . '" placeholder="' . esc_attr__('搜索代码', 'aksrt') . '" /> ';
submit_button(__('筛选', 'aksrt'), 'secondary', '', false);
echo '</form>';
$result = $svc->get_list([
'status' => $status,
'search' => $search,
'limit' => $per_page,
'offset' => ($page_num - 1) * $per_page,
]);
$items = $result['items'] ?? [];
$total = (int) ($result['total'] ?? 0);
$pages = max(1, (int) ($result['total_pages'] ?? 1));
echo '<table class="wp-list-table widefat fixed striped"><thead><tr>';
echo '<th>ID</th><th>' . esc_html__('代码', 'aksrt') . '</th><th>' . esc_html__('类型', 'aksrt') . '</th><th>' . esc_html__('面值', 'aksrt') . '</th><th>' . esc_html__('门槛/封顶', 'aksrt') . '</th><th>' . esc_html__('范围', 'aksrt') . '</th><th>' . esc_html__('已用/上限/每人', 'aksrt') . '</th><th>' . esc_html__('状态', 'aksrt') . '</th><th>' . esc_html__('过期', 'aksrt') . '</th><th>' . esc_html__('操作', 'aksrt') . '</th>';
echo '</tr></thead><tbody>';
if (!$items) {
echo '<tr><td colspan="10">' . esc_html__('暂无优惠码', 'aksrt') . '</td></tr>';
}
foreach ($items as $row) {
$id = (int) ($row['id'] ?? 0);
$st = (string) ($row['status'] ?? '');
$row_type = (string) ($row['type'] ?? '');
echo '<tr>';
echo '<td>' . esc_html((string) $id) . '</td>';
echo '<td><code>' . esc_html((string) ($row['code'] ?? '')) . '</code></td>';
echo '<td>' . esc_html($type_labels[$row_type] ?? $row_type) . '</td>';
echo '<td>' . esc_html((string) ($row['value'] ?? '')) . ($row_type === 'percent' ? '%' : '') . '</td>';
echo '<td>' . esc_html((string) ($row['min_amount'] ?? 0)) . ' / ' . esc_html((string) ($row['max_discount'] ?? 0)) . '</td>';
echo '<td>' . esc_html($this->format_coupon_scope_label($row['product_scope'] ?? [])) . '</td>';
echo '<td>' . esc_html((string) ((int) ($row['used_count'] ?? 0)) . '/' . (string) ((int) ($row['usage_limit'] ?? 0)) . '/' . (string) ((int) ($row['per_user_limit'] ?? 0))) . '</td>';
echo '<td>' . esc_html($status_labels[$st] ?? $st) . '</td>';
echo '<td>' . esc_html((string) ($row['expires_at'] ?? '')) . '</td>';
echo '<td>';
if ($st === 'active') {
echo '<form method="post" action="' . esc_url(admin_url('admin-post.php')) . '">';
echo '<input type="hidden" name="action" value="aksrt_pay_disable_coupon" />';
echo '<input type="hidden" name="coupon_id" value="' . esc_attr((string) $id) . '" />';
wp_nonce_field('aksrt_pay_disable_coupon_' . $id);
submit_button(__('禁用', 'aksrt'), 'small', '', false);
echo '</form>';
} elseif ($st === 'disabled') {
echo '<form method="post" action="' . esc_url(admin_url('admin-post.php')) . '">';
echo '<input type="hidden" name="action" value="aksrt_pay_enable_coupon" />';
echo '<input type="hidden" name="coupon_id" value="' . esc_attr((string) $id) . '" />';
wp_nonce_field('aksrt_pay_enable_coupon_' . $id);
submit_button(__('启用', 'aksrt'), 'small', '', false);
echo '</form>';
} else {
echo '—';
}
echo '</td></tr>';
}
echo '</tbody></table>';
$this->render_pagination($pages, $page_num);
$this->render_footer();
}
public function handle_create_coupon(): void {
if (!current_user_can(self::CAPABILITY)) {
wp_die(esc_html__('权限不足', 'aksrt'));
}
check_admin_referer('aksrt_pay_create_coupon');
$ok = false;
if (class_exists('AKSRT_Coupon')) {
$expires = isset($_POST['expires_at']) ? sanitize_text_field((string) wp_unslash($_POST['expires_at'])) : '';
if ($expires !== '') {
$expires = str_replace('T', ' ', $expires);
if (strlen($expires) === 16) {
$expires .= ':00';
}
}
$id = AKSRT_Coupon::get_instance()->create([
'code' => sanitize_text_field((string) wp_unslash($_POST['code'] ?? '')),
'type' => sanitize_key((string) wp_unslash($_POST['type'] ?? 'fixed')),
'value' => (float) ($_POST['value'] ?? 0),
'min_amount' => (float) ($_POST['min_amount'] ?? 0),
'max_discount' => (float) ($_POST['max_discount'] ?? 0),
'usage_limit' => (int) ($_POST['usage_limit'] ?? 0),
'per_user_limit' => (int) ($_POST['per_user_limit'] ?? 0),
'product_scope' => $this->parse_coupon_product_scope_from_request(),
'expires_at' => $expires,
]);
$ok = $id > 0;
}
wp_safe_redirect($this->page_url('aksrt_coupons', ['aksrt_pay_msg' => $ok ? 'coupon_created' : 'coupon_create_failed']));
exit;
}
public function handle_batch_coupons(): void {
if (!current_user_can(self::CAPABILITY)) {
wp_die(esc_html__('权限不足', 'aksrt'));
}
check_admin_referer('aksrt_pay_batch_coupons');
$ok = false;
$created = 0;
$codes = [];
if (class_exists('AKSRT_Coupon')) {
$expires = isset($_POST['expires_at']) ? sanitize_text_field((string) wp_unslash($_POST['expires_at'])) : '';
if ($expires !== '') {
$expires = str_replace('T', ' ', $expires);
if (strlen($expires) === 16) {
$expires .= ':00';
}
}
$result = AKSRT_Coupon::get_instance()->batch_create([
'type' => sanitize_key((string) wp_unslash($_POST['type'] ?? 'fixed')),
'value' => (float) ($_POST['value'] ?? 0),
'min_amount' => (float) ($_POST['min_amount'] ?? 0),
'max_discount' => (float) ($_POST['max_discount'] ?? 0),
'usage_limit' => (int) ($_POST['usage_limit'] ?? 0),
'per_user_limit' => (int) ($_POST['per_user_limit'] ?? 0),
'expires_at' => $expires,
], (int) ($_POST['count'] ?? 10), (int) ($_POST['length'] ?? 10), sanitize_text_field((string) wp_unslash($_POST['prefix'] ?? '')));
$created = (int) ($result['created'] ?? 0);
$codes = is_array($result['codes'] ?? null) ? $result['codes'] : [];
$ok = $created > 0;
if ($ok) {
set_transient('aksrt_pay_coupon_codes_' . get_current_user_id(), $codes, 10 * MINUTE_IN_SECONDS);
}
}
wp_safe_redirect($this->page_url('aksrt_coupons', [
'aksrt_pay_msg' => $ok ? 'coupon_batch_ok' : 'coupon_batch_failed',
'aksrt_coupon_generated' => $created,
]));
exit;
}
public function handle_disable_coupon(): void {
if (!current_user_can(self::CAPABILITY)) {
wp_die(esc_html__('权限不足', 'aksrt'));
}
$id = isset($_POST['coupon_id']) ? (int) $_POST['coupon_id'] : 0;
check_admin_referer('aksrt_pay_disable_coupon_' . $id);
$ok = $id > 0 && class_exists('AKSRT_Coupon') && AKSRT_Coupon::get_instance()->disable($id);
wp_safe_redirect($this->page_url('aksrt_coupons', ['aksrt_pay_msg' => $ok ? 'coupon_disabled' : 'coupon_failed']));
exit;
}
public function handle_enable_coupon(): void {
if (!current_user_can(self::CAPABILITY)) {
wp_die(esc_html__('权限不足', 'aksrt'));
}
$id = isset($_POST['coupon_id']) ? (int) $_POST['coupon_id'] : 0;
check_admin_referer('aksrt_pay_enable_coupon_' . $id);
$ok = $id > 0 && class_exists('AKSRT_Coupon') && AKSRT_Coupon::get_instance()->enable($id);
wp_safe_redirect($this->page_url('aksrt_coupons', ['aksrt_pay_msg' => $ok ? 'coupon_enabled' : 'coupon_failed']));
exit;
}
/* ------------------------------------------------------------------
* Income / rebate
* ----------------------------------------------------------------*/
@@ -2215,53 +1971,6 @@ class AKSRT_Admin_Pay_Menus {
echo '</ol></div>';
}
/**
* @return array<string,mixed>
*/
private function parse_coupon_product_scope_from_request(): array {
$type = isset($_POST['scope_type']) ? sanitize_key((string) wp_unslash($_POST['scope_type'])) : '';
if ($type === '' || !in_array($type, ['include', 'exclude', 'category'], true)) {
return [];
}
$raw = isset($_POST['scope_ids']) ? (string) wp_unslash($_POST['scope_ids']) : '';
$parts = preg_split('/[\s,;]+/', $raw) ?: [];
$ids = array_values(array_unique(array_filter(array_map('intval', $parts))));
if (!$ids) {
return [];
}
$scope = [
'type' => $type,
'ids' => $ids,
];
if ($type === 'category') {
$scope['taxonomies'] = ['aksrt_product_cat', 'category'];
}
return $scope;
}
/**
* @param mixed $scope
*/
private function format_coupon_scope_label($scope): string {
if (is_string($scope) && $scope !== '') {
$decoded = json_decode($scope, true);
$scope = is_array($decoded) ? $decoded : [];
}
if (!is_array($scope) || empty($scope)) {
return __('全部', 'aksrt');
}
$type = sanitize_key((string) ($scope['type'] ?? ''));
$ids = array_map('intval', (array) ($scope['ids'] ?? []));
$id_text = $ids ? implode(',', $ids) : '—';
$map = [
'include' => __('含商品', 'aksrt'),
'exclude' => __('排除商品', 'aksrt'),
'category' => __('分类', 'aksrt'),
];
$label = $map[$type] ?? $type;
return $label . ':' . $id_text;
}
private function render_pagination(int $pages, int $page_num): void {
if ($pages <= 1) {
return;
inc/classes/class-aksrt-coupon.php
+82
View File
@@ -250,6 +250,88 @@ class AKSRT_Coupon {
return $wpdb->update($this->table(), ['status' => 'active'], ['id' => $id], ['%s'], ['%d']) !== false;
}
/**
* Get one coupon by id.
*/
public function get(int $id): ?array {
global $wpdb;
if ($id <= 0) {
return null;
}
$row = $wpdb->get_row($wpdb->prepare(
"SELECT * FROM {$this->table()} WHERE id = %d",
$id
), ARRAY_A);
if (!$row) {
return null;
}
return $this->normalize_row($row);
}
/**
* Update mutable coupon fields (not code / used_count / created_at).
*/
public function update(int $id, array $data): bool {
global $wpdb;
if ($id <= 0 || !$this->get($id)) {
return false;
}
$fields = [];
$format = [];
if (array_key_exists('type', $data)) {
$type = sanitize_key((string) $data['type']);
if (!in_array($type, [self::TYPE_PERCENT, self::TYPE_FIXED], true)) {
$type = self::TYPE_FIXED;
}
$fields['type'] = $type;
$format[] = '%s';
}
if (array_key_exists('value', $data)) {
$fields['value'] = (float) $data['value'];
$format[] = '%f';
}
if (array_key_exists('min_amount', $data)) {
$fields['min_amount'] = (float) $data['min_amount'];
$format[] = '%f';
}
if (array_key_exists('max_discount', $data)) {
$fields['max_discount'] = (float) $data['max_discount'];
$format[] = '%f';
}
if (array_key_exists('usage_limit', $data)) {
$fields['usage_limit'] = (int) $data['usage_limit'];
$format[] = '%d';
}
if (array_key_exists('per_user_limit', $data)) {
$fields['per_user_limit'] = (int) $data['per_user_limit'];
$format[] = '%d';
}
if (array_key_exists('expires_at', $data)) {
$fields['expires_at'] = sanitize_text_field((string) $data['expires_at']);
$format[] = '%s';
}
if (array_key_exists('product_scope', $data)) {
$scope = is_array($data['product_scope']) ? $data['product_scope'] : [];
$fields['product_scope'] = wp_json_encode($scope, JSON_UNESCAPED_UNICODE);
$format[] = '%s';
}
if (array_key_exists('status', $data)) {
$status = sanitize_key((string) $data['status']);
if (in_array($status, ['active', 'disabled'], true)) {
$fields['status'] = $status;
$format[] = '%s';
}
}
if (!$fields) {
return false;
}
return $wpdb->update($this->table(), $fields, ['id' => $id], $format, ['%d']) !== false;
}
/**
* Batch-create coupons with auto-generated codes.
*
inc/classes/forum/board-service-traits/trait-aksrt-forum-board-service-part-2.php
+8 -2
View File
@@ -252,10 +252,15 @@ trait AKSRT_Forum_Board_Service_Part_2 {
}
$add_limit = (string) (get_post_meta($plate_id, '_aksrt_add_limit', true) ?: 'all');
if ($add_limit === 'all') {
if ($add_limit === 'all' || $add_limit === 'login') {
return true;
}
// Moderators already returned true above.
if ($add_limit === 'moderator') {
return false;
}
$user = get_userdata($user_id);
if (!$user) {
return false;
@@ -269,7 +274,8 @@ trait AKSRT_Forum_Board_Service_Part_2 {
return !empty(array_intersect($user->roles, $allowed_roles));
}
return true;
// Unknown contract → deny (no legacy fallthrough).
return false;
}
/**
inc/classes/forum/class-aksrt-plate-meta-box.php
+267 -35
View File
@@ -1,6 +1,6 @@
<?php
/**
* Native meta box for aksrt_forum_plate moderators & applications.
* Native meta box for aksrt_forum_plate moderators, roles & access limits.
*
* @package AKSRT
*/
@@ -11,6 +11,19 @@ class AKSRT_Plate_Meta_Box {
private static $instance = null;
/** @var array<string,string> */
private const ASSIGNABLE_ROLES = [
'super_moderator' => '超级版主',
'moderator' => '版主',
'junior_moderator' => '初级版主',
];
/** @var list<string> */
private const ALLOW_VIEW = ['public', 'login', 'follow', 'role'];
/** @var list<string> */
private const ADD_LIMIT = ['all', 'login', 'moderator', 'role'];
public static function get_instance(): self {
if (null === self::$instance) {
self::$instance = new self();
@@ -29,7 +42,7 @@ class AKSRT_Plate_Meta_Box {
public function register_meta_box(): void {
add_meta_box(
'aksrt_plate_moderators',
__('版主与申请', 'aksrt'),
__('版主与权限', 'aksrt'),
[$this, 'render'],
'aksrt_forum_plate',
'side',
@@ -40,41 +53,75 @@ class AKSRT_Plate_Meta_Box {
public function render(WP_Post $post): void {
wp_nonce_field('aksrt_plate_meta_save', 'aksrt_plate_meta_nonce');
$plate_id = (int) $post->ID;
$author_id = (int) $post->post_author;
$moderator_ids = [];
$roles_map = [];
$applications = [];
if (class_exists('AKSRT_Forum')) {
$forum = AKSRT_Forum::get_instance();
$moderator_ids = $forum->get_plate_moderators((int) $post->ID);
$applications = $forum->get_plate_moderator_applications((int) $post->ID);
$moderator_ids = $forum->get_plate_moderators($plate_id);
$roles_map = $forum->get_moderator_roles($plate_id);
$applications = $forum->get_plate_moderator_applications($plate_id);
} else {
$raw = get_post_meta($post->ID, '_aksrt_moderators', true);
$raw = get_post_meta($plate_id, '_aksrt_moderators', true);
$moderator_ids = is_array($raw) ? array_map('intval', $raw) : [];
$applications = get_post_meta($post->ID, '_aksrt_moderator_applications', true);
$roles_raw = get_post_meta($plate_id, '_aksrt_moderator_roles', true);
$roles_map = is_array($roles_raw) ? $roles_raw : [];
$applications = get_post_meta($plate_id, '_aksrt_moderator_applications', true);
$applications = is_array($applications) ? $applications : [];
}
$allow_view = (string) (get_post_meta($post->ID, '_aksrt_allow_view', true) ?: 'public');
$add_limit = (string) (get_post_meta($post->ID, '_aksrt_add_limit', true) ?: 'all');
$moderator_labels = [];
foreach ($moderator_ids as $uid) {
$user = get_userdata((int) $uid);
$moderator_labels[] = $user
? sprintf('%s (#%d)', $user->user_login, (int) $uid)
: (string) (int) $uid;
$allow_view = (string) (get_post_meta($plate_id, '_aksrt_allow_view', true) ?: 'public');
if (!in_array($allow_view, self::ALLOW_VIEW, true)) {
// Rewrite legacy values (e.g. moderator) on display; save will persist new contract.
$allow_view = 'login';
}
$add_limit = (string) (get_post_meta($plate_id, '_aksrt_add_limit', true) ?: 'all');
if (!in_array($add_limit, self::ADD_LIMIT, true)) {
$add_limit = 'all';
}
$view_roles = get_post_meta($plate_id, '_aksrt_allow_view_roles', true);
$view_roles = is_array($view_roles) ? array_map('sanitize_key', $view_roles) : [];
$add_roles = get_post_meta($plate_id, '_aksrt_add_limit_roles', true);
$add_roles = is_array($add_roles) ? array_map('sanitize_key', $add_roles) : [];
$wp_roles = $this->wp_role_options();
$this->render_access_fields($allow_view, $add_limit, $view_roles, $add_roles, $wp_roles);
$this->render_moderator_fields($moderator_ids, $roles_map, $author_id);
$this->render_applications($applications);
}
/**
* @param list<string> $view_roles
* @param list<string> $add_roles
* @param array<string,string> $wp_roles
*/
private function render_access_fields(string $allow_view, string $add_limit, array $view_roles, array $add_roles, array $wp_roles): void {
?>
<p>
<label for="aksrt_plate_allow_view"><strong><?php esc_html_e('浏览权限', 'aksrt'); ?></strong></label>
<select id="aksrt_plate_allow_view" name="aksrt_plate_allow_view" class="widefat">
<?php foreach ([
'public' => __('公开', 'aksrt'),
'login' => __('登录可见', 'aksrt'),
'moderator' => __('版主可见', 'aksrt'),
'public' => __('公开', 'aksrt'),
'login' => __('登录可见', 'aksrt'),
'follow' => __('关注可见', 'aksrt'),
'role' => __('指定角色', 'aksrt'),
] as $k => $label) : ?>
<option value="<?php echo esc_attr($k); ?>" <?php selected($allow_view, $k); ?>><?php echo esc_html($label); ?></option>
<?php endforeach; ?>
</select>
</p>
<p>
<label for="aksrt_plate_allow_view_roles"><strong><?php esc_html_e('可浏览角色', 'aksrt'); ?></strong></label>
<select id="aksrt_plate_allow_view_roles" name="aksrt_plate_allow_view_roles[]" class="widefat" multiple size="4">
<?php foreach ($wp_roles as $slug => $label) : ?>
<option value="<?php echo esc_attr($slug); ?>" <?php selected(in_array($slug, $view_roles, true)); ?>><?php echo esc_html($label); ?></option>
<?php endforeach; ?>
</select>
<span class="description"><?php esc_html_e('仅「指定角色」时生效。', 'aksrt'); ?></span>
</p>
<p>
<label for="aksrt_plate_add_limit"><strong><?php esc_html_e('发帖权限', 'aksrt'); ?></strong></label>
<select id="aksrt_plate_add_limit" name="aksrt_plate_add_limit" class="widefat">
@@ -82,25 +129,101 @@ class AKSRT_Plate_Meta_Box {
'all' => __('所有人', 'aksrt'),
'login' => __('登录用户', 'aksrt'),
'moderator' => __('仅版主', 'aksrt'),
'role' => __('指定角色', 'aksrt'),
] as $k => $label) : ?>
<option value="<?php echo esc_attr($k); ?>" <?php selected($add_limit, $k); ?>><?php echo esc_html($label); ?></option>
<?php endforeach; ?>
</select>
</p>
<p>
<label for="aksrt_plate_moderators"><strong><?php esc_html_e('版主用户 ID', 'aksrt'); ?></strong></label>
<textarea id="aksrt_plate_moderators" name="aksrt_plate_moderators" rows="3" class="widefat" placeholder="1,2,3"><?php echo esc_textarea(implode(',', array_map('intval', $moderator_ids))); ?></textarea>
<span class="description"><?php esc_html_e('逗号或换行分隔的用户 ID。超级版主为版块作者。', 'aksrt'); ?></span>
<label for="aksrt_plate_add_limit_roles"><strong><?php esc_html_e('可发帖角色', 'aksrt'); ?></strong></label>
<select id="aksrt_plate_add_limit_roles" name="aksrt_plate_add_limit_roles[]" class="widefat" multiple size="4">
<?php foreach ($wp_roles as $slug => $label) : ?>
<option value="<?php echo esc_attr($slug); ?>" <?php selected(in_array($slug, $add_roles, true)); ?>><?php echo esc_html($label); ?></option>
<?php endforeach; ?>
</select>
<span class="description"><?php esc_html_e('仅「指定角色」时生效。', 'aksrt'); ?></span>
</p>
<?php if ($moderator_labels) : ?>
<p class="description"><?php echo esc_html(implode(' · ', $moderator_labels)); ?></p>
<?php endif; ?>
<hr>
<p><strong><?php esc_html_e('版主申请', 'aksrt'); ?></strong></p>
<?php
}
/**
* @param list<int> $moderator_ids
* @param array<int|string,string> $roles_map
*/
private function render_moderator_fields(array $moderator_ids, array $roles_map, int $author_id): void {
if ($author_id > 0) {
$author = get_userdata($author_id);
echo '<p><strong>' . esc_html__('超级版主（版块作者）', 'aksrt') . '</strong><br>';
echo '<code>' . esc_html($author ? $author->user_login . ' (#' . $author_id . ')' : (string) $author_id) . '</code>';
echo '<br><span class="description">' . esc_html__('由版块作者决定，不可在此移除。', 'aksrt') . '</span></p>';
}
echo '<p><strong>' . esc_html__('版主列表', 'aksrt') . '</strong></p>';
$rows = 0;
foreach ($moderator_ids as $uid) {
$uid = (int) $uid;
if ($uid <= 0 || $uid === $author_id) {
continue;
}
$user = get_userdata($uid);
$role = sanitize_key((string) ($roles_map[$uid] ?? 'moderator'));
if (!isset(self::ASSIGNABLE_ROLES[$role])) {
$role = 'moderator';
}
$rows++;
echo '<div style="margin:0 0 10px;padding:8px;border:1px solid #dcdcde;border-radius:4px;">';
echo '<div><code>' . esc_html($user ? $user->user_login . ' (#' . $uid . ')' : (string) $uid) . '</code></div>';
echo '<label style="display:block;margin-top:4px;">' . esc_html__('角色', 'aksrt') . ' ';
echo '<select name="aksrt_plate_mod_role[' . esc_attr((string) $uid) . ']" class="widefat">';
foreach (self::ASSIGNABLE_ROLES as $rk => $rl) {
printf(
'<option value="%s"%s>%s</option>',
esc_attr($rk),
selected($role, $rk, false),
esc_html__($rl, 'aksrt')
);
}
echo '</select></label>';
echo '<label style="display:block;margin-top:4px;"><input type="checkbox" name="aksrt_plate_mod_remove[]" value="' . esc_attr((string) $uid) . '"> ' . esc_html__('移除', 'aksrt') . '</label>';
echo '</div>';
}
if ($rows === 0) {
echo '<p class="description">' . esc_html__('暂无版主。', 'aksrt') . '</p>';
}
echo '<p><strong>' . esc_html__('添加版主', 'aksrt') . '</strong></p>';
echo '<p><label>' . esc_html__('用户 ID', 'aksrt') . '<br>';
echo '<input type="number" min="1" name="aksrt_plate_mod_add_id" class="widefat" value="" placeholder="123"></label></p>';
echo '<p><label>' . esc_html__('角色', 'aksrt') . '<br><select name="aksrt_plate_mod_add_role" class="widefat">';
foreach (self::ASSIGNABLE_ROLES as $rk => $rl) {
printf(
'<option value="%s"%s>%s</option>',
esc_attr($rk),
selected($rk, 'moderator', false),
esc_html__($rl, 'aksrt')
);
}
echo '</select></label></p>';
echo '<p class="description">' . esc_html__('保存后生效。勿将版块作者重复加为版主。', 'aksrt') . '</p>';
echo '<hr>';
}
/**
* @param array<int,array<string,mixed>> $applications
*/
private function render_applications(array $applications): void {
echo '<p><strong>' . esc_html__('版主申请', 'aksrt') . '</strong></p>';
$pending = array_values(array_filter($applications, static function ($app) {
return is_array($app) && (($app['status'] ?? '') === 'pending' || ($app['status'] ?? '') === AKSRT_Forum::APPLICATION_PENDING);
if (!is_array($app)) {
return false;
}
$status = (string) ($app['status'] ?? '');
if ($status === 'pending') {
return true;
}
return class_exists('AKSRT_Forum') && $status === AKSRT_Forum::APPLICATION_PENDING;
}));
if (!$pending) {
echo '<p class="description">' . esc_html__('暂无待处理申请。', 'aksrt') . '</p>';
@@ -109,9 +232,9 @@ class AKSRT_Plate_Meta_Box {
echo '<ul style="margin:0;padding-left:16px;">';
foreach ($pending as $app) {
$uid = (int) ($app['user_id'] ?? 0);
$user = $uid > 0 ? get_userdata($uid) : null;
$aid = (string) ($app['id'] ?? '');
$uid = (int) ($app['user_id'] ?? 0);
$user = $uid > 0 ? get_userdata($uid) : null;
$aid = (string) ($app['id'] ?? '');
$reason = (string) ($app['reason'] ?? '');
echo '<li style="margin-bottom:10px;">';
echo '<div><code>' . esc_html($user ? $user->display_name . ' (#' . $uid . ')' : (string) $uid) . '</code></div>';
@@ -137,23 +260,99 @@ class AKSRT_Plate_Meta_Box {
return;
}
$this->save_access_meta($post_id);
$this->save_moderators($post_id, (int) $post->post_author);
$this->save_applications();
}
private function save_access_meta(int $post_id): void {
$allow_view = isset($_POST['aksrt_plate_allow_view']) ? sanitize_key((string) wp_unslash($_POST['aksrt_plate_allow_view'])) : 'public';
if (!in_array($allow_view, ['public', 'login', 'moderator'], true)) {
if (!in_array($allow_view, self::ALLOW_VIEW, true)) {
$allow_view = 'public';
}
update_post_meta($post_id, '_aksrt_allow_view', $allow_view);
if ($allow_view === 'role') {
$roles = $this->sanitize_role_list($_POST['aksrt_plate_allow_view_roles'] ?? []);
update_post_meta($post_id, '_aksrt_allow_view_roles', $roles);
} else {
delete_post_meta($post_id, '_aksrt_allow_view_roles');
}
$add_limit = isset($_POST['aksrt_plate_add_limit']) ? sanitize_key((string) wp_unslash($_POST['aksrt_plate_add_limit'])) : 'all';
if (!in_array($add_limit, ['all', 'login', 'moderator'], true)) {
if (!in_array($add_limit, self::ADD_LIMIT, true)) {
$add_limit = 'all';
}
update_post_meta($post_id, '_aksrt_add_limit', $add_limit);
$raw = isset($_POST['aksrt_plate_moderators']) ? (string) wp_unslash($_POST['aksrt_plate_moderators']) : '';
$ids = preg_split('/[\s,;]+/', $raw) ?: [];
$ids = array_values(array_unique(array_filter(array_map('intval', $ids))));
update_post_meta($post_id, '_aksrt_moderators', $ids);
if ($add_limit === 'role') {
$roles = $this->sanitize_role_list($_POST['aksrt_plate_add_limit_roles'] ?? []);
update_post_meta($post_id, '_aksrt_add_limit_roles', $roles);
} else {
delete_post_meta($post_id, '_aksrt_add_limit_roles');
}
}
private function save_moderators(int $post_id, int $author_id): void {
$role_posted = isset($_POST['aksrt_plate_mod_role']) && is_array($_POST['aksrt_plate_mod_role'])
? wp_unslash($_POST['aksrt_plate_mod_role'])
: [];
$remove = isset($_POST['aksrt_plate_mod_remove']) && is_array($_POST['aksrt_plate_mod_remove'])
? array_map('intval', wp_unslash($_POST['aksrt_plate_mod_remove']))
: [];
$remove_set = array_fill_keys($remove, true);
$desired = [];
foreach ($role_posted as $uid => $role) {
$uid = (int) $uid;
$role = sanitize_key((string) $role);
if ($uid <= 0 || $uid === $author_id || isset($remove_set[$uid])) {
continue;
}
if (!isset(self::ASSIGNABLE_ROLES[$role])) {
$role = 'moderator';
}
$desired[$uid] = $role;
}
$add_id = isset($_POST['aksrt_plate_mod_add_id']) ? (int) wp_unslash($_POST['aksrt_plate_mod_add_id']) : 0;
$add_role = isset($_POST['aksrt_plate_mod_add_role']) ? sanitize_key((string) wp_unslash($_POST['aksrt_plate_mod_add_role'])) : 'moderator';
if ($add_id > 0 && $add_id !== $author_id) {
if (!isset(self::ASSIGNABLE_ROLES[$add_role])) {
$add_role = 'moderator';
}
$desired[$add_id] = $add_role;
}
if (class_exists('AKSRT_Forum')) {
$forum = AKSRT_Forum::get_instance();
$current = $forum->get_plate_moderators($post_id);
foreach ($current as $uid) {
$uid = (int) $uid;
if ($uid === $author_id) {
continue;
}
if (!isset($desired[$uid])) {
$forum->remove_moderator($uid, $post_id);
}
}
foreach ($desired as $uid => $role) {
if (in_array($uid, $current, true)) {
$forum->set_moderator_role($uid, $post_id, $role);
} else {
$forum->add_moderator($uid, $post_id, $role);
}
}
return;
}
// Fallback without forum service: rewrite meta directly (no legacy keep).
$ids = array_values(array_unique(array_map('intval', array_keys($desired))));
update_post_meta($post_id, '_aksrt_moderators', $ids);
update_post_meta($post_id, '_aksrt_moderator_roles', $desired);
}
private function save_applications(): void {
$actions = isset($_POST['aksrt_plate_app']) && is_array($_POST['aksrt_plate_app'])
? wp_unslash($_POST['aksrt_plate_app'])
: [];
@@ -175,4 +374,37 @@ class AKSRT_Plate_Meta_Box {
}
}
}
/**
* @param mixed $raw
* @return list<string>
*/
private function sanitize_role_list($raw): array {
if (!is_array($raw)) {
return [];
}
$valid = array_keys($this->wp_role_options());
$out = [];
foreach ($raw as $role) {
$role = sanitize_key((string) $role);
if ($role !== '' && in_array($role, $valid, true)) {
$out[] = $role;
}
}
return array_values(array_unique($out));
}
/**
* @return array<string,string>
*/
private function wp_role_options(): array {
$out = [];
if (!function_exists('wp_roles')) {
return $out;
}
foreach (wp_roles()->roles as $slug => $data) {
$out[sanitize_key((string) $slug)] = translate_user_role((string) ($data['name'] ?? $slug));
}
return $out;
}
}