MoodleDocs - User contributions [en]

HTML editor

2019-06-24T17:19:46Z

Rcollman: /* Inserting images */

<p class="note">'''Note:''' There is a new HTML editor in Moodle 2.0 onwards. See [[HTML editor 2.0]] for details.</p>

Moodle has a standard toolbar that serves as an HTML interface. Many of the icons on the tool bar can be found on most text editing (word processing) programs. This page will cover some of the icons/tools which may not be as familiar to a new user of Moodle.

For example, you can cut/copy and paste text from other applications into this editor and formatting will be preserved. There is the usual [[Image:Ed paste.gif]] clipboard icon which is for pasting text that has been copied or cut. Or use the usual short cut keys of Control+C and Control+V .

==HTML editor toolbar features==
[[Image:HTMLeditor_tools_M2_1.png|frame|center|HTML editor toolbar in 2.0. See [[HTML editor 2.0]]]]
[[Image:Course Lesson Page Content Toolbar.GIF|frame|center|HTML editor toolbar in a 1.9.5 Lesson page, other modules will look similar.]]

__TOC__

===Font and background colours===
There are two icons to change the [[Image:Ed color fg.gif]] font and the [[Image:Ed color bg.gif]] colour behind text. Clicking on the icon will bring up a color pallet. Note the HTML color code is displayed.
[[Image:HTML toolbar Color pallet.JPG|center]]

===Anchor===
[[Image:Ed anchor.gif]] An HTML anchor identifies text within a page which can be referenced by a link. To use the Anchor, highlight the word, then click on the Anchor icon. Give the anchor a name. Anywhere on the page, highlight the word you would like to link to the Anchor. Use the Link icon and the pull down menu to find the correct anchor.
[[Image:HTML toolbar anchor tool.JPG]]

===Inserting links===
[[Image:Ed link.gif|left|]] An HTML link creates a path to an external, internal or within the current page. The icon saves writing code. One method is to copy the address bar from the location you want, click on the link icon, then paste the URL. Another method is to press the Browse button, which will display the [[Files]] area of the course, from whence you select an existing file or upload a new file and link to that.

'''To make a new link'''
*Type the text that you want to serve as the anchor for your link
***For example: "Link to course file in demo.moodle.org"
*Select the text
***For example select "course file" by highlighting it with your mouse.
*Click the [[Image:Ed link.gif]] link button in the toolbar
*Type (or paste, or browse to) the URL you want to link to
***For example we used "browse", and clicked on the file to get our entry
*Type in some text which will appear when the mouse rolls over it
***For example: "Course file in demo moodle."
*Target - What kind of window should be called up -- typically, open a New window.
***[[Image:HTML editor insert link target menu.jpg]]
*Anchors - A pull down list allows you to select an [[HTML_editor#Anchor|anchor]] you previously created on the page
*Click OK

[[Image:HTML toolbar Hyperlink.JPG|center]]

*After the above steps the student will see:
**[[Image:HTML toolbar Insert Link result1.jpg|frame|center|This result]]

* [[Image:Ed unlink.gif]] The unlink, will remove the HTML link from the selected text.

====TIPs - inserting links====
*This process does '''NOT''' work inside the wiki module where you need to use the Wiki link system (square brackets containing the label and the link separated by a vertical line character)
*A course file has a URL address that can be found via the browse button

===Prevent Automatic Linking===
* [[Image:Ed nolink.gif]] The prevent automatic linking icon prevents the selected text from being linked to [[Glossary]]. For example, this is useful in a quiz question or where the links are distracting in a presentation.

This also prevents automatic linking to activity or resource pages within the same course if the Resource Names Auto-linking filter has been enabled at Site level.

===Inserting images===
[[Image:Ed_image.gif]] Moodle allows you to upload pictures into a course or site folder, then insert that image into the content area. It is also possible to use an existing image located outside of your Moodle site.

You can include images in the content area by using the [[Image:Ed_image.gif]] button. This will bring up an insert image edit screen to assist you in inserting an picture. More detailed instructions for [[Insert image|inserting an image can be found here]]. Moodle recognizes JPG, GIF and PNG as image files.
[[Image:HTML Insert Image tool pop-up.JPG|thumb|center|300px|[[Insert image| Insert image page link]] in Moodle Documentation]]

If you wish to change an image, give the new image a different file name and link to that. Some servers will cache the file, thus when you review the change it will still show the old image.

===Inserting tables===
* [[Image:Insert table.gif]] To add layout to your texts, you can use the "Insert Tables" button in the toolbar.

[[Image:HTML toolbar table settings.jpg|center]]
*Most table editing tools are only visible if you click the '''Enlarge Editor''' button.

===Inserting smilies (emoticons)===

The smiley icon [[Image:Smiley.gif]] will allow you to add a small icon (for example [[Image:Cool.gif]] ) in your text. A dialog will pop up that allows you to select from a table of smiley icons. Alternatively, you can just type the corresponding code straight into your text and it will be converted later when your text is displayed.
[[Image:HTML toolbar Smiley icon selections.JPG|center]]

===Clean Word button===
The clean Word [[Image:Ed wordclean.gif]] button removes some Word formatting from your pasted text so that the page is smaller, less complex and thus loads faster. The [http://www.microsoft.com/downloads/details.aspx?FamilyID=209ADBEE-3FBD-482C-83B0-96FB79B74DED&displaylang=EN Microsoft Office HTML Filter 2.0] removes all Word code from HTML file far more effectively for Office 2000. This filter is already built into office in Microsoft Office XP onwards.

===Special characters===
The special characters [[Image:special characters button.gif]] button, allows you to enter special characters from a table.
[[Image:HTML_toolbar_Special_character_selections.JPG|center]]

===Toggle to HTML Code editing===

The [[Image: Ed html.gif]] button changes the display window to raw HTML code. This can be useful for those of you that know how to use it (or want to learn!). Most of the buttons do not work in this view, including many of the hotkeys.

[[Image:HTML editor HTML code example.png|thumb|center|400px|Example of HTML code for content area in a forum post ]]

===Enlarge editor===
The [[Image:Fullscreen maximize.gif]] button will expand the HTML editor area.

===Clean Word button===
The clean Word [[Image:Ed wordclean.gif]] button removes some Word formatting from your pasted text so that the page is smaller, less complex and thus loads faster. The [http://www.microsoft.com/downloads/details.aspx?FamilyID=209ADBEE-3FBD-482C-83B0-96FB79B74DED&displaylang=EN Microsoft Office HTML Filter 2.0] removes all Word code from HTML file far more effectively for Office 2000. This filter is already built into office in Microsoft Office XP onwards.

==Shortcut keys==
Here are some common editing short cut or hot keys which will within the HTML editor in WYSIWYG view. Different operating systems and browsers may not support all these keys. The most universal hot keys are in''' bold'''.
{| border="0" cellpadding="2" cellspacing="0" style="text-align:left"
! width="70"|Keys
! width="300"|Action
! width="10"|
! width="70"|Keys
! width="300"|Action

|-
| '''Ctrl-C'''
| Copy
|
| '''Ctrl-V'''
| Paste

|-
| '''Ctrl-X'''
| Cut
|
| '''Ctrl-F'''
| Find text

|-
| Ctrl-H
| Find and replace
|
| *
| *

|-
| '''Ctrl-Z'''
| Undo
|
| '''Ctrl-Y'''
| Redo

|-
| '''Ctrl-B'''
| Make text bold
|
| '''Ctrl-I'''
| Make text italic

|-
| '''Ctrl-U'''
| Underline text
|
| '''Ctrl-S'''
| Strikethrough text

|-
| Ctrl-H
| Change text format (headings etc.)
|
| Ctrl-1
| to Ctrl-6 Change heading level

|-
| Ctrl-,
| Subscript
|
| Ctrl-.
| Superscript

|-
| Ctrl-O
| Change the font
|
| Ctrl-0
| Clean Word HTML

|-
| Ctrl-L
| Justify left
|
| Ctrl-E
| Center

|-
| Ctrl-J
| Justify full
|
| Ctrl-/
| Text runs left to right

|-
| Ctrl-<nowiki>|</nowiki>
| Text runs right to left
|
| Ctrl-;
| Decrease indent

|-
| Ctrl-'
| Increase indent
|
| Ctrl-G
| Change text colour

|-
| Ctrl-K
| Change background colour
|
| Ctrl-P
| Change the font size

|-
| Ctrl-`
| Switch to HTML source code view
|
| Ctrl-M
| Toggle fullscreen editor mode

|-
| Ctrl-Alt-O
| Insert ordered list
|
| Ctrl-Alt-U
| Insert unordered list

|-
| Ctrl-Alt-R
| Insert horizontal rule
|
| Ctrl-Alt-A
| Create anchor

|-
| Ctrl-Alt-L
| Create link
|
| Ctrl-Alt-D
| Unlink

|-
| Ctrl-Alt-N
| Turn off autolinking
|
| Ctrl-Alt-I
| Insert image

|-
| Ctrl-Alt-T
| Insert table
|
| Ctrl-Alt-S
| Insert emoticon

|-
| Ctrl-Alt-C
| Insert special character
|
| Ctrl-=
| Change text language for screen readers, or specify language for the Multilang filter

|}

==Tips and Tricks==
*[[Themes|Theme]] settings can control the default fonts in the HTML editor. It is possible to have individual themes for a context (for example, a course may have its own theme).

*When you choose many functions a new small window will open. Unfortunately it can often open BEHIND the window you are in so you may miss that anything has happened. You can check new windows with [Alt]+[Tab].

*The HTML editor does not work in all browsers. If you are using a Mac OS X and for some reason it does not appear, try using Firefox instead of Safari as a browser.

*To make the switch in Safari in Moodle 1.9:
:#With Safari open, go to Preferences in the Safari menu.
:#Select the Advanced tab.
:#At the bottom of the window, check "Show Develop menu in menu bar"
:#The second item in the Develop menu is "User Agent". Select a version of Firefox and possibly Internet Explorer also works.

*Cannot make HTML give you the text style you want? Use an image or even an animated gif file.

*It is possible to deploy your own custom smiley (emoticon) set. This is [[deploying_custom_emoticons|described here]].

==See also==

*[[HTML editor FAQ]]
*[[HTML editor 2.0]]
*[[Page content]] - for more assistance on using some of above editing icons
*[[Insert image]] - examples and instructions for inserting and editing images
*[[HTML in Moodle]]
*[[HTML editor settings]] - change the look of the HTML toolbar
*Extend HTMLAREA editor with an extra toolbar, full of useful plugins by using [[htmlarea_custom_plugins]] framework (tiny patch).

Using Moodle forum discussions:
*[http://moodle.org/mod/forum/discuss.php?d=64354 Question about insert image function in HTML editor] including methods of enabling students to insert images using the HTML editor
*[http://moodle.org/mod/forum/discuss.php?d=66805 Need to display english special phonetic symbols for ESL students]
*[http://moodle.org/mod/forum/discuss.php?d=83115 tables in HTML editor]

[[Category:HTML editor]]

[[fr:Éditeur HTML]]
[[ja:HTMLエディタ]]
[[pl:Edytor_HTML]]

Authentication

2012-02-14T15:21:34Z

Rcollman: /* Setting the authentication method */ give location, then the pull down menu for self enrollment.

Location: ''Administration > Users > Authentication > Manage authentication'' in 1.9

Authentication is the process which allows a user to login to a Moodle site. [[Site policies]] determines if users must login before reaching the [[Front Page]].

==Setting the authentication method==
[[Image:authentication plugins.png|thumb|Choosing an authentication plugin in Moodle 1.8 (only shows top of Authentication page)]]
To set the authentication method:

#Access ''Administration > Users > Authentication > Manage authentication'' in 1.9.
#On the Manage authentication page, click on the closed eye icon to enable your chosen [[Authentication|authentication plugin(s)]]. In Moodle 1.8 onwards, you can choose to use more than one authentication plugin (see Multi-authentication below). Use the up/down arrow icons to arrange the plugins in order, with the plugin handling the most logins at the top of the page.
#If you have chosen [[Email-based self-registration]] in active authentication plugins section, then scroll down to the common settings section, , in the self registration drop-down menu select "Email-based self-registration". Potential users will then be presented with a "Create new account" button on the login page.
#If you have courses with guest access, set the Guest login button to show.
#Click the "Save changes" button.
#Click on Settings opposite the authentication plugin(s) you have chosen.
#Configure the required settings and click the "Save changes" button.

==Authentication methods==

Authentication methods (also known as authentication plugins) include:

*[[Manual accounts]] - accounts created manually by an administrator
*[[No login]] - suspend particular user account
*[[Email-based self-registration]] - for enabling users to create their own accounts
*[[CAS server (SSO)]] - account details are located on an external CAS server
*[[External database authentication|External database]] - account details are located on an external database
*[[FirstClass authentication|FirstClass server]] - account details are located on an external FirstClass server
*[[IMAP authentication|IMAP server]] - account details are located on an external IMAP server
*[[LDAP authentication|LDAP server]] - account details are located on an external LDAP server
*[[MNet|Moodle Network authentication]] - how different Moodle sites can connect and authenticate users
*[[NNTP authentication|NNTP server]] - account details are located on an external NNTP server
*[[No authentication]] - for testing purposes only
*[[PAM (Pluggable Authentication Modules)]] - account details come from the operating system Moodle is running on, via PAM (can only be used Linux/Unix).
*[[POP3 server]] - account details are located on an external POP3 server
*[[RADIUS authentication|RADIUS server]] - account details are located on an external RADIUS server
*[[Shibboleth]] - account details are located on an external Shibboleth server
*[[NTLM authentication|NTLM/Integrated Authentication]] (contributed plugin prior to Moodle 1.9; is part of the LDAP authentication plugin from 1.9 onwards).

==Authentication types==

===Internal authentication===
This type of authentication is used when Moodle stores users' passwords and other details in local Moodle database. Authentication plugins such as manual and email are indicate as internal authentication

===External authentication===
Other authentication plugins (such as: LDAP or POP3) are indicate as external authentication. With this type of authentication, user's details are not required to be stored in local Moodle database and user's password field will be labeld as 'not cached'.

==Multi-authentication==
From Moodle 1.8 onwards, multi-authentication is supported. Each authentication plugin may be used to find a username/password match. Once found, a user is logged in and alternative plugins are not used. Therefore the plugin which handles the most logins should be moved to the top of the page in order that less load is put on authentication servers.

==Common settings==

===Self registration===

If you wish users to be able to create their own user accounts, i.e. self-register, then select Email-based self-registration (or any other enabled plugin that can support self registration, like LDAP) from the drop-down menu. This will result in a "Is this your first time here?" instructions and a "Create new account" button being displayed on the login page.

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 (see below). 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 with that plugin. Selecting Email-based self-registration as the self registration method allows potential users to self register.

===Guest login button===

You can hide or show the guest login button on the login page. Hiding the guest login button disables [[Guest role|guest access]] to the Moodle site, however logged-in users can still enter any courses which allow guest access without being required to enrol.

===Alternate login URL===

This should be used with care, since a mistake in the URL or on the actual login page can lock you out of your site. If you do mess it up, you can remove the entry from your database (table mdl_config) using, e.g., phpmyadmin for mysql.

===Forgotten password URL===

{{Moodle 1.9}}In Moodle 1.9 onwards, if your lost password handling is performed entirely outside of Moodle (for example, only by a help desk), you can set the url of that service here. Anybody pressing a "lost password" link in Moodle will be redirected to this URL. Note that this will disable '''all''' of Moodle's lost password recovery options regardless of authentication method(s) in use.

===Allowed and denied email domains===

Authentication may be restricted to particular email domains when using [[Email-based self-registration]] so that, for example, only students with a university email can login.

(Note: Prior to Moodle 1.9, the allowed and denied email domains settings can be found in ''Administration > Server > [[Email settings|Email]]''.) ('It should be:- Administration > User > Manage Authentication')

===Restrict domains when changing email===

In Moodle 1.9.3 onwards, you can choose to enforce email domains only when users create an account using [[Email-based self-registration]] i.e. after creating an account, users may change their email to a different domain.

===ReCAPTCHA===

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

From Moodle 1.9.1 onwards, 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.

ReCAPTCHA keys can be obtained from http://www.google.com/recaptcha by [https://www.google.com/recaptcha/admin/create signing up for an account] (free) then entering a domain. The public and private keys provided can then be copied and pasted into the ''recaptchapublickey'' and ''recaptchaprivatekey'' fields in the manage authentication common settings, and the changes saved.

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

==Profile fields data mapping and locking==
Most (but not all) authentication plugins that use an external source for the user account details allow us to retrieve some user profile details (like first name, last name, email, etc.). By using the Data Mapping section on those authentication plugins configuration page we can configure what, when and how to manage all those user profile details.

[[Image:Authent-data-map-fname.jpg|Data Mapping Options]]

These fields are optional. You can choose to pre-fill some Moodle user fields with information from the external authentication source (if you are using one), from the fields that you specify here. If you leave these fields blank, then nothing will be transferred from the external authentication source and Moodle defaults will be used instead. In either case, the user will be able to edit all of these fields after they log in.

In addition to specifying how to fill this fields, we can set how to update them (in both directions, to Moodle or from Moodle), and whether we want to lock them (so the user cannot modify their value) or not:

*'''Update local''': When the user field will be updated from the external authentication source:
** '''On creation''': when the user account is created during the first login
** '''On every login''': every time the user logs in (or there is a user synchronization, for those authentication plugins that support it). Fields set to update locally should be locked.
*'''Update external''': When the external authentication source will be updated from the user field:
** '''Never''': never update the external authentication source from Moodle.
** '''On update''': the external authentication source will be updated when the user profile is updated. Fields should be unlocked to allow edits.
*'''Lock value''': To prevent users from altering some fields (e.g. students changing profile information to inappropriate or misleading information), the site administrator can lock profile fields. It's usually a good idea to lock profile fields if you are maintaining this data in the external authentication system.
** '''Unlocked''': The field is unlocked and can be edited by the user at any time.
** '''Unlocked if empty''': The field is unlocked if it is empty, but once the user fills in some information, it becomes locked and cannot be edited any more.
** '''Locked''': The field is locked and cannot be edited by the user.

If you are using a mixture of authentication types (such as IMAP and manual), then the fields you map and lock in the authentication options are specific to that particular authentication plugin. Each authentication plugin has its own set of mapped and locked fields.

Remember to test the field locking by logging in with the proper type of account! If you test with a manual account but have set the field locking to apply to IMAP accounts, you will not be able to tell if it worked!

==See also==

*[[Authentication FAQ]]
*Multi authentication in [[Upgrading to Moodle 1.8]]
*Using Moodle [http://moodle.org/mod/forum/view.php?id=42 User authentication forum]
*Using Moodle [http://moodle.org/mod/forum/discuss.php?d=95559 Do users need e-mail addresses?] forum discussion
*Using Moodle [http://moodle.org/mod/forum/discuss.php?d=97938 Admin approving self registrations?] forum discussion

[[Category:Authentication]]

[[eu:Erabiltzaileen_autentifikazioa]]
[[fr:Authentification]]
[[de:Authentifizierung]]
[[ja:認証]]

Authentication

2012-02-14T15:11:50Z

Rcollman: /* Setting the authentication method */

Location: ''Administration > Users > Authentication > Manage authentication'' in 1.9

Authentication is the process which allows a user to login to a Moodle site. [[Site policies]] determines if users must login before reaching the [[Front Page]].

==Setting the authentication method==
[[Image:authentication plugins.png|thumb|Choosing an authentication plugin in Moodle 1.8 (only shows top of Authentication page)]]
To set the authentication method:

#Access ''Administration > Users > Authentication > Manage authentication'' in 1.9.
#On the Manage authentication page, click on the closed eye icon to enable your chosen [[Authentication|authentication plugin(s)]]. In Moodle 1.8 onwards, you can choose to use more than one authentication plugin (see Multi-authentication below). Use the up/down arrow icons to arrange the plugins in order, with the plugin handling the most logins at the top of the page.
#If you have chosen [[Email-based self-registration]] and wish potential users to be able to create their own accounts, select "Email-based self-registration" from the self registration drop-down menu in the common settings section. Potential users will then be presented with a "Create new account" button on the login page.
#If you have courses with guest access, set the Guest login button to show.
#Click the "Save changes" button.
#Click on Settings opposite the authentication plugin(s) you have chosen.
#Configure the required settings and click the "Save changes" button.

==Authentication methods==

Authentication methods (also known as authentication plugins) include:

*[[Manual accounts]] - accounts created manually by an administrator
*[[No login]] - suspend particular user account
*[[Email-based self-registration]] - for enabling users to create their own accounts
*[[CAS server (SSO)]] - account details are located on an external CAS server
*[[External database authentication|External database]] - account details are located on an external database
*[[FirstClass authentication|FirstClass server]] - account details are located on an external FirstClass server
*[[IMAP authentication|IMAP server]] - account details are located on an external IMAP server
*[[LDAP authentication|LDAP server]] - account details are located on an external LDAP server
*[[MNet|Moodle Network authentication]] - how different Moodle sites can connect and authenticate users
*[[NNTP authentication|NNTP server]] - account details are located on an external NNTP server
*[[No authentication]] - for testing purposes only
*[[PAM (Pluggable Authentication Modules)]] - account details come from the operating system Moodle is running on, via PAM (can only be used Linux/Unix).
*[[POP3 server]] - account details are located on an external POP3 server
*[[RADIUS authentication|RADIUS server]] - account details are located on an external RADIUS server
*[[Shibboleth]] - account details are located on an external Shibboleth server
*[[NTLM authentication|NTLM/Integrated Authentication]] (contributed plugin prior to Moodle 1.9; is part of the LDAP authentication plugin from 1.9 onwards).

==Authentication types==

===Internal authentication===
This type of authentication is used when Moodle stores users' passwords and other details in local Moodle database. Authentication plugins such as manual and email are indicate as internal authentication

===External authentication===
Other authentication plugins (such as: LDAP or POP3) are indicate as external authentication. With this type of authentication, user's details are not required to be stored in local Moodle database and user's password field will be labeld as 'not cached'.

==Multi-authentication==
From Moodle 1.8 onwards, multi-authentication is supported. Each authentication plugin may be used to find a username/password match. Once found, a user is logged in and alternative plugins are not used. Therefore the plugin which handles the most logins should be moved to the top of the page in order that less load is put on authentication servers.

==Common settings==

===Self registration===

If you wish users to be able to create their own user accounts, i.e. self-register, then select Email-based self-registration (or any other enabled plugin that can support self registration, like LDAP) from the drop-down menu. This will result in a "Is this your first time here?" instructions and a "Create new account" button being displayed on the login page.

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 (see below). 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 with that plugin. Selecting Email-based self-registration as the self registration method allows potential users to self register.

===Guest login button===

You can hide or show the guest login button on the login page. Hiding the guest login button disables [[Guest role|guest access]] to the Moodle site, however logged-in users can still enter any courses which allow guest access without being required to enrol.

===Alternate login URL===

This should be used with care, since a mistake in the URL or on the actual login page can lock you out of your site. If you do mess it up, you can remove the entry from your database (table mdl_config) using, e.g., phpmyadmin for mysql.

===Forgotten password URL===

{{Moodle 1.9}}In Moodle 1.9 onwards, if your lost password handling is performed entirely outside of Moodle (for example, only by a help desk), you can set the url of that service here. Anybody pressing a "lost password" link in Moodle will be redirected to this URL. Note that this will disable '''all''' of Moodle's lost password recovery options regardless of authentication method(s) in use.

===Allowed and denied email domains===

Authentication may be restricted to particular email domains when using [[Email-based self-registration]] so that, for example, only students with a university email can login.

(Note: Prior to Moodle 1.9, the allowed and denied email domains settings can be found in ''Administration > Server > [[Email settings|Email]]''.) ('It should be:- Administration > User > Manage Authentication')

===Restrict domains when changing email===

In Moodle 1.9.3 onwards, you can choose to enforce email domains only when users create an account using [[Email-based self-registration]] i.e. after creating an account, users may change their email to a different domain.

===ReCAPTCHA===

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

From Moodle 1.9.1 onwards, 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.

ReCAPTCHA keys can be obtained from http://www.google.com/recaptcha by [https://www.google.com/recaptcha/admin/create signing up for an account] (free) then entering a domain. The public and private keys provided can then be copied and pasted into the ''recaptchapublickey'' and ''recaptchaprivatekey'' fields in the manage authentication common settings, and the changes saved.

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

==Profile fields data mapping and locking==
Most (but not all) authentication plugins that use an external source for the user account details allow us to retrieve some user profile details (like first name, last name, email, etc.). By using the Data Mapping section on those authentication plugins configuration page we can configure what, when and how to manage all those user profile details.

[[Image:Authent-data-map-fname.jpg|Data Mapping Options]]

These fields are optional. You can choose to pre-fill some Moodle user fields with information from the external authentication source (if you are using one), from the fields that you specify here. If you leave these fields blank, then nothing will be transferred from the external authentication source and Moodle defaults will be used instead. In either case, the user will be able to edit all of these fields after they log in.

In addition to specifying how to fill this fields, we can set how to update them (in both directions, to Moodle or from Moodle), and whether we want to lock them (so the user cannot modify their value) or not:

*'''Update local''': When the user field will be updated from the external authentication source:
** '''On creation''': when the user account is created during the first login
** '''On every login''': every time the user logs in (or there is a user synchronization, for those authentication plugins that support it). Fields set to update locally should be locked.
*'''Update external''': When the external authentication source will be updated from the user field:
** '''Never''': never update the external authentication source from Moodle.
** '''On update''': the external authentication source will be updated when the user profile is updated. Fields should be unlocked to allow edits.
*'''Lock value''': To prevent users from altering some fields (e.g. students changing profile information to inappropriate or misleading information), the site administrator can lock profile fields. It's usually a good idea to lock profile fields if you are maintaining this data in the external authentication system.
** '''Unlocked''': The field is unlocked and can be edited by the user at any time.
** '''Unlocked if empty''': The field is unlocked if it is empty, but once the user fills in some information, it becomes locked and cannot be edited any more.
** '''Locked''': The field is locked and cannot be edited by the user.

If you are using a mixture of authentication types (such as IMAP and manual), then the fields you map and lock in the authentication options are specific to that particular authentication plugin. Each authentication plugin has its own set of mapped and locked fields.

Remember to test the field locking by logging in with the proper type of account! If you test with a manual account but have set the field locking to apply to IMAP accounts, you will not be able to tell if it worked!

==See also==

*[[Authentication FAQ]]
*Multi authentication in [[Upgrading to Moodle 1.8]]
*Using Moodle [http://moodle.org/mod/forum/view.php?id=42 User authentication forum]
*Using Moodle [http://moodle.org/mod/forum/discuss.php?d=95559 Do users need e-mail addresses?] forum discussion
*Using Moodle [http://moodle.org/mod/forum/discuss.php?d=97938 Admin approving self registrations?] forum discussion

[[Category:Authentication]]

[[eu:Erabiltzaileen_autentifikazioa]]
[[fr:Authentification]]
[[de:Authentifizierung]]
[[ja:認証]]

Authentication

2012-02-14T15:10:29Z

Rcollman:

Location: ''Administration > Users > Authentication > Manage authentication'' in 1.9

Authentication is the process which allows a user to login to a Moodle site. [[Site policies]] determines if users must login before reaching the [[Front Page]].

==Setting the authentication method==
[[Image:authentication plugins.png|thumb|Choosing an authentication plugin in Moodle 1.8 (only shows top of Authentication page)]]
To set the authentication method:

#Access ''Administration > Plugins > Authentication > Manage authentication'' in 2.0 onwards or ''Administration > Users > Authentication > Manage authentication'' in 1.9.
#On the Manage authentication page, click on the closed eye icon to enable your chosen [[Authentication|authentication plugin(s)]]. In Moodle 1.8 onwards, you can choose to use more than one authentication plugin (see Multi-authentication below). Use the up/down arrow icons to arrange the plugins in order, with the plugin handling the most logins at the top of the page.
#If you have chosen [[Email-based self-registration]] and wish potential users to be able to create their own accounts, select "Email-based self-registration" from the self registration drop-down menu in the common settings section. Potential users will then be presented with a "Create new account" button on the login page.
#If you have courses with guest access, set the Guest login button to show.
#Click the "Save changes" button.
#Click on Settings opposite the authentication plugin(s) you have chosen.
#Configure the required settings and click the "Save changes" button.

==Authentication methods==

Authentication methods (also known as authentication plugins) include:

*[[Manual accounts]] - accounts created manually by an administrator
*[[No login]] - suspend particular user account
*[[Email-based self-registration]] - for enabling users to create their own accounts
*[[CAS server (SSO)]] - account details are located on an external CAS server
*[[External database authentication|External database]] - account details are located on an external database
*[[FirstClass authentication|FirstClass server]] - account details are located on an external FirstClass server
*[[IMAP authentication|IMAP server]] - account details are located on an external IMAP server
*[[LDAP authentication|LDAP server]] - account details are located on an external LDAP server
*[[MNet|Moodle Network authentication]] - how different Moodle sites can connect and authenticate users
*[[NNTP authentication|NNTP server]] - account details are located on an external NNTP server
*[[No authentication]] - for testing purposes only
*[[PAM (Pluggable Authentication Modules)]] - account details come from the operating system Moodle is running on, via PAM (can only be used Linux/Unix).
*[[POP3 server]] - account details are located on an external POP3 server
*[[RADIUS authentication|RADIUS server]] - account details are located on an external RADIUS server
*[[Shibboleth]] - account details are located on an external Shibboleth server
*[[NTLM authentication|NTLM/Integrated Authentication]] (contributed plugin prior to Moodle 1.9; is part of the LDAP authentication plugin from 1.9 onwards).

==Authentication types==

===Internal authentication===
This type of authentication is used when Moodle stores users' passwords and other details in local Moodle database. Authentication plugins such as manual and email are indicate as internal authentication

===External authentication===
Other authentication plugins (such as: LDAP or POP3) are indicate as external authentication. With this type of authentication, user's details are not required to be stored in local Moodle database and user's password field will be labeld as 'not cached'.

==Multi-authentication==
From Moodle 1.8 onwards, multi-authentication is supported. Each authentication plugin may be used to find a username/password match. Once found, a user is logged in and alternative plugins are not used. Therefore the plugin which handles the most logins should be moved to the top of the page in order that less load is put on authentication servers.

==Common settings==

===Self registration===

If you wish users to be able to create their own user accounts, i.e. self-register, then select Email-based self-registration (or any other enabled plugin that can support self registration, like LDAP) from the drop-down menu. This will result in a "Is this your first time here?" instructions and a "Create new account" button being displayed on the login page.

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 (see below). 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 with that plugin. Selecting Email-based self-registration as the self registration method allows potential users to self register.

===Guest login button===

You can hide or show the guest login button on the login page. Hiding the guest login button disables [[Guest role|guest access]] to the Moodle site, however logged-in users can still enter any courses which allow guest access without being required to enrol.

===Alternate login URL===

This should be used with care, since a mistake in the URL or on the actual login page can lock you out of your site. If you do mess it up, you can remove the entry from your database (table mdl_config) using, e.g., phpmyadmin for mysql.

===Forgotten password URL===

{{Moodle 1.9}}In Moodle 1.9 onwards, if your lost password handling is performed entirely outside of Moodle (for example, only by a help desk), you can set the url of that service here. Anybody pressing a "lost password" link in Moodle will be redirected to this URL. Note that this will disable '''all''' of Moodle's lost password recovery options regardless of authentication method(s) in use.

===Allowed and denied email domains===

Authentication may be restricted to particular email domains when using [[Email-based self-registration]] so that, for example, only students with a university email can login.

(Note: Prior to Moodle 1.9, the allowed and denied email domains settings can be found in ''Administration > Server > [[Email settings|Email]]''.) ('It should be:- Administration > User > Manage Authentication')

===Restrict domains when changing email===

In Moodle 1.9.3 onwards, you can choose to enforce email domains only when users create an account using [[Email-based self-registration]] i.e. after creating an account, users may change their email to a different domain.

===ReCAPTCHA===

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

From Moodle 1.9.1 onwards, 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.

ReCAPTCHA keys can be obtained from http://www.google.com/recaptcha by [https://www.google.com/recaptcha/admin/create signing up for an account] (free) then entering a domain. The public and private keys provided can then be copied and pasted into the ''recaptchapublickey'' and ''recaptchaprivatekey'' fields in the manage authentication common settings, and the changes saved.

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

==Profile fields data mapping and locking==
Most (but not all) authentication plugins that use an external source for the user account details allow us to retrieve some user profile details (like first name, last name, email, etc.). By using the Data Mapping section on those authentication plugins configuration page we can configure what, when and how to manage all those user profile details.

[[Image:Authent-data-map-fname.jpg|Data Mapping Options]]

These fields are optional. You can choose to pre-fill some Moodle user fields with information from the external authentication source (if you are using one), from the fields that you specify here. If you leave these fields blank, then nothing will be transferred from the external authentication source and Moodle defaults will be used instead. In either case, the user will be able to edit all of these fields after they log in.

In addition to specifying how to fill this fields, we can set how to update them (in both directions, to Moodle or from Moodle), and whether we want to lock them (so the user cannot modify their value) or not:

*'''Update local''': When the user field will be updated from the external authentication source:
** '''On creation''': when the user account is created during the first login
** '''On every login''': every time the user logs in (or there is a user synchronization, for those authentication plugins that support it). Fields set to update locally should be locked.
*'''Update external''': When the external authentication source will be updated from the user field:
** '''Never''': never update the external authentication source from Moodle.
** '''On update''': the external authentication source will be updated when the user profile is updated. Fields should be unlocked to allow edits.
*'''Lock value''': To prevent users from altering some fields (e.g. students changing profile information to inappropriate or misleading information), the site administrator can lock profile fields. It's usually a good idea to lock profile fields if you are maintaining this data in the external authentication system.
** '''Unlocked''': The field is unlocked and can be edited by the user at any time.
** '''Unlocked if empty''': The field is unlocked if it is empty, but once the user fills in some information, it becomes locked and cannot be edited any more.
** '''Locked''': The field is locked and cannot be edited by the user.

If you are using a mixture of authentication types (such as IMAP and manual), then the fields you map and lock in the authentication options are specific to that particular authentication plugin. Each authentication plugin has its own set of mapped and locked fields.

Remember to test the field locking by logging in with the proper type of account! If you test with a manual account but have set the field locking to apply to IMAP accounts, you will not be able to tell if it worked!

==See also==

*[[Authentication FAQ]]
*Multi authentication in [[Upgrading to Moodle 1.8]]
*Using Moodle [http://moodle.org/mod/forum/view.php?id=42 User authentication forum]
*Using Moodle [http://moodle.org/mod/forum/discuss.php?d=95559 Do users need e-mail addresses?] forum discussion
*Using Moodle [http://moodle.org/mod/forum/discuss.php?d=97938 Admin approving self registrations?] forum discussion

[[Category:Authentication]]

[[eu:Erabiltzaileen_autentifikazioa]]
[[fr:Authentification]]
[[de:Authentifizierung]]
[[ja:認証]]

Features

2012-02-14T15:08:18Z

Rcollman:

{{About Moodle}}
Moodle is an active and evolving product. This page lists only some of Moodle's many features. We encourage you to click on links to learn more.

== Overall design ==
Moodle's overall design:
* Promotes a social constructionist pedagogy (collaboration, activities, critical reflection, etc)
* Suitable for 100% online classes as well as supplementing face-to-face learning
* Simple, lightweight, efficient, compatible, low-tech browser interface
* Easy to install on almost any platform that supports PHP. Requires only one database (and can share it).
* Full database abstraction supports all major brands of database (except for initial table definition)
* Course listing shows descriptions for every course on the server, including accessibility to guests.
* Courses can be categorised and searched - one Moodle site can support thousands of courses
* Emphasis on strong security throughout. Forms are all checked, data validated, cookies encrypted etc
* Most text entry areas (resources, forum postings etc) can be edited using an embedded WYSIWYG HTML editor

== Site management ==

*Site is managed by an [[Administrator|administrator]] user
*Site is defined during setup. Defaults can be edited during setup or globally accepted
*Site can be modified by a robust [[Site administration block]].
* Plug-in [[Themes|"themes"]] allow the administrator to customize the site colors, fonts, layout etc to suit local needs
* Plug-in [[:Category:Contributed code|activity modules]] can be added to existing Moodle installations
* Plug-in language packs allow full localization to any language. These can be [[Language editing|edited]] using a built-in web-based editor. Currently there are language packs for over [http://download.moodle.org/lang/ 70 languages].
* The code is clearly-written PHP under a GPL license - easy to modify to suit your needs

== User management ==
===Overview===
* Goals are to reduce admin involvement to a minimum, while retaining high security
* Supports a range of user [[Authentication|authentication]] mechanisms through plug-in authentication modules, allowing easy integration with existing systems.
** [[Email-based self-registration|Standard email method]]: students can create their own login accounts. Email addresses are verified by confirmation.
** [[LDAP authentication|LDAP]] method: account logins can be checked against an LDAP server. Admin can specify which fields to use.
** For example, [[IMAP authentication|IMAP]], [[POP3 server|POP3]], [[NNTP authentication|NNTP]]: account logins are checked against a mail or news server. SSL/TLS certificates are supported.
* Students are encouraged to build an online [[Edit profile]] including photos, description. Email addresses can be protected from display if required.
**Every user can specify their own timezone, and every date in Moodle is translated to that timezone (e.g. posting dates, assignment due dates etc)
** Every user can choose the language used for the Moodle interface (English, French, German, Spanish, Portuguese etc)

===Enrolment===
*After a user has been [[Authenticated user|authenticated]] by the site or allowed in as a guest, they can self [[Enrolment|enroll]] in courses.
*Courses can a limit enrollment in several ways. Student self enrollment can be turned off.
* An "[[enrolment_key|enrolment key]]" in a course, only allows certain students to enter. These keys can be give out face-to-face or via email and can be changed
* Teachers, with permissions, can manually [[Students#Manual_enrol|enrol students]] or [[Students#Manual_unenrol|unenrol students]] in their courses.
* [[Course completion]] is a course prerequsite feature of Moodle 2.0 that allows scaffolding of courses.
* Course and site settings have options for automatic removal of users
*There are many [[Enrolment_plugins]]
**Includes: LADP, IMS, Paypal, [[MNet|Moodle Network]] to name a few
**Any [[External_database|External database]] that has least two fields can be used as an external authentication source
**[[Flat file]] or [[CSV]] files can automatically authenticate and enroll students in specific courses
* Each person needs only one account for the Moodle site. Each account can have access to different courses, and the courses resources and activities.
* [[Metacourses|Meta courses]] get their enrollment information from 1 or more other courses.

===Roles ===
* [[Roles]] combine specific permissions for specific types of participants. A user can be [[Assign roles|assigned]] a different role for each [[Context|contexts]], such as a specific course.
* The [[Administrator|administrator (admin)]] user account controls the creation of courses and creates teachers by assigning users to courses and giving them a role in that context
* New roles can be [[Manage roles|created, copied from existing roles and edited]]. Some standard roles include:
** [[Course creator]] can create courses, teach in them, and assign others to teacher roles.
** [[Teachers]] are a role in a specific course.
** Non-editing teacher roles are available for adjuncts, and part-time tutors.
** [[Students]] can participate and view activities but not create them
** [[Guest]]s are view only users.

== Course management ==
===Overview===
* Typically, a teacher has full control over all [[Course settings|settings]] for a course.
**This can include assigning other teachers [[Roles|roles]] with less privileges
* Choice of [[Course formats]] settings such as by week, by topic or a discussion-focused social format
* An individual [[Course_settings#Force_theme|course theme]] and layout can be created for any course.
* Flexible array of course [[Activities|activities]] - Forums, Quizzes, Glossaries, Resources, Choices, Surveys, Assignments, Chats, Workshops
* [[Groups]] - teacher(s) and students can be placed in one or more groups
* Recent changes to the course since the last login can be displayed on the course home page - helps give sense of community
* Content areas (things seen by students) have an [[HTML editor]] tool bar with many standard editing fuctions, including an html code view.
* Mail integration - copies of forum posts, teacher feedback etc can be mailed in HTML or plain text. Users can set a preference for daily emails in their profile.
* Custom [[Scales|scales]] - teachers can define their own scales to be used for grading forums and assignments
* Courses can be packaged as a single zip file using the [[Backup]] function. These can be restored on any Moodle server.
* Specific course activities and resources can be [[Import course data|imported]] from another existing course
* [[Conditional activities]] in Moodle 2.0 allow the teacher to set [[Activity completion|completion standards]] and conditions for entry into any specific activity, based upon serveral criterion.

===Course reports===
* All [[Grades|grades]] for many kinds of activities can be viewed on [[Gradebook|one page]] (and downloaded in several formats).
* Graded activities can be futher calculated or manually entered in the Gradebook which is seperated from the initial activity caluclation. Additionally categories of graded activities and display functions allow for custom reports.
* Full user logging and tracking - [[Reports|activity reports]] for each student are available with graphs and details about each module (last access, number of times read) as well as a detailed "story" of each students involvement including postings etc on one page.

=== Assignment Module ===

* [[Assignment module|Assignments]] can be specified with a due date and a maximum grade.
* Students can upload their assignments (any file format) to the server - they are date-stamped.
* Late assignments are allowed, but the amount of lateness is shown clearly to the teacher
* For each particular assignment, the whole class can be assessed (grade and comment) on one page in one form.
* Teacher feedback is appended to the assignment page for each student, and notification is mailed out.
* The teacher can choose to allow resubmission of assignments after grading (for regrading)
* Allowing resubmissions can allow the teacher to progress monitor student projects/assignments as they evolve.
* Advanced assignments can allow multiple files to be uploaded. This could keep together preplanning maps, outlines, research papers and presentations. (Not for beginners)

=== Chat module ===

* The [[Chat module]] allows smooth, synchronous text interaction
**They can be limited to group members or roles, or be for anyone in the course
* Includes profile pictures in the chat window
* Supports URLs, smilies, embedded HTML, images etc
* All sessions are logged for later viewing, and these can also be made available to students

=== Choice module ===
* The [[Choice module]] is like a single question poll. Can either be used to vote on something, or to get feedback from every student
* Teacher sees intuitive table view of who chose what
* Students can optionally be allowed to see an up-to-date graph of results

=== Forum Module ===
* Different types of [[Forum module|forums]] are available, such as [[News forum|course news]], open-to-all, one-thread-per-user and question/answers types.
* [[Forum posting|Forum posts]] can be emailed in several ways, some controled by the student.
* Posts can have the authors photo attached.
* [[Viewing a discussion|Discussions can be viewed]] nested, flat or threaded, oldest or newest first.
* Robust [[Forum subscription|subscription]] methods for each forum
**Individual forums can be subscribed to by each person
**Teacher can force subscription for all members of the course, either initially or permanently.
* [[Groups]] features allow options for more entry and viewing limitations for students.
* The teacher can choose not to allow replies to their posts (announcements).
* Discussion threads can be moved between forums or split by the teacher.
* Attachments can be made to posts and shown as part of message.
* [[Forum ratings|Forum ratings]] can be used. These can be restricted to a range of dates and included as part of a student's grade.

===Glossary Module===
*The [[Glossary module]] is one of the modules that best illustrates the way that Moodle can fundamentally improve upon the experience of a traditional classroom
*When students contribute to a course in a public place like the glossary, their ideas are given weight and attention and often result in a greater pride or ownership of the assignment
*Allows participants to create and maintain a list of definitions, like a dictionary
*Student entries can be previewed by instructors before publishing
*Entries can be searched or browsed using alphabet, category, date, and author
*A glossary of terms can be easily referenced by students
*Almost any module of Moodle can be set to hyperlink - automatically - to any word or phrase that is stored in or added to the glossary
*Glossary items can be grouped in categories
*Participants can comment on glossary entries
*Entries can be rated using teacher-defined scales
*Glossaries can be easily exported and imported via xml
*Glossaries can be fully searched
*Glossaries can be viewed with different display formats

=== Lesson Module ===
*A [[Lesson module|lesson]] is a single activity where a series of pages are presented to the student, usually based upon a student's choice.
*Content seen by the student is created with Moodle's [[HTML editor]] tool.
*Students make choices by their answers to questions or by selecting a button with a description. Their choices are linked to other pages in the lesson.
**This allows for a simple slide show type of presentation, with content and questions.
**It allows for a branching, adaptive presentation based upon a student's specific choice.
**Navigation through the lesson can be straight forward or complex, logical or random.
*[[Jumps]] are associated with each choice that link to other lesson pages.
**Jumps can be to a specific page or to a random page or a page not seen by the student.
*Choices that are answers to questions and can be scored and given individual feed back.
**Question pages include Multiple choice, Multi-answer, T/F, numeric, short answer and essay.
*[[Adding/editing a lesson|Lesson settings]] offer the teacher many options such as:
**Different scoring and grading potentials
**Lessons can build upon each other through conditional dependencies upon one another
**Student attempts, time limits, minimum score and retakes can be set for each lesson
**Students may see progress bars, running score, and feedback on their answers.
**Password, start and end times, and other restrictions can be placed on students.
*Pages can be created one at a time or [[Import questions|imported]].

=== Quiz Module ===
* There are many types of standard questions formats that can be used in the [[Quiz module]]. Quiz offers many scoring methods and ways to present itself to students.
* Quizzes are automatically graded when a student finishes. An entire quiz or specific questions be regraded at any time, should the teacher change an answer's score.
* There are many [[Adding/editing a quiz|quiz settings options]], such as:
** Quizzes can have a limited time window outside of which they are not available
** At the teacher's option, quizzes can be attempted multiple times, and can show feedback and/or correct answers
** Quiz questions and quiz answers can each be shuffled (randomised) to reduce cheating
** Quizzes can be attempted multiple times, if desired
** Attempts can be cumulative, if desired, and finished over several sessions
* Questions are stored in [[Question categories|categories]] that are part of a robust [[Question bank|database] for easy access.
** Categories of questions can be arranged in the database so they can only be used in a specific quiz, or in a specific course or in any quiz on the site.
** Edited questions can replace the orignial or become new questions in the database
* Questions use HTML formatting, images and has a [[HTML editor|friendly tool bar]] in both the question and answer areas.
* Questions can be [[Import questions|imported]] or [[Export questions|exported]] in many file formats.
* There are more than 10 question types, each with different scoring methods, such as:
** [[Multiple Choice question type|Multiple-choice questions]] supporting single or multiple answers
** [[Short-Answer question type|Short Answer questions]] (words or phrases)
** [[True/False question type|True-False questions]]** Matching questions
** [[Random Short-Answer Matching question type|Random Short answer questions]]
** [[Numerical question type|Numerical questions]] (with allowable ranges)
** [[Embedded Answers (Cloze) question type|Embedded-answer questions (cloze style)]] with answers within passages of text
** [[Questions linking to files|Embedded descriptive text and graphics]] is possible in questions
* Quiz questions can come from specific question in a specific category or as a random questions drawn from a category. These can be mixed and matched to suit the teacher.

=== Resource Module ===
* [[Resources]] can display of many types of media content files by a single link on the course page, such as:
** Word, Powerpoint, Flash, Video formats, Audio formats
** [[Web page|Internal web pages]] (HTML formatted) can be created with [[HTML editor]] tool
** Internal [[Text page]]s (no formatting)
**Files can be stored locally or the link point to remote locations
* [[Files]] can be uploaded and managed (zipped, unzipped, renamed, moved) in the course
** Folders can be created and managed in the course and students given a [[Directory|link to the folder]] via a resource link.
**[[File handling 2.0|File handling in Moodle 2.0]] has a [[File picker]] that is associated with specific resources or activities, allowing uploads from server, private, recent or on the fly. Files have attributes for author and license/copyright.
* [[File or website link|content on the web]] can be linked to or seamlessly included within the course interface.
** External web applications can be linked to with data passed to them

=== Survey Module ===

* Built-in [[Survey module|surveys]] (COLLES, ATTLS) have been proven as instruments for analysing online classes
* Online survey reports always available, including many graphs. Data is downloadable as an Excel spreadsheet or CSV text file.
* Survey interface prevents partly-finished surveys.
* Feedback is provided to the student of their results compared to the class averages

=== Wiki Module===
*[[Wiki module]] is a series of web pages that anyone can add to or edit
*It enables document pages to be authored collectively
*Supports groups
*There are many [[Wiki administration|teacher based editing tools]].

=== Workshop Module ===
* [[Workshop module]] allows peer assessement of documents, and the teacher can manage and grade the assessment.
* Supports a wide range of possible grading scales
* Teacher can provide sample documents for students to practice grading
* Being redone for Moodle 2.0

==Support==
Moodle has better actual user support than most higher priced course management software programs. [http://moodle.org/support Support] comes in a variety of robust forms to meet the varied needs of a larger user base. Some examples:

*Moodle documentation. You are reading one of many pages
**Starting links for [[Teacher_documentation|Teachers]], [[Administrator documentation|Administrator]] and [[Development:Developer documentation|Developers]]
**[[Moodle Docs|Pages]] that can connect to your Moodle site for help
*Many active [http://moodle.org/course/ forums and courses] to provide help, tips and friendly encouragement
**Over 70 [http://moodle.org/course/view.php?id=5 user forums] in English
**Even more in other languages
**A [http://moodle.org/course/view.php?id=55 social forum] for not necessarily Moodle related threads
*Special user group Moodle courses, with forums, demonstrations and FAQs
*[[Tracker]] for bugs, issues and new features requests
*Demonstration courses - in many languages showing different looks and presentation methods with a standard Moodle.
*Books - we have our [[Using Moodle book|favorites]] and there are [[Moodle manuals|many books]] on and about Moodle
*[[Moodle Partners]] can also provide you with focused help for your site or project

[[es:Características]]
[[fr:Fonctionnalités]]
[[pt:Características do Moodle]]
[[de:Funktionalität]]
[[ru:Возможности]]

CSS

2011-11-29T15:31:08Z

Rcollman: /* See Also */

CSS or Cascading Style Sheets are used to control the way web pages look. By changing a CSS definition, the change is made on every Moodle webpage that uses that definition.

CSS files are located in the [[Theme|theme]] folder being used by Moodle. The normal Moodle practice is to have 3 main CSS files: [[CSS styles_ color.css|styles_color]], [[CSS styles_layout.css|styles_layout]], [[CSS styles_fonts.css|styles_fonts]]. When a CSS definition is not found in a theme CSS file, the CSS files located in the standard theme serves as the default.

There may also be CSS files for Internet Explorer, Mozilla or other internet browsers.

==Basic Moodle page parts==
A web page is broken up into pieces or elements. Not every page contains the same parts.

These parts or elements include: core, forms, header, footer,admin, blocks, blog, calendar, course, doc, grades, login, message, notes, mymoodle, question, tabs, tags, user and many of the modules.

==Basic CSS files==
*[[CSS styles_ layout.css]] contains the layout specifications for various page elements.

*[[CSS styles_color.css]] contains the colors used in the page elements.

*[[CSS styles_fonts.css]] defines the fonts used in the page elements.

== See Also ==
In other MoodleDoc versions, the CSS info has been moved to [https://docs.moodle.org/dev/CSS devDocs on CSS]

In this documentation you can find more information in the links below:

* [[CSS FAQ]]
* [[CSS styles moz.css]]
* [[Themes]]
* [http://en.wikipedia.org/wiki/Cascading_Style_Sheets Wikipedia Cascading Style Sheets]
* [http://www.w3schools.com/css/default.asp W3schools]

[[Category:Administrator]]
[[Category:Developer]]
[[Category:Themes]]

CSS

2011-11-29T15:30:51Z

Rcollman: /* See Also */ add dev link to CSS

CSS or Cascading Style Sheets are used to control the way web pages look. By changing a CSS definition, the change is made on every Moodle webpage that uses that definition.

CSS files are located in the [[Theme|theme]] folder being used by Moodle. The normal Moodle practice is to have 3 main CSS files: [[CSS styles_ color.css|styles_color]], [[CSS styles_layout.css|styles_layout]], [[CSS styles_fonts.css|styles_fonts]]. When a CSS definition is not found in a theme CSS file, the CSS files located in the standard theme serves as the default.

There may also be CSS files for Internet Explorer, Mozilla or other internet browsers.

==Basic Moodle page parts==
A web page is broken up into pieces or elements. Not every page contains the same parts.

These parts or elements include: core, forms, header, footer,admin, blocks, blog, calendar, course, doc, grades, login, message, notes, mymoodle, question, tabs, tags, user and many of the modules.

==Basic CSS files==
*[[CSS styles_ layout.css]] contains the layout specifications for various page elements.

*[[CSS styles_color.css]] contains the colors used in the page elements.

*[[CSS styles_fonts.css]] defines the fonts used in the page elements.

== See Also ==
In other MoodleDoc versions, the CSS info has been moved to [[https://docs.moodle.org/dev/CSS devDocs on CSS]

In this documentation you can find more information in the links below:

* [[CSS FAQ]]
* [[CSS styles moz.css]]
* [[Themes]]
* [http://en.wikipedia.org/wiki/Cascading_Style_Sheets Wikipedia Cascading Style Sheets]
* [http://www.w3schools.com/css/default.asp W3schools]

[[Category:Administrator]]
[[Category:Developer]]
[[Category:Themes]]

User talk:Chris collman

2011-11-12T14:54:13Z

Rcollman:

I will not be checking this on a regular basis. If you have a comment, please put new ones directly below this line.
[https://docs.moodle.org/21/en/User_talk:Chris_collman My MoodleDocs 2.1 page is here]. --[[User:chris collman|chris collman]] 22:54, 12 November 2011 (WST)

User talk:Chris collman

2011-11-12T14:52:56Z

Rcollman: Created page with "I will not be checking this on a regular basis. If you have a comment, please put new ones directly below this line. --~~~~"

I will not be checking this on a regular basis. If you have a comment, please put new ones directly below this line. --[[User:chris collman|chris collman]] 22:52, 12 November 2011 (WST)

User:Chris collman

2011-11-12T14:51:55Z

Rcollman:

I have contributed to MoodleDocs since 2006.

*In 2010 I migrated a 1.5.3 production server to 1.9.x. We are scheduled to migrate that to 2.x in the summer of 2012. Most of my time is spent working with 3 small production servers running 2.1.x on an internal wan. I work in a training environmeent as assist trainers with blended learning technologies.
*I moderate the Lesson and Certificate forums.
*I am a sysop on all MoodleDoc versions, except the Dev namespaces.
*While not a php or Moodle code developer, I have some knowledge of custom themes, certificates and have a few tricks I use to import a batch of images into a Lesson.
*In 1.5- 1.9, I had knowledge of installing and troubleshooting Activity Locking (Conditional Activities). This is now part of a standard Moodle code (see advanced settings).

[https://docs.moodle.org/21/en/User_talk:Chris_collman My MoodleDocs 2.1 page is here].

User:Chris collman

2011-07-15T23:54:46Z

Rcollman: Created page with "test"

test

Streaming Media

2011-05-05T20:28:16Z

Rcollman: /* Other Resources */ delete dead link

== Types of Streaming Media ==

* [http://en.wikipedia.org/wiki/Adobe_Flash Flash]
* [http://en.wikipedia.org/wiki/MPEG-4 MPEG-4]
* [http://en.wikipedia.org/wiki/Quicktime Quicktime]
* [http://en.wikipedia.org/wiki/RealVideo RealVideo]
* [http://en.wikipedia.org/wiki/Windows_Media_Video Windows Media Video]

== Sources of Streaming Servers ==

'''Commercial'''
* Adobe - [http://www.adobe.com/products/flashmediaserver/ Flash Media Server 2] (Flash)
* Apple - [http://www.apple.com/quicktime/streamingserver/ Quicktime Streaming Server] (Quicktime, MP3, and MPEG4)
* Real Networks - [http://www.realnetworks.com/products/media_delivery.html Helix Server] (All formats)
* Microsoft - [http://www.microsoft.com/windows/windowsmedia/forpros/serve/prodinfo.aspx Windows 2003 Media Services] (WMV)

'''Free (Open Source)'''
* Apple - [http://developer.apple.com/opensource/server/streaming/index.html Darwin Streaming Server] (Quicktime, MP3, and MPEG4)
* Real Networks - [http://helix-server.helixcommunity.org/ Helix DNA server] (Real Media and MP3)
* OSFlash - [http://osflash.org/red5 Red5 Open Source Flash Server] (Flash and MP3)

== Lecture Delivery Systems ==

* Accordnet (commercial) - [http://accordent.com/products/med_mngm_prod/med_mngm_sys/med_mngm_sys.html Media Management System] (Sits on top of Helix server) [http://accordent.com/democase/prod_demos/edu_demo.html Demos]
* FlashVideo activity module (Sits on top of Open Source Products) [http://moodle.org/mod/data/view.php?d=13&rid=931 More Info]
* WebClass activity module (Sits on top of Open Source Products) [http://moodle.org/mod/data/view.php?d=13&rid=965 More Info]

== Other Resources ==

* [http://streaming411.com/wiki/Darwin_Streaming_Server Darwin Installation]

* [http://www.youtube.com/view_play_list?p=15DCA58C6829BAFF Demo on Installing Red5 with WebClass and FlashVideo]

Talk:Teacher documentation

2011-03-15T11:49:21Z

Rcollman: Moodle Principles section - uh not enlightening, needs links

==Page graphics==
I added some graphics and learned how to float then to the left. It does not add a great deal of length to the article. They come from 1.6.1 . It occured to me that the drop downs provide the list, and the text the links. Notice the text needs to be adjusted to the reality of what is actually there :) I like some visuals to provide context and I think this makes this opening page from the teacher link on the left of just about every MoodleDoc page, more friendly. What do you think Helen and others? --[[User:chris collman|chris collman]] 19:44, 11 August 2006 (WST)

:Hi Chris, please let's not make this page any longer! How about making it into the "jump station" we agreed upon previously? --[[User:Helen Foster|Helen Foster]] 08:39, 4 September 2006 (CDT)

==What's the point???==

I have been doing some work on this page based upon a suggestion I made (and helen agreed) in the docs forum which changes the lists to paragraphs. I feel this has made things better but the page obviously now needs a lot of work. I was wondering what the point / outcome of this page is? What does it hope to achieve? That may sound pretty obvious but it still isn't clear to me. Sure it introduces moodle features to teachers but there are so many ways to do that. Is it just an explanation of the features? Is it a human, friendly explanation of the features? Should it cover application in real life? Should there be a tutorial element to it? All of the above?

Also I was thinking that it is still a long page and will only increase in length. How about splitting it up further into smaller pages so you can navigate like a book. A bit like [http://computer.howstuffworks.com/wiki.htm this site] with a TOC for the pages and next links but only clearer and nicer of course :-). Darren Smith 19th March 2006

:I think we need different pages for the different purposes you mention. Yes, there should be a tutorial. Yes, there should be a comprehensive explanation of all the features. And yes, there should be a human-friendly explanation of the essentials. This last page is the one that Helen was asking for to replace the current teacher help file in Moodle. It should be distributed with Moodle. It should be a single page, not much longer than the current teacher help file but more up-to-date. --[[User:Gustav Delius|Gustav Delius]] 16:12, 20 March 2006 (WST)

::Darren, a big THANK YOU for your work on the [[Teacher documentation]] page - it's looking so much better now. :-)
::Gustav, I agree with all your points apart from the human-friendly explanation of the essentials being distributed with Moodle - it should be the [[Teacher documentation]] page (see [http://moodle.org/bugs/bug.php?op=show&bugid=4803 Bug 4803 - Redirect help link in course administration block to Teacher documentation]). --[[User:Helen Foster|Helen Foster]] 16:54, 23 March 2006 (WST)
:::Thanks Helen. A big thank you to you for this docs project! I am feeling better about the page now I finally removed the upload section. A lot of this stuff exists elsewhere so I am using the intro page as a jump station - seem fair enough? Also, is it possible to tell a page not to display a TOC as I think it would be more friendly if visiting teachers were presented with the introduction rather then a hyperlink list. --[[User:Darren Smith|Darren Smith]] 04:57, 24 March 2006 (WST) (Is it possible to change the time in the sig?

::::Hi Darren, please note that typing <code><nowiki>__NOTOC__</nowiki></code> removes the TOC. Your "jump station" plan sounds good to me :-) The signature time seems to be a bug. At least it's consistently wrong ;-) --[[User:Helen Foster|Helen Foster]] 16:57, 24 March 2006 (WST)

::::: Hey Darren, ditto wonderful work here. I have not looked at this section in a couple of months. While I would like to assume that anyone looking at Moodle undertands links, I would still point out the obvious to teachers that there are links that lead to other pages with more details, right at the top. Just a clue will do.

Gets me thinking about cross linking the Demo Moodle to the appropriate MoodleDoc page(s). For example, if I look at the lesson topic, there is not only the lesson example but also lesson references in the topic that could serve as the overview, which contain links to MoodleDoc pages. That would assist potential new moodlers as well as serving as an example of walking the Moodle walk. Again - thanks for your effort.--[[User:chris collman|chris collman]] 21:08, 25 April 2006 (WST)

==Changed intro==
I moved the instructions about logging in and troubleshooting logging in to their own pages so a) they can be expanded and b) it keeps the intro section concise. I have also restored the instructions stating that you need a teaching editing account or admin account as I feel that is an essential starting point. I have tweaked the new introduction but was tempted to remove it. Do we need to explain what moodle is here as it is covered elsewhere in the wiki? --[[User:Darren Smith|Darren Smith]] 04:52, 5 April 2006 (WST)

:You're doing a great job Darren! Please feel free to remove the Moodle explanation. --[[User:Helen Foster|Helen Foster]] 18:16, 10 April 2006 (WST)

:As a newbie to this wiki I though it prudent to put a link to the full teacher category at the top of the page, a way of going directly to an article that you may be interested in. --[[User:Lindsay Magnus|Lindsay Magnus]] 18:50, 17 July 2006 (WST)

:Lindsay thanks for comment, and change. I tweaked it to be even more obvious. I think new users should jump to the page Teacher. From the page teacher, there should be a See Also short list of links, such as the catagory index for teacher, perhaps to this page and links for a new administrator.

Consider that a new teacher might logically from Moodle.org click on "Free documentation", then "Welcome! Are you new, confused Start Here" then "Moodle Documentation" and then "Teacher Documentation". 4 logical clicks for the brand new user and this is where they end up. New users are not dumb and quickly notice this page is about the mechanics of ''course'', not about a ''teacher'' or a teacher's approach to Moodle. Yeah my usual new user soapbox which has to be balanced by the user who wants to know the basics of a course from a teacher's perspective.

There have been a lot of excellent changes to this page that really help our community get what they need faster. Best to all --[[User:chris collman|chris collman]] 23:23, 30 July 2006 (WST)

==New Intro and next wave of pages==
Added a link at the top of the page to [http://http://moodle.org/course/view.php?id=17223 Teaching and Learning with Moodle course at Moodle.org] The intent of the course is not to duplicate (there is some duplication and several references to Moodle Docs in here) but to have perhaps little more coherent entry point to Moodle from teaching rather than technical side of things. The course is in its initial stages and will serve as a focal point for many activities we intend to run from HQ in terms of pedagogical/andragogical use (see Moodle Recipes for Educators - first such project, more flagged in the Welcome message at the top of the course). Cheers --[[User:Tomaz Lasic|Tomaz Lasic]] 07:37, 23 March 2010 (UTC)
::Thanks for the link. It was broken and I fixed it. Guess it comes down to the question if the chicken or the egg comes first. The egg is the how to, the chicken is the example. :). This is the start of the next wave of pages, examples of how things can work. Whoopee! --[[User:chris collman|chris collman]] 12:59, 23 March 2010 (UTC)

==Major changes?==

Does [[Teacher documentation]] require major changes? The last major change, made by Darren mostly, was to move away from a page simply listing links https://docs.moodle.org/en/index.php?title=Teacher_documentation&oldid=6986 Do we really want to return to this? --[[User:Helen Foster|Helen Foster]] 04:51, 5 September 2006 (CDT)

Sigh. Thought we wanted a format like developer documentation and administrator documentation (lists organized by tasks), which I took to be jumping off places (blush). WIP notices not good even if for a day on the major Teacher link (double blush). In the cold light of the morning, my self assessment is that I am clearly confused about this page.

I myself like this page better than the other two. I do favor the format of text with embedded links to pages and some pictures. I have to stay with that thesis on this page, keep verbal and visually interesting and moving right along (letting links do the talking). Thanks for correction, hope I did not create a spike in blood pressure on that one. --[[User:chris collman|chris collman]] 06:52, 5 September 2006 (CDT)

==Adminstration block changes ==
'''Note, the MoodleDoc page [[Course administration block]] has most of this material built into with links as was suggested in this section of page comments.''' Thanks for assistance. --[[User:chris collman|chris collman]] 09:12, 26 May 2007 (CDT)

Below is for example. I would delete Administration block sub heading and make the course teacher tools the same as Block et al. Will work on words below and weave more links into discussion.
=== Course teacher tools===
Maybe we don't need this heading, just jump to the below.
====Teacher's people tools====
Features in the administration block allow teachers to manage [[Students | student]] and [[Teachers | teacher]] enrollments and their [[Groups | groups/cohorts]] and access the private Teacher forum.

====Grades====
Teachers can view the course [[Grades | gradebook]], create custom [[Scales | grading scales]] by the administration block links.

====Presentation settings====
You can change the way students (and other teachers) access and view your course by exploring the [[Settings]] option in the [[Administration | administration block]]. This page has over 30 different parameters to select. It is a place to select the section format, when the course is visible, more....

====Virtual handouts & resources====
Another much used feature of the administration block is the [[Files]] link. From here you can upload any digital content for inclusion in an activity, resource, course section or for a direct download. These files can be moved, renamed, edited directly on the server (if they are HTML or text) or deleted. You can also create a directory and display the whole contents of that directory to course students using the add resource drop down in any course section.
Of course if your content resides out on the web then you don't need to upload the files at all - you can link directly to them from inside the course using the link to file or website option.

====Student tools====
All of the links in the administration block are only available to teachers of the course. Students will receive their own version of the block which will display a link to their own gradebook and, if enabled, their own course logs. Need links for teachers about student's in Moodle.

== Where to mention Blogs? ==

There was no mention of Blogs in Moodle on the article page. The Blogs page belongs to Teacher category. I added a link to it to the See also section, but it might deserve a more prominent link somewhere? It's not a resource or module... maybe something mentioning "other" pedagogical tools in Moodle than the activity modules? --[[User:Samuli Karevaara|Samuli Karevaara]] 02:40, 30 October 2006 (CST)
::Good points. Blogs are part of blocks. Having been gently reminded :) to not add to the length of this page, I thought a picture of the block menu was worth 1,000 words. What I just did was use your link [[Blogs]](Thank you), and updated [[Blocks_%28teacher%29|Block (teacher)]] which was also Blog link-less. I also added more links to the Block section on the teacher documentation page so the reader might get the idea that there was more to learn about blocks.

::[[Blocks_%28teacher%29#Block_types|The block type section]] has a pretty impressive list and actually none are "more important" than another. I guess we could string every block feature in a sentence under Blocks on this page and put links there as well. Subject to the ultimate approval of those who watch over page lengths. However, these are just my thoughts and this is a collaborative effort. Thanks for the comment and putting in the Blog link --[[User:chris collman|chris collman]] 12:22, 31 October 2006 (CST)

==How about this template for just Teacher documentation page==

Rather than make the experienced teacher dig in the text, why not have this template. I would only put it on the teacher documentation page, because once they pick an activity, that will have it's own template of sub catagories. I have not looked at this template in a couple of months and it may need some corrections/additions. --[[User:chris collman|chris collman]] 07:36, 23 June 2007 (CDT)

{{Teacher documentation}}

:Hi Chris, thanks for your suggestion. I guess what you're wanting to do is to provide an easy way of navigating to other pages of interest for teachers. If you've not done so already, you may be interested in browsing the long history of the Teacher documentation page and seeing how it changed from being a list of links (similar to your Teacher doc template) to being paragraphs of text. --[[User:Helen Foster|Helen Foster]] 06:22, 25 June 2007 (CDT)

:I strongly support Chris' suggestion. His list was the information I was looking for when I landed on this page -- an index of documentation for Teachers. I suggest the "Getting Started" material should be moved to a separate page and added as an entry (at the top, if you wish). [[User:Donna Hrynkiw|Donna Hrynkiw]] 12:25, 21 May 2008 (CDT)
::Thanks Donna. I put up the template and changed it so instead of linking to other templates, It jumps to the main over view page. I think that will work better for people. --[[User:chris collman|chris collman]] 08:02, 22 June 2008 (CDT)

==Links to more student help/handouts?==
I am new to Moodle. I am a graduate student in technical communication. As part of a group project for a knowledge management class, I and two other students would like to contribute to Moodle's documentation and/or other types of help. We noticed that teachers cannot easily come to MoodleDocs and find information to give students who have questions about Moodle. For example, the [[Student_FAQ|Student FAQ]] is short and related to only technical issues. Also, both [[Student_tutorials|the Student tutorials page]] and the idea of creating more [https://docs.moodle.org/en/Category:Student student documentation pages] seem to have been abandoned. From my investigations, it seems like most student help is created by individual teachers and universities. If my assumption is true, '''would teachers like a page that links to different handouts and tutorials that others have created for students?''' Then teachers could easily find existing documentation to modify instead of starting from scratch when they need helpful resources for their students.--[[User:Apryl Jackson|Apryl Jackson]] 15:35, 21 February 2008 (CST)
:Hi, Please put in those links! Good point, why completely reinvent the wheel. (Humor here: My research data indicates that students are the most numerous users of Moodle.) On a more serious note, having examples of documentation could be a great help and who knows what it might inspire in MoodleDocs? Did you see the Moodle Documentation forum [http://moodle.org/mod/forum/discuss.php?d=42148 thread] ? --[[User:chris collman|chris collman]] 07:32, 22 February 2008 (CST)
::Thanks, Chris, for the encouragement. My classmates and I searched the documentation forums and the internet to come up with a list of example student documentation. I just posted our results to a page called [[Student documentation examples]]. I put links to it in the See Also section of this Teacher documentation page, some of the student pages, and the [http://moodle.org/mod/forum/discuss.php?d=91344 discussion that one of my classmates started] in the Moodle documentation forum. Of course, the page that we created, like all of Moodle Docs, is a work in progress, and we look forward to feedback.--[[User:Apryl Jackson|Apryl Jackson]] 13:49, 13 March 2008 (CDT)

==Moved Getting Started Content==
I moved the Getting Started material to [[Getting started|its own page]] because I felt that Teacher Documentation home page should be an overview of ''all'' teacher documentation; returning teachers shouldn't have to scroll past beginner material to get to the index of resources.

I think a little more categorization wouldn't hurt, but don't have time right now to visit all the links to find out more about them.

--[[User:Donna Hrynkiw|Donna Hrynkiw]] 11:49, 13 June 2008 (CDT)

:I generally agree with you. I made a suggestion along those line when I had more hair and was politely told no. At the time, I thought all three Documentation "Teacher" "Administrator" "Developer" links should go to pages that looked the same. On the other hand(s), note that MoodleDocs is not just for the experienced and indexes are efficient but cold and unfriendly. Why not a link off the other page with a nice orange (Expert Index box) to this one. Just look at how the administration index page has grown, I had to add links to get back to the top of the page to cut down on wear and tear on my mouse wheel :)

::And for the experts, what are all those category things supposed to be used for anyway if not as an index? Not trying to be negative, just talking about many concerns.

:I was also thinking that a master teacher documentation template sidebox, would accomplish what this index lays out. I wanted to put a Teacher master sidebox for those experienced users on what is/was called Getting Started. See it at the top of this page. When someone clicked on say Lesson, they would jump to the Lesson module page, which in turn has its own template sidebox with the major parts of Lesson broken out. This kept within the style of the rest of the teacher pages yet some quick drilldowns for those who knew where they were going but forgot the page name. Quicking than scrolling down a page or trying to get past a huge TOC.

:This page has received over 600,000 views, so while I can accept your changes and work on this page to make it more user friendly to new users, I was a little surprised. But this is a good thing because we need to keep up the discussion about improvements to MoodleDocs. Best to all--[[User:chris collman|chris collman]] 13:01, 17 June 2008 (CDT)

==Video links==
I am wondering if we have or need to have a page for video links for how to Moodle for Teachers? I know there is a ton out there, many of these links show up in the "see also" of specific pages. The trend is to put up more, so at some point I wonder if this page which we wanted to be short, is going to grow. I do appreciate the links! --[[User:chris collman|chris collman]] 12:47, 5 February 2010 (UTC)

==Major rewrite Oct 2010==

The page needed a bit of TLC, as suggested by Helen, Martin and my own steam. Last previous edit was many months ago.

I've removed a few links, changed the structure to something a bit more coherent, up-to-date and a touch more 'Wikipedia-ish'. Will work on the (new) pages some more, extend my explanation.

I'll be giving a priority to Teacher FAQ page (there are so many, it would be great if we could have literally a whole bank in one spot), will add and organise that page from different sources and add many more Q

High on the list of priorities are also primary, secondary, tertiary, adult ed/training pages. I started them, hoping to develop folks ;-)

Will need a 2.0 'getting started' page as well to reflect changes as 2.0 goes stable.

Shall we keep the Teacher Docs menu to different activities?

Feedback welcome. Thanks. Tomaz Lasic

:Thanks Tomaz for your edits. (Do not forget to sign your comments :) I like to see simple, focused English in Moodle Docs because it gets read by people that are not native speakers of English. I liked your changes and it inspired me to pick up my keyboard again. --[[User:chris collman|chris collman]] 22:07, 25 October 2010 (UTC)

==Moodle principles==
My spellchecker does not recognize andragogical nor it's alternative spelling androgogical. I can only wonder how this section translates in other languages.

It seems to me that pedagogy refers to teacher driven ("traditional") and andragogical to student driven ("adult learning"), while social constructionist theory offers a different context for these roles. Alternative #1:

:The design and development of Moodle is guided by a theory of teaching and learning called [[Philosophy|social constructionist]]. Moodle can be and is used to support other educational approaches involving [http://en.wikipedia.org/wiki/Pedagogical pedagogical] (teacher driven) to [http://en.wikipedia.org/wiki/Andragogy andragogical] (student driven) theories. However, the core Moodle package will continue to be built with a [[five key principles|particular view]] of the [[Pedagogy|teacher's role]].

Alternative #2 is shorter and follows the current version's form.

:The design and development of Moodle has been guided by a [[Philosophy|social constructionist]] theory and practice of teaching and learning. Moodle can be and is used to support a range of other [http://en.wikipedia.org/wiki/Pedagogical pedagogical] to [http://en.wikipedia.org/wiki/Andragogy andragogical] approaches. However, the core Moodle package will continue to be built with a particular view of the [[Pedagogy|teacher's role]] and is guided by [[five key principles]].

I know this is dear to the hearts of many so I will not make the change without receiving some comments from others. --[[User:chris collman|chris collman]] 11:49, 15 March 2011 (UTC)

Development:lib/moodlelib.php

2011-01-08T14:57:37Z

Rcollman: fomat

moodlelib.php is the main library file of miscellaneous general purpose Moodle functions.

Other main libraries:
* weblib.php - functions that produce web output
* datalib.php - functions that access the database

Development:lib/moodlelib.php

2011-01-08T14:56:37Z

Rcollman: no page link from Dev home page copied from heading

moodlelib.php is the main library file of miscellaneous general-purpose Moodle functions.

Other main libraries:
* - weblib.php - functions that produce web output
* - datalib.php - functions that access the database

Development:Finding your way into the Moodle code

2011-01-08T14:44:38Z

Rcollman: /* See also */ put intro to moodle programming at top

This article is aimed at people totally new to Moodle development and have some PHP experience, if you don't have that experience please visit [[Development:PHP for novices|PHP for novices]]. It is a few tips to help you get started with the mass of Moodle code.

Please feel free to add more tips here, but I think it is also good if we can keep this article quite short.

==Developer documentation==

If you have not already found it, the main source of developer documentation is [[Development:Developer_documentation]].

==Finding a way in==

For finding where to start, you need to know that when you are looking at, for example, http://moodle.org/mod/forum/discuss.php?d=82799, then the code for that is in /mod/forum/discuss.php, and you just need to follow through what it does.

It calls functions in the main Moodle libraries, and the three most important are:

*lib/moodlelib.php - general stuff.
*lib/weblib.php - things to do with output of HTML
*lib/dmllib.php - things to do with getting data in and out of the database.

==Understanding what you find==

As you look at the code, it is often a good idea, to insert statements like
debugging('In function require_login');
which will print the message above if it gets far enough so you know the code has not stalled before there, or
print_object($course);
which will print out a variable, showing you what it contains.

Variable like $course are often objects with lots of fields. Seeing what they contain will help you understand what is going on. The first of these prints out whatever text you give it, and information about the sequence of function calls that the code took to get there. (It only works if you go to ''Administration > Server > [[Debugging]]'', and turn the debug level to ALL or DEVELOPER.)

==Tools that can help==

*'''Eclipse''', for instance helps finding function definitions. You can hold down CTRL and click on the name of a function, it immediately jumps you to where that function is defined. ([[Development:Setting_up_Eclipse]])
*'''Emacs'''
*'''Vim'''
*'''TextMate'''

See also [[Development:Developer documentation#Tools]] and [[:Category:Developer tools]].

==See also==
* [http://dev.moodle.org/course/view.php?id=2 Introduction to Moodle Programming] a course at dev.moodle.org
* First posted at http://moodle.org/mod/forum/discuss.php?d=82799#p366264
* [[Development:Developer_documentation]]
* [[Development:Overview]]
* [[Development:ctags]]
* [http://blog.danpoltawski.co.uk/archives/2009-05-Secrets-of-Learning-Moodle-Development!.html "Secrets of Learning Moodle Development!"] by Moodle core developer [[User:Dan Poltawski| Dan Poltawski]]
* http://www.slideshare.net/tjh1000/a-basic-introduciton-to-the-moodle-architecture-5442122

[[Category:Developer]]

Development:PHP for novices

2011-01-08T14:41:11Z

Rcollman: add Intro to Moodle Programming

This page is written for this who need an introduction into the PHP language. For more documentation please also visit [http://www.php.net/manual PHP.net].

==PHP for complete novices==

Moodle is written in [http://www.php.net PHP] - a relatively easy language to learn.

===How it works===
When your browser requests a webpage, you are asking for a file. The computer (server) you connect to at the other end of the internet normally sends back a file of [http://en.wikipedia.org/wiki/Html HTML] (which you need to get familiar with if you are not already) that your browser then converts into a webpage. HTML documents are static, meaning that they exist on the server in the same form as they are sent to you. PHP on the other hand is dynamic - the form it exists in on the server is different from what is ultimately sent to you, which may be different for different people. When a PHP file is requested, the server runs the instructions it contains and sends the output (HTML) to you in the normal way. PHP code can either be inserted into part of an HTML document, or can exist in files with nothing but PHP. You can recognise it by its start (<?php) and end (?>) tags

PHP almost always uses a database to store information. That way, the PHP forms a template, that gets filled with whatever information is appropriate to the user e.g. there is a space at the top right of this page for a username, but it is different for everyone.

In the following examples, the numbered line indicates what the intention of the developer is and the text in the box with the blue dashed outline is the code that would actually be written in the php file. Notice that the php lines always end with a ; symbol to indicate the end of a command.

The PHP code for the username box will say some thing like:

1. start a box by printing <div>
echo "<div>";
2. set the font colour to blue by printing <font color="#002bb8">
echo "<font color="#002bb8">";
3. get the username for user number x from the database
$username=fullname(123);
4. print that username
echo $username;
5. end font colour by printing </font>
echo "</font>";
6. end div by printing </div>
echo </div>

End result (HTML that will be sent to your browser):
<div>
<font color="#002bb8">
Joe Bloggs
</font>
</div>

===Variables===

In the above example, $username is a variable. It is effectively algebra, where a word of some sort (starting with a dollar sign) represents a piece of data, in this case the username returned by the database.

===Functions===

In the above example, fullname() is a function. This means a collection of commands (which in this case accesses the user table of the database and returns the name) that have been defined elsewhere, which can be run using a shorthand reference. This saves writing them out hundreds of times in different places. Functions are often written down in large library files, so that they can be used whenever they are needed.

===Including other files===

Moodle is a very complex program. Instead of just one page with a list of commands, it uses a great many files linked together using the [http://uk.php.net/include/ include] or [http://uk.php.net/manual/en/function.require-once.php require_once] commands. This means that when you request e.g. the front page, there will be commands such as the following:

<code php>
require_once('config.php');
</code>

which means 'if its not been done already for this page request, go and get config.php and run all of its instructions before continuing'. In this way, a single Moodle webpage can sometimes include as many as 150 separate files on the server. This is how the library files are made available - you include the library and can then use any of the functions that the library contains e.g. fullname().

===Libraries and functions===

To make the username commands above into a function, we would write them like this:

<code php>
function print_username_box($useridnumber) {
echo "<div>";
echo "<font color="#002bb8">";
$username=fullname($useridnumber);
echo $username;
echo "</font>";
echo </div>
}
</code>

Now, whenever the commands are needed, the developer simply writes
<code php>
print_username_box(123);
</code>

==See also==
[http://dev.moodle.org/course/view.php?id=2 Introduction to Moodle Programming] a course at dev.moodle.org.

{{CategoryDeveloper}}

Grade item settings

2011-01-02T21:08:38Z

Rcollman: /* Old Version for advanced grade item options */

{{Grades}}Location: ''Administration > Grades > Grade item settings''
[[Image:Grade item settings.png|thumb|Grade item settings screen]]

Grade item settings are the various settings that the administrator is able to edit for all [[Gradebook|gradebooks]] used by teachers. These settings will change what items are displayed for each grade. As administrator, you would turn on or off various settings and the teacher would input the actual data.

==Grade display type==

This is the type of grade that is to be shown for each individual grade. Different school districts use different grading systems so this can be changed to suit your district.

* Real - Grade from minimum to maximum range indicating total points received. Default from 0-100 but may be arbitrary.
* Percentage - Grade from 0 - 100% indicating the total points received divided by maximum possible amount times 100.
* [[Grade letters|Letter]]- Grade in the form of a letter representing a range of percentages.

==Overall decimal points==

This setting is for display purposes only. Grade calculations are made with an accuracy of 5 decimal places and grade letters, if used, are assigned accordingly.

If rounding of grades in [[Grade calculations|grade calculations]] is required, the round(number, count) function may be used.

==Advance grade item options==
In Moodle 2.0 Course administration>Grades>Category & Items>Add grade item, or Simple view>edit item brings up the Grade item page with the "Show advanced" button.

These features can be set or viewed:

{| style="width:75%" border="0"
|
* Item info
* ID Number
* Grade Type
* Scale
* Minimum Grade
* Maximum Grade
||
* Grade to pass
* Offset
* Multiplicator
* Grade display type
* Overall decimal places
||
* Hidden
* Hidden until
* Locked
* Locked after
|-
|}

Both Full and Simple views have "Add category" and "Add grade item" buttons at the bottom of the page.

===Old Version for advanced grade item options===
Older versions of Moodle contained a list of various fields that can be toggled on or off to appear on the default grade item screen or hidden. By selecting a field, it is put into the "Advanced" items menu and a field that is not selected will appear on the main grade item menu by default. Note that all of these options will always be available to teachers with a click of the button "Show Advanced". {

To highlight more than one field, use ctrl+click and both will be highlighted. To highlight from one field to another, use shift+click the range between two will be highlighted. Shift+ctrl+right click will combine a range of selections to those already highlighted. To de-highlight a field just do the same steps but click on already highlighted fields.

==See also==
*[[Grade items]] - for teachers
*[http://www.moodletutorials.org/view_video.php?viewkey=d7fbdea1afc51c7c6ad2 Video tutorial on Grade Item Setting and Grade Letters]

[[de:Einstellungen_für_Bewertungsaspekte]]
[[fr:Réglages des éléments d'évaluation]]
[[ja:評定項目設定]]

Talk:Grade item settings

2011-01-02T19:44:32Z

Rcollman: I did ! the url does not count!

==Advanced settings==
I do not understand where these are in 1.9.9 or Moodle 2.0. Will flag it as needs work. I suspect that the UI was changed in 1.9.5. As admin looked in site and course menus. --[[User:chris collman|chris collman]] 12:52, 2 January 2011 (UTC)

:Chris, I do not understand why you think that the advanced grade options setting is no longer available in 1.9.9 and 2.0 because it is! Perhaps you could check http://demo.moodle.net/ ;-) --[[User:Helen Foster|Helen Foster]] 14:57, 2 January 2011 (UTC)
::I am glad you are so kind to a blind guy with a head cold, who is only trying to follow instructions :)
::So I did login as teacher at demo.moodle yesterday and today.
::I went to lesson demo, did not see any grade item setting link. Did see the categories and items tab but advanced did not appear anywhere on my screen when I clicked on it. See here:
::*http://demo.moodle.net/grade/edit/tree/index.php?sesskey=0IFAaAi6tt&showadvanced=0&id=5
Right now I do notice that the url has "showadvanced" in it but that is NOT FAIR!

::And still as teacher I went to Site administration► Grades ► Grade item settings
::* http://demo.moodle.net/admin/settings.php?section=gradeitemsettings
:: and did not see it there either. Repeated this as site admin with ditto results. Guess I better reword the 'category and items' section and talk about simple and full??
:::Hoping you are still having a good holiday Chris

Lesson questions

2011-01-02T17:32:50Z

Rcollman: /* Short answer */ edit again

Questions in the Lesson activity module are slightly different than in the [[Quiz module]]/[[Question bank]] modules. There are fewer types, Lesson questions use jumps, can be scored differently and thus the question edit screens look very different. This page will discuss the mechanics of editing each type and rely upon linking so as not to duplicate efforts with information found about the [[Question bank]] types.

The lesson module gives a good overview of the [[Lesson_module#Types_of_questions_available_within_a_lesson|lesson types]]. [[Editing question page]](Lesson questions only) gives more detailed instructions for teachers.

==Parts of a question==
This is a quick review. Each [[Lesson_Pages#Questions_-_Choice_Pages| Lesson question page]] has a [[Lesson_Pages#Title_.26_Content|title and a place where content]] is presented. The number of student [[Lesson_Pages#Answer|answers]], teacher [[Lesson_Pages#Responses_in_Questions|responses]], navigational [[Lesson_Pages#Jumps_in_Questions|jumps]] and [[Lesson_Pages#score|scores]] depends upon the question type and sometimes upon the [[Adding/editing a lesson|lesson setting]].

==Multiple choice (single answer)==
Multiple choice allow the student to select one answer out of many. Each answer can have a default response, a specific teacher response, or no responce shown to the student. It is similar with a jump associated with a student answer. There is a default jumps of "this page" or "next page", or the teacher may select another more specific page for each individual answer.

==Multianswer ==
Multianswer is created using the Multiple choice form and by checking multianswer box. Multianswer allow the student to select more than one answer of many. In this Lesson question type, every correct answer must have both the same jump and the same response. And every wrong answer must have both the same jump and response. A correct answer is one that receives a positive score or advances the student forward in the [[Edit page order (Lesson)|edit order]].

There is no partial credit given for selecting some of the correct answers in a lesson question of this type.

==True-False==
True-False is a type of Multiple choice, except it is limited to two possible answers. Please refer to the Multiple choice section.

==Matching==
In a matching question, students use a pulldown menu to come up with a match. The quiz page on [[Matching question type]]s describes the process. There is one response and jump for getting the entire question correct and another response and jump when the match was wrong.

==Numeric==
A student is as to provide the results of a calculation in a single answer. The Quiz page about [[Numerical question type]]s has more information about evaluation of the student answer. Like a short answer, the teacher uses the series of answer as a filter. With the last one being "all the other wrong answers".

==Short answer==
A student is asked to provide a single short answer. The teacher uses a series of answer/response/jump/score as a series of filters to evaluate the students short answer. Each one can have a unique response, jump and score. The last one in the series is always all the other wrong answers.

The Quiz page about [[Short-Answer question type]] has more information about evaluation of the student answer. Notice that Lesson has a different evaluation method than Quiz for this kind of question.

:Please note: Starting with Moodle 1.6 in the Lesson module, there are two different student answer analysis systems available for the Short Answer type of question: the ''simple system ''is used by default. The second type only available in Lesson Module is called "Regular Expressions". See [[Short answer analysis]] for a description of the new type, with examples.

==Short essay==
In an lesson, after the student submits the answer for this type of question, the teacher must enter the lesson in edit mode to see a list of the student submitted essay questions for the teacher to manually grade.

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

Lesson questions

2011-01-02T17:30:38Z

Rcollman: /* Short essay */ corrected

Questions in the Lesson activity module are slightly different than in the [[Quiz module]]/[[Question bank]] modules. There are fewer types, Lesson questions use jumps, can be scored differently and thus the question edit screens look very different. This page will discuss the mechanics of editing each type and rely upon linking so as not to duplicate efforts with information found about the [[Question bank]] types.

The lesson module gives a good overview of the [[Lesson_module#Types_of_questions_available_within_a_lesson|lesson types]]. [[Editing question page]](Lesson questions only) gives more detailed instructions for teachers.

==Parts of a question==
This is a quick review. Each [[Lesson_Pages#Questions_-_Choice_Pages| Lesson question page]] has a [[Lesson_Pages#Title_.26_Content|title and a place where content]] is presented. The number of student [[Lesson_Pages#Answer|answers]], teacher [[Lesson_Pages#Responses_in_Questions|responses]], navigational [[Lesson_Pages#Jumps_in_Questions|jumps]] and [[Lesson_Pages#score|scores]] depends upon the question type and sometimes upon the [[Adding/editing a lesson|lesson setting]].

==Multiple choice (single answer)==
Multiple choice allow the student to select one answer out of many. Each answer can have a default response, a specific teacher response, or no responce shown to the student. It is similar with a jump associated with a student answer. There is a default jumps of "this page" or "next page", or the teacher may select another more specific page for each individual answer.

==Multianswer ==
Multianswer is created using the Multiple choice form and by checking multianswer box. Multianswer allow the student to select more than one answer of many. In this Lesson question type, every correct answer must have both the same jump and the same response. And every wrong answer must have both the same jump and response. A correct answer is one that receives a positive score or advances the student forward in the [[Edit page order (Lesson)|edit order]].

There is no partial credit given for selecting some of the correct answers in a lesson question of this type.

==True-False==
True-False is a type of Multiple choice, except it is limited to two possible answers. Please refer to the Multiple choice section.

==Matching==
In a matching question, students use a pulldown menu to come up with a match. The quiz page on [[Matching question type]]s describes the process. There is one response and jump for getting the entire question correct and another response and jump when the match was wrong.

==Numeric==
A student is as to provide the results of a calculation in a single answer. The Quiz page about [[Numerical question type]]s has more information about evaluation of the student answer. Like a short answer, the teacher uses the series of answer as a filter. With the last one being "all the other wrong answers".

==Short answer==
A student is asked to provide a single short answer. The Quiz page about [[Short-Answer question type] has more information about evaluation of the student answer. Notice that Lesson has a different evaluation method than Quiz for this kind of question. The teacher uses a series of answer/response/jump/score as a series of filters to evaluate the students short answer. Each one can have a unique response, jump and score. The last one in the series is always all the other wrong answers.

The Quiz page about [[Short-Answer question type]] has more information.
Please note: Starting with Moodle 1.6 in the Lesson module, there are two different student answer analysis systems available for the Short Answer type of question: the ''simple system ''is used by default. The second type only available in Lesson Module is called "Regular Expressions". See [[Short answer analysis]] for a description of the new type, with examples.

==Short essay==
In an lesson, after the student submits the answer for this type of question, the teacher must enter the lesson in edit mode to see a list of the student submitted essay questions for the teacher to manually grade.

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

Lesson questions

2011-01-02T17:28:13Z

Rcollman: /* Short answer */ wrong link

Questions in the Lesson activity module are slightly different than in the [[Quiz module]]/[[Question bank]] modules. There are fewer types, Lesson questions use jumps, can be scored differently and thus the question edit screens look very different. This page will discuss the mechanics of editing each type and rely upon linking so as not to duplicate efforts with information found about the [[Question bank]] types.

The lesson module gives a good overview of the [[Lesson_module#Types_of_questions_available_within_a_lesson|lesson types]]. [[Editing question page]](Lesson questions only) gives more detailed instructions for teachers.

==Parts of a question==
This is a quick review. Each [[Lesson_Pages#Questions_-_Choice_Pages| Lesson question page]] has a [[Lesson_Pages#Title_.26_Content|title and a place where content]] is presented. The number of student [[Lesson_Pages#Answer|answers]], teacher [[Lesson_Pages#Responses_in_Questions|responses]], navigational [[Lesson_Pages#Jumps_in_Questions|jumps]] and [[Lesson_Pages#score|scores]] depends upon the question type and sometimes upon the [[Adding/editing a lesson|lesson setting]].

==Multiple choice (single answer)==
Multiple choice allow the student to select one answer out of many. Each answer can have a default response, a specific teacher response, or no responce shown to the student. It is similar with a jump associated with a student answer. There is a default jumps of "this page" or "next page", or the teacher may select another more specific page for each individual answer.

==Multianswer ==
Multianswer is created using the Multiple choice form and by checking multianswer box. Multianswer allow the student to select more than one answer of many. In this Lesson question type, every correct answer must have both the same jump and the same response. And every wrong answer must have both the same jump and response. A correct answer is one that receives a positive score or advances the student forward in the [[Edit page order (Lesson)|edit order]].

There is no partial credit given for selecting some of the correct answers in a lesson question of this type.

==True-False==
True-False is a type of Multiple choice, except it is limited to two possible answers. Please refer to the Multiple choice section.

==Matching==
In a matching question, students use a pulldown menu to come up with a match. The quiz page on [[Matching question type]]s describes the process. There is one response and jump for getting the entire question correct and another response and jump when the match was wrong.

==Numeric==
A student is as to provide the results of a calculation in a single answer. The Quiz page about [[Numerical question type]]s has more information about evaluation of the student answer. Like a short answer, the teacher uses the series of answer as a filter. With the last one being "all the other wrong answers".

==Short answer==
A student is asked to provide a single short answer. The Quiz page about [[Short-Answer question type] has more information about evaluation of the student answer. Notice that Lesson has a different evaluation method than Quiz for this kind of question. The teacher uses a series of answer/response/jump/score as a series of filters to evaluate the students short answer. Each one can have a unique response, jump and score. The last one in the series is always all the other wrong answers.

==Short essay==
The Quiz page about [[Short-Answer question type]] has more information.

Please note: Starting with Moodle 1.6 in the Lesson module, there are two different student answer analysis systems available for the Short Answer type of question: the ''simple system ''is used by default. The second type only available in Lesson Module is called "Regular Expressions". See [[Short answer analysis]] for a description of the new type, with examples.

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

Course administration block

2011-01-02T16:09:46Z

Rcollman: /* Common adjusted settings */ more "common"

{{Course admin}}
Most of the links in the administration block in a course are only visible and available to teachers of the course. Students see a course administration block with just two links - [[Profile]] and [[Grades]] (assuming "Show grades" is set to yes in the [[Course settings|course settings]]).

Please use the menu on the right to find more specifics about each course setting.

Features in the administration block allow teachers to manage [[Course settings]], [[Students | student]] and [[Teachers | teacher]] enrollments and their [[Groups | groups]], view the course [[Grades | gradebook]], create custom [[Scales | grading scales]] and access the Teacher forum. The teacher forum is a private forum only available to teachers of that course. It can be used to discuss the course content, the direction the course could take or even to attach files to that can be shared among the course teachers.

[[Image:Administration Block Course 1 9.JPG|left|thumb|Moodle 1.9 course administration block]]

==Common adjusted settings==
There are many ways to set up a course. Here are a few ideas about course settings.

Under Edit settings, teachers can set the [[Course formats|course format]], which changes how the [[Course sections]] in the center column will appear to the student. Here are 4 common settings:
*[[Course_formats#Weekly_format|Weekly format]] - Creates weekly sections based upon start dates. Thus activities and resources placed in a week, will be revealed when week starts.
*[[Course_formats#Topic_format|Topic format]] - perhaps best for asynchronous enrolments.
*[[Course_formats#Social_format|Social format]]
*[[Course_formats#SCROM|SCROM format]] [[SCORM module]] can be loaded with this format.

The "Hide sections" will only show the student the name of the section but not the content with a section is hidden by the teacher or Moodle.

Another feature of the course administration block is the [[Files]] link. For Moodle 2.0 users, please see [[Repositories]]. A teacher can upload any digital content for inclusion in an activity or as a resource for viewing or downloading. Files can be moved, renamed, or deleted. Some files can be edited directly. Teachers can also create a directory and display the whole contents of that directory to course students using the "add resource" drop down in any course section. Of course if your content resides out on the web then you don't need to upload the files at all by using the "add resource" menu or creating an HTML link on a content page.

Using the availability setting can hide the course from students but allow the teacher to work on it.

==Moodle 2.0 changes==
{{Moodle 2.0}}Course administration can be found as a sub menu in the [[Settings block]]. Click on Course administration to expand the sub menu. There have been several changes. [[Image:Course administration_2_expanded all.png|thumb|right|Course Administration expanded in 2.0]]
*[[Turn editing on]]
*Edit settings [[Course settings]] - new features added
*[[Course completion|Completion tracking]] - new feature
*User
**[[Enrolled users]] -new interface
**[[Enrolment|Enrolment methods]] - new interface
**[[Groups]]
**Permissions - see [[Roles and capabilities]]
***[[Check permissions]] - new feature
**[[Other users (course)|Other users]] - new feature
*Filters - [[Filters 2.0]] - new interface
*[[Grades]]
*Backup - [[Backup 2.0]] - new interface
*Restore - [[Restore 2.0]] - new interface
*Import - [[Import course data]] - new interface
*[[Reset course|Reset]] - more options
*Question bank
**Questions- links to [[Question bank]]
**[[Question categories|Categories]]
**[[Import questions|Import]]
**[[Export questions|Export]]
*[[Repositories]] - replaces Files

==See also==
*[[Site administration block]] for settings
**Under Courses to set [[Automated course backup]] for the entire site
**Under Front Page link in this block to manually backup the front page as you would a course

[[Category:Teacher]]
[[Category:Block]]

[[eu:Kudeaketa]]
[[fr:Bloc d'administration]]
[[ja:管理ブロック]]

Course administration block

2011-01-02T16:00:43Z

Rcollman:

{{Course admin}}
Most of the links in the administration block in a course are only visible and available to teachers of the course. Students see a course administration block with just two links - [[Profile]] and [[Grades]] (assuming "Show grades" is set to yes in the [[Course settings|course settings]]).

Please use the menu on the right to find more specifics about each course setting.

Features in the administration block allow teachers to manage [[Course settings]], [[Students | student]] and [[Teachers | teacher]] enrollments and their [[Groups | groups]], view the course [[Grades | gradebook]], create custom [[Scales | grading scales]] and access the Teacher forum. The teacher forum is a private forum only available to teachers of that course. It can be used to discuss the course content, the direction the course could take or even to attach files to that can be shared among the course teachers.

[[Image:Administration Block Course 1 9.JPG|left|thumb|Moodle 1.9 course administration block]]

==Common adjusted settings==
There are many ways to set up a course. Here are a few ideas.

Teachers can set the [[Course formats|course format]], which changes how the [[Course sections]] in the center column will appear to the student. Here are 4 common settings:
*[[Course_formats#Weekly_format|Weekly format]] - Creates weekly sections based upon start dates. Thus activities and resources placed in a week, will be revealed when week starts.
*[[Course_formats#Topic_format|Topic format]] - perhaps best for asynchronous enrolments.
*[[Course_formats#Social_format|Social format]]
*[[Course_formats#SCROM|SCROM format]] [[SCORM module]] can be loaded with this format.

Teachers can move blocks or delete blocks to visually delete columns for students. Thus the student can see one course that only has a wide center column, and another that has blocks to the right and/or the left of the center column.

Another feature of the course administration block is the [[Files]] link. For Moodle 2.0 users, please see [[Repositories]]. A teacher can upload any digital content for inclusion in an activity or as a resource for viewing or downloading. Files can be moved, renamed, or deleted. Some files can be edited directly. Teachers can also create a directory and display the whole contents of that directory to course students using the "add resource" drop down in any course section. Of course if your content resides out on the web then you don't need to upload the files at all by using the "add resource" menu or creating an HTML link on a content page.

==Moodle 2.0 changes==
{{Moodle 2.0}}Course administration can be found as a sub menu in the [[Settings block]]. Click on Course administration to expand the sub menu. There have been several changes. [[Image:Course administration_2_expanded all.png|thumb|right|Course Administration expanded in 2.0]]
*[[Turn editing on]]
*Edit settings [[Course settings]] - new features added
*[[Course completion|Completion tracking]] - new feature
*User
**[[Enrolled users]] -new interface
**[[Enrolment|Enrolment methods]] - new interface
**[[Groups]]
**Permissions - see [[Roles and capabilities]]
***[[Check permissions]] - new feature
**[[Other users (course)|Other users]] - new feature
*Filters - [[Filters 2.0]] - new interface
*[[Grades]]
*Backup - [[Backup 2.0]] - new interface
*Restore - [[Restore 2.0]] - new interface
*Import - [[Import course data]] - new interface
*[[Reset course|Reset]] - more options
*Question bank
**Questions- links to [[Question bank]]
**[[Question categories|Categories]]
**[[Import questions|Import]]
**[[Export questions|Export]]
*[[Repositories]] - replaces Files

==See also==
*[[Site administration block]] for settings
**Under Courses to set [[Automated course backup]] for the entire site
**Under Front Page link in this block to manually backup the front page as you would a course

[[Category:Teacher]]
[[Category:Block]]

[[eu:Kudeaketa]]
[[fr:Bloc d'administration]]
[[ja:管理ブロック]]

Talk:Course administration block

2011-01-02T15:59:57Z

Rcollman: My feelings about this page as 2.0 comes along

==Moodle 2 adjustments==
I added some infomation for 2.0. I am not sure why we have "Common adjustments" but I went along with it just to be friendly to history (I would delete it or put it as "tips and trips section at the end. I put in more links in the whole page. Deleted the lightbulb expand hide section tools because they have nothing to do with the course administration link.

I personally like the new 2.0 section which does not describe much but does give links. As time goes by, the new should move up and the old move down. As usual, I expect my edits to be edited and it is always appreciated. --[[User:chris collman|chris collman]] 15:59, 2 January 2011 (UTC)

==Administration block links==

Is this a copy of the admin course block? It looks like it should be. If so the following are missing
* Turn editing on
* Help
* Teacher Forum

Do these pages exist already? --[[User:Darren Smith|Darren Smith]] 01:39, 26 March 2006 (WST)

:Oh and database (phpmysql) which is optional but very useful --[[User:Darren Smith|Darren Smith]] 05:35, 26 March 2006 (WST)

::Hi Darren, please note that Help in the Administration block should link to [[Teacher documentation]]. There are not yet pages for Turn editing on or Teacher Forum. If you wish to write some documentation for them then please create the pages. There is already a [[Moodle database|database]] page. --[[User:Helen Foster|Helen Foster]] 04:30, 27 March 2006 (WST)

==Out of date==
I was checking to see if the admin course block said grades or gradebook. There was no picture. I added one and then happen to read the text. There seems to be information about sections here that does not belong. Then there are references to scales which are in the site administration block. It would be nice if we changed the name of this page to Course Admininstration block. Seems like this is really what this page is about.

Can I make the edit changes concerning scales, sections and other things not found in the course administration block? A little distraction from my pondering Grades :) Thanks --[[User:chris collman|chris collman]] 08:56, 5 June 2008 (CDT)
===Example, needs more work but===
All of the links in the administration block are only available to teachers of the course. Students will receive their own version of the [[student administration block|block]]. More information about specific links can be found in the box to the right.

Features in the administration block allow teachers [[Assign roles]] in a course to any site user (for example [[Students | student]] and other [[Teachers | teachers]]). There is a Grades link to view the course [[Grades | gradebook]], where the teacher can also create custom [[Scales | grading scales]] and letter or word displays instead of a number score. The [[Outcomes]] link is a new 1.9 feature. When enabled in settings, [[Groups]] allow the teacher to separated students for different activities. Some teachers have the rights to [[Course backup|backup]] and [[Restore|restore]] their course. The [[Import course data|import]] link will allow the teacher to bring in all or parts of other courses they teach on the Moodle site. The [[Reset course|reset]] link is a quick way to use a course again for a different set of students. Specific student activity can be seen as logs with the [[Reports]] link. The [[Question bank]] can be accessed from the Course Administration block instead of the [[Quiz]] activity. The entire [[Files|course file]] structure for student and teacher materials is located here.

need to check links and maybe break up or reorganize the paragraph in something other that the listed order. --[[User:chris collman|chris collman]] 09:27, 5 June 2008 (CDT)

Course administration block

2011-01-02T15:52:36Z

Rcollman: /* Common adjusted settings */ see page comment

{{Course admin}}

Most of the links in the administration block in a course are only visible and available to teachers of the course. Students see a course administration block with just two links - [[Profile]] and [[Grades]] (assuming "Show grades" is set to yes in the [[Course settings|course settings]]).

Please use the menu on the right to find more specifics about each course setting.

Features in the administration block allow teachers to manage [[Course settings]], [[Students | student]] and [[Teachers | teacher]] enrollments and their [[Groups | groups]], view the course [[Grades | gradebook]], create custom [[Scales | grading scales]] and access the Teacher forum. The teacher forum is a private forum only available to teachers of that course. It can be used to discuss the course content, the direction the course could take or even to attach files to that can be shared among the course teachers.

[[Image:Administration Block Course 1 9.JPG|left|thumb|Moodle 1.9 course administration block]]

==Common adjusted settings==
There are many ways to set up a course. Here are a few ideas.

Teachers can set the [[Course formats|course format]], which changes how the [[Course sections]] in the center column will appear to the student. Here are 4 common settings:
*[[Course_formats#Weekly_format|Weekly format]] - Creates weekly sections based upon start dates. Thus activities and resources placed in a week, will be revealed when week starts.
*[[Course_formats#Topic_format|Topic format]] - perhaps best for asynchronous enrolments.
*[[Course_formats#Social_format|Social format]]
*[[Course_formats#SCROM|SCROM format]] [[SCORM module]] can be loaded with this format.

Teachers can move blocks or delete blocks to visually delete columns for students. Thus the student can see one course that only has a wide center column, and another that has blocks to the right and/or the left of the center column.

Another feature of the course administration block is the [[Files]] link. For Moodle 2.0 users, please see [[Repositories]]. A teacher can upload any digital content for inclusion in an activity or as a resource for viewing or downloading. Files can be moved, renamed, or deleted. Some files can be edited directly. Teachers can also create a directory and display the whole contents of that directory to course students using the "add resource" drop down in any course section. Of course if your content resides out on the web then you don't need to upload the files at all by using the "add resource" menu or creating an HTML link on a content page.

==Moodle 2.0 changes==
{{Moodle 2.0}}Course administration can be found as a sub menu in the [[Settings block]]. Click on Course administration to expand the sub menu. There have been several changes. [[Image:Course administration_2_expanded all.png|thumb|right|Course Administration expanded in 2.0]]
*[[Turn editing on]]
*Edit settings [[Course settings]] - new features added
*[[Course completion|Completion tracking]] - new feature
*User
**[[Enrolled users]] -new interface
**[[Enrolment|Enrolment methods]] - new interface
**[[Groups]]
**Permissions - see [[Roles and capabilities]]
***[[Check permissions]] - new feature
**[[Other users (course)|Other users]] - new feature
*Filters - [[Filters 2.0]] - new interface
*[[Grades]]
*Backup - [[Backup 2.0]] - new interface
*Restore - [[Restore 2.0]] - new interface
*Import - [[Import course data]] - new interface
*[[Reset course|Reset]] - more options
*Question bank
**Questions- links to [[Question bank]]
**[[Question categories|Categories]]
**[[Import questions|Import]]
**[[Export questions|Export]]
*[[Repositories]] - replaces Files

==See also==
*[[Site administration block]] for settings
**Under Courses to set [[Automated course backup]] for the entire site
**Under Front Page link in this block to manually backup the front page as you would a course

[[Category:Teacher]]
[[Category:Block]]

[[eu:Kudeaketa]]
[[fr:Bloc d'administration]]
[[ja:管理ブロック]]

Course settings

2011-01-02T15:07:24Z

Rcollman: add brief 2.0 messae

{{Course admin}}

[[Image:Settings.gif]]'''Course settings''' control how the things appear to the participants in a course. It is the first page viewed after creating a course. It can be edited through the '''Settings''' link in the [[Course administration block]] menu. This page has links to other pages that may describe a setting in more detail. Different versions of Moodle may not have all the settings listed below.

The Moodle 2.0 interface will look slightly different but will contain all the features of 1.9, plus the new course completion tracking feature.

==General==
[[Image:generalsettings1.gif|thumb|General settings]]
===Category===

The site administrator may have created course categories to help teachers and students find their courses easily.

The capability [[Capabilities/moodle/course:changecategory|moodle/course:changecategory]] controls whether a user can edit the course category.

===Short name===
Many institutions have a shorthand way of referring to a course, such as BP102 or COMMS. Even if you do not already have such a name for your course, make one up here. It will be used in several places where the long name is not appropriate. The most common use is in the navigation bar that is at the top of most pages and this provides an active link to the course home page.

[[Image:Assignment nav trail.jpg|Point to Assignment, part of the Features course, in a site called Moodle]]

The above example has the short course name, "Features", in the navigation links (breadcrumb). The short name also appears in the subject line of email messages that are part of the course.

The capability [[Capabilities/moodle/course:changeshortname|moodle/course:changeshortname]] controls whether a user can edit the short name field.

===ID number===
The ID number is an alphanumeric field. It has several potential uses. Generally, it is not displayed to students. However, it can be used to match this course against an external system's ID, as your course catalog ID or can be used in the certificate module as a printed field.

The capability [[Capabilities/moodle/course:changeidnumber|moodle/course:changeidnumber]] controls whether a user can edit the ID number.

===Summary===

The summary appears on the course listings page.

The capability [[Capabilities/moodle/course:changesummary|moodle/course:changesummary]] controls whether a user can edit the course summary.

===Format===
[[Image:generalsettings3.gif|thumb|Format section in course settings]]
See [[Course formats]]

===Number of weeks/topics===
This setting is only used by the 'weekly' and 'topics' course formats. In the 'weekly' format, it specifies the number of weeks that the course will run for, starting from the course starting date. In the 'topics' format, it specifies the number of topics in the course. Both of these translate to the number of "boxes" down the middle of the course page.

[[#top|Top]]

===Course start date===
This is where you specify the starting time of the course (in your own time zone). The first week will start on the date you set here when you use the "Weekly" course format.

This setting will not affect courses using the 'social' or 'topics' formats.

However, this setting will have an effect on the display of logs, which use this date as the earliest possible date you can display. It can also make your course not visible to students even if when the course is available to students (see below).

:''TIP:'' If your institution runs on a weekly schedule, you may want to consider setting the start date for courses on the first day of the week, like a Monday.

:''TIP:'' In general, if your course does not have a real starting date then set the date to yesterday and use the availability setting to reveal the course to students.

===Hidden sections===
This option allows you to decide how the hidden sections in your course are displayed to students. By default, a small area is shown (in collapsed form, usually gray) to indicate where the hidden section is, though they still cannot actually see the hidden activities and texts. This is particularly useful in the Weekly format, so that non-class weeks are clear, or if you have quizes you don't want your students to see.

:''TIP:'' If you choose, these non-available items can be completely hidden, so that students do not even know that sections or an activity in the course are hidden.

[[#top|Top]]

===Show grades===
Many of the activities allow [[Grades|grades]] to be set. By default, the results of all grades within the course can be seen in the Grades page, available from the main course page for students and teachers.

:''TIP:'' If a teacher is not interested in using grades in a course, or just wants to hide grades from students, then they can disable the display of grades with this option. This does not prevent the teacher using or setting grades for an individual activities, it just disables the results from being displayed to students.

===Show activity reports===
[[Activity_report#Individual_Activity_Report|Activity reports]] are available to each student. These reports or logs show their activity and contributions in the current course. These reports include their detailed access log.

Student access to their own reports is controlled by the teacher via this course setting. For some courses, these reports can be a useful tool for a student to reflect on their involvement and appearance within the online environment, but for some courses, this may not be necessary.

Teachers always have access to these reports. Teachers can use the button or tab visible on each person’s profile page or use the [[Reports]] link in the course administration block.

Your site administrator may ask you to turn this feature off. Showing activity reports can place a load on the server, slowing it down at times. For large or long classes it may be more efficient to keep it off.

[[#top|Top]]

===Maximum upload size===
[[Image:Changeupload.jpg|thumb|Maximum upload size setting]]
This setting defines the largest size of file that can be uploaded by students in this course. The site administrator can determine [[Site_policies#Maximum_uploaded_file_sizefile |sizes available]] for the teacher to select. Teachers should be aware of a course's [[Files|file structure]].

It is possible to further restrict this size through settings within each activity module.

===Force theme===
If the site administrator has allowed the teacher to set a course [[Themes|theme]], this pull down menu will appear with a list of themes on the site.

===Is this a meta course?===
A [[Metacourses|metacourse]] only gets its student enrolments from one or more other courses. Students can not be enrolled directly in this kind of course. A metacourse creates a virtual family of related courses. There are [[Metacourse examples of use|many uses for a metacourse]].

[[#top|Top]]

==Enrolments==
[[Image:generalsetting4.gif|thumb|Enrolment settings]]
===Enrolment plugins===
This setting allows you to choose an interactive [[Enrolment plugins|enrolment plugin]], such as [[Internal enrolment|internal enrolment]] or [[Paypal]]. If you use a non-interactive enrolment plugin, this setting has no effect.

===Default role===

From Moodle 1.7 onwards, a default course role, such as student, may be set.

===Course enrollable===
This setting only affects interactive enrolment plugins, such as [[Internal enrolment|internal enrolment]] and [[Paypal]]. It has no affect at all on non-interactive plugins (e.g. External Database, LDAP). Setting it to "no" or if it is outside the specified date range will result in the student being told the course is "Not enrollable" and being returned to the front page, if they are attempting to enrol using an interactive plugin.

:''TIP:'' If you are using Internal enrolment and you have not set an enrolment key, you should seriously consider setting this to ''No'' otherwise any user can enrol on your course.

[[#top|Top]]
===Enrolment duration===
This setting specifies the number of days a student can be enrolled in this course (starting from the moment they enrol). Set this value with care - setting it when not required is a common origin of the complaint, "my students keep disappearing after n days".

:''TIP:'' This is useful for rolling courses without a specific start or end time. Students are automatically unenrolled after the number of days has expired in this setting.

:''TIP:'' This setting can be used as an alternative to a manually unenrolling students or using a clean-up function to remove defunct students at some future time.
:''TIP:'' If this course is a metacourse, the enrolment period will not be used.

==Enrolment expiry notification==
[[Image:generalsettings5.gif|thumb|Enrolment expiry notification settings]]
These settings determine whether teachers and/or students are notified that their enrolment is about to expire and how much notice they should be given.

[[#top|Top]]
==Groups==
[[Image:generalsettings6.gif|thumb|Groups settings]]
===Group mode===
Here you can define the [[Groups|group mode]] at the course level by a pull down menu. "[[Groups#No_groups|No groups]]", "[[Groups#Separate_groups|Separate groups]]" and "[[Groups#Visible_groups|Visible groups]]" are the choices. The selected setting will be the default group mode for all activities defined within that course. The group setting can affect what users see in the [[Participants]] list.

:''TIP:'' You may leave it set to "No groups" and still have specific activities use groups. In this case the force setting below should be set to "no". For example, the teacher can use a group setting to completely separate cohorts of students such that each group is unaware of the other in the course.

===Force===
If the group mode is "forced" at a course-level, then this particular group mode will be applied to every activity in that course. This will override any activities that may have a special group setting.

:''TIP:''The force setting is useful when the teacher wants to set up a course and not have to change each activities group settings.

[[#top|Top]]
===Default grouping===

{{Moodle 1.9}}If [[Groupings|groupings]] are enabled (in Moodle 1.9 onwards), a default grouping for course activities and resources may be set.

==Availability==

[[Image:generalsettings7.gif|thumb|Availability settings]]
This option allows you to "hide" your course completely. It will not appear on any course listings, except to teachers of the course and administrators. Even if students try to access the course URL directly, they will not be allowed to enter.

:''TIP:'' The [[Course_settings#Course_start_date|Start Date]] of the course can also effect course visibility.

[[#top|Top]]
===Enrolment key===
A course [[Enrolment key|enrolment key]] enables access to courses to be restricted to those who know the key. This feature is typically used on sites which encourage self enrolments or use an external database process to register students in a course. The idea is that Teachers or course administrators will supply the key to authorized people using another means like private email, snail mail, on the phone or even verbally in a face-to-face class.

When the key is left blank and [[Course_settings#Course_enrollable|self enrolment]] is allowed, then anyone who has a Moodle username on the site will be able to enrol in the course.

:''TIP:'' A student can be manually enroled in the course and will not have to supply the required key when they enter the course for the first time.

:''TIP:'' If this password "gets out" and you have unwanted people enrolling, you can unenrol them (see their user profile page or unassign them from the [[Assign roles|student role]] in the course) and change this key. Any legitimate students who have already enrolled will not be affected, but the unwanted people will not be able to get back in.

:''TIP:'' If you are using a non-interactive enrolment, system (e.g., External Database, LDAP) and you do not want students who fail the initial check to be asked for an enrolment key that they will not have, set ''Course Enrolable'' to ''No''.

:''TIP:'' You can control who is displayed as providing the Key when someone is requested to supply the key. See [[Internal enrolment]]

[[#top|Top]]

===Guest access===

Allows any authenticated user (i.e. logged in) to access the course (as a [[Guest role|guest]]), including those who have logged in "as guest". You can choose if they need an enrolment key or may enter without one.

People can log in as guests using the "Login as a guest" button on a login screen, where that feature is enabled for the site. When the user tries to enter a course, they will see the [[Log in|login screen]]. If you only need people authenticated via your normal authentication method to access courses (as Guest or not) it is probably wise to disable "Login as a guest" for a slight improvement in site security. See [[Manage authentication]].

Guests in a course ALWAYS have "read-only" access - meaning they cannot leave any posts or otherwise mess up the course for real students. No use information is stored for a guest.

:''TIP:'' This can be handy when you want to let a colleague in to look around at your work, or to let students see a course before they have decided to enroll.
:''TIP:'' You have a choice between two types of guest access: with the enrolment key or without. If you choose to allow guests who have the key, then the guest will need to provide the current enrolment key EVERY TIME they log in (unlike students who only need to do it once). This lets you restrict your guests. If you choose to allow guests without a key, then anyone can get straight into your course.

For more information see [[Guest role]].

[[#top|Top]]
===Cost===

If [[Paypal]] or [[Authorize.net Payment Gateway]] is set as the [[Enrolment plugins|enrolment plugin]], then the course cost can be set in the cost field.

==Language==
[[Image:generalsettings8.gif|thumb|Language settings]]

If you force a language in a course, the interface of Moodle in this course will be in this particular language, even if a student has selected a different preferred language in his/her personal profile.

==Student progress==
{{Moodle 2.0}}Has settings for [[Course completion]] criterion, a new feature in 2.0.

[[#top|Top]]

==Role renaming==
[[Image:rolesimages.gif|thumb|Role renaming settings]]
{{Moodle 1.9}}In Moodle 1.9 onwards, you can rename the [[Roles|roles]] used in your course. For example, you may wish to rename the [[Teacher role]] as "Facilitator", "Tutor" or "Guide". These new role names will appear within the course. For example on the [[Participants|participants]] and the override permissions pages.

Please note that the site administrator or a [[Course managers|course manager]] may have changed the names or added new roles. These names will appear and the teacher may rename them.

[[Roles FAQ]] contains information on changing the name for teacher in Moodle 1.7 and 1.8. Prior to Moodle 1.7, the words for teacher and student may be changed in the course settings.

:''Tip'': Do not worry about changing every role name. Only change the site roles which are used in your course. For example, you may want to ignore renaming roles such as the [[Administrator role]] or the [[Authenticated user role]].

:''Tip'': To include new role names in a course backup, users should be included in the backup.

[[#top|Top]]

==Default course settings==

An administrator can set course settings defaults in ''Administration > Courses > [[Course default settings]]'' in Moodle 1.9.5 onwards.
[[#top|Top]]

==See also==

*[http://www.youtube.com/watch?v=zWOp1oq-TvI Video showing how to create a course in Moodle]

[[Category:Course]]

[[de:Kurseinstellungen]]
[[es:Administración del curso]]
[[eu:Ikastaroaren_ezarpenak]]
[[fr:Paramètres]]
[[ja:コース設定]]
[[ru:course/edit]]

Course settings

2011-01-02T15:05:05Z

Rcollman: /* Student progress */ new 2.0 setting

{{Course admin}}

[[Image:Settings.gif]]'''Course settings''' control how the things appear to the participants in a course. It is the first page viewed after creating a course. It can be edited through the '''Settings''' link in the [[Course administration block]] menu. This page has links to other pages that may describe a setting in more detail. Different versions of Moodle may not have all the settings listed below.

==General==
[[Image:generalsettings1.gif|thumb|General settings]]
===Category===

The site administrator may have created course categories to help teachers and students find their courses easily.

The capability [[Capabilities/moodle/course:changecategory|moodle/course:changecategory]] controls whether a user can edit the course category.

===Short name===
Many institutions have a shorthand way of referring to a course, such as BP102 or COMMS. Even if you do not already have such a name for your course, make one up here. It will be used in several places where the long name is not appropriate. The most common use is in the navigation bar that is at the top of most pages and this provides an active link to the course home page.

[[Image:Assignment nav trail.jpg|Point to Assignment, part of the Features course, in a site called Moodle]]

The above example has the short course name, "Features", in the navigation links (breadcrumb). The short name also appears in the subject line of email messages that are part of the course.

The capability [[Capabilities/moodle/course:changeshortname|moodle/course:changeshortname]] controls whether a user can edit the short name field.

===ID number===
The ID number is an alphanumeric field. It has several potential uses. Generally, it is not displayed to students. However, it can be used to match this course against an external system's ID, as your course catalog ID or can be used in the certificate module as a printed field.

The capability [[Capabilities/moodle/course:changeidnumber|moodle/course:changeidnumber]] controls whether a user can edit the ID number.

===Summary===

The summary appears on the course listings page.

The capability [[Capabilities/moodle/course:changesummary|moodle/course:changesummary]] controls whether a user can edit the course summary.

===Format===
[[Image:generalsettings3.gif|thumb|Format section in course settings]]
See [[Course formats]]

===Number of weeks/topics===
This setting is only used by the 'weekly' and 'topics' course formats. In the 'weekly' format, it specifies the number of weeks that the course will run for, starting from the course starting date. In the 'topics' format, it specifies the number of topics in the course. Both of these translate to the number of "boxes" down the middle of the course page.

[[#top|Top]]

===Course start date===
This is where you specify the starting time of the course (in your own time zone). The first week will start on the date you set here when you use the "Weekly" course format.

This setting will not affect courses using the 'social' or 'topics' formats.

However, this setting will have an effect on the display of logs, which use this date as the earliest possible date you can display. It can also make your course not visible to students even if when the course is available to students (see below).

:''TIP:'' If your institution runs on a weekly schedule, you may want to consider setting the start date for courses on the first day of the week, like a Monday.

:''TIP:'' In general, if your course does not have a real starting date then set the date to yesterday and use the availability setting to reveal the course to students.

===Hidden sections===
This option allows you to decide how the hidden sections in your course are displayed to students. By default, a small area is shown (in collapsed form, usually gray) to indicate where the hidden section is, though they still cannot actually see the hidden activities and texts. This is particularly useful in the Weekly format, so that non-class weeks are clear, or if you have quizes you don't want your students to see.

:''TIP:'' If you choose, these non-available items can be completely hidden, so that students do not even know that sections or an activity in the course are hidden.

[[#top|Top]]

===Show grades===
Many of the activities allow [[Grades|grades]] to be set. By default, the results of all grades within the course can be seen in the Grades page, available from the main course page for students and teachers.

:''TIP:'' If a teacher is not interested in using grades in a course, or just wants to hide grades from students, then they can disable the display of grades with this option. This does not prevent the teacher using or setting grades for an individual activities, it just disables the results from being displayed to students.

===Show activity reports===
[[Activity_report#Individual_Activity_Report|Activity reports]] are available to each student. These reports or logs show their activity and contributions in the current course. These reports include their detailed access log.

Student access to their own reports is controlled by the teacher via this course setting. For some courses, these reports can be a useful tool for a student to reflect on their involvement and appearance within the online environment, but for some courses, this may not be necessary.

Teachers always have access to these reports. Teachers can use the button or tab visible on each person’s profile page or use the [[Reports]] link in the course administration block.

Your site administrator may ask you to turn this feature off. Showing activity reports can place a load on the server, slowing it down at times. For large or long classes it may be more efficient to keep it off.

[[#top|Top]]

===Maximum upload size===
[[Image:Changeupload.jpg|thumb|Maximum upload size setting]]
This setting defines the largest size of file that can be uploaded by students in this course. The site administrator can determine [[Site_policies#Maximum_uploaded_file_sizefile |sizes available]] for the teacher to select. Teachers should be aware of a course's [[Files|file structure]].

It is possible to further restrict this size through settings within each activity module.

===Force theme===
If the site administrator has allowed the teacher to set a course [[Themes|theme]], this pull down menu will appear with a list of themes on the site.

===Is this a meta course?===
A [[Metacourses|metacourse]] only gets its student enrolments from one or more other courses. Students can not be enrolled directly in this kind of course. A metacourse creates a virtual family of related courses. There are [[Metacourse examples of use|many uses for a metacourse]].

[[#top|Top]]

==Enrolments==
[[Image:generalsetting4.gif|thumb|Enrolment settings]]
===Enrolment plugins===
This setting allows you to choose an interactive [[Enrolment plugins|enrolment plugin]], such as [[Internal enrolment|internal enrolment]] or [[Paypal]]. If you use a non-interactive enrolment plugin, this setting has no effect.

===Default role===

From Moodle 1.7 onwards, a default course role, such as student, may be set.

===Course enrollable===
This setting only affects interactive enrolment plugins, such as [[Internal enrolment|internal enrolment]] and [[Paypal]]. It has no affect at all on non-interactive plugins (e.g. External Database, LDAP). Setting it to "no" or if it is outside the specified date range will result in the student being told the course is "Not enrollable" and being returned to the front page, if they are attempting to enrol using an interactive plugin.

:''TIP:'' If you are using Internal enrolment and you have not set an enrolment key, you should seriously consider setting this to ''No'' otherwise any user can enrol on your course.

[[#top|Top]]
===Enrolment duration===
This setting specifies the number of days a student can be enrolled in this course (starting from the moment they enrol). Set this value with care - setting it when not required is a common origin of the complaint, "my students keep disappearing after n days".

:''TIP:'' This is useful for rolling courses without a specific start or end time. Students are automatically unenrolled after the number of days has expired in this setting.

:''TIP:'' This setting can be used as an alternative to a manually unenrolling students or using a clean-up function to remove defunct students at some future time.
:''TIP:'' If this course is a metacourse, the enrolment period will not be used.

==Enrolment expiry notification==
[[Image:generalsettings5.gif|thumb|Enrolment expiry notification settings]]
These settings determine whether teachers and/or students are notified that their enrolment is about to expire and how much notice they should be given.

[[#top|Top]]
==Groups==
[[Image:generalsettings6.gif|thumb|Groups settings]]
===Group mode===
Here you can define the [[Groups|group mode]] at the course level by a pull down menu. "[[Groups#No_groups|No groups]]", "[[Groups#Separate_groups|Separate groups]]" and "[[Groups#Visible_groups|Visible groups]]" are the choices. The selected setting will be the default group mode for all activities defined within that course. The group setting can affect what users see in the [[Participants]] list.

:''TIP:'' You may leave it set to "No groups" and still have specific activities use groups. In this case the force setting below should be set to "no". For example, the teacher can use a group setting to completely separate cohorts of students such that each group is unaware of the other in the course.

===Force===
If the group mode is "forced" at a course-level, then this particular group mode will be applied to every activity in that course. This will override any activities that may have a special group setting.

:''TIP:''The force setting is useful when the teacher wants to set up a course and not have to change each activities group settings.

[[#top|Top]]
===Default grouping===

{{Moodle 1.9}}If [[Groupings|groupings]] are enabled (in Moodle 1.9 onwards), a default grouping for course activities and resources may be set.

==Availability==

[[Image:generalsettings7.gif|thumb|Availability settings]]
This option allows you to "hide" your course completely. It will not appear on any course listings, except to teachers of the course and administrators. Even if students try to access the course URL directly, they will not be allowed to enter.

:''TIP:'' The [[Course_settings#Course_start_date|Start Date]] of the course can also effect course visibility.

[[#top|Top]]
===Enrolment key===
A course [[Enrolment key|enrolment key]] enables access to courses to be restricted to those who know the key. This feature is typically used on sites which encourage self enrolments or use an external database process to register students in a course. The idea is that Teachers or course administrators will supply the key to authorized people using another means like private email, snail mail, on the phone or even verbally in a face-to-face class.

When the key is left blank and [[Course_settings#Course_enrollable|self enrolment]] is allowed, then anyone who has a Moodle username on the site will be able to enrol in the course.

:''TIP:'' A student can be manually enroled in the course and will not have to supply the required key when they enter the course for the first time.

:''TIP:'' If this password "gets out" and you have unwanted people enrolling, you can unenrol them (see their user profile page or unassign them from the [[Assign roles|student role]] in the course) and change this key. Any legitimate students who have already enrolled will not be affected, but the unwanted people will not be able to get back in.

:''TIP:'' If you are using a non-interactive enrolment, system (e.g., External Database, LDAP) and you do not want students who fail the initial check to be asked for an enrolment key that they will not have, set ''Course Enrolable'' to ''No''.

:''TIP:'' You can control who is displayed as providing the Key when someone is requested to supply the key. See [[Internal enrolment]]

[[#top|Top]]

===Guest access===

Allows any authenticated user (i.e. logged in) to access the course (as a [[Guest role|guest]]), including those who have logged in "as guest". You can choose if they need an enrolment key or may enter without one.

People can log in as guests using the "Login as a guest" button on a login screen, where that feature is enabled for the site. When the user tries to enter a course, they will see the [[Log in|login screen]]. If you only need people authenticated via your normal authentication method to access courses (as Guest or not) it is probably wise to disable "Login as a guest" for a slight improvement in site security. See [[Manage authentication]].

Guests in a course ALWAYS have "read-only" access - meaning they cannot leave any posts or otherwise mess up the course for real students. No use information is stored for a guest.

:''TIP:'' This can be handy when you want to let a colleague in to look around at your work, or to let students see a course before they have decided to enroll.
:''TIP:'' You have a choice between two types of guest access: with the enrolment key or without. If you choose to allow guests who have the key, then the guest will need to provide the current enrolment key EVERY TIME they log in (unlike students who only need to do it once). This lets you restrict your guests. If you choose to allow guests without a key, then anyone can get straight into your course.

For more information see [[Guest role]].

[[#top|Top]]
===Cost===

If [[Paypal]] or [[Authorize.net Payment Gateway]] is set as the [[Enrolment plugins|enrolment plugin]], then the course cost can be set in the cost field.

==Language==
[[Image:generalsettings8.gif|thumb|Language settings]]

If you force a language in a course, the interface of Moodle in this course will be in this particular language, even if a student has selected a different preferred language in his/her personal profile.

==Student progress==
{{Moodle 2.0}}Has settings for [[Course completion]] criterion, a new feature in 2.0.

[[#top|Top]]

==Role renaming==
[[Image:rolesimages.gif|thumb|Role renaming settings]]
{{Moodle 1.9}}In Moodle 1.9 onwards, you can rename the [[Roles|roles]] used in your course. For example, you may wish to rename the [[Teacher role]] as "Facilitator", "Tutor" or "Guide". These new role names will appear within the course. For example on the [[Participants|participants]] and the override permissions pages.

Please note that the site administrator or a [[Course managers|course manager]] may have changed the names or added new roles. These names will appear and the teacher may rename them.

[[Roles FAQ]] contains information on changing the name for teacher in Moodle 1.7 and 1.8. Prior to Moodle 1.7, the words for teacher and student may be changed in the course settings.

:''Tip'': Do not worry about changing every role name. Only change the site roles which are used in your course. For example, you may want to ignore renaming roles such as the [[Administrator role]] or the [[Authenticated user role]].

:''Tip'': To include new role names in a course backup, users should be included in the backup.

[[#top|Top]]

==Default course settings==

An administrator can set course settings defaults in ''Administration > Courses > [[Course default settings]]'' in Moodle 1.9.5 onwards.
[[#top|Top]]

==See also==

*[http://www.youtube.com/watch?v=zWOp1oq-TvI Video showing how to create a course in Moodle]

[[Category:Course]]

[[de:Kurseinstellungen]]
[[es:Administración del curso]]
[[eu:Ikastaroaren_ezarpenak]]
[[fr:Paramètres]]
[[ja:コース設定]]
[[ru:course/edit]]

Course administration block

2011-01-02T14:58:04Z

Rcollman: /* Moodle 2.0 changes */

{{Course admin}}

Most of the links in the administration block in a course are only visible and available to teachers of the course. Students see a course administration block with just two links - [[Profile]] and [[Grades]] (assuming "Show grades" is set to yes in the [[Course settings|course settings]]).

Please use the menu on the right to find more specifics about each course setting.

Features in the administration block allow teachers to manage [[Course settings]], [[Students | student]] and [[Teachers | teacher]] enrollments and their [[Groups | groups]], view the course [[Grades | gradebook]], create custom [[Scales | grading scales]] and access the Teacher forum. The teacher forum is a private forum only available to teachers of that course. It can be used to discuss the course content, the direction the course could take or even to attach files to that can be shared among the course teachers.

[[Image:Administration Block Course 1 9.JPG|left|thumb|Moodle 1.9 course administration block]]

==Common adjusted settings==

There are lots of possible ways to set up a course using blocks, but teachers may be particularly interested in [[Course_settings#Format | course formats]] which change how the course is presented to the learner. The weekly format is suitable for courses that have a clear start date and activities are presented in weekly blocks. Topic formatted courses are actually presented in a similar way but with the dates removed so activities can belong to general or specific areas of study. The social format doesn't use much content at all and is based around just one forum which is displayed on the main course page.

Another much used feature of the administration block is the [[Files]] link. From here you can upload any digital content for inclusion in an activity, resource, course section or for a direct download. These files can be moved, renamed, edited directly on the server (if they are HTML or text) or deleted. You can also create a directory and display the whole contents of that directory to course students using the add resource drop down in any course section.
Of course if your content resides out on the web then you don't need to upload the files at all - you can link directly to them from inside the course using the link to file or website option.

In the course homepage there is a white square icon on the top right of a [[Course_sections | section]] which can be used to expand and collapse sections. You can also use the lightbulb icon to mark a topic as current.

==Moodle 2.0 changes==
{{Moodle 2.0}}Course administration can be found as a sub menu in the [[Settings block]]. Click on Course administration to expand the sub menu. There have been several changes. [[Image:Course administration_2_expanded all.png|thumb|right|Course Administration expanded in 2.0]]
*[[Turn editing on]]
*Edit settings [[Course settings]] - new features added
*[[Course completion|Completion tracking]] - new feature
*User
**[[Enrolled users]] -new interface
**[[Enrolment|Enrolment methods]] - new interface
**[[Groups]]
**Permissions - see [[Roles and capabilities]]
***[[Check permissions]] - new feature
**[[Other users (course)|Other users]] - new feature
*Filters - [[Filters 2.0]] - new interface
*[[Grades]]
*Backup - [[Backup 2.0]] - new interface
*Restore - [[Restore 2.0]] - new interface
*Import - [[Import course data]] - new interface
*[[Reset course|Reset]] - more options
*Question bank
**Questions- links to [[Question bank]]
**[[Question categories|Categories]]
**[[Import questions|Import]]
**[[Export questions|Export]]
*[[Repositories]] - replaces Files

==See also==
*[[Site administration block]] for settings
**Under Courses to set [[Automated course backup]] for the entire site
**Under Front Page link in this block to manually backup the front page as you would a course

[[Category:Teacher]]
[[Category:Block]]

[[eu:Kudeaketa]]
[[fr:Bloc d'administration]]
[[ja:管理ブロック]]

Course administration block

2011-01-02T14:57:10Z

Rcollman: /* Moodle 2.0 changes */ Show image, list and put links - too busy??

{{Course admin}}

Most of the links in the administration block in a course are only visible and available to teachers of the course. Students see a course administration block with just two links - [[Profile]] and [[Grades]] (assuming "Show grades" is set to yes in the [[Course settings|course settings]]).

Please use the menu on the right to find more specifics about each course setting.

Features in the administration block allow teachers to manage [[Course settings]], [[Students | student]] and [[Teachers | teacher]] enrollments and their [[Groups | groups]], view the course [[Grades | gradebook]], create custom [[Scales | grading scales]] and access the Teacher forum. The teacher forum is a private forum only available to teachers of that course. It can be used to discuss the course content, the direction the course could take or even to attach files to that can be shared among the course teachers.

[[Image:Administration Block Course 1 9.JPG|left|thumb|Moodle 1.9 course administration block]]

==Common adjusted settings==

There are lots of possible ways to set up a course using blocks, but teachers may be particularly interested in [[Course_settings#Format | course formats]] which change how the course is presented to the learner. The weekly format is suitable for courses that have a clear start date and activities are presented in weekly blocks. Topic formatted courses are actually presented in a similar way but with the dates removed so activities can belong to general or specific areas of study. The social format doesn't use much content at all and is based around just one forum which is displayed on the main course page.

Another much used feature of the administration block is the [[Files]] link. From here you can upload any digital content for inclusion in an activity, resource, course section or for a direct download. These files can be moved, renamed, edited directly on the server (if they are HTML or text) or deleted. You can also create a directory and display the whole contents of that directory to course students using the add resource drop down in any course section.
Of course if your content resides out on the web then you don't need to upload the files at all - you can link directly to them from inside the course using the link to file or website option.

In the course homepage there is a white square icon on the top right of a [[Course_sections | section]] which can be used to expand and collapse sections. You can also use the lightbulb icon to mark a topic as current.

==Moodle 2.0 changes==
{{Moodle 2.0}}Course administration can be found as a sub menu in the [[Settings block]]. Click on Course administration to expand the sub menu. There have been several changes. [[Image:Course administration_2_expanded all.png|thumb|right|Course Administration expanded in 2.0]]
*[[Turn editing on]]
*Edit settings [[Course settings]] - new features added
*[[Completion tracking]] - new feature
*User
**[[Enrolled users]] -new interface
**[[Enrolment|Enrolment methods]] - new interface
**[[Groups]]
**Permissions - see [[Roles and capabilities]]
***[[Check permissions]] - new feature
**[[Other users (course)|Other users]] - new feature
*Filters - [[Filters 2.0]] - new interface
*[[Grades]]
*Backup - [[Backup 2.0]] - new interface
*Restore - [[Restore 2.0]] - new interface
*Import - [[Import course data]] - new interface
*[[Reset course|Reset]] - more options
*Question bank
**Questions- links to [[Question bank]]
**[[Question categories|Categories]]
**[[Import questions|Import]]
**[[Export questions|Export]]
*[[Repositories]] - replaces Files

==See also==
*[[Site administration block]] for settings
**Under Courses to set [[Automated course backup]] for the entire site
**Under Front Page link in this block to manually backup the front page as you would a course

[[Category:Teacher]]
[[Category:Block]]

[[eu:Kudeaketa]]
[[fr:Bloc d'administration]]
[[ja:管理ブロック]]

File:Course administration 2 expanded all.png

2011-01-02T14:46:46Z

Rcollman:

Other users (course)

2011-01-02T14:44:50Z

Rcollman: A new page in Moodle 2.0 under course>users>other users

{{Moodle 2.0}}
Other uses is a new category found in course administration>Users>Other users.
Not all users who have permissions in the course are enrolled, this page shows those users.

File:Course administration in settings block.png

2011-01-02T14:06:06Z

Rcollman:

Course administration block

2011-01-02T14:05:45Z

Rcollman: /* Moodle 2.0 changes */ place image as thumb left, edit

{{Course admin}}

Most of the links in the administration block in a course are only visible and available to teachers of the course. Students see a course administration block with just two links - [[Profile]] and [[Grades]] (assuming "Show grades" is set to yes in the [[Course settings|course settings]]).

Please use the menu on the right to find more specifics about each course setting.

Features in the administration block allow teachers to manage [[Course settings]], [[Students | student]] and [[Teachers | teacher]] enrollments and their [[Groups | groups]], view the course [[Grades | gradebook]], create custom [[Scales | grading scales]] and access the Teacher forum. The teacher forum is a private forum only available to teachers of that course. It can be used to discuss the course content, the direction the course could take or even to attach files to that can be shared among the course teachers.

[[Image:Administration Block Course 1 9.JPG|left|thumb|Moodle 1.9 course administration block]]

==Common adjusted settings==

There are lots of possible ways to set up a course using blocks, but teachers may be particularly interested in [[Course_settings#Format | course formats]] which change how the course is presented to the learner. The weekly format is suitable for courses that have a clear start date and activities are presented in weekly blocks. Topic formatted courses are actually presented in a similar way but with the dates removed so activities can belong to general or specific areas of study. The social format doesn't use much content at all and is based around just one forum which is displayed on the main course page.

Another much used feature of the administration block is the [[Files]] link. From here you can upload any digital content for inclusion in an activity, resource, course section or for a direct download. These files can be moved, renamed, edited directly on the server (if they are HTML or text) or deleted. You can also create a directory and display the whole contents of that directory to course students using the add resource drop down in any course section.
Of course if your content resides out on the web then you don't need to upload the files at all - you can link directly to them from inside the course using the link to file or website option.

In the course homepage there is a white square icon on the top right of a [[Course_sections | section]] which can be used to expand and collapse sections. You can also use the lightbulb icon to mark a topic as current.

==Moodle 2.0 changes==
{{Moodle 2.0}}Course administration can be found as a sub menu in the [[Settings block]]. Click on Course administration to expand the sub menu. Notice that "[[Repositories]]" has replaced Files in the menu. [[Image:Course administration_in_settings block.png|thumb|left|Course Administration expanded in 2.0]]

==See also==
*[[Site administration block]] for settings
**Under Courses to set [[Automated course backup]] for the entire site
**Under Front Page link in this block to manually backup the front page as you would a course

[[Category:Teacher]]
[[Category:Block]]

[[eu:Kudeaketa]]
[[fr:Bloc d'administration]]
[[ja:管理ブロック]]

Grade permissions

2011-01-02T13:35:30Z

Rcollman: format

{{Grades}}The capability permissions concerning Grades and gradebook have been expanded for [[Roles]]. They appear in several places. The list below is for Site administrators.

==Gradebook capabilities==
*[[Capabilities/gradeexport/ods:view|gradeexport/ods:view]]
*[[Capabilities/gradeexport/ods:publish|gradeexport/ods:publish]]
*[[Capabilities/gradeexport/txt:view|gradeexport/txt:view]]
*[[Capabilities/gradeexport/txt:publish|gradeexport/txt:publish]]
*[[Capabilities/gradeexport/xls:view|gradeexport/xls:view]]
*[[Capabilities/gradeexport/xls:publish|gradeexport/xls:publish]]
*[[Capabilities/gradeexport/xml:view|gradeexport/xml:view]]
*[[Capabilities/gradeexport/xml:publish|gradeexport/xml:publish]]
*[[Capabilities/gradeimport/csv:view|gradeimport/csv:view]]
*[[Capabilities/gradeimport/xml:view|gradeimport/xml:view]]
*[[Capabilities/gradeimport/xml:publish|gradeimport/xml:publish]]
*[[Capabilities/gradereport/grader:view|gradereport/grader:view]]
*[[Capabilities/gradereport/outcomes:view|gradereport/outcomes:view]]
*[[Capabilities/gradereport/overview:view|gradereport/overview:view]]
*[[Capabilities/gradereport/user:view|gradereport/user:view]]

==Course capabilities==
*[[Capabilities/moodle/grade:viewall|moodle/grade:viewall]]
*[[Capabilities/moodle/grade:view|moodle/grade:view]]
*[[Capabilities/moodle/grade:viewhidden|moodle/grade:viewhidden]]
*[[Capabilities/moodle/grade:import|moodle/grade:import]]
*[[Capabilities/moodle/grade:export|moodle/grade:export]]
*[[Capabilities/moodle/grade:manage|moodle/grade:manage]]
*[[Capabilities/moodle/grade:edit|moodle/grade:edit]]
*[[Capabilities/moodle/grade:manageoutcomes|moodle/grade:manageoutcomes]]
*[[Capabilities/moodle/grade:manageletters|moodle/grade:manageletters]]
*[[Capabilities/moodle/grade:hide|moodle/grade:hide]]
*[[Capabilities/moodle/grade:lock|moodle/grade:lock]]
*[[Capabilities/moodle/grade:unlock|moodle/grade:unlock]]

==Module capabilities==
*[[Capabilities/mod/assignment:grade|mod/assignment:grade]]
*[[Capabilities/mod/hotpot:grade|mod/hotpot:grade]]
*[[Capabilities/mod/quiz:grade|mod/quiz:grade]]

==See also==

*[[Simplifying the gradebook by changing permissions]]

[[Category:Roles]]

[[eu:Kalifikazioen_baimenak]]
[[fr:Permissions des notes]]
[[de:Bewertungen-Rechte]]
[[ja:評定パーミッション]]

Grade permissions

2011-01-02T13:35:08Z

Rcollman: Intro, make sure it is clear this is site admin

{{Grades}} The capability permissions concerning Grades and gradebook have been expanded for [[Roles]]. They appear in several places. The list below is for Site administrators.

==Gradebook capabilities==
*[[Capabilities/gradeexport/ods:view|gradeexport/ods:view]]
*[[Capabilities/gradeexport/ods:publish|gradeexport/ods:publish]]
*[[Capabilities/gradeexport/txt:view|gradeexport/txt:view]]
*[[Capabilities/gradeexport/txt:publish|gradeexport/txt:publish]]
*[[Capabilities/gradeexport/xls:view|gradeexport/xls:view]]
*[[Capabilities/gradeexport/xls:publish|gradeexport/xls:publish]]
*[[Capabilities/gradeexport/xml:view|gradeexport/xml:view]]
*[[Capabilities/gradeexport/xml:publish|gradeexport/xml:publish]]
*[[Capabilities/gradeimport/csv:view|gradeimport/csv:view]]
*[[Capabilities/gradeimport/xml:view|gradeimport/xml:view]]
*[[Capabilities/gradeimport/xml:publish|gradeimport/xml:publish]]
*[[Capabilities/gradereport/grader:view|gradereport/grader:view]]
*[[Capabilities/gradereport/outcomes:view|gradereport/outcomes:view]]
*[[Capabilities/gradereport/overview:view|gradereport/overview:view]]
*[[Capabilities/gradereport/user:view|gradereport/user:view]]

==Course capabilities==
*[[Capabilities/moodle/grade:viewall|moodle/grade:viewall]]
*[[Capabilities/moodle/grade:view|moodle/grade:view]]
*[[Capabilities/moodle/grade:viewhidden|moodle/grade:viewhidden]]
*[[Capabilities/moodle/grade:import|moodle/grade:import]]
*[[Capabilities/moodle/grade:export|moodle/grade:export]]
*[[Capabilities/moodle/grade:manage|moodle/grade:manage]]
*[[Capabilities/moodle/grade:edit|moodle/grade:edit]]
*[[Capabilities/moodle/grade:manageoutcomes|moodle/grade:manageoutcomes]]
*[[Capabilities/moodle/grade:manageletters|moodle/grade:manageletters]]
*[[Capabilities/moodle/grade:hide|moodle/grade:hide]]
*[[Capabilities/moodle/grade:lock|moodle/grade:lock]]
*[[Capabilities/moodle/grade:unlock|moodle/grade:unlock]]

==Module capabilities==
*[[Capabilities/mod/assignment:grade|mod/assignment:grade]]
*[[Capabilities/mod/hotpot:grade|mod/hotpot:grade]]
*[[Capabilities/mod/quiz:grade|mod/quiz:grade]]

==See also==

*[[Simplifying the gradebook by changing permissions]]

[[Category:Roles]]

[[eu:Kalifikazioen_baimenak]]
[[fr:Permissions des notes]]
[[de:Bewertungen-Rechte]]
[[ja:評定パーミッション]]

Gradebook report settings

2011-01-02T13:29:47Z

Rcollman: This page links from the admin area of the grades template

{{Grades}}The gradebook report settings determine the appearance of gradebook reports in all courses on the site. The site administrator will find the default and enabled/disabled settings in the administration area. There have been some additions and format changes in Moodle 2.0.

Teachers can use the [[Grader report preferences|"My report preferences"]] link in any course to essentially change their defaults and the way a report will display. These preferences become the new defaults for that teacher until they are changed by the teacher.

==Grader report settings==
[[Image:Grader report settings.png|thumb|Grader report settings]]Location: ''Administration > Grades > Report settings > Grader report''

Grader report settings include whether to show calculations, show/hide icons, column averages etc. Individual teachers may override certain settings for their own grader report view via their [[Grade preferences|"My report preferences"]] tab.

===Quick grading and quick feedback===

*Quick grading adds a text input element in each grade cell on the grader report, allowing you to edit the feedback for many grades at once. You can then click the Update button to perform all these changes at once, instead of one at a time.
*Quick feedback adds a text input element in each grade cell on the grader report, allowing you to edit many grades at once. You can then click the Update button to perform all these changes at once, instead of one at a time.
*By default, both quick grading and quick feedback are enabled. They can be disabled by de-selecting the appropriate checkbox.
[[Image:Gradebook horizontal scrollbar.png|thumb|Grader report with horizontal scrollbar]]
===Static students column===

In Moodle 1.9.5 onwards, a static students column may be enabled so that teachers can scroll grades in the [[Grader report|grader report]] using a horizontal scrollbar. (Note that this feature is not available for IE6 users or for users who have have the screenreader setting in their profile set to Yes.)

==Overview report settings==
Location: ''Administration > Grades > Report settings > Overview report''

The overview report setting may be overridden for all overview reports in a course by a teacher in the [[Gradebook course settings|course settings]].

===Show rank===

If the show rank checkbox is ticked, the position of a grade item in relation to the rest of the class will be shown.

==User report settings==
Location: ''Administration > Grades > Report settings > User report''

The user report settings may be overridden for all user reports in a course by a teacher in the [[Gradebook course settings|course settings]].

===Show rank===

If the show rank checkbox is ticked, the position of a grade item in relation to the rest of the class will be shown.

===Show percentage===

If the show percentage checkbox (in Moodle 1.9.3 onwards) is ticked, the percentage value of each grade item will be shown.

==See also==

*[[Grade preferences]] - for teachers to set their personal preferences for how the grader report is displayed
*[[Gradebook course settings]]

[[Category:Grades]]

[[de:Einstellungen_für_die_Bewertungsübersicht]]
[[eu:Kalifikazio-liburuaren_txostenen_ezarpenak]]
[[fr:Réglages du rapport de l'évaluateur]]
[[ja:評定表レポート設定]]

Grade item settings

2011-01-02T13:18:33Z

Rcollman: /* Advanced grade item options */ delete picture, compress list

{{Grades}}Location: ''Administration > Grades > Grade item settings''
[[Image:Grade item settings.png|thumb|Grade item settings screen]]

Grade item settings are the various settings that the administrator is able to edit for all [[Gradebook|gradebooks]] used by teachers. These settings will change what items are displayed for each grade. As administrator, you would turn on or off various settings and the teacher would input the actual data.

==Grade display type==

This is the type of grade that is to be shown for each individual grade. Different school districts use different grading systems so this can be changed to suit your district.

* Real - Grade from minimum to maximum range indicating total points received. Default from 0-100 but may be arbitrary.
* Percentage - Grade from 0 - 100% indicating the total points received divided by maximum possible amount times 100.
* [[Grade letters|Letter]]- Grade in the form of a letter representing a range of percentages.

==Overall decimal points==

This setting is for display purposes only. Grade calculations are made with an accuracy of 5 decimal places and grade letters, if used, are assigned accordingly.

If rounding of grades in [[Grade calculations|grade calculations]] is required, the round(number, count) function may be used.

==Old Version for advanced grade item options==
Older versions of Moodle contained a list of various fields that can be toggled on or off to appear on the default grade item screen or hidden. By selecting a field, it is put into the "Advanced" items menu and a field that is not selected will appear on the main grade item menu by default. Note that all of these options will always be available to teachers with a click of the button "Show Advanced".

To highlight more than one field, use ctrl+click and both will be highlighted. To highlight from one field to another, use shift+click the range between two will be highlighted. Shift+ctrl+right click will combine a range of selections to those already highlighted. To de-highlight a field just do the same steps but click on already highlighted fields.
{| style="width:75%" border="0"
|
* Item info
* ID Number
* Grade Type
* Scale
* Minimum Grade
* Maximum Grade
||
* Grade to pass
* Offset
* Multiplicator
* Grade display type
* Overall decimal places
||
* Hidden
* Hidden until
* Locked
* Locked after
* Aggregation coefficient
* Parent category
|-
|}

==See also==
*[[Grade items]] - for teachers
*[http://www.moodletutorials.org/view_video.php?viewkey=d7fbdea1afc51c7c6ad2 Video tutorial on Grade Item Setting and Grade Letters]

[[de:Einstellungen_für_Bewertungsaspekte]]
[[fr:Réglages des éléments d'évaluation]]
[[ja:評定項目設定]]

Talk:Grade item settings

2011-01-02T12:52:43Z

Rcollman: Where are advanced settings in 1.9.9 and 2.0

File picker FAQ

2011-01-02T12:12:52Z

Rcollman: /* What is the private folder? */ fix link

{{stub}}
The File picker is new to Moodle 2.0. Here are some common question of old and new users about this feature.

==Can I move items around in the File Picker?==
No. Moodle associates files with activities. You need to navigate to these activities to link to them.

==How can I create shared folders of common files for others to access?==
*When creating a folder of files using "add a resource>folder" the files are then visible and editable to other teachers in the course. The resource can be hidden with the "eye" icon to keep it out of student view.
*Another method to create and share files and folders out of site of students is to use[[Legacy_course_files]] which replicate the course files system of Moodle 1.9 but which are disabled by default in 2.0 owing to security reasons. See [[Legacy_course_files]] for more informatio about the risks involved and also how to enable them.

==I've just uploaded a file. Now I cannot see it when I want to use it somewhere else. Why is this?==
One option: It seems that if you choose the copyright "All Rights Reserved" it is not available to others.

==What is the private folder?==
The [[Private_files]] link is visible in the file picker if the admin has enabled it in [[Site_administration_menu_2.0]]>plugins>repositiories>manage repositories.
If this is the case then a user will have a link in their profile settings (and, if added, in a side block) to a personal area into which they can upload files and organise folders.
The uploaded files and folders may then be selected from the [[Private_files]] link in the file picker.

==See also==
[[File picker]]

[[Repositories]]
[[Category:Files]]
[[Category:FAQ]]

Grade category settings

2011-01-01T17:18:06Z

Rcollman: reformat new image, add so all 8 settings are show. We could turn those into bullets.

{{Grades}}Location: ''Administration > Grades > Grade Category Settings''

Grade category settings enable administrators to choose which options appear for teachers when [[Grade categories|adding/editing a grade category]] in their course gradebook, and their default values. Settings are applied site-wide.

There are 2 check boxes next to most features on this page. The "Force" check box eliminates any options the teacher will see. For example, the teacher will only see and be able to use the "mean of all grades" as an aggregation. The "Advanced" checkbox will hide the specific feature until the "Show advanced" button is used by the teacher. This will reduce initial menu choices for teachers but allow them to see them if they wish.

[[Image:Grade category settings.png|thumb|100px|left|]]
==Hide forced settings==
The default is to show the forced settings (see below). If these are not to be used check this box to hide them. Unchecking the "Force" setting will simply restore each category's setting to its previous state, prior to the application of the forced global setting. Administrators can thus experiment with these settings without fear of losing any specific category settings.

==Aggregation settings==
Select the type of aggregation method from a pulldown menu from 1 of 9 choices. However there are two check boxes which will effect this default, in addition to the Hide forced settings.

The "Force" checkbox only allows the selected aggregation method to apply. This results in switches and drop-down elements being disabled in all course gradebooks. For example, if the Aggregation Type setting is forced as "Mean", teachers will no longer have the option to change the aggregation type of each grade category separately, the option will not be there in the category edit form.

==Available aggregation types==
[[Image:Available agg types.png|thumb|Available aggregation types setting]]
In Moodle 1.9.5 onwards, administrators may reduce the number of aggregation types available for teachers to use.

By default, all existing aggregation types are available (Mean of grades, Weighted mean of grades, Simple weighted mean of grades, Mean of grades (with extra credits), Median of grades, Lowest grade, Highest grade, Mode of grades, Sum of grades). This list may be reduced to only a few types, with additional types being enabled as/when teachers request them.

Note that reducing the number of aggregation types simply results in disabled aggregation types not appearing in the aggregation type dropdown menu. All existing grade category calculations remain the same, regardless of whether the aggregation type is later disabled by an administrator.

==Aggregate only non-empty grades==
The default is no.

==Include outcomes in aggregation==
The default is no.

==Aggregate including subcategories==
The default is no. Yes will include subcategory grades in the aggregation.

==Keep the highest==
Keeps only the X number of highest grades in the report

==Drop the lowest==
Drops the lowest X number of grades from the report.

==See also==
*[[Grade categories]] - for teachers
*[http://www.youtube.com/watch?v=p6zWwJGb9TA Video demonstrating how to use gradebook site settings and defaults]
*[http://www.youtube.com/watch?v=sUslTuZPu6A Video showing the effects of the grade category settings]

[[Category:Grades]]

[[de:Einstellungen_für_Bewertungskategorien]]
[[fr:Réglages des catégories d'évaluation]]
[[ja:評定カテゴリ設定]]

File:Grade category settings.png

2011-01-01T16:41:03Z

Rcollman: uploaded a new version of "Image:Grade category settings.png": Edited image from 1.9.1 to remove the details because showed only 4 of 8.

General grade settings

2011-01-01T16:33:11Z

Rcollman: delete image , not helpful as instruction, found another "you".

{{Grades}}Location: ''Administration > Grades > General settings''

General grade settings allow the site administrator to set site defaults, and to enable or disable the graded roles, outcomes, scales in aggregated grades, publishing grades or unlimiting grades features. These settings are site-wide settings that will affect all [[Gradebook|gradebooks]] used by all teachers.

==Graded Roles==
Graded roles are the type of user that will appear in the gradebook. Sometimes various users will be graded for various purposes. Most of the time "student" is the only one needed.

:Note: a site must select '''at least''' one role that can be graded.

==Enable outcomes==
{{Moodle 1.9}}
[[Outcomes]] allow grading of activities according to a "scale", instead of a numeric score. It is new in Moodle 1.9. The default site setting is "no". Check the box to enable this feature. Teachers will now be able to implement outcomes into their gradebooks.

==User profile report==
The default user profile report setting has just one option, [[User report]], unless a custom user report has been added to the site.

User reports are available for teachers via students' profiles by following the grade link in the "Activity reports" tab. Alternatively, teachers can view the user reports for all or selected students in the course by selecting "User report" in the gradebook dropdown menu.

==Aggregation position==
Aggregation position default is either the first or last column.

==Include scales in aggregation==
Scales can be included as numbers in all aggregated grades across all gradebooks in all courses. Changing this setting will force all aggregated grades to be recalculated.

If this is checked (and it is by default) then all custom scales will have a corresponding value that is assigned based on the number of options in the scale (ie. three values will have values of 1,2,3) and this will be included in the grade aggregation.

==Show submitted date for hidden grades==
When a grade is hidden from the user, the default setting shows a dash (-) mark, Enable this to show the date that the grade was submitted rather than a dash for a hidden grade

==Enable publishing==
[[Image:Grade publishing settings.png|thumb|Grade publishing settings]]
Grade publishing is a way of importing and exporting grades via a URL without being logged in to Moodle. Grade publishing is intended for administrators only. Security implications should be thoroughly considered before allowing non-admin users to publish grades.

Grade publishing may be enabled by checking the gradepublishing box. If enabled, administrators are provided with [[Grade export|grade export]] publishing settings in each course gradebook.

==Grade export display type==
This is the default setting for exporting grades. A user may select a different setting.

* Real - Grade from minimum to maximum range indicating total points received. Default from 0-100 but may be arbitrary.
* Percentage - Grade from 0 - 100% indicating the total points received divided by maximum possible amount times 100.
* [[Grade letters|Letter]]- Grade in the form of a letter representing a range of percentages.

Note: Teachers can edit the actual display type right before export.

==Grade export decimal points==

During the export process, this is the default number of decimal places for all grades that is to be shown. Number of decimal places range from 0-5. This number can be changed by the teacher.

==Primary grade export methods==
The default method of export which will show at the time of export. The default is none and that setting forces the user to select one of the export types:

* ods (OpenOffice spreadsheet)
* txt (Plain text file)
* xls (Excel spreadsheet)
* xml (Extensible Markup Language file)

==Navigation method==
[[Image:gradebook tabs navigation.png|thumb|Tabs navigation]]
In some versions of Moodle, tabs navigation of the gradebook may be enabled in addition to/instead of the existing drop down menu in a course.

==Unlimited grades==
In Moodle 1.9.5 onwards, teachers can enter grades over 100% directly in the gradebook if the ''unlimitedgrades'' setting is enabled.

[[Category:Administrator]]

[[es:Ajustes_generales_de_las_calificaciones]]
[[de:Grundeinstellungen_für_Bewertungen]]
[[fr:Réglages généraux des notes]]
[[ja:一般評定設定]]

General grade settings

2011-01-01T16:29:09Z

Rcollman: Review with 1.9 and 2.0 minor language changes used "default" and "enabled" consistantly

{{Grades}}Location: ''Administration > Grades > General settings''
[[Image:Grade Settings.png|right|thumb|General Grade Settings page Moodle 1.9.x]]

General grade settings allow the site administrator to set site defaults, and to enable or disable the graded roles, outcomes, scales in aggregated grades, publishing grades or unlimiting grades features. These settings are site-wide settings that will affect all [[Gradebook|gradebooks]] used by all teachers.

==Graded Roles==
Graded roles are the type of user that you want to appear in the gradebook. Sometimes various users will be graded for various purposes. Most of the time "student" is the only one needed.

:Note: a site must select '''at least''' one role that can be graded.

==Enable outcomes==
{{Moodle 1.9}}
[[Outcomes]] allow grading of activities according to a "scale", instead of a numeric score. It is new in Moodle 1.9. The default site setting is "no". Check the box to enable this feature. Teachers will now be able to implement outcomes into their gradebooks.

==User profile report==
The default user profile report setting has just one option, [[User report]], unless a custom user report has been added to the site.

User reports are available for teachers via students' profiles by following the grade link in the "Activity reports" tab. Alternatively, teachers can view the user reports for all or selected students in the course by selecting "User report" in the gradebook dropdown menu.

==Aggregation position==
Aggregation position default is either the first or last column.

==Include scales in aggregation==
Scales can be included as numbers in all aggregated grades across all gradebooks in all courses. Changing this setting will force all aggregated grades to be recalculated.

If this is checked (and it is by default) then all custom scales will have a corresponding value that is assigned based on the number of options in the scale (ie. three values will have values of 1,2,3) and this will be included in the grade aggregation.

==Show submitted date for hidden grades==
When a grade is hidden from the user, the default setting shows a dash (-) mark, Enable this to show the date that the grade was submitted rather than a dash for a hidden grade

==Enable publishing==
[[Image:Grade publishing settings.png|thumb|Grade publishing settings]]
Grade publishing is a way of importing and exporting grades via a URL without being logged in to Moodle. Grade publishing is intended for administrators only. Security implications should be thoroughly considered before allowing non-admin users to publish grades.

Grade publishing may be enabled by checking the gradepublishing box. If enabled, administrators are provided with [[Grade export|grade export]] publishing settings in each course gradebook.

==Grade export display type==
This is the default setting for exporting grades. A user may select a different setting.

* Real - Grade from minimum to maximum range indicating total points received. Default from 0-100 but may be arbitrary.
* Percentage - Grade from 0 - 100% indicating the total points received divided by maximum possible amount times 100.
* [[Grade letters|Letter]]- Grade in the form of a letter representing a range of percentages.

Note: Teachers can edit the actual display type right before export.

==Grade export decimal points==

During the export process, this is the default number of decimal places for all grades that is to be shown. Number of decimal places range from 0-5. This number can be changed by the teacher.

==Primary grade export methods==
The default method of export which will show at the time of export. The default is none and that setting forces the user to select one of the export types:

* ods (OpenOffice spreadsheet)
* txt (Plain text file)
* xls (Excel spreadsheet)
* xml (Extensible Markup Language file)

==Navigation method==
[[Image:gradebook tabs navigation.png|thumb|Tabs navigation]]
In some versions of Moodle, tabs navigation of the gradebook may be enabled in addition to/instead of the existing drop down menu in a course.

==Unlimited grades==
In Moodle 1.9.5 onwards, teachers can enter grades over 100% directly in the gradebook if the ''unlimitedgrades'' setting is enabled.

[[Category:Administrator]]

[[es:Ajustes_generales_de_las_calificaciones]]
[[de:Grundeinstellungen_für_Bewertungen]]
[[fr:Réglages généraux des notes]]
[[ja:一般評定設定]]

Grader report preferences

2011-01-01T15:57:21Z

Rcollman: One Moodle doc page for teachers and administrators. This is for teachers :)

{{Grades}}Teachers can set their preferences for the grader report using the "My report preferences" or "My preferences tab via the Grades>Grader report. These settings will apply to all courses for that teacher. The teacher may change them at any time.

The teacher sees the settings grouped under 3 headings. There is an "Advanced settings" button.

An administrator can set the initial defaults for all teachers through Site Administration>Grades>Report settings>Grader reports. The settings are arranged differently than the teacher's settings.

[[Image:Grade preferences.png|thumb|Grade preferences]]

==General settings==

===Aggregation view===
Options are:
*Report default (set by an administrator for all courses on the site)
*Full view - all grades and totals are displayed
*Aggregates only - only category and course totals are displayed
*Grades only

The aggregation view can also be controlled from the grader report using the <code>-</code>, <code>+</code> or <code>o</code> buttons next to the course title.

===Quick grading===
This will make the grader report appear with editable boxes for each grade, so you can change them quickly for many students.

===Quick feedback===
This does the same, but for the typed feedback.

===Students per page===
This sets the number of students displayed per page in the grader report. If left empty, the site default (set by an administrator) is used.

===Aggregation position===
Sets the position for the aggregation total column as first or last (Advanced)

==Show/hide toggles==
A teacher can change their preferences for
*Show calculations
*Show show/hide icons
*Show column averages
*Show groups
*Show locks
*Show user profile images
*Show user idnumber
*Show activity icons
*Show ranges

==Special rows==
*Range display type (Advanced)
*Decimals shown in ranges (Advanced)
*Column averages display type (Advanced)
*Decimals in column averages (Advanced)
*Grades selected for column averages
*Show number of grades in averages

==Change site report defaults link (Administrators only)==
Administrators, on this page, will see "Change report defaults" link, at the top right of the grade preferences page. This will take them to the site administration [[Gradebook report settings|Grader report settings]] where they may change the default links for the site. This will not override any settings that individual teachers have set as a preference.

==See also==

*[http://www.youtube.com/watch?v=jWPUEqdhI4A Video showing how to change the display of grades in the gradebook]

[[ca:grade/report/grader/preferences]]
[[eu:Kalifikazioen_hobespenak]]
[[fr:Préférences du rapport de l'évaluateur]]
[[ja:評定プリファレンス]]

Grader report preferences

2011-01-01T15:47:29Z

Rcollman: /* Change report defaults */ change heading name, does not change teacher preferences

{{Grades}}Teachers can set their preferences for the grader report using the "My report preferences" or "My preferences tab via the Grades>Grader report. These settings will apply to all courses for that teacher. The teacher may change them at any time.

The settings are grouped under 3 headings. Moodle 2.0 and earlier versions of 1.9.x are similar. Both have an advanced setting.

[[Image:Grade preferences.png|thumb|Grade preferences]]

==General settings==

===Aggregation view===
Options are:
*Report default (set by an administrator for all courses on the site)
*Full view - all grades and totals are displayed
*Aggregates only - only category and course totals are displayed
*Grades only

The aggregation view can also be controlled from the grader report using the <code>-</code>, <code>+</code> or <code>o</code> buttons next to the course title.

===Quick grading===
This will make the grader report appear with editable boxes for each grade, so you can change them quickly for many students.

===Quick feedback===
This does the same, but for the typed feedback.

===Students per page===
This sets the number of students displayed per page in the grader report. If left empty, the site default (set by an administrator) is used.

===Aggregation position===
Sets the position for the aggregation total column as first or last (Advanced)

==Show/hide toggles==
A teacher can change their preferences for
*Show calculations
*Show show/hide icons
*Show column averages
*Show groups
*Show locks
*Show user profile images
*Show user idnumber
*Show activity icons
*Show ranges

==Special rows==
*Range display type (Advanced)
*Decimals shown in ranges (Advanced)
*Column averages display type (Advanced)
*Decimals in column averages (Advanced)
*Grades selected for column averages
*Show number of grades in averages

==Change site report defaults link (Administrators only)==
Administrators, on this page, will see "Change report defaults" link, at the top right of the grade preferences page. This will take them to the site administration [[Gradebook report settings|Grader report settings]] where they may change the default links for the site. This will not override any settings that individual teachers have set as a preference.

==See also==

*[http://www.youtube.com/watch?v=jWPUEqdhI4A Video showing how to change the display of grades in the gradebook]

[[ca:grade/report/grader/preferences]]
[[eu:Kalifikazioen_hobespenak]]
[[fr:Préférences du rapport de l'évaluateur]]
[[ja:評定プリファレンス]]

Grader report preferences

2011-01-01T15:45:07Z

Rcollman: add other 2 sub headings for teachers

{{Grades}}Teachers can set their preferences for the grader report using the "My report preferences" or "My preferences tab via the Grades>Grader report. These settings will apply to all courses for that teacher. The teacher may change them at any time.

The settings are grouped under 3 headings. Moodle 2.0 and earlier versions of 1.9.x are similar. Both have an advanced setting.

[[Image:Grade preferences.png|thumb|Grade preferences]]

==General settings==

===Aggregation view===
Options are:
*Report default (set by an administrator for all courses on the site)
*Full view - all grades and totals are displayed
*Aggregates only - only category and course totals are displayed
*Grades only

The aggregation view can also be controlled from the grader report using the <code>-</code>, <code>+</code> or <code>o</code> buttons next to the course title.

===Quick grading===
This will make the grader report appear with editable boxes for each grade, so you can change them quickly for many students.

===Quick feedback===
This does the same, but for the typed feedback.

===Students per page===
This sets the number of students displayed per page in the grader report. If left empty, the site default (set by an administrator) is used.

===Aggregation position===
Sets the position for the aggregation total column as first or last (Advanced)

==Show/hide toggles==
A teacher can change their preferences for
*Show calculations
*Show show/hide icons
*Show column averages
*Show groups
*Show locks
*Show user profile images
*Show user idnumber
*Show activity icons
*Show ranges

==Special rows==
*Range display type (Advanced)
*Decimals shown in ranges (Advanced)
*Column averages display type (Advanced)
*Decimals in column averages (Advanced)
*Grades selected for column averages
*Show number of grades in averages

==Change report defaults==
Administrators, on this page, will see "Change report defaults" link, at the top right of the grade preferences page. This will take them to the site administration [[Gradebook report settings|Grader report settings]].

==See also==

*[http://www.youtube.com/watch?v=jWPUEqdhI4A Video showing how to change the display of grades in the gradebook]

[[ca:grade/report/grader/preferences]]
[[eu:Kalifikazioen_hobespenak]]
[[fr:Préférences du rapport de l'évaluateur]]
[[ja:評定プリファレンス]]

Talk:Grader report preferences

2011-01-01T15:18:29Z

Rcollman: /* Differences in versions */ Ah, in 1.9.1 but not in 1.9.5 interesting

==Differences in versions==
My overview for M2. "Grader report preferences" is the page to explain to the teacher those report settings that they can change.

These essentially become a teacher's personal report settings for all grader reports in any course they teach. Thus if a teacher wants to see a grader report one way in course A and another way in course B, they will have to change "My preferences". This is different than the site preferences for the grader report, which sets the initial defaults for all teachers.

I can see these settings in 1.9.1. However, (could be me) I can not see them on my 1.9.5 and 1.9.9+ (Build: 20101013) localhost because there is no tab and nothing in the dropdown menu in the upper left. Evidently the teacher preferences was improved/expanded in 1.9.1 then dropped completely by 1.9.5. It this correct?

In 2.0 a teacher can use "My preferences" tab or the "My preferences" link in the Course administration>Course grade settings>Grader report to set any of 14 variables. The site administrator sees these plus a 5 more under Grades>Report settings>Grader report in a long un-grouped list. The teacher has their preferences listed under 3 headings: Show/hide toggles, Special rows, and General. I like the teacher's headings and will suggest that the site admin be rearranged.

I wanted to set out the overview for others to double check my thinking. I will make a note about some versions of 1.9 but will move onto 2.0 instructions, which will cover those for 1.9.1. --[[User:chris collman|chris collman]] 15:18, 1 January 2011 (UTC)

Talk:Grader report preferences

2011-01-01T15:04:08Z

Rcollman: Major questions about this page re 1.9. Want to change for 2.0

==Differences in versions==
My overview for M2. "Grader report preferences" is the page to explain to the teacher those report settings that they can change.

These essentially become a teacher's personal report settings for all grader reports in any course they teach. Thus if a teacher wants to see a grader report one way in course A and another way in course B, they will have to change "My preferences". This is different than the site preferences for the grader report, which sets the initial defaults for all teachers.

I checked my 1.9.5 and 1.9.9+ (Build: 20101013) localhost and I do not see where a teacher can set their own preferences. I can set a "Set preferences" tab with 2 settings in a 1.8.9. Evidently the teacher preferences was improved/expanded in 1.9 then dropped completely by 1.9.5. Which is to say, I am confused by the 1.9 instructions.

In 2.0 a teacher can use "My preferences" tab or the "My preferences" link in the Course administration>Course grade settings>Grader report to set any of 14 variables. The site administrator sees these plus a 5 more under Grades>Report settings>Grader report in a long un-grouped list. The teacher has their preferences listed under 3 headings: Show/hide toggles, Special rows, and General. I like the teacher's headings and will suggest that the site admin be rearranged.

I wanted to set out the overview for others to double check my thinking. I would like to drop the 1.9 and add 2.0, then reorganize this page as outline above. --[[User:chris collman|chris collman]] 15:04, 1 January 2011 (UTC)

Gradebook report settings

2011-01-01T14:07:32Z

Rcollman: Rewrite intro, sliding into M2 and away from pre 1.9.5

{{Grades}}The gradebook report settings determine the appearance of gradebook reports in all courses on the site. There have been several additional settings in Moodle 2.0.

Teachers can use the [[Grader report preferences|"My report preferences"]] link in any course to essentially change the defaults and the way a report will display. These preferences become the new defaults for that teacher until they are changed by the teacher.

==Grader report settings==
[[Image:Grader report settings.png|thumb|Grader report settings]]Location: ''Administration > Grades > Report settings > Grader report''

Grader report settings include whether to show calculations, show/hide icons, column averages etc. Individual teachers may override certain settings for their own grader report view via their [[Grade preferences|"My report preferences"]] tab.

===Quick grading and quick feedback===

*Quick grading adds a text input element in each grade cell on the grader report, allowing you to edit the feedback for many grades at once. You can then click the Update button to perform all these changes at once, instead of one at a time.
*Quick feedback adds a text input element in each grade cell on the grader report, allowing you to edit many grades at once. You can then click the Update button to perform all these changes at once, instead of one at a time.
*By default, both quick grading and quick feedback are enabled. They can be disabled by de-selecting the appropriate checkbox.
[[Image:Gradebook horizontal scrollbar.png|thumb|Grader report with horizontal scrollbar]]
===Static students column===

In Moodle 1.9.5 onwards, a static students column may be enabled so that teachers can scroll grades in the [[Grader report|grader report]] using a horizontal scrollbar. (Note that this feature is not available for IE6 users or for users who have have the screenreader setting in their profile set to Yes.)

==Overview report settings==
Location: ''Administration > Grades > Report settings > Overview report''

The overview report setting may be overridden for all overview reports in a course by a teacher in the [[Gradebook course settings|course settings]].

===Show rank===

If the show rank checkbox is ticked, the position of a grade item in relation to the rest of the class will be shown.

==User report settings==
Location: ''Administration > Grades > Report settings > User report''

The user report settings may be overridden for all user reports in a course by a teacher in the [[Gradebook course settings|course settings]].

===Show rank===

If the show rank checkbox is ticked, the position of a grade item in relation to the rest of the class will be shown.

===Show percentage===

If the show percentage checkbox (in Moodle 1.9.3 onwards) is ticked, the percentage value of each grade item will be shown.

==See also==

*[[Grade preferences]] - for teachers to set their personal preferences for how the grader report is displayed
*[[Gradebook course settings]]

[[Category:Grades]]

[[de:Einstellungen_für_die_Bewertungsübersicht]]
[[eu:Kalifikazio-liburuaren_txostenen_ezarpenak]]
[[fr:Réglages du rapport de l'évaluateur]]
[[ja:評定表レポート設定]]