
FAQ
Откуда берётся product_id?
Передайте id товара MS3. На странице товара это обычно id ресурса.
{'!msReviews' | snippet : ['product_id' => $_modx->resource.id]}[[!msReviews? &product_id=`[[*id]]`]]У msQuestions и msQuestionForm только product_id. Параметр product не поддерживается.
Где модерировать отзывы с карточки товара?
На Ресурсы → редактирование msProduct вкладка «Отзывы» (право review_view) показывает сводку и кнопку в Extras → msReviews с фильтром по товару. Таблица модерации только в CMP.
Отзыв не появляется сразу
Новые отзывы при модерации получают статус pending. Опубликуйте во вкладке Extras → msReviews → Отзывы. Средний рейтинг пересчитывается после публикации.
Ошибка VueTools в админке
Установите VueTools ≥ 1.1.2-pl и обновите страницу Extras → msReviews.
Verified не сработал
Проверьте:
- товар был в составе этого заказа;
- ссылка из письма ведёт на страницу того же товара;
- при
msreviews_reject_on_cancelстатус заказа не вmsreviews_cancelled_order_status_ids.
См. Verified в settings.
Как закрепить отзыв?
Extras → msReviews → Отзывы → колонка Закреп у опубликованного отзыва. Закреплённые выводятся первыми.
Формат даты в списке
- Глобально:
msreviews_storefront_date_format. - На вызове:
dateFormatуmsReviews.
{'!msReviews' | snippet : [
'product_id' => $_modx->resource.id,
'dateFormat' => 'd.m.Y H:i'
]}[[!msReviews? &product_id=`[[*id]]` &dateFormat=`d.m.Y H:i`]]Порядок формы вопроса и списка Q&A
- Поменяйте местами
msQuestionsиmsQuestionFormв.msreviews-qna-stack. - Настройка
msreviews_qna_form_position=before|after. - Или
msQnaBlockсformPosition.
Рейтинг в каталоге не показывается
Нужны опубликованные отзывы. В чанке карточки:
{'!msRatingSummary' | snippet : [
'product_id' => $id,
'tpl' => 'tplRatingCatalog',
'summaryMode' => 'aggregate',
'hideEmpty' => 1
]}[[!msRatingSummary?
&product_id=`[[+id]]`
&tpl=`tplRatingCatalog`
&summaryMode=`aggregate`
&hideEmpty=`1`
]]Двойной JSON-LD
msReviewSchema вызывайте один раз на карточке. Не комбинируйте msReviewsHub с отдельным schema и не дублируйте msReviewsHub вместе со сборкой по частям.
Fenom экранирует schema
Оборачивайте в {raw (...)}. См. msReviewSchema.
Не смешивать готовый блок и отдельные списки
На боевом сайте выберите один способ: сборка по частям, msReviewsHub или msReviewsTabbed + форма + schema. См. Интеграция.
Фильтры отзывов не меняют список
- Плагин msReviews Storefront cache включён (Extras → Плагины).
- На странице товара стоит отдельный
msReviewsсshowHeading=1, а не только Hub безapplyRequestFilters=1. msReviewsFiltersвызван перед списком на той же странице.
См. Интеграция — фильтры, events — Resource cache.
Импорт и API
- Импорт CSV: Операции в CMP (
review_import). - HTTP API: AJAX API.
После обновления пакета
Очистите кэш MODX. Если админка устарела — переустановите transport через Extras → Installer (ModStore).
