הפעלת ווידג'ט האתר

ווידג'ט האתר הוא הערוץ היחיד שאין לו שלב רישום — הוא עולה לאוויר ברגע שמטמיעים שורת HTML, כי הסטודיו כבר יודע כל מה שהוא צריך לדעת רק מתוך מפתח הווידג'ט.

1. שורת ההטמעה אף פעם לא משתנה

<script async
  src="https://kav.example.gov.il/widget/w.js"
  data-kav-widget
  data-key="wk_your_org_web"></script>

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

הווידג'ט רץ בתוך shadow root סגור, כך שה-CSS של האתר שלכם לא יכול לשבור אותו והוא לא יכול לשבור את האתר — זה אושר מול עמוד בדיקה עוין בכוונה עם איפוס CSS גלובלי ו-z-index בן תשע ספרות, וזה החזיק מעמד.

2. הגדירו את המיתוג שלכם, עם תצוגה מקדימה חיה

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

לכל שדה כאן יש מנגנון הגנה מובנה ולא משהו שנשען על בדיקה ידנית:

צבעים הם ליטרלים — ערך שלא מתפרש מסומן בשדה עצמו וחוסם פרסום; התצוגה המקדימה מציבה ברירת מחדל של הפלטפורמה במקום להציג בשקט משהו שבור.
גופנים מגיעים מ-<select>, אף פעם לא משם גופן בטקסט חופשי.
תמונות מועלות לאחסון של הארגון שלכם ומופנות דרך מפתח, לא מודבקות ככתובת URL. SVG נדחה, עם הסיבה מצוינת.

3. ניגודיות נבדקת לפני שאפשר לפרסם, לא אחרי

מכיוון שגופים ציבוריים בישראל מחויבים חוקית לרכוש כלים נגישים (ת"י 5568, WCAG 2.2 AA), זוג צבעים שנכשל בניגודיות בעמוד הכניסה שלכם אינו הצעת עיצוב — זו שגיאה, והיא אחת הסיבות שכפתור הפרסום מציין לפני שאפשר ללחוץ עליו. זוג שרק בקושי עובר את הרף מוצג כאזהרה, כי הזזה קטנה הבאה לצבע הזה עלולה לדחוף אותו מתחת לרף.

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