באנר הסכמה לעוגיות לוורדפרס. שני מצבים: מלא (חוסם סקריפטים של אנליטיקה ושיווק עד שהמבקר מסכים) ופשוט (הודעת יידוע). עובד בעברית (RTL) ובאנגלית, ותומך ב־WPML וב־Polylang.
תוכן העניינים
- התחלה מהירה
- שאלות נפוצות ופתרון בעיות
- מצבי הסכמה
- חסימת קוד מעקב שהתבנית מוסיפה
- לאפשר למבקרים לשנות את הבחירה
- ההגדרות, לשונית אחר לשונית
- קופה של WooCommerce
- למפתחים
- עמודים קשורים
התחלה מהירה
- פתחו את הגדרות → ATR Cookie Notice.
- בלשונית הגדרות כלליות ודאו שההגדרה הראשונה, הפעל הסכמה לעוגיות ומדיניות פרטיות - ישראל, מסומנת.
- בחרו מצב הסכמה: מלא אם חובה לחסום מעקב עד ההסכמה, פשוט אם מספיק ליידע את המבקרים. ראו מצבי הסכמה.
- הגדירו עמוד מדיניות פרטיות ב־הגדרות → פרטיות (של וורדפרס). הקישור בבאנר מפנה אליו.
- בחרו מיקום הבאנר וצד הבאנר. את המראה בודקים בתצוגה המקדימה בלשונית עיצוב ומראה.
- לחצו שמירת שינויים, אחר כך Purge caches and refresh assets, ובדקו את האתר בחלון פרטי.
שאלות נפוצות ופתרון בעיות
פופאפ של האתר מסתיר את הבאנר
תוספי פופאפ מסוימים מציגים את החלון שלהם, או שכבה כהה, מעל באנר העוגיות, והמבקר לא יכול ללחוץ עליו.
העלו את עיצוב ומראה → Banner Z-Index. הערך המרבי הוא 2147483647, והוא מציב את הבאנר מעל כמעט כל רכיב. המבקרים יכולים גם לגרור את הבאנר הצידה (ראו בהמשך).
הבאנר מסתיר חלון צ'אט או תוכן אחר
- שנו את הגדרות כלליות → צד הבאנר לצד השני של המסך.
- המבקרים יכולים לגרור את הבאנר הצידה בעזרת נקודות הגרירה בפינה העליונה שלו: בעכבר, באצבע או במקשי החיצים. הזזת הבאנר אינה הסכמה, והמיקום לא נשמר לעמוד הבא.
לא רוצים באנר בעמוד מסוים
למשל דף נחיתה לתרומות. הוסיפו את מזהה העמוד ב־הגדרות כלליות → הסתרת הבאנר בעמודים (מופרדים בפסיקים, למשל 12, 345). המזהה מופיע בכתובת העריכה של העמוד (post=12).
אזהרה: בעמודים אלה הבאנר לא מוצג וסקריפטי מעקב לא נחסמים, גם במצב מלא. המבקרים שם לא מיודעים ולא נאספת מהם הסכמה.
השינויים לא מופיעים באתר
לחצו Purge caches and refresh assets בראש דף ההגדרות, נקו מטמון עמודים או CDN, ובדקו בחלון פרטי.
הבאנר לא מופיע ב־Brave או עם חוסם פרסומות
Brave (חסימת הודעות עוגיות ב־Shields), uBlock Origin ו־AdGuard יכולים להשתמש ברשימת הסינון הציבורית "EasyList Cookie". היא חוסמת קובצי הודעות עוגיות לפי שם, כולל קובצי ה־CSS וה־JavaScript של התוסף, ולכן הבאנר לא מוצג.
- זו בחירה של המבקר; התוסף לא מנסה לעקוף אותה.
- המבקר לא מסכים אף פעם, ולכן סקריפטים שעטופים ב־
data-consentלא רצים אצלו. - הבאנר נשאר מוסתר; לא מופיעים כפתורים בלי עיצוב בתחתית הדף.
- כדי לבדוק את הבאנר בעצמכם, השתמשו בדפדפן בלי חוסמים כאלה, או כבו את החוסם לאתר שלכם.
מצבי הסכמה
| מלא (ברירת מחדל) | פשוט | |
|---|---|---|
| מטרה | לבקש הסכמה לפני מעקב | ליידע את המבקרים |
| כפתורים | קבל הכל, הסר לא הכרחיות, העדפות | אישור, קישור למדיניות פרטיות |
| חוסם אנליטיקה ושיווק עד ההסכמה | הפונקציות של Google Analytics ו־Facebook Pixel; קוד מעקב מהתבנית צריך עטיפה (ראו block-tracking-code) | לא |
| המבקר בוחר קטגוריות | כן (העדפות) | לא |
| מתי לבחור | כשחובה לחסום מעקב לא־חיוני עד ההסכמה | כשהודעה שקופה מספיקה |
חסימת קוד מעקב שהתבנית מוסיפה
חשוב: מצב מלא מנטרל את הפונקציות של Google Analytics ו־Facebook Pixel עד להסכמה, אבל לא עוצר קוד מעקב שהתבנית או תוסף אחר מדפיסים לתוך הדף - למשל קוד Google Tag Manager ב־header של התבנית, או קוד שנוסף בתוסף "הוספת קוד ל־header/footer". קוד כזה רץ לפני שהמבקר מחליט.
הפתרון: לעטוף את הקוד בסימון ההסכמה של התוסף. משנים רק את תגית ה־<script> הפותחת; הקוד שבפנים נשאר כמו שהוא.
לפני:
<script>
(function(w,d,s,l,i){ ... 'https://www.googletagmanager.com/gtm.js?id=' ... })(window,document,'script','dataLayer','GTM-XXXX');
</script>
אחרי:
<script type="text/plain" data-consent="analytics">
(function(w,d,s,l,i){ ... 'https://www.googletagmanager.com/gtm.js?id=' ... })(window,document,'script','dataLayer','GTM-XXXX');
</script>
איזו קטגוריה לבחור:
| קוד | סימון |
|---|---|
| Google Tag Manager, Google Analytics (gtag.js) | data-consent="analytics" |
| Facebook Pixel, Google Ads ופרסום אחר | data-consent="marketing" |
סקריפטים עם src עובדים באותה צורה:
<script type="text/plain" data-consent="marketing" src="https://connect.facebook.net/en_US/fbevents.js"></script>
איך זה עובד:
- הדפדפן לא מריץ סקריפט מסוג
text/plain, ולכן שום דבר לא נשלח לפני שהמבקר מחליט. - כשהמבקר מסכים לקטגוריה, התוסף הופך את הסקריפט לרגיל ומריץ אותו.
- אם המבקר דוחה, הסקריפט לא רץ אף פעם.
איפה זה עובד: בכל מקום שבו הקוד מודפס לתוך הדף - header.php של התבנית, functions.php (wp_head), Insert Headers and Footers / WPCode / Code Snippets, קוד מותאם בבוני עמודים.
איפה זה לא עובד:
- קוד שקובץ JavaScript אחר יוצר בזמן שהדף רץ.
- חלקי ה־
<noscript>של Google Tag Manager (<iframe src="https://www.googletagmanager.com/ns.html?id=...">) ושל Facebook Pixel (<img src="https://www.facebook.com/tr?...">). הם נטענים רק כש־JavaScript כבוי; אז אין באנר שיכול לבקש הסכמה, והנתונים נשלחים בכל זאת. אי אפשר לעטוף אותם - מחקו אותם. אצל מבקרים ש־JavaScript פעיל אצלם אין שום שינוי. - תגיות שמוגדרות בתוך Google Tag Manager: ברגע ש־GTM רץ (הסכמה לאנליטיקה), כל התגיות שבו רצות, כולל תגית Facebook Pixel. השאירו תגיות פרסום מחוץ ל־GTM, או טענו אותן בנפרד עם
data-consent="marketing". - קוד ש־Cloudflare מוסיפה (למשל Cloudflare Web Analytics) ומעקב מצד השרת (Facebook Conversions API).
לאפשר למבקרים לשנות את הבחירה
מוסיפים את השורטקוד [atr_cookie_notice_settings] לעמוד מדיניות הפרטיות, לפוטר או לווידג'ט תפריט. הוא מציג קישור "הגדרות עוגיות"; לחיצה עליו מוחקת את הבחירה השמורה ומציגה את הבאנר מחדש. משנים את טקסט הקישור כך: [atr_cookie_notice_settings text="ניהול עוגיות"].
ההגדרות, לשונית אחר לשונית
הגדרות כלליות
| הגדרה | מה היא עושה |
|---|---|
| הפעל הסכמה לעוגיות ומדיניות פרטיות - ישראל | מפעיל או מכבה את הבאנר בכל האתר. |
| מצב הסכמה | מלא או פשוט. ראו מצבי הסכמה. |
| מיקום הבאנר | תחתית, עליון, או שכבה (מרכז). |
| צד הבאנר | ימין או שמאל, למיקומים תחתית ועליון. צד פיזי: ימין הוא ימין גם באתר בעברית. |
| הסתרת הבאנר בעמודים | מזהי עמודים/פוסטים שבהם הבאנר לא פועל. ראו בשאלות הנפוצות. |
| עיכוב הסתרה אוטומטית (שניות) | מסתיר את הבאנר אחרי N שניות (0 = אף פעם). |
קטגוריות עוגיות
- עוגיות חיוניות תמיד פעילות ולא ניתן לכבות אותן (סשן, אבטחה, שפה).
- את אנליטיקה (למשל Google Analytics) ושיווק (למשל Facebook Pixel, Google Ads) אפשר להציג או להסתיר בבאנר.
- מצב ברירת המחדל שלהן הוא לא מסומן, וניתן לשנות אותו לכל קטגוריה.
עיצוב ומראה
- צבעים: ראשי, משני, טקסט, רקע, קישורים ושני סוגי הכפתורים (רקע וטקסט), עם בוחר צבעים.
- טיפוגרפיה: גופן, גודל, משקלים, כפתורים באותיות גדולות.
- פריסה: רדיוס פינות, ריפודים, רווחים, רוחב מרבי, כיוון, יישור.
- שכבה וסדר תצוגה: צבע ושקיפות השכבה, Banner Z-Index, צל.
- CSS מותאם לכל השאר.
- תצוגה מקדימה חיה מתעדכנת בזמן העריכה, לפני השמירה.
- Reset Styling to defaults (בכלים שבראש דף ההגדרות) מאפס רק את הלשונית הזו.
תוכן
מחליפים את הטקסט והכפתורים של הבאנר. שדה ריק משאיר את טקסט ברירת המחדל, שכבר מתורגם.
שדות:
- מצב פשוט - טקסט HTML, מצב פשוט - פעולות HTML
- מצב מלא - טקסט HTML, מצב מלא - פעולות HTML, מצב מלא - פוטר HTML
| טוקן | מה מוצג |
|---|---|
{site_name} | שם האתר |
{privacy_url} | כתובת עמוד מדיניות הפרטיות |
{privacy_link} | קישור מלא עם כותרת עמוד מדיניות הפרטיות |
[ok_button] | כפתור אישור (פשוט) |
[privacy_link] | קישור למדיניות פרטיות (פשוט) |
[accept_all_button] | כפתור קבל הכל (מלא) |
[reject_button] | כפתור הסר לא הכרחיות (מלא) |
[preferences_button] | כפתור העדפות (מלא) |
- HTML מותר:
a,button,strong,em,span,br,p. - אם מוחקים כפתור חובה, התוסף מוסיף אותו מחדש כדי שהבאנר תמיד יעבוד.
אתרים רב־לשוניים (WPML / Polylang)
להגדרות התוסף יש סט אחד לכל האתר. את שדות התוכן מתרגמים בתוסף הרב־לשוני:
- כותבים את הטקסט בלשונית תוכן בשפת ברירת המחדל של האתר, ושומרים.
- מתרגמים לפי המדריך של התוסף הרב־לשוני:
- WPML: Registering strings from the admin area and plugin settings. במסך Admin Texts מחפשים את
atr-cookie-notice. - Polylang: Strings translation. המחרוזות נמצאות בקבוצה
plugins/atr-cookie-notice.
- WPML: Registering strings from the admin area and plugin settings. במסך Admin Texts מחפשים את
- בודקים כל שפה באתר בחלון פרטי.
שדה ריק משתמש בטקסט ברירת המחדל, שכבר מוצג לפי שפת האתר. אחרי שינוי הטקסט המקורי צריך לעדכן גם את התרגומים.
אפשרויות מתקדמות
- פריסט עיצוב: בהיר, כהה, מינימלי או ניגודיות גבוהה. חלה בשמירה. כדי להתאים ערכה: שומרים אותה קודם, משנים צבעים ושומרים שוב.
- Force override theme styles: ראו בשאלות הנפוצות.
- הפעל מצב דיבאג: למפתחים, ראו למפתחים.
- תוקף עוגיות (ימים): כמה זמן הבחירה של המבקר נשמרת (ברירת מחדל 365).
כלים
בראש דף ההגדרות:
- Purge caches and refresh assets: נותן לקבצי ה־CSS/JS של התוסף מספר גרסה חדש, כך שדפדפנים ומטמונים טוענים את הקבצים החדשים, ומנקה מטמון בתוספי מטמון נפוצים אם הם מותקנים.
- Reset Styling to defaults: מאפס רק את לשונית עיצוב ומראה, אחרי אישור.
קופה של WooCommerce
WooCommerce מציג קישור משלו למדיניות פרטיות בקופה, והתוסף לא מוסיף שם תיבת סימון.
- WooCommerce → הגדרות → חשבונות ופרטיות.
- הפעילו "הוסף קישור למדיניות פרטיות לעמוד הקופה".
- ודאו שהוגדר עמוד מדיניות פרטיות ב־הגדרות → פרטיות.
בתבניות קלאסיות (לא בלוקים): הוסיפו [privacy_policy] תחת Customizer → WooCommerce → קופה → תנאים והגבלות.
למפתחים
Filters
| Filter | מטרה |
|---|---|
atr_cookie_notice_text_html_simple, atr_cookie_notice_text_html_full | שינוי ה־HTML של טקסט הבאנר אחרי החלפת הטוקנים |
atr_cookie_notice_actions_html_simple, atr_cookie_notice_actions_html_full | שינוי ה־HTML של הכפתורים אחרי החלפת הטוקנים |
atr_cookie_notice_is_excluded_page | החזרת true עוצרת את הבאנר בעמוד הנוכחי (ארגומנטים: $excluded, $post_id) |
atr_scb_settings_fields | הוספה או שינוי של שדות הגדרות |
מעקב שמצב מלא שולט בו:
- אנליטיקה: Google Analytics (
gtag,ga), Google Tag Manager (dataLayer.push). - שיווק: Facebook Pixel (
fbq). - לפני ההסכמה הפונקציות האלה מוחלפות בפונקציות ריקות; אחרי ההסכמה המקוריות חוזרות לפי קטגוריה.
- סקריפטים שמסומנים
type="text/plain" data-consent="analytics|marketing"רצים רק אחרי הסכמה לאותה קטגוריה (ראוblock-tracking-code).
שמירת הבחירה: עוגייה atr_cookie_notice_consent (JSON) ו־atr_cookie_notice_consent_given, וגם localStorage. פגה אחרי "Cookie Expiry (days)".
ממשק JavaScript: window.atrCookieNotice (window.scb נשאר ככינוי מיושן).
מצב דיבאג (אפשרויות מתקדמות → הפעל מצב דיבאג):
- פותחים עמוד ומריצים בקונסול
window.atrCookieNotice.clearConsent()(העמוד נטען מחדש). - לפני ההסכמה
window.gtag._scbBlocked,window.ga._scbBlockedו־window.fbq._scbBlockedהםtrue. window.atrCookieNotice.testTracking()שולח קריאות בדיקה.- לוחצים קבל הכל ובודקים שהסימונים נעלמו.
Text domain: atr-cookie-notice. רישיון: GPL-2.0+.