В OpenCart MarkerView ставится через шаблоны витрины: общий шаблон загружает сниппет, а шаблон product/product содержит якорь и SKU. Нативного расширения MarkerView нет; способ редактирования зависит от версии OpenCart и установленной темы.
Подготовка
- В MarkerView синхронизируйте отзывы, обновите каталог и скопируйте код из Виджет → Конструктор → Подключение.
- Сделайте резервную копию темы и базы данных.
- Уточните версию OpenCart. Официальный Theme Editor OpenCart 4 создаёт включаемые переопределения Twig в базе, не меняя исходный файл. В OpenCart 3, кастомных темах и сборках OCMOD пути и механизм могут отличаться — следуйте документации темы или привлеките разработчика.
MarkerView Cloud работает без сервера со стороны магазина. Для собственного экземпляра сначала выполните Self-hosted-установку, настройте HTTPS и копируйте код из его админ-панели.
Шаг 1. Загрузите сниппет
В OpenCart 4 откройте Design → Theme Editor, создайте или измените переопределение общего шаблона подвала для нужного магазина и вставьте актуальный сниппет перед </body>. Включите переопределение и сохраните.
Если проект хранит тему в файлах и под версионным контролем, разработчик может сделать эквивалентное изменение в пользовательской теме вместо редактора. Не редактируйте ядро и не вставляйте сниппет в цикл карточек: на странице нужна одна копия.
Шаг 2. Добавьте якорь товара
Создайте переопределение маршрута шаблона товара (product/product) и добавьте в желаемое место:
<div id="reviews-widget" data-article="{{ SKU_ТЕКУЩЕГО_ТОВАРА }}"></div>
SKU_ТЕКУЩЕГО_ТОВАРА здесь — обозначение, а не готовая переменная. Разработчик должен использовать реальное поле, которое контроллер вашей версии и темы передаёт в Twig, и экранировать его. В одних магазинах это sku, в других отзывы связаны с model или пользовательским кодом. Сначала сравните отображаемое значение с артикулом в каталоге MarkerView.
Product JSON-LD темы иногда позволяет обойтись без data-article, но структура зависит от темы и SEO-расширений. Не обещайте автоматическое сопоставление до проверки нескольких карточек.
Если URL товаров не начинается с /products/, разработчик должен указать реальный productPathPrefix в конфигурации скопированного сниппета. SEO URL OpenCart и расширения могут менять путь, поэтому берите его с опубликованной карточки.
Для общей витрины на главной добавьте в её шаблон:
<div id="reviews-homepage"></div>
Публикация и результат
Включите переопределения для правильного магазина, очистите кэш шаблонов OpenCart и откройте публичную карточку. Виджет должен появиться у якоря; на другой карточке должны загрузиться отзывы другого артикула.
Частые ошибки
- Белая страница после сохранения: синтаксическая ошибка Twig. Отключите переопределение и восстановите рабочий код.
- Изменение действует не в том магазине: в multi-store выбран неверный Store.
- Отзывы одинаковы: шаблон выводит постоянное значение либо
model, который не совпадает с артикулом продавца. - Изменения не видны: очистите template cache; Theme Editor хранит override в базе.
- После обновления темы сломалась разметка: сравните переопределение с новой версией шаблона.
Официальные источники
- OpenCart 4: Theme Editor — переопределения Twig, выбор магазина и ограничения редактора.
- OpenCart: управление товарами — поля каталога и карточки товаров.
Если в Theme Editor нет нужного маршрута или тема полностью заменила карточку, установку должен выполнить разработчик этой темы.