ثيم نور (Noor Theme) - ثيم احترافي لمنصة سلة

📋 نظرة عامة

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

✨ المميزات الرئيسية

🎨 التصميم والهوية البصرية

• ألوان متناسقة: نظام ألوان احترافي (أساسي: #3A6B83، ثانوي: #F5F5F0، تميز: #E8B856)
• خطوط عربية جميلة: دعم خطوط Tajawal, Cairo, Inter
• أوضاع ألوان متعددة: فاتح، داكن، تلقائي
• تصميم متجاوب: يعمل بشكل مثالي على جميع الأجهزة

🛍️ ميزات التسوق

• صفحة رئيسية متكاملة: بانر ترحيبي + 3 بنرات تسويقية + منتجات مختارة
• صفحة منتج متقدمة: معرض صور + خيارات + تقييمات + مشاركة اجتماعية
• صفحة فئات محسنة: فلاتر متقدمة + ترتيب + عرض شبكي/قائمة
• صفحة هبوط للعروض: مع عداد تنازلي ومؤشرات ثقة

🚀 الأداء والتحسين

• تحميل كسول للصور: تحسين سرعة التحميل
• محسن لمحركات البحث: بيانات منظمة وmeta tags
• ضغط الملفات: CSS وJS محسنة
• كاش ذكي: تحسين الأداء

🛒 ميزات التجارة الإلكترونية

• سلة تسوق ذكية: حفظ محلي + إشعارات
• قائمة المفضلة: إدارة سهلة للمنتجات المفضلة
• بحث متقدم: مع اقتراحات تلقائية
• مشاركة اجتماعية: WhatsApp, Twitter, Facebook

🌙 ميزات متقدمة

• الوضع الليلي: تبديل تلقائي أو يدوي
• تعدد اللغات: عربي وإنجليزي
• إشعارات ذكية: تأكيدات الإجراءات
• تحليلات مدمجة: تتبع سلوك المستخدمين

📁 هيكل المشروع

noor-theme/
├── assets/                 # الملفات الثابتة
│   ├── style.css          # ملف الأنماط الرئيسي
│   ├── main.js            # ملف JavaScript الرئيسي
│   ├── banners/           # صور البنرات
│   ├── products/          # صور المنتجات
│   ├── logos/             # الشعارات والأيقونات
│   └── fonts/             # الخطوط
├── templates/             # قوالب Twig
│   ├── home.twig          # الصفحة الرئيسية
│   ├── product.twig       # صفحة المنتج
│   ├── category.twig      # صفحة الفئة
│   └── landing.twig       # صفحة الهبوط
├── locales/               # ملفات الترجمة
│   ├── ar.json            # الترجمة العربية
│   └── en.json            # الترجمة الإنجليزية
├── twilight.json          # إعدادات الثيم
├── preview.json           # معلومات المعاينة
├── salla-theme.config     # ملف التكوين
└── README.md              # هذا الملف

🚀 التركيب والاستخدام

المتطلبات الأساسية

• حساب على منصة سلة
• Salla CLI مثبت على جهازك
• Node.js (الإصدار 14 أو أحدث)

خطوات التركيب

1. تسجيل الدخول إلى Salla CLI

salla theme login

2. تنزيل الثيم

git clone https://github.com/your-repo/noor-theme.git
cd noor-theme

3. تهيئة المشروع

salla theme init

4. رفع الثيم

salla theme upload

5. معاينة الثيم

salla theme serve

تخصيص الثيم

تعديل الألوان

قم بتعديل الألوان في ملف twilight.json:

{
  "settings": {
    "colors": {
      "primary": {
        "default": "#3A6B83"
      },
      "secondary": {
        "default": "#F5F5F0"
      }
    }
  }
}

تخصيص المحتوى

• النصوص: عدّل ملفات الترجمة في مجلد locales/
• الصور: استبدل الصور في مجلد assets/
• القوالب: عدّل ملفات .twig في مجلد templates/

إضافة ميزات جديدة

// في ملف assets/main.js
window.NoorTheme.cartManager.addItem(product, quantity);
window.NoorTheme.wishlistManager.toggleItem(product);
window.NoorTheme.notificationManager.show(message, type);

🎨 دليل التخصيص

الألوان المتاحة

:root {
  --primary-color: #3A6B83;     /* اللون الأساسي */
  --secondary-color: #F5F5F0;   /* اللون الثانوي */
  --accent-color: #E8B856;      /* لون التمييز */
  --text-color: #333333;        /* لون النص */
  --background-color: #FFFFFF;  /* لون الخلفية */
}

الخطوط المدعومة

• Tajawal: الخط الافتراضي العربي
• Cairo: خط عربي بديل
• Inter: خط إنجليزي حديث
• Almarai: خط عربي أنيق
• Amiri: خط عربي تقليدي

أحجام الشاشات

• Mobile: أقل من 768px
• Tablet: 768px - 1024px
• Desktop: أكبر من 1024px

📱 الاستجابة والتوافق

المتصفحات المدعومة

• ✅ Chrome (الإصدار 70+)
• ✅ Firefox (الإصدار 65+)
• ✅ Safari (الإصدار 12+)
• ✅ Edge (الإصدار 79+)
• ✅ Opera (الإصدار 56+)

الأجهزة المدعومة

• 📱 الهواتف الذكية (iOS & Android)
• 📟 الأجهزة اللوحية
• 💻 أجهزة الكمبيوتر المحمولة
• 🖥️ أجهزة سطح المكتب

🔧 إعدادات الثيم

الإعدادات الأساسية

من لوحة تحكم سلة، يمكنك تخصيص:

الألوان والخطوط

• اللون الأساسي والثانوي
• نوع الخط وحجمه
• نمط الألوان (فاتح/داكن/تلقائي)

تخطيط الصفحة

• نمط الهيدر
• عدد المنتجات في الصف
• إظهار/إخفاء العناصر

المحتوى

• نصوص البانر الرئيسي
• عناوين البنرات التسويقية
• نصوص المميزات

إعدادات متقدمة

// تخصيص إعدادات الثيم
window.NoorTheme.CONFIG = {
  animationDuration: 300,
  debounceDelay: 250,
  lazyLoadOffset: 100,
  cartUpdateDelay: 1500
};

📊 الأداء والتحليلات

مقاييس الأداء

• سرعة التحميل: أقل من 3 ثوان
• نتيجة Lighthouse: 90+ في جميع المقاييس
• Core Web Vitals: ممتاز في جميع المؤشرات

التحليلات المدمجة

// تتبع الأحداث
NoorTheme.analytics.trackEvent('add_to_cart', {
  product_id: '123',
  product_name: 'عطر فاخر',
  price: 299
});

🛡️ الأمان والخصوصية

ميزات الأمان

• 🔒 تشفير SSL لجميع البيانات
• 🛡️ حماية من هجمات XSS
• 🔐 تخزين آمن للبيانات المحلية
• 🚫 حماية من البريد العشوائي

سياسة الخصوصية

• لا نجمع بيانات شخصية إضافية
• البيانات المحفوظة محلياً فقط
• التحليلات مجهولة المصدر

🐛 استكشاف الأخطاء

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

الثيم لا يظهر بشكل صحيح

# تأكد من رفع جميع الملفات
salla theme upload --force

# امسح الكاش
salla theme cache:clear

مشاكل الخطوط

/* تأكد من تحميل الخطوط */
@import url('https://fonts.googleapis.com/css2?family=Tajawal:wght@400;700&display=swap');

مشاكل JavaScript

// تأكد من تحميل الثيم
if (window.NoorTheme) {
  console.log('Noor Theme loaded successfully');
} else {
  console.error('Noor Theme failed to load');
}

🔄 التحديثات والصيانة

جدول التحديثات

• تحديثات أمنية: فورية
• إصلاح الأخطاء: أسبوعياً
• ميزات جديدة: شهرياً
• تحديثات كبرى: ربع سنوية

طريقة التحديث

# تحديث الثيم
git pull origin main
salla theme upload

💡 نصائح للاستخدام الأمثل

تحسين الأداء

1. ضغط الصور: استخدم تنسيقات WebP
2. تقليل الطلبات: ادمج ملفات CSS/JS
3. استخدام CDN: لملفات الخطوط والمكتبات
4. تفعيل الكاش: في إعدادات الخادم

تحسين التحويل

1. صور عالية الجودة: للمنتجات والبنرات
2. نصوص واضحة: أزرار CTA واضحة
3. تجربة مستخدم سلسة: تحميل سريع
4. ثقة العملاء: شهادات وضمانات

تحسين SEO

1. عناوين وصفية: لجميع الصفحات
2. وصف المنتجات: مفصل وفريد
3. البيانات المنظمة: JSON-LD
4. سرعة التحميل: أقل من 3 ثوان

📞 الدعم والمساعدة

طرق التواصل

• 📧 البريد الإلكتروني: support@noor-theme.com
• 💬 WhatsApp: +966500000000
• 📚 التوثيق: https://docs.noor-theme.com
• 🐛 الإبلاغ عن خطأ: https://github.com/noor-theme/issues

ساعات الدعم

• الأحد - الخميس: 9:00 ص - 6:00 م (GMT+3)
• الجمعة - السبت: 10:00 ص - 4:00 م (GMT+3)
• الدعم الطارئ: متوفر على مدار الساعة

📜 الترخيص

هذا الثيم محمي بحقوق الطبع والنشر ومرخص تحت:

• ✅ الاستخدام التجاري: مسموح
• ✅ التعديل: مسموح
• ❌ إعادة التوزيع: غير مسموح
• ❌ بيع الكود: غير مسموح

🙏 شكر وتقدير

نشكر جميع المساهمين في تطوير هذا الثيم:

• فريق التصميم
• مطوري الواجهة الأمامية
• فريق ضمان الجودة
• مختبري الثيم

---

ثيم نور - حيث تلتقي الفخامة بالتكنولوجيا ✨

تم تطويره بـ ❤️ خصيصاً لمنصة سلة