Download the PHP package fbollon/lara-visitors without Composer

LaraVisitors

LaraVisitors is a Laravel package that provides a dashboard and statistics for visits recorded by shetabit/visitor.

✨ Features

• Dashboard with visit statistics
• Date filters
• CSV export
• Charts (Chart.js)
• Stats by user, URL, browser, device
• Localization (EN/FR)

✅ Requirements

• Laravel 11 or higher
• PHP 8.2+
• shetabit/visitor 4.5.6 or higher

📦 Installation

Install package via Composer:

This package requires shetabit/visitor and will install it automatically if it is not already present.

⚙️ Configuration

Since this package also installs the shetabit/visitor package, we start with its configuration

1. Configure shetabit/visitor

Publish the configuration file:

If needed, change the default table name in config/visitor.php:

Publish the migrations and run them:

Add the middleware to app/Http/Kernel.php to automatically log visits:

Add the trait to your User model:

2. Configure fbollon/lara-visitors

Publish the configuration file:

This will create config/laravisitors.php where you can customize:

• provide_assets: Load Bootstrap 5, Chart.js, and Font Awesome (set to false if your app already includes them).
• layout: Define the layout used by package views.
  • If you want to use the minimal layout provided by the package, you must set provide_assets to true.
• access_middleware: Middlewares applied to package routes.
• visits_table: Table name for visits (should match shetabit/visitor).
• user_model: Your User model class.
• user_display_attribute: User attribute to display in dashboard.

Optional: Publish assets (CSS/JS) if you want to customize them:

Optional: Publish the layout if you want to override the default:

Optional: Publish lang file, if you want to override :

🌍 Localization

LaraVisitors supports multiple languages (EN/FR).
To override translations:

Files will be published to lang/vendor/laravisitors/{locale}/messages.php.

🔍 Usage

Access the dashboard at:

✅ Example config/laravisitors.php

🔄 Upgrading

Upgrade to 1.1.1

Version 1.1 introduces:

• Support for shetabit/visitor 4.5.6 or higher
• Automatic loading of LaraVisitors migrations
• Improved dashboard performance through a database index on the created_at column of the visits table

Update the package:

Run database migrations:

The migration included with LaraVisitors 1.1 automatically creates an index on the created_at column used by dashboard statistics queries.

This can significantly improve dashboard performance on applications with a large number of visit records.

🛠 Contributing

Feel free to submit issues or pull requests on GitHub.

📄 License

This package is open-sourced software licensed under the MIT license.