Discuz道具开发文档.doc

Discuz!道具系统道具开发文档Discuz!道具系统采用独立的php文件的道具结构，每个道具拥有一个单独的php文件，做为这个道具运行文件，用户可以自行编写道具文件制作属于自己论坛的道具。下面具体介绍一下相关机制和开发方法1、 道具的组成每个道具由两部分组成，php文件和图片文件。php文件存放在论坛include/magic目录下，命名规范为magic_inc_道具名称.php文件。图片文件存放在images/magics目录下，命名规范为道具唯一标识（小写）.gif注：其中道具名称由任意英文字母组成，道具唯一标识是在添加的时候确定的，此标识唯一，最长为3个大写英文字母道具图片不用多说就是gif文件，下面我具体说说php文件编写规范2、 道具php文件编写详解我们以一个道具php文件（magic_inc_close.php）为例query(UPDATE $tableprethreads SET closed=1, moderated=1 WHERE tid=$tid);$expiration = $timestamp + 86400; / 使用道具代码usemagic($magicid, $magicnum); / 记录道具使用日志updatemagiclog($magicid, 2, 1, 0, $tid); / 记录道具使用对象（这里指主题）日志updatemagicthreadlog($tid, $magicid, $magicidentifier, $expiration); / 显示道具使用信息showmessage(magics_operation_succeed, magic.php?action=user);/ 生成道具界面显示代码function showmagic() global $tid, $lang;magicshowtype($langoption, top);magicshowsetting($langtarget_tid, tid, $tid, text);magicshowtype(, bottom);?以上就是一个简单道具的编写格式，其中红色注释部分是一个道具必须有的，当然里面的一些代码可以根据道具类型的不同做一些改动，比如取得帖子资料的语句，如果是对用户的操作，可以改为取用户资料。相关这些操作我们已经内置了一些自定义函数，通过这些自定义函数你就可以轻松调用你想调用的资料了，下面我们就来说说这些自定义函数。3、 道具系统自带函数所有的自定函数都在include/magic.func.php文件里面，下面我对这些函数一一做解释/ 道具权限验证函数$perms有权限的groupid或者fid的序列，中间用t隔开$id要验证fid或者groupidcheckmagicperm($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 查询的类型 tid代表主题 pid代表帖子$colsarray 要查询的字段 数据类型数组getpostinfo($id, $type, $colsarray = )/ 查询用户信息函数$username 查询用户名$colsarray 要查询的字段 数据类型数组getuserinfo($username, $colsarray = )/ 赠送道具函数$username 要赠送对象的用户名$magicid 赠送道具道具id$magicnum 赠送道具的单个数量$totalnum 赠送道具的总数量$totalprice 赠送道具的总价格givemagic($username, $magicid, $magicnum, $totalnum, $totalprice)/ 道具随机函数$odds 成功的几率，例如10成功的几率就是10%magicrand($odds) / 道具市场道具操作函数$magicid 道具id$marketnum 道具市场道具数量$magicnum 道具数量marketmagicnum($magicid, $marketnum, $magicnum) / 道具操作验证函数（用户验证道具使用对象是否被版主操作过）$tid 帖子idmagicthreadmod($tid)/ 道具界面生成函数magicshowsetting($setname, $varname, $value, $type = radio, $width = 20%)magicshowtips($tips, $title) magicshowtype($name, $type = )/ 道具使用函数$magicid 道具id$totalnum 被使用道具的用户拥有总数量$num 使用数量usemagic($magicid, $totalnum, $num = 1) / 道具使用对象日志（主要用于使用对象主题时）$tid 主题tid$magicid 道具id$action 动作标识$expiration 道具有效期$extra 是否记录用户名 1为不记录，0为记录updatemagicthreadlog($tid, $magicid, $action, $expiration, $extra = 0)/ 道具使用日志$magicid 道具id$action 动作标识 1为购买 2为使用 3为赠送 4为道具市场出售 5为道具市场购买$amount 道具操作数量$price道具操作价格$targettid 道具使用对象tid$ta