Подготовка и выгрузка характеристик Эпицентр

Эпицентр — Импорт и заполнение характеристик

Версия: 1.0.0
Автор: Yevhen Plashenko
Совместимость: OpenCart 3.0.x / ocStore 3.0.x

Возможности модуля

• Импорт характеристик из Эпицентра по ссылке: модуль позволяет парсить страницу товара с сайта Эпицентра и автоматически загружать все характеристики (атрибуты) этого товара в вашу карточку товара OpenCart.
• Отображение характеристик в карточке товара: все импортированные атрибуты сохраняются в товаре и отображаются пользователям на витрине (в разделе «Характеристики» товара) без дополнительных настроек.
• Автоматическое определение языка: модуль распознаёт доступные языки данных на сайте Эпицентра (украинский/русский) и заполняет характеристики на соответствующих языках в вашем магазине. В мультиязычных магазинах значения характеристик могут заполняться сразу для всех языков.
• Сопоставление атрибутов и опций: интеграция импортированных характеристик с вашей существующей базой атрибутов и опций. Модуль автоматически создает недостающие атрибуты и группы атрибутов, а также может сопоставлять некоторые спецификации Эпицентра с опциями товара (например, размер, цвет) при необходимости, избегая дублирования данных.
• Инструменты для синхронизации данных: в комплекте есть средства первичной загрузки справочников Эпицентра – категорий, стран-производителей, брендов – и полной структуры характеристик. Это облегчает дальнейшее ручное заполнение и обеспечивает корректное сопоставление полей.
• Безопасная интеграция: модуль реализован через систему OCMOD (модификаторы OpenCart) и не вносит прямых изменений в ядро. Все правки виртуальны и легко отключаются, что гарантирует стабильность работы магазина.

Установка модуля

Установка выполняется стандартным способом через модификатор (OCMOD):

1. Сделайте резервную копию файлов и базы данных магазина (рекомендуется перед установкой любого модуля).
2. В админ-панели перейдите в раздел Дополнения → Установка расширений (Extensions → Installer) и загрузите архив модуля (OCMOD файл .ocmod.zip).
3. После успешной загрузки откройте раздел Дополнения → Модификаторы (Extensions → Modifications) и нажмите кнопку «Обновить» (Refresh) для применения модификатора. Убедитесь, что новый модификатор «Epicentr Characteristics» появился в списке модификаторов и активирован.
4. При необходимости зайдите в Система → Пользователи → Группы пользователей и дайте группе Администратор права на доступ/изменение для нового модуля (файлы, связанные с Epicentr, если модуль добавляет новые права).
5. Перейдите в раздел Дополнения → Модули (Extensions → Modules), найдите в списке модуль «Эпицентр — Импорт характеристик» и нажмите «Установить» (зелёная кнопка). Затем нажмите «Редактировать» (иконка карандаша) для перехода к настройкам модуля.

Первичная настройка

После установки перед началом работы необходимо единожды синхронизировать справочники с Эпицентра. В настройках модуля вы найдете соответствующие кнопки импорта:

Импорт категорий Эпицентра

В модуле нажмите кнопку «Импорт категорий» (или «Синхронизация категорий Эпицентра»). Будет загружен актуальный список категорий с сайта Эпицентра. Эти данные необходимы для структуры характеристик – каждая характеристика привязана к определенной категории. Дождитесь завершения процесса импорта категорий. (В дальнейшем, при обновлении каталога Эпицентра, вы можете повторно выполнить импорт категорий, но обычно достаточно сделать это один раз.)

Импорт стран-производителей

Выполните импорт списка стран. Модуль загрузит перечень всех стран, используемых на Эпицентре в качестве «Страны производства» товаров. Эти данные понадобятся для заполнения атрибута происхождения товара. Если в вашем магазине несколько языков, названия стран будут сохранены на каждом из них. Обычно достаточно нажать кнопку «Импорт стран» – появится сообщение об успешной загрузке списка стран.

Импорт брендов (производителей)

Запустите импорт брендов. Модуль получит список всех брендов, представленных на Эпицентр. Импортированные названия брендов будут сопоставлены с производителями в вашем магазине (раздел Каталог → Производители). Если какого-то производителя еще нет, модуль может создать новую запись автоматически. Это нужно для того, чтобы при парсинге товаров бренд товара корректно устанавливался как производитель. После выполнения вы получите полный справочник брендов для дальнейшего использования.

Загрузка структуры характеристик

Нажмите «Загрузить структуру характеристик» (может называться «Импорт атрибутов» или «Синхронизация характеристик»). Модуль скачает с Эпицентра все доступные характеристики по каждой категории и создаст соответствующие атрибуты в вашем магазине. Будут сформированы группы атрибутов и сами атрибуты так, как они структурированы на Эпицентре. Также загрузятся заранее известные варианты значений (справочники опций) для тех характеристик, у которых есть фиксированный набор (например, цвета, размеры, типы и т.д.). После завершения этой операции в вашем магазине появится полный список атрибутов Эпицентра (их можно просмотреть в Каталог → Характеристики), готовых к заполнению у товаров. **Примечание:** Этот процесс может занять некоторое время при первом выполнении, в зависимости от объема данных. Рекомендуется выполнять поочередно (сначала категории, затем страны/бренды, затем атрибуты) и дожидаться окончания каждой операции.

Заполнение характеристик товара

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

Ручное заполнение

Откройте нужный товар для редактирования (навигация: Каталог → Товары, далее нажмите «Редактировать» напротив товара). На странице редактирования товара, благодаря модулю, появилась дополнительная вкладка, например «Эпицентр хар-ки» (Epicentr характеристики). Перейдите на эту вкладку. Вначале выберите категорию Эпицентра, к которой относится данный товар, из выпадающего списка или через автопоиск по названию (поле «Категория Эпицентра»). После выбора категории модуль отобразит полный список характеристик, предусмотренных для этой категории.

Теперь вы можете заполнить значения этих характеристик. Напротив каждого названия атрибута есть поле ввода для значения. Если у вас мультиязычный магазин, вы увидите поля для каждого языка (под флагами языков) – заполните все необходимые языковые версии характеристики. Для некоторых характеристик, имеющих фиксированный набор значений, доступен выпадающий список (например, типы, размеры, стандарты и пр.) – вы можете просто выбрать нужное значение без ввода вручную. Обязательные характеристики, требуемые Эпицентром, отмечены символом «*», их желательно заполнить. Заполнив нужные поля, нажмите «Сохранить» товара. Добавленные характеристики сразу станут видны на витрине в карточке товара, что позволит покупателям ознакомиться с подробными свойствами товара.

Автозаполнение (парсинг по URL)

Модуль значительно упрощает заполнение за счет автоматического импорта. Если товар уже представлен на сайте Эпицентра (например, у производителя или другого продавца), вы можете скопировать его URL. Перейдите на вкладку «Эпицентр характеристики» в админке товара. Введите скопированный URL страницы товара Эпицентра в специальное поле для парсинга (например, «URL товара Эпицентр») и нажмите кнопку «Заполнить» или «Парсинг». Модуль подключится к сайту Эпицентра и загрузит все характеристики этого товара автоматически.

За несколько секунд соответствующие поля значений заполнятся данными из Эпицентра. Язык данных определяется автоматически: если в вашем магазине несколько языков, модуль постарается заполнить значения на каждом (например, украинские значения в столбце с флагом UA, русские – с флагом RU). Таким образом, вы получаете готовое двуязычное описание характеристик прямо с сайта Эпицентра.

Кроме атрибутов, при парсинге модуль может установить и некоторые сопутствующие данные: например, если на Эпицентре указан бренд (производитель) товара, модуль сопоставит его с вашим списком производителей и выберет соответствующего производителя для товара (при условии, что вы ранее импортировали бренды). После автозаполнения рекомендуется просмотреть полученные значения, при необходимости подкорректировать их вручную, и сохранить изменения. Все импортированные характеристики будут сохранены в товаре, при этом остальные данные (название, описание, цена и т.д.) **не изменяются** – модуль работает только с характеристиками и не затрагивает другие поля товара.

Примечание: Для успешного парсинга убедитесь, что вы выполнили первичный импорт данных для категории данного товара (как описано выше). Если вы пропустили импорт какой-либо категории или атрибутов, модуль может не найти нужные поля для заполнения. В таком случае сначала синхронизируйте структуру характеристик для соответствующей категории, затем повторите парсинг по URL.

Информация о безопасности

Данный модуль разработан с учетом безопасности и чистоты системы. Он не вносит изменений в ядро OpenCart: все добавления реализованы через OCMOD-модификаторы. Это означает, что оригинальные файлы движка не изменяются – модуль как бы «надстраивается» над системой. Вы всегда можете включить или отключить модуль через список модификаторов, либо удалить его, не опасаясь, что это повлияет на работу магазина.

Модуль сохраняет все данные (новые атрибуты, категории Эпицентра, и т.д.) в стандартных таблицах базы данных OpenCart или в отдельных таблицах, предусмотренных модулем, не перезаписывая существующую информацию. Нет потенциально опасных действий – интеграция с сайтом Эпицентра происходит в режиме чтения (только получение данных). Ваш магазин и данные покупателей никак не затрагиваются при парсинге. Таким образом, использование модуля безопасно для целостности сайта. Регулярные обновления и поддержка автора обеспечивают совместимость с актуальными версиями OpenCart/ocStore.

Описание модуля опубликовано на webdd.in.ua