Plausible is intuitive, lightweight and open source web analytics. Plausible has no cookies and fully compliant with GDPR, CCPA and PECR.
You can install the package via composer:
composer require njoguamos/laravel-plausibleYou can initialise the package with:
php artisan plausible:installInstall command will publish the config file.
Ensure that you have updated your application .env with credentials from Plausible i.e.
#.env file
PLAUSIBLE_SITE_ID=
PLAUSIBLE_API_KEY=
#PLAUSIBLE_BASE_URL= <-- (Optional) for self-hostedNote If you are using a self-hosted version of plausible, ensure that you define
PLAUSIBLE_BASE_URLto point to your custom domain.
To get the current visitors on your default site, run a request as follows.
use NjoguAmos\Plausible\Facades\Plausible;
$visitors = Plausible::realtime();The response in a single digit number
12If you prefer using facades, then you can do as follows.
use NjoguAmos\Plausible\Facades\Plausible;
$all = Plausible::aggregates();To get the aggregates, run a request as follows.
use NjoguAmos\Plausible\Facades\Plausible;
// Simple with default
$aggregates = Plausible::aggregates();
// Or with optional custom parameters
$aggregates = Plausible::aggregates(
period: 'custom',
metrics: ['visitors', 'visits', 'pageviews'],
filters: ['event:page==/blog**', 'visit:country==KE'],
date: '2023-01-01,2023-01-31'
);A successful response will be a json. Example;
{
"bounce_rate": {
"change": 4,
"value": 71
},
"events": {
"change": -24,
"value": 1166
},
"pageviews": {
"change": -24,
"value": 1166
},
"views_per_visit": {
"change": -26,
"value": 3
},
"visit_duration": {
"change": -37,
"value": 132
},
"visitors": {
"change": 1,
"value": 360
},
"visits": {
"change": 3,
"value": 389
}
}Period - string, optional
use NjoguAmos\Plausible\Facades\Plausible;
$aggregates = Plausible::aggregates(period: '7d')The period MUST be either of the allowed ones i.e 12mo,6mo,month,0d,7d,day, or custom. If not provided, period will default to 30d;
Metrics - array, optional
use NjoguAmos\Plausible\Facades\Plausible;
$aggregates = Plausible::aggregates(metrics: ['visitors', 'visits'])The metrics must contain either of the allowed ones i.e visitors,visits,pageviews,views_per_visit,bounce_rate,visit_duration, or events. If not provided, all metrics will be included.
Compare - boolean, optional
use NjoguAmos\Plausible\Facades\Plausible;
$aggregates = Plausible::aggregates(compare: false )compare defaults to true, meaning that the percent difference with the previous period for each metric will be calculated.
Filters - array, optional
use NjoguAmos\Plausible\Facades\Plausible;
$aggregates = Plausible::aggregates(filters: ['event:page==/blog**', 'visit:country==KE|DE'])Your filters must be properly formed as per plausible instructions. Filters defaults to null.
Date - string, optional
use NjoguAmos\Plausible\Facades\Plausible;
$aggregates = Plausible::aggregates(period: 'custom', date: '2023-01-01,2023-01-31')Date in Y-m-d format. Individual date e.g 2023-01-04 or a range 2023-01-01,2023-01-31. When not provided, date defaults to current date.
Info You must include
period: 'custom'when you provide a date range.
To get the timeseries data over a certain time period, run a request as follows.
use NjoguAmos\Plausible\Facades\Plausible;
// Simple with default
$aggregates = Plausible::timeSeries();
// Or with optional custom parameters
$aggregates = Plausible::timeSeries(
period: 'custom',
metrics: ['visitors', 'visits', 'pageviews', 'views_per_visit', 'bounce_rate', 'visit_duration'],
filters: ['event:page==/blog**'],
interval: 'month',
date: '2023-01-01,2023-01-31'
);A successful response will be a json. Example;
[
{
"bounce_rate": 17,
"date": "2023-01-01",
"pageviews": 60,
"views_per_visit": 19,
"visit_duration": 525,
"visitors": 6,
"visits": 6
},
{
"bounce_rate": 12,
"date": "2023-01-02",
"pageviews": 22,
"views_per_visit": 4,
"visit_duration": 149,
"visitors": 6,
"visits": 8
},
{
"bounce_rate": 57,
"date": "2023-01-03",
"pageviews": 9,
"views_per_visit": 2.57,
"visit_duration": 48,
"visitors": 7,
"visits": 7
},
{
"bounce_rate": 71,
"date": "2023-01-04",
"pageviews": 48,
"views_per_visit": 8.43,
"visit_duration": 301,
"visitors": 7,
"visits": 7
}
]Period - string, optional
use NjoguAmos\Plausible\Facades\Plausible;
$aggregates = Plausible::timeSeries(period: '6mo')The period MUST be either of the allowed ones i.e 12mo,6mo,month,0d,7d,day, or custom. If not provided, period will default to 30d;
Metrics - array, optional
use NjoguAmos\Plausible\Facades\Plausible;
$aggregates = Plausible::timeSeries(metrics: ['visits', 'pageviews', 'views_per_visit'])The metrics must contain either of the allowed ones i.e visitors,visits,pageviews,views_per_visit,bounce_rate,visit_duration, or events. If not provided, all metrics will be included.
Filters - array, optional
use NjoguAmos\Plausible\Facades\Plausible;
$aggregates = Plausible::timeSeries(filters: ['event:page==/blog**', 'visit:browser==Firefox'])Your filters must be properly formed as per plausible instructions. Filters defaults to null.
Interval - string, optional
use NjoguAmos\Plausible\Facades\Plausible;
$aggregates = Plausible::timeSeries(interval: 'month')Interval can only be either month or date. When not provided, it defaults to date.
Date - string, optional
use NjoguAmos\Plausible\Facades\Plausible;
$aggregates = Plausible::timeSeries(period: 'custom', date: '2023-01-01,2023-01-31')Date in Y-m-d format. Individual date e.g 2023-01-04 or a range 2023-01-01,2023-01-31. When not provided, date defaults to current date.
Info You must include
period: 'custom'when you provide a date range.
To get a breakdown of your stats by some property, run a request as follows.
use \NjoguAmos\Plausible\Facades\Plausible;
// Simple with defaults
$visitors = Plausible::breakdown();
// With optional parameters
$aggregates = Plausible::breakdown(
property: 'event:page',
period: '12mo',
metrics: ['visitors', 'visits', 'pageviews'],
filters: 'event:page==/blog**',
limit: 500
);The response in a single digit number
[
{
"bounce_rate": 71,
"page": "/",
"pageviews": 146,
"visit_duration": 126,
"visitors": 87,
"visits": 77
},
{
"bounce_rate": 54,
"page": "/articles",
"pageviews": 179,
"visit_duration": 206,
"visitors": 71,
"visits": 50
},
{
"bounce_rate": 81,
"page": "/blog/about-laravel-plausible",
"pageviews": 42,
"visit_duration": 27,
"visitors": 35,
"visits": 37
},
{
"bounce_rate": 52,
"page": "/pricing",
"pageviews": 72,
"visit_duration": 147,
"visitors": 31,
"visits": 27
},
{
"bounce_rate": 76,
"page": "/aquatadas",
"pageviews": 22,
"visit_duration": 82,
"visitors": 21,
"visits": 21
}
]Property - string, optional
use NjoguAmos\Plausible\Facades\Plausible;
$aggregates = Plausible::breakdown(property: '6mo')The property MUST be either of the allowed ones i.e. visitors, visits, pageviews, bounce_rate, or visit_duration. If not provided, period will default to all allowed;
Period - string, optional
use NjoguAmos\Plausible\Facades\Plausible;
$aggregates = Plausible::breakdown(period: '6mo')The period MUST be either of the allowed ones i.e 12mo,6mo,month,0d,7d,day, or custom. If not provided, period will default to 30d;
Date - string, optional
use NjoguAmos\Plausible\Facades\Plausible;
$aggregates = Plausible::breakdown(date: '2023-01-01')Date in Y-m-d format.
Info
period: 'custom'is not supported. `date: '2023-01-01,2023-02-02' is not supported.
Metrics - array, optional
use NjoguAmos\Plausible\Facades\Plausible;
$aggregates = Plausible::breakdown(metrics: ['visits', 'pageviews', 'views_per_visit'])The metrics must contain either of the allowed ones i.e visitors,visits,pageviews,views_per_visit,bounce_rate,visit_duration, or events. If not provided, all metrics will be included.
Limit - int, optional
use NjoguAmos\Plausible\Facades\Plausible;;
$aggregates = Plausible::breakdown(limit: 200)The results limit. It must be between 1 and 1000. When not provided, limit defaults to 100.
Page - int, optional
use NjoguAmos\Plausible\Facades\Plausible;;
$aggregates = Plausible::breakdown(page: 2)Page for the results. When not provided, page defaults to 1.
Filters - string, optional
use NjoguAmos\Plausible\Facades\Plausible;
$aggregates = Plausible::breakdown(filters: 'event:page==/blog**')Your filters must be properly formed as per plausible instructions. Filters defaults to null.
Info Multiple filters are not supported.
To increased performance of your application and reduce reliance to plausible api, all requests are cached for 3 minutes. You can specify cache duration (in seconds) and driver using the following env variables.
PLAUSIBLE_CACHE_DURATION=300
PLAUSIBLE_CACHE_DRIVER=redisIf for some reason you don't want to cache response, you can turn off caching entirely by adding the following env variable.
PLAUSIBLE_CACHE=falseInfo To test this package, run the following command.
composer testPlease see releases for more information on what has changed recently.
Please see CONTRIBUTING for details.
Please review our security policy on how to report security vulnerabilities.
The MIT License (MIT). Please see License File for more information.