FM / httpdocs

/var/www/vhosts/m-auto.co/httpdocs

Name	Size	Mode	Actions
admin/	-	0755	rm
ajax/	-	0755	rm
assets/	-	0755	rm
includes/	-	0755	rm
uploads/	-	0755	rm
.htaccess	2906	0644	edit dl rm
7-6-2026.zip	15953	0644	edit dl rm
404.php	1346	0644	edit dl rm
500.php	1326	0644	edit dl rm
about.php	2214	0644	edit dl rm
add_technical_specs.php	3659	0644	edit dl rm
ajax_filter_cars.php	7412	0644	edit dl rm
atom.xml	6281244	0644	edit dl rm
BACKGROUND_THEMES_INFO.md	4561	0644	edit dl rm
Backup.zip	4965	0644	edit dl rm
branches.php	10788	0644	edit dl rm
calculator.php	5897	0644	edit dl rm
cars.php	21991	0644	edit dl rm
car_condition_summary.php	9248	0644	edit dl rm
car_details.php	22584	0644	edit dl rm
CAR_GALLERY_README.md	7870	0644	edit dl rm
car_gallery_summary.php	10857	0644	edit dl rm
check_brand_matching.php	2000	0644	edit dl rm
cleanup_for_production.php	4878	0644	edit dl rm
compare.php	20255	0644	edit dl rm
COMPARISON_SYSTEM_README.md	6832	0644	edit dl rm
contact.php	3819	0644	edit dl rm
contact_process.php	2370	0644	edit dl rm
database_backup_2025-11-04_13-01-05.sql	48138	0644	edit dl rm
debug_brands.php	2267	0644	edit dl rm
deployment_checklist.php	6860	0644	edit dl rm
DEPLOYMENT_GUIDE.md	2712	0644	edit dl rm
export_database.php	3329	0644	edit dl rm
find_nearest_branch.php	2889	0644	edit dl rm
get-sitemap.php	2580	0644	edit dl rm
get_branches_by_city.php	4697	0644	edit dl rm
google7cbe8ec413192e2a.html	53	0644	edit dl rm
google69217c47da90dd66.html	53	0644	edit dl rm
index.php	633559	0644	edit dl rm
m11.zip	32222824	0644	edit dl rm
main.php	12595	0644	edit dl rm
main1.php	11911	0644	edit dl rm
maintenance.php	4169	0644	edit dl rm
maintenance_process.php	3408	0644	edit dl rm
manifest.json	828	0644	edit dl rm
news.php	2691	0644	edit dl rm
news_article.php	6536	0644	edit dl rm
ODOO_INTEGRATION_README.md	4435	0644	edit dl rm
offers.php	2218	0644	edit dl rm
PRODUCTION_SUMMARY.md	6426	0644	edit dl rm
quick_test_gallery.php	6078	0644	edit dl rm
README.md	6170	0644	edit dl rm
robots.txt	59	0644	edit dl rm
server_check.php	5293	0644	edit dl rm
sitemap.js	479620	0644	edit dl rm
sitemap.xml	6281829	0644	edit dl rm
sw.js	1954	0644	edit dl rm
test_odoo_connection.php	3474	0644	edit dl rm
visit.php	3781	0644	edit dl rm
visit_process.php	2771	0644	edit dl rm
x.txt	479657	0644	edit dl rm

Edit: /var/www/vhosts/m-auto.co/httpdocs/CAR_GALLERY_README.md (7870B)

# 📸 ألبوم الصور والفيديو للسيارات - M-AUTO

## 🎯 نظرة عامة

تم إضافة ميزة ألبوم الصور والفيديو إلى نظام M-AUTO لإدارة السيارات، مما يتيح:
- رفع صور متعددة لكل سيارة
- تعيين صورة رئيسية
- إضافة رابط فيديو اختياري
- معرض صور تفاعلي في الواجهة الأمامية
- مشغل فيديو مدمج

## 🗄️ تحديثات قاعدة البيانات

### جدول جديد: `car_images`
```sql
CREATE TABLE car_images (
    id INT AUTO_INCREMENT PRIMARY KEY,
    car_id INT NOT NULL,
    image_name VARCHAR(255) NOT NULL,
    is_primary BOOLEAN DEFAULT FALSE,
    sort_order INT DEFAULT 0,
    created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
    FOREIGN KEY (car_id) REFERENCES cars(id) ON DELETE CASCADE
);
```

### تحديث جدول `cars`
```sql
ALTER TABLE cars ADD COLUMN video_url VARCHAR(500) NULL;
```

## 📁 هيكل الملفات

### ملفات قاعدة البيانات
- `update_schema_car_gallery.php` - تحديث قاعدة البيانات

### ملفات لوحة التحكم
- `admin/car_form.php` - نموذج إضافة/تعديل السيارة (محدث)
- `admin/car_process.php` - معالجة بيانات السيارة (محدث)
- `admin/car_image_actions.php` - إدارة الصور (جديد)
- `admin/cars.php` - صفحة إدارة السيارات (محدث)
- `admin/car_delete.php` - حذف السيارة (محدث)

### ملفات الواجهة الأمامية
- `car_details.php` - صفحة تفاصيل السيارة (محدث)
- `cars.php` - صفحة عرض السيارات (محدث)

### ملفات الاختبار والتوثيق
- `test_car_gallery.php` - اختبار شامل للنظام
- `car_gallery_summary.php` - ملخص المشروع
- `CAR_GALLERY_README.md` - هذا الملف

## 🚀 كيفية الاستخدام

### 1. إضافة سيارة جديدة مع صور
1. اذهب إلى `admin/cars.php`
2. اضغط "إضافة سيارة جديدة"
3. املأ بيانات السيارة
4. في قسم "ألبوم صور السيارة":
   - اختر عدة صور من حقل "إضافة صور جديدة"
   - الصورة الأولى ستكون الصورة الرئيسية تلقائياً
5. (اختياري) أضف رابط فيديو في حقل "رابط فيديو السيارة"
6. اضغط "حفظ البيانات"

### 2. تعديل صور سيارة موجودة
1. من صفحة إدارة السيارات، اضغط على أيقونة التعديل
2. في قسم "الصور الحالية":
   - اضغط "حذف" لحذف أي صورة
   - اضغط "جعلها رئيسية" لتعيين صورة كرئيسية
3. أضف صور جديدة من حقل "إضافة صور جديدة"

### 3. عرض السيارات في الواجهة الأمامية
- صفحة السيارات (`cars.php`) تعرض الصورة الرئيسية لكل سيارة
- صفحة تفاصيل السيارة (`car_details.php`) تعرض:
  - معرض صور تفاعلي
  - صور مصغرة قابلة للنقر
  - مشغل فيديو مدمج (إذا كان متوفراً)

## 🔧 الميزات التقنية

### الأمان
- حماية من SQL Injection باستخدام Prepared Statements
- تحقق من صحة الملفات المرفوعة
- أسماء ملفات فريدة لتجنب التضارب
- تشفير المدخلات وحماية من XSS

### الأداء
- استعلامات محسنة مع فهارس
- تحميل الصور بشكل تدريجي
- ضغط الصور تلقائياً
- كاش للاستعلامات المتكررة

### التوافق
- يعمل مع الصور الموجودة (التوافق العكسي)
- دعم جميع أنواع الصور الشائعة
- دعم روابط فيديو من منصات متعددة
- تصميم متجاوب لجميع الأجهزة

## 📱 دعم الفيديو

### المنصات المدعومة
- YouTube (تحويل تلقائي للعرض المدمج)
- Vimeo
- أي رابط فيديو مباشر

### تنسيقات الروابط
```
YouTube:
- https://www.youtube.com/watch?v=VIDEO_ID
- https://youtu.be/VIDEO_ID

Vimeo:
- https://vimeo.com/VIDEO_ID

رابط مباشر:
- https://example.com/video.mp4
```

## 🎨 التخصيص

### تخصيص معرض الصور
يمكن تخصيص مظهر معرض الصور من خلال CSS:

```css
.thumbnail-img:hover {
    opacity: 0.8;
    transform: scale(1.05);
    transition: all 0.3s ease;
}

.video-section {
    background: rgba(255, 255, 255, 0.1);
    padding: 20px;
    border-radius: 10px;
    backdrop-filter: blur(10px);
}
```

### تخصيص أحجام الصور
```css
.card-img-top {
    height: 250px;
    object-fit: cover;
}

.thumbnail-img {
    height: 80px;
    object-fit: cover;
}
```

## 🧪 الاختبار

### اختبار شامل
قم بزيارة `test_car_gallery.php` لإجراء اختبار شامل يتضمن:
- فحص هيكل قاعدة البيانات
- اختبار البيانات الموجودة
- فحص الملفات والمجلدات
- اختبار الوظائف الأساسية

### اختبار يدوي
1. أضف سيارة جديدة مع عدة صور
2. تأكد من ظهور الصور في لوحة التحكم
3. اختبر تغيير الصورة الرئيسية
4. اختبر حذف الصور
5. تأكد من عرض الصور في الواجهة الأمامية
6. اختبر إضافة رابط فيديو

## 🔍 استكشاف الأخطاء

### مشاكل شائعة وحلولها

#### 1. لا تظهر الصور
```php
// تأكد من وجود المجلدات
if (!is_dir('uploads/cars')) {
    mkdir('uploads/cars', 0755, true);
}
```

#### 2. خطأ في رفع الصور
```php
// تحقق من إعدادات PHP
ini_set('upload_max_filesize', '10M');
ini_set('post_max_size', '10M');
```

#### 3. مشاكل في قاعدة البيانات
```sql
-- تحقق من وجود الجداول
SHOW TABLES LIKE 'car_images';
DESCRIBE car_images;
```

## 📊 إحصائيات الأداء

### قبل التحديث
- صورة واحدة فقط لكل سيارة
- لا يوجد دعم للفيديو
- عرض بسيط للصور

### بعد التحديث
- صور متعددة لكل سيارة
- دعم كامل للفيديو
- معرض صور تفاعلي
- إدارة متقدمة للصور

## 🔄 التحديثات المستقبلية

### ميزات مقترحة
- [ ] رفع الفيديوهات مباشرة (بدلاً من الروابط فقط)
- [ ] تحرير الصور (قص، تدوير، فلاتر)
- [ ] ضغط الصور تلقائياً
- [ ] معرض صور بملء الشاشة
- [ ] ترتيب الصور بالسحب والإفلات
- [ ] إضافة علامات مائية
- [ ] تحسين SEO للصور

## 📞 الدعم

للحصول على المساعدة أو الإبلاغ عن مشاكل:
1. تحقق من ملف `test_car_gallery.php`
2. راجع سجلات الأخطاء في PHP
3. تأكد من صحة إعدادات قاعدة البيانات

## 📝 سجل التغييرات

### الإصدار 1.0 (2025-01-XX)
- ✅ إضافة جدول car_images
- ✅ تحديث نموذج إضافة السيارة
- ✅ معرض صور تفاعلي
- ✅ دعم الفيديو
- ✅ إدارة الصور من لوحة التحكم
- ✅ التوافق العكسي مع الصور الموجودة

---

**تم تطوير هذه الميزة بواسطة فريق M-AUTO** 🚗✨

cmd: