MoodleDocs - User contributions [en]

Wiki settings

2014-06-05T02:48:18Z

Cttxg: Adding MoodleBites YouTube video link

{{Wiki}}

==Adding a wiki==
*With the editing turned on, in the section you wish to add your wiki, click the "Add an activity or resource" link (or, if not present, the "Add an activity" drop down menu )and choose ''Wiki''.
*This will take you to the wiki settings page titled "Adding a new wiki". All settings may expanded by clicking the "Expand all" link top right.
*In an existing wiki, the wiki settings can be found in ''Administration > Wiki administration > Edit settings''.

==General==
{|
|[[File:wikigeneral25.png|thumb|General settings expanded by default]]
|}

===Wiki name===
*The name you give to your wiki here will appear as the link on the course page for your students to click.

===Wiki description===
*Explain the purpose of your wiki here. (This description may or may not be compulsory depending on your admin's settings.)
====Display description on course page====

If this box is checked, then the description you added above will appear with the wiki link on the course page.

===Wiki mode===
*Choose between "Individual wiki" where each student gets their own, or "Collaborative wiki" where students work together on a single wiki.
===First page name===
*The name you add here will form the first page of your new wiki. It is a required field and once a name has been entered,it can't be changed.
==Format==
(These settings are collapsed by defaul)
{|
|[[File:wikiformat25.png|thumb|Wiki format settings expanded]]
|}

===Default format===
*Set the default type of editing your wiki will use. Chooose from
**HTML - editing using the normal text editor
**Creole - a popular wiki editing language. If this is selected, a small editing toolbar will appear.
[[File:creolenwiki.png]]
**NWiki - a wiki editing language used in the contributed NWiki module.

===Force format===
If you check this box then students cannot choose their own method of editing the wiki.
==Common module settings==
See [[Common module settings]]
==Restrict access/Activity completion==
(These settings are collapsed by default)

These settings are visible if [[Conditional activities]] and [[Activity completion]] have been enabled in the site and the course.

==Locally assigned roles==

In ''Administration> Wiki administration > Locally assigned roles'' selected users can be given additional roles in the activity.

==Wiki permissions==

Role permissions for the activity can be changed in ''Administration > Wiki administration > Permissions''.

==See also==
*[http://youtu.be/293p7T55OHA MoodleBites for Teachers - Moodle 2.0 Wiki (part 1)] MoodleBites video on YouTube
*[http://youtu.be/AXPPUbv-b3Y MoodleBites for Teachers - Moodle 2.0 Wiki (part 2)] MoodleBites video on YouTube

[[fr:Ajouter/modifier un wiki]]
[[de:Wiki anlegen]]
[[ja:Wikiを追加/編集する]]

Roles and permissions

2014-06-05T02:44:48Z

Cttxg: /* See also */ Adding MoodleBites YouTube video link

{{Managing a Moodle site}}
A role is a collection of permissions defined for the whole system that you can assign to specific users in specific contexts. The combination of roles and context define a specific user's ability to do something on any page. The most common examples are the roles of student and teacher in the context of a course.

*[[Managing roles]]
*[[Assign roles]]
*[[Roles settings]]
*[[Using roles]]
*[[Standard roles]]
*[[Creating custom roles]]
*[[Permissions]]
*[[Override permissions]]

==See also==
*[http://youtu.be/7W08wDSWUa4 Moodle 2 Users, Permissions] MoodleBites video on YouTube

*[[Roles FAQ]]

[[Category:Roles]]

[[es:Roles y permisos]]
[[eu:Rolak]]
[[fr:Rôles et permissions]]
[[ja:ロールおよびケイパビリティ]]
[[de:Rollen und Rechte]]

Managing accounts

2014-06-05T02:40:35Z

Cttxg: /* See also */ Adding MoodleBites YouTube video link

{{Managing a Moodle site}}

An administrator can perform various tasks relating to user accounts in ''Administration > Site administration > Users > Accounts''. The links below provide more information:

* [[Browse list of users]] - how to search for, find and edit user accounts
* [[Bulk user actions]] - how to message, confirm, download or perform other actions on a large group of users globally
* [[Add a new user]] - how to create one individual user account
* [[Upload users]] - how to bulk create new user accounts
* [[User pictures]] - how to bulk upload profile pictures for users
* [[User profile fields]] - how to create customised profile fields

==See also==
*[http://youtu.be/bTsHsXOYDQc Moodle 2.0 User Accounts] MoodleBites video on YouTube

*[[Accounts FAQ]]

[[Category:Accounts]]

[[de:Nutzerverwaltung]]

URL resource settings

2014-06-05T02:29:27Z

Cttxg: Adding MoodleBites YouTube video link

{{URL}}
==Adding a URL resource to your course==

# Turn editing on.
#From the the "Add an activity or resource" link (or, if not present, the "Add a resource" drop down menu),choose URL. All settings may expanded by clicking the "Expand all" link top right.

==General==

{|
|[[File:urlgeneral25.png|thumb|General settings expanded by default]]
|}
===Name===
Whatever you type here will form the link learners click on to view the URL so it is helpful to give it a name that suggests its purpose.
===Description===
Add a description of your page here. Click "Show editing tools" to display the rich text editor, and drag the bottom right of the text box out to expand it.
===Display description on the course page===
If this box is ticked, the description will appear on the course page just below the name of the URL.

==Content==

{|
|[[File:Url.png|thumb|External URL field expanded by default]]
|}

# Either enter the URL in the external URL field or click the "Choose a link" button to open the file picker and choose a URL YouTube, Picasa etc (depending on which [[Repositories|repositories]] are enabled for the site.

==Appearance==
(These settings are collapsed by default)

{|
|[[File:urlappearance25.png|thumb|Appearance settings expanded]]

|}
===Display===

* ''Automatic'' - Make the best guess at what should happen (probably what is wanted 99% of the time).
* ''Embed'' - Show the Moodle page with heading, blocks and footer. Show the title/description of the item and display the file directly in the page as well
* ''Open'' - No Moodle heading, blocks, footer or description - just show the file in the web browser (e.g. shows image, PDF, flash animation, taking up the whole browser window)
* ''In pop-up'' - Same as 'Open', but opens a new browser window to show this file (without the Moodle heading, blocks, etc) - this browser window also does not have all the menus and address bar in it.

The above options are the default display options. Additional display options (see below) may be enabled by an administrator in ''Site administration > Plugins > Activity modules > URL''.
===Pop-up width/height===
If your URL is to be displayed in a pop-up, specify the width and height here.

===Display URL name/description===
To show the resource name and/or description when clicking to access the URL, simply tick the appropriate checkboxes.

==URL variables==
(These settings are collapsed by default.)
{|
|[[File:urlvariables25.png|thumb|URL variables settings expanded]]
|}

Thissection allows you to pass internal information as part of the URL.

This is useful if the URL is actually an interactive web page that takes parameters, and you want to pass something like the name of the current user, for example.

==Common module settings==
See [[Common module settings]]
==Restrict access/Activity completion==
(These settings are collapsed by default)

These settings are visible if [[Conditional activities]] and [[Activity completion]] have been enabled in the site and the course.

==Drag and Drop a URL==
Alternatively, if an administrator has enabled the experimental feature drag and drop upload of text/links in ''Settings > Site administration > Development > Experimental > [[Experimental settings]]'', a link can be dragged into a section of the course and given a name, as shown in the images below.

{|
| [[File:dragURL.png|thumb|Adding a URL using drag and drop]]
|}

==URL module capabilities==

* [[Capabilities/mod/url:view|View URL resource]]
* [[Capabilities/mod/url:addinstance|Add a new URL resource]]

==Site administration settings==

The URL module has additional settings which may be changed by an administrator in ''Administration > Site administration > Plugins > Activity modules > URL''.

===Frame height===

Here you can specify the height of the top frame (containing the navigation) if you choose the "in frame" display option. Note:If your theme has a large header then the height should be increased to prevent horizontal and vertical scrollbars.

===Require activity description===

This setting allows you to turn off the requirement for users to type something into the description box.

===Password===

Here you can add a password that will connect your users to a secure site. [http://moodle.org/mod/forum/discuss.php?d=189842#p826416 See this forum post] for more details.

===Include role names in parameters===

===Available display options===

This setting allows you to add different ways the resource may be displayed on the course page. There are a number of defaults but you can add or change them here. Other display options are:
* ''In frame'' - show the Moodle heading and the file description, with the file displayed in a resizeable area below
* ''New window'' - very much like 'in pop-up', but the new window is a full browser window, with menus and address bar, etc.
[[File:Display.gif]]

===Default values for activity settings===

Here you can set the defaults for this resource. You can also choose which setting(s) to class as "Advanced". These settings will only then appear if the user clicks "Show advanced" in the settings.

==See also==
*[http://youtu.be/bJitv0UzeOY Moodle 2.0 Adding Content - URL] MoodleBites video on YouTube

[[de:Link/URL konfigurieren]]
[[fr:Paramètres de l'URL]]

Theme settings

2014-06-05T02:26:30Z

Cttxg: Adding MoodleBites YouTube video link

{{Themes}}
== Theme settings ==
An administrator can change theme settings in ''Settings > Site administration > Appearance > Themes > Theme settings''.

[[File:Themesettings.png]]

===Theme list===
This lists the themes available for course and user themes. Leave this blank to allow any valid theme to be used. If you want to shorten the theme menu, you may specify a comma-separated list of names, though don't use spaces (e.g. standard,orangewhite).

You can preview the available themes in ''Settings > Site Administration > Appearance > Themes > Themes selector.''

===Theme designer mode===
Turn this on if you are designing and testing themes as it will stop the themes being cached and enable you to see theme changes quickly. (You can also do this with the Clear theme cache button on the theme selector page.)

===Allow user themes===
If the option ''allowuserthemes'' is enabled, each user may select their preferred theme on the edit profile page. All Moodle pages will be displayed in the user's theme, apart from courses where a course theme has been set.

===Allow course themes===
If you enable this, then teachers will be able to set their own course themes. Course themes override all other theme choices (site, user, or session themes).

*If the option ''allowcoursethemes'' is enabled, each editing teacher may select their course theme via the Force theme option on the [[course/edit|Course settings]] page. The course will always be displayed in the theme specified in the course setting, with user and the site themes being overwritten.

===Allow category themes===
When enabled, themes can be set at the category level. This will affect all child categories and courses unless they have specifically set their own theme. WARNING: Enabling category themes may affect performance, as it will result in a few extra DB queries on each page, so only turn this on if you need it!

===Allow theme changes in the URL===
*If this is checked then the theme may be changed by adding <code>?theme=theme_name</code> (or <code>&theme=theme_name</code> if there are other URL parameters) to the URL in the browser. Theme names should be in lower case with spaces replaced by underscores, for example the theme "Formal white" should be entered as <code>?theme=formal_white</code>

===Allow users to hide blocks===
Allows users to display and hide blocks

===Allow blocks to use the docks===
*If the theme allows it, then checking this will allow the user to move blocks to the side dock.

===Custom menu items===
The custommenuitems setting allows you to create a drop down menu that can be displayed by themes that support it. Currently all themes that are provided with Moodle 2.0 support this custom menu.

You are able to create the custom menu by entering custom menu items one per line into the setting. Each item is preceded by a number of hyphens (-), the number of hyphens determines the depth of the item. So items that are '''NOT''' preceded by a hyphen appear on the top level of the menu (always visible), items with a single hyphen appear on a drop down menu below the previous top level item, and items with two hyphens appear on a drop down menu below the previous first level item and so on.

The content of each item is constructed of up to three bits, each separated by a '''|''' (Shift + \) character. The bits are '''label''' | '''url''' | '''tooltip'''.
; label : This is the text that will be shown within the menu item. You must specify a label for every item on the menu.
; url : This is the URL that the user will be taken to it they click the menu item. This is optional, if not provided then the item will not link anywhere.
; tooltip : If you provide a URL you can also choose to provide a tooltip for the link that is created with the URL. This is optional and if not set the label is used as the tooltip for the menu item.

The following is an example of how you would create a custom menu:

<pre>
Moodle community|http://moodle.org
-Moodle free support|http://moodle.org/support
-Moodle development|http://moodle.org/development
--Moodle Tracker|http://tracker.moodle.org
--Moodle Docs|https://docs.moodle.org
-Moodle News|http://moodle.org/news
Moodle company
-Moodle commercial hosting|http://moodle.com/hosting
-Moodle commercial support|http://moodle.com/support
</pre>

Note: The custom menu does not escape characters within the label, if you want to use a special HTML character such as an ampersand you must escape it yourself within the label. e.g. use & instead of &.

For more information on this setting please see the ''Using Moodle'' forum discussion [http://moodle.org/mod/forum/discuss.php?d=149803 Moodle 2.0: Custom menu in core]

==== Multilanguage support ====

You can add a language code (or a comma separated list of codes) as the 4th item of the line. The line will be then printed if and only if the user has currently selected the listed language. For example:

<pre><nowiki>
English only|http://moodle.com|English only item|en
German only|http://moodle.de|Deutsch|de,de_du,de_kids
</nowiki></pre>

==== Adding other attributes to the HTML ====
Other attributes, such as '''target''' can be added with escaped quotes:
<pre><nowiki>
Moodle Homepage|http://moodle.org\" target=\"_blank
</nowiki></pre>
The first escaped quote closes the href attribute, allowing other attributes to be added. All quotes for the extra attributes must be escaped as well. Do not add the closing quotation mark on the final attribute, it is added automatically by Moodle.

===Enable device detection===
Will detect mobile and tablets that identify themselves via the web browser at the time of login to Moodle. These work with the theme selector. When the theme selector has identified a default, mobile and tablet themes, this feature will use that theme.

===Device detection regular expressions===
This will allow you to customize the theme selector options. For example, you can add a custom theme for IE6 and another for Windows CE by entering the identifying expressions the browser sends and the "Return value" you want to display as the theme selectors "Device type".

==Special themes==

=== Session themes ===
Moodle offers an additional way to set a theme - the '''session theme'''. This is set with the URL and lasts until you log out. When you next login, the site/course/user themes are active again. This option is great for theme testing and works perfectly when you want to enable different themes for different situations.

For example you can offer a special link for PDA users and integrate the session theme ''orangewhitepda'' in that link. Nobody needs to change any settings, you just click on that link. The session theme is called by the URL parameter <code>&theme=orangewhitepda</code>. The whole URL without the session theme could look like <code><nowiki>http://mymoodlesite.org/course/view.php?id=18</nowiki></code> and with the parameter for the PDA theme like <code><nowiki>"http://mymoodlesite.org/course/view.php?id=18&theme=orangewhitepda"</nowiki></code>.

In a standard Moodle installation, session themes are not active. To activate them the administrator must add the parameter <code>$CFG->allowthemechangeonurl = true;</code> to the Moodle ''config.php'' file in the Moodle base directory.

=== Page theme ===
A page theme is for special page-only themes set by code, use <code>$PAGE->force_theme()</code>.

== Theme hierarchy ==
Here is the usual order that themes are considered by the Moodle interface.

{| style="border:1px dashed #ddd"
|- style="vertical-align:top;text-align:left"
!Theme type
! style="background:#eee"|Overwrites
!Display
! style="background:#eee"|Setting type
|- style="vertical-align:top"
|Site
|style="background:#eee"| -
|all pages*
|style="background:#eee"|saved in theme profile
|- style="vertical-align:top"
|User
|style="background:#eee"|Site theme
|all pages*
|style="background:#eee"|saved in user profile
|- style="vertical-align:top"
|Course
|style="background:#eee"|Site, user and session themes
|one course
|style="background:#eee"|saved in course profile
|- style="vertical-align:top"
|Session
|style="background:#eee"|Site and user themes
|all pages*
|style="background:#eee"|temporary until logout
|}
(* except courses with the course theme set)

=== Change default hierarchy===
The priority of themes can be set via the /moodle/config.php file. The order defines which theme wins when there are several set at different levels. You can set a variable called $CFG->themeorder (see config-dist.php for more details). By default it is set to:

<code><nowiki>$CFG->themeorder = array('course', 'category', 'session', 'user', 'site');</nowiki></code>

==Particular theme settings==

Logo, tagline, link colour, column width, custom CSS and other settings for a particular theme may be set by an administrator in ''Settings > Site administration > Appearance > Themes > Theme name''.

==See also==
*[http://youtu.be/a4Sbg8k6PoU Moodle 2 Administrator Theme settings ] MoodleBites video on YouTube

[[es:Configuración de temas]]
[[fr:Réglages des thèmes]]
[[ja:テーマ設定]]
[[de:Design-Einstellungen]]

Server settings

2014-06-05T02:23:21Z

Cttxg: Adding MoodleBites YouTube video link

{{Managing a Moodle site}}
*[[System paths]]
*[[Session handling]]
*[[HTTP]]
*[[Maintenance mode]]
*[[Cleanup]]
*[[Environment]]
*[[Site registration]]

==See also==
*[http://youtu.be/qVnR84C9NDU Moodle 2 Administration Server settings] MoodleBites video on YouTube

[[de:Servereinstellungen]]
[[es:Configuraciones del servidor]]

Self enrolment

2014-06-05T02:19:52Z

Cttxg: Adding MoodleBites YouTube video link

{{Enrolment}}
Self enrolment is the method whereby users can choose to enrol themselves into a course, either immediately by clicking "enrol me in this course" or by typing in an enrolment key they have been given. The enrolment plugin needs to be enabled by the site admin in [[Enrolment_plugins|enrolment plugins]] and has to be enabled within the course. The manual enrolment plugin has to be enabled in the same course as well.

==Course settings for self enrolment==
[[File:Selfenrolment.png]]

===Checking self enrolment is enabled===
In a course, go to ''Administration > Course administration > Users > Enrolment methods'' and ensure the "eye" is opened for self enrolment.

===Adding an enrolment key to a course===

If you wish only a certain group of users to self enrol (and not anyone) then you can set an enrolment key which you then tell them to use when they access the self-enrolment screen. See section 1 of [[Enrolment_key|enrolment key]] for how to do this.

===Adding a group enrolment key to a course===

If you wish your users to enrol themselves directly into a group in the course then you can set a group enrolment key which you then tell them to use when they access the self-enrolment screen. See section 2 of [[Enrolment_key|enrolment key]] for how to do this.

See also this screencast [http://www.youtube.com/watch?v=4xzF7xerle0 Group enrolment keys in Moodle 2.0].

The following settings may be changed by clicking the edit (hand/pen) icon to the right of the self-enrolment option in ''Administration > Course administration > Users > Enrolment methods'':

===Setting the enrolment period===

Tick the "enable" box to the right of Enrolment period and then choose your dates.

=== Enrolment duration===

Set the amount of time a user enrolment is valid, starting with the moment the user enrols themselves. If disabled, the enrolment duration will be unlimited.

===Notifying users when their enrolment expires===

It is possible also for students and/or teachers to be notified when enrolments expire by selecting either "Enroller only" or "Enroller and enrolled user" from the dropdown "Notify before enrolment expires" and a time in "Notification threshold".

{|
|[[File:selfenrolmenexpirynotification.png|thumb|Settings for notifiying users before enrolment expires. Click to enlarge.]]
|}

====Editing individual enrolment times====

It is possible to edit the date and hour of an individual's enrolment from ''Administration>Course administration>Users>Enrolled users'' by clicking the edit icon in the enrolment methods column for the user in question. This then brings up a screen where the date and time can be modified.

{|
|[[File:selfenrolment241.png|thumb|Click the edit icon in the enrolment methods column for the user]]
|[[File:selfenrolment242.png|thumb|Modifying the date and time]]
|}

===Unenrolling students who haven't been active on the course===

Choose from the dropdown to the right of "Unenrol inactive after..."

===Deciding the maximum number of users in your course===

Type the maximum number of users you want in your course in "Max enrolled users". When this limit is reached, nobody will be able to self-enrol. If you leave the number at 0 then there will be no maximum number.

===Allowing only cohort members to self-enrol===

If you have cohorts set up, then you can restrict self enrolment to particular cohorts by selecting the name of the cohort from the drop down box, A member of the cohort can self-enrol as normal; whereas a non-member gets a message telling them they are not able to self-enrol.

{|
|[[File:cohortselfenrol.png|thumb|Restricting self enrolment to members of a particular cohort]]
|[[File:noncohortmember.png|thumb|Message seen by a user not in a cohort who is attempting to self-enrol]]
|}

===Sending a welcome message to new users===

If enabled, users receive the following message via email when they self-enrol in a course:

Welcome to {Course name}
If you have not done so already, you should edit your profile page so that we can learn more about you: {link to profile page}

If you want to send a different message, simply type it in the custom welcome message text box.

Note: An admin can customise the message for the whole site by editing the ''welcometocoursetext'' language string. See [[Language customization]] for further details.

==Admin settings==
The self enrolment plugin may be enabled or disabled throughout the site in ''Administration > Site administration > Plugins > Enrolments > Manage enrol plugins.''

===Shared settings for all courses===
The page ''Administration > Site administration > Plugins > Enrolments > Self enrolment.'' contains options for defaults that admin can set:
* Require an enrolment key - if this box is ticked then all courses with self-enrolment enabled will need to have an enrolment key. The setting won't save until the teacher adds a key - something to be aware of as this can cause confusion:)
* Use password policy - tick this box if you want enrolment keys set by teachers to follow the password policy of the site.
* Show hint - tick this box if you are prepared to allow the first letter of a key to be given as a "hint"
* Enrolment expiration action - specifies what happens when user enrolments reach expiration date. Please note that option "Unenrol user from course" purges grades, group memberships, preferences and other user related data from the courses.
* Hour to send enrolment expiry notifications - specify hour for sending expiration notifications.

===Default enrolment settings in new courses===
These can be set in ''Administration > Site administration > Plugins > Enrolments > Self enrolment'' but teachers in individual courses can alter them to suit their needs:
* Add instance to new courses - if admin selects this, then any new course created will include the self enrolment plugin
* Enable self enrolments- if this is enabled then users by default can self enrol into a course.
* Use group enrolment keys - the setting for group enrolment keys in a course will be set to "yes" by default
* Default role assignment - normally, when users self enrol, they have the student role. If necessary that role can be changed by default here - for example - if your Moodle has a dedicated role you wish to use instead.
* Enrolment duration - this sets the default enrolment length for new courses (but again, may be altered by the course teacher.)
* Notify before enrolment expires - specifies if teacher or optionally students should be notified before the expiration.
* Notification threshold - specify how many days should be users notified before the enrolment expiration.
* Unenrol inactive after- this sets the default time after which a student will be unenrolled if they haven't accessed the courses. (Teachers may change this)
* Max enrolled users - adding a number here will specify the maximum number of users who can self-enrol into new courses. Teachers in the course can change this. If it is left at 0, there will be no maximum.
* Send course welcome message- if this box is checked then newly enrolled users will receive a welcome message by default.

==Self enrolment method options==
One course may contain multiple self enrolment methods. User may be enrolled once in each instance only.

* Custom instance name - specify custom enrolment method name.
* Enable existing enrolments - if disabled all users enrolled via this plugin can not access course.
* Allow new enrolments - disable if you do not want to allow students to self enrol in the future.
* Enrolment key - specify key required for enrolment.
* Use group enrolment keys - optionally use group keys for enrolment too.
* Default assigned role - specify role to be assigned to suers during enrolment, this can be manually after user enrolment.
* Enrolment duration - specify enrolment length, this can be manually after user enrolment.
* Notify before enrolment expires - specifies if teacher or optionally students should be notified before the expiration.
* Notification threshold - specify how many days should be users notified before the enrolment expiration.
* Unenrol inactive after- specify time after which a student will be unenrolled if they haven't accessed the courses.
* Max enrolled users - adding a number here will specify the maximum number of users who can self-enrol into this course.
* Only cohort members - optionally restrict this enrolment method to members of specified cohort.
* Send course welcome message- if this box is checked then newly enrolled users will receive a welcome message by default.
* Custom welcome message - specify custom message if necessary.

==Self enrolment capabilities==

*[[Capabilities/enrol/self:config|Configure self enrol instances]]
*[[Capabilities/enrol/self:manage|Manage enrolled users]]
*[[Capabilities/enrol/self:unenrol|Unenrol users from course]]
*[[Capabilities/enrol/self:unenrolself|Unenrol self from the course]]

==See also==
*[http://youtu.be/jl52muw67bg Enabling Self Enrolment in Moodle 2.x] MoodleBites video on YouTube

[[de:Selbsteinschreibung]]

HTTP security

2014-06-05T02:16:41Z

Cttxg: /* See also */ Adding MoodleBites YouTube video link

{{Security}}
HTTPS for logins can be enabled by an administrator in ''Settings > Site administration > Security > HTTP security''.

==Use HTTPS for logins==
HTTPS encrypts the user's login data, so it's difficult to sniff out a user's username and password on the network. You will need to enable HTTPS on your server before you turn on this setting, or else you will be locked out of your site. Every web server has a different method for enabling HTTPS, so you should check the documentation for your web server.

==See also==
*[http://youtu.be/VZdv2FvxwrQ Moodle 2 Administration Security settings] MoodleBites video on YouTube
*Using Moodle [http://moodle.org/mod/forum/discuss.php?d=79110 Locked out] forum discussion

[[Category:Site administration]]

[[de:HTTP-Sicherheit]]

IP blocker

2014-06-05T02:15:24Z

Cttxg: Adding MoodleBites YouTube video link

{{Security}}
An administrator can set a list of allowed and/or blocked IP addresses in ''Settings > Site administration > Security > IP blocker''.

[[File:IPblocker.png]]

*By default, entries in the blocked list are processed first, but checking the box ''Allowed list will be processed first'' reverses this order.
*Each entry in the allowed or blocked list goes on one line, with either the full IP address, partial address or range. Blank lines or domain names written as text (like moodle.org) are ignored.

Be aware that with any entries in the Allowed IP List, the effect is to allow ONLY those IP addresses and block all others. Exercise care with this setting, as it is possible to lock yourself out of Moodle.

If there are entries present in the Blocked IP List, any hosts for which Moodle cannot determine the IP address will be blocked by default. For example, hosts that are behind a web proxy server which does not pass the HTTP headers containing the remote IP address information. In this case Moodle cannot determine the host's IP address with which to compare against the Blocked IP List, so the host is blocked by default. A suggested workaround may be to change the Logged IP address source (getremoteaddrconf setting within Site administration > Server > HTTP > Reverse Proxy) from the default to "REMOTE_ADDR" which will log the IP address of the proxy server instead of the host behind it.

==See also==
*[http://youtu.be/VZdv2FvxwrQ Moodle 2 Administration Security settings] MoodleBites video on YouTube

[[Category:Site administration]]

[[fr:Blocage IP]]
[[de:IP-Blockierung]]

Anti-virus

2014-06-05T02:14:25Z

Cttxg: /* See also */ Adding MoodleBites YouTube video link

{{Security}}
The use of the open source virus scanner clam AV on uploaded files can be enabled by an administrator in ''Settings > Site administration > Security > Anti-Virus''.

Clam AV should be installed on your server. See http://www.clamav.net for more information and also [[Talk:Anti-virus]].

==See also==
*[http://youtu.be/VZdv2FvxwrQ Moodle 2 Administration Security settings] MoodleBites video on YouTube
* Using Moodle [http://moodle.org/mod/forum/discuss.php?d=147820 ClamAV upgrade may be required] forum discussion
*ClamAV reporting errors when scanning external repo files MDL-34939

[[Category:Site administration]]

[[eu:Antibirusa]]
[[hu:Vírusölő]]
[[de:Antivirus]]

Site policies

2014-06-05T02:11:28Z

Cttxg: Adding MoodleBites YouTube video link

{{Security}}
A site administrator can set site policies affecting the security and privacy of the site in ''Administration > Site administration > Security > Site policies''.

===Protect usernames===

If enabled, when a user attempts to reset their password and enters a username or email address, the following message is displayed: "If you supplied a correct username or email address then an email should have been sent to you." This is to prevent a malicious party from using the interface to determine which usernames and email addresses are in use in valid accounts.

If the protect usernames setting is disabled, when a user attempts to reset their password they are provided with feedback regarding whether an account exists with the username or email address supplied. For example, the message "The email address was not found in the database" may be displayed.

===Force users to login===

If you turn this setting on, all users must login before they even see the [[Front Page]] of the site.

===Force users to login for profiles===

Leave this set to Yes to keep anonymous visitors away from user profiles.

===Force users to login to view user pictures===

If enabled, users must login in order to view user profile pictures and the default user picture will be used in all notification emails.

===Open to Google===

Enabling this setting allows Google's search spiders guest access to your site. Any part of the site that allows guest access will then be searchable on Google. In addition, people coming in to your site via a Google search will automatically be logged in as a guest.

===Profile visible roles===
Any role which is checked/ticked here will be visible on user profiles and the Participation screen.

===Maximum uploaded file size===

Probably the most frequently asked question in the Moodle.org Using Moodle forums is "How do I increase the upload file size limit?"

Upload file sizes are restricted in a number of ways - each one in this list restricts the following ones:

1. The Apache server setting LimitRequestBody ... default in Apache 2.x or greater is set to 0 or an unlimited upload size

2. The PHP site settings post_max_size and upload_max_filesize in php.ini : '''modify php.ini in web server directories''' ( apache2.x.x/bin/php.ini ) not in php directories :

post_max_size = 128M; to increase limit to 128 Megabytes;
upload_max_filesize = 128M; to increase limit to 128 Megabytes;
max_execution_time = 600 ; Maximum execution time of each script, in seconds;

3. The Moodle site-wide maximum uploaded file size setting: ''Settings > Site administration > Security > Site policies > Maximum uploaded file size''.

4. The Moodle course maximum uploaded file size setting in the course default settings: ''Settings > Site administration > Courses > Course default settings''

5. The file size settings in each individual course in ''Course Administration>Settings''.

5. Certain course activity module settings (for example, Assignment)

* See [[File upload size]] for more details.

===User quota===

The maximum number of bytes that a user can store in their own [[Private files]] area.

===Allow EMBED and OBJECT tags===
Allowing these presents a security risk but if you wish normal users such as students to be able to use them then check the box here.

===Enable trusted content===

By default Moodle will always thoroughly clean text that comes from users to remove any possible bad scripts, media etc that could be a security risk. The Trusted Content system is a way of giving particular users that you trust the ability to include these advanced features in their content without interference. To enable this system, you need to first enable this setting, and then grant the [[Capabilities/moodle/site:trustcontent|Trust submitted content]] capability to a specific Moodle role. Texts created or uploaded by such users will be marked as trusted and will not be cleaned before display. Please refer to [[dev:Trusttext cleaning bypass]] for further information.

===Maximum time to edit posts===

This sets the editing time for forum postings. The editing time is the amount of time users have to change forum postings before they are mailed to subscribers.

Please refer to the forum discussions [http://moodle.org/mod/forum/discuss.php?d=28679 Editing a forum post after the 30 minutes deadline] and [http://moodle.org/mod/forum/discuss.php?d=5367 The philosophy underlying "no editing after 30 minutes"]

===Full name format===

If set to 'First name' only users with the [[Capabilities/moodle/site:viewfullnames|view full names capability]] (by default managers, teachers and non-editing teachers) can view users' full names.

===Allow extended characters in usernames===

The default here, unchecked = unenabled, can only contain alphabetical letters in lowercase, numbers, hypen '-', underscore '_', period '.', or at sign '@'. If you enable this, it will be possible to have any characters for the username.

===Site policy URL===

* If you have a site policy that all users must see and agree to before using this site, then specify the URL to it here, otherwise leave this field blank. The URL can point to any type of file anywhere online that can be accessed without a log in to your Moodle.
* It is recommended that the site policy is on the same domain as Moodle to avoid the problem of Internet Explorer users seeing a blank screen when the site policy is on a different domain.
* The site policy will be displayed in a frame. You can view it via the URL ''<nowiki>yourmoodlesite.org/user/policy.php</nowiki>''.

===Site policy URL for guests===
This is similar to the Site policy URL as above but will be seen by those to whom you give guest access.

===Keep tag name casing===

If checked, then tags like the following will be displayed: SOCCER, gUiTaR, MacDonalds, music

If unchecked, then all tags will be displayed as follows: Soccer, Guitar, Macdonalds, Music

:''Tips'':
:* For English, off is useful.
:* For Japanese, no changes are made either way.
:* For languages where this kind of capitalization changes the meaning, it is best to keep this option on.

===Profiles for enrolled users only===

To prevent misuse by spammers, profile descriptions of users who are not yet enrolled in any course are hidden. New users must enrol in at least one course before they can add a profile description.

===Cron execution via command line only===

[[Cron]] is an action that runs various administrative jobs on your Moodle such as sending out forum posts. Normally Cron can be run by typing www.YOURMOODLE.com/admin/cron.php but as anyone logged in can do this, if you wish to prevent it, then check this box and only a admin can run Cron from the command line.

===Cron password for remote access===
Setting a password here will mean that users can only run cron from the browser if they know the password and add it like this:
www.YOURMOODLE.com/admin/cron.php/?password=THEPASSWORDYOUSET

===Account lockout===

{{New features}}In Moodle 2.5 onwards, account lockout may enabled. After a specified number of failed login attempts, a user's account is locked and they are sent an email containing a URL to unlock the account.

The account may also be unlocked by an administrator in ''Settings > Site administration > Users > Accounts > Browse list of users'' or by waiting for the account lockout duration to elapse.

===Password policy===

It is highly recommended that a password policy is set to force users to use stronger passwords that are less susceptible to being cracked by a intruder.
[[Image:Password policy.png|thumb|Password policy]]

The password policy includes option to set the minimum length of the password, the minimum number of digits, the minimum number of lower-case characters, the minimum number of upper-case characters and the minimum number of non alphanumeric characters.

The password policy is enabled by default. Default (recommended) settings are:
* Password length - 8
* Digits - 1
* Lowercase letters - 1
* Uppercase letters - 1
* Non-alphanumeric characters - 1

If a user enters a password that does not meet the requirements, they are given an error message indicating the nature of the problem with the entered password.

Enabling the password policy does not affect existing users until they decide to or are required to change their password. An admin can force all users to change their password using the force password change option in [[Bulk user actions]].

:''Tip'': The password policy may also be applied to [[Enrolment key|enrolment keys]] by ticking the 'Use password policy' checkbox in the [[Self enrolment]] settings.

===Group enrolment key policy===
If this is enabled then when a teacher sets a group enrolment key, they will have to set a key which follows the password policy set above.

===Disable user profile images===

Check/tick this box if you don't want your users to be able to change their [[User pictures|profile images]].

===Email change confirmation===

A confirmation step is required for users to change their email address unless the ''emailchangeconfirmation'' box is unchecked.

===Remember username===
If you want usernames to be stored during login then set this to "yes". This will store permanent cookies and in some countries may be considered a privacy issue if used without consent. From a UK point of view, see http://tracker.moodle.org/secure/attachment/24290/UK+Laws+Relating+to+Cookies-LUNS2011.pdf See also the Using Moodle forum discussion [http://moodle.org/mod/forum/discuss.php?d=201558 EU Cookie Law].

==See also==
*[http://youtu.be/VZdv2FvxwrQ Moodle 2 Administration Security settings] MoodleBites video on YouTube

[[es:Políticas del sitio]]
[[eu:Gunearen_politikak]]
[[fr:Règles site]]
[[ja:サイトポリシー]]
[[de:Website-Rechte]]

Using RSS feeds

2014-06-05T02:06:09Z

Cttxg: Adding MoodleBites YouTube video link

{{RSS feeds}}
==Activities and other areas that produce RSS feeds==

* [[Blogs]]
* [[Database]]
* [[Forum]]
* [[Glossary]]

== Subscribing to RSS feeds==

To subscribe to an RSS feed from Moodle, go to the activity, click on the orange 'RSS' button and copy the address from your browser bar to your RSS reader software.

==Restricting access to RSS feeds==

To ensure security and privacy, RSS feed URLs contain a special token that identifies the user they are for. This prevents users from accessing areas of Moodle they shouldn't have access to via RSS feeds.

Users have this token automatically created for them the first time they access an area of Moodle that produces an RSS feed. If a user feels that their RSS feed token has been compromised in some way they can request a new one by going to ''Settings > My profile > Security keys'' and clicking the Reset link next to the RSS key.

To provide a public RSS feed for use on another site, login to your Moodle site as a guest, then copy the RSS feed address.

==See also==
*[http://youtu.be/Zx9o-ueJ-II Moodle 2.0 - RSS] MoodleBites video on YouTube

[[de:RSS-Feeds nutzen]]

Site-wide reports

2014-06-05T02:03:37Z

Cttxg: /* See also */ Adding MoodleBites YouTube video link

{{Managing a Moodle site}}
In addition to reports available at both site and course level, the following site-wide reports are available for administrators:

*[[Config changes report]] - Shows changes made by an administrator to the site configuration
*[[Course overview report]]
*[[Question instances report]] - Reports where particular question types are used on the site

==See also==
*[http://youtu.be/YJ5qxYfWmbY Moodle 2 Administration Reports] MoodleBites video on YouTube
* [[Logs]] - Activity reports for course or site
*[[Reports FAQ]]
*[[Course reports]] in Managing a Moodle course
*[[Plugins_overview| Plugins overview]] for checking the status of all plugins on the site.
*[[:dev:General report plugins|General report plugins]] developer documentation
*[[ad-hoc contributed reports]]

[[Category:Report]]

[[es:Reportes del sitio]]

Quiz settings

2014-06-05T01:55:47Z

Cttxg: /* See also */ Adding MoodleBites YouTube video link

{{Quiz}}
Creating a new quiz is a two-step process. In the first step, you create the quiz activity and set its options which specify the rules for interacting with the quiz. In the second step you add questions to the quiz.
This page describes the options you can set for the quiz activity. The page [[Building Quiz]] describes how to set up the questions for the quiz.

==Quiz administration==
When you first set up your quiz from ''Add an activity or resource > Quiz'', (or, if you don't have this link, the dropdown ''Add an activity>Quiz'') you will get the following settings, (which can also be changed later in the Edit Settings link of the Quiz administration settings block) All settings may expanded by clicking the "Expand all" link top right.

==General==
{|
|[[File:quizgeneral25.png|thumb|General settings expanded by default]]
|}
;Name
:This is the standard name field. This name will appear on the home page of the course, navigation menu and other places which will show or provide links to this quiz.

;Description
:Describe the purpose of the glossary and provide instructions or background information, links etc. Click "Show editing tools" to display the rich text editor, and drag the bottom right of the text box out to expand it.

;'''Display description on course page'''
:If ticked, the quiz description will appear on the course page directly under the quiz name.
==Timing==
(These settings are collapsed by default)
{|
|[[File:quiztiming25.png|thumb|Timing settings expanded]]
|}

;Open the quiz
:You can specify times when the quiz is accessible for people to make attempts. Before the opening time the quiz will be unavailable to students. They will be able to view the quiz introduction but will not be able to view the questions. Quizzes with start times in the future diasplay both the open and close date for students.

Note: You can make the quiz available at different times for different groups or users in the Group or User override sections of the Quiz Administration settings block.

;Close the quiz
:After the closing time, the students will not be able to start new attempts. Answers that the student submits after the quiz closing date will be saved but they will not be marked.

: Even after the quiz has closed students will still be able to see the quiz description and review their attempts. What exactly they will see depends on the settings you choose for review options (see below).
;Time limit
:By default, quizzes do not have a time limit, which allows students as much time as they need to complete the quiz. If you do specify a time limit, several things are done to try and ensure that quizzes are completed within that time:
{|
|[[File:quiz timer.png|thumb|Navigation block showing quiz timer]]
|}

# A countdown timer is shown in the quiz navigation block
# When the timer has run out, the quiz is submitted automatically with whatever answers have been filled in so far
# If a student manages to cheat and goes over the allotted time, no marks are awarded for any answers entered after the time ran out

Note: You can make the quiz available last a different period of time for different groups or users in the Group or User override sections of the Quiz Administration settings block (see below).

;When time expires..

There are three options as to what will happen when the time limit is up. Choose the one you need from the dropdown menu:
{|
|[[File:quiztiming25.png|thumb|right|Timing options]]
|}

If you select "''there is a grace period...''" then you can check the box to enable the "Submission grace period" and specify a period of time during which learners may still submit the quiz after the time is up.

===Examples of how timing is handled===

#A student starts a quiz at noon. The quiz has a one-hour time-limit, and a 1 hour delay between attempts. The student gets distracted, and so actually does not submit (using the overdue handling) until 1:30pm. ''They are allowed to start their second attempt at 2. pm''
#The quiz count-down timer submits a student's quiz attempt at the last second when time expires. Because the server is heavily loaded, it takes 30 seconds to process the student's attempt. ''The submission is accepted nonetheless.''
#Same situation as above but with a 120 second delay: ''The submission is rejected.''
#The delay is not because of server load but because the student found a way to cheat the timer. ''Moodle cannot know what causes a delay.The behaviour is controlled by the admin setting(quiz | graceperiodmin), 60 seconds by default.''
#A student is a member of 3 groups,all of which have different override settings. Which limits will apply to this student? ''If there is any user-specific override, then that is used, and the group overrides for that setting are not used at all. Otherwise, if there are multiple group overrides, the most generous values are used (the earliest open date, the latest close date, the longest time limit, the most number of attempts, and the student can type any of the passwords).''

==Grade==
(These settings are collapsed by default)
{|
|[[File:quizgrade25.png|thumb|Grade settings expanded]]
|}

;Grade category
If you have categories in your gradebook, select the one you wish the quiz to be in here.
;Attempts allowed
:Students may be allowed to have multiple attempts at a quiz. This can help make the process of taking the quiz more of an educational activity rather than simply an assessment. If the quiz is randomized then the student will get a new version for each attempt. This is useful for practice purposes.

Note: You can change the allowed number of attempts for different groups or users in the Group or User override sections of the Quiz Administration settings block.

;Grading method
:When multiple attempts are allowed, there are different ways you can use the grades to calculate the student's final grade for the quiz.
* Highest grade - the final grade is the highest (best) grade in any attempt
* Average grade - the final grade is the average (simple mean) grade of all attempts
* First grade - the final grade is the grade earned on the first attempt (other attempts are ignored)
* Last grade - the final grade is the grade earned on the most recent attempt only

==Layout==
(These settings are collapsed by default)
{|
|[[File:quizlayout25.png|thumb|Layout settings expanded]]
|}

;Question order
:If 'Shuffled randomly' is selected, then the order of questions in the quiz will be randomly shuffled each time a student starts a new attempt at the quiz. The intention is to make it a little harder for students to copy from each other.

;New page
:For longer quizzes it makes sense to stretch the quiz over several pages by limiting the number of questions per page. When adding questions to the quiz, page breaks will automatically be inserted according to the setting you choose here. However, you will also be able to move page breaks around by hand later on the editing page.
:'''Note that changing this setting has no effect on questions you have already added to the quiz'''. The setting will only apply to questions you add subsequently. To change the page breaks in an existing quiz, you need to go to the quiz editing screen, tick the 'Show page breaks' checkbox, then use the repaginate control.

;Navigation method (available by clicking ''Show More'')

By choosing ''Sequential'' instead of ''Free'', the teacher is forcing the student to progress through the questions in order without being able to go back to a previous question or skip to a later one.

==Question behaviour==
(These settings are collapsed by default)
{|
|[[File:quizbehaviour25.png|thumb|Question behaviour settings expanded]]
|}
;Shuffle within questions

If set to 'yes', then each time the student takes a quiz the parts of the question will be shuffled randomly.
;How questions behave
* Deferred feedback - Students must enter an answer to each question and then submit the entire quiz, before anything is graded or they get any feedback.
* Adaptive mode and Adaptive mode (no penalties) - Allows students to have multiple attempts at the question before moving on to the next question.
*Interactive mode - After submitting one answer, and reading the feedback, the student has to click a 'Try again' button before they can try a new response. Once the student has got the question right, they can no longer change their response. Once the student has got the question wrong too many times, they are just graded wrong (or partially correct) and get shown the feedback and can no longer change their answer. There can be different feedback after each try the student makes.
*Immediate feedback - Similar to interactive mode in that the student can submit their response immediately during the quiz attempt, and get it graded. However, they can only submit one response, they cannot change it later.
*Deferred feedback or Immediate feedback with '''Certainty-based marking''' ('''CBM''') - With CBM, the student does not only answer the question, but they also indicate how sure they are they got the question right. The grading is adjusted by the choice of certainty, so that students have to reflect honestly on their own level of knowledge in order to get the best mark. See the ''See Also'' section below for an example quiz using CBM and a blog post explaining the philosophy.

''Note:'' There is also an option "Manual grading" which can be enabled from A''dministration>Site administration>Plugins>Question behaviour'' This causes all questions in the quiz to require manual grading.
===Certainty-based marking===
When a student answers a question they also have to state how sure they are of the answer: not very (less than 67%); fairly (more than 67%) or very (more than 80%). Their grading is then adjusted according to how certain they are, which means that for example if they answered correctly but were only guessing, their mark is adjusted from 1 to 0.33. If they answered wrongly but were very sure, their mark is adjusted from 0 to -2.

{|
| [[File:cbm03.png|thumb|correct answer; very sure]]
| [[File:cbm05.png|thumb|correct answer; fairly sure]]
| [[File:cmb04.png|thumb|correct answer; not very sure]]
| [[File:cbm01.png|thumb|wrong answer; very sure]]
| [[File:cbm99.png|thumb|wrong answer; not very sure]]
|}

;Each attempt builds on the last (available by clicking "Show more")
:If multiple attempts are allowed and this setting is set to Yes, then each new attempt contains the results of the previous attempt. This allows the student on the new attempt to concentrate on just those questions that were answered incorrectly on the previous attempt. If this option is chosen then each attempt by a particular student uses the same questions in the same order, independent of randomization settings. To show a fresh quiz on every attempt, select No for this setting.

''Note:'' to find out more about an available patch extending and enhancing CBM feedback, see [[Using certainty-based marking]].

==Review options==
(These settings are collapsed by default)
{|
|[[File:quizreviewoptions25.png|thumb|Review options expanded]]
|}

This section controls what information students will be shown when they review their past attempts at the quiz, and during the attempt in adaptive mode. It is a matrix with check boxes.

The various pieces of information that can be controlled are:
; The attempt: Will show how the student responded to each question.
; Whether correct: Displays whether the students response to each question is correct or incorrect.
; Marks: Reveals the marks awarded to the student and the grade for the quiz.
; Specific feedback: Will show the feedback for the response to the answer as set when adding the question to the quiz. Each response to a question can have feedback for both correct and incorrect answers.
; General feedback: Displays the general feedback for the whole question as set when adding the question to the quiz. You can use the general feedback to give students some background to what knowledge the question was testing.
; Right answer: Reveals the correct answer to each question, whether the student answered correctly or not (See note below).
; Overall feedback: Displays feedback for the entire quiz as set in the quiz settings (See note below).

For each of the above items, you can determine the timeframe when the students will see them:
; During the attempt : is only available when ''‘How questions behave’'' has been set to ''‘Immediate feedback’'', ''‘Immediate feedback with CBM’'' and ''‘Interactive with multiple tries’''. If set to one of these options then a ''‘Check’'' button will appear below the answer and when clicked the student will submit that response and then receive immediate feedback.
; Immediately after the attempt : means within 2 minutes of the student clicking "submit all and finish".
; Later, while the quiz is still open : means after 2 minutes, but before the close date (if the quiz does not have a close date, this phase never ends).
; After the quiz is closed : means what it says (you never get here for quizzes without a close date).

:''Tip:'' Checking any of the boxes in the timeframe row, will reveal the test to the student. For example, to allow students to see their quiz immediately after taking it but not later, make sure none of the boxes in "Later" or "After" rows are checked. The student will be able to see their grade but not get into the quiz.

Note: Currently, the Answers display is a bit inconsistent between different question types. For example, the matching question type shows students which of their responses are correct, but does not tell them the right answer for the ones they got wrong. The short answer and multiple choices question types do tell the student what the correct answer is.

Users with the capability 'View hidden grades' [[Capabilities/moodle/grade:viewhidden|moodle/grade:viewhidden]] (typically teachers and administrators) are not affected by these settings and will always by able to review all information about a student's attempt at any time.

In your list of review options, you must have 'The attempt' (the first option in the lists) selected before you can enable the options to show 'Whether correct', 'Specific feedback', 'General feedback', and 'Right answer'. If you choose not to let the students review the attempt, your only options are to display 'Marks' and 'Overall feedback'.

==Display==
(These settings are collapsed by default)
{|
|[[File:quizdisplay25.png|thumb|Display settings expanded]]
|}

;Decimal places in grades
:This option determines how many digits will be shown after the decimal point when the grade is displayed. A setting of 0 for example means that the grades are displayed as integers. This setting is only used for the display of grades, not for the display or marking of answers.

==Extra restrictions on attempts==
(These settings are collapsed by default nd are available by clicking "Show more")
{|
|[[File:quizextrarestrictionsonattempts25.png|thumb|Extra restrictions settings expanded]]
|}

;Require password
:This field is optional.

:If you specify a password in here then participants must enter the same password before they are allowed to make an attempt on the quiz. This is useful to give only a selected group of students access to the quiz.

;Require network address
:This field is optional.

:You can restrict access for a quiz to particular subnets on the LAN or Internet by specifying a comma-separated list of partial or full IP address numbers. This is especially useful for a proctored (invigilated) quiz, where you want to be sure that only people in a certain room are able to access the quiz. For example: 192.168. , 231.54.211.0/20, 231.3.56.211

:There are three types of numbers you can use (you can not use text based domain names like example.com):

# Full IP addresses, such as 192.168.10.1 which will match a single computer (or proxy).
# Partial addresses, such as 192.168 which will match anything starting with those numbers.
# CIDR notation, such as 231.54.211.0/20 which allows you to specify more detailed subnets.

:Spaces are ignored.

;Enforced delay between attempts
:These two fields are optional.

:You can set a time (from seconds to weeks) between the first and second attempt of a quiz. You can also (or alternatively) set a time from seconds to weeks for subsequent attempts after the second attempt. Thus, you might allow a student to take the quiz twice immediately with no delay, but if they want to improve their score with a third attempt, they are forced to wait a week and use the time for extra revision.

;Browser security
:This is by default an advanced field, visible by clicking "Show advanced".
:The options in this section offer various ways to try to restrict how students may try to 'cheat' while attempting a quiz. However, this is not a simple issue, and what in one situation is considered 'cheating' may, in another situation, just be effective use of information technology. (For example, the ability to quickly find answers using a search engine.)

::Note also that this is not just at problem of technology with a technical solution. Cheating has been going on since long before computers, and while computers make certain actions, like copy and paste, easier, they also make it easier for teachers to detect cheating - for example using the quiz reports. The options provided here are not fool-proof, and while they do make some forms of cheating harder for students, they also make it more inconvenient for students to attempt the quizzes, and they are not fool-proof.

:'''Full screen pop-up with some JavaScript security'''

:There is a limit to what the quiz, which runs on a web server, can do to restrict what the student sitting at their computer can do while attempting the quiz. However, this option does what is possible:

:* The quiz will only start if the student has a JavaScript-enabled web-browser.
:* The quiz appears in a fullscreen popup window that covers all the other windows and has no course navigation controls.

{|
|[[File:seb24.png|thumb|Student view of quiz question with full screen popup. (Click to see enlarged)]]
|}
:* The students are prevented, as far as is possible, from using facilities like copy and paste.
:* This setting does not work well with the MyMobile theme for mobile devices included in the standard installation. In particular, quiz time limits do not function correctly (MDL-32047).

:'''Require the use of Safe Exam Browser'''

:This option will only appear if your administrator has enabled it in ''Settings > Site administration > Development > Experimental > Experimental settings''.

:[[Safe exam browser|Safe Exam Browser]] is a customised web browser that must be downloaded and installed on the computer that the student uses to attempt the quiz. It restricts student use more effectively than a pop up window option. Features include full screen, without web navigation options, shortcut keys including copy and paste are disabled and of course surfing the web during an exam.

==Overall feedback==
(These setttings are collapsed by default)
{|
|[[File:quizoverallfeedback25.png|thumb|Overall feedback settings expanded]]
|}
Overall feedback is shown to a student after they have completed an attempt at the quiz. The text that is shown can depend on the grade the student got. Click "Show editing tools" to display the rich text editor, and drag the bottom right of the text box out to expand it.

For example, if you entered:

:Grade boundary: 100%
:Feedback: "Well done"
:Grade boundary: 40%
:Feedback: "Please study this week's work again"
:Grade boundary: 0%

Then students who score between 100% and 40% will see the "Well done" message, and those who score between 39.99% and 0% will see "Please study this week's work again". That is, the grade boundaries define ranges of grades, and each feedback string is displayed to scores within the appropriate range.

Grade boundaries can be specified either as a percentage, for example "31.41%", or as a number, for example "7". If your quiz is out of 10 marks, a grade boundary of 7 means 7/10 or better.

Note that the maximum and minimum grade boundaries (100% and 0%) are set automatically.

You can set as many or as few grade boundaries as you wish. The form allows you up to 5 ranges at first, but you can add more by clicking the "Add 3 fields to form" button underneath.

If you're getting confusing error messages about a boundary being out of sequence (when it's obviously *in* sequence), or "boundaries must be between 0% and 100%" (and they are) -- check that the Maximum Grade for this quiz is set to something greater than zero.

==Common module settings==
(These settings are collapsed by default)
See [[Common module settings]]

==Restrict access/Activity completion==
(These settings are collapsed by default)

The Restrict access and Activity completion settings are visible if [[Conditional activities]] and [[Activity completion]] have been enabled in the site and the course.

==Group and User overrides==

[[File:overridesquiz.png]]

Dates, timing and number of allowed attempts may be changed for individual users or groups by following the links ''Group Overrides'' or ''User Overrides'' in the Quiz Administration settings block.

===Group overrides===
To change a quiz setting for a particular group, click the "add group override" button in ''Quiz Administration>Group overrides'', make the changes you wish and save or enter another override.

===User overrides===
To change a quiz setting for a particular user or users, click the "add user override"button in ''Quiz Administration>Group overrides'', make the changes you wish and save or enter another override.

[[Image:groupuseroverride.png|groupuseroverride.png]]

==Site administration settings==

The quiz module has additional settings which may be changed by an administrator in ''Administration > Site administration > Plugins > Activity modules > Quiz''.

{{New features}}
;Auto-save period
:If enabled, student responses will be saved 1, 2, or 5 minutes (according to selection) after they have typed an answer. It will only save if the answers have been changed so will remain idle if no changes are made.

:This is useful for students who may take a long time to answer a question (like an Essay) or experience a connection problem that would previously have caused their work to be lost.

:This feature works by 'listening' for changes in the answers then starting the auto-save timer (at 60, 120 or 300 seconds). When the timer reaches zero all the answers on the page are sent to the Moodle server in the background, the student will not notice anything. The Moodle server then saves those answers that have changed. If no changes are made by the student the timer will not start and nothing will happen.

:Although there will be some additional server load it is minimal and much less than the alternative of putting one question per page to ensure frequent saves of student work.

How questions behave can be configured in ''Administration>Site administration>Plugins>Question behaviours>Manage question
behaviours''

[[de:Test konfigurieren]]

==See also==
*[http://youtu.be/MCLGZTpfG60 Moodle 2.x Quiz] MoodleBites video on YouTube
*[http://school.demo.moodle.net/mod/quiz/view.php?id=1496 School demo example of a quiz with CBM] Log into with username "parent" and password "moodle"
*[https://moodle.org/mod/forum/discuss.php?d=225920 Forum thread: Certainty based marking - too harsh?]
*[http://helderenwijzer.nl/2011/10/certainty-based-marking-in-moodle/ Blog post on CBM (Certainty Based Marking)in Moodle]

[[fr:Ajouter/modifier un test]]
[[es:Configuraciones del examen]]

Question bank

2014-06-05T01:52:03Z

Cttxg: /* See also */ Adding MoodleBites YouTube video link

{{Managing questions}}
This feature allows a teacher to create, preview, and edit questions in a database of question categories. The categories can be limited to being used on the site, course or quiz level. The questions in a category can be added to a [[Quiz module|Quiz]] or to a [[Lesson module|lesson activity]] via an export process. The teacher enters the question bank by creating or editing a quiz activity or via ''Settings > Course administration > Question bank''.

==Select a category==
Questions are organised into categories. Initially each course has only one category called "Default". It is good practice to create more categories to organize your questions. This not only makes it easier to find questions, but makes the use of random questions and matching question easier. You can create a hierarchy of categories because you can create subcategories inside parent categories. To add or edit categories click on the "[[Question categories|Categories]]" tab.

The question editing screen shows the questions from the currently selected category. You choose this category from the '''Category:''' drop-down menu. Using the tick box below that menu you determine whether to also show the questions from all subcategories.

===Categories are shared in contexts===

There are separate question category trees in each different 'context' in which questions are shared. The contexts available to you depend on whether you access the question bank from an activity or from a course and depend on the permissions assigned you for access to questions. See [[Question contexts]] for more information on these contexts.

==Add a new question==
# Click the ''Questions'' tab to access the Question Bank page, if not there already.
# From the '''Category''' drop-down menu, select a category you want to add a question to.
# The page will change to show the questions already in that category
# Select the question type you want to create from the '''Create new question''' drop-down menu.
# Fill in the form for the question type you are creating. Each [[Question types|question type]] has its own form and has its own options.
# Click ''Save Changes'' at the bottom of the form.

==Preview, Edit, Delete, and Move==
The first column in the list of questions contains a number of icons and a selection box.

Clicking on the '''Preview''' icon will open a preview window in which you can test the question. The '''Edit''' icon allows you to edit the question via the same form that you used to create it. The '''Delete''' icon deletes the question, provided it is not already in use in some activity. The selection box allows you to select a subset of questions that you can then move to another category using the controls below the list of questions. The '''move''' icon allows you to move one question at a time.

==Tips and tricks==
*Put the answer into the question name so you can quickly see the answers when students are asking for answers. This is especially useful if you're dealing with large sets of questions! (No option yet for viewing category or answer of question in the list of questions.)
*Export questions in GIFT or Moodle XML formats, then import them into a Lesson. (Future versions of Moodle will make Question bank available to both Lesson and Quiz activities.)
*Remember that while some of the same question types can be found in both the Quiz and Lesson modules, they can be very different. Scoring and grading each student's choice is more robust in a Quiz. On the other hand, each Lesson question answer also has a [[Jumps|jump]] associated it.
*Use GIFT or other export modes to print questions and answers in a category. Hint, clever use of word processor macros, using search and replace, can tidy up a GIFT file for printing.
*The question title is useful in sorting and making notes. For example, "ZZ remove 2010-3 Why did the Moodler cross", will put this question at the bottom of the list. Or where you want a 'the' questions in a category to appear in a specific order, use letters or numbers, knowing that AA will come first, AB will be second in the list.
*Do a copy and paste from a PDF file into the question content area. Reduces "other" hidden code which Word, Open Office and other programs can insert.

==Sharing and Managing Question banks==

Be default, teachers can manage only the questions in the context of the courses they are in. You can set up a role to allow teachers to share and manager questions on a larger scale.

You can also use this role to create a special system-wide "Question bank Manager" instead of giving admin level or site-wide Manager access to a person managing the Questions.

See:

*[[How to let teachers share questions between courses]]

==See also==
*[http://youtu.be/YQEx0PxRb4c Creating Quiz Questions (part 1)] MoodleBites video on YouTube
*[http://youtu.be/FGIh-5CYwzs Creating Quiz Questions (part 2)] MoodleBites video on YouTube
*[http://youtu.be/BRDbe7JcCBw Creating Quiz Questions (part 3)] MoodleBites video on YouTube

[[de:Fragensammlung]]
[[es:Banco de Preguntas]]
[[eu:Galdera-bankua]]
[[fr:Questions]]
[[ja:問題バンク]]

Quiz module

2014-06-05T01:50:26Z

Cttxg: /* See also */ Adding MoodleBites YouTube video link

{{Activities}}

The '''Quiz''' activity module allows the teacher to design and build quizzes consisting of a large variety of [[Question types]], including multiple choice, true-false, and short answer questions. These questions are kept in the [[Question bank]] and can be re-used in different quizzes.

[[Image:Quizexample.png]]

* [[Quiz settings]]
* [[Building Quiz]]
* [[Using Quiz]]
* [[Quiz reports]]
* [[Quiz FAQ]]

== Features ==

* Quizzes can be [[Quiz settings|configured]] to allow multiple attempts. Each attempt at a question is automatically marked, and the teacher can choose whether to give feedback and/or show the correct answers.
There are many ways to [[Using Quiz|use a quiz]].

* Feedback about performance and self-assessment are important parts of a learning environment. There are several ways to give feedback to students: on each question or overall. The quiz module can display feedback and scores at different times during the quiz, using the review options in the [[Quiz settings]].

* A wide variety of [[Quiz reports]] (in addition to [[Grades]]) are available for use by the teacher. Quiz reports not only can focus on a single student's attempt to answer each question, but also can perform a robust item analysis of a question's validity based upon aggregated student responses.

* A single quiz can automatically select random and/or specific questions from different [[Question bank|categories]] of questions.

* There are different options for [[Editing a quiz|scoring (marks-grades)]] individual questions in a specific quiz, [[Adding/updating_a_quiz#Grades_section|grading attempts]] for a quiz and each [[Question types|question type]].

* The quiz settings allow different [[Adding/updating_a_quiz#Display_section|display methods]]. They can randomize the questions for each student and or randomize the answers for each student.

* The teacher can determine the number of questions on each page of questions the student sees. The teacher can change the position of any question in the quiz. It is possible to put a label with information any place between questions.

* The teacher can [[Quiz settings|choose]] how questions behave during the quiz. It can be like a classic test, where the student gets no feedback while attempting the test, only later. Alternatively, Moodle can reveal the grades and/or feedback to the student during the quiz, and perhaps even give them another chance to answer the question (for fewer marks) having read the feedback.

The about list only mentions a few features of the quiz module and how it works with the question bank. Please follow the links on this page to learn more.

==See also==
*[http://www.youtube.com/watch?v=sfGlV5WaZE8 Quiz in Moodle 2.0 video]
*[https://docs.moodle.org/25/en/Word_table_format Microsoft Word table format add-on]
*[http://youtu.be/YQEx0PxRb4c Creating Quiz Questions (part 1)] MoodleBites video on YouTube
*[http://youtu.be/FGIh-5CYwzs Creating Quiz Questions (part 2)] MoodleBites video on YouTube
*[http://youtu.be/BRDbe7JcCBw Creating Quiz Questions (part 3)] MoodleBites video on YouTube

[[es:Módulo de examen]]
[[eu:Galdetegiak]]
[[ja:小テストモジュール]]
[[ru:Тест]]
[[fr:Test]]
[[pl:Quizy]]
[[de:Test]]
[[zh:測驗卷]]

Building Quiz

2014-06-05T01:49:57Z

Cttxg: /* See also */ Adding MoodleBites YouTube video link

{{Quiz}}

==How a Moodle quiz works==

The word “quiz” might conjure up for some images of TV game shows, but a Moodle quiz is basically a set of questions presented to the learner which may be automatically marked by Moodle or graded later by the teacher. The questions may be in sentence or number form or contain various media such as video or sound. They do not all need to be the same type of questions: a quiz may contain multiple choice, matching, essays (teacher-graded) and calculated. Feedback may be given at any or all stages of the process.

Once a quiz is made, that’s not the end of it. A Moodle quiz is environmentally friendly: its questions are saved in a [[Question bank]] and may be recycled for use elsewhere. Thus, Mr Brown could create a Physics Quiz with 20 questions for his class, Class Brown, and his colleague Mr Smith sharing the course could save himself valuable time by resusing 5 of Mr Brown’s questions in his own General Science quiz for Class Smith. (See also [[How to let teachers share questions between courses|Question Sharer role]] for sharing questions across the site)

If a quiz is a book, the [[Quiz settings]] are equivalent to the front cover; the quiz itself is contained within when the questions are created. (Be careful : once you have chosen the Quiz Settings, it will be “live” on your course page, unless you hide it, so your learners could potentially see a quiz with no questions, like a front cover with no content.)

Once a quiz has been added to the course and the [[Quiz settings]] established,the teacher can start to build the quiz. The teacher can access the quiz to edit the questions by clicking directly on the Quiz name on the course home page and then "Edit quiz" or by clicking the "info" link in the Navigation block. The "Edit quiz link can also be accessed from ''Settings>Quiz administration.''

{|
| [[File:editquiz.png|thumb|250px|Accessing the quiz to add or edit questions]]

|}

==Adding questions==

Once you have accessed the quiz editing screen as above, you can add questions from a number of locations:

#Click the "Add question" button to begin a new question (1 below)
#Click "Show" (2a) to reveal the contents of the question bank (2b) and then choose a pre-made question or click "Create new question" (3)
#Click "Add a random question" to add a random question, ''providing there are questions in the question bank already''.

{|
| [[File:add question.png|thumb|300px|Adding a question]]

|}

===Creating a new question===

#To make a brand new question, click "Add a question".
#From the next screen, choose the question type you want to add and click "Next"

'''NOTE:''' ''When you click on a question type on the left, helpful information appears on the right''.

#Fill in the question form, making sure to give a grade to the correct answer.
#Click "Save changes"

{|
| [[File:questionpicker.png|thumb|250px|Selecting a question type]]
| [[File:questionadded.png|thumb|250px|A question when it has been created]]

|}
====Adding responses and feedback====

{{New features}}When you add responses and feedback you can hide or display the text editor:
{|
| [[File:quizform1.png|thumb|250px|Without the editing tools]]
| [[File:quizform2.png|thumb|250px|With the editing tools]]

|}

Note that when a question has been created, an icon and words display its type (eg multiple choice) and a magnifiying glass icon allows you to preview it.

You can continue adding questions this way, clicking the "Add a question" button each time.

===Choosing a pre-made question===
If other teachers in the course have made questions, or if a teacher made questions in an earlier quiz, these can be added to the current quiz by clicking the arrows next to them in the question bank (1 below) or by checking/ticking the box of several and then clicking the button "add to quiz" (2). To ensure all previously made questions are available, make sure to tick the boxes "also show questions from sub-categories/old questions".

{|
| [[File:premadequestion.png|thumb|Using a previously made question]]

|}

===Adding a random question===
As long as you have questions in the question bank, you can add random questions to your quiz. This might be useful if you have students in a class taking a quiz at the same time, because they are unlikely to get the same questions at the same time. The same question will never appear twice in a quiz. If you include several random questions then different questions will always be chosen for each of them. If you mix random questions with non-random questions then the random questions will be chosen so that they do not duplicate one of the non-random questions. This does imply that you need to provide enough questions in the category from which the random questions are chosen, otherwise the student will be shown a friendly error message. The more questions you provide the more likely it will be that students get different questions on each attempt.

The grade for the randomly chosen question will be rescaled so that the maximum grade is what you have chosen as the grade for the random question.

You can add one or more random questions by choosing the number and category in the question bank. Note the die icon to highlight random question selection.
{|
| [[File:randomquestions.png|thumb|Adding a random question]]
| [[File:randomquestionadded.png|thumb|Random question selected for quiz]]

|}

====Quiz question tags====
Note that although it is possible to tag questions, the feature does not currently work. See forum discussion: https://moodle.org/mod/forum/discuss.php?d=194119

===Question categories===
Questions can be stored and retrieved from categories in the Question bank. When you make a new question it defaults to the category with the course name. So if you make a quiz in the Senior Physics course, questions will automatically be added to "Default for Senior Physics". You can opt to have your quiz questions in a category of their own ("Quizname") or to add a subcategory.

To add a subcategory, go to ''Administration>Quiz administration>Question bank>Categories'' For more information on question contexts and categories, see [[Question bank]]

Users will have access to different categories according to their permissions. For example, a regular teacher might only have access to question categories in his own Physics course whereas his Faculty Head of Science with permissions in all science courses might have access to question categories in Biology and Chemistry as well.

==Quiz layout==

*You can choose in '' Administration>Quiz administration>Edit settings>Layout'' whether to have a new page for every question or after a certain number of questions.
*You can click the "Add a page here" button to add a page at selected intervals and move questions up and down by clicking the arrow button.
*You can also set the pages by clicking the tab "Order and paging" on the Edit quiz screen.
*Questions may be moved up and down with the arrows, or you can check the boxes to their left and then click "reorder questions"
*You can check a box to select a question and then click "Add new pages after selected questions"
*You can "repaginate" by setting the number of questions per page. After setting the number of questions per page, you can move questions so that there are a different number of questions on each page.

{|
| [[File:paging1.png|thumb|Moving questions and adding pages]]
| [[File:orderandpaging.png|thumb|Order and paging]]
| [[File:repaginate.png|thumb|Repaginating]]
|}

==Assigning points to questions ==
''Administration > Quiz administration > Edit quiz > Editing quiz''

You can set how many points each question is worth by changing the number in the box to the right of each question (1) and you can change the maximum grade by changing the number in the box at the top of the quiz (2) The default is one point per question and 100.00 maximum grade.

{|
| [[File:gradingquiz.png|thumb|250px|Points per question and max grade]]

|}

:Tip: Each save button is independent of each other. Thus if you change 2 grade boxes and click on the "Save" button, only the grade next to that button will be saved. Your other changes will revert to what they were before. Best practice is to change the grade and save one question at a time.

The quiz module will do any maths, so for example, a 2 point question will be worth 2 times more when the Quiz module determines how many point out of 10 to award the student.

==Previewing the quiz==
*You can preview individual questions by clicking the magnifying glass icon.
*You can preview the whole quiz by clicking the "Preview" link in ''Administration>Quiz administration>Preview''
*The quiz works like a real quiz so you can see your grades and any feedback for correct/incorrect answers just as a student would see them.
{|
| [[File:previewquestion.png|thumb|200px|Previewing a single question]]
| [[File:previewquiz.png|thumb|200px|Click to preview the whole quiz]]
| [[File:quizpreviewed.png|thumb|200px|Quiz in preview mode]]
| [[File:quizincorrect.png|thumb|200px|Quiz feedback for incorrect answer]]

|}

==After quiz has been attempted==
If one or more students have taken the quiz, you will see a list of all the questions in the quiz and a notice saying that you cannot add or remove questions.

You can change the order of questions, regrade them, preview an individual question and click on an question edit link that will allow you to directly edit the question stored in the question bank.

'''NOTE:''' You can delete all quiz attempts by students and then edit the quiz as if no students had attempted it. To do this,click the quiz name and then the Results link in the Navigation block. This will present a list of students and their scores. Click "Select all" and then "Delete selected attempts".

===Dealing with faulty questions===

There are several ways to deal with "bad" questions in a quiz.
::*Change the grade for the bad question to 0 in the quiz.
::*Edit the question, changing what you will accept as a correct answer, then regrading the exam. Remember when changing a question that the next time it is used it will be as it was in the last edit. Also, regrading will only affect one quiz at a time.
::*You can edit the question to explain the situation to the student and then you can set the grade for the question to zero. After you make such changes you should regrade the quiz by clicking on the '''Results''' tab and then the '''Regrade''' tab. This will change the grade for all students who have taken the quiz so far. Remember, if the question is used by another quiz, your "explanation" will appear as part of that quiz.
::*You can change the grade for the bad question and then move or delete the question from your question category. The question will still appear on the quiz. Some places do not like to delete any question, but will move them to a "dead" or "bad" question category.
::*When you discover a bad question in your quiz, it may affect the question bank. Remember that a final might be made up of a certain number of random questions drawn from different question categories, the same categories used in a smaller subject quiz. It can be very important do something about bad or invalid questions in a question category when the categories are use in other places.

==See also==
*[[Questions]] in [[Managing a Moodle course]]
*[http://youtu.be/YQEx0PxRb4c Creating Quiz Questions (part 1)] MoodleBites video on YouTube
*[http://youtu.be/FGIh-5CYwzs Creating Quiz Questions (part 2)] MoodleBites video on YouTube
*[http://youtu.be/BRDbe7JcCBw Creating Quiz Questions (part 3)] MoodleBites video on YouTube

[[de:Test erstellen]]
[[es:Construyendo un examen]]

Quiz module

2014-06-05T01:48:34Z

Cttxg: /* See also */ Adding MoodleBites YouTube video link

{{Activities}}

The '''Quiz''' activity module allows the teacher to design and build quizzes consisting of a large variety of [[Question types]], including multiple choice, true-false, and short answer questions. These questions are kept in the [[Question bank]] and can be re-used in different quizzes.

[[Image:Quizexample.png]]

* [[Quiz settings]]
* [[Building Quiz]]
* [[Using Quiz]]
* [[Quiz reports]]
* [[Quiz FAQ]]

== Features ==

* Quizzes can be [[Quiz settings|configured]] to allow multiple attempts. Each attempt at a question is automatically marked, and the teacher can choose whether to give feedback and/or show the correct answers.
There are many ways to [[Using Quiz|use a quiz]].

* Feedback about performance and self-assessment are important parts of a learning environment. There are several ways to give feedback to students: on each question or overall. The quiz module can display feedback and scores at different times during the quiz, using the review options in the [[Quiz settings]].

* A wide variety of [[Quiz reports]] (in addition to [[Grades]]) are available for use by the teacher. Quiz reports not only can focus on a single student's attempt to answer each question, but also can perform a robust item analysis of a question's validity based upon aggregated student responses.

* A single quiz can automatically select random and/or specific questions from different [[Question bank|categories]] of questions.

* There are different options for [[Editing a quiz|scoring (marks-grades)]] individual questions in a specific quiz, [[Adding/updating_a_quiz#Grades_section|grading attempts]] for a quiz and each [[Question types|question type]].

* The quiz settings allow different [[Adding/updating_a_quiz#Display_section|display methods]]. They can randomize the questions for each student and or randomize the answers for each student.

* The teacher can determine the number of questions on each page of questions the student sees. The teacher can change the position of any question in the quiz. It is possible to put a label with information any place between questions.

* The teacher can [[Quiz settings|choose]] how questions behave during the quiz. It can be like a classic test, where the student gets no feedback while attempting the test, only later. Alternatively, Moodle can reveal the grades and/or feedback to the student during the quiz, and perhaps even give them another chance to answer the question (for fewer marks) having read the feedback.

The about list only mentions a few features of the quiz module and how it works with the question bank. Please follow the links on this page to learn more.

==See also==
*[http://www.youtube.com/watch?v=sfGlV5WaZE8 Quiz in Moodle 2.0 video]
*[https://docs.moodle.org/25/en/Word_table_format Microsoft Word table format add-on]
http://youtu.be/YQEx0PxRb4c Creating Quiz Questions (part 1)
http://youtu.be/FGIh-5CYwzs Creating Quiz Questions (part 2)
http://youtu.be/BRDbe7JcCBw Creating Quiz Questions (part 3)

[[es:Módulo de examen]]
[[eu:Galdetegiak]]
[[ja:小テストモジュール]]
[[ru:Тест]]
[[fr:Test]]
[[pl:Quizy]]
[[de:Test]]
[[zh:測驗卷]]

Question bank

2014-06-05T01:47:34Z

Cttxg: Adding MoodleBites YouTube video link

{{Managing questions}}
This feature allows a teacher to create, preview, and edit questions in a database of question categories. The categories can be limited to being used on the site, course or quiz level. The questions in a category can be added to a [[Quiz module|Quiz]] or to a [[Lesson module|lesson activity]] via an export process. The teacher enters the question bank by creating or editing a quiz activity or via ''Settings > Course administration > Question bank''.

==Select a category==
Questions are organised into categories. Initially each course has only one category called "Default". It is good practice to create more categories to organize your questions. This not only makes it easier to find questions, but makes the use of random questions and matching question easier. You can create a hierarchy of categories because you can create subcategories inside parent categories. To add or edit categories click on the "[[Question categories|Categories]]" tab.

The question editing screen shows the questions from the currently selected category. You choose this category from the '''Category:''' drop-down menu. Using the tick box below that menu you determine whether to also show the questions from all subcategories.

===Categories are shared in contexts===

There are separate question category trees in each different 'context' in which questions are shared. The contexts available to you depend on whether you access the question bank from an activity or from a course and depend on the permissions assigned you for access to questions. See [[Question contexts]] for more information on these contexts.

==Add a new question==
# Click the ''Questions'' tab to access the Question Bank page, if not there already.
# From the '''Category''' drop-down menu, select a category you want to add a question to.
# The page will change to show the questions already in that category
# Select the question type you want to create from the '''Create new question''' drop-down menu.
# Fill in the form for the question type you are creating. Each [[Question types|question type]] has its own form and has its own options.
# Click ''Save Changes'' at the bottom of the form.

==Preview, Edit, Delete, and Move==
The first column in the list of questions contains a number of icons and a selection box.

Clicking on the '''Preview''' icon will open a preview window in which you can test the question. The '''Edit''' icon allows you to edit the question via the same form that you used to create it. The '''Delete''' icon deletes the question, provided it is not already in use in some activity. The selection box allows you to select a subset of questions that you can then move to another category using the controls below the list of questions. The '''move''' icon allows you to move one question at a time.

==Tips and tricks==
*Put the answer into the question name so you can quickly see the answers when students are asking for answers. This is especially useful if you're dealing with large sets of questions! (No option yet for viewing category or answer of question in the list of questions.)
*Export questions in GIFT or Moodle XML formats, then import them into a Lesson. (Future versions of Moodle will make Question bank available to both Lesson and Quiz activities.)
*Remember that while some of the same question types can be found in both the Quiz and Lesson modules, they can be very different. Scoring and grading each student's choice is more robust in a Quiz. On the other hand, each Lesson question answer also has a [[Jumps|jump]] associated it.
*Use GIFT or other export modes to print questions and answers in a category. Hint, clever use of word processor macros, using search and replace, can tidy up a GIFT file for printing.
*The question title is useful in sorting and making notes. For example, "ZZ remove 2010-3 Why did the Moodler cross", will put this question at the bottom of the list. Or where you want a 'the' questions in a category to appear in a specific order, use letters or numbers, knowing that AA will come first, AB will be second in the list.
*Do a copy and paste from a PDF file into the question content area. Reduces "other" hidden code which Word, Open Office and other programs can insert.

==Sharing and Managing Question banks==

Be default, teachers can manage only the questions in the context of the courses they are in. You can set up a role to allow teachers to share and manager questions on a larger scale.

You can also use this role to create a special system-wide "Question bank Manager" instead of giving admin level or site-wide Manager access to a person managing the Questions.

See:

*[[How to let teachers share questions between courses]]

==See also==
http://youtu.be/YQEx0PxRb4c Creating Quiz Questions (part 1)
http://youtu.be/FGIh-5CYwzs Creating Quiz Questions (part 2)
http://youtu.be/BRDbe7JcCBw Creating Quiz Questions (part 3)

[[de:Fragensammlung]]
[[es:Banco de Preguntas]]
[[eu:Galdera-bankua]]
[[fr:Questions]]
[[ja:問題バンク]]

Installing add-ons

2014-06-05T01:35:16Z

Cttxg: /* See also */ Adding MoodleBites YouTube video link

{{Installing Moodle}}
An add-on is an optional plugin for adding additional features and functionality to Moodle, such as new activities, new quiz question types, new reports, integrations with other systems and many more.

==What is meant by the words 'plugin' and 'add-on'?==

Moodle = core code + plugins

Plugins may be either standard plugins (included in the Moodle download package) or add-ons.

== Considerations for production sites (skip if you're just moodling) ==

'''VERY IMPORTANT''' Warning: Please be aware that some add-ons have not been reviewed, and the quality and/or suitability for your Moodle site has not been checked. Please be careful. It may not do what you expect, it may have serious security issues or it may even not work at all. This is however improving over time with the evolving new plugins directory system.

* If you have a large site for production purposes consider if you '''really''' need the add-on? More functionality means more things to support, more things to (potentially) go wrong and more things to worry about at upgrade time.
* Is the add-on supported and maintained? If something goes wrong can you get support? Will bugs be fixed?
* If the add-on does not work in a future version of Moodle, what will you do about it?
* Beware of ''patches'' ([https://moodle.org/plugins/browse.php?list=category&id=38 Moodle Plugins Directory Other category]) ! If an add-on modifies or replaces core files then be very careful. It can only be guaranteed to work with the exact build (version) of Moodle it was created for and is highly unlikely to survive a Moodle upgrade.

==Installing an add-on==

To install an add-on, its source code must be put (deployed) into the appropriate location inside the Moodle installation directory and the main administration page ''Administration > Site administration > Notifications'' must be visited. There are three ways how the add-on code can be deployed into Moodle.

{{New features}}In Moodle 2.5 onwards, an add-on code may be deployed from within Moodle, either directly from the Moodle plugins directory or by uploading a ZIP file. The web server process has to have write access to the plugin type folder where the new add-on is to be installed in order to use either of these methods.

Alternatively, an add-on code may be deployed manually at the server.

===Installing directly from the Moodle plugins directory===

# Login as an admin and go to ''Administration > Site administration > Plugins > Install add-ons''.
# Click the button 'Install add-ons from Moodle plugins directory'.
# Search for a plugin with an Install button (i.e. suitable for 2.5), click the Install button then click Continue.
# Check that you obtain a 'Validation passed!' message, then click the button 'Install add-on'.

===Installing via uploaded ZIP file===

# Go to the [https://moodle.org/plugins Moodle plugins directory], select Moodle 2.5 as version, then choose an add-on with a Download button and download the ZIP file.
# Login to your Moodle site as an admin and go to ''Administration > Site administration > Plugins > Install add-ons''.
# Upload the ZIP file, select the appropriate plugin type, tick the acknowledgement checkbox, then click the button 'Install add-on from the ZIP file'.
# Check that you obtain a 'Validation passed!' message, then click the button 'Install add-on'.

{|
| [[File:install add-ons.png|thumb|Install add-ons]]
| [[File:add-on package validation.png|thumb|Add-on package validation]]
|}

For both of the above methods, after clicking the button 'Install add-on', you will then be automatically redirected to ''Settings > Site administration > Notifications'' and the installation process (i.e. creating required database tables etc) will happen.

===Installing manually at the server===

If you can't deploy the add-on code via the administration web interface, you have to copy it to the server file system manually (e.g. if the web server process does not have write access to the Moodle installation tree to do this for you).

First, establish the correct place in the Moodle code tree for the add-on type. Common locations are:

* /path/to/moodle/theme/ - themes
* /path/to/moodle/mod/ - activity modules and resources
* /path/to/moodle/blocks/ - sidebar blocks
* /path/to/moodle/question/type/ - question types
* /path/to/moodle/course/format/ - course formats
* /path/to/moodle/admin/report/ - admin reports

See [[:dev:Plugins]] for the full list of all plugin types and their locations within the Moodle tree.

# Go to the [https://moodle.org/plugins Moodle plugins directory], select Moodle 2.5 as version, then choose an add-on with a Download button and download the ZIP file.
# Upload or copy it to your Moodle server.
# Unzip it in the right place for the plugin type (or follow add-on instructions).
# In your Moodle site (as admin) go to ''Settings > Site administration > Notifications'' (you should, for most plugin types, get a message saying the add-on is installed).

Note: The add-on may contain language files. They'll be found by your Moodle automatically. These language strings can be customized using the standard ''Settings > Site administration > Language'' editing interface. If you get a "Database error" when you try to edit your language files, there is a strong chance that the language files included within the downloaded ZIP file of this add-on have a coding problem. If you delete the ''plugin_name/lang/other_language_different_to_English/'' folder with the new language strings and the database error disappears, this is indeed the case. Please notify the plugin maintainer, so that it can be fixed in future releases.

==Troubleshooting==

===Errors===

If you obtain an error, please [[Debugging|turn debugging on]] to obtain additional information about the cause of the error.

;tool_installaddon/err_curl_exec - cURL error 60 : This suggests problems with the validation of the SSL certificate of the remote (moodle.org) site. This is also a known problem in Moodle Windows 7 servers running the Moodle package for Windows. See [[SSL certificate for moodle.org]] for more info and possible solutions.

===When installing manually===

* Check the file permissions. The web server needs to be able to read the plugin files. If the the rest of Moodle works then try to make the plugin permissions and ownership match.
* Did you '''definitely''' unzip or install the add-on in the correct place?
* Because Moodle scans plugin folders for new plugins you cannot have any other files or folders there. Make sure you deleted the zip file and don't try to rename (for example) an old version of the plugin to some other name - it will break.
* Make sure the directory name for the plugin is correct. All the names '''have''' to match. If you change the name then it won't work.

===Obtaining help===

Ask in the appropriate forum in [http://moodle.org/course/view.php?id=5 Using Moodle]. Make sure you describe your system (including versions of MySQL, PHP etc.), what you tried and what happened. Copy and paste error messages exactly. Provide the link to the version of the add-on you downloaded (some have very similar names).

==Uninstalling an add-on==

To uninstall an add-on
# Go to ''Administration> Site Administration > Plugins > Plugins overview'' and click the Uninstall link opposite the add-on you wish to remove
# Use a file manager to remove/delete the actual plugin directory as instructed, otherwise Moodle will reinstall it next time you access the site administration

Note: Certain plugin types offer the removal from the disk as well, though not yet all.

==Plugins overview==

[[File:plugins overview.png|thumb|left|Plugins overview highlighting available update with install button]]The Plugins overview page in ''Administration > Site Administration > Plugins > Plugins overview'' lists all installed plugins, together with the version number, availability (enabled or disabled) and settings link (if applicable).

A 'Check for available updates' button enables admins to quickly check for any updates available to standard plugins or add-ons installed on the site (from the [http://moodle.org/plugins plugins directory]). Any updates available are highlighted, with further information and a download link in the notes column opposite the plugin.

===Plugin updating from within Moodle===

In Moodle 2.4 onwards, an administrator can enable updates deployment in ''Administration > Site Administration > Server > Update notifications''. Then when updates are available, 'Install this update' buttons are shown on the Plugins overview page. See [[Automatic updates deployment]] for more details.

==Preventing installing add-ons from within Moodle==

If required, installing and updating from within Moodle can be prevented by copying the following lines of code from config-dist.php and pasting them in config.php.

// Use the following flag to completely disable the On-click add-on installation
// feature and hide it from the server administration UI.
//
// $CFG->disableonclickaddoninstall = true;

==See also==

* [[Notifications]] for further details of update notifications
* [[Add-on Review Criteria]]
* [[Add-on FAQ]]
* Using Moodle [http://moodle.org/mod/forum/view.php?id=44 General add-ons forum]
* [[Installing Moodle from Git repository#Installing a contributed extension from its Git repository|Installing a contributed extension from its Git repository]]
* [http://www.somerandomthoughts.com/blog/2013/05/07/managing-add-ons-in-moodle-2-5/ Managing add-ons in Moodle 2.5] blog post by Gavin Henrick
*[http://youtu.be/RxlmVzIllVk Moodle 2 Plugins Administration] MoodleBites video on YouTube

For developers:

*[[:dev:Category:Plugins|Plugins developer documentation]]
*[[:dev:Plugin validation]]
*[[:dev:On-click add-on installation]]

[[Category:Contributed code]]

[[de:Plugins installieren]]
[[es:Instalando plugins]]

Page resource settings

2014-06-05T01:29:18Z

Cttxg: Adding MoodleBites YouTube video link

{{Page}}
==Adding a new page to your course==

*From the the "Add an activity or resource" link (or, if not present, the "Add a resource" drop down menu),choose [[Page]] All settings may expanded by clicking the "Expand all" link top right.
*In the "Adding a new page" screen that follows, give your page a name and a description (which may or may not be required according to admin settings)
*Add your content to the Page content section.

==General==

{|
|[[File:pagegeneral25.png|thumb|General settings expanded by default]]
|}
===Name===
Whatever you type here will form the link learners click on to view the page so it is helpful to give it a name that suggests its purpose.
===Description===
Add a description of your page here. Click "Show editing tools" to display the rich text editor, and drag the bottom right of the text box out to expand it.
===Display description on the course page===
If this box is ticked, the description will appear on the course page just below the name of the page.

==Content==
{|
|[[File:pagecontent25.png|thumb|Content settings expanded by default]]
|}
Add your page content here. You can use the features of the [[Text editor|Text editor]] to add media, images, links and more.

==Appearance==
(These settings are collapsed by default.)
{|
|[[File:pageappearance252.png|thumb|Appearance settings expanded]]
|}

Choose here whether or not to display the page name and/or description along with the page content when a user clicks on the page.

If the administrator has allowed both 'open' and 'pop-up' as display options (''from Administration>Site administration>Plugins>Activity modules>Page''), you will have additonal display settings here.

==Common module settings==
See [[Common module settings]]
==Restrict access/Activity completion==
(These settings are collapsed by default)

These settings are visible if [[Conditional activities]] and [[Activity completion]] have been enabled in the site and the course.

==Page module capabilities==

* [[Capabilities/mod/page:view|View page content]]
* [[Capabilities/mod/page:addinstance|Add a new page]]

==Site administration settings==

The page module has additional settings which may be changed by an administrator in ''Administration > Site administration > Plugins > Activity modules > Page''.

===Require activity description===
This setting allows you to turn off the requirement for users to type something into the description box.

===Available display options===
This setting allows you to add different ways the resource may be displayed on the course page.

===Default values for activity settings===

Here you can set the defaults for this resource. You can also choose which setting(s) to class as "Advanced". These settings will only then appear if the user clicks "Show advanced" in the settings.

==See also==
*[http://youtu.be/LGXmnk59BQM Moodle 2.x Adding Content - Page ] MoodleBites video on YouTube

[[de:Textseite konfigurieren]]

Advanced features

2014-06-05T01:25:58Z

Cttxg: Adding MoodleBites YouTube video link

{{Managing a Moodle site}}
The Advanced features screen in ''Settings > Site administration > Advanced features'' contains a number of features that may be enabled/disabled globally by the site administrator.

* [[Outcomes]]
* [[Comments]]
* [[Tags|Tags functionality]]
* [[Notes]]
* [[Portfolios]]
* [[Web services]]
* [[Messaging]]
* [[Statistics]]
* [[RSS feeds]]
* [[Blogs]]
* [[MNet|Networking]]
* [[Activity completion|Completion tracking]]
* [[Conditional_activities|Conditional access]]
* [[Plagiarism Prevention|Plagiarism plugins]]
* [[Badges]] (new in 2.5)

==Show advanced==
Note: Many pages have a "Show advanced" button which reveals extra options for the user to select from. This is not connected to the Advanced features screen.
==See also==
*[http://youtu.be/d3D77TfI8wA Moodle 2.0 Notifications, Register and Advanced features] MoodleBites video on YouTube

[[eu:Funtzio_aurreratuak]]
[[de:Zusatzoptionen]]
[[fr:Fonctions avancées]]

Site registration

2014-06-05T01:24:30Z

Cttxg: /* See also */ Adding MoodleBites YouTube video link

{{Server settings}}
==Moodle.org registration==

[[Image:Registration.png|thumb|Moodle.org registration]]An administrator can register their site with moodle.org in ''Administration > Site Administration > Registration''.

When you register your site with Moodle.org

* You are added to a low-volume mailing list for important notifications such as security alerts and new releases of Moodle
* Statistics about your site will be added to the statistics of the worldwide Moodle community http://moodle.org/stats/
* Your site is also registered with [http://moodle.net/ Moodle.net], allowing users with the [[Capabilities/moodle/course:publish|publish courses capability]] (by default only managers) the option of publishing courses to Moodle.net

If you wish, you can choose for your site to be listed in http://moodle.org/sites/.

To register your site:

# Go to ''Administration > Site Administration > Registration''
# Click the 'Register with moodle.org now' button
# Review the registration information, amending as necessary
# Click the 'Update registration on moodle.org' button at the bottom of the page

After registering, Moodle.net will be listed on ''Administration > Site administration > Server > Hubs''.

You may change the registration information at any time by updating your registration.

Updated site statistics are sent to moodle.org automatically every 7 days.

Note: it can sometimes take a little while (some days) for information to appear on http://moodle.org/sites

Note: Only sites which are publicly available on the Internet are eligible to be registered.

==Registering with other hubs==

An administrator can register their site with other community hubs in ''Administration > Site administration > Server > Hubs''.

A public hub may be selected from the list or a private hub URL and password may be entered.

If you add the [[Community finder block]] to courses on your site, teachers, non-editing teachers and managers (and any other users with the capability [[Capabilities/moodle/community:add|moodle/community:add]]) will be able to access the hub and search for courses for download or to enrol in.

== Unregistering from a hub==

You may unregister from a hub at any time by clicking the unregister button. You will then be given the option to remove all courses currently being advertised on the hub and remove all courses that were uploaded to the hub.

==See also==
*[http://youtu.be/d3D77TfI8wA Moodle 2.0 Notifications, Register and Advanced features] MoodleBites video on YouTube

*[[Usage]] for how statistics about Moodle sites are collected and maintained
* [[Community hub]]
* [[Moodle.net FAQ]]

[[Category:Hub]]

[[ja: サイト登録]]
[[de:Moodle-Site registrieren]]
[[es:Registro del sitio]]

Notifications

2014-06-05T01:23:26Z

Cttxg: /* See also */ Adding MoodleBites YouTube video link

{{Security}}
==Update notifications==

An administrator can configure update notifications for both Moodle core code and any contributed plugins installed on the site in ''Settings > Site Administration > Server > Update notifications''. See [[Available update notifications]] for more details.

==Login failure notifications==

An administrator can set up login failure notification in ''Settings > Site Administration > Security > Notifications''.

===Display login failures to===

Set this to administrators to be warned of anyone attempting to steal student or teacher logins. When set, a link stating the number of failed logins appears in the top right corner of the page when an administrator logs in. Click the link to access the login error page.

===Email login failures===

If you're concerned about login failures, you can set up email notification for administrators or any/all users who can change the site configuration.

===Threshold for email notifications===

This sets the number of failed logins for a given user from a single computer that will trigger notification.

Note: The number of failed login attempts that result in account lockout may be set in ''Administration > Site administration > Security > Site policies'' (new in 2.5).

==Other notifications==

The version of Moodle used may be found in ''Settings > Site administration > Notifications''.

Other notifications listed on the page may include

* [[Upgrade warnings|"Alpha" development code warning]]
* [[Cron]] not run for at least 24 hours
* Database tables are using MyISAM database engine - see [[Migration from MyISAM to InnoDB]] for advice on what to do
* "Enabling the PHP setting display_errors is not recommended on production sites because some error messages may reveal sensitive information about your server." What you do about this is not explained. Making a php.ini file with "display_errors = off;" in it in the folder "with the script" (?) is one suggestion found by googling, but that may depend on your server.
* Site not yet [[Site registration|registered]]

==See also==
*[http://youtu.be/d3D77TfI8wA Moodle 2.0 Notifications, Register and Advanced features] MoodleBites video on YouTube

* [[:dev:Available update notifications|Available update notifications developer documentation]]

[[es:Notificaciones]]
[[eu:Jakinarazpenak]]
[[fr:Notifications]]
[[de:Benachrichtigungen]]
[[ja:通知]]

My home

2014-06-05T01:17:31Z

Cttxg: /* See also */ Adding MoodleBites YouTube video link

{{Site appearance}}
==My home==
My home is a customisable "dashboard" page for providing users with links to their courses and activities within them, such as unread forum posts and upcoming assignments.

My home usually has the [[Course overview block]] in the central column. Users can customize their My home page and add and remove blocks by clicking the 'Customise this page' button.

{|
|[[File:My home.png|thumb|My home]]
|[[File:Customising my home.png|thumb|Customising My home]]
|}

The navigation block includes a My home link directly above or below the Site home link. Once a regular user is logged in, the My courses link will also take them to their My home page.

==Default home page==

An administrator can set My home as the default home page for all logged-in users by selecting 'My home' as default home page in ''Settings > Site administration > Appearance > Navigation''.

If 'User preference' is selected as default home page, each user needs to navigate to either the 'Home Page' or the 'My home' page then via the ''Settings > My profile settings'' click the "Make this my default home page" link. Note that this option only appears on the page that is not their current default home page. Once selected, Moodle will remember which page to present them each time they log on.

Users with the Site administrator role cannot set My home as their default home page.

==Setting the default My home page for new users==

An administrator or manager (or other user with the capability [[Capabilities/moodle/my:configsyspages|moodle/my:configsyspages]]) can set which content (course overview, calendar, blocks) appears on the My home page for new users as follows:

# Access ''Settings > Site administration > Appearance > Default My home page''
# Select the required blocks from the "Add a block" drop-down menu. [[Block settings|Configure]] each block as desired
# Reposition blocks using the arrow icons in the block headers

==Adding a block to the My home page for all users==

An administrator can add a new block to the My home page for all existing users (not only new users) as follows:

# Turn editing on for the front page
# Add the block to the front page
# Edit where the block appears and set the page contexts to 'Display throughout the entire site'
# Go to your My home page and again edit where the block appears and set 'Display on page types' to 'My home page'

==Preventing users from customizing their My home page==

By default, users can customize their My home page and add blocks. An admin can prevent this as follows:

# Go to ''Settings > Site administration > Users > Permissions > Define roles''
# Edit the authenticated user role and untick the [[Capabilities/moodle/my:manageblocks|Manage My home page blocks capability]]

==My Moodle capabilities==

* [[Capabilities/moodle/my:manageblocks|Manage My home page blocks]] (see above)
* [[Capabilities/moodle/my:configsyspages|Configure system templates for My home pages]]

In addition, all blocks which may be added to a My home page have a ''myaddinstance'' capability (e.g. [[Capabilities/block/comments:myaddinstance|block/comments:myaddinstance]]) for controlling whether a user with a particular role can add the block.

==Preventing users from adding a block to their My home page==

By default, users can add many blocks to their My home page. An admin can prevent them from adding a particular block, such as the [[Online users block]], as follows:

# Go to ''Administration > Site administration > Users > Permissions > Define roles''
# Edit the authenticated user role and untick the [[Capabilities/block/online users:myaddinstance|Add a new online users block to the My home page capability]]

==Blocks not available on My home==

The following blocks may not be added to a user's My home page (because it wouldn't make sense):

*[[Course completion status block]]
*[[Course/site summary block]]
*[[Self completion block]]

==See also==

* [http://www.youtube.com/watch?v=un_pBYkeXXI My Home in Moodle 2.0 video]
*[Moodle 2.0 My Home http://youtu.be/5hD6l3xdSMI] MoodleBites video on YouTube

Using Moodle forum discussions:
* [http://moodle.org/mod/forum/discuss.php?d=168292 Latest news on My Moodle]

[[eu:Nire_Moodle]]
[[fr:Mon Moodle]]
[[de:Meine Startseite]]

Location

2014-06-05T01:08:43Z

Cttxg: Adding MoodleBites YouTube video link

{{Admin tools}}
==Location settings==
An administrator can change the following location settings in ''Administration > Site administration > Location > Location settings''.

====Default timezone====
This sets the default time zone for date display.

====Force default timezone====
Pull down menu to force the user to be in a specific timezone or allow users to individually select their timezone.

====Default country====
Select the country to appear by default on a new user account page form.

===IP address lookup===
====GeoIP City data file====
Location of GeoIP City binary data file. This is a non-invasive way to determine geographical and other information about Internet visitors in real-time. This file is not part of Moodle distribution and must be obtained separately from MaxMind. There is a GeoIPLite version for free.

====Google Maps API key====
Google Maps for IP address lookup visualization key. The Google Maps API lets you embed Google Maps with JavaScript. This is free.

'''NOTE:''' There is no longer support for Google maps API V2 as it has been deprecated since 2010. V3 is now used. See here for details: https://developers.google.com/maps/documentation/javascript/tutorial#api_key

After updating the information in this section, IP's that are displayed as a link, such as in reports, when clicked will open new window with a Google Map indicating the location of the IP, if found and if not a private address.

==Update timezones==

The update timezones page ''Administration > Site administration > Location > Update timezones'' provides administrators with the option to update their local database with new information about world timezones. This is important because of daylight saving changes that many countries use.

If the update is completed with success, Moodle will inform you how many entries were updated and which location was used as a source.

==See also==
*[http://youtu.be/L-_2N9gIiLo Moodle 2 Administration - Location] MoodleBites video on YouTube

[[es:Localización]]
[[eu:Kokagunea]]

Lesson settings

2014-06-05T00:50:33Z

Cttxg: /* See also */ Adding MoodleBites YouTube video link

{{Lesson}}
=Lesson administration settings=

This page explains the settings involved when first creating a lesson.
To add a lesson to your Moodle course page:
*With the editing turned on, in the section you wish to add your lesson, click the "Add an activity or resource" link (or, if not present, the "Add an activity" drop down menu) and choose ''Lesson'' All settings may expanded by clicking the "Expand all" link top right.

==General==
{|
|[[File:lessongeneral25.png|thumb|General settings expanded by default]]
|}

===Name===
Whatever you type here will form the link learners click on to view the lesson so it is helpful to give it a name that suggests its purpose.

==Appearance==
(These settings are collapsed by default)
{|
|[[File:lessonappearance25.png|thumb|Appearance settings expanded]]
|}
===File pop===
If you want to include a link to a file on the lesson page for students to refer to, upload it here.

===Progress bar===
Choose this to show a bar at the bottom of the page showing how far into the lesson the student has got.
===Display ongoing score===
Choose this to let students see their score as they work through the lesson.
===Display left menu===
Choose this if you want to show a list of the pages in the Lesson so a student can see what is coming up.
===Minimum grade to display menu===
Choose this if you want the student to go through the lesson once and get a grade before they can (on review) see and navigate through all the different pages.
===Slideshow===
Please note that slideshow mode currently does not work for Moodle 2. There is a tracker issue and patch here MDL-36673
===Maximum Number of Answers===
Here you can set the default number of answer boxes available when you add your question or content pages. For instance, if you are only going to use True/False, you would only need 2. You can change this at any time so it's not crucial.
===Use default feedback===
Choose this if you want to show a set phrase regardless of their answer. If you have set your own default feedback such as "well done; correct" or "never mind; better luck next time" etc it will appear. If you have not, then Moodle's default feedback will appear.

===Link to next activity===
Choose this to give students a link to another activity when they reach the end of the lesson. ''(Note: this can also be achieved using [[Conditional activities]])''
==Availability==
(These settings are collapsed by default)
{|
|[[File:lessonavailability25.png|thumb|Availability settings expanded]]
|}
===Available from/Deadline===
Here you can set a start and end date and time for your Lesson.
===Time limit===
[[Image:Lesson Timer.png|right]]
This allows you to set a time limit on the lesson. Students will see a countdown counter as they work. The timer does not stop them doing the lesson when the time is up, but correct answers are no longer scored.

===Password protected lesson===
*Change to "Yes" and enter the password if you want students only to access it when they know the password.
==Prerequisite lesson==
(These setings are collapsed by default)
{|
|[[File:prerequisitelesson25.png|thumb|Prerequisite lesson settings expanded]]
|}

===Dependent on===
This allows access to the lesson to be dependent on students' performance in another lesson in the same course. ''(Note: this can also be achieved with [[Conditional activities]])''
===Time spent===
Decide here how long you want the student to have spent in the chosen previous lesson
===Completed===
Check this box if you want the student to have completed a previous lesson (according to [[Activity completion]] settings)
===Grade better than===
Enter the grade from the previous lesson which you want the student to have exceeded before they can attempt the current lesson.

==Flow control==
(These settings are collapsed by default)
{|
|[[File:lessonflowcontrol25.png|thumb|Flow control settings expanded]]
|}

===Allow Student Review===
This puts a "Review Lesson" button on the last screen of the lesson to encourage the student to navigate through the lesson again from the start. Be sure to check other settings to allow them to change their answers.
===Provide option to try a question again===
*This displays a button after an incorrectly answered question so that the student can try again (but not get credit for it)
:''TIP:'' Leave this off if you are using essay questions.
===Maximum Number of Attempts===
*Decide here how many times you want students to be able to attempt each question. When they reach the maximum, they will be taken automatically to the next page.
===Action after a Correct Answer===
Choose here where you want a student to be sent to if they get a question right. See [[Using Lesson]] for more details on this setting. The options are:
**the next part of the Lesson (default setting)
**a random, unexpected page
**a random page which they have not yet answered.
===Number of pages to show===
You only need this if you have set "Action after a correct answer" to show an unseen or unanswered page. Otherwise, all pages will be seen

==Grade==
(These settings are collapsed by default.)
{|
|[[File:lessongrade25.png|thumb|Grade settings expanded]]
|}

Set a grade and grade category here.

===Practice lesson===
Use this if you don't need the lesson to be scored/graded but just need students to work through some pages. Set this to Yes to have the same ungraded type Lesson in earlier versions of Moodle.

===Custom Scoring===
Use this to give a particular number score (negative or positive) to each answer
===Re-takes allowed===
Choose this if you want your students to be able to do the lesson more than once.
====Handling of re-take====
If you allow your students to re-take the lesson, then decide here if the grade for all lesson attempts is the mean or the maximum.

:Note that the Question Analysis always uses the answers from the first tries of the lesson. Re-takes by students are ignored.
===Minimum Number of Questions===
Set here the minimum number of questions that will be used to calculate a student's score. Students will be told how many they have answered and how many more they need to answer.
*If you are using Content pages, then set this to 0.
*If you use this setting, then add some explanatory text at the start of the lesson so the student knows how many questions they must answer as a minimum. (They may answer more.

==Common module settings==
(These settings are collapsed by default.)

See [[Common module settings]]
==Restrict access/Activity completion==
(These settings are collapsed by default)

The Restrict access and Activity completion settings are visible if [[Conditional activities]] and [[Activity completion]] have been enabled in the site and the course.

==Site administration settings==

The lesson module has additional settings which may be changed by an administrator in ''Settings > Site administration > Plugins > Activity modules > Lesson''.

'''NOTE:''' ''The slideshow settings below do not work. See MDL-36673''

===Slideshow width===
Sets the width of the slideshow only when this feature is enabled in a Lesson's "Change settings".
*Variable name: lesson_slideshowwidth, Default 640.

===Slideshow height===
Sets the height of the slideshow only when this feature is enabled in a Lesson's "Change settings".
*Variable name: lesson_slideshowheight, Default 480.

===Slideshow background colour===
Background colour to for the slideshow if it is enabled.
*Variable name: lesson_slideshowbgcolor, Default #FFFFFF.

===Popup window width===
Sets the width of the popup displayed for a linked media file
*Variable name: lesson_mediawidth, Default 640.

===Popup window height===
Sets the height of the popup displayed for a linked media file
*Variable name: lesson_mediaheight, Default 480.

===Show close button:===
Displays a close button as part of the popup generated for a linked media file
*Variable name: lesson_mediaclose, Default No.

===Number of high scores displayed===
Sets the number of high scores to display
*Variable name: lesson_maxhighscores, Default: 10

===Maximum number of answers===
Default maximum number of answers per page for site
*Variable name: lesson_maxanswers, Default: 4.

===Action after correct answer===
The default action to take after a correct answer
*Variable name: lesson_defaultnextpage, Default: Normal - follow lesson path

==See also==
*[http://youtu.be/cUDV0WE5ZYY Moodle 2.x Lesson (part 1)] MoodleBites video on YouTube
*[http://youtu.be/Mfj-8w-Ze0A Moodle 2.x Lesson (part 2)] MoodleBites video on YouTube
*[http://youtu.be/jXjqHtgC9c0 Moodle 2.x Lesson (part 3)] MoodleBites video on YouTube

[[de:Lektion konfigurieren]]
[[fr:Ajouter/modifier une leçon]]
[[ja:レッスンの設定]]

Lesson module

2014-06-05T00:49:33Z

Cttxg: /* See also */ Adding MoodleBites YouTube video link

{{Activities}}

[[Image:Lesson icon.gif]] The lesson module presents a series of HTML pages to the student who is usually asked to make some sort of choice underneath the content area. The choice will send them to a specific page in the Lesson. In a Lesson page's simplest form, the student can select a continue button at the bottom of the page, which will send them to the next page in the Lesson.

[[Image:Lessonexample.png]]

* [[Lesson settings]]
* [[Building Lesson]]
* [[Using Lesson]]
* [[Lesson FAQ]]

There are 2 basic Lesson page types that the student will see: question pages and content pages. There are also several advanced navigational pages which can meet more specialized needs of the Teacher. The Lesson module was designed to be adaptive and to use a student's choices to create a self directed lesson.

The main difference between a Lesson and other activity modules available in Moodle comes from its adaptive ability. With this tool, each choice the students makes can show a different teacher response/comment and send the student to a different page in the lesson. Thus with planning, the Lesson module can customize the presentation of content and questions to each student with no further action required by the teacher.

==See also==
Using Moodle [http://moodle.org/mod/forum/discuss.php?d=207365&parent=910023#p910107 Difference between Lesson and Book]
*[http://youtu.be/cUDV0WE5ZYY Moodle 2.x Lesson (part 1)] MoodleBites video on YouTube
*[http://youtu.be/Mfj-8w-Ze0A Moodle 2.x Lesson (part 2)] MoodleBites video on YouTube
*[http://youtu.be/jXjqHtgC9c0 Moodle 2.x Lesson (part 3)] MoodleBites video on YouTube

[[Category:Lesson]]
[[es:Módulo de lección]]
[[eu:Ikasgaiak]]
[[fr:Leçon]]
[[de:Lektion]]

Language customization

2014-06-05T00:44:49Z

Cttxg: /* See also */ Adding MoodleBites YouTube video link

{{Language}}
Words or phrases (in any language) used on the site may be easily changed by an administrator using the language customization feature. For example, you may want to change the word "Course" to "Unit". The process consists of 4 steps:

# Check-out the strings
# Filter the strings you wish to customize
# Customize the strings
# Save and check-in the strings

== Quick instructions for the impatient ==

# Go to the ''Administration > Site administration > Language> Language customization'' page.
# Pick the language to customize from the pull down list.
# Click the "Open languge pack for editing" button. This may take time to process.
# Click or Ctrl+Click to select files on the "Filter strings" interface. Notice files are grouped. For example, you will find the lesson strings under "mod" and moodle.php under core.
# After selecting the file(s), it is possible to use "string must contain" and other filters. For example, look at only string text that has "teacher" the file(s) you selected.
# Click "Save changes and continue editing" if you want to pick another filter or PHP file(s) to edit.
# Click "Save and check in string into files" to save all changes you have made.

:''Tip:'' Do not see any string changes? Did you remember to use the "Save and check in string into files" button? Did you refresh your browser so it is not looking at a cached page? Did you edit the language file that is actually being used in your site, course or by the user?

:''Tip:'' Can't find the string you wish to change? Tick the 'Show origin of languages strings' checkbox in ''Administration > Site administration > Development > Debugging'' then visit the page containing the string you want to customize.

== Background ==

Moodle is translated into many languages - see [http://download.moodle.org/langpack/ Moodle.org: Language packs] for their list and the translation completion status. The translations are distributed in so called language packages (or just lang packs) that are maintained by kind volunteers, community contributors and Moodle partners. Please read the page [[Translation]] first to understand how the whole localization machinery works.

Moodle site administrators can customize any language pack to fit their individual needs (for example to use the term "Unit" instead of "Course"). You are discouraged from direct editing the files coming as a part official language pack. Such changes would be silently overwritten during the next upgrade. Instead, you should create a local language pack that holds all your changes from the official pack.

Local language packs have the same structure as the official ones. They are saved in your Moodle data directory in moodledata/lang/xx_local/ folder where 'xx' is the code of the language. You have to have the official language pack installed before you can customize it. Local language pack should contain just strings you have customized - you should not copy whole official language packs.

When displaying a string, Moodle first looks if a local customization of it exists in moodledata/lang/xx_local/component_file.php. If so, it is used. If not, the string from the official language pack is used (eventually, if the string has not been translated yet, the original English version is displayed). Please note that the strings are cached for better performance so you have to purge Moodle caches after you modify a file in your xx_local pack (caches are purged automatically if you use the tool described below).

== Using Language customization tool ==

Moodle comes with a tool that allows you to edit your local language pack via web interface. This tool is available for the site administrators in ''Settings > Site administration > Language > Language customization''. Please refer to the following workflow diagram.

[[image:customlang-process.png|800px|thumb|left|Workflow of the language customization (click to enlarge)]]
 

=== Check out strings into translator ===

At the Language customization first page, select a language to customize and press the button 'Check out string into translator'. During the checkout, Moodle loads the language strings from PHP files into its database. The language customization tool works with this database so the files in your xx_local pack are not touched unless your proceed to the final step of this workflow. If the xx_local language pack does not exist yet, Moodle automatically creates an empty one for you.
:''Tip:'' There is currently a problem with "execution time". If you get the "Fatal error: Maximum execution time of 180 seconds exceeded" message, you will have to press the button 'Check out string into translator' several times to get the operation completed. See [http://moodle.org/mod/forum/discuss.php?d=163375 forum discussion].

=== Use filter to find the strings you want to customize ===

[[Image:Language_string_M2_filter.png|thumb|right|Moodle 2.0 language filter]]
After the checkout, use the "filter strings" form to find strings you want to customize for your site. Not selecting any filters will display all strings in the language pack.

* ''Show strings of these components'' - Click or Ctrl+click to select one or more files that contain the string you want.
* ''Customized only'' - check this field to display only those strings that are already present in your xx_local pack.
* ''Help only''' - check this field to display only help tooltips, that is the texts used when clicking the yellow question mark icon.
:''Note:'' Starting in Moodle 2.0, help string identifiers must end with _help suffix.
* ''Modified only'' - displays only the strings that are modified in the current session.
:''Note:'' The term 'customized' means strings that are saved on disk in your xx_local pack directory. The term 'modified' represents the changes made since the last checkin string into the language pack. Customized strings (already saved in a file) are highlighted with green. Modified strings (not saved in a file yet) are highlighted with blue.
:''Tip:'' You may want to use this option look at your current work before you check it in.
* ''Only strings containing'' - insert a phrase that must appear in the string. For example, if you put a word 'student' here, you will get only those strings that contain this word.
:''Tip:'' The 'Only strings' filter can be used for a total search for a term used in your Moodle site for the selected language pack.
* ''String identifier'' - if you know the string identifier (it is the first parameter of the get_string() function), type it here. For example, the names of activity modules are defined in strings 'modulename'. Finding where a particular string is saved can be difficult sometimes. The administrator can start a debugging function: Site administration>Development>Debugging and choose "Show origin of language strings". Then if you append "?strings=1" (or "&strings=1" if there is already a parameter) to the end of the page URL, beside each string will be shown something like "{rememberusername/admin}". The last part says which php file uses the string, so this one is in admin.php. If there is nothing after the / look in moodle.php. The first part, before the /, is the string identifier.

Use combination of filter settings to get the required set of strings.

Click button 'Show strings' for potential editing.

=== Input your own translation ===

The strings that pass all the conditions defined in the filter are displayed in a table. To replace the standard translation, put your own into the 'Local customization' field.
:''Tip:''If you want to delete your current customization , just delete the content of the 'Local customization' field and click the "Save and continue editing". The modifications that are going to be removed a customized string are highlighted in red. If you made changes to a field previously "Save and continue editing" it will be highlighted in blue.

Click "Save and continue" button before you change the filter settings and show a new set of strings.

=== Saving your work into files ===

As necessary, you may repeat the "show strings", "local customization" and "Save and continue" process. When you have made all the changes you want to make:

Click "Save and check in strings into files" to process all changes made in the translator database to your local language pack.

=== Writing the modifications into files ===

During the checkin, the contents of the translator database are dumped into files in moodledata/lang/xx_local/ directory.

Click "Save and check in strings into files" to process all changes made into your local language pack.
:''Note:'' this operation removes the directory first and then re-creates it with the actual data. Therefore it is reasonable to not to touch the files directly after you have checked out them into the translator.

==See also==

* Using Moodle [https://moodle.org/mod/forum/discuss.php?d=219504 Duplicate entry 'en-373-AM'] forum discussion about error when attempting to edit a lang pack
*[http://youtu.be/0v72GKn2Wuk Moodle 2 Language Administration settings] MoodleBites video on YouTube

[[de:Sprachanpassung]]
[[es:Personalización del idioma]]

Language packs

2014-06-05T00:43:17Z

Cttxg: /* See also */ Adding MoodleBites YouTube video link

{{Language}}
Over 100 language packs are available for an administrator to install on your Moodle site via ''Adminisration > Site administration > Language > Language packs''. Simply select the languages you require from the list of available language packs and click on the "Install selected language pack" button.

Multiple language packs may be selected for install by holding down the Apple or Ctrl key whilst clicking on the language packs.

Installing many (20+) language packs has [https://moodle.org/mod/forum/discuss.php?d=241098 almost 0 impact] on Moodle performance.

All language packs, apart from English, are stored in ''moodledata/lang'' folder.

==Parent language packs==

Certain language packs contain only the modified language strings from their parent language, rather than a complete set. Thus, it is necessary to install the parent language pack too. These language packs are:
* de_du, de_kids and de_comm (which requires de)
* es_ar, es_es (which requires es)
* fr_ca (which requires fr)
* en_us, en_ar, en_kids (which requires the default en)

==Manual language pack installation==

Language packs may also be installed manually by downloading the zip file from http://download.moodle.org/langpack/ to a directory called ''lang'' in your ''moodledata'' directory and then unzipping.

==Language pack updates==

* Language packs can be updated via ''Administration > Site administration > Language > Language packs''.
* You can see which language packs have updates because they are listed in both 'Installed language packs' and 'Available language packs'.
* To update all installed language packs (except English and any local language packs) click the 'Update all installed language packs' button.
* For sites with a large number of language packs installed, to update just a few installed language packs at a time, select the languages from the 'Available language packs' list and click the 'Install selected language pack(s)' button.
* The English language pack is updated automatically each time the site is upgraded.
* As most language packs are a work in progress, it is usually a good idea to update them regularly. Once a week/month might be a good frequency.

==See also==

*Using Moodle [http://moodle.org/mod/forum/discuss.php?d=48492 Language import utility broken] forum discussion
*List of [http://en.wikipedia.org/wiki/List_of_ISO_639-1_codes language codes] on Wikipedia
* [[Translation]] and help us to translate Moodle to more languages
*[http://youtu.be/0v72GKn2Wuk Moodle 2 Language Administration settings] MoodleBites video on YouTube

[[eu:Hizkuntza-paketeak]]
[[es:Paquetes de idioma]]
[[fr:Paquetages de langue]]
[[ja:言語インポートユーティリティ]]
[[de:Sprachpakete]]
[[zh:语言倒入工具]]

Language settings

2014-06-05T00:41:04Z

Cttxg: Adding MoodleBites YouTube video link

{{Language}}==User profile settings==

A user can set their preferred language for the site in ''Administration > My profile settings > Edit profile''.

==Course administration settings==

A teacher can force the language of their course in ''Administration > Course administration > Edit settings''.

==Site administration settings==

There are a number of language settings for administrators in ''Administration > Site administration > Language > Language settings''.

===Language autodetect===

By default, Moodle detects a user's language from their browser setting. However, language auto-detection may be disabled so that the default site language is used instead.

===Default language===

This sets the default language for the site. This setting can be overridden by users using the language menu or the setting in their user profile.

Note: If a preferred language is set in your browser then this will override the default site language (unless language auto-detection is disabled).

You can enable localised error messages for database connection problems by add the following line to your [[Configuration file|config.php file]]:

$CFG->lang="yourlangcode";

===Display language menu===

This sets whether the language menu is displayed on the login page and the home page. If this is turned off, the only places where a user can change the language setting is in their user profile or in the course settings if they are a teacher.

===Languages on the language menu===

If you want to limit the number of languages students and teachers can select from, enter a reduced list here.

===Language selection priority===

This figure shows Moodle priority when selecting languages:

[[File:mdl_lang_selection_priority.png|640px|Moodle language selection priority]]

===Sitewide locale===

It's generally best to leave this setting empty, as it's set through each language pack.

===Excel encoding===

Leave as default (Unicode) unless you have a particular reason for wanting Latin encoding.

==See also==
*[http://youtu.be/0v72GKn2Wuk Moodle 2 Language Administration settings] MoodleBites video on YouTube

[[fr:Réglages langue]]
[[de:Spracheinstellungen]]
[[es:Configuraciones del idioma]]

Label module settings

2014-06-05T00:36:07Z

Cttxg: Adding MoodleBites YouTube video link

{{Label}}
==Adding a label==
*With the editing turned on to a course by choosing Label from the "Add an activity or resource" link (or, if not present, the "Add a resource" drop down menu) in the section where you want to add your menu. Click "Expand all" top right to see all the settings expanded.

==General==
{|
|[[File:labelcollapsed.png|thumb|Collapsed view of editor]]
|[[File:labelexpanded.png|thumb|Click to display the editing tools and drag the bottom right to enlarge the editor]]
|}

*Type your chosen words or add your resources.

*Note: Because the label has the [[HTML_editor| TinyMCE text editor]], it is possible not just to type words but also to add images, links, media or code from within the labels' editor. See [[Using_Label| here]] for suggestions about using labels in your course.
==Common module settings==
(These settings are collapsed by default.)
*Leave Common Module settings as "show" for the label to be visible.
==Restrict access/Activity completion==
(These settings are collapsed by default)

These settings are visible if [[Conditional activities]] and [[Activity completion]] have been enabled in the site and the course.

*Click "Save and return to course".
*You can now use the move icon (crosshair or up/down arrow) to move your label to where you wish it to display.

[[File:newlabel25.png]]

==Label capabilities==

* [[Capabilities/mod/label:addinstance|Add a new label]]

==See also==
*[http://youtu.be/kdPVi-cwMdg Adding a Label and content in Moodle] MoodleBites video on YouTube

[[de:Textfeld konfigurieren]]
[[es:Configuraciones de módulo etiqueta]]

Grade settings

2014-06-05T00:32:44Z

Cttxg: Adding MoodleBites YouTube video link

{{Grades}}
==Course grade settings==

[[File:Course grade settings.png|thumb|Course grade settings]]Course grade settings determine how the gradebook appears for all participants in the course.

Course grade settings are found in ''Administration > Grade administration > Course grade settings'' or via the gradebook Settings tab.

The default course grade settings are set by an administrator in ''Administration > Site administration > Grades''.

==Grader report preferences==

[[File:Grader report preferences.png|thumb|Grader report preferences]]Teachers can set their preferences for the grader report via the gradebook 'My preferences' tab. These settings will apply to all courses for that teacher. The teacher may change them at any time.

The default grader report preferences are set by an administrator in ''Administration > Site administration > Grades > Report settings > Grader report''.

In Moodle 2.4.2 onwards, the default number of students per page (''grade_report_studentsperpage'') can safely be increased without any loss of data when grading large numbers of students with many assignments.

==Site administration settings==

Default values for all grade settings can be set by an administrator. The easiest way to do so is to log in as admin then browse a course gradebook and follow the 'Change defaults' links.

The following additional grade settings can be found in ''Administration > Site administration > Grades > General settings''. The settings will affect all gradebooks used by all teachers.

===Graded Roles===

Graded roles are the type of user that will appear in the gradebook. Most of the time "student" is the only one needed.

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

Teachers can view the user reports for all or selected students in the course in ''Administration > Grades administration > User report''.

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

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

===Recover grades default===

When [[Enrolled users|manually enrolling]] a student in a course, there is an option 'Recover user's old grades if possible', however this checkbox is easy to miss. Enabling 'Recover grades default' results in 'Recover user's old grades if possible' being ticked for every course.

[[File:enrol users enrolment options.png]]

===Unlimited grades===
Teachers can enter grades over 100% directly in the gradebook if the ''unlimitedgrades'' setting is enabled.

==Grade capabilities==

*[[Capabilities/moodle/grade:edit|Edit grades]]
*[[Capabilities/moodle/grade:export|Export grades]]
*[[Capabilities/moodle/grade:hide|Hide/unhide grades or items]]
*[[Capabilities/moodle/grade:import|Import grades]]
*[[Capabilities/moodle/grade:lock|Lock grades or items]]
*[[Capabilities/moodle/grade:manage|Manage grade items]]
*[[Capabilities/moodle/grade:managegradingforms|Manage advanced grading methods]]
*[[Capabilities/moodle/grade:manageletters|Manage grade letters]]
*[[Capabilities/moodle/grade:manageoutcomes|Manage grade outcomes]]
*[[Capabilities/moodle/grade:unlock|Unlock grades or items]]
*[[Capabilities/moodle/grade:view|View own grades]]
*[[Capabilities/moodle/grade:viewall|View grades of other users]]
*[[Capabilities/moodle/grade:viewhidden|View hidden grades for owner]]

==See also==
*[http://youtu.be/QWE0c_-NjHE Moodle 2 Grades Administration settings] MoodleBites video on YouTube

[[de:Bewertungseinstellungen]]
[[es:Configuraciones de calificación]]
[[fr:Paramètres de notes]]

Gradebook

2014-06-05T00:25:11Z

Cttxg: Adding MoodleBites YouTube video link

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

The grader report collects [[Grade_items|items]] that have been graded from the various parts of Moodle that are assessed, and allows you to view and change them as well as sort them out into [[Grade_categories|categories]] and calculate totals in various ways. When you add an assessed item in a Moodle course, the gradebook automatically creates space for the grades it will produce and also adds the grades themselves as they are generated, either by the system or by you.

The grades displayed are initially displayed as the raw marks from the assessments themselves, so will depend on how you set those up e.g. an essay out of 36 will appear as however many raw marks that student got, not a percentage (although this can be changed later, see below).

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

==Display==

Along the top of the grader report are several rows: first the course, then the category, then the columns for each graded activity (for example: Assignment, Quiz, Lesson). Any activities settings which were left "uncategorised" will appear in the general category which is named after the course by default (any category name can be changed).

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

There are three ways that the categories can be displayed:

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

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

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

===Highlighting rows and columns===

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

===Sorting by columns===

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

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

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

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

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

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

===Horizontal scrollbar===

A horizontal scrollbar enables teachers to scroll grades in the grader report. (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.)

[[Image:Gradebook horizontal scrollbar.png|thumb|Horizontal scrollbar]]

===Mouse-over tooltips===

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

===Filtering the gradebook by groups===
If you change the course settings Group mode to Visible groups or Separate groups a drop-down menu will appear in the gradebook to allow you to filter your students by groups.

==Editing==

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

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

Alternatively, you can choose "Quick grading" and "Quick feedback" in 'My preferences' to make the report appear with editable boxes containing each grade, so you can change many at once. This capability can be a real time saver, but make sure to save at reasonable intervals lest a pageful of changes be lost.

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

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

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

==Gradebook capabilities==

There is just one gradebook capability, [[Capabilities/gradereport/grader:view|View the grader report]], which is allowed for the default roles of manager, teacher and non-editing teacher.

==Extending the gradebook==

The Gradebook can be extended in three main ways:

===1. [https://moodle.org/plugins/browse.php?list=category&id=9 Grade reports]===
Which are the main way to view and manipulate grades
* [[LAEGrader report|LAE Grader Report]] Alternative to Grader report that scrolls vertically and horizontally without losing student columns or grade item header rows. Lot of additional enhancements.
* [https://moodle.org/plugins/view.php?plugin=gradereport_updfgrades Upload PDF Grader Report] lets you view assignment grades, comments and lateness in a report

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

===3. [https://moodle.org/plugins/browse.php?list=category&id=10 Grade export plugins]:===
Which allow you to export grade data for other systems
* [https://moodle.org/plugins/view.php?plugin=gradeexport_pdf PDF document] This is moodle plugin for exporting grades in PDF format. It is developed by using "Moodle PDF library"
* [https://moodle.org/plugins/view.php?plugin=gradeexport_checklist Checklist] This is a grade export plugin which will create an Excel spreadsheet containing all the checkmarks from a single checklist.

==See also==

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

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

[[de:Bewertungen]]
[[es:Informe calificador]]
[[fr:Carnet de notes]]
[[ja:評定表]]

Glossary settings

2014-06-05T00:20:39Z

Cttxg: Adding MoodleBites YouTube video link

{{Glossary}}
==Adding a glossary==
To add a glossary:
#With the editing turned on, in the section you wish to add your glossary, click the "Add an activity or resource" link (or, if not present, the "Add an activity" drop down menu ) and choose ''Glossary.'' All settings may expanded by clicking the "Expand all" link top right.

==General==

{|
|[[File:glossarygeneral25.png|thumb|General settings expanded by default]]
|}
===Name===
Give your new glossary a descriptive name.
===Description===
Describe the purpose of the glossary and provide instructions or background information, links etc. Click "Show editing tools" to display the rich text editor, and drag the bottom right of the text box out to expand it.

===Display description on course page===
If this box is ticked, the description will appear on the course page just below the name of the glossary.
===Is this glossary global?===

Administrators can make a global glossary, with entries linking throughout the whole Moodle site. Any course may contain a global glossary, though the best practice is to place a global glossary on the site front page.

===Glossary type===

Here you can decide whether the glossary will be main or secondary. The glossary system allows you to export entries from any secondary glossary to the main one of the course. In order to do this, you should specify which glossary is the main one. You can only have one main glossary per course.

==Entries==
(These settings are collapsed by default)
{|
|[[File:glossaryentries25.png|thumb|Entries settings expanded]]
|}

===Approved by default===
If set to "yes" then new entries appear automatically. If not, then the teacher must approve each one first.
===Always allow editing===
If set to "yes", students can edit their entries at any time. If not, then they can only edit for a certain period (defined in [[Site Policies]])
===Duplicate entries allowed===
This allows the entry of more than one definition for a given word.
===Allow comments on entries===
Students and teachers can leave comments on glossary definitions. The comments are available through a link at the bottom of the definition.

===Automatically link glossary entries===
If the [[Glossary auto-linking filter]] is enabled by an administrator (see [[Filters]] for further details), then turning this on allows individual entries in this glossary to be automatically linked whenever the concept words and phrases appear throughout the rest of the same course. This includes forum postings, internal resources, week summaries and so on.
{|
|[[Image:Glossaryautolink.png|thumb|An auto-linked word in a forum]]
|}

Note: Enabling linking for the glossary does not automatically turn on linking for each entry - linking needs to be set for each entry individually. If you do not want particular text to be linked (in a forum posting, say) then you should add <nolink> and </nolink> tags around the text. Note that category names are also linked.

==Appearance==
(These settings are collapsed by default)
{|
|[[File:glossaryappearance25.png|thumb|Appearance settings expanded]]
|}

===Display format===

That specifies the way that each entry will be shown within the glossary. The default formats are:

* Simple, dictionary style - This looks like a conventional dictionary with separate entries. No authors are displayed and attachments are shown as links.
* Continuous without author - Like the simple style. Shows the entries one after other without any kind of separation but the editing icons if your theme supports it.
* Full with author - A forum-like display format showing author's data. Attachments are shown as links.
* Full without author - A forum-like display format that does not show author's data. Attachments are shown as links.
* Encyclopedia - Like 'Full with author' but attached images are shown inline.
* Entry list - This lists the concepts as links.
* FAQ - Useful for displaying lists of frequently asked questions. It automatically appends the words QUESTION and ANSWER in the concept and definition respectively.

See [[Glossary FAQ]] for more information on the code for the different display formats.

===Approval display format===
It is possible to set an alternative display format for when entries are approved that can differ from the display format on the course page. This could be useful for instance if a tutor wants to see who made a particular glossary entry before approving it but doesn't want the students' name to be displayed for others on the course page.
===Entries shown per page===
Decid here how many entries to show per page.
===Show alphabet links===
If set to "yes", users can browse the glossary by letters of the alphabet.
===Show 'ALL' link===
If set to "yes", users can browse all the entries at once
===Show 'Special' link===
If set to "yes", users can can browse the glossary by special characters, such as @ and #.
===Allow print view===
This provides a printer-friendly version link for students. (Teachers are always provided with a printer-friendly version link.)

==RSS==
(These settings are collapsed by default and only visible if RSS has been enabled on the site and for the glossary.)
{|
|[[File:glossaryrss25.png|thumb|RSS settings expanded]]
|}

===RSS feed for this activity===

This turns RSS on or off. When set to “None,” the RSS feed is disabled. When set to “Concepts with authors,” the RSS feed will send out the glossary entries with the name of the author. When set to “Concepts without authors,” the RSS feed sends out glossary entries without the name of the author.

===Number of RSS recent articles===

This number sets the number of entries that go out via RSS. If this number is set to 5, then the 5 most recent articles will be sent to subscribers. As new entries get added, the oldest entry gets replaced on the RSS feed. If your glossary gets a lot of posts every day, you will want to set this number high.

When RSS is enabled for your glossary, an orange RSS button appears on the main page (in the upper right-hand side). When a user clicks on the RSS button, they see the [[XML]] code displayed, needed by the news-reader. Once a user has the RSS news-feed link, adding it to a reader is simple and will then display Glossary aggregated information, along with other information they subscribe to.

==Grade==
(This setting is collapsed by default)
Choose the category in which this glossary will appear if ratings are enabled.

==Ratings==
(This setting is collapsed by default)

{|
|[[File:ratings25.png|thumb|Ratings settings expanded]]
|}

===Roles with permissions to rate===
Glossary entries can be rated using a [[Scales|scale]]. By default, only teachers can rate glossary entries, though students can be given permission to do so if desired from ''Administration>Glossary administration''. This is a useful tool for giving students participation grades. Any ratings given are recorded in the [[Gradebook|gradebook]].
==Common module settings==
(These settings are collapsed by default.)

See [[Common module settings]]
==Restrict access/Activity completion==
(These settings are collapsed by default)

The Restrict access and Activity completion settings are visible if [[Conditional activities]] and [[Activity completion]] have been enabled in the site and the course.

==Adding a new glossary entry==
See [[Using Glossary]]

==Glossary permissions==
Role permissions for the activity can be changed in ''Settings > Glossary administration > Permissions.''

==Site administration settings==

The glossary module has additional settings which may be changed by an administrator in ''Settings > Site administration > Plugins > Activity modules > Glossary''.

=== Glossary level default settings ===

* glossary_entbypage - Number of Glossary entries shown per page. Default is set to 10.
* glossary_dupentries - Whether or not the Glossary will allow duplicate entries. Default is set to "No".
* glossary_allowcomments - Whether or not the Glossary will accept user comments on its entries. Default is set to "No".
* glossary_linkbydefault - Whether or not a glossary should be automatically linked. Default is set to "Yes".
* glossary_defaultapproval - Whether or not the Glossary will define the approval status of an entry posted by a student. Default is set to "Yes".
* glossary_enablerssfeeds - Enabling of RSS feeds for all glossaries. Default is set to "No". Note: feeds will still need to be turned on manually in the settings for each glossary.

=== Entry level default settings===

* glossary_linkentries - Whether or not glossary entries should be automatically linked. Default is set to "No".
* glossary_casesensitive - Whether or not an entry is case sensitive when linked. Default is set to "No".
* glossary_fullmatch - Whether or not an entry should match the case in the target text by default when linked. Default is set to "No".

=== Display Formats Setup ===

To hide or show any of these entries, simply click on the "eye" icon next to the entry. Clicking on the "writing hand" icon will take you to the settings page for that entry.

==See also==
*[http://youtu.be/y82WI5DJzkE Moodle 2 Glossary] MoodleBites video on YouTube

[[Category:Site administration]]

[[de:Glossar konfigurieren]]
[[ja:用語集エントリを追加/編集する]]

Front page settings

2014-06-05T00:17:11Z

Cttxg: /* See also */ Adding MoodleBites YouTube video link

{{Front page}}The site's [[Front page]] is similar to a course page. The front page settings, roles, filters, backup, restore and questions are currently duplicated in ''Administration> Front page settings'' AND ''Settings > Site administration > Front page'' (reported as MDL-26012).

==Front page settings==

The following settings may be changed by a site administrator in ''Administration > Front page settings > Edit settings'':

===Full site name===
This name appears at the top of every page above the navigation bar.
[[Image:demositefrontpage01.png|frame|center|Front page full site name]]

===Short name for site===
The short name appears at the beginning of the navigation bar as a link back to your site front page.

===Front page summary===
This summary can be displayed on the front page using the course/site summary block.

===Front page and Front page items when logged in===
The centre of the front page can display any combination of the following: news items, a list of courses, a list of enrolled courses, a list of course categories, a list of categories and courses, a course search box or none. The order is determined by a combination box.

It is possible to create one setting for anyone who gets to the front page without logging in to the Moodle site, and another look for only those who have logged into the Moodle site. There are two combination boxes.

{| class="nicetable"
|-
!colspan="3"|Combination boxes
|-
|[[Image:FrontPage settings frontpage pd.png|thumb|left|frontpage showing pulldown]]
| The image on the left shows the first Front Page settings dialog - what visitors will see before they log in.

The image on the right shows a second front Page settings dialog - what Authenticated Users will see when logged in.

:An alternative option for logged-in users is [[My home]] (can be set in Site administration > Appearance > Navigation)
|[[Image:FrontPage_settings_frontpageloggedin.png|thumb|right|frontpage for login user box]]
|}

===Maximum category depth===
This specifies the maximum depth of child categories expanded when displaying categories or combo list. Deeper level categories will appear as links and user can expand them with AJAX request.

===Maximum number of courses===
Maximum number of courses to be displayed on the site's front page in course listings.

===Include a topic section===
This adds a topic section to the centre-top of the front page. When editing is turned on, resources and/or activities can be added to the topic section using the dropdown menus, in the same way as on a course page.

:Note: The label resource can be used to add text and/or an image to the centre-top of the front page.

===News items to show===
This setting only applies if the front page is set to display news items or if you are using the [[Latest News block]].

===Comments per page===
Each course may include a [[Comments block]] which allows the display of user comments. The number of comments displayed at any time is set here.

===Default front page role===

The default frontpage role enables logged-in users to participate in front page activities. It is recommended that it is set to frontpage role. It should ''never'' be set to [[Guest]].

For sites which do not have a default frontpage role (because they upgraded from 1.9), it is recommended that the administrator [[Creating custom roles|creates a new role]] with frontpage archetype, resets it to default and then sets it as the default frontpage role.

==Front Page roles==
As in a course, you can assign users [[Roles|roles]] just in the [[Context|context]] of this page. Note this is different from the default Authenticated User on Front Page role found in front page settings. As a security issue, usually only admins can modify the front page, other users do not.

It is possible to upload users as students in the front page with a csv file using the site short name as 'course1' field, student in 'role1' field (and, if needed, chosen group name in 'group1' field.) '''(new in 2.5)'''{{New features}}

==Front Page backup==
You can backup the front page, similar to a [[Course backup]].

==Front Page restore==
As in a course, you can [[Restore]] a backed up version of the front page.
However, there are currently issues with front page restore, as outlined in MDL-31500 and MDL-30808

==Front Page questions==
The [[Question bank]] is accessible from the Front Page. For example, if "topic" is checked in the front page settings, you can add a [[Quiz module]] activity.

==Tips and Tricks==

A Moodle site's front page can be reconfigured from the default standard to give it a different look and or change how it functions. Depending upon the changes, this can be a simple or a more complex process. Of course a custom theme may have it's own unique front page format. Here are some examples using the formal white standard theme:

====Visual examples====
<gallery caption="Guest view, same Theme- click on any to enlarge" widths="150px" heights="100px" perrow="3">
Image:fp013col.png|3 column Front Page, topic checked
Image:fp032colright.png|2 column Front Page, blocks right
Image:fp022colleft.png|2 column Front Page, blocks left
Image:fp043coluser.png|3 column Front Page, Categories and courses
Image:fp052colright.png|2 column Front Page, Categories only
Image:fp021col.png|Clean look, topic checked, no blocks
</gallery>

====Central area, Courses or Categories?====
This is a major decision, what is it you want in the centre of your front page? You can have a list of categories, a list of categories and courses, or neither, a label with a table full of images works just as well. The issue is always the same, actually, what looks good.

====Clean look, topic checked, no blocks====
The standard Moodle page format of [[Block]]s on the left and blocks on the right is not always appropriate or considered pretty. The [[Administrator|site administrator]] can change this basic format by simply deleting or hiding blocks that can be seen by users. Navigation can be placed on the dock.

====The two column format====
The Administrator decides which blocks should appear on the front page and moves all of them to the left or right side. This format allows you to decide what you want in the centre, and where you want the blocks, left or right.
:Tip: It is possible to force a block column to assume a specific width. For example, placing an image of 400 px in a block will force that column to 400 px.

====The clean look example====
Some sites want an uncluttered look. A site administrator or designer wants to start with the most basic look and then add features.

# The site administrator will turn on editing and hide or delete all blocks that can be see by teachers or students on the front page.
# Then go to the Site administration block► Front Page ► Front Page settings and:
## Set the "Front page" list to None, None, None, None
## Set "Front page items when logged in" list to the same
## Check the box for "Include Topic section"
## Save

All the above was done with 1 theme, and a simple front page.

==Block settings==
[[Image:Editconfigblock.png|thumb|200px|right|Editing block settings]]
Each block has a number of configuration settings that you can change. See [[Managing blocks]] for more details.

==See also==
*[[Front Page FAQ]]
*[http://youtu.be/XkVp4Vo0juA Moodle 2 Administration Front page settings] MoodleBites video on YouTube

[[Category:Site administration]]

[[de:Einstellungen_f%C3%BCr_die_Startseite]]
[[es:Configuraciones de la portada]]
[[eu:Hasiera-orriaren_ezarpenak]]
[[fr:Réglages page d'accueil]]
[[pl:Ustawienia strony głównej]]

Folder resource settings

2014-06-05T00:08:03Z

Cttxg: /* See also */ Adding MoodleBites YouTube video link

{{Folder}}

==Adding a folder to your course==

Note: Folders you wish to upload to Moodle have to be "zipped" or "compressed" first. The way you do this depends on your computer and operating system.

If you already have a folder of files you would like to display, there are two methods:

====Quick method====

#Click the 'Turn editing on' button at the top right of the course page
#Drag and drop the folder onto the course section where you'd like it to appear
#Click the button of the action you would like to take with the folder (in our case, "Unzip") and click "Upload"
#If necessary, edit the title of the folder by clicking the pencil icon

{|
| [[File:folderdragging.png|thumb|2. Drag and drop folder]]
| [[File:folderaction.png|thumb|3. Uploading the folder]]
|}

====Longer method====

#Click the 'Turn editing on' button at the top right of the course page
#Click 'Add an activity or resource' link, then in the activity chooser; select folder then click the "Add" button (or select folder from the "Add a resource" dropdown menu) All settings may expanded by clicking the "Expand all" link top right.
{|
|[[File:foldergeneral.png|thumb|General settings expanded by default]]
|[[File:foldercontent.png|thumb|Content settings expanded by default]]
|}

#For''' General''', add name and a description (which may be required or optional according to the admin settings)Click "Show editing tools" to display the rich text editor and drag the bottom right of the text box out to expand it. Enabling 'Display description on course page' will show it just below the link to the folder.
# For '''Content,''' either drag and drop a zipped/compressed folder into the box with an arrow or click the Add button to open the [[File picker]] menu in order to choose a file from your computer or a repository.
#When the folder thumbnail appears, click on it and select "Unzip":
{|
| [[File:newfolderupload.png|thumb|Unzipping a folder]]
|}

#Click the original (zipped) folder and click the "Delete" button to delete it if you wish
#Select how you want to [[#Display folder contents |display your folder contents]], your [[Common module settings]] and, if enabled, [[Conditional activities settings]] and [[Activity completion]] and click "Save and return to course"
#Click the button 'Save and return to course' at the bottom of the page

==Creating and uploading to a new folder==
Use this method if you want to create a folder on your Moodle course and then upload files into it.

# Click the 'Turn editing on' button at the top right of the course page
# Click 'Add an activity or resource' link, then in the activity chooser; select folder then click the "Add" button (or select folder from the "Add a resource" dropdown menu)
# Enter a name and a description (which may be required or optional according to the admin settings)
# Click the "Create folder" link as below; choose a name for your new folder and then click "Create folder"
# Click INTO the folder
# You can then add individual files into the folder either by dragging and dropping into the box (1 below) or clicking the "Add" (2 below) to upload files from the [[File picker]]
# Choose how you want to display your folder contents, your [[Common module settings]] and, if enabled, [[Conditional activities settings]]
# Click "Save and return to course"

{|
| [[File:createfolder.png|thumb|4. Creating a folder]]
| [[File:addtofolder.png|thumb|6. Adding files to a folder]]
|}

==Display folder contents==
{{New features}}
Decide here whether to have the folder displayed on a separate page (the default) or inline with or without subfolders expanded or collapsed.

{|
| [[File:folder1.png|thumb|Folder displayed on separate page]]
| [[File:folder2.png|thumb|Folder displayed inline]]
| [[File:folder3.png|thumb|Folder displayed inline with subfolders expanded]]
|}

In Moodle 2.5.2 onwards, all folder names are shown on the course page. (Previously the name was not displayed for folders displayed inline.)

==Folder capabilities==

*[[Capabilities/mod/folder:view|View folder content]]
*[[Capabilities/mod/folder:managefiles|Manage files in folder module]]
*[[Capabilities/mod/folder:addinstance|Add new folder]]

==Site administration settings==

The folder module has additional settings which may be changed by an administrator in ''Settings > Site administration > Plugins > Activity modules > Folder''.

===Require activity description===
This setting allows you to turn off the requirement for users to type something into the description box.

==See also==
*[http://youtu.be/VQ14drMhRyE Moodle 2.0 Adding Content - Folder] MoodleBites video on YouTube
*[http://youtu.be/ZPaVskLCRb4 Moodle 2 file management] MoodleBites video on YouTube

[[de:Verzeichnis konfigurieren]]

Folder resource settings

2014-06-05T00:06:16Z

Cttxg: Adding MoodleBites YouTube video link

{{Folder}}

==Adding a folder to your course==

Note: Folders you wish to upload to Moodle have to be "zipped" or "compressed" first. The way you do this depends on your computer and operating system.

If you already have a folder of files you would like to display, there are two methods:

====Quick method====

#Click the 'Turn editing on' button at the top right of the course page
#Drag and drop the folder onto the course section where you'd like it to appear
#Click the button of the action you would like to take with the folder (in our case, "Unzip") and click "Upload"
#If necessary, edit the title of the folder by clicking the pencil icon

{|
| [[File:folderdragging.png|thumb|2. Drag and drop folder]]
| [[File:folderaction.png|thumb|3. Uploading the folder]]
|}

====Longer method====

#Click the 'Turn editing on' button at the top right of the course page
#Click 'Add an activity or resource' link, then in the activity chooser; select folder then click the "Add" button (or select folder from the "Add a resource" dropdown menu) All settings may expanded by clicking the "Expand all" link top right.
{|
|[[File:foldergeneral.png|thumb|General settings expanded by default]]
|[[File:foldercontent.png|thumb|Content settings expanded by default]]
|}

#For''' General''', add name and a description (which may be required or optional according to the admin settings)Click "Show editing tools" to display the rich text editor and drag the bottom right of the text box out to expand it. Enabling 'Display description on course page' will show it just below the link to the folder.
# For '''Content,''' either drag and drop a zipped/compressed folder into the box with an arrow or click the Add button to open the [[File picker]] menu in order to choose a file from your computer or a repository.
#When the folder thumbnail appears, click on it and select "Unzip":
{|
| [[File:newfolderupload.png|thumb|Unzipping a folder]]
|}

#Click the original (zipped) folder and click the "Delete" button to delete it if you wish
#Select how you want to [[#Display folder contents |display your folder contents]], your [[Common module settings]] and, if enabled, [[Conditional activities settings]] and [[Activity completion]] and click "Save and return to course"
#Click the button 'Save and return to course' at the bottom of the page

==Creating and uploading to a new folder==
Use this method if you want to create a folder on your Moodle course and then upload files into it.

# Click the 'Turn editing on' button at the top right of the course page
# Click 'Add an activity or resource' link, then in the activity chooser; select folder then click the "Add" button (or select folder from the "Add a resource" dropdown menu)
# Enter a name and a description (which may be required or optional according to the admin settings)
# Click the "Create folder" link as below; choose a name for your new folder and then click "Create folder"
# Click INTO the folder
# You can then add individual files into the folder either by dragging and dropping into the box (1 below) or clicking the "Add" (2 below) to upload files from the [[File picker]]
# Choose how you want to display your folder contents, your [[Common module settings]] and, if enabled, [[Conditional activities settings]]
# Click "Save and return to course"

{|
| [[File:createfolder.png|thumb|4. Creating a folder]]
| [[File:addtofolder.png|thumb|6. Adding files to a folder]]
|}

==Display folder contents==
{{New features}}
Decide here whether to have the folder displayed on a separate page (the default) or inline with or without subfolders expanded or collapsed.

{|
| [[File:folder1.png|thumb|Folder displayed on separate page]]
| [[File:folder2.png|thumb|Folder displayed inline]]
| [[File:folder3.png|thumb|Folder displayed inline with subfolders expanded]]
|}

In Moodle 2.5.2 onwards, all folder names are shown on the course page. (Previously the name was not displayed for folders displayed inline.)

==Folder capabilities==

*[[Capabilities/mod/folder:view|View folder content]]
*[[Capabilities/mod/folder:managefiles|Manage files in folder module]]
*[[Capabilities/mod/folder:addinstance|Add new folder]]

==Site administration settings==

The folder module has additional settings which may be changed by an administrator in ''Settings > Site administration > Plugins > Activity modules > Folder''.

===Require activity description===
This setting allows you to turn off the requirement for users to type something into the description box.

==See also==
*[http://youtu.be/ZPaVskLCRb4 Moodle 2 file management] MoodleBites video on YouTube

[[de:Verzeichnis konfigurieren]]

File resource settings

2014-06-05T00:03:07Z

Cttxg: /* See also */ Adding MoodleBites YouTube video link

{{File}}
==Adding a file==

To add a file to your course
[[File:dragandrop.png|thumb|Quick method of adding a file]]
Quick method: (''Note'' - ''does not work with Internet Explorer 9 or lower'')
# Click the 'Turn editing on' button at the top right of the course page
# Drag and drop the file onto the course section where you'd like it to appear
# If necessary, edit the title of the file by clicking the pencil icon, or edit other options (see below) by clicking the editing icon

Longer method:
# Click the 'Turn editing on' button at the top right of the course page
# Click 'Add an activity or resource' link, then in the activity chooser, select file then click the Add button (or select file from the "Add a resource" dropdown menu) All settings may expanded by clicking the "Expand all" link top right.
#Select your options as below:

==General==
{|
|[[File:filegeneral25.png|thumb|General settings expanded by default]]
|}

===Name===
Whatever you type here will form the link learners click on to view the file so it is helpful to give it a name that suggests its purpose.
===Description===
Add a description of your file here if desired (or required.) Click "Show editing tools" to display the rich text editor, and drag the bottom right of the text box out to expand it.
===Display description on the course page===
If this box is ticked, the description will appear on the course page just below the name of the file.

==Content==
{|
|[[File:filecontent25.png|thumb|Content settings expanded by default]]
|}

Either drag and drop your file onto the arrow if you are using an appropriate browser, or click on "Add" and use the [[File picker]] to upload your file.

(Note that if legacy files were used there will be a setting "Migration of old course file")

==Appearance==
(These settings are collapsed by default)
{|
|[[File:fileappearance25.png|thumb|Appearance settings expanded]]
|}

===Display===
* ''Automatic'' - Make the best guess at what should happen (probably what is wanted 99% of the time).
* ''Embed'' - Show the Moodle page with heading, blocks and footer. Show the title/description of the item and display the file directly in the page as well (good for images, flash animations, videos?, PDFs).
* ''Force download'' - user clicks on the file, then the web browser pops up with the 'where do you want to save this file' box.
* ''Open'' - No Moodle heading, blocks, footer or description - just show the file in the web browser (e.g. shows image, PDF, flash animation, taking up the whole browser window)
* ''In pop-up'' - Same as 'Open', but opens a new browser window to show this file (without the Moodle heading, blocks, etc) - this browser window also does not have all the menus and address bar in it.

*The following additional options are only there if you enable them via ''Site administration > Plugins > Activity modules > File'':

* ''In frame'' - show the Moodle heading and the file description, with the file displayed in a resizable area below (images, PDF, flash, etc. supported).
* ''New window'' - very much like 'in pop-up', but the new window is a full browser window, with menus and address bar, etc.

All of the above is true of items that can be displayed inside the browser directly (e.g. images, text files, PDFs (with plugin)). If the file cannot be displayed within the browser (e.g. word documents, without a suitable plugin, or other files that need to be loaded by an external program), then the pop-ups or frames, etc. will be created, but then the browser will take over and ask if you want to save the file.

To summarise:

* Do you want Moodle to sort it all out for you? - Automatic
* Do you want to force the user to save the file (or open it in a program on their desktop)? - Force download
* Do you want to show the file as part of the Moodle page (images, PDFs, videos)? - Embed
* Do you want to show the file in the browser, but without the Moodle page decorations (images, PDFs, videos)? - Open
* Do you want that, but in a new window? - In Pop-up (or possibly 'New window')
* Do you want to use a horrible bit of non-strict HTML that should never be allowed in polite company? - In frame

===Show size.type===

To show the file size and/or type on the course page and also on the resource page, simply tick the appropriate checkboxes.
====Display resource name/description====
To show the resource name and/or description when clicking to access the file, simply tick the appropriate checkboxes.

===Pop-up width/height===
(This setting is visible when "Show more" is clicked.)

If your file is to be displayed in a pop-up, specify the width and height here.

===Use filters on file content===
(This setting is visible when "Show more" is clicked.)

If you wish included media such as images and mp3 to appear embedded in the files then select "all files" or "HTML files only", according to your file types. (Note that this setting may cause problems for some Flash and Java applets.)

==Common module settings==
See [[Common module settings]]
==Restrict access/Activity completion==
(These settings are collapsed by default)

These settings are visible if [[Conditional activities]] and [[Activity completion]] have been enabled in the site and the course.

==Displaying a website index page==
[[File:Setmainfile.png|thumb|Setting the main file]]
The file module may be used if you have a folder with linked files such as a website with an index.html file or a flash activity with xml/swf and index file.
[[File:file resource.png|thumb|Website index page set as main file]]
# Click the 'Turn editing on' button at the top right of the course page
# Drag and drop the zipped folder onto the course section where you'd like it to appear, answer 'Create file resource' to the popup dialogue, then click the upload button
# Clicking the editing icon (hand with a pen) then click on the zip file and unzip it
# Click on the index.html file or the file you want to start displaying your linked files from then in the popup dialogue click the button 'Set main file'. This ensures this file is the one that appears on the course page for students to click on. The main file is then indicated with a title in bold.
# Click the button 'Save and display' at the bottom of the page

==File module capabilities==

* [[Capabilities/mod/resource:view|View file resource]]
* [[Capabilities/mod/resource:addinstance|Add a new file resource]]

==Site administration settings==

The file module has additional settings which may be changed by an administrator in ''Settings > Site administration > Plugins > Activity modules > File''.

===Frame height===
Here you can specify the height of the top frame (containing the navigation) if you choose the "in frame" display option. Note: If your theme has a large header then the ''resource_framesize'' variable should be increased to prevent horizontal and vertical scrollbars.

===Require activity description===
This setting allows you to turn off the requirement for users to type something into the description box.

===Available display options===
[[File:FileOptions.jpg|thumb|Setting the Admin File Display Options]]
This setting allows you to add different ways the resource may be displayed on the course page. By default Moodle doesn't enable "New window" or "In frame", so you need to set them available here if required, and you can also disable other options if not applicable.

===Default values for activity settings===

Here you can set the defaults for this resource. You can also choose which setting(s) to class as "Advanced". These settings will only then appear if the user clicks "Show More" in the settings.

==See also==
*[http://youtu.be/a_HoneIa-rY Moodle 2.0 Adding Resources - File] MoodleBites video on YouTube
*[http://youtu.be/ZPaVskLCRb4 Moodle 2 file management] MoodleBites video on YouTube

[[de:Datei konfigurieren]]

File resource settings

2014-06-04T23:56:43Z

Cttxg: Adding MoodleBites YouTube video link

Manual enrolment

2014-06-04T23:46:54Z

Cttxg: /* See also */ Adding MoodleBites YouTube video link

{{Enrolment}}
The manual enrolments plugin allows users to be enrolled manually via a link in the course administration settings. The plugin has to be enabled by the site administrator (see [[Enrolment plugins]]) and should normally be enabled as certain other enrolment plugins, such as self enrolment, require it.

==Course settings==

===Checking you have manual enrolment in your course===
*In a course, go to ''Administration > Course administration > Users > Enrolment methods''
*Make sure Manual enrolments has its "eye" opened.

[[File:Manualenrolments.png]]

===Editing manual enrolment settings===

Managers (and any other users with the capability [[Capabilities/enrol/manual:config|enrol/manual:config]]) can edit the manual enrolment method in the course and set the default enrolment period and default role in ''Administration > Course administration > Users > Enrolment methods''.

{|
|[[File:enrolmenexpirynotification.png|thumb|The manual enrolment screen (Click to enlarge)]]
|}

It is possible also for students and/or teachers to be notified when enrolments expire by selecting either "Enroller only" or "Enroller and enrolled user" from the dropdown "Notify before enrolment expires" and a time in "Notification threshold".

==Enrolling users==

'''Method 1'''
[[File:Enrolledusers.png|thumb|Enrolling users method 1]]
# Go to ''Administration > Course administration > Users > Enrolled users''
# Click the 'Enrol users' button at the top right or bottom left of the page
# Use the 'Assign roles' dropdown if you wish to change the role
# Select enrolment options as appropriate
# Browse or search for the user
# Click the Enrol button opposite the user. The user will indent in the list and the enrol button will disappear, indicating that the user is enrolled.
# When you have finished, click the 'Finish enrolling users' button (or simply close the enrol users box)

The user will then appear in the list of enrolled users.

Note: The enrolment option 'Recover user's old grades if possible' is not ticked by default and is easy to miss. An admin can make it so that the checkbox is ticked for all courses on the site by enabling the setting 'Recover grades default' in ''Administration > Site administration > Grades > General settings''.

'''Method 2'''
[[File:manually enrolling users.png|thumb|Enrolling users method 2]]
# Go to ''Administration > Course administration > Users > Enrolment methods''
# Click the 'Enrol users' icon in the edit column opposite manual enrolment
# Select users from the not enrolled users list, using Ctrl + click to select multiple users
# Click the add button to add the users to the enrolled users list

===Editing individual enrolment start and end dates===

[[File:individualenrolment24.png|thumb|Editing enrolment start and end dates]]Enrolment start and end dates may be edited for individual students as follows:

# Go to ''Administration > Course administration > Users > Enrolled users''
# Click the edit icon in the enrolment methods column for a particular user.
# Edit dates as required, then click the 'Save changes' button.

==Admin settings==

The manual enrolment plugin may be enabled or disabled site-wide in ''Administration > Site administration > Plugins > Enrolments > Manage enrol plugins.''

Site-wide settings, including default settings for manual enrolment in new courses, may be set via ''Administration > Site administration > Plugins > Enrolments > Manual enrolments''.

* Enrolment expiration action - specifies what happens when user enrolments reach expiration date. Please note that option "Unenrol user from course" purges grades, group memberships, preferences and other user related data from the courses.
* Hour to send enrolment expiry notifications - specify hour for sending expiration notifications.
* Add instance to new courses- if this is enabled, then whenever a new course is created, manual enrolments will automatically added to new courses.
* Enable manual enrolments - this specifies if enrol instances are enabled by default in new courses, it is strongly recommended to keep this setting enabled.
* Default role - this sets the default role, which is normally student and may be altered by a teacher in a course.
* Default enrolment duration - this sets the default length of enrolment in new courses.
* Notify before enrolment expires - specifies if teacher or optionally students should be notified before the expiration.
* Notification threshold - specify how many days should be users notified before the enrolment expiration.

==Manual enrolment capabilities==

*[[Capabilities/enrol/manual:config|Configure manual enrol instances]]
*[[Capabilities/enrol/manual:enrol|Enrol users]]
*[[Capabilities/enrol/manual:manage|Manage user enrolments]]
*[[Capabilities/enrol/manual:unenrol|Unenrol users from the course]]
*[[Capabilities/enrol/manual:unenrolself|Unenrol self from the course]]

==See also==

* [[Enrolled users]]
*[http://youtu.be/bo1hX8tVw5U Manually Enrolling Users] MoodleBites video on YouTube

[[de:Manuelle Einschreibung]]
[[es:Inscripción manual]]
[[ja:手動登録]]

Text editor

2014-03-06T04:22:29Z

Cttxg: /* See also */ Adding MoodleBites YouTube video link

{{Editing text}}
The text editor (sometimes referred to as the 'HTML editor' or even 'TinyMCE') has many icons to assist the user in entering content. Many of these icons and functions should be familiar to anyone who uses a word processor. Some examples of where you will see the text editor include: Editing Section headings, description of an activity, writing an answer to a quiz question or editing the content of many blocks.

'''Note:''' It's possible to disable the TinyMCE editor and only use a plain text editor from ''Administration>Site administration>Plugins>Text editors>Manage editors.''

==The collapsed editor==
Since Moodle 2.5, the text editor appears collapsed with no formatting in many places to save space. To access the full editor, click "Show editing tools" as in (1) in the screenshot below. You can use keyboard shortcuts for quick formatting as in (2) in the screenshot below. (See [[Text editor FAQ]] for a list of shortcuts.) To increase the size of the editor, drag the bottom right once you have clicked "Show editing tools" as in (3) in the screenshot below.

{|
|[[File:collapsededitor1.png|thumb|The collapsed editor]]
|[[File:expandeditor.png|thumb|The expanded editor]]
|}

==The full editor==
{|
|[[Image:HTMLeditor tools M2 1.png|thumb|The standard version of the text editor tool bar]]
|}

==List of groups==
For those who are not familiar with the tool bar, here are the functions listed by group using the above example. Remember that the site administrator can edit or provide additional toolbars.

Row 1
*[[Image:HTML_editor_group_font_style.png]] - Font, size and heading group
*[[Image:HTML_editor_group_undo_redo.png]] - Undo and Redo group
*[[Image:HTML_editor_group_find_replace.png]] - Find and Replace group
*[[Image:HTML_editor_group_fullscreen_1.png]]|Full screen toggle
Row 2
*[[Image:HTML editor group text effects.png]] - Text effect group
*[[Image:HTML editor group line format.png]] - Line format group
*[[Image:HTML_editor_group_formatting.png]] - Formatting group
*[[Image:HTML_editor_group_color.png]] - Color group
*[[Image:HTML_editor_group_paragraph.png]] - Paragraph group

Row 3
*[[Image:HTML_editor_group_lists.png]] - Number and Bullets and indents
*[[Image:HTML_editor_group_link.png]] - Link group
*[[Image:HTML_editor_group_insert.png]] - Insert group
*[[Image:HTML_editor_group_HTML_spell.png]] - HTML source toggle and spellchecker (IE 9/8 only)

==Special features==

===Color pickers===
*[[Image:HTML_editor_group_color.png]]
There are four levels of selecting a font or background color,
*A quick pick 5x8 matrix of colors
*"More colors" that links to Picker, Pallet and Named tabs
<gallery>
Image:HTML_editor_color_selector_basic_1.png|A quick pick 5x8 matrix of colors
Image:HTML_editor_color_selector_more_picker_1.png|A rainbow color picker tab
Image:HTML_editor_color_selector_more_pallet_1.png|A Pallet tab with a 18x12 matrix of colors
Image:HTML_editor_color_selector_more_named_1.png|A Named tab with custom pallets
</gallery>

===Insert images and media===
[[Image:HTML_editor_group_insert_MU_1.png|thumb|The Insert images and media group]]

* 1 Insert Image - uses [[File picker]]
* 2 Insert Emoticon
* 3 Insert Media - uses [[File picker]]
* 4 Insert Equation - uses java script editor
* 5 Insert Non breaking space
* 6 Insert Custom character - Special keyboard characters
* 7 Insert Table -

<gallery widths="300px">
Image:Files_File_picker_upload_files_add_1.png|File picker Upload file screen
Image:HTML editor equation editor 1.png|Equation editor
Image:HTML_editor_custom_character_selector_1.png|Custom character selector
</gallery>

====Insert table====
<gallery widths="300px">
Image:HTMLeditor_Insert_Table_general_1.png|General tab
Image:HTMLeditor_Insert_Table_advanced_1.png|Advanced tab
</gallery>

'''To add borders to a table'''

Cell borders are crucial for helping readers to follow the rows across the screen. If they aren’t showing already you can add them as follows:

#In the Wiki page containing your table, click its Edit tab
#Carefully select all the cells of the table
#Then right click (Macs: Command+click or Ctrl+Click) over any part of your selection to get a context menu; from it select Cell > Table Cell Properties; the cell properties dialog box then loads.
#Click on its Advanced tab, set Border Color to black (for instance), then click Apply, and then click Update.
#Click Save; the Wiki page containing your table will then load displaying its borders.

==Site administration settings==

===Manage editors===

A site administrator can enable / disable text editors in ''Settings > Site administration > Plugins > Text editors > Manage editors''. By default the TinyMCE HTML editor and plain text area are enabled.

===TinyMCE editor settings===

The TinyMCE HTML editor has its own settings page ''Administration>Site administration>Plugins>Text editors>TinyMCE HTML editor>General settings'' with the following options:

====Plugins====
*Buttons for equations, emoticons,images, media, automatic linking, and legacy spell-checking may be enabled, disabled or uninstall here by clicking on their eye.
*Additionally the equation, emoticon and spell check buttons have links to their Settings screens.

[[File:legacyspellchecker.png |thumb|none|upright=2.0|alt="The TinyMCE editor plugins screen" | The TinyMCE editor plugins screen]]

=====Insert equation=====

Accessed from ''Administration>Site administration>Plugins>Text editors>TinyMCE HTML editor>Edit equation'', this allows you to enable or disable the TeX filter in the editor context and thereby display the Dragmath button. If you have a global custom TeX filter, then disable this setting.

=====Insert emoticon=====
Accessed from ''Administration>Site administration>Plugins>Text editors>TinyMCE HTML editor>Insert emoticon'', this allows you to enable or disable the emoticon filter in the editor context and thereby display the emoticon button.

===== Legacy spell checker=====
The legacy spell checker is visible in IE9 and lower only, but not in other browsers. If you want to disable it and and rely on browser spell checker functionality instead, you can do this by disabling the ''legacy spellchecker'' plugin by clicking its eye in ''Administration > Site administration > Plugins > Text editors > TinyMCE HTML editor > General settings''

To spell-check via your browser, type your word (which if incorrectly spelt will have red lines under it) and press right click + CTRL
{|
|[[File:Browserspellcheck.png|thumb|Right-click+CTRL for browser spellcheck]]
|}

You can select a different spell engine from ''Administration> Site administration > Plugins > Text editors > TinyMCE HTML editor>Check spelling''

{|
|[[File:Spellengine.png|thumb|Choosing a different spell engine]]
|}
According to: http://php.net/manual/en/book.pspell.php

"As of php 5.3. Pspell is no longer supported/bundled. Instead you can use the enchant which is bundled by default in 5.3."

'''NOTE:'''
While the default spell engine is Google spell which can be changed in ''Administration>Site administration>Plugins>Text editors>TinyMCE HTML editor'', this is no longer supported by Google and will not work. (Note that it is only visible in IE9 and lower) It is due to be removed. See MDL-38867. In browser spell check is recommended.

If PSpell is selected then aspell 0.50 or later must be installed on your server and the path to aspell set in Administration > Site administration > Server > System Paths.

===Customising the editor toolbar===

An administrator can remove or add buttons to the TinyMCE editor toolbar by altering the Editor toolbar box in ''Administration>Site administration>Plugins>Text editors>TinyMCE HTML editor>General settings'' as demonstrated in the screencast [http://youtu.be/vTW1DImro9c Customise the text editor in 2.4]

{|
| [[File:editortoolbar.png|thumb|The Editor toolbar box]]
|[[File:horizontalrule.png|thumb|Example of simpler toolbar with added horizontal rule button]]
|[[File:inserttime.png|thumb|An "insert time" button has been added]]

|}

====Available fonts list====

In addition to the default fonts, a site administrator can add extra fonts by typing their name and string in the box in ''Administration > Site administration > Plugins > Text editors > TinyMCE HTML editor>General settings'' as demonstrated in the screencast [http://youtu.be/udP7Bnur30Y How to add extra fonts].

{|
|[[File:comicsans.png|thumb|Example of custom font]]
|}

====Custom configuration====

A setting in ''Administration>Site administration>Plugins>Text editors>TinyMCE HTML editor>General settings'' provides a box in which an administrator can apply custom formats. See MDL-37186 for more details with examples, and see also the [http://www.tinymce.com/wiki.php/Configuration:formats TinyMCE configuration page]

{|
|[[File:bottomtoolbar.png|thumb| Example 1:Toolbar at the bottom]]
|[[File:customstyles.png|thumb| Example 2: Custom styles]]
|}

*Example: Moving the toolbar to the bottom:

Add the following:
{"theme_advanced_toolbar_location" : "bottom"}

*Example: Adding your own custom styles.
(This might be useful for example if you want a "house style" for important notes, key points or similar)
In the editor toolbar, enter "styleselect" and then in the custom box add the following code, changing it to suit your purposes:
{"style_formats" : [
{"title" : "Bold text", "inline" : "b"},
{"title" : "Red text", "inline" : "span", "styles" : {"color" : "#ff0000"}},
{"title" : "Red header", "block" : "h1", "styles" : {"color" : "#ff0000"}} ]}

The following will let you use bootstrap CSS classes if you use a bootstrap based theme:

{"style_formats" : [
{"title" : "Well", "block" : "div", "classes" : "well"},
{"title" : "Label", "inline" : "span", "classes" : "label"},
{"title" : "Label - success", "inline" : "span", "classes" : "label label-success"},
{"title" : "Label - warning", "inline" : "span", "classes" : "label label-warning"},
{"title" : "Label - important", "inline" : "span", "classes" : "label label-important"},
{"title" : "Label - info", "inline" : "span", "classes" : "label label-info"},
{"title" : "Label - inverse", "inline" : "span", "classes" : "label label-inverse"},
{"title" : "Button", "inline" : "a", "classes" : "btn btn"},
{"title" : "Button - primary", "inline" : "a", "classes" : "btn btn-primary"},
{"title" : "Button - info", "inline" : "a", "classes" : "btn btn-info"},
{"title" : "Button - success", "inline" : "a", "classes" : "btn btn-success"},
{"title" : "Button - warning", "inline" : "a", "classes" : "btn btn-warning"},
{"title" : "Button - danger", "inline" : "a", "classes" : "btn btn-danger"},
{"title" : "Button - inverse", "inline" : "a", "classes" : "btn btn-inverse"}
]}

*Example: Enabling copy of rich content with styles from MS Word (tm) and paste into TineMCE without removing important styles:

{"paste_retain_style_properties" : "margin, padding, width, height, font-size,
font-weight, font-family, color, text-align, ul, ol, li,
text-decoration, border, background, float, display"}

==See also==
*[http://youtu.be/bBZQYGcDaMg Moodle 2.0 HTML Editor - Row 1] MoodleBites video on YouTube
*[http://youtu.be/uS_M6-eHsxE Moodle 2.0 HTML Editor - Row 2] MoodleBites video on YouTube
*[http://youtu.be/3rRztnWkhuY Moodle 2.0 HTML Editor - Row 3] MoodleBites video on YouTube

* [[Text editor FAQ]]

[[Category:Site administration]]

[[de:Text-Editor]]

Upload users

2014-01-25T03:52:17Z

Cttxg: /* See also */ Adding MoodleBites YouTube video link

{{Accounts}}
An administrator can upload multiple user accounts via text file in ''Settings > Site administration > Users > Accounts > Upload users''.

There are many robust options for uploading information (fields associated with a user) with this method: from enrolling users in multiple courses with course specific [[Roles|roles]] to updating user information in the [[User profile]] to deleting users from the site.

Rather than uploading the text file, it can simply dragged from the desktop and dropped into the upload area, as demonstrated in the screencast [http://youtu.be/6E-TQXTkZB0 Drag and drop new users into Moodle 2.3] (by Mary Cooch).

''Tip:'' It is usually not necessary to upload users in bulk with Upload users. To keep maintenance work down you should first explore forms of authentication that do not require manual maintenance, such as [[External database authentication|connecting to existing external databases]] or letting the users create their own accounts ([[Self enrolment]]). See [[Authentication]] for more information.

[[File:uploadusersnew.png|thumb|center|Initial upload users screen]]

==Upload user process==
Here is an outline of the process:

# Create file for uploading
# Go to ''Settings > Site administration > Users > Accounts > Upload users''
# Add file to upload
# Upload users preview - check settings and default user profile settings
# Upload users preview - click "Upload users"
# Upload users results - shows list of users, exceptions made in upload and summary of number of users
# Upload users results - click "Continue"
# Returns to Upload users screen

==Updating users preview==
There are settings for the kind of Upload user function you want to perform on the "Upload users preview" page.
[[File:Upload users preview 2.0.JPG|thumb|center|Upload users preview in Moodle 2.x]]

===Updating existing accounts===

By default Moodle adds new user accounts and skips existing users lines where the <code>username</code> matches an existing account. Set "Upload Type" to '''Add new and update existing users''', and existing user account will be updated.
*Add all, append number to usernames if needed
*Add new and update existing users
*Update existing users only

'''Warning''': errors updating existing accounts can affect your users badly. Be careful when using the options to update.

===Additional Options===

There are also fields settings to force password change, allow renames, allow deletes, prevent email address duplicates, standardise usernames and select for bulk operations(new users. updated users, all users).

*Standardise usernames - This folds username to lowercase and strips out illegal characters. This is roughly equivalent to:

$username = preg_replace('/[^-\.@_a-z0-9]/', '', $username);

===Set default user values===

You may be able to set default user field values, if the fields were not included in the uploaded file on this page.

==Upload user results ==
After accepting the preview settings by clicking on "Upload users", you should see the the Upload users results screen.
[[File:Upload users results 2.0.JPG|thumb|center|The results screen; everything went well!]]
This screen will show you any exceptions or changes that were made to each user in the upload process. For example if you were updating user information, the updated information will be shown. Or if a user was not added that record will be highlighted.

The screen will summarize how many users were uploaded or updated, indicate the number of weak passwords and the number of errors.

==File formats for upload users file==
The upload users file has fields separated by a comma (or other delimiter) ONLY - no space. The first line contains the valid field names. The rest of the lines (records) contain information about each user.

'':Tip:'' Avoid special characters in field information like quotes or other commas. Test a file with only one record before a large upload. Remember there are other ways to authenticate users on you site or enroll users in a course.

'':Tip:'' You can use a spread sheet program to create the file with the required columns and fields. Then save the file as "CSV (comma delimited)". These files can be opened with simple text editors for verification.

===Valid upload file for testing===
Here is an example of a simple valid upload file:

<code>username,password,firstname,lastname,email,course1,group1,cohort1 
jonest,verysecret,Tom,Jones,jonest@someplace.edu,math102,Section 1,year 3 
reznort,somesecret,Trent,Reznor,reznort@someplace.edu,math102,Section 3,year 4</code>

===Fields that can be included===
'':Tip:'' We strongly recommend that you test a file that contains fields you proposed to use with one user before attempting a file upload for the first time. http://demo.moodle.net might be a good place to see if your test file works.

*'''Required fields''':
:<code>username,firstname,lastname,email</code>
:Validity checks are performed for:
#<code>username</code> can only contain alphabetical '''lowercase''' letters , numbers, hypen '-', underscore '_', period '.', or at-sign '@'
#<code>email</code> is in the form: ''name@example.com'' .

*'''Password field''': "password" field is optional if "Create password if needed" setting is chosen (default).
**If included, values should meet the requirements for the site's [[Site_policies#Password_policy|Password policy]]. To force password change for a particular user, set the password field to <code>changeme</code>.
**If omitted, a password will be generated for each user (during the next Cron job) and welcome e-mails sent out.
**Note: the text for the welcome e-mail is in the language settings. Please refer to this [https://moodle.org/mod/forum/discuss.php?d=210359&parent=917138 forum thread]for details.

*'''Optional fields''': To provide values other than the default include one or more of these
:<code>institution,department,city,country,lang,auth,timezone,idnumber,icq,phone1,phone2,address,url,description,mailformat,maildisplay,htmleditor,autosubscribe</code>
*Country- use a country TWO LETTER CODE
*Some fields have a maximum number of characters that are allowed (notably institution should be '''at most 40 characters''' long). See hints below.
*Maildisplay, htmleditor and autosubscribe can be set from an import screen.

*'''Custom profile field names''': (Optional). xxxxx is the real custom user profile field name (i.e. the unique shortname)
:<code>profile_field_xxxxx</code>
: Create the custom fields BEFORE importing. Use the standard header. The "shortname" for your custom field is xxxxx (NB the shortname must be all lowercase, otherwise won't be recognised). The first record must include "profile_field_xxxxx".

:'''Example''': To create a custom field "genre", you must write a shortname "genre" in the new field, and write "profile_field_genre" in the header of the .csv file.

: For custom profile fields that are a menu, use the corresponding value (new in Moodle 2.3 onwards).

:'''Example''': A custom field 'Department' with one of three values 'HR', 'Marketing' or 'Training'. Just insert one of those three words (e.g. 'Training') as the value for that field.

*'''Special fields''': Used for changing of usernames or deleting of users
:<code>oldusername</code>, <code>deleted</code>

*'''Enrolment fields''': (Optional):
:<code>course1,type1,role1,group1,enrolperiod1,course2,type2,role2,group2,enrolperiod2</code> etc.

:*<code>course</code> is the "shortname" of the course, if present the user will be enrolled in those courses.
:* <code>type</code> refers to the role to be used for associated course enrolment. Value 1 is default course role, 2 is legacy Teacher role and 3 is legacy Non-editing Teacher.
:* You can use role field instead to specify roles directly - use either role short name or id (numeric names of roles are not supported).
:* Users may be also assigned to groups in course (group1 in course1, group2 in course2, etc.).
:* A group is identified by name or id (numeric group names are not supported)
:* You can set the enrolment duration, in days, for each course (<code>enrolperiod1</code> for <code>course1</code>, <code>enrolperiod2</code> for <code>course2</code>, etc.).

*'''Cohort field''': (Optional):
:<code>cohort1</code>

:Internal cohort id numbers or non-numeric Cohort IDs of existing cohorts must be used; names are not allowed.
*'''mnethostid''' (Optional)
{{New features}}
Existing [[MNet]]users can be added to courses, groups or cohorts as below:
#enrolling to courses: username+mnethostid+course required
# adding to group: username+mnethostid+course+group required
#adding to cohort: username+mnethostid+cohort required
#suspending/reviving accounts: username+mnethostid+suspended required
All other operations are ignored. You can not add users, delete them or update them (such as change names or email, profile fields, etc.)

Commas within a field must be encoded as &#44 - the script will decode these back to commas.

For Boolean fields, use <code>0</code> for false and <code>1</code> for true.

To prevent users from receiving a large number of emails from courses or forced subscription forums use the '''maildigest'''. The options for this field are 0 = No digest, 1 = Complete digest and 2 = Digest with just subjects.

==Advanced potentials of Upload user==
===Templates===

''Note: This section needs checking and updating if necessary for Moodle 2.0. Please do so and remove this note when finished.''

The default values are processed as templates in which the following codes are allowed:

* %l - will be replaced by the lastname
* %f - will be replaced by the firstname
* %u - will be replaced by the username
* %% - will be replaced by the %

Between the percent sign (%) and any code letter (l, f or u) the following modifiers are allowed:

* (-) minus sign - the information specified by the code letter will be converted to lowercase
* (+) plus sign - the information specified by the code letter will be converted to UPPERCASE
* (~) tilde sign - the information specified by the code letter will be converted to Title Case
* a decimal number - the information specified by the code letter will be truncated to that many characters

For example, if the firstname is John and the lastname is Doe, the following values will be obtained with the specified templates:

* %l%f = DoeJohn
* %l%1f = DoeJ
* %-l%+f = doeJOHN
* %-f_%-l = john_doe
*<nowiki> http://www.example.com/~%u/</nowiki> results in <nowiki>http://www.example.com/~jdoe/</nowiki> (if the username is jdoe or %-1f%-l)

Template processing is done only on default values, and not on the values retrieved from the CSV file.

In order to create correct Moodle usernames, the username is always converted to lowercase. Moreover, if the "Allow extended characters in usernames" option in the Site policies page is off, characters different to letters, digits, dash (-) and dot (.) are removed. For example if the firstname is John Jr. and the lastname is Doe, the username %-f_%-l will produce john jr._doe when Allow extended characters in usernames is on, and johnjr.doe when off.

When the "New username duplicate handling" setting is set to Append counter, an auto-increment counter will be append to duplicate usernames produced by the template. For example, if the CSV file contains the users named John Doe, Jane Doe and Jenny Doe without explicit usernames, the default username is %-1f%-l and New username duplicate handling is set to Append counter, then the usernames produced will be jdoe, jdoe2 and jdoe3.

===Deleting accounts===

If the <code>deleted</code> field is present, users with value 1 for it will be deleted. In this case, all the fields may be omitted, except for <code>username</code>. After uploading the file, be sure to change the "Upload type" to "Update existing users only" and the "Allow deletes" option to "Yes".

:''Tip:'' A similar field is available for <code>suspended</code>. This enables a user account to be temporarily disabled rather than completely removed.

Deleting and uploading accounts could be done with a single CSV file. For example, the following file will add the user Tom Jones and delete the user reznort:

<code>username,firstname,lastname,deleted 
jonest,Tom,Jones,0 
reznort,,,1</code>

==Encoding file format==
On the initial Upload user screen, you may select the file encoding format from a pull down list. These include UTF-8 (the default), ASCII, ISO-8859-1 to ISO-8859-11 or any one of over 36 formats.

==Hints==

===Spreadsheet===

If you use a spreadsheet program such as Excel to create your .csv file, check the resulting output in a text editor before you upload it. It is possible to get trailing commas on each line from an empty field if you have added and deleted columns of information prior to saving the final file. Also check the character encoding. A csv file is a simple text file (ASCII or Unicode) that can be used to upload user accounts.

Excel translates passwords that begin with - (minus) or + (plus) as zero. Even when saving as .csv and saying "Yes" to "Keep this format, and leave out any incompatible features." Check for this before uploading, as a zero halts the upload process.

If you use a formula in Excel to create fields (for example, the concatenate function to create a user name), then remember to copy the cells with the formula and use special paste with values checked to make them into an acceptable data for a csv file.

The upload will also fail if you have trailing spaces at the end of your data fields. Often, this can not be removed with a simple Find " " and Replace with "". If information has been copied from web sources than it is possible to include non-breaking spaces which will prevent your upload from being completed correctly. To find these invisible spaces, use the Find and Replace function in Excel. In the find field, hold alt and type 0160. Leave the replace field blank.

===Country===
The country should be written as a two letter code, in capitals. For example, use BE for Belgium or NL for the Netherlands. Using "be" or "nl" as a country code will result in a database error.
:''Tip:'' If you are having trouble working out the two-letter code for a country, you can consult the list of [http://www.iso.org/iso/country_names_and_code_elements country names and code elements] available on the ISO Website. A common error is to use UK for United Kingdom; it should be GB.

===Field size limits===
Some fields have maximum character lengths. Typically the file will import to the preview list screen but not finish the process. Turn on debug to see the fields that are too long. Common fields to cause problems are "Institution" which is limited to 40 characters, and "City", also limited (20 characters). The error will be "User not added - error".

===All fields listed here===
:All the fields that are valid are listed below, except for any custom fields you may have created.
firstname, lastname, username, email, city, country, lang, timezone, mailformat, maildisplay, maildigest, htmleditor, ajax, autosubscribe ,institution, department, idnumber, skype , msn, aim, yahoo, icq, phone1, phone2, address, url, description, descriptionformat, password, auth, oldusername , deleted, suspended, course1, course2, course3, course4

== See also ==
* [http://youtu.be/PFGLZnuu_JI Adding users by using a CSV in Moodle] MoodleBites video on YouTube
*[[Flat file]] enrolment
* [[User profile fields]] for details of how to include data about custom user profile fields in the upload users file

Using Moodle forum discussions:
*[http://moodle.org/mod/forum/discuss.php?d=36851 Can I auto enroll from Excel?]
*[http://moodle.org/mod/forum/discuss.php?d=97903 Uploading users to custom roles]
*[http://moodle.org/mod/forum/discuss.php?d=181259 User upload option: standardise usernames]
*[http://moodle.org/mod/forum/discuss.php?d=144569 Matriculacion con flat file csv] - discussion in Spanish

[[fr:Importer des utilisateurs]]
[[ja:ユーザのアップロード]]
[[de:Nutzerliste hochladen]]

Automated course backup

2014-01-25T03:46:43Z

Cttxg: /* See also */ Adding MoodleBites YouTube video link

{{Backup}}
A site administrator can configure a schedule for automated course backups in ''Settings > Site administration > > Courses > Backups > Automated backup setup''.

Automated course backups runs the same functions as individual [[Course backup|course backups]]. It's a good idea to schedule backups for when your server isn't usually busy. Running the backup tool over all the courses can be processor-intensive, so you shouldn't run it when there are a lot of students trying to access the server. You should always alert users with an announcement on the first page that if they log on during the backup hours they may notice a decrease in performance.

In order to make scheduled backups, you have to set up CRON to run periodically. Please refer to the [[Cron|cron instructions]].

==Setting an automated course backup schedule==

To set the backup schedule:
#Go to ''Settings > Site administration > > Courses > Backups > Automated backup setup''.
#Set backup_auto_active to enabled.
#Select the days of the week to run the backup.
#Set the execution time for the backup process. For most servers, early morning will be the best time. Keep in mind the time zone your server is using.
#Set the "Save to..." path. If you can, choose a backup path on another machine or on a different drive than the one Moodle is on. You don’t want to lose your backups at the same time you lose your Moodle site if the drive fails. If you leave the field blank, then backup zip files will be saved in the backup folder of each course files folder. On a Linux server the path might look like: /home/(your user or domain)/public_html/archive/ or if it's below the publicly accessible folders: /home/(your user or domain)/archive/ if the path is not recognized a red X is shown after saving, otherwise a green check.
#Choose whether to skip the backup of hidden courses or courses which have not been modified within a specified number of days, or not modified since the last backup (new settings in Moodle 2.4 onwards).
#Click the "Save changes" button.

Once you've set up your backup schedule, Moodle will automatically create archives of all the courses on the server at the time you specified. Once the backup is complete, Moodle will send you an email describing the status of the backup.

===Use course names for your backups===

By default, the backups will be named according to the course ID, which is not always easily recognisable. Check the box ''Use course name in backup filename'' in ''Settings > Site Administration > Courses > Backups > Automated backup setup'' to have them saved with the course shortname instead.

==Backups report==

A last execution log of scheduled course backups can be found in ''Settings > Site administration > Reports > Backups''. It displays a list of all course backups made, the time taken to create them, their status (see below), and the next scheduled automated backup execution time.

Clicking on a particular course name will cause a detailed execution log to be displayed, including date, hour and minute when each step of the backup was performed.

[[Image:Reports_Site_Backups_1.jpg]]

===Backup status===

*'''OK''' - The course backup was successfully completed.
*'''Skipped''' - The course was skipped (not backed up) because the course was unavailable to students and had not been changed in the last 31 days. This is not an error, but a feature designed to save process time.
*'''Unfinished''' - The backup was not finished. This might have happened because the job to execute backups ran out of time or resources (e.g., the cron running the backups ran out of time before finishing all the courses waiting). The unfinished jobs should be completed when the next scheduled backups are repeated.
*'''Error''' - There were errors in the backup process for the course, so a backup was not completed. For additional details about the error (1) check the backup log for the affected course (i.e., click the course name in the backups log), or (2) back up the course manually with debugging turned on to see what error message is displayed.

==Course versus site backups==

*Automated course backups are more expensive in terms of time and CPU usage. The recovery time to have your site running again is longer.
*Course backups are useful for obtaining "fresh" copies of courses to be re-used or distributed individually, however they should never be used as a primary backup system (unless your hosting doesn't allow the preferred [[Site backup|site backups]]).

==See also==
* [http://youtu.be/rg6rUuBwITo Moodle 2 Administration Courses ] MoodleBites video on YouTube
* MDL-30725 Automated backups with external storage fill trashdir

Using Moodle forum discussions:
*[http://moodle.org/mod/forum/discuss.php?d=167471 Where is the Moodle 2.0 "Course Backup Filearea"?]
*[http://moodle.org/mod/forum/discuss.php?d=191275 the story of the mysteriously filling up hard disk]

[[Category:Report]]
[[Category:Site administration]]

[[eu:Ikastaroen_segurtasun-kopia_automatikoa]]
[[fr:Sauvegarde (administrateur)]]
[[ja:自動コースバックアップ]]
[[de:Automatische Kurssicherung]]
[[es:Respaldo de curso automatizado]]

Adding a new course

2014-01-25T03:37:34Z

Cttxg: /* See also */ formatting fix

{{Courses}}

By default a regular teacher can't add a new course. To add a new course to Moodle you need to have either [[Administrator|Adminstrator]], [[Course creator|Course Creator]] or [[Manager|Manager]] rights.

==Adding a course==
To add a course:
*Go to ''Settings>Site Administration>Courses>Add/edit courses''

[[File:Addeditcourses.jpg]]

*Choose the category where you want your course to be. For more information see [[Course categories|Course categories]]
*Click the "Add a new course" button
*Enter the [[Course settings|course settings]], then click the "Save changes" button.
*On the next screen, choose your students/teachers to assign to the course.

==Deleting a course(s)==

A regular teacher can't delete a course. Administrators and managers (i.e. users with a role for which the capability [[Capabilities/moodle/course:delete|moodle/course:delete]] is allowed) can delete courses. A [[Course creator|Course creator]] can delete courses they have created themselves.

To delete a course (as an administrator or manager):
*Go to ''Settings > Site Administration > Courses > Add/edit courses''
*Click the course's category (to drill down the category tree) and find the course you wish to delete. Or use the "Search course" textbox at the bottom of the category list.
*Click the "X" icon to the right of the course's name to delete it.

You can delete multiple courses by:
*Creating a new (temporary) category. You can name it "To be deleted".
*Select and '''move''' the "About to be deleted" courses to that category ("To be deleted").
*Delete the category ("To be deleted") and choose "Delete ALL - cannot be undone".

There is no user interface for course creators to delete courses they have created, however they can do so by editing the URL of the course from <nowiki>http://yourmoodlesite.net/course/view.php?id=N</nowiki> to <nowiki>http://yourmoodlesite.net/course/delete.php?id=N</nowiki> (replacing 'view' with 'delete').

==Course requests==

[[File:Courserequest.png|thumb|Course request screen]]The course request feature can be enabled by an administrator in ''Settings > Site administration > Courses > Course request''.

An admin can set the default category for course requests, whether users can select a category when requesting a course, and who can receive notification of course requests (from a list of users with the capability [[Capabilities/moodle/site:approvecourse|moodle/site:approvecourse]]).

A 'Request a new course' button will then appear on the 'All courses' page. The All courses page can be accessed via a link in the [[Courses block]].

If course requests are enabled, by default all authenticated users can make course requests. See [[Course requester role]] for details of how to restrict users who can make course requests.

==Bulk course creation==

It is not yet possible to create courses in bulk, however this feature is coming in Moodle 2.6 (MDL-13114).

==See also==
* [http://youtu.be/vOm1NAknuvk Creating a Course and Course Settings] MoodleBites video on YouTube
* [http://youtu.be/rg6rUuBwITo Moodle 2 Administration Courses] MoodleBites video on YouTube
*Using Moodle [http://moodle.org/mod/forum/discuss.php?d=83830 Hide Courses from some users or students] forum discussion

[[de:Kurs anlegen]]
[[es:Cursos_%28administrador%29]]
[[eu:Ikastaroak_%28Kudeatzaileak%29]]

Adding a new course

2014-01-25T03:36:56Z

Cttxg: /* See also */ Adding MoodleBites YouTube video links

{{Courses}}

By default a regular teacher can't add a new course. To add a new course to Moodle you need to have either [[Administrator|Adminstrator]], [[Course creator|Course Creator]] or [[Manager|Manager]] rights.

==Adding a course==
To add a course:
*Go to ''Settings>Site Administration>Courses>Add/edit courses''

[[File:Addeditcourses.jpg]]

*Choose the category where you want your course to be. For more information see [[Course categories|Course categories]]
*Click the "Add a new course" button
*Enter the [[Course settings|course settings]], then click the "Save changes" button.
*On the next screen, choose your students/teachers to assign to the course.

==Deleting a course(s)==

A regular teacher can't delete a course. Administrators and managers (i.e. users with a role for which the capability [[Capabilities/moodle/course:delete|moodle/course:delete]] is allowed) can delete courses. A [[Course creator|Course creator]] can delete courses they have created themselves.

To delete a course (as an administrator or manager):
*Go to ''Settings > Site Administration > Courses > Add/edit courses''
*Click the course's category (to drill down the category tree) and find the course you wish to delete. Or use the "Search course" textbox at the bottom of the category list.
*Click the "X" icon to the right of the course's name to delete it.

You can delete multiple courses by:
*Creating a new (temporary) category. You can name it "To be deleted".
*Select and '''move''' the "About to be deleted" courses to that category ("To be deleted").
*Delete the category ("To be deleted") and choose "Delete ALL - cannot be undone".

There is no user interface for course creators to delete courses they have created, however they can do so by editing the URL of the course from <nowiki>http://yourmoodlesite.net/course/view.php?id=N</nowiki> to <nowiki>http://yourmoodlesite.net/course/delete.php?id=N</nowiki> (replacing 'view' with 'delete').

==Course requests==

[[File:Courserequest.png|thumb|Course request screen]]The course request feature can be enabled by an administrator in ''Settings > Site administration > Courses > Course request''.

An admin can set the default category for course requests, whether users can select a category when requesting a course, and who can receive notification of course requests (from a list of users with the capability [[Capabilities/moodle/site:approvecourse|moodle/site:approvecourse]]).

A 'Request a new course' button will then appear on the 'All courses' page. The All courses page can be accessed via a link in the [[Courses block]].

If course requests are enabled, by default all authenticated users can make course requests. See [[Course requester role]] for details of how to restrict users who can make course requests.

==Bulk course creation==

It is not yet possible to create courses in bulk, however this feature is coming in Moodle 2.6 (MDL-13114).

==See also==
* [http://youtu.be/vOm1NAknuvk Creating a Course and Course Settings] MoodleBites video on YouTube
* [http://youtu.be/rg6rUuBwITo Moodle 2 Administration Courses ] MoodleBites video on YouTube
*Using Moodle [http://moodle.org/mod/forum/discuss.php?d=83830 Hide Courses from some users or students] forum discussion

[[de:Kurs anlegen]]
[[es:Cursos_%28administrador%29]]
[[eu:Ikastaroak_%28Kudeatzaileak%29]]

Course backup

2014-01-25T03:33:03Z

Cttxg: /* See also */ Adding MoodleBites YouTube video link

{{Backup}}
A course can be saved with some or all of its parts by using the course backup. Typically, the site administrator will set a schedule of [[Automated course backup|automated course backups]] for the whole site. A teacher with editing privileges can create a backup or download an existing backup for safe keeping, or for use on another Moodle site.

==Backing up a course==

[[Image:Backup of a course section.png|thumb|Schema selection, no user data selected in initial settings]]To backup a course

# Go to ''Settings > Course administration > Backup''
# Initial settings - Select activities, blocks, filters and other items as required then click the Next button. Users with appropriate permissions, such as administrators and managers, can choose whether to [[Backup of user data|include users]], anonymize user information, or include user role assignments, user files, comments, user completion details, course logs and grade history in the backup.
# Schema settings - Select/deselect specific items to include in backup then click the Next button
# Confirmation and review - Check that everything is as required, using the Previous button if necessary, otherwise click the 'Perform backup' button
# Complete - Click the Continue button

A backup file (with distinctive .mbz extension to avoid confusion with .zip files) is then saved in the course backup area.

Backup in Moodle 2.0 video:

<mediaplayer>http://www.youtube.com/watch?v=mya-u0zAZZE</mediaplayer>

==Anonymizing user information==

Anonymize user information is a backup feature which "protects user identities" by making each user anonymous. If this box is checked in the backup initial settings, Moodle will substitute aliases for real names, substituting @doesntexist.com email addresses and so forth. For example "Max Manager" might become "anonfirstname4 anonlastname4".

==Backup and restore from 1.9 to 2==

Courses created in 1.9 can be backed up and then restored into a 2.1 Moodle or later but blocks are not currently restored and nor is user data (such as forum posts, grades, submissions etc).

==Backup and restore of assignments from Moodle 2.2 and older==

The assignment activity module was completely rewritten in Moodle 2.3. Thus, assignments from Moodle 2.2 and older (e.g. from Moodle 1.9) need to be upgraded in order to continue being usable. See the section 'Restoring course backups from Moodle 2.2 and older' in [[Assignment upgrade tool]] for details of what to do.

==Tips and tricks==
* Lose content after a restore in Moodle 2.0 ? Do you see topic headings that say "Orphaned activities"? Solution: Go to course settings and increase the number of topic sections and things will return to normal.

==Creative uses==
The backup and restore processes can offer the teacher and administrators many creative solutions.
*Duplicating courses or specific activities in one course to another course (similar to Import)
*Updating a production Moodle site course, with material from a localhost site course
*Transferring a course to a new Moodle site.
*In earlier versions of Moodle, a way of rolling a course forward without past student activity
*Creating a blank activity, save just that activity and then restore it to the course or another course one or more times.

==General backup defaults==

Default settings for course backups can be set by a site administrator in ''Settings > Site administration > Courses > Backups > General backup defaults''.

Selected settings may be locked, so that they cannot be changed when creating a course backup.

By selecting a time in the "Keep logs for.." dropdown, it is possible to specify how long backup logs information is kept before being deleted. As this information may be very large, it is recommended the length of time chosen be quite short.

==Course backup capabilities==

*[[Capabilities/moodle/backup:anonymise|Anonymise user data on backup]]
*[[Capabilities/moodle/backup:backupcourse|Backup courses]]
*[[Capabilities/moodle/backup:backupsection|Backup sections]]
*[[Capabilities/moodle/backup:backuptargethub|Backup for hub]]
*[[Capabilities/moodle/backup:backuptargetimport|Backup for import]]
*[[Capabilities/moodle/backup:configure|Configure backup options]]
*[[Capabilities/moodle/backup:downloadfile|Download files from backup areas]]
*[[Capabilities/moodle/backup:userinfo|Backup user data]]

==See also==

*[[Course restore]]
*[[Backup of user data]]
*[[Activity backup]]
* [http://youtu.be/rg6rUuBwITo Moodle 2 Administration Courses ] MoodleBites video on YouTube

[[de:Kurssicherung]]
[[es:Respaldo del curso]]
[[eu:Ikastaroaren_Segurtasun-kopia]]
[[fr:Sauvegarde de cours]]
[[ja:コースバックアップ]]

Course settings

2014-01-25T03:30:02Z

Cttxg: /* See also */ Adding MoodleBites YouTube video link

{{Courses}}
A teacher, or other user with the [[Capabilities/moodle/course:update|update course settings capability]], can change course settings in ''Settings > Course administration > Edit settings''.

==General==
{|
|[[File:generalcourse25.png|thumb|General settings,expanded by default]]
|}

===Course full name===

This is the name of the course. It is displayed as a link on course lists on the [[Front page]] and on [[My home]] and in reports. It is also used in the browser title bar when the course is viewed.

The capability [[Capabilities/moodle/course:changefullname|moodle/course:changefullname]] controls whether a user can edit the course full name.

===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, such as the Navigation block.

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

By default, only course full names are displayed in the list of courses. However an administrator can enable short names to be displayed too if required by ticking the checkbox in ''Settings > Site administration > Appearance > Courses''.

=== Course category===

The site administrator may have created course categories to help teachers and students find their courses easily. Course categories may be reflected in the [[Navigation block]].

The capability [[Capabilities/moodle/course:changecategory|moodle/course:changecategory]] controls whether a user can edit the course category.
===Course start date===
This setting affects the display of logs and the weekly format topic dates.

If you use the "Weekly" course format, the start date will appear in the first section of the course. For example selecting 27 July, will display "27 July - 2 August" in the first section (when default display is selected for that section).

This setting will have an effect on the display of logs. This will be the earliest possible date the log activity will display.

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

:''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. Please note that the 'first day of the week' is set by the [https://docs.moodle.org/dev/Translation_langconfig langconfig file] of your [[Language]], and might be different from the default Monday of the English language pack.

:''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.

:''TIP:'' See self enrolment course settings to prevent students from entering the course before a certain date/time.

===Visible===

Here you can "hide" your course completely. It will not appear on any course listings, except for managers, course creators, teachers and any other users with the [[Capabilities/moodle/course:viewhiddencourses|view hidden courses capability]]. Even if students try to access the course URL directly, they will not be allowed to enter.

The [[Capabilities/moodle/course:visibility|hide/show courses capability]] controls whether a user can hide a course.

Note: In earlier versions of Moodle, this setting was named 'Course availability'.

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

==Description==
{|
|[[File:descriptioncourse25.png|thumb|Description settings expanded by default]]
|}

===Course summary===

The summary appears on the course listings page. This field is searched when searching for a course and also appears in the Course/Site description block.

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

===Course summary files===
{{New features}}
An image (and if allowed by the administrator, other file types) may be attached to the course summary. They will be accessible by anyone from outside of the course just like the course name and/or summary. Only users with [[Capabilities/moodle/course:changesummary| moodle/course:changesummary capability]] are able to upload/change course summary files.
''Note that if this is not allowed by the administrator, then no box will appear to upload course summary files''.

By default, only jpg, gif and png file types are allowed as course summary files. An administrator can change the allowed file types in ''Administration > Site administration > Appearance > Courses''.

==Course format==
(These settings are collapsed by default.)
{|
|[[File:coursefomat25.png|thumb|Course format settings expanded]]
|}

===Format===
See [[Course formats]]
===Number of sections===

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.

If the number of weeks/topics is changed for an existing course so that the number is less than the number of course sections containing activities (for example the course contains activities in 3 sections and the number or weeks/topics is set to 2) then when editing is turned on section(s) at the bottom of the course page will be shown with the title 'Orphaned activities'.

The number of weeks/topics may be set to 0, so that only the top general section is displayed on the course page and there are no numbered sections.

By default, the maximum number of weeks/topics is 52, but an administrator can set a different maximum number which will apply to all courses on the site (see below).
===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 grey) 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 quizzes 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.

===Course layout===

The Course layout setting determines whether the whole course is displayed on one page or split over several pages. The setting currently applies to the topics and weekly core course formats and contributed collapsed topics course format only.

Teachers choose from the dropdown whether they wish to "show all sections on one page" in the familiar scrolling format, or "show one section per page".

If one section per page is selected, the course page is abbreviated to a list of links to individual sections. If an individual section is shown, next and previous sections may be accessed via links above and below the section.

{|
| [[File:one section per page course format.png|thumb|Course page for course using one section per page course layout]]
| [[File:Single_section_page.png|thumb|Individual section of a course using one section per page course layout]]
|}

Visit the School demo site course [http://school.demo.moodle.net/course/view.php?id=96 The Types of Sport] to see the "Show one section per page" course layout in action!

For further details plus screenshots, see blog post [http://www.somerandomthoughts.com/blog/2012/05/08/moodle-2-3-section-per-page/ Moodle 2.3 – Section per page] by Gavin Henrick.

==Appearance==
(These settings are collapsed by default.)

{|
|[[File:appearancecourse252.png|thumb|Appearance settings expanded]]
|}

===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. Teachers can use this to choose a different look for the course from the rest of the Moodle site.

=== Force language===
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.
===News items to show===
How many news items should show the [[Latest news block]]. Set it to 0 and Latest news block will not appear.

The Latest News block relies on the use of the associated News Forum. News posted in other forums do not display in the latest News block

===Show gradebook to students===
Here you can decide whether to allow students to see the link to [[Grades|grades]] in the Administration block. If your course doesn't use graded activities, it makes sense to disable this. If grades are used and this link is disabled, students can still see their grade from the actual activity itself, such as an [[Assignment|assignment]]

===Show activity reports===

Here you can decide whether to show students their [[Activity_report#Individual_Activity_Report|activity reports]]. Doing so places a load on the server however, which is why the setting is disabled by default.

==Files and uploads==
(These settings are collapsed by default.)
===Maximum upload size===
Here you can decide the largest size of file that students can upload to a course. The site administrator can determine [[Site_policies#Maximum_uploaded_file_sizefile |sizes available]] for the teacher to select.

Editing teachers or other users may be allowed to upload files larger than the maximum size by giving them the capability [[Capabilities/moodle/course:ignorefilesizelimits|moodle/course:ignorefilesizelimits]]

==Completion tracking==
(These settings are collapsed by default.)

Completion tracking must be enabled for [[Activity completion]]. [[Course completion]] criteria may also be based upon Activity completion values found in the activity's settings.

==Guest access==
(These settings are collapsed by default.)
{|
|[[File:guestaccess25.png|thumb|Guest access settings expanded]]
|}
Here you can decide whether to allow logged in users to access the course as a guest, and whether or not they need to enter a password. See [[Guest role|Guest role]] for more information.

==Groups==
(These settings are collapsed by default.)
{|
|[[File:coursegroups25.png|thumb|Groups settings expanded]]
|}
===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 and who they can interact with in activities.

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

===Default grouping===

If [[Groupings|groupings]] are enabled, a default grouping for course activities and resources may be set.

==Role renaming==
(These settings are collapsed by default.)
{|
|[[File:rolerenaming.png|thumb|Role renaming settings expanded]]
|}
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 [[Manager |course manager]] may have changed the names or added new roles. These names will appear and the teacher may rename them.

== Site administration settings==

An administrator can set course default settings in ''Administration > Site administration > Courses > Course default settings''.

The maximum number of weeks/topics may be set for all courses on the site. The default value is 52.

==Preventing teachers from editing course settings==

Any/all of the following fields - course full name, short name, ID number and category, summary - may be locked to prevent teachers from editing them. To do so:

#Access ''Site Administration > Users > Permissions > Define roles''.
#Click the edit icon opposite the teacher role.
#Change any/all of the capabilities [[Capabilities/moodle/course:changefullname|moodle/course:changefullname]], [[Capabilities/moodle/course:changeshortname|moodle/course:changeshortname]], [[Capabilities/moodle/course:changeidnumber|moodle/course:changeidnumber]], [[Capabilities/moodle/course:changecategory|moodle/course:changecategory]], [[Capabilities/moodle/course:changesummary|moodle/course:changesummary]] from allow to not set.
#Click the "Save changes" button at the bottom of the page.

==See also==
* [http://youtu.be/vOm1NAknuvk Creating a Course and Course Settings] MoodleBites video on YouTube
* [http://youtu.be/rg6rUuBwITo Moodle 2 Administration Courses] MoodleBites video on YouTube

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

Course settings

2014-01-25T03:13:40Z

Cttxg: /* See also */ Adding MoodleBites YouTube video link

{{Courses}}
A teacher, or other user with the [[Capabilities/moodle/course:update|update course settings capability]], can change course settings in ''Settings > Course administration > Edit settings''.

==General==
{|
|[[File:generalcourse25.png|thumb|General settings,expanded by default]]
|}

===Course full name===

This is the name of the course. It is displayed as a link on course lists on the [[Front page]] and on [[My home]] and in reports. It is also used in the browser title bar when the course is viewed.

The capability [[Capabilities/moodle/course:changefullname|moodle/course:changefullname]] controls whether a user can edit the course full name.

===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, such as the Navigation block.

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

By default, only course full names are displayed in the list of courses. However an administrator can enable short names to be displayed too if required by ticking the checkbox in ''Settings > Site administration > Appearance > Courses''.

=== Course category===

The site administrator may have created course categories to help teachers and students find their courses easily. Course categories may be reflected in the [[Navigation block]].

The capability [[Capabilities/moodle/course:changecategory|moodle/course:changecategory]] controls whether a user can edit the course category.
===Course start date===
This setting affects the display of logs and the weekly format topic dates.

If you use the "Weekly" course format, the start date will appear in the first section of the course. For example selecting 27 July, will display "27 July - 2 August" in the first section (when default display is selected for that section).

This setting will have an effect on the display of logs. This will be the earliest possible date the log activity will display.

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

:''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. Please note that the 'first day of the week' is set by the [https://docs.moodle.org/dev/Translation_langconfig langconfig file] of your [[Language]], and might be different from the default Monday of the English language pack.

:''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.

:''TIP:'' See self enrolment course settings to prevent students from entering the course before a certain date/time.

===Visible===

Here you can "hide" your course completely. It will not appear on any course listings, except for managers, course creators, teachers and any other users with the [[Capabilities/moodle/course:viewhiddencourses|view hidden courses capability]]. Even if students try to access the course URL directly, they will not be allowed to enter.

The [[Capabilities/moodle/course:visibility|hide/show courses capability]] controls whether a user can hide a course.

Note: In earlier versions of Moodle, this setting was named 'Course availability'.

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

==Description==
{|
|[[File:descriptioncourse25.png|thumb|Description settings expanded by default]]
|}

===Course summary===

The summary appears on the course listings page. This field is searched when searching for a course and also appears in the Course/Site description block.

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

===Course summary files===
{{New features}}
An image (and if allowed by the administrator, other file types) may be attached to the course summary. They will be accessible by anyone from outside of the course just like the course name and/or summary. Only users with [[Capabilities/moodle/course:changesummary| moodle/course:changesummary capability]] are able to upload/change course summary files.
''Note that if this is not allowed by the administrator, then no box will appear to upload course summary files''.

By default, only jpg, gif and png file types are allowed as course summary files. An administrator can change the allowed file types in ''Administration > Site administration > Appearance > Courses''.

==Course format==
(These settings are collapsed by default.)
{|
|[[File:coursefomat25.png|thumb|Course format settings expanded]]
|}

===Format===
See [[Course formats]]
===Number of sections===

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.

If the number of weeks/topics is changed for an existing course so that the number is less than the number of course sections containing activities (for example the course contains activities in 3 sections and the number or weeks/topics is set to 2) then when editing is turned on section(s) at the bottom of the course page will be shown with the title 'Orphaned activities'.

The number of weeks/topics may be set to 0, so that only the top general section is displayed on the course page and there are no numbered sections.

By default, the maximum number of weeks/topics is 52, but an administrator can set a different maximum number which will apply to all courses on the site (see below).
===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 grey) 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 quizzes 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.

===Course layout===

The Course layout setting determines whether the whole course is displayed on one page or split over several pages. The setting currently applies to the topics and weekly core course formats and contributed collapsed topics course format only.

Teachers choose from the dropdown whether they wish to "show all sections on one page" in the familiar scrolling format, or "show one section per page".

If one section per page is selected, the course page is abbreviated to a list of links to individual sections. If an individual section is shown, next and previous sections may be accessed via links above and below the section.

{|
| [[File:one section per page course format.png|thumb|Course page for course using one section per page course layout]]
| [[File:Single_section_page.png|thumb|Individual section of a course using one section per page course layout]]
|}

Visit the School demo site course [http://school.demo.moodle.net/course/view.php?id=96 The Types of Sport] to see the "Show one section per page" course layout in action!

For further details plus screenshots, see blog post [http://www.somerandomthoughts.com/blog/2012/05/08/moodle-2-3-section-per-page/ Moodle 2.3 – Section per page] by Gavin Henrick.

==Appearance==
(These settings are collapsed by default.)

{|
|[[File:appearancecourse252.png|thumb|Appearance settings expanded]]
|}

===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. Teachers can use this to choose a different look for the course from the rest of the Moodle site.

=== Force language===
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.
===News items to show===
How many news items should show the [[Latest news block]]. Set it to 0 and Latest news block will not appear.

The Latest News block relies on the use of the associated News Forum. News posted in other forums do not display in the latest News block

===Show gradebook to students===
Here you can decide whether to allow students to see the link to [[Grades|grades]] in the Administration block. If your course doesn't use graded activities, it makes sense to disable this. If grades are used and this link is disabled, students can still see their grade from the actual activity itself, such as an [[Assignment|assignment]]

===Show activity reports===

Here you can decide whether to show students their [[Activity_report#Individual_Activity_Report|activity reports]]. Doing so places a load on the server however, which is why the setting is disabled by default.

==Files and uploads==
(These settings are collapsed by default.)
===Maximum upload size===
Here you can decide the largest size of file that students can upload to a course. The site administrator can determine [[Site_policies#Maximum_uploaded_file_sizefile |sizes available]] for the teacher to select.

Editing teachers or other users may be allowed to upload files larger than the maximum size by giving them the capability [[Capabilities/moodle/course:ignorefilesizelimits|moodle/course:ignorefilesizelimits]]

==Completion tracking==
(These settings are collapsed by default.)

Completion tracking must be enabled for [[Activity completion]]. [[Course completion]] criteria may also be based upon Activity completion values found in the activity's settings.

==Guest access==
(These settings are collapsed by default.)
{|
|[[File:guestaccess25.png|thumb|Guest access settings expanded]]
|}
Here you can decide whether to allow logged in users to access the course as a guest, and whether or not they need to enter a password. See [[Guest role|Guest role]] for more information.

==Groups==
(These settings are collapsed by default.)
{|
|[[File:coursegroups25.png|thumb|Groups settings expanded]]
|}
===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 and who they can interact with in activities.

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

===Default grouping===

If [[Groupings|groupings]] are enabled, a default grouping for course activities and resources may be set.

==Role renaming==
(These settings are collapsed by default.)
{|
|[[File:rolerenaming.png|thumb|Role renaming settings expanded]]
|}
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 [[Manager |course manager]] may have changed the names or added new roles. These names will appear and the teacher may rename them.

== Site administration settings==

An administrator can set course default settings in ''Administration > Site administration > Courses > Course default settings''.

The maximum number of weeks/topics may be set for all courses on the site. The default value is 52.

==Preventing teachers from editing course settings==

Any/all of the following fields - course full name, short name, ID number and category, summary - may be locked to prevent teachers from editing them. To do so:

#Access ''Site Administration > Users > Permissions > Define roles''.
#Click the edit icon opposite the teacher role.
#Change any/all of the capabilities [[Capabilities/moodle/course:changefullname|moodle/course:changefullname]], [[Capabilities/moodle/course:changeshortname|moodle/course:changeshortname]], [[Capabilities/moodle/course:changeidnumber|moodle/course:changeidnumber]], [[Capabilities/moodle/course:changecategory|moodle/course:changecategory]], [[Capabilities/moodle/course:changesummary|moodle/course:changesummary]] from allow to not set.
#Click the "Save changes" button at the bottom of the page.

==See also==
* [http://youtu.be/vOm1NAknuvk Creating a Course and Course Settings] MoodleBites video on YouTube

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

Site appearance

2014-01-19T01:47:21Z

Cttxg: Adding MoodleBites YouTube video link

{{Managing a Moodle site}}

There are many ways to customise the appearance of your Moodle site so that it blends in with, for example, your college site or your company's corporate brand. The links below provide more information on personalising the appearance of Moodle:
*[[Front page]] - how best to display the entry page to your Moodle.
*[[My home]] - a personalised "dashboard" page for each user
*[[User profiles]]
*[[Navigation]] - control how users find their way around Moodle
*[[Course list]] - control who appears in the list of courses
*[[Themes]] - change the "skin" of your Moodle for the whole site or just sections.
*[[Header and footer]] - add information to the top and bottom areas of your Moodle.

==See also==
* [http://youtu.be/05eW0NzDi_c Moodle 2 Appearance Administration settings] MoodleBites video on YouTube
*Change the language or default wording on your site - [[Language|Language]]

[[de:Darstellung]]