منصوبے کے بارے میں

Laravel Metrics Plausible ایک PHP لائبریری ہے جو Plausible Analytics Stats API v2 کو لپیٹتی ہے، جو اینالیٹکس ڈیٹا حاصل کرنے اور ان کا انتظام کرنے کے لیے ایک روانی سے بھرپور، Laravel‑native انٹرفیس فراہم کرتی ہے۔ اہم خصوصیات - مجموعی ٹوٹل حاصل کریں (وزٹرز، پیج ویوز، باؤنس ریٹ، وغیرہ) - حسب ضرورت تاریخ کی حدود اور طول و عرض (فی گھنٹہ، روزانہ، ماہانہ) کے ساتھ ٹائم سیریز ڈیٹا کوئری کریں - صفحات، اینٹری/ایگزٹ صفحات، ذرائع، چینلز، UTM پیرامیٹرز، ممالک، خطے، شہر، ڈیوائسز، براؤزرز، آپریٹنگ سسٹمز کی تفصیل حاصل کریں - ہدف کنورژنز، حسب ضرورت ایونٹس اور ریئل ٹائم وزٹرز کی تعداد تک رسائی حاصل کریں - Plausible سائٹس اور مقاصد کا انتظام کریں (فہرست، تخلیق، حذف) - API پے لوڈ کی عکاسی کرنے والے کوئری بلڈر کا استعمال کرتے ہوئے کسٹم کوئریز بنائیں - مخصوص استثناء کے ساتھ آتھینٹیکیشن، ریٹ لمٹ اور عمومی API کی خرابیوں کو سنبھالتا ہے - Plausible Cloud اور سیلف ہوسٹڈ Community Edition دونوں کے ساتھ کام کرتا ہے - کنفیگریشن ڈیٹابیس میں spatie/laravel-settings کے ذریعے اسٹور کی جاتی ہے، جس سے کنفیگ فائلوں کی ضرورت ختم ہو جاتی ہے انسٹالیشن 1. پیکیج شامل کریں: composer require jeffersongoncalves/laravel-metrics-plausible 2. سیٹنگز ٹیبل بنانے کے لیے مائیگریشنز چلائیں: php artisan migrate کنفیگریشن مائیگریشن کے بعد، ماحول کے متغیرات (environment variables) سیٹنگز کو سیڈ کرتے ہیں: PLAUSIBLE_API_KEY – Plausible Settings → API Keys سے API کی PLAUSIBLE_SITE_ID – سائٹ کا ڈومین (مثلاً، example.com) PLAUSIBLE_BASE_URL – Plausible کا بیس URL (ڈیفالٹ https://plausible.io، سیلف ہوسٹڈ کے لیے تبدیل کریں) سیٹنگز کو PlausibleSettings کلاس کے ذریعے بھی پروگرام کے ذریعے اپ ڈیٹ کیا جا سکتا ہے۔ استعمال کا جائزہ تمام تعاملات Plausible فیکیڈ کے ذریعے کیے جاتے ہیں۔ مجموعی ٹوٹل: $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); ای نمز (Enums) Metric – Visitors, Visits, Pageviews, BounceRate, VisitDuration, Events، وغیرہ۔ DateRange – Day, Last7Days, Last30Days, Last12Months, Year, All، وغیرہ۔ Dimension – Page, Hostname, Source, Referrer, Device, Browser, Country, City, TimeHour, TimeDay، وغیرہ۔ خرابیوں کی ہینڈلنگ - AuthenticationException: مفقود/غیر معتبر API کی یا سائٹ ID، یا 403 جوابی پیغام۔ - RateLimitException: HTTP 429 جوابی پیغام۔ - PlausibleException: عمومی API ناکامیاں (اوپر والے کے لیے بیس کلاس)۔ ٹیسٹنگ اور ڈیولپمنٹ ٹیسٹ سویٹ کو composer test کے ساتھ چلائیں، composer format کے ساتھ کوڈ فارمیٹ کریں، اور composer analyse کے ساتھ اسٹیٹک تجزیہ انجام دیں۔ لائسنس MIT لائسنس کے تحت تقسیم کیا گیا ہے۔