Перевод импортированных товаров WooCommerce: CSV, API, ERP
Поддерживайте актуальность многоязычного каталога WooCommerce при импорте товаров через CSV, WP All Import, REST API или синхронизацию с ERP.
Обновлено: 16 ноября 2026 года
Это руководство предназначено для магазинов, чей каталог находится вне WordPress: в электронной таблице, PIM, ERP или фиде поставщика. Товары попадают в WooCommerce через импортер, REST API или запланированное задание, и Вы редко открываете редактор товаров.
Часть 1. Как работает многоязычный магазин, управляемый извне
Один товар на язык, связанные группой переводов
В каждом языке есть свой товар WooCommerce со своим собственным ID. WPML связывает языки в группу переводов. Оригинал — это товар на языке по умолчанию Вашего магазина; остальные языки являются его переводами.
В нашем примере магазина худи на молнии (Zip-Up Hoodie) — это товар 14 на английском, 121 на немецком и 122 на французском языках. Каждый ответ REST API для любого из них содержит одну и ту же карту: "translations": {"de":"121","en":"14","fr":"122"}.
Артикул (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 копирует следующие значения в каждый перевод:
Базовая цена и цена распродажи
Количество в запасе и статус наличия
Артикул, вес и размеры
Изображение товара и галерея (каждый язык получает свою копию изображения)
Категории и метки (в виде переведенной категории или метки)
Апселлы и кросс-селлы (указывающие на товар на том же языке)
Статус публикации
Для вариативных товаров: цена и запасы каждой вариации, диапазон цен, новый глобальный термин атрибута (в виде его перевода, например Schwarz и Noir для Black) и новая вариация
Следующие данные остаются разными для каждого языка, поскольку они переводятся:
Название, описание и краткое описание
Слаг (адрес товара, например /de/produkt/kapuzenjacke-mit-reissverschluss/)
Термины атрибутов, такие как Blue, Blau и Bleu
Значения атрибутов, специфичных для товара, например «Материал», заданный только для этого товара
Запасы являются общими для всех языков.
Записывайте цены и атрибуты в оригинал. Если Ваша система записывает цену или атрибуты в перевод, перевод сохраняет значения оригинала. Запасы, записанные для любого языка, становятся запасами для всех языков, поскольку они являются общими.
Цены во второй валюте также следуют за оригиналом (см. мультивалютность для WooCommerce). Задавайте их в оригинале с помощью custom_prices в REST API ("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
Цена и запасы
Следуют за оригиналом
Следуют за оригиналом
Где Вы это видите: в блоке «Язык» дубликата написано «This document is a duplicate of ... and it is maintained by WPML.» с кнопкой Переводить самостоятельно.
Превращение дубликатов в независимые переводы: нажмите Переводить самостоятельно в блоке «Язык» дубликата или, для нескольких товаров, перейдите в Товары → Все товары, переключитесь на язык перевода, отметьте товары и выберите Массовые действия → Переводить самостоятельно.
Что создают процессы из части 2: процесс A создает переводы с помощью функции Переводить все. Процесс B импортирует независимые переводы. Ни одному из них не нужны дубликаты.
Настройка магазина до добавления первого товара
Запустите мастер настройки WooCommerce Multilingual. Он открывается при активации WPML Multilingual & Multicurrency for WooCommerce. Его экраны — Страницы магазина, Глобальные атрибуты и Несколько валют. Первый создает страницы «Магазин», «Корзина», «Оформление заказа» и «Мой аккаунт» на каждом языке.
Сделайте глобальные атрибуты переводимыми. На экране мастера «Which product attributes should be translatable?» отметьте каждый атрибут, например Color и Size. Позже эта же настройка будет доступна в виде флажка Translatable? в разделе Товары → Атрибуты → Изменить.
Переведите термины атрибутов до перевода товаров. Перейдите в WPML → Переводы, откройте вкладку Таксономия, выберите атрибут в разделе «Выберите таксономию для перевода» и переведите каждый термин. Если включена функция «Переводить все» (процесс A), WPML переведет новые термины за Вас.
Часть 2. Создание без использования кода
Выбор процесса: один язык или все языки
Процесс A: переводит WPML
Процесс B: Вы импортируете все языки
Что содержит Ваша система
Только язык магазина по умолчанию
Все языки
Что Вы импортируете
Оригинальные товары
Оригиналы и их переводы, связанные по артикулу (SKU)
WPML отмечает, что перевод нуждается в обновлении; Ваш следующий файл содержит новый текст
Цены и запасы
Соответствуют оригиналу
Соответствуют оригиналу
Процесс A подходит для магазина, который ведется на одном языке и хочет получить все остальные языки без файлов перевода. Процесс B подходит для магазина, чья система PIM или переводчики уже содержат тексты на всех языках.
Процесс A с использованием CSV-импортера WooCommerce или WP All Import
Включите функцию «Переводить все → один раз:
Перейдите вWPML → Переводы и нажмите Настроить Переводить все.
Выберите контент. В разделе «Контент для перевода» оставьте Все товары и нажмите Продолжить.
Выберите способ публикации переводов. В разделе «Метод публикации» оставьте Опубликовать без проверки.
Нажмите Включить Переводить все автоматически.
Импортируйте товары только на языке магазина по умолчанию. Используйте Товары → Импорт (CSV-импортер WooCommerce) или All Import → New Import (WP All Import с дополнением для WooCommerce). В Вашем файле не нужны столбцы WPML.
Сам импорт ставит переводы в очередь. Затем WPML переводит каждый товар, вариацию, категорию и новый термин атрибута на каждый язык и публикует их. Вам не нужно ничего запускать вручную, и ни одна страница админ-панели WPML не должна быть открыта. Вы можете следить за прогрессом в разделе WPML → Переводы.
Когда Вы редактируете оригинал, функция «Переводить все» переводит только то, что изменилось. Остальная часть перевода остается слово в слово.
Функция «Переводить все» переводит опубликованные товары, включая внешние товары. Она не переводит личные товары. Черновики также ожидают: параметр Автоматически переводить черновики (в разделе WPML → Настройки → Перевод ИИ, в блоке «Расширенный редактор переводов») по умолчанию отключен, а когда Вы его включаете, WPML переводит черновик только при его повторном сохранении. Чтобы перевести черновики и личные товары, отправьте их из раздела WPML → Переводы (см. Поиск и устранение неисправностей).
Если Вы хотите изменить перевод, откройте его из блока «Язык» товара (Изменить перевод на...), отредактируйте его в Расширенном редакторе переводов и нажмите Завершить. Когда оригинал позже изменится, Ваши правки в неизмененных предложениях сохранятся.
Процесс B с использованием CSV-импортера WooCommerce
В процессе 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_status
Статус после того, как WPML свяжет товары
publish
Упорядочите строки по языку, сначала оригиналы. В каждом языке товары идут перед их вариациями.
Импортируйте товары как черновики:Published = -1 для товаров, 1 для вариаций.
Укажите для каждого языка собственные тексты: названия, описания, категории (Kleidung > Jacken) и значения атрибутов (Blau, Grün).
Сохраните названия атрибутов магазина (Color, Size) на каждом языке. Переведите метки атрибутов в разделе WPML → Переводы → Таксономия.
Укажите сопутствующие и родительские товары по артикулу (SKU), используя один и тот же SKU на каждом языке.
Немецкая строка вариативного товара из нашего файла-примера:
Перейдите вТовары → Импорт и выберите файл в разделе «Выберите CSV-файл на вашем компьютере:». Оставьте флажок Обновлять существующие товары снятым. Нажмите Продолжить.
Проверьте сопоставление. Четыре столбца Meta: сопоставляются с Импортировать как метаданные. Нажмите Запустить импорт.
Перейдите вWPML → Экспорт и импорт WPML. На экране появится сообщение «Отличная работа. Мы видим 33 записи, которые импортированы и нуждаются в информации о языке.» Нажмите Запустить импорт WPML.
Дождитесь сообщения «Мультиязычный импорт завершен».
До шага 3 каждый товар является английским черновиком, а каждая вариация — английской вариацией, и ни одна из них не связана со своим оригиналом. После него:
Каждый товар и каждая вариация связаны между собой на всех языках.
Все опубликовано.
Переводы являются независимыми.
Категории и термины атрибутов связаны на всех языках, и вариации каждого языка используют свои собственные термины.
Апселлы указывают на товар на том же языке, и каждый язык имеет собственную копию изображений.
Категории и термины атрибутов передаются внутри строк товаров, поэтому этому импортеру не требуется отдельный импорт таксономий. Если переведенные термины атрибутов уже существуют в магазине, импортер использует их, а кнопка Запустить импорт WPML связывает их с оригиналами.
Чтобы WPML переводил выбранные товары автоматически, когда для параметра Товары установлено значение Нет:
Оставьте включенным режим Переводить все.
Добавьте столбец Meta: _wpml_import_tea в файл со значением 1 для каждого товара, который нужно перевести.
Оставьте Meta: _wpml_import_translation_group в том же файле.
Импортируйте файл, затем перейдите в WPML → Экспорт и импорт WPML и нажмите Запустить импорт WPML. В списке прогресса отобразится «Отправка записей на автоматический перевод», и WPML переведет и опубликует эти товары.
Процесс B с использованием WP All Import
Вам понадобится WP All Import Pro и его дополнение для WooCommerce. Бесплатная версия не импортирует произвольные поля, а столбцы WPML являются произвольными полями.
Порядок работы следующий: сначала термины атрибутов с подключенными переводами, затем товары. Переведенные страницы товаров затем будут предлагать каждое значение атрибута на своем языке, например Bleu marine, а не Navy.
Свяжите переведенные термины, которые уже есть в магазине. Для каждого переведенного термина атрибута, который уже существует в магазине, перейдите в Товары → Атрибуты, нажмите Настройка терминов для атрибута, переключите язык в верхней админ-панели на язык термина и нажмите на название термина. В блоке «Язык» выберите его оригинал в разделе Это перевод и нажмите Обновить. После этого для каждого связанного термина будет отображаться значок карандаша под его языком в разделе WPML → Переводы → Таксономия.
Установите язык админ-панели на язык по умолчанию для магазина в переключателе языков верхней панели перед запуском импорта.
Импортируйте категории. Перейдите в All Import → New Import → Upload a file, выберите Taxonomies → Product categories. В разделе Term Meta добавьте три строки: _wpml_import_language_code, _wpml_import_source_language_code и _wpml_import_translation_group, каждая из которых сопоставлена с одноименным столбцом файла. Установите родительский элемент в разделе Other Category Options → Parent Term.
Импортируйте термины атрибутов таким же образом, например Taxonomies → Product Color, с теми же тремя строками Term Meta.
Свяжите термины. Перейдите в WPML → Экспорт и импорт WPML и нажмите Запустить импорт WPML. Проверьте в разделе WPML → Переводы → Таксономия (выберите таксономию в поле «Выберите таксономию для перевода»), что у каждого термина есть одна строка со значком карандаша под флагом каждого языка. Наведите курсор на карандаш, чтобы увидеть переведенное название. Знак «+» означает, что для этого языка нет перевода. Переведенный термин, отображаемый в отдельной строке, не связан.
Импортируйте товары. Выберите WooCommerce Products. В разделе WooCommerce Add-On сопоставьте артикул (SKU), цены, запасы и атрибуты. В разделе Custom Fields добавьте три строки _wpml_import_*.
Снова нажмите Запустить импорт WPML и дождитесь сообщения Мультиязычный импорт завершен.
Две настройки для файла товаров, содержащего все языки:
Строки вариаций имеют тип 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), одинаковый для всех языков, с General → SKU и с группой перевода. Другой способ — один импорт на каждый языковой файл.
Этот порядок работает независимо от того, запускаете ли Вы импорт WP All Import из wp-admin, через WP-CLI или по расписанию.
Обновление запасов и цен по расписанию
Обновляйте оригинальные товары. WPML сразу же копирует запасы и цены на все языки.
С помощью CSV-импортера WooCommerce:
Отправляйте только те столбцы, которые Вы меняете. Столбец с пустой ячейкой записывает пустое значение. Наш файл-пример:
Добавьте Meta: _wpml_import_language_code с языком оригинала в каждую строку. Тогда каждая строка обновляет товар на этом языке — оригинал. Без этого столбца строка обновляет товар на текущем языке админ-панели, поэтому результат зависит от переключателя языков админ-панели.
Установите язык админ-панели на язык по умолчанию для магазина в переключателе языков верхней панели.
Сразу после импорта на всех языках отображаются новые запасы, цены и диапазон цен.
С помощью WP All Import, по расписанию:
All Import → Новый импорт → Загрузить файл → Из URL, указав URL-адрес фида Вашего поставщика. Выберите Товары WooCommerce.
Сопоставьте артикул (SKU), базовую цену и количество в запасе в разделе дополнения WooCommerce.
В настройках импорта отметьте Пытаться найти существующие товары WooCommerce перед созданием новых (Attempt to match to existing WooCommerce products before creating new ones) и сопоставьте их по Произвольному полю (Custom field) _sku. Отключите Создавать новые товары WooCommerce из записей, впервые присутствующих в этом файле импорта. Включите Обновлять существующие товары WooCommerce данными из этого файла импорта.
В разделе выбора данных для обновления отключите всё, кроме Произвольных полей (Custom Fields), и выберите Обновлять только эти произвольные поля, остальные оставить без изменений (Update only these Custom Fields, leave the rest alone): _regular_price, _price, _stock, _manage_stock.
Настройте расписание. В разделе All Import → Управление импортом → Параметры расписания для параметра Ручное расписание (Manual Scheduling) отображаются URL-адрес запуска (Trigger URL) и URL-адрес обработки (Processing URL) для задачи cron Вашего сервера.
При каждом запуске строки сопоставляются с оригинальными товарами, и на всех языках появляются новые цены и запасы для каждого товара и вариации.
Если полный файл процесса B импортируется повторно в качестве обновления, задайте для Published значение 1 в каждой строке. В противном случае опубликованные товары перейдут в статус Черновик до выполнения действия Запустить импорт WPML. Отметьте Обновить существующие товары, затем нажмите Запустить импорт WPML. Товары останутся опубликованными, а тексты в файле сразу же заменят переводы.
Добавление языка в уже существующий каталог
Процесс A:
Перейдите вWPML → Языки, нажмите Управление и скрытие языков сайта, воспользуйтесь полем Поиск и добавление языка… и выберите язык.
Нажмите «Рассчитать стоимость». В диалоговом окне «Стоимость перевода Вашего контента на...» будут перечислены элементы и слова. Нажмите Сохранить.
Режим Переводить все самостоятельно запускает перевод на новый язык при следующей загрузке страницы админ-панели WPML. WPML переводит и публикует каждый товар и вариацию на новом языке. Ваши существующие языки не затрагиваются.
Процесс B:
Подготовьте файл только со строками для нового языка. Используйте артикул (SKU) в качестве группы переводов, язык оригинала — в качестве исходного языка, Published = -1, а publish — в качестве конечного статуса.
Перейдите вWPML → Экспорт и импорт WPML и нажмите Запустить импорт WPML.
Каждый новый товар и вариация присоединяется к группе переводов своего оригинала, сопоставляясь по артикулу (SKU). Это работает с любым каталогом, в том числе с тем, который никогда не импортировался. Новый язык получает свои собственные категории и термины атрибутов из файла.
Опция Обновить существующие товары не добавляет язык: импорт пропускает такие строки. Он помечает каждый товар на новом языке сообщением «No matching product exists to update.» (Нет подходящего товара для обновления), а каждую вариацию на новом языке — сообщением «A new variation cannot be created without a parent product.» (Невозможно создать новую вариацию без родительского товара).
Импорт больших каталогов
Импортируйте по одному файлу для каждого языка, начиная с оригиналов.
Запустите импорт WPML один раз, после последнего файла.
Для длительных процессов используйте WP-CLI: команда wp wpml import process выполняет то же действие, что и кнопка, и показывает количество для каждого шага.
Сколько времени это занимает (по данным нашей лаборатории) при использовании импорта WooCommerce и одного выполнения действия Запустить импорт WPML для каталога на трех языках:
Товаров на каждый язык
Весь импорт
Из них на «Запустить импорт WPML»
500
около получаса
несколько минут
1 000
около часа
около 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=...)
Обновляет запасы и цены существующих товаров, а также создает новые товары через REST API WooCommerce
Работает по расписанию
Вот процесс, который работает с WPML:
Коннектор записывает данные только на языке по умолчанию магазина.
WPML копирует запасы и цены на все языки в одном и том же запросе.
Режим «Переводить все → переводит новые товары на все языки (Процесс А).
Товар, который коннектор переводит в черновик, становится черновиком на всех языках.
Товар, который удаляет коннектор, следует правилам в WPML → Настройки → Удаление контента, строка Товары. Во время синхронизации запросы на подтверждение не выводятся, поэтому задайте для настройки Удаление оригинала нужное Вам поведение: Удалить все языки удаляет и переводы; Только его оставляет их опубликованными.
Задайте разработчику Вашего коннектора три вопроса:
Он записывает данные через WooCommerce или напрямую в базу данных? Изменения, записанные напрямую в базу данных, применяются только к оригиналу. В переводах остаются старые запасы и цены.
На каком языке он записывает данные? Он должен записывать их на языке оригинала. Цена, записанная в перевод, не сохраняется: перевод сохраняет цену оригинала.
Он создает по одному товару для каждого языка? WooCommerce отклоняет второй товар с таким же SKU. Без SKU копии становятся отдельными товарами, которые не получают обновлений запасов или цен. Позвольте коннектору создавать только оригинал, а WPML — переводить его.
Часть 3. Создание пользовательских процессов (для разработчиков)
Создание товара и его переводов с помощью REST API WooCommerce
Сначала создайте термины, затем оригинал, а затем каждый перевод с помощью lang и translation_of.
Переведите рубрику (и любые термины атрибутов): POST /wp-json/wc/v3/products/categories
Создайте каждый перевод:POST /wp-json/wc/v3/products с переведенными текстами, переведенной рубрикой, lang и translation_of (ID оригинала). Не отправляйте SKU, цену или запасы: WPML скопирует их из оригинала.
Прочитайте результат с помощью 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 существующего перевода. Вместо этого обновите существующий перевод.
Обновите оригинал. WPML скопирует изменение на все языки в том же запросе.
Вызов PUT /wc/v3/products/123/variations/124 с {"regular_price": "59.00", "stock_quantity": 3} изменяет цену и запасы этой вариации на всех языках, и диапазон цен обновляется соответствующим образом.
Вызов 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 увидит изменение и скопирует его на все языки.
После save() в переводах отображаются новые цена и запасы.
Никогда не записывайте данные товаров напрямую в базу данных (update_post_meta() или SQL). Оригинал изменится, а переводы сохранят старые значения.
Запустите шаг импорта WPML из кода после импорта со столбцами WPML: wp wpml import process. Он выполняет те же шаги, что и кнопка Run WPML Import, и выводит каждый из них с количеством.
Запланированные задания
Запланированное задание (WP-Cron), изменяющее оригинал с помощью функций товаров WooCommerce, переносит эти изменения на все языки в рамках собственного запроса задания:
Базовая цена, цена распродажи и запасы, со статусом запасов, который из них следует
Категория, добавленная к товару (как переведенная категория)
Новый элемент атрибута вариативного товара (как его перевод)
Диапазон цен вариативного товара
Часть 4. Поиск и устранение неисправностей
Импортированные переводы отображаются как отдельные, не связанные товары
Что Вы видите: переведенные строки отсутствуют, или они существуют как английские товары (на языке по умолчанию), часто со статусом «Личное», без связи с оригиналом.
Почему это происходит:
В файле нет столбцов WPML. В этом случае WooCommerce пропускает каждую строку, чей артикул (SKU) уже существует: «A product with this SKU already exists.» (Товар с таким артикулом уже существует).
В файле есть столбцы WPML, но кнопка Run WPML Import не была нажата. До этого момента каждая строка является товаром на языке по умолчанию без связи с оригиналом, со статусом, который задает столбец Published файла («Личное» для 0, «Черновик» для -1). WPML → Экспорт и импорт показывает «Good job. We see 12 posts that are imported and need language information.» (Отличная работа. Мы видим 12 импортированных записей, которым нужна информация о языке).
Как это исправить сейчас:
Шаг импорта WPML не выполнен: перейдите в WPML → Экспорт и импорт и нажмите Run WPML Import.
Нет столбцов WPML: добавьте четыре столбца WPML к строкам перевода и импортируйте их снова как новый импорт, сняв галочку Update existing products (Обновить существующие товары). Затем нажмите Run WPML Import. Каждый перевод присоединится к своему оригиналу по артикулу (SKU).
Как этого избежать: всегда включайте столбцы WPML и нажимайте Run WPML Import после каждого импорта.
Что Вы видите: Вы импортировали переведенные названия и описания, а после следующего сохранения оригинала они вернулись на язык оригинала.
Почему это происходит: переводы были дубликатами. WPML перезаписывает дубликат при каждом сохранении его оригинала.
Как это исправить сейчас:
Сделайте их независимыми. Перейдите в Товары → Все товары, переключитесь на язык перевода, отметьте товары галочками и выберите Массовые действия → Переводить самостоятельно.
Если включен режим «Переводить все», установите для товаров значение «Нет». В WPML → Переводы нажмите на меню с тремя точками в блоке «Translate Everything Automatically is enabled» (Переводить все автоматически включено), выберите Adjust content limits, установите для Products значение None и нажмите Сохранить изменения.
Импортируйте Ваши переводы еще раз.
После этого при сохранении оригинала импортированный текст останется.
Как этого избежать: перед импортом текста в существующие переводы установите для них режим Переводить самостоятельно. Или импортируйте переводы как новые товары со столбцами WPML (Процесс B).
Переведенные товары показывают значения атрибутов на языке оригинала
Что Вы видите: на странице переведенного товара предлагаются варианты «Blue», «Green» вместо переведенных элементов.
Почему это происходит: товары были переведены до того, как были переведены элементы их атрибутов.
Как это исправить сейчас:
Перейдите вWPML → Переводы и откройте вкладку Таксономия.
В разделе «Выберите таксономию для перевода» выберите атрибут, например Product Color.
Переведите каждый элемент на каждый язык и нажмите Сохранить. Переведите название атрибута на том же экране.
Существующие переведенные товары подхватывают каждый элемент по мере его сохранения. Ни один товар не нужно сохранять повторно. Если элемент был изначально создан как копия с названием оригинала, его слаг сохраняет текст оригинала; измените его в том же диалоговом окне.
Как этого избежать: переводите элементы атрибутов до перевода или импорта товаров.
Переведенные категории или элементы сохраняют названия оригинала после импорта
Что Вы видите: переведенный товар находится в категории под названием «Sunglasses» или предлагает вариант «Blue» в переведенном магазине.
Почему это происходит: строки перевода были скопированы из экспорта оригинала и сохранили названия его категорий, меток и элементов атрибутов. WPML создает переведенные элементы с этими названиями и связывает их правильно, но не переименовывает их. Апселлы, кросс-селлы, изображения, галереи и родительские элементы вариаций, заданные по ID оригинала, переназначаются на нужный язык.
Как это исправить сейчас: переименуйте элементы в WPML → Переводы → Таксономия, как описано в разделе выше. Хлебные крошки, ссылки на элементы, заголовки архивов и параметры атрибутов сразу же покажут новые названия, и ни один товар не нужно сохранять повторно. Слаги сохраняют текст оригинала, если Вы не измените их в том же диалоговом окне.
Как этого избежать: в строках перевода пишите переведенные названия категорий, меток и элементов атрибутов в том же порядке, что и в оригинале. Указывайте сопутствующие товары и родительские элементы по артикулу (SKU).
Запасы или цены на других языках отстают от оригинала
Что Вы видите: оригинал показывает новые запасы или цену, а переводы показывают старые.
Почему это происходит: изменение произошло в обход WooCommerce или WPML:
Коннектор записал данные напрямую в базу данных.
Импорт был запущен, когда плагин WPML был деактивирован.
Как это определить: откройте оригинал в редакторе товаров. Под редактором описания указано «Последнее изменение» с датой и временем. Если это время старше, чем новая цена или запасы в блоке «Данные товара», или изменение было сделано, когда WPML был неактивен, обновление прошло в обход синхронизации.
Как это исправить сейчас:
Для вариативных товаров:
Перейдите вWPML → Поддержка → Fix WCML translations. Раздел Fix WCML translations является частью WPML Troubleshooting — отдельного плагина.
Отметьте «Синхронизировать вариации товаров» и нажмите Запустить выбранные инструменты.
После этого на всех языках будут отображаться цены и запасы вариаций оригинала, а также диапазон цен товара.
Для простых товаров используйте один из этих способов. Каждый из них переносит цену и запасы оригинала на все языки:
По одному товару за раз: откройте каждый измененный оригинал и нажмите Обновить.
Множество товаров через импорт: установив язык админ-панели на язык по умолчанию, снова импортируйте товары через Товары → Импорт, отметив Обновлять существующие товары. Файл может содержать значения, которые уже есть у оригиналов. Это также выравнивает вариативные товары.
Множество товаров через 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 создает товар в собственной группе, без артикула и без скопированной цены или запасов.
Как это исправить сейчас: отправьте товар снова с правильным языком и связью, используя PUT /wc/v3/products/<id>:
JSON
{
"lang": "de",
"translation_of": 38
}
Товар перемещается в группу оригинала и получает его артикул, цену и запасы. Для вариативного товара WPML заменяет вариации, созданные без связи, на новые, связанные. Считайте новые ID вариаций обратно.
Как этого избежать: отправляйте lang и translation_of для каждого перевода, сначала создавайте элементы, и позвольте WPML создавать вариации переводов.
Новые импортированные товары не переводятся автоматически
Что Вы видите: импортированные товары остаются только на языке оригинала.
Почему это происходит: режим «Переводить все» был отключен во время импорта, либо товары являются личными (которые «Переводить все» никогда не переводит), либо черновиками (которые он переводит только тогда, когда включена опция Автоматически переводить черновики и черновик сохранен повторно).
Как это исправить сейчас:
Отправьте товары: перейдите в WPML → Переводы, откройте раздел Товары, отметьте товары, выберите Переводить автоматически для каждого языка, выберите Опубликовать без проверки в разделе «Что Вы хотите сделать после того, как WPML завершит автоматический перевод Вашего контента?» и нажмите Перевести контент. Это также работает для черновиков и личных товаров; их переводы получают статус оригинала.
Или включите «Переводить все». Этот режим переводит каждый опубликованный товар, который еще не переведен. WPML отправляет их во время загрузки страниц админ-панели WPML.
Перейдите вWPML → Переводы → Настроить Переводить все → Продолжить → Включить Переводить все автоматически.
Оставайтесь вWPML → Переводы, пока не появится сообщение «Перевод Вашего контента завершен».
Как этого избежать: включите «Переводить все» до импорта (Процесс А) и импортируйте товары как опубликованные.
Автор:Amir·
Ищите по документации, блогу, хукам и другим разделам.