À propos du projet
Nuxt Plausible est un module léger qui intègre le service d'analyse Plausible dans les applications Nuxt. L'installation s'effectue avec une seule commande (`npx nuxt module add plausible`) et l'ajout de `@nuxtjs/plausible` au tableau `modules` dans `nuxt.config.ts` active le suivi sans autre configuration. Par défaut, le module utilise le nom d'hôte actuel comme domaine Plausible, mais l'option `domain` permet de le remplacer.
Les fonctionnalités clés comprennent :
- Suivi automatique des vues de page, avec prise en charge optionnelle du mode hash.
- Suivi intégré des clics sur les liens sortants, des téléchargements de fichiers et des soumissions de formulaires, configurable via les options `autoOutboundTracking`, `fileDownloads` et `formSubmissions`.
- Suivi manuel via les composables auto-importés `useTrackEvent` et `useTrackPageview` pour les objectifs personnalisés et les vues de page virtuelles.
- Proxy optionnel (`proxy: true`) qui achemine les événements via le serveur Nuxt (`/_plausible/api/event`), aidant à contourner les bloqueurs de publicité tout en conservant les cookies sur votre propre origine.
- Configuration au moment de l'exécution via des variables d'environnement publiques (par ex. `NUXT_PUBLIC_PLAUSIBLE_DOMAIN`) pour un déploiement facile selon les environnements.
- Implémentation prête pour le SSR, garantissant qu'aucun code réservé au client ne fuite dans les bundles serveur.
La configuration s'effectue soit dans la clé `plausible` de `nuxt.config.ts`, soit via des variables `.env`. Les options courantes incluent `enabled`, `ignoredHostnames`, `ignoreSubDomains`, `apiHost`, `autoPageviews`, `logIgnoredEvents` et des paramètres de proxy tels que `proxyBaseEndpoint`.
Le module respecte la vie privée en n'envoyant que des en-têtes minimaux (user-agent, content-type, x-forwarded-for) à Plausible et en vous permettant de désactiver complètement le suivi avec `enabled: false`. Toutes les fonctionnalités sont documentées dans le README avec des exemples d'utilisation.
Le développement suit les conventions standard des modules Nuxt : cloner le dépôt, activer Corepack, installer les dépendances avec pnpm, exécuter `pnpm run dev:prepare` et démarrer le serveur de développement avec `pnpm run dev`. Le projet est sous licence MIT.
Comments
0 Rating appears after 10 ratings
Sign in to join the discussion.