Findle

GDPR-friendly page view tracking and analytics package for Laravel applications with comprehensive bot detection and a beautiful statistics dashboard.

Features

• GDPR Friendly - Uses hashed visitor identifiers instead of storing personal data
• Bot Detection - Advanced bot detection to filter out non-human traffic
• Statistics Dashboard - Beautiful overview and detailed analytics pages
• Performance Optimized - Efficient tracking with rate limiting
• Security Focused - Configurable authorization and excluded routes
• Responsive UI - Mobile-friendly statistics interface
• Data retention settings with automatic cleanup
• Comprehensive bot filtering for accurate analytics

Installation

You can install the package via composer:

composer require dennenboom/findle

Publish Configuration

After installing, publish the configuration file:

php artisan vendor:publish --tag=findle-config

Run Migration

Run the database migration to create the required tables:

php artisan migrate

Configuration

Environment Variables

Optionally add these variables to your .env file:

FINDLE_ENABLED=true
FINDLE_ROUTE=/admin/statistics
FINDLE_BOT_DETECTION=true
FINDLE_RATE_LIMIT=30
FINDLE_DATA_RETENTION_DAYS=365

Usage

Automatic Tracking

Once installed, Findle automatically tracks page views for all GET requests that aren't excluded. The middleware is automatically registered with the web middleware group.

Accessing Statistics

By default, statistics are available at /admin/statistics. The statistics page includes:

• Total pages tracked
• Unique visitors count
• Total visits
• Daily, weekly, and monthly visit counts
• Sortable and searchable page list
• Detailed page analytics with charts