get_display_state($user_id);
}
if ($state === '') {
return $cache[$user_id] = [];
}
$badges = class_exists('\AKSRT\User\Restriction') ? \AKSRT\User\Restriction::state_badges() : [];
$badge = is_array($badges[$state] ?? null) ? $badges[$state] : [];
return $cache[$user_id] = [
'state' => $state,
'label' => (string) ($badge['label'] ?? ''),
'tone' => (string) ($badge['tone'] ?? 'c-gray'),
'icon' => (string) ($badge['icon'] ?? '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);
}
/**
* 治理状态徽章（占据身份行元信息位，参考主题 author_header_identity 钩子 /
* zib_ban_author_header_identity_filter：badg + 图标 + 文案，红=封号、
* 黄=小黑屋、灰=禁言，字段与颜色由 Restriction::state_badges() 统一管理）。
*/
function aksrt_get_user_ban_identity_badge(int $user_id, string $class = ''): string
{
$state = aksrt_get_user_ban_state($user_id);
if (empty($state['state'])) {
return '';
}
$classes = trim('badg ' . (string) $state['tone'] . ($class !== '' ? ' ' . $class : ''));
return ''
. ''
. esc_html((string) $state['label']) . '';
}
/**
* 「查看禁封状态」入口（用户中心元信息位，参考主题 user_page_header_desc
* 钩子 / zib_get_user_ban_info_link：but 按钮 = 内层 badg 徽章（带色）+
* 右箭头，外层 but 为默认按钮色——不在内外两层重复着色）。
* 点击经 data-aksrt-ban-info 委托打开禁封信息弹窗。
*/
function aksrt_get_user_ban_info_link(int $user_id, string $class = ''): string
{
if (!aksrt_user_ban_enabled()) {
return '';
}
$state = aksrt_get_user_ban_state($user_id);
if (empty($state['state'])) {
return '';
}
$badge = aksrt_get_user_ban_identity_badge($user_id);
if ($badge === '') {
return '';
}
// 外层 but 不重复状态色：颜色仅由内层 badg 承载（1:1 参考主题）。
$classes = trim('but p2-10' . ($class !== '' ? ' ' . $class : ''));
return '' . $badge
. '';
}
/**
* 禁封信息弹窗（1:1 复刻参考主题 zib_get_ban_info_modal：多彩头 c-gray +
* 禁封信息行 + 申诉入口；本人或管理员可见）。
*
* @return string 弹窗 HTML（空串 = 无权查看或用户不存在）
*/
function aksrt_get_user_ban_info_modal(int $user_id): string
{
$user = $user_id > 0 ? get_userdata($user_id) : null;
if (!$user) {
return '';
}
$viewer_id = get_current_user_id();
$can_view = $viewer_id > 0 && ($viewer_id === $user_id || aksrt_current_user_can_ban($user_id));
if (!$can_view) {
return '';
}
$info = class_exists('\AKSRT\User\Restriction')
? \AKSRT\User\Restriction::get_instance()->get_ban_info($user_id)
: [];
$html = '';
// 弹窗头（参考主题 zib_get_modal_colorful_header('c-gray', ban 图标, 标题)）。
$html .= '';
if (empty($info)) {
$html .= '
' . esc_html__('您已解封，请刷新页面', 'aksrt') . '
' . esc_html($label) . '
' . esc_html($value) . '
';
$html .= $set_row(__('用户名', 'aksrt'), $user->display_name);
$html .= $set_row(__('状态', 'aksrt'), (string) $info['status']);
$html .= $set_row(__('开始时间', 'aksrt'), (string) $info['start']);
$html .= $set_row(__('结束时间', 'aksrt'), (string) $info['end']);
$html .= $set_row(__('原因', 'aksrt'), (string) $info['reason']);
$html .= $set_row(__('说明', 'aksrt'), (string) $info['desc']);
$html .= '
';
if (!empty($info['no_appeal'])) {
$html .= '' . esc_html__('您当前已无法进行申诉', 'aksrt') . '
';
if ((string) $info['no_appeal_desc'] !== '') {
$html .= '
' . esc_html((string) $info['no_appeal_desc']) . '
';
}
$html .= '
';
$html .= '';
$html .= $appeal_link !== '' ? $appeal_link : '';
$html .= '
';
}
$html .= '';
return $html;
}
/**
* 「申诉」入口（参考主题 zib_get_user_ban_appeal_link：禁封申诉 modal-mini，
* 仅本人可发起；点击经 data-aksrt-ban-appeal 委托打开申诉弹窗）。
*/
function aksrt_get_user_ban_appeal_link(int $user_id, string $class = ''): string
{
if ($user_id <= 0 || get_current_user_id() !== $user_id) {
return '';
}
$classes = trim((string) ($class !== '' ? $class : 'but c-blue'));
return ''
. ''
. esc_html__('申诉', 'aksrt') . '';
}
/**
* 禁封申诉弹窗（1:1 复刻参考主题 zib_get_user_ban_appeal_modal：
* edit-header（gavel / c-blue / 禁封申诉）+ 禁封信息行 + 申诉说明 + 资料项
* 输入 + 审核中态 + 禁止申诉态；仅本人可见可提交）。
*
* @return string 弹窗 HTML（空串 = 非本人或用户不存在）
*/
function aksrt_get_user_ban_appeal_modal(int $user_id): string
{
$user = $user_id > 0 ? get_userdata($user_id) : null;
if (!$user || get_current_user_id() !== $user_id) {
return '';
}
$info = class_exists('\AKSRT\User\Restriction')
? \AKSRT\User\Restriction::get_instance()->get_ban_info($user_id)
: [];
$settings = class_exists('\AKSRT\User\BanAppeal') ? \AKSRT\User\BanAppeal::settings() : ['enabled' => true, 'desc' => '', 'keys' => []];
$status = class_exists('\AKSRT\User\BanAppeal') ? \AKSRT\User\BanAppeal::get_status($user_id) : '';
$payload = class_exists('\AKSRT\User\BanAppeal') ? \AKSRT\User\BanAppeal::get_payload($user_id) : [];
// 弹窗头（参考主题 edit-header：关闭钮 + gavel 徽标 + 标题居左）。
$html = '';
$html .= '';
if (empty($info)) {
$html .= '
' . esc_html__('您已解封，请刷新页面', 'aksrt') . '
' . esc_html($label) . '
' . esc_html($value) . '
'
. $set_row(__('用户名', 'aksrt'), $user->display_name)
. $set_row(__('状态', 'aksrt'), (string) $info['status'])
. $set_row(__('开始时间', 'aksrt'), (string) $info['start'])
. $set_row(__('结束时间', 'aksrt'), (string) $info['end'])
. $set_row(__('原因', 'aksrt'), (string) $info['reason'])
. $set_row(__('说明', 'aksrt'), (string) $info['desc'])
. '
';
if (!empty($info['no_appeal'])) {
// 禁止申诉态（参考主题：c-yellow box-body + 禁止申诉说明）。
$html .= '' . esc_html__('抱歉！您当前已无法进行申诉', 'aksrt') . '
';
if ((string) $info['no_appeal_desc'] !== '') {
$html .= '
' . esc_html((string) $info['no_appeal_desc']) . '
';
}
$html .= '
' . esc_html__('申诉功能暂未开启', 'aksrt') . '
';
return $html;
}
$input = '';
$footer = '';
if ($status === 'pending') {
// 审核中态（参考主题：黄色 badg + 已提交资料行 + 提交时间）。
$input = '' . esc_html__('您的申诉正在审核中，请耐心等待', 'aksrt') . '
';
$data = is_array($payload['data'] ?? null) ? $payload['data'] : [];
if (!empty($data)) {
foreach ($data as $k => $v) {
$input .= $set_row((string) $k, (string) $v);
}
} elseif (!empty($payload['reason'])) {
$input .= $set_row(__('申诉说明', 'aksrt'), (string) $payload['reason']);
}
$input .= $set_row(__('提交时间', 'aksrt'), (string) ($payload['time'] ?? ''));
} else {
// 申诉表单（参考主题：资料项逐项输入 + 申诉说明 textarea + 双按钮）。
foreach ((array) $settings['keys'] as $key) {
$key = (string) $key;
if ($key === '') {
continue;
}
$input .= '';
}
$input .= '' . esc_html__('请填写申诉说明', 'aksrt') . '
'
. '
'
. ''
. wp_nonce_field('aksrt_ban_appeal', '_wpnonce', false, false)
. ''
. ''
. '
';
}
$desc_html = (string) $settings['desc'] !== '' ? '' . wp_kses_post(nl2br(esc_html((string) $settings['desc']))) . '
' : '';
// 滚动容器：scroll-y + no-scrollbar（完全隐藏滚动条，含细滚动条）+ max-vh5（50vh，
// 内层滚动、外层对话框不滚动）；说明框保持 rows=3 自然高度，不做 autoHeight 压缩。
$html .= '';
$html .= '';
return $html;
}
/**
* 「查看禁封记录」链接（参考主题 zib_get_user_ban_log_link：em09 c-yellow
* 链接触发禁封记录弹窗；仅具备禁封权限的管理员可见）。
*/
function aksrt_get_user_ban_log_link(int $user_id, string $class = '', string $con = ''): string
{
if ($user_id <= 0 || !aksrt_current_user_can_ban($user_id)) {
return '';
}
if ($con === '') {
$con = '' . esc_html__('查看禁封记录', 'aksrt');
}
$classes = trim('em09 c-yellow pointer ' . $class);
return '' . $con . '';
}
/**
* 禁封记录弹窗（1:1 复刻参考主题 zib_get_ban_log_modal：多彩头 c-yellow +
* 用户行 + 计数 + 逐条记录卡（类型徽章 / 结束时间 / 原因 / 说明 / 禁止申诉）；
* 仅具备禁封权限的管理员可见）。
*
* @return string 弹窗 HTML（空串 = 无权查看）
*/
function aksrt_get_user_ban_log_modal(int $user_id): string
{
$user = $user_id > 0 ? get_userdata($user_id) : null;
if (!$user || !aksrt_current_user_can_ban($user_id)) {
return '';
}
$logs = class_exists('\AKSRT\User\Restriction')
? \AKSRT\User\Restriction::get_instance()->get_user_restrictions($user_id, false)
: [];
$logs = array_values(array_filter((array) $logs, static function ($r): bool {
return in_array((string) ($r['type'] ?? ''), ['ban', 'suspend'], true);
}));
// 弹窗头（参考主题 zib_get_modal_colorful_header('c-yellow', ban 图标, 标题)）。
$html = '';
$html .= '';
$user_name = function_exists('aksrt_get_user_name')
? aksrt_get_user_name(['id' => $user_id, 'vip' => false, 'medal' => false, 'auth' => false, 'level' => false])
: '
' . esc_html($user->display_name) . '';
$avatar_url = get_avatar_url($user_id, ['size' => 40]);
$html .= '
 $avatar_url) . ')
' . $user_name . '
'; // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped -- aksrt_get_user_name escapes internally.
if (empty($logs)) {
$html .= '
' . esc_html__('该用户暂无禁封记录', 'aksrt') . '
' . esc_html(sprintf(__('该用户共有%d次禁封记录', 'aksrt'), count($logs))) . '
';
$html .= '';
return $html;
}
/**
* 受限位置治理提示（评论拒绝态，参考主题 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 : '');
$inner = ''
. '' . esc_html($text) . '';
if (aksrt_current_user_can_ban($user_id) || get_current_user_id() === $user_id) {
$inner .= ' '
. esc_html__('查看禁封状态', 'aksrt')
. '';
}
return '';
}
/**
* 昵称旁禁封徽章（参考主题 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 '';
}
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 ''
. '';
}
/**
* 登录后禁封状态页（1:1 复刻参考主题 zib_user_ban_restrict_login /
* zib_die_page：红盒提示 + 禁封信息行 + 申诉权限 + 退出登录/申诉按钮）。
* 由 Restriction::restrict_frontend_access() 在 template_redirect 调用。
*/
function aksrt_render_user_ban_block_page(int $user_id): void
{
$user = $user_id > 0 ? get_userdata($user_id) : null;
if (!$user) {
return;
}
$info = class_exists('\AKSRT\User\Restriction')
? \AKSRT\User\Restriction::get_instance()->get_ban_info($user_id)
: [];
// 禁封页可出现在任何前台页面：确保弹窗运行时与禁封脚本就位（申诉入口）。
if (function_exists('wp_style_is') && !wp_script_is('aksrt-user-ban', 'enqueued')) {
$ban_js = get_template_directory() . '/assets/js/user-ban.js';
if (file_exists($ban_js)) {
wp_enqueue_script(
'aksrt-user-ban',
get_template_directory_uri() . '/assets/js/user-ban.js',
['loader_js'],
filemtime($ban_js) ?: '1.0.0',
true
);
}
}
if (!headers_sent()) {
header('Content-Type: text/html; charset=' . get_bloginfo('charset'));
}
get_header();
get_template_part('templates/parts/user/ban-block', null, [
'user' => $user,
'info' => $info,
]);
get_footer();
exit;
}
/**
* 禁封功能开关（后台“用户&互动 → 禁封/举报 → 禁封功能”，
* 对齐参考主题 _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 '';
}
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 . '';
if ($ban) {
// ── 已禁封视图：解封（参考主题解封弹窗同构） ──
$is_ban = (string) ($ban['type'] ?? '') === 'ban';
$unban_title = $is_ban ? __('解封用户', 'aksrt') : __('移出小黑屋', 'aksrt');
// 用户名徽章（参考主题 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) . '';
// 禁封信息行（与查看禁封状态弹窗 / 申诉弹窗 / 禁封页共用的单一数据源）。
$info = class_exists('\AKSRT\User\Restriction')
? \AKSRT\User\Restriction::get_instance()->get_ban_info($user_id)
: [];
$set_row = static function (string $label, string $value, bool $raw = false): string {
if ($value === '') {
return '';
}
$html_value = $raw ? $value : nl2br(esc_html($value)); // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped -- raw callers pass internally-escaped HTML.
return '
' . esc_html($label) . '
' . $html_value . '
';
};
// 禁封记录入口（参考主题：>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_link = aksrt_get_user_ban_log_link($user_id, 'em09 c-yellow', sprintf(__('当前用户已有%d次禁封记录，请谨慎操作', 'aksrt'), $log_count));
$log_view = ($log_count > 1 && $log_link !== '')
? '
' . esc_html__('禁封记录', 'aksrt') . '
' . $log_link . '
'
: '';
// 弹窗头（参考主题 zib_get_modal_colorful_header('c-yellow', ban 图标, 标题)：
// 120px 多彩横幅 + 大图标 + 居中标题，与禁封视图的 edit-header 头对应）。
$html .= '';
$html .= '
' . esc_html__('禁封记录', 'aksrt') . '
' . $log_link . '