feat(credits): free points tasks matrix, day cap, and tasks tab

Add AKSRT_Points_Free for catalog/day-max/daily detail, wire the full
earn matrix (login, post, like, favorite, follow, comment, forum),
expose 积分任务 + 每日详情 tabs, and expand admin free-task settings.
This commit is contained in:
kate522 committed 2026-07-16 16:29:15 +08:00
1 parent 4da003663d
commit 15a883eb54
13 files changed
+728 -232

No files matched your search

@@ -414,13 +414,21 @@ class AKSRT_Admin_Schema_Users {
['key' => 'points_name', 'label' => '积分名称', 'type' => 'input', 'default' => '积分'],
['key' => 'points_decimal', 'label' => '积分小数位数', 'type' => 'number', 'default' => 2, 'min' => 0, 'max' => 4],
]],
['key' => 'earn', 'title' => '积分获取', 'fields' => [
['key' => 'points_earn_comment', 'label' => '评论奖励', 'type' => 'number', 'default' => 1, 'min' => 0, 'max' => 100],
['key' => 'points_earn_post', 'label' => '发布文章奖励', 'type' => 'number', 'default' => 5, 'min' => 0, 'max' => 100],
['key' => 'points_earn_login', 'label' => '每日登录奖励', 'type' => 'number', 'default' => 1, 'min' => 0, 'max' => 100],
['key' => 'points_earn_like_received', 'label' => '收到点赞奖励', 'type' => 'number', 'default' => 1, 'min' => 0, 'max' => 100],
['key' => 'points_earn_invite', 'label' => '邀请注册奖励', 'type' => 'number', 'default' => 10, 'min' => 0, 'max' => 1000],
['key' => 'points_earn_daily_limit', 'label' => '每日获取上限', 'type' => 'number', 'default' => 50, 'min' => 0, 'max' => 9999, 'help' => '0为不限制'],
['key' => 'earn', 'title' => '积分获取 / 任务', 'fields' => [
['key' => 'points_earn_daily_limit', 'label' => '每日免费积分上限', 'type' => 'number', 'default' => 50, 'min' => 0, 'max' => 9999, 'help' => '0为不限制;免费任务合计'],
['key' => 'points_free_sign_up', 'label' => '注册奖励', 'type' => 'number', 'default' => 10, 'min' => 0, 'max' => 10000],
['key' => 'points_free_sign_in', 'label' => '签到展示分值', 'type' => 'number', 'default' => 1, 'min' => 0, 'max' => 1000],
['key' => 'points_free_login', 'label' => '每日登录', 'type' => 'number', 'default' => 1, 'min' => 0, 'max' => 100],
['key' => 'points_free_post_new', 'label' => '发布文章', 'type' => 'number', 'default' => 5, 'min' => 0, 'max' => 1000],
['key' => 'points_free_post_like', 'label' => '文章被赞', 'type' => 'number', 'default' => 1, 'min' => 0, 'max' => 100],
['key' => 'points_free_post_favorite', 'label' => '文章被收藏', 'type' => 'number', 'default' => 1, 'min' => 0, 'max' => 100],
['key' => 'points_free_comment_new', 'label' => '发表评论', 'type' => 'number', 'default' => 1, 'min' => 0, 'max' => 100],
['key' => 'points_free_comment_like', 'label' => '评论被赞', 'type' => 'number', 'default' => 1, 'min' => 0, 'max' => 100],
['key' => 'points_free_followed', 'label' => '被关注', 'type' => 'number', 'default' => 1, 'min' => 0, 'max' => 100],
['key' => 'points_free_bbs_posts_new', 'label' => '论坛发帖', 'type' => 'number', 'default' => 5, 'min' => 0, 'max' => 1000],
['key' => 'points_free_bbs_reply', 'label' => '论坛回复', 'type' => 'number', 'default' => 2, 'min' => 0, 'max' => 1000],
['key' => 'points_free_bbs_essence', 'label' => '帖子加精', 'type' => 'number', 'default' => 10, 'min' => 0, 'max' => 1000],
['key' => 'points_earn_invite', 'label' => '邀请注册奖励', 'type' => 'number', 'default' => 10, 'min' => 0, 'max' => 1000, 'help' => '邀请奖励不走免费日上限'],
]],
['key' => 'spend', 'title' => '积分消费', 'fields' => [
['key' => 'points_spend_comment', 'label' => '评论消耗', 'type' => 'number', 'default' => 0, 'min' => 0, 'max' => 100],
@@ -526,6 +526,9 @@ class AKSRT_Comment_Actions {
if ($target !== $current) {
aksrt_set_comment_like_state($comment_id, $target);
$count = aksrt_update_comment_counter($comment_id, 'aksrt_comment_likes', $target ? 1 : -1);
if (is_user_logged_in()) {
do_action('aksrt_comment_liked', $comment_id, get_current_user_id(), (bool) $target);
}
} else {
$count = aksrt_get_comment_likes($comment_id);
}
+225 -199
View File
@@ -1,13 +1,6 @@
<?php
/**
* AKSRT Credits Earn
*
* 积分获取入口,挂载到 WordPress 钩子:
* - 注册赠送 → user_register
* - 评论奖励 → wp_insert_comment / transition_comment_status
* - 签到/邀请 → 由 AKSRT_Signin / AKSRT_Invite 独立处理(REST)
*
* 所有发放都受 aksrt_credit_settings.* 子开关控制,关闭后不发放。
* AKSRT Credits Earn — free-task matrix hooks via AKSRT_Points_Free.
*
* @package AKSRT
*/
@@ -16,214 +9,247 @@ defined('ABSPATH') || exit;
class AKSRT_Credits_Earn {
private static $instance = null;
private static $instance = null;
private function __construct() {}
private function __construct() {}
public static function get_instance(): self {
if (null === self::$instance) self::$instance = new self();
return self::$instance;
}
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_user_register'], 10, 1);
public function init(): void {
add_action('user_register', [$this, 'on_user_register'], 10, 1);
add_action('wp_login', [$this, 'on_wp_login'], 20, 2);
// 评论奖励:on_approved 时机决定挂到哪个钩子
// 默认 on_approved=true → 仅审核通过后发;否则插入即发
add_action('wp_insert_comment', [$this, 'on_comment_inserted'], 10, 2);
add_action('transition_comment_status', [$this, 'on_comment_transition'], 10, 3);
add_action('wp_insert_comment', [$this, 'on_comment_inserted'], 10, 2);
add_action('transition_comment_status', [$this, 'on_comment_transition'], 10, 3);
add_action('transition_post_status', [$this, 'on_post_status'], 10, 3);
// 论坛发帖奖励
add_action('aksrt_forum_topic_created', [$this, 'on_forum_topic_created'], 10, 2);
add_action('aksrt_post_liked', [$this, 'on_post_liked'], 10, 3);
add_action('aksrt_post_favorited', [$this, 'on_post_favorited'], 10, 3);
add_action('aksrt_comment_liked', [$this, 'on_comment_liked'], 10, 3);
add_action('aksrt_user_followed', [$this, 'on_user_followed'], 10, 2);
// 论坛回复奖励(§7.7)
add_action('comment_post', [$this, 'on_forum_reply_posted'], 20, 3);
add_action('aksrt_forum_topic_created', [$this, 'on_forum_topic_created'], 10, 2);
add_action('comment_post', [$this, 'on_forum_reply_posted'], 20, 3);
add_action('aksrt_forum_topic_featured', [$this, 'on_forum_topic_featured'], 10, 2);
}
// 论坛精华/热帖奖励(§7.7)
add_action('aksrt_forum_topic_featured', [$this, 'on_forum_topic_featured'], 10, 2);
}
public function on_user_register(int $user_id): void {
if (!class_exists('AKSRT_Points_Free')) {
return;
}
AKSRT_Points_Free::grant($user_id, 'sign_up', 0, ['type' => 'user', 'id' => $user_id]);
}
/**
* 论坛发帖积分奖励
*/
public function on_forum_topic_created(int $user_id, int $post_id): void {
if (!class_exists('AKSRT_Credits') || !class_exists('AKSRT_Settings')) return;
$cfg = AKSRT_Settings::get_credit_settings();
if (empty($cfg['enabled'])) return;
$reward = $cfg['forum_topic_reward'] ?? [];
if (empty($reward['enabled'])) return;
/**
* Daily first login free points.
*
* @param string $user_login
* @param WP_User $user
*/
public function on_wp_login($user_login, $user = null): void {
unset($user_login);
$user_id = $user instanceof WP_User ? (int) $user->ID : 0;
if ($user_id <= 0 || !class_exists('AKSRT_Points_Free')) {
return;
}
$today = (new DateTimeImmutable('today', wp_timezone()))->format('Y-m-d');
$last = (string) get_user_meta($user_id, AKSRT_Points_Free::META_LOGIN, true);
if ($last === $today) {
return;
}
$granted = AKSRT_Points_Free::grant($user_id, 'login', 0, ['type' => 'user', 'id' => $user_id]);
if (!is_wp_error($granted) && $granted >= 0) {
update_user_meta($user_id, AKSRT_Points_Free::META_LOGIN, $today);
}
}
$amount = (int) ($reward['amount'] ?? 0);
if ($amount <= 0) return;
/**
* @param string $new_status
* @param string $old_status
* @param WP_Post $post
*/
public function on_post_status($new_status, $old_status, $post): void {
if (!($post instanceof WP_Post) || $post->post_type !== 'post') {
return;
}
if ($new_status !== 'publish' || $old_status === 'publish') {
return;
}
$user_id = (int) $post->post_author;
if ($user_id <= 0 || !class_exists('AKSRT_Points_Free')) {
return;
}
if (get_post_meta($post->ID, 'aksrt_credit_post_rewarded', true)) {
return;
}
$granted = AKSRT_Points_Free::grant($user_id, 'post_new', 0, ['type' => 'post', 'id' => (int) $post->ID]);
if (!is_wp_error($granted) && $granted > 0) {
update_post_meta($post->ID, 'aksrt_credit_post_rewarded', 1);
}
}
$daily_limit = (int) ($reward['daily_limit'] ?? 5);
$today_count = $this->today_forum_reward_count($user_id, 'topic');
if ($today_count >= $daily_limit) return;
public function on_comment_inserted(int $comment_id, $comment): void {
$cfg = class_exists('AKSRT_Settings') ? AKSRT_Settings::get_credit_settings() : [];
$reward = is_array($cfg['comment_reward'] ?? null) ? $cfg['comment_reward'] : [];
// Legacy on_approved=true → wait for transition; default true.
$on_approved = !isset($reward['on_approved']) || !empty($reward['on_approved']);
if ($on_approved) {
return;
}
$comment = $comment instanceof WP_Comment ? $comment : get_comment($comment_id);
if (!($comment instanceof WP_Comment) || (int) $comment->comment_approved !== 1) {
return;
}
$this->reward_comment($comment);
}
AKSRT_Credits::add($user_id, $amount, 'forum_topic', ['type' => 'post', 'id' => $post_id]);
}
public function on_comment_transition($new_status, $old_status, $comment): void {
unset($old_status);
if ($new_status !== 'approved' || !($comment instanceof WP_Comment)) {
return;
}
$this->reward_comment($comment);
}
/**
* 今日论坛奖励次数
*/
private function today_forum_reward_count(int $user_id, string $type = 'topic'): int {
global $wpdb;
$table = AKSRT_DB_Migrator::table('credit_log');
if (!$table) return 0;
private function reward_comment(WP_Comment $comment): void {
$user_id = (int) $comment->user_id;
if ($user_id <= 0 || !class_exists('AKSRT_Points_Free')) {
return;
}
if (get_comment_meta($comment->comment_ID, 'aksrt_credit_rewarded', true)) {
return;
}
// Skip forum topic replies (handled separately).
$post = get_post((int) $comment->comment_post_ID);
if ($post && $post->post_type === 'aksrt_forum_topic') {
return;
}
$cfg = class_exists('AKSRT_Settings') ? AKSRT_Settings::get_credit_settings() : [];
$reward = is_array($cfg['comment_reward'] ?? null) ? $cfg['comment_reward'] : [];
$min_length = (int) ($reward['min_length'] ?? 0);
if ($min_length > 0 && mb_strlen(wp_strip_all_tags((string) $comment->comment_content)) < $min_length) {
return;
}
$granted = AKSRT_Points_Free::grant($user_id, 'comment_new', 0, [
'type' => 'comment',
'id' => (int) $comment->comment_ID,
]);
if (!is_wp_error($granted)) {
update_comment_meta($comment->comment_ID, 'aksrt_credit_rewarded', $granted > 0 ? 1 : 'capped');
}
}
$today = current_time('Y-m-d');
return (int) $wpdb->get_var($wpdb->prepare(
"SELECT COUNT(*) FROM {$table} WHERE user_id = %d AND reason = %s AND DATE(created_at) = %s",
$user_id, 'forum_' . $type, $today
));
}
/**
* @param int $post_id
* @param int $actor_id liker
* @param bool $active
*/
public function on_post_liked(int $post_id, int $actor_id, bool $active): void {
if (!$active || $post_id <= 0 || !class_exists('AKSRT_Points_Free')) {
return;
}
$post = get_post($post_id);
if (!$post || $post->post_type !== 'post') {
return;
}
$author = (int) $post->post_author;
if ($author <= 0 || $author === $actor_id) {
return;
}
AKSRT_Points_Free::grant($author, 'post_like', 0, ['type' => 'post', 'id' => $post_id]);
}
/**
* 注册赠送。
*/
public function on_user_register(int $user_id): void {
if (!class_exists('AKSRT_Credits') || !class_exists('AKSRT_Settings')) return;
$cfg = AKSRT_Settings::get_credit_settings();
if (empty($cfg['enabled'])) return;
$bonus = (int) ($cfg['register_bonus'] ?? 0);
if ($bonus <= 0) return;
public function on_post_favorited(int $post_id, int $actor_id, bool $active): void {
if (!$active || $post_id <= 0 || !class_exists('AKSRT_Points_Free')) {
return;
}
$post = get_post($post_id);
if (!$post || $post->post_type !== 'post') {
return;
}
$author = (int) $post->post_author;
if ($author <= 0 || $author === $actor_id) {
return;
}
AKSRT_Points_Free::grant($author, 'post_favorite', 0, ['type' => 'post', 'id' => $post_id]);
}
AKSRT_Credits::add($user_id, $bonus, 'register', ['type' => 'user', 'id' => $user_id]);
}
public function on_comment_liked(int $comment_id, int $actor_id, bool $active): void {
if (!$active || $comment_id <= 0 || !class_exists('AKSRT_Points_Free')) {
return;
}
$comment = get_comment($comment_id);
if (!$comment) {
return;
}
$author = (int) $comment->user_id;
if ($author <= 0 || $author === $actor_id) {
return;
}
AKSRT_Points_Free::grant($author, 'comment_like', 0, ['type' => 'comment', 'id' => $comment_id]);
}
/**
* 评论插入(直接发表无需审核场景)。
*/
public function on_comment_inserted(int $comment_id, $comment): void {
if (!class_exists('AKSRT_Settings')) return;
$cfg = AKSRT_Settings::get_credit_settings();
$reward = $cfg['comment_reward'] ?? [];
if (empty($cfg['enabled']) || empty($reward['enabled'])) return;
public function on_user_followed(int $follower_id, int $following_id): void {
if ($following_id <= 0 || $follower_id === $following_id || !class_exists('AKSRT_Points_Free')) {
return;
}
AKSRT_Points_Free::grant($following_id, 'followed', 0, ['type' => 'user', 'id' => $follower_id]);
}
// 仅审核通过后发放 → 不在 insert 时处理
if (!empty($reward['on_approved'])) return;
public function on_forum_topic_created(int $user_id, int $post_id): void {
if ($user_id <= 0 || !class_exists('AKSRT_Points_Free')) {
return;
}
AKSRT_Points_Free::grant($user_id, 'bbs_posts_new', 0, ['type' => 'post', 'id' => $post_id]);
}
$comment = $comment instanceof WP_Comment ? $comment : get_comment($comment_id);
if (!($comment instanceof WP_Comment)) return;
public function on_forum_reply_posted(int $comment_id, $approved, array $commentdata = []): void {
unset($commentdata);
if ((int) $approved !== 1 && $approved !== '1' && $approved !== true) {
// Still load comment and check.
}
$comment = get_comment($comment_id);
if (!$comment || (int) $comment->comment_approved !== 1) {
return;
}
$post = get_post((int) $comment->comment_post_ID);
if (!$post || $post->post_type !== 'aksrt_forum_topic') {
return;
}
$user_id = (int) $comment->user_id;
if ($user_id <= 0 || !class_exists('AKSRT_Points_Free')) {
return;
}
if (get_comment_meta($comment_id, 'aksrt_credit_forum_reply', true)) {
return;
}
$granted = AKSRT_Points_Free::grant($user_id, 'bbs_reply', 0, ['type' => 'comment', 'id' => $comment_id]);
if (!is_wp_error($granted)) {
update_comment_meta($comment_id, 'aksrt_credit_forum_reply', 1);
}
}
// 只奖励已批准的评论
if ((int) $comment->comment_approved !== 1) return;
$this->maybe_reward_comment($comment, $reward);
}
/**
* 评论状态流转。
*/
public function on_comment_transition($new_status, $old_status, $comment): void {
if (!class_exists('AKSRT_Settings')) return;
$cfg = AKSRT_Settings::get_credit_settings();
$reward = $cfg['comment_reward'] ?? [];
if (empty($cfg['enabled']) || empty($reward['enabled'])) return;
if (empty($reward['on_approved'])) return;
if ($new_status !== 'approved') return;
// 跳过已经处理过的:以 commentmeta 标记
if (!($comment instanceof WP_Comment)) return;
$this->maybe_reward_comment($comment, $reward);
}
/**
* 真正的评论奖励逻辑(含字数 / 每日上限 / 去重)。
*/
private function maybe_reward_comment(WP_Comment $comment, array $reward): void {
$user_id = (int) $comment->user_id;
if ($user_id <= 0) return;
// 防重复:commentmeta 标记
if (get_comment_meta($comment->comment_ID, 'aksrt_credit_rewarded', true)) return;
$min_length = (int) ($reward['min_length'] ?? 0);
if ($min_length > 0 && mb_strlen(strip_tags($comment->comment_content)) < $min_length) return;
$amount = (int) ($reward['amount'] ?? 0);
if ($amount <= 0) return;
// 每日上限
$cap = (int) ($reward['daily_cap'] ?? 0);
if ($cap > 0) {
$today_count = $this->today_comment_reward_count($user_id);
if ($today_count >= $cap) {
update_comment_meta($comment->comment_ID, 'aksrt_credit_rewarded', 'capped');
return;
}
}
$result = AKSRT_Credits::add(
$user_id,
$amount,
'comment',
['type' => 'comment', 'id' => (int) $comment->comment_ID]
);
if (!is_wp_error($result)) {
update_comment_meta($comment->comment_ID, 'aksrt_credit_rewarded', 1);
}
}
/**
* 当日评论奖励次数(查询 credit_log)。
*/
private function today_comment_reward_count(int $user_id): int {
global $wpdb;
if (!class_exists('AKSRT_DB_Migrator')) return 0;
$table = AKSRT_DB_Migrator::table('credit_log');
if (!$table) return 0;
// 站点时区当日 00:00 起
$tz = wp_timezone();
$today = (new DateTimeImmutable('today', $tz))->format('Y-m-d H:i:s');
// 转 UTC(数据库 created_at 用 mysql UTC)
$today_utc = (new DateTimeImmutable('today', $tz))->setTimezone(new DateTimeZone('UTC'))->format('Y-m-d H:i:s');
return (int) $wpdb->get_var($wpdb->prepare(
"SELECT COUNT(*) FROM {$table} WHERE user_id = %d AND reason = 'comment' AND created_at >= %s",
$user_id,
$today_utc
));
}
// ================================================================
// Forum credits (§7.7)
// ================================================================
public function on_forum_reply_posted(int $comment_id, $approved, array $commentdata = []): void {
if (!class_exists('AKSRT_Credits') || !class_exists('AKSRT_Settings')) return;
if (!class_exists('AKSRT_Forum')) return;
$comment = get_comment($comment_id);
if (!$comment) return;
$post = get_post((int) $comment->comment_post_ID);
if (!$post || $post->post_type !== 'aksrt_forum_topic') return;
if ((int) $comment->comment_approved !== 1) return;
$user_id = (int) $comment->user_id;
if ($user_id <= 0) return;
$forum_cfg = AKSRT_Settings::get_forum_settings();
$amount = (int) ($forum_cfg['credits']['comment_new'] ?? 2);
if ($amount <= 0) return;
$daily_max = (int) ($forum_cfg['credits']['daily_max'] ?? 50);
$today_count = $this->today_forum_reward_count($user_id, 'reply');
if ($today_count >= $daily_max) return;
AKSRT_Credits::add($user_id, $amount, 'forum_reply', [
'type' => 'comment',
'id' => $comment_id,
]);
}
public function on_forum_topic_featured(int $topic_id, int $operator_id): void {
// Essence reward is handled in AKSRT_Forum::reward_essence().
// This hook is for additional integrations if needed.
}
public function on_forum_topic_featured(int $topic_id, int $operator_id): void {
unset($operator_id);
$post = get_post($topic_id);
if (!$post || $post->post_type !== 'aksrt_forum_topic') {
return;
}
$user_id = (int) $post->post_author;
if ($user_id <= 0 || !class_exists('AKSRT_Points_Free')) {
return;
}
if (get_post_meta($topic_id, 'aksrt_credit_essence_rewarded', true)) {
return;
}
$granted = AKSRT_Points_Free::grant($user_id, 'bbs_essence', 0, ['type' => 'post', 'id' => $topic_id]);
if (!is_wp_error($granted) && $granted > 0) {
update_post_meta($topic_id, 'aksrt_credit_essence_rewarded', 1);
}
}
}
+5 -1
View File
@@ -47,7 +47,11 @@ class AKSRT_Follow {
'created_at' => current_time('mysql'),
], ['%d', '%d', '%s']);
return $result !== false;
if ($result === false) {
return false;
}
do_action('aksrt_user_followed', $follower_id, $following_id);
return true;
}
/**
+283
View File
@@ -0,0 +1,283 @@
<?php
/**
* Free points tasks — Zibll points_free_opt parity.
*
* Unified grant path with daily free-points cap + per-day detail meta.
*
* @package AKSRT
*/
defined('ABSPATH') || exit;
class AKSRT_Points_Free {
public const META_DETAIL = 'aksrt_free_points_detail';
public const META_LOGIN = 'aksrt_free_points_login_date';
/**
* Task catalog: key => [label, short_desc, default_points]
*
* @return array<string, array{0:string,1:string,2:int}>
*/
public static function catalog(): array {
return [
'sign_up' => [__('注册奖励', 'aksrt'), __('新用户注册成功后发放', 'aksrt'), 10],
'sign_in' => [__('每日签到', 'aksrt'), __('完成每日签到', 'aksrt'), 1],
'login' => [__('每日登录', 'aksrt'), __('每日首次登录', 'aksrt'), 1],
'followed' => [__('被关注', 'aksrt'), __('被其他用户关注', 'aksrt'), 1],
'post_new' => [__('发布文章', 'aksrt'), __('发布并通过审核的文章', 'aksrt'), 5],
'post_like' => [__('文章被赞', 'aksrt'), __('你的文章被点赞', 'aksrt'), 1],
'post_favorite' => [__('文章被收藏', 'aksrt'), __('你的文章被收藏', 'aksrt'), 1],
'comment_new' => [__('发表评论', 'aksrt'), __('发表并通过审核的评论', 'aksrt'), 1],
'comment_like' => [__('评论被赞', 'aksrt'), __('你的评论被点赞', 'aksrt'), 1],
'bbs_posts_new' => [__('论坛发帖', 'aksrt'), __('发布论坛主题', 'aksrt'), 5],
'bbs_reply' => [__('论坛回复', 'aksrt'), __('回复论坛主题', 'aksrt'), 2],
'bbs_essence' => [__('帖子加精', 'aksrt'), __('主题被设为精华', 'aksrt'), 10],
];
}
/**
* Runtime free-task settings from theme options.
*
* @return array{day_max:int,tasks:array<string,int>}
*/
public static function settings(): array {
$all = class_exists('AKSRT_Settings') ? AKSRT_Settings::get_all() : [];
$credit = class_exists('AKSRT_Settings') ? AKSRT_Settings::get_credit_settings() : [];
$tasks = [];
foreach (self::catalog() as $key => $meta) {
$flat_key = 'points_free_' . $key;
if (array_key_exists($flat_key, $all)) {
$tasks[$key] = max(0, (int) $all[$flat_key]);
continue;
}
// Fallback mapping from legacy / parallel settings.
$tasks[$key] = self::legacy_task_points($key, $all, $credit, (int) $meta[2]);
}
$day_max = array_key_exists('points_earn_daily_limit', $all)
? max(0, (int) $all['points_earn_daily_limit'])
: 50;
return [
'day_max' => $day_max,
'tasks' => $tasks,
];
}
/**
* Points configured for a task (0 = disabled).
*/
public static function task_points(string $key): int {
$cfg = self::settings();
return max(0, (int) ($cfg['tasks'][$key] ?? 0));
}
/**
* Whether free points system can run (credits enabled).
*/
public static function enabled(): bool {
return class_exists('AKSRT_Settings') && AKSRT_Settings::credits_enabled() && class_exists('AKSRT_Credits');
}
/**
* Today's free points total.
*/
public static function today_total(int $user_id): int {
if ($user_id <= 0) {
return 0;
}
$detail = self::detail_map($user_id);
$today = self::today_key();
return max(0, (int) ($detail[$today] ?? 0));
}
/**
* Remaining free points allowed today (PHP_INT_MAX if unlimited).
*/
public static function remaining_today(int $user_id): int {
$day_max = (int) self::settings()['day_max'];
if ($day_max <= 0) {
return PHP_INT_MAX;
}
return max(0, $day_max - self::today_total($user_id));
}
/**
* Daily free points detail (newest first).
*
* @return array<string,int>
*/
public static function date_detail(int $user_id): array {
$detail = self::detail_map($user_id);
krsort($detail, SORT_STRING);
return $detail;
}
/**
* Grant free points for a task. Respects day_max; clamps amount.
*
* @param array{type?:string,id?:int} $ref
* @return int|WP_Error granted amount (0 if skipped)
*/
public static function grant(int $user_id, string $task_key, int $points = 0, array $ref = []) {
if (!self::enabled() || $user_id <= 0) {
return 0;
}
$task_key = sanitize_key($task_key);
if ($task_key === '') {
return 0;
}
if ($points <= 0) {
$points = self::task_points($task_key);
}
$points = max(0, (int) $points);
if ($points <= 0) {
return 0;
}
$remaining = self::remaining_today($user_id);
if ($remaining <= 0) {
return 0;
}
if ($points > $remaining) {
$points = $remaining;
}
$reason = 'free_' . $task_key;
$result = AKSRT_Credits::add(
$user_id,
$points,
$reason,
$ref,
self::catalog()[$task_key][0] ?? $task_key
);
if (is_wp_error($result)) {
return $result;
}
self::bump_detail($user_id, $points);
return $points;
}
/**
* Grant with explicit amount (e.g. signin streak reward), still under day_max.
*
* @return int|WP_Error
*/
public static function grant_amount(int $user_id, int $points, string $task_key, array $ref = []) {
return self::grant($user_id, $task_key, $points, $ref);
}
/**
* Task list DTO for user center UI.
*
* @return list<array{key:string,title:string,desc:string,points:int,enabled:bool}>
*/
public static function task_list_for_user(int $user_id = 0): array {
unset($user_id); // reserved for per-user progress later
$cfg = self::settings();
$list = [];
foreach (self::catalog() as $key => $meta) {
$pts = (int) ($cfg['tasks'][$key] ?? 0);
// Hide sign_up from daily task list (one-time); still grant on register.
if ($key === 'sign_up') {
continue;
}
if ($pts <= 0) {
continue;
}
$list[] = [
'key' => $key,
'title' => $meta[0],
'desc' => $meta[1],
'points' => $pts,
'enabled' => true,
];
}
return $list;
}
private static function today_key(): string {
return (new DateTimeImmutable('today', wp_timezone()))->format('Y-m-d');
}
/**
* @return array<string,int>
*/
private static function detail_map(int $user_id): array {
$raw = get_user_meta($user_id, self::META_DETAIL, true);
if (!is_array($raw)) {
return [];
}
$out = [];
foreach ($raw as $day => $val) {
$day = is_string($day) ? $day : (string) $day;
if (!preg_match('/^\d{4}-\d{2}-\d{2}$/', $day)) {
continue;
}
$out[$day] = max(0, (int) $val);
}
return $out;
}
private static function bump_detail(int $user_id, int $points): void {
if ($points <= 0) {
return;
}
$detail = self::detail_map($user_id);
$today = self::today_key();
$detail[$today] = max(0, (int) ($detail[$today] ?? 0)) + $points;
// Keep ~50 newest days.
krsort($detail, SORT_STRING);
$detail = array_slice($detail, 0, 50, true);
update_user_meta($user_id, self::META_DETAIL, $detail);
}
/**
* @param array<string,mixed> $all
* @param array<string,mixed> $credit
*/
private static function legacy_task_points(string $key, array $all, array $credit, int $default): int {
switch ($key) {
case 'sign_up':
return max(0, (int) ($credit['register_bonus'] ?? $default));
case 'sign_in':
$signin = is_array($credit['daily_signin'] ?? null) ? $credit['daily_signin'] : [];
if (isset($signin['enabled']) && empty($signin['enabled'])) {
return 0;
}
return max(0, (int) ($signin['base'] ?? $default));
case 'login':
return max(0, (int) ($all['points_earn_login'] ?? $default));
case 'post_new':
return max(0, (int) ($all['points_earn_post'] ?? $default));
case 'post_like':
return max(0, (int) ($all['points_earn_like_received'] ?? $default));
case 'comment_new':
if (isset($all['points_earn_comment'])) {
return max(0, (int) $all['points_earn_comment']);
}
$cr = is_array($credit['comment_reward'] ?? null) ? $credit['comment_reward'] : [];
if (isset($cr['enabled']) && empty($cr['enabled'])) {
return 0;
}
return max(0, (int) ($cr['amount'] ?? $default));
case 'bbs_posts_new':
if (class_exists('AKSRT_Settings') && method_exists('AKSRT_Settings', 'get_forum_settings')) {
$f = AKSRT_Settings::get_forum_settings();
return max(0, (int) ($f['credits']['post_new'] ?? $f['credits']['topic_new'] ?? $all['bbs_credits_post_new'] ?? $default));
}
return max(0, (int) ($all['bbs_credits_post_new'] ?? $default));
case 'bbs_reply':
if (class_exists('AKSRT_Settings') && method_exists('AKSRT_Settings', 'get_forum_settings')) {
$f = AKSRT_Settings::get_forum_settings();
return max(0, (int) ($f['credits']['comment_new'] ?? $default));
}
return $default;
default:
return $default;
}
}
}
+13 -2
View File
@@ -130,8 +130,19 @@ class AKSRT_Signin {
return new WP_Error('aksrt_signin_dup', __('签到失败', 'aksrt'), ['status' => 409]);
}
if ($reward > 0 && class_exists('AKSRT_Credits')) {
AKSRT_Credits::add($user_id, $reward, 'signin', ['type' => 'user', 'id' => $user_id]);
if ($reward > 0) {
if (class_exists('AKSRT_Points_Free')) {
$granted = AKSRT_Points_Free::grant_amount($user_id, $reward, 'sign_in', ['type' => 'user', 'id' => $user_id]);
if (is_wp_error($granted)) {
if (class_exists('AKSRT_Credits')) {
AKSRT_Credits::add($user_id, $reward, 'signin', ['type' => 'user', 'id' => $user_id]);
}
} else {
$reward = (int) $granted;
}
} elseif (class_exists('AKSRT_Credits')) {
AKSRT_Credits::add($user_id, $reward, 'signin', ['type' => 'user', 'id' => $user_id]);
}
}
return new WP_REST_Response([