প্রকল্প সম্পর্কে

Laravel Metrics Plausible হল একটি PHP লাইব্রেরি যা Plausible Analytics Stats API v2 কে র‍্যাপ করে, অ্যানালিটিক্স ডেটা পুনরুদ্ধার এবং পরিচালনার জন্য একটি সাবলীল, Laravel-নেটিভ ইন্টারফেস প্রদান করে। মূল বৈশিষ্ট্য - সমষ্টিগত মোট ডেটা পুনরুদ্ধার করুন (ভিজিটর, পেজভিউ, বাউন্স রেট ইত্যাদি) - কাস্টম ডেট রেঞ্জ এবং ডাইমেনশন সহ টাইম-সিরিজ ডেটা কোয়েরি করুন (প্রতি ঘণ্টা, দৈনিক, মাসিক) - পেজ, এন্ট্রি/এক্সিট পেজ, সোর্স, চ্যানেল, UTM প্যারামিটার, দেশ, অঞ্চল, শহর, ডিভাইস, ব্রাউজার, অপারেটিং সিস্টেম দ্বারা ব্রেকডাউন পান - গোল কনভার্সন, কাস্টম ইভেন্ট এবং রিয়েলটাইম ভিজিটর সংখ্যা অ্যাক্সেস করুন - Plausible সাইট এবং গোল পরিচালনা করুন (তালিকা, তৈরি, মুছে ফেলা) - একটি কোয়েরি বিল্ডার ব্যবহার করে কাস্টম কোয়েরি তৈরি করুন যা API পেলোডকে প্রতিফলিত করে - নির্দিষ্ট ব্যতিক্রম সহ প্রমাণীকরণ, রেট-লিমিট এবং জেনেরিক API ত্রুটিগুলি পরিচালনা করে - Plausible Cloud এবং সেলফ-হোস্টেড কমিউনিটি এডিশন উভয় ক্ষেত্রেই কাজ করে - spatie/laravel-settings এর মাধ্যমে ডেটাবেসে কনফিগারেশন সংরক্ষণ করা হয়, যা কনফিগার ফাইলগুলির প্রয়োজনীয়তা দূর করে ইনস্টলেশন 1. প্যাকেজ যোগ করুন: composer require jeffersongoncalves/laravel-metrics-plausible 2. সেটিংস টেবিল তৈরি করতে মাইগ্রেশন চালান: php artisan migrate কনফিগারেশন মাইগ্রেশনের পর, এনভায়রনমেন্ট ভেরিয়েবল সেটিংসকে সিড করে: PLAUSIBLE_API_KEY – Plausible Settings → API Keys থেকে API কী PLAUSIBLE_SITE_ID – সাইটের ডোমেইন (যেমন, example.com) PLAUSIBLE_BASE_URL – Plausible এর বেস URL (ডিফল্ট https://plausible.io, সেলফ-হোস্টেড এর জন্য পরিবর্তন করুন) PlausibleSettings ক্লাস ব্যবহার করে প্রোগ্রাম্যাটিকভাবেও সেটিংস আপডেট করা যেতে পারে। ব্যবহারের সংক্ষিপ্ত বিবরণ সমস্ত ইন্টারঅ্যাকশন Plausible facade এর মাধ্যমে সম্পন্ন হয়। সমষ্টিগত মোট ডেটা: $stats = Plausible::aggregate(); $stats->visitors(); // 1234 $stats->pageviews(); // 4321 টাইম-সিরিজ: $rows = Plausible::timeseries(DateRange::Last30Days, Dimension::TimeDay); foreach ($rows as $row) { echo $row->label . ': ' . $row->visitors(); } ব্রেকডাউন (পেজ, সোর্স, দেশ, ডিভাইস ইত্যাদি) Plausible::pages(), Plausible::countries(), Plausible::devices() এর মতো ডেডিকেটেড পদ্ধতির মাধ্যমে উপলব্ধ। রিয়েলটাইম ভিজিটর: $visitors = Plausible::realtimeVisitors(); কাস্টম কোয়েরি: $query = Plausible::query() ->metrics(Metric::Visitors, Metric::Pageviews) ->dateRange(DateRange::Last7Days) ->dimensions(Dimension::Page) ->filter('is', Dimension::Country, ['BR', 'PT']) ->orderBy(Metric::Visitors, 'desc') ->limit(50); $rows = Plausible::rows($query); সাইট ব্যবস্থাপনা: Plausible::sites(); Plausible::createSite('example.com', 'America/Sao_Paulo'); Plausible::deleteSite('example.com'); গোল ব্যবস্থাপনা: Plausible::goals(); Plausible::createEventGoal('Signup'); Plausible::deleteGoal(1); এনামস Metric – ভিজিটর, ভিজিট, পেজভিউ, বাউন্স রেট, ভিজিট ডিউরেশন, ইভেন্ট ইত্যাদি। DateRange – দিন, শেষ ৭ দিন, শেষ ৩০ দিন, শেষ ১২ মাস, বছর, সব ইত্যাদি। Dimension – পেজ, হোস্টনেম, সোর্স, রেফারার, ডিভাইস, ব্রাউজার, দেশ, শহর, টাইম আওয়ার, টাইম ডে ইত্যাদি। ত্রুটি হ্যান্ডলিং - AuthenticationException: অনুপস্থিত/অবৈধ API কী বা সাইট আইডি, অথবা 403 রেসপন্স। - RateLimitException: HTTP 429 রেসপন্স। - PlausibleException: জেনেরিক API ব্যর্থতা (উপরেরগুলির জন্য বেস ক্লাস)। টেস্টিং এবং ডেভেলপমেন্ট composer test দিয়ে টেস্ট স্যুট চালান, composer format দিয়ে কোড ফরম্যাট করুন এবং composer analyse দিয়ে স্ট্যাটিক অ্যানালাইসিস করুন। লাইসেন্স MIT লাইসেন্সের অধীনে বিতরণ করা হয়েছে।