Allows course authors to create a gradable component that will assign a grade to students based on their participation in the discussion forum. The instructor will be able to choose between different grading methods and configure each of them.
This XBlock has been created as an open source contribution to the Open edX platform and has been funded by Unidigital project from the Spanish Government - 2023.
| Open edX Release | Version |
|---|---|
| Palm | >= 0.2.0 |
| Quince | >= 0.2.0 |
| Redwood | >= 0.2.0 |
The settings can be changed in discussion_grading/settings/common.py or,
for example, in tutor configurations.
NOTE: the current common.py works with Open edX Palm, Quince and Redwood
version.
Once the XBlock has been installed in your Open edX installation, you can enable it in a course from Studio through the Advanced Settings.
- Go to Studio and open the course to which you want to add the XBlock.
- Go to Settings > Advanced Settings from the top menu.
- Search for Advanced Module List and add
"discussion_grading"to the list. - Click Save Changes button.
From Studio, you can add the Discussion Grading Component to a course unit.
Click on the Advanced button in Add New Component.
Select Discussion Grading from the list.
Configure the component as needed.
The Discussion Grading component has a set of settings that can be configured by the course author.
The Discussion Grading component has the following settings:
Grading Method: Allow the course author to choose between different grading methods. The available options are: - Minimum Participations: The learner will receive the maximum grade
if they have the minimum number of participations in the discussion forum. If the learner does not have the minimum number of participations, the grade is 0
- Weighted Participations: The learner will receive a grade based on the weighted number of participations in the discussion forum. The grade will be calculated as: (learner_participations / number of participations). The grade is rounded to the nearest integer.
Maximum Attempts: Allows the course author to set the maximum number of attempts that a learner can calculate the grade. If no value is set, the learner can calculate the grade as many times as they want.
Number of Participations: Allows the course author to set the number of participations that the learner must have in the discussion forum to receive the maximum grade.
Problem Weight: Allows the course author to set the weight of the discussion grading component in the final grade of the course.
Instructions Text: Allows the course author to set the instructions that will be displayed to the learner.
Button Text: Allows the course author to set the text that will be displayed on the button that the learner will use to calculate the grade.
When a learner accesses the course, they will see the instructions and the button to calculate the grade. If the course author has set the maximum number of attempts, the learner will see the number of attempts left. After the learner has calculated the grade, they will see the grade obtained.
XBlock is the Open edX component architecture for building custom learning interactive components.
You can see the Discussion Grading component in action in the XBlock Workbench. Running the Workbench requires having docker running.
git clone git@github.com:eduNEXT/xblock-discussion-grading virtualenv venv/ source venv/bin/activate cd xblock-discussion-grading make upgrade make install make dev.run
Once the process is done, you can interact with the Discussion Grading XBlock in the Workbench by navigating to http://localhost:8000
For details regarding how to deploy this or any other XBlock in the Open edX platform, see the installing-the-xblock documentation.
If you're having trouble, the Open edX community has active discussion forums available at https://discuss.openedx.org where you can connect with others in the community.
Also, real-time conversations are always happening on the Open edX community Slack channel. You can request a Slack invitation, then join the community Slack workspace.
For anything non-trivial, the best path is to open an issue in this repository with as many details about the issue you are facing as you can provide.
For more information about these options, see the Getting Help page.
The code in this repository is licensed under the AGPL-3.0 unless otherwise noted.
Please see LICENSE.txt for details.
Contributions are very welcome.
This project is currently accepting all types of contributions, bug fixes, security fixes, maintenance work, or new features. However, please make sure to have a discussion about your new feature idea with the maintainers prior to beginning development to maximize the chances of your change being accepted. You can start a conversation by creating a new issue on this repo summarizing your idea.
This Xblock is initially available in English and Spanish. You can help by translating this component to other languages. Follow the steps below:
- Create a folder for the translations in
locale/, eg:locale/fr_FR/LC_MESSAGES/, and create yourtext.pofile with all the translations. - Run
make compile_translations, this will generate the.mofile. - Create a pull request with your changes.
Please do not report a potential security issue in public. Please email security@edunext.co.