Установка виджета на 1С-Битрикс

В «1С-Битрикс: Управление сайтом» MarkerView подключает разработчик: сниппет добавляется один раз в шаблон сайта, а якорь — в шаблон компонента детальной карточки. Готового модуля MarkerView для Marketplace нет.

Перед изменением

1. Синхронизируйте отзывы и обновите каталог в MarkerView.
2. Скопируйте актуальный код из Виджет → Конструктор → Подключение.
3. Определите, какой шаблон сайта и какой шаблон компонента каталога реально применяются к нужному разделу. В Битрикс один сайт может использовать несколько шаблонов по условиям.
4. Сделайте резервную копию изменяемых файлов и выполняйте работу сначала на тестовой среде.

Нужны права на файлы проекта и знание PHP/шаблонов Битрикс. Пользователю без такого доступа следует передать задачу разработчику или интегратору.

Для MarkerView Cloud сервер поднимать не нужно. Собственное развёртывание выполняется отдельно по Self-hosted-инструкции; после него используйте сниппет с HTTPS-адресом этого сервера.

Шаг 1. Загрузите сниппет

Официальная структура шаблона сайта включает header.php и footer.php в каталоге /bitrix/templates/<ID_ШАБЛОНА>/. Добавьте скопированный сниппет в footer.php активного пользовательского шаблона перед закрывающим </body>.

Не правьте файлы ядра и не вставляйте код в компонент внутри цикла товаров. Если проект хранит собственные шаблоны в /local/templates/, следуйте структуре проекта: точный путь зависит от реализации и версии.

Шаг 2. Выведите якорь в карточке

В шаблоне детального компонента каталога добавьте в нужном месте:

<div id="reviews-widget" data-article="АРТИКУЛ_ТЕКУЩЕГО_ТОВАРА"></div>

Разработчик должен заменить значение на экранированный артикул текущего элемента или торгового предложения из данных компонента. Какое свойство является артикулом — решение конкретного каталога: это может быть стандартное или пользовательское свойство. Сверьте итоговую строку со столбцом артикула в MarkerView.

Если у товара несколько предложений с разными артикулами, заранее выберите правило: основной SKU или обновление data-article при переключении предложения. MarkerView не может автоматически угадать бизнес-правило каталога.

Для главной страницы добавьте в её включаемую область или шаблон:

<div id="reviews-homepage"></div>

Если URL детальных страниц не начинается с /products/, разработчик должен добавить фактический productPathPrefix в конфигурацию скопированного сниппета. Сниппет второй раз добавлять не нужно.

Проверка результата

1. Очистите управляемый кэш Битрикс только штатными средствами проекта.
2. Откройте публичную детальную страницу и проверьте, что в HTML есть один #reviews-widget с правильным data-article.
3. Проверьте вторую карточку с другим артикулом.
4. В MarkerView откройте Настройки → Состояние и запустите проверку живого URL.

Частые ошибки

• Код есть не на всех страницах: изменён шаблон, который применяется только при части условий или к другому сайту.
• После обновления компонента правка исчезла: менялся шаблон поставщика, а не копия в шаблоне сайта. Перенесите переопределение в пользовательский шаблон.
• Отзывы относятся к другому варианту: выведен ID элемента или артикул родительского товара вместо SKU предложения.
• Изменения не видны: очистите кэш Битрикс и проверьте активный шаблон.
• Ошибка PHP: восстановите файл из копии; не скрывайте ошибку изменением настроек сервера.

Официальный источник

1С-Битрикс: устройство сайта и шаблона сайта описывает условия применения шаблонов, header.php, footer.php и каталог компонентов.