וידג'ט ההרשמה
וידג'ט ההרשמה הוא חבילת JS אחת ללא תלויות (פחות מ-60 קילובייט דחוסים) שמרכיבה טופס לכידת לידים בתוך Shadow DOM בכל עמוד — האתר שלכם, עמוד נחיתה, כל מקום. הוא לעולם לא נוגע בסגנונות של עמוד המארח, ועמוד המארח לעולם לא נוגע בפנימיותו.
תג הסקריפט
כל התקנה עצמאית (self-hosted) של Institflow מגישה עותק משלה של הווידג'ט בנתיב /widget.js — בלי CDN ובלי מארח נפרד שאליו מפנים. המסך הגדרות ← מפתחים ← קטע קוד לווידג'ט באפליקציית הווב שלכם מייצר את התג הבא בדיוק, עם הכתובת של ההתקנה שלכם והמפתח הפומבי כבר ממולאים; כתובת הסקריפט עדיין ניתנת לעריכה שם אם אתם מעדיפים לארח את הקובץ בעצמכם.
<script
src="https://<your-institute-address>/widget.js"
data-key="ifl_pub_9c1f2e7a4b8d3c6f0a5e9b2d7c4f1a8e"
data-locale="he"
data-course-id="0190a1b2-0000-7000-8000-000000000002"
></script>שימו אותו בכל מקום בגוף העמוד שלכם. הווידג'ט קורא את המאפיינים של תג ה-<script> שלו עצמו בזמן הטעינה — הוא חייב להיות סקריפט קלאסי (בלי type="module"), כי זו הדרך היחידה שבה הוא יכול לאתר את התג של עצמו בעמוד.
מאפייני data-*
| מאפיין | חובה | תיאור |
|---|---|---|
data-key | כן | המפתח לפרסום שלכם (ifl_pub_…). לעולם לא מפתח סודי. |
data-locale | לא | "en", "ar" או "he" — ברירת המחדל היא שפת הדפדפן, ואם לא, "en". |
data-course | לא | תחום עניין בקורס כטקסט חופשי, נרשם עם הפנייה. |
data-course-id | לא | מזהה קורס מתוך GET /public/courses — נרשם כהפניה אמיתית, בניגוד ל-data-course הטקסטואלי. |
data-group-id | לא | מזהה של קבוצה מסוימת באותו קורס. |
data-captcha-site-key | לא | מפתח האתר שלכם ב-Cloudflare Turnstile (ההגדרה integration.captchaSiteKey). כשהוא מוגדר, הטופס מציג אתגר ולא נשלח בלעדיו. |
data-theme | לא | "light", "dark" או "auto" (ברירת המחדל — עוקב אחרי העדפת מערכת ההפעלה של המבקר). |
מה הוא יוצר
שליחה של הטופס קוראת ל-POST /api/v1/public/registrations עם המפתח לפרסום שלכם, וזה:
- יוצר תלמיד בסטטוס
lead, מתויגwidget-lead, בסניף ברירת המחדל של הדייר שאליו שייך המפתח. - יוצר אפוטרופוס (או משתמש בקיים, לפי התאמת מספר טלפון), ומקשר אותו כאיש קשר ראשי וכמשלם.
- משדר
student.created— בדיוק אותו אירוע שנקודות ה-webhook שלכם כבר רשומות אליו.
מכאן זהו תלמיד רגיל במערכת שלכם: מופיע ב-GET /api/v1/students בסטטוס lead, מוכן לרישום ברגע שמישהו מהצוות שלכם יחזור אליו.
רשימת מקורות מאושרים ומגבלות קצב
כל מפתח לפרסום עובד רק מהמקורות שאישרתם לו במפורש ביצירה — רשימה ריקה לא מקבלת אף מקור. שליחות מוגבלות בקצב לפי כתובת IP (30 לדקה) ולפי מפתח (300 ליום).
עיצוב וערכות נושא
הצבעים, המרווחים, הרדיוסים והטיפוגרפיה של הטופס מגיעים היישר מאותם design tokens שכל שאר Institflow משתמשת בהם, כך שהוא מרגיש טבעי לצד המוצר שלכם ולא כמו iframe מוטמע וזר. הוא מכבד את data-theme (או את העדפת מערכת ההפעלה), נפרס אוטומטית מימין לשמאל עבור ar/he באמצעות תכונות CSS לוגיות (לעולם לא גיליון סגנונות RTL נפרד), ומציג את מצב ההצלחה או הכישלון שלו בתוך העמוד — בלי ניווט ובלי חלון קופץ.