laravel-umami

Laravel Umami proporciona una forma sencilla de agregar análisis de Umami a una aplicación Laravel. El paquete depende de spatie/laravel-settings para mantener todos los valores de configuración de Umami en la base de datos, facilitando el cambio de ajustes sin tocar el código. Características principales: - Inclusión simple en Blade: agrega @include('umami::script') a tu diseño para cargar el script de seguimiento. - Configuración basada en base de datos: el ID del sitio, URL del host, lista blanca de dominios, indicador de auto-seguimiento y otras opciones se almacenan en la tabla de settings y pueden editarse mediante código o una interfaz de administración. - Rastreo automático de páginas vistas y eventos de serie, con opciones para excluir cadenas de consulta o fragmentos hash. - Soporte para etiquetas personalizadas y restricciones de dominio para un análisis más preciso. Pasos de instalación: 1. Requiere el paquete con Composer. 2. Asegúrate de que spatie/laravel-settings esté instalado y su migración haya sido ejecutada. 3. Publica y ejecuta la migración de configuración de Umami proporcionada por el paquete. 4. Agrega la inclusión del script a tu diseño Blade. Ejemplo de configuración (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(); ``` Las configuraciones disponibles incluyen: - website_id (requerido) - host_analytics (default https://cloud.umami.is) - host_url (sobrescritura opcional) - auto_track (booleano, default true) - domains (lista separada por comas) - tag (etiqueta de agrupación opcional) - exclude_search y exclude_hash (booleanos para eliminar partes de la URL) El paquete es compatible con PHP 8.2+ y Laravel 11+. Las pruebas se pueden ejecutar con `composer test`. Está liberado bajo la licencia MIT. Para más detalles, consulta el README del repositorio, el historial de cambios y las directrices de contribución.