new

Hits3

Hits3 — компонент для подсчёта просмотров страниц на MODX 3. Считает просмотры статей
Бесплатно
Загрузите дополнение из админки вашего сайта.
Как загрузить?
Автор дополнения
Maksim
Пакетов
1
Закачек
0
Автор дополнения
Пакетов
1
Закачек
0
Версия 1.0.0-beta2
Дата выпуска 16.11.2026
Загрузки 0
Внимание, этот компонент требует PHP 8.1 или выше!
Внимание, этот компонент требует MODX 3 или выше.
1. Подсчёт только на нужных страницах
Добавьте в шаблон статьи или товара:
Просмотров: [[!Hits3? &track=`1` &getCount=`1`]]


Этот вызов учитывает просмотр текущей страницы и выводит число.

При таком варианте настройку hits3.autoTrack оставьте выключенной.
2. Автоматический подсчёт на сайте
Откройте «Системные настройки», выберите пространство имён hits3 и включите:
hits3.autoTrack = Да

Очистите кэш MODX. Плагин начнёт учитывать просмотры автоматически.

Для вывода числа используйте:
Просмотров: [[!Hits3? &getCount=`1`]]


Этот вызов только показывает накопленное значение.
3. Настройки
Настройка По умолчанию Что делает
hits3.autoTrack Нет Включает автоматический подсчёт
hits3.excludeBots Да Исключает известных ботов по User-Agent
hits3.excludeManager Да Исключает посетителей с активной сессией админки
hits3.excludeResources Пусто Исключает страницы по ID через запятую

Например, чтобы не учитывать страницы 1, 15 и 28:
hits3.excludeResources = 1,15,28

Эти исключения применяются к автоматическому учёту и вызовам с track.

Проверяйте подсчёт в приватном окне браузера: посещения из браузера с активной сессией админки по умолчанию не учитываются.
4. Популярные статьи
Вывести пять самых просматриваемых страниц внутри раздела с ID 12:

Замените 12 на ID своего раздела.

Для выборки по всему дереву текущего контекста:
[[!Hits3?
&parents=`0`
&limit=`10`
&tpl=`Hits3Row`
]]

В список попадают страницы с накопленной статистикой, опубликованные, не удалённые и доступные посетителю. Сам указанный родитель в выборку не входит.
5. Собственное оформление
Создайте чанк tplPopularArticle:
[[+pagetitle]]

[[+hit_count]] просмотров


Укажите его в вызове:
[[!Hits3?
&parents=`12`
&limit=`5`
&tpl=`tplPopularArticle`
]]

Основные плейсхолдеры чанка:
Плейсхолдер Значение
[[+resource_id]] ID страницы
[[+hit_key]] Ключ счётчика — обычно ID страницы
[[+hit_count]] Число просмотров
[[+pagetitle]] Заголовок страницы при выборке через parents
[[+id]] ID записи статистики, не ID страницы

6. Получение числа просмотров
Текущая страница:
[[!Hits3? &getCount=`1`]]

Страница с ID 25:
[[!Hits3? &getCount=`1` &resource=`25`]]

Запись результата в плейсхолдер:
[[!Hits3?
&getCount=`1`
&toPlaceholder=`article.views`
]]

Просмотров: [[!+article.views]]

7. Функции, аналогичные Hits
Прибавить один просмотр странице 25:
[[!Hits3? &punch=`25`]]

Прибавить десять:
[[!Hits3? &punch=`25` &amount=`10`]]

Уменьшить на пять:
[[!Hits3? &punch=`25` &amount=`-5`]]

Обнулить:
[[!Hits3? &punch=`25` &knockout=`1` &amount=`0`]]

Установить значение 100:
[[!Hits3? &punch=`25` &knockout=`1` &amount=`100`]]

Вызовы корректировки выполняются при каждом открытии страницы. После разового изменения удалите их из шаблона. punch не применяет фильтры ботов и администратора; для обычного подсчёта используйте track или автоматический режим.
8. Сортировка и ограничение выдачи
[[!Hits3?
&parents=`12`
&sort=`hit_count`
&dir=`DESC`
&limit=`5`
&offset=`0`
&tpl=`tplPopularArticle`
]]

Параметр Назначение
parents ID разделов через запятую
depth Глубина поиска, по умолчанию 10
limit Количество результатов, по умолчанию 5; 0 — все
offset Сколько результатов пропустить
sort hit_count, hit_key или id
dir DESC — по убыванию, ASC — по возрастанию
tpl / chunk Чанк оформления
outputSeparator Разделитель результатов
toPlaceholder Плейсхолдер вместо вывода
context Контекст для выборки по разделам

Получить только список ID популярных страниц:
[[!Hits3?
&parents=`12`
&limit=`5`
&outputSeparator=`,`
]]

Особенности
— Считаются просмотры, а не уникальные посетители. Повторное открытие страницы добавляет просмотр.
— Данные хранятся в отдельной таблице; IP и идентификаторы посетителей не сохраняются.
— Фильтр известных ботов не является полной защитой от накрутки.
— Внешний кэш или CDN, отдающий страницу без запуска MODX, не вызывает счётчик.
— Старый компонент Hits и его данные не изменяются. Автоматического переноса статистики из Hits нет.
— При удалении компонента таблица статистики сохраняется.
— Версия beta2: перед использованием на основном сайте проверьте работу на тестовой копии.

Последние обсуждения в сообществе MODX.pro