README

Laravel Cloudflare Web Analytics

Add Cloudflare Web Analytics — privacy-first, cookie-free analytics from Cloudflare — to your Laravel app. The settings are stored in the database with spatie/laravel-settings, so you can change them at runtime (e.g. from an admin panel) instead of in .env.

For a Filament settings page, use jeffersongoncalves/filament-cloudflare-web-analytics.

Installation

composer require jeffersongoncalves/laravel-cloudflare-web-analytics

Publish and run the settings migration:

php artisan vendor:publish --tag=cloudflare-web-analytics-settings-migrations
php artisan migrate

Configuration

$settings = cloudflare_web_analytics_settings();
$settings->token = '0123456789abcdef0123456789abcdef';
$settings->save();

Or through the settings class or the Facade:

use JeffersonGoncalves\CloudflareWebAnalytics\Facades\CloudflareWebAnalytics;
use JeffersonGoncalves\CloudflareWebAnalytics\Settings\CloudflareWebAnalyticsSettings;

$settings = app(CloudflareWebAnalyticsSettings::class);
$value = CloudflareWebAnalytics::getFacadeRoot()->token;

Available settings

Setting	Type	Default	Description
`token`	`?string`	`null`	Your Cloudflare Web Analytics token. The script only renders when it is valid.

Usage

Add the script to your Blade layout, inside <head>:

@include('cloudflare-web-analytics::script')

Nothing is rendered until the settings are complete, so you can ship the include everywhere and turn Cloudflare Web Analytics on later.

Content Security Policy

When your app sets a CSP nonce through Laravel's Vite (Vite::useCspNonce(), as laravel-security-headers does), every <script> this package renders carries it, so a script-src 'self' 'nonce-{nonce}' policy works without 'unsafe-inline'. Scripts loaded afterwards from the vendor's own CDN still need that host in script-src (and its API in connect-src).

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

License

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

jeffersongoncalves / laravel-cloudflare-web-analytics

Package info

Security

Fund package maintenance!

Statistics