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 committed 2026-07-15 03:30:08 +08:00
1 parent 733a1670ec
commit deee48245f
8 files changed
+849 -338
Download Patch File Download Diff File Expand all files Collapse all files

No files matched your search

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;
}
}