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 '
'; } /** * 禁封功能开关(后台“用户&互动 → 禁封/举报 → 禁封功能”, * 对齐参考主题 _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 '