This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 3 of the License, or (at your option) any later version.
This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.
This module creates an assignment in Moodle, where the student's grades can be updated from the results of an assignment in an external system (i.e. GitHub Classroom). Besides the grade and feedback from the external system, there are separate fields for manual grading and feedback.
We developed this module to integrate automatic grading from GitHub Classroom into Moodle. The plugin is not limited to use with GitHub Classroom, it should work with any external system.
At this time the plugin only supports individual assignments.
This plugin is being developed for my own classes and is still in testing. I try to make this plugin as safe and error-free as possible. I cannot give any guarantees or accept any liability if you use this plugin in your Moodle installation. Before use, I encourage you to study the source code (and give me feedback if you find any flaws) and install it in a test instance.
To match the grades to the correct user, the username in the external system (i.e. Classroom, ...) must be set in the Moodle user profile. To add an additional field to the user profile see https://docs.moodle.org/402/en/User_profile_fields.
This screenshot shows our setup:
Download this plugin as a ZIP archive and install it in your Moodle (see https://docs.moodle.org/403/en/Installing_plugins#Installing_a_plugin). During installation, you will be asked to specify the short name of the custom field for the external username you created above. In my setup, this is "github_username".
Create a new external web service (See https://docs.moodle.org/403/en/Using_web_services) and add the function "mod_assignexternal_update_grade" to it. This creates an endpoint for the external system to send the grade and feedback. Take note of the token generated for this service.
- HTTP-method:
POST - URL:
https://YOURMOODLE.HLQ/webservice/rest/server.php?wstoken=TOKEN&wsfunction=mod_assignexternal_update_grade - Body:
- assignment_name: String
- user_name: String
- points: Float
- max: Float
- externallink: String
- feedback: String
These are the basic steps to use this module. The details depend on the kind of assignment and the external system you use.
- Add the external username to the Moodle profile of your students.
- Create an assignment in the external system.
- Create a new external assignment in your Moodle with the following details:
- a link to the external assignment.
- the name of the external assignment.
- a description of the task.
- maximum points for external and manual grades.
The external system needs a script that calls the web service in Moodle. Every time the web service gets called, it updates the external grade and feedback for the student. Additionally, you can manually grade the assignment and give feedback.
For more information see the Wiki.