discuz插件机制－－语言包

婷姐 · 发表于 2023-4-21 19:35:49

马上注册，免费下载更多dz插件网资源。

您需要登录才可以下载或查看，没有账号？立即注册

×

插件语言包

创建语言包给插件创建语言包首先需要创建一个 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}

复制代码

模板的编写详见模板创建、解析原理详解

原文地址：https://addon.dismall.com/library/plug/plugin/plugin_language.html#language
其它用法：https://open.dismall.com/?ac=document&page=plugin_language

©DZ插件网所发布的一切资源仅限用于学习和研究目的；不得将上述内容用于商业或者非法用途，否则，一切后果请用户自负。
本站内容为站长个人技术研究记录或网络，不提供用户交互功能，所有内容版权归原作者所有。您必须在下载后的24个小时之内，从您的电脑中彻底删除上述内容。如果您喜欢该程序，请支持正版软件，得到更好的正版服务。
您在本站任何的赞助购买、下载、查阅、回复等行为等均表示接受并同意签订《DZ插件网免责声明协议》。
如有侵权请邮件与我们联系处理: discuzaddons@vip.qq.com 并出示相关证明以便删除。敬请谅解！

Discuz智能体 · 发表于 2025-3-17 09:34:43

在Discuz插件开发中，语言包的使用是非常重要的，尤其是在开发多语言支持的插件时。以下是如何在Discuz插件中创建和使用语言包的详细步骤：

### 1. 创建语言包文件
首先，你需要在插件的 `data/plugindata/` 目录下创建一个名为 `identifier.lang.php` 的文件。这个文件将包含插件的语言包数据。文件内容通常包含三个数组：

- `$scriptlang`：用于程序脚本文件的语言包。
- `$templatelang`：用于模板文件的语言包。
- `$installlang`：用于安装、升级、卸载脚本的语言包。

例如：

<?php
$scriptlang = array(
'english' => 'This is a script language text.',
);
$templatelang = array(
'english' => 'This is a template language text.',
);
$installlang = array(
'english' => 'This is an installation language text.',
);
?>

复制代码

### 2. 在插件设置中启用语言包
在插件的配置文件中，确保启用了语言包选项。这通常是在插件的 `config.xml` 文件中设置的。

### 3. 在模板中调用语言包
在模板文件中，你可以通过以下方式调用语言包：

{lang identifier:english}

复制代码

这将输出 `$templatelang['english']` 中定义的内容。

### 4. 在程序脚本中调用语言包
在PHP脚本中，你可以通过以下方式调用语言包：

echo lang('plugin/identifier', 'english');

复制代码

这将输出 `$scriptlang['english']` 中定义的内容。

### 5. 在安装脚本中调用语言包
在安装、升级或卸载脚本中，你可以直接使用 `$installlang` 数组来获取语言包内容：

echo $installlang['english'];

复制代码

### 6. 导出语言包
当你导出插件时，语言包会自动包含在导出的XML文件中。这样，插件作者可以轻松地将插件转换为多语言版本。

### 7. 插件模板的放置
插件的模板文件应放置在 `source/plugin/identifier/template/` 目录下。你可以在程序脚本中通过以下方式调用模板文件：

include template('identifier:test');

复制代码

在模板文件中，你可以通过以下方式调用其他模板：

{template identifier:test}

复制代码

### 8. 模板的编写
模板的编写和解析原理详见Discuz的模板创建和解析文档。

### 总结
通过以上步骤，你可以在Discuz插件中轻松地创建和使用语言包，从而实现多语言支持。这对于开发国际化插件非常重要。如果你有更多关于Discuz插件开发的问题，欢迎随时提问！
-- 本回答由人工智能 AI智能体生成，内容仅供参考，请仔细甄别。

Discuz智能体 · 发表于 7 天前

在Discuz插件开发中，语言包的使用是非常重要的，尤其是在多语言支持的场景下。通过语言包，插件可以轻松实现多语言切换，提升用户体验。以下是关于Discuz插件语言包的详细说明和使用方法：

### 1. 创建语言包文件
语言包文件通常放置在 `data/plugindata/` 目录下，文件名为 `identifier.lang.php`，其中 `identifier` 是插件的唯一标识符。文件内容包含三个数组：

- `$scriptlang`：用于程序脚本文件的语言包。
- `$templatelang`：用于模板文件的语言包。
- `$installlang`：用于安装、升级、卸载脚本的语言包。

如果插件不涉及某些类型的语言文字，对应的数组可以忽略。

示例：

<?php
$scriptlang = array(
'english' => '英文',
'chinese' => '中文',
);
$templatelang = array(
'welcome' => '欢迎使用本插件',
'description' => '这是一个示例插件',
);
$installlang = array(
'install_success' => '插件安装成功',
'uninstall_success' => '插件卸载成功',
);
?>

复制代码

### 2. 在插件中调用语言包
#### 2.1 在模板中调用语言包
在模板文件中，可以通过 `{lang identifier:key}` 的方式调用语言包中的内容。

示例：

<div>{lang identifier:welcome}</div>

复制代码

#### 2.2 在程序脚本中调用语言包
在PHP脚本中，可以通过 `lang('plugin/identifier', 'key')` 的方式调用语言包中的内容。

示例：

$welcome_message = lang('plugin/identifier', 'welcome');
echo $welcome_message;

复制代码

#### 2.3 在安装脚本中调用语言包
在插件的安装、升级、卸载脚本中，可以直接通过 `$installlang` 数组获取语言包内容。

示例：

echo $installlang['install_success'];

复制代码

### 3. 语言包的导出
在插件导出时，语言包会自动导出到XML文件中。导出的XML文件内容如下：

<item id="scriptlang">
<english>英文</english>
<chinese>中文</chinese>
</item>
<item id="templatelang">
<welcome>欢迎使用本插件</welcome>
<description>这是一个示例插件</description>
</item>
<item id="installlang">
<install_success>插件安装成功</install_success>
<uninstall_success>插件卸载成功</uninstall_success>
</item>

复制代码

### 4. 插件模板的使用
插件的模板文件通常放置在 `source/plugin/identifier/template/` 目录下。在程序脚本中，可以通过 `include template('identifier:template_name')` 的方式调用模板文件。

示例：

include template('identifier:test');

复制代码

在模板文件中，可以通过 `{template identifier:template_name}` 的方式调用其他模板文件。

示例：

{template identifier:header}

复制代码

### 5. 注意事项
- `data/plugindata/identifier.lang.php` 文件仅供插件设计者在开发模式下使用，插件发布时不需要导出该文件。
- 语言包的内容可以根据需要进行扩展，支持多语言切换。
- 模板文件的编写需要遵循Discuz的模板语法规则。

通过以上步骤，你可以为Discuz插件创建和使用语言包，实现多语言支持，提升插件的国际化能力。如果你有更多关于Discuz插件开发的问题，欢迎随时提问！
-- 本回答由人工智能 AI智能体生成，内容仅供参考，请仔细甄别。