عن المشروع

تُعد Nuxt Plausible وحدة خفيفة الوزن تُدمج خدمة تحليلات Plausible في تطبيقات Nuxt. يتم التثبيت عبر أمر واحد (`npx nuxt module add plausible`)، وتتيح إضافة `@nuxtjs/plausible` إلى مصفوفة `modules` في `nuxt.config.ts` التتبع دون الحاجة إلى تكوينات إضافية. بشكل افتراضي، تستخدم الوحدة اسم المضيف الحالي كـ Plausible domain، ولكن يمكن لخيار `domain` تجاوز ذلك. تشمل الميزات الرئيسية ما يلي: - تتبع تلقائي لمشاهدات الصفحات، مع دعم اختياري لوضع الـ hash. - تتبع مدمج لنقرات الروابط الخارجية، وتنزيلات الملفات، وإرسال النماذج، ويمكن تكوينه عبر خيارات `autoOutboundTracking` و `fileDownloads` و `formSubmissions`. - تتبع يدوي من خلال دوال مجمعة (composables) مستوردة تلقائياً مثل `useTrackEvent` و `useTrackPageview` للأهداف المخصصة ومشاهدات الصفحات الافتراضية. - خيار الوكيل الاختياري (`proxy: true`) الذي يوجه الأحداث عبر خادم Nuxt (`/_plausible/api/event`)، مما يساعد في تجاوز حواجب الإعلانات مع الحفاظ على ملفات تعريف الارتباط في نطاقك الخاص. - تكوين أثناء التشغيل (Runtime configuration) عبر متغيرات البيئة العامة (مثل `NUXT_PUBLIC_PLAUSIBLE_DOMAIN`) لسهولة النشر عبر بيئات مختلفة. - تنفيذ جاهز لـ SSR، مما يضمن عدم تسرب أي كود خاص بالعميل فقط إلى حزم الخادم. يتم التكوين إما في مفتاح `plausible` في `nuxt.config.ts` أو من خلال متغيرات `.env`. تشمل الخيارات الشائعة `enabled` و `ignoredHostnames` و `ignoreSubDomains` و `apiHost` و `autoPageviews` و `logIgnoredEvents` وإعدادات الوكيل مثل `proxyBaseEndpoint`. تراعي الوحدة الخصوصية من خلال إرسال الحد الأدنى فقط من الترويسات (user‑agent و content‑type و x‑forwarded‑for) إلى Plausible ومن خلال السماح لك بتعطيل التتبع تماماً باستخدام `enabled: false`. جميع الميزات موثقة في ملف README مع أمثلة الاستخدام. يتبع التطوير اتفاقيات وحدة Nuxt القياسية: استنسخ المستودع، وقم بتمكين Corepack، وثبت التبعيات باستخدام pnpm، وقم بتشغيل `pnpm run dev:prepare`، وابدأ خادم التطوير باستخدام `pnpm run dev`. المشروع مرخص بموجب ترخيص MIT.