
Сниппет msReviewMediaGallery
Выводит горизонтальную галерею опубликованных фото из отзывов по товару.
Назначение
UGC-блок на странице товара: миниатюры фото покупателей. По умолчанию клик открывает lightbox (стрелки, счётчик, закрытие). С reviewAnchor ссылка ведёт к якорю отзыва на странице.
Где вызывать
- Шаблон msProduct, между msRatingSummary и msReviews.
- Передайте
hideEmpty=1, чтобы скрыть блок без фото.
Зависимости
- MiniShop3, msReviews
- Настройка
msreviews_media_enabled - Lightbox: сниппет подключает
reviews.jsпри наличии фото; строки UI — через msReviewsLexiconScript (msreviews_media_lightbox_*)
Параметры
| Параметр | По умолчанию | Описание |
|---|---|---|
product_id | id ресурса | ID товара MS3 |
limit | 24 | Максимум фото (1–100) |
tpl | tplReviewMediaGallery | Чанк-обёртка (плейсхолдер gallery_body) |
itemTpl | tplReviewMediaGalleryItem | Чанк элемента. По умолчанию HTML собирается в PHP |
hideEmpty | 1 | Не выводить без фото |
showHeading | 1 | Заголовок <h3> «Фото из отзывов» |
reviewAnchor | (пусто) | Якорь отзыва, напр. #msreviews-reviews. Пусто — lightbox вместо перехода |
Lightbox (по умолчанию)
Без reviewAnchor миниатюры получают data-msr-media-lightbox="1". reviews.js открывает диалог с навигацией по всем фото блока.
Перед галереей вызовите msReviewsLexiconScript, иначе подписи кнопок lightbox возьмутся из fallback в JS.
{'!msReviewsLexiconScript' | snippet}
{'!msReviewMediaGallery' | snippet : [
'product_id' => $_modx->resource.id,
'limit' => 12,
'hideEmpty' => 1
]}[[!msReviewsLexiconScript]]
[[!msReviewMediaGallery?
&product_id=`[[*id]]`
&limit=`12`
&hideEmpty=`1`
]]Переход к секции отзывов
С reviewAnchor lightbox отключается: ссылка ведёт на якорь (в Hub/Tabbed секция отзывов — #msreviews-reviews).
{'!msReviewMediaGallery' | snippet : [
'product_id' => $_modx->resource.id,
'limit' => 24,
'reviewAnchor' => '#msreviews-reviews',
'hideEmpty' => 1
]}[[!msReviewMediaGallery?
&product_id=`[[*id]]`
&limit=`24`
&reviewAnchor=`#msreviews-reviews`
&hideEmpty=`1`
]]Кастомный itemTpl
При itemTpl ≠ tplReviewMediaGalleryItem сниппет передаёт в чанк готовый [[+link_html]] (ссылка + img). Разметку ссылки в PHP собирает msr_storefront_media_link_html.
На странице товара
{'!msReviewsLexiconScript' | snippet}
{'!msRatingSummary' | snippet : ['product_id' => $_modx->resource.id]}
{'!msReviewMediaGallery' | snippet : ['product_id' => $_modx->resource.id, 'limit' => 12, 'hideEmpty' => 1]}
{'!msReviewsFilters' | snippet : ['product_id' => $_modx->resource.id, 'showCounts' => 1]}
{'!msReviews' | snippet : ['product_id' => $_modx->resource.id, 'showStats' => 0]}[[!msReviewsLexiconScript]]
[[!msRatingSummary? &product_id=`[[*id]]`]]
[[!msReviewMediaGallery? &product_id=`[[*id]]` &limit=`12` &hideEmpty=`1`]]
[[!msReviewsFilters? &product_id=`[[*id]]` &showCounts=`1`]]
[[!msReviews? &product_id=`[[*id]]` &showStats=`0`]]Чанки: Чанки — галерея.
См. также
- msReviews
- msReviewForm — загрузка фото
- msReviewsLexiconScript
- Интеграция
- FAQ
