انتقل إلى المحتوى الرئيسي

المقدمة

🎯 ماذا يفعل هذا الموديل؟​

يمكن لموديل ProductStatuses تمكين شروط تصفية إضافية لعناصر الكتالوج بجانب الفلاتر المعتمدة على السمات الموجودة. يتيح لك Product Statuses إنشاء تسميات فريدة للمنتجات وفلاتر - مثل "وصول جديد"، "الأكثر مبيعًا"، "تخفيضات"، "غير متوفر" - لتنظيم وتصنيف المنتجات في كتالوج التجارة الإلكترونية الخاص بك.

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

فكر في الأمر كنظام لتصنيف المنتجات - تقوم بتعريف تسميات الحالة في لوحة إدارة OneEntry (الكتالوج > حالات المنتجات)، وتعيينها للمنتجات، واستخدامها لتصفية، ووضع شارات، وتصنيف المنتجات بشكل ديناميكي.

📖 شرح بسيط​

تحتاج كل متجر إلكتروني إلى تسليط الضوء على المنتجات الخاصة:

  • 🆕 وصول جديد - منتجات تمت إضافتها مؤخرًا
  • 🔥 الأكثر مبيعًا - عناصر شائعة
  • 💰 تخفيضات - منتجات مخفضة
  • ⭐ مميز - منتجات بارزة
  • 📦 غير متوفر - عناصر غير متاحة
  • 🎁 إصدار محدود - منتجات حصرية
  • 🚚 شحن مجاني - منتجات مع توصيل مجاني

المشكلات:

  • 🔒 غير مرن - يحتاج إلى تغييرات في الكود لإضافة حالات جديدة
  • 📊 صعب الإدارة - حقول منطقية متعددة
  • 🔄 لا إعادة استخدام - لا يمكن إعادة استخدام منطق الحالة
  • 🎨 غير متسق - أنماط شارات مختلفة في كل مكان

حل ProductStatuses:

الفوائد:

  • 🔒 مرن - إضافة/إزالة الحالات في لوحة الإدارة
  • 📊 سهل الإدارة - تعريفات حالة مركزية
  • 🔄 قابل لإعادة الاستخدام - نفس الحالة للعديد من المنتجات
  • 🎨 متسق - عرض شارات موحد

✨ المفاهيم الأساسية​

ما هي حالة المنتج؟​

حالة المنتج هي تسمية/علامة مخصصة للمنتجات:

  • اسم الحالة - اسم العرض (مثل "وصول جديد"، "تخفيضات")
  • علامة الحالة - معرف فريد للتصفية
  • لون/نمط - تمثيل بصري (يتم تكوينه في الإدارة)
  • ارتباط المنتج - أي المنتجات تحمل هذه الحالة
  • التصفية - استعلام عن المنتجات حسب الحالة

سير عمل حالة المنتج​

1. Create status in admin panel
   (e.g., "New Arrival")
   ↓
2. Assign status to products
   (Select products in admin)
   ↓
3. Fetch statuses via SDK
   (ProductStatuses.getProductStatuses())
   ↓
4. Display status badges on products
   (Render badges in product listings)
   ↓
5. Filter products by status
   (Products.getProducts({ statusId }))

لماذا تستخدم موديل ProductStatuses؟​

الفائدةالوصف
تصفية مرنةتصفية المنتجات حسب معايير مخصصة متعددة
شارات ديناميكيةعرض شارات بصرية دون ترميز ثابت
إدارة سهلةإضافة/إزالة الحالات في لوحة الإدارة
تسميات قابلة لإعادة الاستخدامتطبيق نفس الحالة على العديد من المنتجات
دعم متعدد اللغاتأسماء الحالات محلية حسب اللغة
تصميم مخصصتعريف الألوان والأنماط لكل حالة

📋 ما تحتاج إلى معرفته​

تُنشأ حالات المنتجات في لوحة الإدارة​

لا يمكنك إنشاء حالات عبر SDK - يتم إنشاؤها في لوحة إدارة OneEntry:

OneEntry Admin Panel → Catalog → Product Statuses → Create Status → Set Name/Marker → Save

عملية الإنشاء:

  • قدم اسمًا - تعيين الحالة (مطلوب)
  • قدم علامة - معرف فريد (مطلوب، أحرف وأرقام لاتينية/'_'/'-' فقط)
  • انقر على "إنشاء" لإنهاء العملية

قيود العلامة:

  • أحرف لاتينية فقط (a-z, A-Z)
  • أرقام (0-9)
  • الرموز (_) و(-)
  • لا يُسمح بأحرف خاصة أو مسافات

إدارة الحالة:

  • عرض القائمة - جدول مع أعمدة الاسم، العلامة، والإجراءات
  • تحرير الحالة - تعديل حقول الاسم والعلامة
  • حذف الحالة - إزالة الحالات غير المستخدمة
  • إعادة ترتيب - سحب وإفلات لتغيير ترتيب العرض (يؤثر على حقل sortOrder)

SDK مخصص لـ جلب الحالات وتصفية المنتجات، وليس لإنشاء الحالات.

تعيين الحالة​

تُعين الحالات للمنتجات في لوحة الإدارة:

OneEntry Admin Panel → Products → Edit Product → Assign Statuses → Save

في SDK: تحتوي المنتجات على مصفوفة statusIds مع معرفات الحالة المعينة:

const product = await Products.getProductById(123);
console.log(product.statusIds); // [1, 2] - Status IDs

التصفية حسب الحالة​

استخدم معرف الحالة لتصفية المنتجات

دعم متعدد اللغات​

تتم محلية أسماء الحالات تلقائيًا

💡 ملاحظات مهمة​

تُنشأ الحالات في لوحة الإدارة​

تذكر: SDK مخصص لـ جلب الحالات، وليس لإنشائها.

لإنشاء/تحرير الحالات: استخدم لوحة إدارة OneEntry.

واجهة قائمة الحالات​

تظهر لوحة الإدارة جميع الحالات في جدول مع ثلاثة أعمدة:

  • الاسم - تعيين الحالة
  • العلامة - معرف فريد
  • الإجراءات - عمليات التحرير والحذف، بالإضافة إلى إعادة ترتيب السحب والإفلات

التحقق من العلامة​

مهم: تساعد طريقة validateMarker() في التحقق مما إذا كانت العلامة موجودة بالفعل قبل إنشائها/استخدامها.

قيود العلامة:

  • أحرف أبجدية رقمية لاتينية فقط (a-z, A-Z, 0-9)
  • يُسمح بالرموز (_) و(-)
  • لا مسافات أو أحرف خاصة
  • يجب أن تكون فريدة عبر جميع الحالات

حالات متعددة لكل منتج​

يمكن أن تحتوي المنتجات على حالات متعددة في نفس الوقت (مثل "وصول جديد" + "تخفيضات")

الحالة مقابل السمات​

ProductStatuses تختلف عن سمات المنتج:

الميزةProductStatusesالسمات
الغرضتسميات/شارات/فلاترخصائص المنتج
أمثلة"جديد"، "تخفيضات"، "مميز"اللون، الحجم، المادة
قيم متعددةنعم (حالات متعددة)نعم (سمات متعددة)
التصفيةبسيطة (حسب معرف الحالة)معقدة (نطاقات، قيم)
حالة الاستخدامتسميات تسويقيةمواصفات المنتج

أفضل ممارسة: استخدم الحالات للتسميات التسويقية، والسمات لخصائص المنتج.

📊 جدول مرجعي سريع​

الطريقةالوصفحالة الاستخدام
getProductStatuses()الحصول على جميع حالات المنتجاتعرض جميع الحالات المتاحة
getProductsByStatusMarker()الحصول على حالة المنتج حسب العلامةجلب الحالة حسب المعرف
validateMarker()التحقق مما إذا كانت العلامة موجودةالتحقق من العلامة قبل الاستخدام

❓ الأسئلة الشائعة (FAQ)​

ما الفرق بين حالات المنتج وسمات المنتج؟​

حالات المنتج هي تسميات تسويقية (جديد، تخفيضات، مميز) للتصفية ووضع الشارات، بينما السمات هي مواصفات المنتج (اللون، الحجم، المادة). استخدم الحالات لعلامات الترويج والسمات لخصائص المنتج.

هل يمكن أن يحتوي المنتج على حالات متعددة في نفس الوقت؟​

نعم! يمكن أن تحتوي المنتجات على حالات متعددة في نفس الوقت. على سبيل المثال، يمكن أن يكون المنتج "وصول جديد" و"تخفيضات" في نفس الوقت. تحتوي مصفوفة statusIds في كائن المنتج على جميع معرفات الحالة المعينة.

كيف يمكنني تصفية المنتجات حسب الحالة؟​

استخدم طرق موديل المنتجات مع فلاتر الحالة. مرر معرف الحالة أو العلامة في استعلامك لجلب المنتجات ذات الحالات المحددة. يمكنك أيضًا دمج فلاتر حالات متعددة.

كيف يمكنني التحقق من علامة قبل إنشاء حالة؟​

استخدم طريقة validateMarker() للتحقق مما إذا كانت العلامة موجودة بالفعل. يساعد ذلك في منع العلامات المكررة ويضمن أن تتبع علامتك قواعد التسمية (أحرف لاتينية، أرقام، شرطة سفلية، شرطة فقط).

هل يمكنني تغيير ترتيب الحالات المعروضة؟​

نعم! في لوحة الإدارة، يمكنك سحب وإفلات الحالات لإعادة ترتيبها. يؤثر ذلك على حقل sortOrder ويحدد أولوية العرض في تطبيقك.

كيف يمكنني إضافة تصميم مخصص لشارات الحالة؟​

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

🎓 أفضل الممارسات​

  • استخدم علامات وصفية - new_arrival، وليس status1
  • حدد الألوان بشكل متسق - استخدم لوحة ألوان العلامة التجارية
  • حدد حالات نشطة - لا تفرط في إرباك المستخدمين بالعديد من الشارات
  • اجعل أسماء الحالات قصيرة - "تخفيضات" أفضل من "منتجات في التخفيضات"
  • استخدم الحالة للتصفية - اجعل الحالات قابلة للتصفية في واجهة المستخدم
  • قم بتخزين الحالات مؤقتًا - نادرًا ما تتغير، خزّنها لأداء أفضل
  • عرض حالات متعددة - عرض جميع الشارات ذات الصلة على المنتجات
  • استخدم الحالة للفرز - فرز حسب حالة "مميز" أولاً

مزيد من المعلومات حول حالات المنتجات في لوحة إدارة OneEntry: https://doc.oneentry.cloudhttps://doc.oneentry.cloud/docs/catalog/product-statuses/

تعريف موديل ProductStatuses​

يدير موديل ProductStatuses الحالات التي تعمل كفلاتر إضافية بجانب الشروط المحددة بواسطة السمات. تمكّن حالات المنتجات من إضافة شروط تصفية إضافية لعناصر الكتالوج في منصة OneEntry، وتعمل بالتزامن مع التصفية المعتمدة على السمات.


const { ProductStatuses } = defineOneEntry(
  "your-project-url", {
    "token": "your-app-token"
  }
);

🔗 الوثائق ذات الصلة​