קובץ iframe מסוג Discovery iframe הוא התצוגה הראשונית שמוצגת למורה כאשר לפתוח תוסף במהלך היצירה של משימה ב-Classroom. קובץ מצורף הוא התוכן או הפעילות שאתם מתכוונים לאפשר לתלמידים ליצור איתם אינטראקציה.
מתוך קורס ב-Classroom, מורה יוצר פוסט חדש (עבור למשל, מטלה, הודעה או שאלה) ובוחר תוסף מתוך ברשימה הנפתחת של התוספים. לפרק זמן קצר (לפי סדר השעות), Classroom מאפשר לתוסף לצרף קבצים לפוסט.
איור 1. תצוגה של
יצירת מטלות, כולל אפשרויות התוספים האפשריים שהמורים יכולים לצרף.
אחרי שהמורה בוחר/ת תוסף, מערכת Classroom יוצרת קובץ מצורף iframe של Discovery וטוען את כתובת ה-URL להפעלה של התוסף. כל שאילתת iframe רלוונטית פרמטרים מועברים לכתובת ה-URL להפעלה.
איור 2. דוגמה לממשק משתמש של attachment Discovery ב-iframe.
המורה משתמש באפליקציית האינטרנט של השותף, בתוך iframe, כדי לבחור
מצורף. האפליקציה מבצעת קריאות ל-Classroom API כדי לצרף את הקובץ המצורף
למטלה. כשהמורה מסיים לבחור את הקבצים המצורפים,
התוסף שולח מטען ייעודי (payload) של postMessage
שמבקש את סגירת ה-iframe.
ה-iframe נסגר והמורה יכול/ה לראות את הקבצים המצורפים בוחרים אם להציג תצוגה מקדימה במטלה או להסיר ממנה.
איור 3. תצוגה של יצירת מטלה עם תוסף לשלושה סוגי פעילות קבצים מצורפים.
שיקולים לגבי חוויית המשתמש ב-iframe
- בפתיחה הראשונית, התוסף צריך לבקש מהמורה להיכנס.
- נדרשת כניסה יחידה (SSO) באמצעות Google לכל הקריאות ל-Classroom API. אם המיקום למוצר שלכם יש מערכת התחברות נפרדת, עליכם לקשר חשבונות.
- למורה צריכה להיות אפשרות להציג קובץ מצורף בתצוגה מקדימה בתוך ה-iframe לפני לקבל את הבחירה הסופית.
- למורים צריכה להיות אפשרות לחפש קבצים מצורפים או לעיין בהם תוכן.
- התוסף עשוי לספק מגוון תצוגות, כמו למשל תוכן מהזמן האחרון, תכנים שונים ולסנן אותם לפי מיומנויות הלמידה.
- לתוסף צריכה להיות אפשרות ליצור פריט חדש שאפשר לצרף מ- ב-iframe.
לפרטים נוספים, אפשר לעיין ברשימת המשימות לדרישות השימוש בתוספי Classroom. בדרישות של חווית המשתמש.
הצגת סטטוס הרישוי בתוך iframe
אם לתוסף נדרש רישיון ולמורה אין רישיון כזה, חובה להציג למורה שמיידע אותם על השלב הבא צעדים לתיקון המצב. המטרה היא למנוע בלבול שעלול להיגרם לך מהגבלות רישוי.
בנוסף, אנחנו ממליצים שהתוסף:
- מציג את רמת הרישיון של המורה בקובץ גילוי הקובץ המצורף iframe.
- הסתרה או השבתה של תוכן שלא זמין למורה עקב רישיון מגבלות ברמה.