Add Comments to Your LMS via LTI 1.3

1. היכנס ל-FastComments ועבור אל דף התצורה של LTI 1.3 שלך.
2. (Optional) בחר את הפלטפורמה שממנה אתה מתחבר מתוך תפריט הנפתח Platform - זה קובע את תווית התצוגה, אך Auto-detect עובד היטב.
3. לחץ על Generate URL. מופיע Registration URL לשימוש חד-פעמי (תקף למשך 30 דקות).
4. ב-LMS שלך, פתח את מסך ההרשמה הדינמית של LTI 1.3 והדבק את ה-URL בשדה Tool initiation registration endpoint (או שדה מקביל). הגש.
5. ה-LMS שלך קורא חזרה ל-FastComments, מחליף מפתחות ויוצר את האינטגרציה. החלונית הקופצת נסגרת אוטומטית כשהתהליך מסתיים.
6. חזור ל-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.

Navigate to LTI 1.3 Configuration

Sign in to FastComments and go to עמוד התצורה של LTI 1.3 שלך.

If your account doesn't yet have LTI access, you'll see "LTI not enabled for this account" - contact support to enable it on your plan.

Pick a Platform (Optional)

Under Generate a Dynamic Registration URL, use the Platform dropdown to tell FastComments which LMS you're connecting:

• D2L Brightspace
• Moodle
• Blackboard Learn
• Sakai
• Schoology
• Other LTI 1.3 platform

You can also leave it on Auto-detect. The platform is read out of your LMS's openid-configuration during registration; the dropdown only seeds the display label for the resulting configuration.

Generate the URL

Click Generate URL. FastComments creates a one-time registration token and shows you a URL that looks like:

https://fastcomments.com/lti/v1p3/register/<long-token>

Copy it. This URL:

• Is single-use - once your LMS calls it successfully, the token is consumed.
• Expires after 30 minutes if not used.
• Should be kept private - anyone with the URL can register a tool against your tenant within those 30 minutes.

Existing Configurations

Once a registration completes successfully, the new configuration shows up in the Existing Configurations table on the same page, with its Platform, Issuer, Client ID, and Status. You can delete configurations from this table if you ever need to unregister.

D2L Brightspace חושפת רישום דינמי דרך ממשק הניהול של LTI Advantage. נדרשת גישת מנהל.

Open the Registration Screen

1. Sign in to your Brightspace instance as an admin.
2. Navigate to Admin Tools > Manage Extensibility > LTI Advantage.
3. Click Register Tool. (The direct URL is https://<your-brightspace-host>/d2l/le/ltiadvantage/registrations/create.)

Paste the URL

You'll see a registration form. The key field is Tool initiation registration endpoint (some Brightspace versions label it "Tool Initiation Registration URL").

Paste the FastComments registration URL (השג אותו כאן) into that field. Leave the other fields blank - they're auto-populated by FastComments during the registration handshake.

Click Register.

Approve the Tool

Brightspace opens a popup that talks to FastComments, exchanges keys, and shows a confirmation screen. The popup closes itself when registration completes.

The new tool appears in your LTI Advantage tool list. By default Brightspace marks new tools as disabled - flip the toggle to enabled so your courses can use it.

Add a Deployment

In Brightspace, LTI tools need a deployment before they can be used in courses:

1. Open the newly-registered FastComments tool.
2. Click View Deployments > New Deployment.
3. Give the deployment a name (e.g. "FastComments - All Courses"), pick the org units it should be available in, and save.

After the first launch through this deployment, FastComments pins the deployment_id to its configuration record - subsequent launches from a different deployment under the same client will be rejected unless you re-register.

משתמשים ב‑Moodle? אנו מפרסמים גם תוסף Moodle ייעודי ל‑FastComments עם אינטגרציה צמודה יותר מ‑LTI 1.3 (hooks לסנכרון ציונים, דיווח פעילות מעמיק יותר, ממשק הגדרות מקומי ב‑Moodle). ראה את ה־מדריך התקנת התוסף ל‑Moodle. זרימת LTI 1.3 להלן היא הבחירה הנכונה אם ברצונך רישום יחיד המכסה גם LMSים אחרים, או אם מנהל ה‑Moodle שלך לא יתקין תוספי צד שלישי.

Moodle 4.0+ תומך ברישום דינמי של LTI 1.3 באמצעות התוסף External tool.

פתח את מסך ניהול הכלים

1. התחבר ל‑Moodle כמנהל האתר.
2. נווט אל 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 בכל הקורס:

1. לחץ על סמל גלגל השיניים בכרטיס של FastComments.
2. מתחת ל‑Tool configuration usage, בחר Show in activity chooser and as a preconfigured tool.
3. שמור.

מרצים יכולים כעת להוסיף את FastComments לכל קורס דרך Add an activity or resource > FastComments.

Blackboard Learn SaaS ו-Ultra תומכים ברישום דינמי של LTI 1.3.

פתח את מסך ספק הכלי

1. היכנס ל-Blackboard כמנהל מערכת.
2. נווט אל Administrator Panel > Integrations > LTI Tool Providers.
3. לחץ על 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:

1. מצא את הרשומה של FastComments ברשימת ספקי הכלים.
2. פתח את התפריט ובחר Edit.
3. הגדר את Tool Status ל-Approved.
4. תחת Institution Policies, עיין אילו נתוני משתמש נשלחים (שם, דוא"ל, תפקיד). שמור.

הכלי כעת זמין למרצים כאשר הם מוסיפים תוכן לקורסים.

Sakai

Sakai תומכת בהרשמה דינמית של LTI 1.3 בגרסאות עם LTI Advantage. מתוך מרחב הניהול:

1. התחבר כמנהל ב‑Sakai ופתח את מרחב הניהול.
2. בחר כלים חיצוניים > התקן כלי LTI 1.3.
3. הדבק את כתובת הרישום של FastComments (קבלו אותה כאן) והגש.
4. אשר את הכלי כאשר תהליך החיבור יסתיים.

הכלי יופיע אז תחת כלים חיצוניים וניתן להוספה לאתרים על ידי המנהלים שלהם.

Schoology

מופעי Schoology Enterprise תומכים ב‑LTI 1.3, אבל זמינות ההרשמה הדינמית משתנה לפי פריסה. בדקו עם מנהל החשבון שלכם ב‑Schoology.

אם הרשמה דינמית אינה זמינה ב‑Schoology שלכם, יהיה עליכם להגדיר את האינטגרציה באופן ידני באמצעות נקודות הקצה הבאות:

• כתובת כניסה OIDC: https://fastcomments.com/lti/v1p3/login
• כתובת הקישור היעד: https://fastcomments.com/lti/v1p3/launch
• כתובת מערך המפתחות הציבוריים (JWKS): https://fastcomments.com/lti/v1p3/jwks
• כתובות הפניה: https://fastcomments.com/lti/v1p3/launch

לאחר ש‑Schoology תספק לכם Client ID ו‑Deployment ID, פנו לתמיכת FastComments כדי לרשום את התצורה ב‑tenant שלכם.

Other LTI 1.3 Platforms

כל LMS שעומד במפרט IMS LTI 1.3 Advantage אמור לעבוד עם אותה כתובת רישום (קבלו אותה כאן). חפשו הגדרה שכותרתה "הרשמה דינמית", "כתובת רישום כלי", "נקודת קצה לרישום יזום של כלי", או דומה.

אם הפלטפורמה שלכם תומכת רק בהגדרה ידנית של LTI 1.3, השתמשו בארבע נקודות הקצה המפורטות בסעיף Schoology לעיל ופנו לתמיכה כדי להשלים את התהליך.

עמוד זה מכסה הוספת FastComments לקורס ב‑Brightspace לאחר שמנהל רשם את הכלי ויצר פריסה. אם הכלי עדיין לא נרשם, עיין תחילה במדריך הרישום של D2L.

FastComments מוטמע כנושא יחידה ב‑Brightspace

Brightspace מספקת שתי חוויות עריכת תוכן: תוכן קלאסי וחוויית התוכן החדשה (נקראת גם Lessons). שתי החוויות מאפשרות שימוש ב‑FastComments, אך מסלולי התפריטים שונים. כל סעיף למטה מתאר את שתי האפשרויות כשיש הבדלים.

איתור כלי FastComments

כלי FastComments מופיע בשני אזורים בתוך עורך התוכן של הקורס:

1. ב‑activity picker, הנמצא דרך כפתור הוספה של פריט קיים של מודול/יחידה (בגרסאות ישנות של Brightspace התווית היא Add Existing Activities). בגרסאות עדכניות FastComments מופיע ישירות בבורר; בגרסאות ישנות הוא מקונן תחת תפריט משנה External Learning Tools. בכל אחת מהדרכים מוסיפים את FastComments כנושא עצמאי.
2. בדיאלוג Insert Stuff שבתוך עורך ה‑HTML, תחת LTI Advantage. זה מאפשר להטמיע את FastComments במקביל בתוך נושא HTML באמצעות זרימת deep linking של LTI.

אם FastComments לא מופיע באף אחד מהבוררים, הפריסה לא מופעלת ל‑org unit שמכיל את הקורס. בקש ממנהל ה‑Brightspace לפתוח Admin Tools > Manage Extensibility > LTI Advantage > כלי FastComments > View Deployments, לפתוח את הפריסה ולהוסיף את יחידת הארגון של הקורס (או יחידת על) תחת Org Units.

הוספת FastComments כנושא במודול

תוכן קלאסי:

1. פתח את הקורס ולחץ על תוכן בסרגל הניווט.
2. בחר את המודול שצריך להכיל את הדיון (או צור אחד דרך הוסף מודול).
3. לחץ הוסף קיים (Brightspace ישן: Add Existing Activities > External Learning Tools).
4. בבורר, לחץ על FastComments. Brightspace יוצר נושא במודול ומחזיר אותך לתצוגת התוכן.
5. לחץ על הנושא החדש. שנה את שמו למשהו תיאורי כמו FastComments Discussion באמצעות עורך הכותרת המובנה.

חוויית התוכן החדשה (Lessons):

1. פתח את הקורס ולחץ על תוכן.
2. פתח את היחידה והשיעור שצריכים להכיל את הדיון.
3. לחץ הוסף > פעילות קיימת ובחר FastComments (Brightspace ישן: מקונן תחת External Learning Tools).
4. הפעילות מתווספת לשיעור.
5. לחץ על כותרת הפעילות כדי לשנות את שמה.

בפעם הראשונה שמשתמש (מרצה או סטודנט) פותח את הנושא, FastComments מאתחלת את השרשור עבור אותו resource link. השרשור קשור ל‑resource link ID, כך שהחלפת שם או העברת הנושא לא תשנה את השרשור שנטען.

הטמעת FastComments בתוך נושא HTML

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

1. פתח או צור נושא HTML במודול/שיעור.
2. לחץ ערוך HTML כדי לפתוח את עורך ה‑HTML של Brightspace.
3. מקם את הסמן במקום שבו שרשור התגובות צריך להופיע.
4. לחץ על כפתור Insert Stuff (אייקון פאזל בסרגל הכלים של העורך).
5. בדיאלוג Insert Stuff, גלול ל‑LTI Advantage ולחץ FastComments.
6. FastComments פותח בורר deep linking. אשר את המיקום (ההגדרות כברירת מחדל מתאימות לדיוני תוכן); לחץ Insert או Continue.
7. Brightspace חוזר לעורך ה‑HTML עם בלוק מציין מקום המייצג את ההפעלה של ה‑LTI. לחץ שמור וסגור על הנושא.

כאשר הנושא נטען, Brightspace מחליף את המציין במקום ב‑iframe שמבצע הפעלה אוטומטית של FastComments דרך LTI. הסטודנטים רואים את שרשור הדיון בתוך הדף.

נושא HTML אחד יכול להכיל מספר הטמעות deep-linked של FastComments. כל הטמעה מקבלת שרשור משלה כיוון שכל deep link מייצר resource link ID נפרד.

נושא מודול מול קישור מהיר מוטמע בדף

בחר בגישת נושא במודול כאשר:

• הדיון הוא הפעילות העיקרית עבור השלב במודול.
• אתה רוצה שהנושא יופיע בטבלת התוכן של Brightspace, במעקב ההשלמה וב‑Class Progress.

בחר בגישת הטמעה בתוך הדף כאשר:

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

נראות, מצב טיוטה ותנאי שחרור

נושא FastComments חדש נראה לסטודנטים כברירת מחדל. כדי להסתיר אותו בזמן ההגדרה:

1. בעורך התוכן, לחץ על כותרת הנושא (תוכן קלאסי) או על תפריט שלוש הנקודות בפעילות (חוויית התוכן החדשה).
2. הגדר סטטוס ל‑טיוטה (תוכן קלאסי) או כבה את נראות (חוויית התוכן החדשה).

נושאי טיוטה אינם נראים לסטודנטים. מרצים ועוזרי הוראה עדיין רואים אותם עם תג "טיוטה".

כדי להגביל את הנושא לקבוצה או לסקשן ספציפי:

1. פתח את הנושא.
2. לחץ בתפריט כותרת הנושא > ערוך מאפיינים במקום (תוכן קלאסי) או ערוך > מגבלות (חוויית התוכן החדשה).
3. תחת תנאי שחרור, לחץ צור.
4. בחר הרשמה לקבוצה או הרשמה לקטע, בחר את הקבוצה/הקטע ושמור.

תנאי שחרור מצטברים עם מיפוי התפקידים של FastComments. סטודנטים שאינם רואים את הנושא לא יקבלו הפעלת LTI.

מה הסטודנטים רואים בהפעלה הראשונה

כאשר סטודנט לוחץ על הנושא (או טוען נושא HTML עם הטמעה):

1. Brightspace מבצע את השיגור LTI 1.3 ברקע.
2. FastComments מקבלת את שם הסטודנט, אימייל, כתובת URL לאוואטר ותפקיד ב‑LMS, ומתחברת אותו אוטומטית. אין דרישת התחברות ל‑FastComments.
3. שרשור התגובות עבור אותו resource link מוצג בתוך ה‑iframe של Brightspace.

מיפוי תפקידים בזמן השיגור:

• Brightspace Administrator הופך ל‑FastComments admin עבור השרשור (גישה מלאה למתן פריטים, מחיקה, חסימה והגדרות).
• Brightspace Instructor הופך ל‑FastComments moderator (נעיצה, הסתרה, מחיקה, חסימה).
• כל שאר התפקידים (Learner, TeachingAssistant, וכו') הופכים למגיבים רגילים.

תגובות מתויגות לחשבון ה‑Brightspace של הסטודנט. אם הסטודנט מעדכן את שמו או את האוואטר ב‑Brightspace, ההשקה הבאה של LTI מסנכרנת את השינוי.

גובה ה‑Iframe ושינוי גודל

FastComments משדר את הודעת ה‑postMessage של org.imsglobal.lti.frameResize בכל רינדור של השרשור ובשינויים בתוכן (תגובה חדשה, פתיחת תשובות). Brightspace מאזין להודעה זו ומתאים את גובה ה‑iframe כדי שהשרשור לא יהיה גזור ולא יציג פס גלילה פנימי.

אם ה‑iframe נשאר בגובה קבוע וקצר:

• ודא שהקורס נטען דרך HTTPS. מאזין ה‑postMessage של Brightspace דוחה frames בתוכן מעורב.
• ודא שאין תוסף דפדפן שחוסם את ערוץ ה‑postMessage.
• להטמעות בתוך נושא HTML, ה‑HTML המקיף לא צריך לעטוף את ה‑iframe במיכל בגובה קבוע. הסר כל inline style="height: ..." מהרכיב ההורה.

נקודות רגישות ספציפיות ל‑Brightspace

הכלי לא מופיע בבורר Add Existing. הפריסה לא מופעלת עבור יחידת הארגון של הקורס. מנהל צריך להוסיף את יחידת הארגון (או יחידת על) לרשימת ה‑Org Units של הפריסה. רישום הכלי לבדו אינו מספיק; הפריסה קובעת אילו קורסים רואים את הכלי.

התאמת deployment_id משיכה בהשקה. FastComments קושרת (TOFU) את ה‑deployment_id הראשון שהיא רואה עבור רישום. אם מנהל מוחק את הפריסה המקורית ויוצר חדשה, השיגורים מהפריסה החדשה נדחים עם שגיאת חוסר התאמה של פריסה. התיקון הוא לרשום את FastComments מחדש (לייצר URL רישום חדש (השג אותו כאן) ולהריץ 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 דרך הוספה של פריט קיים (אל תבצע המרה של הקישור הישן) כדי שההשקה תשתמש ב‑LTI 1.3.

ההטמעה מציגה מסך התחברות במקום SSO אוטומטי. נושא ה‑HTML הוכנס כ‑