msReviews
msReviews — дополнение для MODX Revolution 3 и MiniShop3: отзывы 1–5★, Q&A, фото к отзывам, подтверждённая покупка, JSON-LD и Vue-админка модерации.
С чего начать: Быстрый старт.
Минимальный путь на витрине
- Установить MiniShop3 и msReviews через ModStore.
- На шаблоне msProduct вывести блок сниппетов (см. Быстрый старт).
- В Системные настройки (namespace
msreviews) задайте статусы заказа для писем и правила модерации. - Настройки → Очистить кэш и открыть карточку товара.
- Модерация: Extras → msReviews.
Быстрые ссылки
| Нужно | Документ |
|---|---|
| Установить и вывести блок на странице товара | Быстрый старт |
Все ключи msreviews_* | Системные настройки |
| Как собрать блок на карточке | Интеграция |
| Карточка товара | Страница товара |
Как подключить reviews.css в каталоге | Каталог, msRatingSummary |
| Параметры сниппетов | Сниппеты (обзор) |
| Чанки и CSS-токены | Чанки |
| CMP и модерация | Админка |
| Connector API | AJAX API |
| Капча и события | События MODX |
| Диагностика | FAQ |
Возможности
- Карточка товара — сводка рейтинга, список отзывов, форма, Q&A, JSON-LD Product + Review
- Готовые блоки для карточки —
msReviewsHub, вкладки, фильтры, CTA и галерея одним или несколькими вызовами - Каталог — строка ★ 4.4 (32) через
tplRatingCatalogилиmsRatingBadge - Главная —
msReviewsLatest,msTopRatedProducts,msQuestionsLatest - Verified purchase — метка по токену из письма после заказа MS3
- UGC — плюсы/минусы, сценарий, вариант, «рекомендую», фото, оценки по критериям
- Engagement — «полезно», правка и удаление своего отзыва
- CMP — дашборд, модерация, медиа, CSV import/export, очередь писем
Системные требования
| Требование | Версия |
|---|---|
| MODX Revolution | 3.0.3+ |
| PHP | 8.2+ |
| MiniShop3 | 1.0+ |
| VueTools | 1.1.2+ (только CMP) |
| pdoTools | 3.x (для Fenom и pdoPage) |
Зависимости
- MiniShop3 — товары
msProduct, заказы, verified purchase
Опционально
- CrawlerDetect — блок ботов при
msreviews_crawler_block_enabled
Установка
- Подключите ModStore.
- Extras → Installer → Download Extras — msReviews → Download → Install.
- Убедитесь, что установлен MiniShop3 и VueTools.
- Настройки → Очистить кэш.
Термины
| Термин | Описание |
|---|---|
| product_id | ID товара MS3 (ms3_product.id), на странице товара обычно совпадает с id ресурса |
| display_avg | Рейтинг для сортировки топа (алгоритм Wilson или среднее) |
| verified | Отзыв с подтверждённой покупкой по токену заказа |
| Готовые блоки | msReviewsHub, msReviewsTabbed, msReviewsFilters — вместо ручной сборки по частям |
| pending | Отзыв на модерации, не виден на витрине |