About this project

SimpleStats is a lightweight visitor analytics plugin for Kirby CMS websites. It provides self-hosted, non-intrusive tracking of page views, referrer URLs, and device information. Key features include categorization of referrers into search, social, or website sources; device data covering device type, browser engine, and OS family (all version-less); and page visit counting at one hit per unique user per language every 24 hours. Data collection is fully anonymized and processed across configurable timeframes (daily, weekly, monthly, or custom). All analytics data is stored in a single SQLite database for easy backup and portability. The `Stats` class exposes data for use in frontend templates, while the Kirby Panel displays interactive charts via Chart.js and dedicated page sections show page-specific metrics. Dependencies include Chart.js for rendering charts, WhichBrowser parser for accurate PHP user-agent parsing, and a dedicated referer parser package. Installation, configuration, and integration instructions are documented in SETUP.md. License: MIT.