
שפה 🇮🇱 עברית
TLDR
הגדרת FastComments
רישום הכלי
הוספה לקורס
שימוש בכלי
אבטחה וציות
סקרים
הוספת תגובות ל‑LMS שלך דרך LTI 1.3
FastComments משתלב עם כל LMS התואמת LTI 1.3 - D2L Brightspace, Moodle, Blackboard Learn, Sakai, Schoology, ואחרות - באמצעות תקן IMS LTI Dynamic Registration. כתובת URL אחת, שמדביקים במסך ההרשמה של ה-LMS שלכם, מחברת את כל האינטגרציה: SSO, הקשר קורס, מיפוי תפקידים, ומיקום התוכן. אין צורך להתקין תוסף על השרת שלכם. (ל-Canvas LMS יש מדריך ייעודי כי תהליך ההרשמה שלו שונה.)
לאחר ההרשמה, FastComments מופיע ככלי לימודי בתוך הקורסים שלכם. תלמידים רואים תגובות בשרשור וצ'אט שיתופי לצד תוכן הקורס, והם מחוברים אוטומטית באמצעות חשבון ה-LMS שלהם.
תמחור 
האינטגרציה של FastComments ב-LTI 1.3 כלולה בתוכניות Flex ו-Pro ללא עלות נוספת.
היא עובדת עם כל LMS שתומך במפרט IMS LTI 1.3 Advantage, כולל Dynamic Registration.
התחלה מהירה 
- היכנס ל-FastComments ועבור אל דף התצורה של LTI 1.3 שלך.
- (Optional) בחר את הפלטפורמה שממנה אתה מתחבר מתוך תפריט הנפתח Platform - זה קובע את תווית התצוגה, אך Auto-detect עובד היטב.
- לחץ על Generate URL. מופיע Registration URL לשימוש חד-פעמי (תקף למשך 30 דקות).
- ב-LMS שלך, פתח את מסך ההרשמה הדינמית של LTI 1.3 והדבק את ה-URL בשדה Tool initiation registration endpoint (או שדה מקביל). הגש.
- ה-LMS שלך קורא חזרה ל-FastComments, מחליף מפתחות ויוצר את האינטגרציה. החלונית הקופצת נסגרת אוטומטית כשהתהליך מסתיים.
- חזור ל-FastComments, התצורה החדשה מופיעה בטבלה Existing Configurations. הכלי זמין כעת בתוך הקורסים ב-LMS שלך.
פלטפורמות נתמכות 
FastComments LTI 1.3 נבדק מול:
- D2L Brightspace (כל גרסה עם LTI Advantage)
- Moodle 4.0+ (תוסף External Tool, LTI Advantage)
- Blackboard Learn (SaaS ו-Ultra)
- Sakai (גרסאות התומכות ב-LTI Advantage)
- Schoology (Enterprise, Dynamic Registration כאשר זמין)
כל LMS אחר שמיישם את התקן IMS LTI 1.3 Advantage עם Dynamic Registration אמור גם לעבוד - בחר Other LTI 1.3 platform מהרשימה הנפתחת של פלטפורמות בעת יצירת כתובת ההרשמה שלך (קבל אותה כאן).
Canvas LMS משתמש בזרימת הגדרה שונה (JSON של תצורת per-developer-key במקום Dynamic Registration). עיין במדריך ההתקנה הייעודי ל-Canvas LMS.
יצירת כתובת URL לרישום 
נווטו להגדרות LTI 1.3
התחברו ל-FastComments ועברו לדף הגדרות LTI 1.3 שלכם.
אם לחשבון שלכם עדיין אין גישה ל-LTI, תראו את ההודעה "LTI not enabled for this account" - פנו לתמיכה כדי להפעיל אותו בתוכנית שלכם.
בחרו פלטפורמה (אופציונלי)
תחת Generate a Dynamic Registration URL, השתמשו בתפריט הנפתח Platform כדי לציין ל-FastComments לאיזה LMS אתם מתחברים:
- D2L Brightspace
- Moodle
- Blackboard Learn
- Sakai
- Schoology
- פלטפורמת LTI 1.3 אחרת
אתם יכולים גם להשאיר אותו על Auto-detect. הפלטפורמה נקראת מה-openid-configuration של ה-LMS שלכם במהלך הרישום; התפריט הנפתח רק מגדיר את התווית המוצגת עבור ההגדרה שתיווצר.
יצירת ה-URL
לחצו על Generate URL. FastComments יוצר אסימון רישום חד-פעמי ומציג לכם URL שנראה כך:
https://fastcomments.com/lti/v1p3/register/<long-token>
העתיקו אותו. URL זה:
- הוא חד-פעמי - ברגע שה-LMS שלכם קורא לו בהצלחה, האסימון נצרך.
- פג תוקפו לאחר 30 דקות אם לא נעשה בו שימוש.
- יש לשמור אותו פרטי - כל מי שמחזיק ב-URL יכול לרשום כלי מול הטננט שלכם בתוך אותן 30 דקות.
הגדרות קיימות
ברגע שרישום מסתיים בהצלחה, ההגדרה החדשה מופיעה בטבלת Existing Configurations באותו דף, עם הפלטפורמה, ה-Issuer, ה-Client ID והסטטוס שלה. ניתן למחוק הגדרות מהטבלה הזו אם תצטרכו לבטל רישום בעתיד.
רישום ב‑D2L Brightspace 
D2L Brightspace חושפת רישום דינמי (Dynamic Registration) דרך ממשק הניהול של LTI Advantage. תזדקקו לגישת מנהל מערכת.
פתיחת מסך הרישום
- התחברו למופע ה-Brightspace שלכם כמנהל מערכת.
- נווטו אל Admin Tools > Manage Extensibility > LTI Advantage.
- לחצו על Register Tool. (כתובת ה-URL הישירה היא
https://<your-brightspace-host>/d2l/le/ltiadvantage/registrations/create.)
הדבקת ה-URL
תראו טופס רישום. השדה המרכזי הוא Tool initiation registration endpoint (בגרסאות מסוימות של Brightspace הוא מסומן כ-"Tool Initiation Registration URL").
הדביקו את כתובת ה-URL לרישום של FastComments (ניתן להשיג אותה כאן) בשדה זה. השאירו את שאר השדות ריקים - הם מאוכלסים אוטומטית על ידי FastComments במהלך תהליך הרישום.
לחצו על Register.
אישור הכלי
Brightspace פותח חלון קופץ שמתקשר עם FastComments, מחליף מפתחות ומציג מסך אישור. החלון הקופץ נסגר מעצמו כאשר הרישום מושלם.
הכלי החדש יופיע ברשימת הכלים של LTI Advantage. כברירת מחדל, Brightspace מסמן כלים חדשים כמושבתים - הפעילו את המתג למופעל כדי שהקורסים שלכם יוכלו להשתמש בו.
הוספת פריסה (Deployment)
ב-Brightspace, כלי LTI זקוקים לפריסה (deployment) לפני שניתן יהיה להשתמש בהם בקורסים:
- פתחו את הכלי החדש של FastComments שנרשם.
- לחצו על View Deployments > New Deployment.
- תנו לפריסה שם (למשל "FastComments - All Courses"), בחרו את יחידות הארגון שבהן היא תהיה זמינה, ושמרו.
לאחר ההפעלה הראשונה דרך פריסה זו, FastComments מקבע את ה-deployment_id ברשומת התצורה שלו - הפעלות נוספות מפריסה אחרת תחת אותו לקוח יידחו אלא אם תבצעו רישום מחדש.
רישום ב‑Moodle 
משתמשים ב‑Moodle? אנו מפרסמים גם תוסף Moodle ייעודי ל‑FastComments עם אינטגרציה צמודה יותר מ‑LTI 1.3 (hooks לסנכרון ציונים, דיווח פעילות מעמיק יותר, ממשק הגדרות מקומי ב‑Moodle). ראה את ה־מדריך התקנת התוסף ל‑Moodle. זרימת LTI 1.3 להלן היא הבחירה הנכונה אם ברצונך רישום יחיד המכסה גם LMSים אחרים, או אם מנהל ה‑Moodle שלך לא יתקין תוספי צד שלישי.
Moodle 4.0+ תומך ברישום דינמי של LTI 1.3 באמצעות התוסף External tool.
פתח את מסך ניהול הכלים
- התחבר ל‑Moodle כמנהל האתר.
- נווט אל Site administration > Plugins > Activity modules > External tool > Manage tools.
הדבק את ה-URL
תראה כרטיס שכותרתו Tool URL. הדבק את כתובת ההרשמה של FastComments (קבל אותה כאן) לתוך שדה הטקסט ולחץ על Add LTI Advantage.
Moodle יפתח מסך רישום המציג את זהות הכלי ואת ההרשאות שהוא מבקש. בדוק ולחץ על Activate (או Register, בהתאם לגרסת Moodle).
חלון הקופץ ייסגר כאשר הרישום יסתיים; כלי FastComments החדש יופיע ברשימת Tools עם הסטטוס Active.
הפוך אותו לזמין
כברירת מחדל Moodle מוסיף כלים חדשים לרשימת "Course tools" אך אינו מציג אותם בבוחר הפעילויות. כדי לחשוף את FastComments בכל הקורס:
- לחץ על סמל גלגל השיניים בכרטיס של FastComments.
- מתחת ל‑Tool configuration usage, בחר Show in activity chooser and as a preconfigured tool.
- שמור.
מרצים יכולים כעת להוסיף את FastComments לכל קורס דרך Add an activity or resource > FastComments.
רישום ב‑Blackboard Learn 
Blackboard Learn SaaS ו-Ultra תומכים ברישום דינמי של LTI 1.3.
פתח את מסך ספק הכלי
- היכנס ל-Blackboard כמנהל מערכת.
- נווט אל Administrator Panel > Integrations > LTI Tool Providers.
- לחץ על Register LTI 1.3 / LTI Advantage Tool.
אם אתה רואה רק "Register LTI 1.1 Provider", גרסת Blackboard שלך עדיין לא תומכת ב-LTI 1.3 — שדרג או פנה לתמיכת Blackboard.
הדבק את ה-URL
הדבק את כתובת ההרשמה של FastComments (השג אותה כאן) אל שדה Client ID / Registration URL (תוויות ב-Blackboard משתנות בין גרסאות). שלח.
Blackboard מבצע את תהליך ה-handshake של ההרשמה עם FastComments ומציג מסך אישור.
אשר והפעל
Blackboard מסמן כלים שנרשמו זה עתה כברירת מחדל כ-Approved but excluded:
- מצא את הרשומה של FastComments ברשימת ספקי הכלים.
- פתח את התפריט ובחר Edit.
- הגדר את Tool Status ל-Approved.
- תחת Institution Policies, עיין אילו נתוני משתמש נשלחים (שם, דוא"ל, תפקיד). שמור.
הכלי כעת זמין למרצים כאשר הם מוסיפים תוכן לקורסים.
רישום ב‑Sakai או Schoology 
Sakai
Sakai תומך ב-LTI 1.3 Dynamic Registration בגרסאות עם LTI Advantage. מתוך Administration Workspace:
- התחברו כמנהל Sakai ופתחו את Administration Workspace.
- בחרו External Tools > Install LTI 1.3 Tool.
- הדביקו את כתובת ההרשמה של FastComments (ניתן להשיג אותה כאן) ושלחו.
- אשרו את הכלי כאשר תהליך ה-handshake מסתיים.
הכלי יופיע לאחר מכן תחת External Tools וניתן להוסיף אותו לאתרים על ידי מנהלי האתרים.
Schoology
מופעי Schoology Enterprise תומכים ב-LTI 1.3, אך זמינות ה-Dynamic Registration משתנה בהתאם לפריסה. בדקו עם מנהל החשבון שלכם ב-Schoology.
אם Dynamic Registration אינו זמין במופע ה-Schoology שלכם, תצטרכו להגדיר את האינטגרציה באופן ידני באמצעות נקודות הקצה הבאות:
- OIDC Login URL:
https://fastcomments.com/lti/v1p3/login - Target Link URL:
https://fastcomments.com/lti/v1p3/launch - Public Keyset URL (JWKS):
https://fastcomments.com/lti/v1p3/jwks - Redirect URLs:
https://fastcomments.com/lti/v1p3/launch
לאחר ש-Schoology מספק לכם Client ID ו-Deployment ID, פנו לתמיכה של FastComments כדי לרשום את ההגדרה בטננט שלכם.
פלטפורמות LTI 1.3 אחרות
כל LMS העוקב אחר המפרט של IMS LTI 1.3 Advantage אמור לעבוד עם אותה כתובת הרשמה (ניתן להשיג אותה כאן). חפשו הגדרה בשם "Dynamic Registration", "Tool Registration URL", "Tool initiation registration endpoint" או דומה לכך.
אם הפלטפורמה שלכם תומכת רק בהגדרה ידנית של LTI 1.3, השתמשו בארבע נקודות הקצה המפורטות בסעיף Schoology למעלה ופנו לתמיכה כדי להשלים את התהליך.
הוספה לתוכן הקורס ב‑D2L 
עמוד זה מסביר כיצד להוסיף את FastComments לקורס ב-Brightspace לאחר שמנהל המערכת רשם את הכלי ויצר פריסה. אם הכלי עדיין לא נרשם, עיין תחילה במדריך הרישום של D2L.
Brightspace מספקת שתי חוויות עריכת תוכן: Classic Content ו-New Content Experience (המכונה גם Lessons). שתיהן מאפשרות שימוש ב-FastComments, אבל מסלולי התפריטים שונים. כל קטע מטה מכסה את שתי הגרסאות כאשר יש הבדל.
אתר את הכלי FastComments
הכלי FastComments מופיע בשני מקומות בתוך עורך התוכן של הקורס:
- ב-picker של פעילויות, הנגיש מתוך כפתור Add Existing של מודול/יחידה (בלגרסאות ישנות של Brightspace מסומן Add Existing Activities). בגרסאות הנוכחיות של Brightspace FastComments מופיע ישירות ב-picker; בגרסאות ישנות הוא מוחבא תחת תת-תפריט External Learning Tools. כל דרך מוסיפה את FastComments כנושא עצמאי.
- בדיאלוג Insert Stuff בתוך עורך ה-HTML, תחת LTI Advantage. זה משבץ את FastComments באופן מוטמע בתוך נושא HTML באמצעות זרימת ה-LTI deep linking.
אם FastComments אינו מופיע באף אחד מה-picker-ים, הפריסה (deployment) אינה מאופשרת עבור יחידת הארגון (org unit) שמכילה את הקורס. בקש ממנהל Brightspace לפתוח Admin Tools > Manage Extensibility > LTI Advantage > כלי FastComments > View Deployments, לפתוח את הפריסה, ולהוסיף את יחידת הארגון של הקורס (או יחידת ארגון אב) תחת Org Units.
הוספת FastComments כנושא במודול
Classic Content:
- פתח את הקורס ולחץ Content בסרגל הניווט.
- בחר את המודול שבו אמור להיות הדיון (או צור אחד דרך Add a module).
- לחץ Add Existing (Brightspace ישן: Add Existing Activities > External Learning Tools).
- ב-picker, לחץ FastComments. Brightspace יוצר נושא במודול ומחזיר אותך לצפיית התוכן.
- לחץ על הנושא החדש. שנה את שמו למשהו תיאורי כמו
FastComments Discussionבאמצעות עורך הכותרת המוטמע.
New Content Experience (Lessons):
- פתח את הקורס ולחץ Content.
- פתח את היחידה והלקח (lesson) שבו אמור להיות הדיון.
- לחץ Add > Existing Activity ובחר FastComments (Brightspace ישן: מקונן תחת External Learning Tools).
- הפעילות מתווספת ללקח.
- לחץ על כותרת הפעילות כדי לשנות את שמה.
בפעם הראשונה שכל משתמש (מרצה או סטודנט) פותח את הנושא, FastComments מאתחל את השרשור (thread) עבור קישור המשאב (resource link) הזה. השרשור קשור ל-resource link ID, כך ששינוי שם או העברה של הנושא לא ישנו את השרשור שנפתח.
שיבוץ FastComments בתוך נושא HTML
השתמש בזרימה זו כאשר אתה רוצה שהתגובות יופיעו מתחת לקריאה, סרטון או תוכן אחר בתוך אותה עמודת נושא במקום כנושא נפרד.
- פתח או צור נושא HTML במודול/לקח.
- לחץ Edit HTML כדי לפתוח את עורך ה-HTML של Brightspace.
- הנח את הסמן במקום שבו צריך להופיע שרשור התגובות.
- לחץ על כפתור Insert Stuff (אייקון פאזל בסרגל העורך).
- בדיאלוג Insert Stuff, גלול ל-LTI Advantage ולחץ FastComments.
- FastComments פותח picker ל-deep linking. אשר את המיקום (האפשרויות המוגדרות כברירת מחדל מתאימות לדיוני תוכן); לחץ Insert או Continue.
- Brightspace יחזור לעורך ה-HTML עם בלוק מציין מקום המייצג את הפעלת ה-LTI. לחץ Save and Close על הנושא.
כאשר הנושא נטען, Brightspace מחליף את ה-placholder ב-iframe שמפעיל את FastComments אוטומטית דרך ה-LTI. הסטודנטים יראו את שרשור הדיון משובץ בתוך ה-iframe של Brightspace.
נושא HTML יחיד יכול להכיל מספר משובצים של FastComments באמצעות deep linking. כל שיבוץ מקבל שרשור נפרד מכיוון שכל deep link מייצר resource link ID שונה.
נושא מודול לעומת קישור מהיר משובץ בתוך הדף
בחר בגישת ה-נושא במודול כאשר:
- הדיון הוא הפעילות הראשית עבור הצעד הזה במודול.
- אתה רוצה שהנושא יופיע בתוכן העניינים של Brightspace, במעקב השלמת פעילויות וב-Class Progress.
בחר בגישת ה-שיבוץ המוטמע כאשר:
- יש למקם את התגובות מתחת לתוכן אחר באותו עמוד.
- אינך רוצה פריט נפרד שניתן לעקוב אחר השלמתו בטבלת התוכן.
נראות, מצב טיוטה ותנאי שחרור
נושא FastComments חדש גלוי לסטודנטים כברירת מחדל. כדי להסתיר אותו בזמן ההגדרה:
- בעורך התוכן, לחץ על כותרת הנושא (Classic) או על תפריט שלוש הנקודות של הפעילות (New Content Experience).
- קבע סטטוס ל-Draft (Classic) או נטר את Visibility לכיבוי (New Content Experience).
נושאי טיוטה אינם ניתנים לצפייה על ידי סטודנטים. מרצים ועוזרי הוראה עדיין רואים אותם עם תג "Draft".
כדי להגביל את הנושא לקבוצה או קטע מסוים:
- פתח את הנושא.
- לחץ על תפריט כותרת הנושא > Edit Properties In-place (Classic) או Edit > Restrictions (New Content Experience).
- תחת Release Conditions, לחץ Create.
- בחר Group enrollment או Section enrollment, בחר את הקבוצה/הסעיף ושמור.
תנאי השחרור מצטברים עם מיפוי התפקידים של FastComments. סטודנטים שאינם יכולים לראות את הנושא לא יקבלו הפעלת LTI.
מה הסטודנטים רואים בהשקה הראשונה
כשהסטודנט לוחץ על הנושא (או טוען נושא HTML עם שיבוץ):
- Brightspace מבצע את הפעלת ה-LTI 1.3 ברקע.
- FastComments מקבל את שם הסטודנט, אימייל, כתובת URL של אווטאר ותפקיד ה-LMS, ומחבר אותם באופן אוטומטי. אין מסך כניסה ל-FastComments.
- שרשור התגובות עבור קישור המשאב נטען בתוך ה-iframe של Brightspace.
מיפוי תפקידים בזמן ההשקה:
- Brightspace
Administratorהופך ל-admin של FastComments עבור השרשור (גישה מלאה למודרציה, מחיקה, חסימה וקונפיגורציה). - Brightspace
Instructorהופך למודרטור (moderator) של FastComments (הצמדה, הסתרה, מחיקה, חסימה). - כל תפקיד אחר (
Learner,TeachingAssistant, וכו') הופך למגיב רגיל.
תגובות מופיעות בשמם של חשבונות Brightspace של הסטודנטים. אם הסטודנט משנה את שמו או אווטאר ב-Brightspace, ההשקה הבאה של ה-LTI מסנכרנת את השינוי.
נעל גישה ציבורית (מומלץ)
ברירת המחדל היא שנתוני התגובות של FastComments ניתנים לקריאה לציבור. כל מי שיכול לנחש את כתובת השרשור או נקודת הקצה של ה-API יכול לצפות בתגובות, גם מחוץ ל-Brightspace. לשיחי קורסים רוב הסיכויים שתרצה להגביל צפייה רק ללומדים הרשומים.
פתח את דף התאמת הווידג'ט ויצר כלל עם האפשרות Require SSO To View Comments מופעלת, ואז הגדר את רמת האבטחה ל-Secure SSO כך ששרשורים יוכלו להיטען רק דרך השקת LTI חתומה.
ראה Protecting Comment Threads With Single-Sign-On להדרכה המלאה, כולל כיצד להגביל את הכלל לדומיין או דף יחיד.
גובה ה-iframe ושינוי גודל
FastComments שולח את הודעת ה-postMessage בשם org.imsglobal.lti.frameResize בכל טעינת שרשור ובשינויים בתוכן (תגובה חדשה, הרחבת תגובות). Brightspace מאזין להודעה זו ומתאים את גובה ה-iframe כך שהשרשור לא ייחתך ולא תופיע גלילה פנימית.
אם ה-iframe נשאר בגובה קצר קבוע:
- אשר שהקורס נטען דרך HTTPS. מאזין ה-postMessage של Brightspace דוחה frames בתוכן מעורב (mixed-content).
- אשר שלא קיימת הרחבת דפדפן שחוסמת את ערוץ ה-postMessage.
- עבור שיבוצים בתוך נושא HTML, ה-HTML המקיף לא יעטוף את ה-iframe בתוך מיכל עם גובה קבוע. הסר כל inline
style="height: ..."מהרכיב ההורה.
בעיות ספציפיות ל-Brightspace
הכלי לא מופיע ב-picker של Add Existing. הפריסה אינה מאופשרת עבור יחידת הארגון של הקורס. מנהל צריך להוסיף את יחידת הארגון (או יחידת אב) לרשימת Org Units של הפריסה. רישום הכלי כשלעצמו לא מספיק; הפריסה קובעת אילו קורסים רואים את הכלי.
שגיאת deployment_id mismatch בעת ההשקה. FastComments מקבע (TOFU) את ה-deployment_id הראשון שהוא רואה עבור ההרשמה. אם מנהל מוחק את הפריסה המקורית ויוצר פריסה חדשה, השקות מהפריסה החדשה נדחות עם שגיאת אי-התאמת פריסה. התיקון הוא לרשום מחדש את FastComments (ליצור כתובת רישום חדשה (קבל אותה כאן) ולהפעיל Dynamic Registration שוב); רשומת הקונפיגורציה הישנה מוחלפת.
הכלי עולה אך מראה "Invalid LTI launch". הקורס נמצא במבנה דייר/ארגון שונה ממה שהפריסה מכסה, או שהפריסה הושבתה אחרי הרישום. בדוק שוב Admin Tools > Manage Extensibility > LTI Advantage > FastComments > מצבי Enabled ורשימת יחידות הארגון של הפריסה.
שמות ותפקידים חסרים בתוך FastComments. Brightspace שולח השקות LTI עם טענות NRPS (Names and Role Provisioning Services). אם קורס שודרג מקישור LTI 1.1 ישן, בהשקה יחסר name ו-email. הוסף מחדש את נושא FastComments דרך Add Existing (אל תעביר/תמיר את הקישור הישן) כדי שההשקה תשתמש ב-LTI 1.3.
השיבוץ מראה מסך כניסה במקום SSO אוטומטי. נושא ה-HTML הוכנס כ-plain <iframe> שמפנה ל-FastComments במקום דרך Insert Stuff > LTI Advantage. iFrames פשוטים מדלגים על השקת ה-LTI ומובילים משתמשים לדף הציבורי של FastComments. מחק את ה-iframe והכנס מחדש דרך זרימת Insert Stuff.
הוספה לתוכן הקורס ב‑Moodle 
המדריך הזה מכסה הוספת FastComments לקורס Moodle 4.x לאחר שמנהל האתר רשם את הכלי והגדיר אותו להצגה בבוחר הפעילות. אם FastComments עדיין לא רשום, עיין תחילה במדריך הרשמת Moodle.
פתח את הקורס במצב עריכה
- היכנס ל-Moodle כמורה בעריכה (Editing Teacher) או ברמה גבוהה יותר עבור הקורס.
- פתח את הקורס.
- הפעל את מצב העריכה (Edit mode) באמצעות המתג בפינה הימנית-עליונה של כותרת הקורס.
Moodle 4.x החליף את תפריט ה"Add an activity or resource" הישן מ-3.x בדיאלוג בוחר פעילויות במסך מלא. ב-Moodle 4.5 נשאר אותו בורר אך נוסף שורת מועדפים/כוכביות בראש, כך שסימון של FastComments פעם אחת הופך אותו לזריז יותר להגיע אליו בחלקים הבאים.
הוסף את פעילות FastComments
- גלול אל המקטע בקורס (נושא או שבוע) שבו השיחה שייכת.
- לחץ על Add an activity or resource בתחתית אותו מקטע.
- בדיאלוג הבורר, בחר FastComments. אם אינך רואה אותו, קפוץ לסעיף הבעיות הנפוצות למטה.
טופס הגדרות הפעילות נפתח. השדות החשובים:
- Activity name (נדרש). מוצג בדף הקורס ובספר הציונים. לדוגמה:
Week 3 Discussion. - Activity description. טקסט מבוא אופציונלי שמוצג מעל שרשור התגובות.
- Show description on course page. סמן אם ברצונך שהתיאור יהיה גלוי ללא צורך בלחיצה לתוך הפעילות.
- Preconfigured tool. מוגדר ל-
FastComments(נבחר אוטומטית כשיופעל מהבורר). אל תשנה. - Launch container. הגדר ל- New window. ראה את סעיף הבעיות הנפוצות להסבר מדוע "Same window" יכול לשבור במטלות Moodle מסוימות.
- Tool URL, Public key, Shared secret, Custom parameters. השאר ריקים. Dynamic Registration טיפל בזה ברמת האתר.
גלול לתחתית ולחץ Save and return to course (או Save and display כדי לפתוח את הפעילות מיד).
הפעילות מופיעה כשורה במקטע עם סמל FastComments. תלמידים ילחצו על השורה כדי לפתוח את שרשור התגובות.
הטמע את FastComments באופן מקומי בתוך העורך
לשרשור בתוך דף (Page), פרק בספר (Book chapter), שיעור (Lesson), או כל משאב אחר שמשתמש בעורך Atto או TinyMCE:
- פתח את המשאב במצב עריכה.
- מקם את הסמן במקום שבו השרשור אמור להופיע.
- בסרגל הכלים של העורך, לחץ על הכפתור LTI / External tool. ב-Atto הוא מסומן "Insert LTI Advantage content". ב-TinyMCE (ברירת המחדל ב-Moodle 4.3+) הוא נמצא תחת תפריט More כ- External tools.
- בחר FastComments מרשימת הכלים.
- FastComments פותח בורר קישורים עמוקים (deep-linking). אשר את כותרת השרשור ולחץ הטמע.
- העורך מכניס בלוק מציין מיקום של LTI. שמור את המשאב.
כל מופע מושתל הוא שרשור נפרד שממופה על פי מזהה פריט הקישור העמוק (deep-link content item ID), כך שדף עם שלושה הטמעות FastComments יקבל שלושה שרשורים עצמאיים.
הגבלת גישה והגדרות קבוצות
הגדרות הפעילות הסטנדרטיות של Moodle חלות על פעילויות FastComments:
- Common module settings > Group mode. קביעה זו ל- Separate groups או Visible groups לא מפרקת את FastComments לשרשורים נפרדים לכל קבוצה מעצמה. מצב הקבוצות של Moodle רק מסנן את ספר הציונים ורשימת החברים. כדי להפעיל שרשור נפרד לכל קבוצה, הוסף פעילות FastComments נפרדת לכל קבוצה והשתמש ב- Restrict access כדי להגביל כל אחת מהן.
- Restrict access > Add restriction. תומך בתנאי Moodle הסטנדרטיים: Date, Grade, Group, Grouping, User profile, וסטים מקוננים של הגבלות. השתמש ב- Group כדי לנעול פעילות FastComments לקבוצה יחידה.
- Activity completion. קבע ל- Students must view this activity to complete it אם ברצונך במעקב השלמה. FastComments כרגע לא מדווח מחדש אירוע השלמה ל-Moodle מעבר להשקה.
מיפוי תפקידים
FastComments קורא את הערעור LTI roles ש-Moodle שולח בכל השקה וממפה אותו כדלהלן:
- Moodle Manager or Site administrator -> FastComments admin
- Moodle Editing teacher or Non-editing teacher -> FastComments moderator
- Moodle Student -> FastComments commenter
- Moodle Guest -> קריאה בלבד
מנהלים יכולים למחוק כל תגובה, לחסום משתמשים ולערוך הגדרות שרשור. Moderators יכולים למחוק ולמאשר תגובות בתוך השרשור שהם השיקו לתוכו. תפקידי Moodle מותאמים אישית יורשים את המיפוי של ארכיטיפ התפקיד ממנו הם נשוכפצו.
מה הסטודנטים רואים
תלמידים לוחצים על פעילות FastComments (או גוללים אל הבלוק המושתל בתוך דף או ספר). Moodle שולח את הזהות שלהם ל-FastComments דרך השקת LTI:
- אין מסך התחברות. FastComments מחבר אותם באמצעות חשבון ה-Moodle.
- שם התצוגה שלהם, הדואר האלקטרוני והאבאטאר מגיעים מ-Moodle.
- השרשור מוקצה ל-(Moodle site, course, resource link ID), כך שהעתקת אותה פעילות לקורס אחר יוצרת שרשור חדש.
- תגובות מקוננות, הצבעות והתראות עובדים כפי שבשרשור עצמאי של FastComments.
נעל את הגישה הציבורית (מומלץ)
ברירת המחדל היא שנתוני התגובות של FastComments ניתנים לקריאה ציבורית. כל מי שיכול לנחש את כתובת ה-URL של שרשור או את ה-API endpoint שלו יכול לצפות בתגובות, אפילו מחוץ ל-Moodle. עבור שיחות קורס סביר להניח שתרצה להגביל צפייה רק לסטודנטים הרשומים.
פתח את דף התאמת הווידג'ט וצור כלל עם Require SSO To View Comments מופעל, ואז קבע את רמת האבטחה ל- Secure SSO כך שניתן יהיה לטעון שרשורים רק דרך השקת LTI חתומה.
ראה Protecting Comment Threads With Single-Sign-On למדריך מלא, כולל איך להגביל את הכלל לדומיין או לדף יחיד.
בעיות נפוצות ב-Moodle
FastComments חסר מבוחר הפעילויות. מנהל האתר רשם את הכלי אך לא קבע את Tool configuration usage ל- Show in activity chooser and as a preconfigured tool. תיקון זה תחת Site administration > Plugins > Activity modules > External tool > Manage tools > סמל הגלגל על האריח של FastComments.
ההשקה נכשלת או מציגה מסגרת ריקה כשהמיכל מוגדר ל-"Same window". עוגיות הסשן של Moodle משתמשות ב-SameSite=Lax כברירת מחדל, וחלק מהדפדפנים מסירים אותן ב-POST החוצה לאתר ש-LTI 1.3 משתמש בה כדי לחזור מ-FastComments. הגדר את Launch container ל- New window בפעילות. זהו דרישה קשה עבור הטמעות FastComments בתוך דף או ספר, מכיוון שדרך ההשקה המושתלת של העורך תמיד פותחת חלון חדש.
טענת ה-iss היא ה-URL של אתר ה-Moodle, לא מזהה שוכר (tenant ID). FastComments משתמש בכתובת האתר של Moodle (ערך התצורה wwwroot) כמנפיק (issuer) של LTI. אם ה-instance של Moodle שלך עובר לדומיין חדש או תשנה את wwwroot, השרשורים הקיימים של FastComments יישארו קשורים למנפיק הישן ולא יתאימו להשקות החדשות. רשם מחדש את הכלי מול ה-URL החדש והעבר שרשורים דרך ניהול FastComments במידת הצורך.
גיבוי ושחזור של פעילות. גיבוי של קורס ושחזור שלו לקורס חדש יוצר מזהי resource link חדשים, כך שהפעילויות המשוחזרות של FastComments יתחילו עם שרשורים ריקים. הקורס המקורי שומר על השרשורים המקוריים. זה התנהגות מכוונת, לא באג.
Moodle 4.5 TinyMCE כברירת מחדל. Moodle 4.5 מגיע עם TinyMCE כברירת מחדל בהתקנות חדשות. מיקום כפתור ה-External tool נמצא תחת תפריט More (...) במקום בסרגל הכלים הראשי. אתרים ישנים ששודרגו מ-4.1 שומרים על Atto אלא אם מנהל שינה את ברירת המחדל.
הוספה לתוכן הקורס ב‑Blackboard 
לאחר שמנהל מערכת רשם את FastComments ככלי LTI 1.3 Advantage ואישר את מדיניות המוסד, מרצים מוסיפים אותו לקורסים דרך נקודות ההצבה הסטנדרטיות של Blackboard. השלבים המדויקים שונים בין Ultra Course View ל-Original Course View, ולכן שניהם מתוארים להלן.
Ultra Course View
Ultra Course View הוא ברירת המחדל ב-Blackboard Learn SaaS החל מ-2026.
- פתחו את הקורס ועברו לדף Course Content.
- רחפו או הקישו במקום שבו אתם רוצים ששרשור התגובות יופיע במתאר, ולחצו על כפתור ה-+ הסגול (הוספת תוכן).
- בחרו Content Market. פאנל ה-Content Market מציג את כל כלי ה-LTI המאושרים והצבות ה-Building Block של המוסד שלכם.
- מצאו את האריח של FastComments ולחצו עליו. Blackboard יוצר פריט תוכן במיקום שבו פתחתם את תפריט ה-+.
- הפריט מופיע במתאר כרשומה "Visible to students" כברירת מחדל עבור מרצים שהגדירו Hide from students ככבוי בברירת המחדל האישית שלהם. אם ברירת המחדל שלכם היא Hidden, הפריט נוצר מוסתר ותוכלו להפוך את בורר הנראות בשורת הפריט כשתהיו מוכנים.
- כדי לשנות את שם הפריט, לחצו על הכותרת במתאר והקלידו תווית חדשה. הכותרת שהסטודנטים רואים במתאר היא בלתי תלויה במזהה השרשור של FastComments, ולכן שינוי שם בטוח בכל עת.
אם אינכם רואים את Content Market כאפשרות, המוסד שלכם הסתיר את ההצבה. ניתן להגיע לאותו בורר גם דרך More tools באותו תפריט + תחת קבוצת LTI Tools.
Original Course View
Original Course View עדיין נתמך ב-Learn SaaS ונשאר החוויה העיקרית עבור אתרי Learn 9.1 המתארחים בעצמם בקו המהדורה Q4 2024 CU.
- פתחו את הקורס והיכנסו ל-Content Area (למשל, אזור Information או Content המוגדר כברירת מחדל בתפריט הקורס).
- הפעילו את Edit Mode באמצעות המתג בפינה השמאלית העליונה של הדף.
- לחצו על Build Content בסרגל הפעולות.
- תחת תפריט המשנה Learning Tools, לחצו על FastComments. תפריט המשנה Learning Tools מאוכלס מהצבות כלי LTI 1.3 לאחר שמנהל רושם את הכלי. אם אינכם רואים אותו, עיינו בסעיף הבעיות המוכרות להלן.
- בטופס Create FastComments, הגדירו:
- Name: התווית שהסטודנטים רואים באזור התוכן.
- Description: טקסט אופציונלי המוצג מעל השרשור המוטמע.
- Permit Users to View this Content: מתג זמינות כן/לא.
- Track Number of Views: הפעילו אם אתם רוצים את סטטיסטיקות הצפיות הפר-פריט של Blackboard. FastComments מפעיל ניתוח נתונים משלו באופן עצמאי.
- Date and Time Restrictions: חלונות Display After / Display Until אופציונליים.
- שלחו. הכלי מופיע כפריט לחיץ באזור התוכן.
הטמעה בתוך פריט או מסמך
בשני מצבי הקורס, מרצים מטמיעים את FastComments בתוך גוף של פריט, מסמך או כל שדה טקסט עשיר באמצעות כפתור ה-LTI Advantage של עורך התוכן.
Ultra Course View:
- צרו או ערכו Document.
- לחצו על Add content בתוך גוף המסמך במקום שבו אתם רוצים שהשרשור יופיע.
- בסרגל הכלים של העורך, פתחו את תפריט Insert content ולחצו על Content Market (נקודת הכניסה של LTI Advantage / Deep Linking).
- בחרו FastComments. FastComments מחזיר מטען deep-link ו-Blackboard מכניס בלוק מוטמע בגוף המסמך במיקום הסמן.
- שמרו את המסמך. הסטודנטים רואים את השרשור מוצג בתוך הזרימה כשהם גוללים על פניו.
Original Course View:
- ערכו כל פריט עם גוף טקסט עשיר.
- בסרגל הכלים של עורך התוכן, לחצו על סמל הפלוס Add Content ובחרו Content Market (מסומן Add Content from External Tool בגרסאות Q4 2024 CU ישנות יותר).
- בחרו FastComments. העורך מכניס בלוק placeholder המפנה למשאב ה-deep-linked.
- שלחו את הפריט.
כל הטמעת deep-link מייצרת שרשור FastComments משלה, ולכן פריט עם שני בלוקים מוטמעים של FastComments מכיל שני זרמי תגובות עצמאיים.
נראות, תנאי שחרור והגבלות קבוצות
פריטי תוכן של FastComments מתנהגים כמו כל פריט תוכן אחר של Blackboard מבחינת כללי בקרת הגישה המרובבים עליהם.
- Ultra: לחצו על בורר הנראות בשורה (Visible to students, Hidden from students, Conditional availability). Conditional availability תומך בחלונות תאריך/שעה, כללי ביצועים מול פריטי ציונים, וכללי חברים מול קבוצות קורס.
- Original: פתחו את תפריט ההקשר של הפריט ובחרו Adaptive Release או Adaptive Release: Advanced כדי להגביל את הכלי לפי תאריך, חברות, ציון או סטטוס סקירה. השתמשו ב-Set Group Availability בפריט כדי להגביל לקבוצות קורס ספציפיות.
FastComments מכבד את מה שהשער של Blackboard מחליט. אם Blackboard מסתיר את הפריט מסטודנט, ההשקה של LTI לא מתרחשת עבור אותו סטודנט והוא לא מופיע בתצוגת המנחה.
התנהגות ספר הציונים
FastComments אינו מדווח ציונים חזרה דרך LTI Advantage Assignment and Grade Services. לא נוצרת באופן אוטומטי עמודת ציונים עבור פריטי תוכן של FastComments.
אם ה-tenant של Blackboard שלכם מוגדר ליצור עמודת ציונים באופן אוטומטי עבור כל פריט תוכן חדש ללא קשר למטא-נתוני ההערכה, עמודה ריקה תופיע בכל זאת. כדי להסתיר אותה:
- Ultra: פתחו את Gradebook, לחצו על כותרת העמודה, בחרו Edit, וכבו את Show to students וגם Include in calculations. או השתמשו ב-Delete אם המוסד שלכם מתיר מחיקת עמודות עבור פריטים ללא הערכה.
- Original: פתחו את Grade Center, לחצו על החץ של העמודה, בחרו Hide from Users (on/off), ובאופן אופציונלי Hide from Instructor View תחת Column Organization.
מה סטודנטים רואים
כאשר סטודנט פותח את פריט FastComments או גולל לבלוק מוטמע:
- Blackboard משיק את הודעת ה-LTI 1.3 אל FastComments. הסטודנט מחובר באמצעות SSO עם זהות ה-Blackboard שלו (שם, אימייל, אווטאר, תפקיד) מבלי לראות טופס התחברות.
- שרשור התגובות מוצג ב-iframe. שרשור, תגובות, אזכורים ותגובות רגש זמינים כולם בהתאם להגדרות ווידג'ט התגובות שהוגדרו ב-FastComments.
- התגובות שלו מיוחסות לחשבון ה-Blackboard שלו. אם הסטודנט עורך את שמו או תמונתו ב-Blackboard מאוחר יותר, ההשקה הבאה מעדכנת את הפרופיל ב-FastComments.
מיפוי תפקידים מ-Blackboard ל-FastComments:
- System Administrator ו-Course Builder ממופים ל-admin של FastComments.
- Instructor ו-Teaching Assistant ממופים ל-moderator של FastComments.
- Student, Guest ו-Observer ממופים ל-commenter של FastComments.
מנחים רואים פקדי ניהול (נעיצה, הסתרה, חסימה, מחיקה) בתוך הזרימה על כל תגובה בשרשור.
נעילת גישה ציבורית (מומלץ)
כברירת מחדל, נתוני התגובות של FastComments קריאים לציבור. כל מי שיכול לנחש את ה-URL של שרשור או נקודת קצה של API יכול לצפות בתגובותיו, גם מחוץ ל-Blackboard. עבור דיוני קורס כמעט בוודאות תרצו להגביל את הצפייה לסטודנטים רשומים בלבד.
פתחו את דף התאמת הווידג'ט שלכם וצרו כלל עם Require SSO To View Comments מופעל, ואז הגדירו את רמת האבטחה ל-Secure SSO כך ששרשורים ייטענו רק דרך השקת ה-LTI החתומה.
ראו Protecting Comment Threads With Single-Sign-On להדרכה המלאה, כולל כיצד להגביל את הכלל לדומיין או דף בודד.
היקף שרשורים
FastComments מגדיר את היקף כל שרשור לפי (מארח Blackboard, מזהה קורס, מזהה resource link). שני פריטי FastComments באותו קורס מייצרים שני שרשורים. אותו פריט שהועתק בין שני קונכיות קורס (למשל, דרך העתקת קורס) מייצר שני שרשורים, מכיוון ש-Blackboard מנפיק מזהה resource link חדש במהלך ההעתקה. כדי לשמור שרשור משותף על פני העתקות קורס, השתמשו ב-Deep Linking עם URN שרשור מפורש שהוגדר ב-FastComments לפני השקת ההעתקה.
בעיות מוכרות ספציפיות ל-Blackboard
אריח FastComments חסר בתפריט Build Content (Original) או ב-Content Market (Ultra). מנהל המערכת אישר את הכלי אך השאיר מדיניות מוסדית שחוסמת את ההצבה הרלוונטית. עברו אל Administrator Panel > Integrations > LTI Tool Providers, ערכו את הרשומה של FastComments, וודאו ששתי ההצבות Course Content Tool (Original) ו-Course Content Tool - allow students / Deep Linking content tool (Ultra) מופעלות. שמרו ורעננו את דף הקורס.
שגיאת "Tool not configured for this context" או "Tool is not deployed" בהשקה. היקף ה-deployment שנרשם במהלך הרישום הדינמי אינו תואם להקשר המוסדי שאליו שייך הקורס. ברשומת ספק הכלים של Blackboard, ודאו שה-Deployment ID תואם למה ש-FastComments מציג בדף ההגדרות LTI 1.3 שלו עבור tenant זה. אם הם שונים, מחקו את ההצבה והריצו רישום דינמי מחדש מ-URL רישום טרי (קבלו אותו כאן).
גובה ה-iframe נראה קבוע או שהתוכן נחתך. חלק מה-tenants של Blackboard מגיעים עם מדיניות Content Security Policy מחמירה שחוסמת את הודעת ה-postMessage המובנית של שינוי גודל ה-iframe של LTI. FastComments פולט גם את הודעת lti.frameResize בסגנון Canvas וגם את הודעת org.imsglobal.lti.frameResize לפי מפרט IMS כדי למקסם תאימות, אך עקיפת CSP ברמת tenant חוסמת את המאזין בהורה. בקשו ממנהל המערכת לוודא ש-*.fastcomments.com נמצא ברשימת ההיתרים של כלי ה-LTI ושאין כותרת CSP מותאמת שמסננת אירועי postMessage. לאחר מכן שינוי הגודל עובד ללא הגדרה נוספת.
העתקת קורס משכפלת שרשורים. העתקת קורס של Blackboard מנפיקה מזהי resource link חדשים עבור הצבות LTI, ולכן קורסים מועתקים מתחילים עם שרשורים ריקים. זה צפוי. אם אתם צריכים שהקורס המועתק ירש את השרשור המקורי, הגדירו Deep Linking עם URN שרשור מפורש לפני ההעתקה, או פנו לתמיכת FastComments למיפוי מחדש של מזהי שרשורים בכמות גדולה.
סטודנט רואה שגיאת Blackboard כללית בהשקה. הסיבה היא claim של email חסר או לא עדכני. ודאו שמדיניות המוסד עבור FastComments מפעילה Role, Name ו-Email Address תחת User Fields to Send. שמרו, ואז השיקו שוב בסשן דפדפן טרי.
הוספה לתוכן הקורס ב‑Sakai או Schoology 
לאחר ש-FastComments נרשם בפלטפורמה, מדריכים מוסיפים אותו לתוכן הקורס באמצעות זרימות כלי חיצוני סטנדרטיות של הפלטפורמה. עמוד זה מכסה את Sakai 23.x ו-Schoology Enterprise.
נעילת גישה ציבורית (מומלץ)
כברירת מחדל, נתוני התגובות של FastComments קריאים לציבור בשתי הפלטפורמות. כל מי שיכול לנחש את ה-URL של שרשור או נקודת קצה של API יכול לצפות בתגובותיו, גם מחוץ ל-Sakai או Schoology. עבור דיוני קורס כמעט בוודאי תרצו להגביל את הצפייה לסטודנטים רשומים בלבד.
פתחו את עמוד התאמה אישית של הווידג'ט וצרו כלל עם Require SSO To View Comments מופעל, ואז הגדירו את רמת האבטחה ל-Secure SSO כך ששרשורים ייטענו רק דרך השקת ה-LTI החתומה.
ראו הגנה על שרשורי תגובות באמצעות Single-Sign-On להדרכה המלאה, כולל כיצד להגביל את הכלל לדומיין או עמוד בודדים.
Sakai
1. הוספת FastComments לאתר
מנהל האתר מפעיל את הכלי על בסיס אתר-אתר:
- פתחו את האתר ולחצו על Site Info בניווט השמאלי.
- לחצו על Manage Tools.
- גללו לרשימת External Tools והפעילו את FastComments.
- לחצו על Continue, סקרו את רשימת הכלים, ואז לחצו על Finish.
FastComments מופיע כעת כפריט ניווט שמאלי באתר.
2. סידור מחדש של פריט הניווט השמאלי
עברו אל Site Info > Tool Order. גררו את FastComments למיקום הרצוי ולחצו על Save. ניתן גם לשנות את שם התווית בניווט ולהסתיר אותה מסטודנטים ממסך זה.
3. הטמעה בתוך עמוד Lessons
כדי למקם את FastComments בתוך עמוד Lessons ישירות, במקום ככלי ניווט שמאלי עצמאי:
- פתחו את כלי ה-Lessons באתר.
- לחצו על Add Content > Add External Tool.
- בחרו FastComments מהרשימה.
- אם FastComments פרסם Deep Linking במהלך הרישום, Sakai פותח את בורר התוכן של הכלי כדי שתוכלו לבחור או לתייג את השרשור. אם Deep Linking לא פורסם, Sakai מכניס קישור השקה ברירת מחדל.
- שמרו את פריט ה-Lessons.
לכל מופע מוטמע יש שרשור משלו, המוגבל לקישור המשאב ההוא.
4. התאמות הרשאות לגישת סטודנטים
Sakai מווסת השקות של כלים חיצוניים באמצעות Realms. כדי לוודא שסטודנטים יכולים להפעיל את FastComments:
- התחברו כמנהל Sakai ופתחו Administration Workspace > Realms.
- פתחו את ה-realm הרלוונטי (למשל,
!site.template.courseאו ה-realm של האתר הספציפי). - ודאו שלתפקיד
accessישlti.launchמופעל ושהרשאות התפקיד בקבוצת external.tools הוענקו. - שמרו את ה-realm.
לעקיפות ברמת האתר, מנהל האתר יכול להתאים את נראות הכלי לפי תפקיד מ-Site Info > Tool Order על ידי הסתרה או הצגה של FastComments לכל תפקיד.
5. מה סטודנטים רואים
סטודנטים לוחצים על פריט הניווט השמאלי של FastComments (או גוללים לבלוק ה-Lessons המוטמע) ומגיעים ישירות לתצוגת התגובות המשורשרות. ה-SSO אוטומטי: Sakai שולח את זהות המשתמש בהשקת ה-LTI ו-FastComments מחבר אותם תחת חשבון ה-Sakai שלהם.
מיפוי תפקידים:
- Sakai
Instructor-> FastComments מנחה (moderator) - Sakai
Admin(מנהל ב-Administration Workspace) -> FastComments מנהל - Sakai
Student/access-> FastComments מגיב
6. מלכודות ב-Sakai
- הכלי לא מופיע ב-Manage Tools. אם FastComments לא מופיע ברשימת External Tools, מנהל ה-Sakai צריך לפתוח את רישום הכלים (Administration Workspace > External Tools > FastComments) ולהגדיר Stealthed ל-
false. כלים Stealthed מוסתרים מבורר Manage Tools ברמת האתר. - השקות שנכשלות בדפדפנים עם סשן משותף. אסימון ה-CSRF של פורטל Sakai קשור לסשן הדפדפן. אם סטודנט מחובר לשני אתרי Sakai בטאבים שונים או שיש לו סשן מיושן, ההשקה מחזירה 403. פתרון: סגרו טאבים אחרים של Sakai, התנתקו, התחברו מחדש, והפעילו שוב. מנהלים יכולים גם להעלות את
sakai.csrf.token.cache.ttlאם זה קורה ברמת הקלאסטר. - הטמעה במסגרת. ודאו ש-
lti.frameheightב-sakai.propertiesגדול מספיק (600 ומעלה) כדי ששרשור התגובות לא ייחתך בתוך עמוד Lessons.
Schoology
ל-Schoology Enterprise יש שני תרחישי התקנה. ודאו איזה מהם חל לפני הוספת הכלי לקורס.
1. שני תרחישי התקנה
- (a) התקנה ברמת Enterprise. מנהל המערכת של Schoology התקין את FastComments ברמת הארגון והקצה אותו לכל הקורסים או לתבניות קורס ספציפיות. מדריכים מדלגים על ההתקנה ועוברים ישירות ל-"Add Materials".
- (b) התקנה עצמית של המדריך. המדריך מתקין את הכלי לקורס בודד מ-Course Options > External Tools > Install LTI Apps. התקנה עצמית דורשת שמנהל המערכת אישר קודם את אפליקציית FastComments ברמת הארגון.
2. הוספת FastComments כחומר קורס
בתוך הקורס:
- פתחו את הקורס ועברו אל Materials.
- לחצו על Add Materials > Add File/Link/External Tool.
- בחרו External Tool.
- בחרו FastComments מרשימת הכלים הרשומים.
- הגדירו Name (זה מה שסטודנטים רואים ברשימת החומרים) ו-Description אופציונלי.
- השאירו את Enable Grading (העברת ציונים) כבוי. FastComments אינו מדווח ציונים חזרה ל-Schoology, ולכן הפעלת העברת ציונים יוצרת עמודה ריקה במחברת הציונים.
- לחצו על Submit.
החומר מופיע כעת ברשימת חומרי הקורס ופותח את שרשור FastComments בלחיצה.
3. הטמעה בתוך השורה באמצעות עורך ה-Rich Text
אם מנהל המערכת הפעיל מיקום Deep Linking עבור FastComments במהלך הרישום, מדריכים יכולים להטמיע את שרשור התגובות בתוך כל שדה Rich Text (הוראות מטלה, גופי עמודים, פרומפטים לדיון):
- פתחו את עורך ה-Rich Text בעמוד היעד.
- לחצו על סמל External Tool (חתיכת פאזל) בסרגל הכלים.
- בחרו FastComments.
- הגדירו את ההטמעה בדיאלוג ה-deep-linking ולחצו על Insert.
- שמרו את העמוד.
אם כפתור External Tool לא מופיע בעורך ה-Rich Text, Deep Linking מושבת עבור הכלי הזה בטננט הזה. ראו את המלכודות למטה.
4. נראות והקצאות סקשנים
Schoology מגביל זמינות כלים לפי סקשן באמצעות Course Options:
- מהקורס, לחצו על Course Options > External Tools.
- עבור כל אפליקציית LTI מותקנת, אתם שולטים האם היא זמינה לכל הסקשנים בקורס או לסקשנים ספציפיים.
- כדי להגביל את FastComments לסקשנים מסוימים, בטלו את הסימון של הסקשנים שלא אמורים לראות את הכלי.
- גישה ברמת סקשן גם קובעת אילו סקשנים רואים את הפריט Add Materials > External Tool עבור FastComments.
5. מה סטודנטים רואים
סטודנטים לוחצים על החומר של FastComments (או גוללים להטמעה בתוך השורה) ומגיעים לדיון המשורשר. ה-SSO אוטומטי דרך השקת ה-LTI של Schoology תחת חשבון ה-Schoology שלהם.
מיפוי תפקידים:
- Schoology
Administrator-> FastComments מנהל - Schoology
Instructor-> FastComments מנחה (moderator) - Schoology
Student-> FastComments מגיב
6. מלכודות ב-Schoology
- Enterprise בלבד. חשבונות Schoology אישיים וחינמיים אינם יכולים להתקין כלי LTI 1.3. אם הטננט שלכם ברמה החינמית, האפשרות External Tools חסרה ב-Course Options. שדרגו ל-Schoology Enterprise כדי להשתמש ב-FastComments.
- Deep Linking מושבת כברירת מחדל בטננט. חלק מטננטים של Schoology מגבילים מיקום Deep Linking ברמת הארגון. כשזה המצב, מדריכים רואים רק את זרימת Add Materials > External Tool ולא את כפתור External Tool בעורך ה-Rich Text. כדי לאפשר הטמעה בתוך השורה, מנהל המערכת עובר אל System Settings > Integration > LTI 1.3 > FastComments ומפעיל את מיקום Content Item / Deep Linking, ואז שומר.
- עקיפת הקצאה ברמת סקשן. אם FastComments מוקצה ברמת הארגון אך המדריך אינו רואה אותו ב-Add Materials, הסקשן של הקורס נכלל בשלילה בהקצאה ברמת הארגון. בקשו ממנהל המערכת להוסיף את הסקשן להקצאת אפליקציית FastComments.
- שם החומר מול זהות השרשור. שינוי שם החומר ב-Schoology אינו מזיז את שרשור התגובות. שרשורים ממופתחים לפי מזהה קישור המשאב של ה-LTI, ולכן שינוי שם שומר על אותו שרשור; מחיקה ויצירה מחדש של החומר יוצרת שרשור חדש וריק.
פתרון בעיות 
"אסימון הרישום לא נמצא, פג תוקפו, או כבר נוצל"
האסימון בכתובת הרישום שלכם (קבלו אותו כאן) תקף למשך 30 דקות וניתן לשימוש חד-פעמי בלבד. אם ה-LMS שלכם לקח יותר זמן מכך, או אם הרישום נוסה שוב לאחר שהצליח, האסימון יידחה. צרו כתובת חדשה בעמוד הגדרות LTI 1.3 של FastComments והתחילו מחדש.
"הפלטפורמה דחתה את הרישום"
ה-LMS שלכם סירב לביצוע ידנית הרישום. הסיבות הנפוצות ביותר:
- הכלי כבר רשום עם אותו שם לקוח. חלק מהפלטפורמות (בעיקר D2L) דוחות רישום שני של "FastComments" עד שהרישום הקודם יימחק. הסירו את הכלי הישן ב-LMS שלכם ואז נסו שוב.
- שדה שגוי ב-LMS. ודאו שהדבקתם את הכתובת בשדה registration / tool initiation registration endpoint, ולא בשדה כתובת ההפעלה (launch URL) או כתובת ההתחברות (login URL).
- ה-LMS למעשה אינו תומך ברישום דינמי (Dynamic Registration). גרסאות ישנות יותר של Moodle ו-Blackboard מצהירות על תמיכה ב-LTI 1.3 אך מאפשרות רק הגדרה ידנית. בדקו את התיעוד של הפלטפורמה שלכם.
"נכשל באחזור תצורת הפלטפורמה"
FastComments לא הצליח לקרוא את מסמך ה-openid-configuration של ה-LMS שלכם. זה נדיר ובדרך כלל משמעותו שה-LMS סיפק כתובת גילוי (discovery URL) פגומה או בלתי נגישה. פנו לתמיכה של ה-LMS שלכם.
ההפעלה מציגה "Configuration not found"
או שהתצורה ב-FastComments נמחקה, או שההפעלה הגיעה מזוג iss/client_id שאינו מוכר לנו. אם מחקתם ורשמתם מחדש, הנחו את ה-LMS שלכם להסיר ולהוסיף מחדש את הכלי של FastComments כדי שיקבל את ה-client_id החדש.
ההפעלה מציגה "Deployment not registered"
הפעלתם את FastComments מהפעלה (deployment) של Brightspace/Moodle/Blackboard שונה מזו שממנה הוא הופעל בפעם הראשונה. FastComments קובע את ה-deployment_id בהפעלה הראשונה כבדיקת אבטחה. כדי להוסיף הפעלה חדשה תחת אותו לקוח, פנו לתמיכה - נוסיף את מזהה ההפעלה (Deployment ID) לתצורה.
ההפעלה מציגה "Unsupported message_type"
ה-LMS שלח הודעת LTI ש-FastComments אינו תומך בה (למשל LtiSubmissionReviewRequest). FastComments תומך רק בזרימות ההפעלה הסטנדרטיות של resource-link ו-deep-linking. פנו אלינו אם אתם זקוקים להוספת סוג הודעה ספציפי.
ה-iframe אינו מתאים את גודלו
רוב מערכות ה-LMS מתאימות אוטומטית את גודל ה-iframe של LTI. אם המערכת שלכם לא עושה זאת, בדקו שהגדרות ההפעלה של ה-LMS מאפשרות לכלי לשלוח אירועי postMessage למסגרת האב. FastComments שולח הודעות שינוי גודל הן בסגנון Canvas (lti.frameResize) והן לפי תקן IMS (org.imsglobal.lti.frameResize).
מינימום הרשאות והפחתת נתונים 
אינטגרציית ה-LTI 1.3 של FastComments פועלת על פי עקרון ההרשאה המינימלית: היא משתמשת רק בטענות (claims) של ההשקה הדרושות לזיהוי המשתמש, לקישור התגובות לקורס ולמשאב הנכונים, ולהחלת הרשאות מבוססות תפקידים.
שאר הדף מפרט כל טענה שהאינטגרציה צורכת, כל שירות LTI Advantage שהיא אינה מבקשת, וכל קטגוריית נתונים שהיא אינה אוספת. סוקרי אבטחה ורכש יכולים להסתמך ישירות על הטבלאות למטה.
רכיבי נתונים המתקבלים מה-LMS
כל השקת LTI 1.3 כוללת JWT חתום מה-LMS. FastComments מחלץ את הטענות הבאות מה-JWT ואינו משתמש בדבר נוסף:
| שדה | טענת LTI | מטרה | נדרש | נשמר |
|---|---|---|---|---|
| מזהה משתמש | sub | מזהה את המשתמש באופן עקבי בין השקות כך שאותו אדם ממופה לאותו משתמש SSO של FastComments | כן | כן, כחלק ממזהה SSO פנימי יציב |
| שם לתצוגה | name | ייחוס המוצג לצד התגובות של המשתמש | כן (עם ברירת מחדל "LMS User" אם חסר) | כן |
| דוא"ל | email | התאמת חשבונות, התראות, ניהול תגובות, התכתבות תמיכה | אופציונלי (האינטגרציה עובדת גם בלעדיו) | כן כאשר מסופק |
| כתובת URL של אווטאר | picture | מוצג לצד התגובות של המשתמש | אופציונלי | כתובת URL בלבד; FastComments אינו מוריד או מאחסן מחדש את התמונה |
| תפקידים | https://purl.imsglobal.org/spec/lti/claim/roles | קובע אם המשתמש הוא מנהל מערכת, מרצה (מנחה/מנהל תגובות) או לומד | כן | דגלי isAdmin / isModerator נגזרים בסשן ה-SSO |
| הקשר קורס | https://purl.imsglobal.org/spec/lti/claim/context (id, title) | מקשר את שרשור התגובות לקורס הנכון ב-LMS | כן | כן, כחלק ממזהה העמוד המפוענח |
| קישור משאב | https://purl.imsglobal.org/spec/lti/claim/resource_link (id) | מקשר תגובות לפעילות או למיקום הכלי הנכון בתוך הקורס | כן כאשר קיים | כן, כחלק ממזהה העמוד המפוענח |
| מזהה פריסה | https://purl.imsglobal.org/spec/lti/claim/deployment_id | מנתב את ההשקה לתצורת הטננט הנכונה של FastComments | כן | כן, ברשומת התצורה של FastComments LTI |
טענות והיקפים המוצהרים בעת הרישום
במהלך רישום דינמי של LTI 1.3, FastComments רושם את עצמו עם scope: "" (ללא היקפי OAuth נוספים) ומצהיר רק על טענות OpenID Connect אלה:
iss, sub, name, email, picture
הוא רושם שני סוגי הודעות:
LtiResourceLinkRequest- ההשקה הסטנדרטית לקורס אל FastComments.LtiDeepLinkingRequest- מאפשר למרצים למקם את הכלי של FastComments בתוך קורס.
לא מתבקשים אסימוני גישה נוספים מה-LMS.
שירותי LTI Advantage שאינם מבוקשים
| שירות / היקף | מבוקש? | סיבה |
|---|---|---|
| Names and Role Provisioning Services (NRPS) | לא | האינטגרציה אינה זקוקה לרשימת משתתפי הקורס; זהות המשתמש מגיעה עם כל השקה |
| Assignment and Grade Services (AGS) - היקפי lineitem, score, result | לא | האינטגרציה אינה מודעת למחווני הערכה |
| Deep Linking מעבר להחזרה הסטנדרטית של המיקום | ללא נתונים נוספים | Deep Linking משמש רק למיקום הכלי על ידי מרצים; אין מנייה של תוכן קורס |
נתונים שאינם נאספים
מעבר ל-LTI עצמו, FastComments אינו מבקש או מקבל מה-LMS או מהמשתמש את הפריטים הבאים:
| קטגוריה | נאסף? |
|---|---|
| ציוני סטודנטים | לא |
| הגשות מטלות | לא |
| רישומי נוכחות | לא |
| רשימות מלאות של משתתפי קורס | לא |
| מזהים ממשלתיים | לא |
| תאריך לידה | לא |
| כתובת דואר או מספר טלפון | לא |
| מידע פיננסי | לא |
| אישורי מנהלי ה-LMS | לא |
גבולות גישה
- FastComments מקבל נתונים רק בתוך השקת LTI 1.3 מורשית החתומה במפתחות הרשומים של ה-LMS. האינטגרציה אינה קוראת בחזרה ל-LMS לקבלת מידע נוסף.
- אסימוני השקה הם לשימוש חד-פעמי וקצרי מועד. אסימונים ששוחזרו או שפג תוקפם נדחים.
- מנהלי ה-LMS שולטים במקומות שבהם הכלי נפרס בתוך הפלטפורמה שלהם. לדוגמה, D2L Brightspace תומך בהגדרת היקף לפי יחידה ארגונית (org-unit) לכל פריסה ובהגדרות אבטחה לכל פריסה, מה שמאפשר למנהלים להגביל את הכלי לקורסים או ליחידות ארגוניות ספציפיות במקום להפוך אותו לזמין באופן גלובלי. Moodle, Blackboard, Sakai ו-Schoology מציעים בקרות דומות לכל פריסה ביישומי ה-LTI 1.3 שלהם.
אחסון ושמירה
FastComments שומר נתונים שנגזרו מ-LTI למשך תקופת הפעלת שירות התגובות ובהתאם להגדרות השמירה שהוגדרו על ידי הלקוח. נתוני התגובות נשמרים באחסון ייצור מוצפן במנוחה. בעת סגירת חשבון או בקשת מחיקה בכתב, FastComments מוחק או מאלחש נתוני לקוח בהתאם להסכם החל.
לפרטים מלאים על אחסון וטיפול בנתונים, ראו את מדיניות הפרטיות של FastComments.
קצב סקירה
כל תכונת LTI חדשה שתדרוש טענות, היקפים או שירותי LTI Advantage נוספים נבחנת לפני השחרור כדי לוודא שהגישה המבוקשת הכרחית ומידתית לתכונה המשוחררת.
הצהרה קצרה לשאלוני אבטחה
FastComments מיישם הרשאה מינימלית ומזעור נתונים באינטגרציית ה-LTI 1.3 שלו. האינטגרציה משתמשת רק בטענות ההשקה של LTI הדרושות לאימות המשתמש (
sub,name,picture), לקביעת התפקיד שלו, ולזיהוי הקורס והמשאב שהתגובות שייכות אליהם. FastComments אינו מבקש Names and Role Provisioning Services, Assignment and Grade Services, נתוני מחווני הערכה, נוכחות, רשימות משתתפים מלאות או גישת ניהול ל-LMS. מנהלי ה-LMS שומרים על שליטה ביחידות הארגוניות, בקורסים ובפריסות שבהן הכלי זמין.
הוספת סקרים לקורס LMS שלך 
לאחר ש-FastComments נמצא בקורס LMS שלך, אתה יכול גם להריץ סקרים חיים ישירות בתגובות. הפעל Enable Polls בהגדרות התאמה אישית של הווידג'ט שלך וכפתור סקר יופיע בסרגל הכלים של התגובה. סקרים יכולים לכלול 2 עד 10 אפשרויות, התוצאות מתעדכנות בזמן אמת לכל המשתמשים בדף, ואתה בוחר מי יכול ליצור סקרים והאם ההצבעה דורשת התחברות. אין צורך להתקין דבר נוסף על LMS.
נסה את הדגמת הסקרים החיים או קרא את תיעוד הסקרים כדי להגדיר אותם.