For Developers
Troubleshooting Issues
General Troubleshooting Steps
- 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.
- Check Permissions:
- Ensure the Moodle user associated with the API credentials has the required permissions to access categories, courses, users, enrollments, and assignments.
- 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:
- Verify that each course in Moodle is assigned to a valid category.
- 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:
- Check the enrollments in Moodle to confirm the user is assigned to the correct courses.
- 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:
- Verify that the SSO settings in Edlink are correctly configured.
- Check that the user's Moodle account is linked to their Edlink account.
- 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:
- Confirm that the assignments are published and visible in Moodle.
- Ensure the Edlink plugin is correctly configured to access assignment data.
Problem: User Profiles Are Incomplete
- Cause: Moodle user profiles lack required information.
- Resolution:
- Ensure that user profiles in Moodle include fields like names, email addresses, and roles.
- Check for duplicate or conflicting user entries.
Error Codes and Messages
"Access Denied"
- Cause: The API user does not have sufficient permissions.
- Resolution:
- Ensure that the API user in Moodle has permissions to access the required data.
- Recheck the API credentials in Edlink.