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

مولد رمز التضمين

أضف أداة تصويت Society Speaks إلى مقالتك في دقائق. يحصل المطورون على iframe نظيف وعناصر تحكم في التخصيص. يحصل المحررون على رؤى منظمة، وليس ضوضاء التعليقات.

مرجع API الاتصال

التضمينات متاحة لنقاشات Society Speaks الأصلية.

قائمة التحقق من التنفيذ

  • تأكد من إدراج مجال اسمك في قائمة السماح
  • إنشاء iframe أدناه
  • استخدم تغيير الحجم التلقائي لتجربة مستخدم سلسة

استخدم بوابة الشركاء للتوصيل الإنتاجي

قم بإنشاء مفاتيح الاختبار الخاصة بك، والتحقق من المجالات، وتفعيل المفاتيح المباشرة من <a href="/for-publishers/portal/signup" class="underline">بوابة الشركاء</a>. للعمل على نطاق واسع، استخدم API لإنشاء نقاشات وتخزين معرف النقاش المُرجع في نظام إدارة المحتوى الخاص بك. راجع <a href="/for-publishers/api" class="underline">مرجع API</a> للحصول على سير العمل البرمجي.

للمطورين

iframe خفيف الوزن، معاملات يمكن التنبؤ بها، وخطافات تغيير حجم postMessage.

للمحررين

المشاركة المنظمة، وإشارات إجماع واضحة، والمنهجية القابلة للتدقيق.

للجماهير

التصويت في ثوان، ورؤية محاذاة الجمهور، واستكشاف التحليلات الأعمق.

سير العمل على نطاق واسع

1) البحث بعنوان URL للمقالة، 2) الإنشاء إذا كان مفقوداً، 3) تخزين معرف النقاش.

ما هو معرف النقاش؟

معرّف فريد يُرجعه API عند إنشاء نقاش أو العثور عليه.

لا يوجد نقاش حتى الآن؟

اتصل بـ POST /api/partner/discussions لإنشاء واحد، ثم قم بالتضمين على الفور.

1. ابحث عن النقاش الخاص بك

أو

مُرجع بواسطة API عند إنشاء نقاش أو العثور عليه.

2. اختر مظهراً

أو خصص الألوان:

3. أضف مرجعك (اختياري)

يُستخدم للتحليلات. حروف صغيرة، بدون مسافات.

معاينة

أدخل معرف نقاش أو ابحث عن عنوان URL للمقالة لعرض المعاينة

رمز التضمين

<!-- أدخل معرّف النقاش لإنشاء رمز التضمين -->

مقتطف إعادة الحجم التلقائي

<script>
window.addEventListener('message', (event) => {
  if (event.data && event.data.type === 'societyspeaks:embed:resize') {
    const iframe = document.getElementById('societyspeaks-embed');
    if (iframe) iframe.style.height = event.data.height + 'px';
  }
});
</script>

تلميحات الأداء

<link rel="preconnect" href="https://societyspeaks.io">
<link rel="dns-prefetch" href="https://societyspeaks.io">

نصائح

  • اضبط عرض iframe على 100% للتضمينات سريعة الاستجابة
  • الارتفاع الافتراضي هو 600px؛ اضبطه بناءً على عدد البيانات
  • أضف ref لتتبع المشاركة من موقعك
  • التضمين ينشر ارتفاعه عبر postMessage لتحديد الحجم الديناميكي
  • أضف مقتطف إعادة الحجم التلقائي لتجنب أشرطة التمرير
  • استخدم تلميحات preconnect لتسريع الرسم الأول