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

مقدمة

استرجع أنواع الكيانات على مستوى النظام التي تصنف صفحاتك، ونماذجك، وكتل المحتوى، ومنتجاتك.

مزيد من المعلومات حول واجهة مستخدم الوحدة: https://doc.oneentry.cloud/docs/attributes/types/#General-Type-Attributes

🎯 ماذا تفعل هذه الوحدة؟​

تتيح لك وحدة GeneralTypes استرجاع أنواع الكيانات على مستوى النظام - أنواع الصفحات، وأنواع النماذج، وأنواع الكتل، وأنواع المنتجات - التي تحدد فئات المحتوى في مشروع OneEntry الخاص بك. يستخدم OneEntry مجموعة ثابتة من الأنواع النظامية (BlockType) لتصنيف الصفحات (common_page, catalog_page, external_page, error_page)، والنماذج (form)، والكتل (common_block, product_block, slider_block, …)، والمنتجات (product, service). هذه الوحدة هي للقراءة فقط.

🚀 بدء سريع​

قم بتهيئة الوحدة من defineOneEntry:


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

استرجع جميع الأنواع واستخدمها:

// Returns a combined list of types across all entities.
const types = await GeneralTypes.getAllTypes();
// e.g. [{ id: 1, type: "product" }, { id: 2, type: "common_page" }, ...]

// Filter manually - there is no built-in per-entity filter.
const pageTypes = types.filter((t) => t.type.endsWith("_page"));

console.log(pageTypes);

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

نظام الأنواع​

يصنف OneEntry كل كيان بواسطة قيمة BlockType:

الكيانأمثلة على الأنواع (BlockType)الغرض
الصفحاتcommon_page, catalog_page, external_page, error_pageتحديد تخطيطات الصفحات والوظائف
النماذجformتصنيف أغراض النماذج
الكتلcommon_block, product_block, slider_blockكتل بناء للصفحات/المنتجات
المنتجاتproduct, serviceتصنيف مخزون المنتجات

هيكل كيان النوع​

كل نوع يتم إرجاعه بواسطة getAllTypes() هو GeneralTypeEntity:

interface GeneralTypeEntity {
  id: number;        // Unique numeric ID (e.g. 1, 2, 3)
  type: BlockType;   // Type name (e.g. "product", "common_page", "form")
}

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

الأنواع هي فئات نظام محددة مسبقًا​

لا يمكنك إنشاء أنواع عبر SDK - فهي مجموعة ثابتة من فئات النظام (BlockType) التي تحددها المنصة. تقوم GeneralTypes فقط باسترجاع قائمة الأنواع الموجودة في مشروعك. تتم إدارة جميع الأنواع في لوحة إدارة OneEntry.

getAllTypes() ترجع جميع الأنواع عبر جميع الكيانات​

ترجع الطريقة قائمة مجمعة من الأنواع من الصفحات، والنماذج، والكتل، والمنتجات، وأي كيانات أخرى. لا يوجد تصفية مدمجة حسب فئة الكيان، لذا قم بتصفية النتيجة يدويًا (على سبيل المثال، t.type.endsWith('_page')).

النوع مقابل العلامة مقابل المعرف​

المعرفما هومثالالأفضل للاستخدام
النوعفئة/تصنيف الكيان"catalog_page"التصفية والتجميع
العلامةمعرف فريد قابل للقراءة البشرية"my_about_page"استرجاع كيانات محددة
المعرفمعرف رقمي في قاعدة البيانات42للاستخدام الداخلي

استخدم سلسلة type في منطق الكود الخاص بك (على سبيل المثال، if (page.type === 'catalog_page')) - فهي مستقرة عبر البيئات، بينما يمكن أن يختلف id.

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

الطريقةالوصفحالة الاستخدام
getAllTypes()يسترجع جميع الأنواع العامة في النظامملء القوائم المنسدلة، التحقق من الأنواع

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

كيف يمكنني إنشاء أنواع جديدة؟​

لا يمكنك - الأنواع هي مجموعة ثابتة من فئات النظام (BlockType) والوحدة للقراءة فقط. استرجع الأنواع المتاحة في مشروعك باستخدام getAllTypes().

كيف يمكنني تصفية الأنواع حسب الكيان (الصفحات، النماذج، المنتجات)؟​

ترجع getAllTypes() جميع الأنواع عبر جميع الكيانات. قم بتصفية النتيجة يدويًا، على سبيل المثال types.filter(t => t.type.endsWith('_page')).

هل يمكنني تحديث أو حذف الأنواع عبر SDK؟​

لا. وحدة GeneralTypes هي للقراءة فقط - تتم إدارة جميع الأنواع في لوحة إدارة OneEntry.

ما الفرق بين معرف النوع واسم النوع؟​

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

هل يمكنني تخزين قائمة الأنواع في الذاكرة المؤقتة؟​

نعم - الأنواع نادرًا ما تتغير، لذا يُوصى بالتخزين المؤقت.

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

  • استرجع الأنواع ديناميكيًا - لا تقم بتشفير قوائم الأنواع.
  • استخدم سلسلة type، وليس id - أسماء الأنواع مستقرة عبر البيئات.
  • قم بالتصفية يدويًا - ترجع getAllTypes() أنواع كل كيان في قائمة واحدة.
  • قم بتخزين القائمة في الذاكرة المؤقتة - نادرًا ما تتغير.
  • تعامل مع الأنواع غير المعروفة بشكل جيد - قدم عرضًا احتياطيًا.

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