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}

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