提示
有关 Phrase Strings 中 WordPress 集成的信息,请参阅 WordPress (Strings)。
WordPress 是一个开源的博客和网站内容管理系统。它还支持邮件列表、论坛、媒体库、分析和在线商店。
该连接器支持 WPML 和 Multilingual Press 插件。它会在安装 Phrase 插件 期间自动检测已安装的插件。可以在 设置中查看插件运行的模式。
不支持 WordPress VIP 平台。
该连接器不支持 2FA。可以为 wp-admin 或前端启用 2FA,但所有以 /wp-json/memsource/v1/connector 开头的端点必须能够从 Phrase 访问且无需 2FA。连接器使用的端点已通过 Phrase 令牌进行保护,并且可以通过添加基本 auth 和/或仅允许从 Phrase IP 访问来提高安全性。
支持的内容类型
WordPress 连接器允许直接从 WordPress 下载源内容并将目标本地化内容上传至 WordPress,适用于以下内容类型:
-
文章
-
页面
-
标签
-
分类
-
自定义文章类型
-
自定义分类法
支持的状态
-
已发布和草稿(文章及衍生内容支持上下文预览)
注意
某些 HTML 标签存在风险,CAT 编辑器在显示预览时会从 HTML 中移除这些标签。这是为了确保用户的数据隐私和安全。
被移除标签的示例包括 FORM、IFRAME、SCRIPT、SVG、VIDEO、EMBED、OBJECT 或 background-image CSS 属性。
支持的插件
Phrase Translation Plugin for WordPress 支持以下插件:
-
Avada
-
Divi
-
Elementor
-
Gutenberg
-
预定义区块会自动配置。在 菜单下的 Gutenberg 区块 中配置 。如果未配置,内容将不会被导入。
-
-
Yoast SEO
-
SEOPress
-
WPBakery 页面构建器(前身为 Visual Composer)
-
Avia (Enfold 主题)
-
必须取消选择 Enfold 自定义字段,因为它们不受支持。点击您 WordPress 账户中的 Phrase 插件,前往 页面以取消选择 Enfold 自定义字段。
-
此连接器有多种使用案例:
-
项目经理可以直接从在线存储库将文件添加到项目中。
-
借助高级自定义字段 (ACF) 插件,可以在 WordPress 内定义单独的工作流程。Phrase 会监控工作流程步骤的更改并相应地进行更新,例如从 翻译 到 翻译中 再到 翻译完成。
-
设置 提交者门户,允许提交者直接从在线存储库将文件添加到请求中。
-
使用 自动项目创建 (APC),以便在检测到受监控文件或文件夹的 最后修改日期发生更改时,自动创建新项目。
上下文预览功能可在CAT网页编辑器和CAT桌面编辑器中实时预览原文或译文。
支持表格、列、各种图形、格式和字体(如果由用户安装)。此功能旨在在翻译时提供上下文,并非原文或已完成文档的完美呈现;预计会出现一些视觉差异。它也可能受到“访问和安全”设置中启用/禁用 允许在编辑器中加载外部内容 选项的影响。
Phrase 要求:
-
穿过企业防火墙以访问本地安装。
-
验证进入创作环境。
本地安装的防火墙配置:
-
必须能够从 Phrase 服务器 IP 地址访问安装。请参阅 Phrase 服务器 IP 地址 获取当前列表。
-
域名必须能够从外部解析。
注意
某些 HTML 标签存在风险,CAT 编辑器在显示预览时会从 HTML 中移除这些标签。这是为了确保用户的数据隐私和安全。
被移除标签的示例包括 FORM、IFRAME、SCRIPT、SVG、VIDEO、EMBED、OBJECT,或 background-image CSS 属性。
-
安装 WPML 或 Multilingual Press 插件以创建和管理多语言页面。
-
转到左侧导航面板中的 。
-
点击 连接器,然后点击 显示连接器设置。
-
点击 生成新令牌 以生成用于建立连接的令牌。
-
根据文章状态选择要导入的文章,并确定发送回的译文应分配什么状态。
-
导航至 自定义字段 页面,并从列表中选择需要从 WordPress 导出并翻译的自定义字段。默认情况下,所有自定义字段均被选中以供导出。
-
导航至 页面,并将 WordPress 语言映射到 Phrase 语言代码。
-
前往 页面查看支持的短代码列表,或添加使用第三方短代码插件创建的自定义短代码。
-
将翻译内容应用于 (APC) 中指定的语言。
自动项目创建仅为自定义字段中指定的语言创建作业,该字段由其 标识 – 例如 target_languages。字段类型应为多值下拉列表,其中值需与 语言代码 匹配。
注意
WPML 中的语言必须与项目的语言相匹配。为了支持诸如 法语(加拿大) 之类的本地变体,请在 WordPress 内的 WPML 面板中定义语言。
-
在“设置”
页面中,向下滚动至 部分。
-
点击 连接器。
页面随即打开。
-
点击 新建连接器。
页面随即打开。
-
将 类型 更改为 WordPress 并为该连接器提供一个名称。
-
输入 WordPress 站点 URL。
示例:如果您的 WordPress 管理页面 URL 为 http://blog.phrase.com/wp-admin/index.php,则站点 URL 应为 http://blog.phrase.com/。
-
输入 Phrase WordPress 插件令牌,并填入来自 Phrase 插件配置的令牌。
-
如果站点使用基本 HTTP 身份验证进行保护,请提供在 WP 管理后台中设置的 用户名 和 密码。
-
点击 测试连接。
如果连接成功,将显示已配置语言的列表。如果连接失败,将出现一个红色感叹号和一条错误消息。将鼠标悬停在图标上可查看更多详细信息。
如果更改了源或目标,点击 将刷新已配置语言的选择。
-
点击 保存。
连接器已添加到 页面的列表中。
删除连接器
要删除连接器:
注意
如果连接器仍与项目中的未完成作业(包括回收站中的作业)相关联,则无法将其删除。尝试删除此类连接器会返回“删除连接器失败”错误。
解决方法:打开与该连接器关联的项目,并完成或删除所有剩余作业。前往 并清空它,以移除仍与该连接器关联的任何作业。重试删除连接器。
如果导入的文本中充满了代码该怎么办
一些 WordPress 插件会将代码注入到您的 WordPress 页面中。如果不进行进一步配置,Phrase 无法处理此代码。
已知会导致此问题的插件包括:
-
Avia Layout Builder
-
Divi Builder
-
Fusion Builder
-
Visual Composer
-
WPBakery(前身为 Visual Composer)
若要在此情况下配置 Phrase,请在 WordPress 中指明您希望翻译的自定义字段。
转至 插件,然后转至 ,并根据插件格式的规范添加短代码。
WPBakery 设置:
配置连接器时连接测试失败
某些 WordPress 插件(如 WP Hardening、WP Security、WP Staging、Disable WP REST API 或 Wordfence Security)提供了禁用 JSON API 的选项。请确保 WordPress API 未被禁用。
短代码属性被随机字符串损坏
在某些情况下,短代码属性名称可能会在导入或导出过程中因添加了随机哈希字符串而损坏,例如 label:0336e6e6d2197e47=\"Play Now\" 而不是 label=\"Play Now\"。
此问题是由过时的 Phrase WordPress 插件版本引起的。将 Phrase WordPress 插件更新至最新可用版本,然后创建新的翻译任务,以验证短代码属性是否已正确导入和导出。