> ## Documentation Index
> Fetch the complete documentation index at: https://discuz.p.cafe/llms.txt
> Use this file to discover all available pages before exploring further.

# 模板和语言包

## **插件语言包**

### **创建语言包**

给插件创建语言包首先需要创建一个 `data/plugindata/identifier.lang.php` 文件，文件内容中包含 4 个数组，如下：

```php theme={null}
<?php
​
$scriptlang['identifier'] = array(
  'english' => 'chinese',
  ...
);
​
$templatelang['identifier'] = array(
  'english' => 'chinese',
  ...
);
​
$installlang['identifier'] = array(
  'english' => 'chinese',
  ...
);
​
$systemlang['identifier'] = array(
  'file' => array(
     'english' => 'chinese',
     ...
  ),
  ...
);
​
?>
```

**语言包数组说明：**

* **\$scriptlang** 为程序脚本文件的语言包。
* **\$templatelang** 为模版文件的语言包。
* **\$installlang** 为安装、升级、卸载脚本用的语言包。
* **\$systemlang** 为系统语言包(Discuz! X3 新增)。
* 如果插件不涉及某些类型的语言文字，变量可忽略。

然后在插件基本设置中开启语言包选项后即可。

### **调用语言包**

**模版中调用模板文件语言包：** 通过 `{lang identifier:english}` 方式调用。

**程序脚本中调用脚本文件语言包：** 通过 `lang('plugin/identifier', 'english')` 方式调用。

**安装脚本中调用安装脚本文件语言包：** 通过 `$installlang` 变量直接获取。如 `$installlang['english']`。

**系统语言包：** 用于替换系统语言包中的某些语言条目。

### **语言包导出**

创建好的语言包在插件导出后会自动导出到 XML 文件中，供插件作者转码后发放多编码版本的插件。如上例中导出的 XML 中会包含以下内容：

```xml theme={null}
<item id="language">
    <item id="scriptlang">
        <item id="english"><![CDATA[chinese]]></item>
    </item>
    <item id="templatelang">
        <item id="english"><![CDATA[chinese]]></item>
    </item>
    <item id="installlang">
        <item id="english"><![CDATA[chinese]]></item>
    </item>
    <item id="systemlang">
        <item id="file">
            <item id="english"><![CDATA[chinese]]></item>
        </item>
    </item>
</item>
```

> data/plugindata/identifier.lang.php 文件不必在插件发布的时候导出，此文件仅供插件设计者模式时使用。

## **插件模板**

插件的模板统一放置到 `source/plugin/identifier/template` 目录下，程序脚本通过以下语句调用插件模板文件，如下例，调用 `source/plugin/identifier/template/test`：

```
include template('identifier:test');
```

模版中调用插件模版通过以下方法：

```
{template identifier:test}
```

模板的编写详见相关模板开发文档。