Description

This package provides three custom grading features for OpenEdx: "passing grade", "problem best score" and "vertical grading".

Passing grade feature allows to specify in studio minimal percent that should be earned for each assignment category. If these requirements are not met, course is considered as not passed even if overall percent is high enough. Messages about failed categories are shown to student at the progress page.

Problem best score forces grading system to choose the best score that student have ever got for given problem. E.g. student got 1.5/2 points for problem, tried the second attempt and got 0.5/2 points. At progress pages his score for this problem is still 1.5/2.

Vertical grading adds new way of grading: scores are given for units, and scores for problem are used only to compute fraction of unit max score that student have earned. E.g, unit has max score 5 and consists of Problem1(1 point) and Problem2(2 points). If student passed first one and failed the last one, his would earn for this unit 5*(1/(2+1)) = 1.66 points.

It was tested on Ginkgo release . Vertical Grading and Passing Grade features can't be enabled at Ficus and earlier edX versions.

Vertical Grading Feature Installation

1. Install this package, add it into the INSTALLED_APPS and run migrations if it is not done yet.

   python -m pip install -e git+https://github.com/zimka/vertical_grading.git#egg=vertical-grading
   python manage.py lms migrate npoed_grading_features --settings=YOUR_SETTINGS
   

2. Apply decorator 'enable_vertical_grading' to the next classes/functions

   • lms.djangoapps.grades.new.subsection_grade.py: CourseGradeBase
   • common.lib.xmodule.xmodule: CourseFields
   • common.lib.xmodule.xmodule.vertical_block.py: VerticalBlock
   • common.lib.xmodule.xmodule.graders.py: AssignmentFormatGrader
   • cms.djangoapps.contentstore.views.item.py: create_xblock_info
   • cms.djangoapps.models.settings.py: CourseMetadata

Example:

...
from npoed_grading_features import enable_vertical_grading

@enable_vertical_grading
class SubsectionGrade(SubsectionGradeBase):
...

3. Enable feature in lms and cms settings

FEATURES["ENABLE_GRADING_FEATURES"] = True

4. Run django command

python manage.py lms load_static_grading_feature vertical_grading --settings=SETTINGS

Or copy static files manually from static/vertical_grading

6. At the admin dashboard find NpoedGradingFeatures and add desired course with "Vertical Grading" flag on.
7. (Optional) Update staticfiles
8. (Optional) Set variable VERTICAL_GRADING_DEFAULT at SETTINGS to True/False. Works for courses which don't have records at NpoedGradingFeatures model. Default is False.

Passing Grade Feature Installation

1. Install this package, add it into the INSTALLED_APPS and run migrations if it is not done yet (same to vertical grading).

   python -m pip install -e git+https://github.com/zimka/npoed_grading_features.git#egg=npoed-grading-features
   python manage.py lms migrate npoed_grading_features --settings=YOUR_SETTINGS
   

2. Apply decorator 'enable_passing_grade' to the next classes/functions

• cms.djangoapps.models.settings.course_grading.py: CourseGradingModel
• lms.djangoapps.grade.new.course_grade.py: CourseGrade
• lms.djangoapps.courseware.views.py: is_course_passed
• lms.djangoapps.courseware.views.py: _credit_course_requirements

Example:

...
from npoed_grading_features import enable_passing_grade

@enable_passing_grade
def _credit_course_requirements
...

4. Enable feature in lms and cms settings

FEATURES["ENABLE_GRADING_FEATURES"] = True

5. Run django command

python manage.py lms load_static_grading_feature passing_grade --settings=SETTINGS

Or copy static files manually from static/vertical_grading

6. At the admin dashboard find NpoedGradingFeatures and add desired course with "Passing Grade" flag on.
7. (Optional) Update staticfiles

Problem Best Score Installation

1. Install this package, add it into the INSTALLED_APPS and run migrations if it is not done yet (same to vertical grading).

   python -m pip install -e git+https://github.com/zimka/npoed_grading_features.git#egg=npoed-grading-features
   python manage.py lms migrate npoed_grading_features --settings=YOUR_SETTINGS
   

2. Apply decorator 'enable_problem_best_score' to the next classes/functions

• lms.djangoapps.courseware.model_data.py: set_score

Example:

...
from npoed_grading_features import enable_passing_grade

@enable_problem_best_score
def set_score(...):
...

4. Enable feature in lms and cms settings

FEATURES["ENABLE_GRADING_FEATURES"] = True