The Site Statistics add-on provides privacy-first, built-in analytics for your Larapen website — track page views, unique visitors, referrers, geographic locations, browsers, and platforms without third-party scripts or cookies.
Key Features
- Page view tracking — Automatically records every front-end page visit via middleware. No manual instrumentation required.
- Unique visitor tracking — Privacy-friendly unique visitor detection using SHA-256 hashed IP + User-Agent fingerprints. No cookies needed.
- Daily statistics — Aggregated daily stats for total views, unique visitors, and new visitors.
- Referrer analysis — Track where your traffic comes from (search engines, social media, direct, other websites).
- Country stats — Geographic breakdown of visitors by country using the core GeoIP library.
- Browser stats — Identify which browsers your visitors use (Chrome, Firefox, Safari, Edge, etc.).
- Platform stats — Track operating systems and device types (Windows, macOS, Linux, iOS, Android) with desktop/mobile/tablet breakdown.
- Dashboard widget — Traffic summary widget on the admin dashboard with today's views, unique visitors, weekly/monthly totals, trend indicator, and mini chart.
- Period selector — View statistics for different time ranges: last 7 days, 30 days, 90 days, or 365 days.
- Data retention — Configurable automatic purging of old page view records (default: 90 days).
- Bot and admin exclusion — Exclude known bots/crawlers and logged-in admin users from statistics.
- Privacy-focused — All data is stored on your own server. No data is sent to third parties, no cookies are set.
Admin Panel
| Section | Description |
|---|---|
| Overview | Dashboard with summary cards, traffic chart (views vs. unique visitors), top 10 pages, referrers, countries, browsers, and device type breakdown. |
| Pages | Most visited pages with view counts for the selected period. |
| Referrers | Top traffic sources and referrer URLs/domains. |
| Countries | Visitor geographic distribution by country. |
| Browsers | Browser usage breakdown. |
| Platforms | Operating system and device type distribution (desktop, mobile, tablet). |
| Settings | Configure tracking behavior, data retention period, bot/admin exclusion, GeoIP toggle, and display options. |
Configuration
- Tracking enabled — Master switch to enable/disable page view tracking.
- Data retention — Number of days to keep raw page view data before automatic purging (default: 90 days, set to 0 for indefinite).
- Exclude bots — Filter out known bots and crawlers (Googlebot, Bingbot, etc.).
- Exclude admins — Exclude logged-in admin users from being tracked.
- Unique tracking — Enable/disable privacy-friendly unique visitor tracking (hashed fingerprint, no cookies).
- GeoIP — Enable/disable geographic IP resolution for country statistics.
Dependencies
None — the Stats add-on works entirely standalone. GeoIP country detection uses the core GeoIP library already included in Larapen.
Ideal for
- Website owners who want analytics without Google Analytics or other third-party trackers.
- GDPR-conscious businesses keeping visitor data on their own servers.
- Monitoring traffic trends, popular content, and referral sources.
- Understanding your audience demographics (location, devices, browsers).