Импорт/экспорт категорий

Модуль работает на CS-Cart и Multi-Vendor начиная с версии 4.3.1 и поддерживает редакции CS-Cart, CS-Cart Ultimate, Multi-Vendor, Multi-Vendor Plus и Multi-Vendor Ultimate. С версии 1.7.0 модуль совместим с PHP 8.3.

• CS-Cart Ultimate — категории выгружаются и загружаются с привязкой к витрине (поле Store).
• Multi-Vendor — поле Store (витрина) доступно начиная с CS-Cart 4.14.1.
• Модуль Отзывы и комментарии — если он включён, в файле появляется поле Discussion с типом отзывов категории.
• Модуль SEO — если он включён, в файле появляется поле SeoName.
• Модуль Тарифные планы для продавцов: Комиссии для категорий (Multi-Vendor) — если он включён, комиссия каждого тарифного плана выгружается и загружается отдельной колонкой (с версии 1.6.0).

На данный момент нет информации о несовместимости модуля с какой-либо темой. В случае конфликта модуля с вашей темой обращайтесь в наш центр поддержки.

После оформления и оплаты, ваш заказ будет автоматически переведен в статус Оплачен в течение считанных минут. Статус заказа Оплачен означает активацию лицензии и вам на e-mail отправляется письмо с подтверждением о получении оплаты и письмо со ссылкой на скачивание модуля. Так же модуль всегда можно скачать в нашем разделе Управление лицензиями. Для установки модуля на ваш сайт, пожалуйста, выполните следующие шаги:

1. Скачайте последнюю версию модуля на нашем сайте в разделе "Управление лицензиями" или по ссылке, отправленной по e-mail.
2. Пройдите в раздел Модули → Управление модулями и в меню шестерёнки выберите Ручная установка.
3. Выберите ранее скачанный файл и завершите установку модуля.

На этом установка модуля завершена. Для перехода на страницу настроек модуля выберите установленный модуль в разделе Модули → Модули CS-Commerce

Модуль работает в трёх местах панели администратора:

• Администрирование → Экспорт данных → Категории и Администрирование → Импорт данных → Категории — выгрузка и загрузка файла;
• Товары → Категории — экспорт выбранных категорий и товаров из них, поле Артикул категории на странице категории;
• Модули → Модули CS-Commerce → Импорт/экспорт категорий — страница модуля с генерацией недостающих артикулов.

Глобальных настроек у модуля нет: всё, что влияет на выгрузку и загрузку, выбирается в параметрах экспорта и импорта. Единственное, что нужно подготовить, — артикулы категорий.

Артикул категории

Артикул — это код, по которому импорт находит категорию в магазине. Он уникален в пределах одной витрины. Поле находится на странице категории, вкладка Модули, раздел Импорт/экспорт категорий.

• При установке модуль заполняет артикулы всех существующих категорий их ID.
• Если сохранить категорию с пустым артикулом, он заполнится её ID.
• Артикул можно заменить на свой, например на код категории из учётной системы, — тогда импорт будет сопоставлять категории по нему.

Генерация недостающих артикулов

Если у части категорий артикула нет (например, категории созданы до установки модуля другим способом), откройте Модули → Модули CS-Commerce → Импорт/экспорт категорий, нажмите на шестерёнку и выберите Сгенерировать артикулы категориям без артикула. В скобках показано, сколько таких категорий. Артикулом становится ID категории; если этот ID уже занят артикулом другой категории, к нему добавляется случайный префикс из двух букв, например KX-245.

Откройте Администрирование → Экспорт данных → Категории. Страница устроена так же, как экспорт товаров: слева выгружаемые поля, справа доступные, раскладку полей можно сохранить и выбирать потом из списка Макеты. Обязательные поля — CategoryCode, CategoryPath и Language, а в CS-Cart Ultimate при работе со всеми витринами ещё и Store.

Параметры экспорта:

• Язык — на каких языках выгружать названия, описания и мета-теги. Для каждого выбранного языка категория выгружается отдельной строкой.
• Разделитель категории — чем разделяются уровни в пути категории, по умолчанию ///: Электроника///Компьютеры///Ноутбуки.
• Разделитель CSV, имя файла и прочие параметры — стандартные, как у экспорта товаров.

Категории выгружаются по уровням: сначала корневые, затем их подкатегории и так далее. Такой файл можно сразу загрузить обратно — родительские категории в нём всегда идут раньше дочерних.

Экспорт выбранных категорий

Чтобы выгрузить не всё дерево, а часть, отметьте категории в списке Товары → Категории, нажмите на шестерёнку и выберите Экспортировать выбранные. Откроется страница экспорта, где уже задан диапазон из отмеченных категорий. Выбрать категории можно и с самой страницы экспорта — ссылкой в боковой панели.

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

Откройте Администрирование → Импорт данных → Категории. Вверху страницы перечислены поля, которые может содержать файл; обязательные выделены. Проще всего получить файл нужного формата, выгрузив категории экспортом, и править уже его.

Параметры импорта:

• Создать резервную копию таблиц — перед импортом сохранить таблицы категорий, их описаний и SEO-имён. По умолчанию включено.
• Режим импорта:
  • Все — категории, найденные по артикулу, обновляются, остальные создаются;
  • Обновлять только существующие категории — строки с незнакомыми артикулами пропускаются;
  • Только создавать новые категории — строки с артикулами, которые уже есть в магазине, пропускаются.
• Разделитель категории — должен совпадать с разделителем в поле CategoryPath файла, по умолчанию ///.

Пропущенные строки попадают в итоговую статистику импорта как пропущенные.

Как категория находится и создаётся

• Категория ищется по CategoryCode, в CS-Cart Ultimate — в пределах витрины из поля Store (или текущей витрины, если она выбрана в панели администратора).
• Последний элемент CategoryPath — название самой категории, всё до него — путь к родителю. Родительские категории ищутся по названию, уровень за уровнем, от корня.
• Чтобы переименовать категорию, измените последний элемент пути; чтобы перенести её в другую ветку — путь к родителю. Артикул при этом оставьте прежним.
• Новая категория получает название на всех языках магазина: на тех, что есть в файле, — из файла, на остальных — на языке первой строки.

Родительская категория должна существовать в магазине или стоять в файле выше дочерней. Если родитель по пути не найден, модуль предупреждает «Родительской категории не существует: …» и создаёт категорию в последней найденной категории пути — проверьте такие категории после импорта.

Если что-то пошло не так

Резервная копия сохраняется как обычный бэкап CS-Cart с именем categories_backup_<дата>_<время>.sql в архиве zip. Восстановить её можно в разделе Администрирование → Резервное копирование и восстановление — таблицы категорий, их описаний и SEO-имён вернутся в состояние до импорта.

Резервная копия касается только таблиц категорий, их описаний и SEO-имён. Изображения категорий, отзывы и комиссии продавцов в неё не входят.

Большие каталоги

Делить файл на части не нужно: с версии 1.7.0 импорт проходит целиком на каталогах в несколько тысяч категорий и работает в 2–3 раза быстрее прежнего. В версиях до 1.7.0 на больших каталогах импорт мог прерваться, не загрузив все категории, — если вы сталкивались с этим, обновите модуль.

Обязательные поля выделены жирным.

• CategoryCode — артикул категории, по нему импорт находит категорию.
• CategoryPath — путь в дереве через разделитель категории: Одежда///Обувь. Последний элемент — название категории. Значение на языке строки.
• Language — код языка строки: ru, en.
• CategoryId — ID категории. Только экспорт.
• DateAdded — дата создания. Только экспорт.
• CategoryUrl — ссылка на страницу категории на витрине. Только экспорт (с версии 1.5.0).
• Status — A включена, D выключена, H скрыта.
• Position — позиция среди соседних категорий.
• DetailedImageURL — изображение категории. При экспорте — адрес изображения, за которым в фигурных скобках идёт alt-текст по языкам: https://.../image.png#{[ru]:Обувь;[en]:Shoes;}. При импорте — адрес или путь к файлу в том же формате. Если имя файла совпадает с уже загруженным изображением категории, файл не перезагружается, обновляется только alt-текст.
• Description — описание категории на языке строки.
• PageTitle, MetaDescription, MetaKeywords — заголовок страницы и мета-теги на языке строки.
• SeoName — SEO-имя категории. Есть, если включён модуль SEO.
• ProductDetailsView — шаблон страницы товара для категории, например default.
• UsergroupIds — ID групп пользователей, которым видна категория; 0 — всем.
• Store — название витрины. В CS-Cart Ultimate обязательно, если в панели администратора выбраны все витрины; в Multi-Vendor — с CS-Cart 4.14.1.
• Discussion — тип отзывов категории: B общение и оценка, C общение, R оценка, D выключено. Есть, если включён модуль Отзывы и комментарии.
• Vendor categories fee - <тарифный план> — комиссия для категории в процентах, отдельная колонка на каждый тарифный план. Есть в Multi-Vendor, если включён модуль Тарифные планы для продавцов: Комиссии для категорий.

Для того, чтобы иметь доступ к обновлениям модуля, у вас должен быть активный период подписки на обновления. При истекшем периоде подписки, вам будут доступны только обновления, выпущенные до даты истечения вашей подписки. Продлить подписку на обновления можно в разделе "Управление лицензиями" на нашем сайте. 

Модуль поддерживает поставку обновлений через Центр обновлений CS-Cart. О выходе новых версий модуля вас оповестит встроенный Центр уведомлений Cart (колокольчик). Обновление модуля с помощью Центра обновлений позволит без потерь настроек данных модуля произвести переход на более новую версию модуля.

Непосредственно перед обновлением, крайне рекомендуется делать полный бэкап сайта (базы данных и файлов) вашего магазина средствами сервера или хостинга.

Обновление модуля через Центр обновлений:

1. В верхнем меню пройдите в раздел Администрирование → Центр обновлений;
2. В меню шестеренки нажмите "Проверить доступные обновления"
3. Cреди списка доступных обновлений найдите нужное и нажмите кнопку Обновить;
4. Следуйте всем инструкциям, которые будут показаны при процедуре обновления;
5. Рекомендуется произвести очистку кэша CS-Cart после завершения устанвоки обновлений удалением папки var/cache на вашем сервере или добавлением в адресную строку параметра ctpl (прмиер: https://domain.com/admin.php?ctpl).

Переустановка модуля удалением:

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

Для полной переустановки модуля без сохранения данных выполните следующие шаги:

1. Пройдите в раздел Модули → Управление модулями и найдите старый установленный модуль.
2. Нажмите в меню шестеренки модуля кнопку удалить.
3. Скачайте последнюю версию модуля на нашем сайте в разделе "Управление лицензиями".
4. Пройдите в раздел Модули → Управление модулями и в меню шестеренки выберите Ручная установка.
5. Выберите ранее скачанный файл и завершите установку модуля.

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

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

1. На нашем сайте центра поддержки https://helpdesk.cs-commerce.com/ авторизуйтесь под своей учетной записью;
2. Нажмите на кнопку "Новая заявка";
3. Заполните все необходимые поля и создайте заявку (Вы получите на e-mail письмо с подтверждением);
4. Ожидайте ответ специалиста (на ваш e-mail придет уведомление об ответе на вашу заявку) в соответствии с регламентами работы службы техподдержки.

Если Вы не получили ответ в течении сроков, обозначенных в регламентах, напишите нам на e-mail [email protected] сообщение с темой заявки и мы постараемся решить вас вопрос в ближайшее время.

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

Рекомендуем ознакомиться с общими ограничениями:

1. Фрагменты кода  или некоторые файлы модуля могут иметь закрытую (закодированную) часть. Закодированная часть не создает проблемы в доработке модуля;
2. Модуль будет работать только на тех доменах, которые указаны в лицензии пользователя. При попытке использования решения на установках CS-Cart, домены которых не включены в лицензию, модуль будет автоматически выключен;
3. Установка локально не допускается системой лицензирования. Чтобы модуль работал на дополнительном домене (псевдониме) укажите этот псевдоним на странице управления лицензиями. На один домен допускается указать до трех псевдонимов для нужд тестирования и разработки.
4. Главный домен лицензии вы можете менять самостоятельно на странице управления лицензиями. 

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

Версия 1.7.0 от 7 октября 2026 года

• Добавлена совместимость с PHP 8.3.
• Исправлен импорт категорий на магазинах с большим каталогом: импорт мог прерываться, не загрузив все категории из файла; теперь он выполняется в 2–3 раза быстрее и с меньшей нагрузкой на сервер.
• Улучшена совместимость импорта обсуждений категорий со старыми версиями CS-Cart.
• Базовые обновления безопасности модуля.

Версия 1.6.1 от 11 марта 2025 года

• Исправлена проблема импорта данных на некоторых конфигурациях.

Версия 1.6.0 от 20 февраля 2025 года

• Добавлена совместимость с модулем «Тарифные планы для продавцов: Комиссии для категорий» для CS-Cart Multi-Vendor.

Версия 1.5.0 от 11 сентября 2024 года

• Добавлен экспорт ссылки на страницу категории.
• Добавлен импорт и экспорт типа отзывов (модуль Отзывы и комментарии).
• Если артикул категории не задан, он заполняется ID категории.
• Базовые обновления безопасности модуля.

Версия 1.4.0 от 29 мая 2024 года

• Исправлен импорт SEO-имён категорий на некоторых конфигурациях.
• Базовое обновление безопасности модуля.

Версия 1.3 от 28 апреля 2023 года

• Добавлены экспорт и импорт изображений категорий с alt-текстом.

Версия 1.2 от 30 января 2023 года

• Добавлена генерация артикулов для категорий, у которых он не задан.

Версия 1.1 от 17 января 2023 года

• Исправлен импорт названий категорий на многоязычном магазине.

Версия 1.0 от 27 декабря 2022 года

• Первый релиз модуля.