# ATR Cookie Notice

ניהול הסכמה לעוגיות לוורדפרס.

## תכונות

- **באנר הסכמה לעוגיות**: מוצג כאשר משתמשים מבקרים באתר בפעם הראשונה
- **אפשרויות הסכמה מפורטות**: משתמשים יכולים לבחור בין עוגיות חיוניות, אנליטיקה ושיווק
- **אחסון העדפות**: העדפות המשתמש נשמרות מקומית ומכובדות בין ביקורים
- **תמיכה רב-לשונית**: התוסף זמין בעברית ואנגלית. ניתן להוסיף שפות אחרות בתרגום וורדפרס סטנדרטי.

## הגדרה

### הגדרות כלליות
- הפעל/בטל את באנר העוגיות
- מצב הסכמה:
  - מלא (ברירת מחדל) – חוסם סקריפטים לא‑חיוניים (אנליטיקה/שיווק) עד להסכמה. מציג כפתורים: "קבל הכל", "דחה לא‑חיוניות" ו"העדפות" לבחירה מדויקת.
  - פשוט – הודעת מידע בלבד עם כפתור "אישור" (OK) וקישור למדיניות פרטיות. לא חוסם או משנה סקריפטים של צד שלישי.
  - מומלץ: בחרו "מלא" כשנדרשת חסימה עד הסכמה; בחרו "פשוט" כשנדרש רק עדכון שקוף ללא חסימה.
- הגדר מיקום הבאנר (תחתית, עליון, שכבת-על)
- הגדר השהיה להסתרה אוטומטית

### קטגוריות עוגיות
- הצגה/הסתרה של קטגוריות אנליטיקה ושיווק
- ברירות מחדל:
  - חיוניות: תמיד נדרשות (לא ניתנות לכיבוי)
  - אנליטיקה: מוצגת, לא מסומנת כברירת מחדל
  - שיווק: מוצגת, לא מסומנת כברירת מחדל

### עיצוב ומראה
- התאמה מקיפה בעזרת משתני CSS:
  - צבעים: ראשי, משני, טקסט, רקע, קישור, וכפתורים (טקסט/רקע לכפתור ראשי/משני)
  - טיפוגרפיה: משפחת גופנים, גודל בסיס, משקלים, אותיות רישיות לכפתורים
  - פריסה וריווחים: רדיוס פינות, ריווח פנימי, מרווחים, רוחב מקסימלי לבאנר/מודאל, כיוון ויישור
  - שכבת-על וסדר שכבות: צבע/שקיפות לאוברליי, z-index, הצללה
  - CSS מותאם אישית (מוסף לאחר הסגנונות המחושבים)
- תצוגה מקדימה חיה בממשק הניהול מתעדכנת מיד בזמן עריכת השדות (ללא שמירה).
- מתג “כפה עקיפה על סגנונות התבנית” מוסיף איפוסים ממוקדים וכללים בעלי עדיפות גבוהה כדי להתגבר על CSS אגרסיבי של התבנית.
- איפוס עיצוב: ב"כלים" קיים כפתור “אפס עיצוב לברירות מחדל” שמחזיר רק את שדות "מראה ועיצוב" לברירות המחדל.

### תוכן (HTML בטוח)
- ניתן להחליף את הטקסט (`.scb-text`) ואת אזור הפעולות הראשיות (`.scb-actions`) בשתי התצורות.
- שדות:
  - מצב פשוט: “טקסט HTML — מצב פשוט”, “פעולות HTML — מצב פשוט”
  - מצב מלא: “טקסט HTML — מצב מלא”, “פעולות HTML — מצב מלא”
- השאירו ריק כדי להשתמש בברירת המחדל המתורגמת.
- תגיות מותרות: `a`, `button`, `strong`, `em`, `span`, `br`, `p`
  - מאפיינים מותרים: `href`, `rel`, `target`, `class`, `id`, `type`, וגם `style` (על `span`)
- טוקנים:
  - `{site_name}`, `{privacy_url}`
  - `{privacy_link}` → אלמנט קישור מלא עם כותרת עמוד מדיניות הפרטיות, למשל: `<a href="…" target="_blank" rel="noopener" role="link">כותרת מדיניות הפרטיות</a>`
  - פעולות במצב פשוט: `[ok_button]`, `[privacy_link]`
  - פעולות במצב מלא: `[accept_all_button]`, `[reject_button]`, `[preferences_button]`
- פוטר (מצב מלא):
  - שדה: “טקסט HTML — פוטר מצב מלא”
  - טוקנים: `{privacy_url}`
  - ברירת מחדל (כאשר ריק): קישור למדיניות הפרטיות
- בטיחות: מזהי כפתורים נדרשים נאכפים. אם חסרים, התוסף יוסיף ברירות מחדל:
  - מצב פשוט: `#scb-btn-ok`
  - מצב מלא: `#scb-btn-accept-all`, `#scb-btn-reject`, `#scb-btn-custom`
- פילטרים (למפתחים, אחרי החלפת טוקנים):
  - `atr_cookie_notice_text_html_simple`, `atr_cookie_notice_actions_html_simple`
  - `atr_cookie_notice_text_html_full`, `atr_cookie_notice_actions_html_full`

### לוקליזציה
- קישור מדיניות הפרטיות בבאנר מפנה לעמוד שמוגדר ב‑WordPress תחת הגדרות → פרטיות (התוסף אינו מנהל את תוכן עמוד זה).
- בתיעוד למנהלים בלבד, מוצג תוכן דוגמה למדיניות פרטיות לפי שפת המנהל (עברית/אנגלית).
- התרגומים פועלים לפי מנגנון התרגום הסטנדרטי של וורדפרס. ניתן להוסיף שפות נוספות אך ורק דרך מערכת התרגום הרשמית ב‑translate.wordpress.org עבור תחום הטקסט `atr-cookie-notice`.

### אפשרויות מתקדמות
- הפעל מצב דיבוג
- הגדר ימי תפוגת עוגיות

### כלים
- ניקוי מטמון ורענון משאבים: כלי בלחיצה אחת שמבצע:
  - העלאת "מספר גרסה" פנימי לקבצי CSS/JS (asset buster) כך שכתובות ייטענו עם `?ver=` חדש ויעקפו מטמונים ישנים
  - הפעלת ניקוי מטמון בתוספי/ספקי מטמון נפוצים, אם מותקנים
  - הפניה חזרה עם הודעת הצלחה

כיצד משתמשים:
1. פתחו את דף הגדרות התוסף בלוח הבקרה
2. לחצו על "ניקוי מטמון ורענון משאבים" בבלוק הכלים למעלה
3. רעננו עמוד פרונטאנד ובדקו שכתובות המשאבים כוללות `?ver={גרסה}-{חותמת_זמן}`

### מצבי הסכמה

#### מלא (ברירת מחדל)
- חוסם מעקב אנליטיקה ושיווק עד למתן הסכמה.
- מציג בחירות מפורטות: קבל הכל, דחה לא‑חיוניות, העדפות עם קטגוריות.
- משחזר מעקב רק לקטגוריות שאושרו.

#### פשוט
- מציג באנר מידע קל עם כפתור אישור (OK) וקישור למדיניות פרטיות.
- לא חוסם ולא משנה שום סקריפט של צד שלישי.
- מומלץ כאשר נדרש רק לעדכן את המשתמשים ללא חסימת תכנים.

#### טעינת סקריפטים בזמן ריצה
- נטען קובץ JS אחד בלבד לפי המצב הנבחר:
  - מלא: `public/js/atr-cookie-notice-public.js` (דורש jQuery)
  - פשוט: `public/js/atr-cookie-notice-simple.js` (ללא jQuery)

### שירותי מעקב מבוקרים

התוסף חוסם ומבקר אוטומטית את שירותי המעקב הנפוצים הבאים:

**שירותי אנליטיקה:**
- Google Analytics (פונקציות gtag, ga)
- Google Tag Manager (פונקציית dataLayer.push)

**שירותי שיווק:**
- Facebook Pixel (פונקציית fbq)

**איך זה עובד:**
- לפני הסכמה: פונקציות מעקב חסומות ומוחלפות בגרסאות ריקות
- אחרי הסכמה: פונקציות המעקב המקוריות משוחזרות לפי בחירות המשתמש
- עוגיות חיוניות: תמיד מותרות (ניהול סשן, אבטחה, העדפות)
- עוגיות אנליטיקה: חסומות עד שהמשתמש מסכים לקטגוריית אנליטיקה
- עוגיות שיווק: חסומות עד שהמשתמש מסכים לקטגוריית שיווק

### מצב דיבוג (למפתחים)

כאשר פעיל, נחשפים כלים לבדיקת חסימת מעקב (ללא השפעה על משתמשים):

- דגל JS: ‏`scbSettings.enableDebug === true`
- מסייע: `window.scb.testTracking()` לסימולציית קריאות אנליטיקה/שיווק
- בדיקת-עצמית אופציונלית לאחר הטעינה (ללא שינוי בהסכמה)

איך בודקים

1. הפעילו את "הפעל מצב דיבוג" ושמרו.
2. פתחו עמוד פרונטאנד ונקו הסכמה: `window.scb.clearConsent()` (העמוד ייטען מחדש).
3. לפני הסכמה, בדקו את דגלי החסימה בקונסול:
   - `window.gtag && window.gtag._scbBlocked` → true כאשר חסום
   - `window.ga && window.ga._scbBlocked` → true כאשר חסום
   - `window.fbq && window.fbq._scbBlocked` → true כאשר חסום
4. הריצו `window.scb.testTracking()` (מחזיר undefined; זו בדיקה בלבד).
5. לחצו "קבל הכל". בדקו שוב את הדגלים; הם לא אמורים להיות חסומים.

## שימוש

בביקור ראשון:
1. מציג באנר הסכמה
2. חוסם אנליטיקה/שיווק עד להסכמה
3. שומר את בחירות המשתמש

## קטגוריות עוגיות (לעיון)

### חיוניות
- נדרשות לתפקוד ליבה (לדוגמה: סשנים, הזדהות, שפה)

### אנליטיקה
- לדוגמה: Google Analytics, צפיות בדפים, ביצועים

### שיווק
- לדוגמה: Facebook Pixel, Google Ads

## קישור למדיניות פרטיות בקופה של WooCommerce

WooCommerce כולל תצוגה מובנית של קישור למדיניות פרטיות בעמוד הקופה. התוסף אינו מוסיף תיבת סימון נפרדת.

כך מפעילים קישור למדיניות בפרוצדורת התשלום:

1. WooCommerce → הגדרות → חשבונות ופרטיות
2. סמנו "הוסף קישור למדיניות פרטיות בעמוד הקופה"
3. ודאו שעמוד מדיניות פרטיות מוגדר תחת הגדרות → פרטיות
4. התאימו את נוסח המדיניות תחת WooCommerce → הגדרות → חשבונות ופרטיות לפי הצורך

שימו לב: הקישור יוצג רק אם הוגדר עמוד מדיניות פרטיות (הגדרות → פרטיות). בתמות קלאסיות (לא FSE) הוסיפו את `[privacy_policy]` תחת WooCommerce → התאמה אישית (Customizer) → קופה → תנאים והגבלות, כדי שתיבת הסימון תכלול גם הסכמה למדיניות הפרטיות.

## מידע למפתחים

- **תחום טקסט**: atr-cookie-notice
- **גרסה**: 1.1.0
- **מחבר**: יהודה תירם
- **רישיון**: GPL-2.0+

## תמיכה

לתמיכה ותיעוד, בקר בדף הגדרות התוסף בממשק הניהול של וורדפרס.

## יומן שינויים

### 1.0.0
- שחרור ראשוני
- באנר הסכמה לעוגיות
- תמיכה רב-לשונית