您现在的位置是：首页 > cms教程 > Discuz教程Discuz教程

Discuz!道具系统开发介绍

问筠2025-07-06Discuz教程已有人查阅

导读Discuz!道具系统采用独立的php文件的道具结构，每个道具拥有一个单独的php文件，做为这个道具运行文件，用户可以自行编写道具文件制作属于自己论坛的道具。

Discuz!道具系统采用独立的php文件的道具结构，每个道具拥有一个单独的php文件，做为这个道具运行文件，用户可以自行编写道具文件制作属于自己论坛的道具。下面具体介绍一下相关机制和开发方法
1、道具的组成
每个道具由两部分组成，php文件和图片文件。
php文件存放在论坛include/magic目录下，命名规范为magic_inc_道具名称.php文件。图片文件存放在images/magics目录下，命名规范为道具唯一标识（小写）.gif
注：其中道具名称由任意英文字母组成，道具唯一标识是在添加的时候确定的，此标识唯一，最长为3个大写英文字母道具图片不用多说就是gif文件，下面我具体说说php文件编写规范
2、道具php文件编写详解
我们以一个道具php文件（magic_inc_close.php）为例

<?php
// 这段代码的作用防止文件直接调用，每个道具文件都必须在开头加入
if(!defined('IN_DISCUZ')) {
exit('Access Denied');
}
// 用户点击使用后，执行的代码
if(submitcheck('usesubmit')) {
// 验证资料是否填写完全，这里验证$tid（帖子id）是否填写
if(empty($tid)) {
showmessage('magics_info_nonexistence');
}
// 取得帖子的相关资料
$thread = getpostinfo($tid, 'tid', array('fid'));
// 验证帖子所在的版块是否有使用道具的权限
checkmagicperm($magicperm['forum'], $thread['fid']);
// 道具的执行代码
$db->query("UPDATE {$tablepre}threads SET closed='1', moderated='1' WHERE tid='$tid'");
$expiration = $timestamp + 86400;
// 使用道具代码
usemagic($magicid, $magic['num']);
// 记录道具使用日志
updatemagiclog($magicid, '2', '1', '0', $tid);
// 记录道具使用对象（这里指主题）日志
updatemagicthreadlog($tid, $magicid, $magic['identifier'], $expiration);
// 显示道具使用信息
showmessage('magics_operation_succeed', 'magic.php?action=user');
}
// 生成道具界面显示代码
function showmagic() {
global $tid, $lang;
magicshowtype($lang['option'], 'top');
magicshowsetting($lang['target_tid'], 'tid', $tid, 'text');
magicshowtype('', 'bottom');
}
?>

以上就是一个简单道具的编写格式，其中红色注释部分是一个道具必须有的，当然里面的一些代码可以根据道具类型的不同做一些改动，比如取得帖子资料的语句，如果是对用户的操作，可以改为取用户资料。相关这些操作我们已经内置了一些自定义函数，通过这些自定义函数你就可以轻松调用你想调用的资料了，下面我们就来说说这些自定义函数。
3、道具系统自带函数
所有的自定函数都在include/magic.func.php文件里面，下面我对这些函数一一做解释