عن المشروع

يوفر Laravel Umami طريقة بسيطة لإضافة تحليلات Umami إلى تطبيق Laravel. تعتمد الحزمة على spatie/laravel-settings لتخزين جميع قيم إعدادات Umami في قاعدة البيانات، مما يسهل تغيير الإعدادات دون التعديل على الكود. الميزات الرئيسية: - تضمين Blade بسيط: أضف @include('umami::script') إلى التخطيط الخاص بك لتحميل سكريبت التتبع. - إعدادات قائمة على قاعدة البيانات: يُخزّن معرّف الموقع، ورابط المضيف، وقائمة النطاقات البيضاء، وعلامة التتبع التلقائي، وخيارات أخرى في جدول الإعدادات ويمكن تعديلها عبر الكود أو واجهة الإدارة. - تتبع تلقائي لمدخلات الصفحات والأحداث افتراضيًا، مع خيارات لاستبعاد سلاسل الاستعلام أو أجزاء رمز التعريف (hash). - يدعم العلامات المخصصة وتقييدات النطاق لتحليلات أكثر دقة. خطوات التثبيت: 1. ثبت الحزمة باستخدام Composer. 2. تأكد من تثبيت spatie/laravel-settings وتشغيل ملف الارتحال الخاص به. 3. أنشر وشغّل ملف الارتحال الخاص بإعدادات Umami الذي توفره الحزمة. 4. أضف تضمين السكريبت إلى قالب Blade الخاص بك. مثال تكوين (PHP): ``` use JeffersonGoncalves\Umami\Settings\UmamiSettings; $settings = app(UmamiSettings::class); $settings->website_id = 'your-website-id'; $settings->host_analytics = 'https://your-umami-instance.com'; $settings->save(); ``` الإعدادات المتاحة تشمل: - website_id (مطلوب) - host_analytics (افتراضي https://cloud.umami.is) - host_url (تعديل اختياري) - auto_track (منطقي، افتراضي true) - domains (قائمة مفصولة بفواصل) - tag (علامة تجميع اختيارية) - exclude_search و exclude_hash (منطقيان لقص أجزاء URL) الحزمة متوافقة مع PHP 8.2+ وLaravel 11+. يمكن تشغيل الاختبارات عبر `composer test`. الصادرة بموجب رخصة MIT. لمزيد من التفاصيل، انظر دليل README والمستودع وسجل التغييرات وإرشادات المساهمة.