Discuz技术手册-刘泓宾.pdf

目 录 官方文档 Discuz! 的插件机制 准备工作 插件接口 基础 架构 文件结构 路由 数据库 数据库表 数据库字典x3.4 数据库字典x3 本文档使用 看云 构建 - 2 - 官方文档 官方文档 这是官方文档 ，来之于discuz官方 ，由本人收集整理 ，如有错误的地方希望大家指正 ，文档不定期更新 ，欢迎大 家参与文档编辑。 本文档使用 看云 构建 - 3 - Discuz! 的插件机制 Discuz! 的插件机制 准备工作 插件接口 本文档使用 看云 构建 - 4 - 准备工作 准备工作 插件实现流程 开始编写社区插件 ，您应当首先对插件实现的流程有一个大致的了解 ，以下是我们推荐的插件编写流程 ： 熟练使用 Discuz! 社区系统后 ，对希望完善或补充的个性化功能进行评估 ，进而提出插件的功能需求。 对插件做一个概括性的设计 ，例如 ：需要使用什么菜单、什么参数 ，配置哪些选项、数据结构如何设计、前 后台实现哪些功能等等。 阅读本文档并在系统设置中实际体验 Discuz! 插件接口所实现的功用 ，例如 ：您的插件应当如何设计才 能良好的挂接到社区系统中来。插件接口能够实现哪些功能、不能实现哪些功能 ，插件为此而需要做的优 化、改造和取舍。 编写相应程序代码和模板语句 ，实现所需的功能并进行代码测试、兼容性测试和代码改进。 如果需要公开您的插件 ，可以用插件导出的方式 ，将插件配置信息导出到一个 XML 文件中 ，连同相应的程 序和模板文件一同打包。同时 ，编写一个适合新手的插件的说明书也是必不可少的 ，其中包括 ：插件适用的 Discuz! 版本、功能概述、兼容性声明、安装方法、使用方法、卸载方法等等。 将插件提供给他人 ，或自己使用 ，根据使用者反馈 ，对插件进行完善。插件实现流程至此结束。 文件命名规范 Discuz! 按照如下的规范对程序和模板进行命名 ，请在设计插件时尽量遵循此命名规范 ： 可以直接通过浏览器访问的普通程序文件 ，以 .php 后缀命名。 被普通程序文件引用的程序文件 ，以 .inc.php 后缀命名。 被普通程序文件 ，或引用程序文件引用的函数库或类库 ，以 .func.php (函数库) 或 .class.php (类 库) 后缀命名。 模板文件 ，以 .htm 后缀命名 ，插件模板文件存在于 source/plugin/identifier/template/ 目录 中 ，手机版插件模板存在于 source/plugin/identifier/template/mobile/ 目录中 模板语言包文件 ，以 .lang.php 后缀命名 ，插件语言包文件开发时存放于 data/plugindata/ 目 录中 ，文件名为 identifier.lang.php 。 动态缓存文件 ，存放于 ./data/cache 目录中 ，依据不同的功用进行独立的命名。 使用后台数据备份功能生成的备份文件 ，通常以 .sql 为后缀 ，存放于 data/ 目录中。 有些目录中存在内容为空白的 index.htm 文件 ，此类文件是为了避免 Web 服务器打开 Directory Index 时可能产生的安全问题。 [X2.5新增内容] 从 Discuz! X2.5 开始 ，产品对数据表进行了封装 ，封装后的文件统一命名为 Table 类 ， 通过 “C::t(Table类文件名 )” 方式调用。插件如需封装自己的数据表 ，可将 Table 类文件存放于 source/plugin/identifier/table/ 目录下 ，并以 table_表名 .php 格式命名 ，详见X2.5的新 本文