App 扩展_Discuz!开放平台 - Discuz!应用中心

App 扩展

<div class="tbmu bbda mbm"><a href="?ac=document&page=dev_x5_index">结构概述</a><span class="pipe">|</span><a href="?ac=document&page=dev_x5_app" class="a">App 扩展</a><span class="pipe">|</span><a href="?ac=document&page=dev_x5_plugin">新增插件接口</a><span class="pipe">|</span><a href="?ac=document&page=dev_x5_template">新增模板接口</a><span class="pipe">|</span><a href="?ac=document&page=dev_x5_witframe">云插件</a></div>

# 概述
Discuz! X5.0 将各个模块功能的包含类文件进行了合并，所有同模块的文件都在各自的目录下。
X3.5 版本的 /source/module 目录已经合并到各个 app 的子目录 /source/app/xxx/module 中。

如果您要进行 app 的扩展，可直接在 /source/app 下创建目录，然后在此目录下创建同名文件，例如 /source/app/xxx/xxx.php

```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 格式是模板文件：

```php
require_once template('tpl', 0, 'source/app/xxx/template');
```

或者

```php
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 可直接在“站点功能”添加当前模块的开关入口，文件内容如下：
```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 存在多个开关项，使用以下的代码结构：

```php
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
<?php

$lang += [
	'sameple_test' => '测试文字',
];
```

对于 X5.0 支持的多语言包拓展则是在 /source/app/xxx/i18n/langkey 目录下。

# 插件范例
X5.0 App扩展完整范例见 [sample 插件](https://gitee.com/Discuz/DiscuzXDevSample/tree/X5.0 "sample 插件")

开放平台

App 扩展

开发文档