# Housa CMS v1.6 — صور وفيديو في نفس Media Slot

هذا التحديث يحول أي موضع صورة قابل للتحرير في صفحات القالب إلى **Media Slot** موحد. نفس المكان يمكن أن يعرض صورة أو فيديو، من غير تعديل HTML يدويًا ومن غير تغيير أبعاد التصميم الأصلي.

## أين أجد الخيار؟

من لوحة التحكم:

1. افتح **Pages**.
2. اختر الصفحة ثم السيكشن.
3. افتح تبويب **Media**.
4. أمام كل موضع ستجد **Image** و **Video** و **Adjust** و **Settings**.

ومن **Appearance → Page designer**، اختر السيكشن ثم استخدم **SECTION MEDIA** لتبديل نفس الموضع بين Image وVideo أثناء التصميم.

## Image

اختيار **Image** يفتح Media Library على الصور فقط. يمكنك رفع PNG/JPG/WEBP/GIF أو اختيار صورة موجودة، ثم ضبطها داخل الـFrame الحقيقي عبر **Adjust**.

## Video

اختيار **Video** يفتح Media Library على الفيديو فقط. الأنواع المدعومة:

- MP4
- WEBM
- OGV / OGG

الحد داخل التطبيق 100 MB للفيديو. قد تحتاج أيضًا إلى رفع حدود PHP أو Nginx/Apache إذا كانت الاستضافة تسمح بحجم أقل.

بعد اختيار الفيديو، يفتح **Adjust video** داخل نفس أبعاد الـFrame الحقيقي للصورة التي استبدلتها. تستطيع ضبط:

- Fit: Cover / Contain / Fill / None / Template default
- Zoom من 50% إلى 300%
- الموضع الأفقي والرأسي
- Desktop / Tablet / Mobile بشكل مستقل

## إعدادات الفيديو

من **Settings** تستطيع تحديد:

- Poster Image
- Autoplay
- Muted
- Loop
- Controls
- Plays inline
- Preload: Metadata / Auto / None
- Opacity وVisibility للمواضع العادية

للتشغيل التلقائي في أغلب المتصفحات يفضل إبقاء **Autoplay + Muted + Plays inline** مفعلة.

## صورة على Desktop وفيديو على Mobile؟

نعم. كل جهاز له Media Type مستقل. مثال:

- Desktop → Image
- Tablet → Inherit
- Mobile → Video

أو العكس. إذا اخترت **Inherit** يستخدم الجهاز إعداد الجهاز الأكبر السابق له.

## Background Video

إذا كان موضع الصورة Background، يمكن تحويله إلى فيديو خلفية. الفيديو يتم إدخاله خلف محتوى السيكشن مع الحفاظ على النصوص والأزرار فوقه، ويتم قصه داخل حدود السيكشن.

## الرجوع للصورة الأصلية

- **Restore template** يعيد موضع Desktop للصورة الأصلية في القالب.
- **Reset tablet / Reset mobile** يلغي التخصيص في هذا الجهاز ويعيد الوراثة.
- التحويل من Video إلى Image لا يحذف ملف الفيديو من Media Library؛ فقط يغير ما يعرضه هذا الموضع.

## Workflow مقترح

1. Video أو Image.
2. Upload/Choose media.
3. Adjust داخل الـFrame الحقيقي.
4. Settings إذا احتجت Poster أو Playback options.
5. Save draft.
6. Preview draft على Desktop/Tablet/Mobile.
7. Publish changes.

## تركيب التحديث على نسخة موجودة

1. أوقف السيرفر بـ `Ctrl + C`.
2. خذ نسخة احتياطية من المشروع.
3. فك ملف **Housa-Image-Video-Media-Update-v1.6.zip**.
4. انسخ محتويات مجلد `housa-cms` الموجود داخل التحديث فوق مجلد `housa-cms` الحالي، ووافق على Replace للملفات المتطابقة.
5. **لا تحذف** `storage/` ولا `public/uploads/`.
6. لا تشغل `php bin/setup.php` مرة أخرى.
7. شغل:

```powershell
php -S 127.0.0.1:8000 -t public public/router.php
```

8. افتح `/admin/` واضغط `Ctrl + F5`.

## حدود مهمة

Media Slot مخصص لمواضع الصور والخلفيات التي تم اكتشافها في القالب. الحقول التي يجب أن تظل صورة بطبيعتها، مثل الشعار أو Cover Image لبعض Collections، تظل Image-only حتى لا ينكسر استخدامها في SEO أو البطاقات التي تتوقع صورة.