تضمين الصفحات داخل الصفحة

Shayan Taslimتم التحديث

تعرض عمليات التضمين صفحات UserJot العامة ضمن تخطيطك، بدلاً من أداة عائمة. يمكنك تضمين لوحات الملاحظات وخارطة الطريق وسجل التغييرات ومركز المساعدة. أما واجهة الرسائل في «المحادثات» فتتوفر في الأداة فقط، ولا يمكن تضمينها.

الإعداد الأساسي

أضف عنصر حاوية إلى صفحتك:

HTML
<div data-userjot-embed style="height: 700px"></div>

بعد ذلك، ابدأ تشغيل SDK وثبّت التضمين:

JavaScript
uj.init('YOUR_PROJECT_ID', { widget: false });
uj.createEmbed();

يشغل التضمين كامل مساحة الحاوية، لذا حدّد ارتفاع الحاوية باستخدام CSS. يؤدي تمرير widget: false إلى إيقاف تشغيل الأداة العائمة، أو اتركها مفعّلة لاستخدامهما معًا.

الخيارات والمسارات المدعومة

JavaScript
uj.createEmbed({
  container: '#my-container', // CSS selector or DOM element, default '[data-userjot-embed]'
  path: '/roadmap',           // initial page, default '/'
  theme: 'auto'               // 'auto', 'light', or 'dark'
});

قيم path الصالحة:

المسار

ما الذي يعرضه

/ (أو /feedback)

لوحة الملاحظات الافتراضية

/feedback/<board-slug>

لوحة عامة محددة

/feedback/p/<post-slug>

منشور ملاحظات محدد

/roadmap

خارطة الطريق العامة

/updates

فهرس سجل التغييرات

/updates/<slug>

تحديث محدد في سجل التغييرات

/help

الصفحة الرئيسية لمركز المساعدة (عند نشره)

/help/collections/<slug>

مجموعة محددة في مركز المساعدة

/help/articles/<slug>

مقالة محددة في مركز المساعدة

تُعيد المسارات القديمة /board/<board-slug> و/board/p/<post-slug> التوجيه إلى /feedback/<board-slug> و/feedback/p/<post-slug>.

التحكم في التضمين

تعيد uj.createEmbed وحدة تحكم بعد تحميل نص SDK البرمجي:

JavaScript
const embed = uj.createEmbed({ path: '/' });

embed.navigate('/roadmap'); // switch to another page
embed.destroy();            // unmount the embed

المزامنة مع عنوان URL الخاص بك

مرّر basePath لكي يزامن التضمين عنوان URL في المتصفح أثناء تنقّل المستخدمين:

JavaScript
uj.createEmbed({
  container: '#feedback-page',
  basePath: '/feedback'
});

مع basePath: '/feedback'، تظل صفحة الملاحظات الرئيسية على /feedback، ويؤدي فتح منشور إلى تحديث عنوان URL في متصفحك إلى /feedback/feedback/p/<post-slug>، كما يؤدي تحميل عنوان URL هذا مباشرةً إلى فتح التضمين عند ذلك المنشور.

لكي تعمل الروابط العميقة، اضبط موجّه تطبيقك بحيث يعرض كل من /feedback و/feedback/* الصفحة التي تستدعي uj.createEmbed.

تنتقل الهوية تلقائيًا

يؤدي استدعاء uj.identify إلى تسجيل دخول المستخدم إلى كل عمليات التضمين على الصفحة (بما فيها عمليات التضمين التي تُنشأ لاحقًا)، بينما يؤدي uj.logout إلى تسجيل خروجه.

بما أن تسجيل دخول المستخدمين إلى الصفحات المضمّنة يتم عبر تسجيل الدخول التلقائي، فتأكد من تفعيل تسجيل الدخول التلقائي ضمن الإعدادات ← تسجيل الدخول (في خطة Starter أو Professional). من دون ذلك، ستُحمّل عمليات التضمين من دون تسجيل دخول، حتى عند تمرير هوية مُسجّلة الدخول.

JavaScript
uj.identify({ token: 'TOKEN_FROM_YOUR_SERVER' });
uj.createEmbed();

تضمينات متعددة

ثبّت عدة عمليات تضمين في الصفحة نفسها، مع تخصيص حاوية ومسار لكل منها:

JavaScript
uj.createEmbed({ container: '#board', path: '/' });
uj.createEmbed({ container: '#roadmap', path: '/roadmap' });

التضمين أم الأداة؟

  • استخدم الأداة عندما تريد إتاحة الملاحظات والمساعدة والتحديثات والرسائل بنقرة واحدة من أي مكان في تطبيقك.

  • استخدم التضمين عندما تريد صفحة مستقلة ضمن تخطيطك، مثل yourapp.com/feedback أو yourapp.com/help.

تستخدم منتجات كثيرة كليهما. راجع مرجع SDK للاطلاع على جميع خيارات التضمين.

هل أجاب هذا عن سؤالك؟