DISCUZ 多语言

插件语言包

创建语言包

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

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26

<?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 中会包含以下内容：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16

<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.htm

include template('identifier:test');

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

{template identifier:test}

未经允许不得转载：开心乐窝-乐在其中 » DISCUZ 多语言