Sobre o projeto

Laravel Plausible é um pacote que integra o Plausible Analytics em aplicações Laravel. Ele oferece uma fachada simples para interagir com a API de Estatísticas do Plausible, permitindo que desenvolvedores busquem números de visitantes em tempo real, métricas agregadas, dados de séries temporais e divisões por várias propriedades. A instalação é feita via Composer com o comando composer require njoguamos/laravel-plausible, seguido por php artisan plausible:install para publicar o arquivo de configuração. Após a instalação, os usuários devem adicionar seu site ID e chave de API do Plausible no arquivo .env, e opcionalmente definir PLAUSIBLE_BASE_URL para instâncias auto-hospedadas. O pacote oferece vários métodos: Plausible::realtime() retorna a contagem atual de visitantes; Plausible::aggregates() recupera métricas resumo com parâmetros opcionais para período, métricas, comparação, filtros, intervalo de datas e inclusão de dados importados; Plausible::timeSeries() retorna pontos de dados ao longo do tempo com intervalo configurável; Plausible::breakdown() fornece estatísticas agrupadas por uma propriedade como página, navegador ou país, com suporte para limites, paginação e filtragem. Para reduzir chamadas à API, as respostas são armazenadas em cache por três minutos por padrão, mas a duração do cache e o driver podem ser ajustados via variáveis de ambiente PLAUSIBLE_CACHE_DURATION e PLAUSIBLE_CACHE_DRIVER, ou o cache pode ser desativado completamente com PLAUSIBLE_CACHE=false. O pacote inclui uma suíte de testes executável com composer test e segue as diretrizes padrão de contribuição do Laravel.