Расширенные теги

Инструкция к модулю Расширенные теги

Что делает модуль

Модуль расширяет стандартные теги CS-Cart: добавляет для тегов отдельные названия по языкам, учитывает эти названия при поиске товаров и страниц, выводит локализованное название на странице тега и добавляет расширенные схемы импорта/экспорта.

Модуль не имеет отдельной страницы настроек в карточке модуля. После активации он работает через стандартные разделы тегов, товаров, страниц, менеджер блоков и импорт/экспорт CS-Cart.

Где находится модуль

Основная работа с тегами выполняется в стандартных разделах CS-Cart, где используются теги товаров и страниц. При редактировании тегов модуль сохраняет название тега для текущего языка.

Блоки витрины добавляются через Дизайн → Макеты → нужный макет или страницу:

• MS: Теги страниц — выводит теги страниц в виде меню. В настройках шаблона указывается ID страницы, определяющий место показа блока.
• MS: Теги блогов — выводит облако тегов блога на основе стандартного блока тегов.

Импорт и экспорт находятся в стандартном разделе Администрирование → Импорт данных / Экспорт данных. Модуль добавляет схемы для тегов, связей тегов и SEO-данных тегов.

Работа с мультиязычными тегами

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

Если покупатель или администратор ищет товары или страницы по переведённому названию тега, модуль сопоставляет это название с основным тегом и возвращает связанные объекты.

Блок тегов страниц

В макетах добавьте «MS: Теги страниц» и задайте ID родительской страницы (по умолчанию 186, замените на ID вашей страницы). Непустой ID нужен для показа: блок виден на указанной странице и её непосредственных дочерних страницах. Это условие показа, а не ограничение выборки тегов: выборка включает теги текстовых страниц с переводом на текущий язык.

Фильтрация дочерних страниц при переходе по тегу использует уже подготовленный список ms_subpages. Если его нет, модуль сам не создаёт список. Если совпадений нет, текущий обработчик не заменяет исходный список пустым результатом.

Блок тегов блога

Для блога используйте шаблон MS: Теги блогов в стандартном блоке тегов. Модуль отбирает теги, связанные со страницами типа «Блог», и выводит их с локализованными названиями.

Импорт и экспорт

Модуль добавляет отдельные схемы обмена данными:

• Теги — экспортирует и импортирует названия тегов с учётом языка.
• Теги ссылки — переносит связи тегов с объектами.
• SEO — экспортирует и импортирует SEO-поля тегов, если в магазине активен совместимый SEO-модуль для тегов.

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

Как проверить работу

1. Создайте или откройте тег на основном языке и сохраните его.
2. Переключите язык административной панели, задайте перевод названия тега и сохраните изменения.
3. Откройте витрину на соответствующем языке и проверьте страницу тега: название и хлебные крошки должны отображаться на выбранном языке.
4. Добавьте тег к товару или странице, затем выполните поиск или переход по тегу на витрине.
5. Добавьте блок MS: Теги страниц или MS: Теги блогов в макет и убедитесь, что в блоке отображаются нужные теги.
6. Выполните тестовый экспорт тегов и проверьте, что в файле есть языковые данные, связи или SEO-поля в зависимости от выбранной схемы.

Если теги отображаются неправильно

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

Формат файлов и ограничения импорта

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

• Теги: обязательны tag_id, Language и tag. Language — код языка, tag — его перевод; Company необязателен.
• Теги ссылки: Name — базовое имя тега, Company — числовой ID компании, Object_id — ID объекта, Type — тип объекта (P для товара, A для страницы). Name, Company и Type обязательны по схеме; для осмысленной связи указывайте Object_id.
• SEO: Name обязателен. Только при активном ab__seo_for_tags добавляются AB:SEO:H1, AB:SEO:description, AB:SEO:page_title, AB:SEO:meta_description, AB:SEO:meta_keywords и AB:SEO:language.

«Не создавать новые теги» включено по умолчанию и задаёт режим обновления для отсутствующих записей. Однако преобразователь Name в схеме связей сам может создать тег или активировать ожидающий тег ещё при сопоставлении. Не считайте этот флажок гарантией отсутствия новых тегов при импорте связей: используйте существующие базовые имена и сначала проверьте одну строку.

При переносе между магазинами ID тегов, компаний и объектов могут отличаться — сопоставьте их перед импортом. После пробной строки проверьте перевод, связи и витрину, затем импортируйте остальное. Наличие перевода не означает автоматический перевод всех языков: заполните каждый нужный язык отдельно.