התקנה בשורה אחת
(וגם מה עושים כשזה "לא עולה")
מדביקים שורת <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> בכל עמוד / בתבנית המשותפת |
| WordPress | footer.php של ה-theme לפני wp_footer(), או תוסף "Insert Headers and Footers" |
| Wix | Settings → Custom Code → Add Custom Code, מיקום: Body – end |
| Shopify | Online Store → Themes → Edit code → theme.liquid לפני </body> |
| Webflow | Project Settings → Custom Code → Footer Code |
| React + Vite | בקובץ index.html לפני </body> — לא בתוך קומפוננטה |
| Next.js | app/layout.tsx עם <Script strategy="afterInteractive"> |
| Google Tag Manager | Tag חדש → Custom HTML, Trigger: All Pages |
לוח הבקרה מייצר עבורך את הקוד המדויק לכל אחת מהפלטפורמות האלה — אין צורך לכתוב ידנית.
חשוב: HTML גולמי, לא שדה טקסט
הטעות הנפוצה ביותר: להדביק את הסניפט לתוך שדה שמקודד HTML (שדה תיאור, שדה SEO, או בלוק טקסט בעורך ויזואלי). אז הדפדפן מציג את הקוד כטקסט במקום להריץ אותו — והתוסף לא מופיע.
כלל אצבע: הסניפט חייב להיכנס למקום שמקבל HTML גולמי / Custom Code / Embed. אם אתם רואים את הקוד עצמו על הדף — הוא במקום הלא נכון.
איך מוודאים שזה עובד
- טענו את האתר ובדקו שכפתור הנגישות הצף מופיע בפינה.
- או — התקינו את תוסף הכרום ולחצו "בדוק שהתוסף עובד בדף הזה": הוא מריץ כל פיצ'ר ומראה דוח של מה עובד.
- בדיקה מהירה למפתחים: בקונסול,
!!document.getElementById('nagisot-host')צריך להחזירtrue.
כשעדכון "לא עולה": Service Worker
אם הטמעתם את הסניפט אבל שינויים/עדכונים לא מופיעים — סביר שלאתר שלכם יש Service Worker (נפוץ בבוני-אתרים ובאתרי PWA) שמאחסן קבצים ב-cache ומגיש גרסה ישנה. זו לא תקלה אצלנו — זו שכבת ה-cache של האתר.
הפתרון:
- ודאו שהסניפט משתמש בגרסה העדכנית (
?v=20או חדש יותר). מספר גרסה חדש = כתובת חדשה שה-Service Worker חייב להביא מחדש. - אם עדיין ישן — נקו את ה-cache: DevTools → Application → Service Workers (Unregister) + Cache Storage (Delete), ורעננו (Ctrl+F5).
אנחנו מגרסנים גם את loader.js וגם את הקובץ הפנימי שהוא טוען, כך
שכל מהדורה היא כתובת ייחודית — ברגע שמעדכנים את מספר הגרסה בסניפט, הגרסה
החדשה מגיעה גם לאתרים עם Service Worker.
www מול בלי-www
אם האתר שלכם נגיש גם עם www. וגם בלי — אין צורך בשני סניפטים.
המערכת מתייחסת לשני הווריאנטים כאותו אתר אוטומטית. מספיק להדביק את אותו
סניפט בשני המקומות (או בתבנית המשותפת), והכל יעבוד בשני הדומיינים.
הצעד הבא
פתחו חשבון, הוסיפו אתר, העתיקו את הסניפט, והדביקו לפני </body>.