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