discuz插件开发的准备工作

21fanqie

1 . 插仵实现流程
开始编写论坛插件，用户应当首先对插件实现的流程有一个大致的了解，以下是我们推荐的插件编写流程。
熟练使用Discuz! 论坛系统后，对希望完善或补充的个性化功能进行评估，进而提出插件的功能需求。
（1）对插件做一个概括性的设计，例如：
    （a）需要使用什么菜单；
    （b）什么参数；
    （c）配置哪些选项
    （d）数据结构如何设计
    （f）前后台实现哪些功能，等等。

（2）阅读本文档并在系统设置中实际体验Discuz! 插件接口所实现的功用，例如：
    （a）你的插件应当如何设计才能良好地挂接到论坛系统中；
    （b）插件接口能够实现哪些功能、不能实现哪些功能；
    （c）插件为此而需要做的优化、改造和取舍。

（3）编写相应程序代码和模板语句，实现所需的功能并进行代码测试、兼容性测试和代码改进。

（4）如果需要公开你的插件，可以用插件导出的方式，将插件配置信息导出到一个文本文件中，连同相应的程序和模板文件一同打包。同时，编写一个适合新手的插件的说明书也是必不可少的，其中包括：插件适用的Discuz! 版本、功能概述、兼容性声明、安装方法、使用方法、卸载方法等等。

（5）将插件提供给他人，或自己使用，根据使用者反馈，对插件进行完善。

                               
登录/注册后可看大图

2. 文件命名规范
Discuz! 按照如下的规范对程序和模板进行命名，请在设计插件时尽量遵循此命名规范。
（1）可以直接通过浏览器访问的普通程序文件，以.php 后缀命名。
（2）被普通程序文件引用的程序文件，以.inc.php 后缀命名。
（3）被普通程序文件，或引用程序文件引用的函数库或类库，以.func.php( 函数库）或class.php(类库）后缀命名。
（4）模板文件，以.htm 后缀命名，模板文件只存在于templates 目录中。
（5）模板语言包文件，以.lang.php 后缀命名，语言包文件只存放于templates 目录中，与模板文件同级目录。     插件模板文件存在于 source/plugin/identifier/template/ 目录中，手机版插件模板存在于 source/plugin/identifier/template/mobile/目录中。
（6）被编译后的模板文件，以.tpl.php 后缀命名，前面的数字是模板套系的ID, 下划线后面的是模板原名，编译模板文件只存在于forumdata/templates 目录中。
（7）动态缓存文件，存放于 ./data/cache 目录中，依据不同的功用进行独立的命名。
（8）使用后台数据备份功能生成的备份文件，通常以.sql 为后缀，存放于data/ 目录中。
（9）有些目录中存在内容为空白的index.hon 文件，此类文件是为了避免Web, 服务器打开Directory Index 时可能产生的安全问题。
[X2.5新增内容] 从 Discuz! X2.5 开始，产品对数据表进行了封装，封装后的文件统一命名为 Table 类，通过“C::t(Table类文件名)”方式调用。插件如需封装自己的数据表，可将 Table 类文件存放于 source/plugin/identifier/table/ 目录下，并以 table_表名.php 格式命名，详见X2.5的新程序架构。