Files
wordpress-theme-aksrt/inc/helpers/aksrt-credits.php
T
kate522 1247f9bf4e feat(credits): exchange balance for points
Replace the legacy points-to-balance and external points purchase flows
with direct integer balance-to-points exchange. Enforce exchange and
points-transfer limits and capability checks across the UI and REST API.
2026-08-13 15:20:06 +08:00

77 lines
2.7 KiB
PHP

<?php
/**
* AKSRT Credits Helper
*
* 模板层使用的顶层辅助函数:
* aksrt_user_credits($user_id = 0) 读取余额
* aksrt_format_credits(int $n) 格式化展示
* aksrt_credits_label(string $reason) 流水原因 → 友好文案
*
* @package AKSRT
*/
defined('ABSPATH') || exit;
if (!function_exists('aksrt_user_credits')) {
/**
* 取用户当前积分余额。
*
* @param int $user_id 0 表示当前登录用户
* @return int
*/
function aksrt_user_credits(int $user_id = 0): int {
if ($user_id <= 0) $user_id = get_current_user_id();
if ($user_id <= 0) return 0;
if (!class_exists('\AKSRT\Credits\Credits')) return 0;
return \AKSRT\Credits\Credits::balance($user_id);
}
}
if (!function_exists('aksrt_format_credits')) {
function aksrt_format_credits(int $n): string {
return number_format_i18n($n);
}
}
if (!function_exists('aksrt_credits_label')) {
/**
* 把 reason 字段翻译成展示文案。
*/
function aksrt_credits_label(string $reason): string {
$map = [
'register' => __('注册赠送', 'aksrt'),
'signin' => __('每日签到', 'aksrt'),
'comment' => __('发表评论', 'aksrt'),
'invite' => __('邀请奖励', 'aksrt'),
'invitee' => __('被邀请奖励', 'aksrt'),
'download' => __('下载消费', 'aksrt'),
'admin' => __('管理员调整', 'aksrt'),
'refund' => __('退款', 'aksrt'),
'free_sign_up' => __('注册奖励', 'aksrt'),
'free_sign_in' => __('每日签到', 'aksrt'),
'free_login' => __('每日登录', 'aksrt'),
'free_followed'=> __('被关注', 'aksrt'),
'free_post_new'=> __('发布文章', 'aksrt'),
'free_post_like'=> __('文章被赞', 'aksrt'),
'free_post_favorite'=> __('文章被收藏', 'aksrt'),
'free_comment_new'=> __('发表评论', 'aksrt'),
'free_comment_like'=> __('评论被赞', 'aksrt'),
'points_exchange_in' => __('余额兑换积分', 'aksrt'),
'transfer_in' => __('积分转入', 'aksrt'),
'transfer_out' => __('积分转出', 'aksrt'),
'transfer_refund' => __('积分转账退款', 'aksrt'),
];
if (isset($map[$reason])) {
return $map[$reason];
}
if (str_starts_with($reason, 'free_') && class_exists('\AKSRT\Credits\PointsFree')) {
$key = substr($reason, 5);
$cat = \AKSRT\Credits\PointsFree::catalog();
if (isset($cat[$key][0])) {
return (string) $cat[$key][0];
}
}
return $reason;
}
}