get_display_state($user_id); } if ($state === '') { return $cache[$user_id] = []; } $labels = class_exists('\AKSRT\User\Restriction') ? \AKSRT\User\Restriction::state_labels() : []; $icons = [ 'banned' => 'ban', 'restricted' => 'ban', 'muted' => 'comment-slash', ]; return $cache[$user_id] = [ 'state' => $state, 'label' => (string) ($labels[$state] ?? ''), 'icon' => (string) ($icons[$state] ?? 'ban'), ]; } /** * 目标是否处于封禁/小黑屋状态(举报入口隐藏判定,参考主题 * zib_get_report_link 中 zib_user_is_ban($user_id) 的排除语义; * 禁言为轻量评论域限制,不隐藏举报入口)。 */ function aksrt_is_user_ban_restricted(int $user_id): bool { $state = aksrt_get_user_ban_state($user_id); return in_array((string) ($state['state'] ?? ''), ['banned', 'restricted'], true); } /** * 禁封申诉页 URL(自定义页面模板 templates/pages/page-ban-appeal.php, * 即参考主题 zib_get_ban_info_modal / zib_get_user_ban_info_link 的落地视图)。 * 站点未创建该页面时返回空串,调用方应降级为纯文本徽章。 */ function aksrt_get_ban_appeal_page_url(): string { static $url = null; if (null !== $url) { return $url; } $pages = get_posts([ 'post_type' => 'page', 'post_status' => 'publish', 'posts_per_page' => 1, 'fields' => 'ids', 'no_found_rows' => true, 'meta_query' => [ [ 'key' => '_wp_page_template', 'value' => 'templates/pages/page-ban-appeal.php', ], ], ]); return $url = !empty($pages) ? (string) get_permalink((int) $pages[0]) : ''; } /** * 治理状态提示(用户中心页头,参考主题 user_page_header_desc 钩子 / * zib_get_user_ban_info_link 语义:状态 + 箭头 + 查看入口)。 * * 排版复用 uc-header__meta-item(inline-flex 居中、12px 图标、13px 字号), * 与相邻元信息(用户名 / 邮箱 / 城市)高度与字号完全一致;箭头置于提示内部, * 不使用 badg-sm(0.8em 会破坏与相邻项的字号一致性)。 */ function aksrt_get_user_ban_notice_html(int $user_id): string { $state = aksrt_get_user_ban_state($user_id); if (empty($state['state'])) { return ''; } $tone = 'banned' === $state['state'] ? 'c-red' : 'c-yellow'; $inner = '' . '' . esc_html((string) $state['label']) . '' . ''; $class = 'uc-header__meta-item aksrt-user-ban-notice'; $link = aksrt_get_ban_appeal_page_url(); if ($link === '') { return '' . $inner . ''; } return '' . $inner . ''; } /** * 昵称旁禁封徽章(参考主题 user_name_badge 钩子语义:占据 VIP 图标位, * 头像角标 user_avatar_badge 为可选项,见 aksrt_get_user_ban_avatar_badge)。 */ function aksrt_get_user_ban_name_badge(int $user_id): string { $state = aksrt_get_user_ban_state($user_id); if (empty($state['state'])) { return ''; } $tone = 'banned' === $state['state'] ? 'c-red' : 'c-yellow'; return ''; } /** * 头像禁封角标(参考主题 user_avatar_badge 钩子语义:覆盖 VIP 角标位)。 */ function aksrt_get_user_ban_avatar_badge(int $user_id): string { $state = aksrt_get_user_ban_state($user_id); if (empty($state['state'])) { return ''; } $tone = 'banned' === $state['state'] ? 'is-banned' : 'is-restricted'; return '' . ''; } /** * 受限位置治理提示(评论拒绝态,参考主题 zib_get_user_ban_nocan_info 语义: * 状态徽章 +「暂时无法操作」+ 查看禁封状态入口)。 * * @param string $msg 具体受阻的操作描述,如「发表评论」。 */ function aksrt_get_user_ban_nocan_html(int $user_id, string $msg = ''): string { $state = aksrt_get_user_ban_state($user_id); if (empty($state['state'])) { return ''; } $text = (string) $state['label'] . ($msg !== '' ? ',' . $msg : ''); $tone = 'banned' === $state['state'] ? 'c-red' : 'c-yellow'; $link = aksrt_get_ban_appeal_page_url(); $inner = '' . '' . esc_html($text) . ''; if ($link !== '') { $inner .= ' ' . esc_html__('查看禁封状态', 'aksrt') . ''; } return '

' . $inner . '

'; } /** * 禁封功能开关(后台“用户&互动 → 禁封/举报 → 禁封功能”, * 对齐参考主题 _pz('user_ban_s', true):缺键默认开启)。 */ function aksrt_user_ban_enabled(): bool { $settings = class_exists('\AKSRT\Admin\SchemaProvider') ? \AKSRT\Settings\Settings::read_domain('users', 'report') : (class_exists('\AKSRT\Settings\Settings') ? \AKSRT\Settings\Settings::get_all() : []); $settings = is_array($settings) ? $settings : []; return !isset($settings['user_ban_s']) || !empty($settings['user_ban_s']); } /** * 当前用户能否禁封目标用户(对齐参考主题 zib_current_user_can('set_user_ban') 语义)。 */ function aksrt_current_user_can_ban(int $user_id): bool { if ($user_id <= 0 || !aksrt_user_ban_enabled()) { return false; } $current_id = get_current_user_id(); if ($current_id <= 0 || $current_id === $user_id) { return false; } if (!current_user_can('manage_options')) { return false; } if (function_exists('is_super_admin') && is_super_admin($user_id)) { return false; } return true; } /** * 取用户当前生效中的禁封记录(ban 优先于 suspend,对齐后台单一状态语义)。 */ function aksrt_get_user_current_ban(int $user_id): ?array { if ($user_id <= 0 || !class_exists('\AKSRT\User\Restriction')) { return null; } $svc = \AKSRT\User\Restriction::get_instance(); return $svc->get_active_ban($user_id) ?: $svc->get_active_suspend($user_id); } /** * 禁封 / 解封触发器(参考主题 zib_get_edit_user_ban_link)。 * 输出 data-aksrt-ban 委托入口,由 assets/js/user-ban.js 打开禁封弹窗。 */ function aksrt_get_edit_user_ban_link(int $user_id = 0, string $class = '', string $con = ''): string { if (!aksrt_current_user_can_ban($user_id)) { return ''; } if ($con === '') { $con = aksrt_get_user_current_ban($user_id) ? '' . __('解封此用户', 'aksrt') : '' . __('禁封此用户', 'aksrt'); } return '' . $con . ''; } /** * 用户主页封面三点菜单项(参考主题 author_header_drop_lists 钩子语义): * 有禁封权限 → 禁封入口;否则(开启举报且非本人)→ 举报入口。 */ function aksrt_get_user_cover_menu_action_html(int $user_id): string { if (aksrt_current_user_can_ban($user_id)) { $ban = aksrt_get_user_current_ban($user_id); $label = $ban ? __('解封此用户', 'aksrt') : __('禁封此用户', 'aksrt'); return ''; } return ''; } /** * 评论三点菜单项(参考主题 comments_action_lists 钩子语义): * 管理员 → 禁封用户(固定文案,与参考主题 zib_ban_comments_action_lists_filter * 一致——解封态由弹窗内容呈现);否则 → 举报( Aksrt 既有评论举报契约)。 */ function aksrt_get_comment_ban_or_report_item(\WP_Comment $comment): string { $user_id = (int) $comment->user_id; if ($user_id > 0 && aksrt_current_user_can_ban($user_id)) { return '
  • ' . esc_html__('禁封用户', 'aksrt') . '
  • '; } if (function_exists('aksrt_get_comment_report_html')) { return aksrt_get_comment_report_html($comment); } return ''; } /** * 文章作者资料卡三点菜单项(参考主题 zib_get_post_more_dropdown 语义,菜单首项): * 管理员 → 禁封用户(固定文案,解封态由弹窗内容呈现);否则 → 空(由既有 * 文章举报项兜底,与参考主题「禁封优先、否则举报」互斥语义一致)。 */ function aksrt_get_post_author_ban_item(int $author_id, string $post_url = ''): string { if ($author_id <= 0 || get_current_user_id() === $author_id) { return ''; } if (aksrt_current_user_can_ban($author_id)) { return '' . esc_html__('禁封用户', 'aksrt') . ''; } return ''; } /** * 弹窗关闭图标(与 report.js 同款 SVG 雪碧图契约)。 */ function aksrt_user_ban_close_svg(): string { return ''; } /** * 禁封 / 解封弹窗内容 — 1:1 复刻参考主题 zib_get_set_user_ban_modal: * 未禁封 → 禁封表单(禁封方式 / 禁封时间 / 预置原因徽章 / 其它原因 / * 禁封说明 / 删除全部内容 / 禁止用户申诉(含说明)); * 已禁封 → 解封视图(状态信息 + 解封留言表单)。 * * @return string 弹窗 HTML(空串 = 无权操作或用户不存在) */ function aksrt_get_user_ban_modal(int $user_id): string { $user = $user_id > 0 ? get_userdata($user_id) : null; if (!$user || !aksrt_current_user_can_ban($user_id)) { return ''; } $ban = aksrt_get_user_current_ban($user_id); // 用户行(头像 + 昵称),与参考主题弹窗头部同构。 $avatar_url = get_avatar_url($user_id, ['size' => 40]); $user_name = function_exists('aksrt_get_user_name') ? aksrt_get_user_name(['id' => $user_id, 'vip' => false, 'medal' => false]) : esc_html($user->display_name); $user_row = '
    ' . '' . '' . $user_name . '
    '; // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped -- aksrt_get_user_name escapes internally. $html = '
    '; if ($ban) { // ── 已禁封视图:解封(参考主题解封弹窗同构) ── $is_ban = (string) ($ban['type'] ?? '') === 'ban'; $unban_title = $is_ban ? __('解封用户', 'aksrt') : __('移出小黑屋', 'aksrt'); $status_text = $is_ban ? __('禁封中(禁止登录)', 'aksrt') : __('小黑屋', 'aksrt'); $end_time = !empty($ban['expires_at']) ? (string) $ban['expires_at'] : __('永久', 'aksrt'); // AKSRT 单一 reason 列:禁封说明以“禁封说明:”后缀并入(set_user_ban 同语义), // 解封视图拆回参考主题的「原因 / 说明」两行。 $raw_reason = (string) ($ban['reason'] ?? ''); $reason = $raw_reason; $ban_desc = ''; $desc_marker = __('禁封说明:', 'aksrt'); $marker_pos = strpos($raw_reason, "\n" . $desc_marker); if (false !== $marker_pos) { $reason = substr($raw_reason, 0, $marker_pos); $ban_desc = substr($raw_reason, $marker_pos + strlen("\n" . $desc_marker)); } // 用户名徽章(参考主题 zib_get_user_name(...&class=inflex ac badg p2-10 em09))。 $user_badge = function_exists('aksrt_get_user_name') ? aksrt_get_user_name(['id' => $user_id, 'class' => 'inflex ac badg p2-10 em09', 'vip' => false, 'medal' => false, 'auth' => false, 'level' => false]) : '' . esc_html($user->display_name) . ''; $set_row = static function (string $label, string $value): string { return '
    ' . esc_html($label) . '
    ' . $value . '
    '; // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped -- callers pass escaped HTML. }; // 弹窗头(参考主题 zib_get_modal_colorful_header('c-yellow', ban 图标, 标题): // 120px 多彩横幅 + 大图标 + 居中标题,与禁封视图的 edit-header 头对应)。 $html .= ''; $html .= '
    '; $html .= '
    '; $html .= $set_row(__('用户', 'aksrt'), $user_badge); // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped $html .= $set_row(__('状态', 'aksrt'), esc_html($status_text)); $html .= $set_row(__('开始时间', 'aksrt'), esc_html((string) ($ban['created_at'] ?? ''))); $html .= $set_row(__('结束时间', 'aksrt'), esc_html($end_time)); $html .= $set_row(__('原因', 'aksrt'), nl2br(esc_html($reason))); $html .= $set_row(__('说明', 'aksrt'), nl2br(esc_html($ban_desc))); $html .= '
    '; $html .= '
    '; $html .= '
    '; return $html; } // ── 未禁封视图:禁封表单(参考主题禁封弹窗同构) ── $close_svg = aksrt_user_ban_close_svg(); $html .= '
    ' . esc_html__('禁封用户', 'aksrt') . '
    '; // 历史禁封次数提示(参考主题:>1 次时展示禁封记录链接,此处展示计数提示)。 $log_count = 0; if (class_exists('\AKSRT\User\Restriction')) { $all = \AKSRT\User\Restriction::get_instance()->get_user_restrictions($user_id, false); foreach ((array) $all as $r) { if (in_array((string) ($r['type'] ?? ''), ['ban', 'suspend'], true)) { $log_count++; } } } $log_view = $log_count > 1 ? '
    ' . esc_html__('禁封记录', 'aksrt') . '
    ' . esc_html(sprintf(__('当前用户已有%d次禁封记录,请谨慎操作', 'aksrt'), $log_count)) . '
    ' : ''; $html .= '
    '; $html .= '
    '; $html .= '
    ' . $user_row . $log_view . '
    '; // 禁封方式(1=拉入小黑屋 suspend / 2=禁封用户 ban)。 $html .= '
    ' . esc_html__('禁封方式', 'aksrt') . '
    '; $html .= '
    '; $html .= ''; $html .= ''; $html .= '
    '; $html .= '
    '; $html .= '
    ' . esc_html__('将用户拉入小黑屋后,用户将失去所有的发布权限及大部分的操作权限,例如发帖、评论等', 'aksrt') . '
    '; $html .= '
    ' . esc_html__('禁封的用户将不能登录', 'aksrt') . '
    '; $html .= '
    '; // 禁封时间(1/7/14/30/100/永久,默认 7 天,对齐参考主题 checked(7, ...))。 $html .= '
    ' . esc_html__('禁封时间', 'aksrt') . '
    '; $html .= '
    '; foreach ([1 => __('1天', 'aksrt'), 7 => __('7天', 'aksrt'), 14 => __('14天', 'aksrt'), 30 => __('30天', 'aksrt'), 100 => __('100天', 'aksrt'), 0 => __('永久', 'aksrt')] as $days => $label) { $checked = 7 === $days ? ' checked="checked"' : ''; $html .= ''; } $html .= '
    '; // 选择禁封原因(预置徽章 + 其它原因)。 $html .= '
    ' . esc_html__('选择禁封原因', 'aksrt') . '
    '; $html .= '
    '; $reasons = class_exists('\AKSRT\Settings\UserRuntime') ? (\AKSRT\Settings\UserRuntime::ban_settings()['reasons'] ?? []) : []; foreach ($reasons as $reason) { $html .= ''; } $html .= ''; $html .= '
    '; $html .= ''; // 禁封说明。 $html .= '
    ' . esc_html__('禁封说明', 'aksrt') . '
    '; $html .= ''; // 删除全部内容。 $html .= '
    '; // 禁止用户申诉(含说明联动)。 $html .= '
    '; $html .= '
    '; $html .= '
    '; $html .= '
    '; $html .= '
    '; $html .= ''; $html .= '
    '; return $html; }