Track your authenticated and unauthenticated visitors, login attempts, ajax requests, and more. Includes a controller and a bunch of routes and views to display the statistics, as well as a helper class to fetch the statistics easily (in case you want to display the statistics yourself).
- Install the package using composer:
composer require voerro/laravel-visitor-tracker- Run the migration to install the package's table to record visits to by executing:
php artisan migrate- Add the middleware to
app/Http/Kernel.php:
protected $middlewareGroups = [
...
'web' => [
...
\Voerro\Laravel\VisitorTracker\Middleware\RecordVisits::class,
],
...
];- Laravel 5.5 has package auto-discovery. If you have an older version, register the service provider in
config/app.php:
...
'providers' => [
...
Voerro\Laravel\VisitorTracker\VisitorTrackerServiceProvider::class,
...
],
...If you want to fetch and display the visitor statistics yourself register the facade in the same file:
...
'aliases' => [
...
'VisitStats' => Voerro\Laravel\VisitorTracker\Facades\VisitStats::class,
...
],
...- Publish the config file, assets, and views by running:
php artisan vendor:publishChoose Voerro\Laravel\VisitorTracker\VisitorTrackerServiceProvider in the provided list.
The tracker uses external API to fetch the geolocation data. To turn geoapi off set the geoip_on setting in the config file to false. To change a provider change the geoip_driver field. The supported drivers are listed in the configuration file. You might need to fill out additional API keys depending on the driver you choose.
Since fetching data from an external API takes time, the operation is queued an performed asynchronously. This is done using Laravel Jobs and probably won't work on a shared hosting. There are multiple drivers supported. We'll describe how to set up the database driver.
First, in your .env file you need to set:
QUEUE_DRIVER=databaseThen run these commands one after another:
php artisan queue:table
php artisan queue:failed-table
php artisan migrateFinally, you need to start the worker that will take care of the queue. Run the following command and keep it running:
php artisan queue:workRead more on Queues and Jobs in the Laravel documentation. This section describes how to restart the queue worker automatically in case the process fails.
P.S. You need to restart the worker every time you've made changes to the package's config file.
Check out the config/visitortracker.php file. It is well commented and additional explanations are not required. You can exclude certain user groups, individual users, and certain requests from being tracked there among other things.
The external API calls to retrieve geolocation information are disabled in the testing environment. Otherwise your tests would run really slow, since the tracker tracks all the requests.
The package comes with a controller and a bunch of routes and views to display statistics. You can fetch and display the stats yourself using the VisitStats class, but we'll talk about it later. The provided views are uncomplicated and styled with the standard Bootstrap classes.
To install the in-built routes add this line to your routes.php file:
VisitStats::routes();You can put this line inside a group to restrict the access with middlewares and/or to add a prefix to the routes. For example, like this:
Route::middleware('auth')->prefix('admin')->group(function () {
VisitStats::routes();
});You can integrate the views into your existing layouts. Take a look at the Views section of the config file. All the routes are named so you could easily add and style links to all the pages. Below is the complete list of routes.
| Route name | Description |
|---|---|
| visitortracker.summary | A small summary page |
| visitortracker.all_requests | A list of all the requests |
| visitortracker.visits | A list of page visits (same as all request minus ajax calls, bot visits, and login attempts) |
| visitortracker.ajax_requests | A list of AJAX requests |
| visitortracker.bots | A list of visits from bots/crawlers |
| visitortracker.login_attempts | A list of login attempts (check the "Tracking login attempts" section of the config file) |
| visitortracker.countries | A list of countries with the number of visits and unique visitors in each ordered by the date of last visit |
| visitortracker.os | A list of operating systems with the number of visits and unique visitors from each ordered by the date of last visit |
| visitortracker.browsers | A list of browsers with the number of visits and unique visitors from each ordered by the date of last visit |
| visitortracker.languages | A list of browser languages with the number of visits and unique visitors in each ordered by the date of last visit |
| visitortracker.unique | A list of unique visitors (unique IPs) ordered by the date of last visit |
| visitortracker.users | A list of registered users with the total number of visits ordered by the date of last visit |
| visitortracker.urls | A list of URLs with the total number of visits and unique visitors ordered by the date of last visit |
This is the data that is being collected by the tracker.
| Database field | Description |
|---|---|
| user_id | An id of an authenticated user performing the request |
| ip | e.g. '127.0.0.1' |
| method | e.g. 'GET' |
| is_ajax | Whether the request is an AJAX request |
| url | e.g. 'http://voerro.com' |
| referer | e.g. 'http://google.com' |
| user_agent | e.g. 'Mozilla/5.0 (X11; Ubuntu; Linux x86_64; rv:58.0) Gecko/20100101 Firefox/58.0' |
| is_desktop | Whether the request is made from a desktop |
| is_mobile | Whether the request is made from a mobile device |
| is_bot | Whether the visitor is a bot/crawler |
| bot | e.g. 'Googlebot' |
| os_family | e.g. 'linux' |
| os | e.g. 'Ubuntu' |
| browser_family | e.g. 'firefox' |
| browser | e.g. 'Firefox 58.0' |
| is_login_attempt | Whether the request is a login attempt |
| country | e.g. 'Russia' |
| country_code | e.g. 'RU' |
| city | e.g. 'Moscow' |
| lat | Latitude |
| long | Longitude |
| browser_language_family | e.g. 'en' |
| browser_language | e.g. 'en-US' |
| created_at | A standard Laravel field which is also used as a visit/request datetime |
The package uses piwik/device-detector to parse the user agent.
In case you are not content with the provided views, you can use the Voerro\Laravel\VisitorTracker\Facades\VisitStats class to fetch the statistics data and then make your own controller and views to display this data.
Take a look at the controller located at src/Controllers/StatisticsController.php to understand how to work with the class, it's pretty simple. The original class is located at src/VisitStats.php and all the methods inside are documented, in case you need more insights.
This is open-sourced software licensed under the MIT license.