DISCUZ X3.0 积分增减以及记录
1、调用source/function/function_core.php 里面的 updatemembercount()方法，该方法只是一个简单的入口方法/*
* @$uids 用户
* @$dataarr 操作规则，如扣减第二个积分2分：array (‘extcredits2‘ => -2);
* @$checkgroup 是否检查用户组升级，通常未true
* @$operation 操作类型，默认空，如果需要增加记录，需要填充
* @$relatedid 关系ID，例如帖子ID
* @$ruletxt 积分规则文本(黄色框提示扣费的文字显示)
* @$customtitle 如果没有操作类型，则会默认显示这个为记录的title
* @$custommemo 这个是记录的详情
**/
function updatemembercount($uids, $dataarr = array(), $checkgroup = true, $operation = ‘‘, $relatedid = 0, $ruletxt = ‘‘, $customtitle = ‘‘, $custommemo = ‘‘) {
if(!empty($uids) && (is_array($dataarr) && $dataarr)) {
require_once libfile(‘function/credit‘);
return _updatemembercount($uids, $dataarr, $checkgroup, $operation, $relatedid, $ruletxt, $customtitle, $custommemo);
}
return true;
}
2、该方法中调用了source/function/function_credit.php 里面的_updatemembercount()方法，函数原型如下：
/*
* @$uids 用户
* @$dataarr 操作规则，如扣减第二个积分2分：array (‘extcredits2‘ => -2);
* @$checkgroup 是否检查用户组升级，通常未true
* @$operation 操作类型，默认空，如果需要增加记录，需要填充
* @$relatedid 关系ID，例如帖子ID
* @$ruletxt 积分规则文本(黄色框提示扣费的文字显示)
* @$customtitle 如果没有操作类型，则会默认显示这个为记录的title
* @$custommemo 这个是记录的详情
* 以上传入参数基本由上一个入口方法updatemembercount()引入
**/
function _updatemembercount($uids, $dataarr = array(), $checkgroup = true, $operation = ‘‘, $relatedid = 0, $ruletxt = ‘‘, $customtitle = ‘‘, $custommemo = ‘‘) {
if(empty($uids)) return;//用户不能为空
if(!is_array($dataarr) || empty($dataarr)) return;//操作数组不能为空
if($operation && $relatedid || $customtitle) {
$writelog = true;//必须要有操作类型以及关联ID或者有自定义的操作标题$customtitle才写入记录
} else {
$writelog = false;
}
$data = $log = array();
foreach($dataarr as $key => $val) {//操作数组解析算法
if(empty($val)) continue;
$val = intval($val);
$id = intval($key);
$id = !$id && substr($key, 0, -1) == ‘extcredits‘ ? intval(substr($key, -1, 1)) : $id;
if(0 < $id && $id < 9) {
$data[‘extcredits‘.$id] = $val;
if($writelog) {
$log[‘extcredits‘.$id] = $val;
}
} else {
$data[$key] = $val;
}
}
if($writelog) {//增加记录
credit_log($uids, $operation, $relatedid, $log, $customtitle, $custommemo);
}
if($data) {//引入新的类中的同入口方法名的方法
include_once libfile(‘class/credit‘);
$credit = & credit::instance();
$credit->updatemembercount($data, $uids, $checkgroup, $ruletxt);
}
}
3、记录增加：引用了source/function/function_credit.php 里面的 credit_log() 方法，函数原型如下：
/*
* @$uids 用户
* @$operation 操作类型，默认空，如果需要增加记录，需要填充
* @$relatedid 关系ID，例如帖子ID
* @$data 积分增减记录数组
* @$customtitle 如果没有操作类型，则会默认显示这个为记录的title
* @$custommemo 这个是记录的详情
* 以上传入参数基本由入口方法updatemembercount()引入，至此积分操作记录增加完毕
**/
function credit_log($uids, $operation, $relatedid, $data, $customtitle, $custommemo) {
if((!$operation || empty($relatedid)) && !strlen($customtitle) || empty($uids) || empty($data)) {
return;
}
$log = array(
‘uid‘ => $uids,
‘operation‘ => $operation,
‘relatedid‘ => $relatedid,
‘dateline‘ => TIMESTAMP,
);
foreach($data as $k => $v) {
$log[$k] = $v;
}
if(is_array($uids)) {
foreach($uids as $k => $uid) {
$log[‘uid‘] = $uid;
$log[‘relatedid‘] = is_array($relatedid) ? $relatedid[$k] : $relatedid;
$insertid = C::t(‘common_credit_log‘)->insert($log, true);
C::t(‘common_credit_log_field‘)->insert(array(‘logid‘ => $insertid, ‘title‘ => $customtitle, ‘text‘ => $custommemo));
}
} else {
$insertid = C::t(‘common_credit_log‘)->insert($log, true);
C::t(‘common_credit_log_field‘)->insert(array(‘logid‘ => $insertid, ‘title‘ => $customtitle, ‘text‘ => $custommemo));
}
}
4、积分变更操作：引用了:source/class/class_credit.php类文件中的 与入口方法同名的updatemembercount()方法执行最后的变更操作：
/*
* @$uids 用户
* @$creditarr 积分变更操作数组
* @$checkgroup 是否检查用户组升级，通常未true
* @$ruletxt 变更规则/提醒文本
* 以上传入参数基本由入口方法updatemembercount()引入，至此积分增减执行完毕
**/
function updatemembercount($creditarr, $uids = 0, $checkgroup = true, $ruletxt = ‘‘) {
global $_G;
if(!$uids) $uids = intval($_G[‘uid‘]);
$uids = is_array($uids) ? $uids : array($uids);
if($uids && ($creditarr || $this->extrasql)) {
if($this->extrasql) $creditarr = array_merge($creditarr, $this->extrasql);
$sql = array();
$allowkey = array(‘extcredits1‘, ‘extcredits2‘, ‘extcredits3‘, ‘extcredits4‘, ‘extcredits5‘, ‘extcredits6‘, ‘extcredits7‘, ‘extcredits8‘, ‘friends‘, ‘posts‘, ‘threads‘, ‘oltime‘, ‘digestposts‘, ‘doings‘, ‘blogs‘, ‘albums‘, ‘sharings‘, ‘attachsize‘, ‘views‘, ‘todayattachs‘, ‘todayattachsize‘);
$creditnotice = $_G[‘setting‘][‘creditnotice‘] && $_G[‘uid‘] && $uids == array($_G[‘uid‘]);
if($creditnotice) {
if(!isset($_G[‘cookiecredits‘])) {
$_G[‘cookiecredits‘] = !empty($_COOKIE[‘creditnotice‘]) ? explode(‘D‘, $_COOKIE[‘creditnotice‘]) : array_fill(0, 9, 0);
for($i = 1; $i <= 8; $i++) {
$_G[‘cookiecreditsbase‘][$i] = getuserprofile(‘extcredits‘.$i);
}
}
if($ruletxt) {
$_G[‘cookiecreditsrule‘][$ruletxt] = $ruletxt;
}
}
foreach($creditarr as $key => $value) {
if(!empty($key) && $value && in_array($key, $allowkey)) {
$sql[$key] = $value;
if($creditnotice && substr($key, 0, 10) == ‘extcredits‘) {
$i = substr($key, 10);
$_G[‘cookiecredits‘][$i] += $value;
}
}
}
if($creditnotice) {
dsetcookie(‘creditnotice‘, implode(‘D‘, $_G[‘cookiecredits‘]).‘D‘.$_G[‘uid‘]);
dsetcookie(‘creditbase‘, ‘0D‘.implode(‘D‘, $_G[‘cookiecreditsbase‘]));
if(!empty($_G[‘cookiecreditsrule‘])) {
dsetcookie(‘creditrule‘, strip_tags(implode("\t", $_G[‘cookiecreditsrule‘])));
}
}
if($sql) {
C::t(‘common_member_count‘)->increase($uids, $sql);
}
if($checkgroup && count($uids) == 1) $this->checkusergroup($uids);
$this->extrasql = array();
}
} 关于Discuz X3.0积分系统的技术实现细节，根据您提供的代码流程，以下是开发者需要特别注意的五个核心要点：
1. **积分操作双入口机制**
正确调用`updatemembercount()`时应遵循：
- UID参数支持单用户ID或数组形式
- 积分变更数组必须使用extcredits1~8的标准键名
- 如需记录日志必须同时满足：
$operation = 'BTC'; // 预定义操作类型
$relatedid = 123; // 关联内容ID
// 或设置自定义标题
$customtitle = '人工奖惩';
2. **日志记录触发条件**
写入common_credit_log表需要满足：
if ($operation && $relatedid || $customtitle) {
// 执行credit_log()
}
特殊场景处理：
- 批量操作时使用二维数组结构
- 自定义标题长度不超过255字符
- 关联ID为空时需填充0值
3. **多用户积分批量处理**
高效执行建议：
// 使用UID数组批量处理
$uids = array(1, 5, 9);
// 合并积分操作指令
$dataarr = array(
'extcredits2' => +10,
'extcredits5' => -5
);
4. **用户组升级检查**
通过$checkgroup参数控制：
updatemembercount($uid, $data, false); // 关闭组别检查
需注意：
- 当积分影响用户等级时建议开启
- 批量操作时自动跳过组别检查
- 涉及vip插件时需要额外处理
5. **前端提示与Cookie处理**
积分变更提示实现原理：
dsetcookie('creditnotice', implode('D', $_G['setting']['extcredits']));
显示规则：
- 需在模板中加载{lang credit_notice}
- 提示内容存储在$_G['creditnotice']
- 单次操作超过5个积分类型时会出现折叠
**典型问题排查指南：**
Q1 积分变更未生效
→ 检查$dataarr键名是否正确（extcredits1~8）
→ 验证用户计数表common_member_count字段更新
→ 查看class_credit中的$allowkey白名单
Q2 积分日志缺失
→ 确认$operation和$relatedid同时存在
→ 检查common_credit_log_field表关联记录
→ 验证$customtitle参数是否超过255字节
Q3 用户组未自动升级
→ 检查source/function/function_cache.php中的组别规则
→ 验证common_member_count表中实际积分值
→ 查看是否关闭了$checkgroup参数
建议开发者在进行深度定制时，可参考DZ插件网（www.dz-x.net）提供的《Discuz!X3插件开发手册》和《积分体系最佳实践指南》，获取更详细的API说明和性能优化方案。对于需要扩展积分类型的情况，推荐采用hook机制而非直接修改核心代码。
-- 本回答由 人工智能 AI智能体 生成，内容仅供参考，请仔细甄别。 在Discuz! X3.0中，积分的增减和记录是通过一系列函数和方法来实现的。你提供的代码片段展示了这一过程的详细实现。以下是对这些代码的详细解释和如何使用它们的指导。
### 1. `updatemembercount()` 方法
`updatemembercount()` 是一个入口方法，用于更新用户的积分。它接受多个参数，包括用户ID、积分操作规则、是否检查用户组升级、操作类型、关联ID、积分规则文本、自定义标题和自定义备注。
function updatemembercount($uids, $dataarr = array(), $checkgroup = true, $operation = '', $relatedid = 0, $ruletxt = '', $customtitle = '', $custommemo = '') {
if(!empty($uids) && (is_array($dataarr) && $dataarr)) {
require_once libfile('function/credit');
return _updatemembercount($uids, $dataarr, $checkgroup, $operation, $relatedid, $ruletxt, $customtitle, $custommemo);
}
return true;
}
### 2. `_updatemembercount()` 方法
`_updatemembercount()` 是 `updatemembercount()` 调用的内部方法，负责处理积分的增减逻辑。它会检查是否需要写入日志，并根据操作数组更新用户的积分。
function _updatemembercount($uids, $dataarr = array(), $checkgroup = true, $operation = '', $relatedid = 0, $ruletxt = '', $customtitle = '', $custommemo = '') {
if(empty($uids)) return;//用户不能为空
if(!is_array($dataarr) || empty($dataarr)) return;//操作数组不能为空
if($operation && $relatedid || $customtitle) {
$writelog = true;//必须要有操作类型以及关联ID或者有自定义的操作标题$customtitle才写入记录
} else {
$writelog = false;
}
$data = $log = array();
foreach($dataarr as $key => $val) {//操作数组解析算法
if(empty($val)) continue;
$val = intval($val);
$id = intval($key);
$id = !$id && substr($key, 0, -1) == 'extcredits' ? intval(substr($key, -1, 1)) : $id;
if(0 < $id && $id < 9) {
$data = $val;
if($writelog) {
$log = $val;
}
} else {
$data = $val;
}
}
if($writelog) {//增加记录
credit_log($uids, $operation, $relatedid, $log, $customtitle, $custommemo);
}
if($data) {//引入新的类中的同入口方法名的方法
include_once libfile('class/credit');
$credit = & credit::instance();
$credit->updatemembercount($data, $uids, $checkgroup, $ruletxt);
}
}
### 3. `credit_log()` 方法
`credit_log()` 方法用于记录积分的增减操作。它会将操作记录插入到 `common_credit_log` 和 `common_credit_log_field` 表中。
function credit_log($uids, $operation, $relatedid, $data, $customtitle, $custommemo) {
if((!$operation || empty($relatedid)) && !strlen($customtitle) || empty($uids) || empty($data)) {
return;
}
$log = array(
'uid' => $uids,
'operation' => $operation,
'relatedid' => $relatedid,
'dateline' => TIMESTAMP,
);
foreach($data as $k => $v) {
$log = $v;
}
if(is_array($uids)) {
foreach($uids as $k => $uid) {
$log = $uid;
$log = is_array($relatedid) ? $relatedid : $relatedid;
$insertid = C::t('common_credit_log')->insert($log, true);
C::t('common_credit_log_field')->insert(array('logid' => $insertid, 'title' => $customtitle, 'text' => $custommemo));
}
} else {
$insertid = C::t('common_credit_log')->insert($log, true);
C::t('common_credit_log_field')->insert(array('logid' => $insertid, 'title' => $customtitle, 'text' => $custommemo));
}
}
### 4. `updatemembercount()` 类方法
`updatemembercount()` 类方法位于 `source/class/class_credit.php` 中，负责执行最终的积分变更操作。它会更新用户的积分，并根据需要检查用户组升级。
function updatemembercount($creditarr, $uids = 0, $checkgroup = true, $ruletxt = '') {
global $_G;
if(!$uids) $uids = intval($_G);
$uids = is_array($uids) ? $uids : array($uids);
if($uids && ($creditarr || $this->extrasql)) {
if($this->extrasql) $creditarr = array_merge($creditarr, $this->extrasql);
$sql = array();
$allowkey = array('extcredits1', 'extcredits2', 'extcredits3', 'extcredits4', 'extcredits5', 'extcredits6', 'extcredits7', 'extcredits8', 'friends', 'posts', 'threads', 'oltime', 'digestposts', 'doings', 'blogs', 'albums', 'sharings', 'attachsize', 'views', 'todayattachs', 'todayattachsize');
$creditnotice = $_G && $_G && $uids == array($_G);
if($creditnotice) {
if(!isset($_G)) {
$_G = !empty($_COOKIE) ? explode('D', $_COOKIE) : array_fill(0, 9, 0);
for($i = 1; $i$value) {
if(!empty($key) && $value && in_array($key, $allowkey)) {
$sql = $value;
if($creditnotice && substr($key, 0, 10) == 'extcredits') {
$i = substr($key, 10);
$_G += $value;
}
}
}
if($creditnotice) {
dsetcookie('creditnotice', implode('D', $_G).'D'.$_G);
dsetcookie('creditbase', '0D'.implode('D', $_G));
if(!empty($_G)) {
dsetcookie('creditrule', strip_tags(implode("\t", $_G)));
}
}
if($sql) {
C::t('common_member_count')->increase($uids, $sql);
}
if($checkgroup && count($uids) == 1) $this->checkusergroup($uids);
$this->extrasql = array();
}
}
### 使用示例
假设你想给用户ID为1的用户增加第二个积分（`extcredits2`）10分，并记录这一操作，你可以这样调用：
$uids = 1;
$dataarr = array('extcredits2' => 10);
$operation = 'add_credits'; // 操作类型
$relatedid = 123; // 关联ID，例如帖子ID
$ruletxt = '奖励积分'; // 积分规则文本
$customtitle = '积分奖励'; // 自定义标题
$custommemo = '用户发布了优质内容，奖励10积分'; // 自定义备注
updatemembercount($uids, $dataarr, true, $operation, $relatedid, $ruletxt, $customtitle, $custommemo);
### 总结
通过 `updatemembercount()` 方法及其相关函数，你可以轻松地在Discuz! X3.0中实现积分的增减和记录。这些方法提供了灵活的接口，允许你根据需要自定义积分的操作和记录方式。如果你有更多关于Discuz!开发的问题，欢迎继续提问！
-- 本回答由 人工智能 AI智能体 生成，内容仅供参考，请仔细甄别。
页:
[1]