https://docs.moodle.org/38/en/api.php?action=feedcontributions&user=Bobpuffer&feedformat=atomMoodleDocs - User contributions [en]2024-03-29T09:49:13ZUser contributionsMediaWiki 1.39.6https://docs.moodle.org/38/en/index.php?title=Gradebook&diff=115590Gradebook2014-10-28T17:22:27Z<p>Bobpuffer: /* 2.8 Gradebook Enhancements */</p>
<hr />
<div>{{Grades}}<br />
All the grades for each student in a course can be found in the course gradebook, or 'Grader report' in ''Administration > Course administration > Grades''.<br />
<br />
The grader report 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.<br />
<br />
The grades displayed are initially displayed as the raw marks from the assessments themselves, so will depend on how you set those up e.g. an essay out of 36 will appear as however many raw marks that student got, not a percentage (although this can be changed later, see below).<br />
<br />
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.<br />
<br />
==2.8 Gradebook Enhancements==<br />
[[gradebook/2.8 Gradebook Enhancements Page|2.8 Gradebook Enhancements Page]]<br />
<br />
==Display==<br />
<br />
Along the top of the grader report are several rows: first the course, then the category, then the columns for each graded activity (for example: Assignment, Quiz, Lesson). Any activities settings which were left "uncategorised" will appear in the general category which is named after the course by default (any category name can be changed).<br />
<br />
You can add a row showing the range of possible scores by selecting 'Show ranges' in 'My report preferences.<br />
<br />
There are three ways that the categories can be displayed:<br />
<br />
* Grades only - without the category totals column<br />
* Collapsed - Category total column only<br />
* Full view - grades and the aggregates (the totals column for the category) <br />
<br />
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.<br />
<br />
[[Image:Grades grader report with categories 1.png]]<br />
<br />
===Highlighting rows and columns===<br />
<br />
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.<br />
* Clicking on empty space in the cell that contains the students name will toggle the highlighting of that entire row<br />
* Clicking on empty space in the cell at the top of each column will toggle highlighting of the entire column<br />
(Note: this requires Javascript to be enabled in your browser.)<br />
<br />
===Sorting by columns===<br />
<br />
You can sort by any column. Click the [[Image:iconsort.png]] symbol near the top of a column to sort by that column. This will change the symbol to a single down arrow. Clicking again will sort lowest-to-highest, changing the symbol to an up arrow. The arrows will toggle between these two states until you click on a different column.<br />
<br />
The student name columns do not have the [[Image:iconsort.png]] symbol. Clicking on either the first or last name will cause the report to sort.<br />
<br />
[[File:Grade_Report_unsorted_name1.png]]<br />
<br />
===Highlighting scores that are either adequate or unacceptable in red and green===<br />
<br />
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.<br />
<br />
Note that the highlighting will not show if the Grader report is viewed in the editing mode.<br />
<br />
===Horizontal scrollbar===<br />
<br />
A horizontal scrollbar enables teachers to scroll grades in the grader report. <br />
<br />
<br />
The horizontal scrollbar is available both at the bottom and at the top of the grader report.<br />
<br />
[[Image:horizontalscrollbar.png|thumb|center|500px|Horizontal scrollbars]]<br />
<br />
===Mouse-over tooltips===<br />
<br />
Each grade cell in the table has a tooltip indicating the user and grade item to which the grade belongs.<br />
<br />
===Searching and filtering the gradebook===<br />
If you change the course settings Group mode to Visible groups or Separate groups a drop-down menu will appear in the gradebook to allow you to filter your students by groups.<br />
<br />
<br />
It is also possible to search students by first name and last name:<br />
<br />
[[File:gradebooksearch.png]]<br />
<br />
==Editing==<br />
<br />
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.<br />
<br />
===Altering the grades===<br />
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.<br />
<br />
Alternatively, you can choose "Quick grading" and "Quick feedback" in 'My preferences' 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.<br />
<br />
Note: If you make changes here, they are then shown highlighted to indicate grades which have been manually changed.<br />
<br />
===Hiding columns or individual grades===<br />
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]].<br />
<br />
===Recalculating===<br />
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.<br />
<br />
==Gradebook capabilities==<br />
<br />
There is just one gradebook capability, [[Capabilities/gradereport/grader:view|View the grader report]], which is allowed for the default roles of manager, teacher and non-editing teacher.<br />
<br />
==Extending the gradebook==<br />
<br />
The Gradebook can be extended in three main ways:<br />
<br />
===1. [https://moodle.org/plugins/browse.php?list=category&id=9 Grade reports]===<br />
Which are the main way to view and manipulate grades<br />
* [[LAEGrader report|LAE Grader Report]] Alternative to Grader report that scrolls vertically and horizontally without losing student columns or grade item header rows. Lot of additional enhancements.<br />
* [https://moodle.org/plugins/view.php?plugin=gradereport_updfgrades Upload PDF Grader Report] lets you view assignment grades, comments and lateness in a report<br />
<br />
===2. Grade import plugins===<br />
Which allow data to be imported from external sources<br />
<br />
===3. [https://moodle.org/plugins/browse.php?list=category&id=10 Grade export plugins]:===<br />
Which allow you to export grade data for other systems<br />
* [https://moodle.org/plugins/view.php?plugin=gradeexport_pdf PDF document] This is moodle plugin for exporting grades in PDF format. It is developed by using "Moodle PDF library"<br />
* [https://moodle.org/plugins/view.php?plugin=gradeexport_checklist Checklist] This is a grade export plugin which will create an Excel spreadsheet containing all the checkmarks from a single checklist.<br />
<br />
<br />
==See also==<br />
<br />
* Join the discussions about gradebook plugins in the [https://moodle.org/mod/forum/view.php?id=2122 Gradebook forum].<br />
<br />
*[http://www.youtube.com/watch?v=5hrLNbifiGQ Video explaining the different gradebook reports]<br />
*[http://youtu.be/5FbOti83Nkw Moodle 2.x Gradebook (part 1)] MoodleBites video on YouTube <br />
*[http://youtu.be/Dg-10yQBXuM Moodle 2.x Gradebook (part 2)] MoodleBites video on YouTube <br />
*[http://youtu.be/ShGv7lwMfm0 Greg Egan - Introduction to grading and the gradebook - iMoot 2013] Excellent clarification of Grader Report, Categories and Items, Scales, Aggregation (especially helpful for accurate overall grades!), Letter Grades, and Rubrics. Outcomes are not covered.<br />
<br />
[[de:Bewertungen]]<br />
[[es:Libro de calificaciones]]<br />
[[fr:Carnet de notes]]<br />
[[ja:評定表]]</div>Bobpufferhttps://docs.moodle.org/38/en/index.php?title=Gradebook&diff=115589Gradebook2014-10-28T17:13:51Z<p>Bobpuffer: /* Display */</p>
<hr />
<div>{{Grades}}<br />
All the grades for each student in a course can be found in the course gradebook, or 'Grader report' in ''Administration > Course administration > Grades''.<br />
<br />
The grader report 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.<br />
<br />
The grades displayed are initially displayed as the raw marks from the assessments themselves, so will depend on how you set those up e.g. an essay out of 36 will appear as however many raw marks that student got, not a percentage (although this can be changed later, see below).<br />
<br />
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.<br />
<br />
==2.8 Gradebook Enhancements==<br />
<br />
==Display==<br />
<br />
Along the top of the grader report are several rows: first the course, then the category, then the columns for each graded activity (for example: Assignment, Quiz, Lesson). Any activities settings which were left "uncategorised" will appear in the general category which is named after the course by default (any category name can be changed).<br />
<br />
You can add a row showing the range of possible scores by selecting 'Show ranges' in 'My report preferences.<br />
<br />
There are three ways that the categories can be displayed:<br />
<br />
* Grades only - without the category totals column<br />
* Collapsed - Category total column only<br />
* Full view - grades and the aggregates (the totals column for the category) <br />
<br />
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.<br />
<br />
[[Image:Grades grader report with categories 1.png]]<br />
<br />
===Highlighting rows and columns===<br />
<br />
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.<br />
* Clicking on empty space in the cell that contains the students name will toggle the highlighting of that entire row<br />
* Clicking on empty space in the cell at the top of each column will toggle highlighting of the entire column<br />
(Note: this requires Javascript to be enabled in your browser.)<br />
<br />
===Sorting by columns===<br />
<br />
You can sort by any column. Click the [[Image:iconsort.png]] symbol near the top of a column to sort by that column. This will change the symbol to a single down arrow. Clicking again will sort lowest-to-highest, changing the symbol to an up arrow. The arrows will toggle between these two states until you click on a different column.<br />
<br />
The student name columns do not have the [[Image:iconsort.png]] symbol. Clicking on either the first or last name will cause the report to sort.<br />
<br />
[[File:Grade_Report_unsorted_name1.png]]<br />
<br />
===Highlighting scores that are either adequate or unacceptable in red and green===<br />
<br />
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.<br />
<br />
Note that the highlighting will not show if the Grader report is viewed in the editing mode.<br />
<br />
===Horizontal scrollbar===<br />
<br />
A horizontal scrollbar enables teachers to scroll grades in the grader report. <br />
<br />
<br />
The horizontal scrollbar is available both at the bottom and at the top of the grader report.<br />
<br />
[[Image:horizontalscrollbar.png|thumb|center|500px|Horizontal scrollbars]]<br />
<br />
===Mouse-over tooltips===<br />
<br />
Each grade cell in the table has a tooltip indicating the user and grade item to which the grade belongs.<br />
<br />
===Searching and filtering the gradebook===<br />
If you change the course settings Group mode to Visible groups or Separate groups a drop-down menu will appear in the gradebook to allow you to filter your students by groups.<br />
<br />
<br />
It is also possible to search students by first name and last name:<br />
<br />
[[File:gradebooksearch.png]]<br />
<br />
==Editing==<br />
<br />
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.<br />
<br />
===Altering the grades===<br />
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.<br />
<br />
Alternatively, you can choose "Quick grading" and "Quick feedback" in 'My preferences' 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.<br />
<br />
Note: If you make changes here, they are then shown highlighted to indicate grades which have been manually changed.<br />
<br />
===Hiding columns or individual grades===<br />
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]].<br />
<br />
===Recalculating===<br />
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.<br />
<br />
==Gradebook capabilities==<br />
<br />
There is just one gradebook capability, [[Capabilities/gradereport/grader:view|View the grader report]], which is allowed for the default roles of manager, teacher and non-editing teacher.<br />
<br />
==Extending the gradebook==<br />
<br />
The Gradebook can be extended in three main ways:<br />
<br />
===1. [https://moodle.org/plugins/browse.php?list=category&id=9 Grade reports]===<br />
Which are the main way to view and manipulate grades<br />
* [[LAEGrader report|LAE Grader Report]] Alternative to Grader report that scrolls vertically and horizontally without losing student columns or grade item header rows. Lot of additional enhancements.<br />
* [https://moodle.org/plugins/view.php?plugin=gradereport_updfgrades Upload PDF Grader Report] lets you view assignment grades, comments and lateness in a report<br />
<br />
===2. Grade import plugins===<br />
Which allow data to be imported from external sources<br />
<br />
===3. [https://moodle.org/plugins/browse.php?list=category&id=10 Grade export plugins]:===<br />
Which allow you to export grade data for other systems<br />
* [https://moodle.org/plugins/view.php?plugin=gradeexport_pdf PDF document] This is moodle plugin for exporting grades in PDF format. It is developed by using "Moodle PDF library"<br />
* [https://moodle.org/plugins/view.php?plugin=gradeexport_checklist Checklist] This is a grade export plugin which will create an Excel spreadsheet containing all the checkmarks from a single checklist.<br />
<br />
<br />
==See also==<br />
<br />
* Join the discussions about gradebook plugins in the [https://moodle.org/mod/forum/view.php?id=2122 Gradebook forum].<br />
<br />
*[http://www.youtube.com/watch?v=5hrLNbifiGQ Video explaining the different gradebook reports]<br />
*[http://youtu.be/5FbOti83Nkw Moodle 2.x Gradebook (part 1)] MoodleBites video on YouTube <br />
*[http://youtu.be/Dg-10yQBXuM Moodle 2.x Gradebook (part 2)] MoodleBites video on YouTube <br />
*[http://youtu.be/ShGv7lwMfm0 Greg Egan - Introduction to grading and the gradebook - iMoot 2013] Excellent clarification of Grader Report, Categories and Items, Scales, Aggregation (especially helpful for accurate overall grades!), Letter Grades, and Rubrics. Outcomes are not covered.<br />
<br />
[[de:Bewertungen]]<br />
[[es:Libro de calificaciones]]<br />
[[fr:Carnet de notes]]<br />
[[ja:評定表]]</div>Bobpufferhttps://docs.moodle.org/38/en/index.php?title=LAEUser&diff=110356LAEUser2014-02-26T14:49:07Z<p>Bobpuffer: </p>
<hr />
<div>NOTE: LAE stands for Liberal Arts Edition, a repackaged version of Moodle provided by CLAMP (Collaborative Liberal Arts Moodle Project). The LAE User and LAE Grader are packaged with the LAE version of Moodle but can be installed separately with the dependencies as noted below.<br />
<br />
The LAE User report complements the LAE Grader report in providing for accurate point totals if desired. Additionally, LAE User provides additional functionality as follows:<br />
<br />
* Accurate weights are recorded not just whatever number the instructor input whether it has any relation to how grades are calculated or not. Still the LAE User report respects instructor-input weights if using Weighted mean of grades.<br />
* A 'contribution' column is provided allowing a student to easily see how the final grade was derived (arrow-B, below):<br />
[[{{ns:file}}:realstudentlaeuserreport.png|600px|thumb|center|LAE User report]]<br />
* A 'Final grade only' option for display of letter grades (arrow-A, above)<br />
* A drop down allowing a student to choose a target grade based on what remains ungraded (arrow-C, below)<br />
[[{{ns:file}}:myuncalcedlaeuserreport.png|600px|thumb|center|LAE User report]]<br />
Once the target grade is input, values are filled in that will show the student what performance is needed to hit the target.<br />
[[{{ns:file}}:mycalcedlaeuserreport.png|600px|thumb|center|LAE User report]]</div>Bobpufferhttps://docs.moodle.org/38/en/index.php?title=File:mycalcedlaeuserreport.png&diff=110355File:mycalcedlaeuserreport.png2014-02-26T14:48:07Z<p>Bobpuffer: </p>
<hr />
<div></div>Bobpufferhttps://docs.moodle.org/38/en/index.php?title=File:myuncalcedlaeuserreport.png&diff=110354File:myuncalcedlaeuserreport.png2014-02-26T14:45:56Z<p>Bobpuffer: </p>
<hr />
<div></div>Bobpufferhttps://docs.moodle.org/38/en/index.php?title=File:realstudentlaeuserreport.png&diff=110353File:realstudentlaeuserreport.png2014-02-26T14:42:01Z<p>Bobpuffer: </p>
<hr />
<div></div>Bobpufferhttps://docs.moodle.org/38/en/index.php?title=LAEUser&diff=110351LAEUser2014-02-26T14:38:29Z<p>Bobpuffer: </p>
<hr />
<div>NOTE: LAE stands for Liberal Arts Edition, a repackaged version of Moodle provided by CLAMP (Collaborative Liberal Arts Moodle Project). The LAE User and LAE Grader are packaged with the LAE version of Moodle but can be installed separately with the dependencies as noted below.<br />
<br />
The LAE User report complements the LAE Grader report in providing for accurate point totals if desired. Additionally, LAE User provides additional functionality as follows:<br />
<br />
# Accurate weights are recorded not just whatever number the instructor input whether it has any relation to how grades are calculated or not. Still the LAE User report respects instructor-input weights if using Weighted mean of grades.<br />
# A 'contribution' column is provided allowing a student to easily see how the final grade was derived (arrow-B, below):<br />
[[http://katie.luther.edu/moodle/realstudentlaeuserreport.png]]<br />
# A 'Final grade only' option for display of letter grades (arrow-A, above)<br />
# A drop down allowing a student to choose a target grade based on what remains ungraded (arrow-C, below)<br />
[[http://katie.luther.edu/moodle/myuncalcedlaeuserreport.png]]<br />
Once the target grade is input, values are filled in that will show the student what performance is needed to hit the target.<br />
[[http://katie.luther.edu/moodle/mycalcedlaeuserreport.png]]</div>Bobpufferhttps://docs.moodle.org/38/en/index.php?title=LAEUser&diff=110350LAEUser2014-02-26T14:37:05Z<p>Bobpuffer: Created page with "NOTE: LAE stands for Liberal Arts Edition, a repackaged version of Moodle provided by CLAMP (Collaborative Liberal Arts Moodle Project). The LAE User and LAE Grader are packag..."</p>
<hr />
<div>NOTE: LAE stands for Liberal Arts Edition, a repackaged version of Moodle provided by CLAMP (Collaborative Liberal Arts Moodle Project). The LAE User and LAE Grader are packaged with the LAE version of Moodle but can be installed separately with the dependencies as noted below.<br />
<br />
The LAE User report complements the LAE Grader report in providing for accurate point totals if desired. Additionally, LAE User provides additional functionality as follows:<br />
<br />
# Accurate weights are recorded not just whatever number the instructor input whether it has any relation to how grades are calculated or not. Still the LAE User report respects instructor-input weights if using Weighted mean of grades.<br />
# A 'contribution' column is provided allowing a student to easily see how the final grade was derived (arrow-B, below):<br />
[[File:http://katie.luther.edu/moodle/realstudentlaeuserreport.png]]<br />
# A 'Final grade only' option for display of letter grades (arrow-A, above)<br />
# A drop down allowing a student to choose a target grade based on what remains ungraded (arrow-C, below)<br />
[[File:http://katie.luther.edu/moodle/myuncalcedlaeuserreport.png]]<br />
Once the target grade is input, values are filled in that will show the student what performance is needed to hit the target.<br />
[[File:http://katie.luther.edu/moodle/mycalcedlaeuserreport.png]]</div>Bobpufferhttps://docs.moodle.org/38/en/index.php?title=Grades&diff=110348Grades2014-02-26T14:30:27Z<p>Bobpuffer: </p>
<hr />
<div>{{Tracking progress}}<br />
<br />
* [[Gradebook]]<br />
* [[LAEGrader]]<br />
* [[LAEUser]]<br />
* [[Grade settings]]<br />
* [[Managing grades]]<br />
** [[Grade items]]<br />
** [[Grade categories]]<br />
** [[Grade calculations]]<br />
* [[Scales]]<br />
* [[Outcomes]]<br />
* [[Grade letters]]<br />
* [[Grade import]]<br />
* [[Grade export]]<br />
* [[Advanced grading methods]] <br />
** [[Rubrics]]<br />
** [[Marking guide]]<br />
** [[Learning Analytics Enriched Rubric]]<br />
<br />
==See also==<br />
* [[Grades FAQ]]<br />
<br />
[[Category:Grades]]<br />
<br />
[[ca:Qualificacions]]<br />
[[cs:Známky]]<br />
[[de:Bewertungen in Moodle]]<br />
[[eu:Kalifikazioak]]<br />
[[fr:Notes]]<br />
[[es:Calificaciones]]<br />
[[ru:Оценки]]<br />
[[ja:評定]]</div>Bobpufferhttps://docs.moodle.org/38/en/index.php?title=Grades&diff=110347Grades2014-02-26T14:25:45Z<p>Bobpuffer: </p>
<hr />
<div>{{Tracking progress}}<br />
<br />
* [[Gradebook]]<br />
* [[LAE Grader report]]<br />
* [[LAE User report]]<br />
* [[Grade settings]]<br />
* [[Managing grades]]<br />
** [[Grade items]]<br />
** [[Grade categories]]<br />
** [[Grade calculations]]<br />
* [[Scales]]<br />
* [[Outcomes]]<br />
* [[Grade letters]]<br />
* [[Grade import]]<br />
* [[Grade export]]<br />
* [[Advanced grading methods]] <br />
** [[Rubrics]]<br />
** [[Marking guide]]<br />
** [[Learning Analytics Enriched Rubric]]<br />
<br />
==See also==<br />
* [[Grades FAQ]]<br />
<br />
[[Category:Grades]]<br />
<br />
[[ca:Qualificacions]]<br />
[[cs:Známky]]<br />
[[de:Bewertungen in Moodle]]<br />
[[eu:Kalifikazioak]]<br />
[[fr:Notes]]<br />
[[es:Calificaciones]]<br />
[[ru:Оценки]]<br />
[[ja:評定]]</div>Bobpufferhttps://docs.moodle.org/38/en/index.php?title=LAEGrader_report&diff=110148LAEGrader report2014-02-21T18:58:02Z<p>Bobpuffer: /* User Configurable settings */</p>
<hr />
<div>{{Grades}}<br />
{{Infobox plugin<br />
|type = Grade report<br />
|entry = http://clamp-it.org<br />
|tracker = Enter the Tracker CONTRIB component link<br />
|discussion = https://moodle.org/mod/forum/discuss.php?d=153718<br />
|maintainer = [[User:Bob Puffer|Bob Puffer]]<br />
|float = right<br />
}}<br />
<br />
The LAEgrader report page is an alternative main teacher view of the gradebook in Moodle 1.9. LAEgrader is not designed for versions prior to 1.9.<br />
<br />
If installed, the report can be seen in ''Course administration>Grades''<br />
<br />
==LAEgrader Report Overview==<br />
The LAEgrader report takes the place of the Grader report as the grades repository interface for the instructor for the course. It is based off from, and shares many library functions and classes with the Grader report. Therefore, the Grader report directory on your Moodle installation cannot be removed. The most notable difference between the LAEgrader and Grader is that the LAEgrader freezes both the column headers (grade item titles) and the student rows, while still allowing the user to scroll vertically and horizontally.<br />
<br />
==LAEgrader Report Installation==<br />
# Download the LAEgrader report from https://github.com/bobpuffer/laegrader.git. It is bundled with the LAE version of Moodle but can be extracted and used alone without other LAE enhancements.<br />
# (If zipped) unzip the contents of the zip file.<br />
# Place all contents of the grade/report/laegrader folder in the grade/report folder of your Moodle installation (you should then have a grade/report/laegrader folder)<br />
# Under Site administration block run Notifications.<br />
# Check to see that your permissions for your various roles are as you desire. It is recommended that access to the regular Grader report be set to "Prohibit" to avoid confusion. The admin will always see both reports.<br />
<br />
==User Configurable settings==<br />
* Height in pixels of scrollable portion of LAE grader report (300,340,380,420,460,500,540,580,620,660,700,740,780,820,860,900). Each increment represents roughly one student line.<br />
* Accurate points calculation on or off (see below).<br />
* Width of column text.<br />
<br />
==Display==<br />
===Layout Differences From Grader Report===<br />
[[Image:laegrader_normal_mode.png|right|thumb|LAE Grader report in non-editing mode]]<br />
* Grade item and category headers are all on one line, not nested. LAEgrader does not collapse or expand categories.<br />
* LAEgrader allows wrapping of grade item and grade category names (at approximately 30 characters) to avoid excessively wide reports<br />
* Category items always follow the items contained in the category<br />
* All items (including the category column) included in a category are color-coded the same to group them together, alternately orange/blue<br />
* The last column is always the Course Total. <br />
* Items not contained in a category have a background of white as does the Course Total. <br />
* Hidden items and categories are gray.<br />
* '''Grades scroll both horizontally and vertically without losing view of the students column or the grade item header rows.''' This is the biggest difference between the LAE and core gradebooks. It negates the need for mouseover descriptions of which student and which item on which you're currently working.<br />
* Rows added such as 'range' or 'average' are placed at the top (instead of the bottom) and are frozen along with the grade item titles row so the user never loses sight of them.<br />
<br />
==Functionality Enhancements Beyond the Core Gradebook==<br />
===Letter and Percentage Input===<br />
Whenever the user is editing grades they have the option of inputting a "real" number, a letter grade or a percentage grade. A letter will be compared against the letter grade setup for the course (configurable [[Grade letters]]) and will be converted to 1 point less than the maximum available for that letter grade. Percentage grades will be converted to the input percentage times the maximum grade earnable for that item.<br />
<br />
==="Dump to Google" button===<br />
A button is provided above the student names column to allow quick "dumps" of LAE grader report contents. The data is exported in a format that facilitates calculations and checking of grades in Google (or Excel, if you have to).<br />
<br />
===Filters for Groupings===<br />
If a group is chosen which doesn't have access to all grade items, those grade items are not displayed in the LAE Grader report.<br />
<br />
===Accurate Points Calculation===<br />
Unless Sum of Grades aggregation method is used, Moodle's core gradebook does not automatically maintain accurate category and course points totals. LAE maintains these on the fly (if $CFG->accuratetotals is chosen) without making changes in the values stored in Moodle's grades tables. There are also instances when the core gradebook's lack of maintaining accurate totals affects percentage and letter grade calculations. LAE corrects those. Examples of issues caused by the core gradebook not maintaining accurate point totals include:<br />
# When multiple SWM categories are nested in another category with differing total actual points the expected outcome is each point will be counted the same. When 100 points is left for each category total, (the default for the core gradebook) the result is each category is counted the same, regardless of the value of the contained item points -- a point in one category is not worth the same as a point in another category.<br />
# Though teachers can update the maximum points for categories and course totals they'd need to do this continually throughout the duration of the course, after each grade item is marked.<br />
# With a set 100 points being the maximum, what is reported as the “grade” is nothing different than percentage and has no additional value.<br />
<br />
NOTE: to maintain the enhancements inside the report "plugin" the accurately calculated points for categories will not be reflected in the Categories and Items screen (unless you request Luther's hack for that). Additionally, an accurate points version of the User report is available so students see what makes sense to them.<br />
<br />
==Problems==<br />
===Grades not submitting===<br />
(Similar problems exist for existing Moodle gradebook). If you're using suhosin to harden your PHP you should set suhosin.post.max_vars four times the columns times the rows of your anticipated largest gradebook.<br />
<br />
If you're using PHP 5.3.9 you need a line like:<br />
php_value max_input_vars XXXXX<br />
where XXXXX is a similar calculation as above with suhosin (we use 20000).<br />
<br />
==See also==<br />
*[[Edit grade calculation]]<br />
*[[Grade preferences]]<br />
*[http://www.youtube.com/watch?v=EB58W3KePBc Video showing the basic gradebook setup and use]<br />
*[http://www.youtube.com/watch?v=jWPUEqdhI4A Video showing how to change the display of grades in the gradebook]<br />
*[http://www.youtube.com/watch?v=5hrLNbifiGQ Video explaining the different gradebook reports]<br />
<br />
Using Moodle forum discussions:<br />
*[http://moodle.org/mod/forum/discuss.php?d=153718 Initial announcement and discussion on LAEgrader report]<br />
<br />
[[Category:Contributed code]]</div>Bobpufferhttps://docs.moodle.org/38/en/index.php?title=LAEGrader_report&diff=105974LAEGrader report2013-07-10T22:31:15Z<p>Bobpuffer: </p>
<hr />
<div>{{Grades}}<br />
{{Infobox plugin<br />
|type = Grade report<br />
|entry = http://clamp-it.org<br />
|tracker = Enter the Tracker CONTRIB component link<br />
|discussion = https://moodle.org/mod/forum/discuss.php?d=153718<br />
|maintainer = [[User:Bob Puffer|Bob Puffer]]<br />
|float = right<br />
}}<br />
<br />
The LAEgrader report page is an alternative main teacher view of the gradebook in Moodle 1.9. LAEgrader is not designed for versions prior to 1.9.<br />
<br />
If installed, the report can be seen in ''Course administration>Grades''<br />
<br />
==LAEgrader Report Overview==<br />
The LAEgrader report takes the place of the Grader report as the grades repository interface for the instructor for the course. It is based off from, and shares many library functions and classes with the Grader report. Therefore, the Grader report directory on your Moodle installation cannot be removed. The most notable difference between the LAEgrader and Grader is that the LAEgrader freezes both the column headers (grade item titles) and the student rows, while still allowing the user to scroll vertically and horizontally.<br />
<br />
==LAEgrader Report Installation==<br />
# Download the LAEgrader report from https://github.com/bobpuffer/laegrader.git. It is bundled with the LAE version of Moodle but can be extracted and used alone without other LAE enhancements.<br />
# (If zipped) unzip the contents of the zip file.<br />
# Place all contents of the grade/report/laegrader folder in the grade/report folder of your Moodle installation (you should then have a grade/report/laegrader folder)<br />
# Under Site administration block run Notifications.<br />
# Check to see that your permissions for your various roles are as you desire. It is recommended that access to the regular Grader report be set to "Prohibit" to avoid confusion. The admin will always see both reports.<br />
<br />
==User Configurable settings==<br />
* "gradeeditalways" mode removes the edit button and always displays the report ready for editing of grades (see below). <br />
* Height in pixels of scrollable portion of LAE grader report (300,340,380,420,460,500,540,580,620,660,700,740,780,820,860,900). Each increment represents roughly one student line.<br />
* Accurate points calculation on or off (see below).<br />
<br />
==Display==<br />
===Layout Differences From Grader Report===<br />
[[Image:laegrader_normal_mode.png|right|thumb|LAE Grader report in non-editing mode]]<br />
* Grade item and category headers are all on one line, not nested. LAEgrader does not collapse or expand categories.<br />
* LAEgrader allows wrapping of grade item and grade category names (at approximately 30 characters) to avoid excessively wide reports<br />
* Category items always follow the items contained in the category<br />
* All items (including the category column) included in a category are color-coded the same to group them together, alternately orange/blue<br />
* The last column is always the Course Total. <br />
* Items not contained in a category have a background of white as does the Course Total. <br />
* Hidden items and categories are gray.<br />
* '''Grades scroll both horizontally and vertically without losing view of the students column or the grade item header rows.''' This is the biggest difference between the LAE and core gradebooks. It negates the need for mouseover descriptions of which student and which item on which you're currently working.<br />
* Rows added such as 'range' or 'average' are placed at the top (instead of the bottom) and are frozen along with the grade item titles row so the user never loses sight of them.<br />
<br />
==Functionality Enhancements Beyond the Core Gradebook==<br />
===Letter and Percentage Input===<br />
Whenever the user is editing grades they have the option of inputting a "real" number, a letter grade or a percentage grade. A letter will be compared against the letter grade setup for the course (configurable [[Grade letters]]) and will be converted to 1 point less than the maximum available for that letter grade. Percentage grades will be converted to the input percentage times the maximum grade earnable for that item.<br />
<br />
==="Dump to Google" button===<br />
A button is provided above the student names column to allow quick "dumps" of LAE grader report contents. The data is exported in a format that facilitates calculations and checking of grades in Google (or Excel, if you have to).<br />
<br />
===Filters for Groupings===<br />
If a group is chosen which doesn't have access to all grade items, those grade items are not displayed in the LAE Grader report.<br />
<br />
===Accurate Points Calculation===<br />
Unless Sum of Grades aggregation method is used, Moodle's core gradebook does not automatically maintain accurate category and course points totals. LAE maintains these on the fly (if $CFG->accuratetotals is chosen) without making changes in the values stored in Moodle's grades tables. There are also instances when the core gradebook's lack of maintaining accurate totals affects percentage and letter grade calculations. LAE corrects those. Examples of issues caused by the core gradebook not maintaining accurate point totals include:<br />
# When multiple SWM categories are nested in another category with differing total actual points the expected outcome is each point will be counted the same. When 100 points is left for each category total, (the default for the core gradebook) the result is each category is counted the same, regardless of the value of the contained item points -- a point in one category is not worth the same as a point in another category.<br />
# Though teachers can update the maximum points for categories and course totals they'd need to do this continually throughout the duration of the course, after each grade item is marked.<br />
# With a set 100 points being the maximum, what is reported as the “grade” is nothing different than percentage and has no additional value.<br />
<br />
NOTE: to maintain the enhancements inside the report "plugin" the accurately calculated points for categories will not be reflected in the Categories and Items screen (unless you request Luther's hack for that). Additionally, an accurate points version of the User report is available so students see what makes sense to them.<br />
<br />
==Problems==<br />
===Grades not submitting===<br />
(Similar problems exist for existing Moodle gradebook). If you're using suhosin to harden your PHP you should set suhosin.post.max_vars four times the columns times the rows of your anticipated largest gradebook.<br />
<br />
If you're using PHP 5.3.9 you need a line like:<br />
php_value max_input_vars XXXXX<br />
where XXXXX is a similar calculation as above with suhosin (we use 20000).<br />
<br />
==See also==<br />
*[[Edit grade calculation]]<br />
*[[Grade preferences]]<br />
*[http://www.youtube.com/watch?v=EB58W3KePBc Video showing the basic gradebook setup and use]<br />
*[http://www.youtube.com/watch?v=jWPUEqdhI4A Video showing how to change the display of grades in the gradebook]<br />
*[http://www.youtube.com/watch?v=5hrLNbifiGQ Video explaining the different gradebook reports]<br />
<br />
Using Moodle forum discussions:<br />
*[http://moodle.org/mod/forum/discuss.php?d=153718 Initial announcement and discussion on LAEgrader report]<br />
<br />
[[Category:Contributed code]]</div>Bobpufferhttps://docs.moodle.org/38/en/index.php?title=LAEGrader_report&diff=105973LAEGrader report2013-07-10T22:28:25Z<p>Bobpuffer: /* Grades not submitting */</p>
<hr />
<div>{{Grades}}<br />
{{Infobox plugin<br />
|type = Grade report<br />
|entry = http://clamp-it.org<br />
|tracker = Enter the Tracker CONTRIB component link<br />
|discussion = https://moodle.org/mod/forum/discuss.php?d=153718<br />
|maintainer = [[User:Bob Puffer|Bob Puffer]]<br />
|float = right<br />
}}<br />
<br />
The LAEgrader report page is an alternative main teacher view of the gradebook in Moodle 1.9. LAEgrader is not designed for versions prior to 1.9.<br />
<br />
If installed, the report can be seen in ''Course administration>Grades''<br />
<br />
==LAEgrader Report Overview==<br />
The LAEgrader report takes the place of the Grader report as the grades repository interface for the instructor for the course. It is based off from, and shares many library functions and classes with the Grader report. Therefore, the Grader report directory on your Moodle installation cannot be removed. The most notable difference between the LAEgrader and Grader is that the LAEgrader freezes both the column headers (grade item titles) and the student rows, while still allowing the user to scroll vertically and horizontally.<br />
<br />
==LAEgrader Report Installation==<br />
# Download the LAEgrader report from https://github.com/bobpuffer/laegrader.git. It is bundled with the LAE version of Moodle but can be extracted and used alone without other LAE enhancements.<br />
# (If zipped) unzip the contents of the zip file.<br />
# Place all contents of the grade/report/laegrader folder in the grade/report folder of your Moodle installation (you should then have a grade/report/laegrader folder)<br />
# Under Site administration block run Notifications.<br />
# Check to see that your permissions for your various roles are as you desire. It is recommended that access to the regular Grader report be set to "Prohibit" to avoid confusion. The admin will always see both reports.<br />
<br />
==User Configurable settings==<br />
* "gradeeditalways" mode removes the edit button and always displays the report ready for editing of grades (see below). <br />
* Height in pixels of scrollable portion of LAE grader report (300,340,380,420,460,500,540,580,620,660,700,740,780,820,860,900). Each increment represents roughly one student line.<br />
* Accurate points calculation on or off (see below).<br />
<br />
==Display==<br />
===Layout Differences From Grader Report===<br />
[[Image:laegrader_normal_mode.png|right|thumb|LAE Grader report in non-editing mode]]<br />
* Grade item and category headers are all on one line, not nested. LAEgrader does not collapse or expand categories.<br />
* LAEgrader allows wrapping of grade item and grade category names (at approximately 30 characters) to avoid excessively wide reports<br />
* Category items always follow the items contained in the category<br />
* All items (including the category column) included in a category are color-coded the same to group them together, alternately orange/blue<br />
* The last column is always the Course Total. <br />
* Items not contained in a category have a background of white as does the Course Total. <br />
* Hidden items and categories are gray.<br />
* '''Grades scroll both horizontally and vertically without losing view of the students column or the grade item header rows.''' This is the biggest difference between the LAE and core gradebooks. It negates the need for mouseover descriptions of which student and which item on which you're currently working.<br />
* Rows added such as 'range' or 'average' are placed at the top (instead of the bottom) and are frozen along with the grade item titles row so the user never loses sight of them.<br />
<br />
==Functionality Enhancements Beyond the Core Gradebook==<br />
===Letter and Percentage Input===<br />
Whenever the user is editing grades they have the option of inputting a "real" number, a letter grade or a percentage grade. A letter will be compared against the letter grade setup for the course (configurable [[Grade letters]]) and will be converted to 1 point less than the maximum available for that letter grade. Percentage grades will be converted to the input percentage times the maximum grade earnable for that item.<br />
<br />
==="Dump to Google" button===<br />
A button is provided above the student names column to allow quick "dumps" of LAE grader report contents. The data is exported in a format that facilitates calculations and checking of grades in Google (or Excel, if you have to).<br />
<br />
===Accurate Points Calculation===<br />
Unless Sum of Grades aggregation method is used, Moodle's core gradebook does not automatically maintain accurate category and course points totals. LAE maintains these on the fly (if $CFG->accuratetotals is chosen) without making changes in the values stored in Moodle's grades tables. There are also instances when the core gradebook's lack of maintaining accurate totals affects percentage and letter grade calculations. LAE corrects those. Examples of issues caused by the core gradebook not maintaining accurate point totals include:<br />
# When multiple SWM categories are nested in another category with differing total actual points the expected outcome is each point will be counted the same. When 100 points is left for each category total, (the default for the core gradebook) the result is each category is counted the same, regardless of the value of the contained item points -- a point in one category is not worth the same as a point in another category.<br />
# Though teachers can update the maximum points for categories and course totals they'd need to do this continually throughout the duration of the course, after each grade item is marked.<br />
# With a set 100 points being the maximum, what is reported as the “grade” is nothing different than percentage and has no additional value.<br />
<br />
NOTE: to maintain the enhancements inside the report "plugin" the accurately calculated points for categories will not be reflected in the Categories and Items screen (unless you request Luther's hack for that). Additionally, an accurate points version of the User report is available so students see what makes sense to them.<br />
<br />
==Problems==<br />
===Grades not submitting===<br />
(Similar problems exist for existing Moodle gradebook). If you're using suhosin to harden your PHP you should set suhosin.post.max_vars four times the columns times the rows of your anticipated largest gradebook.<br />
<br />
If you're using PHP 5.3.9 you need a line like:<br />
php_value max_input_vars XXXXX<br />
where XXXXX is a similar calculation as above with suhosin (we use 20000).<br />
<br />
==See also==<br />
*[[Edit grade calculation]]<br />
*[[Grade preferences]]<br />
*[http://www.youtube.com/watch?v=EB58W3KePBc Video showing the basic gradebook setup and use]<br />
*[http://www.youtube.com/watch?v=jWPUEqdhI4A Video showing how to change the display of grades in the gradebook]<br />
*[http://www.youtube.com/watch?v=5hrLNbifiGQ Video explaining the different gradebook reports]<br />
<br />
Using Moodle forum discussions:<br />
*[http://moodle.org/mod/forum/discuss.php?d=153718 Initial announcement and discussion on LAEgrader report]<br />
<br />
[[Category:Contributed code]]</div>Bobpufferhttps://docs.moodle.org/38/en/index.php?title=Development:Survey_2_brainstorm&diff=81948Development:Survey 2 brainstorm2011-03-15T13:14:39Z<p>Bobpuffer: /* Uncategorised requested features */</p>
<hr />
<div>This page is for collecting feature requests for a new Survey module that replaces Survey, Questionnaire and Feedback.<br />
<br />
==Module settings page==<br />
*option: allow/deny save without submission<br />
*option: anonymous survey or named responses<br />
*option: allow/deny record modification after submission<br />
*option: allow/deny the read only access to submitted records (see next example)<br />
(Example: This option should appear like:<br />
<code><br />
<div>Submitted answers are available/visible <select name="dropdown_7" size="1"><br />
<option value="0">to all users</option><br />
<option value="1" >to submitter only</option><br />
<option value="2" >to submitter group only</option><br />
</select></div><br />
</code><br />
)<br />
*option: allow/deny submitted record deletion<br />
*custom form and css<br />
*download of submitted records in some standard format<br />
* option: allow access to results any time/after you've submitted/after close date/never<br />
** fine-grain control for result display at question level also<br />
*type of field (char(n), text, number, alphanumeric, boolean, date, picture, file, email, url...) with type check at submit time (and number of digit check for char(n) fields).<br />
<br />
This information may not be used at field definition time but is useful for data verification/check. (see next example)<br />
<br />
(Example:<br />
Please, enter your card ID: _______<br />
This field should be defined, for instance, as char(7))<br />
*opening and closing submission dates (displayed on calendar)<br />
*relations between tables<br />
(Example:<br />
one record for the profile of my company<br />
one related record for each intervention request submitted by my company)<br />
<br />
=== Standard module settings ===<br />
<br />
* support for groups and groupings<br />
* permission control for which roles can create surveys<br />
<br />
==Field level settings==<br />
*mandatory/non mandatory field option<br />
*free text description field for further description and advice to the completer<br />
*define a range of valid answers for fields allowing this (see next examples)<br />
(Example 1:<br />
Please, enter your seniority. (limited between 0 and 50 years)<br />
<br />
Example 2:<br />
Date of birth: (limited between 18 and 100 years ago))<br />
*define fields default to be loaded at "new record" display time<br />
*optional "other" text field for drop down menu/radio button/check box. (see next example)<br />
(Example for drop down:<br />
<br />
Where were you born? <code><select name="dropdown_14" size="1"><option value="1" selected="selected">Spain</option><option value="2" >France</option><option value="3" >other, please specify</option></select> <input type="text" name="dropdown_14_other" size="10" maxlength="10" value="" /></code><br />
<br />
If you choose "other" in the drop down menu the field will be enabled and become mandatory, otherwise it will be disabled.<br />
)<br />
*define read-only fields (auto filled by the software) like, current_date, user_name, record_ID...<br />
* option: allow access to results any time/after you've submitted/after close date/never<br />
<br />
==Fields types==<br />
<br />
Field types should be plug-ins so that they can be extended locally if required. The following list covers types which exist in at least one of the current survey modules.<br />
<br />
* radio buttons<br />
** horizontal & vertical<br />
* short text entry<br />
* long text entry<br />
* allocation<br />
* checkbox<br />
* customisable likert scale for rating<br />
* ranking<br />
<br />
<br />
===New field types===<br />
*short date (with month and years only, to answer question like: When had you the first evidence of this disease?)<br />
*order list. A list of available items and the answer is supposed to order them.<br />
*time (see next example)<br />
<br />
(Example:<br />
When do you usually take breakfast?<br />
)<br />
<br />
==Result display==<br />
<br />
* choose for a question whether to display results as<br />
** a table<br />
** a bar chart<br />
** a pie chart<br />
<br />
==Question management==<br />
<br />
* questions can be copied within an activity<br />
* question sets can be created as templates for re-use<br />
* question sets can be used across multiple courses<br />
* questions can be re-ordered within an activity<br />
* question sets can be combined to create a questionnaire<br />
<br />
==Uncategorised requested features==<br />
*handle more than one view_single/view_list/find/input layout (and allow this or that layout to users on the basis of capabilities).<br />
<br />
The idea is: On the basis of capability you will access your specific layout with only a field subset.<br />
If you have this capability, you will find all the fields of the survey, otherwise you will find only a subset of them.<br />
<br />
The same feature may be provided in the following way:<br />
At fields level definition the course creator should be allowed to mark the field "field1" as<br />
#visible and enabled to all<br />
#visible to all but enabled to users with view_field1 capability only<br />
#visible and enabled to users with view_field1 capability only<br />
<br />
*allow update of submitted questionnaire as an option (not just a clean slate on the next go-round)<br />
*allow course creator to add custom number to question inside layouts (i.e.: 1, 2, 2a, 2b, 3...) to respect questions hierarchy<br />
*allow course creator to indent questions inside layouts to respect questions hierarchy (as it is already possible the indent of resources inside courses)<br />
*conditional branching (see next example)<br />
(Example:<br />
<br />
1. Gender: <code><input type="radio" name="gender" value="0" checked="checked"/></code>F <code><input type="radio" name="gender" value="1" /></code>M<br />
1a. How many pregnancies have you had? <code><select><option value="0" selected="selected">0</option><option value="1">1</option><option value="2">2</option><option value="more">more</option></select></code> (should be disabled when answer 1 == F)<br />
1b. Question relevant only for males? <code><select disabled="disabled"><option value="aa" selected="selected">aa</option><option value="bb">bb</option><option value="cc">cc</option><option value="more">other</option></select></code> (should be disabled when answer 1 == M)<br />
)</div>Bobpufferhttps://docs.moodle.org/38/en/index.php?title=Development:Survey_2_brainstorm&diff=81947Development:Survey 2 brainstorm2011-03-15T13:12:59Z<p>Bobpuffer: /* Question management */</p>
<hr />
<div>This page is for collecting feature requests for a new Survey module that replaces Survey, Questionnaire and Feedback.<br />
<br />
==Module settings page==<br />
*option: allow/deny save without submission<br />
*option: anonymous survey or named responses<br />
*option: allow/deny record modification after submission<br />
*option: allow/deny the read only access to submitted records (see next example)<br />
(Example: This option should appear like:<br />
<code><br />
<div>Submitted answers are available/visible <select name="dropdown_7" size="1"><br />
<option value="0">to all users</option><br />
<option value="1" >to submitter only</option><br />
<option value="2" >to submitter group only</option><br />
</select></div><br />
</code><br />
)<br />
*option: allow/deny submitted record deletion<br />
*custom form and css<br />
*download of submitted records in some standard format<br />
* option: allow access to results any time/after you've submitted/after close date/never<br />
** fine-grain control for result display at question level also<br />
*type of field (char(n), text, number, alphanumeric, boolean, date, picture, file, email, url...) with type check at submit time (and number of digit check for char(n) fields).<br />
<br />
This information may not be used at field definition time but is useful for data verification/check. (see next example)<br />
<br />
(Example:<br />
Please, enter your card ID: _______<br />
This field should be defined, for instance, as char(7))<br />
*opening and closing submission dates (displayed on calendar)<br />
*relations between tables<br />
(Example:<br />
one record for the profile of my company<br />
one related record for each intervention request submitted by my company)<br />
<br />
=== Standard module settings ===<br />
<br />
* support for groups and groupings<br />
* permission control for which roles can create surveys<br />
<br />
==Field level settings==<br />
*mandatory/non mandatory field option<br />
*free text description field for further description and advice to the completer<br />
*define a range of valid answers for fields allowing this (see next examples)<br />
(Example 1:<br />
Please, enter your seniority. (limited between 0 and 50 years)<br />
<br />
Example 2:<br />
Date of birth: (limited between 18 and 100 years ago))<br />
*define fields default to be loaded at "new record" display time<br />
*optional "other" text field for drop down menu/radio button/check box. (see next example)<br />
(Example for drop down:<br />
<br />
Where were you born? <code><select name="dropdown_14" size="1"><option value="1" selected="selected">Spain</option><option value="2" >France</option><option value="3" >other, please specify</option></select> <input type="text" name="dropdown_14_other" size="10" maxlength="10" value="" /></code><br />
<br />
If you choose "other" in the drop down menu the field will be enabled and become mandatory, otherwise it will be disabled.<br />
)<br />
*define read-only fields (auto filled by the software) like, current_date, user_name, record_ID...<br />
* option: allow access to results any time/after you've submitted/after close date/never<br />
<br />
==Fields types==<br />
<br />
Field types should be plug-ins so that they can be extended locally if required. The following list covers types which exist in at least one of the current survey modules.<br />
<br />
* radio buttons<br />
** horizontal & vertical<br />
* short text entry<br />
* long text entry<br />
* allocation<br />
* checkbox<br />
* customisable likert scale for rating<br />
* ranking<br />
<br />
<br />
===New field types===<br />
*short date (with month and years only, to answer question like: When had you the first evidence of this disease?)<br />
*order list. A list of available items and the answer is supposed to order them.<br />
*time (see next example)<br />
<br />
(Example:<br />
When do you usually take breakfast?<br />
)<br />
<br />
==Result display==<br />
<br />
* choose for a question whether to display results as<br />
** a table<br />
** a bar chart<br />
** a pie chart<br />
<br />
==Question management==<br />
<br />
* questions can be copied within an activity<br />
* question sets can be created as templates for re-use<br />
* question sets can be used across multiple courses<br />
* questions can be re-ordered within an activity<br />
* question sets can be combined to create a questionnaire<br />
<br />
==Uncategorised requested features==<br />
*handle more than one view_single/view_list/find/input layout (and allow this or that layout to users on the basis of capabilities).<br />
<br />
The idea is: On the basis of capability you will access your specific layout with only a field subset.<br />
If you have this capability, you will find all the fields of the survey, otherwise you will find only a subset of them.<br />
<br />
The same feature may be provided in the following way:<br />
At fields level definition the course creator should be allowed to mark the field "field1" as<br />
#visible and enabled to all<br />
#visible to all but enabled to users with view_field1 capability only<br />
#visible and enabled to users with view_field1 capability only<br />
<br />
*allow course creator to add custom number to question inside layouts (i.e.: 1, 2, 2a, 2b, 3...) to respect questions hierarchy<br />
*allow course creator to indent questions inside layouts to respect questions hierarchy (as it is already possible the indent of resources inside courses)<br />
*conditional branching (see next example)<br />
(Example:<br />
<br />
1. Gender: <code><input type="radio" name="gender" value="0" checked="checked"/></code>F <code><input type="radio" name="gender" value="1" /></code>M<br />
1a. How many pregnancies have you had? <code><select><option value="0" selected="selected">0</option><option value="1">1</option><option value="2">2</option><option value="more">more</option></select></code> (should be disabled when answer 1 == F)<br />
1b. Question relevant only for males? <code><select disabled="disabled"><option value="aa" selected="selected">aa</option><option value="bb">bb</option><option value="cc">cc</option><option value="more">other</option></select></code> (should be disabled when answer 1 == M)<br />
)</div>Bobpufferhttps://docs.moodle.org/38/en/index.php?title=LAEGrader_report&diff=75205LAEGrader report2010-08-27T20:24:04Z<p>Bobpuffer: /* Categorising the grades */</p>
<hr />
<div>{{Grades}}The LAEgrader report page is an alternative main teacher view of the gradebook in Moodle 1.9. LAEgrader is not designed for versions prior to 1.9.<br />
<br />
If installed, the report can be seen in [[Course administration block|Course administration]]>Grades.<br />
<br />
=LAEgrader Report Overview=<br />
The LAEgrader report takes the place of the Grader report as the grades repository interface for the instructor for the course. It is based off from, and shares many library functions and classes with the Grader report. Therefore, the Grader report directory on your Moodle installation cannot be removed. The most notable difference between the LAEgrader and Grader is that the LAEgrader freezes both the column headers (grade item titles) and the student rows, while still allowing the user to scroll vertically and horizontally.<br />
<br />
=LAEgrader Report Installation=<br />
* Download the LAEgrader report from CVS or the [http://moodle.org/mod/data/view.php?d=13&rid=4026&filter=1 Moodle Modules and Plugins page].<br />
* (If zipped) unzip the contents of the zip file.<br />
* Place all contents in the grade/report directory of your Moodle installation (you should then have a grade/report/laegrader directory)<br />
* Under [[Site administration block]] run [[Notifications]].<br />
* Check to see that your permissions for your various roles are as you desire. It is recommended that access to the regular Grader report be set to "Prohibit" to avoid confusion. Basic steps:<br />
# Site Administration block->Users->Permissions->Define Roles<br />
# With each role (likely only editingteacher and teacher, unless you've cloned some)<br />
<br />
::* edit the role<br />
::* change the gradereport/grader:view capabilities to "prohibit"<br />
::* Save the permission changes<br />
<br />
:The admin will always see both reports. There is one caveat to the above mentioned exercise... hardcoding outside the plugin branches causes the default grade report to search:<br />
<br />
:# first for the last report the user used<br />
:# then for a report called "grader" if present and accessible for this role<br />
:# then for a report called "user" if present, blah, blah, blah<br />
:# then alphabetically<br />
<br />
=User Configurable settings=<br />
* "gradeeditalways" mode removes the edit button and always displays the report ready for editing of grades (see below). <br />
* Height in pixels of scrollable portion of LAE grader report (300,340,380,420,460).<br />
* Accurate points calculation on or off (see below).<br />
<br />
The defaults for these options can be set at site level by going to Administration->Grades->[[Gradebook_report_settings|Report settings]]->LAE grader report.<br />
<br />
=Display=<br />
==Layout==<br />
[[Image:laegrader_normal_mode.png|right|thumb|LAE Grader report in non-editing mode]]<br />
Along the top is one row containing all grade items interspersed with a category items (if previous grade items are categorized). The last column is always the Course Total. All items contained in a category and the category total column are background color-coded the same (alternating light-red/light-blue). Items not contained in a category have a background of white as does the Course Total. If your gradebook exceeds 95% of the width of the document page, a horizontal scrollbar will be applied at the bottom. If the height of the number of student rows to display exceeds the user-configurable height (default: 360) a vertical scrollbar will be displayed. Whenever the grades are scrolled, either horizontally or vertically, the grade item titles )and optionally, range and average rows) will remain fixed as will the student columns (including "id", if displayed).<br />
<br />
===Other layout options===<br />
<br />
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.<br />
<br />
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.<br />
<br />
==Other Layout Differences From Grader Report==<br />
* LAEgrader does not collapse or expand categories.<br />
* LAEgrader allows wrapping of grade item and grade category names (at approximately 30 characters) to avoid excessively wide reports<br />
* You can add rows showing the range of possible scores and/or averages by going to [[Grade_preferences|My report preferences]] and selecting '''Show ranges''' or selecting '''Show averages'''. Unlike the Grader report, these rows are placed at the top and are frozen along with the grade item titles row so the user never loses sight of them.<br />
* Aggregation column (category or course) is always after the contained items or subcategories. This is not configurable.<br />
* The number of students per page is always unlimited.<br />
* The LAE grader report always makes it easy to know which student and which gradeitem is being viewed or edited and therefore selecting of whole rows or columns is disabled.<br />
* There are no longer any mouseover tooltips reminding you what student and what grade on which you're operating.<br />
<br />
=Functionality Enhancements=<br />
==Letter and Percentage Input==<br />
Whenever the user is editing grades they have the option of inputting a "real" number, a letter grade or a percentage grade. A letter will be compared against the letter grade setup for the course (configurable [[Grade letters]]) and will be converted to 1 point less than the maximum available for that letter grade. Percentage grades will be converted to the input percentage times the maximum grade earnable for that item.<br />
<br />
=="Edit Always" mode==<br />
When "gradeeditalways" preference has been selected by the user, the "Turn editing on/off" button does not appear. All grades are shown with their respective displaytypes (Real, Letter, Percentage) but are editable, unless locked. In the case where multiple displaytypes are formatted for grade column(s), (i.e., Real/Percentage) the first type will be the display format used. Grade column "locks" are provided at the top of each editable column of grades, clicked to insure that final grades in that column are not accidentally "re-edited".<br />
<br />
=="Copy to Excel" button==<br />
A button is provided above the student names column to allow quick "dumps" of LAE grader report contents. The data is exported "as seen" on the LAE grader report with all displaytypes as formatted on the screen. In the case where multiple displaytypes are formatted for grade column(s), (i.e., Real/Percentage) the first type will be the export format used. This quick export includes a row containing maximum point earnable for each grade item/category column. Grades displayed as percentages are exported as decimal equivalents.<br />
<br />
==Accurate Points Calculation==<br />
The Moodle core gradebook stores "real" grades to the grades table. "Real" is most often the number of points earned when applied to individual grade items. The total points for all grade items contained in a grade category is not automatically maintained unless "Sum of Grades" aggregation method is used. If other aggregation methods other than "Sum" are used and the category total is not manually adjusted to reflect the total points, usually the total points (or "real" grade) shown for a category is 100. This confuses many who expect "real" to be the actual total (earned and earnable, in the case of "range"). Setting "Accurate points calculation" triggers calculations in the LAE grader report so all "real" values reported are the actual sum of points for grade items making them up. This setting does not change what is stored in the grades table. You can toggle between "Accurate points" and Moodle's default with no problems. NOTE: to maintain the enhancements inside the report "plugin" the accurately calculated points for categories will not be reflected in the Categories and Items screen.<br />
<br />
<br />
*Examples<br />
<br />
{| style="width:75%; border="0" align="center" <br />
|[[Image:Grade Report unsorted column1.png|frame|center|Unsorted]]<br />
||[[Image:Grade Report sorted column2.png|frame|center|Sorted]]<br />
||[[Image:Grade Report unsorted name1.png|frame|center|Unsorted]]<br />
||[[Image:Grade Report sorted lastname3.png|frame|center|Sorted ]] <br />
|-<br />
|}<br />
<br />
<br />
<br />
<br />
<br />
=Editing=<br />
[[Image:laegrader_edit_mode.png|right|thumb|Grader report in editing mode]]<br />
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.<br />
<br />
==Altering the grades==<br />
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.<br />
<br />
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.<br />
<br />
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]]".<br />
<br />
==The significance of altering the grades in this screen==<br />
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.<br />
<br />
==Calculating totals==<br />
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.<br />
<br />
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.<br />
<br />
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.<br />
<br />
==Hiding columns or individual grades==<br />
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]].<br />
<br />
==Recalculating==<br />
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.<br />
<br />
==Changing the Order of Assignments within Categories==<br />
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.<br />
<br />
===Move an individual Grade item or Grade Category===<br />
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.<br />
<br />
===Move a number of Grade items simultaneously===<br />
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.<br />
<br />
===Other ways of moving grade items===<br />
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.<br />
<br />
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.<br />
<br />
==See also==<br />
*[[Edit grade calculation]]<br />
*[[Grade preferences]]<br />
*[http://www.youtube.com/watch?v=EB58W3KePBc Video showing the basic gradebook setup and use]<br />
*[http://www.youtube.com/watch?v=jWPUEqdhI4A Video showing how to change the display of grades in the gradebook]<br />
*[http://www.youtube.com/watch?v=5hrLNbifiGQ Video explaining the different gradebook reports]<br />
<br />
Using Moodle forum discussions:<br />
*[http://moodle.org/mod/forum/discuss.php?d=153718 Initial announcement and discussion on LAEgrader report]<br />
<br />
[[Category:Contributed code]]</div>Bobpufferhttps://docs.moodle.org/38/en/index.php?title=LAEGrader_report&diff=75204LAEGrader report2010-08-27T20:23:43Z<p>Bobpuffer: /* Highlighting scores that are either adequate or unacceptable in red and green */</p>
<hr />
<div>{{Grades}}The LAEgrader report page is an alternative main teacher view of the gradebook in Moodle 1.9. LAEgrader is not designed for versions prior to 1.9.<br />
<br />
If installed, the report can be seen in [[Course administration block|Course administration]]>Grades.<br />
<br />
=LAEgrader Report Overview=<br />
The LAEgrader report takes the place of the Grader report as the grades repository interface for the instructor for the course. It is based off from, and shares many library functions and classes with the Grader report. Therefore, the Grader report directory on your Moodle installation cannot be removed. The most notable difference between the LAEgrader and Grader is that the LAEgrader freezes both the column headers (grade item titles) and the student rows, while still allowing the user to scroll vertically and horizontally.<br />
<br />
=LAEgrader Report Installation=<br />
* Download the LAEgrader report from CVS or the [http://moodle.org/mod/data/view.php?d=13&rid=4026&filter=1 Moodle Modules and Plugins page].<br />
* (If zipped) unzip the contents of the zip file.<br />
* Place all contents in the grade/report directory of your Moodle installation (you should then have a grade/report/laegrader directory)<br />
* Under [[Site administration block]] run [[Notifications]].<br />
* Check to see that your permissions for your various roles are as you desire. It is recommended that access to the regular Grader report be set to "Prohibit" to avoid confusion. Basic steps:<br />
# Site Administration block->Users->Permissions->Define Roles<br />
# With each role (likely only editingteacher and teacher, unless you've cloned some)<br />
<br />
::* edit the role<br />
::* change the gradereport/grader:view capabilities to "prohibit"<br />
::* Save the permission changes<br />
<br />
:The admin will always see both reports. There is one caveat to the above mentioned exercise... hardcoding outside the plugin branches causes the default grade report to search:<br />
<br />
:# first for the last report the user used<br />
:# then for a report called "grader" if present and accessible for this role<br />
:# then for a report called "user" if present, blah, blah, blah<br />
:# then alphabetically<br />
<br />
=User Configurable settings=<br />
* "gradeeditalways" mode removes the edit button and always displays the report ready for editing of grades (see below). <br />
* Height in pixels of scrollable portion of LAE grader report (300,340,380,420,460).<br />
* Accurate points calculation on or off (see below).<br />
<br />
The defaults for these options can be set at site level by going to Administration->Grades->[[Gradebook_report_settings|Report settings]]->LAE grader report.<br />
<br />
=Display=<br />
==Layout==<br />
[[Image:laegrader_normal_mode.png|right|thumb|LAE Grader report in non-editing mode]]<br />
Along the top is one row containing all grade items interspersed with a category items (if previous grade items are categorized). The last column is always the Course Total. All items contained in a category and the category total column are background color-coded the same (alternating light-red/light-blue). Items not contained in a category have a background of white as does the Course Total. If your gradebook exceeds 95% of the width of the document page, a horizontal scrollbar will be applied at the bottom. If the height of the number of student rows to display exceeds the user-configurable height (default: 360) a vertical scrollbar will be displayed. Whenever the grades are scrolled, either horizontally or vertically, the grade item titles )and optionally, range and average rows) will remain fixed as will the student columns (including "id", if displayed).<br />
<br />
===Other layout options===<br />
<br />
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.<br />
<br />
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.<br />
<br />
==Other Layout Differences From Grader Report==<br />
* LAEgrader does not collapse or expand categories.<br />
* LAEgrader allows wrapping of grade item and grade category names (at approximately 30 characters) to avoid excessively wide reports<br />
* You can add rows showing the range of possible scores and/or averages by going to [[Grade_preferences|My report preferences]] and selecting '''Show ranges''' or selecting '''Show averages'''. Unlike the Grader report, these rows are placed at the top and are frozen along with the grade item titles row so the user never loses sight of them.<br />
* Aggregation column (category or course) is always after the contained items or subcategories. This is not configurable.<br />
* The number of students per page is always unlimited.<br />
* The LAE grader report always makes it easy to know which student and which gradeitem is being viewed or edited and therefore selecting of whole rows or columns is disabled.<br />
* There are no longer any mouseover tooltips reminding you what student and what grade on which you're operating.<br />
<br />
=Functionality Enhancements=<br />
==Letter and Percentage Input==<br />
Whenever the user is editing grades they have the option of inputting a "real" number, a letter grade or a percentage grade. A letter will be compared against the letter grade setup for the course (configurable [[Grade letters]]) and will be converted to 1 point less than the maximum available for that letter grade. Percentage grades will be converted to the input percentage times the maximum grade earnable for that item.<br />
<br />
=="Edit Always" mode==<br />
When "gradeeditalways" preference has been selected by the user, the "Turn editing on/off" button does not appear. All grades are shown with their respective displaytypes (Real, Letter, Percentage) but are editable, unless locked. In the case where multiple displaytypes are formatted for grade column(s), (i.e., Real/Percentage) the first type will be the display format used. Grade column "locks" are provided at the top of each editable column of grades, clicked to insure that final grades in that column are not accidentally "re-edited".<br />
<br />
=="Copy to Excel" button==<br />
A button is provided above the student names column to allow quick "dumps" of LAE grader report contents. The data is exported "as seen" on the LAE grader report with all displaytypes as formatted on the screen. In the case where multiple displaytypes are formatted for grade column(s), (i.e., Real/Percentage) the first type will be the export format used. This quick export includes a row containing maximum point earnable for each grade item/category column. Grades displayed as percentages are exported as decimal equivalents.<br />
<br />
==Accurate Points Calculation==<br />
The Moodle core gradebook stores "real" grades to the grades table. "Real" is most often the number of points earned when applied to individual grade items. The total points for all grade items contained in a grade category is not automatically maintained unless "Sum of Grades" aggregation method is used. If other aggregation methods other than "Sum" are used and the category total is not manually adjusted to reflect the total points, usually the total points (or "real" grade) shown for a category is 100. This confuses many who expect "real" to be the actual total (earned and earnable, in the case of "range"). Setting "Accurate points calculation" triggers calculations in the LAE grader report so all "real" values reported are the actual sum of points for grade items making them up. This setting does not change what is stored in the grades table. You can toggle between "Accurate points" and Moodle's default with no problems. NOTE: to maintain the enhancements inside the report "plugin" the accurately calculated points for categories will not be reflected in the Categories and Items screen.<br />
<br />
<br />
*Examples<br />
<br />
{| style="width:75%; border="0" align="center" <br />
|[[Image:Grade Report unsorted column1.png|frame|center|Unsorted]]<br />
||[[Image:Grade Report sorted column2.png|frame|center|Sorted]]<br />
||[[Image:Grade Report unsorted name1.png|frame|center|Unsorted]]<br />
||[[Image:Grade Report sorted lastname3.png|frame|center|Sorted ]] <br />
|-<br />
|}<br />
<br />
<br />
<br />
==Categorising the grades==<br />
The 'Choose an action...' drop down on the upper left will let you switch to other views<br />
* '''Edit categories and items''' will allow you to set up your assessments in different categories e.g. 'classwork', 'homework' etc. <br />
<br />
Each category will then have its own '''Category total''' column.<br />
<br />
=Editing=<br />
[[Image:laegrader_edit_mode.png|right|thumb|Grader report in editing mode]]<br />
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.<br />
<br />
==Altering the grades==<br />
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.<br />
<br />
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.<br />
<br />
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]]".<br />
<br />
==The significance of altering the grades in this screen==<br />
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.<br />
<br />
==Calculating totals==<br />
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.<br />
<br />
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.<br />
<br />
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.<br />
<br />
==Hiding columns or individual grades==<br />
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]].<br />
<br />
==Recalculating==<br />
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.<br />
<br />
==Changing the Order of Assignments within Categories==<br />
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.<br />
<br />
===Move an individual Grade item or Grade Category===<br />
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.<br />
<br />
===Move a number of Grade items simultaneously===<br />
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.<br />
<br />
===Other ways of moving grade items===<br />
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.<br />
<br />
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.<br />
<br />
==See also==<br />
*[[Edit grade calculation]]<br />
*[[Grade preferences]]<br />
*[http://www.youtube.com/watch?v=EB58W3KePBc Video showing the basic gradebook setup and use]<br />
*[http://www.youtube.com/watch?v=jWPUEqdhI4A Video showing how to change the display of grades in the gradebook]<br />
*[http://www.youtube.com/watch?v=5hrLNbifiGQ Video explaining the different gradebook reports]<br />
<br />
Using Moodle forum discussions:<br />
*[http://moodle.org/mod/forum/discuss.php?d=153718 Initial announcement and discussion on LAEgrader report]<br />
<br />
[[Category:Contributed code]]</div>Bobpufferhttps://docs.moodle.org/38/en/index.php?title=LAEGrader_report&diff=74951LAEGrader report2010-08-19T20:51:52Z<p>Bobpuffer: /* LAEgrader Report Installation */</p>
<hr />
<div>{{Grades}}The LAEgrader report page is an alternative main teacher view of the gradebook in Moodle 1.9. LAEgrader is not designed for versions prior to 1.9.<br />
<br />
If installed, the report can be seen in [[Course administration block|Course administration]]>Grades.<br />
<br />
=LAEgrader Report Overview=<br />
The LAEgrader report takes the place of the Grader report as the grades repository interface for the instructor for the course. It is based off from, and shares many library functions and classes with the Grader report. Therefore, the Grader report directory on your Moodle installation cannot be removed. The most notable difference between the LAEgrader and Grader is that the LAEgrader freezes both the column headers (grade item titles) and the student rows, while still allowing the user to scroll vertically and horizontally.<br />
<br />
=LAEgrader Report Installation=<br />
* Download the LAEgrader report from CVS or the [http://moodle.org/mod/data/view.php?d=13&rid=4026&filter=1 Moodle Modules and Plugins page].<br />
* (If zipped) unzip the contents of the zip file.<br />
* Place all contents in the grade/report directory of your Moodle installation (you should then have a grade/report/laegrader directory)<br />
* Under [[Site administration block]] run [[Notifications]].<br />
* Check to see that your permissions for your various roles are as you desire. It is recommended that access to the regular Grader report be set to "Prohibit" to avoid confusion. Basic steps:<br />
# Site Administration block->Users->Permissions->Define Roles<br />
# With each role (likely only editingteacher and teacher, unless you've cloned some)<br />
<br />
::* edit the role<br />
::* change the gradereport/grader:view capabilities to "prohibit"<br />
::* Save the permission changes<br />
<br />
:The admin will always see both reports. There is one caveat to the above mentioned exercise... hardcoding outside the plugin branches causes the default grade report to search:<br />
<br />
:# first for the last report the user used<br />
:# then for a report called "grader" if present and accessible for this role<br />
:# then for a report called "user" if present, blah, blah, blah<br />
:# then alphabetically<br />
<br />
=User Configurable settings=<br />
* "gradeeditalways" mode removes the edit button and always displays the report ready for editing of grades (see below). <br />
* Height in pixels of scrollable portion of LAE grader report (300,340,380,420,460).<br />
* Accurate points calculation on or off (see below).<br />
<br />
The defaults for these options can be set at site level by going to Administration->Grades->[[Gradebook_report_settings|Report settings]]->LAE grader report.<br />
<br />
=Display=<br />
==Layout==<br />
[[Image:laegrader_normal_mode.png|right|thumb|LAE Grader report in non-editing mode]]<br />
Along the top is one row containing all grade items interspersed with a category items (if previous grade items are categorized). The last column is always the Course Total. All items contained in a category and the category total column are background color-coded the same (alternating light-red/light-blue). Items not contained in a category have a background of white as does the Course Total. If your gradebook exceeds 95% of the width of the document page, a horizontal scrollbar will be applied at the bottom. If the height of the number of student rows to display exceeds the user-configurable height (default: 360) a vertical scrollbar will be displayed. Whenever the grades are scrolled, either horizontally or vertically, the grade item titles )and optionally, range and average rows) will remain fixed as will the student columns (including "id", if displayed).<br />
<br />
===Other layout options===<br />
<br />
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.<br />
<br />
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.<br />
<br />
==Other Layout Differences From Grader Report==<br />
* LAEgrader does not collapse or expand categories.<br />
* LAEgrader allows wrapping of grade item and grade category names (at approximately 30 characters) to avoid excessively wide reports<br />
* You can add rows showing the range of possible scores and/or averages by going to [[Grade_preferences|My report preferences]] and selecting '''Show ranges''' or selecting '''Show averages'''. Unlike the Grader report, these rows are placed at the top and are frozen along with the grade item titles row so the user never loses sight of them.<br />
* Aggregation column (category or course) is always after the contained items or subcategories. This is not configurable.<br />
* The number of students per page is always unlimited.<br />
* The LAE grader report always makes it easy to know which student and which gradeitem is being viewed or edited and therefore selecting of whole rows or columns is disabled.<br />
* There are no longer any mouseover tooltips reminding you what student and what grade on which you're operating.<br />
<br />
=Functionality Enhancements=<br />
==Letter and Percentage Input==<br />
Whenever the user is editing grades they have the option of inputting a "real" number, a letter grade or a percentage grade. A letter will be compared against the letter grade setup for the course (configurable [[Grade letters]]) and will be converted to 1 point less than the maximum available for that letter grade. Percentage grades will be converted to the input percentage times the maximum grade earnable for that item.<br />
<br />
=="Edit Always" mode==<br />
When "gradeeditalways" preference has been selected by the user, the "Turn editing on/off" button does not appear. All grades are shown with their respective displaytypes (Real, Letter, Percentage) but are editable, unless locked. In the case where multiple displaytypes are formatted for grade column(s), (i.e., Real/Percentage) the first type will be the display format used. Grade column "locks" are provided at the top of each editable column of grades, clicked to insure that final grades in that column are not accidentally "re-edited".<br />
<br />
=="Copy to Excel" button==<br />
A button is provided above the student names column to allow quick "dumps" of LAE grader report contents. The data is exported "as seen" on the LAE grader report with all displaytypes as formatted on the screen. In the case where multiple displaytypes are formatted for grade column(s), (i.e., Real/Percentage) the first type will be the export format used. This quick export includes a row containing maximum point earnable for each grade item/category column. Grades displayed as percentages are exported as decimal equivalents.<br />
<br />
==Accurate Points Calculation==<br />
The Moodle core gradebook stores "real" grades to the grades table. "Real" is most often the number of points earned when applied to individual grade items. The total points for all grade items contained in a grade category is not automatically maintained unless "Sum of Grades" aggregation method is used. If other aggregation methods other than "Sum" are used and the category total is not manually adjusted to reflect the total points, usually the total points (or "real" grade) shown for a category is 100. This confuses many who expect "real" to be the actual total (earned and earnable, in the case of "range"). Setting "Accurate points calculation" triggers calculations in the LAE grader report so all "real" values reported are the actual sum of points for grade items making them up. This setting does not change what is stored in the grades table. You can toggle between "Accurate points" and Moodle's default with no problems. NOTE: to maintain the enhancements inside the report "plugin" the accurately calculated points for categories will not be reflected in the Categories and Items screen.<br />
<br />
<br />
*Examples<br />
<br />
{| style="width:75%; border="0" align="center" <br />
|[[Image:Grade Report unsorted column1.png|frame|center|Unsorted]]<br />
||[[Image:Grade Report sorted column2.png|frame|center|Sorted]]<br />
||[[Image:Grade Report unsorted name1.png|frame|center|Unsorted]]<br />
||[[Image:Grade Report sorted lastname3.png|frame|center|Sorted ]] <br />
|-<br />
|}<br />
<br />
==Highlighting scores that are either adequate or unacceptable in red and green==<br />
<br />
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.<br />
<br />
Note that the highlighting will not show if the LAE Grader report is viewed in the editing mode.<br />
<br />
==Categorising the grades==<br />
The 'Choose an action...' drop down on the upper left will let you switch to other views<br />
* '''Edit categories and items''' will allow you to set up your assessments in different categories e.g. 'classwork', 'homework' etc. <br />
<br />
Each category will then have its own '''Category total''' column.<br />
<br />
=Editing=<br />
[[Image:laegrader_edit_mode.png|right|thumb|Grader report in editing mode]]<br />
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.<br />
<br />
==Altering the grades==<br />
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.<br />
<br />
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.<br />
<br />
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]]".<br />
<br />
==The significance of altering the grades in this screen==<br />
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.<br />
<br />
==Calculating totals==<br />
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.<br />
<br />
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.<br />
<br />
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.<br />
<br />
==Hiding columns or individual grades==<br />
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]].<br />
<br />
==Recalculating==<br />
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.<br />
<br />
==Changing the Order of Assignments within Categories==<br />
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.<br />
<br />
===Move an individual Grade item or Grade Category===<br />
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.<br />
<br />
===Move a number of Grade items simultaneously===<br />
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.<br />
<br />
===Other ways of moving grade items===<br />
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.<br />
<br />
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.<br />
<br />
==See also==<br />
*[[Edit grade calculation]]<br />
*[[Grade preferences]]<br />
*[http://www.youtube.com/watch?v=EB58W3KePBc Video showing the basic gradebook setup and use]<br />
*[http://www.youtube.com/watch?v=jWPUEqdhI4A Video showing how to change the display of grades in the gradebook]<br />
*[http://www.youtube.com/watch?v=5hrLNbifiGQ Video explaining the different gradebook reports]<br />
<br />
Using Moodle forum discussions:<br />
*[http://moodle.org/mod/forum/discuss.php?d=153718 Initial announcement and discussion on LAEgrader report]<br />
<br />
[[Category:Contributed code]]</div>Bobpufferhttps://docs.moodle.org/38/en/index.php?title=LAEGrader_report&diff=74950LAEGrader report2010-08-19T20:51:07Z<p>Bobpuffer: /* LAEgrader Report Installation */</p>
<hr />
<div>{{Grades}}The LAEgrader report page is an alternative main teacher view of the gradebook in Moodle 1.9. LAEgrader is not designed for versions prior to 1.9.<br />
<br />
If installed, the report can be seen in [[Course administration block|Course administration]]>Grades.<br />
<br />
=LAEgrader Report Overview=<br />
The LAEgrader report takes the place of the Grader report as the grades repository interface for the instructor for the course. It is based off from, and shares many library functions and classes with the Grader report. Therefore, the Grader report directory on your Moodle installation cannot be removed. The most notable difference between the LAEgrader and Grader is that the LAEgrader freezes both the column headers (grade item titles) and the student rows, while still allowing the user to scroll vertically and horizontally.<br />
<br />
=LAEgrader Report Installation=<br />
* Download the LAEgrader report from CVS or the [http://moodle.org/mod/data/view.php?d=13&rid=4026&filter=1 Moodle Modules and Plugins page].<br />
* (If zipped) unzip the contents of the zip file.<br />
* Place all contents in the grade/report directory of your Moodle installation (you should then have a grade/report/laegrader directory)<br />
* Under [[Site administration block]] run [[Notifications]].<br />
* Check to see that your permissions for your various roles are as you desire. It is recommended that access to the regular Grader report be set to "Prohibit" to avoid confusion. Basic steps:<br />
# Site Administration block->Users->Permissions->Define Roles<br />
# With each role (likely only editingteacher and teacher, unless you've cloned some)<br />
<br />
::* edit the role<br />
::* change the gradereport/grader:view capabilities to "prohibit"<br />
::* Save the permission changes<br />
<br />
The admin will always see both reports. There is one caveat to the above mentioned exercise... hardcoding outside the plugin branches causes the default grade report to search:<br />
<br />
# first for the last report the user used<br />
# then for a report called "grader" if present and accessible for this role<br />
# then for a report called "user" if present, blah, blah, blah<br />
# then alphabetically<br />
<br />
=User Configurable settings=<br />
* "gradeeditalways" mode removes the edit button and always displays the report ready for editing of grades (see below). <br />
* Height in pixels of scrollable portion of LAE grader report (300,340,380,420,460).<br />
* Accurate points calculation on or off (see below).<br />
<br />
The defaults for these options can be set at site level by going to Administration->Grades->[[Gradebook_report_settings|Report settings]]->LAE grader report.<br />
<br />
=Display=<br />
==Layout==<br />
[[Image:laegrader_normal_mode.png|right|thumb|LAE Grader report in non-editing mode]]<br />
Along the top is one row containing all grade items interspersed with a category items (if previous grade items are categorized). The last column is always the Course Total. All items contained in a category and the category total column are background color-coded the same (alternating light-red/light-blue). Items not contained in a category have a background of white as does the Course Total. If your gradebook exceeds 95% of the width of the document page, a horizontal scrollbar will be applied at the bottom. If the height of the number of student rows to display exceeds the user-configurable height (default: 360) a vertical scrollbar will be displayed. Whenever the grades are scrolled, either horizontally or vertically, the grade item titles )and optionally, range and average rows) will remain fixed as will the student columns (including "id", if displayed).<br />
<br />
===Other layout options===<br />
<br />
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.<br />
<br />
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.<br />
<br />
==Other Layout Differences From Grader Report==<br />
* LAEgrader does not collapse or expand categories.<br />
* LAEgrader allows wrapping of grade item and grade category names (at approximately 30 characters) to avoid excessively wide reports<br />
* You can add rows showing the range of possible scores and/or averages by going to [[Grade_preferences|My report preferences]] and selecting '''Show ranges''' or selecting '''Show averages'''. Unlike the Grader report, these rows are placed at the top and are frozen along with the grade item titles row so the user never loses sight of them.<br />
* Aggregation column (category or course) is always after the contained items or subcategories. This is not configurable.<br />
* The number of students per page is always unlimited.<br />
* The LAE grader report always makes it easy to know which student and which gradeitem is being viewed or edited and therefore selecting of whole rows or columns is disabled.<br />
* There are no longer any mouseover tooltips reminding you what student and what grade on which you're operating.<br />
<br />
=Functionality Enhancements=<br />
==Letter and Percentage Input==<br />
Whenever the user is editing grades they have the option of inputting a "real" number, a letter grade or a percentage grade. A letter will be compared against the letter grade setup for the course (configurable [[Grade letters]]) and will be converted to 1 point less than the maximum available for that letter grade. Percentage grades will be converted to the input percentage times the maximum grade earnable for that item.<br />
<br />
=="Edit Always" mode==<br />
When "gradeeditalways" preference has been selected by the user, the "Turn editing on/off" button does not appear. All grades are shown with their respective displaytypes (Real, Letter, Percentage) but are editable, unless locked. In the case where multiple displaytypes are formatted for grade column(s), (i.e., Real/Percentage) the first type will be the display format used. Grade column "locks" are provided at the top of each editable column of grades, clicked to insure that final grades in that column are not accidentally "re-edited".<br />
<br />
=="Copy to Excel" button==<br />
A button is provided above the student names column to allow quick "dumps" of LAE grader report contents. The data is exported "as seen" on the LAE grader report with all displaytypes as formatted on the screen. In the case where multiple displaytypes are formatted for grade column(s), (i.e., Real/Percentage) the first type will be the export format used. This quick export includes a row containing maximum point earnable for each grade item/category column. Grades displayed as percentages are exported as decimal equivalents.<br />
<br />
==Accurate Points Calculation==<br />
The Moodle core gradebook stores "real" grades to the grades table. "Real" is most often the number of points earned when applied to individual grade items. The total points for all grade items contained in a grade category is not automatically maintained unless "Sum of Grades" aggregation method is used. If other aggregation methods other than "Sum" are used and the category total is not manually adjusted to reflect the total points, usually the total points (or "real" grade) shown for a category is 100. This confuses many who expect "real" to be the actual total (earned and earnable, in the case of "range"). Setting "Accurate points calculation" triggers calculations in the LAE grader report so all "real" values reported are the actual sum of points for grade items making them up. This setting does not change what is stored in the grades table. You can toggle between "Accurate points" and Moodle's default with no problems. NOTE: to maintain the enhancements inside the report "plugin" the accurately calculated points for categories will not be reflected in the Categories and Items screen.<br />
<br />
<br />
*Examples<br />
<br />
{| style="width:75%; border="0" align="center" <br />
|[[Image:Grade Report unsorted column1.png|frame|center|Unsorted]]<br />
||[[Image:Grade Report sorted column2.png|frame|center|Sorted]]<br />
||[[Image:Grade Report unsorted name1.png|frame|center|Unsorted]]<br />
||[[Image:Grade Report sorted lastname3.png|frame|center|Sorted ]] <br />
|-<br />
|}<br />
<br />
==Highlighting scores that are either adequate or unacceptable in red and green==<br />
<br />
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.<br />
<br />
Note that the highlighting will not show if the LAE Grader report is viewed in the editing mode.<br />
<br />
==Categorising the grades==<br />
The 'Choose an action...' drop down on the upper left will let you switch to other views<br />
* '''Edit categories and items''' will allow you to set up your assessments in different categories e.g. 'classwork', 'homework' etc. <br />
<br />
Each category will then have its own '''Category total''' column.<br />
<br />
=Editing=<br />
[[Image:laegrader_edit_mode.png|right|thumb|Grader report in editing mode]]<br />
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.<br />
<br />
==Altering the grades==<br />
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.<br />
<br />
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.<br />
<br />
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]]".<br />
<br />
==The significance of altering the grades in this screen==<br />
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.<br />
<br />
==Calculating totals==<br />
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.<br />
<br />
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.<br />
<br />
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.<br />
<br />
==Hiding columns or individual grades==<br />
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]].<br />
<br />
==Recalculating==<br />
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.<br />
<br />
==Changing the Order of Assignments within Categories==<br />
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.<br />
<br />
===Move an individual Grade item or Grade Category===<br />
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.<br />
<br />
===Move a number of Grade items simultaneously===<br />
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.<br />
<br />
===Other ways of moving grade items===<br />
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.<br />
<br />
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.<br />
<br />
==See also==<br />
*[[Edit grade calculation]]<br />
*[[Grade preferences]]<br />
*[http://www.youtube.com/watch?v=EB58W3KePBc Video showing the basic gradebook setup and use]<br />
*[http://www.youtube.com/watch?v=jWPUEqdhI4A Video showing how to change the display of grades in the gradebook]<br />
*[http://www.youtube.com/watch?v=5hrLNbifiGQ Video explaining the different gradebook reports]<br />
<br />
Using Moodle forum discussions:<br />
*[http://moodle.org/mod/forum/discuss.php?d=153718 Initial announcement and discussion on LAEgrader report]<br />
<br />
[[Category:Contributed code]]</div>Bobpufferhttps://docs.moodle.org/38/en/index.php?title=LAEGrader_report&diff=74949LAEGrader report2010-08-19T20:48:04Z<p>Bobpuffer: /* LAEgrader Report Installation */</p>
<hr />
<div>{{Grades}}The LAEgrader report page is an alternative main teacher view of the gradebook in Moodle 1.9. LAEgrader is not designed for versions prior to 1.9.<br />
<br />
If installed, the report can be seen in [[Course administration block|Course administration]]>Grades.<br />
<br />
=LAEgrader Report Overview=<br />
The LAEgrader report takes the place of the Grader report as the grades repository interface for the instructor for the course. It is based off from, and shares many library functions and classes with the Grader report. Therefore, the Grader report directory on your Moodle installation cannot be removed. The most notable difference between the LAEgrader and Grader is that the LAEgrader freezes both the column headers (grade item titles) and the student rows, while still allowing the user to scroll vertically and horizontally.<br />
<br />
=LAEgrader Report Installation=<br />
* Download the LAEgrader report from CVS or the [http://moodle.org/mod/data/view.php?d=13&rid=4026&filter=1 Moodle Modules and Plugins page].<br />
* (If zipped) unzip the contents of the zip file.<br />
* Place all contents in the grade/report directory of your Moodle installation (you should then have a grade/report/laegrader directory)<br />
* Under [[Site administration block]] run [[Notifications]].<br />
* Check to see that your permissions for your various roles are as you desire. It is recommended that access to the regular Grader report be set to "Prohibit" to avoid confusion. Basic steps:<br />
;# Site Administration block->Users->Permissions->Define Roles<br />
:# With each role (likely only editingteacher and teacher, unless you've cloned some)<br />
*** edit the role<br />
*** change the gradereport/grader:view capabilities to "prohibit"<br />
*** Save the permission changes<br />
<br />
The admin will always see both reports. There is one caveat to the above mentioned exercise... hardcoding outside the plugin branches causes the default grade report to search:<br />
<br />
# first for the last report the user used<br />
# then for a report called "grader" if present and accessible for this role<br />
# then for a report called "user" if present, blah, blah, blah<br />
# then alphabetically<br />
<br />
=User Configurable settings=<br />
* "gradeeditalways" mode removes the edit button and always displays the report ready for editing of grades (see below). <br />
* Height in pixels of scrollable portion of LAE grader report (300,340,380,420,460).<br />
* Accurate points calculation on or off (see below).<br />
<br />
The defaults for these options can be set at site level by going to Administration->Grades->[[Gradebook_report_settings|Report settings]]->LAE grader report.<br />
<br />
=Display=<br />
==Layout==<br />
[[Image:laegrader_normal_mode.png|right|thumb|LAE Grader report in non-editing mode]]<br />
Along the top is one row containing all grade items interspersed with a category items (if previous grade items are categorized). The last column is always the Course Total. All items contained in a category and the category total column are background color-coded the same (alternating light-red/light-blue). Items not contained in a category have a background of white as does the Course Total. If your gradebook exceeds 95% of the width of the document page, a horizontal scrollbar will be applied at the bottom. If the height of the number of student rows to display exceeds the user-configurable height (default: 360) a vertical scrollbar will be displayed. Whenever the grades are scrolled, either horizontally or vertically, the grade item titles )and optionally, range and average rows) will remain fixed as will the student columns (including "id", if displayed).<br />
<br />
===Other layout options===<br />
<br />
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.<br />
<br />
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.<br />
<br />
==Other Layout Differences From Grader Report==<br />
* LAEgrader does not collapse or expand categories.<br />
* LAEgrader allows wrapping of grade item and grade category names (at approximately 30 characters) to avoid excessively wide reports<br />
* You can add rows showing the range of possible scores and/or averages by going to [[Grade_preferences|My report preferences]] and selecting '''Show ranges''' or selecting '''Show averages'''. Unlike the Grader report, these rows are placed at the top and are frozen along with the grade item titles row so the user never loses sight of them.<br />
* Aggregation column (category or course) is always after the contained items or subcategories. This is not configurable.<br />
* The number of students per page is always unlimited.<br />
* The LAE grader report always makes it easy to know which student and which gradeitem is being viewed or edited and therefore selecting of whole rows or columns is disabled.<br />
* There are no longer any mouseover tooltips reminding you what student and what grade on which you're operating.<br />
<br />
=Functionality Enhancements=<br />
==Letter and Percentage Input==<br />
Whenever the user is editing grades they have the option of inputting a "real" number, a letter grade or a percentage grade. A letter will be compared against the letter grade setup for the course (configurable [[Grade letters]]) and will be converted to 1 point less than the maximum available for that letter grade. Percentage grades will be converted to the input percentage times the maximum grade earnable for that item.<br />
<br />
=="Edit Always" mode==<br />
When "gradeeditalways" preference has been selected by the user, the "Turn editing on/off" button does not appear. All grades are shown with their respective displaytypes (Real, Letter, Percentage) but are editable, unless locked. In the case where multiple displaytypes are formatted for grade column(s), (i.e., Real/Percentage) the first type will be the display format used. Grade column "locks" are provided at the top of each editable column of grades, clicked to insure that final grades in that column are not accidentally "re-edited".<br />
<br />
=="Copy to Excel" button==<br />
A button is provided above the student names column to allow quick "dumps" of LAE grader report contents. The data is exported "as seen" on the LAE grader report with all displaytypes as formatted on the screen. In the case where multiple displaytypes are formatted for grade column(s), (i.e., Real/Percentage) the first type will be the export format used. This quick export includes a row containing maximum point earnable for each grade item/category column. Grades displayed as percentages are exported as decimal equivalents.<br />
<br />
==Accurate Points Calculation==<br />
The Moodle core gradebook stores "real" grades to the grades table. "Real" is most often the number of points earned when applied to individual grade items. The total points for all grade items contained in a grade category is not automatically maintained unless "Sum of Grades" aggregation method is used. If other aggregation methods other than "Sum" are used and the category total is not manually adjusted to reflect the total points, usually the total points (or "real" grade) shown for a category is 100. This confuses many who expect "real" to be the actual total (earned and earnable, in the case of "range"). Setting "Accurate points calculation" triggers calculations in the LAE grader report so all "real" values reported are the actual sum of points for grade items making them up. This setting does not change what is stored in the grades table. You can toggle between "Accurate points" and Moodle's default with no problems. NOTE: to maintain the enhancements inside the report "plugin" the accurately calculated points for categories will not be reflected in the Categories and Items screen.<br />
<br />
<br />
*Examples<br />
<br />
{| style="width:75%; border="0" align="center" <br />
|[[Image:Grade Report unsorted column1.png|frame|center|Unsorted]]<br />
||[[Image:Grade Report sorted column2.png|frame|center|Sorted]]<br />
||[[Image:Grade Report unsorted name1.png|frame|center|Unsorted]]<br />
||[[Image:Grade Report sorted lastname3.png|frame|center|Sorted ]] <br />
|-<br />
|}<br />
<br />
==Highlighting scores that are either adequate or unacceptable in red and green==<br />
<br />
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.<br />
<br />
Note that the highlighting will not show if the LAE Grader report is viewed in the editing mode.<br />
<br />
==Categorising the grades==<br />
The 'Choose an action...' drop down on the upper left will let you switch to other views<br />
* '''Edit categories and items''' will allow you to set up your assessments in different categories e.g. 'classwork', 'homework' etc. <br />
<br />
Each category will then have its own '''Category total''' column.<br />
<br />
=Editing=<br />
[[Image:laegrader_edit_mode.png|right|thumb|Grader report in editing mode]]<br />
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.<br />
<br />
==Altering the grades==<br />
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.<br />
<br />
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.<br />
<br />
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]]".<br />
<br />
==The significance of altering the grades in this screen==<br />
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.<br />
<br />
==Calculating totals==<br />
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.<br />
<br />
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.<br />
<br />
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.<br />
<br />
==Hiding columns or individual grades==<br />
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]].<br />
<br />
==Recalculating==<br />
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.<br />
<br />
==Changing the Order of Assignments within Categories==<br />
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.<br />
<br />
===Move an individual Grade item or Grade Category===<br />
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.<br />
<br />
===Move a number of Grade items simultaneously===<br />
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.<br />
<br />
===Other ways of moving grade items===<br />
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.<br />
<br />
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.<br />
<br />
==See also==<br />
*[[Edit grade calculation]]<br />
*[[Grade preferences]]<br />
*[http://www.youtube.com/watch?v=EB58W3KePBc Video showing the basic gradebook setup and use]<br />
*[http://www.youtube.com/watch?v=jWPUEqdhI4A Video showing how to change the display of grades in the gradebook]<br />
*[http://www.youtube.com/watch?v=5hrLNbifiGQ Video explaining the different gradebook reports]<br />
<br />
Using Moodle forum discussions:<br />
*[http://moodle.org/mod/forum/discuss.php?d=153718 Initial announcement and discussion on LAEgrader report]<br />
<br />
[[Category:Contributed code]]</div>Bobpufferhttps://docs.moodle.org/38/en/index.php?title=grade/report/laegrader/index&diff=74922grade/report/laegrader/index2010-08-18T19:47:28Z<p>Bobpuffer: Redirecting to LAEGrader report</p>
<hr />
<div>#redirect [[LAEGrader report]]</div>Bobpufferhttps://docs.moodle.org/38/en/index.php?title=LAEGrader_report&diff=74872LAEGrader report2010-08-17T20:22:51Z<p>Bobpuffer: /* LAEgrader Report Installation */</p>
<hr />
<div>{{Grades}}The LAEgrader report page is an alternative main teacher view of the gradebook in Moodle 1.9. LAEgrader is not designed for versions prior to 1.9.<br />
<br />
If installed, the report can be seen in [[Course administration block|Course administration]]>Grades.<br />
<br />
=LAEgrader Report Overview=<br />
The LAEgrader report takes the place of the Grader report as the grades repository interface for the instructor for the course. It is based off from, and shares many library functions and classes with the Grader report. Therefore, the Grader report directory on your Moodle installation cannot be removed. The most notable difference between the LAEgrader and Grader is that the LAEgrader freezes both the column headers (grade item titles) and the student rows, while still allowing the user to scroll vertically and horizontally.<br />
<br />
=LAEgrader Report Installation=<br />
* Download the LAEgrader report from CVS or the [http://moodle.org/mod/data/view.php?d=13&rid=4026&filter=1 Moodle Modules and Plugins page].<br />
* (If zipped) unzip the contents of the zip file.<br />
* Place all contents in the grade/report directory of your Moodle installation (you should then have a grade/report/laegrader directory)<br />
* Under [[Site administration block]] run [[Notifications]].<br />
* Check to see that your permissions for your various roles are as you desire. It is recommended that access to the regular Grader report be set to "Prevent" to avoid confusion.<br />
<br />
=User Configurable settings=<br />
* "gradeeditalways" mode removes the edit button and always displays the report ready for editing of grades (see below). <br />
* Height in pixels of scrollable portion of LAE grader report (300,340,380,420,460).<br />
* Accurate points calculation on or off (see below).<br />
<br />
The defaults for these options can be set at site level by going to Administration->Grades->[[Gradebook_report_settings|Report settings]]->LAE grader report.<br />
<br />
=Display=<br />
==Layout==<br />
[[Image:laegrader_normal_mode.png|right|thumb|LAE Grader report in non-editing mode]]<br />
Along the top is one row containing all grade items interspersed with a category items (if previous grade items are categorized). The last column is always the Course Total. All items contained in a category and the category total column are background color-coded the same (alternating light-red/light-blue). Items not contained in a category have a background of white as does the Course Total. If your gradebook exceeds 95% of the width of the document page, a horizontal scrollbar will be applied at the bottom. If the height of the number of student rows to display exceeds the user-configurable height (default: 360) a vertical scrollbar will be displayed. Whenever the grades are scrolled, either horizontally or vertically, the grade item titles )and optionally, range and average rows) will remain fixed as will the student columns (including "id", if displayed).<br />
<br />
===Other layout options===<br />
<br />
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.<br />
<br />
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.<br />
<br />
==Other Layout Differences From Grader Report==<br />
* LAEgrader does not collapse or expand categories.<br />
* LAEgrader allows wrapping of grade item and grade category names (at approximately 30 characters) to avoid excessively wide reports<br />
* You can add rows showing the range of possible scores and/or averages by going to [[Grade_preferences|My report preferences]] and selecting '''Show ranges''' or selecting '''Show averages'''. Unlike the Grader report, these rows are placed at the top and are frozen along with the grade item titles row so the user never loses sight of them.<br />
* Aggregation column (category or course) is always after the contained items or subcategories. This is not configurable.<br />
* The number of students per page is always unlimited.<br />
* The LAE grader report always makes it easy to know which student and which gradeitem is being viewed or edited and therefore selecting of whole rows or columns is disabled.<br />
* There are no longer any mouseover tooltips reminding you what student and what grade on which you're operating.<br />
<br />
=Functionality Enhancements=<br />
==Letter and Percentage Input==<br />
Whenever the user is editing grades they have the option of inputting a "real" number, a letter grade or a percentage grade. A letter will be compared against the letter grade setup for the course (configurable [[Grade letters]]) and will be converted to 1 point less than the maximum available for that letter grade. Percentage grades will be converted to the input percentage times the maximum grade earnable for that item.<br />
<br />
=="Edit Always" mode==<br />
When "gradeeditalways" preference has been selected by the user, the "Turn editing on/off" button does not appear. All grades are shown with their respective displaytypes (Real, Letter, Percentage) but are editable, unless locked. In the case where multiple displaytypes are formatted for grade column(s), (i.e., Real/Percentage) the first type will be the display format used. Grade column "locks" are provided at the top of each editable column of grades, clicked to insure that final grades in that column are not accidentally "re-edited".<br />
<br />
=="Copy to Excel" button==<br />
A button is provided above the student names column to allow quick "dumps" of LAE grader report contents. The data is exported "as seen" on the LAE grader report with all displaytypes as formatted on the screen. In the case where multiple displaytypes are formatted for grade column(s), (i.e., Real/Percentage) the first type will be the export format used. This quick export includes a row containing maximum point earnable for each grade item/category column. Grades displayed as percentages are exported as decimal equivalents.<br />
<br />
==Accurate Points Calculation==<br />
The Moodle core gradebook stores "real" grades to the grades table. "Real" is most often the number of points earned when applied to individual grade items. The total points for all grade items contained in a grade category is not automatically maintained unless "Sum of Grades" aggregation method is used. If other aggregation methods other than "Sum" are used and the category total is not manually adjusted to reflect the total points, usually the total points (or "real" grade) shown for a category is 100. This confuses many who expect "real" to be the actual total (earned and earnable, in the case of "range"). Setting "Accurate points calculation" triggers calculations in the LAE grader report so all "real" values reported are the actual sum of points for grade items making them up. This setting does not change what is stored in the grades table. You can toggle between "Accurate points" and Moodle's default with no problems. NOTE: to maintain the enhancements inside the report "plugin" the accurately calculated points for categories will not be reflected in the Categories and Items screen.<br />
<br />
<br />
*Examples<br />
<br />
{| style="width:75%; border="0" align="center" <br />
|[[Image:Grade Report unsorted column1.png|frame|center|Unsorted]]<br />
||[[Image:Grade Report sorted column2.png|frame|center|Sorted]]<br />
||[[Image:Grade Report unsorted name1.png|frame|center|Unsorted]]<br />
||[[Image:Grade Report sorted lastname3.png|frame|center|Sorted ]] <br />
|-<br />
|}<br />
<br />
==Highlighting scores that are either adequate or unacceptable in red and green==<br />
<br />
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.<br />
<br />
Note that the highlighting will not show if the LAE Grader report is viewed in the editing mode.<br />
<br />
==Categorising the grades==<br />
The 'Choose an action...' drop down on the upper left will let you switch to other views<br />
* '''Edit categories and items''' will allow you to set up your assessments in different categories e.g. 'classwork', 'homework' etc. <br />
<br />
Each category will then have its own '''Category total''' column.<br />
<br />
=Editing=<br />
[[Image:laegrader_edit_mode.png|right|thumb|Grader report in editing mode]]<br />
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.<br />
<br />
==Altering the grades==<br />
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.<br />
<br />
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.<br />
<br />
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]]".<br />
<br />
==The significance of altering the grades in this screen==<br />
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.<br />
<br />
==Calculating totals==<br />
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.<br />
<br />
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.<br />
<br />
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.<br />
<br />
==Hiding columns or individual grades==<br />
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]].<br />
<br />
==Recalculating==<br />
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.<br />
<br />
==Changing the Order of Assignments within Categories==<br />
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.<br />
<br />
===Move an individual Grade item or Grade Category===<br />
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.<br />
<br />
===Move a number of Grade items simultaneously===<br />
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.<br />
<br />
===Other ways of moving grade items===<br />
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.<br />
<br />
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.<br />
<br />
==See also==<br />
*[[Edit grade calculation]]<br />
*[[Grade preferences]]<br />
*[http://www.youtube.com/watch?v=EB58W3KePBc Video showing the basic gradebook setup and use]<br />
*[http://www.youtube.com/watch?v=jWPUEqdhI4A Video showing how to change the display of grades in the gradebook]<br />
*[http://www.youtube.com/watch?v=5hrLNbifiGQ Video explaining the different gradebook reports]<br />
<br />
Using Moodle forum discussions:<br />
*[http://moodle.org/mod/forum/discuss.php?d=153718 Initial announcement and discussion on LAEgrader report]</div>Bobpufferhttps://docs.moodle.org/38/en/index.php?title=LAEGrader_report&diff=74871LAEGrader report2010-08-17T20:19:05Z<p>Bobpuffer: /* LAEgrader Report Installation */</p>
<hr />
<div>{{Grades}}The LAEgrader report page is an alternative main teacher view of the gradebook in Moodle 1.9. LAEgrader is not designed for versions prior to 1.9.<br />
<br />
If installed, the report can be seen in [[Course administration block|Course administration]]>Grades.<br />
<br />
=LAEgrader Report Overview=<br />
The LAEgrader report takes the place of the Grader report as the grades repository interface for the instructor for the course. It is based off from, and shares many library functions and classes with the Grader report. Therefore, the Grader report directory on your Moodle installation cannot be removed. The most notable difference between the LAEgrader and Grader is that the LAEgrader freezes both the column headers (grade item titles) and the student rows, while still allowing the user to scroll vertically and horizontally.<br />
<br />
=LAEgrader Report Installation=<br />
* Download the LAEgrader report from CVS or the [http://moodle.org/mod/data/view.php?d=13&rid=4026&filter=1 Moodle Modules and Plugins page].<br />
* (If zipped) unzip the contents of the zip file.<br />
* Place all contents in the grade/report directory of your Moodle installation (you should then have a grade/report/laegrader directory)<br />
* Under [[Site administration]] run "Notifications".<br />
* Check to see that your permissions for your various roles are as you desire. It is recommended that access to the regular Grader report be set to "Prevent" to avoid confusion.<br />
<br />
=User Configurable settings=<br />
* "gradeeditalways" mode removes the edit button and always displays the report ready for editing of grades (see below). <br />
* Height in pixels of scrollable portion of LAE grader report (300,340,380,420,460).<br />
* Accurate points calculation on or off (see below).<br />
<br />
The defaults for these options can be set at site level by going to Administration->Grades->[[Gradebook_report_settings|Report settings]]->LAE grader report.<br />
<br />
=Display=<br />
==Layout==<br />
[[Image:laegrader_normal_mode.png|right|thumb|LAE Grader report in non-editing mode]]<br />
Along the top is one row containing all grade items interspersed with a category items (if previous grade items are categorized). The last column is always the Course Total. All items contained in a category and the category total column are background color-coded the same (alternating light-red/light-blue). Items not contained in a category have a background of white as does the Course Total. If your gradebook exceeds 95% of the width of the document page, a horizontal scrollbar will be applied at the bottom. If the height of the number of student rows to display exceeds the user-configurable height (default: 360) a vertical scrollbar will be displayed. Whenever the grades are scrolled, either horizontally or vertically, the grade item titles )and optionally, range and average rows) will remain fixed as will the student columns (including "id", if displayed).<br />
<br />
===Other layout options===<br />
<br />
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.<br />
<br />
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.<br />
<br />
==Other Layout Differences From Grader Report==<br />
* LAEgrader does not collapse or expand categories.<br />
* LAEgrader allows wrapping of grade item and grade category names (at approximately 30 characters) to avoid excessively wide reports<br />
* You can add rows showing the range of possible scores and/or averages by going to [[Grade_preferences|My report preferences]] and selecting '''Show ranges''' or selecting '''Show averages'''. Unlike the Grader report, these rows are placed at the top and are frozen along with the grade item titles row so the user never loses sight of them.<br />
* Aggregation column (category or course) is always after the contained items or subcategories. This is not configurable.<br />
* The number of students per page is always unlimited.<br />
* The LAE grader report always makes it easy to know which student and which gradeitem is being viewed or edited and therefore selecting of whole rows or columns is disabled.<br />
* There are no longer any mouseover tooltips reminding you what student and what grade on which you're operating.<br />
<br />
=Functionality Enhancements=<br />
==Letter and Percentage Input==<br />
Whenever the user is editing grades they have the option of inputting a "real" number, a letter grade or a percentage grade. A letter will be compared against the letter grade setup for the course (configurable [[Grade letters]]) and will be converted to 1 point less than the maximum available for that letter grade. Percentage grades will be converted to the input percentage times the maximum grade earnable for that item.<br />
<br />
=="Edit Always" mode==<br />
When "gradeeditalways" preference has been selected by the user, the "Turn editing on/off" button does not appear. All grades are shown with their respective displaytypes (Real, Letter, Percentage) but are editable, unless locked. In the case where multiple displaytypes are formatted for grade column(s), (i.e., Real/Percentage) the first type will be the display format used. Grade column "locks" are provided at the top of each editable column of grades, clicked to insure that final grades in that column are not accidentally "re-edited".<br />
<br />
=="Copy to Excel" button==<br />
A button is provided above the student names column to allow quick "dumps" of LAE grader report contents. The data is exported "as seen" on the LAE grader report with all displaytypes as formatted on the screen. In the case where multiple displaytypes are formatted for grade column(s), (i.e., Real/Percentage) the first type will be the export format used. This quick export includes a row containing maximum point earnable for each grade item/category column. Grades displayed as percentages are exported as decimal equivalents.<br />
<br />
==Accurate Points Calculation==<br />
The Moodle core gradebook stores "real" grades to the grades table. "Real" is most often the number of points earned when applied to individual grade items. The total points for all grade items contained in a grade category is not automatically maintained unless "Sum of Grades" aggregation method is used. If other aggregation methods other than "Sum" are used and the category total is not manually adjusted to reflect the total points, usually the total points (or "real" grade) shown for a category is 100. This confuses many who expect "real" to be the actual total (earned and earnable, in the case of "range"). Setting "Accurate points calculation" triggers calculations in the LAE grader report so all "real" values reported are the actual sum of points for grade items making them up. This setting does not change what is stored in the grades table. You can toggle between "Accurate points" and Moodle's default with no problems. NOTE: to maintain the enhancements inside the report "plugin" the accurately calculated points for categories will not be reflected in the Categories and Items screen.<br />
<br />
<br />
*Examples<br />
<br />
{| style="width:75%; border="0" align="center" <br />
|[[Image:Grade Report unsorted column1.png|frame|center|Unsorted]]<br />
||[[Image:Grade Report sorted column2.png|frame|center|Sorted]]<br />
||[[Image:Grade Report unsorted name1.png|frame|center|Unsorted]]<br />
||[[Image:Grade Report sorted lastname3.png|frame|center|Sorted ]] <br />
|-<br />
|}<br />
<br />
==Highlighting scores that are either adequate or unacceptable in red and green==<br />
<br />
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.<br />
<br />
Note that the highlighting will not show if the LAE Grader report is viewed in the editing mode.<br />
<br />
==Categorising the grades==<br />
The 'Choose an action...' drop down on the upper left will let you switch to other views<br />
* '''Edit categories and items''' will allow you to set up your assessments in different categories e.g. 'classwork', 'homework' etc. <br />
<br />
Each category will then have its own '''Category total''' column.<br />
<br />
=Editing=<br />
[[Image:laegrader_edit_mode.png|right|thumb|Grader report in editing mode]]<br />
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.<br />
<br />
==Altering the grades==<br />
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.<br />
<br />
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.<br />
<br />
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]]".<br />
<br />
==The significance of altering the grades in this screen==<br />
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.<br />
<br />
==Calculating totals==<br />
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.<br />
<br />
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.<br />
<br />
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.<br />
<br />
==Hiding columns or individual grades==<br />
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]].<br />
<br />
==Recalculating==<br />
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.<br />
<br />
==Changing the Order of Assignments within Categories==<br />
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.<br />
<br />
===Move an individual Grade item or Grade Category===<br />
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.<br />
<br />
===Move a number of Grade items simultaneously===<br />
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.<br />
<br />
===Other ways of moving grade items===<br />
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.<br />
<br />
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.<br />
<br />
==See also==<br />
*[[Edit grade calculation]]<br />
*[[Grade preferences]]<br />
*[http://www.youtube.com/watch?v=EB58W3KePBc Video showing the basic gradebook setup and use]<br />
*[http://www.youtube.com/watch?v=jWPUEqdhI4A Video showing how to change the display of grades in the gradebook]<br />
*[http://www.youtube.com/watch?v=5hrLNbifiGQ Video explaining the different gradebook reports]<br />
<br />
Using Moodle forum discussions:<br />
*[http://moodle.org/mod/forum/discuss.php?d=153718 Initial announcement and discussion on LAEgrader report]</div>Bobpufferhttps://docs.moodle.org/38/en/index.php?title=LAEGrader_report&diff=74870LAEGrader report2010-08-17T20:16:25Z<p>Bobpuffer: /* Other Layout Differences From Grader Report */</p>
<hr />
<div>{{Grades}}The LAEgrader report page is an alternative main teacher view of the gradebook in Moodle 1.9. LAEgrader is not designed for versions prior to 1.9.<br />
<br />
If installed, the report can be seen in [[Course administration block|Course administration]]>Grades.<br />
<br />
=LAEgrader Report Overview=<br />
The LAEgrader report takes the place of the Grader report as the grades repository interface for the instructor for the course. It is based off from, and shares many library functions and classes with the Grader report. Therefore, the Grader report directory on your Moodle installation cannot be removed. The most notable difference between the LAEgrader and Grader is that the LAEgrader freezes both the column headers (grade item titles) and the student rows, while still allowing the user to scroll vertically and horizontally.<br />
<br />
=LAEgrader Report Installation=<br />
* Download the LAEgrader report from CVS or the [http://moodle.org/mod/data/view.php?d=13&rid=4026&filter=1 Moodle Modules and Plugins page].<br />
* (If zipped) unzip the contents of the zip file.<br />
* Place all contents in the grade/report directory of your Moodle installation (you should then have a grade/report/laegrader directory)<br />
<br />
=User Configurable settings=<br />
* "gradeeditalways" mode removes the edit button and always displays the report ready for editing of grades (see below). <br />
* Height in pixels of scrollable portion of LAE grader report (300,340,380,420,460).<br />
* Accurate points calculation on or off (see below).<br />
<br />
The defaults for these options can be set at site level by going to Administration->Grades->[[Gradebook_report_settings|Report settings]]->LAE grader report.<br />
<br />
=Display=<br />
==Layout==<br />
[[Image:laegrader_normal_mode.png|right|thumb|LAE Grader report in non-editing mode]]<br />
Along the top is one row containing all grade items interspersed with a category items (if previous grade items are categorized). The last column is always the Course Total. All items contained in a category and the category total column are background color-coded the same (alternating light-red/light-blue). Items not contained in a category have a background of white as does the Course Total. If your gradebook exceeds 95% of the width of the document page, a horizontal scrollbar will be applied at the bottom. If the height of the number of student rows to display exceeds the user-configurable height (default: 360) a vertical scrollbar will be displayed. Whenever the grades are scrolled, either horizontally or vertically, the grade item titles )and optionally, range and average rows) will remain fixed as will the student columns (including "id", if displayed).<br />
<br />
===Other layout options===<br />
<br />
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.<br />
<br />
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.<br />
<br />
==Other Layout Differences From Grader Report==<br />
* LAEgrader does not collapse or expand categories.<br />
* LAEgrader allows wrapping of grade item and grade category names (at approximately 30 characters) to avoid excessively wide reports<br />
* You can add rows showing the range of possible scores and/or averages by going to [[Grade_preferences|My report preferences]] and selecting '''Show ranges''' or selecting '''Show averages'''. Unlike the Grader report, these rows are placed at the top and are frozen along with the grade item titles row so the user never loses sight of them.<br />
* Aggregation column (category or course) is always after the contained items or subcategories. This is not configurable.<br />
* The number of students per page is always unlimited.<br />
* The LAE grader report always makes it easy to know which student and which gradeitem is being viewed or edited and therefore selecting of whole rows or columns is disabled.<br />
* There are no longer any mouseover tooltips reminding you what student and what grade on which you're operating.<br />
<br />
=Functionality Enhancements=<br />
==Letter and Percentage Input==<br />
Whenever the user is editing grades they have the option of inputting a "real" number, a letter grade or a percentage grade. A letter will be compared against the letter grade setup for the course (configurable [[Grade letters]]) and will be converted to 1 point less than the maximum available for that letter grade. Percentage grades will be converted to the input percentage times the maximum grade earnable for that item.<br />
<br />
=="Edit Always" mode==<br />
When "gradeeditalways" preference has been selected by the user, the "Turn editing on/off" button does not appear. All grades are shown with their respective displaytypes (Real, Letter, Percentage) but are editable, unless locked. In the case where multiple displaytypes are formatted for grade column(s), (i.e., Real/Percentage) the first type will be the display format used. Grade column "locks" are provided at the top of each editable column of grades, clicked to insure that final grades in that column are not accidentally "re-edited".<br />
<br />
=="Copy to Excel" button==<br />
A button is provided above the student names column to allow quick "dumps" of LAE grader report contents. The data is exported "as seen" on the LAE grader report with all displaytypes as formatted on the screen. In the case where multiple displaytypes are formatted for grade column(s), (i.e., Real/Percentage) the first type will be the export format used. This quick export includes a row containing maximum point earnable for each grade item/category column. Grades displayed as percentages are exported as decimal equivalents.<br />
<br />
==Accurate Points Calculation==<br />
The Moodle core gradebook stores "real" grades to the grades table. "Real" is most often the number of points earned when applied to individual grade items. The total points for all grade items contained in a grade category is not automatically maintained unless "Sum of Grades" aggregation method is used. If other aggregation methods other than "Sum" are used and the category total is not manually adjusted to reflect the total points, usually the total points (or "real" grade) shown for a category is 100. This confuses many who expect "real" to be the actual total (earned and earnable, in the case of "range"). Setting "Accurate points calculation" triggers calculations in the LAE grader report so all "real" values reported are the actual sum of points for grade items making them up. This setting does not change what is stored in the grades table. You can toggle between "Accurate points" and Moodle's default with no problems. NOTE: to maintain the enhancements inside the report "plugin" the accurately calculated points for categories will not be reflected in the Categories and Items screen.<br />
<br />
<br />
*Examples<br />
<br />
{| style="width:75%; border="0" align="center" <br />
|[[Image:Grade Report unsorted column1.png|frame|center|Unsorted]]<br />
||[[Image:Grade Report sorted column2.png|frame|center|Sorted]]<br />
||[[Image:Grade Report unsorted name1.png|frame|center|Unsorted]]<br />
||[[Image:Grade Report sorted lastname3.png|frame|center|Sorted ]] <br />
|-<br />
|}<br />
<br />
==Highlighting scores that are either adequate or unacceptable in red and green==<br />
<br />
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.<br />
<br />
Note that the highlighting will not show if the LAE Grader report is viewed in the editing mode.<br />
<br />
==Categorising the grades==<br />
The 'Choose an action...' drop down on the upper left will let you switch to other views<br />
* '''Edit categories and items''' will allow you to set up your assessments in different categories e.g. 'classwork', 'homework' etc. <br />
<br />
Each category will then have its own '''Category total''' column.<br />
<br />
=Editing=<br />
[[Image:laegrader_edit_mode.png|right|thumb|Grader report in editing mode]]<br />
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.<br />
<br />
==Altering the grades==<br />
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.<br />
<br />
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.<br />
<br />
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]]".<br />
<br />
==The significance of altering the grades in this screen==<br />
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.<br />
<br />
==Calculating totals==<br />
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.<br />
<br />
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.<br />
<br />
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.<br />
<br />
==Hiding columns or individual grades==<br />
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]].<br />
<br />
==Recalculating==<br />
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.<br />
<br />
==Changing the Order of Assignments within Categories==<br />
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.<br />
<br />
===Move an individual Grade item or Grade Category===<br />
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.<br />
<br />
===Move a number of Grade items simultaneously===<br />
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.<br />
<br />
===Other ways of moving grade items===<br />
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.<br />
<br />
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.<br />
<br />
==See also==<br />
*[[Edit grade calculation]]<br />
*[[Grade preferences]]<br />
*[http://www.youtube.com/watch?v=EB58W3KePBc Video showing the basic gradebook setup and use]<br />
*[http://www.youtube.com/watch?v=jWPUEqdhI4A Video showing how to change the display of grades in the gradebook]<br />
*[http://www.youtube.com/watch?v=5hrLNbifiGQ Video explaining the different gradebook reports]<br />
<br />
Using Moodle forum discussions:<br />
*[http://moodle.org/mod/forum/discuss.php?d=153718 Initial announcement and discussion on LAEgrader report]</div>Bobpufferhttps://docs.moodle.org/38/en/index.php?title=Template:Grades&diff=74869Template:Grades2010-08-17T20:09:45Z<p>Bobpuffer: </p>
<hr />
<div><div class="sideblock right" style="width: 12em;"><br />
<div class="header">[[Grades]]</div><br />
<div class="content"><br />
* [[Grader report]]<br />
* [[Grade preferences]]<br />
* [[Outcomes report]]<br />
* [[Overview report]]<br />
* [[User report]]<br />
* [[LAEGrader report]]<br />
* [[Grade import]]<br />
* [[Grade export]]<br />
* [[Grade items]]<br />
* [[Grade categories]]<br />
* [[Grade calculations]]<br />
* [[Scales]]<br />
* [[Outcomes]]<br />
* [[Grade letters]]<br />
* [[Gradebook course settings|Course settings]]<br />
* [[Grades FAQ]]<br />
For administrators:<br />
* [[General grade settings|General settings]]<br />
* [[Grade category settings]]<br />
* [[Grade item settings]]<br />
* [[Gradebook report settings|Report settings]]<br />
* [[Grade permissions]]<br />
</div><br />
</div><br />
{{Moodle 1.9}}<br />
<br />
<includeonly>[[Category:Grades]]</includeonly><br />
<noinclude>This template will categorize articles that include it into [[:Category:Grades]].</noinclude><br />
<noinclude>[[fr:Modèle:Notes]]</noinclude></div>Bobpufferhttps://docs.moodle.org/38/en/index.php?title=File:laegrader_normal_mode.png&diff=74868File:laegrader normal mode.png2010-08-17T20:02:38Z<p>Bobpuffer: uploaded a new version of "Image:laegrader normal mode.png"</p>
<hr />
<div></div>Bobpufferhttps://docs.moodle.org/38/en/index.php?title=File:laegrader_normal_mode.png&diff=74867File:laegrader normal mode.png2010-08-17T20:00:23Z<p>Bobpuffer: </p>
<hr />
<div></div>Bobpufferhttps://docs.moodle.org/38/en/index.php?title=LAEGrader_report&diff=74865LAEGrader report2010-08-17T19:54:23Z<p>Bobpuffer: New page: {{Grades}}The LAEgrader report page is an alternative main teacher view of the gradebook in Moodle 1.9. LAEgrader is not designed for versions prior to 1.9. If installed, the report can b...</p>
<hr />
<div>{{Grades}}The LAEgrader report page is an alternative main teacher view of the gradebook in Moodle 1.9. LAEgrader is not designed for versions prior to 1.9.<br />
<br />
If installed, the report can be seen in [[Course administration block|Course administration]]>Grades.<br />
<br />
=LAEgrader Report Overview=<br />
The LAEgrader report takes the place of the Grader report as the grades repository interface for the instructor for the course. It is based off from, and shares many library functions and classes with the Grader report. Therefore, the Grader report directory on your Moodle installation cannot be removed. The most notable difference between the LAEgrader and Grader is that the LAEgrader freezes both the column headers (grade item titles) and the student rows, while still allowing the user to scroll vertically and horizontally.<br />
<br />
=LAEgrader Report Installation=<br />
* Download the LAEgrader report from CVS or the [http://moodle.org/mod/data/view.php?d=13&rid=4026&filter=1 Moodle Modules and Plugins page].<br />
* (If zipped) unzip the contents of the zip file.<br />
* Place all contents in the grade/report directory of your Moodle installation (you should then have a grade/report/laegrader directory)<br />
<br />
=User Configurable settings=<br />
* "gradeeditalways" mode removes the edit button and always displays the report ready for editing of grades (see below). <br />
* Height in pixels of scrollable portion of LAE grader report (300,340,380,420,460).<br />
* Accurate points calculation on or off (see below).<br />
<br />
The defaults for these options can be set at site level by going to Administration->Grades->[[Gradebook_report_settings|Report settings]]->LAE grader report.<br />
<br />
=Display=<br />
==Layout==<br />
[[Image:laegrader_normal_mode.png|right|thumb|LAE Grader report in non-editing mode]]<br />
Along the top is one row containing all grade items interspersed with a category items (if previous grade items are categorized). The last column is always the Course Total. All items contained in a category and the category total column are background color-coded the same (alternating light-red/light-blue). Items not contained in a category have a background of white as does the Course Total. If your gradebook exceeds 95% of the width of the document page, a horizontal scrollbar will be applied at the bottom. If the height of the number of student rows to display exceeds the user-configurable height (default: 360) a vertical scrollbar will be displayed. Whenever the grades are scrolled, either horizontally or vertically, the grade item titles )and optionally, range and average rows) will remain fixed as will the student columns (including "id", if displayed).<br />
<br />
===Other layout options===<br />
<br />
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.<br />
<br />
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.<br />
<br />
==Other Layout Differences From Grader Report==<br />
* LAEgrader does not collapse or expand categories.<br />
* LAEgrader allows wrapping of grade item and grade category names (at approximately 30 characters) to avoid excessively wide reports<br />
* You can add a rows showing the range of possible scores or averages by going to [[Grade_preferences|My report preferences]] and selecting '''Show ranges''' or selecting '''Show averages'''. Unlike the Grader report, these rows are placed at the top and are frozen along with the grade item titles row so the user never loses sight of them.<br />
* Aggregation column (category or course) is always after the contained items or subcategories. This is not configurable.<br />
* The number of students per page is always unlimited.<br />
* The LAE grader report always makes it easy to know which student and which gradeitem is being viewed or edited and therefore selecting of whole rows or columns is disabled.<br />
* There are no longer any mouseover tooltips reminding you what student and what grade on which you're operating.<br />
<br />
=Functionality Enhancements=<br />
==Letter and Percentage Input==<br />
Whenever the user is editing grades they have the option of inputting a "real" number, a letter grade or a percentage grade. A letter will be compared against the letter grade setup for the course (configurable [[Grade letters]]) and will be converted to 1 point less than the maximum available for that letter grade. Percentage grades will be converted to the input percentage times the maximum grade earnable for that item.<br />
<br />
=="Edit Always" mode==<br />
When "gradeeditalways" preference has been selected by the user, the "Turn editing on/off" button does not appear. All grades are shown with their respective displaytypes (Real, Letter, Percentage) but are editable, unless locked. In the case where multiple displaytypes are formatted for grade column(s), (i.e., Real/Percentage) the first type will be the display format used. Grade column "locks" are provided at the top of each editable column of grades, clicked to insure that final grades in that column are not accidentally "re-edited".<br />
<br />
=="Copy to Excel" button==<br />
A button is provided above the student names column to allow quick "dumps" of LAE grader report contents. The data is exported "as seen" on the LAE grader report with all displaytypes as formatted on the screen. In the case where multiple displaytypes are formatted for grade column(s), (i.e., Real/Percentage) the first type will be the export format used. This quick export includes a row containing maximum point earnable for each grade item/category column. Grades displayed as percentages are exported as decimal equivalents.<br />
<br />
==Accurate Points Calculation==<br />
The Moodle core gradebook stores "real" grades to the grades table. "Real" is most often the number of points earned when applied to individual grade items. The total points for all grade items contained in a grade category is not automatically maintained unless "Sum of Grades" aggregation method is used. If other aggregation methods other than "Sum" are used and the category total is not manually adjusted to reflect the total points, usually the total points (or "real" grade) shown for a category is 100. This confuses many who expect "real" to be the actual total (earned and earnable, in the case of "range"). Setting "Accurate points calculation" triggers calculations in the LAE grader report so all "real" values reported are the actual sum of points for grade items making them up. This setting does not change what is stored in the grades table. You can toggle between "Accurate points" and Moodle's default with no problems. NOTE: to maintain the enhancements inside the report "plugin" the accurately calculated points for categories will not be reflected in the Categories and Items screen.<br />
<br />
<br />
*Examples<br />
<br />
{| style="width:75%; border="0" align="center" <br />
|[[Image:Grade Report unsorted column1.png|frame|center|Unsorted]]<br />
||[[Image:Grade Report sorted column2.png|frame|center|Sorted]]<br />
||[[Image:Grade Report unsorted name1.png|frame|center|Unsorted]]<br />
||[[Image:Grade Report sorted lastname3.png|frame|center|Sorted ]] <br />
|-<br />
|}<br />
<br />
==Highlighting scores that are either adequate or unacceptable in red and green==<br />
<br />
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.<br />
<br />
Note that the highlighting will not show if the LAE Grader report is viewed in the editing mode.<br />
<br />
==Categorising the grades==<br />
The 'Choose an action...' drop down on the upper left will let you switch to other views<br />
* '''Edit categories and items''' will allow you to set up your assessments in different categories e.g. 'classwork', 'homework' etc. <br />
<br />
Each category will then have its own '''Category total''' column.<br />
<br />
=Editing=<br />
[[Image:laegrader_edit_mode.png|right|thumb|Grader report in editing mode]]<br />
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.<br />
<br />
==Altering the grades==<br />
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.<br />
<br />
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.<br />
<br />
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]]".<br />
<br />
==The significance of altering the grades in this screen==<br />
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.<br />
<br />
==Calculating totals==<br />
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.<br />
<br />
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.<br />
<br />
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.<br />
<br />
==Hiding columns or individual grades==<br />
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]].<br />
<br />
==Recalculating==<br />
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.<br />
<br />
==Changing the Order of Assignments within Categories==<br />
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.<br />
<br />
===Move an individual Grade item or Grade Category===<br />
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.<br />
<br />
===Move a number of Grade items simultaneously===<br />
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.<br />
<br />
===Other ways of moving grade items===<br />
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.<br />
<br />
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.<br />
<br />
==See also==<br />
*[[Edit grade calculation]]<br />
*[[Grade preferences]]<br />
*[http://www.youtube.com/watch?v=EB58W3KePBc Video showing the basic gradebook setup and use]<br />
*[http://www.youtube.com/watch?v=jWPUEqdhI4A Video showing how to change the display of grades in the gradebook]<br />
*[http://www.youtube.com/watch?v=5hrLNbifiGQ Video explaining the different gradebook reports]<br />
<br />
Using Moodle forum discussions:<br />
*[http://moodle.org/mod/forum/discuss.php?d=153718 Initial announcement and discussion on LAEgrader report]</div>Bobpufferhttps://docs.moodle.org/38/en/index.php?title=Grades&diff=70475Grades2010-03-31T14:06:55Z<p>Bobpuffer: /* Grades pushed by modules */</p>
<hr />
<div>{{Grades}}<p class="note">'''Note:''' This page, together with the pages listed in the block on the right, describe the gradebook in Moodle 1.9 onwards. For documentation on the gradebook in Moodle prior to 1.9, see [[Grades pre-1.9]].</p><br />
<br />
<br />
==Introduction==<br />
<br />
The concepts of ''grades'' and of ''gradebook'' have been completely revisited in Moodle 1.9. These words and modules were used in earlier version. There are important differences that users who are upgrading to 1.9 need to understand and this should also help new users. <br />
<br />
The two central ideas of grading in Moodle 1.9 are:<br />
<br />
#'''Grades''' are scores attributed to participants in a Moodle course<br />
#The '''gradebook''' is a repository of these grades: modules push their grades to it, but the gradebook doesn't push anything back to the modules<br />
<br />
The three building blocks of the Gradebook in Moodle 1.9 are<br />
<br />
*The [[Grade_categories|grade category]]<br />
:A grade category groups grade items together, and has settings for affecting these grade items<br />
*The [[Grade_items|grade item]]<br />
:A grade item stores a grade for each course participant, and has settings for affecting these grades<br />
*The grade -Student scores in a course<br />
:A grade has settings for affecting how it is displayed to the users, as well as [[Grade locking|locking]] and [[Grade hiding|hiding]] functions.<br />
<br />
As an overview:<br />
Grades can be [[Grade_calculations|calculated]], [[Grade_categories#Aggregation|aggregated]] and [[Grader_report#Display|displayed]] in a variety of ways, the many settings having been designed to suit the needs of a great variety of organisations.<br />
<br />
Many activities in Moodle, such as [[Assignment module|assignments]], [[Forum module|forums]] and [[Quiz module|quizzes]] may be given grades. Grades may have numerical values, or words/phrases from a [[Scales|scale or rating system]].<br />
<br />
Grades can also be used as [[Outcomes|outcomes]] and as arbitrary text attributed to each participant in a course.<br />
<br />
==How Grades Get Into the Gradebook==<br />
<br />
===Grades pushed by modules===<br />
When activity modules produce grades, they use the [[Development:Grades#API_for_communication_with_modules.2Fblocks|gradebook public API]] to push (or send) their grades to the gradebook. These grades are then stored in database tables that are independent of the modules. The grades are still kept in the module database tables, and the gradebook will never access or modify these original grades. <br />
<br />
The gradebook, however, provides administrators and teachers with tools for changing the ways in which grades are calculated, aggregated and displayed, as well as [[grade/edit/tree/grade|means to change the grades manually]] (a manual edit of a grade automatically locks the grade in the gradebook, so that the module which originally created the grade can no longer update that grade in the gradebook until the grade is unlocked).<br />
<br />
===Grades Manually Added by Teachers===<br />
Users with Teacher permissions for the course can add "manual" grade items to the gradebook through the Categories and Items section.<br />
<br />
==Settings affecting grades==<br />
Being the smallest unit in the gradebook, the grade is affected by many settings at different levels. Here is a list of these levels, in hierarchical order:<br />
<br />
*[[General_grade_settings|Site-wide general settings]]<br />
*[[Grade_category_settings|Site-wide grade category settings]]<br />
*[[Grade_item_settings|Site-wide grade item settings]]<br />
*[[Gradebook_report_settings|Gradebook report settings]]<br />
*[[Gradebook_course_settings|Course settings]]<br />
*[[Grade_categories|Category settings]]<br />
*[[Grade_items|Grade item settings]]<br />
*[[grade/edit/tree/grade|Grade settings]]<br />
<br />
==Outcomes==<br />
<br />
[[Outcomes]] are specific descriptions of what a student is expected to be able to do or understand at the completion of an activity or course. An activity might have more than one outcome, and each may have a grade against it (usually on a [[Scales|scale]]).<br />
<br />
==Gradebook reports==<br />
<br />
The gradebook includes a variety of reports, available via the grades link in each [[Course administration block|course administration block]]:<br />
<br />
* [[Grader report]] - The main teacher view of a course gradebook. The "[[Grade preferences|My report preferences]]" tab in the grader report enables teachers to change how the grader report is displayed.<br />
* [[Outcomes report]]<br />
* [[Overview report]]<br />
* [[User report]]<br />
<br />
==Grades organisation==<br />
<br />
Teachers may organise grades into [[Grade categories|grade categories]], [[Grade import|import]] and/or [[Grade export|export]] grades, and make [[Grade calculations|grade calculations]].<br />
<br />
Symbols to represent ranges of grades may be set as [[Grade letters|grade letters]].<br />
<br />
Administrators may control the appearance of the gradebook site-wide by adjusting settings available via the grades link in the site administration block:<br />
<br />
*[[General grade settings]]<br />
*[[Grade category settings]]<br />
*[[Grade item settings]]<br />
*[[Gradebook report settings]] <br />
<br />
==See also==<br />
<br />
*Using Moodle [http://moodle.org/mod/forum/view.php?id=2122 Gradebook forum]<br />
<br />
Video tutorials:<br />
*[http://www.youtube.com/watch?v=YeUy-_kbvqQ Basic Moodle Gradebook howto]<br />
*[http://www.youtube.com/watch?v=5hrLNbifiGQ Gradebook reports]<br />
*[http://www.youtube.com/watch?v=lXEefYe3qdk How to use the grade item settings and grade letters at admin level]<br />
*[http://www.youtube.com/watch?v=sUslTuZPu6A Grade category settings]<br />
*[http://www.youtube.com/watch?v=EB58W3KePBc How to set up the gradebook]<br />
*[http://www.youtube.com/watch?v=PmkEGfvjj9U How to use outcomes in Moodle]<br />
*[http://www.youtube.com/watch?v=yZcbN_7p2zI How to export grades from the gradebook]<br />
*[http://www.youtube.com/watch?v=p6zWwJGb9TA How to use gradebook site settings and defaults]<br />
*[http://www.youtube.com/watch?v=WKUGyzAXcyA How to set up calculations in the gradebook (basic)]<br />
*[http://www.youtube.com/watch?v=VBEj8mmu8lM How to set up calculations in the gradebook (advanced)]<br />
*[http://www.youtube.com/watch?v=jWPUEqdhI4A How to change the display of grades in the gradebook]<br />
<br />
[[ca:Qualificacions]]<br />
[[cs:Známky]]<br />
[[de:Bewertungen]]<br />
[[eu:Kalifikazioak]]<br />
[[fr:Notes]]<br />
[[es:Calificaciones]]<br />
[[ru:Оценки]]</div>Bobpufferhttps://docs.moodle.org/38/en/index.php?title=Simplifying_the_gradebook_by_changing_permissions&diff=52100Simplifying the gradebook by changing permissions2009-03-05T14:52:40Z<p>Bobpuffer: /* Reducing aggregation methods available in the gradebook */</p>
<hr />
<div>The gradebook in Moodle 1.9 onwards may be simplified for teachers and non-editing teachers by changing permissions at the system, course category or course level.<br />
<br />
<br />
==Basic method==<br />
<br />
To change permissions at the system level:<br />
<br />
# Login as an administrator.<br />
# Access ''Administration > Users > Permissions > Define roles''<br />
# Edit the role(s) of teacher and/or non-editing teacher and change chosen capabilities from Allow to Not set.<br />
# Scroll to the bottom of the page and click the "Save changes" button.<br />
<br />
To change permissions at the course category or course level:<br />
<br />
# Login as an administrator.<br />
# Follow the "Assign roles" link at the top right of the course category page or the link in the course administration block.<br />
# Click the "Override permissions" tab.<br />
# Select the role(s) of teacher and/or non-editing teacher and change chosen capabilities from Inherit to Prevent.<br />
# Scroll to the bottom of the page and click the "Save changes" button.<br />
<br />
==Removing the overview report link==<br />
<br />
The overview report lists all the courses a student is enrolled in with the total grade for each course, and teachers obtain the message "There are no courses yet".<br />
<br />
To remove the overview report link, change the capability [[Capabilities/gradereport/overview:view|gradereport/overview:view]].<br />
<br />
==Reducing the number of grade export types==<br />
<br />
By default, teachers can [[Grade export|export grades]] to Excel spreadsheet (xls), OpenDocument spreadsheet (ods), plain text file (txt) or XML file (xml). <br />
<br />
To remove grade export types which teachers aren't likely to use, change any of the following capabilities: [[Capabilities/gradeexport/xls:view|gradeexport/xls:view]], [[Capabilities/gradeexport/ods:view|gradeexport/ods:view]], [[Capabilities/gradeexport/txt:view|gradeexport/txt:view]], [[Capabilities/gradeexport/xml:view|gradeexport/xml:view]].<br />
<br />
To remove the option to export grades completely, change the capability [[Capabilities/moodle/grade:export|moodle/grade:export]].<br />
<br />
==Reducing the number of grade import types==<br />
<br />
By default, teachers can [[Grade import|import grades]] as a CSV or XML file.<br />
<br />
To remove grade import types which teachers aren't likely to use, change either of the following capabilities: [[Capabilities/gradeimport/csv:view|gradeimport/csv:view]], [[Capabilities/gradeimport/xml:view|gradeimport/xml:view]].<br />
<br />
To remove the option to import grades completely, change the capability [[Capabilities/moodle/grade:import|moodle/grade:import]].<br />
<br />
==Forcing grade letter site-level defaults==<br />
<br />
To remove the ability for teachers to edit grade letters in their courses, change the capability [[Capabilities/moodle/grade:manageletters|moodle/grade:manageletters]].<br />
<br />
==Forcing standard scales==<br />
<br />
To remove the ability for teachers to create, edit and delete custom [[Scales|scales]], change the capability [[Capabilities/moodle/course:managescales|moodle/course:managescales]].<br />
<br />
==Removing the option to edit grades directly in the gradebook==<br />
<br />
To remove the [[Grader report|grader report]] turn editing on/off button, change the capability [[Capabilities/moodle/grade:edit|moodle/grade:edit]]. This will result in teachers not being able to edit grades directly or to hide or lock individual grades (though they will still be able to hide or lock [[Grade items]] via the edit categories and items page). This change makes the grader report similar to the Moodle 1.8 gradebook.<br />
<br />
==Reducing aggregation methods available in the gradebook==<br />
"A Point's a Point (currently, "Sum of Points"), "Average of Percents" (currently "Simple weighted mean of grades"), "Weighted Average" (currently "Weighted mean of grades). I can't seem to think of use-cases where something else would be needed. Perhaps the rest of those methods have been provided for the 5% of users who might use them.<br />
<br />
[[Category:Grades]]</div>Bobpufferhttps://docs.moodle.org/38/en/index.php?title=Simplifying_the_gradebook_by_changing_permissions&diff=52099Simplifying the gradebook by changing permissions2009-03-05T14:51:57Z<p>Bobpuffer: </p>
<hr />
<div>The gradebook in Moodle 1.9 onwards may be simplified for teachers and non-editing teachers by changing permissions at the system, course category or course level.<br />
<br />
<br />
==Basic method==<br />
<br />
To change permissions at the system level:<br />
<br />
# Login as an administrator.<br />
# Access ''Administration > Users > Permissions > Define roles''<br />
# Edit the role(s) of teacher and/or non-editing teacher and change chosen capabilities from Allow to Not set.<br />
# Scroll to the bottom of the page and click the "Save changes" button.<br />
<br />
To change permissions at the course category or course level:<br />
<br />
# Login as an administrator.<br />
# Follow the "Assign roles" link at the top right of the course category page or the link in the course administration block.<br />
# Click the "Override permissions" tab.<br />
# Select the role(s) of teacher and/or non-editing teacher and change chosen capabilities from Inherit to Prevent.<br />
# Scroll to the bottom of the page and click the "Save changes" button.<br />
<br />
==Removing the overview report link==<br />
<br />
The overview report lists all the courses a student is enrolled in with the total grade for each course, and teachers obtain the message "There are no courses yet".<br />
<br />
To remove the overview report link, change the capability [[Capabilities/gradereport/overview:view|gradereport/overview:view]].<br />
<br />
==Reducing the number of grade export types==<br />
<br />
By default, teachers can [[Grade export|export grades]] to Excel spreadsheet (xls), OpenDocument spreadsheet (ods), plain text file (txt) or XML file (xml). <br />
<br />
To remove grade export types which teachers aren't likely to use, change any of the following capabilities: [[Capabilities/gradeexport/xls:view|gradeexport/xls:view]], [[Capabilities/gradeexport/ods:view|gradeexport/ods:view]], [[Capabilities/gradeexport/txt:view|gradeexport/txt:view]], [[Capabilities/gradeexport/xml:view|gradeexport/xml:view]].<br />
<br />
To remove the option to export grades completely, change the capability [[Capabilities/moodle/grade:export|moodle/grade:export]].<br />
<br />
==Reducing the number of grade import types==<br />
<br />
By default, teachers can [[Grade import|import grades]] as a CSV or XML file.<br />
<br />
To remove grade import types which teachers aren't likely to use, change either of the following capabilities: [[Capabilities/gradeimport/csv:view|gradeimport/csv:view]], [[Capabilities/gradeimport/xml:view|gradeimport/xml:view]].<br />
<br />
To remove the option to import grades completely, change the capability [[Capabilities/moodle/grade:import|moodle/grade:import]].<br />
<br />
==Forcing grade letter site-level defaults==<br />
<br />
To remove the ability for teachers to edit grade letters in their courses, change the capability [[Capabilities/moodle/grade:manageletters|moodle/grade:manageletters]].<br />
<br />
==Forcing standard scales==<br />
<br />
To remove the ability for teachers to create, edit and delete custom [[Scales|scales]], change the capability [[Capabilities/moodle/course:managescales|moodle/course:managescales]].<br />
<br />
==Removing the option to edit grades directly in the gradebook==<br />
<br />
To remove the [[Grader report|grader report]] turn editing on/off button, change the capability [[Capabilities/moodle/grade:edit|moodle/grade:edit]]. This will result in teachers not being able to edit grades directly or to hide or lock individual grades (though they will still be able to hide or lock [[Grade items]] via the edit categories and items page). This change makes the grader report similar to the Moodle 1.8 gradebook.<br />
<br />
==Reducing aggregation methods available in the gradebook==<br />
"A Point's a Point (currently, "Sum of Points"", "Average of Percents" (currently "Simple weighted mean of grades", "Weighted Average" (currently "Weighted mean of grades). I can't seem to think of use-cases where something else would be needed. Perhaps the rest of those methods have been provided for the 5% of users who might use them.<br />
<br />
[[Category:Grades]]</div>Bobpufferhttps://docs.moodle.org/38/en/index.php?title=Simplifying_the_gradebook_by_changing_permissions&diff=52098Simplifying the gradebook by changing permissions2009-03-05T14:49:49Z<p>Bobpuffer: </p>
<hr />
<div>The gradebook in Moodle 1.9 onwards may be simplified for teachers and non-editing teachers by changing permissions at the system, course category or course level.<br />
<br />
<br />
==Basic method==<br />
<br />
To change permissions at the system level:<br />
<br />
# Login as an administrator.<br />
# Access ''Administration > Users > Permissions > Define roles''<br />
# Edit the role(s) of teacher and/or non-editing teacher and change chosen capabilities from Allow to Not set.<br />
# Scroll to the bottom of the page and click the "Save changes" button.<br />
<br />
To change permissions at the course category or course level:<br />
<br />
# Login as an administrator.<br />
# Follow the "Assign roles" link at the top right of the course category page or the link in the course administration block.<br />
# Click the "Override permissions" tab.<br />
# Select the role(s) of teacher and/or non-editing teacher and change chosen capabilities from Inherit to Prevent.<br />
# Scroll to the bottom of the page and click the "Save changes" button.<br />
<br />
==Removing the overview report link==<br />
<br />
The overview report lists all the courses a student is enrolled in with the total grade for each course, and teachers obtain the message "There are no courses yet".<br />
<br />
To remove the overview report link, change the capability [[Capabilities/gradereport/overview:view|gradereport/overview:view]].<br />
<br />
==Reducing the number of grade export types==<br />
<br />
By default, teachers can [[Grade export|export grades]] to Excel spreadsheet (xls), OpenDocument spreadsheet (ods), plain text file (txt) or XML file (xml). <br />
<br />
To remove grade export types which teachers aren't likely to use, change any of the following capabilities: [[Capabilities/gradeexport/xls:view|gradeexport/xls:view]], [[Capabilities/gradeexport/ods:view|gradeexport/ods:view]], [[Capabilities/gradeexport/txt:view|gradeexport/txt:view]], [[Capabilities/gradeexport/xml:view|gradeexport/xml:view]].<br />
<br />
To remove the option to export grades completely, change the capability [[Capabilities/moodle/grade:export|moodle/grade:export]].<br />
<br />
==Reducing the number of grade import types==<br />
<br />
By default, teachers can [[Grade import|import grades]] as a CSV or XML file.<br />
<br />
To remove grade import types which teachers aren't likely to use, change either of the following capabilities: [[Capabilities/gradeimport/csv:view|gradeimport/csv:view]], [[Capabilities/gradeimport/xml:view|gradeimport/xml:view]].<br />
<br />
To remove the option to import grades completely, change the capability [[Capabilities/moodle/grade:import|moodle/grade:import]].<br />
<br />
==Forcing grade letter site-level defaults==<br />
<br />
To remove the ability for teachers to edit grade letters in their courses, change the capability [[Capabilities/moodle/grade:manageletters|moodle/grade:manageletters]].<br />
<br />
==Forcing standard scales==<br />
<br />
To remove the ability for teachers to create, edit and delete custom [[Scales|scales]], change the capability [[Capabilities/moodle/course:managescales|moodle/course:managescales]].<br />
<br />
==Removing the option to edit grades directly in the gradebook==<br />
<br />
To remove the [[Grader report|grader report]] turn editing on/off button, change the capability [[Capabilities/moodle/grade:edit|moodle/grade:edit]]. This will result in teachers not being able to edit grades directly or to hide or lock individual grades (though they will still be able to hide or lock [[Grade items]] via the edit categories and items page). This change makes the grader report similar to the Moodle 1.8 gradebook.<br />
<br />
==Reducing aggregation methods available in the gradebook==<br />
"A Point's a Point", "Weighted Average", "Sum of Points". I can't seem to think of use-cases where something else would be needed. Perhaps the rest of those methods have been provided for the 5% of users who might use them.<br />
<br />
[[Category:Grades]]</div>Bobpuffer