Все системные настройки компонента и их значения по умолчанию. Меняются в Системных настройках, пространство имён stats3x. Значения в фигурных скобках ({core_path} и т.п.) подставляются автоматически.
Учёт посетителей
| Настройка | Описание | По умолчанию |
|---|---|---|
Режим учёта посетителейstats3x.tracking_mode | cookie - посетителю сохраняется cookie _st3x с его номером, вернувшиеся посетители определяются точно. cookieless - без cookie: номер посетителя вычисляется на сервере по IP и браузеру и меняется каждые сутки, поэтому вернувшихся посетителей в этом режиме не видно. | cookie |
Срок хранения cookie, днейstats3x.cookie_lifetime | Сколько дней браузер хранит cookie _st3x в режиме cookie. Посетитель, вернувшийся позже, считается новым. | 365 |
Перерыв до нового визита, минутstats3x.visit_timeout | Если посетитель ничего не делал на сайте дольше этого времени, следующий просмотр начинает новый визит. Новый визит начинается и при переходе из другого источника. | 30 |
Учитывать клики по элементамstats3x.click_selectors | CSS-селекторы через запятую, например: .btn-buy, #callback, a[href^="tel:"]. Клики по этим элементам и элементам внутри них записываются в действия посетителей. | пусто |
Не учитывать IP-адресаstats3x.exclude_ips | IPv4 и IPv6 адреса или подсети через запятую или с новой строки, например: 192.168.0.1, 10.0.0.0/8, 2001:db8::/32. Запросы с этих адресов отбрасываются при разборе данных. | пусто |
Заголовок с IP посетителяstats3x.ip_header | Заполняйте, только если сайт работает за прокси: тогда в REMOTE_ADDR приходит адрес прокси, а адрес посетителя - в заголовке. Например: CF-Connecting-IP для Cloudflare, X-Real-IP или X-Forwarded-For для nginx перед Apache. Из X-Forwarded-For берётся последний публичный адрес: его дописал ваш прокси, а начало списка может прислать сам посетитель. Поэтому за CDN укажите её заголовок с адресом посетителя, а не X-Forwarded-For. Заголовок учитывается только от доверенных прокси (stats3x.ip_proxies). Без прокси оставьте пустым: заголовок может подделать любой посетитель. | пусто |
Доверенные проксиstats3x.ip_proxies | Заголовок из stats3x.ip_header учитывается, только если запрос пришёл от прокси: иначе посетитель, зашедший на сайт напрямую, мог бы прислать заголовок сам и подменить свой IP. Пусто - доверять только внутренним адресам (nginx на том же сервере, балансировщик в локальной сети). Для CDN укажите её адреса и подсети через запятую или с новой строки (например, подсети Cloudflare), * - доверять любому адресу. | пусто |
Скрытые параметры адресаstats3x.hidden_params | Из адреса страницы, адреса перехода и ссылок всегда убираются часть после # и параметры с секретами и личными данными: всё, где в имени есть token, secret, passw, session, signature, apikey, и auth, code, key, hash, sig, sid, ticket, otp, pin, email, mail, phone, tel. Здесь можно добавить свои имена через запятую, например order_id, promo. | пусто |
Показывать IP-адреса посетителейstats3x.show_ip | IP-адрес в списке визитов, записях действий, на вкладке «Сейчас на сайте» и в карточке посетителя. Нет - IP в менеджере не показывается (в базе он хранится по-прежнему: нужен для исключений и географии). | 1 |
Хранение данных
| Настройка | Описание | По умолчанию |
|---|---|---|
Папка данныхstats3x.data_path | Временные файлы с входящими данными (buffer/) и записи действий (replays/). Базы IP2Location сюда не входят - их путь в настройках stats3x.geo_ipv4_path и stats3x.geo_ipv6_path. Плейсхолдеры: {core_path}, {base_path}, {assets_path}. По умолчанию {core_path}components/stats3x/data/ - внутри папки компонента: обновление пакета её не трогает, удаление пакета удаляет вместе с записями действий. Чтобы данные пережили удаление пакета, укажите папку вне компонента, лучше за пределами корня сайта, например на HestiaCP: /home/пользователь/web/домен/private/stats3x/. Такая папка при удалении пакета остаётся, если не включена stats3x.remove_tables_on_uninstall. | {core_path}components/stats3x/data/ |
Хранить подробные данные, днейstats3x.keep_details_days | Визиты, просмотры и действия старше этого срока удаляются раз в сутки. Итоги по дням хранятся всегда. 0 - не удалять. | 90 |
География
| Настройка | Описание | По умолчанию |
|---|---|---|
База IP2Location для IPv4stats3x.geo_ipv4_path | Файл базы IP2Location LITE в формате BIN или папка с ним. Если указана папка, берётся файл IP2LOCATION-LITE-DB*.BIN. DB1 - страна, DB3 - страна, регион и город, DB5 и DB11 - ещё координаты и часовой пояс. По умолчанию {core_path}components/stats3x/geo_ip/ - внутри папки компонента, удаляется вместе с пакетом. Папка может быть где угодно на сервере (одна на несколько сайтов, если позволяет open_basedir), но не в открытой из интернета части сайта. Плейсхолдеры: {data_path}, {core_path}, {base_path}. | {core_path}components/stats3x/geo_ip/ |
База IP2Location для IPv6stats3x.geo_ipv6_path | Файл базы IP2Location LITE для IPv6 (IP2LOCATION-LITE-DB*.IPV6.BIN) или папка с ним, может совпадать с папкой для IPv4. По умолчанию {core_path}components/stats3x/geo_ip/. Плейсхолдеры: {data_path}, {core_path}, {base_path}. | {core_path}components/stats3x/geo_ip/ |
Токен для скачивания баз IP2Locationstats3x.geo_token | Download Token для бесплатных баз IP2Location LITE. Регистрация: https://www.ip2location.com/register?id=lite, токен - в личном кабинете https://www.ip2location.com/account, раздел Download. Если задан, задача cron «Обновление баз IP2Location» сама скачивает базы из stats3x.geo_download в папку из stats3x.geo_ipv4_path (базы IPv6 - из stats3x.geo_ipv6_path) и раз в месяц обновляет их. Пусто - базы кладутся вручную. | пусто |
Какие базы IP2Location скачиватьstats3x.geo_download | Коды баз IP2Location LITE через запятую. DB11LITEBINIPV6 - страна, регион, город, координаты и часовой пояс для IPv4 и IPv6 одним файлом. Только IPv4: DB1LITEBIN (страна), DB3LITEBIN (+ регион и город), DB5LITEBIN (+ координаты), DB11LITEBIN (+ часовой пояс); с окончанием IPV6 - те же базы для IPv4 и IPv6. | DB11LITEBINIPV6 |
Cron
| Настройка | Описание | По умолчанию |
|---|---|---|
Предупреждать, если cron не запускался, минутstats3x.cron_alert_minutes | Если cron.php не запускался дольше этого времени, в компоненте появляется предупреждение, а в журнал ошибок MODX пишется запись. | 10 |
Отчёты на почту (Вестник)
| Настройка | Описание | По умолчанию |
|---|---|---|
Отправлять отчёты на почтуstats3x.vestnik_enabled | Работает, только если установлен компонент Вестник: Stats3x передаёт ему данные отчёта, письмо собирает и отправляет Вестник. Без Вестника настройка ни на что не влияет. | 0 |
Как часто отправлятьstats3x.vestnik_period | daily - каждый день за вчера, weekly - по понедельникам за прошлую неделю, monthly - 1-го числа за прошлый месяц. Отчёт уходит в первый запуск cron после 7:00. | weekly |
Получатели отчётаstats3x.vestnik_recipients | Адреса через запятую или с новой строки. Вестник получает событие stats3x.report для каждого адреса. | пусто |
Запись действий посетителей
| Настройка | Описание | По умолчанию |
|---|---|---|
Записывать действия посетителейstats3x.replay_enabled | Пишутся только страницы, где сниппет вызван с параметром &replay=1. Запись не замедляет страницу: скрипт записи (rec.js) грузится только для визитов из выборки, части записи уходят на сервер сжатыми. | 0 |
Доля записываемых визитов, %stats3x.replay_sample | Например, 10 - записывается каждый десятый визит. 100 - все визиты. | 10 |
Скрывать ввод в поляхstats3x.replay_mask_inputs | Текст, который посетитель вводит в поля форм, в записи заменяется звёздочками. Пароли скрываются всегда. Отдельные блоки скрываются классами st3x-block (не записывать блок) и st3x-mask (скрыть текст). | 1 |
Минимальная длительность записи, секундstats3x.replay_min_duration | Записи короче не сохраняются. | 10 |
Хранить записи, днейstats3x.replay_keep_days | Записи старше удаляются вместе с файлами. 0 - не удалять. | 30 |
Домены картинок и стилей в записяхstats3x.replay_hosts | Запись может подделать кто угодно, поэтому проигрыватель загружает картинки, стили и шрифты из записи только с домена сайта и доменов контекстов (с поддоменами), кроме менеджера и коннекторов. Если они лежат на CDN, укажите его домены через запятую, например cdn.example.com. Остальное в записи показывается без картинок, вместо фреймов - пустое место. | пусто |
Системные
| Настройка | Описание | По умолчанию |
|---|---|---|
Удалять таблицы при удалении пакетаstats3x.remove_tables_on_uninstall | Если включено, при удалении пакета из менеджера таблицы компонента будут удалены вместе со всеми данными, системными настройками компонента и файлами в папке данных (buffer/, replays/). По умолчанию выключено: таблицы и настройки переживают переустановку. Папка данных по умолчанию лежит внутри компонента и удаляется с пакетом всегда, вынесенная настройкой stats3x.data_path - только при включённой опции. | 0 |