DISCUZ插件开发新手入门

《DISCUZ插件开发新手入门》由会员上传分享，免费在线阅读，更多相关内容在教育资源-天天文库。

DISCUZ插件开发新手入门作者：联想锋行QQ445663314前言：本文所谓插件开发是指按照DISCUZ官方用户手册所说明的插件开发流程所进行的开发。在阅读本文之前，假设读者是已经了解DISCUZ程序中的include/common.inc.php这个公共处理程序。如果您不了解此程序功能，请阅读手用户册中的插件开发说明，并阅读程序。本文基于DISCUZ6.1.0GBK版。水平有限，仅供新手参考。如有错误，请指正。第一步：后台增加插件1，添加新插件（点击添加新插件）2，编辑插件信息（点击详情） 设置插件信息注意插件目录是相对于./plugins/的，因为插件文件是要放在./plugins/这个文件夹下的。为了方便和统一管理，一般都是按照自己的插件项目命名一个文件夹，然后此插件的程序放在此目录下。一般此目录名与您的唯一标识符是相同的，以便于识别。当然，不是必需，但是，为了良好习惯和标准，最好还是同名。一般会在前面加plugins_以区分这是插件数据表。另外注意数据库表不要有前缀。当然，写在那里只是备份数据的时候要用到。如果你觉得你的数据表不用备份到里，也可以不必填写。当然，大部分时候还是推荐您填写。1，增加模块程序模块名填写英语，名称填写中文的链接显示名称。模块类型选择“前台调用（前台下拉菜单）”，此时直接URL可以不填写。如果此模块是给会员用的，使用等级设为普通用户。 1，把插件设为可用回到论坛插件管理，把刚才新增的插件设为可用。如下图：把前面的勾打上。OK，现在论坛首页去看看，测试一下插件有没有显示出来。OK，出来了。成功一半了。点击插件的链接，会出现以下提示：这是正常的，因为我们还没有正式开始写程序嘛！第二步：编写程序和模板1，在plugins目录下增加插件目录，此目录名example要与插件设置的“插件目录”里的一致！2，在plugins目录下增加模块程序 注意，文件名要按“模块名.inc.php”来，如本文中的kaifa.inc.php。好了，OK，我们来写行程序测试下。OK，见到效果了。1，开始写插件程序首先，保护本程序不被独访。按DZ官方的来。接下来，引进模板。以上template(‘kaifa’)中的kaifa是模板的命名，对应于模板风格目录下的kaifa.htm，当然，模板名字可以随便取。一般会以plugins_kaifa这样子以区分这是插件的模板。 1，开始写插件模板一般的，都要引进DZ的页头页脚的。OK,让我们看下效果。更多关于DZ模板和程序的知识，作为程序员，你应该了解，在此不讲。第三步：设置插件变量1，增加变量论坛插件管理->详情->变量。比如增加一个列表分页显示数，变量名为pagenum，数字 提交，然后编辑变量详情。以上主要是给变量给点说明，用于给管理员在后台配置插件的时候的提示信息。1，配置插件变量论坛插件->设置->详情->变量。找到插件，点击插件参数设置把刚才新增的变量赋上值。（如果不做这一步，变量就没值用，插件就可能会出错！） 1，引进插件缓存数据该文件位于forumdata/cache/plugin_插件名称.php一般来说，插件中都要用到此插件配置信息。所以，请把此文件包含进来。至于如何取得插件里的数据以及变量的值，一看插件缓存文件便知。不再多讲。如$pagenum=$_DPLUGIN['example'][‘vars’][‘pagenum’];第四步：设置插件钩子1，了解钩子所谓钩子。我的理解，不过就是把某个地方要运用的代码，先不写在那里，而是放在其它地方。其实就是eval()的功能。如果你还不了解，相信你很快会了解。提醒下，钩子不是一开始写插件程序就要用的，往往是插件的后期阶段，测试无误了，把代码抽出来，换成钩子。因为这些代码所在的地方往往不是插件的程序而是论坛本身的程序，所以，换成钩子比较容易实现管理，比如插件禁用和删除时方便。如要在index.php里的某程序段落里实现输出“你好”，你可以 如果换成钩子的话：从而将echo‘您好’;这个可能是一大段代码用一个简洁的代码表示，用户安装时方便，技术人员修改时也方便，同时即使插件出错也可以不影响，禁用和删除时可以不必删除此钩子。很是方便。1，新增钩子编辑钩子详情再把钩子设为可用。2，获得钩子调用代码，替换程序原来的代码段。 第五步：发布插件1，在桌面上新建一目录，用于存放一会要发布的插件。比如“开发示例插件”。2，在里面新增一个目录“upload”，用于存放要上传的文件以及文件夹。3，新增一个说明文档。用于插件介绍，安装方法，要修改的地方，版权信息等。4，在后台导出插件信息。导出，保存在文件夹中。5，在upload里建立templates/default/，并复制插件模板到此目录。6，在upload里建立plugins/并复制插件程序目录到此目录。如程序里plugins/example/这个目录。（当然，如果你的插件目录不设置在plugins目录下，另当别论。）7，再检查下有没有文件要用到的没有复制出来。比如图片。8，再检查下钩子的修改都在说明里写明了吗？9，OK，这是一个待发布的插件了。别着急，在你的一个另一个论坛上先安装测试一下。如果安装成功且使用正常，说明可以了。10，发布此插件。结束语：本人也刚接触DZ的插件开发不久。水平有限。我是自己摸索的。在学习的过程中，感觉如果有人指点下，还是可以节省很多时间的。特以此献给那些有志于进入DZ插件开发队伍，又一时找不到门的朋友。这是我的经验，经验难免有不足和错误。感谢DZ。联想锋行2008-10-124:03