Как импортировать многоязычный контент в WordPress — WooCommerce, CSV и XML

Экспорт и импорт WPML работает вместе с плагином импорта WordPress, который Вы уже используете. Плагин импорта перемещает Ваши данные. Экспорт и импорт WPML добавляет языковую информацию в конце, чтобы каждая строка попадала в правильный язык, а каждый перевод связывался со своим оригиналом.

Перед началом работы

Установите и активируйте следующие плагины на сайте, куда Вы выполняете импорт:

Плагин импорта: WP All Import Pro, WP All Export Pro, встроенный импортер CSV WooCommerce или стандартный импортер WordPress.
WPML и WPML Перевод строк.
Экспорт и импорт WPML (дополнение, о котором идет речь на этой странице).
WPML Multilingual & Multicurrency for WooCommerce, если Вы импортируете товары WooCommerce.

На сайте для импорта настройте WPML для каждого языка, который Вы планируете импортировать. Языки перевода должны уже существовать в WPML → Настройки → Языки до запуска импорта.

Два пути — выберите тот, который соответствует Вашему источнику

Существует два пути импорта, в зависимости от того, откуда поступают многоязычные данные:

Поддерживаемый плагин импорта. Если Вы переносите контент с существующего сайта WordPress с помощью WP All Export Pro (или другого поддерживаемого инструмента экспорта), Экспорт и импорт WPML уже находится в файле экспорта — языковая информация включается автоматически. Перейдите к шагу Запуск импорта WPML ниже.
Пользовательский CSV или XML. Если Вы ведете многоязычные данные в электронной таблице или Вашим источником является система, отличная от WordPress (PIM, MLS, ERP, платформа бронирования), Вы добавите три языковых столбца в свой файл вручную. Перейдите к разделу Подготовка Вашего CSV или XML ниже.

Подготовка Вашего CSV или XML с тремя языковыми столбцами

Для пользовательского импорта добавьте три столбца к каждой строке Вашей электронной таблицы. Именно так WPML связывает переводы вместе и помечает каждую строку правильным языком:

_wpml_import_translation_group. Уникальное значение, общее для всех языковых версий одного элемента контента. Для товаров используйте артикул (SKU). Для всего остального сгенерируйте свой собственный ID и используйте его повторно для исходной строки и каждого ее перевода.
_wpml_import_language_code. Код языка ISO для строки (en для английского, es для испанского, fr для французского, pt-pt для европейского португальского и так далее).
_wpml_import_source_language_code. Только в строках перевода; код языка оригинала. Оставьте его пустым для строк на исходном языке.

Для WP All Import Pro и аналогичных инструментов подготовьте две электронные таблицы: одну для таксономий (рубрики, метки, категории товаров), другую для записей и товаров. Встроенный импортер CSV WooCommerce принимает одну электронную таблицу, поскольку категории товаров находятся внутри строк товаров.

Пользовательские атрибуты WooCommerce для вариативных товаров

Если у Вас есть вариативные товары с пользовательскими атрибутами, добавьте четвертый столбец к строкам переведенных товаров: _wpml_import_wc_local_attribute_labels. Значением является JSON-объект из пар slug:translation. Для вариативного товара на французском языке с атрибутами Size и Color:

{"size":"Taille","color":"Couleur"}

Слаг — это имя атрибута в нижнем регистре, где пробелы заменены дефисами.

Порядок импорта

Всегда импортируйте таксономии в первую очередь, если у Вас есть отдельный файл для них. Рубрики, метки и любые другие таксономии должны существовать до того, как записи и товары смогут ссылаться на них. Затем импортируйте записи, страницы, товары и другие типы контента.

Если Вы разделяете свои данные на один файл для каждого языка, импортируйте каждый языковой файл перед запуском шага связывания WPML.

Сопоставление языковых столбцов в Вашем плагине импорта

Каждый плагин импорта обрабатывает пользовательские столбцы по-своему. Критически важным шагом является сопоставление трех столбцов WPML с произвольными полями (или метаданными элемента, для таксономий). В WP All Import Pro это происходит на Шаге 3 мастера импорта:

Для записей и товаров. Откройте Произвольные поля, добавьте три поля, перетащите языковые столбцы в поля Value и используйте имена столбцов без скобок в полях Name.
Для таксономий. Откройте Метаданные элемента, добавьте три поля метаданных элемента и сопоставьте языковые столбцы таким же образом.

Если столбцы не сопоставлены, WPML будет нечего читать при запуске шага связывания.

Что Вы увидите между импортом и шагом связывания

До тех пор, пока Вы не запустите Экспорт и импорт WPML, весь импортированный контент будет находиться в Вашем языке по умолчанию, а WPML автоматически сохраняет записи и товары в статусе Черновик, чтобы не допустить появления смешанного языкового контента на фронтенде. Это ожидаемое промежуточное состояние, а не признак неудачного импорта.

Для неподдерживаемых плагинов импорта Вам потребуется опубликовать записи вручную после завершения шага связывания.

Запуск импорта WPML

После того как плагин импорта завершит работу:

Откройте WPML → Экспорт и импорт в админ-панели WordPress.
Нажмите Запустить импорт WPML.

WPML считывает языковые столбцы каждой строки, назначает язык этой строке и связывает переводы с их оригиналом. В больших каталогах это может занять несколько минут. По завершении Ваш импортированный контент будет опубликован на правильном языке, а каждый перевод будет связан со своим источником.

Выполните выборочную проверку в админ-панели и на фронтенде:

Откройте список типов записей или товаров — убедитесь, что каждая строка отображается под правильным флагом языка.
Перейдите на фронтенд и переключите языки — каждая переведенная страница должна загружать свою переведенную версию, а не возвращаться к оригиналу.

Если перевод таксономии не связался, откройте элемент в админ-панели WordPress и используйте блок «Языки» этого элемента, чтобы связать его с элементом на языке по умолчанию.

Автоматизация — запуск импорта WPML после каждого запланированного импорта

Для ночных синхронизаций, лент поставщиков или любого запланированного импорта шаг связывания WPML может выполняться автоматически сразу после завершения работы плагина импорта. Есть три способа настроить это:

Вариант 1 — POST-эндпоинт (для импортов на основе Cron, таких как запланированные действия WP All Import)

Это рекомендуемый способ. Добавьте надежный секретный ключ в wp-config.php:

define( 'WPML_IMPORT_KEY', 'your-strong-secret-key-here' );

Затем добавьте вторую команду в настройки Вашего запланированного импорта. Она отправляет POST-запрос на Ваш сайт и передает ключ в теле запроса:

curl -X POST https://yoursite.com/ \
  -d 'wpml_import_trigger=your-strong-secret-key-here'

Тот же вызов с wget:

wget -q -O - \
  --post-data='wpml_import_trigger=your-strong-secret-key-here' \
  https://yoursite.com/

Для ручного планирования в WP All Import Pro добавьте любую из команд сразу после команды импорта.

При выполнении шага связывания Ваш сайт отвечает статусом 200 и следующим сообщением:

Import process completed

Два других ответа сообщают Вам, что произошло: 401 означает, что ключ не совпадает, а 204 означает, что больше нечего обрабатывать.

Вариант 2 — URL-эндпоинт (устарел)

До версии WPML Export and Import 1.2.0 Вы передавали ключ в URL-адресе:

https://yoursite.com/?wpml_import_trigger=your-strong-secret-key-here

Этот URL-адрес по-прежнему работает, поэтому Ваши текущие задания cron продолжат выполняться. Он устарел, и WPML удалит его в следующем крупном релизе.

Причина — ключ. URL-адрес проходит через журналы сервера, историю браузера и аналитику, и Ваш ключ путешествует вместе с ним. POST-запрос сохраняет ключ в теле запроса. Переведите Ваши запланированные импорты на POST-вызов из Варианта 1.

Вариант 3 — хук действия (для импортов, запланированных через PHP)

Если Вы планируете импорты из PHP с помощью Action Scheduler или wp_schedule_single_event, запустите шаг WPML одним вызовом действия:

do_action( 'wpml_import_process' );

Чтобы запустить его как одноразовую фоновую задачу сразу после Вашего действия импорта:

wp_schedule_single_event( time(), 'wpml_import_process' );

Если что-то пойдет не так в любом из этих путей, включите WP_DEBUG_LOG в wp-config.php, чтобы зафиксировать ошибку в журнале ошибок PHP.

Запуск импорта WPML из командной строки

Для скриптов развертывания, сборок контейнеров или любого конвейера, где недоступен пользовательский интерфейс админ-панели, запустите шаг связывания из WP-CLI:

wp wpml import process

Команда сообщает, сколько переводов было подключено. Это прямая замена кнопки Запустить импорт WPML.

Распространенные ошибки

В файле импорта отсутствуют три языковых столбца. Контент импортируется, но попадает как непомеченные строки исходного языка; кнопке Запустить импорт WPML нечего связывать. Решение: добавьте столбцы в Ваши исходные данные, выполните повторный экспорт и повторный импорт.
Сопоставление Произвольные поля / Метаданные элемента в WP All Import было пропущено. Та же ситуация, что и с отсутствующими столбцами. Данные есть в файле, но плагин импорта не сохранил их в записи. Запустите импорт повторно с сопоставленными полями.
Языки перевода не настроены на сайте импорта. Импортированные строки для ненастроенного языка попадают в язык по умолчанию. Сначала добавьте недостающие языки в WPML → Настройки → Языки, затем запустите повторно.
Неподдерживаемый плагин импорта. Импортированные записи остаются в статусе «Черновик» после шага связывания. Опубликуйте их вручную или перейдите на поддерживаемый плагин.
Специально созданные скрипты импорта, которые не передают языковые данные. Исправление находится на уровне скрипта. Три языковых столбца (и столбец атрибутов WooCommerce, когда это применимо) должны достичь строки.

Если импорты продолжают спотыкаться об одну и ту же проблему, команда поддержки WPML отвечает на вопросы по импорту круглосуточно и без выходных.

Если Вы искали плагин WPML All Import

WPML All Import — это устаревший плагин, предшествующий Экспорту и импорту WPML. Он больше не поддерживается и не рекомендуется. Описанная выше процедура — это современный способ импорта многоязычного контента на сайт WordPress; используйте ее вместо любого рабочего процесса, описанного в документации старого плагина.