laravel-umami

Laravel Umami oferece uma maneira direta de adicionar análise Umami a uma aplicação Laravel. O pacote utiliza spatie/laravel-settings para manter todos os valores de configuração do Umami no banco de dados, facilitando a alteração das configurações sem modificar o código. Principais recursos: - Inclusão simples via Blade: adicione @include('umami::script') ao seu layout para carregar o script de rastreamento. - Configurações orientadas pelo banco de dados: ID do site, URL do host, whitelist de domínios, flag de auto-rastreamento e outras opções são armazenadas na tabela de configurações e podem ser editadas via código ou interface administrativa. - Rastreamento automático de pageviews e eventos desde o início, com opções para excluir query strings ou fragmentos hash. - Suporta tags personalizadas e restrições de domínio para análises mais precisas. Etapas de instalação: 1. Instale o pacote com Composer. 2. Certifique-se de que spatie/laravel-settings está instalado e sua migração foi executada. 3. Publique e execute a migração de configurações do Umami fornecida pelo pacote. 4. Adicione a inclusão do script ao seu layout Blade. Exemplo de configuração (PHP): ``` use JeffersonGoncalves\Umami\Settings\UmamiSettings; $settings = app(UmamiSettings::class); $settings->website_id = 'seu-id-do-site'; $settings->host_analytics = 'https://sua-instancia-umami.com'; $settings->save(); ``` As configurações disponíveis incluem: - website_id (obrigatório) - host_analytics (padrão https://cloud.umami.is) - host_url (override opcional) - auto_track (booleano, padrão true) - domains (lista separada por vírgulas) - tag (tag opcional de agrupamento) - exclude_search e exclude_hash (booleans para remover partes da URL) O pacote é compatível com PHP 8.2+ e Laravel 11+. Os testes podem ser executados via `composer test`. É licenciado sob a licença MIT. Para mais detalhes, consulte o README do repositório, o changelog e as diretrizes de contribuição.