MoodleDocs - User contributions [en]

Site wide user report

2010-07-04T20:34:05Z

Barrysspace: /* Limitations */

==Introduction==
The Site Wide User Report was developed by [http://www.beauxcreations.com Barry Oosthuizen] as a quick way to get a detailed overview of all user reports on a site.
It also acts as a quick way to navigate to any other course's User Reports by use of hyperlinks on the course names. I made it because it was easy to make, took only a day to develop and I think it will be useful for somebody

==Installation==
*Upload and extract the zip file from the Modules and Plugins database to your grade/report folder.
*Visit the Site Admin > Notifications page

==How to use it==
#Visit any course page as teacher/admin etc
#Click on Grades in the Administration block / Visit the gradebook
#Click on the "Site Wide User Report" subtab / option from the "Choose an action menu" (if you still use this)
##You are now viewing everyone's grades for all courses you have access to
##To view only one of the displayed courses's User Report, click on the name of the course
##To view the Site Wide User Reports of only one specific student, click on the name of the student
###To view only one user report (not site wide) of a student click on their name for that course.
##To use the Site Wide User Report as a navigation help, right click and choose 'open as new tab' when you open a new Site Wide User report / User Report. This way you can always come back to the back without having to wait for the page to refresh.

==Live Demo==
You may visit the [http://www.example.com Beaux Creations website] where you will find log in instructions. You can then view the multi course grader in action by visiting the Grade Book of any course and then clicking on the 'Site Wide User Report' subtab (or using the "Choose an action" dropdown menu)

==Limitations==
*The Site Wide User Report does not cater for groups. The standard user reports may be used for that purpose.
*To limit the amount of courses shown in the report a new feature has been added (Course Selector tool). For really large insitutions this will help to speed up the report running time
*Groups cannot yet be filtered

==Access Levels==
*User with moodle/grade:viewall & gradereport/sitewideuser:view capabilities can view all the grades for all the courses where they have those permissions
*Students can only view there own reports (unless permission overrides are defined).

==Screen Shot==
=== Course Selector ===
This is a new feature in the Development version
Available to download from [http://www.beauxcreations.com/course/view.php?id=11]
[[Image:Site_wide_user_report_-_Course_selector.jpg]]
=== Report ===
[[Image:beaux_creations_site_wide_user_report.gif]]

[[Category:Contributed code]]

Site wide user report

2010-07-04T20:19:38Z

Barrysspace: /* Access Levels */

==Introduction==
The Site Wide User Report was developed by [http://www.beauxcreations.com Barry Oosthuizen] as a quick way to get a detailed overview of all user reports on a site.
It also acts as a quick way to navigate to any other course's User Reports by use of hyperlinks on the course names. I made it because it was easy to make, took only a day to develop and I think it will be useful for somebody

==Installation==
*Upload and extract the zip file from the Modules and Plugins database to your grade/report folder.
*Visit the Site Admin > Notifications page

==How to use it==
#Visit any course page as teacher/admin etc
#Click on Grades in the Administration block / Visit the gradebook
#Click on the "Site Wide User Report" subtab / option from the "Choose an action menu" (if you still use this)
##You are now viewing everyone's grades for all courses you have access to
##To view only one of the displayed courses's User Report, click on the name of the course
##To view the Site Wide User Reports of only one specific student, click on the name of the student
###To view only one user report (not site wide) of a student click on their name for that course.
##To use the Site Wide User Report as a navigation help, right click and choose 'open as new tab' when you open a new Site Wide User report / User Report. This way you can always come back to the back without having to wait for the page to refresh.

==Live Demo==
You may visit the [http://www.example.com Beaux Creations website] where you will find log in instructions. You can then view the multi course grader in action by visiting the Grade Book of any course and then clicking on the 'Site Wide User Report' subtab (or using the "Choose an action" dropdown menu)

==Limitations==
*The Site Wide User Report does not cater for groups. The standard user reports may be used for that purpose.
*For really large insitutions this may take ages to load

==Access Levels==
*User with moodle/grade:viewall & gradereport/sitewideuser:view capabilities can view all the grades for all the courses where they have those permissions
*Students can only view there own reports (unless permission overrides are defined).

==Screen Shot==
=== Course Selector ===
This is a new feature in the Development version
Available to download from [http://www.beauxcreations.com/course/view.php?id=11]
[[Image:Site_wide_user_report_-_Course_selector.jpg]]
=== Report ===
[[Image:beaux_creations_site_wide_user_report.gif]]

[[Category:Contributed code]]

Site wide user report

2010-07-04T20:00:11Z

Barrysspace: /* Screen Shot */

==Introduction==
The Site Wide User Report was developed by [http://www.beauxcreations.com Barry Oosthuizen] as a quick way to get a detailed overview of all user reports on a site.
It also acts as a quick way to navigate to any other course's User Reports by use of hyperlinks on the course names. I made it because it was easy to make, took only a day to develop and I think it will be useful for somebody

==Installation==
*Upload and extract the zip file from the Modules and Plugins database to your grade/report folder.
*Visit the Site Admin > Notifications page

==How to use it==
#Visit any course page as teacher/admin etc
#Click on Grades in the Administration block / Visit the gradebook
#Click on the "Site Wide User Report" subtab / option from the "Choose an action menu" (if you still use this)
##You are now viewing everyone's grades for all courses you have access to
##To view only one of the displayed courses's User Report, click on the name of the course
##To view the Site Wide User Reports of only one specific student, click on the name of the student
###To view only one user report (not site wide) of a student click on their name for that course.
##To use the Site Wide User Report as a navigation help, right click and choose 'open as new tab' when you open a new Site Wide User report / User Report. This way you can always come back to the back without having to wait for the page to refresh.

==Live Demo==
You may visit the [http://www.example.com Beaux Creations website] where you will find log in instructions. You can then view the multi course grader in action by visiting the Grade Book of any course and then clicking on the 'Site Wide User Report' subtab (or using the "Choose an action" dropdown menu)

==Limitations==
*The Site Wide User Report does not cater for groups. The standard user reports may be used for that purpose.
*For really large insitutions this may take ages to load

==Access Levels==
*Users can only view courses/grades to which they have permission to view the grade reports.

==Screen Shot==
=== Course Selector ===
This is a new feature in the Development version
Available to download from [http://www.beauxcreations.com/course/view.php?id=11]
[[Image:Site_wide_user_report_-_Course_selector.jpg]]
=== Report ===
[[Image:beaux_creations_site_wide_user_report.gif]]

[[Category:Contributed code]]

Site wide user report

2010-07-04T19:54:46Z

Barrysspace: /* Screen Shot */

==Introduction==
The Site Wide User Report was developed by [http://www.beauxcreations.com Barry Oosthuizen] as a quick way to get a detailed overview of all user reports on a site.
It also acts as a quick way to navigate to any other course's User Reports by use of hyperlinks on the course names. I made it because it was easy to make, took only a day to develop and I think it will be useful for somebody

==Installation==
*Upload and extract the zip file from the Modules and Plugins database to your grade/report folder.
*Visit the Site Admin > Notifications page

==How to use it==
#Visit any course page as teacher/admin etc
#Click on Grades in the Administration block / Visit the gradebook
#Click on the "Site Wide User Report" subtab / option from the "Choose an action menu" (if you still use this)
##You are now viewing everyone's grades for all courses you have access to
##To view only one of the displayed courses's User Report, click on the name of the course
##To view the Site Wide User Reports of only one specific student, click on the name of the student
###To view only one user report (not site wide) of a student click on their name for that course.
##To use the Site Wide User Report as a navigation help, right click and choose 'open as new tab' when you open a new Site Wide User report / User Report. This way you can always come back to the back without having to wait for the page to refresh.

==Live Demo==
You may visit the [http://www.example.com Beaux Creations website] where you will find log in instructions. You can then view the multi course grader in action by visiting the Grade Book of any course and then clicking on the 'Site Wide User Report' subtab (or using the "Choose an action" dropdown menu)

==Limitations==
*The Site Wide User Report does not cater for groups. The standard user reports may be used for that purpose.
*For really large insitutions this may take ages to load

==Access Levels==
*Users can only view courses/grades to which they have permission to view the grade reports.

==Screen Shot==
[[Image:Site_wide_user_report_-_Course_selector.jpg]]
[[Image:beaux_creations_site_wide_user_report.gif]]

[[Category:Contributed code]]

File:Site wide user report - Course selector.jpg

2010-07-04T19:53:49Z

Barrysspace:

Multi course grader report

2010-07-04T19:28:03Z

Barrysspace: /* Screen Shot */

==Introduction==
The Multi Course Grader Report was developed by [http://www.beauxcreations.com Barry Oosthuizen] as a quick way to get a detailed overview of all courses on site.
It also acts as a quick way to navigate to any other course's Grader Report by use of hyperlinks on the course names. I made it because it was easy to make, took only a day to develop and I think it will be useful for somebody

==Installation==
*Upload and extract the zip file from the Modules and Plugins database to your grade/report folder.
*Visit the Site Admin > Notifications page

==How to use it==
#Visit any course page as teacher/admin etc
#Click on Grades in the Administration block / Visit the gradebook
#Click on the "Multi Course Grader Report" subtab / option from the "Choose an action menu" (if you still use this)
##You are now viewing everyone's grades for all courses you have access to
##To view only of the displayed courses's Grader Report, click on the name of the course
##To visit the XLS/XML/ODS/TXT Grade Export page of any of the displayed courses (when in Multi Grader view) click on the appropriate icon underneath the Course name
##To use the multi grader as a navigation help, right click and choose 'open as new tab' when you open a new Grader report or Grade Export page. This way you can always come back to the back without having to wait for the page to refresh

==Live Demo==
You may visit the [http://www.beauxcreations.com/ Beaux Creations website] where you will find log in instructions. You can then view the multi course grader in action by visiting the Grade Book of any course and then clicking on the 'Multi Course Grader Report' subtab (or using the "Choose an action" dropdown menu)

==Limitations==
*The Multi Course Grader does not cater for groups or grade editing. The standard grader report may be used for that purpose.

==Access Levels==
*Users can only view courses to which they have permission to view the grade reports.

==Screen Shots==

[[Image:Category_and_Course_Selector.jpg]]

[[Image:beaux_creations_multi_course_grader_report.gif]]

[[Category:Contributed code]]

Multi course grader report

2010-07-04T19:27:15Z

Barrysspace: /* Screen Shot */

==Introduction==
The Multi Course Grader Report was developed by [http://www.beauxcreations.com Barry Oosthuizen] as a quick way to get a detailed overview of all courses on site.
It also acts as a quick way to navigate to any other course's Grader Report by use of hyperlinks on the course names. I made it because it was easy to make, took only a day to develop and I think it will be useful for somebody

==Installation==
*Upload and extract the zip file from the Modules and Plugins database to your grade/report folder.
*Visit the Site Admin > Notifications page

==How to use it==
#Visit any course page as teacher/admin etc
#Click on Grades in the Administration block / Visit the gradebook
#Click on the "Multi Course Grader Report" subtab / option from the "Choose an action menu" (if you still use this)
##You are now viewing everyone's grades for all courses you have access to
##To view only of the displayed courses's Grader Report, click on the name of the course
##To visit the XLS/XML/ODS/TXT Grade Export page of any of the displayed courses (when in Multi Grader view) click on the appropriate icon underneath the Course name
##To use the multi grader as a navigation help, right click and choose 'open as new tab' when you open a new Grader report or Grade Export page. This way you can always come back to the back without having to wait for the page to refresh

==Live Demo==
You may visit the [http://www.beauxcreations.com/ Beaux Creations website] where you will find log in instructions. You can then view the multi course grader in action by visiting the Grade Book of any course and then clicking on the 'Multi Course Grader Report' subtab (or using the "Choose an action" dropdown menu)

==Limitations==
*The Multi Course Grader does not cater for groups or grade editing. The standard grader report may be used for that purpose.

==Access Levels==
*Users can only view courses to which they have permission to view the grade reports.

==Screen Shot==

[[Image:Category_and_Course_Selector.jpg]]

[[Image:beaux_creations_multi_course_grader_report.gif]]

[[Category:Contributed code]]

File:Category and Course Selector.jpg

2010-07-04T19:24:43Z

Barrysspace: Course selector for Multi Course Grader Report

Course selector for Multi Course Grader Report

Site wide user report

2010-02-01T21:27:35Z

Barrysspace: New page: ==Introduction== The Site Wide User Report was developed by [http://www.beauxcreations.com Barry Oosthuizen] as a quick way to get a detailed overview of all user reports on a site. It als...

==Introduction==
The Site Wide User Report was developed by [http://www.beauxcreations.com Barry Oosthuizen] as a quick way to get a detailed overview of all user reports on a site.
It also acts as a quick way to navigate to any other course's User Reports by use of hyperlinks on the course names. I made it because it was easy to make, took only a day to develop and I think it will be useful for somebody

==Installation==
*Upload and extract the zip file from the Modules and Plugins database to your grade/report folder.
*Visit the Site Admin > Notifications page

==How to use it==
#Visit any course page as teacher/admin etc
#Click on Grades in the Administration block / Visit the gradebook
#Click on the "Site Wide User Report" subtab / option from the "Choose an action menu" (if you still use this)
##You are now viewing everyone's grades for all courses you have access to
##To view only one of the displayed courses's User Report, click on the name of the course
##To view the Site Wide User Reports of only one specific student, click on the name of the student
###To view only one user report (not site wide) of a student click on their name for that course.
##To use the Site Wide User Report as a navigation help, right click and choose 'open as new tab' when you open a new Site Wide User report / User Report. This way you can always come back to the back without having to wait for the page to refresh.

==Live Demo==
You may visit the [http://www.example.com Beaux Creations website] where you will find log in instructions. You can then view the multi course grader in action by visiting the Grade Book of any course and then clicking on the 'Site Wide User Report' subtab (or using the "Choose an action" dropdown menu)

==Limitations==
*The Site Wide User Report does not cater for groups. The standard user reports may be used for that purpose.
*For really large insitutions this may take ages to load

==Access Levels==
*Users can only view courses/grades to which they have permission to view the grade reports.

==Screen Shot==
[[Image:beaux_creations_site_wide_user_report.gif]]

File:beaux creations site wide user report.gif

2010-02-01T21:26:12Z

Barrysspace: Screenshot of the Site Wide user report. Clicking on a Course name drills down to that one course only Clicking on a student name drills down to the Site Wide User Report for that student only

Screenshot of the Site Wide user report.

Clicking on a Course name drills down to that one course only

Clicking on a student name drills down to the Site Wide User Report for that student only

Multi course grader report

2010-02-01T21:17:16Z

Barrysspace:

==Introduction==
The Multi Course Grader Report was developed by [http://www.beauxcreations.com Barry Oosthuizen] as a quick way to get a detailed overview of all courses on site.
It also acts as a quick way to navigate to any other course's Grader Report by use of hyperlinks on the course names. I made it because it was easy to make, took only a day to develop and I think it will be useful for somebody

==Installation==
*Upload and extract the zip file from the Modules and Plugins database to your grade/report folder.
*Visit the Site Admin > Notifications page

==How to use it==
#Visit any course page as teacher/admin etc
#Click on Grades in the Administration block / Visit the gradebook
#Click on the "Multi Course Grader Report" subtab / option from the "Choose an action menu" (if you still use this)
##You are now viewing everyone's grades for all courses you have access to
##To view only of the displayed courses's Grader Report, click on the name of the course
##To visit the XLS/XML/ODS/TXT Grade Export page of any of the displayed courses (when in Multi Grader view) click on the appropriate icon underneath the Course name
##To use the multi grader as a navigation help, right click and choose 'open as new tab' when you open a new Grader report or Grade Export page. This way you can always come back to the back without having to wait for the page to refresh

==Live Demo==
You may visit the [http://www.example.com Beaux Creations website] where you will find log in instructions. You can then view the multi course grader in action by visiting the Grade Book of any course and then clicking on the 'Multi Course Grader Report' subtab (or using the "Choose an action" dropdown menu)

==Limitations==
*The Multi Course Grader does not cater for groups or grade editing. The standard grader report may be used for that purpose.

==Access Levels==
*Users can only view courses to which they have permission to view the grade reports.

==Screen Shot==
[[Image:beaux_creations_multi_course_grader_report.gif]]

Multi course grader report

2010-02-01T21:07:16Z

Barrysspace:

Multi course grader report

2010-02-01T21:06:15Z

Barrysspace: /* Introduction */

Multi course grader report

2010-02-01T20:59:21Z

Barrysspace: New page: ==Introduction== The Multi Course Grader Report was developed by [http://www.beauxcreations.com Barry Oosthuizen] as a quick way to get a detailed overview of all courses on site. It also ...

File:beaux creations multi course grader report.gif

2010-02-01T20:54:36Z

Barrysspace: This is an example screenshot of multiple Grader Reports on one page. The Course names acts as links to individual Grader Reports. The icons underneath the Course name links to the Excel/XML/ODS/Text Grade Export page for that specific course.

This is an example screenshot of multiple Grader Reports on one page. The Course names acts as links to individual Grader Reports. The icons underneath the Course name links to the Excel/XML/ODS/Text Grade Export page for that specific course.

Development:YUI

2010-01-25T20:33:40Z

Barrysspace:

The '''Yahoo! User Interface''' (YUI) Library is a set of utilities and controls, written in JavaScript, for building richly interactive web applications using techniques such as DOM scripting, DHTML and AJAX.

All components in the YUI Library have been released as open source under a BSD license and are free for all uses.

Details of the YUI can be found at the [http://developer.yahoo.com/yui/index.html Yahoo Developer Website].

==Note==

Some of the following information will be out of date when Moodle 2.0 is released. Please see [[Development:JavaScript guidelines]] for the latest information.

==Getting started==

One approach is to find an example that is close to what you want, either in the Moodle code, or on the [http://developer.yahoo.com/yui/examples/slider/index.html Yahoo Developer Website]. Then adapt it to your needs.

The entire YUI libraries are all part of a single YAHOO object, so they will not clash with other code. You then use them like this:
<code javascript>
YAHOO.util.Event.onDOMready(...);
</code>

=== Dependencies ===

In order to make the ''onDOMready'' method available to you, you first include a .js file that sets up the global object, then the events library .js file that adds all of the events methods to it. Moodle's way of doing this is with the ''require_js()'' function:

<code php>
require_js(array('yui_yahoo', 'yui_event'));
</code>

As you can see, you need only refer to the libraries by name. You don't need to know the full path. The [http://xref.moodle.org/lib/ajax/ajaxlib.php.source.html#l6 ajax_get_lib()] function in ''/lib/ajax/ajaxlib.php'' has the complete list of libraries.

Once you have included the various .js dependency files with ''require_js()'' as outlined above, then write your own source .js file and add that to the require_js array '''after''' the other YUI ones. Many of the YUI files have other dependencies, so you'll often need to include more than one and the order matters for them too. Just follow the examples.

=== Skinning ===

For CSS, you include the css dependency files in either your theme styles.php or module/block styles.php using the standard PHP include() function. You will often need to apply the yui-skin-sam style to the body tag to get the skins to work right, so add something near the top of your script like:

<code php>
document.body.className += ' yui-skin-sam';
</code>

As a caveat, the paths in the CSS files assume that yui is placed in the site's web root and have no reference to $CFG->wwwroot, so none of the images work. The solution is to go through the CSS files, pulling out any that have

<code php>
background: url(../../whatever.png);
</code>

and paste them into your styles.php below the css include you've added, but looking like this:

<code php>
background: url(<?php echo $CFG->wwwroot ?>/lib/yui/whatever.png);
</code>

== Performance ==

Remember to use [http://developer.yahoo.com/yui/examples/event/event-delegation.html event bubbling] wherever possible so that instead of adding a drag-drop listener to every page element, you just add one to the content div which catches all of the events lower down the DOM tree and does what's needed.

== Debugging ==

* Ideally, you should use '''Firefox''', with the [https://addons.mozilla.org/en-US/firefox/addon/60 Web Developer Toolbar], [https://addons.mozilla.org/en-US/firefox/addon/1843 Firebug] and [https://addons.mozilla.org/en-US/firefox/addon/5369 YSlow] extensions loaded (see also [[Development:Firebug]] and [[Web developer extension]]).

* The '''YUI logger''' will need to be included as a dependency if you want to use the xxx-debug.js versions of the files, so you need to add it to require_js() before them.

== See also ==

* [http://developer.yahoo.com/yui/ The official YUI documentation]
* [[JavaScript FAQ]]

[[Category:Javascript|YUI]]
[[Category:AJAX|YUI]]
{{CategoryDeveloper}}

Grader report

2009-12-26T23:14:52Z

Barrysspace: /* Changing the Order of Assignments within Categories */

{{Grades}}The grader report page is the main teacher view of the new gradebook in Moodle 1.9. For versions prior to 1.9, look [[Grades_pre-1.9 | here]].

=Basics=
The gradebook collects [[Grade_items|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 [[Grade_categories|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|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 however many raw marks that student got, not a percentage (although this can be changed later, see below).

Note 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.

=Display=
==Layout==
[[Image:gradebook_normal_mode.png|right|thumb|Grader report in non-editing mode]]
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 [[Grade_preferences|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.

===Other layout options===
The defaults for these options can be set at site level by going to Administration->Grades->[[Gradebook_report_settings|Report settings]]->Grader report.

*You can add a row showing the range of possible scores by going to [[Grade_preferences|My report preferences]] and selecting '''Show ranges'''.

==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.)
==Sorting by columns==

You can sort by any column. Click the [[Image:Move.gif]] symbol near the top of a column to sort by that column. This will change the symbol to a single downarrow. Clicking again will sort lowest-to-highest, changing the symbol to an uparrow. The arrows will toggle between these two states until you click on a different column.

The student name columns do not have the [[Image:Move.gif]] symbol. Clicking on either the first or last name will cause the report to sort.

*Examples

{| style="width:75%; border="0" align="center"
|[[Image:Grade Report unsorted column1.png|frame|center|Unsorted]]
||[[Image:Grade Report sorted column2.png|frame|center|Sorted]]
||[[Image:Grade Report unsorted name1.png|frame|center|Unsorted]]
||[[Image:Grade Report sorted lastname3.png|frame|center|Sorted ]]
|-
|}

==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.

Note that the highlighting will not show if the Grader report is viewed in the editing mode.

==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.

==Horizontal scrollbar==
[[Image:Gradebook horizontal scrollbar.png|thumb|Grader report with horizontal scrollbar]]
In Moodle 1.9.5 onwards, administrators may enable a static students column (in ''Administration > Grades > Report settings > [[Gradebook report settings|Grader report]]'') for teachers to scroll grades in the grader report using a horizontal scrollbar. (Note that this feature is not available for IE6 users or for users who have have the screenreader setting in their profile set to Yes.)

==Mouse-over tooltips==

In Moodle 1.9.5 onwards, each grade cell in the table has a tooltip indicating the user and grade item to which the grade belongs.

=Editing=
[[Image:gradebook_edit_mode.png|right|thumb|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. The "Turn editing on" button functions separately from 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. Roles such as 'non-editing teacher' may only have one or the other.

==Altering the grades==
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 "[[Grade_preferences|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. This capability can be a real time saver, but make sure to save at reasonable intervals lest a pageful of changes be lost. You can lose unsaved changes by bringing up a new page in the browser, such as a Moodle manual page. If you want a manual page or the like, be sure to bring it up in a new tab.

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 "[[Grade_preferences|My report preferences]]".

==The significance of altering the grades in this screen==
If you make changes here, they're highlighted in this screen going forward. The orange highlight represents a grade altered outside of its native assignment page.

==Calculating totals==
Rather than a simple average or sum, Moodle can perform very complex calculations to produce the totals for each category and for the whole course. e.g. you want to take an average of 3 items from one category, double it, then add it to the average of another category.

You can do this using calculations. Either turn on editing, then click '''Show calculations''', or go to '''[[Grade_preferences|My report preferences]]''', choose '''show calculations''', then save and turn editing on. You will then see a small calculator icon next to each total column which, when you click on it, will take you to the page [[Edit grade calculation]] where there are instructions.

To choose how the grades are aggregated for the totals within categories, you can turn editing on and click on the little editing icon for the category. You can then choose to have means, medians, modes etc. You can also leave out empty grades and choose other settings.

==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|grade hiding]].

==Recalculating==
If you change any part of an assessment 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.

==Changing the Order of Assignments within Categories==
Assignments are listed across the top in the order they are created. The order is not affected by the date the assignment is due, the title of the assignment or the ID number.

===Move an individual Grade item or Grade Category===
On the "Edit categories and items" page of the gradebook there is a series of icons under the 'Actions' column one of which is a up/down arrow called 'move'. Click on the icon and then click on one of the empty boxes to where you want to move the item to.

===Move a number of Grade items simultaneously===
On the "Edit categories and items" page of the gradebook, under the 'Select' column tick the check boxes of the grade items you want to move. Now scroll down to the bottom of the page and find the 'Move selected items to' option list. Select the category from the list where you want to move the grade items to.

===Other ways of moving grade items===
There is one way you can change the order of display. Let's say you have an assignment that is in the middle someplace, but you want it on the end of the category. Edit the assignment to '''uncategorized''' and come back to the Grader report screen. You will see that the assignment has departed from the category and is Uncategorized. Then edit the assignment again, returning it to its original category. Return to the Grader Report screen. Now the assignment should be on the end of the category.

If you have two or more assignments in the wrong place, repeat the process, finishing with the assignment you want to be on the extreme end.

==See also==
*[[Edit grade calculation]]
*[[Grade preferences]]
*[http://www.youtube.com/watch?v=EB58W3KePBc Video showing the basic gradebook setup and use]
*[http://www.youtube.com/watch?v=jWPUEqdhI4A Video showing how to change the display of grades in the gradebook]
*[http://www.youtube.com/watch?v=5hrLNbifiGQ Video explaining the different gradebook reports]

Using Moodle forum discussions:
*[http://moodle.org/mod/forum/discuss.php?d=87844 What happens in the 1.9 gradebook when students are unenrolled from a course]
*[http://moodle.org/mod/forum/discuss.php?d=125266 How to make the grader report narrower]

[[ca:grade/report/grader/index]]
[[cs:Celkový přehled]]
[[fr:Rapport de l'évaluateur]]
[[es:Informe_calificador]]

Gradebook uses

2009-02-05T19:35:53Z

Barrysspace: /* At a glance reporting */

Please add common gradebook uses below to help us in planning [[Development:Gradebook improvements|gradebook improvements]].

==Using different aggregation methods==

* [[Using 'Weighted mean of grades']]
* [[Using 'Sum of grades']] Case 1 - Brand new course, no existing assignments or categories, sum of points grading with a single category
* [[Using 'Sum of grades' with a grade calculation]] Case 2 - This case begins with a course containing assignments, but no categories. It will illustrate the creation of categories, putting assignments in categories, and setting up the grade calculation to produce the total number of points earned for the course. We will also take a look at setting up an uncategorized section to allow for assignments that should not be included in the final point total.

==The keep-it-simple-please teacher==

The keep-it-simple-please teacher just wants to look at the gradebook, but doesn't want to change anything (even by accident!). They'd like the total grade for the course to be calculated just the same as the default in Moodle 1.8.

The keep-it-simple-please teacher needs an easy way to look at an individual student's grades from the gradebook (like it was in 1.8 when you could click on a student's name) for parents' evenings.

'''Gradebook set-up'''

A view-only version of the gradebook can be created for the keep-it-simple-please teacher by not setting (or preventing) some/all of the following capabilities: [[Capabilities/moodle/grade:edit|Edit grades]], [[Capabilities/moodle/grade:hide|Hide/unhide grades or items]], [[Capabilities/moodle/grade:lock|Lock grades or items]], [[Capabilities/moodle/grade:manage|Manage grade items]], [[Capabilities/moodle/grade:manageletters|Manage letter grades]], [[Capabilities/moodle/grade:unlock|Unlock grades or items]]

Regarding an easy way to look at an individual student's grades from the gradebook, see MDL-12972.

==At a glance reporting==
For writing reports and quickly finding out who in the class needs attention to prevent them falling behind (or for gifted/talented enrichment), the gradebook needs to show information about pass/fail grades and deadline meeting without further clicks.

Setting grade to pass is a good way to make the passed items show up with a green background (once MDL-13830 is fixed), so this is a start, although it is not in any way clear that this functionality exists and the editing icon for the gradebook columns is not easy to spot as distinct from all of the others. It would help if grade to pass could be set from within modules as this would be the intuitive place to look for it (MDL-13831). There is an urgent need for a way to identify late work visually (MDL-12111) and also to show work which has been submitted (on time or otherwise), but is not yet marked (MDL-12513).

These changes would bring the gradebook in line with paper registers in terms of basic at a glance access to information, which is often encoded idiosyncratically with different marks or pen colours. There is probably some room for discussion of how much information can be carried by each cell, but with border colours currently unused and perhaps background images this must be possible (although there may need to be a separate image for every possible combination of CSS classes in order to preserve info on browsers that don't support transparency).
-- [[User:Matt Gibson|Matt Gibson]] 04:14, 27 January 2009 (CST)

[[Image:Gradebook_Grader_Mock1.png|200px|thumb|Mockup showing header toggles for cell attributes]]To build on what Matt said above I've created some mockups of improvements to the interface of the 1.9 grader report. The major feature that applies to this topic is the use of grade item attributes that can be checked on or off in the header of the report (much the same way "Show Hide/show icons" and "Show locks" are now done). I've taken the liberty to update the language to be more noun or verb focused based on attribute or action respectively.

The "action buttons" and "special rows" are very similar in behavior to current 1.9.x. The attributes are displayed as colored tags in each grade cell.

[[Image:Gradebook_Grader-mock1-attribute-tags.png|200px|thumb|Mockup showing how attributes would be organized in grade cells]]Some notes on the grade cell tags:
* The position of each tag within a grade cell is consistent no matter how many or which tags are displayed. This improves scanning speed and accuracy.
* Clicking on the tag icon in the legend at the top would (through the power of javascript) highlight all the grade cells that have that tag set within them (much like you can now highlight a row or column). This would make it trivially easy to quickly find the grades which are late or need to be marked, etc.
-- [[User:Paul Ortman|Paul Ortman]] 03:46, 29 January 2009 (EST)

[[Image:Quickeditfilter.jpg|400px|thumb|Mockup showing filters for item attributes on LSU Quick Edit Grades Report]]

[[Image:Graderfilters.jpg|750px|thumb|Mockup showing filters for item attributes on grader report]]

'''Filters for At a glance reporting and editing'''

Grade item attributes could also be used to apply a filter to:
* one or more Columns in the grader report
* a Quick Edit page (LSU)

This would be very helpful when a teacher wants to:
* View/Edit only grades which meet a certain criteria
* Drill down into the detail
[[User:Barry Oosthuizen|Barry Oosthuizen]] 12:42, 5 February 2009 (CST)

==Category or site aggregation==
For a one year teaching programme, I am currently using 6 courses and manage enrolments with a metacourse. David's excellent [http://moodle.org/mod/data/view.php?d=13&rid=1775&filter=1 subcourse] module lets this happen, but it's non-standard and should really appear as part of a metacourse by default. It could also do with a cron component so that it doesn't have to be manually fetched all the time. If it were possible to have a similar module that would pick an arbitrary grade or aggragate from another course, instead of the total, that would make this very powerful.
-- [[User:Matt Gibson|Matt Gibson]] 04:14, 27 January 2009 (CST)

==Target tracking==
Use the gradebook primarily to track a pupil's progress in terms of meeting the targets that they were previously set. This is already possible to a certain extent using the hover-over tooltips for feedback, but not all modules (e.g. quiz MDL-13902) can do this. Having a separate comment field in each grading screen to specify a clear target as distict from general comments would be ideal, along with a checkbox to say if the previous one has been achieved, but is a bit outside the gradebook scope.
-- [[User:Matt Gibson|Matt Gibson]] 04:14, 27 January 2009 (CST)

==Participation tracking==
For my courses, I often set a participation target e.g. 'post twice in this forum and reply twice', but this is impossible to grade automatically, even though it's just a matter of checking the logs on a cron run. A new module to do this (whilst again, slightly outside the scope of the gradebook) would make the gradebook that much more useful for one-stop whole course monitoring.
-- [[User:Matt Gibson|Matt Gibson]] 04:14, 27 January 2009 (CST)

: The Activity completion part of [[Conditional activities]] already does this in Moodle 2.0.--[[User:Tim Hunt|Tim Hunt]] 20:37, 27 January 2009 (CST)

==Using the gradebook at a fraction of its potential==
Maybe the most common use-case :) Moodle's general aversion to direct on-screen guidance, rather than pop-up help, or semi-obscure (bottom of page, not labelled as 'help' MDL-18047) guidance in moodledocs could easily lead most users to miss features that they could make amazing use of. Tooltips for absolutely everything (MDL-13960) and small amounts of on-screen help (MDL-18046) would also be very useful in letting people know what's possible. As an example - how can one check the history of a grade that's been changed? I still can't work out how to do this and I would consider myself a power user. Can it be done? If so, some documentation or on screen help is needed.
-- [[User:Matt Gibson|Matt Gibson]] 04:14, 27 January 2009 (CST)

==Hassling students who are not pulling their weight (Deadline/lateness tracking)==
I'd ideally like to be able to look at the gradebook, see that X students are constantly missing deadlines (MDL-12111) and be able to message them there and then using simple check boxes (MDL-12203). Even better would be the option to have an automatic mailmerge done using the address field of the user profiles and some standard letter template so that I could download pre-written letters to these student or their parents/guardians pointing out to them what they have not done, and the dire consequences they can expect if they keep slacking.
-- [[User:Matt Gibson|Matt Gibson]] 04:14, 27 January 2009 (CST)

==Extra Credit==
At our institution we see that every grade item (at least those that are numeric) needs an extra credit field. The contents of the field determine how extra credit is applied to that item, category, or course category. If the contents are a whole or real number ('5', '24', '1.5'), the extra credit field is added to the numerator prior to normalization of the grade. If the contents of the extra credit field is a percentage ('5%') then that value is added to the normalized value of the item. Likewise, extra credit could be added to categories or the course category, but in this case only percentages could be added (unless sum of grades is used in the category). There would need to be a visual cue to both the teacher and student that a given grade item has had extra credit adjustments made to it. Finally, I could see use cases where lists of extra credit would need to be added to grade items (so more than one piece of extra credit could be added to a category per person.

[[Category:Grades]]

Gradebook uses

2009-02-05T19:31:40Z

Barrysspace: /* At a glance reporting */

Please add common gradebook uses below to help us in planning [[Development:Gradebook improvements|gradebook improvements]].

==Using different aggregation methods==

* [[Using 'Weighted mean of grades']]
* [[Using 'Sum of grades']] Case 1 - Brand new course, no existing assignments or categories, sum of points grading with a single category
* [[Using 'Sum of grades' with a grade calculation]] Case 2 - This case begins with a course containing assignments, but no categories. It will illustrate the creation of categories, putting assignments in categories, and setting up the grade calculation to produce the total number of points earned for the course. We will also take a look at setting up an uncategorized section to allow for assignments that should not be included in the final point total.

==The keep-it-simple-please teacher==

The keep-it-simple-please teacher just wants to look at the gradebook, but doesn't want to change anything (even by accident!). They'd like the total grade for the course to be calculated just the same as the default in Moodle 1.8.

The keep-it-simple-please teacher needs an easy way to look at an individual student's grades from the gradebook (like it was in 1.8 when you could click on a student's name) for parents' evenings.

'''Gradebook set-up'''

A view-only version of the gradebook can be created for the keep-it-simple-please teacher by not setting (or preventing) some/all of the following capabilities: [[Capabilities/moodle/grade:edit|Edit grades]], [[Capabilities/moodle/grade:hide|Hide/unhide grades or items]], [[Capabilities/moodle/grade:lock|Lock grades or items]], [[Capabilities/moodle/grade:manage|Manage grade items]], [[Capabilities/moodle/grade:manageletters|Manage letter grades]], [[Capabilities/moodle/grade:unlock|Unlock grades or items]]

Regarding an easy way to look at an individual student's grades from the gradebook, see MDL-12972.

==At a glance reporting==
For writing reports and quickly finding out who in the class needs attention to prevent them falling behind (or for gifted/talented enrichment), the gradebook needs to show information about pass/fail grades and deadline meeting without further clicks.

Setting grade to pass is a good way to make the passed items show up with a green background (once MDL-13830 is fixed), so this is a start, although it is not in any way clear that this functionality exists and the editing icon for the gradebook columns is not easy to spot as distinct from all of the others. It would help if grade to pass could be set from within modules as this would be the intuitive place to look for it (MDL-13831). There is an urgent need for a way to identify late work visually (MDL-12111) and also to show work which has been submitted (on time or otherwise), but is not yet marked (MDL-12513).

These changes would bring the gradebook in line with paper registers in terms of basic at a glance access to information, which is often encoded idiosyncratically with different marks or pen colours. There is probably some room for discussion of how much information can be carried by each cell, but with border colours currently unused and perhaps background images this must be possible (although there may need to be a separate image for every possible combination of CSS classes in order to preserve info on browsers that don't support transparency).
-- [[User:Matt Gibson|Matt Gibson]] 04:14, 27 January 2009 (CST)

[[Image:Gradebook_Grader_Mock1.png|200px|thumb|Mockup showing header toggles for cell attributes]]To build on what Matt said above I've created some mockups of improvements to the interface of the 1.9 grader report. The major feature that applies to this topic is the use of grade item attributes that can be checked on or off in the header of the report (much the same way "Show Hide/show icons" and "Show locks" are now done). I've taken the liberty to update the language to be more noun or verb focused based on attribute or action respectively.

The "action buttons" and "special rows" are very similar in behavior to current 1.9.x. The attributes are displayed as colored tags in each grade cell.

[[Image:Gradebook_Grader-mock1-attribute-tags.png|200px|thumb|Mockup showing how attributes would be organized in grade cells]]Some notes on the grade cell tags:
* The position of each tag within a grade cell is consistent no matter how many or which tags are displayed. This improves scanning speed and accuracy.
* Clicking on the tag icon in the legend at the top would (through the power of javascript) highlight all the grade cells that have that tag set within them (much like you can now highlight a row or column). This would make it trivially easy to quickly find the grades which are late or need to be marked, etc.
-- [[User:Paul Ortman|Paul Ortman]] 03:46, 29 January 2009 (EST)

[[Image:Quickeditfilter.jpg|200px|thumb|Mockup showing filters for item attributes on LSU Quick Edit Grades Report]]

[[Image:Graderfilters.jpg|750px|thumb|Mockup showing filters for item attributes on grader report]]

'''Filters for At a glance reporting and editing'''

Grade item attributes could also be used to apply a filter to:
* one or more Columns in the grader report
* a Quick Edit page (LSU)

This would be very helpful when a teacher wants to:
* View/Edit only grades which meet a certain criteria
* Drill down into the detail
[[User:Barry Oosthuizen|Barry Oosthuizen]] 12:42, 5 February 2009 (CST)

==Category or site aggregation==
For a one year teaching programme, I am currently using 6 courses and manage enrolments with a metacourse. David's excellent [http://moodle.org/mod/data/view.php?d=13&rid=1775&filter=1 subcourse] module lets this happen, but it's non-standard and should really appear as part of a metacourse by default. It could also do with a cron component so that it doesn't have to be manually fetched all the time. If it were possible to have a similar module that would pick an arbitrary grade or aggragate from another course, instead of the total, that would make this very powerful.
-- [[User:Matt Gibson|Matt Gibson]] 04:14, 27 January 2009 (CST)

==Target tracking==
Use the gradebook primarily to track a pupil's progress in terms of meeting the targets that they were previously set. This is already possible to a certain extent using the hover-over tooltips for feedback, but not all modules (e.g. quiz MDL-13902) can do this. Having a separate comment field in each grading screen to specify a clear target as distict from general comments would be ideal, along with a checkbox to say if the previous one has been achieved, but is a bit outside the gradebook scope.
-- [[User:Matt Gibson|Matt Gibson]] 04:14, 27 January 2009 (CST)

==Participation tracking==
For my courses, I often set a participation target e.g. 'post twice in this forum and reply twice', but this is impossible to grade automatically, even though it's just a matter of checking the logs on a cron run. A new module to do this (whilst again, slightly outside the scope of the gradebook) would make the gradebook that much more useful for one-stop whole course monitoring.
-- [[User:Matt Gibson|Matt Gibson]] 04:14, 27 January 2009 (CST)

: The Activity completion part of [[Conditional activities]] already does this in Moodle 2.0.--[[User:Tim Hunt|Tim Hunt]] 20:37, 27 January 2009 (CST)

==Using the gradebook at a fraction of its potential==
Maybe the most common use-case :) Moodle's general aversion to direct on-screen guidance, rather than pop-up help, or semi-obscure (bottom of page, not labelled as 'help' MDL-18047) guidance in moodledocs could easily lead most users to miss features that they could make amazing use of. Tooltips for absolutely everything (MDL-13960) and small amounts of on-screen help (MDL-18046) would also be very useful in letting people know what's possible. As an example - how can one check the history of a grade that's been changed? I still can't work out how to do this and I would consider myself a power user. Can it be done? If so, some documentation or on screen help is needed.
-- [[User:Matt Gibson|Matt Gibson]] 04:14, 27 January 2009 (CST)

==Hassling students who are not pulling their weight (Deadline/lateness tracking)==
I'd ideally like to be able to look at the gradebook, see that X students are constantly missing deadlines (MDL-12111) and be able to message them there and then using simple check boxes (MDL-12203). Even better would be the option to have an automatic mailmerge done using the address field of the user profiles and some standard letter template so that I could download pre-written letters to these student or their parents/guardians pointing out to them what they have not done, and the dire consequences they can expect if they keep slacking.
-- [[User:Matt Gibson|Matt Gibson]] 04:14, 27 January 2009 (CST)

==Extra Credit==
At our institution we see that every grade item (at least those that are numeric) needs an extra credit field. The contents of the field determine how extra credit is applied to that item, category, or course category. If the contents are a whole or real number ('5', '24', '1.5'), the extra credit field is added to the numerator prior to normalization of the grade. If the contents of the extra credit field is a percentage ('5%') then that value is added to the normalized value of the item. Likewise, extra credit could be added to categories or the course category, but in this case only percentages could be added (unless sum of grades is used in the category). There would need to be a visual cue to both the teacher and student that a given grade item has had extra credit adjustments made to it. Finally, I could see use cases where lists of extra credit would need to be added to grade items (so more than one piece of extra credit could be added to a category per person.

[[Category:Grades]]

Gradebook uses

2009-02-05T19:27:41Z

Barrysspace: /* At a glance reporting */

Please add common gradebook uses below to help us in planning [[Development:Gradebook improvements|gradebook improvements]].

==Using different aggregation methods==

* [[Using 'Weighted mean of grades']]
* [[Using 'Sum of grades']] Case 1 - Brand new course, no existing assignments or categories, sum of points grading with a single category
* [[Using 'Sum of grades' with a grade calculation]] Case 2 - This case begins with a course containing assignments, but no categories. It will illustrate the creation of categories, putting assignments in categories, and setting up the grade calculation to produce the total number of points earned for the course. We will also take a look at setting up an uncategorized section to allow for assignments that should not be included in the final point total.

==The keep-it-simple-please teacher==

The keep-it-simple-please teacher just wants to look at the gradebook, but doesn't want to change anything (even by accident!). They'd like the total grade for the course to be calculated just the same as the default in Moodle 1.8.

The keep-it-simple-please teacher needs an easy way to look at an individual student's grades from the gradebook (like it was in 1.8 when you could click on a student's name) for parents' evenings.

'''Gradebook set-up'''

A view-only version of the gradebook can be created for the keep-it-simple-please teacher by not setting (or preventing) some/all of the following capabilities: [[Capabilities/moodle/grade:edit|Edit grades]], [[Capabilities/moodle/grade:hide|Hide/unhide grades or items]], [[Capabilities/moodle/grade:lock|Lock grades or items]], [[Capabilities/moodle/grade:manage|Manage grade items]], [[Capabilities/moodle/grade:manageletters|Manage letter grades]], [[Capabilities/moodle/grade:unlock|Unlock grades or items]]

Regarding an easy way to look at an individual student's grades from the gradebook, see MDL-12972.

==At a glance reporting==
For writing reports and quickly finding out who in the class needs attention to prevent them falling behind (or for gifted/talented enrichment), the gradebook needs to show information about pass/fail grades and deadline meeting without further clicks.

Setting grade to pass is a good way to make the passed items show up with a green background (once MDL-13830 is fixed), so this is a start, although it is not in any way clear that this functionality exists and the editing icon for the gradebook columns is not easy to spot as distinct from all of the others. It would help if grade to pass could be set from within modules as this would be the intuitive place to look for it (MDL-13831). There is an urgent need for a way to identify late work visually (MDL-12111) and also to show work which has been submitted (on time or otherwise), but is not yet marked (MDL-12513).

These changes would bring the gradebook in line with paper registers in terms of basic at a glance access to information, which is often encoded idiosyncratically with different marks or pen colours. There is probably some room for discussion of how much information can be carried by each cell, but with border colours currently unused and perhaps background images this must be possible (although there may need to be a separate image for every possible combination of CSS classes in order to preserve info on browsers that don't support transparency).
-- [[User:Matt Gibson|Matt Gibson]] 04:14, 27 January 2009 (CST)

[[Image:Gradebook_Grader_Mock1.png|200px|thumb|Mockup showing header toggles for cell attributes]]To build on what Matt said above I've created some mockups of improvements to the interface of the 1.9 grader report. The major feature that applies to this topic is the use of grade item attributes that can be checked on or off in the header of the report (much the same way "Show Hide/show icons" and "Show locks" are now done). I've taken the liberty to update the language to be more noun or verb focused based on attribute or action respectively.

The "action buttons" and "special rows" are very similar in behavior to current 1.9.x. The attributes are displayed as colored tags in each grade cell.

[[Image:Gradebook_Grader-mock1-attribute-tags.png|200px|thumb|Mockup showing how attributes would be organized in grade cells]]Some notes on the grade cell tags:
* The position of each tag within a grade cell is consistent no matter how many or which tags are displayed. This improves scanning speed and accuracy.
* Clicking on the tag icon in the legend at the top would (through the power of javascript) highlight all the grade cells that have that tag set within them (much like you can now highlight a row or column). This would make it trivially easy to quickly find the grades which are late or need to be marked, etc.
-- [[User:Paul Ortman|Paul Ortman]] 03:46, 29 January 2009 (EST)

[[Image:Graderfilters.jpg|200px|thumb|Mockup showing filters for item attributes on grader report]]

[[Image:Quickeditfilter.jpg|200px|thumb|Mockup showing filters for item attributes on LSU Quick Edit Grades Report]]

'''Filters for At a glance reporting and editing'''

Grade item attributes could also be used to apply a filter to:
* one or more Columns in the grader report
* a Quick Edit page (LSU)

This would be very helpful when a teacher wants to:
* View/Edit only grades which meet a certain criteria
* Drill down into the detail

[[User:Barry Oosthuizen|Barry Oosthuizen]] 12:42, 5 February 2009 (CST)

==Category or site aggregation==
For a one year teaching programme, I am currently using 6 courses and manage enrolments with a metacourse. David's excellent [http://moodle.org/mod/data/view.php?d=13&rid=1775&filter=1 subcourse] module lets this happen, but it's non-standard and should really appear as part of a metacourse by default. It could also do with a cron component so that it doesn't have to be manually fetched all the time. If it were possible to have a similar module that would pick an arbitrary grade or aggragate from another course, instead of the total, that would make this very powerful.
-- [[User:Matt Gibson|Matt Gibson]] 04:14, 27 January 2009 (CST)

==Target tracking==
Use the gradebook primarily to track a pupil's progress in terms of meeting the targets that they were previously set. This is already possible to a certain extent using the hover-over tooltips for feedback, but not all modules (e.g. quiz MDL-13902) can do this. Having a separate comment field in each grading screen to specify a clear target as distict from general comments would be ideal, along with a checkbox to say if the previous one has been achieved, but is a bit outside the gradebook scope.
-- [[User:Matt Gibson|Matt Gibson]] 04:14, 27 January 2009 (CST)

==Participation tracking==
For my courses, I often set a participation target e.g. 'post twice in this forum and reply twice', but this is impossible to grade automatically, even though it's just a matter of checking the logs on a cron run. A new module to do this (whilst again, slightly outside the scope of the gradebook) would make the gradebook that much more useful for one-stop whole course monitoring.
-- [[User:Matt Gibson|Matt Gibson]] 04:14, 27 January 2009 (CST)

: The Activity completion part of [[Conditional activities]] already does this in Moodle 2.0.--[[User:Tim Hunt|Tim Hunt]] 20:37, 27 January 2009 (CST)

==Using the gradebook at a fraction of its potential==
Maybe the most common use-case :) Moodle's general aversion to direct on-screen guidance, rather than pop-up help, or semi-obscure (bottom of page, not labelled as 'help' MDL-18047) guidance in moodledocs could easily lead most users to miss features that they could make amazing use of. Tooltips for absolutely everything (MDL-13960) and small amounts of on-screen help (MDL-18046) would also be very useful in letting people know what's possible. As an example - how can one check the history of a grade that's been changed? I still can't work out how to do this and I would consider myself a power user. Can it be done? If so, some documentation or on screen help is needed.
-- [[User:Matt Gibson|Matt Gibson]] 04:14, 27 January 2009 (CST)

==Hassling students who are not pulling their weight (Deadline/lateness tracking)==
I'd ideally like to be able to look at the gradebook, see that X students are constantly missing deadlines (MDL-12111) and be able to message them there and then using simple check boxes (MDL-12203). Even better would be the option to have an automatic mailmerge done using the address field of the user profiles and some standard letter template so that I could download pre-written letters to these student or their parents/guardians pointing out to them what they have not done, and the dire consequences they can expect if they keep slacking.
-- [[User:Matt Gibson|Matt Gibson]] 04:14, 27 January 2009 (CST)

==Extra Credit==
At our institution we see that every grade item (at least those that are numeric) needs an extra credit field. The contents of the field determine how extra credit is applied to that item, category, or course category. If the contents are a whole or real number ('5', '24', '1.5'), the extra credit field is added to the numerator prior to normalization of the grade. If the contents of the extra credit field is a percentage ('5%') then that value is added to the normalized value of the item. Likewise, extra credit could be added to categories or the course category, but in this case only percentages could be added (unless sum of grades is used in the category). There would need to be a visual cue to both the teacher and student that a given grade item has had extra credit adjustments made to it. Finally, I could see use cases where lists of extra credit would need to be added to grade items (so more than one piece of extra credit could be added to a category per person.

[[Category:Grades]]

Gradebook uses

2009-02-05T19:19:31Z

Barrysspace: /* At a glance reporting */

Please add common gradebook uses below to help us in planning [[Development:Gradebook improvements|gradebook improvements]].

==Using different aggregation methods==

* [[Using 'Weighted mean of grades']]
* [[Using 'Sum of grades']] Case 1 - Brand new course, no existing assignments or categories, sum of points grading with a single category
* [[Using 'Sum of grades' with a grade calculation]] Case 2 - This case begins with a course containing assignments, but no categories. It will illustrate the creation of categories, putting assignments in categories, and setting up the grade calculation to produce the total number of points earned for the course. We will also take a look at setting up an uncategorized section to allow for assignments that should not be included in the final point total.

==The keep-it-simple-please teacher==

The keep-it-simple-please teacher just wants to look at the gradebook, but doesn't want to change anything (even by accident!). They'd like the total grade for the course to be calculated just the same as the default in Moodle 1.8.

The keep-it-simple-please teacher needs an easy way to look at an individual student's grades from the gradebook (like it was in 1.8 when you could click on a student's name) for parents' evenings.

'''Gradebook set-up'''

A view-only version of the gradebook can be created for the keep-it-simple-please teacher by not setting (or preventing) some/all of the following capabilities: [[Capabilities/moodle/grade:edit|Edit grades]], [[Capabilities/moodle/grade:hide|Hide/unhide grades or items]], [[Capabilities/moodle/grade:lock|Lock grades or items]], [[Capabilities/moodle/grade:manage|Manage grade items]], [[Capabilities/moodle/grade:manageletters|Manage letter grades]], [[Capabilities/moodle/grade:unlock|Unlock grades or items]]

Regarding an easy way to look at an individual student's grades from the gradebook, see MDL-12972.

==At a glance reporting==
For writing reports and quickly finding out who in the class needs attention to prevent them falling behind (or for gifted/talented enrichment), the gradebook needs to show information about pass/fail grades and deadline meeting without further clicks.

Setting grade to pass is a good way to make the passed items show up with a green background (once MDL-13830 is fixed), so this is a start, although it is not in any way clear that this functionality exists and the editing icon for the gradebook columns is not easy to spot as distinct from all of the others. It would help if grade to pass could be set from within modules as this would be the intuitive place to look for it (MDL-13831). There is an urgent need for a way to identify late work visually (MDL-12111) and also to show work which has been submitted (on time or otherwise), but is not yet marked (MDL-12513).

These changes would bring the gradebook in line with paper registers in terms of basic at a glance access to information, which is often encoded idiosyncratically with different marks or pen colours. There is probably some room for discussion of how much information can be carried by each cell, but with border colours currently unused and perhaps background images this must be possible (although there may need to be a separate image for every possible combination of CSS classes in order to preserve info on browsers that don't support transparency).
-- [[User:Matt Gibson|Matt Gibson]] 04:14, 27 January 2009 (CST)

[[Image:Gradebook_Grader_Mock1.png|200px|thumb|Mockup showing header toggles for cell attributes]]To build on what Matt said above I've created some mockups of improvements to the interface of the 1.9 grader report. The major feature that applies to this topic is the use of grade item attributes that can be checked on or off in the header of the report (much the same way "Show Hide/show icons" and "Show locks" are now done). I've taken the liberty to update the language to be more noun or verb focused based on attribute or action respectively.

The "action buttons" and "special rows" are very similar in behavior to current 1.9.x. The attributes are displayed as colored tags in each grade cell.

[[Image:Gradebook_Grader-mock1-attribute-tags.png|200px|thumb|Mockup showing how attributes would be organized in grade cells]]Some notes on the grade cell tags:
* The position of each tag within a grade cell is consistent no matter how many or which tags are displayed. This improves scanning speed and accuracy.
* Clicking on the tag icon in the legend at the top would (through the power of javascript) highlight all the grade cells that have that tag set within them (much like you can now highlight a row or column). This would make it trivially easy to quickly find the grades which are late or need to be marked, etc.
-- [[User:Paul Ortman|Paul Ortman]] 03:46, 29 January 2009 (EST)

[[Image:Graderfilters.jpg|200px|thumb|Mockup showing filters for item attributes on grader report]]

[[Image:Quickeditfilter.jpg|200px|thumb|Mockup showing filters for item attributes on LSU Quick Edit Grades Report]]

'''Filters for At a glance editing'''

Grade item attributes could also be used to apply a filter to:
* one or more Columns in the grader report
* a Quick Edit page (LSU)

[[User:Barry Oosthuizen|Barry Oosthuizen]] 12:42, 5 February 2009 (CST)

==Category or site aggregation==
For a one year teaching programme, I am currently using 6 courses and manage enrolments with a metacourse. David's excellent [http://moodle.org/mod/data/view.php?d=13&rid=1775&filter=1 subcourse] module lets this happen, but it's non-standard and should really appear as part of a metacourse by default. It could also do with a cron component so that it doesn't have to be manually fetched all the time. If it were possible to have a similar module that would pick an arbitrary grade or aggragate from another course, instead of the total, that would make this very powerful.
-- [[User:Matt Gibson|Matt Gibson]] 04:14, 27 January 2009 (CST)

==Target tracking==
Use the gradebook primarily to track a pupil's progress in terms of meeting the targets that they were previously set. This is already possible to a certain extent using the hover-over tooltips for feedback, but not all modules (e.g. quiz MDL-13902) can do this. Having a separate comment field in each grading screen to specify a clear target as distict from general comments would be ideal, along with a checkbox to say if the previous one has been achieved, but is a bit outside the gradebook scope.
-- [[User:Matt Gibson|Matt Gibson]] 04:14, 27 January 2009 (CST)

==Participation tracking==
For my courses, I often set a participation target e.g. 'post twice in this forum and reply twice', but this is impossible to grade automatically, even though it's just a matter of checking the logs on a cron run. A new module to do this (whilst again, slightly outside the scope of the gradebook) would make the gradebook that much more useful for one-stop whole course monitoring.
-- [[User:Matt Gibson|Matt Gibson]] 04:14, 27 January 2009 (CST)

: The Activity completion part of [[Conditional activities]] already does this in Moodle 2.0.--[[User:Tim Hunt|Tim Hunt]] 20:37, 27 January 2009 (CST)

==Using the gradebook at a fraction of its potential==
Maybe the most common use-case :) Moodle's general aversion to direct on-screen guidance, rather than pop-up help, or semi-obscure (bottom of page, not labelled as 'help' MDL-18047) guidance in moodledocs could easily lead most users to miss features that they could make amazing use of. Tooltips for absolutely everything (MDL-13960) and small amounts of on-screen help (MDL-18046) would also be very useful in letting people know what's possible. As an example - how can one check the history of a grade that's been changed? I still can't work out how to do this and I would consider myself a power user. Can it be done? If so, some documentation or on screen help is needed.
-- [[User:Matt Gibson|Matt Gibson]] 04:14, 27 January 2009 (CST)

==Hassling students who are not pulling their weight (Deadline/lateness tracking)==
I'd ideally like to be able to look at the gradebook, see that X students are constantly missing deadlines (MDL-12111) and be able to message them there and then using simple check boxes (MDL-12203). Even better would be the option to have an automatic mailmerge done using the address field of the user profiles and some standard letter template so that I could download pre-written letters to these student or their parents/guardians pointing out to them what they have not done, and the dire consequences they can expect if they keep slacking.
-- [[User:Matt Gibson|Matt Gibson]] 04:14, 27 January 2009 (CST)

==Extra Credit==
At our institution we see that every grade item (at least those that are numeric) needs an extra credit field. The contents of the field determine how extra credit is applied to that item, category, or course category. If the contents are a whole or real number ('5', '24', '1.5'), the extra credit field is added to the numerator prior to normalization of the grade. If the contents of the extra credit field is a percentage ('5%') then that value is added to the normalized value of the item. Likewise, extra credit could be added to categories or the course category, but in this case only percentages could be added (unless sum of grades is used in the category). There would need to be a visual cue to both the teacher and student that a given grade item has had extra credit adjustments made to it. Finally, I could see use cases where lists of extra credit would need to be added to grade items (so more than one piece of extra credit could be added to a category per person.

[[Category:Grades]]

Gradebook uses

2009-02-05T19:18:04Z

Barrysspace: /* At a glance reporting */

Please add common gradebook uses below to help us in planning [[Development:Gradebook improvements|gradebook improvements]].

==Using different aggregation methods==

* [[Using 'Weighted mean of grades']]
* [[Using 'Sum of grades']] Case 1 - Brand new course, no existing assignments or categories, sum of points grading with a single category
* [[Using 'Sum of grades' with a grade calculation]] Case 2 - This case begins with a course containing assignments, but no categories. It will illustrate the creation of categories, putting assignments in categories, and setting up the grade calculation to produce the total number of points earned for the course. We will also take a look at setting up an uncategorized section to allow for assignments that should not be included in the final point total.

==The keep-it-simple-please teacher==

The keep-it-simple-please teacher just wants to look at the gradebook, but doesn't want to change anything (even by accident!). They'd like the total grade for the course to be calculated just the same as the default in Moodle 1.8.

The keep-it-simple-please teacher needs an easy way to look at an individual student's grades from the gradebook (like it was in 1.8 when you could click on a student's name) for parents' evenings.

'''Gradebook set-up'''

A view-only version of the gradebook can be created for the keep-it-simple-please teacher by not setting (or preventing) some/all of the following capabilities: [[Capabilities/moodle/grade:edit|Edit grades]], [[Capabilities/moodle/grade:hide|Hide/unhide grades or items]], [[Capabilities/moodle/grade:lock|Lock grades or items]], [[Capabilities/moodle/grade:manage|Manage grade items]], [[Capabilities/moodle/grade:manageletters|Manage letter grades]], [[Capabilities/moodle/grade:unlock|Unlock grades or items]]

Regarding an easy way to look at an individual student's grades from the gradebook, see MDL-12972.

==At a glance reporting==
For writing reports and quickly finding out who in the class needs attention to prevent them falling behind (or for gifted/talented enrichment), the gradebook needs to show information about pass/fail grades and deadline meeting without further clicks.

Setting grade to pass is a good way to make the passed items show up with a green background (once MDL-13830 is fixed), so this is a start, although it is not in any way clear that this functionality exists and the editing icon for the gradebook columns is not easy to spot as distinct from all of the others. It would help if grade to pass could be set from within modules as this would be the intuitive place to look for it (MDL-13831). There is an urgent need for a way to identify late work visually (MDL-12111) and also to show work which has been submitted (on time or otherwise), but is not yet marked (MDL-12513).

These changes would bring the gradebook in line with paper registers in terms of basic at a glance access to information, which is often encoded idiosyncratically with different marks or pen colours. There is probably some room for discussion of how much information can be carried by each cell, but with border colours currently unused and perhaps background images this must be possible (although there may need to be a separate image for every possible combination of CSS classes in order to preserve info on browsers that don't support transparency).
-- [[User:Matt Gibson|Matt Gibson]] 04:14, 27 January 2009 (CST)

[[Image:Gradebook_Grader_Mock1.png|200px|thumb|Mockup showing header toggles for cell attributes]]To build on what Matt said above I've created some mockups of improvements to the interface of the 1.9 grader report. The major feature that applies to this topic is the use of grade item attributes that can be checked on or off in the header of the report (much the same way "Show Hide/show icons" and "Show locks" are now done). I've taken the liberty to update the language to be more noun or verb focused based on attribute or action respectively.

The "action buttons" and "special rows" are very similar in behavior to current 1.9.x. The attributes are displayed as colored tags in each grade cell.

[[Image:Gradebook_Grader-mock1-attribute-tags.png|200px|thumb|Mockup showing how attributes would be organized in grade cells]]Some notes on the grade cell tags:
* The position of each tag within a grade cell is consistent no matter how many or which tags are displayed. This improves scanning speed and accuracy.
* Clicking on the tag icon in the legend at the top would (through the power of javascript) highlight all the grade cells that have that tag set within them (much like you can now highlight a row or column). This would make it trivially easy to quickly find the grades which are late or need to be marked, etc.
-- [[User:Paul Ortman|Paul Ortman]] 03:46, 29 January 2009 (EST)

'''Filters for At a glance editing'''

Grade item attributes could also be used to apply a filter to:
* one or more Columns in the grader report
* a Quick Edit page (LSU)

[[Image:Graderfilters.jpg|600px|thumb|Mockup showing filters for item attributes on grader report]]

[[Image:Quickeditfilter.jpg|600px|thumb|Mockup showing filters for item attributes on LSU Quick Edit Grades Report]]
[[User:Barry Oosthuizen|Barry Oosthuizen]] 12:42, 5 February 2009 (CST)

==Category or site aggregation==
For a one year teaching programme, I am currently using 6 courses and manage enrolments with a metacourse. David's excellent [http://moodle.org/mod/data/view.php?d=13&rid=1775&filter=1 subcourse] module lets this happen, but it's non-standard and should really appear as part of a metacourse by default. It could also do with a cron component so that it doesn't have to be manually fetched all the time. If it were possible to have a similar module that would pick an arbitrary grade or aggragate from another course, instead of the total, that would make this very powerful.
-- [[User:Matt Gibson|Matt Gibson]] 04:14, 27 January 2009 (CST)

==Target tracking==
Use the gradebook primarily to track a pupil's progress in terms of meeting the targets that they were previously set. This is already possible to a certain extent using the hover-over tooltips for feedback, but not all modules (e.g. quiz MDL-13902) can do this. Having a separate comment field in each grading screen to specify a clear target as distict from general comments would be ideal, along with a checkbox to say if the previous one has been achieved, but is a bit outside the gradebook scope.
-- [[User:Matt Gibson|Matt Gibson]] 04:14, 27 January 2009 (CST)

==Participation tracking==
For my courses, I often set a participation target e.g. 'post twice in this forum and reply twice', but this is impossible to grade automatically, even though it's just a matter of checking the logs on a cron run. A new module to do this (whilst again, slightly outside the scope of the gradebook) would make the gradebook that much more useful for one-stop whole course monitoring.
-- [[User:Matt Gibson|Matt Gibson]] 04:14, 27 January 2009 (CST)

: The Activity completion part of [[Conditional activities]] already does this in Moodle 2.0.--[[User:Tim Hunt|Tim Hunt]] 20:37, 27 January 2009 (CST)

==Using the gradebook at a fraction of its potential==
Maybe the most common use-case :) Moodle's general aversion to direct on-screen guidance, rather than pop-up help, or semi-obscure (bottom of page, not labelled as 'help' MDL-18047) guidance in moodledocs could easily lead most users to miss features that they could make amazing use of. Tooltips for absolutely everything (MDL-13960) and small amounts of on-screen help (MDL-18046) would also be very useful in letting people know what's possible. As an example - how can one check the history of a grade that's been changed? I still can't work out how to do this and I would consider myself a power user. Can it be done? If so, some documentation or on screen help is needed.
-- [[User:Matt Gibson|Matt Gibson]] 04:14, 27 January 2009 (CST)

==Hassling students who are not pulling their weight (Deadline/lateness tracking)==
I'd ideally like to be able to look at the gradebook, see that X students are constantly missing deadlines (MDL-12111) and be able to message them there and then using simple check boxes (MDL-12203). Even better would be the option to have an automatic mailmerge done using the address field of the user profiles and some standard letter template so that I could download pre-written letters to these student or their parents/guardians pointing out to them what they have not done, and the dire consequences they can expect if they keep slacking.
-- [[User:Matt Gibson|Matt Gibson]] 04:14, 27 January 2009 (CST)

==Extra Credit==
At our institution we see that every grade item (at least those that are numeric) needs an extra credit field. The contents of the field determine how extra credit is applied to that item, category, or course category. If the contents are a whole or real number ('5', '24', '1.5'), the extra credit field is added to the numerator prior to normalization of the grade. If the contents of the extra credit field is a percentage ('5%') then that value is added to the normalized value of the item. Likewise, extra credit could be added to categories or the course category, but in this case only percentages could be added (unless sum of grades is used in the category). There would need to be a visual cue to both the teacher and student that a given grade item has had extra credit adjustments made to it. Finally, I could see use cases where lists of extra credit would need to be added to grade items (so more than one piece of extra credit could be added to a category per person.

[[Category:Grades]]

File:Quickeditfilter.jpg

2009-02-05T19:04:40Z

Barrysspace:

File:Graderfilters.jpg

2009-02-05T19:03:38Z

Barrysspace:

Gradebook uses

2009-02-05T18:42:45Z

Barrysspace: /* At a glance reporting */

Please add common gradebook uses below to help us in planning [[Development:Gradebook improvements|gradebook improvements]].

==Using different aggregation methods==

* [[Using 'Weighted mean of grades']]
* [[Using 'Sum of grades']] Case 1 - Brand new course, no existing assignments or categories, sum of points grading with a single category
* [[Using 'Sum of grades' with a grade calculation]] Case 2 - This case begins with a course containing assignments, but no categories. It will illustrate the creation of categories, putting assignments in categories, and setting up the grade calculation to produce the total number of points earned for the course. We will also take a look at setting up an uncategorized section to allow for assignments that should not be included in the final point total.

==The keep-it-simple-please teacher==

The keep-it-simple-please teacher just wants to look at the gradebook, but doesn't want to change anything (even by accident!). They'd like the total grade for the course to be calculated just the same as the default in Moodle 1.8.

The keep-it-simple-please teacher needs an easy way to look at an individual student's grades from the gradebook (like it was in 1.8 when you could click on a student's name) for parents' evenings.

'''Gradebook set-up'''

A view-only version of the gradebook can be created for the keep-it-simple-please teacher by not setting (or preventing) some/all of the following capabilities: [[Capabilities/moodle/grade:edit|Edit grades]], [[Capabilities/moodle/grade:hide|Hide/unhide grades or items]], [[Capabilities/moodle/grade:lock|Lock grades or items]], [[Capabilities/moodle/grade:manage|Manage grade items]], [[Capabilities/moodle/grade:manageletters|Manage letter grades]], [[Capabilities/moodle/grade:unlock|Unlock grades or items]]

Regarding an easy way to look at an individual student's grades from the gradebook, see MDL-12972.

==At a glance reporting==
For writing reports and quickly finding out who in the class needs attention to prevent them falling behind (or for gifted/talented enrichment), the gradebook needs to show information about pass/fail grades and deadline meeting without further clicks.

Setting grade to pass is a good way to make the passed items show up with a green background (once MDL-13830 is fixed), so this is a start, although it is not in any way clear that this functionality exists and the editing icon for the gradebook columns is not easy to spot as distinct from all of the others. It would help if grade to pass could be set from within modules as this would be the intuitive place to look for it (MDL-13831). There is an urgent need for a way to identify late work visually (MDL-12111) and also to show work which has been submitted (on time or otherwise), but is not yet marked (MDL-12513).

These changes would bring the gradebook in line with paper registers in terms of basic at a glance access to information, which is often encoded idiosyncratically with different marks or pen colours. There is probably some room for discussion of how much information can be carried by each cell, but with border colours currently unused and perhaps background images this must be possible (although there may need to be a separate image for every possible combination of CSS classes in order to preserve info on browsers that don't support transparency).
-- [[User:Matt Gibson|Matt Gibson]] 04:14, 27 January 2009 (CST)

[[Image:Gradebook_Grader_Mock1.png|200px|thumb|Mockup showing header toggles for cell attributes]]To build on what Matt said above I've created some mockups of improvements to the interface of the 1.9 grader report. The major feature that applies to this topic is the use of grade item attributes that can be checked on or off in the header of the report (much the same way "Show Hide/show icons" and "Show locks" are now done). I've taken the liberty to update the language to be more noun or verb focused based on attribute or action respectively.

The "action buttons" and "special rows" are very similar in behavior to current 1.9.x. The attributes are displayed as colored tags in each grade cell.

[[Image:Gradebook_Grader-mock1-attribute-tags.png|200px|thumb|Mockup showing how attributes would be organized in grade cells]]Some notes on the grade cell tags:
* The position of each tag within a grade cell is consistent no matter how many or which tags are displayed. This improves scanning speed and accuracy.
* Clicking on the tag icon in the legend at the top would (through the power of javascript) highlight all the grade cells that have that tag set within them (much like you can now highlight a row or column). This would make it trivially easy to quickly find the grades which are late or need to be marked, etc.
-- [[User:Paul Ortman|Paul Ortman]] 03:46, 29 January 2009 (EST)

'''Filters for At a glance editing'''

Grade item attributes could also be used to apply a filter to:
* one or more Columns in the grader report
* a Quick Edit page (LSU)
[[User:Barry Oosthuizen|Barry Oosthuizen]] 12:42, 5 February 2009 (CST)

==Category or site aggregation==
For a one year teaching programme, I am currently using 6 courses and manage enrolments with a metacourse. David's excellent [http://moodle.org/mod/data/view.php?d=13&rid=1775&filter=1 subcourse] module lets this happen, but it's non-standard and should really appear as part of a metacourse by default. It could also do with a cron component so that it doesn't have to be manually fetched all the time. If it were possible to have a similar module that would pick an arbitrary grade or aggragate from another course, instead of the total, that would make this very powerful.
-- [[User:Matt Gibson|Matt Gibson]] 04:14, 27 January 2009 (CST)

==Target tracking==
Use the gradebook primarily to track a pupil's progress in terms of meeting the targets that they were previously set. This is already possible to a certain extent using the hover-over tooltips for feedback, but not all modules (e.g. quiz MDL-13902) can do this. Having a separate comment field in each grading screen to specify a clear target as distict from general comments would be ideal, along with a checkbox to say if the previous one has been achieved, but is a bit outside the gradebook scope.
-- [[User:Matt Gibson|Matt Gibson]] 04:14, 27 January 2009 (CST)

==Participation tracking==
For my courses, I often set a participation target e.g. 'post twice in this forum and reply twice', but this is impossible to grade automatically, even though it's just a matter of checking the logs on a cron run. A new module to do this (whilst again, slightly outside the scope of the gradebook) would make the gradebook that much more useful for one-stop whole course monitoring.
-- [[User:Matt Gibson|Matt Gibson]] 04:14, 27 January 2009 (CST)

: The Activity completion part of [[Conditional activities]] already does this in Moodle 2.0.--[[User:Tim Hunt|Tim Hunt]] 20:37, 27 January 2009 (CST)

==Using the gradebook at a fraction of its potential==
Maybe the most common use-case :) Moodle's general aversion to direct on-screen guidance, rather than pop-up help, or semi-obscure (bottom of page, not labelled as 'help' MDL-18047) guidance in moodledocs could easily lead most users to miss features that they could make amazing use of. Tooltips for absolutely everything (MDL-13960) and small amounts of on-screen help (MDL-18046) would also be very useful in letting people know what's possible. As an example - how can one check the history of a grade that's been changed? I still can't work out how to do this and I would consider myself a power user. Can it be done? If so, some documentation or on screen help is needed.
-- [[User:Matt Gibson|Matt Gibson]] 04:14, 27 January 2009 (CST)

==Hassling students who are not pulling their weight (Deadline/lateness tracking)==
I'd ideally like to be able to look at the gradebook, see that X students are constantly missing deadlines (MDL-12111) and be able to message them there and then using simple check boxes (MDL-12203). Even better would be the option to have an automatic mailmerge done using the address field of the user profiles and some standard letter template so that I could download pre-written letters to these student or their parents/guardians pointing out to them what they have not done, and the dire consequences they can expect if they keep slacking.
-- [[User:Matt Gibson|Matt Gibson]] 04:14, 27 January 2009 (CST)

==Extra Credit==
At our institution we see that every grade item (at least those that are numeric) needs an extra credit field. The contents of the field determine how extra credit is applied to that item, category, or course category. If the contents are a whole or real number ('5', '24', '1.5'), the extra credit field is added to the numerator prior to normalization of the grade. If the contents of the extra credit field is a percentage ('5%') then that value is added to the normalized value of the item. Likewise, extra credit could be added to categories or the course category, but in this case only percentages could be added (unless sum of grades is used in the category). There would need to be a visual cue to both the teacher and student that a given grade item has had extra credit adjustments made to it. Finally, I could see use cases where lists of extra credit would need to be added to grade items (so more than one piece of extra credit could be added to a category per person.

[[Category:Grades]]