internetztube / craft-spreadsheet-translations
支持从谷歌表格动态翻译。
3.0.0-beta.1
2024-04-09 16:38 UTC
Requires
- craftcms/cms: ^5.0.0
- google/apiclient: ^2.4
This package is auto-updated.
Last update: 2024-09-09 17:33:02 UTC
README
此插件允许非开发人员通过谷歌表格访问静态翻译。
屏幕截图
要求
此插件需要Craft CMS 5.0.0或更高版本。
安装
要安装此插件,请按照以下步骤操作
- 使用Composer通过
internetztube/craft-spreadsheet-translations安装 - 在Craft控制面板的设置>插件中安装插件。您也可以通过Craft控制面板的插件商店安装此插件。
问题
请将您发现的问题报告给 问题 页面。
动态字符串
- 您无法翻译动态字符串。请使用 消息参数。
{{ ("Welcome back, " ~ currentUser.friendlyName ~ "!") | t }}{{ 'Welcome back, {name}!' | t(params = { name: currentUser.friendlyName}) }}
控制台工具
- 将所有翻译从电子表格拉入磁盘上的静态文件。不删除任何处理程序!
php craft spreadsheet-translations/main/pull-translations - 将模板中所有缺失的翻译处理程序推送到电子表格。不删除任何处理程序!
⚠️ 确保存在php craft spreadsheet-translations/main/push-missing-handlestranslations/<lang>/site.php!否则,不会从模板中拉取任何翻译! - 将所有缺失的站点语言推送到电子表格。不删除任何语言!
php craft spreadsheet-translations/main/push-missing-languages
这些工具也可在控制面板的“工具”部分中找到。
设置/配置
谷歌API
此插件需要一个谷歌API令牌。在这里,您将学习如何创建一个。
- 前往 https://console.developers.google.com/apis/library/sheets.googleapis.com。
- 点击
启用。 - 在侧边栏中点击
凭证。 - 点击
创建凭证,然后选择服务帐户密钥。 - 点击
选择...并创建一个新的服务帐户 或 使用现有的服务帐户。 - 只需填写一个名称和一个电子邮件前缀。您将在下一步需要电子邮件地址。
- 保持
JSON作为密钥类型。 - 点击
创建。 - 此服务帐户不需要特殊角色。因此,在模态框中点击
无角色创建。 - 已下载一个JSON文件。此文件的必须内容需要复制到插件设置中的
访问密钥文件内容字段。 - 前往您的电子表格,并与服务帐户的电子邮件地址共享。
谷歌表格
除了 访问密钥文件内容 之外,还需要在设置中提供 工作表ID 和 存储翻译的表名。
工作表ID
工作表ID只是URL的一部分。
https://docs.google.com/spreadsheets/d/<SPREADSHEET-ID>/edit
https://docs.google.com/spreadsheets/d/11fRj44MwhGqFGpIYHGfwpA69ed-Z657WdiXex6kvuo8/edit -> 11fRj44MwhGqFGpIYHGfwpA69ed-Z657WdiXex6kvuo8
表名
这是存储翻译并应用于此项目的表的名称。
由 Frederic Köberl 提供




