Sobre el proyecto
Nuxt Plausible es un módulo ligero que integra el servicio de análisis Plausible en aplicaciones Nuxt. La instalación se realiza con un solo comando (`npx nuxt module add plausible`) y añadir `@nuxtjs/plausible` al arreglo `modules` en `nuxt.config.ts` habilita el rastreo sin necesidad de configuración adicional. Por defecto, el módulo utiliza el nombre de host actual como dominio de Plausible, pero se puede sobrescribir mediante la opción `domain`.
Las características clave incluyen:
- Rastreo automático de vistas de página, con soporte opcional para modo hash.
- Rastreo incorporado de clics en enlaces externos, descargas de archivos y envíos de formularios, configurable mediante las opciones `autoOutboundTracking`, `fileDownloads` y `formSubmissions`.
- Rastreo manual a través de componibles auto-importados `useTrackEvent` y `useTrackPageview` para objetivos personalizados y vistas de página virtuales.
- Proxy opcional (`proxy: true`) que dirige los eventos a través del servidor Nuxt (`/_plausible/api/event`), ayudando a evitar bloqueadores de anuncios mientras mantiene las cookies en tu propio origen.
- Configuración en tiempo de ejecución mediante variables de entorno públicas (por ejemplo, `NUXT_PUBLIC_PLAUSIBLE_DOMAIN`) para facilitar el despliegue en múltiples entornos.
- Implementación lista para SSR, garantizando que no haya código solo para cliente dentro de los paquetes del servidor.
La configuración se realiza en la clave `plausible` de `nuxt.config.ts` o mediante variables `.env`. Opciones comunes incluyen `enabled`, `ignoredHostnames`, `ignoreSubDomains`, `apiHost`, `autoPageviews`, `logIgnoredEvents` y ajustes de proxy como `proxyBaseEndpoint`.
El módulo respeta la privacidad enviando únicamente encabezados mínimos (user-agent, content-type, x-forwarded-for) a Plausible y permitiendo deshabilitar completamente el rastreo con `enabled: false`. Todas las funciones están documentadas en el archivo README con ejemplos de uso.
El desarrollo sigue convenciones estándar de módulos Nuxt: clonar el repositorio, activar Corepack, instalar dependencias con pnpm, ejecutar `pnpm run dev:prepare` y arrancar el servidor de desarrollo con `pnpm run dev`. El proyecto tiene licencia bajo MIT.
Comments
0 Rating appears after 10 ratings
Sign in to join the discussion.