Интеграция и сценарии

Подключите сниппеты в шаблонах MiniShop3. На карточке товара product_id — id ресурса MS3.

Fenom

Не вызывайте getObject() из шаблона: у $_modx этого метода нет. Вызывайте сниппет напрямую. При hideEmpty=1 блок останется пустым без отзывов.

Три способа собрать блок на карточке

Способ	Когда	Сниппеты
A — по частям	Полный контроль разметки	LexiconScript → RatingSummary → … → Schema
B — msReviewsHub	Весь блок одним вызовом	msReviewsHub
C — вкладки	Компактная карточка	msReviewsTabbed + msReviewForm + msReviewSchema отдельно

Не смешивайте msReviewsHub или msReviewsTabbed с отдельными msReviews / msQuestions на одной странице — получите дубли списков и второй JSON-LD.

Детали: Страница товара.

Verified purchase

1. Плагин msReviews Order status → очередь при статусах из msreviews_request_order_statuses.
2. Письмо со ссылкой на страницу товара: ?msr_token=…&msr_product_id=….
3. msReviewForm на той же странице с тем же product_id.
4. Настройки: Verified в settings.

Фильтры списка отзывов

Параметры msReviews: verifiedOnly, withMedia, withReply, recommendOnly, sortBy=helpful. По умолчанию те же фильтры читаются из GET msr_*.

Или сниппет msReviewsFilters — chip-ссылки с GET msr_*. Ставьте перед msReviews. Chip-ссылки ведут на #msreviews-list-section (якорь есть при showHeading=1 у списка). См. msReviewsFilters.

Кэш страницы: при cache_resource=1 HTML карточки кэшируется без учёта ?msr_*. Пакет ставит плагин msReviews Storefront cache — не отключайте его, иначе фильтры «залипнут». С imageoptimizer HTML-кэшем плагин тоже сбрасывает ответ с query.

Hub / Tabbed: внутренний msReviews вызывается с showHeading=0 и applyRequestFilters=0. Chip-фильтры снаружи Hub не сработают, пока не передадите applyRequestFilters=1 в msReviewsHub / msReviewsTabbed.

Какой сниппет списка: карточка или лента

Нужно	Сниппет	Область
Список отзывов одного товара (карточка, Hub, Tabbed, Filters)	msReviews	Обязателен product_id (или id текущего ресурса на странице товара)
Лента последних отзывов на главной / категории / лендинге	msReviewsLatest	Весь каталог или parents / productIds. Параметра product_id нет

То же для Q&A: на карточке товара msQuestions, для FAQ-ленты по каталогу msQuestionsLatest.

Без product_id у msReviews сработает fallback на id страницы, а не «все товары». Для ленты по каталогу вызывайте msReviewsLatest.

Пагинация (pdoPage)

Нужен pdoTools. Оборачивайте msReviews, msQuestions, msReviewsLatest, msQuestionsLatest в !pdoPage с pageVarKey, pageNavVar, totalVar. Внутри обёртки сниппет выводит только карточки, без шапки списка.

fenom

{'!pdoPage' | snippet : [
  'element' => 'msReviews',
  'product_id' => $_modx->resource.id,
  'limit' => 5,
  'showStats' => 0,
  'pageVarKey' => 'reviews_page',
  'pageNavVar' => 'reviews.page.nav',
  'totalVar' => 'reviews.page.total'
]}
<div class="msreviews-pdopage-nav">{'reviews.page.nav' | placeholder}</div>

modx

[[!pdoPage?
  &element=`msReviews`
  &product_id=`[[*id]]`
  &limit=`5`
  &showStats=`0`
  &pageVarKey=`reviews_page`
  &pageNavVar=`reviews.page.nav`
  &totalVar=`reviews.page.total`
]]
<div class="msreviews-pdopage-nav">[[!+reviews.page.nav]]</div>

Q&A — тот же паттерн с element=msQuestions:

fenom

{'!pdoPage' | snippet : [
  'element' => 'msQuestions',
  'product_id' => $_modx->resource.id,
  'limit' => 5,
  'pageVarKey' => 'qna_page',
  'pageNavVar' => 'qna.page.nav',
  'totalVar' => 'qna.page.total'
]}
<div class="msreviews-pdopage-nav">{'qna.page.nav' | placeholder}</div>

modx

[[!pdoPage?
  &element=`msQuestions`
  &product_id=`[[*id]]`
  &limit=`5`
  &pageVarKey=`qna_page`
  &pageNavVar=`qna.page.nav`
  &totalVar=`qna.page.total`
]]
<div class="msreviews-pdopage-nav">[[!+qna.page.nav]]</div>

Два блока на одной странице — разные pageVarKey, pageNavVar, totalVar.

Без pdoPage задайте limit и offset у прямого вызова сниппета.

После AJAX-обновления pdoPage вызовите window.msReviewsInitLists(), если кнопки «полезно» и правка перестали работать.

SEO: JSON-LD

Страница	HTML-рейтинг	JSON-LD
Карточка товара	msRatingSummary (full)	msReviewSchema — один раз
Каталог	tplRatingCatalog / msRatingBadge	нет
Виджеты главной	Latest / TopRated	нет

«Полезно», правка, удаление

Скрипт reviews.js (через msReviews или engagement=1 у msReviewsLatest) обрабатывает голос, правку и удаление. Настройки: msreviews_engagement_*.

Капча

Встроенного виджета нет. Передайте HTML в &captchaHtml= формы и повесьте плагин на msrOnCaptchaVerify. См. События MODX.

Стилизация

Токены --msr-* в reviews.css. Переопределение на родителе карточки товара или через formClass у формы. В каталоге CSS подключают в шаблоне страницы или оставляют автоподключение сниппета — Каталог — reviews.css. Полный список токенов: Чанки.

У витринных сниппетов есть registerCss / registerJs (по умолчанию 1). Глобально: msreviews_frontend_css_enabled / _js_enabled.

Кастомная вёрстка: data-контракт

С 1.2 JS витрины ищет элементы только по data-msr-*, name, type, role. BEM-классы (msreviews-form__*, msreviews-item__*) остались для CSS, в логике скриптов не участвуют.

Кастомный чанк без data-msr-* перестанет работать с штатным JS. Headless (свой фронт + POST на коннектор) это не затрагивает.

Формы

Атрибут	Элемент	Зачем
data-msr-form-wrap	обёртка	Область success-блока
data-msr-review-form / data-msr-question-form	<form>	Точка инициализации
data-msr-form-message	блок сообщения	Ошибка / подтверждение
data-msr-rating-group	контейнер звёзд	role="radiogroup"
data-msr-rating-star	кнопка звезды	Выбор оценки
data-msr-rating-value	hidden input	Значение в POST
data-msr-rating-caption	подпись	Текст выбранной оценки
data-msr-file-input / data-msr-file-list	file / ul	Загрузка фото
data-msr-media-max, data-msr-media-max-mb	форма	Лимиты на клиенте
data-msr-success, data-msr-success-text, data-msr-success-again	блок успеха	После отправки
data-connector	форма или список	URL коннектора

Состояния пишет JS атрибутами:

Состояние	Где
data-msr-form-state="success"	обёртка формы
data-msr-message="ok" / "error"	блок сообщения
data-msr-star-lit	закрашенная звезда
aria-pressed="true"	кнопка «Полезно»

Список отзывов

Атрибут	Зачем
data-msr-reviews-list	Корень делегирования, data-connector, data-product-id
data-msr-review-item	Карточка (data-id)
data-msr-item-title, data-msr-item-text, data-msr-item-rating, data-msr-item-foot	Обновление после правки
data-msr-vote, data-msr-vote-count, data-msr-vote-live	«Полезно»
data-msr-own-actions, data-msr-edit-own, data-msr-delete-own, …	Свои действия
data-msr-media-lightbox, data-msr-media-group	Встроенный lightbox

Вкладки

data-msreviews-tabbed на корне, data-msr-tab / data-msr-tab-panel / data-msr-tab-count. Активная вкладка: aria-selected="true", скрытая панель: hidden. Класс .is-active в JS и CSS больше не используется.

Свой фронт без нашего JS

Отключите скрипты параметром registerJs=0 на сниппетах (или настройкой msreviews_frontend_js_enabled = Нет) и отправляйте POST на коннектор. Поля описаны в AJAX API. Тексты UI: window.msrLexicon из msReviewsLexiconScript.

Миграция с 1.1: Обновление до 1.2.

См. также

• Страница товара
• Каталог и главная
• Сниппеты
• Чанки