MoodleDocs - User contributions [en]

Talk:Creating custom roles

2016-10-12T12:21:35Z

Cburell: /* "Add new role" does not offer "Select template for the new role" */

The Admin breadcrumb ends with "Course managers". This setting is not visible in Site Administration > Appearance. I did an Admin search for "course managers" and it came up empty, so I can't fix it. Just fyi. :)

4. New role considerations

A new role is not automatically listed in course descriptions even if was created by copying a role that is listed, such as Teacher. If you want the new role to appear in the course listing, you must set it explicitly via Administration > Site administration > Appearance > Course managers.

==Thanks Clay==
Thanks Clay for spotting this out of date information which I have now corrected :)
--[[User:Mary Cooch|Mary Cooch]] ([[User talk:Mary Cooch|talk]]) 19:31, 23 September 2014 (WST)

== "Add new role" does not offer "Select template for the new role" ==

Hi,

I'm trying to create a role so teachers can see all the assignments on their students' calendars (to avoid student overload). I reached this roadblock when trying to use this page:

"To create a custom role:

Go to Administration > Site administration > Users > Permissions > Define roles.
Click the "Add a new role" button.
Select template for the new role or upload a preset"

--When I click "Add a new role," all I see is this:

[[File:Add a new role.jpg]]

Documentation would improve by explaining what step(s) to take if no template is available to select.

Thanks!

File:Add a new role.jpg

2016-10-12T12:18:57Z

Cburell: Screenshot of 3.1.2 Add new role

Screenshot of 3.1.2 Add new role

Talk:Creating custom roles

2016-10-12T12:17:33Z

Cburell: /* "Add new role" does not offer "Select template for the new role" */

Talk:Creating custom roles

2016-10-12T12:16:20Z

Cburell: /* "Add new role" does not offer "Select template for the new role" */ new section

The Admin breadcrumb ends with "Course managers". This setting is not visible in Site Administration > Appearance. I did an Admin search for "course managers" and it came up empty, so I can't fix it. Just fyi. :)

4. New role considerations

A new role is not automatically listed in course descriptions even if was created by copying a role that is listed, such as Teacher. If you want the new role to appear in the course listing, you must set it explicitly via Administration > Site administration > Appearance > Course managers.

==Thanks Clay==
Thanks Clay for spotting this out of date information which I have now corrected :)
--[[User:Mary Cooch|Mary Cooch]] ([[User talk:Mary Cooch|talk]]) 19:31, 23 September 2014 (WST)

== "Add new role" does not offer "Select template for the new role" ==

Hi,

I'm trying to create a role so teachers can see all the assignments on their students' calendars (to avoid student overload). I reached this roadblock when trying to use this page:

"To create a custom role:

Go to Administration > Site administration > Users > Permissions > Define roles.
Click the "Add a new role" button.
Select template for the new role or upload a preset"

--When I click "Add a new role," all I see is this:

[[File:Example.jpg]]

== "Add new role" does not offer "Select template for the new role" ==

Hi,

I'm trying to create a role so teachers can see all the assignments on their students' calendars (to avoid student overload). I reached this roadblock when trying to use this page:

"To create a custom role:

Go to Administration > Site administration > Users > Permissions > Define roles.
Click the "Add a new role" button.
Select template for the new role or upload a preset"

--When I click "Add a new role," all I see is this:

[[File:Add a new role.jpg]]

Talk:Creating custom roles

2016-10-12T12:15:04Z

Cburell: /* "Add new role" does not offer "Select template for the new role" */ new section

Scheduler module

2014-11-30T08:51:26Z

Cburell: Changed forum URL to main discussion page. Existing URL went to one discussion only.

{{Infobox plugin
|type = Activity module
|entry = https://moodle.org/plugins/view.php?plugin=mod_scheduler
|tracker = http://tracker.moodle.org/browse/CONTRIB/component/10241
|discussion = https://moodle.org/mod/forum/view.php?id=7139
|maintainer = [[User:Henning Bostelmann|Henning Bostelmann]]
|float = right
}}

The '''Scheduler module''' helps you to schedule one-on-one appointments with all your students. You specify the periods during which you are available to see the students and the length of each appointment. The students then book themselves into one of the available
timeslots. The module also lets you record the attendance and grade the appointment.

==Screens==

* Teacher screens
** [[Scheduler: My Appointments|My appointments]]
** [[Scheduler: All Appointments|All Appointments]]
** [[Scheduler: Adding slots|Adding a slot or a series of slots]]
** Scheduling a student or a group of students
** Adding a student to the slot when scheduling
** Overview (release 1.9 added)
** Statistics
** [[Scheduler: Exporting schedule tables|Exports]]
** View student
*** [[Scheduler: Setting feedback|View of comments]]
*** [[Scheduler: Grading|View of appointments and grades]]

* Student screens
** [[Scheduler : Appointing|Appoint]]

==Features and Defines==

===Scheduling Modes===

The Scheduler module allows two behaviours relative to appointing, depending on configuration settings. When set to "one only", a student can propose a unique appointment. When set to "one at a time", the student may propose one appointment, and will have to wait to be seen, before being able to make a subsequent appointment.

===Slots exclusivity===

A slot may accept an unlimited number of students (say, when scheduling for open meetings), or only one (face-to-face meeting), or may be set to accept a predefined number of students.

===Volatile slots===

A slot may be volatile. If so, it will be deleted from slot list when released by a student or revoked by a teacher.

==Moodle Module standard implementations==

===Settings===

* [[Scheduler Module settings and parameters|Scheduler Module settings]]

===Capabilities===

* [[Scheduler Module capabilities]]

===Backup/Restore===

The module performs complete backup/restore within the course context. Slots are considered as module scope information, while appointments are considered as user related data.

==Additional implementations==

===Notifications===

A notification service (by mail) sends messages to teachers and students about any unilateral change to the agreed appointment.

===Behaviour with groups===

The Scheduler Module uses the standard grouping mode of Moodle to enable or disable features related to groups scheduling. When the group mode of the module is set to "NO GROUPS", all group related adds-on are hidden. When set to "GROUPS VISIBLE" or "SEPARATE GROUPS", all group related features are enabled. For group features to be usable, students in the current course should of course be grouped (obvious).

*'''Teacher side group features'''
**A teacher can schedule on a group basis rather than on a per student basis. When scheduling a full group, the exclusivity status of the time slot changes to fit the group size. The appointment of the group locks definitively the time slot for that group. Notifications are handled individually, just as if each student had made the appointment.

*'''Student side group features'''
**A student can schedule an appointment for one of the groups he belongs to. When choosing this option, he will make the appointment for all colleagues in the group, locking the slot exclusively at that number of users. In order for a student to schedule a group, he will have to belong to at least one group in the course. In the special case where he belongs to several groups and he wishes to make an appointment within a group, he will not be able to make the appointment until he has been seen (one-at-a-time setting) or at all (only-one-time setting).

==Links==
* [https://moodle.org/mod/forum/view.php?id=7139 Scheduler module forum]
* [https://moodle.org/plugins/view.php?plugin=mod_scheduler Plug-in database entry for Scheduler module]

[[Category:Scheduler]]
[[fr:Rendez-Vous]]

Moodle app additional features

2014-11-13T10:32:40Z

Cburell: Added admin user add token detail: be sure "Moodle mobile additional services features" is toggled before creating token.

{{Mobile}}
{{Infobox plugin
|type = Local plugin
|entry = http://moodle.org/plugins/view.php?plugin=local_mobile
|tracker = https://tracker.moodle.org/browse/CONTRIB/component/13930
|discussion = http://moodle.org/mod/forum/view.php?id=
|maintainer = [[User:Juan Leyva|Juan Leyva]]
}}

Local plugin for adding new features to the current Moodle Mobile app ([https://moodle.org/plugins/view.php?plugin=local_mobile Plugin download link])

This add-on provides new features and web services which are currently only available in the latest Moodle version.

== How it works ==

Once installed the plugin creates a new service "Moodle Mobile additional features".

The Mobile app checks if this service is enabled. If not, the Mobile app falls backs to the standard core Mobile app service.

== Features ==

* Support for sites using SSO authentication methods (Shibboleth and CAS)
* Retrieval of course grades

=== Enable authentication for sites using SSO methods (like Shibboleth and CAS) ===

VERY IMPORTANT NOTE: You need to disable the "Auto login guest" option "autologinguests". This setting is not compatible with the SSO via app.

SSO is not supported in the Windows 8 and Windows Phone 8 apps

Once the plugin is installed, you need to go to Site administration > Plugins > Local plugins > Moodle Mobile additional features

There you can choose the "Type of login":

- Via the app: Is the default login, the user must introduce his credentials in the app

- Via a browser window: A new browser instance is open in the mobile device pointing to the login form in the Moodle site. The user must introduce his credentials there. This is the option that must be selected for sites using SSO methods (or for sites that wants to force the user to authenticate in the site, not in the app)

<mediaplayer>https://www.youtube.com/watch?v=cl8rsyyyg9g</mediaplayer>

=== Push notifications ===

If you want to enable Push notifications in Moodle sites prior to version 2.6 this plugin must be installed.

See [[Mobile app Push Notifications]] for more information

== Installation ==

1. Unpack the zip file into the local/ directory. A new directory will be created called local/mobile.

2. Go to Site administration > Notifications to complete the plugin installation.

3. Go to Site administration > Plugins > Web services > Mobile, enable "Enable web services for mobile devices" (Remember to save the changes)

4. Go to Site administration > Plugins > Web services > External services, edit "Moodle Mobile additional features" and check the "Enabled" field, then save changes.

5. Go to Site administration > Users >Permissions Define roles, edit the Authenticated user role and allow the capability moodle/webservice:createtoken.

Note: You need to have upgraded the Moodle Mobile app to version 1.4.4.

If you are currently using the Moodle Mobile app, you will need to log out of all your sites in order for the app to detect the new service.

== Admin users, please read ==

This plugin installs a new service in your Moodle installation, the automatic token creation for this type of services is forbidden for admin users. This means that admin users will not be able to use the Mobile app.

This can be solved easily, administrators must create a token manually in Moodle (Plugins > Web Services > Manage tokens) for the local_mobile service. '''Note:''' Be sure to toggle the default "Moodle mobile web services" setting to "Moodle mobile additional features service" before creating the token.

[[de:Mobile App - Zusatzfeatures]]
[[es:Características adicionales de Moodle Mobile]]

Authentication FAQ

2014-10-06T18:02:58Z

Cburell: Added "no emails sent on email-based self-registration" FAQ and link to excellent forum post for troubleshooting/fix

{{Authentication}}
==What is an authentication plugin?==

An authentication plugin is a method of handling user authentication i.e. enabling certain people to login to your Moodle site.

==How do I enable the "Create new account" button on the login page?==

To display the "Is this your first time here?" instructions and the "Create new account" button:

# Make sure that the [[Email-based self-registration|email-based self-registration plugin]] (or any other plugin that can support self-registration, such as LDAP) is enabled in '' Settings>Site administration > Plugins > Authentication > [[Manage authentication]]''.
# Select the self-registration plugin in the Common settings.

Warning: Enabling self registration results in the possibility of spammers creating accounts in order to use forum posts, blog entries etc. for spam. See [[Reducing spam in Moodle]] for ways of minimizing the risk.

==How can I change the "Is this your first time here?" instructions?==

#Access ''Settings > Site administration > Plugins > Authentication > Manage authentication''.
#Write the instructions in the ''auth_instructions'' text field.
#Click the "Save changes" button at the bottom of the page.

An alternative method of providing custom login instructions is to edit the default login instructions using the language customization feature. This method should be used if you wish to provide custom login instructions in more than one language. See [[Managing authentication]] for further details.

==How do I set up LDAP authentication?==

See [[LDAP authentication]] for full instructions.

==How is the "No login" authentication plugin used?==

The [[No login]] authentication plugin can be used to suspend particular user accounts. To do so:

# Access the user's profile page.
# In the Settings block, click "Edit profile".
# Select "No login" as the authentication method. (If the setting isn't shown, click the "Show advanced" button to reveal it.)
# Click the "Update profile" button at the bottom of the page.

==What is the difference between enabling the email-based self-registration auth plugin and selecting it as the self registration method?==

The [[Email-based self-registration| email-based self-registration authentication plugin]] must be enabled to allow users who previously self-registered to login.

Selecting email-based self-registration as the self registration method allows potential users to self register.

Warning: Enabling self registration results in the possibility of spammers creating accounts in order to use forum posts, blog entries etc. for spam. This risk can be minimized by limiting self registration to particular email domains with the allowed email domains setting in ''Settings > Site administration > Plugins> Authentication > [[Authentication|Manage authentication]]''. Alternatively, self registration may be enabled for a short period of time to allow users to create accounts, and then later disabled.

There is some discussion about having admin approval or new accounts created this way here: http://tracker.moodle.org/browse/CONTRIB-1444

==Why isn't the Email-Based Self-Registration sending emails?==

Good troubleshooting fix here: [https://moodle.org/mod/forum/discuss.php?d=271188#p1170455]

==How can I create an authentication plugin?==

See [[Development:Authentication plugins]].

==How can students without email addresses create new Moodle accounts?==

See [[No Email]].

==My students are too young to have emails, but it's a required field - what do I do?==
You can either use a fake email address when you upload the CSV file of your young students - or -
#Upload a CSV file without an email field. When previewing the accounts, set "Prevent email address duplicates" to ''No''.
#In "Default values", type in an email address.
#When the users are uploaded, they will all have the same email address. (It will say "duplicated" but the accounts will work)

==Where are users' details stored?==

Users' details can be stored in local Moodle database or externally.

If Users' details are stored in the local Moodle database, it is called "internal authentication". Storing users' details externally is called "external authentication".

==Can you arrange for an e-mail to be sent to notify Users of new accounts?==
If you are creating ONE manual account, then no.

See Feature request here: http://tracker.moodle.org/browse/MDL-19390

See discussion http://moodle.org/mod/forum/discuss.php?d=117005

Bulk upload can be set up to send e-mails: see the discussion here: http://moodle.org/mod/forum/discuss.php?d=85333 (Which includes a code hack to do this as well. (Also http://moodle.org/mod/forum/discuss.php?d=125000)

==Can you arrange for Admins to be notified of new self registrations==
See this discussion: http://moodle.org/mod/forum/discuss.php?d=212648

==How can I have users logging in with their email address?==

See this Forum thread: [http://moodle.org/mod/forum/discuss.php?d=199457#p869691 Logging in Using Email or Username]

==How can I allow users to bypass NTML SSO?==

When NTLM SSO is enabled on a Moodle site the SSO function always logs the user who is logged into the computer into Moodle. Sometimes you may need to override this feature and login to Moodle as another user. Example: when a teacher or site administrator needs to login to the students computer to troubleshoot a problem. Or the teacher simply needs to access functionality that is not available to the student and the teacher is not anywhere near her own computer.

The problem is that the Moodle logout option is not available when SSO is enabled - the user simply gets logged back into Moodle. To bypass the SSO you can add this to the url:

<code>/login/index.php?authldap_skipntlmsso=1</code>

Example: http://yourschool.com/login/index.php?authldap_skipntlmsso=1

The NTLM SSO will be disabled (for this login only) and you will get the regular Moodle login page.

{{warning|message=This bypass won't work if you have the [[Site policies#Force users to login|''Force users to login'' site policy]] enabled. In that case, SSO is applied to all pages on the site, including the log in and log out pages.}}

See the Using Moodle [http://moodle.org/mod/forum/discuss.php?d=200641 Bypass NTML SSO for Moode 2.2] forum discussion for details.

==Can I change manual accounts to LDAP?==
Yes. See this blog post on [http://www.schoolanywhere.co.uk/blog/how-to-change-manual-user-accounts-to-ldap/#more-828 Changing manual accounts to LDAP] using MySQL database
==See also==

* Using Moodle [http://moodle.org/mod/forum/view.php?id=42 User authentication forum]
* [[Accounts FAQ]]

[[Category:FAQ]]

[[de:Authentifizierung FAQ]]

Email-based self-registration

2014-10-06T17:58:09Z

Cburell: Added link to forum post on "no emails being sent"

{{Authentication}}
The email-based self-registration authentication method enables users to create their own accounts via the 'Create new account' button on the login page. They then receive an email at the address they specified in their account profile to confirm their account.

==Enabling email-based self-registration==

An administrator can enable email-based self-registration in ''Administration > Site administration > Plugins > Authentication > Manage authentication''.

In addition to enabling the plugin, email-based self-registration must be selected from the self registration drop-down menu in the common settings which is further down the same page, underneath the authentication plugins.

Warning: Enabling self registration results in the possibility of spammers creating accounts in order to use forum posts, blog entries etc. for spam. This risk can be minimized by limiting self registration to particular email domains with the allowed email domains setting in ''Administration > Site administration > Plugins> Authentication > Manage authentication''. Alternatively, self registration may be enabled for a short period of time to allow users to create accounts, and then later disabled.

Note: The Email-based self-registration authentication plugin must be enabled to allow users who previously self-registered to login. Selecting Email-based self-registration as the self registration method allows potential users to self register.

{|
|[[File:Emailbased.png|thumb|left|Login page with 'Create new account' button]]
|}

==Enable reCAPTCHA element==

[[Image:New account form with captcha element.png|thumb|New account form with CAPTCHA element]]
A CAPTCHA is a program that can tell whether its user is a human or a computer. CAPTCHAs are used by many websites to prevent abuse from bots, or automated programs usually written to generate spam. No computer program can read distorted text as well as humans can, so bots cannot navigate sites protected by CAPTCHAs.

Spam protection may be added to the email-based self-registration new account form with a CAPTCHA element - a challenge-response test used to determine whether the user is human.

In addition to enabling the reCAPTCHA element, email-based self-registration should be set as the self registration authentication plugin and reCAPTCHA keys should be set in the manage authentication common settings.

==Email confirmation message==

An automated email confirmation message is sent to the user using the support contact email address.

You can change this text in ''Administration > Site administration > Language > Language customization'' by choosing the appropriate language pack. selecting 'moodle.php' from 'core' and searching for the string identifier name 'emailconfirmation' and editing it with a local customization.

{|
|[[File:emailconfirmationstring25.png|thumb|Editing the email confirmation message]]
|}

==Support contact==

An administrator can specify a support name, email and/or support page in ''Administration > Site administration > Server > Support contact'' for including in the confirmation email.

==Tips==

* Check your user list regularly for spammy/suspect names/emails and/or users in the system but not enrolled in the course
* Disable [[Blogs]] unless actually using them; some spambots know how to post there
* Enable some sort of login failure notification in ''Administration > Site administration > Security > Notifications'' so you can see who is having login issues
* Check ''Administration > Site administration > Reports > Spam cleaner'' from time to time
* Potential users may not receive the account confirmation email due to it ending up in the spam folder, being refused by the remote server, an invalid email address entered etc. Such accounts may be confirmed manually by an admin.

==See also==

*[[No Email]]

Using Moodle forum discussions:
* [http://moodle.org/mod/forum/discuss.php?d=97938 Admin approving self registrations?]
* [http://moodle.org/mod/forum/discuss.php?d=80518 Sending the email confirmation again]
* [http://moodle.org/mod/forum/discuss.php?d=92958 Self registration with validation]
* [https://moodle.org/mod/forum/discuss.php?d=271310 "Password Reset" email blocked by email servers]
* [https://moodle.org/mod/forum/discuss.php?d=271188#p1170455 Email-Based Self-Registration not sending emails: things to know]

[[de:E-Mail-basierte Selbstregistrierung]]
[[es:Auto-registro_basado_en_Email]]
[[fr:Authentification par courriel]]
[[ja:Eメールによる自己登録]]

Talk:Plagiarism Prevention Turnitin Settings

2014-09-24T17:51:06Z

Cburell: Turnitin email message seems outdated--help needed.

This instruction seems to need updating, yes?

Activation of your Turnitin Account

obtain a Turnitin Subscription from www.turnitin.com
Email your Turnitin Account rep or the Turnitin helpdesk (turnitinsupport@turnitin.com) and paste this text into the e-mail:
'''
Please manually enable our Turnitin account to allow the use of the Turnitin Plagiarism plugin for Moodle 2.0 written by Dan Marsden from Catalyst IT.

We are aware of the Turnitin Basic, Turnitin Direct plugins and the new plugin planned to replace Dan Marsdens plugin but wish to use the older plug-in provided from Dan Marsden/Catalyst IT until the new one is available.'''

I'm trying to set up the Turnitin Assignment plugin but the documentation seems to invite confusion. Please let me know if I'm wrong, thanks.

Talk:Creating custom roles

2014-09-23T11:26:10Z

Cburell: No "course managers" page in Admin settings. Can't find "Course managers"

Grades FAQ

2014-09-14T14:47:34Z

Cburell: /* How do students see the Assignment module Rubric marks and feedback from their teacher? */ Changed question and provided answer :)

{{Grades}}
== General ==

===How can I change how grades are displayed?===

Grades may be displayed as as actual grades, as percentages (in reference to the minimum and maximum grades) or as letters.

The default grade display type for the site is set by an administrator in ''Administration > Grades > [[Grade item settings]]''. However, this may be changed at course level.

To change how grades are displayed for particular [[Grade items|grade items]], or category and course summaries (called aggregations):

# Follow the grades link in the Course administration block.
# Select "Categories and items" from the gradebook dropdown menu.
# Click the edit icon for the grade item, category total or course total.
# From the Grade display type menu, select real (for actual grades), percentage or letter.
# Click the "Save changes" button at the bottom of the page.

Alternatively, to change how grades are displayed for the whole course:

# Follow the grades link in the course administration block.
# Select "Course settings" from the gradebook dropdown menu.
# From the Grade display type menu, select real (for actual grades), percentage or letter.
# Click the "Save changes" button.

===How can I hide entered grades until a specified date?===

To set a "Hidden until" date:

#Access the course gradebook via the grades link in the course administration block.
#Select "Categories and items" from the gradebook dropdown menu.
#Click on the edit icon opposite the activity for which a "Hidden until" date is to be set.
#On the edit grade item page, ensure that advanced settings are displayed. (Click the "Show advanced" button if not.)
#Enable the "Hidden until" setting by unchecking the disable checkbox, then set a date.
#Click the "Save changes" button.

=== Is it possible to show the teachers/administrators' grades in the grader report? ===
Yes, at the site level you can define which roles will appear in the grader report. This can be found in [[General_grade_settings#Graded_Roles|Administration > Grades > General settings]]. Also read [http://moodle.org/mod/forum/discuss.php?d=92612 this discussion] for some more ideas.

===Why can't I change a grade within an assignment after changing it in the gradebook?===

When you edit a grade directly in the gradebook, an "overridden" flag is set, meaning that the grade can no longer be changed from within the assignment.

However, the flag can be removed by turning editing on in the [[Grader report|grader report]], then clicking the [[Grade editing|edit grade]] icon, unchecking the overridden box and saving the changes.

===How do I get groups to show up in the grader report?===

For groups to show up in the grader report, group mode should be set to visible or separate groups in the [[Course settings|course settings]]. This will result in a groups dropdown menu being displayed, enabling a teacher to view the grades of all participants, or only the grades for a selected group.

===The quiz grades keep disappearing from the student view, even after I un-hide them!===

Check your quiz settings. Under the '''Review options''' heading, in the '''Later, while the quiz is still open''' and/or the '''After the quiz is closed''' columns, you probably have Scores un-checked. Each time a student completes a quiz, these settings are consulted and the scores will be hidden from ''all'' students. If your students don't all take the quiz at the same time, it can look like quiz scores reset themselves to 'hidden' randomly, even after you un-hide them.

===How can I make the gradebook simpler for teachers?===

See [[Simplifying the gradebook by changing permissions]].

==Grades and user removals==

===What happens to gradebook data when a user is unenrolled from a course?===
On re-enrolling, you can recover their grades from before: see [https://docs.moodle.org/24/en/Grade_settings#Recover_grades_default Recover grades on re-enrol]

===What happens to gradebook data when a user is deleted from the Moodle site?===

==Advanced grading==

===Why can't I see the advanced grading option??===
To see the option for Advanced grading, you first have to create an assignment and choose Advanced grading/Rubric from the gGading method dropdown. Advanced grading will then appear in ''Settings>Assignment administration.''
===How can I allow teachers to save rubrics as templates for others?===
Create a new role and assign it in the system context. Give this role the capability ''moodle/grade:sharegradingforms'' (for sharing as a template) and if desired ''moodle/grade:managesharedforms'' (for editing or deleting templates created by others) Assign this role to those teachers you wish to have this ability.

===How do students see the Marking guide?===
Assuming the teacher has allowed this in the [[Marking guide]] settings, the student may click "submissions grading" under the assignment name in their navigation block:

[[File:submissionsgrading.png]]

===Why can't students see feedback when Blind Marking is used?===
If you use '''Blind Marking''' to conceal student identities when assessing in the Assignment module, it waits until ''all'' submissions are marked, and '''reveal student identities''' is clicked, to enter final grades into the Gradebook. Only at this point does it release Rubric marks/comments and inline feedback for student view (if Advanced Grading: Rubrics and Inline Comment Feedback are used in the Assignment).

== Reports ==
=== How do I create my own custom gradebook reports? ===
Here is a [[Development:Gradebook_Report_Tutorial|tutorial]] explaining all the main steps involved.
===How can I sort or change the order of column headings?===
Go to Grades link, then select one of the "Category & items" actions from the pulldown on the top left. Use the move icon to change the position of the graded item. And/or you could create categories for the items and move them into a category so they will be grouped that way first.

===How can I remove user ID numbers and/or email addresses from the grader report===

Go to ''Settings > Site administration > Users > Permissions > [[Roles settings|User policies]]'' and untick the 'ID number' and/or 'email address' checkboxes for 'Show user identity'.

Note that this will result in ID numbers and/or email addresses not being shown when searching for users and displaying lists of users. See the section 'Show user identity' in [[Roles settings]] for a list of locations where user identity fields are shown.

=== How can I interpret the quiz report statistics?===

See [https://docs.moodle.org/dev/Quiz_report_statistics Quiz report statistics] in the developers documentation.

== Aggregation ==
=== I can't find where to change the aggregation type for my gradebook categories! ===
Each category has an aggregation type, which can be changed through that category's "edit" page. To access that page, you must use one of 2 ways:

1. In the grader report, turn "Editing" on, then click the little "hand" icon next to the category whose aggregation you want to change
2. In the "Edit categories and Items" page (accessible through the "choose an action" menu, top left), you see a tree view of the categories and items in your gradebook. The top category is the course category. Each category also has a "hand" icon, which leads to the category edit page

=== How can I grade some of my activities without the results affecting my students' course total? ===
#Go to Grades and choose the "Category and items" tab.
#Add two [[Grade categories]], one for your "Graded activities" and one for your "Not graded activities". In the "Not graded activities" category choose "None" in grading type.
#Ensure that "Aggregate including subcategories" (an option visible only in "full view") is unchecked for your top level course grade category.
#If you want to completely hide the "Not graded activities" category from your students tick the "Hidden" icon too.
#Save your changes.
#Move all your normally graded activities into the "Graded activities" category.
#Move all your excluded from grading activities into "Not graded activities" category.

'''Note''': Following the above steps the not graded activities will be completely hidden from your students. So...

*'''IF''' you want the activity grades of the "Not graded activities" category, to remain visible to your student without their grades affecting their course total, simply click the eye to show the "Not graded activities" category.

*'''IF''' you want students to be able to see the activity grades and the category total of the "Not graded activities", then you have to let the category visible and also choose a grading type between value, scale or text, by editing the category.

In this case you can exclude the "Not graded activities" from course total using the "Weighted mean of grades" aggregation method in Course category and assigning 100 weight to the "Graded activities" and 0 weight to the "Not graded activities".

*'''IF''' you don't want to use grade categories, you can also exclude the grades of a specific activity by changing the "Multiplicator" (visible only in "full view") from 1.0 into 0.0.

*Last, '''IF''' you want to exclude the grade of an activity only to one or some specific students, then follow these steps:
#From the grader report "Turn editing on"
#Click the "Edit grade" icon of the activity of the student you want to exclude.
#In the Edit grade page, check the tick box next to the "Excluded" option and "Save changes".

=== My student completed only one activity out of 5, but his course total shows 100%. How do I show a more "progressive" course total? ===

==== Step-by-Step Explanation ====
# From the view menu in the gradeboook, select "Categories and items"
# At the top line there is a folder icon and an edit icon on the right, click the edit icon
# You'll then see the title "Grade category," the 3rd item is "Aggregate only non-empty grades."
# Uncheck this.
# Save.

==== Another Explanation ====
By default, only non-empty grades are aggregated, the others are ignored. However, you can change this setting as well as others that affect the course total, by turning "Editing" on in the grader report, and clicking the "Edit" icon next to the course category (the very top row of the grader report).

You can untick the box "Aggregate only non-empty grades" if you want to show a more "progressive" score for each student. Their empty grades will count as a 0 and will be counted in the course mean/total.

If you prefer to show a sum of points, rather than a percentage, you can change the course category's aggregation method to "Sum of grades".

=== How can I display the average grade for my course categories (not grade categories)? ===
In Moodle 1.9 there is no way to aggregate course totals within each category. The gradebook is course-centered, and there is currently no User Interface for showing grades within an entire course category at once.

=== How can I setup weighted assignments? ===
See [[Using "Weighted Mean of Grades" to weight categories containing assignments]].

=== Why is the Category Total blank for one of my categories? ===
One possibility is that you accidentally entered some grades into the Category Total column and then erased them. When you do that, an override flag gets set and then the totals won't calculate. Here's how to check, and fix it:

# Go to the [[Grader report]] view of the gradebook.
# Click the "Turn editing on" button for the gradebook. (There's a separate one for the gradebook from the one on the main page.)
# Find the box for the problem category and the first student affected.
# Click on the icon of a gear *in that box*.
# See if the box marked "[[Grade_editing#Overridden|Overridden]]" (third line down) is checked. If it is, uncheck it.
# Repeat (4) and (5) for each student affected,

== Categories ==
=== How many depths of categories/subcategories can I create? ===
There is no programmatic limit, but there are practical limits. Very deeply nested structures are difficult to manage. 3 levels of categories should be sufficient for most situations. Note that there is always at least one level of categories, since the Course category always encompasses all other categories and grade items, can cannot be deleted.

=== I can't find setting X in the grade category edit page! Where is it? ===
If a setting documented on the [[Grade categories]] page does not appear on your edit page, it may mean that it is set globally in your site. See [[Grade_category_settings#Forcing_settings|Forcing settings]] for more information.

== Outcomes ==
=== I want to set up an outcome item for my course. What are the steps required? ===
#The site administrator needs to have enabled outcomes via ''Settings>Site Aaministration > Advanced Features >Enable Outcomes''
#In your course, go to ''Settings>Course administration>Grades>Scales'' and create the scale you need.
#[[Scales#Creating_a_new_scale|Create a scale]]
#In Settings>Course administration>Outcomes, create a course outcome assigning it to the scale you just created.
#Read the [[Outcomes| outcomes documentation]] for instructions).
#You can now give your students a rating on the outcome dimension you just created. If you created a standard outcome, you will be able to use it in other courses and follow your students' performance across these courses.

===How can I remove an outcome from an activity?===

An outcome can be removed from an activity by deleting it on the gradebook edit categories and items page. This results in the outcomes being deselected on the update activity page.

== Modules ==
=== The activity module (Module name) doesn't support grading. How can I give my students a grade anyway? ===
You can create a [[Grade_items#Manual_grade_items|grade item]] manually in the gradebook. You will have to grade your students through the [[Grader report]] interface (in editing mode).

=== I just graded some of my students using the (Module name) interface, but the results aren't showing up in the grader report. What's going on? ===
Here are some of the possible reasons:
#The site settings>Grades>General settings may not have the correct graded roles checked off to appear in grade book. If you see no students in the Gradebook but do see columns for the graded activities, then check the graded role settings.
#The corresponding [[Grade items|grade item]] is [[Grade_locking#In_grade_items|locked]], or its parent [[Grade categories|category]] is [[Grade_locking#In_grade_categories|locked]].
#The module code is not using the [[Development:Grades#API_for_communication_with_modules.2Fblocks|gradebook API]] correctly

=== I just created a new assignment with the "Grade" setting set to "No grade", but it still appears in the gradebook ===
The reason is that the gradebook is now the place where both numerical and textual types of feedback are recorded for all activity modules. The word "Grading" in assignment relates only to numerical grades, but the ability to give text feedback remains, and must be recorded in the gradebook. This is why a grade item is created for it. You can hide the grade item if you do not want it to appear in the user reports.

==Weights and extra credits==

===How do weighted grades influence the category or course total?===
A weight (also called coefficient) only has meaning in reference to other weights. If you only have one grade item, changing its weight will not have any effect. However, if you have two grade items, each with a different weight, the "heavier" item will have more influence on the total grade than the "lighter" one.

You can set the weights to any positive numerical value you choose. Usually, at least one of the weights will be 1 and serve as the baseline for other weights. If another item has a weight of 2, its grades will be multiplied by 2 compared with the grades of the first grade item, before being averaged. The denominator used for averaging is the sum of all the weights.

An example follows:
item 1 weight: 1
item 2 weight: 3
item 3 weight: 0.5

item 1 grade: 40/100
item 2 grade: 60/100
item 3 grade: 20/100

Calculation:
total = ((40 * 1) + (60 * 3) + (20 * 0.5)) / (1 + 3 + 0.5)
= (40 + 180 + 10) / (4.5)
= 230 / 4.5
= 51.11

The total for this category will then be 51.11 out of 100

===Do I have to put a value in each "weight" input box?===
No. If you do not put a value, it will default to 1. If all items are set to 1 then they all have equal weight. If you set a weight to 0, the item's grades will not count at all in the category or course average.

===Do all the weights have to add up to 100 or some similar value?===
No, the numbers you put as weights are completely arbitrary. They must be positive numbers, and can add up to anything you want. Note however that the following four sets of weights are identical in value:

(1 1.75 3)
(4 7 12)
(8 14 24)
(400 700 1200)

===What is the difference between Weight and Extra Credit?===
Weight is only available with "Weighted mean of grades". For the "Simple weighted mean of grades", the weight is taken from the grade item's maximum grade. A weight is used to give a grade item more or less importance in the computation of the category total or average, compared with the other items of the same category.

Extra credit replaces grade item weight if the aggregation method is "Mean of grades (with extra credits)", "Sum of grades", or "Simple weighted mean of grades". The effect of extra credit is different in each case, hence some confusion:

*Mean of grades (with extra credits): A value of 0 does nothing. Any other value is used to multiply the grade and add it to the total after the computation of the mean. This grade is not used in the computation of the mean, however, only added afterwards. Additionally, this cannot bring the category total over its maximum grade unless grades over 100% are enabled by the site administrator (since 1.9.5). This grade item is not counted either in the denominator used to compute the category mean.

*Sum of grades: Extra credit is a checkbox, not a number. Normally, with Sum of Grades, the category's maximum grade is the sum of the maximum grades of all its grade items. If one of them is set as "Extra Credit", however, its maximum grade is not added to the category's maximum grade, but its grades will be. This way it is possible to achieve maximum grade (or grades over maximum if enabled by the site administrator) in the category without getting the maximum grade in all the grade items.

*Simple weighted mean of grades: Extra credit is a checkbox, not a number. The "Extra Credit" grades are counted in the numerator used to compute the category mean, but not the denominator. See [[Category_aggregation#Simple_weighted_mean|here]] for more information.

===How do I create an assignment for which students can receive a grade higher than the maximum?===

In Moodle 1.9.5 onwards, a new [[Grade_settings#Unlimited_grades|unlimited grades]] setting in ''Administration > Grades > General settings'' enables administrators to allow teachers to enter grades over 100% directly in the gradebook.

===Why can't I enter a grade higher than the maximum?===

First, check with your administrators to make sure the [[Grade_settings#Unlimited_grades|unlimited grades]] setting is turned on. If that is not the problem, you might be using [[Gradebook_report_settings#Quick_grading_and_quick_feedback|quick grading]]. If that is the problem, you can still enter grades higher than the maximum this way:

# Go to the Moodle gradebook "Grader Report" page.
# Use the button in the upper right to "Turn editing on" if it is not already on.
# In the upper right corner of each box for entering the grade, there should be an icon of a gear. Click on that.
# On the "Edit grade" screen that comes up, there's a box for "Final grade". You should be able to enter any number of points into that, even if it's more than the maximum. (If this is an "[[Grade_items#Activity-based_grade_items|Activity-based grade item]]" such as an Assignment or a Quiz, then you may also have to check the "[[Grade_editing#Overridden|Overridden]]" checkbox.)

If you expect a lot of students to get extra credit, it's probably better to make it a separate grade item and mark it as extra credit instead, or else [[Grade_import|import]] the grades from a spreadsheet.

==Formulas==

===How do I give a fixed score for a successful quiz attempt===

Suppose you want to give 5 points for a passing grade (say, 40) in a certain quiz (which has a maximum score of 100). Possible scenario ([http://moodle.org/mod/forum/discuss.php?d=148576]): extra credit points to every student that gets a "passing grade" in a "practice test" at the end of each chapter covered in the course, to encourage them to practice after the homework quizzes and to get familiar with a "test type" situation before the actual test.

The following formula should do the trick:

=min(round((||quiz||/40)-0.49,0),1)*5

The formula may be added to a designated grade item or category.

Sample calculations:
Score 40 (pass):
=min(round((40/40)-0.49,0),1)*5
=min(round(1-0.49,0),1)*5
=min(round(0.51,0),1)*5
=min(1,1)*5
=1*5
=5

Score 39 (not pass):
=min(round((39/40)-0.49,0),1)*5
=min(round(0.975-0.49,0),1)*5
=min(round(0.485,0),1)*5
=min(0,1)*5
=0*5
=0

Score 100 (pass):
=min(round((100/40)-0.49,0),1)*5
=min(round(2.5-0.49,0),1)*5
=min(round(2.01,0),1)*5
=min(2,1)*5
=1*5
=5

==See also==

*Gradebook Scenarios/Use Cases [https://docs.moodle.org/en/experimental:_gb_tutoring]
*Using Moodle [http://moodle.org/mod/forum/view.php?id=2122 Gradebook forum]

Using Moodle forum discussions:
*[http://moodle.org/mod/forum/discuss.php?d=123143 Excluding practice quizzes from gradebook]
*[http://moodle.org/mod/forum/discuss.php?d=193705 Course total not sum of max grade column?]
*[https://moodle.org/mod/forum/discuss.php?d=167596 Why do only certain items have multiplicator & offset boxes?]
*[https://moodle.org/mod/forum/discuss.php?d=235640 Extra credit]
*[https://moodle.org/mod/forum/discuss.php?d=269534#unread Change grading method only for some students]

[[Category:FAQ]]

[[ca:PMF de les qualificacions]]
[[de:Bewertungen FAQ]]
[[es:Calificaciones FAQ]]
[[fr:FAQ des notes]]
[[ja:評定FAQ]]

Advanced grading methods

2014-09-14T14:41:08Z

Cburell: /* How to let students see rubric marks and feedback after submission */

{{Grades}}'''Advanced grading methods''' enable various assessment forms to be used for calculating grades.

[[image:comicstrip-rubrics.png|600px|They should also have plagiarism plugins installed and apply them to control lazy course content creators.]]

==Advanced grading method types==

* [[Rubrics]]
* [[Marking guide]]

There are also add-ons available in the 'See also' section below.
== Basic concepts ==

By default, numerical grades in Moodle are selected by the teacher from a range like 0-100. When advanced grading methods are enabled, the grade selection element is replaced with a more complex assessment form provided by the plugin. The plugin contains the logic how to calculate the grade. Such a calculated grade is then passed back to the activity module as if the teacher used the standard grade value selector.

:''Example:'' The teacher creates new Assignment in the course with the grade up to 30. She defines a rubric to be used for grading. The rubric itself produces raw score up to 12 (eg it has four criteria with levels 0, 1, 2, 3). So the rubric's score 12 leads to the assignment grade 30, the score 6 leads to the grade 15 etc.

For each activity, a new copy of the assessment form is created. Note that this is different from how [[Scales|scales]] work. While scales are defined at the site level or course level and then can be used in all activities, advanced grading forms create a new copy of the form definition for every single activity that uses it. So a change in the form definition in one assignment does not affect other places where the same rubric is used.

:''Example:'' The teacher defines a rubric for an assignment in the course. Then she re-uses the rubric in another assignment (see below on how to do this). When the teacher modifies the rubric in the second assignment, the first assignment still uses the original rubric.

The grading form definition is part of the activity data. It is included in the activity's backup and it is copied when the activity is duplicated via the "x2" icon or imported from another course.

== Configuring an activity module to use advanced grading methods ==

[[image:grading-method-selection-modform.png|thumb|right|Choosing the grading method in the activity settings form.]]

Modules that support advanced grading methods have the grading method selector included in their settings form (for example in the [[Assignment settings]] form). The teacher can choose either 'Simple direct grading' or one of the installed grading methods plugins. Selecting 'Simple direct grading' means that the advanced grading is not used and the standard grade selector is displayed.

Alternative way is to follow the link 'Advanced grading' in ''Administration > Activity administration''. The link leads to a page where the current active grading method can be changed, too.

The form definition and the associated assessment data are stashed when the grading method is changed from one type to another. That means it is safe to change the current active grading method from 'Rubric' to 'Simple direct grading' and back to 'Rubric'. The rubric definition is kept in the database, although it may not be available while the current grading method is set to some other method.

== Assessment form definition ==

[[image:grading-manage-initial.png|thumb|right|Grading method management screen (no assessment form of the selected type is not defined yet).]]

The link 'Advance grading' in the activity settings form leads to a management screen where the assessment form can be defined, edited, deleted and eventually shared as a public template (if the user has such permission). If there is no form of the selected method defined yet, there are two options:

* Define new grading form from scratch - creates a blank grading form and lets you define it. Each grading plugin provides its own grading form editor.
* Create new grading form from a template - lets you re-use a previously defined form. You can copy any of your own grading forms (that is those you have created elsewhere) or a grading form that was shared as a public template at your site.

Every grading form has a name and a description. These are not displayed to students. The description should summarize the form, explain its usage etc.

The grading form definition can be saved as a draft or as a final version. If the grading form is saved as a draft, it can't be used for assessing. To release the form and make it available to assessment, save it using the button 'Save and make it ready'. The current status of the form definition is indicated via a tag displayed next to the form name.

=== Modifying the form after it has been used ===

It may happen that you define a grading form, make it ready for usage and start assessing students with it. After some time you realize there is a typo in the form or that it should be actually improved significantly (like by adding another criterion into the rubric). In such case, you are about to edit a form that has already been used for assessment.

If the grading plugin considers your change as significant, it may force you to mark all current assessment with a special flag 'Needs review'. It is your duty to go through all existing assessments made by the previous version of the form and re-assess them to make the calculated grades valid a comparable. If the change seems to be a trivial change (eg fixing a typo in the text), the form editor may ask you to decide whether the existing assessment should be marked with the 'Needs review' flag or not.

Please note, when there are other people using the form for assessment (eg there are several non-editing teachers in the course who participate on the submissions assessment), even a trivial rewording can be understood as significant change in the criterion meaning. Make sure you communicate the changes well with your colleagues.

== Re-using assessment forms ==

[[image:grading-pick-search.png|thumb|right|Searching for a grading form to re-use]]

Instead of defining the new grading form from scratch, you can use some existing form as the initial template to create it from. When clicking the 'Create new grading form from a template' icon, a new page opens and you can search for a grading form there. Simply type words that should appear somewhere in the form name, its description or the form body itself. To search for a phrase, wrap the whole query in double quotes.

=== Shared templates ===

Users who were given a special permission can save their grading forms as shared templates on the site. Such forms can be then picked and re-used by all teachers in their courses. Users who published the form as a template can also delete it from the list of shared templates. See [[Grading forms publisher]] for more information. There is also another permission to manage the whole "bank" of shared template. Users with this permission can delete any shared template, even if they are not the authors of it. See [[Grading forms manager]] for more information.

Grading forms can be shared at the site level only. There is no way how to share forms at lower context levels (eg at the course category level as the question bank does).

=== Re-using own forms without sharing them ===

[[image:grading-pick-ownform.png|thumb|right|Re-using a form that was previously used in another activity]]

By default, only the grading forms that have been saved as shared templates are included in the search results. You can also include all your own grading forms in the search results. This way, you can simply re-use your grading forms without sharing them. Only forms marked as 'Ready for usage' can be re-used this way.

=== Permissions ===

There are two capabilities that affect the user's permission to work with templates.

* Share advanced grading form as a template ([[Capabilities/moodle/grade:sharegradingforms|moodle/grade:sharegradingforms]]) - grants the ability to save a grading form as a new shared template and eventually edit and remove own templates (templates originally shared by that user). Users with the role of manager are given this permission by default. To allow others to do this, see [[Grading forms publisher]].
* Manage advanced grading form templates ([[Capabilities/moodle/grade:managesharedforms|moodle/grade:managesharedforms]]) - grants the ability to edit and remove any shared template, even those originally shared by other users. To allow trusted teachers to do this, see [[Grading forms manager]].

=== Sharing your grading forms world-wide ===

At the moment, there is no way how to export/import grading form definitions. The known workaround is to create an empty assignment module and attach the grading form to it. Then make a standard activity backup of this assignment in the MBZ format and share it. By restoring the assignment, the attached grading form is restored, too. It can be then picked for your own activities or shared as a template at your site.

==What the students see==

When students click on an assignment which has a rubric or marking guide attached to it, they will see the rubric or marking guide as part of the information about their assignment.

{|
|[[File:rubricbeforesubmission.png|thumb|Student view of rubric '''before''' submission]]
|}

==Rubric feedback for student view when Blind Marking is used==
Note: When '''blind marking''' is used, students ''will'' receive a notification, but will ''not'' see rubric feedback until ''all'' submissions are marked and '''reveal student identities''' is clicked. That releases rubric marks and inline comment feedback to all students.

==The future of advanced grading methods==

Advanced grading methods can currently only be used for [[Assignment module|assignments]]. In future Moodle versions it is hoped that they can be used in more activity modules, such as glossaries and database activities. In addition more grading methods can be implemented as independent plugins (including custom ones fitting your particular need).

==See also==
* [[Learning Analytics Enriched Rubric]]
* [[BTEC marking]] for use with Moodle assignments

Using Moodle forum discussions:
* [http://moodle.org/mod/forum/discuss.php?d=193460 A few Advanced Grading questions for Moodle 2.2.1]
* [http://moodle.org/mod/forum/discuss.php?d=193961 Wrong Gradebook Calculation from 2.2 Rubric]

[[de:Erweiterte Bewertungsmethoden]]
[[es:Métodos avanzados de calificar]]

Advanced grading methods

2014-09-14T14:39:18Z

Cburell: /* How to let students see rubric marks and feedback after submission */ Explained effect of Blind Marking on revealing rubric feedback to students.

{{Grades}}'''Advanced grading methods''' enable various assessment forms to be used for calculating grades.

[[image:comicstrip-rubrics.png|600px|They should also have plagiarism plugins installed and apply them to control lazy course content creators.]]

==Advanced grading method types==

* [[Rubrics]]
* [[Marking guide]]

There are also add-ons available in the 'See also' section below.
== Basic concepts ==

By default, numerical grades in Moodle are selected by the teacher from a range like 0-100. When advanced grading methods are enabled, the grade selection element is replaced with a more complex assessment form provided by the plugin. The plugin contains the logic how to calculate the grade. Such a calculated grade is then passed back to the activity module as if the teacher used the standard grade value selector.

:''Example:'' The teacher creates new Assignment in the course with the grade up to 30. She defines a rubric to be used for grading. The rubric itself produces raw score up to 12 (eg it has four criteria with levels 0, 1, 2, 3). So the rubric's score 12 leads to the assignment grade 30, the score 6 leads to the grade 15 etc.

For each activity, a new copy of the assessment form is created. Note that this is different from how [[Scales|scales]] work. While scales are defined at the site level or course level and then can be used in all activities, advanced grading forms create a new copy of the form definition for every single activity that uses it. So a change in the form definition in one assignment does not affect other places where the same rubric is used.

:''Example:'' The teacher defines a rubric for an assignment in the course. Then she re-uses the rubric in another assignment (see below on how to do this). When the teacher modifies the rubric in the second assignment, the first assignment still uses the original rubric.

The grading form definition is part of the activity data. It is included in the activity's backup and it is copied when the activity is duplicated via the "x2" icon or imported from another course.

== Configuring an activity module to use advanced grading methods ==

[[image:grading-method-selection-modform.png|thumb|right|Choosing the grading method in the activity settings form.]]

Modules that support advanced grading methods have the grading method selector included in their settings form (for example in the [[Assignment settings]] form). The teacher can choose either 'Simple direct grading' or one of the installed grading methods plugins. Selecting 'Simple direct grading' means that the advanced grading is not used and the standard grade selector is displayed.

Alternative way is to follow the link 'Advanced grading' in ''Administration > Activity administration''. The link leads to a page where the current active grading method can be changed, too.

The form definition and the associated assessment data are stashed when the grading method is changed from one type to another. That means it is safe to change the current active grading method from 'Rubric' to 'Simple direct grading' and back to 'Rubric'. The rubric definition is kept in the database, although it may not be available while the current grading method is set to some other method.

== Assessment form definition ==

[[image:grading-manage-initial.png|thumb|right|Grading method management screen (no assessment form of the selected type is not defined yet).]]

The link 'Advance grading' in the activity settings form leads to a management screen where the assessment form can be defined, edited, deleted and eventually shared as a public template (if the user has such permission). If there is no form of the selected method defined yet, there are two options:

* Define new grading form from scratch - creates a blank grading form and lets you define it. Each grading plugin provides its own grading form editor.
* Create new grading form from a template - lets you re-use a previously defined form. You can copy any of your own grading forms (that is those you have created elsewhere) or a grading form that was shared as a public template at your site.

Every grading form has a name and a description. These are not displayed to students. The description should summarize the form, explain its usage etc.

The grading form definition can be saved as a draft or as a final version. If the grading form is saved as a draft, it can't be used for assessing. To release the form and make it available to assessment, save it using the button 'Save and make it ready'. The current status of the form definition is indicated via a tag displayed next to the form name.

=== Modifying the form after it has been used ===

It may happen that you define a grading form, make it ready for usage and start assessing students with it. After some time you realize there is a typo in the form or that it should be actually improved significantly (like by adding another criterion into the rubric). In such case, you are about to edit a form that has already been used for assessment.

If the grading plugin considers your change as significant, it may force you to mark all current assessment with a special flag 'Needs review'. It is your duty to go through all existing assessments made by the previous version of the form and re-assess them to make the calculated grades valid a comparable. If the change seems to be a trivial change (eg fixing a typo in the text), the form editor may ask you to decide whether the existing assessment should be marked with the 'Needs review' flag or not.

Please note, when there are other people using the form for assessment (eg there are several non-editing teachers in the course who participate on the submissions assessment), even a trivial rewording can be understood as significant change in the criterion meaning. Make sure you communicate the changes well with your colleagues.

== Re-using assessment forms ==

[[image:grading-pick-search.png|thumb|right|Searching for a grading form to re-use]]

Instead of defining the new grading form from scratch, you can use some existing form as the initial template to create it from. When clicking the 'Create new grading form from a template' icon, a new page opens and you can search for a grading form there. Simply type words that should appear somewhere in the form name, its description or the form body itself. To search for a phrase, wrap the whole query in double quotes.

=== Shared templates ===

Users who were given a special permission can save their grading forms as shared templates on the site. Such forms can be then picked and re-used by all teachers in their courses. Users who published the form as a template can also delete it from the list of shared templates. See [[Grading forms publisher]] for more information. There is also another permission to manage the whole "bank" of shared template. Users with this permission can delete any shared template, even if they are not the authors of it. See [[Grading forms manager]] for more information.

Grading forms can be shared at the site level only. There is no way how to share forms at lower context levels (eg at the course category level as the question bank does).

=== Re-using own forms without sharing them ===

[[image:grading-pick-ownform.png|thumb|right|Re-using a form that was previously used in another activity]]

By default, only the grading forms that have been saved as shared templates are included in the search results. You can also include all your own grading forms in the search results. This way, you can simply re-use your grading forms without sharing them. Only forms marked as 'Ready for usage' can be re-used this way.

=== Permissions ===

There are two capabilities that affect the user's permission to work with templates.

* Share advanced grading form as a template ([[Capabilities/moodle/grade:sharegradingforms|moodle/grade:sharegradingforms]]) - grants the ability to save a grading form as a new shared template and eventually edit and remove own templates (templates originally shared by that user). Users with the role of manager are given this permission by default. To allow others to do this, see [[Grading forms publisher]].
* Manage advanced grading form templates ([[Capabilities/moodle/grade:managesharedforms|moodle/grade:managesharedforms]]) - grants the ability to edit and remove any shared template, even those originally shared by other users. To allow trusted teachers to do this, see [[Grading forms manager]].

=== Sharing your grading forms world-wide ===

At the moment, there is no way how to export/import grading form definitions. The known workaround is to create an empty assignment module and attach the grading form to it. Then make a standard activity backup of this assignment in the MBZ format and share it. By restoring the assignment, the attached grading form is restored, too. It can be then picked for your own activities or shared as a template at your site.

==What the students see==

When students click on an assignment which has a rubric or marking guide attached to it, they will see the rubric or marking guide as part of the information about their assignment.

{|
|[[File:rubricbeforesubmission.png|thumb|Student view of rubric '''before''' submission]]
|}

==How to let students see rubric marks and feedback '''after''' submission==
Note: When '''blind marking''' is used, students ''will'' receive a notification, but will ''not'' see rubric feedback until ''all'' submissions are marked and '''reveal student identities''' is clicked. That releases rubric marks and inline comment feedback to all students.

==The future of advanced grading methods==

Advanced grading methods can currently only be used for [[Assignment module|assignments]]. In future Moodle versions it is hoped that they can be used in more activity modules, such as glossaries and database activities. In addition more grading methods can be implemented as independent plugins (including custom ones fitting your particular need).

==See also==
* [[Learning Analytics Enriched Rubric]]
* [[BTEC marking]] for use with Moodle assignments

Using Moodle forum discussions:
* [http://moodle.org/mod/forum/discuss.php?d=193460 A few Advanced Grading questions for Moodle 2.2.1]
* [http://moodle.org/mod/forum/discuss.php?d=193961 Wrong Gradebook Calculation from 2.2 Rubric]

[[de:Erweiterte Bewertungsmethoden]]
[[es:Métodos avanzados de calificar]]

Using Assignment

2014-09-14T14:35:18Z

Cburell: /* Submission notifications */ Added special instructions/clarification for student view of grades and feedback when BLIND MARKING is used.

{{Assignment}}

==Different Submission options==

The standard assignment submission options available are:
* File submissions (students submit a file for assessment)
* Online text (students can type their responses directly in Moodle)
* Submission comments

''Note: It is also possible to use the assignment module for grading an "offline assignment", ie, one where work is done outside of Moodle. This is done by simply unchecking the above three options.''

==Which submission type suits you best?==

===You want students to type shorter or longer responses directly online===

*Set ''Online text'' to Yes. This works well for younger children who will only manage a sentence or two and works just as well for higher education students who write more.
**Advantage - quick for the student to get started; no need to use a word-processing program and upload the file.
**Disadvantage - potential worries that if the internet goes down, the work students have typed in and not yet saved might be lost. If the word count is expected to be large, setting ''Online text'' to No and ''File submission'' to Yes might be a better option.

===You want students to submit work you can download in a specified program===

*Set ''File submission'' to Yes, set the number of files you will allow using the ''Maximum number of uploaded files'' setting and the file sizes by using the '' Maximum submission size'' setting.
**Advantage - better than students emailing work as the whole class's work is collated in one space on your course. Markers can provide comments directly on the student work.
**Advantage - with "Attempts reopened" enabled, teachers can see the progression through various drafts of a student's work.
**Disadvantage - assignments must downloaded to be viewed (but they can be [[Assignment_FAQ| downloaded in bulk]]) and the teacher needs the appropriate program to open them.

===You want students to submit files at different times for a project===

*Set ''File submission'' to Yes, and use ''Maximum number of uploaded files'' to set the maximum number of separate files they can upload
**Advantage - all project files are in one assignment area for grading so they get a single grade.
**Disadvantage - all project files are in one assignment area for grading - so they can only have a single grade!

===You want students to write a response to a video/sound file/image===

*Set up an assignment allowing ''online text'' submission and get students to use the Moodle media icon to add video/sound/image files.

===You want students to answer a series of questions on a video/sound file/image===
*Investigate the [[Quiz]] module. Assignments are really just for a single question.

===You want to grade work students have done offline===
*Uncheck the submission types when setting up the assignment. Students won't be required to do anything but you can use the assignment to grade them for work done outside of Moodle.

===You want to view, comment on and send back students' assignments===

*Set up an assignment allowing ''file submissions''.
**Advantage: useful for teachers who like using the "comment" options in word-processing programs for example. If you have Ghostscript enabled on your server and the students upload PDF files, you can annotate them inline. See the section [[Using Assignment#Annotating PDF files| Annotating PDF files]] below.
**Disadvantage: if students upload other file types, you have to download them, comment and then re-upload them.

===You want students to send you a comment or note along with their uploaded work===

*In the settings, set ''Submission comments'' to Yes.

===You want to allow students to redraft and decide when to submit the work===

*In the settings set ''Require students click submit button'' to Yes. Students can then control when their draft work is submitted to the teacher.

===You want students to keep an ongoing journal or do an iterative assignment===

*In the settings set ''Require students click submit button'' to No. Students can continue to make changes to their assignment and at no point do they 'submit'. If the work will be graded at some point it is recommended that either ''Prevent late submissions'' is set to Yes to ensure that no changes can be made after the due date, or [[Using_Assignment#Submission_status| all submissions are locked]] when grading commences to ensure that the work is not altered during grading.
**Advantage: the work remains in one place and is constantly improved, graded (if needed) and improved again.
**Disadvantage: there is no record/history of previous attempts (such as with the [[Wiki]]). The online text assignment does not replicate the display of a journal or blog where each new entry is additional to the previous ones.

===You want students to submit work in groups===

*In the settings, set "Students submit in groups" to Yes. If you just do this, then once one student has submitted, the assignment will be flagged as submitted even if the others haven't contributed. If you want to ensure everyone has an input, set "Require students click submit button" to Yes and then change "Require all group members to submit" to Yes. The assignment will only be classed as submitted when each member has contributed, and once one student has submitted, the remaining members's names will be displayed for the group to see who still needs to add their input.

===You want to grade students' work anonymously===
*In the settings, choose "Blind marking". When students submit assignments, their names will be replaced by radomly generated participant numbers so you will not know who is who. Note that this is not '''totally'''''Italic text''
blind marking because you can reveal their identities in the assignment settings and you can work out identities from the logs - so this might not be suitable if your establishment has very precise privacy requirements.

===You want to read and grade student assignments offline===
*In the settings, choose "Offline grading worksheet". When students have submitted, click "View/grade all submissions" and you can download their assignments from the link "Download all submission" and download the grading sheet from the link "Download grading worksheet". You can then edit grades and re-upload the grading worksheet. You can also upload multiple feedback files in a zip from this drop down menu. See [[Assignment settings]] for an explanation of how to use the "upload multiple feedback files as zip" feature.
===You want to hide students' grades until a time of your choosing.===
Use 'marking workflow' as explained in [[Assignment settings]]

===You want to moderate other colleagues' marking or allocate certain teachers to certain students===
Use 'marking allocation' as explained in [[Assignment settings]]
==How do students submit their assignments?==
The first page students will see when they click on the assignment activity link from the course page will display the assignment name, description and the submission status. The first time a student views the assignment it will look like this:
{|
|[[Image:statuses.jpg|thumb|Student view of assignment]]
|}
The submission status section includes:
*'''Submission status'''
*'''Grading status'''
*Due date
*Time remaining
*Last modified
*Submission details

As they progress through the assignment the Submission status and Grading status will update and the Last modified date will appear.
{|
|[[Image:submission statuses graded.jpg|thumb|Example of submitted and graded assignment]]
|}

If the student uploaded a pdf file which the teacher has annotated, this will be made available in the feedback section. The student can search through the document and filter specific comments.
{|
|[[File:26pdfstudentgraded.png|thumb|Student view of graded pdf file]]
|[[File:26searchcomments.png|thumb|Searching and filtering comments in annotated pdf]]
|}
Submission statuses include:

*Nothing submitted for this assignment
*Draft (not submitted)
*Submitted for grading

Grading statuses include:

*Not graded
*Graded

===File submission===
To submit a file submission, students complete the following steps:
*Click the ‘Add submission’ button to bring up the file upload page.

*Upload the relevant file into the submission. They are able to ‘drag and drop’ the file into the submission box.
*Click ‘Save Changes’.
*There should now be a Last modified date and the file(s) uploaded will also be displayed.

*Depending on how the assignment is setup the status will either read ‘Submitted for grading’ - in which case no further action is need, or ‘Draft (not submitted)’.
*If changes are required, click on ‘Edit my submission’.
*Once ready to submit, click ‘Submit assignment’. Note that once the assignment is 'submitted’ no further changes are allowed.

{|
|[[File:file upload.jpg|thumb|Student view when adding a submission]]
|[[File:file uploaded.jpg|thumb|Student view once file is uploaded]]
|[[File:submit button.jpg|thumb|Student view when submitting assignment]]
|}
Note: Depending on how the assignment is setup students may see '''both''' a file submission page and an online text editor.

===Online text===
To submit online text, students complete the following steps:
*Click the ‘Add submission’ button to bring up the online text editor page

*Type the relevant text into the [[Text_editor|text editor]], or paste from a previously written file.
*Click ‘Save Changes’.
*There should now be a Last modified date and the first 100 characters entered will also be displayed.

*Depending on how the assignment is setup the status will either read ‘Submitted for grading’ - in which case no further action is need, or ‘Draft (not submitted)’
*If changes are required, click on ‘Edit my submission’.
*Once ready to submit, click ‘Submit assignment’. Note that once the assignment is 'submitted’ no further changes are allowed.

{|
|[[File:online text entered.jpg|thumb|Online text entered]]
|[[File:submit button online text.jpg|thumb|Sumbitting assignment]]
|}

===Submission comments===
Depending on how the assignment has been setup, there may be a section where students can leave submission comments.
{|
|[[Image:student comments.jpg|thumb|Student comments]]
|}

==Submission notifications==
Moodle allows the sending of a notification to the student when a student submits an assignment. This feature provides reassurance to the students that they have correctly submitted their assignments, especially when using features like draft submissions and file uploads. Moodle also allows notifications to teachers either when students submit assignments, or when students submit assignments late, or both. This feature notifies markers of the presence of assignments, or provides a reminder to access assignments submitted after the due date.

'''Why is this useful?'''
*Provides a receipt for student that the assignment has been successfully submitted
*Provides notification to marker that assignment are submitted
*Notifies of any changes to submission - for student’s record and to notify marker
*Provides notification to student that assignment feedback is available
*'''Note''': When '''blind marking''' is used, students ''will'' receive a notification, but will ''not'' see feedback until all submissions are marked and '''reveal student identities''' is clicked. That releases rubric marks and inline comment feedback to all students.

'''When is it sent?'''

If ‘Require students to hit submit button’ is enabled within the assignment (formerly ‘enable send for marking button’ in 2.2), which requires students to click a final submit button and prevents further changes, only one notification will be sent upon hitting the submit button.

If ‘Require students to hit submit button’ is not enabled, and students are allowed to make alterations or add/remove files from their submission, this receipt will be sent every time the file is altered - ie once on adding the file, once on adding a second file, once on removal of file, once on uploading a new file.

'''Where are these settings?'''

Submission Notification for Grader - ''Assignment > Edit Settings''
The grader is given two options:
*Notify Graders about Submissions - YES/NO
*Notify Graders about Late Submissions - YES/NO

The first option will notify the grader on any/all submissions made. The second will only send a notification for assignments submitted after the ‘Due Date’.

The Late Submissions option will be greyed out unless ‘Notify Graders about Submissions’ is selected as NO because ‘Notify Graders about Submissions’ will also send receipts for assignments submitted after the due date. To fully disable the grader receiving notifications, change both options to NO.

Submission Notification for Students - ''My Profile Settings > Messaging''
Tickboxes on the messaging page can be set by the student depending on their preference. A student can opt to receive notification via email, popup message, jabber or -if enabled by admin -mobile phone.

{|
|[[File:grader notifications.jpg|thumb|Grader notifications]]
|[[File:assnotif27.png|thumb|450px|Student notifications]]
|}

Assignment notification - On submission of an assignment, the student will receive a notification that their assignment has been successfully received.

==Viewing and grading submitted assignments==
When students have submitted their assignments, they can be accessed by clicking on the assignment activity. This will bring up the Grading Summary page.

The Grading Summary page displays a summary of the assignment, including; number of participants, number of drafts, number of submitted assignments, due date and time remaining.

Clicking on the the ‘View/grade all submissions’ link will bring up the Grading Table.

The Grading Table contains columns of information about the student, the status of their submission, a link to grade their submission, a link to each submission and feedback comments and files (if enabled).
===Filtering submissions===

{{New features}}
A dropdown menu accessed from the 'Options' section allows you to filter submissions so you can for example quickly see which students have not submitted yet.

[[File:assignmentfilter.png]]

===Submission status===
If you will be assigning grades to student work, you may want to take note of the submission status before you begin the marking process. If you have required students click the Submit button, you may find that some submissions are still marked as Draft (not submitted), meaning the student has either uploaded a file(s) or entered some text, but has not clicked ‘Submit assignment’.

If it's after the due date and you are about to commencing marking that you use ‘Prevent submission changes’ to stop students from making changes to their assignment. You can do this one by one by using the icon in the Edit column.

Or you can select two or more students by putting a tick in the select column and going to 'Lock submissions’ from the ''With selected'' menu under the grading table.

Likewise you can also revert a student's submission to draft if they have uploaded the incorrect file. Instead of selecting ‘Prevent submission changes’ select ‘Revert the submission to draft’, or place ticks against selected students and choose 'Revert the submission to draft status' from the ''With selected'' menu under the grading table.

{|
|[[File:submission statuses.jpg|thumb|Submission statuses]]
|[[File:prevent submission changes dropdown.jpg|thumb|Prevent submission changes dropdown]]
|[[File:lock submissions.jpg|thumb|Lock submissions]]
|[[File:revert to draft.jpg|thumb|Revert to draft]]
|[[File:revert submission to draft status.jpg|thumb|Revert to draft status]]
|}

===Quick grading===
Under Options (scroll to bottom of the page) you can determine your preferences for the number of assignments you wish to display per page. You can also filter assignments either to show all (no filter), submitted, or requires grading. This is also where you can turn on '''quick grading'''.

'''Quick grading''' allows you to enter grades and a feedback comment (if enabled in [[Assignment settings]]) directly into the grading table. '''Quick grading''' is not compatible with advanced grading and is not recommended when there are multiple markers.

#You can enter grades and feedback comments using quick grading. '''It is now possible to enter grades in decimal format.''' You will not be able to return a feedback file to your students (if enabled in the [[Assignment settings]]).
#Enter the grades
#Scroll to the bottom of the grading table and click 'Save all quick grading changes'
#A confirmation screen will appear.

===Student grading page===
If you have enabled File Feedback in the [[Assignment settings]] and wish to upload either the marked student assignment, a completed text based feedback document or audio feedback, click on the green tick in the Grade column (or use the icon in the Edit column and select Grade).

Here you can enter grades, feedback comments and feedback files (if enabled in the [[Assignment settings]]). You can use drag and drop to upload feedback files.

{|
|[[File:green tick.jpg|thumb|Green tick]]
|[[File:grade.jpg|thumb|Grading]]
|[[File:feedbackfiles.png|thumb|Feedback files]]
|}

====Annotating PDF files====

If the student has uploaded a PDF file you will see a link to Launch the PDF editor on the students' individual grading screen. This will display the PDF inline, allowing you to annotate it, using a variety of tools, stamps (if uploaded by the admin) and comments which may be saved to a comments bank. When the annotations are complete, clicking to save the changes will result in it being displayed to the student as part of their feedback. ''(Note that simply clicking on the file itself will not display it inline for annotating.)
''
{|
|[[File:26launchpdf.png|thumb|Teacher view when grading a pdf]]
|[[File:26annotatepdf.png|thumb|Annotating a pdf]]
|[[File:26pdfsavechanges.png|thumb|Make sure you save the changes]]
|}
Comments may be added and then saved in a quick list for future use. When adding a new comment, click the icon top right to access previously saved comments:
{|
|[[File:26commentquicklist.png|thumb|Saving and re-using comments]]
|}

Note: The annotate PDF feature requires Ghostscript to be installed on the server. This can be checked in ''Administration > Site administration > Plugins > Activity modules > Assignments > Feedback plugins > Annotate PDF''.

===Controlling when to notify students of graded work===
{{New features}}

[[File:notifystudents.png|center|thumb|500px]]

A checkbox is available when grading individual students. Choose Yes to notify them immediately or No to grade without notifying the student.

===Downloading student submissions===
You can download a zip file containing all of the assignment submissions by selecting the ‘Download all submissions’ options from the ''Choose'' menu at the top of the grading table, or in the settings menu.

File submissions will be downloaded in the format uploaded by the student. Online text submissions will be downloaded as html files. '''Each file in the zip will include the student first and lastname at the beginning of the filename for identification purposes.'''

==Keeping records (archiving, exporting, backing up)==
When students unenrol from a Moodle area, their records become invisible through the Gradebook interface. In order to have the information to hand, departments or course teaching teams may need systems in place to keep their own records for the data retention period required in their particular context. There are two separate procedures for exporting student submissions and marks.

To export marks (with or without feedback):
#Go to your course area
#From its front page Settings block, select Grades; the Grader Report loads.
#From the Grader Report Settings block, select Export; a menu displays.
#From the menu, if you need easy viewing and running calculations you probably want to select one of the spreadsheet formats; a page of export settings loads
#Use the Visible Groups pulldown menu to limit the export to specific groups, as required
#In Options, you indicate whether feedback comments are included
#In Grade Items To Be Included lists you can, if required, omit particular Activities from the report
#When you've finished with the settings, click on Submit; a preview of your export displays
#Click on Download to export to the format you chose, and save the file.

To download the original student submissions:
#In your course area, click the link to the Assignment whose submissions you want to download.
#Click on the link to View/Grade all submissions; the Grading Table will load.
#Click the link to 'Download all submissions' (either from the ''Choose'' menu or from the Settings block), and save the file.

==Tips and Tricks==
* Want to use an Assignment activity again in another Moodle site? Use the [[Activity_backup| backup and restore]] options.
*Want to use an Assignment activity in another course you teach? Use the [[Import_course_data| Import function]] in the course administration block.
*Moodle will sometimes appear not to be uploading a resubmitted assignment - you seem to be downloading the original assignment. This is a cache issue, in short, go to ''"Tools > Clear Recent History"'' in Firefox or ''"Tools > Delete Browsing History > Delete Temporary Files"'' in Windows Explorer. The newer file will then appear.

==See also==

===Screencasts===
*[http://youtu.be/9sAZaFVCL9c Assignment improvements in 2.7]
*[http://www.youtube.com/watch?v=2dcnTTp_W7c&feature=share&list=SPxcO_MFWQBDe8RRnGjoUDqbcm9PSlIoWn&index=3 Marking workflow and allocated markers.]
*[http://www.youtube.com/watch?v=MgsA-9qMBdY&feature=share&list=SPxcO_MFWQBDe8RRnGjoUDqbcm9PSlIoWn&index=1 Annotate PDFs]

===Examples from [http://school.demo.net School demo site]===

* [http://school.demo.moodle.net/mod/assign/view.php?id=573&rownum=3&action=grade Teacher view of a PDF assignment which can be annotated inline.]Log in with username 'teacher' and password 'moodle'
* [http://school.demo.moodle.net/mod/assign/view.php?id=573&action=grading Teacher view of allocated markers and marking workflow status.] Log in with username 'teacher' and password 'moodle'
* [http://school.demo.moodle.net/mod/assign/view.php?id=190 Student view of an assignment.] Log in with username 'student' and password 'moodle'. Scroll down to see the rubric and feedback.
* [http://school.demo.moodle.net/mod/assign/view.php?id=46&action=editsubmission Student view of a student submission statement] Log in with username 'student' and password 'moodle'
* [http://school.demo.moodle.net/mod/assign/view.php?id=715 Student view of group assignment grading screen] Log in with username 'student' and password 'moodle'
* [http://school.demo.moodle.net/mod/assign/view.php?id=715&action=grading Teacher view of a group assignment grading screen] Log in with username 'teacher' and password 'moodle'.
* [http://school.demo.moodle.net/mod/assign/view.php?id=191&action=grading Teacher view of blind marking grading screen] Log in with username 'teacher' and password 'moodle'

===Other===
* [http://www.somerandomthoughts.com/blog/2013/07/07/one-approach-for-group-project-grading/ One approach to group project grading] Blog post by Gavin Henrick.
*Using Moodle [http://moodle.org/mod/forum/discuss.php?d=201307Advantages of using Assignment upload over emailing a document] forum discussion

[[de:Aufgabe nutzen]]
[[fr:Afficher un devoir]]
[[ja:課題を表示する]]
[[es:Usando Tarea]]

Advanced grading methods

2014-09-14T12:54:26Z

Cburell: Added header, "How to let students view rubric feedback and marks '''after''' submission." Cannot find this in any documentation. Students currently cannot see rubric feedback in my course.

{{Grades}}'''Advanced grading methods''' enable various assessment forms to be used for calculating grades.

[[image:comicstrip-rubrics.png|600px|They should also have plagiarism plugins installed and apply them to control lazy course content creators.]]

==Advanced grading method types==

* [[Rubrics]]
* [[Marking guide]]

There are also add-ons available in the 'See also' section below.
== Basic concepts ==

By default, numerical grades in Moodle are selected by the teacher from a range like 0-100. When advanced grading methods are enabled, the grade selection element is replaced with a more complex assessment form provided by the plugin. The plugin contains the logic how to calculate the grade. Such a calculated grade is then passed back to the activity module as if the teacher used the standard grade value selector.

:''Example:'' The teacher creates new Assignment in the course with the grade up to 30. She defines a rubric to be used for grading. The rubric itself produces raw score up to 12 (eg it has four criteria with levels 0, 1, 2, 3). So the rubric's score 12 leads to the assignment grade 30, the score 6 leads to the grade 15 etc.

For each activity, a new copy of the assessment form is created. Note that this is different from how [[Scales|scales]] work. While scales are defined at the site level or course level and then can be used in all activities, advanced grading forms create a new copy of the form definition for every single activity that uses it. So a change in the form definition in one assignment does not affect other places where the same rubric is used.

:''Example:'' The teacher defines a rubric for an assignment in the course. Then she re-uses the rubric in another assignment (see below on how to do this). When the teacher modifies the rubric in the second assignment, the first assignment still uses the original rubric.

The grading form definition is part of the activity data. It is included in the activity's backup and it is copied when the activity is duplicated via the "x2" icon or imported from another course.

== Configuring an activity module to use advanced grading methods ==

[[image:grading-method-selection-modform.png|thumb|right|Choosing the grading method in the activity settings form.]]

Modules that support advanced grading methods have the grading method selector included in their settings form (for example in the [[Assignment settings]] form). The teacher can choose either 'Simple direct grading' or one of the installed grading methods plugins. Selecting 'Simple direct grading' means that the advanced grading is not used and the standard grade selector is displayed.

Alternative way is to follow the link 'Advanced grading' in ''Administration > Activity administration''. The link leads to a page where the current active grading method can be changed, too.

The form definition and the associated assessment data are stashed when the grading method is changed from one type to another. That means it is safe to change the current active grading method from 'Rubric' to 'Simple direct grading' and back to 'Rubric'. The rubric definition is kept in the database, although it may not be available while the current grading method is set to some other method.

== Assessment form definition ==

[[image:grading-manage-initial.png|thumb|right|Grading method management screen (no assessment form of the selected type is not defined yet).]]

The link 'Advance grading' in the activity settings form leads to a management screen where the assessment form can be defined, edited, deleted and eventually shared as a public template (if the user has such permission). If there is no form of the selected method defined yet, there are two options:

* Define new grading form from scratch - creates a blank grading form and lets you define it. Each grading plugin provides its own grading form editor.
* Create new grading form from a template - lets you re-use a previously defined form. You can copy any of your own grading forms (that is those you have created elsewhere) or a grading form that was shared as a public template at your site.

Every grading form has a name and a description. These are not displayed to students. The description should summarize the form, explain its usage etc.

The grading form definition can be saved as a draft or as a final version. If the grading form is saved as a draft, it can't be used for assessing. To release the form and make it available to assessment, save it using the button 'Save and make it ready'. The current status of the form definition is indicated via a tag displayed next to the form name.

=== Modifying the form after it has been used ===

It may happen that you define a grading form, make it ready for usage and start assessing students with it. After some time you realize there is a typo in the form or that it should be actually improved significantly (like by adding another criterion into the rubric). In such case, you are about to edit a form that has already been used for assessment.

If the grading plugin considers your change as significant, it may force you to mark all current assessment with a special flag 'Needs review'. It is your duty to go through all existing assessments made by the previous version of the form and re-assess them to make the calculated grades valid a comparable. If the change seems to be a trivial change (eg fixing a typo in the text), the form editor may ask you to decide whether the existing assessment should be marked with the 'Needs review' flag or not.

Please note, when there are other people using the form for assessment (eg there are several non-editing teachers in the course who participate on the submissions assessment), even a trivial rewording can be understood as significant change in the criterion meaning. Make sure you communicate the changes well with your colleagues.

== Re-using assessment forms ==

[[image:grading-pick-search.png|thumb|right|Searching for a grading form to re-use]]

Instead of defining the new grading form from scratch, you can use some existing form as the initial template to create it from. When clicking the 'Create new grading form from a template' icon, a new page opens and you can search for a grading form there. Simply type words that should appear somewhere in the form name, its description or the form body itself. To search for a phrase, wrap the whole query in double quotes.

=== Shared templates ===

Users who were given a special permission can save their grading forms as shared templates on the site. Such forms can be then picked and re-used by all teachers in their courses. Users who published the form as a template can also delete it from the list of shared templates. See [[Grading forms publisher]] for more information. There is also another permission to manage the whole "bank" of shared template. Users with this permission can delete any shared template, even if they are not the authors of it. See [[Grading forms manager]] for more information.

Grading forms can be shared at the site level only. There is no way how to share forms at lower context levels (eg at the course category level as the question bank does).

=== Re-using own forms without sharing them ===

[[image:grading-pick-ownform.png|thumb|right|Re-using a form that was previously used in another activity]]

By default, only the grading forms that have been saved as shared templates are included in the search results. You can also include all your own grading forms in the search results. This way, you can simply re-use your grading forms without sharing them. Only forms marked as 'Ready for usage' can be re-used this way.

=== Permissions ===

There are two capabilities that affect the user's permission to work with templates.

* Share advanced grading form as a template ([[Capabilities/moodle/grade:sharegradingforms|moodle/grade:sharegradingforms]]) - grants the ability to save a grading form as a new shared template and eventually edit and remove own templates (templates originally shared by that user). Users with the role of manager are given this permission by default. To allow others to do this, see [[Grading forms publisher]].
* Manage advanced grading form templates ([[Capabilities/moodle/grade:managesharedforms|moodle/grade:managesharedforms]]) - grants the ability to edit and remove any shared template, even those originally shared by other users. To allow trusted teachers to do this, see [[Grading forms manager]].

=== Sharing your grading forms world-wide ===

At the moment, there is no way how to export/import grading form definitions. The known workaround is to create an empty assignment module and attach the grading form to it. Then make a standard activity backup of this assignment in the MBZ format and share it. By restoring the assignment, the attached grading form is restored, too. It can be then picked for your own activities or shared as a template at your site.

==What the students see==

When students click on an assignment which has a rubric or marking guide attached to it, they will see the rubric or marking guide as part of the information about their assignment.

{|
|[[File:rubricbeforesubmission.png|thumb|Student view of rubric '''before''' submission]]
|}

==How to let students see rubric marks and feedback '''after''' submission==
Explanation hopefully forthcoming!

==The future of advanced grading methods==

Advanced grading methods can currently only be used for [[Assignment module|assignments]]. In future Moodle versions it is hoped that they can be used in more activity modules, such as glossaries and database activities. In addition more grading methods can be implemented as independent plugins (including custom ones fitting your particular need).

==See also==
* [[Learning Analytics Enriched Rubric]]
* [[BTEC marking]] for use with Moodle assignments

Using Moodle forum discussions:
* [http://moodle.org/mod/forum/discuss.php?d=193460 A few Advanced Grading questions for Moodle 2.2.1]
* [http://moodle.org/mod/forum/discuss.php?d=193961 Wrong Gradebook Calculation from 2.2 Rubric]

[[de:Erweiterte Bewertungsmethoden]]
[[es:Métodos avanzados de calificar]]

Grades FAQ

2014-09-14T12:42:07Z

Cburell: /* Advanced grading */ Added question of how students see Rubric feedback after teacher scores their assignment

{{Grades}}
== General ==

===How can I change how grades are displayed?===

Grades may be displayed as as actual grades, as percentages (in reference to the minimum and maximum grades) or as letters.

The default grade display type for the site is set by an administrator in ''Administration > Grades > [[Grade item settings]]''. However, this may be changed at course level.

To change how grades are displayed for particular [[Grade items|grade items]], or category and course summaries (called aggregations):

# Follow the grades link in the Course administration block.
# Select "Categories and items" from the gradebook dropdown menu.
# Click the edit icon for the grade item, category total or course total.
# From the Grade display type menu, select real (for actual grades), percentage or letter.
# Click the "Save changes" button at the bottom of the page.

Alternatively, to change how grades are displayed for the whole course:

# Follow the grades link in the course administration block.
# Select "Course settings" from the gradebook dropdown menu.
# From the Grade display type menu, select real (for actual grades), percentage or letter.
# Click the "Save changes" button.

===How can I hide entered grades until a specified date?===

To set a "Hidden until" date:

#Access the course gradebook via the grades link in the course administration block.
#Select "Categories and items" from the gradebook dropdown menu.
#Click on the edit icon opposite the activity for which a "Hidden until" date is to be set.
#On the edit grade item page, ensure that advanced settings are displayed. (Click the "Show advanced" button if not.)
#Enable the "Hidden until" setting by unchecking the disable checkbox, then set a date.
#Click the "Save changes" button.

=== Is it possible to show the teachers/administrators' grades in the grader report? ===
Yes, at the site level you can define which roles will appear in the grader report. This can be found in [[General_grade_settings#Graded_Roles|Administration > Grades > General settings]]. Also read [http://moodle.org/mod/forum/discuss.php?d=92612 this discussion] for some more ideas.

===Why can't I change a grade within an assignment after changing it in the gradebook?===

When you edit a grade directly in the gradebook, an "overridden" flag is set, meaning that the grade can no longer be changed from within the assignment.

However, the flag can be removed by turning editing on in the [[Grader report|grader report]], then clicking the [[Grade editing|edit grade]] icon, unchecking the overridden box and saving the changes.

===How do I get groups to show up in the grader report?===

For groups to show up in the grader report, group mode should be set to visible or separate groups in the [[Course settings|course settings]]. This will result in a groups dropdown menu being displayed, enabling a teacher to view the grades of all participants, or only the grades for a selected group.

===The quiz grades keep disappearing from the student view, even after I un-hide them!===

Check your quiz settings. Under the '''Review options''' heading, in the '''Later, while the quiz is still open''' and/or the '''After the quiz is closed''' columns, you probably have Scores un-checked. Each time a student completes a quiz, these settings are consulted and the scores will be hidden from ''all'' students. If your students don't all take the quiz at the same time, it can look like quiz scores reset themselves to 'hidden' randomly, even after you un-hide them.

===How can I make the gradebook simpler for teachers?===

See [[Simplifying the gradebook by changing permissions]].

==Grades and user removals==

===What happens to gradebook data when a user is unenrolled from a course?===
On re-enrolling, you can recover their grades from before: see [https://docs.moodle.org/24/en/Grade_settings#Recover_grades_default Recover grades on re-enrol]

===What happens to gradebook data when a user is deleted from the Moodle site?===

==Advanced grading==

===Why can't I see the advanced grading option??===
To see the option for Advanced grading, you first have to create an assignment and choose Advanced grading/Rubric from the gGading method dropdown. Advanced grading will then appear in ''Settings>Assignment administration.''
===How can I allow teachers to save rubrics as templates for others?===
Create a new role and assign it in the system context. Give this role the capability ''moodle/grade:sharegradingforms'' (for sharing as a template) and if desired ''moodle/grade:managesharedforms'' (for editing or deleting templates created by others) Assign this role to those teachers you wish to have this ability.

===How do students see the Marking guide?===
Assuming the teacher has allowed this in the [[Marking guide]] settings, the student may click "submissions grading" under the assignment name in their navigation block:

[[File:submissionsgrading.png]]

===How do students see the Assignment module Rubric marks and feedback from their teacher?===

== Reports ==
=== How do I create my own custom gradebook reports? ===
Here is a [[Development:Gradebook_Report_Tutorial|tutorial]] explaining all the main steps involved.
===How can I sort or change the order of column headings?===
Go to Grades link, then select one of the "Category & items" actions from the pulldown on the top left. Use the move icon to change the position of the graded item. And/or you could create categories for the items and move them into a category so they will be grouped that way first.

===How can I remove user ID numbers and/or email addresses from the grader report===

Go to ''Settings > Site administration > Users > Permissions > [[Roles settings|User policies]]'' and untick the 'ID number' and/or 'email address' checkboxes for 'Show user identity'.

Note that this will result in ID numbers and/or email addresses not being shown when searching for users and displaying lists of users. See the section 'Show user identity' in [[Roles settings]] for a list of locations where user identity fields are shown.

=== How can I interpret the quiz report statistics?===

See [https://docs.moodle.org/dev/Quiz_report_statistics Quiz report statistics] in the developers documentation.

== Aggregation ==
=== I can't find where to change the aggregation type for my gradebook categories! ===
Each category has an aggregation type, which can be changed through that category's "edit" page. To access that page, you must use one of 2 ways:

1. In the grader report, turn "Editing" on, then click the little "hand" icon next to the category whose aggregation you want to change
2. In the "Edit categories and Items" page (accessible through the "choose an action" menu, top left), you see a tree view of the categories and items in your gradebook. The top category is the course category. Each category also has a "hand" icon, which leads to the category edit page

=== How can I grade some of my activities without the results affecting my students' course total? ===
#Go to Grades and choose the "Category and items" tab.
#Add two [[Grade categories]], one for your "Graded activities" and one for your "Not graded activities". In the "Not graded activities" category choose "None" in grading type.
#Ensure that "Aggregate including subcategories" (an option visible only in "full view") is unchecked for your top level course grade category.
#If you want to completely hide the "Not graded activities" category from your students tick the "Hidden" icon too.
#Save your changes.
#Move all your normally graded activities into the "Graded activities" category.
#Move all your excluded from grading activities into "Not graded activities" category.

'''Note''': Following the above steps the not graded activities will be completely hidden from your students. So...

*'''IF''' you want the activity grades of the "Not graded activities" category, to remain visible to your student without their grades affecting their course total, simply click the eye to show the "Not graded activities" category.

*'''IF''' you want students to be able to see the activity grades and the category total of the "Not graded activities", then you have to let the category visible and also choose a grading type between value, scale or text, by editing the category.

In this case you can exclude the "Not graded activities" from course total using the "Weighted mean of grades" aggregation method in Course category and assigning 100 weight to the "Graded activities" and 0 weight to the "Not graded activities".

*'''IF''' you don't want to use grade categories, you can also exclude the grades of a specific activity by changing the "Multiplicator" (visible only in "full view") from 1.0 into 0.0.

*Last, '''IF''' you want to exclude the grade of an activity only to one or some specific students, then follow these steps:
#From the grader report "Turn editing on"
#Click the "Edit grade" icon of the activity of the student you want to exclude.
#In the Edit grade page, check the tick box next to the "Excluded" option and "Save changes".

=== My student completed only one activity out of 5, but his course total shows 100%. How do I show a more "progressive" course total? ===

==== Step-by-Step Explanation ====
# From the view menu in the gradeboook, select "Categories and items"
# At the top line there is a folder icon and an edit icon on the right, click the edit icon
# You'll then see the title "Grade category," the 3rd item is "Aggregate only non-empty grades."
# Uncheck this.
# Save.

==== Another Explanation ====
By default, only non-empty grades are aggregated, the others are ignored. However, you can change this setting as well as others that affect the course total, by turning "Editing" on in the grader report, and clicking the "Edit" icon next to the course category (the very top row of the grader report).

You can untick the box "Aggregate only non-empty grades" if you want to show a more "progressive" score for each student. Their empty grades will count as a 0 and will be counted in the course mean/total.

If you prefer to show a sum of points, rather than a percentage, you can change the course category's aggregation method to "Sum of grades".

=== How can I display the average grade for my course categories (not grade categories)? ===
In Moodle 1.9 there is no way to aggregate course totals within each category. The gradebook is course-centered, and there is currently no User Interface for showing grades within an entire course category at once.

=== How can I setup weighted assignments? ===
See [[Using "Weighted Mean of Grades" to weight categories containing assignments]].

=== Why is the Category Total blank for one of my categories? ===
One possibility is that you accidentally entered some grades into the Category Total column and then erased them. When you do that, an override flag gets set and then the totals won't calculate. Here's how to check, and fix it:

# Go to the [[Grader report]] view of the gradebook.
# Click the "Turn editing on" button for the gradebook. (There's a separate one for the gradebook from the one on the main page.)
# Find the box for the problem category and the first student affected.
# Click on the icon of a gear *in that box*.
# See if the box marked "[[Grade_editing#Overridden|Overridden]]" (third line down) is checked. If it is, uncheck it.
# Repeat (4) and (5) for each student affected,

== Categories ==
=== How many depths of categories/subcategories can I create? ===
There is no programmatic limit, but there are practical limits. Very deeply nested structures are difficult to manage. 3 levels of categories should be sufficient for most situations. Note that there is always at least one level of categories, since the Course category always encompasses all other categories and grade items, can cannot be deleted.

=== I can't find setting X in the grade category edit page! Where is it? ===
If a setting documented on the [[Grade categories]] page does not appear on your edit page, it may mean that it is set globally in your site. See [[Grade_category_settings#Forcing_settings|Forcing settings]] for more information.

== Outcomes ==
=== I want to set up an outcome item for my course. What are the steps required? ===
#The site administrator needs to have enabled outcomes via ''Settings>Site Aaministration > Advanced Features >Enable Outcomes''
#In your course, go to ''Settings>Course administration>Grades>Scales'' and create the scale you need.
#[[Scales#Creating_a_new_scale|Create a scale]]
#In Settings>Course administration>Outcomes, create a course outcome assigning it to the scale you just created.
#Read the [[Outcomes| outcomes documentation]] for instructions).
#You can now give your students a rating on the outcome dimension you just created. If you created a standard outcome, you will be able to use it in other courses and follow your students' performance across these courses.

===How can I remove an outcome from an activity?===

An outcome can be removed from an activity by deleting it on the gradebook edit categories and items page. This results in the outcomes being deselected on the update activity page.

== Modules ==
=== The activity module (Module name) doesn't support grading. How can I give my students a grade anyway? ===
You can create a [[Grade_items#Manual_grade_items|grade item]] manually in the gradebook. You will have to grade your students through the [[Grader report]] interface (in editing mode).

=== I just graded some of my students using the (Module name) interface, but the results aren't showing up in the grader report. What's going on? ===
Here are some of the possible reasons:
#The site settings>Grades>General settings may not have the correct graded roles checked off to appear in grade book. If you see no students in the Gradebook but do see columns for the graded activities, then check the graded role settings.
#The corresponding [[Grade items|grade item]] is [[Grade_locking#In_grade_items|locked]], or its parent [[Grade categories|category]] is [[Grade_locking#In_grade_categories|locked]].
#The module code is not using the [[Development:Grades#API_for_communication_with_modules.2Fblocks|gradebook API]] correctly

=== I just created a new assignment with the "Grade" setting set to "No grade", but it still appears in the gradebook ===
The reason is that the gradebook is now the place where both numerical and textual types of feedback are recorded for all activity modules. The word "Grading" in assignment relates only to numerical grades, but the ability to give text feedback remains, and must be recorded in the gradebook. This is why a grade item is created for it. You can hide the grade item if you do not want it to appear in the user reports.

==Weights and extra credits==

===How do weighted grades influence the category or course total?===
A weight (also called coefficient) only has meaning in reference to other weights. If you only have one grade item, changing its weight will not have any effect. However, if you have two grade items, each with a different weight, the "heavier" item will have more influence on the total grade than the "lighter" one.

You can set the weights to any positive numerical value you choose. Usually, at least one of the weights will be 1 and serve as the baseline for other weights. If another item has a weight of 2, its grades will be multiplied by 2 compared with the grades of the first grade item, before being averaged. The denominator used for averaging is the sum of all the weights.

An example follows:
item 1 weight: 1
item 2 weight: 3
item 3 weight: 0.5

item 1 grade: 40/100
item 2 grade: 60/100
item 3 grade: 20/100

Calculation:
total = ((40 * 1) + (60 * 3) + (20 * 0.5)) / (1 + 3 + 0.5)
= (40 + 180 + 10) / (4.5)
= 230 / 4.5
= 51.11

The total for this category will then be 51.11 out of 100

===Do I have to put a value in each "weight" input box?===
No. If you do not put a value, it will default to 1. If all items are set to 1 then they all have equal weight. If you set a weight to 0, the item's grades will not count at all in the category or course average.

===Do all the weights have to add up to 100 or some similar value?===
No, the numbers you put as weights are completely arbitrary. They must be positive numbers, and can add up to anything you want. Note however that the following four sets of weights are identical in value:

(1 1.75 3)
(4 7 12)
(8 14 24)
(400 700 1200)

===What is the difference between Weight and Extra Credit?===
Weight is only available with "Weighted mean of grades". For the "Simple weighted mean of grades", the weight is taken from the grade item's maximum grade. A weight is used to give a grade item more or less importance in the computation of the category total or average, compared with the other items of the same category.

Extra credit replaces grade item weight if the aggregation method is "Mean of grades (with extra credits)", "Sum of grades", or "Simple weighted mean of grades". The effect of extra credit is different in each case, hence some confusion:

*Mean of grades (with extra credits): A value of 0 does nothing. Any other value is used to multiply the grade and add it to the total after the computation of the mean. This grade is not used in the computation of the mean, however, only added afterwards. Additionally, this cannot bring the category total over its maximum grade unless grades over 100% are enabled by the site administrator (since 1.9.5). This grade item is not counted either in the denominator used to compute the category mean.

*Sum of grades: Extra credit is a checkbox, not a number. Normally, with Sum of Grades, the category's maximum grade is the sum of the maximum grades of all its grade items. If one of them is set as "Extra Credit", however, its maximum grade is not added to the category's maximum grade, but its grades will be. This way it is possible to achieve maximum grade (or grades over maximum if enabled by the site administrator) in the category without getting the maximum grade in all the grade items.

*Simple weighted mean of grades: Extra credit is a checkbox, not a number. The "Extra Credit" grades are counted in the numerator used to compute the category mean, but not the denominator. See [[Category_aggregation#Simple_weighted_mean|here]] for more information.

===How do I create an assignment for which students can receive a grade higher than the maximum?===

In Moodle 1.9.5 onwards, a new [[Grade_settings#Unlimited_grades|unlimited grades]] setting in ''Administration > Grades > General settings'' enables administrators to allow teachers to enter grades over 100% directly in the gradebook.

===Why can't I enter a grade higher than the maximum?===

First, check with your administrators to make sure the [[Grade_settings#Unlimited_grades|unlimited grades]] setting is turned on. If that is not the problem, you might be using [[Gradebook_report_settings#Quick_grading_and_quick_feedback|quick grading]]. If that is the problem, you can still enter grades higher than the maximum this way:

# Go to the Moodle gradebook "Grader Report" page.
# Use the button in the upper right to "Turn editing on" if it is not already on.
# In the upper right corner of each box for entering the grade, there should be an icon of a gear. Click on that.
# On the "Edit grade" screen that comes up, there's a box for "Final grade". You should be able to enter any number of points into that, even if it's more than the maximum. (If this is an "[[Grade_items#Activity-based_grade_items|Activity-based grade item]]" such as an Assignment or a Quiz, then you may also have to check the "[[Grade_editing#Overridden|Overridden]]" checkbox.)

If you expect a lot of students to get extra credit, it's probably better to make it a separate grade item and mark it as extra credit instead, or else [[Grade_import|import]] the grades from a spreadsheet.

==Formulas==

===How do I give a fixed score for a successful quiz attempt===

Suppose you want to give 5 points for a passing grade (say, 40) in a certain quiz (which has a maximum score of 100). Possible scenario ([http://moodle.org/mod/forum/discuss.php?d=148576]): extra credit points to every student that gets a "passing grade" in a "practice test" at the end of each chapter covered in the course, to encourage them to practice after the homework quizzes and to get familiar with a "test type" situation before the actual test.

The following formula should do the trick:

=min(round((||quiz||/40)-0.49,0),1)*5

The formula may be added to a designated grade item or category.

Sample calculations:
Score 40 (pass):
=min(round((40/40)-0.49,0),1)*5
=min(round(1-0.49,0),1)*5
=min(round(0.51,0),1)*5
=min(1,1)*5
=1*5
=5

Score 39 (not pass):
=min(round((39/40)-0.49,0),1)*5
=min(round(0.975-0.49,0),1)*5
=min(round(0.485,0),1)*5
=min(0,1)*5
=0*5
=0

Score 100 (pass):
=min(round((100/40)-0.49,0),1)*5
=min(round(2.5-0.49,0),1)*5
=min(round(2.01,0),1)*5
=min(2,1)*5
=1*5
=5

==See also==

*Gradebook Scenarios/Use Cases [https://docs.moodle.org/en/experimental:_gb_tutoring]
*Using Moodle [http://moodle.org/mod/forum/view.php?id=2122 Gradebook forum]

Using Moodle forum discussions:
*[http://moodle.org/mod/forum/discuss.php?d=123143 Excluding practice quizzes from gradebook]
*[http://moodle.org/mod/forum/discuss.php?d=193705 Course total not sum of max grade column?]
*[https://moodle.org/mod/forum/discuss.php?d=167596 Why do only certain items have multiplicator & offset boxes?]
*[https://moodle.org/mod/forum/discuss.php?d=235640 Extra credit]

[[Category:FAQ]]

[[ca:PMF de les qualificacions]]
[[de:Bewertungen FAQ]]
[[es:Calificaciones FAQ]]
[[fr:FAQ des notes]]
[[ja:評定FAQ]]

Question types

2014-08-23T17:09:59Z

Cburell: /* Calculated multi-choice */

{{Questions}}You may add a variety of different types of questions in the Quiz and Lesson modules. This page is about [[Quiz module]] question types; some will be similar to [[Lesson questions]] types, which are fewer in number and function differently. The standard quiz question types are listed below with brief descriptions. '''Please use the links on the right side of this page to find more detailed information about standard questions types.'''

==Standard question types==

=== Calculated ===
Calculated questions offer a way to create individual numerical questions by the use of wildcards that are substituted with individual values when the quiz is taken. [[Calculated_question_type|More on the Calculated question type]]

===Calculated multi-choice===
Calculated multichoice questions are like multichoice questions with the additonal property that the elements to select can include formula results from numeric values that are selected randomly from a set when the quiz is taken. They use the same wildcards than Calculated questions and their wildcards can be shared with other Calculated multichoice or regular Calculated questions.

The main difference is that the formula is included in the answer choice as {=...} i.e if you calculate the surface of a rectangle {={l}*{w}}.

[https://docs.moodle.org/36/en/Calculated_multichoice_question_type More on the Calculated Multi-Choice question type.]

===Calculated simple===
Simple calculated questions offer a way to create individual numerical questions whose response is the result of a numerical formula which contain variable numerical values by the use of wildcards (i.e {x} , {y}) that are substituted with random values when the quiz is taken.

The simple calculated questions offers the most used features of the calculated question with a much simpler creation interface. [https://docs.moodle.org/36/en/Simple_calculated_question_type More on the Simple Calculated Question type.]

=== Description ===
This question type is not actually a question. It just prints some text (and possibly graphics) without requiring an answer. This can be used to provide some information to be used by a subsequent group of questions, for example. [[Description_question_type|More on the Description question type]]

=== Essay ===
This allows students to write at length on a particular subject and must be manually graded.

It is possible for a teacher to create a template to scaffold the student's answer in order to give them extra support. The template is then reproduced in the text editor when the student starts to answer the question. See Youtube video [http://youtu.be/BAZa66WvyWQ Essay scaffold with the Moodle quiz]

{|
| [[File:templatebox.png|thumb|Response template in question set up screen]]
| [[File:quiztemplate.png|thumb|What the student sees]]
|
|}

=== Matching ===
A list of sub-questions is provided, along with a list of answers. The respondent must "match" the correct answers with each question. [[Matching_question_type|More on the Matching question type]]

=== Embedded Answers ([http://en.wikipedia.org/wiki/Cloze_test Cloze Test] / Gap Fill) ===
These very flexible questions consist of a passage of text (in Moodle format) that has various answers embedded within it, including multiple choice, short answers and numerical answers. [[Embedded_Answers_(Cloze)_question_type|More on the Embedded Answers question type]]

=== Multiple choice ===
With the [[Multiple Choice question type]] you can create single-answer and multiple-answer questions, include pictures, sound or other media in the question and/or answer options (by inserting HTML) and weight individual answers.

=== Short Answer ===
In response to a question (that may include an image), the respondent types a word or phrase. There may several possible correct answers, with different grades. Answers may or may not be sensitive to case. [[Short-Answer_question_type|More on the Short Answer question type]]

=== Numerical ===
From the student perspective, a numerical question looks just like a short-answer question. The difference is that numerical answers are allowed to have an accepted error. This allows a continuous range of answers to be set. [[Numerical_question_type|More on the Numerical question type]]
===Random short-answer matching===
From the student perspective, this looks just like a Matching question. The difference is that the sub-questions are drawn randomly from Short Answer questions in the current category. [[Random_Short-Answer_Matching_question_type|More on the Random Short-Answer Matching question type]]
=== True/False ===
In response to a question (that may include an image), the respondent selects from two options: True or False. [[True/False_question_type|More on the True/False question type]]

==Third-party question types==

Besides the standard question types that are part of the core Moodle distribution, there are a number of [https://moodle.org/plugins/browse.php?list=category&id=29 question type add-ons] in [https://moodle.org/plugins the add-ons database].

Some of those add-ons have additional documentation in [[Third-party_question_types|Third-party question types]]:

==See also==
[[Lesson questions]]

[[Category:Quiz]]
[[Category:Teacher]]
[[Category:Lesson]]

[[ca:Tipus_de_preguntes]]
[[es:Tipos de preguntas]]
[[eu:Galdera-motak]]
[[fr:Types de questions]]
[[ja:問題タイプ]]

Question types

2014-08-23T17:09:07Z

Cburell: /* Calculated multi-choice */ Added summary from Doc page for this question with link to full explanation.

Question types

2014-08-23T17:06:54Z

Cburell: /* Calculated simple */ Added Simple Calculated summary + link to full Docs page.

{{Questions}}You may add a variety of different types of questions in the Quiz and Lesson modules. This page is about [[Quiz module]] question types; some will be similar to [[Lesson questions]] types, which are fewer in number and function differently. The standard quiz question types are listed below with brief descriptions. '''Please use the links on the right side of this page to find more detailed information about standard questions types.'''

==Standard question types==

=== Calculated ===
Calculated questions offer a way to create individual numerical questions by the use of wildcards that are substituted with individual values when the quiz is taken. [[Calculated_question_type|More on the Calculated question type]]

===Calculated multi-choice===
Calculated multichoice questions are like multichoice questions with the additonal property that the elements to select can include formula results from numeric values that are selected randomly from a set when the quiz is taken. They use the same wildcards than Calculated questions and their wildcards can be shared with other Calculated multichoice or regular Calculated questions.

The main difference is that the formula is included in the answer choice as {=...} i.e if you calculate the surface of a rectangle {={l}*{w}}.

See fuller explanation [https://docs.moodle.org/36/en/Calculated_multichoice_question_type here].

===Calculated simple===
Simple calculated questions offer a way to create individual numerical questions whose response is the result of a numerical formula which contain variable numerical values by the use of wildcards (i.e {x} , {y}) that are substituted with random values when the quiz is taken.

The simple calculated questions offers the most used features of the calculated question with a much simpler creation interface. [https://docs.moodle.org/36/en/Simple_calculated_question_type More on the Simple Calculated Question type.]

=== Description ===
This question type is not actually a question. It just prints some text (and possibly graphics) without requiring an answer. This can be used to provide some information to be used by a subsequent group of questions, for example. [[Description_question_type|More on the Description question type]]

=== Essay ===
This allows students to write at length on a particular subject and must be manually graded.

It is possible for a teacher to create a template to scaffold the student's answer in order to give them extra support. The template is then reproduced in the text editor when the student starts to answer the question. See Youtube video [http://youtu.be/BAZa66WvyWQ Essay scaffold with the Moodle quiz]

{|
| [[File:templatebox.png|thumb|Response template in question set up screen]]
| [[File:quiztemplate.png|thumb|What the student sees]]
|
|}

=== Matching ===
A list of sub-questions is provided, along with a list of answers. The respondent must "match" the correct answers with each question. [[Matching_question_type|More on the Matching question type]]

=== Embedded Answers ([http://en.wikipedia.org/wiki/Cloze_test Cloze Test] / Gap Fill) ===
These very flexible questions consist of a passage of text (in Moodle format) that has various answers embedded within it, including multiple choice, short answers and numerical answers. [[Embedded_Answers_(Cloze)_question_type|More on the Embedded Answers question type]]

=== Multiple choice ===
With the [[Multiple Choice question type]] you can create single-answer and multiple-answer questions, include pictures, sound or other media in the question and/or answer options (by inserting HTML) and weight individual answers.

=== Short Answer ===
In response to a question (that may include an image), the respondent types a word or phrase. There may several possible correct answers, with different grades. Answers may or may not be sensitive to case. [[Short-Answer_question_type|More on the Short Answer question type]]

=== Numerical ===
From the student perspective, a numerical question looks just like a short-answer question. The difference is that numerical answers are allowed to have an accepted error. This allows a continuous range of answers to be set. [[Numerical_question_type|More on the Numerical question type]]
===Random short-answer matching===
From the student perspective, this looks just like a Matching question. The difference is that the sub-questions are drawn randomly from Short Answer questions in the current category. [[Random_Short-Answer_Matching_question_type|More on the Random Short-Answer Matching question type]]
=== True/False ===
In response to a question (that may include an image), the respondent selects from two options: True or False. [[True/False_question_type|More on the True/False question type]]

==Third-party question types==

Besides the standard question types that are part of the core Moodle distribution, there are a number of [https://moodle.org/plugins/browse.php?list=category&id=29 question type add-ons] in [https://moodle.org/plugins the add-ons database].

Some of those add-ons have additional documentation in [[Third-party_question_types|Third-party question types]]:

==See also==
[[Lesson questions]]

[[Category:Quiz]]
[[Category:Teacher]]
[[Category:Lesson]]

[[ca:Tipus_de_preguntes]]
[[es:Tipos de preguntas]]
[[eu:Galdera-motak]]
[[fr:Types de questions]]
[[ja:問題タイプ]]

Question types

2014-08-23T17:01:56Z

Cburell: /* Calculated multi-choice */ Added summary from Doc page for this question with link to full explanation.

{{Questions}}You may add a variety of different types of questions in the Quiz and Lesson modules. This page is about [[Quiz module]] question types; some will be similar to [[Lesson questions]] types, which are fewer in number and function differently. The standard quiz question types are listed below with brief descriptions. '''Please use the links on the right side of this page to find more detailed information about standard questions types.'''

==Standard question types==

=== Calculated ===
Calculated questions offer a way to create individual numerical questions by the use of wildcards that are substituted with individual values when the quiz is taken. [[Calculated_question_type|More on the Calculated question type]]

===Calculated multi-choice===
Calculated multichoice questions are like multichoice questions with the additonal property that the elements to select can include formula results from numeric values that are selected randomly from a set when the quiz is taken. They use the same wildcards than Calculated questions and their wildcards can be shared with other Calculated multichoice or regular Calculated questions.

The main difference is that the formula is included in the answer choice as {=...} i.e if you calculate the surface of a rectangle {={l}*{w}}.

See fuller explanation [https://docs.moodle.org/36/en/Calculated_multichoice_question_type here].

===Calculated simple===

=== Description ===
This question type is not actually a question. It just prints some text (and possibly graphics) without requiring an answer. This can be used to provide some information to be used by a subsequent group of questions, for example. [[Description_question_type|More on the Description question type]]

=== Essay ===
This allows students to write at length on a particular subject and must be manually graded.

It is possible for a teacher to create a template to scaffold the student's answer in order to give them extra support. The template is then reproduced in the text editor when the student starts to answer the question. See Youtube video [http://youtu.be/BAZa66WvyWQ Essay scaffold with the Moodle quiz]

{|
| [[File:templatebox.png|thumb|Response template in question set up screen]]
| [[File:quiztemplate.png|thumb|What the student sees]]
|
|}

=== Matching ===
A list of sub-questions is provided, along with a list of answers. The respondent must "match" the correct answers with each question. [[Matching_question_type|More on the Matching question type]]

=== Embedded Answers ([http://en.wikipedia.org/wiki/Cloze_test Cloze Test] / Gap Fill) ===
These very flexible questions consist of a passage of text (in Moodle format) that has various answers embedded within it, including multiple choice, short answers and numerical answers. [[Embedded_Answers_(Cloze)_question_type|More on the Embedded Answers question type]]

=== Multiple choice ===
With the [[Multiple Choice question type]] you can create single-answer and multiple-answer questions, include pictures, sound or other media in the question and/or answer options (by inserting HTML) and weight individual answers.

=== Short Answer ===
In response to a question (that may include an image), the respondent types a word or phrase. There may several possible correct answers, with different grades. Answers may or may not be sensitive to case. [[Short-Answer_question_type|More on the Short Answer question type]]

=== Numerical ===
From the student perspective, a numerical question looks just like a short-answer question. The difference is that numerical answers are allowed to have an accepted error. This allows a continuous range of answers to be set. [[Numerical_question_type|More on the Numerical question type]]
===Random short-answer matching===
From the student perspective, this looks just like a Matching question. The difference is that the sub-questions are drawn randomly from Short Answer questions in the current category. [[Random_Short-Answer_Matching_question_type|More on the Random Short-Answer Matching question type]]
=== True/False ===
In response to a question (that may include an image), the respondent selects from two options: True or False. [[True/False_question_type|More on the True/False question type]]

==Third-party question types==

Besides the standard question types that are part of the core Moodle distribution, there are a number of [https://moodle.org/plugins/browse.php?list=category&id=29 question type add-ons] in [https://moodle.org/plugins the add-ons database].

Some of those add-ons have additional documentation in [[Third-party_question_types|Third-party question types]]:

==See also==
[[Lesson questions]]

[[Category:Quiz]]
[[Category:Teacher]]
[[Category:Lesson]]

[[ca:Tipus_de_preguntes]]
[[es:Tipos de preguntas]]
[[eu:Galdera-motak]]
[[fr:Types de questions]]
[[ja:問題タイプ]]

Dataform building

2014-08-18T22:28:53Z

Cburell: /* Resource or Activity? */ fixed typo: "seen is" to "seen as"

{{Dataform}}
{{Dataform Docs Note 1}}
==Understanding the Dataform activity==
===Resource or Activity?===
A Dataform instance is essentially a collection of content entries entered and interacted with by the activity participants. The type of content, the content itself and the manner of interaction depend on the specific objectives of the intended activity.

Moodle divides modules into two groups, Activities and Resources. Modules that involve something that a participant will do by way of interaction with other participants are typically classified as [[Activities]]. Modules that can be seen as mere channels of content are typically classified as [[Resources]]. To be sure, this classification is often not a clear-cut as some Activity modules do not really involve interaction between participants (e.g. Quiz) and some Resource modules can be constructed with interactive components and allow interaction between participants (e.g. adding comments block to Book pages).

The Dataform is an example for a module that can be used either as an Activity or as a Resource depending on the specific application and/or learning objectives. When adding an instance to the course via the 'Add an activity or resource' link, the Dataform is listed in the Group of activities only because it can appear in one group only.

Application wise, the Dataform can emulate many of the standard Moodle resources and activities at least to a certain extent. It's real strength is where the desired behaviour of the resource or activity is not quite standard and the non-standard part can be applied by means of components that are included in the Dataform or can be easily plugged in. Of course, designated modules are likely to be more user friendly for setup within their intended scope than the generic Dataform.

===Building blocks===
The main building blocks of a Dataform activity are fields, views and entries. Each activity typically consists of several views through which content can be submitted and viewed, fields that store submitted content, and entries which are the virtual containers of the submitted content.

[[File:df-structure-view-entry-field.png]]

====View====
A '''view''' is a named entity that allows you to control the way activity content is submitted and displayed.
====Field====
A '''field''' is a named entity that can have content and/or behaviour.
====Entry====
An '''entry''' is a virtual content entity, such as an article in a dictionary or encyclopedia, a record in a log or a diary, or any other list item that can be organized in a similar way.

===Templates and patterns===
This is similar to the technique used to mail merge letters in word processors such as Open Office Writer or Microsoft Word. In designated areas in the View configuration form you can insert special patterns that will be replaced with certain content when the view is displayed. The designated areas for these patterns are typically WYSIWYG editors which allow you to insert static content and decorations in addition to the patterns in order to create the desired visual effect.

For example, in order to display the list of entries in the view, you need to have the pattern ##entries## in the View template area in the view configuration form. In most view types this pattern is added by default when you create the view. If you delete it and want to re-insert it, you can either select it from the View patterns dropdown under the editor or simply type it in. Now you can add decorations to the layout.

The view template and its display with only the ##entries## pattern:

[[File:df-view_template-styling2.png|400px]] [[File:df-view_template-styling3.png|200px]]

The template and its display with the ##entries## pattern and additional content and styles:

[[File:df-view_template-styling.png|400px]] [[File:df-view_template-styling1.png|200px]]

==Building a simple activity==
<mediaplayer>http://www.youtube.com/watch?v=Ab9jLl8ZV90</mediaplayer>

[[es:Dataform Hello World]]

==Setting permissions==
TBC

Building Database

2014-08-08T13:50:31Z

Cburell: changed Input to input

{{Database}}
After creating a database, as explained in [[Database activity settings]]...
* Next you define the kind of fields that define the information you wish to collect. For example a database of famous paintings may have a picture field called ''painting'', for uploading an image file showing the painting, and two text fields called ''artist'' and ''title'' for the name of the artist and the painting. Alternatively, you can use a database preset (see below).
* It is then optional to edit the [[Database templates|database templates]] to alter the way in which the database displays entries.

==Database fields==

A '''field''' is a named unit of information. Each entry in a [[Database activity module|database activity module]] can have multiple fields of multiple types e.g. a text field called 'favourite color' which allows you to type in your favourite shade, or a menu called 'state' that lets you choose one from a list of the 50 that make up the United States of America. By combining several fields with appropriate names and types you should be able to capture all the relevant information about the items in your database.

Note that if you later edit the fields in the databases you must use the Reset template button, or manually edit the template, to ensure the new fields are added to the display.

=== Field name and description ===

The name is what is shown when an entry is added. It must be unique and short. The description is for your benefit to help identify that field.

=== Field types ===

The following screenshots show "before" and "afters" of setting up fields. The selection in orange shows the field as it is displayed for the user when they add an entry.

;Checkbox
:This allows you to offer checkboxes for the user to select. Add the options one under the other. The word will appear next to a checkbox when the user clicks to add an entry. They can check more than one box.

[[File:Checkboxfield1.png]]

;Date
:This allows a user to enter a date by picking a day, month and year from a drop down list.

[[File:Datefield1.png]]

;File
:Users can upload a file from their computer. If it is an image file then the picture field may be a better choice.

[[File:Filefield.png]]

;Latitude/longitude
:Users can enter a geographic location using latitude and longitude. For example, [http://moodle.com/hq/ Moodle HQ] is at latitude -31.9545, longitude 115.877. When viewing the record, links are automatically generated linking to geographic data services such as [http://earth.google.com Google Earth], [http://www.openstreetmap.org/ OpenStreetMap], [http://www.geabios.com/ GeaBios],[http://www.mapstars.com/extern/deltaworks-holland Mapstars] and more. (The teacher can choose which of those links appear, if any.)

[[File:Latlongfield.png]]

;Menu
:The text entered in the ''options'' area will be presented as a drop-down list for the user to choose from. Each line become a different option.

[[File:Menufield.png]]

;Menu (Multi-select)
:The text entered in the ''options'' area will be presented as a list for the user to choose from and each line become a different option. By holding down control or shift as they click, users will be able to select multiple options. This is a fairly advanced computer skill so it may be wise to use multiple checkboxes instead.

[[File:Multiselectfield.png]]

;Number
:This allows users to enter any number. For example:
* 42
* -1000
* 0
* 0.123
* 3.0e8
:(For those who care about the technical details, the field stores floating point numbers.)

[[File:Numberfield.png]]

;Picture
:This allows a user to upload and display an image file. "Single view" is when the image is viewed on its own; "list view" is when it is viewed in with other images. Single view can be larger than list view.

[[File:Picturefield.png]]

;Radio buttons
:The user gets radio buttons and can choose only one. They can only submit the entry when they have clicked on one button. (Note:If you only have two options and they are opposites (true/false, yes/no) then you could simply use a single checkbox instead. However checkboxes default to their unchecked status and so people could submit without actively selecting one of the options. This may not always be appropriate.)

[[File:Radiofield.png]]

;Text input
:Users can enter text up to 60 characters in length. For longer text, or for text that requires formatting such as headers and bullet points, you can use a text area field.

[[File:Textfield.png]]

;Text area
:This allows users to enter a long piece of text using the text editor.

[[File:Textareafield.png]]

;URL
:The user can add a link to a website here. If you select ''autolink'' then the URL becomes clickable.. If you also enter a ''forced name for the link'' then that text will be used for the hyperlink. For example in a database of authors you may wish people to enter the author's website. If you enter the text 'homepage' as a forced name then clicking on text "homepage" will take you to the entered URL.
You can choose to have the URL open in a new window if so desired.

[[File:Urlfield.png]]

==Presets==

To avoid the necessity of always having to create a new database from scratch, the database activity module has a presets feature. An image gallery preset is currently included in the database module to help get you started. You can create your own presets as well and share them with others.

===Importing a preset===

[[Image:databasepresetsnew.png|thumb|Database presets page]]
To use a preset:

# On the database page, click the Presets tab.
# The usual way to import a preset is clicking the "Choose file" button and browsing to the ZIP file containing the preset (eg. "preset.zip") stored on the server. If there does not yet exist a preset ZIP file on the server, upload it from your local machine. Choose the desired preset file by clicking on its action "Choose". Finally, press the "Import" button.
# Alternatively, you can choose a previously loaded preset.
# After the import, you can start to add or import entries. All the hard work of setting up the fields and templates has been done for you. If you desire, you can still customize the fields and templates.

You will see a "Overwrite current settings" checkbox after the "Import" button has been pressed. If checked, the database activity overwrites some of its current general settings by those stored in the preset:
* the "Introduction" HTML text
* "Required entries"
* "Entries required before viewing"
* "Maximum entries"
* "Comments"
* "Require approval?"
* rssarticles

===Exporting a preset===

If you wish to share your database presets with others, you have two options:

#Export as a ZIP file, which can then be imported to another course or Moodle site.
#Save as a preset, which publishes the database for other teachers on your site to use. It will then appear in the preset list. (You can delete it from the list at any time.)

Note: Only the fields and templates of the database are copied when exporting or saving it as a preset, not the entries.

===Presets for download===

The [http://school.demo.moodle.net/course/view.php?id=57 Activity Examples course] on the School demo site has a number of database activities with presets for download.

==See also==
*[http://youtu.be/sRxDg7tGyjw Moodle 2.0 Database - part 1 ] MoodleBites video on YouTube
*[http://youtu.be/RRHy7vjCc7E Moodle 2.0 Database - part 2] MoodleBites video on YouTube

Using Moodle forum discussions:
*[http://moodle.org/mod/forum/discuss.php?d=84050 Can't get columns to line up in list view] including moodle.org presets for download
*[http://moodle.org/mod/forum/discuss.php?d=87005 New preset, please review, and make suggestions!] including FAQ preset for download
*[http://moodle.org/mod/forum/discuss.php?d=87560 Issue 53: Encyclopedia database preset] including encyclopedia-style preset for download
*[http://moodle.org/mod/forum/discuss.php?d=88727 Issue 51 - Design a Database Preset for Document Sharing] including preset for download
*[http://moodle.org/mod/forum/discuss.php?d=94854#p457252 Looking for some stellar examples of Moodle courses] including book reviews preset for download
*[http://moodle.org/mod/forum/discuss.php?d=89117#p511029 Restricting access to database content by user?] with research diary preset for download

[[de:Datenbank erstellen]]

Building Database

2014-08-08T13:49:02Z

Cburell: Made "Text" field "Text Input" (2.7 label)

{{Database}}
After creating a database, as explained in [[Database activity settings]]...
* Next you define the kind of fields that define the information you wish to collect. For example a database of famous paintings may have a picture field called ''painting'', for uploading an image file showing the painting, and two text fields called ''artist'' and ''title'' for the name of the artist and the painting. Alternatively, you can use a database preset (see below).
* It is then optional to edit the [[Database templates|database templates]] to alter the way in which the database displays entries.

==Database fields==

A '''field''' is a named unit of information. Each entry in a [[Database activity module|database activity module]] can have multiple fields of multiple types e.g. a text field called 'favourite color' which allows you to type in your favourite shade, or a menu called 'state' that lets you choose one from a list of the 50 that make up the United States of America. By combining several fields with appropriate names and types you should be able to capture all the relevant information about the items in your database.

Note that if you later edit the fields in the databases you must use the Reset template button, or manually edit the template, to ensure the new fields are added to the display.

=== Field name and description ===

The name is what is shown when an entry is added. It must be unique and short. The description is for your benefit to help identify that field.

=== Field types ===

The following screenshots show "before" and "afters" of setting up fields. The selection in orange shows the field as it is displayed for the user when they add an entry.

;Checkbox
:This allows you to offer checkboxes for the user to select. Add the options one under the other. The word will appear next to a checkbox when the user clicks to add an entry. They can check more than one box.

[[File:Checkboxfield1.png]]

;Date
:This allows a user to enter a date by picking a day, month and year from a drop down list.

[[File:Datefield1.png]]

;File
:Users can upload a file from their computer. If it is an image file then the picture field may be a better choice.

[[File:Filefield.png]]

;Latitude/longitude
:Users can enter a geographic location using latitude and longitude. For example, [http://moodle.com/hq/ Moodle HQ] is at latitude -31.9545, longitude 115.877. When viewing the record, links are automatically generated linking to geographic data services such as [http://earth.google.com Google Earth], [http://www.openstreetmap.org/ OpenStreetMap], [http://www.geabios.com/ GeaBios],[http://www.mapstars.com/extern/deltaworks-holland Mapstars] and more. (The teacher can choose which of those links appear, if any.)

[[File:Latlongfield.png]]

;Menu
:The text entered in the ''options'' area will be presented as a drop-down list for the user to choose from. Each line become a different option.

[[File:Menufield.png]]

;Menu (Multi-select)
:The text entered in the ''options'' area will be presented as a list for the user to choose from and each line become a different option. By holding down control or shift as they click, users will be able to select multiple options. This is a fairly advanced computer skill so it may be wise to use multiple checkboxes instead.

[[File:Multiselectfield.png]]

;Number
:This allows users to enter any number. For example:
* 42
* -1000
* 0
* 0.123
* 3.0e8
:(For those who care about the technical details, the field stores floating point numbers.)

[[File:Numberfield.png]]

;Picture
:This allows a user to upload and display an image file. "Single view" is when the image is viewed on its own; "list view" is when it is viewed in with other images. Single view can be larger than list view.

[[File:Picturefield.png]]

;Radio buttons
:The user gets radio buttons and can choose only one. They can only submit the entry when they have clicked on one button. (Note:If you only have two options and they are opposites (true/false, yes/no) then you could simply use a single checkbox instead. However checkboxes default to their unchecked status and so people could submit without actively selecting one of the options. This may not always be appropriate.)

[[File:Radiofield.png]]

;Text Input
:Users can enter text up to 60 characters in length. For longer text, or for text that requires formatting such as headers and bullet points, you can use a text area field.

[[File:Textfield.png]]

;Text area
:This allows users to enter a long piece of text using the text editor.

[[File:Textareafield.png]]

;URL
:The user can add a link to a website here. If you select ''autolink'' then the URL becomes clickable.. If you also enter a ''forced name for the link'' then that text will be used for the hyperlink. For example in a database of authors you may wish people to enter the author's website. If you enter the text 'homepage' as a forced name then clicking on text "homepage" will take you to the entered URL.
You can choose to have the URL open in a new window if so desired.

[[File:Urlfield.png]]

==Presets==

To avoid the necessity of always having to create a new database from scratch, the database activity module has a presets feature. An image gallery preset is currently included in the database module to help get you started. You can create your own presets as well and share them with others.

===Importing a preset===

[[Image:databasepresetsnew.png|thumb|Database presets page]]
To use a preset:

# On the database page, click the Presets tab.
# The usual way to import a preset is clicking the "Choose file" button and browsing to the ZIP file containing the preset (eg. "preset.zip") stored on the server. If there does not yet exist a preset ZIP file on the server, upload it from your local machine. Choose the desired preset file by clicking on its action "Choose". Finally, press the "Import" button.
# Alternatively, you can choose a previously loaded preset.
# After the import, you can start to add or import entries. All the hard work of setting up the fields and templates has been done for you. If you desire, you can still customize the fields and templates.

You will see a "Overwrite current settings" checkbox after the "Import" button has been pressed. If checked, the database activity overwrites some of its current general settings by those stored in the preset:
* the "Introduction" HTML text
* "Required entries"
* "Entries required before viewing"
* "Maximum entries"
* "Comments"
* "Require approval?"
* rssarticles

===Exporting a preset===

If you wish to share your database presets with others, you have two options:

#Export as a ZIP file, which can then be imported to another course or Moodle site.
#Save as a preset, which publishes the database for other teachers on your site to use. It will then appear in the preset list. (You can delete it from the list at any time.)

Note: Only the fields and templates of the database are copied when exporting or saving it as a preset, not the entries.

===Presets for download===

The [http://school.demo.moodle.net/course/view.php?id=57 Activity Examples course] on the School demo site has a number of database activities with presets for download.

==See also==
*[http://youtu.be/sRxDg7tGyjw Moodle 2.0 Database - part 1 ] MoodleBites video on YouTube
*[http://youtu.be/RRHy7vjCc7E Moodle 2.0 Database - part 2] MoodleBites video on YouTube

Using Moodle forum discussions:
*[http://moodle.org/mod/forum/discuss.php?d=84050 Can't get columns to line up in list view] including moodle.org presets for download
*[http://moodle.org/mod/forum/discuss.php?d=87005 New preset, please review, and make suggestions!] including FAQ preset for download
*[http://moodle.org/mod/forum/discuss.php?d=87560 Issue 53: Encyclopedia database preset] including encyclopedia-style preset for download
*[http://moodle.org/mod/forum/discuss.php?d=88727 Issue 51 - Design a Database Preset for Document Sharing] including preset for download
*[http://moodle.org/mod/forum/discuss.php?d=94854#p457252 Looking for some stellar examples of Moodle courses] including book reviews preset for download
*[http://moodle.org/mod/forum/discuss.php?d=89117#p511029 Restricting access to database content by user?] with research diary preset for download

[[de:Datenbank erstellen]]

Gradebook

2014-08-04T18:54:41Z

Cburell: /* See also */ Added iMoot 2013 presentation--very thorough--on everything but outcomes. Incredibly relieving discovery.

{{Grades}}
All the grades for each student in a course can be found in the course gradebook, or 'Grader report' in ''Administration > Course administration > Grades''.

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.

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

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

==Display==

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

You can add a row showing the range of possible scores by selecting 'Show ranges' in 'My report preferences.

There are three ways that the categories can be displayed:

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

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

[[Image:Grades grader report with categories 1.png]]

===Highlighting rows and columns===

When your gradebook starts to grow, it can be hard to keep track of which student and which assignment a cell refers to. Highlighting solves that.
* Clicking on empty space in the cell that contains the students name will toggle the highlighting of that entire row
* Clicking on empty space in the cell at the top of each column will toggle highlighting of the entire column
(Note: this requires Javascript to be enabled in your browser.)

===Sorting by columns===

You can sort by any column. Click the [[Image: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.

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.

[[File:Grade_Report_unsorted_name1.png]]

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

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

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

===Horizontal scrollbar===

A horizontal scrollbar enables teachers to scroll grades in the grader report.

{{New features}}
The horizontal scrollbar is available both at the bottom and at the top of the grader report.

[[Image:horizontalscrollbar.png|thumb|center|500px|Horizontal scrollbars]]

===Mouse-over tooltips===

Each grade cell in the table has a tooltip indicating the user and grade item to which the grade belongs.

===Searching and filtering the gradebook===
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.

{{New features}}
It is also possible to search students by first name and last name:

[[File:gradebooksearch.png]]

==Editing==

Note: Editing anything in the gradebook refers to editing the grades '''only''' and none of the available operations bear any relationship to editing the main course page i.e. the appearance of your course page cannot be influenced by anything you do in the gradebook. The "Turn editing on" button functions separately from the main course one, so editing can be on in the gradebook, but simultaneously off when you switch back to course view. This is because editing grades and editing the course page are separate capabilities. Roles such as 'non-editing teacher' may only have one or the other.

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

Alternatively, you can 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.

Note: If you make changes here, they are then shown highlighted to indicate grades which have been manually changed.

===Hiding columns or individual grades===
Turning on editing then clicking the "Show show/hide icons" link will give you the familiar show/hide eye icon next to each grade and at the top of each column. For more information, read about [[Grade_hiding|grade hiding]].

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

==Gradebook capabilities==

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.

==Extending the gradebook==

The Gradebook can be extended in three main ways:

===1. [https://moodle.org/plugins/browse.php?list=category&id=9 Grade reports]===
Which are the main way to view and manipulate grades
* [[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.
* [https://moodle.org/plugins/view.php?plugin=gradereport_updfgrades Upload PDF Grader Report] lets you view assignment grades, comments and lateness in a report

===2. Grade import plugins===
Which allow data to be imported from external sources

===3. [https://moodle.org/plugins/browse.php?list=category&id=10 Grade export plugins]:===
Which allow you to export grade data for other systems
* [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"
* [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.

==See also==

* Join the discussions about gradebook plugins in the [https://moodle.org/mod/forum/view.php?id=2122 Gradebook forum].

*[http://www.youtube.com/watch?v=5hrLNbifiGQ Video explaining the different gradebook reports]
*[http://youtu.be/5FbOti83Nkw Moodle 2.x Gradebook (part 1)] MoodleBites video on YouTube
*[http://youtu.be/Dg-10yQBXuM Moodle 2.x Gradebook (part 2)] MoodleBites video on YouTube
*[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.

[[de:Bewertungen]]
[[es:Libro de calificaciones]]
[[fr:Carnet de notes]]
[[ja:評定表]]

Talk:Forum FAQ

2014-03-09T20:07:20Z

Cburell: proposed 2 new FAQs

Suggested FAQ addition:

"How can a teacher see all of a student's forum posts in a course?"
"How can students see all of their forum posts on Moodle?"

I don't find it addressed anywhere obvious, and it's a basic need for quick navigation and assessment.

Talk:Import questions

2014-01-09T16:53:59Z

Cburell: Created page with "Importing Embedded Cloze Questions in MoodleXML format into a Lesson file isn't working for me. Is there a known issue here? --~~~~"

Importing Embedded Cloze Questions in MoodleXML format into a Lesson file isn't working for me. Is there a known issue here? --[[User:Clay Burell|Clay Burell]] ([[User talk:Clay Burell|talk]]) 00:53, 10 January 2014 (WST)

Talk:Moodle XML format

2014-01-09T16:43:08Z

Cburell:

Would it be clearer to name this page "Moodle Question XML format", since it only describes the XML format for questions, not for glossaries, courses, or SCORM?
(Ideally the other XML formats would have separate pages, although I don't see much documentation for those formats.)

--[[User:Clif Kussmaul|Clif Kussmaul]] ([[User talk:Clif Kussmaul|talk]]) 18:54, 17 July 2013 (WST)

: Well, in the Moodle user interface, the format is called Moodle XML format, and has been for years. So, renaming this page will reduce some forms of confusion, but increase others.--[[User:Tim Hunt|Tim Hunt]] ([[User talk:Tim Hunt|talk]]) 19:37, 17 July 2013 (WST)

----
MoodleXMLBuilder link at "Useful Utilities" section goes to a 404 Not Found page, fyi.--[[User:Clay Burell|Clay Burell]] ([[User talk:Clay Burell|talk]]) 00:43, 10 January 2014 (WST)