À propos du projet

Laravel Umami offre un moyen simple d'ajouter l'analytics Umami à une application Laravel. Le package s'appuie sur spatie/laravel-settings pour conserver toutes les valeurs de configuration Umami dans la base de données, ce qui facilite la modification des paramètres sans toucher au code. Fonctionnalités principales : - Inclusion Blade simple : ajoutez @include('umami::script') à votre mise en page pour charger le script de suivi. - Paramètres pilotés par la base de données : l'ID du site, l'URL hôte, la liste blanche de domaines, le drapeau auto-track et d'autres options sont stockés dans la table settings et peuvent être modifiés via le code ou une interface administrateur. - Suivi automatique des pages vues et des événements prêt à l'emploi, avec des options pour exclure les chaînes de requête ou les fragments hash. - Prise en charge des balises personnalisées et des restrictions de domaine pour des analyses plus précises. Étapes d'installation : 1. Installez le package avec Composer. 2. Assurez-vous que spatie/laravel-settings est installé et que sa migration a été exécutée. 3. Publiez et exécutez la migration des paramètres Umami fournie par le package. 4. Ajoutez l'inclusion du script à votre mise en page Blade. Exemple de configuration (PHP) : ``` use JeffersonGoncalves\Umami\Settings\UmamiSettings; $settings = app(UmamiSettings::class); $settings->website_id = 'your-website-id'; $settings->host_analytics = 'https://your-umami-instance.com'; $settings->save(); ``` Paramètres disponibles : - website_id (obligatoire) - host_analytics (par défaut https://cloud.umami.is) - host_url (surcharge optionnelle) - auto_track (booléen, par défaut true) - domains (liste séparée par des virgules) - tag (balise de regroupement optionnelle) - exclude_search et exclude_hash (booléens pour supprimer des parties de l'URL) Le package est compatible avec PHP 8.2+ et Laravel 11+. Les tests peuvent être exécutés via `composer test`. Il est publié sous licence MIT. Pour plus de détails, consultez le README du repository, le changelog et les directives de contribution.