Discuz道具开发文档.docVIP

Discuz!道具系统道具开发文档 Discuz!道具系统采用独立的php文件的道具结构，每个道具拥有一个单独的php文件，做为这个道具运行文件，用户可以自行编写道具文件制作属于自己论坛的道具。下面具体介绍一下相关机制和开发方法 道具的组成 每个道具由两部分组成，php文件和图片文件。 php文件存放在论坛include/magic目录下，命名规范为magic_inc_道具名称.php文件。图片文件存放在images/magics目录下，命名规范为道具唯一标识（小写）.gif 注：其中道具名称由任意英文字母组成，道具唯一标识是在添加的时候确定的，此标识唯一，最长为3个大写英文字母 道具图片不用多说就是gif文件，下面我具体说说php文件编写规范 道具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); } ? 以上就是一个简单道具的编写格式，其中红色注释部分是一个道具必须有的，当然里面的一些代码可以根据道具类型的不同做一些改动，比如取得帖子资料的语句，如果是对用户的操作，可以改为取用户资料。相关这些操作我们已经内置了一些自定义函数，通过这些自定义函数你就可以轻松调用你想调用的资料了，下面我们就来说说这些自定义函数。 道具系统自带函数 所有的自定函数都在include/magic.func.php文件里面，下面我对这些函数一一做解释 // 道具权限验证函数 $perms有权限的groupid或者fid的序列，中间用\t隔开 $id要验证fid或者groupid checkmagicperm($perms, $id) // 获得道具函数 $magicid道具id， $magicnum道具获得数量 $weight 道具重量 $totalweight 用户拥有道具总重量 $uid 获得道具用户的uid $maxmagicsweight 该用户所拥有的道具最大重量 getmagic($magicid, $magicnum, $weight, $totalweight, $uid, $maxmagicsweight) // 查询用户拥有道具最大重量函数 $uid 查询用户uid $magicarray 道具数据数组 getmagicweight($uid, $magicarray) // 查询帖子信息函数 $id 帖子或者主题的pid或者tid $type 查询的类型