msViewCounter
msViewCounter — дополнение для MODX Revolution 3 и MiniShop3: на карточке товара показывает просмотры и число активных посетителей («сейчас смотрят»). Поддерживает честную статистику, маркетинговый boost и синтетический режим для новых магазинов.
С чего начать: Быстрый старт.
Минимальный путь на витрине
- Установить MiniShop3 и msViewCounter через ModStore.
- Убедиться, что плагины
msViewCounterBootstrapиmsViewCounterTrackвключены. - В шаблоне msProduct вывести сниппет (см. Быстрый старт).
- При необходимости выбрать режим в настройках
msviewcounter_mode— Системные настройки. - Очистить кэш и открыть страницу товара.
Быстрые ссылки
| Нужно | Документ |
|---|---|
| Установить и вывести счётчик | Быстрый старт |
Все ключи msviewcounter_* | Системные настройки |
Режимы real, boost, fake | Интеграция |
Стилизация через --msvc-* | Интеграция — стилизация |
| Параметры сниппета | msViewCounter |
| Вывод в каталоге | Каталог товаров |
| CrawlerDetect и боты | Интеграция — CrawlerDetect |
| Диагностика | FAQ |
Возможности
- Общий счётчик — «Этот товар просмотрели 248 раз»
- Live-online — «Сейчас смотрят 3 человека» с heartbeat через JS
- Три режима —
real(честная статистика),boost(реальные данные с базой и разбросом),fake(синтетика без записи в БД) - Дедупликация — один просмотр на товар в рамках сессии (
msviewcounter_dedup_session) - Фильтр ботов — CrawlerDetect при наличии, fallback по
User-Agent - Контроль БД — агрегат в
msviewcounter_totals, active-сессии вmsviewcounter_activeс batch-очисткой - Готовый UI — чанк
tplMsViewCounter, CSS-карточка с переменными--msvc-* - Интеграция — один сниппет на карточке или в строке каталога
Системные требования
| Требование | Версия |
|---|---|
| MODX Revolution | 3.0+ |
| PHP | 8.2+ |
| MiniShop3 | 1.0+ |
| pdoTools | 3.0+ (рекомендуется для Fenom) |
Зависимости
- MiniShop3 — товары класса
msProduct, шаблон карточки
Опционально
- CrawlerDetect — расширенная фильтрация ботов
Установка
- Подключите репозиторий ModStore.
- Extras → Installer → Download Extras — найдите msViewCounter, Download, Install.
- Убедитесь, что установлен MiniShop3.
- Настройки → Очистить кэш.
Термины
| Термин | Описание |
|---|---|
| total | Суммарное число просмотров товара (одна строка на товар в msviewcounter_totals) |
| online | Число активных сессий на странице товара (строки в msviewcounter_active) |
| heartbeat | Периодический POST из viewcounter.js в connector для продления active-сессии |
| TTL online | Сколько секунд (msviewcounter_online_ttl) посетитель считается «смотрящим» |
| boost | Режим: реальные данные в БД, на витрине — с базой, множителем и дневным разбросом |
| fake | Режим: стабильные числа по ID товара и fake_salt, без записи в БД и без JS |
Архитектура (кратко)
Подробнее: Интеграция, Системные настройки.