Об этом проекте

Nuxt Plausible — это легкий модуль, интегрирующий сервис аналитики Plausible в приложения Nuxt. Установка выполняется одной командой (npx nuxt module add plausible), а добавление @nuxtjs/plausible в массив modules в nuxt.config.ts включает отслеживание без дополнительной настройки. По умолчанию модуль использует текущий hostname в качестве домена Plausible, но параметр domain позволяет его переопределить. Основные возможности включают: - Автоматическое отслеживание просмотров страниц с опциональной поддержкой режима хэшей (hash-mode). - Встроенное отслеживание переходов по внешним ссылкам, скачиваний файлов и отправок форм, настраиваемое с помощью параметров autoOutboundTracking, fileDownloads и formSubmissions. - Ручное отслеживание с помощью автоматически импортируемых composable-функций useTrackEvent и useTrackPageview для пользовательских целей и виртуальных просмотров страниц. - Опциональный прокси (proxy: true), который маршрутизирует события через сервер Nuxt (/_plausible/api/event), что помогает обходить блокировщики рекламы и сохранять куки на вашем собственном домене. - Конфигурация во время выполнения (Runtime) через публичные переменные окружения (например, NUXT_PUBLIC_PLAUSIBLE_DOMAIN) для простого развертывания в разных средах. - Готовая к SSR реализация, гарантирующая отсутствие утечек клиентского кода в серверные сборки. Конфигурация выполняется либо в ключе plausible в nuxt.config.ts, либо через переменные .env. Среди распространенных параметров: enabled, ignoredHostnames, ignoreSubDomains, apiHost, autoPageviews, logIgnoredEvents и настройки прокси, такие как proxyBaseEndpoint. Модуль уважает конфиденциальность, отправляя в Plausible только минимальный набор заголовков (user-agent, content-type, x-forwarded-for) и позволяя полностью отключить отслеживание с помощью enabled: false. Все функции задокументированы в файле README с примерами использования. Разработка следует стандартным соглашениям для модулей Nuxt: клонируйте репозиторий, включите Corepack, установите зависимости с помощью pnpm, выполните pnpm run dev:prepare и запустите сервер разработки с помощью pnpm run dev. Проект распространяется под лицензией MIT.