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