laravel-plausible

Laravel Plausible es un paquete que integra Plausible Analytics en aplicaciones Laravel. Proporciona una facade simple para interactuar con la API de estadísticas de Plausible, permitiendo a los desarrolladores obtener conteos de visitantes en tiempo real, métricas agregadas, datos de series temporales y desgloses por diversas propiedades. La instalación se realiza mediante Composer con el comando composer require njoguamos/laravel-plausible, seguido de php artisan plausible:install para publicar el archivo de configuración. Tras la instalación, los usuarios deben agregar su site ID y API key de Plausible al archivo .env, y opcionalmente configurar PLAUSIBLE_BASE_URL para instancias autoalojadas. El paquete ofrece varios métodos: Plausible::realtime() devuelve el conteo actual de visitantes; Plausible::aggregates() recupera métricas resumidas con parámetros opcionales como período, métricas, comparación, filtros, rango de fechas e inclusión de datos importados; Plausible::timeSeries() retorna puntos de datos en el tiempo con intervalo configurable; Plausible::breakdown() proporciona estadísticas agrupadas por una propiedad como página, navegador o país, con soporte para límites, paginación y filtrado. Para reducir las llamadas a la API, las respuestas se almacenan en caché durante tres minutos por defecto, pero la duración y el driver de caché pueden ajustarse mediante las variables de entorno PLAUSIBLE_CACHE_DURATION y PLAUSIBLE_CACHE_DRIVER, o desactivarse por completo con PLAUSIBLE_CACHE=false. El paquete incluye una suite de pruebas ejecutable con composer test y sigue las directrices estándar de contribución de Laravel.