Sobre o projeto
O Nuxt Plausible é um módulo leve que integra o serviço de análise Plausible em aplicações Nuxt. A instalação é feita com um único comando (`npx nuxt module add plausible`) e adicionar `@nuxtjs/plausible` ao array `modules` no `nuxt.config.ts` habilita o rastreamento sem configuração adicional. Por padrão, o módulo usa o hostname atual como domínio do Plausible, mas a opção `domain` pode substituí-lo.
Recursos principais incluem:
- Rastreamento automático de visualizações de página, com suporte opcional ao modo hash.
- Rastreamento embutido de cliques em links externos, downloads de arquivos e envios de formulários, configurável através das opções `autoOutboundTracking`, `fileDownloads` e `formSubmissions`.
- Rastreamento manual por meio de composables auto-importados `useTrackEvent` e `useTrackPageview` para metas personalizadas e visualizações virtuais de páginas.
- Proxy opcional (`proxy: true`) que encaminha eventos pelo servidor Nuxt (`/_plausible/api/event`), ajudando a contornar bloqueadores de anúncios mantendo os cookies na sua própria origem.
- Configuração em tempo de execução via variáveis de ambiente públicas (ex.: `NUXT_PUBLIC_PLAUSIBLE_DOMAIN`) para implantação fácil em diferentes ambientes.
- Implementação pronta para SSR, garantindo que nenhum código somente-cliente se filtre nos pacotes do servidor.
A configuração é feita na chave `plausible` do `nuxt.config.ts` ou por meio de variáveis `.env`. Opções comuns incluem `enabled`, `ignoredHostnames`, `ignoreSubDomains`, `apiHost`, `autoPageviews`, `logIgnoredEvents` e configurações de proxy como `proxyBaseEndpoint`.
O módulo respeita a privacidade ao enviar apenas cabeçalhos mínimos (user-agent, content-type, x-forwarded-for) ao Plausible e ao permitir desativar completamente o rastreamento com `enabled: false`. Todos os recursos estão documentados no README com exemplos de uso.
O desenvolvimento segue convenções padrão de módulos Nuxt: clonar o repositório, ativar o Corepack, instalar dependências com pnpm, executar `pnpm run dev:prepare` e iniciar o servidor de desenvolvimento com `pnpm run dev`. O projeto está licenciado sob a licença MIT.
Comments
0 Rating appears after 10 ratings
Sign in to join the discussion.