internetztube/craft-spreadsheet-translations

支持从谷歌表格动态翻译。

3.0.0-beta.1 2024-04-09 16:38 UTC

This package is auto-updated.

Last update: 2024-09-09 17:33:02 UTC


README

此插件允许非开发人员通过谷歌表格访问静态翻译。

Share Image

屏幕截图

Sample Spreadsheet Translation Files Utilities Settings

要求

此插件需要Craft CMS 5.0.0或更高版本。

安装

要安装此插件,请按照以下步骤操作

  1. 使用Composer通过 internetztube/craft-spreadsheet-translations 安装
  2. 在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-handles
    
    ⚠️ 确保存在 translations/<lang>/site.php!否则,不会从模板中拉取任何翻译!
  • 将所有缺失的站点语言推送到电子表格。不删除任何语言!
    php craft spreadsheet-translations/main/push-missing-languages
    

这些工具也可在控制面板的“工具”部分中找到。

设置/配置

谷歌API

此插件需要一个谷歌API令牌。在这里,您将学习如何创建一个。

  1. 前往 https://console.developers.google.com/apis/library/sheets.googleapis.com
  2. 点击 启用
  3. 在侧边栏中点击 凭证
  4. 点击 创建凭证,然后选择 服务帐户密钥
  5. 点击 选择... 并创建一个新的服务帐户 使用现有的服务帐户。
  6. 只需填写一个名称和一个电子邮件前缀。您将在下一步需要电子邮件地址。
  7. 保持 JSON 作为密钥类型。
  8. 点击 创建
  9. 此服务帐户不需要特殊角色。因此,在模态框中点击 无角色创建
  10. 已下载一个JSON文件。此文件的必须内容需要复制到插件设置中的 访问密钥文件内容 字段。
  11. 前往您的电子表格,并与服务帐户的电子邮件地址共享。

谷歌表格

除了 访问密钥文件内容 之外,还需要在设置中提供 工作表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 提供