ה-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 מפורטות הדרישות בנוגע לחוויית המשתמש.
סטטוס הרישוי
אם התוסף שלכם דורש רישיון למוצר, צריך להציג הודעה ברורה שמסבירה למורה שאין לו רישיון איך לפתור את הבעיה. כדאי גם להסתיר או להשבית תוכן שלא זמין למורים בגלל הגבלות רישוי.