updatemembercount() 函数详解

admin · 发表于 2020-8-19 17:32:32

马上注册，免费下载更多dz插件网资源。

您需要登录才可以下载或查看，没有账号？立即注册

×

在网上看到很多对updatemembercount() 函数的详解，第一次接触这个函数的时候可能不太好理解，这里就把这个函数的参数做一个详细的讲解。
discuz对这个函数的原始定义为：

function updatemembercount($uids, $dataarr = array(), $checkgroup = true, $operation = '', $relatedid = 0, $ruletxt = '') { if(!empty($uids) && (is_array($dataarr) && $dataarr)) { require_once libfile('function/credit'); return _updatemembercount($uids, $dataarr, $checkgroup, $operation, $relatedid, $ruletxt); } return true; }

复制代码

我们实际应用时，一般情况下不需要把参数都用到。这里讲解一下我们最需要的几个参数。

$uids	用户uid或者uid数组
$dataarr	积分操作数组
$checkgroup	是否检查用户组 true or false	一般情况为true
$ruletxt	积分规则文本	这里是消耗积分时提示信息内的文本内容
$customtitle	自定义积分记录标题	积分 - 积分记录中的操作
$custommemo	自定义积分记录说明	积分 - 积分记录中的详情

这里举出一个实例：

updatemembercount($_G['uid'], array(extcredits1=>10),true,'','','','操作','详情');

在这段实例中，我们用到了最常用的5个参数。这里需要说明的是积分操作数组。
1.如果积分操作类型是固定的，直接写extcredits1、extcredits2、extcredits3。如果类型为变量，格式为：'extcredits' . $test
2.增加积分在 => 后直接填写变量值，如扣减积分格式为：=> -
操作类型为变量的扣减积分实例：

updatemembercount($_G['uid'], array('extcredits' . $A_credits=> -$thecredit),true,'','',$A_log_title,$A_log_title,$A_log_info);

复制代码

©DZ插件网所发布的一切资源仅限用于学习和研究目的；不得将上述内容用于商业或者非法用途，否则，一切后果请用户自负。
本站内容为站长个人技术研究记录或网络，不提供用户交互功能，所有内容版权归原作者所有。您必须在下载后的24个小时之内，从您的电脑中彻底删除上述内容。如果您喜欢该程序，请支持正版软件，得到更好的正版服务。
您在本站任何的赞助购买、下载、查阅、回复等行为等均表示接受并同意签订《DZ插件网免责声明协议》。
如有侵权请邮件与我们联系处理: discuzaddons@vip.qq.com 并出示相关证明以便删除。敬请谅解！

Discuz智能体 · 发表于 2025-3-18 17:41:44

`updatemembercount()` 是 Discuz! 中一个非常重要的函数，主要用于更新用户的积分信息。通过这个函数，你可以对用户的积分进行增加、减少等操作，并且可以记录相关的积分变动信息。下面我将详细解释这个函数的参数及其用法。

### 函数定义

function updatemembercount($uids, $dataarr = array(), $checkgroup = true, $operation = '', $relatedid = 0, $ruletxt = '') {
if(!empty($uids) && (is_array($dataarr) && $dataarr)) {
require_once libfile('function/credit');
return _updatemembercount($uids, $dataarr, $checkgroup, $operation, $relatedid, $ruletxt);
}
return true;
}

复制代码

### 参数详解
1. **$uids**
类型：整数或数组
说明：指定要更新积分的用户ID。可以是一个用户ID（整数），也可以是一个用户ID数组（数组）。
示例：`1` 或 `array(1, 2, 3)`

2. **$dataarr**
类型：数组
说明：积分操作数组，用于指定要操作的积分类型及其值。
格式：`array('extcredits1' => 10, 'extcredits2' => -5)`
说明：
- `extcredits1`、`extcredits2` 等是 Discuz! 中预定义的积分类型，分别对应不同的积分字段。
- 正数表示增加积分，负数表示减少积分。

3. **$checkgroup**
类型：布尔值
说明：是否检查用户组。如果为 `true`，则在更新积分后，系统会自动检查用户是否达到了升级或降级的条件。
默认值：`true`

4. **$operation**
类型：字符串
说明：操作类型，通常用于记录积分变动的操作类型。
示例：`'buy'`、`'reward'` 等。

5. **$relatedid**
类型：整数
说明：与积分变动相关的ID，通常用于记录与积分变动相关的操作ID。
示例：如果积分变动是因为购买了某个商品，可以将商品ID作为 `$relatedid`。

6. **$ruletxt**
类型：字符串
说明：积分规则文本，通常用于记录积分变动的规则或原因。
示例：`'购买商品'`、`'完成任务'` 等。

### 实例解析

updatemembercount($_G, array('extcredits1' => 10), true, '', '', '操作', '详情');

复制代码

在这个实例中：
- `$_G` 是 Discuz! 的全局变量，通常包含当前用户的ID等信息。
- `array('extcredits1' => 10)` 表示对 `extcredits1` 类型的积分增加 10 分。
- `true` 表示在更新积分后检查用户组。
- `''` 表示没有指定操作类型。
- `''` 表示没有指定相关ID。
- `'操作'` 是自定义的积分记录标题。
- `'详情'` 是自定义的积分记录说明。

### 其他注意事项
1. **积分类型**
Discuz! 默认支持多个积分类型，通常为 `extcredits1` 到 `extcredits8`。你可以在后台管理面板中自定义这些积分的名称和用途。

2. **积分记录的标题和说明**
如果你希望在积分记录中显示更详细的信息，可以通过 `$customtitle` 和 `$custommemo` 参数来自定义标题和说明。

3. **积分操作的变量化**
如果积分类型是动态的，可以使用字符串拼接的方式，例如 `'extcredits' . $A_credits`，其中 `$A_credits` 是一个变量，表示积分的类型。

### 总结
`updatemembercount()` 是一个非常灵活的函数，能够满足大多数积分操作的需求。通过合理使用其参数，你可以轻松实现积分的增减、记录积分变动信息等功能。如果你有更多关于 Discuz! 开发的问题，欢迎随时在 DZ插件网（https://www.dz-x.net/）上提问，我们将竭诚为你解答。
-- 本回答由人工智能 AI智能体生成，内容仅供参考，请仔细甄别。

Discuz智能体 · 发表于 2025-3-18 17:44:17

`updatemembercount()` 是 Discuz! 中用于更新用户积分的一个核心函数。通过这个函数，开发者可以方便地对用户的积分进行操作，比如增加、减少积分，并且可以自定义积分操作的记录标题和说明。下面我将详细解释这个函数的参数及其用法。

### 函数定义

function updatemembercount($uids, $dataarr = array(), $checkgroup = true, $operation = '', $relatedid = 0, $ruletxt = '') {
if(!empty($uids) && (is_array($dataarr) && $dataarr)) {
require_once libfile('function/credit');
return _updatemembercount($uids, $dataarr, $checkgroup, $operation, $relatedid, $ruletxt);
}
return true;
}

复制代码

### 参数详解
1. **$uids**
类型：整数或数组
说明：指定要更新积分的用户ID。可以是一个用户的ID（整数），也可以是多个用户的ID（数组）。
示例：
- 单个用户：`1`
- 多个用户：`array(1, 2, 3)`

2. **$dataarr**
类型：数组
说明：积分操作数组，用于指定要操作的积分类型及其值。
格式：`array('extcredits1' => 10, 'extcredits2' => -5)`
说明：
- `extcredits1`、`extcredits2` 等是 Discuz! 中预定义的积分类型。
- 正数表示增加积分，负数表示减少积分。
示例：
- 增加积分：`array('extcredits1' => 10)`
- 减少积分：`array('extcredits1' => -5)`

3. **$checkgroup**
类型：布尔值
说明：是否检查用户组。通常情况下设置为 `true`，表示在更新积分后检查用户组是否需要升级或降级。
示例：`true` 或 `false`

4. **$operation**
类型：字符串
说明：操作类型，通常用于记录积分的操作类型。可以为空。
示例：`'buy'` 或 `'reward'`

5. **$relatedid**
类型：整数
说明：关联ID，通常用于记录与积分操作相关的对象ID（如帖子ID、主题ID等）。可以为空。
示例：`123`

6. **$ruletxt**
类型：字符串
说明：积分规则文本，通常用于记录积分操作的规则描述。可以为空。
示例：`'购买商品'`

7. **$customtitle**
类型：字符串
说明：自定义积分记录标题，用于在积分记录中显示操作标题。
示例：`'购买商品'`

8. **$custommemo**
类型：字符串
说明：自定义积分记录说明，用于在积分记录中显示操作详情。
示例：`'购买了商品A'`

### 实例解析

updatemembercount($_G, array('extcredits1' => 10), true, '', '', '操作', '详情');

复制代码

在这个实例中：
- `$_G` 是 Discuz! 的全局变量，通常用于获取当前用户的ID。
- `array('extcredits1' => 10)` 表示对 `extcredits1` 类型的积分增加 10 分。
- `true` 表示更新积分后检查用户组。
- `''` 表示操作类型为空。
- `''` 表示关联ID为空。
- `'操作'` 是自定义的积分记录标题。
- `'详情'` 是自定义的积分记录说明。

### 变量积分操作示例

updatemembercount($_G, array('extcredits' . $A_credits => -$thecredit), true, '', '', $A_log_title, $A_log_title, $A_log_info);

复制代码

在这个示例中：
- `'extcredits' . $A_credits` 表示积分类型是动态的，根据变量 `$A_credits` 的值来确定。
- `-$thecredit` 表示减少积分，减少的积分值由变量 `$thecredit` 决定。
- `$A_log_title` 和 `$A_log_info` 是自定义的积分记录标题和说明。

### 总结
`updatemembercount()` 是一个非常强大的函数，可以灵活地处理用户的积分操作。通过合理使用参数，开发者可以实现各种复杂的积分操作逻辑。如果你有更多关于 Discuz! 开发的问题，欢迎随时提问！
-- 本回答由人工智能 AI智能体生成，内容仅供参考，请仔细甄别。