Troubleshooting Issues

This document provides guidance for resolving common issues encountered during the integration of Moodle with Edlink. Each section outlines potential causes and steps to address the problem.

General Troubleshooting Steps

1. Verify Plugin Installation:
   • Ensure the Edlink plugin is correctly installed and configured in Moodle.
   • Confirm that API credentials, such as client ID and secret, are accurate.
2. Check Permissions:
   • Ensure the Moodle user associated with the API credentials has the required permissions to access categories, courses, users, enrollments, and assignments.
3. Review Logs:
   • Use Edlink’s logs and Moodle’s debugging tools to identify potential errors.
   • Look for common error codes or messages that indicate the issue.

Common Issues and Resolutions

Problem: Classes Don’t Appear

• Cause: Moodle courses are not linked to a category or are inactive.
• Resolution:
  1. Verify that each course in Moodle is assigned to a valid category.
  2. Check the course’s visibility settings in Moodle to ensure it is active.

Problem: Enrollments Are Missing

• Cause: Users are not properly enrolled in courses.
• Resolution:
  1. Check the enrollments in Moodle to confirm the user is assigned to the correct courses.
  2. Ensure the user’s roles (e.g., student, teacher) are properly configured in Moodle.

Problem: SSO Login Fails

• Cause: SSO configuration issues or mismatched user credentials.
• Resolution:
  1. Verify that the SSO settings in Edlink are correctly configured.
  2. Check that the user’s Moodle account is linked to their Edlink account.
  3. Test SSO with a different user to isolate the issue.

Problem: Assignments Are Incomplete or Missing

• Cause: Moodle assignments are not visible via the API or are misconfigured.
• Resolution:
  1. Confirm that the assignments are published and visible in Moodle.
  2. Ensure the Edlink plugin is correctly configured to access assignment data.

Problem: User Profiles Are Incomplete

• Cause: Moodle user profiles lack required information.
• Resolution:
  1. Ensure that user profiles in Moodle include fields like names, email addresses, and roles.
  2. Check for duplicate or conflicting user entries.

Error Codes and Messages

"Access Denied"

• Cause: The API user does not have sufficient permissions.
• Resolution:
  1. Ensure that the API user in Moodle has permissions to access the required data.
  2. Recheck the API credentials in Edlink.