diff --git a/.specs/plans/user-center-sidebar-vip-entry.md b/.specs/plans/user-center-sidebar-vip-entry.md new file mode 100644 index 00000000..33674d99 --- /dev/null +++ b/.specs/plans/user-center-sidebar-vip-entry.md @@ -0,0 +1,61 @@ +# Plan: 用户中心侧栏 VIP 入口卡片 + +## Architectural Decisions + +Durable decisions that apply across all phases: + +- **现有会员导航契约**:完整点击卡片复用现有用户中心 `tab=vip` URL;不打开购买弹窗,也不新增客户端标签切换逻辑。 +- **现有配置决定可见性**:仅当现有 VIP 配置中至少一个等级启用时渲染入口;不新增设置项、管理员例外或不可用占位。 +- **现有数据决定展示状态**:复用既有 VIP 等级、过期等级和到期状态读取能力及文案语义;不增加数据字段、迁移或新的会员状态计算。 +- **侧栏组合层决定顺序**:侧栏组合器将独立 VIP 入口渲染器放在统计信息与账户资产之间;渲染器封装卡片状态和输出。 +- **用户中心样式保持局部**:会员横卡样式限定在用户中心侧栏范围,沿用现有响应式侧栏抽屉,不新增移动端内容区入口。 +- **单一会员入口位置**:删除资产页中仅作导航用途的 VIP 入口,保留独立“我的会员”页面及其购买、续费、升级、兑换和支付能力。 + +--- + +## Phase 1 — 会员入口可从侧栏进入 + +**User stories**: 1、2、3、4、7 + +### What to build + +在统计信息和账户资产之间接入独立的服务端 VIP 入口渲染器。入口根据现有配置和当前用户会员状态,展示未开通引导、有效会员等级与既有到期状态,或过期状态;整个卡片通过现有用户中心 URL 进入“我的会员”页面。此阶段先交付完整行为与基础结构,视觉增强和资产页去重留到下一阶段。 + +### Done when + +- [x] `inc/helpers/user-center-renderers/profile-sidebar.php` 在 `sidebar-stats.php` 后、`sidebar-commerce.php` 前加载独立的侧栏 VIP 入口渲染器。 +- [x] 新的侧栏 VIP 入口渲染器复用现有 VIP 配置、会员等级、过期等级和到期状态,并在没有启用任何 VIP 等级时不输出 HTML。 +- [x] [agent:test-auditor] 人工检查渲染器的四种服务端输出:未开通显示权益引导;有效会员显示等级和既有状态文案;过期会员显示过期状态;VIP 未启用时无入口,并确认未引入新的精确日期格式。 +- [x] 新入口的完整可点击区域使用 `aksrt_get_user_center_tab_url('vip')` 生成目标地址,人工检查所得 URL 可进入 `tab=vip`。 +- [x] 运行 `php tools/audit-admin-contracts.php`,命令退出码为 0 且报告为 `errors=0`。 + +--- + +## Phase 2 — 会员横卡完成视觉落地并消除重复入口 + +**User stories**: 5、6 + +### What to build + +为侧栏 VIP 入口增加与账户资产双卡明显区分的金色或会员感渐变视觉、会员图标、动态状态文本、右侧箭头及交互反馈,并确保其随既有侧栏在移动端抽屉中正确展示。同时删除资产页内容区中重复的 VIP 导航卡,保持余额、积分、签到和记录功能不变。 + +### Done when + +- [x] `assets/css/routes/user-center/shell.css` 包含限定在用户中心侧栏的 VIP 卡样式,覆盖会员渐变、图标、状态文本、右侧箭头、完整卡片悬停/聚焦状态和窄屏文本约束。 +- [x] `inc/helpers/user-center-renderers/profile-credits.php` 不再输出 `uc-vip-assets-entry` 导航卡,文件中原有余额、积分、签到和资产记录组合逻辑仍被保留。 +- [ ] [agent:test-auditor] 人工在桌面宽度验收“统计信息 → VIP 入口 → 账户资产”的顺序、整卡跳转和 VIP 卡与余额/积分双卡的视觉区分。 +- [ ] [agent:test-auditor] 人工在既有移动侧栏抽屉验收相同顺序、整卡可点击性、状态文本无溢出,并确认页面内容区没有额外复制 VIP 入口。 +- [x] 运行 `php tools/audit-admin-contracts.php`,命令退出码为 0 且报告为 `errors=0`。 + +## Out of Scope + +- 修改“我的会员”页面的布局、文案、套餐卡、权益内容或购买流程。 +- 修改支付弹窗、支付渠道、续费、升级、兑换、卡密兑换或订单逻辑。 +- 新增、修改或迁移会员数据、会员状态算法、到期日期格式、数据库表或 REST API。 +- 新增后台会员配置、侧栏开关、管理员例外显示规则或运营统计。 +- 记录 VIP 入口的曝光、点击或转化数据。 +- 在移动端内容区额外置顶或复制 VIP 入口。 + +## Open Questions + +无。 diff --git a/.specs/prds/user-center-sidebar-vip-entry.md b/.specs/prds/user-center-sidebar-vip-entry.md new file mode 100644 index 00000000..9a73ea4d --- /dev/null +++ b/.specs/prds/user-center-sidebar-vip-entry.md @@ -0,0 +1,95 @@ +# 用户中心侧栏 VIP 入口卡片 + +## Problem Statement + +用户中心侧栏当前在统计信息卡片后直接展示账户资产卡片,会员入口仅存在于资产页内容区。会员入口缺少侧栏层级的持续曝光,并且与参考主题的“统计信息 → VIP 入口 → 账户资产”信息架构不一致;同时,用户中心内重复出现会员入口会造成导航冗余。 + +## Current State + +- 用户中心侧栏按“统计信息、账户资产、创作/收益、服务、设置”的顺序组织内容。 +- 已存在独立的“我的会员”用户中心页面,并使用现有 VIP 等级、会员状态和到期状态能力展示会员信息及承接续费、升级、开通等操作。 +- 资产页内容区当前已有一个进入“我的会员”页面的 VIP 入口。 +- 会员功能可由后台 VIP 等级开关控制;未启用任何 VIP 等级时,会员中心不应成为可用入口。 +- 移动端用户中心侧栏会收纳至既有抽屉中。 + +## Solution + +在用户中心侧栏中,统计信息卡片下方、账户资产卡片上方新增一个醒目的 VIP 入口横卡;整体顺序调整为“统计信息 → VIP 入口 → 账户资产”。 + +入口采用参考主题的会员横卡视觉方向:金色或会员感渐变背景、会员图标、动态状态文案及右侧箭头。卡片为完整可点击区域,点击后以现有用户中心 URL 进入“我的会员”页面。 + +入口仅在至少一个 VIP 等级启用时展示。未启用会员功能时,不渲染入口,也不提供不可用状态或管理员例外。 + +卡片根据当前登录用户的既有会员状态展示: + +- 未开通会员:展示开通会员及会员权益引导文案。 +- 当前有效会员:展示当前会员等级和既有有效期状态文案,例如“VIP1 · 还有 30 天到期”。 +- 已过期会员:展示当前或最近会员等级及既有“已过期”等状态文案。 + +状态文案沿用现有会员状态语义,不新增精确到期日期格式或新的会员状态计算规则。 + +移动端不额外创建内容区入口;卡片随现有侧栏收纳至抽屉,并保持与桌面端相同的顺序。 + +为消除重复入口,移除账户资产页内容区中现有的 VIP 入口卡片。独立“我的会员”页面、会员套餐展示、购买弹窗、支付流程和会员状态逻辑保持不变。 + +## User Stories + +1. 作为未开通会员的登录用户,我可以在用户中心侧栏统计信息下方看到会员入口,了解开通会员可获得权益,并可进入我的会员页面。 +2. 作为有效会员,我可以在侧栏入口直接看到当前会员等级和既有到期状态提示,并进入我的会员页面进行续费或升级。 +3. 作为已过期会员,我可以在侧栏入口看到已过期状态,并进入我的会员页面重新开通或续费。 +4. 作为普通用户,当站点没有启用任何 VIP 等级时,我不会看到失效或不可访问的会员入口。 +5. 作为移动端用户,我可以在用户中心侧栏抽屉中按“统计信息、VIP 入口、账户资产”的顺序找到会员入口。 +6. 作为用户,我在账户资产页不再看到重复的会员入口,但原有资产余额、积分、签到及记录功能不受影响。 +7. 作为用户,我点击 VIP 横卡后会通过现有可分享、可刷新、可返回的用户中心链接进入“我的会员”页面。 + +## Implementation Decisions + +### New Modules + +- **侧栏 VIP 入口渲染器**:基于既有用户中心渲染上下文,在统计信息与账户资产之间输出一个完整可点击的会员横卡;负责会员功能启用判断、状态展示数据和目标链接的组合。 +- **侧栏 VIP 入口样式模块**:为会员横卡定义桌面端与抽屉端一致的会员视觉、图标、状态文本、箭头、悬停和窄屏布局;不改变现有统计卡或资产卡的布局职责。 + +### Architectural Decisions + +- 复用既有 VIP 启用判断、会员等级解析和到期状态文本;不复制或重新定义会员状态业务逻辑。 +- 复用现有“我的会员”用户中心目标页和 `tab=vip` 导航方式;不采用未开通即打开购买弹窗的分流行为。 +- 侧栏顺序由侧栏组合层负责,VIP 入口置于统计信息渲染之后、账户资产渲染之前。 +- 删除资产页内容区仅作为导航入口的现有 VIP 卡片;不删除独立会员页面及其中的套餐、权益、续费、升级、兑换和支付能力。 +- 不引入新设置项;可见性完全由现有 VIP 等级启用配置决定。 + +### Schema Changes + +无。复用已有会员配置、用户会员状态和到期状态数据。 + +### API Contracts + +无。入口仅使用既有用户中心页面路由和现有服务端渲染数据。 + +### Navigation + +- 桌面端:用户中心侧栏展示“统计信息 → VIP 入口 → 账户资产”。 +- 移动端:上述顺序在既有用户中心侧栏抽屉中保持一致。 +- 点击 VIP 入口:进入现有用户中心“我的会员”目标页(`tab=vip`)。 +- 账户资产页:移除其内容区内已有的 VIP 导航入口,避免重复。 + +## Testing Decisions + +采用静态契约审计与人工响应式验收。 + +- 运行现有管理员契约审计,确保本次模板与样式调整没有引入管理端契约回归。 +- 人工验收未开通会员:卡片显示权益引导文案,点击进入我的会员页面。 +- 人工验收有效会员:卡片显示会员等级及既有剩余有效期状态文案。 +- 人工验收过期会员:卡片显示既有过期状态文案,跳转仍可用。 +- 人工验收未启用任何 VIP 等级:侧栏不显示 VIP 入口。 +- 人工验收桌面端顺序:统计信息、VIP 入口、账户资产依次显示,会员横卡视觉与资产双卡区分明显。 +- 人工验收移动端:入口随侧栏进入抽屉,顺序、可点击性和窄屏样式正确。 +- 人工验收资产页:原 VIP 入口已移除,余额、积分及其他资产功能仍正常。 + +## Out of Scope + +- 修改“我的会员”页面的布局、文案、套餐卡、权益内容或购买流程。 +- 修改支付弹窗、支付渠道、续费、升级、兑换、卡密兑换或订单逻辑。 +- 新增、修改或迁移会员数据、会员状态算法、到期日期格式、数据库表或 REST API。 +- 新增后台会员配置、侧栏开关、管理员例外显示规则或运营统计。 +- 记录 VIP 入口的曝光、点击或转化数据。 +- 在移动端内容区额外置顶或复制 VIP 入口。 diff --git a/assets/css/routes/user-center/shell.css b/assets/css/routes/user-center/shell.css index 792ce2dc..580abfdf 100644 --- a/assets/css/routes/user-center/shell.css +++ b/assets/css/routes/user-center/shell.css @@ -450,6 +450,123 @@ body.aksrt-user-center .uc-content, font-size: 11px; } +/* VIP 入口:琥珀会员券,与下方中性资产卡形成主次层级 */ +.uc-sidebar .uc-sidebar-vip { + position: relative; + display: grid; + grid-template-columns: auto minmax(0, 1fr) auto; + align-items: center; + gap: 11px; + min-width: 0; + overflow: hidden; + padding: 13px 14px; + border: 1px solid rgba(255, 232, 177, 0.34); + border-radius: var(--main-radius, var(--radius, 8px)); + background: + radial-gradient(circle at 88% 12%, rgba(255, 239, 190, 0.2), transparent 34%), + linear-gradient(122deg, #4a2b13 0%, #7c4a1c 48%, #a86d28 100%); + box-shadow: 0 7px 18px rgba(91, 50, 15, 0.18); + color: #fff8e8; + text-decoration: none; + isolation: isolate; + transition: transform 0.2s ease, box-shadow 0.2s ease, border-color 0.2s ease; +} + +.uc-sidebar .uc-sidebar-vip::after { + content: ''; + position: absolute; + z-index: -1; + top: -80%; + left: 58%; + width: 34px; + height: 260%; + background: linear-gradient(90deg, transparent, rgba(255, 246, 211, 0.14), transparent); + transform: rotate(24deg); + pointer-events: none; +} + +.uc-sidebar-vip__icon { + display: grid; + place-items: center; + width: 38px; + height: 38px; + border: 1px solid rgba(255, 240, 197, 0.46); + border-radius: 50%; + background: rgba(255, 244, 211, 0.12); + box-shadow: inset 0 0 0 4px rgba(255, 244, 211, 0.05); + color: #ffd982; + font-size: 16px; +} + +.uc-sidebar-vip__content { + min-width: 0; +} + +.uc-sidebar-vip__content strong, +.uc-sidebar-vip__content small { + display: block; + overflow: hidden; + text-overflow: ellipsis; + white-space: nowrap; +} + +.uc-sidebar-vip__content strong { + color: #fffaf0; + font-size: 14px; + font-weight: 700; + letter-spacing: 0.01em; + line-height: 1.35; +} + +.uc-sidebar-vip__content small { + margin-top: 3px; + color: rgba(255, 244, 216, 0.76); + font-size: 11px; + line-height: 1.35; +} + +.uc-sidebar-vip__arrow { + color: rgba(255, 244, 216, 0.72); + font-size: 12px; + transition: transform 0.2s ease, color 0.2s ease; +} + +.uc-sidebar .uc-sidebar-vip:hover { + border-color: rgba(255, 235, 180, 0.58); + box-shadow: 0 10px 24px rgba(91, 50, 15, 0.25); + color: #fff8e8; + transform: translateY(-1px); +} + +.uc-sidebar .uc-sidebar-vip:hover .uc-sidebar-vip__arrow { + color: #fff4d8; + transform: translateX(2px); +} + +.uc-sidebar .uc-sidebar-vip:focus-visible { + outline: 3px solid rgba(244, 180, 67, 0.42); + outline-offset: 2px; +} + +@media (max-width: 991.98px) { + .uc-sidebar .uc-sidebar-vip { + margin-right: 12px; + margin-left: 12px; + } +} + +@media (prefers-reduced-motion: reduce) { + .uc-sidebar .uc-sidebar-vip, + .uc-sidebar-vip__arrow { + transition: none; + } + + .uc-sidebar .uc-sidebar-vip:hover, + .uc-sidebar .uc-sidebar-vip:hover .uc-sidebar-vip__arrow { + transform: none; + } +} + .uc-service-grid__icon small { position: absolute; top: -5px; diff --git a/inc/helpers/user-center-renderers/profile-credits.php b/inc/helpers/user-center-renderers/profile-credits.php index e525af63..6eeaadb8 100644 --- a/inc/helpers/user-center-renderers/profile-credits.php +++ b/inc/helpers/user-center-renderers/profile-credits.php @@ -38,17 +38,6 @@ if ($show_wallet || $show_credits) : '; - echo '
' . esc_html__('我的会员', 'aksrt') . '
'; - echo '
' . esc_html__('查看权益、续费与升级', 'aksrt') . '
'; - echo '' . esc_html__('进入会员中心', 'aksrt') . ''; - echo ''; -} if ($show_credits) { require $dir . '/credits-signin.php'; } diff --git a/inc/helpers/user-center-renderers/profile-sidebar.php b/inc/helpers/user-center-renderers/profile-sidebar.php index 4943137b..d7fdfad7 100644 --- a/inc/helpers/user-center-renderers/profile-sidebar.php +++ b/inc/helpers/user-center-renderers/profile-sidebar.php @@ -11,6 +11,7 @@ $context = is_array($args['context'] ?? null) ? $args['context'] : []; extract($context, EXTR_SKIP); // phpcs:ignore WordPress.PHP.DontExtract.extract_extract require __DIR__ . '/sidebar-stats.php'; +require __DIR__ . '/sidebar-vip.php'; require __DIR__ . '/sidebar-commerce.php'; require __DIR__ . '/sidebar-creator.php'; require __DIR__ . '/sidebar-nav.php'; diff --git a/inc/helpers/user-center-renderers/sidebar-vip.php b/inc/helpers/user-center-renderers/sidebar-vip.php new file mode 100644 index 00000000..e4b4e436 --- /dev/null +++ b/inc/helpers/user-center-renderers/sidebar-vip.php @@ -0,0 +1,54 @@ + 0) { + $title = (string) ($vip_levels[$vip_level]['name'] ?? ('VIP' . $vip_level)); + if ($expires <= 0) { + $status = __('永久会员', 'aksrt'); + } else { + $remaining_days = max(1, (int) ceil(($expires - time()) / DAY_IN_SECONDS)); + $status = sprintf( + /* translators: %d: remaining membership days */ + __('还有 %d 天到期', 'aksrt'), + $remaining_days + ); + } +} elseif ($expired_level > 0) { + $title = (string) ($vip_levels[$expired_level]['name'] ?? ('VIP' . $expired_level)); + $status = __('已过期', 'aksrt'); +} +?> + + + + + + + +