مقدمة

السمات كيان يتيح لك ضبط هيكل تطبيقك. وبها تحصل على أقصى قدر من المرونة وتستغني عن الكود الثابت.

مجموعات السمات أشبه بمجموعة من الخصائص تتحكم في قيمها من لوحة الإدارة. وتختلف المجموعات في نوع ربطها بالكيانات المختلفة. تفاصيل الأنواع في قسم "الأنواع". (يفتح في علامة تبويب جديدة)

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

قد تتشابه بعض السمات في هيكلها وتُستخدم في كيانات مختلفة، لذلك يمكنك إعادة استخدام مجموعات السمات لكيانات مختلفة.

الهيكل

تضم كل مجموعة سمات مجموعة قابلة للتخصيص من السمات التي تخزّن محتوى مشروعك. ويمكنك إدارة هذه السمات من نظام الإدارة، فلا تحتاج بعد الآن إلى تعديل كود التطبيق لتغيير مشروعك. انقل إلى السمات كل مكونات المحتوى القابلة للتغيير.

العلامات

لا يجوز أن تحتوي العلامات على مسافات أو أن تبدأ برقم. إذا حاولت إدخال قيمة غير صحيحة في حقل العلامة، يتجاهل النظام الإدخال.

الاسم

لتسهيل التنقل، لكل سمة معلمة اسم إلزامية، وهي سلسلة نصية غير فريدة. سمِّ السمات بما يسهّل عليك العمل بها.

العلامة

لكل سمة معلمة إلزامية تعمل كمعرّف، هي "العلامة"، وهي سلسلة نصية فريدة. وتُستخدم العلامة أيضًا مفتاحًا للوصول إلى السمات في كود مشروعك. فراعِ ذلك عند تعيين علامة السمة حتى لا تقع في تعارضات في الصياغة النحوية.

نوع البيانات

اختر لكل حقل سمة نوع البيانات الذي سيخزّنه.

أنواع البيانات المتاحة:

• سلسلة (String): نص بسيط، مثل "مرحبًا بالعالم!".
• نص (Text): نص أطول، غالبًا ما يكون منسقًا، مثل مقالة أو رسالة.
• نص مع عنوان (Text with header): نص له عنوان، يمكن استخدامه للإشارة إلى موضوع أو فئة.
• عدد صحيح (Integer): عدد صحيح، مثل 5 أو 100 أو -2.
• عدد حقيقي (Real): مثل Float، لكن بدقة أعلى.
• عدد عشري (Float): نوع بيانات للأعداد ذات الفاصلة العائمة التي قد يكون لها جزء عشري، مثل 3.14 أو 1.5 أو -0.25.
• تاريخ ووقت (Date and Time): تاريخ ووقت معًا، مثل 2023-10-27 10:00:00.
• تاريخ (Date): تاريخ، مثل 2023-10-27.
• وقت (Time): وقت، مثل 10:00:00.
• ملف (File): أي ملف على جهازك، مثل مستند أو صورة أو ملف صوتي.
• صورة (Image): صورة، مثل صورة فوتوغرافية أو رسم.
• مجموعة صور (Group of Images): مجموعة من الصور، مثل ألبوم صور.
• زر اختيار (Radio Button): زر اختيار لا يمكن تحديد سوى خيار واحد منه.
• قائمة (List): قائمة عناصر، مثل قائمة مقاسات المنتجات.
• حماية من البريد العشوائي (Spam Protection): كابتشا تحمي النموذج من الإرسال التلقائي.
• زر (Button): زر بقيمة محددة.
• كيان (Entity): كيان يمثل شيئًا من العالم الحقيقي، مثل شخص أو مكان أو مؤسسة.
• فترة زمنية (Time interval): تقويم لإنشاء الفترات الزمنية وجدولتها وإدارتها.
• JSON: يخزّن البيانات بتنسيق JSON.

تفاصيل كل نوع في قسم "الأنواع". (يفتح في علامة تبويب جديدة)

تتوافق واجهة ملء المحتوى مع نوع البيانات المختار لكل حقل سمة.

مجموعة السمات النظامية

يمكن إنشاء مجموعة سمات نظامية منفصلة. لا ترتبط هذه المجموعة بأي مجموعة (collection)، وتتيح تخزين بيانات عشوائية بداخلها. لملء مجموعة السمات النظامية، انتقل إلى صفحة تحرير المجموعة.

الإمكانات

يمكنك إضافة مدققين إلى السمات. تفاصيل هذه الآلية في قسم "Validators". (يفتح في علامة تبويب جديدة)

السمات

إذا كانت عدة كيانات تستخدم مجموعة السمات نفسها، فكن حذرًا عند تغيير سمات هذه المجموعة. فإذا حذفت إحدى السمات، تُحذف هذه السمة مع محتواها في كل مكان تُستخدم فيه. وإذا أضفت سمة جديدة إلى المجموعة، تُضاف هذه السمة أيضًا في كل مكان تُستخدم فيه مجموعة السمات هذه.