عن المشروع

Laravisit هي حزمة Laravel تدار عبر Composer، مصممة لإضافة تتبع الزيارات وتحليلات مشاهدات الصفحات إلى أي نموذج Eloquent من خلال واجهة نظيفة وانسيابية. يتم التثبيت عبر Composer باستخدام الأمر `composer require coderflexx/laravisit` متبوعاً بنشر ملف التكوين وتشغيل التهجيرات (migrations) لإعداد جداول قاعدة البيانات المطلوبة. لاستخدام الحزمة، يجب على النموذج استيراد وتطبيق الـ trait المسمى `HasVisits` مع تنفيذ الواجهة `CanVisit`. بمجرد التكوين، يمكن للمطورين تسجيل الزيارات باستخدام طريقة `visit()` على مثيل النموذج، مع طرق ربط اختيارية لإرفاق عنوان IP، ومعرف الجلسة، ومصفوفات بيانات مخصصة، وارتباطات المستخدمين المصادق عليهم. يدعم تجميع الزيارات فترات زمنية متعددة تشمل: ساعية، يومية، أسبوعية، شهرية، سنوية، وفترات مخصصة تعتمد على Carbon. السلوك الافتراضي يقوم بإزالة تكرار الزيارات لكل يوم لكل مستخدم. لاسترجاع التحليلات، توفر الحزمة نطاقات استعلام (query scopes) مثل `withTotalVisitCount()` و `popularAllTime()` و `popularToday()` و `popularLastDays($days)` و `popularThisWeek()` و `popularLastWeek()` و `popularThisMonth()` و `popularLastMonth()` و `popularThisYear()` و `popularLastYear()` و `popularBetween($from, $to)` لجلب النتائج المصنفة عبر نطاقات تاريخية مختلفة. توجد طبقة عرض للزيارات (visit presenter layer)، مدعومة بحزمة laravel-presenter، تعرض سمات مزخرفة مثل عنوان IP وتفاصيل المستخدم المرتبط بسجلات الزيارات. تتضمن الحزمة اختبارات PHPUnit يمكن تشغيلها باستخدام `composer test` وهي مرخصة بموجب رخصة MIT.