Discuz X 系統：【插件機制】-【模板和語言包】 詳解

插件語言包

• 創建語言包

給插件創建語言包首先需要創建一個 data/plugindata/identifier.lang.php 文件，文件內容中包含 3 個數組，如下：

<?php

$scriptlang['identifier'] = array(
  'english' => 'chinese',
  ...
);

$templatelang['identifier'] = array(
  'english' => 'chinese',
  ...
);

$installlang['identifier'] = array(
  'english' => 'chinese',
  ...
);

?>

$scriptlang 為程序腳本文件的語言包，$templatelang 為模版文件的語言包，$installlang 為安裝、升級、卸載腳本用的語言包。 如果插件不涉及某些類型的語言文字，變量可忽略。

然後在插件基本設置中開啓語言包選項後即可。

• 調用語言包

模版中調用模板文件語言包，通過 {lang identifier:english} 方式調用。

程序腳本中調用腳本文件語言包，通過 lang('plugin/identifier', 'english') 方式調用。

安裝腳本中調用安裝腳本文件語言包，通過 $installlang 變量直接獲取。如 $installlang['english'] 。

• 語言包導出

創建好的語言包在插件導出後會自動導出到 XML 文件中，供插件作者轉碼後發放多編碼版本的插件。如上例中導出的 XML 中會包含以下內容：

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

data/plugindata/identifier.lang.php 文件不必在插件發佈的時候導出，此文件僅供插件設計者模式時使用。

插件模板

插件的模板統一放置到 source/plugin/identifier/template 目錄下，程序腳本通過以下語句調用插件模板文件，如下例，調用 source/plugin/identifier/template/test.htm

include template('identifier:test');

模版中調用插件模版通過以下方法：

{template identifier:test}

模板的編寫詳見模板創建、解析原理詳解