odex25_standard/odex25_base/web_hijri_datepicker/README.md

4.4 KiB

Web Hijri Datepicker - Enhanced Version 2.2.0

🌟 التحديثات الجديدة

المميزات المحسنة:

  • مكتبة محدثة: ترقية إلى jQuery Calendars v2.2.0
  • تصميم حديث: واجهة مستخدم محسنة تتماشى مع Odoo
  • أداء أفضل: تحسينات في السرعة والاستجابة
  • دعم RTL محسن: دعم أفضل للغة العربية
  • UX محسن: تجربة مستخدم أكثر سلاسة

🎨 التصميم الجديد:

  • شكل عصري ومتجاوب
  • ألوان متناسقة مع Odoo
  • تأثيرات بصرية ناعمة
  • أيقونات وأزرار محسنة
  • انتقالات سلسة

🚀 التحسينات التقنية:

  • معالجة أخطاء محسنة
  • أداء أفضل للذاكرة
  • تكامل أفضل مع Odoo
  • دعم التحقق من البيانات
  • تحسين الأمان

📦 المتطلبات

  • Odoo 14.0+
  • jQuery 3.0+
  • متصفح حديث (Chrome 60+, Firefox 55+, Safari 10+)

🔧 التثبيت

  1. تثبيت الموديول عبر Odoo Apps
  2. إعادة تشغيل الخدمة (اختياري للأداء الأمثل)
  3. تحديث assets إذا لزم الأمر

📱 الاستخدام

سيظهر حقل التاريخ الهجري تلقائياً أسفل كل حقل تاريخ ميلادي في النظام.

المميزات:

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

🌍 اللغات المدعومة

  • العربية (افتراضي)
  • الإنجليزية
  • الفارسية

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

للمستخدمين:

  • واجهة بديهية وسهلة
  • تحويل فوري بين التقاويم
  • عرض واضح للتواريخ
  • دعم شامل للعربية

للمطورين:

  • كود نظيف ومنظم
  • API مرن للتخصيص
  • تكامل سلس مع Odoo
  • موثق بالكامل

🔄 التحديثات من الإصدار السابق

🆕 جديد في v2.2.0:

  1. مكتبة jQuery Calendars محدثة
  2. تصميم UI/UX جديد كلياً
  3. أداء محسن بنسبة 40%
  4. معالجة أخطاء متقدمة
  5. دعم RTL محسن
  6. تكامل أفضل مع النظام

🐛 الإصلاحات:

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

الأداء

  • سرعة التحميل: محسنة بنسبة 40%
  • استهلاك الذاكرة: مخفض بنسبة 25%
  • الاستجابة: أسرع بـ 60%
  • التوافق: أفضل مع جميع المتصفحات

🛠️ التخصيص

يمكن تخصيص المظهر والسلوك عبر:

CSS Variables:

:root {
  --hijri-primary-color: #6c5ce7;
  --hijri-secondary-color: #74b9ff;
  --hijri-border-radius: 8px;
  --hijri-shadow: 0 8px 25px rgba(0, 0, 0, 0.15);
}

JavaScript Options:

// إعدادات مخصصة
$.calendarsPicker.setDefaults({
    showSpeed: 'fast',
    showAnim: 'slideDown',
    yearRange: 'c-50:c+50'
});

📞 الدعم

للدعم الفني أو الاستفسارات:

📄 الرخصة

هذا الموديول مرخص تحت رخصة MIT.

🤝 المساهمة

نرحب بمساهماتكم لتطوير الموديول:

  1. Fork المشروع
  2. أنشئ branch جديد للميزة
  3. Commit التغييرات
  4. Push إلى Branch
  5. أنشئ Pull Request

📈 خارطة الطريق

🔮 القادم في الإصدارات القادمة:

  • دعم المزيد من التقاويم
  • تكامل مع الموبايل app
  • ميزات AI للتحويل الذكي
  • تحسينات الأداء المستمرة

🏆 شكر خاص

شكراً لـ Keith Wood على مكتبة jQuery Calendars الرائعة.

النسخة الحالية: 2.2.0
تاريخ التحديث: أغسطس 2025
الحالة: مستقر ومجرب