عن المشروع

Laravel Plausible هي حزمة تتيح دمج Plausible Analytics في تطبيقات Laravel. توفر واجهة بسيطة للتفاعل مع Plausible Stats API، مما يتيح للمطورين جلب أعداد الزوار في الوقت الفعلي، والمقاييس الموجزة، وبيانات السلاسل الزمنية، والتقسيمات حسب خصائص متعددة. يتم التثبيت عبر Composer باستخدام الأمر composer require njoguamos/laravel-plausible، يليه php artisan plausible:install لنشر ملف التكوين. بعد التثبيت، يجب إضافة معرف موقع Plausible ومفتاح API إلى ملف .env، ويمكن ضبط PLAUSIBLE_BASE_URL للاستضافات الذاتية. توفر الحزمة عدة طرق: Plausible::realtime() تعيد عدد الزوار الحالي؛ Plausible::aggregates() تسترجع مقاييس ملخصة مع معاملات اختيارية للفترة والمقاييس والمقارنة والمرشحات ونطاق التاريخ؛ Plausible::timeSeries() تعيد نقاط بيانات عبر الزمن مع فترة زمنية قابلة للتكوين؛ Plausible::breakdown() توفر إحصاءات مجمّعة حسب خاصية مثل الصفحة أو المتصفح أو البلد، مع دعم الحدود وترقيم الصفحات والفلترة. لتقليل استدعاءات API، يتم تخزين الاستجابات مؤقتاً لمدة ثلاث دقائق افتراضياً، ويمكن تعديل مدة التخزين المؤقت ومشغله عبر متغيرات البيئة PLAUSIBLE_CACHE_DURATION وPLAUSIBLE_CACHE_DRIVER، أو تعطيل التخزين المؤقت كلياً بـ PLAUSIBLE_CACHE=false. تتضمن الحزمة مجموعة اختبارات تعمل بـ composer test وتتبع إرشادات مساهمة Laravel القياسية.