feat(users): add inline promotion center

assets/admin/src/schema/sections/users/features.js

@@ -4,7 +4,7 @@ export const featuresSchema = {
   icon: 'fas fa-user-cog',
   description: '配置用户中心和个人主页的功能模块。',
   defaults: {
-    user_center_tabs: 'profile,level,posts,comments,favorites,vip,credits,auth',
+    user_center_tabs: 'profile,level,posts,comments,favorites,vip,credits,promotion,auth',
     user_cover_upload: true,
     user_social_links: true,
     user_desc_std: '这家伙很懒…',
@@ -24,7 +24,7 @@ export const featuresSchema = {
       title: '用户中心',
       icon: 'fas fa-user-shield',
       fields: [
-        { key: 'user_center_tabs', label: '用户中心 Tab', type: 'input', default: 'profile,level,posts,comments,favorites,vip,credits,auth', help: '逗号分隔。level=我的等级；auth=官方认证；等级、VIP、订单和认证会按功能开关自动注入' },
+        { key: 'user_center_tabs', label: '用户中心 Tab', type: 'input', default: 'profile,level,posts,comments,favorites,vip,credits,promotion,auth', help: '逗号分隔。level=我的等级；promotion=推广中心；auth=官方认证；等级、VIP、订单、推广中心和认证会按功能开关自动注入' },
         { key: 'user_cover_upload', label: '封面上传', type: 'switch', default: true },
         { key: 'user_social_links', label: '社交链接', type: 'switch', default: true },
         { key: 'user_desc_std', label: '默认签名', type: 'input', default: '这家伙很懒…', help: '用户未设置个人简介时显示的默认文案' },

inc/helpers/aksrt-user-center.php

@@ -102,13 +102,17 @@ if (!function_exists('aksrt_get_user_center_tab_url')) {
 	 * Build a canonical full-page user-center tab URL.
 	 */
 	function aksrt_get_user_center_tab_url(string $tab): string {
+		$tab = sanitize_key($tab);
+		if ('invite' === $tab) {
+			$tab = 'promotion';
+		}
 		$url = remove_query_arg([
 			'tab', 'posts_page', 'comments_page', 'favorites_page', 'credits_page',
 			'post_status', 'saved', 'profile_error',
 			'order_tab', 'otab', 'order_status', 'order_page', 'order_type', 'section',
 		], aksrt_get_user_center_url());
 
-		return add_query_arg('tab', sanitize_key($tab), $url);
+		return add_query_arg('tab', $tab, $url);
 	}
 }
 
@@ -150,6 +154,7 @@ if (!function_exists('aksrt_capture_user_center_view')) {
 			'vip'            => 'vip',
 			'orders'         => 'orders',
 			'auth'           => 'auth',
+			'promotion'      => 'promotion',
 			'settings'       => 'settings',
 			'header'         => 'header',
 			'sidebar'        => 'sidebar',
@@ -174,7 +179,7 @@ if (!function_exists('aksrt_capture_user_center_panel')) {
 	 * Capture a built-in or registered user-center panel body.
 	 */
 	function aksrt_capture_user_center_panel(string $tab_key, array $tab, array $context): string {
-		$built_in_tabs = ['profile', 'level', 'posts', 'comments', 'favorites', 'credits', 'vip', 'orders', 'auth', 'settings'];
+		$built_in_tabs = ['profile', 'level', 'posts', 'comments', 'favorites', 'credits', 'vip', 'orders', 'auth', 'promotion', 'settings'];
 		if (in_array($tab_key, $built_in_tabs, true)) {
 			return aksrt_capture_user_center_view($tab_key, $context);
 		}
@@ -280,7 +285,7 @@ if (!function_exists('aksrt_user_center_resolve_tabs')) {
 		if ('signin' === $active || 'assets' === $active) {
 			$active = 'credits';
 		} elseif ('invite' === $active) {
-			$active = 'settings';
+			$active = 'promotion';
 		} elseif ('vip' === $active) {
 			// Prefer dedicated vip tab when registered; else credits (VIP shop).
 			$active = in_array('vip', $keys, true) ? 'vip' : 'credits';
@@ -339,7 +344,7 @@ if (!function_exists('aksrt_user_center_runtime_config')) {
 			'activeTab'     => $active_tab,
 			'tabAliases'    => [
 					'signin' => 'credits',
-					'invite' => 'settings',
+					'invite' => 'promotion',
 					'assets' => 'credits',
 					// vip → vip when panel exists; SPA may still map missing keys via server resolve.
 					'vip'    => 'vip',

inc/helpers/user-center-renderers/profile-promotion.php

@@ -0,0 +1,22 @@
+<?php
+/**
+ * User center promotion panel shell.
+ *
+ * @package AKSRT
+ */
+
+defined('ABSPATH') || exit;
+
+$context = is_array($args['context'] ?? null) ? $args['context'] : [];
+extract($context, EXTR_SKIP); // phpcs:ignore WordPress.PHP.DontExtract.extract_extract
+?>
+<section class="uc-promotion-panel" aria-labelledby="uc-promotion-title">
+	<header class="uc-promotion-panel__header">
+		<span class="uc-promotion-panel__icon"><i class="fas fa-user-plus" aria-hidden="true"></i></span>
+		<div>
+			<p class="uc-promotion-panel__eyebrow"><?php esc_html_e('邀请与奖励', 'aksrt'); ?></p>
+			<h2 id="uc-promotion-title"><?php esc_html_e('推广中心', 'aksrt'); ?></h2>
+		</div>
+	</header>
+	<p class="uc-promotion-panel__intro"><?php esc_html_e('在这里分享专属邀请链接并查看推广成果。', 'aksrt'); ?></p>
+</section>

inc/helpers/user-center-renderers/profile-settings.php

@@ -13,5 +13,4 @@ extract($context, EXTR_SKIP); // phpcs:ignore WordPress.PHP.DontExtract.extract_
 $dir = __DIR__;
 require $dir . '/settings-bindings.php';
 require $dir . '/settings-security.php';
-require $dir . '/settings-invite.php';
 require $dir . '/settings-runtime-fields.php';

inc/helpers/user-center-renderers/settings-invite.php

@@ -1,70 +0,0 @@
-<?php
-/**
- * User center settings: invite friends panel.
- *
- * Expects extracted $context vars.
- *
- * @package AKSRT
- */
-
-defined('ABSPATH') || exit;
-
-if (empty($show_invite_section)) {
-	return;
-}
-?>
-<div class="settings-section">
-	<div class="settings-section__header">
-		<span class="settings-icon"><i class="fas fa-user-plus" aria-hidden="true"></i></span>
-		<h3 class="widget-title settings-section__title"><?php esc_html_e('邀请好友', 'aksrt'); ?></h3>
-	</div>
-	<div class="aksrt-invite-panel" data-aksrt-invite>
-		<div class="aksrt-invite-hero">
-			<div class="aksrt-invite-hero__main">
-				<span class="aksrt-invite-kicker"><?php esc_html_e('邀请奖励', 'aksrt'); ?></span>
-				<p class="aksrt-invite-desc">
-					<?php echo esc_html(sprintf(__('将专属链接分享给好友，好友完成注册与验证后即可获得双向%s奖励。', 'aksrt'), $currency_name)); ?>
-				</p>
-			</div>
-			<div class="aksrt-invite-code-card">
-				<span><?php esc_html_e('邀请码', 'aksrt'); ?></span>
-				<strong data-invite-code>--</strong>
-			</div>
-		</div>
-		<div class="aksrt-invite-link-row">
-			<input type="text" class="aksrt-invite-link" data-invite-link readonly value="" aria-label="<?php esc_attr_e('邀请链接', 'aksrt'); ?>">
-			<button type="button" class="btn-primary btn-sm aksrt-invite-copy" data-invite-copy>
-				<i class="fas fa-copy" aria-hidden="true"></i>
-				<span><?php esc_html_e('复制链接', 'aksrt'); ?></span>
-			</button>
-		</div>
-		<div class="aksrt-invite-stats" data-invite-stats>
-			<div class="aksrt-invite-stat">
-				<span><?php esc_html_e('已注册', 'aksrt'); ?></span>
-				<strong data-stat="registered">0</strong>
-				<small><?php esc_html_e('通过链接完成注册', 'aksrt'); ?></small>
-			</div>
-			<div class="aksrt-invite-stat">
-				<span><?php esc_html_e('已验证', 'aksrt'); ?></span>
-				<strong data-stat="verified">0</strong>
-				<small><?php esc_html_e('完成邮箱验证', 'aksrt'); ?></small>
-			</div>
-			<div class="aksrt-invite-stat">
-				<span><?php esc_html_e('已奖励', 'aksrt'); ?></span>
-				<strong data-stat="rewarded">0</strong>
-				<small><?php esc_html_e('奖励已发放', 'aksrt'); ?></small>
-			</div>
-		</div>
-		<div class="aksrt-invite-records">
-			<div class="aksrt-invite-records__header">
-				<h4><?php esc_html_e('邀请记录', 'aksrt'); ?></h4>
-				<span data-invite-total><?php esc_html_e('加载中', 'aksrt'); ?></span>
-			</div>
-			<div class="aksrt-invite-record-list is-loading" data-invite-list>
-				<div class="aksrt-invite-record-empty">
-					<?php esc_html_e('正在加载邀请记录...', 'aksrt'); ?>
-				</div>
-			</div>
-		</div>
-	</div>
-</div>

inc/helpers/user-center-renderers/sidebar-creator.php

@@ -1,6 +1,6 @@
 <?php
 /**
- * User center sidebar: creation and promotion center pair.
+ * User center sidebar: creation and revenue center pair.
  *
  * @package AKSRT
  */
@@ -11,9 +11,9 @@ $creation_url = (string) ($new_post_url ?? '');
 if ($creation_url === '') {
 	$creation_url = isset($dashboard_tabs['posts']) ? aksrt_get_user_center_tab_url('posts') : '';
 }
-$promotion_url = (string) ($revenue_url ?? '');
+$revenue_url = (string) ($revenue_url ?? '');
 
-if ($creation_url === '' && $promotion_url === '') {
+if ($creation_url === '' && $revenue_url === '') {
 	return;
 }
 ?>
@@ -25,10 +25,10 @@ if ($creation_url === '' && $promotion_url === '') {
 			<i class="fas fa-angle-right" aria-hidden="true"></i>
 		</a>
 	<?php endif; ?>
-	<?php if ($promotion_url !== '') : ?>
+	<?php if ($revenue_url !== '') : ?>
-		<a class="uc-center-card uc-center-card--promotion" href="<?php echo esc_url($promotion_url); ?>">
+		<a class="uc-center-card uc-center-card--promotion" href="<?php echo esc_url($revenue_url); ?>">
-			<span class="uc-center-card__icon"><i class="fas fa-bullhorn" aria-hidden="true"></i></span>
+			<span class="uc-center-card__icon"><i class="fas fa-chart-line" aria-hidden="true"></i></span>
-			<span><strong><?php esc_html_e('推广中心', 'aksrt'); ?></strong><small><?php esc_html_e('返佣与收益', 'aksrt'); ?></small></span>
+			<span><strong><?php esc_html_e('收益中心', 'aksrt'); ?></strong><small><?php esc_html_e('返佣与收益', 'aksrt'); ?></small></span>
 			<i class="fas fa-angle-right" aria-hidden="true"></i>
 		</a>
 	<?php endif; ?>

inc/helpers/user-center-renderers/sidebar-nav.php

@@ -11,6 +11,7 @@ $level_url = isset($dashboard_tabs['level'])
 	? aksrt_get_user_center_tab_url('level')
 	: '';
 $auth_url = isset($dashboard_tabs['auth']) ? aksrt_get_user_center_tab_url('auth') : '';
+$promotion_url = isset($dashboard_tabs['promotion']) ? aksrt_get_user_center_tab_url('promotion') : '';
 $orders_available = isset($dashboard_tabs['orders']);
 $orders_url = $orders_available ? (string) ($orders_url ?? '') : '';
 
@@ -28,6 +29,13 @@ $services = array_values(array_filter([
 		'url'   => $auth_url,
 		'tab'   => 'auth',
 	],
+	[
+		'label' => __('推广中心', 'aksrt'),
+		'icon'  => 'user-plus',
+		'tone'  => 'promotion',
+		'url'   => $promotion_url,
+		'tab'   => 'promotion',
+	],
 	[
 		'label' => __('我的订单', 'aksrt'),
 		'icon'  => 'receipt',

inc/modules/user-parts/urls.php

@@ -32,7 +32,7 @@ function aksrt_get_user_center_url(string $tab = ''): string {
             'assets' => 'credits',
             'vip'    => 'vip', // dedicated vip tab when registered; resolver falls back if missing
             'signin' => 'credits',
-            'invite' => 'settings',
+            'invite' => 'promotion',
         ];
         if (isset($aliases[$tab])) {
             $tab = $aliases[$tab];

src/Admin/Schema/SchemaUsers.php

@@ -526,7 +526,7 @@ class SchemaUsers {
                     'option_key' => 'aksrt_settings',
                     'groups'     => [
                         ['key' => 'center', 'title' => '用户中心', 'fields' => [
-                            ['key' => 'user_center_tabs', 'label' => '用户中心 Tab', 'type' => 'input', 'default' => 'profile,level,posts,comments,favorites,vip,credits,auth', 'help' => '逗号分隔。level=我的等级；auth=官方认证；等级、VIP、订单和认证会按功能开关自动注入'],
+                            ['key' => 'user_center_tabs', 'label' => '用户中心 Tab', 'type' => 'input', 'default' => 'profile,level,posts,comments,favorites,vip,credits,promotion,auth', 'help' => '逗号分隔。level=我的等级；promotion=推广中心；auth=官方认证；等级、VIP、订单、推广中心和认证会按功能开关自动注入'],
                             ['key' => 'user_cover_upload', 'label' => '封面上传', 'type' => 'switch', 'default' => true],
                             ['key' => 'user_social_links', 'label' => '社交链接', 'type' => 'switch', 'default' => true],
                             ['key' => 'user_desc_std', 'label' => '默认签名', 'type' => 'input', 'default' => '这家伙很懒…', 'desc' => '用户未设置个人简介时显示的默认文案'],

src/Settings/UserRuntime.php

@@ -83,14 +83,14 @@ class UserRuntime {
      */
     public static function get_user_center_settings(): array {
         $settings = Settings::get_all();
-        $raw_tabs = $settings['user_center_tabs'] ?? 'profile,level,posts,comments,credits,favorites,auth';
+        $raw_tabs = $settings['user_center_tabs'] ?? 'profile,level,posts,comments,credits,promotion,favorites,auth';
         $tabs = is_array($raw_tabs)
             ? $raw_tabs
             : preg_split('/[\s,]+/', (string) $raw_tabs, -1, PREG_SPLIT_NO_EMPTY);
 
         // Built-in switchable panels. VIP is always auto-injected when enabled
         // by AKSRT\User\Center — keep it allowed for explicit config too.
-        $allowed_tabs = ['profile', 'level', 'posts', 'comments', 'favorites', 'credits', 'vip', 'orders', 'auth', 'settings'];
+        $allowed_tabs = ['profile', 'level', 'posts', 'comments', 'favorites', 'credits', 'promotion', 'vip', 'orders', 'auth', 'settings'];
         $normalized_tabs = ['profile'];
 
         foreach ((array) $tabs as $tab) {

src/User/Center.php

@@ -91,6 +91,12 @@ class Center {
                 'priority' => 50,
                 'type'     => 'panel',
             ],
+            'promotion' => [
+                'label'    => __('推广中心', 'aksrt'),
+                'icon'     => 'user-plus',
+                'priority' => 55,
+                'type'     => 'panel',
+            ],
             'notif' => [
                 'label'    => __('消息通知', 'aksrt'),
                 'icon'     => 'bell',
@@ -121,6 +127,10 @@ class Center {
             && !empty(\AKSRT\User\Level::settings()['enabled']);
         $credits_on = class_exists('\AKSRT\Settings\Settings') && \AKSRT\Settings\Settings::credits_enabled();
         $balance_on = class_exists('\AKSRT\Credits\Balance') && \AKSRT\Credits\Balance::enabled();
+        $promotion_on = $credits_on
+            && class_exists('\AKSRT\Settings\Settings')
+            && \AKSRT\Settings\Settings::invite_enabled()
+            && \AKSRT\Settings\Settings::invite_registration_enabled();
         $vip_on = class_exists('\AKSRT\Settings\Settings')
             && !empty(\AKSRT\Settings\Settings::get_payment_vip_settings()['enabled']);
 
@@ -167,6 +177,17 @@ class Center {
         if (($credits_on || $balance_on) && !in_array('credits', $order, true)) {
             $order[] = 'credits';
         }
+        if ($promotion_on && !in_array('promotion', $order, true)) {
+            $insert_at = count($order);
+            foreach (['credits', 'favorites', 'posts'] as $anchor) {
+                $idx = array_search($anchor, $order, true);
+                if ($idx !== false) {
+                    $insert_at = (int) $idx + 1;
+                    break;
+                }
+            }
+            array_splice($order, $insert_at, 0, ['promotion']);
+        }
         $auth_on = class_exists('\AKSRT\User\AuthApply')
             && !empty(\AKSRT\User\AuthApply::settings()['enabled']);
         if ($auth_on && !in_array('auth', $order, true)) {
@@ -186,6 +207,9 @@ class Center {
             if ($key === 'credits' && !$credits_on && !$balance_on) {
                 continue;
             }
+            if ($key === 'promotion' && !$promotion_on) {
+                continue;
+            }
             if ($key === 'vip' && !$vip_on) {
                 continue;
             }