> ## Documentation Index
> Fetch the complete documentation index at: https://docs.karzoun.chat/llms.txt
> Use this file to discover all available pages before exploring further.

# تثبيت كود النافذة

> ثبّت النافذة على موقعك من قائمة النوافذ: انسخ محمل النموذج، وحاوية التضمين عند الحاجة، أو مشغّل الفتح بالنقر.

بعد الحفظ، النافذة لا تظهر على موقعك حتى يُحمَّل كودها. من القائمة افتح **تثبيت الكود** لأي صف — الحوار يعطيك مقاطع جاهزة للنسخ.

## قبل أن تبدأ

* نافذة محفوظة وحالتها مناسبة للعرض (**نشط** إن كنت تختبر الإنتاج)
* صلاحية تعديل قالب الموقع أو أداة العلامات (مثل Google Tag Manager)
* معرفة إن كنت تريد ظهوراً تلقائياً، مضمّناً داخل صفحة، أو فتحاً بزر

## خطوات التثبيت (محمل النموذج — الموصى به)

<Steps>
  <Step title="افتح كود التثبيت">
    من **النوافذ المنبثقة** → قائمة الصف → **تثبيت الكود**.
  </Step>

  <Step title="انسخ وسم السكربت">
    القسم **1. أضف محمل النموذج**: يلصق قبل `</body>`. يحمّل هذا النموذج فقط دون تفعيل المراسلة أو قاعدة المعرفة أو أحداث البكسل الكاملة.
  </Step>

  <Step title="التضمين داخل الصفحة (اختياري)">
    للعرض **المضمّن**: ضع عنصر الحاوية حيث تريد النموذج داخل الصفحة (`data-kzn-form="…"`). بدونه يظهر السلوك كنافذة/عرض حسب إعداد النوع.
  </Step>

  <Step title="مشغّل بالنقر (اختياري)">
    زر أو رابط يستدعي فتح النموذج عبر واجهة JavaScript عند الحاجة (مثل زر «تواصل» في الرأس).
  </Step>

  <Step title="انشر واختبر">
    انشر القالب، ثم استخدم **فتح المعاينة** من الحوار أو زر الموقع الحقيقي.
  </Step>
</Steps>

<Info>
  **وسائط مطلوبة:** حوار كود التثبيت مع مقطع السكربت وزر النسخ وزر فتح المعاينة.\
  `/images/help/popups/install-code-dialog.webp`\
  **فيديو (مستحسن):** نسخ المحمل → لصق في الموقع → ظهور النافذة.
</Info>

## ماذا تعني المقاطع؟

| المقطع                  | دوره                                  |
| ----------------------- | ------------------------------------- |
| إعدادات + سكربت المحمل  | يربط حسابك ويعرّف معرّف النموذج       |
| حاوية التضمين           | موضع ثابت داخل الصفحة للنموذج المضمّن |
| زر `Karzoun.forms.show` | فتح يدوي عند النقر                    |

لا تلصق نسختين متعارضتين من سكربت كرزون على نفس الصفحة دون قصد. إن كنت تستخدم البكسل الكامل أيضاً، راجع [الاستخدام مع كرزون بكسل](/ar/help-center/guides/popups/with-pixel).

## أخطاء شائعة

| العرض                 | السبب المحتمل                                                        |
| --------------------- | -------------------------------------------------------------------- |
| لا يظهر شيء           | السكربت غير منشور، أو النافذة مؤرشفة، أو قواعد استهداف تستثني زيارتك |
| يظهر منبثاً بدل مضمّن | لم تُضف حاوية `data-kzn-form`                                        |
| يعمل في المعاينة فقط  | الكود على بيئة staging وليس الإنتاج                                  |

## ذات صلة

* [الاستخدام مع كرزون بكسل](/ar/help-center/guides/popups/with-pixel)
* [قواعد الاستهداف](/ar/help-center/guides/popups/targeting-rules)
* [القائمة والأداء](/ar/help-center/guides/popups/list-and-performance)
* [تثبيت كرزون بكسل](/ar/help-center/guides/pixel/install)


## Related topics

- [الاستخدام مع كرزون بكسل](/ar/help-center/guides/popups/with-pixel.md)
- [إنشاء نافذة](/ar/help-center/guides/popups/create.md)
- [أنواع العرض](/ar/help-center/guides/popups/display-types.md)
- [التنسيق وCSS](/ar/help-center/guides/popups/styling.md)
- [القائمة والأداء](/ar/help-center/guides/popups/list-and-performance.md)