本指南适用于目录位于 WordPress 之外的商店:在电子表格、PIM、ERP 或供应商提要中。产品通过导入工具、REST API 或计划任务到达 WooCommerce,而您很少打开产品编辑器。
您需要 WPML 、WPML Multilingual & Multicurrency for WooCommerce ,对于带有翻译的导入,还需要 WPML导出和导入 。
第 1 部分:从外部管理的多语言商店如何运作
每种语言一个产品,由翻译组链接
每种语言都有自己的 WooCommerce 产品,并具有自己的 ID。WPML 将这些语言链接在一个翻译组 中。原始产品 是商店默认语言的产品;其他语言是它的翻译。
在我们的示例商店中,Zip-Up Hoodie 在英语中是产品 14,在德语中是 121,在法语中是 122。它们中任何一个的每个 REST API 响应都带有相同的映射:"translations": {"de":"121","en":"14","fr":"122"}。
SKU 在每种语言中都是相同的。 可变产品的变体也保持相同的变体 SKU。
SKU 是外部系统的关键。 WooCommerce 自己的查找 wc_get_product_id_by_sku() 返回原始产品,而不是翻译。
列表一次返回一种语言。 GET /wc/v3/products?sku=HP-HD-ZIP 仅返回默认语言。添加 &lang=de 以获取一种语言,或添加 &lang=all 以获取所有语言。
WPML 复制到每种语言的内容以及它翻译的内容
当原始产品通过产品编辑器、CSV 导入或 REST API 发生更改时,WPML 会将以下值复制到每个翻译:
常规价格和促销价格
库存数量和库存状态
SKU、重量和尺寸
产品图像和图库(每种语言都有自己的图像副本)
类别和标签(作为翻译后的类别或标签)
追加销售和交叉销售(指向相同语言的产品)
发布状态
对于可变产品:每个变体的价格和库存、价格范围、新的全局属性项(作为其翻译,例如 Black 的翻译 Schwarz 和 Noir)以及新的变体
以下内容在每种语言中保持不同,因为它们已被翻译:
名称、说明和简短说明
别名(产品地址,例如 /de/produkt/kapuzenjacke-mit-reissverschluss/)
属性项,例如 Blue、Blau 和 Bleu
特定于产品的属性值,例如仅在此产品上设置的“Material”
库存由所有语言共享。
将价格和属性写入原始产品。 如果您的系统将价格或属性写入翻译,该翻译将保留原始产品的值。由于库存是共享的,写入任何语言的库存都会成为所有语言的库存。
第二种货币的价格 也遵循原始产品(请参阅 WooCommerce 多货币 )。在原始产品上设置它们,使用 REST API 中的 custom_prices("custom_prices": {"USD": {"regular_price": "55.00", "sale_price": "49.00"}})或 CSV 列 Meta: _wcml_custom_prices_status、Meta: _regular_price_USD、Meta: _sale_price_USD 和 Meta: _price_USD。然后,每种语言都会以该货币显示这些价格。
当多货币开启且该货币是您商店的货币之一时,将存储 custom_prices。请按如下方式发送:
首先开启多货币。 前往 WPML → 设置 → 多货币 ,勾选启用多货币模式 并单击保存更改 。在基于以下条件显示货币 下,选择一个选项(例如网站语言 ),然后单击保存更改 。接着使用添加货币 来添加每种货币。在多货币关闭的情况下,WPML 不会存储来自 custom_prices 的任何内容。
使用您商店的货币代码。 WPML 仅存储商店货币的价格。不会存储任何其他代码的价格。
对于可变产品,请在每个变体上发送 custom_prices ,而不是在父级上发送。WPML 将其存储在原始变体上,每种语言都会显示它。如果在父级上发送,则不会被存储。
从 meta_data 读取存储的价格 (_regular_price_USD、_sale_price_USD、_price_USD)。REST 调用的响应不包含 custom_prices 字段。
副本或独立翻译
WPML 有两种翻译产品。您拥有的类型决定了导入文本的处理方式。
副本 独立翻译
说明 WPML 维护的副本 带有自己文本的翻译
下次保存原始产品后的文本 被原始产品的文本替换 仅在关闭“翻译所有内容”或将产品 设置为 None 时保留
价格和库存 遵循原始产品 遵循原始产品
您在哪里可以看到它: 副本的“语言”框中会显示“此文档是 ... 的副本,且由 WPML 维护。”,并带有独立翻译 按钮。
将副本转换为独立翻译: 在副本的“语言”框中单击独立翻译 ,或者,如果涉及许多产品,请前往 产品 → 所有产品 ,切换到翻译的语言,勾选这些产品,然后选择 批量操作 → 独立翻译 。
第 2 部分中的流程会创建什么: 流程 A 使用翻译所有内容 创建翻译。流程 B 导入独立翻译。两者都不需要副本。
在首个产品导入前设置商店
运行 WooCommerce Multilingual 设置向导。 当您激活 WPML Multilingual & Multicurrency for WooCommerce 时,该向导将打开。其屏幕包括商店页面 、全局属性 和多货币 。第一个屏幕会在每种语言中创建商店、购物车、结账和我的账户。
使您的全局属性可翻译。 在向导的“哪些产品属性应可翻译?”屏幕上,勾选每个属性,例如颜色和尺寸。稍后,相同的设置位于 产品 → 属性 → 编辑 下的可翻译? 复选框中。
在产品之前翻译属性项。 前往 WPML → 翻译 ,打开分类法 选项卡,在“选择要翻译的分类法”下选择属性,然后翻译每个项。在开启翻译所有内容(流程 A)的情况下,WPML 会为您翻译新项。
第 2 部分:无代码构建
选择您的流程:单一语言或所有语言
流程 A:WPML 翻译 流程 B:您导入所有语言
您的系统包含什么 仅商店的默认语言 所有语言
您导入什么 原始产品 原始产品及其翻译,通过 SKU 链接
谁来翻译 翻译所有内容,使用 Private Translation Cloud (PTC) (在新标签页中打开) 您的译者,在导入之前
当原始内容的文本发生更改时 翻译所有内容会翻译这些更改 WPML 会将该翻译标记为需要更新;您的下一个文件将引入新文本
价格和库存 跟随原始内容 跟随原始内容
流程 A 适用于只保留一种语言,但希望在没有翻译文件的情况下获得所有其他语言的商店。流程 B 适用于其 PIM 或译者已经掌握所有语言文本的商店。
使用 WooCommerce CSV 导入器或 WP All Import 的流程 A
开启一次翻译所有内容:
前往 WPML → 翻译 ,然后单击设置翻译所有内容 。
选择内容。 在“要翻译的内容”下,保留所有产品 ,然后单击继续 。
选择翻译的发布方式。 在“发布方法”下,保留无需审核即可发布 。
单击启用自动翻译所有内容。
仅以商店的默认语言导入您的产品。 使用 产品 → 导入 (WooCommerce 的 CSV 导入器)或 All Import → New Import (带有 WooCommerce 附加组件的 WP All Import)。您的文件不需要 WPML 列。
导入本身会将翻译排入队列。随后,WPML 会将每个产品、变体、类别和新属性项翻译成每种语言并发布它们。您无需手动启动任何操作,也不需要打开任何 WPML 管理后台页面。您可以在 WPML → 翻译 下跟踪进度。
当您编辑原始内容时 ,翻译所有内容仅翻译更改的部分。翻译的其余部分将逐字保留。
翻译所有内容会翻译已发布的产品,包括外部产品。它不会翻译私密产品。草稿也会等待:自动翻译草稿 (位于 WPML → 设置 → AI 翻译 下的高级翻译编辑器框中)默认处于关闭状态,当您开启它时,WPML 仅在您再次保存草稿时才会翻译该草稿。要翻译草稿和私密产品,请从 WPML → 翻译 发送它们(请参阅故障排除)。
如果您想更改翻译 ,请从产品的“语言”框中打开它(编辑 ... 翻译 ),在高级翻译编辑器中对其进行编辑,然后单击保存并完成 。当原始内容稍后发生更改时,您对未更改句子所做的编辑将被保留。
使用 WooCommerce CSV 导入器的流程 B
在流程 B 中,您的文件包含所有语言。
在首次导入之前为导入的翻译设置翻译所有内容:
前往 WPML → 翻译 。如果翻译所有内容处于关闭状态,请保持关闭并继续处理文件。
如果您希望 WPML 自动翻译您的页面、文章和字符串 ,请单击设置翻译所有内容 。在“要翻译的内容”下,将产品 设置为无 。单击继续 ,保留无需审核即可发布 ,然后单击启用自动翻译所有内容 。
如果翻译所有内容已开启 ,请单击“已启用自动翻译所有内容”框中的三点菜单,选择调整内容限制 ,将产品 设置为无 ,然后单击保存更改 。已经在进行中的翻译仍会完成。
将产品设置为无 后,WPML 会逐字保留您导入的产品翻译。当原始内容发生更改时,WPML 会将其翻译标记为需要更新,而您的下一个文件将引入新文本。
准备一个包含所有语言的文件。 使用 WooCommerce 的常规列并添加四个 WPML 列:
列 包含的内容 示例
Meta: _wpml_import_translation_group链接各语言的值。使用 SKU。 HP-JK-SHELL
Meta: _wpml_import_language_code该行的语言 de
Meta: _wpml_import_source_language_code原始内容的语言,即商店的默认语言。在原始行上为空。 en
Meta: _wpml_import_after_process_post_statusWPML 链接产品后的状态 publish
对行进行排序 :按语言排序,原始内容排在最前。在每种语言中,产品排在其变体之前。
将产品作为草稿导入: 产品上 Published = -1,变体上为 1。
为每种语言提供其自己的文本: 名称、说明、类别(Kleidung > Jacken)和属性值(Blau, Grün)。
在每种语言中保留商店的属性名称 (Color、Size)。在 WPML → 翻译 → 分类法 下翻译属性标签。
通过 SKU 提供相关产品和父级产品 ,每种语言使用相同的 SKU。
来自示例文件的可变产品德语行:
复制 已复制
Type,SKU,Name,Published,...,Categories,...,Parent,Attribute 1 name,Attribute 1 value(s),...,Meta: _wpml_import_translation_group,Meta: _wpml_import_language_code,Meta: _wpml_import_source_language_code,Meta: _wpml_import_after_process_post_status
variable,HP-JK-SHELL,Verstaubare Regenjacke,-1,...,Kleidung > Jacken,...,,Color,"Blau, Grün",...,HP-JK-SHELL,de,en,publish
variation,HP-JK-SHELL-BLU-S,,1,...,,...,HP-JK-SHELL,Color,Blau,...,HP-JK-SHELL-BLU-S,de,en,publish
导入:
前往 产品 → 导入 ,并在“从您的电脑中选择一个 CSV 文件:”下选择文件。不要勾选更新现有产品 。单击继续 。
检查映射。 四个 Meta: 列映射到作为元数据导入 。单击运行导入程序 。
前往 WPML → WPML导出和导入 。屏幕上会显示“干得好。我们看到 33 篇文章已导入并需要语言信息。”。单击运行 WPML 导入 。
等待显示“多语言导入完成”。
在步骤 3 之前,每个产品都是英语草稿,每个变体都是英语变体,它们都没有链接到其原始语言。之后:
每个产品和每个变体都跨语言链接。
所有内容都已发布。
这些翻译是独立翻译。
类别和属性术语跨语言链接,并且每种语言的变体使用其自己的术语。
追加销售指向相同语言的产品,并且每种语言都有自己的图像副本。
类别和属性术语包含在产品行中,因此此导入程序不需要单独的分类法导入。如果商店中已存在翻译后的属性术语,导入程序会使用它们,并且运行 WPML 导入 会将它们连接到原始语言。
要让 WPML 自动翻译选定的产品 (当“产品”设置为无 时):
保持开启翻译所有内容。
在文件中添加 Meta: _wpml_import_tea 列 ,并在每个要翻译的产品上设置值为 1。
在同一文件中保留 Meta: _wpml_import_translation_group 。
导入文件 ,然后前往WPML → WPML导出和导入 并单击运行 WPML 导入 。进度列表会显示“发送文章以进行自动翻译”,然后 WPML 会翻译并发布这些产品。
使用 WP All Import 的流程 B
您需要 WP All Import Pro 及其 WooCommerce 附加组件。免费版不导入自定义字段,而 WPML 列属于自定义字段。
工作顺序为:首先是属性术语及其连接的翻译,然后是产品。 这样,翻译后的产品页面就会以各自的语言提供每个属性值,例如 Bleu marine 而不是 Navy。
连接商店中已有的翻译术语。 对于商店中已存在的每个翻译属性术语,前往产品 → 属性 ,单击该属性的配置术语 ,将管理后台栏切换到该术语的语言,然后单击术语名称。在“语言”框中,在这是以下内容的翻译 下选择其原始语言,然后单击更新 。随后,每个连接的术语都会在WPML → 翻译 → 分类法 上的相应语言下显示一个铅笔图标。
在运行导入之前,在管理后台栏的语言切换器中将管理后台语言设置为商店的默认语言 。
导入类别。 前往All Import → New Import → Upload a file ,选择Taxonomies → Product categories 。在术语元数据 下,添加三行:_wpml_import_language_code、_wpml_import_source_language_code 和 _wpml_import_translation_group,每一行都映射到文件中同名的列。在 Other Category Options → Parent Term 下设置父级。
以相同方式导入属性术语, 例如 Taxonomies → Product Color ,使用相同的三行术语元数据。
连接术语。 前往WPML → WPML导出和导入 并单击运行 WPML 导入 。在WPML → 翻译 → 分类法 下检查(在“选择要翻译的分类法”中选择分类法),确保每个术语在每种语言的旗帜下都有一行带铅笔图标的记录。将鼠标悬停在铅笔图标上可查看翻译后的名称。“+”表示该语言没有翻译。如果翻译后的术语列在自己的行中,则表示未连接。
导入产品。 选择 WooCommerce Products 。在 WooCommerce Add-On 部分,映射 SKU、价格、库存和属性。在自定义字段 下,添加三行 _wpml_import_*。
再次运行 WPML 导入 ,并等待显示多语言导入完成 。
我们的示例术语文件:
复制 已复制
name,_wpml_import_language_code,_wpml_import_source_language_code,_wpml_import_translation_group
Navy,en,,color-navy
Marineblau,de,en,color-navy
包含每种语言的产品文件的两项设置:
变体行的类型为 variable (与其父级相同),位于您映射到 Set Product Type With XPath 的列中。
使用每种语言的键将变体链接到其父级。 在 Variations 下,选择 All my variable products have SKUs or some other unique identifier... ,并将 SKU element for parent 和 Parent SKU element for variation 映射到诸如 HP-OW-RAIN-de 之类的键。将真实的 SKU(每种语言都相同)映射到常规 → SKU 并映射到翻译组。另一种方法是每种语言文件进行一次导入。
无论您是从 wp-admin、WP-CLI 还是按计划启动 WP All Import 导入,此顺序都适用。
按计划更新库存和价格
更新原始产品。WPML 会立即将库存和价格复制到每种语言。
使用 WooCommerce CSV 导入程序:
仅发送您更改的列。 带有空单元格的列会写入空值。我们的示例文件:
复制 已复制
SKU,Stock,Regular price,Meta: _wpml_import_language_code
HP-JK-FIELD,11,95,en
HP-JK-SHELL-BLU-S,5,72,en
在每一行添加带有原始语言的 Meta: _wpml_import_language_code。 然后,每一行都会更新该语言(即原始语言)的产品。如果没有此列,行将更新管理后台当前语言的产品,因此结果取决于管理后台语言切换器。
在管理后台栏的语言切换器中将管理后台语言设置为商店的默认语言 。
前往 产品 → 导入 ,选择文件,勾选更新现有产品 ,单击继续 和运行导入程序 。
导入完成后,每种语言都会立即显示新的库存、价格和价格范围。
使用 WP All Import 定时导入:
前往 All Import → New Import → Download a file → From URL ,并填入您供应商的 feed URL。选择 WooCommerce Products 。
在 WooCommerce Add-On 部分映射 SKU、Regular Price 和 Stock Qty 。
在 Import Settings 中 ,勾选 Attempt to match to existing WooCommerce products before creating new ones ,并按自定义字段 _sku 进行匹配。关闭 Create new WooCommerce products from records newly present in this import file 。开启 Update existing WooCommerce products with the data in this import file 。
在 Choose which data to update 下 ,关闭除 Custom Fields 之外的所有选项,并选择 Update only these Custom Fields, leave the rest alone :_regular_price, _price, _stock, _manage_stock。
设置定时任务。 在 All Import → Manage Imports → Scheduling Options 下,Manual Scheduling 会显示用于服务器 cron 任务的 Trigger URL 和 Processing URL。
每次运行都会将行与原始产品匹配,并且每种语言都会获得每个产品和变体的新价格和库存。
如果再次导入完整的流程 B 文件作为更新 ,请将每一行的 Published 设置为 1。否则,在运行 Run WPML Import 之前,线上产品将变为草稿。勾选更新现有产品 ,然后单击 Run WPML Import 。产品将保持已发布状态,并且文件中的文本会立即替换翻译。
向现有目录添加语言
流程 A:
前往 WPML → 语言 ,单击 Manage and Hide Site Languages ,使用 Search and add a language… 并选择语言。
单击 Calculate Costs。 对话框“Cost to translate your content into ...”会列出项目和字数。单击保存 。
翻译所有内容会在下次加载 WPML 管理后台页面时自行启动新语言。WPML 会翻译并发布新语言中的每个产品和变体。您现有的语言不会受到影响。
流程 B:
准备一个仅包含新语言行的文件。 使用 SKU 作为翻译组,将原始内容的语言作为源语言,Published = -1,并将 publish 作为最终状态。
前往 产品 → 导入 。不要勾选更新现有产品 。运行导入程序。
前往 WPML → WPML导出和导入 ,然后单击 Run WPML Import 。
每个新产品和变体都会通过 SKU 匹配,加入其原始内容的翻译组。这适用于任何目录,包括从未导入过的目录。新语言会从文件中获取其专属的类别和属性项。
更新现有产品 不会添加语言:导入程序会跳过这些行。它会将每个新语言产品列为“No matching product exists to update.”,并将每个新语言变体列为“A new variation cannot be created without a parent product.”。
导入大型目录
每种语言导入一个文件 ,首先导入原始内容。
在最后一个文件导入后,运行一次 Run WPML Import 。
对于长时间运行,请使用 WP-CLI: wp wpml import process 运行与按钮相同的步骤,并显示每个步骤的计数。
在我们的实验室中,使用 WooCommerce 的导入程序和一次 Run WPML Import ,导入包含三种语言的目录所需的时间如下:
每种语言的产品数 整个导入过程 其中,Run WPML Import
500 约半小时 几分钟
1,000 约 1 小时 约 10 分钟
2,000 约两小时 约半小时
每种规模的导入均一次性完成,每种语言中的每个产品和变体都已存在并相互关联。每个数据都是在共享实验室服务器上运行一次的结果。大部分时间都花在 WooCommerce 导入程序上,具体取决于您的服务器。请将这些数字视为数量级参考。
导出产品及其语言(WP All Export)
默认情况下,WP All Export 会将 WPML 列 _wpml_import_language_code、_wpml_import_source_language_code 和 _wpml_import_translation_group 添加到 WooCommerce 产品导出中。其 WPML 部分可导出所有语言或单一语言。手动运行和定时运行的导出都会填充这些列。更多信息请阅读使用 WP All Export 导出多语言网站 。
从 ERP 或 PIM 同步
ERP (企业资源计划系统)是企业用来保存库存、价格和订单的软件。PIM (产品信息管理系统)是企业用来保存产品文本和数据的软件。
这种系统与 WooCommerce 之间的连接器通常:
以一种语言保存按 SKU 索引的目录
按 SKU 查找每个产品(GET /wc/v3/products?sku=...)
通过 WooCommerce REST API 更新现有产品的库存和价格,并创建新产品
按计划运行
这是与 WPML 配合使用的工作流程:
连接器仅写入商店的默认语言。
WPML 会在同一请求中将库存和价格复制到每种语言。
翻译所有内容 将新产品翻译成每种语言(流程 A)。
连接器设为草稿的产品 在每种语言中都会变为草稿。
连接器删除的产品 遵循 WPML → 设置 → 删除内容 中的产品 行。同步期间系统不会进行询问,因此请将删除原始内容 设置为您所需的行为:删除所有语言 会连同翻译一起删除;仅删除该内容 会保持翻译的已发布状态。
请向您的连接器供应商提出三个问题:
它是通过 WooCommerce 写入,还是直接写入数据库? 直接写入数据库的更改仅会影响原始内容。翻译会保留旧的库存和价格。
它写入哪种语言? 它必须写入原始语言。写入翻译的价格不会被保存:翻译会保留原始语言的价格。
它是否为每种语言创建一个产品? WooCommerce 会拒绝具有相同 SKU 的第二个产品。如果没有 SKU,这些副本将是独立的产品,无法获得库存或价格更新。请让连接器仅创建原始内容,并让 WPML 翻译它。
第 3 部分:构建自定义流程(面向开发人员)
使用 WooCommerce REST API 创建产品及其翻译
首先创建分类项目,然后创建原始内容,接着使用 lang 和 translation_of 创建每个翻译。
翻译类别 (以及任何属性分类项目):POST /wp-json/wc/v3/products/categories
JSON 复制 已复制
{
"name" : "Wohnen und Geschenke" ,
"slug" : "wohnen-und-geschenke" ,
"lang" : "de" ,
"translation_of" : 32
}
对于属性分类项目,请在每个分类项目上使用具有相同两个字段的 POST /wc/v3/products/attributes/<id>/terms/batch。
创建原始内容: POST /wp-json/wc/v3/products
JSON 复制 已复制
{
"name" : "Stoneware Coffee Mug" ,
"type" : "simple" ,
"status" : "publish" ,
"sku" : "HP-HG-MUG" ,
"regular_price" : "16.00" ,
"manage_stock" : true ,
"stock_quantity" : 60 ,
"categories" : [ { "id" : 32 } ],
"lang" : "en"
}
创建每个翻译: POST /wp-json/wc/v3/products,包含翻译后的文本、翻译后的类别、lang 和 translation_of(原始内容的 ID)。不要发送 SKU、价格或库存:WPML 会从原始内容复制它们。
JSON 复制 已复制
{
"name" : "Steingut-Kaffeebecher" ,
"slug" : "steingut-kaffeebecher" ,
"status" : "publish" ,
"categories" : [ { "id" : 38 } ],
"lang" : "de" ,
"translation_of" : 120
}
使用 GET 读取结果。 创建调用的响应会显示 SKU、价格和库存为空,因为 WPML 是在构建响应之后复制它们的。紧接着的 GET /wc/v3/products/121 会显示它们。
对于可变产品 ,请仅在原始内容上创建原始内容的变体(POST /wc/v3/products/<id>/variations/batch)。然后使用 lang 和 translation_of 创建每个翻译后的父级。WPML 会自行创建翻译后的变体,将每个变体链接到其原始变体,并复制该语言的 SKU、价格、库存和属性分类项目。不要在翻译上发布变体。
使用 ?lang= 读取翻译的变体: GET /wc/v3/products/137/variations?lang=fr。每个变体都带有 lang、其 translations 映射以及该语言的选项名称。
每种语言一个产品翻译。 如果某语言已有一个产品翻译,则第二个产品翻译将被拒绝并返回 HTTP 400 wcml_translation_exists,且不会创建任何内容。该消息会指明现有翻译的 ID。请改为更新现有翻译。
完整字段参考:WooCommerce Multilingual REST API 。
使用 WooCommerce REST API 更新产品
更新原始内容。WPML 会在同一请求中将更改复制到每种语言。
包含 {"regular_price": "59.00", "stock_quantity": 3} 的 PUT /wc/v3/products/123/variations/124 会更改每种语言中该变体的价格和库存,价格范围也会随之更改。
包含新常规价格、促销价格或库存的 PUT /wc/v3/products/120 会在每种语言中更改它们。
新属性分类项目会在原始内容的属性上创建,并使用 lang 和 translation_of 进行翻译,如上述步骤 1 所示。
添加到原始内容的新变体(POST /wc/v3/products/123/variations 或 .../variations/batch)会在同一请求中到达每种语言,并带有其价格和库存且已链接。调用的响应仅列出原始语言;紧接着的 GET /wc/v3/products/130/variations?lang=de 会列出新的翻译变体。
发送到翻译的价格或属性不会被保存:翻译会保留原始内容的值。发送到任何语言的库存值都会成为所有语言的库存。
通过 API 删除: DELETE /wc/v3/products/<id> 遵循 WPML → 设置 → 删除内容 中的产品 行。API 从不询问:在询问我 下,它仅删除原始内容。请将删除原始内容 设置为您商店所需的行为。在删除所有语言 的情况下,删除操作会将每种语言移动到回收站,而 ?force=true 会删除每种语言。
编写您自己的导入器或连接器
使用 WooCommerce 的产品功能。WPML 会看到更改并将其复制到每种语言。
PHP 复制 已复制
$id = wc_get_product_id_by_sku ( 'HP-HG-MUG' ); // returns the original
$product = wc_get_product ( $id );
$product ->set_regular_price ( '19.00' );
$product ->set_stock_quantity ( 33 );
$product ->save ();
在 save() 之后,翻译将显示新的价格和库存。
切勿将产品数据直接写入数据库 (update_post_meta() 或 SQL)。因为原始产品会更改,而翻译将保留旧值。
在使用带有 WPML 列的文件进行导入后,通过代码运行 WPML 导入步骤 :wp wpml import process。它会执行与运行 WPML 导入 按钮相同的步骤,并打印每个步骤及其计数。
计划任务
使用 WooCommerce 的产品功能更改原始产品的计划任务 (WP-Cron) 会在该任务的自身请求中将这些更改应用到每种语言:
常规价格、促销价格和库存,以及随之而来的库存状态
添加到产品的类别(作为已翻译的类别)
可变产品上的新属性项(作为其翻译)
可变产品的价格范围
第 4 部分:故障排除
导入的翻译显示为独立的、未链接的产品
您看到的情况: 已翻译的行丢失,或者它们作为英语(默认语言)产品存在,通常为私密状态,且没有指向原始产品的链接。
发生原因:
文件没有 WPML 列。此时 WooCommerce 会跳过 SKU 已经存在的每一行:“具有此 SKU 的产品已存在。”
文件包含 WPML 列,但未运行运行 WPML 导入 。在运行之前,每一行都是一个没有指向原始产品链接的默认语言产品,其状态由文件的 Published 列提供(0 为私密,-1 为草稿)。WPML → 导出和导入 显示“干得好。我们看到 12 篇文章已导入并需要语言信息。”
现在的解决方法:
未运行 WPML 导入步骤:前往WPML → 导出和导入 ,然后单击运行 WPML 导入 。
没有 WPML 列:将这四个 WPML 列添加到翻译行中,并将它们作为新的导入再次导入,且不要勾选更新现有产品 。然后单击运行 WPML 导入 。每个翻译都会通过 SKU 与其原始产品关联。
如何避免此问题: 始终包含 WPML 列,并在每次导入后运行运行 WPML 导入 。
导入的翻译被原始文本替换
您看到的情况: 您导入了已翻译的名称和说明,但在下次保存原始产品后,它们又恢复成了原始语言。
发生原因: 翻译是副本。WPML 会在每次保存原始产品时重写其副本。
现在的解决方法:
使它们独立。 前往产品 → 所有产品 ,切换到翻译的语言,勾选产品,然后选择批量操作 → 独立翻译 。
如果开启了“翻译所有内容”,请将“产品”设置为“无”。 在WPML → 翻译 上,单击“已启用自动翻译所有内容”框中的三点菜单,选择调整内容限制 ,将产品 设置为无 ,然后单击保存更改 。
重新导入您的翻译。
之后,保存原始产品将保留导入的文本。
如何避免此问题: 在将文本导入到现有翻译之前,将它们设置为独立翻译 。或者使用 WPML 列将翻译作为新产品导入(过程 B)。
已翻译产品显示原始语言的属性值
您看到的情况: 已翻译的产品页面提供了“Blue”、“Green”,而不是已翻译的属性项。
发生原因: 在翻译属性项之前翻译了产品。
现在的解决方法:
前往 WPML → 翻译 ,然后打开分类法 选项卡。
在“选择要翻译的分类法”下 ,选择属性,例如产品颜色。
翻译每种语言中的每个项 ,然后单击保存 。在同一屏幕上翻译属性的标签。
现有已翻译的产品会在您保存每个项时自动应用它们。无需再次保存任何产品。如果某个项最初是使用原始名称作为副本创建的,其别名将保留原始文本;请在同一对话框中进行更改。
如何避免此问题: 在翻译或导入产品之前先翻译属性项。
导入后已翻译的类别或项带有原始名称
您看到的情况: 已翻译的产品位于名为“Sunglasses”的类别中,或者在已翻译的商店中提供“Blue”选项。
发生原因: 翻译行是从原始导出文件中复制的,并保留了其类别、标签和属性项名称。WPML 会使用这些名称创建已翻译的项并正确链接它们,但不会重命名它们。由原始 ID 提供的追加销售、交叉销售、图像、图库和变体父项会重新映射到正确的语言。
现在的解决方法: 如上一节所述,在 WPML → 翻译 → 分类法 下重命名这些项。面包屑导航、项链接、存档标题和属性选项会立即显示新名称,且无需再次保存任何产品。除非您在同一对话框中进行更改,否则别名将保留原始文本。
如何避免此问题: 在翻译行中,按与原始内容相同的顺序写入已翻译的类别、标签和属性项名称。通过 SKU 提供相关产品和父项。
其他语言的库存或价格落后于原始语言
您看到的情况: 原始内容显示新的库存或价格,而翻译内容显示旧的库存或价格。
发生原因: 更改绕过了 WooCommerce 或 WPML:
连接器直接写入了数据库。
在 WPML 停用时运行了导入。
如何判断: 在产品编辑器中打开原始内容。在说明编辑器下方,会显示“Last edited on”以及日期和时间。如果该时间早于“产品数据”框中的新价格或库存,或者更改是在 WPML 处于非活动状态时进行的,则说明该更新绕过了同步。
现在的解决方法:
对于可变产品:
前往 WPML → 支持 → Fix WCML translations 。Fix WCML translations 是 WPML Troubleshooting (一个单独的插件)的一部分。
勾选 Synchronize product variations ,然后单击 Run the selected tools 。
然后,每种语言都会显示原始的变体价格和库存,以及产品的价格范围。
对于简单产品 ,请使用以下方法之一。每种方法都会将原始价格和库存应用到每种语言:
一次处理一个产品: 打开每个已更改的原始内容,然后单击更新 。
通过导入处理多个产品: 将管理后台语言设置为默认语言,使用 产品 → 导入 再次导入产品,并勾选更新现有产品 。该文件可以包含原始内容已有的值。这也会重新对齐可变产品。
通过 REST 处理多个产品: 发送带有每个产品价格的 PUT /wc/v3/products/<id>,例如 {"regular_price": "19.50"}。
具有统一价格的多个产品: 在 产品 → 所有产品 中,勾选这些产品,选择 批量操作 → 编辑 ,然后单击应用 。在价格 下选择更改为: ,输入价格并单击更新 。每个勾选的产品都会获得该统一价格。
使用原始内容已有的值运行 wp wc product update 不会将其应用到翻译中。
如何避免此问题: 让连接器通过 WooCommerce(REST API 或产品函数)进行写入,并在导入期间保持 WPML 处于活动状态。
通过 REST API 创建的产品出现在错误的语言或组中
您看到的情况: 翻译出现在错误的语言中,或者作为没有 SKU 且没有指向原始内容链接的单独产品出现。
发生原因:
未知的语言代码 会被拒绝并返回 HTTP 422 Invalid language parameter: "ge",且不会创建任何内容。
有效但错误的代码 (例如与 "lang": "fr" 一起发送的德语文本)会在该语言中创建翻译。
缺少 translation_of 会在其自己的组中创建一个产品,没有 SKU,也没有复制的价格或库存。
现在的解决方法: 使用正确的语言和链接,通过 PUT /wc/v3/products/<id> 再次发送该产品:
JSON 复制 已复制
{
"lang" : "de" ,
"translation_of" : 38
}
该产品将移至原始内容的组,并获取其 SKU、价格和库存。对于可变产品,WPML 会将未建立链接创建的变体替换为新的、已链接的变体。请读回新的变体 ID。
如何避免此问题: 在每次翻译时发送 lang 和 translation_of,首先创建项,然后让 WPML 创建翻译的变体。
新导入的产品未自动翻译
您看到的情况: 导入的产品仅保留在原始语言中。
发生原因: 导入期间未开启“翻译所有内容”,或者产品是私密的(“翻译所有内容”从不翻译私密产品),或者产品是草稿(仅当开启自动翻译草稿 且再次保存草稿时才会翻译)。
现在的解决方法:
发送产品: 前往 WPML → 翻译 ,打开 Products (产品)部分,勾选这些产品,为每种语言选择自动翻译 ,在“当 WPML 完成自动翻译您的内容时,您想怎么做?”下选择 Publish without review (无需审核即可发布),然后单击翻译内容 。这也适用于草稿和私密产品;它们的翻译将获得原始内容的状态。
或者开启“翻译所有内容”。 它会翻译所有尚未翻译的已发布产品。WPML 会在 WPML 管理页面加载时发送它们。
前往 WPML → 翻译 → 设置翻译所有内容 → 继续 → 启用自动翻译所有内容 。
停留在 WPML → 翻译 页面,直到显示“Finished translating your content”。
如何避免此问题: 在导入之前开启“翻译所有内容”(过程 A),并将产品作为已发布状态导入。