For Developers

Troubleshooting Issues

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.