Sobre o projeto
Laravisit é um pacote Laravel gerenciado pelo Composer, projetado para adicionar rastreamento de visitas e análises de visualizações de página a qualquer modelo Eloquent por meio de uma interface limpa e fluente.
A instalação é feita via Composer com `composer require coderflexx/laravisit`, seguida pela publicação do arquivo de configuração e a execução de migrations para configurar as tabelas de banco de dados necessárias.
Para usar o pacote, um modelo deve importar e aplicar a trait `HasVisits` enquanto implementa a interface `CanVisit`. Uma vez configurado, os desenvolvedores podem registrar visitas usando o método `visit()` em uma instância do modelo, com métodos de encadeamento opcionais para anexar endereço IP, ID de sessão, arrays de dados personalizados e associações de usuários autenticados.
A agregação de visitas suporta múltiplos intervalos baseados em tempo, incluindo horários, diários, semanais, mensais, anuais e intervalos personalizados baseados em Carbon. O comportamento padrão remove a duplicidade de visitas por dia por usuário.
Para recuperar análises, o pacote fornece query scopes como `withTotalVisitCount()`, `popularAllTime()`, `popularToday()`, `popularLastDays($days)`, `popularThisWeek()`, `popularLastWeek()`, `popularThisMonth()`, `popularLastMonth()`, `popularThisYear()`, `popularLastYear()` e `popularBetween($from, $to)` para buscar resultados ranqueados em diferentes intervalos de datas.
Uma camada de presenter de visitas, alimentada pelo pacote laravel-presenter, expõe atributos decorados, como endereço IP e detalhes do usuário associado, nos registros de visita.
O pacote inclui testes PHPUnit executáveis com `composer test` e é lançado sob a licença MIT.
Comments
0 Rating appears after 10 ratings
Sign in to join the discussion.