Note: You are currently viewing documentation for Moodle 2.4. Up-to-date documentation for the latest stable version of Moodle may be available here: Ajax marking block.

Ajax marking block: Difference between revisions

From MoodleDocs
(Updated docs for 2.2)
 
(One intermediate revision by one other user not shown)
Line 1: Line 1:
The [http://moodle.org/mod/data/view.php?d=13&rid=1459 AJAX marking block] allows you to view and complete all of your marking without leaving the page you are on. It displays all the ungraded work you need to mark in a tree structure of all of the courses you teach in, along with a count of how many items there are for each course & assessment item.  
The [http://moodle.org/plugins/view.php?plugin=block_ajax_marking AJAX marking block] allows you to view and grade all of your marking without leaving the page you are on. It displays all the ungraded work you need to mark in a tree structure of all of the courses you teach in, along with a count of how many items there are for each course & assessment item. Clicking an item gives you a grading popup, and once you're done, the tree updates itself so you can keep track of what's left.
[[Image:Ajax_marking.png|right]]
[[Image:Ajax_marking.png|right]]


=== 2.0 status:===
The block currently works in a basic way for Moodle 2.0 and 2.1, but lacks the configuration interface. I'm working on this pretty much flat out, and it's involved a significant refactor of almost all of the code in order to make more scalable and to allow for future expansion etc. [[User:Matt Gibson|Matt Gibson]] 00:52, 4 November 2011 (WST)


====Keep track of what you have graded so far====
==Prioritise your marking whatever way suits you==
When the tree nodes are expanded and a student's name is clicked, a pop-up opens with the work to be graded. Once 'Submit' has been clicked in that window, the pop-up closes and tree updates itself by removing the student's node and altering its total count.
===Mark all work for a particular class===
The block has been built with workflow in mind. If you have a class coming up and need to get their marking done, whatever it is, use the cohorts tab to see all their work across courses. If you are not using cohorts, set the course or activity you are interested in to 'show groups nodes' by either using the config tab, or right-clicking the item where you see it. This will break down the work into separate nodes for each group and you can mark just those.


====Instantly update without leaving the page====
===Mark the most urgent work first===
The [[AJAX]] bit means that every time you click on the nodes to expand them, the data for the child nodes is fetched in the background without refreshing the whole page. This saves on loading the whole lot at the start, which could be time consuming. Clicking 'Collapse and refresh' will re-load the whole tree, with an updated count of your marking including anything that was submitted a second or two ago, and excluding any that were marked by someone else and now don't need your attention.
Each course, activity, group, etc has a count of the unmarked work attached. This is broken down into three numbers: recent (within the last 4 days), medium (4-10 days) and overdue (> 10 days). You can quickly see where the oldest pieces of work are and attend to those first. Marking should never take longer than 2 weeks in order to maintain it's relevance, so now you can make sure you never miss any at all.
 
=== Mark quizzes faster by doing all answers to one question in rapid succession ===
The block breaks down quizzes into separate questions before showing you all the students' answers, so you can run through all answers to a particular question quickly, keeping your mind focused on the same thing.
 
==Mark only the things you need to, and hide the rest==
The block provides setting via the config tab and a right-click context menu. The trees update immediately when any changes are made, so you can see what's going on.
 
===Only show work for activities you actually have to mark===
Sometimes there is work waiting to be graded on an activity that you are not supposed to do anything about e.g. work submitted to practice courses, courses with different topic taught by different people, etc. You can hide these activities by either finding them in the config tab and clicking the show/hide icon, or right-clicking the item in the main courses tree. If you do this for  course, it will set all the items in that course to inherit that setting. You can then optionally override the course default for individual activities, but hanging the course level setting will wipe all those overrides out again.
 
===Only show work for your own teaching groups===
Sometimes, several groups are doing an activity, but you only teach some of them e.g. if the same Moodle course activities and resources are shared across multiple teachers and classes. In this case, you can set individual groups to be either visible or hidden for that activity, either by using the config tab, or by right-clicking in the courses tree as for the show/hide settings. Defaults are set at course level with activity level overrides in the same way as for show/hide. If you have your groups set to 'separate groups', then you will automatically only see work from student in groups you are a member of, as mentioned above.


====Only show grading for your own teaching groups====
Some sites run training courses that don't need grading, or a single course with many teachers and teaching groups following the same programme of study. You can easily choose to hide the work that is not your using the '''configure''' link, which will open a pop up allowing you to show or hide each item individually, or choose to show only the work of some groups, so you only ever see the work that you actually need to mark.


==Installation==
==Installation==
Download the zip file [http://moodle.org/mod/data/view.php?d=13&rid=1459&filter=1 here]. Copy it to your /blocks/ folder and unzip it there. Then, go to the notifications screen (Front page -> administration block -> notifications) where you should see a message about the tables having been set up correctly.
Get the files into the blocks/jax_marking diretory, then go to the notifications screen (Front page -> administration block -> notifications) where you should see a message about the tables having been set up correctly.
 
How to get the files:


==Roles and permissions==
=== Zip file ===
Note that you will not get anything displayed at all unless you have a teacher role in a course. This course will also need to be one that has gradable items like assignments or forums with ratings, or you will get an error saying that you have no graded assessments yet.
Download the right zip file [http://moodle.org/plugins/pluginversions.php?plugin=block_ajax_marking here]. Copy it to your /blocks/ folder and unzip it there.  


If you want to see all of the items in all of the courses across the site, add yourself as a teacher under   Front page Admin block -> users -> permissions -> assign site wide roles
=== Git ===
The gihub repository is [https://github.com/mattgibson/moodle-block_ajax_marking here]. Use the following command to get the latest version onto your system:
  cd /path/to/your/moodle/blocks
   git clone https://github.com/mattgibson/moodle-block_ajax_marking.git ajax_marking
  cd ajax_marking
  git checkout MOODLE_22_STABLE


A fix so that admins see everything without doing this is on the way (CONTRIB-1017)


===Configuring the display of each individual assessment item===
== Troubleshooting ==
The block can be set to show or hide each individual assessment item, or show only the assessments by students in certain groups. Clicking on '''configure''' will bring up an additional tree, which shows all of your courses and names of all the assessment items. When you click on one of the assessments, you will be faced with a number of options on the right:
If you can't see the work you think you ought to, there are a few reasons for this. Try the following:
* Show - the default state, where you will see all students' work
* You are an admin and the courses you are looking at have work, but you are not enrolled as a teacher in them. This is to prevent site admins from seeing thousands upon thousands of items unnecessarily. Adding yourself as a teacher in a category will work for the courses within it, but not at site level.
* Show by group - a set of checkboxes will appear with the names of the current groups for that course. You choose which you want to see and group nodes will then be shown between the assessment and student nodes in the main block. The nodes for that assessment will then look like this: '''Course -> Assessment -> Group -> Submission'''
* You have your course or activity set to 'separate groups' and you are not in the same groups as the students whose work you can't see. Many people use this technique to hide classes from teachers who don't teach them, so I've set the block up to respect this. Join all the groups in the course and you should be fine.
* Hide - do not display any submissions for this assessment item.
* You have used the AJAX Marking Block's configuration tab to set some items to 'hide' or set some groups to 'hide'. To reset the settings, you can either run an SQL query like this: DELETE FROM mdl_block_ajax_marking where userid = <youruserid> or, you can check the config tab and set all the course level things to hide and back again. This will work because changing the course level settings destroys all the overrides at activity level. Don't forget to do the same with any groups.
* The work you are looking for is from a module that is not supported (yet). The list is below: I am aiming to support any and all modules once I have finished the core block features that I have in mind. Hopefully, by the start of June 2012, this will be done and all modules that can be marked will appear.


The counting of unmarked submissions respects these choices and they are specific to the user who created them. If you are an admin and wish to set the preferences for others, use the 'login as' function to do so.


==Supported types==
==Supported types==
Line 36: Line 51:
* Forum (only if ratings are on)
* Forum (only if ratings are on)
* Workshop
* Workshop
* Journal (1.9 only)
* Quiz (essay questions only)
* Quiz (essay questions only)



Latest revision as of 11:40, 20 April 2012

The AJAX marking block allows you to view and grade all of your marking without leaving the page you are on. It displays all the ungraded work you need to mark in a tree structure of all of the courses you teach in, along with a count of how many items there are for each course & assessment item. Clicking an item gives you a grading popup, and once you're done, the tree updates itself so you can keep track of what's left.

Ajax marking.png


Prioritise your marking whatever way suits you

Mark all work for a particular class

The block has been built with workflow in mind. If you have a class coming up and need to get their marking done, whatever it is, use the cohorts tab to see all their work across courses. If you are not using cohorts, set the course or activity you are interested in to 'show groups nodes' by either using the config tab, or right-clicking the item where you see it. This will break down the work into separate nodes for each group and you can mark just those.

Mark the most urgent work first

Each course, activity, group, etc has a count of the unmarked work attached. This is broken down into three numbers: recent (within the last 4 days), medium (4-10 days) and overdue (> 10 days). You can quickly see where the oldest pieces of work are and attend to those first. Marking should never take longer than 2 weeks in order to maintain it's relevance, so now you can make sure you never miss any at all.

Mark quizzes faster by doing all answers to one question in rapid succession

The block breaks down quizzes into separate questions before showing you all the students' answers, so you can run through all answers to a particular question quickly, keeping your mind focused on the same thing.

Mark only the things you need to, and hide the rest

The block provides setting via the config tab and a right-click context menu. The trees update immediately when any changes are made, so you can see what's going on.

Only show work for activities you actually have to mark

Sometimes there is work waiting to be graded on an activity that you are not supposed to do anything about e.g. work submitted to practice courses, courses with different topic taught by different people, etc. You can hide these activities by either finding them in the config tab and clicking the show/hide icon, or right-clicking the item in the main courses tree. If you do this for course, it will set all the items in that course to inherit that setting. You can then optionally override the course default for individual activities, but hanging the course level setting will wipe all those overrides out again.

Only show work for your own teaching groups

Sometimes, several groups are doing an activity, but you only teach some of them e.g. if the same Moodle course activities and resources are shared across multiple teachers and classes. In this case, you can set individual groups to be either visible or hidden for that activity, either by using the config tab, or by right-clicking in the courses tree as for the show/hide settings. Defaults are set at course level with activity level overrides in the same way as for show/hide. If you have your groups set to 'separate groups', then you will automatically only see work from student in groups you are a member of, as mentioned above.


Installation

Get the files into the blocks/jax_marking diretory, then go to the notifications screen (Front page -> administration block -> notifications) where you should see a message about the tables having been set up correctly.

How to get the files:

Zip file

Download the right zip file here. Copy it to your /blocks/ folder and unzip it there.

Git

The gihub repository is here. Use the following command to get the latest version onto your system:

 cd /path/to/your/moodle/blocks
 git clone https://github.com/mattgibson/moodle-block_ajax_marking.git ajax_marking
 cd ajax_marking
 git checkout MOODLE_22_STABLE


Troubleshooting

If you can't see the work you think you ought to, there are a few reasons for this. Try the following:

  • You are an admin and the courses you are looking at have work, but you are not enrolled as a teacher in them. This is to prevent site admins from seeing thousands upon thousands of items unnecessarily. Adding yourself as a teacher in a category will work for the courses within it, but not at site level.
  • You have your course or activity set to 'separate groups' and you are not in the same groups as the students whose work you can't see. Many people use this technique to hide classes from teachers who don't teach them, so I've set the block up to respect this. Join all the groups in the course and you should be fine.
  • You have used the AJAX Marking Block's configuration tab to set some items to 'hide' or set some groups to 'hide'. To reset the settings, you can either run an SQL query like this: DELETE FROM mdl_block_ajax_marking where userid = <youruserid> or, you can check the config tab and set all the course level things to hide and back again. This will work because changing the course level settings destroys all the overrides at activity level. Don't forget to do the same with any groups.
  • The work you are looking for is from a module that is not supported (yet). The list is below: I am aiming to support any and all modules once I have finished the core block features that I have in mind. Hopefully, by the start of June 2012, this will be done and all modules that can be marked will appear.


Supported types

  • Assignment
  • Forum (only if ratings are on)
  • Workshop
  • Quiz (essay questions only)

See also

Development:AJAX marking block