kate522/wordpress-theme-aksrt
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

feat(users): level integral XP schema + AKSRT_User_Level runtime

Browse Source 
Rewrite /users/level to Zibll-like user_level_s/max/opt and
user_integral_opt. Runtime grants XP with day_max, resolves level,
hooks login/register/post/comment/like/favorite/follow. Profile
signals read integral-backed levels. audit errors=0.
This commit is contained in:
kate522
2026-07-17 01:05:39 +08:00
parent e80d8ea45d
commit 1b0eed6ef7
8 changed files with 658 additions and 141 deletions
Download Patch File Download Diff File Expand all files Collapse all files
inc/classes/admin/schema/class-aksrt-admin-schema-users.php
+13 -23
View File
@@ -604,37 +604,27 @@ class AKSRT_Admin_Schema_Users {
'level' => [
'key' => 'level',
'title' => '用户等级',
'version' => '1.0.0',
'version' => '2.0.0',
'option_key' => 'aksrt_settings',
'groups' => [
['key' => 'display', 'title' => '等级显示', 'fields' => [
['key' => 'user_level_enabled', 'label' => '启用等级系统', 'type' => 'switch', 'default' => false],
['key' => 'user_level_s', 'label' => '启用用户等级', 'type' => 'switch', 'default' => true],
['key' => 'user_level_enabled', 'label' => '启用等级系统(别名)', 'type' => 'switch', 'default' => true, 'help' => '与 user_level_s 同步写入'],
['key' => 'user_level_public_display', 'label' => '公开页显示等级', 'type' => 'switch', 'default' => true],
['key' => 'user_level_prefix', 'label' => '等级前缀', 'type' => 'input', 'default' => 'Lv.'],
['key' => 'user_level_color', 'label' => '等级颜色', 'type' => 'color', 'default' => '#f04494'],
['key' => 'user_level_icon', 'label' => '等级图标', 'type' => 'icon', 'default' => 'fas fa-star'],
]],
['key' => 'rules', 'title' => '等级规则', 'fields' => [
['key' => 'user_level_source', 'label' => '等级来源', 'type' => 'radio', 'default' => 'credits_balance'],
['key' => 'user_level_thresholds', 'label' => '等级阈值', 'type' => 'textarea', 'default' => "1|0\n2|30\n3|100\n4|300"],
['key' => 'user_level_max', 'label' => '最高等级', 'type' => 'number', 'default' => 10, 'min' => 1, 'max' => 99],
['key' => 'user_level_decay', 'label' => '等级衰减', 'type' => 'switch', 'default' => false, 'help' => '长期不活跃自动降级'],
['key' => 'user_level_decay_days', 'label' => '衰减周期(天)', 'type' => 'number', 'default' => 90, 'min' => 7, 'max' => 365],
]],
['key' => 'privilege', 'title' => '等级特权', 'fields' => [
['key' => 'user_level_download_limit', 'label' => '下载限制加成', 'type' => 'switch', 'default' => false, 'help' => '高等级用户每日下载次数增加'],
['key' => 'user_level_upload_limit', 'label' => '上传限制加成', 'type' => 'switch', 'default' => false, 'help' => '高等级用户可上传更大文件'],
['key' => 'user_level_comment_cooldown', 'label' => '评论冷却缩短', 'type' => 'switch', 'default' => false, 'help' => '高等级用户评论间隔更短'],
['key' => 'user_level_custom_title', 'label' => '自定义头衔', 'type' => 'switch', 'default' => false, 'help' => '允许高等级用户自定义头衔'],
]],
['key' => 'notify', 'title' => '升级通知', 'fields' => [
['key' => 'user_level_max', 'label' => '最高等级', 'type' => 'number', 'default' => 10, 'min' => 3, 'max' => 30],
['key' => 'user_level_notify', 'label' => '升级通知', 'type' => 'switch', 'default' => true],
['key' => 'user_level_notify_style', 'label' => '通知方式', 'type' => 'select', 'default' => 'toast', 'options' => [
['label' => '弹窗提示', 'value' => 'toast'],
['label' => '站内信', 'value' => 'message'],
['label' => '两者都有', 'value' => 'both'],
['key' => 'user_level_source', 'label' => '等级来源', 'type' => 'radio', 'default' => 'integral', 'options' => [
['label' => '经验值', 'value' => 'integral'],
['label' => '手动 Meta', 'value' => 'manual_meta'],
]],
]],
['key' => 'level_opt', 'title' => '升级阈值', 'fields' => [
['key' => 'user_level_opt', 'label' => '等级参数', 'type' => 'json', 'default' => [], 'help' => 'upgrade_integral_N / name_N'],
]],
['key' => 'integral', 'title' => '经验值得分', 'fields' => [
['key' => 'user_integral_opt', 'label' => '经验值配置', 'type' => 'json', 'default' => [], 'help' => 'day_max + 行为得分键'],
]],
],
],
'badge' => [
inc/classes/class-aksrt-user-home.php
+7 -5
View File
@@ -279,22 +279,24 @@ class AKSRT_User_Home {
}
/**
* @param array{source:string,thresholds:array<int,int>} $level_settings
* @param array{source?:string,thresholds?:array<int,int>} $level_settings
*/
private function get_user_level(int $user_id, array $level_settings): int {
if (($level_settings['source'] ?? 'credits_balance') === 'manual_meta') {
$source = (string) ($level_settings['source'] ?? 'integral');
if ($source === 'manual_meta') {
return max(0, (int) get_user_meta($user_id, 'aksrt_user_level', true));
}
if (class_exists('AKSRT_User_Level')) {
return AKSRT_User_Level::get_level($user_id);
}
// Fallback: credits_balance thresholds (legacy) if integral class missing.
$score = function_exists('aksrt_user_credits') ? (int) aksrt_user_credits($user_id) : 0;
$level = 0;
foreach ((array) ($level_settings['thresholds'] ?? []) as $candidate => $threshold) {
if ($score >= (int) $threshold) {
$level = (int) $candidate;
}
}
return $level;
}
inc/classes/class-aksrt-user-level.php
+379
View File
@@ -0,0 +1,379 @@
<?php
/**
* User level + integral XP — Zibll user_level / user_integral parity.
*
* Meta:
* aksrt_level_integral int total XP
* aksrt_user_level int resolved level
* aksrt_level_integral_detail array reason => [value, integral]
* aksrt_level_integral_date_detail array Y-m-d => int
*
* @package AKSRT
*/
defined('ABSPATH') || exit;
class AKSRT_User_Level {
public const META_INTEGRAL = 'aksrt_level_integral';
public const META_LEVEL = 'aksrt_user_level';
public const META_DETAIL = 'aksrt_level_integral_detail';
public const META_DATE_DETAIL = 'aksrt_level_integral_date_detail';
public const META_TODAY_FOLLOW = 'aksrt_level_integral_followed';
/** @var self|null */
private static $instance = null;
public static function get_instance(): self {
if (null === self::$instance) {
self::$instance = new self();
}
return self::$instance;
}
public function init(): void {
add_action('user_register', [$this, 'on_register'], 20, 1);
add_action('wp_login', [$this, 'on_login'], 20, 2);
add_action('aksrt_user_signed_in', [$this, 'on_sign_in'], 20, 1);
add_action('publish_post', [$this, 'on_publish_post'], 20, 2);
add_action('comment_post', [$this, 'on_comment_post'], 20, 3);
add_action('aksrt_user_followed', [$this, 'on_followed'], 20, 2);
add_action('aksrt_post_liked', [$this, 'on_post_like'], 20, 2);
add_action('aksrt_comment_liked', [$this, 'on_comment_like'], 20, 2);
add_action('aksrt_post_favorited', [$this, 'on_post_favorite'], 20, 2);
}
/**
* @return array{enabled:bool,public_display:bool,prefix:string,max:int,source:string,level_opt:array<string,mixed>,integral_opt:array<string,mixed>,notify:bool}
*/
public static function settings(): array {
$all = class_exists('AKSRT_Settings') ? AKSRT_Settings::get_all() : [];
$enabled = !empty($all['user_level_s']) || !empty($all['user_level_enabled']);
$max = max(3, min(30, (int) ($all['user_level_max'] ?? 10)));
$source = (string) ($all['user_level_source'] ?? 'integral');
if (!in_array($source, ['integral', 'manual_meta'], true)) {
$source = 'integral';
}
$level_opt = $all['user_level_opt'] ?? [];
if (is_string($level_opt)) {
$decoded = json_decode($level_opt, true);
$level_opt = is_array($decoded) ? $decoded : [];
}
if (!is_array($level_opt)) {
$level_opt = [];
}
$integral_opt = $all['user_integral_opt'] ?? [];
if (is_string($integral_opt)) {
$decoded = json_decode($integral_opt, true);
$integral_opt = is_array($decoded) ? $decoded : [];
}
if (!is_array($integral_opt)) {
$integral_opt = [];
}
$prefix = trim((string) ($all['user_level_prefix'] ?? 'Lv.'));
return [
'enabled' => $enabled,
'public_display' => !isset($all['user_level_public_display']) || !empty($all['user_level_public_display']),
'prefix' => $prefix !== '' ? $prefix : 'Lv.',
'max' => $max,
'source' => $source,
'level_opt' => $level_opt,
'integral_opt' => $integral_opt,
'notify' => !isset($all['user_level_notify']) || !empty($all['user_level_notify']),
];
}
/**
* Catalog of integral earn keys (defaults).
*
* @return array<string,int>
*/
public static function integral_defaults(): array {
return [
'day_max' => 100,
'sign_up' => 20,
'sign_in' => 5,
'followed' => 5,
'post_new' => 5,
'post_like' => 1,
'post_favorite' => 2,
'comment_new' => 2,
'comment_like' => 1,
'bbs_posts_new' => 3,
'bbs_score_extra' => 1,
'bbs_essence' => 2,
'bbs_posts_hot' => 2,
'bbs_plate_new' => 2,
'bbs_plate_hot' => 2,
'bbs_adopt' => 2,
'bbs_comment_hot' => 2,
];
}
public static function task_points(string $key): int {
$cfg = self::settings();
$opt = $cfg['integral_opt'];
$def = self::integral_defaults();
if (array_key_exists($key, $opt)) {
return max(0, (int) $opt[$key]);
}
return max(0, (int) ($def[$key] ?? 0));
}
public static function day_max(): int {
$cfg = self::settings();
$opt = $cfg['integral_opt'];
if (array_key_exists('day_max', $opt)) {
return max(0, (int) $opt['day_max']);
}
return 100;
}
public static function get_integral(int $user_id): int {
if ($user_id <= 0) {
return 0;
}
return max(0, (int) get_user_meta($user_id, self::META_INTEGRAL, true));
}
public static function get_level(int $user_id): int {
if ($user_id <= 0) {
return 0;
}
$cfg = self::settings();
if (!$cfg['enabled']) {
return 0;
}
if ($cfg['source'] === 'manual_meta') {
return max(0, (int) get_user_meta($user_id, self::META_LEVEL, true));
}
return self::resolve_level(self::get_integral($user_id), $cfg);
}
/**
* @param array{max:int,level_opt:array} $cfg
*/
public static function resolve_level(int $integral, ?array $cfg = null): int {
$cfg = $cfg ?? self::settings();
$max = (int) $cfg['max'];
$opt = $cfg['level_opt'];
$level = 1;
for ($i = 1; $i <= $max; $i++) {
$need = (int) ($opt['upgrade_integral_' . $i] ?? ($i === 1 ? 0 : PHP_INT_MAX));
if ($integral >= $need) {
$level = $i;
} else {
break;
}
}
return max(0, min($max, $level));
}
/**
* Grant integral for a task key. Respects day_max.
*
* @return int|false points granted or false
*/
public static function add(int $user_id, string $key, int $points = 0) {
if ($user_id <= 0) {
return false;
}
$cfg = self::settings();
if (!$cfg['enabled'] || $cfg['source'] !== 'integral') {
return false;
}
$key = sanitize_key($key);
if ($key === '' || $key === 'day_max') {
return false;
}
if ($points <= 0) {
$points = self::task_points($key);
}
if ($points <= 0) {
return false;
}
$day_max = self::day_max();
$today = gmdate('Y-m-d', current_time('timestamp'));
$date_detail = get_user_meta($user_id, self::META_DATE_DETAIL, true);
$date_detail = is_array($date_detail) ? $date_detail : [];
$today_sum = max(0, (int) ($date_detail[$today] ?? 0));
if ($day_max > 0 && $today_sum >= $day_max) {
return false;
}
if ($day_max > 0) {
$points = min($points, $day_max - $today_sum);
}
if ($points <= 0) {
return false;
}
$before = self::get_integral($user_id);
$after = $before + $points;
update_user_meta($user_id, self::META_INTEGRAL, $after);
$date_detail[$today] = $today_sum + $points;
// Keep last 90 days.
if (count($date_detail) > 90) {
krsort($date_detail);
$date_detail = array_slice($date_detail, 0, 90, true);
}
update_user_meta($user_id, self::META_DATE_DETAIL, $date_detail);
$detail = get_user_meta($user_id, self::META_DETAIL, true);
$detail = is_array($detail) ? $detail : [];
$prev = is_array($detail[$key] ?? null) ? $detail[$key] : ['value' => 0, 'integral' => 0];
$detail[$key] = [
'value' => (int) ($prev['value'] ?? 0) + $points,
'integral' => (int) ($prev['integral'] ?? 0) + $points,
];
update_user_meta($user_id, self::META_DETAIL, $detail);
$old_level = (int) get_user_meta($user_id, self::META_LEVEL, true);
$new_level = self::resolve_level($after, $cfg);
if ($new_level !== $old_level) {
update_user_meta($user_id, self::META_LEVEL, $new_level);
/**
* @param int $user_id
* @param int $new_level
* @param int $old_level
*/
do_action('aksrt_user_level_changed', $user_id, $new_level, $old_level);
} else {
update_user_meta($user_id, self::META_LEVEL, $new_level);
}
return $points;
}
public function on_register(int $user_id): void {
self::add($user_id, 'sign_up');
}
/**
* @param string $user_login
* @param WP_User $user
*/
public function on_login($user_login, $user): void {
$user_id = $user instanceof WP_User ? (int) $user->ID : 0;
if ($user_id <= 0) {
return;
}
// Once per calendar day for login XP.
$today = gmdate('Y-m-d', current_time('timestamp'));
$flag = (string) get_user_meta($user_id, '_aksrt_integral_sign_in_day', true);
if ($flag === $today) {
return;
}
$granted = self::add($user_id, 'sign_in');
if ($granted) {
update_user_meta($user_id, '_aksrt_integral_sign_in_day', $today);
}
}
public function on_sign_in(int $user_id): void {
// Dedicated check-in hook can also grant if separate from login; reuse sign_in key once/day.
$this->on_login('', get_userdata($user_id) ?: new WP_User($user_id));
}
/**
* @param int $post_id
* @param WP_Post $post
*/
public function on_publish_post($post_id, $post): void {
if (!$post instanceof WP_Post || $post->post_type !== 'post' || $post->post_status !== 'publish') {
return;
}
// Only when transitioning to publish first time.
if ((string) get_post_meta($post_id, '_aksrt_integral_post_new', true) === '1') {
return;
}
$author = (int) $post->post_author;
if ($author <= 0) {
return;
}
if (self::add($author, 'post_new')) {
update_post_meta($post_id, '_aksrt_integral_post_new', '1');
}
}
/**
* @param int $comment_id
* @param int|string $approved
* @param array $commentdata
*/
public function on_comment_post($comment_id, $approved, $commentdata): void {
if ((string) $approved !== '1' && $approved !== 1) {
return;
}
$user_id = (int) ($commentdata['user_id'] ?? 0);
if ($user_id <= 0) {
$user_id = (int) get_comment($comment_id)->user_id;
}
if ($user_id <= 0) {
return;
}
self::add($user_id, 'comment_new');
}
/**
* @param int $follower_id
* @param int $followed_id
*/
public function on_followed($follower_id, $followed_id): void {
$followed_id = (int) $followed_id;
if ($followed_id <= 0) {
return;
}
self::add($followed_id, 'followed');
}
/**
* @param int $post_id
* @param int $user_id liker
*/
public function on_post_like($post_id, $user_id): void {
$post = get_post((int) $post_id);
if (!$post instanceof WP_Post) {
return;
}
$author = (int) $post->post_author;
if ($author <= 0 || $author === (int) $user_id) {
return;
}
self::add($author, 'post_like');
}
/**
* @param int $comment_id
* @param int $user_id
*/
public function on_comment_like($comment_id, $user_id): void {
$c = get_comment((int) $comment_id);
if (!$c) {
return;
}
$author = (int) $c->user_id;
if ($author <= 0 || $author === (int) $user_id) {
return;
}
self::add($author, 'comment_like');
}
/**
* @param int $post_id
* @param int $user_id
*/
public function on_post_favorite($post_id, $user_id): void {
$post = get_post((int) $post_id);
if (!$post instanceof WP_Post) {
return;
}
$author = (int) $post->post_author;
if ($author <= 0 || $author === (int) $user_id) {
return;
}
self::add($author, 'post_favorite');
}
}
inc/classes/settings/class-aksrt-settings-user-runtime.php
+3 -2
View File
@@ -149,11 +149,12 @@ class AKSRT_Settings_User_Runtime {
'enabled' => !empty($settings['user_level_enabled']) || !empty($settings['user_level_s']),
'public_display' => !isset($settings['user_level_public_display']) || !empty($settings['user_level_public_display']),
'source' => (static function () use ($settings) {
$v = $settings['user_level_source'] ?? 'credits_balance';
return in_array($v, ['credits_balance', 'manual_meta', 'integral'], true) ? $v : 'credits_balance';
$v = $settings['user_level_source'] ?? 'integral';
return in_array($v, ['credits_balance', 'manual_meta', 'integral'], true) ? $v : 'integral';
})(),
'label_prefix' => $level_prefix !== '' ? $level_prefix : 'Lv.',
'thresholds' => self::parse_level_thresholds((string) ($settings['user_level_thresholds'] ?? "1|0\n2|30\n3|100\n4|300")),
'max' => max(3, min(30, (int) ($settings['user_level_max'] ?? 10))),
],
'medal' => $medal,
// Alias for existing call sites that still read badge.*; dictionary is derived from medal catalog.