grade/report/simple grader/index

Jump to: navigation, search

Note: You are currently viewing documentation for Moodle 1.9. Up-to-date documentation for the latest stable version is available here: grade/report/simple grader/index.


The simple grader report page is the main teacher view of a new gradebook developed by LSU. For the original grader report look here.


A full featured simple grader report requires the simple tree, anonymous grade block, a slight modification to the existing theme's header.html, and a slight modification to lib/grade/grade_item.php.

  • Change the function in {MOODLE_ROOT}/grade/lib.php print_grade_plugin_selector on line 397:
   //Changing this to simple tree, rather than worrying about javascript to fix this
   //$url = 'edit/tree/index.php?id='.$courseid;
   $url = 'edit/simple_tree/index.php?id='.$courseid;

... And then further in the function for custom letter

   //Changing this to custom_letter, rather than worrying about javascript to fix this
   //$url = 'edit/letter/index.php?id='.$courseid;
   $url = 'edit/custom_letter/index.php?id='.$courseid;
  • The modification in grade_item.php is simply changing:
 var $aggregationcoef = 0;


 var $aggregationcoef = 1;
  • Add a check for Simple Grader report to gradelib, located in {MOODLE_ROOT}/lib/gradelib.php:

At the very beginning of the function grade_regrade_final_grade, you must add code that calculates core modules correctly. So, the code below must be added right under the function declaration line which looks something like:

 function grade_regrade_final_grades($courseid, $userid=null, $updated_item=null) {
  // Check for Simple Grader Report
   global $CFG;

   $exists = file_exists($CFG->dirroot. '/grade/report/simple_grader/lib/simple_gradelib.php');
   if ($exists) {
       require_once($CFG->dirroot . '/grade/report/simple_grader/lib/simple_gradelib.php');
       return simple_grade_regrade_final_grades($courseid, $userid, $updated_item);
  • Add a similar check in {MOODLE_ROOT}/grade/import/lib.php around line 55 in function grade_import_commit add the following:
      $use_function = false;
      $file = $CFG->dirroot . '/grade/report/simple_grader/lib/simple_gradelib.php';
      if (file_exists($file)) {
          $use_function = true;

Then jump to around line 82:

      // insert each individual grade to this new grade item
      foreach ($grades as $grade) {
        if ($use_function){
           if(!simple_update_final_grade($grade->userid, $gradeitem, 2, $grade->finalgrade, 'import', $grade->feedback, FORMAT_MOODLE)) {
                $failed = true;
                break 2;
        } else if (!$gradeitem->update_final_grade($grade->userid, $grade->finalgrade, 'import', $grade->feedback, FORMAT_MOODLE)) {
           $failed = true;
           break 2;

And lastly around line 125:

     // make the grades array for update_grade
     foreach ($grades as $grade) {
         if (!$importfeedback) {
              $grade->feedback = false; // ignore it
         if ($use_function){
             if(!simple_update_final_grade($grade->userid, $gradeitem, 2, $grade->finalgrade, 'import', $grade->feedback)) {
                 $failed = true;
                 break 2;
         } else if (!$gradeitem->update_final_grade($grade->userid, $grade->finalgrade, 'import', $grade->feedback)) {
             $failed = 1;
             break 2;
  • Denying access to the original grader report. Fortunately, this can be done in Moodle, defining capabilities.

With the Site Administration block navigate to Users->Permissions->Define Roles. For every role, change the gradereport/grader:view to "Not Set"

This will deny access to the original gradebook.

Note: in order to get help files to make sense in the simple tree, make sure that the help files location in simple_tree/lang/en_utf8/help/grade/ are moved into core.

Extra Features

The simple grader report is capable of supporting extra grading features like anonymous grading, adjusted values, and extra credit for Simple weighted and Weight mean's. To enable these features, simple grader requires the installation of the anonymous grade (or grade features) block. More on how to fully enable these features can be found on the anonymous grade block page.


The gradebook collects items that have been graded from the various parts of Moodle that are assessed, and allows you to view and change them as well as sort them out into categories and calculate totals in various ways. When you add an assessed item in a Moodle course, the gradebook automatically creates space for the grades it will produce and also adds the grades themselves as they are generated, either by the system or by you.

The grades displayed are initially displayed as the raw marks from the assessments themselves, so will depend on how you set those up e.g. an essay out of 36 will appear as how ever many raw marks that student got, not a percentage (although this can be changed later, see below).

Not that various default options for the gradebook are set at system level by the administrator and can be marked as being overridable by you, or fixed. This means that the options will not always be set up the same way for every user when they see the grader report for the first time.



Simple grader report at LSU. Notice the weights in grade categories.
Simple grader report with sticky tabs.
Simple grader report zooming in on student's image.

Along the top are several rows: first the course, then the category, then the actual column (e.g. an essay or a category total). When you start off, every essay, quiz etc is in the uncategorised category, which is named after the course by default, but can be changed if needed.

You can add a row showing the range of possible scores by going to My report preferences and selecting Show ranges.

There are three ways that the categories can be displayed

  • Grades only - without the category totals column
  • Collapsed - Category total column only
  • Full view - grades and the aggregates (the totals column for the category)

Each section has a small icon immediately to the right of its name. Clicking this will cycle through these display modes for that category. + goes to grades only view, o goes to full view and - goes to collapsed view.

If a parent category is Weighted Mean, children categories will have a percent next to them that represent the scaled weight of the child category to it's parent.

If the student has a profile picture, when the teacher mouses over the image, it will zoom in.

Other layout options

The defaults for these options can be set at site level by going to Administration->Grades->Report settings->Simple Grader Report.

  • You can add a row showing the range of possible scores by going to My report preferences and selecting Show ranges.
  • 'Sticky' tabs can be set through report preferences (Note: Sticky tabs are not supported with IE6).

Highlighting rows and columns

When your gradebook starts to grow, it can be hard to keep track of which student and which assignment a cell refers to. Highlighting solves that.

  • Clicking on empty space in the cell that contains the students name will toggle the highlighting of that entire row
  • Clicking on empty space in the cell at the top of each column will toggle highlighting of the entire column

(Note: this requires Javascript to be enabled in your browser.)

Highlighting scores that are either adequate or unacceptable in red and green

Turn editing on and click on the edit icon in the controls cell at the top of the column. You can then (maybe need to click 'show advanced') see the option to enter a 'grade to pass'. Once set, any grades falling above this will be highlighted in green and any below will be highlighted in red.

Categorising the grades

The 'Choose an action...' drop down on the upper left will let you switch to other views

  • Edit categories and items will allow you to set up your assessments in different categories e.g. 'classwork', 'homework' etc.

Each category will then have its own Category total column.


Simple grader report in editing mode

Note: Editing anything in the gradebook refers to editing the grades only and none of the available operations bear any relationship to editing the main course page i.e. the appearance of your course page cannot be influenced by anything you do in the gradebook.

There are two ways to edit grades in simple gradebook:

  • The original edit mode initiated by clicking the "Turn editing on" button
  • Through the Quick Edit screens

The "Turn editing on" button functions separately to the main course one, so editing can be on in the gradebook, but simultaneously off when you switch back to course view. This is because editing grades and editing the course page are separate capabilities and a role e.g. 'non-editing teacher' may only have one or the other.

The quick edit way, offers a more drilled down approach to grading, which doesn't require the teacher to constantly be in edit mode. More information on how to quick edit can be found here.

Altering the grades through Edit Mode

You can click "Turn editing on" at the top right to show an edit icon next to each grade. Clicking on the icon will bring up the editing screen for that grade which will allow you to set the grade, its written feedback and a number of other attributes.

Alternatively, you can click on "My report preferences"' and choose "Quick grading" and "Quick feedback" to make the report appear with editable boxes containing each grade, so you can change many at once.

Quick feedback is switched off by default, but you can easily switch it on or off using the "Show Quick Feedback" link above the grader report, when editing is on. Alternatively you can switch it on and off in the page "My report preferences".

Quick note about Anonymous grade items

(Anonymous grade items can be enabled through the anonymous grade block.) The idea of anonymous grading is to promote honest grading of grade, as the student remains completely anonymous. As such, stricter measures are used. Use anonymous grading with care.

Anonymous grade items go through two states. When they are first created, they become 'anonymous incomplete' grade items. While in the incomplete state, their grades can only be edited through the quick edit screens, and remain as blank grades in the report. They can be edited until all the grades for that item have been filled out, then they become 'anonymous complete' items. Once an anonymous grade item is made complete, the teacher can no longer edit the grades for this item, and the grade becomes visible in the report.

There is, however, a way to adjust the final grade for an 'anonymous complete' item. This can be done by entering an adjustment value through in the 'Adjustments' column in the quick edit screens. Note: Maximum adjustment values can be set through anonymous grade block.

Calculating totals

Simple grader supports three aggregation methods:

Simple grader supports extra credit for each aggregation method, and grades over max.

Hiding columns or individual grades

Turning on editing then clicking the "Show show/hide icons" link will give you the familiar show/hide eye icon next to each grade and at the top of each column. For more information, read about grade hiding.


If you change any part of an assesment e.g. alter the maximum grade for one of the questions in a quiz, you may find that the columns do not yet reflect the change you have made. Click 'Turn editing on' twice to force the gradebook to re-check.

See also