Discuz! X5.0 开发技术文档-App 扩展

admin

概述

Discuz! X5.0 将各个模块功能的包含类文件进行了合并，所有同模块的文件都在各自的目录下。
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=samplep">开启</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=samplep">开启模块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=samplep">开启模块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 插件