# دليل استخدام المشغل المخصص + Cron Job لـ cPanel

## 🎬 المشغل المخصص (custom_player.html)

### المميزات الكاملة:

#### 1. عناصر التحكم الأساسية
- ✅ **تشغيل/إيقاف** - زر مخصص بالكامل
- ✅ **شريط التقدم** - قابل للنقر والسحب
- ✅ **الوقت** - عرض الوقت الحالي والمدة الكاملة
- ✅ **الصوت** - كتم/إلغاء الكتم + شريط التحكم
- ✅ **ملء الشاشة** - دعم كامل

#### 2. التحكم في الجودة
- ✅ اختيار تلقائي (حسب سرعة الإنترنت)
- ✅ 360p, 480p, 720p, 1080p
- ✅ التبديل أثناء التشغيل
- ✅ قائمة منسدلة أنيقة

#### 3. اختصارات لوحة المفاتيح
- `Space` - تشغيل/إيقاف
- `←` - الرجوع 5 ثواني
- `→` - التقدم 5 ثواني
- `↑` - رفع الصوت
- `↓` - خفض الصوت
- `M` - كتم الصوت
- `F` - ملء الشاشة

#### 4. معلومات التشغيل
- الحالة الحالية
- الجودة الحالية
- سرعة التحميل
- الجودات المتاحة

---

## 🎨 التخصيص الكامل

### تغيير الألوان
```css
/* في custom_player.html - قسم <style> */

/* اللون الرئيسي */
background: linear-gradient(135deg, #667eea 0%, #764ba2 100%);

/* غيّر إلى أي لون تريده */
background: linear-gradient(135deg, #ff6b6b 0%, #ee5a6f 100%); /* أحمر */
background: linear-gradient(135deg, #4facfe 0%, #00f2fe 100%); /* أزرق */
background: linear-gradient(135deg, #43e97b 0%, #38f9d7 100%); /* أخضر */
```

### تغيير حجم الأزرار
```css
.control-btn svg {
    width: 32px;  /* غيّر الحجم */
    height: 32px;
}
```

### تغيير موضع عناصر التحكم
```css
.custom-controls {
    bottom: 0;     /* غيّر إلى top: 0 للأعلى */
    padding: 30px; /* زيادة المسافة */
}
```

---

## 🔧 كود Cron Job لـ cPanel

### الطريقة 1: عبر واجهة cPanel

1. **افتح cPanel**
2. **ابحث عن "Cron Jobs"**
3. **اختر "Add New Cron Job"**
4. **املأ الحقول كالتالي:**

#### كل 30 دقيقة (موصى به):
```
Minute: */30
Hour: *
Day: *
Month: *
Weekday: *

Command:
cd /home/username/public_html/backend/api && /usr/bin/php process_videos.php >> video_processing.log 2>&1
```

#### كل ساعة:
```
Minute: 0
Hour: *
Day: *
Month: *
Weekday: *

Command:
cd /home/username/public_html/backend/api && /usr/bin/php process_videos.php >> video_processing.log 2>&1
```

#### كل 15 دقيقة:
```
Minute: */15
Hour: *
Day: *
Month: *
Weekday: *

Command:
cd /home/username/public_html/backend/api && /usr/bin/php process_videos.php >> video_processing.log 2>&1
```

#### مرة واحدة يومياً (2 صباحاً):
```
Minute: 0
Hour: 2
Day: *
Month: *
Weekday: *

Command:
cd /home/username/public_html/backend/api && /usr/bin/php process_videos.php >> video_processing.log 2>&1
```

---

### الطريقة 2: الصيغة الكاملة (نسخ ولصق)

#### كل 30 دقيقة:
```bash
*/30 * * * * cd /home/username/public_html/backend/api && /usr/bin/php process_videos.php >> video_processing.log 2>&1
```

#### كل ساعة:
```bash
0 * * * * cd /home/username/public_html/backend/api && /usr/bin/php process_videos.php >> video_processing.log 2>&1
```

#### كل 15 دقيقة:
```bash
*/15 * * * * cd /home/username/public_html/backend/api && /usr/bin/php process_videos.php >> video_processing.log 2>&1
```

#### يومياً في 2 صباحاً:
```bash
0 2 * * * cd /home/username/public_html/backend/api && /usr/bin/php process_videos.php >> video_processing.log 2>&1
```

---

## 📝 ملاحظات مهمة لـ cPanel

### 1. تحديد المسارات الصحيحة

**استبدل `username` باسم المستخدم الخاص بك:**
```bash
# بدلاً من:
/home/username/public_html/

# استخدم:
/home/yourusername/public_html/
```

**للحصول على المسار الكامل:**
```bash
# في cPanel Terminal أو SSH
pwd
# سيعطيك المسار الكامل
```

### 2. مسار PHP

**cPanel عادة يستخدم:**
```bash
/usr/bin/php
# أو
/usr/local/bin/php
# أو
/opt/cpanel/ea-php80/root/usr/bin/php  # PHP 8.0
/opt/cpanel/ea-php81/root/usr/bin/php  # PHP 8.1
```

**للتحقق من مسار PHP:**
```bash
which php
```

### 3. التحقق من FFmpeg

**في cPanel Terminal:**
```bash
which ffmpeg
# أو
/usr/bin/ffmpeg -version
```

**إذا لم يكن مثبتاً، اتصل بالدعم الفني لتثبيته**

---

## 📊 مراقبة Cron Job

### عرض السجلات في cPanel

1. **File Manager**
2. **انتقل إلى:** `public_html/backend/api/`
3. **افتح:** `video_processing.log`

### أو عبر Terminal:
```bash
tail -50 ~/public_html/backend/api/video_processing.log
```

---

## 🎯 استخدام المشغل في موقعك

### مثال 1: صفحة مستقلة
```html
<!-- video.php -->
<?php
$postId = $_GET['id'] ?? '';
?>
<!DOCTYPE html>
<html>
<head>
    <title>مشاهدة الفيديو</title>
</head>
<body>
    <iframe src="custom_player.html?post_id=<?= $postId ?>" 
            width="100%" 
            height="600" 
            frameborder="0">
    </iframe>
</body>
</html>
```

### مثال 2: تضمين مباشر
```php
<!-- في صفحة المقالة -->
<?php
$postId = $article['post_id'];
$videoUrl = "backend/api/upload_media/{$postId}_hls/master.m3u8";
?>

<div id="videoContainer"></div>

<script src="https://cdn.jsdelivr.net/npm/hls.js@latest"></script>
<script>
    // نفس الكود من custom_player.html
</script>
```

---

## ✅ قائمة التحقق النهائية

### قبل تفعيل Cron:
- [ ] FFmpeg مثبت على السيرفر
- [ ] المسارات صحيحة في الأمر
- [ ] السكريبت يعمل يدوياً: `php process_videos.php`
- [ ] الصلاحيات صحيحة للمجلدات

### بعد تفعيل Cron:
- [ ] انتظر الوقت المحدد (30 دقيقة مثلاً)
- [ ] تحقق من `video_processing.log`
- [ ] تحقق من قاعدة البيانات (`video_processing = 2`)
- [ ] اختبر المشغل على فيديو معالج

---

## 🚀 الخلاصة

**المشغل المخصص:**
- ✅ تحكم كامل في جميع العناصر
- ✅ تصميم قابل للتخصيص بالكامل
- ✅ اختصارات لوحة المفاتيح
- ✅ معلومات تفصيلية

**Cron Job لـ cPanel:**
```bash
*/30 * * * * cd /home/username/public_html/backend/api && /usr/bin/php process_videos.php >> video_processing.log 2>&1
```

**استبدل:**
- `username` باسم المستخدم الخاص بك
- `/usr/bin/php` بمسار PHP الصحيح

**التاريخ**: 2026-02-10
