Teacher guide
Teacher Manual (Instructor)
For teachers. In this app “Instructor” means Teacher. Your home is /instructor with 4 links: Courses, Students, Sessions, and Chat. Your analytics live on /dashboard (my courses, students, sessions, upcoming classes).
1. Manage your courses
Open My Courses
Click Courses in the sidebar, or go to /instructor/courses. You see only courses where you are the teacher. Each row shows counts of enrolled students, materials, and sessions.
Search and filter
At the top there is a search box (type a course title and press Enter — it is a GET form) and grade pills like All plus each grade name. Click a grade pill to filter the list.
Open a course — learn the 5 tabs
Click a course to open /instructor/courses/[id]. Inside CourseDetailTabs you get 5 tabs: Dashboard, Sessions, Editor (chapters and lessons), Materials, Settings. Your last tab is remembered on this device.
Who can enrol students?
2. Add chapters and lessons (Editor tab)
Open the Editor tab
Inside your course, click the Editor tab. You see the list of chapters, each expandable to show its lessons.
Add a chapter
Click Add Chapter. In the dialog, enter the chapter title, chapter number, and description, then click Save / Create. The new chapter appears in the list.
Add a lesson inside a chapter
Expand the chapter, then click Add Lesson. Enter the lesson title, index number, and content. To attach a file, click Upload file (PDF, video, image) — while uploading the button shows Uploading.... Click Save. To change it later, click the pencil Edit Lesson button on that lesson.
3. Upload course materials
Two ways to upload
Fast way: on the Dashboard tab click Upload Material — it jumps you to the Materials tab. Or click the Materials tab directly.
Upload a file
In CourseMaterialsManager, fill Title (and optional Description), click Upload File, choose a PDF, video, image, or document, and wait until it changes from Uploading... back to Upload File. The file appears in the “Uploaded” list below with date and type.
Students see it instantly
/student/materials. Delete a wrong file from the same list.4. Create a live session (class)
Start a new session
Two equal ways: (a) inside your course on the Dashboard tab click New Session, or (b) go to /instructor/sessions and click Create Session / New Session. Both open /instructor/sessions/new?course_id=... with the SessionForm.
Fill the SessionForm
Select Course (“Select a course”), type Session Title (example “Math - Chapter 3 Live Class”), optional Description (“What will be covered?”), pick Date and Time, and choose Duration (30 min, 45 min, 1 hour, 1.5 hours, 2 hours).
Click Create Session
Click Create Session. While saving it shows Creating.... On success you return to /instructor/sessions. If fields are missing you see “Please fill in all required fields”. Click Cancel to go back without saving.
Find it in Upcoming / Past
Open /instructor/sessions. New classes appear under Upcoming; old ones move to Past. Click a session to open /instructor/sessions/[id] with the Meet link, student count, and attendance.
5. Mark attendance
Open the session detail
Go to /instructor/sessions, click the session title. You see stats, the Meet link code block, the enrolled list, and the AttendanceForm.
Mark present / absent
For speed, click Mark all Present or Mark all Absent, then fix exceptions by toggling individual students (Present / Absent toggle per row).
Save
Click Save Attendance. Students see the result as attendance badges on /student/sessions and inside their course Sessions tab.
6. Students list — /instructor/students
Open Students
Click Students in the sidebar, or go to /instructor/students. At the top is a grade filter (All + each grade). As a teacher you see only students enrolled in your courses (enrolled-only); admin and manager see every student (view-all).
Search and open a student
In StudentPageClient, type a name or email in the search box and press Enter. Click a student row to see their courses, progress %, and grades. From here you can jump to their course or start a chat.
7. Session detail — /instructor/sessions/[id] (Meet + Attendance)
How you get here
From /instructor/sessions (Upcoming / Past) or from a course Sessions tab, click the session title or Attendance. Breadcrumb shows Sessions / Session title.
Read the 3 info cards
Course card (course title), Date card (weekday, month, day), Time card (hour:minute + duration in min). These come from the session you created.
Google Meet card
Card titled Google Meet with text “Share this link with students to join the class” and a badge Active (upcoming) or Ended (past). The code block shows the Meet URL or “No Google Meet link generated”. If a link exists, click Join Meet to open it; otherwise you see No Link.
Attendance card
Card titled Attendance with “Mark students as present, absent, or late” and a count badge like 12 students. Inside AttendanceForm: use Mark all Present / Mark all Absent, fix exceptions per row (Present / Absent / Late), then click Save Attendance.
Only your sessions
/instructor/sessions. Admins and managers can open any session.8. Course detail tabs — /instructor/courses/[id] (all 5 tabs)
Dashboard tab — quick actions + stats
Buttons: New Session (opens /instructor/sessions/new?course_id=...), Add Chapter (opens chapter dialog), Upload Material (jumps to Materials tab). Below: 4 stat cards Enrolled, Avg Completion, Avg Rating (★), Materials (clickable — jumps to Materials tab). Top-right also has Chat and Unpublish.
Sessions tab — Course Sessions table
Title Course Sessions + top-right Create Session. Empty state shows “No sessions yet — Create your first online class session” with a second Create Session button. Otherwise a table with columns Session (title + duration min), Date, Status (Completed / Started / Upcoming), Actions (Join or No Link + Attendance which opens /instructor/sessions/[id]).
Editor tab — chapters and lessons
Empty state: “No chapters yet. Add a chapter to get started.” Otherwise Course Content list: expand a chapter (chevron), read lessons in order, Add Lesson per chapter, pencil icon to edit, trash to delete.
Materials tab — CourseMaterialsManager
Form: Title + Description fields, Upload File button (shows Uploading... while busy), helper text “Upload PDFs, videos, images, or documents”. Below: table header Uploaded with rows (name, type, date, delete X).
Settings tab — CourseSettingsForm
Edit title, descriptions, grade, thumbnail (Replace / Remove), and Visibility toggles (Upcoming, Featured, Self enrollment), then save. Only change what you need — saving refreshes the course page.
9. Teacher home — /instructor
Simple landing with 4 links: Courses (/instructor/courses), Students (/instructor/students), Sessions ( /instructor/sessions), Chat (/instructor/chat). Use it as a starting point after login.
10. Dashboard — /dashboard (teacher view)
“Hey, your name” + 4 stat cards (My Courses, Students, Sessions, Upcoming), then Upcoming Sessions list (title, date-time, course title, Join link), then portal cards to your instructor pages.
11. Settings + Chat — /instructor/settings and /instructor/chat
Connect your calendar
Open /instructor/settings. In GoogleCalendarSettings, click Connect Google Calendar, sign in with Google, and accept. When connected it shows “Connected”. Sessions you create can then carry a Meet link.
Chat with students
Open /instructor/chat, pick a conversation on the left, type at the bottom, and click Send. Direct link format: /instructor/chat?conversation=ID.
MapleStars LMS User Manual · Simple step-by-step guide · If a button is missing, check your role with your admin