kilobyteno/laravel-plausible

A simple package for communicating with the Plausible API within Laravel.

1.2.0 2024-05-21 11:20 UTC

Requires

• php: ^8.0|^8.1|^8.2|^8.3
• illuminate/contracts: ^8.0|^9.0|^10.0|^11.0
• spatie/laravel-package-tools: ^1.9.2

Requires (Dev)

• nunomaduro/collision: ^6.0|^7.0|^8.0
• nunomaduro/larastan: ^2.0
• orchestra/testbench: ^7.0|^8.0|^9.0
• pestphp/pest: ^1.21|^2.0
• pestphp/pest-plugin-laravel: ^1.1|^2.0
• phpstan/extension-installer: ^1.1
• phpstan/phpstan-deprecation-rules: ^1.0
• phpstan/phpstan-phpunit: ^1.0
• phpunit/phpunit: ^9.5|^10.0|^11.0
• spatie/laravel-ray: ^1.26

MIT

• Daniel S. Billing

• laravel
• plausible
• laravel-plausible
• kilobyteno

README

A simple package for communicating with the Plausible API within Laravel.

Installation

You can install the package via composer:

composer require kilobyteno/laravel-plausible

You can publish the config file with:

php artisan vendor:publish --tag="plausible-config"

This is the contents of the published config file:

return [
    'api_url' => env('PLAUSIBLE_API_URL', 'https://plausible.io/api/v1'),
    'api_key' => env('PLAUSIBLE_API_KEY', ''),
];

Usage

use Kilobyteno\LaravelPlausible\Plausible;

// Show the stats for the default period (30d), the period is optional for all methods
$visitors = Plausible::getVisitors($domain->name);

// Show the stats for the last 12 months
$pageviews = Plausible::getPageviews($domain->name, '12mo');

// Get bounce rates for the last 7 days
$bounceRate = Plausible::getBounceRate($domain->name, '7d');

// Get visit duration for the last days
$visitDuration = Plausible::getVisitDuration($domain->name, 'day');

// Get realtime visitors
$realtimeVisitors = Plausible::getRealtimeVisitors($domain->name);

// Add a custom period and metrics
$stats = Plausible::get($domain->name, 'month', ['visitors', 'pageviews']);

$availablePeriods = Plausible::getAllowedPeriods();
// returns: ['12mo', '6mo', 'month', '30d', '7d', 'day']

$allowedMetrics = Plausible::getAllowedMetrics();
// returns: ['visitors', 'pageviews', 'bounce_rate', 'visit_duration', 'visits', 'events']

$allowedProperties = Plausible::getAllowedProperties();
/* 
returns [
    'event:name',
    'event:page',
    'visit:entry_page',
    'visit:exit_page',
    'visit:source',
    'visit:referrer',
    'visit:utm_medium',
    'visit:utm_source',
    'visit:utm_campaign',
    'visit:utm_content',
    'visit:utm_term',
    'visit:device',
    'visit:browser',
    'visit:browser_version',
    'visit:os',
    'visit:os_version',
    'visit:country',
];
*/

Catching exceptions

use Kilobyteno\LaravelPlausible\Exceptions\PlausibleAPIException;

try {
    $visitors = Plausible::getVisitors($domain->name);
} catch (PlausibleAPIException $e) {
    // Handle exception
}

Testing

composer test

Changelog

Please see CHANGELOG for more information on what has changed recently.

Contributing

Please see CONTRIBUTING for details.

Security Vulnerabilities

Please review our security policy on how to report security vulnerabilities.

Credits

• Kilobyte AS
• All Contributors

License

The MIT License (MIT). Please see License File for more information.