התקנה בשורה אחת
(וגם מה עושים כשזה "לא עולה")

מדביקים שורת <script> אחת לפני </body> — וזהו. המדריך הזה מראה איפה בדיוק בכל פלטפורמה, איך מאמתים שהתוסף עובד, ומסביר את הסיבה הנפוצה ביותר לכך שעדכון "לא מופיע": Service Worker של האתר.

הסניפט שלך

כל אתר שמוסיפים בלוח הבקרה מקבל מזהה ציבורי (data-site). הסניפט נראה כך:

<script src="https://widget.nagis.doogree.co.il/loader.js?v=20"
        data-site="YOUR_PUBLIC_SITE_ID"
        defer></script>

את ה-data-site המדויק שלך מוצאים בלוח הבקרה תחת האתרים שלי ← כפתור "העתק סניפט". אל תמציאו מזהה — השתמשו במה שהמערכת נתנה.

איפה להדביק — לפי פלטפורמה

פלטפורמהאיפה
HTML גנרילפני </body> בכל עמוד / בתבנית המשותפת
WordPressfooter.php של ה-theme לפני wp_footer(), או תוסף "Insert Headers and Footers"
WixSettings → Custom Code → Add Custom Code, מיקום: Body – end
ShopifyOnline Store → Themes → Edit code → theme.liquid לפני </body>
WebflowProject Settings → Custom Code → Footer Code
React + Viteבקובץ index.html לפני </body>לא בתוך קומפוננטה
Next.jsapp/layout.tsx עם <Script strategy="afterInteractive">
Google Tag ManagerTag חדש → Custom HTML, Trigger: All Pages

לוח הבקרה מייצר עבורך את הקוד המדויק לכל אחת מהפלטפורמות האלה — אין צורך לכתוב ידנית.

חשוב: HTML גולמי, לא שדה טקסט

הטעות הנפוצה ביותר: להדביק את הסניפט לתוך שדה שמקודד HTML (שדה תיאור, שדה SEO, או בלוק טקסט בעורך ויזואלי). אז הדפדפן מציג את הקוד כטקסט במקום להריץ אותו — והתוסף לא מופיע.

כלל אצבע: הסניפט חייב להיכנס למקום שמקבל HTML גולמי / Custom Code / Embed. אם אתם רואים את הקוד עצמו על הדף — הוא במקום הלא נכון.

איך מוודאים שזה עובד

  1. טענו את האתר ובדקו שכפתור הנגישות הצף מופיע בפינה.
  2. או — התקינו את תוסף הכרום ולחצו "בדוק שהתוסף עובד בדף הזה": הוא מריץ כל פיצ'ר ומראה דוח של מה עובד.
  3. בדיקה מהירה למפתחים: בקונסול, !!document.getElementById('nagisot-host') צריך להחזיר true.

כשעדכון "לא עולה": Service Worker

אם הטמעתם את הסניפט אבל שינויים/עדכונים לא מופיעים — סביר שלאתר שלכם יש Service Worker (נפוץ בבוני-אתרים ובאתרי PWA) שמאחסן קבצים ב-cache ומגיש גרסה ישנה. זו לא תקלה אצלנו — זו שכבת ה-cache של האתר.

הפתרון:

  1. ודאו שהסניפט משתמש בגרסה העדכנית (?v=20 או חדש יותר). מספר גרסה חדש = כתובת חדשה שה-Service Worker חייב להביא מחדש.
  2. אם עדיין ישן — נקו את ה-cache: DevTools → Application → Service Workers (Unregister) + Cache Storage (Delete), ורעננו (Ctrl+F5).

אנחנו מגרסנים גם את loader.js וגם את הקובץ הפנימי שהוא טוען, כך שכל מהדורה היא כתובת ייחודית — ברגע שמעדכנים את מספר הגרסה בסניפט, הגרסה החדשה מגיעה גם לאתרים עם Service Worker.

www מול בלי-www

אם האתר שלכם נגיש גם עם www. וגם בלי — אין צורך בשני סניפטים. המערכת מתייחסת לשני הווריאנטים כאותו אתר אוטומטית. מספיק להדביק את אותו סניפט בשני המקומות (או בתבנית המשותפת), והכל יעבוד בשני הדומיינים.

הצעד הבא

פתחו חשבון, הוסיפו אתר, העתיקו את הסניפט, והדביקו לפני </body>.