--------------------
Stats3x - website visit statistics for MODX 3
--------------------
Author: Ivan K.
--------------------

Visitors, visits, page views, sources, devices, geography, visitor actions and goals.
Optional: session recordings with a player, click map, email reports via Vestnik.
All data is stored on your server, no external services.

QUICK START
1. Call the uncached snippet before </body> in all templates:
     [[!Stats3x]]                 (Fenom: {'Stats3x' | snippet})
     [[!Stats3x? &replay=`1`]]    also records visitor sessions (stats3x.replay_enabled)
2. Add a cron job running every minute as the site user:
     * * * * * php /path/to/core/components/stats3x/cron.php > /dev/null 2>&1
3. Optional: geography - paste the free IP2Location LITE Download Token
   into stats3x.geo_token, the databases are downloaded automatically.

EMAIL REPORTS (requires the Vestnik component)
Stats3x calculates the report and fires the Vestnik event stats3x.report once per
address from stats3x.vestnik_recipients; Vestnik builds the email from its template,
queues it and sends it by its own cron:
     * * * * * php /path/to/core/components/vestnik/cron.php > /dev/null 2>&1
Settings: stats3x.vestnik_recipients, stats3x.vestnik_period (daily/weekly/monthly),
stats3x.vestnik_enabled. Test: State tab -> "Send report now". The Vestnik template
"Stats3x: traffic report" and rule "Stats3x: email report" are created on the first
sending and can be edited in Vestnik.

Access: the permissions are in the Stats3xUserPolicy policy. On installation it is
assigned to the Administrator group in the mgr context (if not assigned to anyone yet).
For other manager groups add it in Access Control -> User Groups -> Context Access (mgr).

Full documentation (template placeholders, schedule, troubleshooting, all settings):
Extras -> Stats3x -> Documentation tab.

https://modxprofi.ru
