تضمين الصفحات داخل الصفحة
تعرض عمليات التضمين صفحات UserJot العامة ضمن تخطيطك، بدلاً من أداة عائمة. يمكنك تضمين لوحات الملاحظات وخارطة الطريق وسجل التغييرات ومركز المساعدة. أما واجهة الرسائل في «المحادثات» فتتوفر في الأداة فقط، ولا يمكن تضمينها.
الإعداد الأساسي
أضف عنصر حاوية إلى صفحتك:
<div data-userjot-embed style="height: 700px"></div>بعد ذلك، ابدأ تشغيل SDK وثبّت التضمين:
uj.init('YOUR_PROJECT_ID', { widget: false });
uj.createEmbed();يشغل التضمين كامل مساحة الحاوية، لذا حدّد ارتفاع الحاوية باستخدام CSS. يؤدي تمرير widget: false إلى إيقاف تشغيل الأداة العائمة، أو اتركها مفعّلة لاستخدامهما معًا.
الخيارات والمسارات المدعومة
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 الصالحة:
المسار | ما الذي يعرضه |
|---|---|
| لوحة الملاحظات الافتراضية |
| لوحة عامة محددة |
| منشور ملاحظات محدد |
| خارطة الطريق العامة |
| فهرس سجل التغييرات |
| تحديث محدد في سجل التغييرات |
| الصفحة الرئيسية لمركز المساعدة (عند نشره) |
| مجموعة محددة في مركز المساعدة |
| مقالة محددة في مركز المساعدة |
تُعيد المسارات القديمة /board/<board-slug> و/board/p/<post-slug> التوجيه إلى /feedback/<board-slug> و/feedback/p/<post-slug>.
التحكم في التضمين
تعيد uj.createEmbed وحدة تحكم بعد تحميل نص SDK البرمجي:
const embed = uj.createEmbed({ path: '/' });
embed.navigate('/roadmap'); // switch to another page
embed.destroy(); // unmount the embedالمزامنة مع عنوان URL الخاص بك
مرّر basePath لكي يزامن التضمين عنوان URL في المتصفح أثناء تنقّل المستخدمين:
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). من دون ذلك، ستُحمّل عمليات التضمين من دون تسجيل دخول، حتى عند تمرير هوية مُسجّلة الدخول.
uj.identify({ token: 'TOKEN_FROM_YOUR_SERVER' });
uj.createEmbed();تضمينات متعددة
ثبّت عدة عمليات تضمين في الصفحة نفسها، مع تخصيص حاوية ومسار لكل منها:
uj.createEmbed({ container: '#board', path: '/' });
uj.createEmbed({ container: '#roadmap', path: '/roadmap' });التضمين أم الأداة؟
استخدم الأداة عندما تريد إتاحة الملاحظات والمساعدة والتحديثات والرسائل بنقرة واحدة من أي مكان في تطبيقك.
استخدم التضمين عندما تريد صفحة مستقلة ضمن تخطيطك، مثل
yourapp.com/feedbackأوyourapp.com/help.
تستخدم منتجات كثيرة كليهما. راجع مرجع SDK للاطلاع على جميع خيارات التضمين.