# Housa CMS 1.4 — التحكم الشامل في الصور

## الهدف
أي صورة مرئية داخل صفحات القالب يمكن استبدالها من لوحة التحكم، سواء كانت صورة عادية، صورة خلفية، أو صورة يتم تحميلها بواسطة `data-src` في بعض السلايدرات والبطاقات.

## تغيير أي صورة داخل صفحة
1. افتح **Pages** ثم الصفحة المطلوبة.
2. اختر السيكشن، أو اختر تبويب **Images** لعرض صور الصفحة.
3. أمام الصورة اضغط **Change**.
4. اختر صورة من Media Library أو اضغط **Upload**.
5. إذا رفعت صورة واحدة من داخل Image Picker، ينتقل النظام مباشرة إلى شاشة **Adjust image**.
6. اضبط الصورة ثم اضغط **Apply adjustment**.
7. احفظ **Save draft** ثم راجع **Preview draft** وبعدها **Publish changes**.

## Adjustment
شاشة Adjustment تسمح بـ:
- **Fit / crop**: Cover / Contain / Fill / Original.
- **Zoom** من 50% إلى 300%.
- **Horizontal position**.
- **Vertical position**.
- سحب نقطة التركيز مباشرة فوق الصورة لتحديد الجزء الأهم.
- تسعة مواضع سريعة: أعلى/وسط/أسفل × يسار/وسط/يمين.
- Center image لإعادة الصورة للمنتصف بسرعة.

هذا مفيد عندما تكون الصورة الجديدة أكبر من المساحة الأصلية، أو عندما يكون الشخص/المبنى في طرف الصورة وتريد إبقاءه ظاهرًا بعد القص.

## Desktop / Tablet / Mobile
من **Settings** للصورة تستطيع استخدام مصدر وإعدادات مختلفة لكل جهاز. إذا تركت Tablet أو Mobile بدون مصدر، يرث الجهاز الصورة الأكبر تلقائيًا.

## Appearance
من **Appearance → Page designer** اختر أي Section. قسم **SECTION MEDIA** يعرض صور ذلك الجزء. يمكنك Change أو Adjust للصورة على Desktop / Tablet / Mobile من نفس شاشة التصميم.

## صور كانت غير ظاهرة سابقًا
الإصدار 1.4 يضيف اكتشاف صور الخلفيات التي تستخدم `data-src` في القالب. تمت المحافظة على IDs القديمة، وأضيفت الحقول الجديدة في نهاية تعريف الصفحة حتى لا تتغير الحقول الحالية في المواقع التي تم تحديثها.

## تركيب التحديث
أوقف الخادم بـ `Ctrl + C`، خذ نسخة احتياطية من المشروع، ثم انسخ محتويات حزمة التحديث فوق مجلد `housa-cms` واختر استبدال الملفات المتطابقة.

لا تحذف:
- `storage/`
- `public/uploads/`

ولا تشغل `php bin/setup.php` مرة أخرى في موقع تم إعداده بالفعل.

بعد النسخ شغّل:

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

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