discuz!x插件开发手册

《discuz!x插件开发手册》由会员上传分享，免费在线阅读，更多相关内容在行业资料-天天文库。

1、Discuz!X1.5插件开发手册2010/9/1ByMonkey插件设计您在开始进行社区插件的设计之前，有必要了解一下我们所推荐的插件设计方式，更好的规范性和兼容性，将使得您设计的插件受到更多使用者的欢迎，对于程序员而言，也有助于形成良好的编码习惯，实现自身能力的提升。如果您有意编写Discuz!社区插件，请按照先后顺序仔细阅读本文档。准备工作开启DisuczDebug模式1、下载DiscuzDebug补丁包，并解压。点我下载1、上传文件到论坛根目录2、在config/config_global.php中添

2、加$_config['debug']=n;n=1，debug标准模式n=2，debugE_ALL模式n=字串，当前$_GET、$_POST等REQUEST参数中包含debug=字串时显示插件实现流程开始编写社区插件，您应当首先对插件实现的流程有一个大致的了解，以下是我们推荐的插件编写流程：o熟练使用Discuz!社区系统后，对希望完善或补充的个性化功能进行评估，进而提出插件的功能需求。o对插件做一个概括性的设计，例如：需要使用什么菜单、什么参数，配置哪些选项、数据结构如何设计、前后台实现哪些功能等等。o阅读本

3、文档并在系统设置中实际体验Discuz!插件接口所实现的功用，例如：您的插件应当如何设计才能良好的挂接到社区系统中来。插件接口能够实现哪些功能、不能实现哪些功能，插件为此而需要做的优化、改造和取舍。o编写相应程序代码和模板语句，实现所需的功能并进行代码测试、兼容性测试和代码改进。o如果需要公开您的插件，可以用插件导出的方式，将插件配置信息导出到一个XML文件中，连同相应的程序和模板文件一同打包。同时，编写一个适合新手的插件的说明书也是必不可少的，其中包括：插件适用的Discuz!版本、功能概述、兼容性声明、安

4、装方法、使用方法、卸载方法等等。o将插件提供给他人，或自己使用，根据使用者反馈，对插件进行完善。插件实现流程至此结束。文件命名规范Discuz!按照如下的规范对程序和模板进行命名，请在设计插件时尽量遵循此命名规范：o可以直接通过浏览器访问的普通程序文件，以.php后缀命名。o被普通程序文件引用的程序文件，以.inc.php后缀命名。o被普通程序文件，或引用程序文件引用的函数库或类库，以.func.php(函数库)或.class.php(类库)后缀命名。o模板文件，以.htm后缀命名，插件模板文件存在于sour

5、ce/plugin/identifier/template/目录中。o模板语言包文件，以.lang.php后缀命名，插件语言包文件开发时存放于data/plugindata/目录中，文件名为identifier.lang.php。o动态缓存文件，存放于./data/cache目录中，依据不同的功用进行独立的命名。o使用后台数据备份功能生成的备份文件，通常以.sql为后缀，存放于data/目录中。o有些目录中存在内容为空白的index.htm文件，此类文件是为了避免Web服务器打开DirectoryIndex时

6、可能产生的安全问题。class_core.php模块功能白皮书source/class/class_core.php是Discuz!的通用初始化模块程序，其几乎被所有的外部代码所引用，在您开始插件设计之前，可以先对该模块的大致功能做一定的了解。class_core.php主要完成了以下任务：o对不同PHP及操作系统环境做了判断和兼容性处理，使得Discuz!可以运行于各种不同配置的服务器环境下。o初始化常量IN_DISCUZ为TRUE，用于include或require后续程序的判断，避免其他程序被非法引用。

7、o读取社区程序所在绝对路径，存放于常量DISCUZ_ROOT中。o加载所需的基本函数库source/function/function_core.php。o通过config/config_global.php中提供的数据库账号信息，建立数据库连接。Discuz!支持数据表的前缀，如需获得表的全名，可使用“DB::table('tablename')”方式。o判断用户是否登录，如登录标记$_G['uid']为非0，同时将$_G['user']（加了addslashes的用户名，可用于不加修改的插入数据库）、$_

8、G['member']['username']（原始的用户名，可用于页面显示）、$_G['member']['password']（用户密码的MD5串）等相应用户信息赋值，其他用户信息存放于$_G['member']，更多信息可通过“getuserprofile()”获取。o判断用户管理权限，将管理权限标记$_G['adminid']为1~3中间的值。0代表普通用户；1代表论坛管理员；2代表超级版主