Discuz! X5.0 开发技术文档 App 扩展
2024/11/12 21:21:47
概述
Discuz! X5.0 将各个模块功能的包含类文件进行了合并，所有同模块的文件都在各自的目录下。
X3.5 版本的 /source/module 目录已经合并到各个 app 的子目录 /source/app/xxx/module 中。
X3.5 版本的 /source/module 目录已经合并到各个 app 的子目录 /source/app/xxx/module 中。
如果您要进行 app 的扩展，可直接在 /source/app 下创建目录，然后在此目录下创建同名文件，例如 /source/app/xxx/xxx.php
- <?php
- require './source/class/class_core.php';
- $discuz = C::app();
- $discuz->cachelist = [];
- $discuz->init();
- require_once appfile('yyy/zzz'); // 调用 /source/app/xxx/yyy/zzz.php 文件
/source/app/xxx 目录下可以直接创建模板文件，可用类似以下方式调用 source/app/xxx/template/tpl.php 模板文件。仅支持 php 格式是模板文件：
- require_once template('tpl', 0, 'source/app/xxx/template');
或者
- require_once apptemplate('tpl');
/source/app/xxx/admin 目录可存放 App 自己的管理后台文件，通过 URL “admin.php?action=app&operation=xxx:yyy” 可以直接调用 /source/app/xxx/admin/yyy.php。
在 admin/ 目录下创建 switch.php 可直接在“站点功能”添加当前模块的开关入口，文件内容如下：
- class app_sample_switch {
- const Icon = 'source/app/sample/static/image/icon.png';
- const Name = 'sample';
- const Desc = 'description';
- public static function getStatus() {
- return 1;
- }
- public static function getOptions() {
- return '<a href="'.ADMINSCRIPT.'?action=app&operation=sample:op">开启</a>';
- }
- }
如果 App 存在多个开关项，使用以下的代码结构：
- class app_sample_switch {
- public static function getModules() {
- return ['module1', 'module2'];
- }
- }
- class app_sample_switch_module1 {
- const Icon = 'source/app/sample/static/image/icon.png';
- const Name = 'sampleModule1';
- const Desc = 'descriptionModule1';
- public static function getStatus() {
- return 1;
- }
- public static function getOptions() {
- return '<a href="'.ADMINSCRIPT.'?action=app&operation=sample:op">开启模块1</a>';
- }
- }
- class app_sample_switch_module2 {
- const Icon = 'source/app/sample/static/image/icon.png';
- const Name = 'sampleModule2';
- const Desc = 'descriptionModule2';
- public static function getStatus() {
- return 1;
- }
- public static function getOptions() {
- return '<a href="'.ADMINSCRIPT.'?action=app&operation=sample:op">开启模块2</a>';
- }
- }
App 的语言包是对默认语言包的拓展，在 /source/app/xxx/language 目录下放入与 /source/language 中的同名文件，即可对原有语言包进行扩展。但是 $lang 变量要使用 “+=” 进行赋值。
/source/app/sample/language/lang_template.php
- <?php
- $lang += [
- 'sameple_test' => '测试文字',
- ];
对于 X5.0 支持的多语言包拓展则是在 /source/app/xxx/i18n/langkey 目录下。
插件范例X5.0 App扩展完整范例见 sample 插件