如何让你的插件支持多种语言 – Matomo 平台介绍

这是我们博客系列的下一篇,我们将介绍 Matomo (Piwik) 平台的功能(上一篇是生成测试数据 – Matomo 平台介绍)。这次您将学习如何为您的插件添加翻译功能。您的插件用户一定会非常感激能够使用并翻译成他们的语言!

入门

在本文中,我们假设您已经搭建了开发环境并创建了一个插件。如如何让你的插件支持果没有,请访问Matomo 开发者专区,在那里您可以找到教程“设置 Matomo以及其他插件开发指南”。

管理翻译

Matomo 支持 50 多种语言,并提供多种翻译。核 数据集 心本身提供了一些基本的词汇翻译,例如“访客”和“帮助”。它们存储在目录中/lang。此外,每个插件都可以为本插件中使用的词汇提供自己的翻译。它们位于 中这些目录中,您可以找到每种语言对应的 JSON 文件。每个语言文件又由属于相应组的标记组成。

一个组通常代表一个插件的名称,在本例中是“MyPlugin”。在这个组中,所有标记都列在左侧,相关的翻译列在右侧。

构建翻译密钥

稍后您将会看到,要真正翻译一个单词或一个句子,您需要知道相应的翻译键。此键由一个组和一个用下划线分隔的标记组合而成。例如,您可以使用该键来获取“博客 为什么需要制定连贯的计划? 文章”的翻译。定义新的键就像在“我的插件”组中添加新条目一样简单。

提供默认翻译

如果找不到翻译,则默认使用英语翻译。因此,您应该始终如何让你的插件支持为文件中的所有如提供默认的英文翻译。

添加其他语言的翻译

这就像在插件的 lang 子目录中创建新文件一样简单。文件名由两个字母的 ISO 639-1 语言代码组成,并以扩展名 完成.json。这意味着德语翻译保存在名为 的文件语 whatsapp 資料庫 翻译保存在名为 的文件中要查看可用的语言列表,请查看/lang目录。

重复使用翻译

如上所述,Matomo 自带了相当多的翻译。您可以而且应该重复使用它们,但您应该注意,翻译键将来可能会被删除或重命名。也有可能,某个翻译键是在较新版本中添加的,因此在旧版本的 Matomo 中不可用。我们目前不宣布任何此类变更。尽管如此,99% 的翻译键不会改变,因此重复使用现有的翻译通常是一个好主意。尤其是在您或您的公司无法提供这些翻译键的情况下。要查找任何现有的翻译键,请转到Matomo 安装目录中的“设置”=>“翻译搜索” 。只有启用开发模式后,该菜单项才会出现。

返回頂端