WP All Import — Casalusso Add-On

Add-on для WP All Import на сайте Casalusso: связывает импортированные товары WooCommerce с Polylang и настраивает переводимые таксономии при создании новых товаров.

Не универсальный плагин. Это индивидуальная разработка под конкретные требования заказчика и конфигурацию проекта Casalusso: номера и настройки импортов WPAI, поля CSV (scu, local), набор языков, атрибуты pa_*, связки с woo-poly-integration и woo-alt-variations. Для других сайтов на WooCommerce и Polylang плагин не подходит без переработки под их импорты, таксономии и бизнес-логику.

Плагин дополняет стандартный импорт WPAI и WooCommerce Add-On: Polylang и woo-poly-integration при импорте через WP All Import не вызываются автоматически (в отличие от создания перевода в админке).

Требования

• WordPress 6.2+
• PHP 7.4+
• WooCommerce
• Polylang (или Polylang Pro)
• WP All Import Pro или WP All Import + WooCommerce Add-On
• [woo-poly-integration_enhanced]
• [WooCommerce Alternative Variations] (мета _display_with_quantity_attributes)

Без активных зависимостей плагин сам деактивируется и показывает уведомление в админке.

Что делает плагин

При импорте новых товаров

Хук: pmxi_saved_post, только если ! $is_update и в строке есть local.

1. Язык товара — из поля CSV local (например ru, en, de, tr).

2. Связь переводов товара — по общему SKU (scu в CSV, мета _sku в WooCommerce): все товары с одним SKU попадают в одну группу post_translations.

3. Подготовка таксономий в Polylang (ensure_polylang_taxonomies_for_product) — если у товара есть термины/атрибуты и в woo-poly включена соответствующая опция (Settings → WooPoly → Features):

   • Translate Categories → product_cat добавляется в переводимые таксономии Polylang, если ещё не включена;
   • Translate Tags → то же для product_tag;
   • Translate Attributes → то же для каждого pa_*, назначенного товару;
   • collection (таксономия темы Casalusso) → включается автоматически, если зарегистрирована и у товара есть коллекция.

   Add-on не создаёт термины и не назначает их товару — только программно ставит «галочку» перевода таксономии в Polylang (аналог Языки → Настройки → Custom taxonomies). Новые pa_*, появившиеся при импорте, включаются автоматически — вручную в Polylang отмечать их не нужно.

4. Создание и назначение терминов из CSV (если WPAI не сделал этого) — при включённой опции woo-poly или для collection:

   • Тэги / Tags → product_tag;
   • Category → product_cat (цепочка Родитель > … > Лист);
   • Collection → collection.

5. Синхронизация таксономий — только если включена та же опция woo-poly (или таксономия collection активна) и таксономия переводимая в Polylang (pll_is_translated_taxonomy):

   • product_cat — язык терминов (включая родителей в цепочке) и связи переводов между языками по SKU; иерархия по глубине (один термин на язык на уровень);
   • product_tag — язык и связи переводов; для нескольких тегов сопоставление по term_order (одинаковое число тегов на всех языках);
   • collection — плоская логика, как у тегов;
   • *`pa_`** — для всех переводимых таксономий атрибутов на товаре; та же плоская логика, что у тегов.

Термины атрибутов не создаёт add-on: их создаёт WPAI. Теги, категории и коллекции add-on создаёт из CSV (Тэги / Tags, Category, Collection). Значения атрибутов в CSV должны быть на каждом языке — add-on не копирует термины с ru, как woo-poly в админке.

Порядок при импорте одного товара: язык и post_translations → ensure_* (Polylang) → sync_* (язык терминов + связи).

При любом импорте товара (create и update)

• Мета _display_with_quantity_attributes для атрибута pa_czvet (интеграция с темой / alt-variations).

Импорт альт. вариаций (vars_info)

Отдельный update-импорт WPAI: запись мета vars_info для плагина woo-alt-variations. Номер импорта не важен — важно содержимое CSV и настройки шаблона.

Функция wpai_casalusso_make_vars_string() преобразует поле Alt_variations из CSV в JSON. В настройках импорта custom field:

vars_info = [wpai_casalusso_make_vars_string({alt_variations[1]}, {local[1]})]

Второй аргумент {local[1]} обязателен: WPAI разбирает custom fields до цикла по строкам, без него язык не определяется.

Отладочный лог: wp-content/import_alt_variatios.log.

Настройка шаблонов WPAI

Ниже — минимальные рабочие настройки для трёх сценариев.

1) Простые товары (create/update с учетом языка)

• Тип импорта: product.
• Условие включения логики add-on: в строке CSV есть local.
• Ключевые поля сопоставления в шаблоне: SKU товара (scu/SKU) + язык local.
• Важно: значения переводимых полей (Title, Category, Tags, pa_*) должны быть на языке строки.

2) Вариативные товары (родитель + вариации, с учетом языка)

• Тип импорта: product + WooCommerce Add-On (режим variable, например first_is_variation).
• Обязательно в данных строки: local и Parent_SCU (или _parent_sku).
• Что делает add-on: после строки вариации корректирует post_parent по паре Parent_SCU + local.
• Номер импорта не используется: можно запускать с любым ID.

3) Альт. вариации (vars_info) — отдельный update-импорт

• Тип импорта: product, режим Update existing.
• Custom field в шаблоне:

vars_info = [wpai_casalusso_make_vars_string({alt_variations[1]}, {local[1]})]

• Для простых товаров: используйте файл вида alt_variations_CL-import-simple-2026-05-26.csv.
• Для variable parent: используйте файл вида alt_variations_CL-import-variative-parents-2026-05-27.csv.
• Важно: если включен пропуск «запись не изменилась», WPAI может не перезаписать vars_info.

Ожидаемый формат CSV

Простые товары (create/update)

Остальные поля обрабатывает WP All Import / WooCommerce Add-On (название, описание, категории, атрибуты, цены и т.д.).

Вариативные товары (родитель + вариации)

Пример тестового файла: wp-content/uploads/wpallimport/files/CL-import-variative-with-parent_2-import.csv.

Альт. вариации (простые и variable parent)

Режим: обновить существующие записи. Сопоставление строки с товаром — по Title + SKU + Local.

Формат Alt_variations — одна строка на товар:

ИмяАтрибута|SKU1,Значение1;SKU2,Значение2;SKU3,Значение3

• До | — подпись атрибута (например Цвет, Color, Renk, Farbe).
• После | — пары через ;, в каждой паре: SKU связанного товара, запятая, подпись варианта (var_attr_value).
• В списке должен быть SKU текущего товара с подписью его цвета/варианта.
• В Alt_variations указываются SKU, не post_id.
• Для variable parent в списке должны быть SKU родителей этой же языковой версии.

Пример (ru):

Цвет|118721,Голубиный серый;118752,Папирус;118738,Арагон

Для строки с SKU=118752 и Local=ru в vars_info попадут post_id товаров 118721, 118752, 118738 на русском, а не en/de/tr.

Правила:

1. Одна строка CSV = один товар = один язык. Для той же модели на en — отдельная строка с переводами в Title и Alt_variations и SKU английских постов.
2. SKU в списке должны существовать в WooCommerce на языке Local; иначе пара пропускается (см. лог).
3. Сначала импорт товаров (simple/variable), затем импорт alt-вариаций.
4. Кодировка файла: UTF-8; разделитель — как в настройках update-импорта alt-вариаций (на dev: ;).
5. Поле Alt_variations с запятыми и ; в Excel — в кавычках.

Файлы на dev:

• wp-content/uploads/wpallimport/files/alt_variations_CL-import-simple-2026-05-26.csv (простые)
• wp-content/uploads/wpallimport/files/alt_variations_CL-import-variative-parents-2026-05-27.csv (родители variable)

Рекомендуемый порядок импорта

1. Сначала язык по умолчанию (ru), затем остальные (en, de, tr).
2. В каждой строке CSV — свои переводимые значения (название, категории, теги, термины pa_*).
3. Для нескольких тегов или значений одного атрибута на товаре — одинаковый порядок значений во всех языковых строках с тем же SKU.
4. В Settings → WooPoly → Features включите Translate Categories, Translate Tags и Translate Attributes для тех таксономий, которые нужно обрабатывать при импорте. Если опция выключена, add-on не включает таксономию в Polylang и не синхронизирует её термины.
5. После импорта simple/variable запускайте отдельный update-импорт для vars_info.

Логирование

При обработке новых товаров (create-импорт с local) пишется лог:

wp-content/uploads/product_taxonomies.log

В лог попадают включение таксономий в Polylang (enabled polylang translation for …) и результаты синхронизации терминов.

Ограничения и что не входит в плагин

Подробный разбор отличий от сценария «Добавить перевод» в админке + woo-poly: docs/woo-poly-integration-import-analysis.txt.

Структура

wpai-casalusso-add-on/
├── wpai-casalusso-add-on.php          # bootstrap
├── includes/
│   ├── class-wpai-casalusso-import.php
│   ├── class-wpai-casalusso-dependencies.php
│   └── wpai-casalusso-functions.php
└── docs/
    └── woo-poly-integration-import-analysis.txt

Установка

1. Склонировать репозиторий в wp-content/plugins/wpai-casalusso-add-on/.
2. Активировать плагин в WordPress после установки всех зависимостей.
3. Настроить шаблоны WPAI для простых, вариативных и alt-вариаций по разделам «Настройка шаблонов WPAI» и «Ожидаемый формат CSV».

Автор

Irina Feodorova

Лицензия

GNU General Public License v2.0 or later (GPL-2.0-or-later) — стандартная лицензия для плагинов WordPress. Полный текст: LICENSE.

Copyright © 2026 Irina Feodorova