# 📱 نظام طلب التثبيت - Install Prompt

## 🎯 الميزات

### ✅ طلب ذكي للتثبيت
- يظهر تلقائياً بعد 3 ثوانٍ من دخول المستخدم (إن لم يكن التطبيق مثبتاً)
- لا يظهر مجدداً إذا رفضه المستخدم (لمدة أسبوع)
- لا يظهر إذا كان التطبيق مثبتاً بالفعل

### 🎨 واجهة جميلة
- نافذة منزلقة من الأسفل
- تأثيرات انسيابية وسلسة
- أيقونات وألوان جذابة
- توافقية مع جميع أحجام الشاشات

### 🔔 إشعارات عند التثبيت
- إشعار عند نجاح التثبيت
- إشعار عند بدء عملية التثبيت
- تتبع حالة التثبيت

---

## 📁 الملفات المطلوبة

```
public/
├── js/
│   └── install-prompt.js          ✅ منطق التثبيت
├── css/
│   └── style.css                  ✅ تصاميم النافذة (مضافة)
└── [جميع صفحات HTML]            ✅ تم إضافة السكريبت
```

---

## 🚀 كيفية العمل

### 1. الظهور التلقائي

```javascript
// تلقائي عند فتح الصفحة بعد 3 ثوانٍ:
// - يتحقق إذا كان التطبيق مثبتاً
// - يتحقق إذا رفضها المستخدم سابقاً
// - يعرض النافذة إن كان يجب
```

### 2. كود بسيط في HTML (لا يلزم)

```html
<!-- السكريبت يُحمل تلقائياً -->
<script src="js/install-prompt.js"></script>
```

### 3. طلب التثبيت يدويًا (من JavaScript)

```javascript
// في أي مكان في الكود:
installPromptManager.requestInstall();
```

---

## 💡 استخدامات متقدمة

### التحقق من التثبيت

```javascript
const isInstalled = installPromptManager.showInstallStatus();

if (isInstalled) {
  console.log('✅ التطبيق مثبت');
} else {
  console.log('❌ التطبيق غير مثبت');
}
```

### إعادة عرض النافذة (للاختبار)

```javascript
// حذف إعدادات الرفض
installPromptManager.resetPromptSettings();
// سيُعاد تحميل الصفحة وستظهر النافذة مجدداً
```

### الاستماع لحدث التثبيت

```javascript
window.addEventListener('appinstalled', () => {
  console.log('✅ تم تثبيت التطبيق');
  // يمكنك تنفيذ إجراء معين هنا
});
```

---

## 🎯 سلوك النافذة

### الظهور
1. بعد 3 ثوانٍ من فتح الصفحة
2. أنزلقة من الأسفل بتأثير سلس
3. تحتوي على 3 فوائد رئيسية للتطبيق

### الرفض
- زر "ليس الآن" أو الـ ✕
- لن تظهر مجدداً لمدة 7 أيام
- يمكن إعادة تعيينها بـ `resetPromptSettings()`

### القبول
- النقر على "ثبّت الآن"
- يفتح نافذة التثبيت الرسمية للمتصفح
- إشعار عند نجاح التثبيت

---

## 📊 معلومات التخزين

### localStorage Keys

```javascript
localStorage.getItem('installPromptDismissed')  // 'true' إن رفضها
localStorage.getItem('installPromptTimestamp')  // وقت الرفض
localStorage.getItem('appInstalled')            // 'true' إن مثبت
```

### يمكن مسحها بـ:
```javascript
localStorage.clear();
location.reload();
```

---

## 🧪 الاختبار

### على الهاتف (Android)
1. افتح التطبيق على Chrome
2. بعد 3 ثوانٍ ستظهر النافذة
3. اضغط "ثبّت الآن"
4. متابعة خطوات المتصفح

### في المتصفح (Desktop)
1. افتح DevTools (F12)
2. اذهب إلى Application → Manifest
3. تحقق من `start_url`
4. النافذة قد لا تظهر على desktop (حسب السياسة)

### اختبار الرفض والقبول
```javascript
// في console:
installPromptManager.resetPromptSettings();

// الآن ستظهر النافذة مجدداً
```

---

## ⚙️ المتطلبات

| المتطلب | التفاصيل |
|--------|---------|
| **HTTPS** | يجب أن يكون الموقع على HTTPS |
| **Service Worker** | يجب تسجيل Service Worker |
| **Manifest** | يجب وجود manifest.json صحيح |
| **Icons** | يجب وجود أيقونات في manifest.json |

---

## 🔧 الخصائص المتاحة

```javascript
installPromptManager.deferredPrompt      // الحدث المُؤجل
installPromptManager.isInstalled         // هل التطبيق مثبت؟
installPromptManager.init()              // تهيئة
installPromptManager.showInstallPrompt() // إظهار النافذة يدويًا
installPromptManager.hideInstallPrompt() // إخفاء النافذة
installPromptManager.dismissPrompt()     // رفض مع حفظ
installPromptManager.installApp()        // بدء التثبيت
installPromptManager.requestInstall()    // طلب التثبيت
installPromptManager.showInstallStatus() // عرض الحالة
installPromptManager.resetPromptSettings() // إعادة تعيين
```

---

## 🎨 تخصيص النافذة

### تغيير الألوان (في style.css)

```css
.btn-install {
  background: linear-gradient(135deg, #667eea 0%, #764ba2 100%);
  /* غيّر الألوان هنا */
}
```

### تغيير النص (في install-prompt.js)

```javascript
<h3 class="install-prompt-title">ثبّت التطبيق</h3>
<!-- غيّر النص هنا -->
```

### تغيير الوقت

```javascript
setTimeout(() => this.showInstallPrompt(), 3000);
// غيّر 3000 (3 ثوانٍ) للمدة المطلوبة
```

---

## 🚨 استكشاف الأخطاء

### النافذة لا تظهر؟

```javascript
// تحقق من:
console.log(installPromptManager.isInstalled);        // يجب أن يكون false
console.log(installPromptManager.deferredPrompt);     // يجب أن يكون موجود
console.log(installPromptManager.hasBeenDismissed()); // يجب أن يكون false
```

### إعادة تعيين كامل

```javascript
// امسح جميع البيانات:
localStorage.clear();
caches.keys().then(names => {
  names.forEach(name => caches.delete(name));
});
location.reload();
```

---

## 📝 ملخص

✅ **نظام طلب التثبيت الذكي**:
- يظهر تلقائياً (لا يزعج إذا رفضه المستخدم)
- واجهة جميلة وسهلة الاستخدام
- يدعم التثبيت على جميع الأجهزة
- قابل للتخصيص والتطوير

**الآن تطبيقك جاهز للترويج!** 🚀
