المقدمة

اقرأ مجموعات المستخدمين لمشروعك: القائمة المسطحة، المستوى الأعلى، مجموعة واحدة، أو الأطفال من واحدة.

مزيد من المعلومات حول واجهة مستخدم الوحدة https://doc.oneentry.cloud/docs/category/users

---

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

تتيح لك وحدة UserGroups قراءة المجموعات التي ينتمي إليها زوارك. تحدد المجموعة ما يمكن أن يراه الزائر، وتشكّل المجموعات شجرة — يمكن أن يكون للمجموعة والد وأطفال.

تُنشأ المجموعات وتُعشّش في لوحة تحكم إدارة OneEntry؛ الـ SDK للقراءة فقط ويقوم فقط بجلب المجموعات. يحتوي كل مشروع على الأقل على مجموعة الضيوف، وهي المكان الذي يصل إليه الزائر غير المصرح له.

🚀 البدء السريع

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

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

اقرأ القائمة الكاملة، أو ابدأ من أعلى الشجرة:

// Every group, flat, regardless of nesting.
const groups = await UserGroups.getUserGroups();

// Only the groups without a parent.
const roots = await UserGroups.getRootUserGroups();

roots.forEach((group) => {
  console.log(group.identifier, group.localizeInfos.title);
});

🌳 التنقل في الشجرة

اقرأ أطفال مجموعة بواسطة علامة الوالد، وليس بواسطة parentId:

const children = await UserGroups.getChildUserGroupsByMarker('guest');

تُرجع المجموعة التي ليس لها أطفال مصفوفة فارغة.

⚠️ childrenCount هو سلسلة نصية

ترسل واجهة برمجة التطبيقات childrenCount كسلسلة نصية، وليس كرقم:

{ "identifier": "guest", "childrenCount": "0" }

قارنها كسلسلة نصية، أو قم بتحويلها بنفسك:

if (Number(group.childrenCount) > 0) {
  const children = await UserGroups.getChildUserGroupsByMarker(group.identifier);
}

📋 الطرق

الطريقة	ما تعيده
getUserGroups()	كل مجموعة كمصفوفة مسطحة
getRootUserGroups()	مجموعات بدون والد
getUserGroupById(id)	مجموعة واحدة بواسطة معرفها
getUserGroupByMarker(marker)	مجموعة واحدة بواسطة علامتها
getChildUserGroupsByMarker(marker)	أطفال المجموعة المعطاة