Section 11 Common Issues & Solutions

11.1 Resetting Course Progress

Sometimes, a learner may need to start a course again from the beginning. This could happen if:

• They enrolled by mistake before being ready
• Their work was incomplete or submitted too early
• You’re using the same course for a new term or new group of learners
• You want to reset everything after an assessment

On VirtualX, you can reset a learner’s progress using the front-end Admin tab—no backend access needed.

🔄 What Happens When You Reset Progress?

When you reset a learner’s course progress:

• All completed units will be unmarked
• Quiz attempts may be cleared (depending on setup)
• The learner can start fresh from Unit 1
• They lose any awarded certificates or badges linked to that course
• Their progress bar resets to 0%

⚠️ This action is final—you cannot undo it once completed.

🛠️ Steps: How to Reset Course Progress for a Learner

1. Login to your VirtualX teacher account.
2. Go to Dashboard > My Courses.
3. Open the course where the learner is enrolled.
4. Click on the “Admin” tab.
5. Scroll to the Enrolled Students list.
6. Find the learner whose progress you want to reset.
7. Click the Reset / Restart Progress icon (usually a circular arrow or bin symbol).
8. Confirm the action in the popup.

✅ The learner will now see the course as brand new when they next log in.

🧑🏽‍🏫 Example in Action:

Mr. Lebohang notices that one learner, Sipho, rushed through a Grade 7 Science course and failed all the quizzes. After talking to Sipho, they agree to start again. Mr. Lebohang resets Sipho’s progress using the Admin tab. Sipho logs in the next day and starts again from Unit 1.

📋 When Should You Reset Progress?

Situation	Recommended?
Learner failed and wants to retry fully	✅ Yes
Learner mistakenly clicked through units	✅ Yes
New term using same course	✅ Yes (for all learners)
Learner missed one quiz only	❌ No – better to reset just the quiz attempt
Course redesign or major update	✅ Yes – especially if structure changed

💡 Tips Before Resetting

Tip	Why It Helps
Speak to the learner first	Avoid confusion or frustration
Download their progress report	Keep a record for moderation or backup
Use announcements to inform class	If resetting for the whole group
Pair reset with encouragement	Help learners see it as a fresh start, not a punishment

🛠️ Bulk Reset (Admin-Assisted)

If you need to reset the entire class:

• Ask your school administrator to do a bulk reset from the backend
• This can be done using filters or batch actions
• Ideal at the end of a term or before starting a new academic cycle

✅ Summary

Resetting course progress is a helpful tool when learners need a clean slate. With a few clicks, you can support revision, correct early mistakes, or reuse your course for a new group—all from the front end of VirtualX.

11.2 Changing Student Course Status

There may be times when you need to manually update a learner’s course status. This could be because of:

• A technical error (the system didn’t mark completion)
• A learner finishing offline or outside of VirtualX
• Special permission to skip ahead or complete early
• Needing to unlock access for support purposes

VirtualX lets teachers change a student’s course status manually using the front-end Admin panel—no backend login required.

🟢 Course Status Types

Here are the typical course statuses you may see:

Status	Meaning
In Progress	Learner has started the course but hasn’t finished
Completed	Learner has met all conditions (units, quizzes, etc.)
Not Started	Learner is enrolled but hasn’t opened the course yet
Expired	Time limit for the course has run out (if applied)
Reset	Learner’s progress was cleared manually

🛠️ Steps: How to Change Course Status (Manually)

1. Login to your teacher account on VirtualX.
2. Go to Dashboard > My Courses.
3. Click on the course in question.
4. Open the “Admin” tab.
5. Scroll to the Enrolled Students section.
6. Find the learner you want to update.
7. Click the small settings icon or status dropdown next to their name.
8. Choose the new status:
   • Mark as Completed
   • Set to In Progress
   • Reset Progress (if needed)

✅ The learner’s dashboard will now reflect the new status immediately.

🧑🏽‍🏫 Example in Action:

Ms. Lategan, teaching Grade 10 Geography, sees that one learner, Reabetswe, completed all units offline due to network issues. She verifies the learner’s workbooks, then manually updates her status to “Completed” and awards her certificate.

📌 When to Change Status

Situation	Action
Learner finishes outside the system	Mark as “Completed” manually
Course didn’t auto-complete properly	Update to “Completed”
Course expired early by mistake	Change back to “In Progress”
Learner needs to start over	Use “Reset Progress”

💡 Tips for Managing Course Status

Tip	Why It Helps
Always verify offline work before updating	Keeps your records reliable
Inform the learner of the change	Avoids confusion or double submissions
Update certificates or badges if needed	Completes the learner’s achievement history
Use with caution—status changes can’t be undone easily	Maintain fairness across the class

✅ Summary

Manually updating a learner’s course status gives you the flexibility to handle special cases, support issues, or offline completions. It’s a fast and easy way to keep your learner records accurate and up to date—all from the front end of VirtualX.

11.3 Extending Student Access

Sometimes a learner may need extra time to finish a course, especially if:

• They were absent for health or personal reasons
• They joined the course late
• Their access expired too early
• You want to offer a revision window after term-end

On VirtualX, teachers can extend student access for individual learners or the entire class—without needing backend access.

⏳ What Happens When Access Expires?

If a learner’s access to a course expires:

• They can no longer open course units or quizzes
• The course will be marked as “Expired” on their dashboard
• Certificates and badges are no longer accessible unless reactivated

⚠️ This does not delete their progress—it only locks access.

🛠️ Steps: How to Extend Course Access (for a Learner)

1. Login to your VirtualX teacher account.
2. Go to Dashboard > My Courses.
3. Click on the course where access needs to be extended.
4. Open the “Admin” tab.
5. In the Enrolled Students list, find the learner.
6. Click the access/edit icon next to their name.
7. Set a new access duration or expiry date:
   • Add extra days (e.g. 7, 14, 30)
   • Or choose a specific end date (e.g. 31 May 2025)
8. Click Save / Update.

✅ The learner’s access will now be extended, and the course will be unlocked.

🧑🏽‍🏫 Example in Action:

Mr. Mabaso, teaching Grade 9 EMS, notices that Lindiwe’s course has expired. She had been sick during the final quiz. He clicks on her profile in the Admin tab, extends her access by 10 days, and sends her a reminder to finish the course. She logs in the same afternoon and completes it.

🔁 How to Extend Access for Multiple Learners

⚙️ If many learners need an extension (e.g. for exam revision):

• Click the “Bulk Actions” or “Manage Students” option in the Admin tab
• Select multiple learners or “Select All”
• Choose “Extend Access”
• Set the number of extra days
• Apply changes to all selected learners

✅ This is perfect for whole-class extensions after school holidays or term changes.

📌 When to Extend Access

Scenario	Recommendation
Illness or emergency	✅ Extend for the affected learner
Late enrolment	✅ Grant extra time
System error or early expiry	✅ Fix with an extension
Learner did not engage at all	❌ Only extend if agreed upon by school or parent

💡 Tips for Managing Access Periods

Tip	Why It Helps
Set clear deadlines early in the course	Helps avoid confusion later
Use reminders before expiry	Encourages learners to finish on time
Document reasons for extensions (internally)	Keeps your tracking fair
Pair with progress reports	See who is worth extending based on effort

✅ Summary

Extending learner access gives you the flexibility to handle special cases without restarting the whole course. With just a few clicks, you can give learners a second chance to complete their work and earn their certificates—all from the front-end Admin panel.

11.4 Troubleshooting Quiz & Assignment Errors

Every now and then, learners may face technical issues when trying to submit a quiz or assignment on VirtualX. These issues can usually be solved quickly with a few simple steps—without needing to call the admin or IT team.

This section helps you understand why these errors happen and how you can help learners resolve them directly from the front-end.

⚠️ Common Quiz & Assignment Issues

Issue	What Learner Sees
Quiz won’t start	“You’ve already attempted this quiz” or nothing loads
Can’t submit quiz	“Time expired” or submit button not working
Assignment not uploading	“Invalid file type” or upload bar stuck
Error message after clicking “Submit”	“Submission failed” or blank page
Assignment marked but not showing	Learner can’t see result/feedback

🛠️ How to Troubleshoot Quiz Issues

1. Check Quiz Attempts
   • Go to Dashboard > My Courses > Admin tab
   • Click “Quiz Submissions”
   • Find the learner and see if they’ve already attempted the quiz
2. Reset the Quiz Attempt (if stuck or incomplete)
   • Click on the learner’s name
   • Click “Reset Attempt”
   • Confirm action
     ✅ They can now restart the quiz
3. Confirm Browser Compatibility
   • Ask learner to use Chrome or Edge, not in-app browsers like WhatsApp
   • Suggest refreshing the page or trying incognito mode
4. Time Expiry or Network Loss
   • If the learner ran out of time or lost signal, reset the quiz with a new duration (if needed)

🛠️ How to Troubleshoot Assignment Errors

1. Check File Type
   • VirtualX accepts: PDF, DOCX, JPG, PNG
   • Learner must not upload ZIP files or unsupported formats
2. Check Submission Status
   • Go to Admin tab > Assignment Submissions
   • Confirm if the file shows up
   • If blank, ask the learner to reupload using a different browser
3. Manually Upload on Behalf of Learner (if needed)
   • Ask the learner to email or WhatsApp you the file
   • Open the assignment and upload it manually using your teacher account
4. Enable Retry (if needed)
   • In the assignment settings, allow 2 or more attempts
   • Reset the submission for the learner to try again

🧑🏽‍🏫 Example in Action:

Ms. Ramathe notices that 3 learners couldn’t submit the Term 1 EMS quiz due to load-shedding. She opens the Admin tab, resets their quiz attempts, and gives them 2 extra days to finish. For one learner whose file didn’t upload, she allows a second attempt and guides them to try using Chrome.

📌 Quick Fix Checklist

Problem	Fix
Quiz locked	Reset attempt
Time expired	Extend quiz time or allow retry
File upload failed	Check file type and size
Blank submission	Ask for resubmission via another device
Error on mobile	Ask learner to use Chrome or a desktop browser

💡 Tips for Preventing Issues

Tip	Why It Helps
Always set 2 attempts for quizzes	Allows recovery from small issues
Provide clear file upload instructions	Reduces mistakes from learners
Post a test assignment in Week 1	Helps learners practise uploading early
Check quiz and assignment logs weekly	Spot issues before they grow

✅ Summary

Most quiz and assignment issues are easy to solve from the teacher dashboard—no need for technical knowledge or backend access. With a few resets and reminders, you can keep your learners on track and stress-free.