প্রকল্প সম্পর্কে
Nuxt Plausible একটি হালকা ওজনের মডিউল যা Nuxt অ্যাপ্লিকেশনগুলোতে Plausible অ্যানালিটিক্স সার্ভিসকে ইন্টিগ্রেট করে। ইনস্টলেশন হল একটি একক কমান্ড (`npx nuxt module add plausible`) এবং `nuxt.config.ts`-এর `modules` অ্যারেতে `@nuxtjs/plausible` যোগ করলে অতিরিক্ত কোনো কনফিগারেশন ছাড়াই ট্র্যাকিং সক্ষম হয়। ডিফল্টভাবে মডিউলটি বর্তমান হোস্টনেমকে Plausible ডোমেন হিসেবে ব্যবহার করে, তবে `domain` অপশন দিয়ে এটি ওভাররাইড করা যেতে পারে।
প্রধান বৈশিষ্ট্যগুলোর মধ্যে রয়েছে:
- ঐচ্ছিক হ্যাশ-মোড (hash-mode) সাপোর্টসহ স্বয়ংক্রিয় পেজ-ভিউ ট্র্যাকিং।
- আউটবাউন্ড লিংক ক্লিক, ফাইল ডাউনলোড এবং ফর্ম সাবমিশনের জন্য বিল্ট-ইন ট্র্যাকিং, যা `autoOutboundTracking`, `fileDownloads`, এবং `formSubmissions` অপশনগুলোর মাধ্যমে কনফিগারযোগ্য।
- কাস্টম গোল এবং ভার্চুয়াল পেজ ভিউয়ের জন্য অটো-ইম্পোর্টেড কম্পোজেবল `useTrackEvent` এবং `useTrackPageview`-এর মাধ্যমে ম্যানুয়াল ট্র্যাকিং।
- ঐচ্ছিক প্রক্সি (`proxy: true`) যা Nuxt সার্ভারের (`/_plausible/api/event`) মাধ্যমে ইভেন্টগুলোকে রুট করে, যা নিজের অরিজিনে কুকি বজায় রাখার পাশাপাশি অ্যাড-ব্লকারগুলোকে বাইপাস করতে সাহায্য করে।
- বিভিন্ন এনভায়রনমেন্ট জুড়ে সহজ ডিপ্লয়মেন্টের জন্য পাবলিক এনভায়রনমেন্ট ভেরিয়েবল (যেমন, `NUXT_PUBLIC_PLAUSIBLE_DOMAIN`)-এর মাধ্যমে রানটাইম কনফিগারেশন।
- SSR-রেডি ইমপ্লিমেন্টেশন, যা সার্ভার বান্ডিলে কোনো ক্লায়েন্ট-অনলি কোড লিক না হওয়া নিশ্চিত করে।
কনফিগারেশন `nuxt.config.ts`-এর `plausible` কিতে অথবা `.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 লাইসেন্সের অধীনে লাইসেন্সপ্রাপ্ত।
Comments
0 Rating appears after 10 ratings
Sign in to join the discussion.