پرش به محتوای اصلی
پلکسیت

نصب ویجت با یک اسکریپت

ویجت گفت‌وگوی Plexit با یک تکه کد روی هر سایتی نصب می‌شود. ساختار کد، ویژگی‌های آن و محل درست قرار دادنش را ببینید.

به‌روزرسانی:زمان مطالعه: ۳ دقیقه
فهرست مطالب

ویجت Plexit یک حباب گفت‌وگو در گوشهٔ سایت شماست که با کلیک باز می‌شود و مخاطب را به دستیار وصل می‌کند. نصب آن فقط یک تگ script است و به هیچ کتابخانه یا ابزار ساخت دیگری نیاز ندارد.

پیش از نصب

  • دستیار شما در وضعیت «فعال» باشد.
  • دامنهٔ سایت در کارت دامنه‌های مجاز ثبت شده باشد. بدون این کار ویجت پاسخ نمی‌دهد؛ راهنمای دامنه‌های مجاز را ببینید.

کپی کد نصب

  1. تب نصب را باز کنید

    در دستیارها روی «مدیریت» بزنید و وارد تب نصب شوید.

  2. نسخهٔ ویجت را انتخاب کنید

    در فیلد «نسخهٔ ویجت» یکی از دو گزینه را برگزینید: «سبک» یا «کامل».

  3. کد را کپی کنید

    در کارت «کد نصب» روی کپی کد بزنید.

  4. کد را در سایت قرار دهید

    کد را درست پیش از بسته شدن تگ body در همهٔ صفحاتی که می‌خواهید ویجت در آن‌ها باشد قرار دهید. در بیشتر سایت‌ها این کار با افزودن کد به قالب مشترک پایین صفحه انجام می‌شود.

ساختار کد نصب

کدی که کنسول می‌سازد شکلی شبیه نمونهٔ زیر دارد. نشانی‌ها و کلید سایت در کد واقعی شما از قبل پر شده‌اند؛ همیشه کد را از تب نصب کپی کنید و نمونهٔ زیر را دستی تایپ نکنید.

html
<script
  src="https://WIDGET_HOST/loader.js"
  data-site-key="wk_YOUR_SITE_KEY"
  data-widget-src="https://WIDGET_HOST"
  data-api-base="https://WIDGET_API_HOST"
  data-position="right"
  async
></script>
ویژگیکاربرد
data-site-keyکلید سایت دستیار؛ الزامی است و بدون آن ویجت بارگذاری نمی‌شود
data-widget-srcنشانی میزبانی فایل‌های ویجت
data-api-baseنشانی سرویسی که ویجت با آن گفت‌وگو می‌کند
data-positionright یا left؛ سمت نمایش حباب در اولین بارگذاری
data-uiبا مقدار elements نسخهٔ کامل ویجت بارگذاری می‌شود؛ اگر نباشد نسخهٔ سبک

نسخهٔ سبک یا کامل؟

هر دو نسخه رفتار یکسانی دارند. نسخهٔ سبک کمترین حجم را دارد و سریع بارگذاری می‌شود. نسخهٔ کامل پاسخ‌ها را با قالب‌بندی Markdown و منابع پاسخ نمایش می‌دهد و حجم بیشتری دارد. با تغییر گزینه در کنسول، کد نصب به‌روز می‌شود و باید کد جدید را جایگزین کنید.

بررسی نصب

  1. صفحه‌ای از سایت را که کد در آن است باز کنید؛ حباب گفت‌وگو باید در گوشهٔ صفحه ظاهر شود.
  2. روی حباب بزنید و یک سؤال بپرسید.
  3. اگر حباب ظاهر نشد، کنسول مرورگر را باز کنید. پیام‌های مربوط به ویجت با [Plexit] شروع می‌شوند؛ مثلاً نبودن ویژگی data-site-key.

برای سایت‌های وردپرسی راهنمای نصب روی وردپرس با کد و برای React و Next.js راهنمای استفاده در React/Next.js را ببینید.

آیا ویجت سرعت سایت را کم می‌کند؟

اسکریپت با ویژگی async بارگذاری می‌شود و مانع نمایش صفحه نمی‌شود. خود ویجت در یک iframe جداگانه اجرا می‌شود و با کدهای سایت شما تداخل ندارد.

تغییر رنگ یا پیام خوش‌آمد نیاز به کد جدید دارد؟

خیر. تنظیمات ظاهر از کنسول خوانده می‌شود و بدون تغییر کد اعمال می‌شود. فقط تغییر نسخهٔ ویجت یا سمت نمایش اولیه در خود کد اثر دارد.

ویجت روی موبایل هم کار می‌کند؟

ویجت اندازهٔ خود را با صفحه تطبیق می‌دهد و از لبه‌های صفحه‌نمایش بیرون نمی‌زند.