الكائنات الوصفية
إذا كانت بياناتك يتم تمثيلها بشكل أفضل بواسطة حقول متعددة، فيمكنك استخدام كائن وصفي لإنشاء كائن بحقول متعددة. يمكن الإشارة إلى كائنك الوصفي من خلال حقول وصفية أو يمكن استخدامه بشكل مستقل.
لماذا تُستخدم الكائنات الوصفية
ضع في اعتبارك هذه الأمثلة لاستخدام الكائنات الوصفية في متجرك:
- إذا كنت تريد إبراز الميزات الرئيسية لمنتجاتك، فيمكنك إنشاء كائن وصفي يُسمى تمييز المنتج. يمكنك بعد ذلك تضمين حقول للأيقونة والعنوان والوصف، وعرض مجموعة فريدة من الميزات البارزة لكل منتج في قالبك.
- إذا كان لديك متجر لمنتجات التجميل والعناية بالبشرة وترغب في جمع معلومات حول أبرز المؤثرين لديك وعرضها، فيمكنك إنشاء كائن وصفي باسم ملف تعريف المؤثر. يمكنك بعد ذلك تضمين حقول للعنوان، والصورة، والوصف، ورابط الملف الشخصي، وإنشاء إدخال لكل مؤثر. يمكنك عرض الكائن الوصفي لملف تعريف المؤثر في قالبك، أو استخدامه في مسؤول Shopify.
- إذا كنت ترغب في معالجة الأسئلة الشائعة حول منتجاتك أو سياساتك، فيمكنك إنشاء كائن وصفي باسم الأسئلة الشائعة. يمكنك بعد ذلك تضمين حقول للسؤال والإجابة، وإنشاء إدخال لكل سؤال شائع، وعرضها في قسم مخصص ضمن قالبك.
- إذا كنت تشارك في معارض تجارية أو فعاليات مباشرة وترغب في عرض سِجل فعالياتك، فيمكنك إنشاء كائن وصفي باسم حضور الفعالية. يمكنك بعد ذلك تضمين حقول لاسم الفعالية، والموقع، والسنة، والوصف، وإنشاء إدخال لكل فعالية. يمكنك عرض سِجل فعالياتك على واجهة المتجر لتبين للعملاء والمنظمين أن لديك خبرة واسعة النطاق.
كيفية استخدام الكائنات الوصفية
يمكنك استرداد وتعديل البيانات المخزنة في الكائنات الوصفية من مسؤول Shopify. يمكن للتطبيقات الوصول إلى الكائنات الوصفية من خلال واجهة برمجة تطبيقات الكائن الوصفي (metaobject API). يمكنك أيضًا الوصول إلى الكائنات الوصفية في القوالب باستخدام Liquid ومن خلال Storefront API. تعرّف على المزيد حول واجهة برمجة تطبيقات الكائن الوصفي (metaobject API).
يوجد مكوّنان رئيسيان للكائنات الوصفية:
- التعريف: مجموعة الحقول التي تحدد بنية الكائن. تتم إدارة ذلك بالانتقال إلى الإعدادات > بيانات مخصصة في مسؤول Shopify.
- الإدخالات: المحتوى أو البيانات الخاصة بالكائن الوصفي. يتم إنشاء الإدخالات وإدارتها بالانتقال إلى المحتوى > الكائنات الوصفية في مسؤول Shopify.
عند إنشاء تعريف كائن وصفي، فإنك تحدد المعلومات التالية:
- الاسم: يُستخدم لتعريف الكائن الوصفي في مسؤول Shopify، مثل
Authors(المؤلفون). - النوع: معرّف فريد للكائن الوصفي، يتم إنشاؤه تلقائيًا من الاسم. يمكنك تعديل معرّف النوع قبل الحفظ.
- الحقول: تحدد المحتوى الذي ترغب في تخزينه في الكائن الوصفي.
- يحتوي كل حقل على اسم (مطلوب)، ووصف، ونوع. يمكنك تحديد نوع الحقل من قائمة قابلة للبحث تضم فئات وإعدادات مسبقة، مثل نص، أو ملف، أو رابط URL.
- اختياري: يمكنك إضافة قواعد تحقق، مثل حدود الأحرف، أو القيم الدنيا والقصوى، أو القيم المحددة مسبقًا.
- يتم تعيين اسم العرض لاسم حقل واحد ويُستخدم لتعريف إدخال كائن وصفي فردي. يمكنك تغيير الحقل المعيّن له اسم العرض في أي وقت. يتم تعيين اسم العرض تلقائيًا لأول حقل نصي في إدخال الكائن الوصفي، أو يتم إنشاؤه تلقائيًا إذا لم تكن هناك حقول نصية في تعريف الكائن الوصفي.
- على سبيل المثال، يمكنك إضافة حقل للنص وتحديده كاسم عرض، وحقل لصورة، وحقل للون.
- الخيارات: حيث يتوفر الكائن الوصفي للاستخدام. تعرّف على المزيد حول خيارات البيانات المخصصة.
تحدد الحقول في تعريف الكائن الوصفي الخاص بك الحقول في إدخالات الكائن الوصفي. على سبيل المثال، إذا قمت بإنشاء كائن وصفي لملفات تعريف برنامج السفراء يتضمن حقولاً للاسم، والسيرة الذاتية، والصورة، فستحتوي إدخالات الكائن الوصفي الخاص بك على حقل لإدخال الاسم، والسيرة الذاتية، ورفع صورة. سيكون كل إدخال في هذا المثال عبارة عن ملف تعريف واحد لبرنامج السفراء.
يستخدم التصنيف القياسي للمنتجات من Shopify والفئات القياسية الكائنات الوصفية. عند إضافة فئة منتج إلى منتج ما، يمكنك إضافة حقول وصفية للفئة خاصة بذلك المنتج. يحتوي كل حقل وصفي للفئة على إدخالات افتراضية، والتي يتم بناؤها باستخدام تعريفات الكائنات الوصفية. على سبيل المثال، إذا أضفت فئة المنتج الملابس والإكسسوارات > الملابس > قطع الملابس العلوية > القمصان، فيمكنك إضافة حقول وصفية للفئة تخص المقاس، وخط العنق، ونوع طول الكم، ونوع طول القطعة العلوية، والفئة العمرية، والقماش، والجنس المستهدف، وميزات الملابس، واللون.