iframe کشف پیوست، نمای اولیه ای است که هنگام باز کردن یک افزونه در حین ایجاد یک کار کلاس درس به معلم نشان داده می شود. پیوست محتوا یا فعالیتی است که قصد دارید دانش آموزان با آن تعامل داشته باشند.
از داخل یک دوره کلاس، معلم یک پست جدید ایجاد می کند (مثلاً یک تکلیف، اطلاعیه یا سؤال) و یک افزونه را از لیست کشویی برافزا انتخاب می کند. برای مدت زمان کوتاهی (به ترتیب ساعت)، Classroom به افزونه اجازه می‌دهد پیوست‌هایی را به پست اضافه کند.
شکل 1. نمای ایجاد تکلیف شامل گزینه های احتمالی افزودنی که معلم می تواند ضمیمه کند.
وقتی معلم افزونه‌ای را انتخاب کرد، Classroom یک iframe کشف پیوست ایجاد می‌کند و URL راه‌اندازی افزونه را بارگیری می‌کند. هر پارامتر مربوط به پرس و جوی iframe به URL راه اندازی ارسال می شود.
شکل 2. نمونه ای از یک رابط کاربری کشف پیوست در iframe.
معلم از برنامه وب شریک، در یک iframe برای انتخاب یک پیوست استفاده می کند. این برنامه برای پیوست کردن پیوست به تکلیف، تماس‌های API Classroom برقرار می‌کند. هنگامی که معلم انتخاب پیوست‌ها را به پایان رساند، افزونه یک بار ارسال postMessage ارسال می‌کند و درخواست می‌کند iframe بسته شود.
iframe بسته می‌شود و معلم اکنون می‌تواند پیوست‌هایی را ببیند که می‌توانند پیش‌نمایش یا حذف از تکلیف را انتخاب کنند.
شکل 3. نمای ایجاد یک تکلیف با سه پیوست افزودنی از نوع فعالیت.
ملاحظات UX در iframe
- در باز شدن اولیه، افزونه باید از معلم بخواهد که وارد سیستم شود.
- برای همه تماس‌های API Classroom، یک ورود به سیستم Google الزامی است. اگر محصول شما دارای سیستم ورود جداگانه است، باید حساب ها را پیوند دهید.
- یک معلم باید بتواند پیش‌نمایش یک پیوست را در iframe قبل از انتخاب نهایی خود مشاهده کند.
- یک معلم باید بتواند محتوای قابل پیوست را جستجو یا مرور کند.
- این افزونه ممکن است نماهای مختلفی مانند محتوای اخیر، محتوای من، و فیلتر با مهارت های یادگیری ارائه دهد.
- این افزونه باید توانایی ایجاد یک آیتم قابل پیوست جدید از داخل iframe را ارائه دهد.
برای جزئیات بیشتر در مورد الزامات UX به چک لیست الزامات افزونه Classroom مراجعه کنید.
نمایش وضعیت مجوز در iframe
اگر افزونه نیاز به مجوز داشته باشد و معلم مجوز نداشته باشد، باید یک پیام واضح به معلم ارائه شود که آنها را از اقدامات بعدی مناسب برای اصلاح وضعیت مطلع کند. این برای جلوگیری از هرگونه سردرگمی است که ممکن است از محدودیت های صدور مجوز ناشی شود.
ما همچنین توصیه می کنیم که افزونه شما:
- سطح مجوز معلم را در قالب iframe کشف پیوست نمایش می دهد.
- محتوایی را که به دلیل محدودیت‌های سطح مجوز برای معلم در دسترس نیست، پنهان یا غیرفعال می‌کند.