MoodleDocs - User contributions [en]

MoodleDocs:About

2020-11-10T09:47:38Z

Marycooch: changed email to contact form link

'''Moodle Docs''' is the documentation for [http://moodle.org/ Moodle], written by the Moodle community.

It's based on wiki technology and is powered by [https://www.mediawiki.org MediaWiki].

==Contact==

* For feedback and suggestions about Moodle Docs, please join the discussions in the [https://moodle.org/mod/forum/view.php?id=7135 Moodle community sites forum].
* For account queries please use the [https://moodle.com/contact/support/?selection=community#form Moodle.com contact form].
==See also==

* [[MoodleDocs:Privacy]]
* [[Documentation philosophy]]
* [[Guidelines for Contributors]]

[[Category:MoodleDocs|About]]

[[fr:MoodleDocs:À propos]]
[[es:MoodleDocs:Acerca de]]

Site registration

2020-11-10T09:43:45Z

Marycooch: changed email to contact form link

{{Managing a Moodle site}}
__NOTOC__
[[File:Boost-Moodle-Registrations.jpg]]
==Why register my site?==
Registering your site gives us a better picture of how Moodle is used worldwide and helps us make decisions about new features and plugins.

==5 reasons to register==
# Stay up to date by email whenever there are new releases of Moodle or security alerts.
# Be part of the [https://moodle.net/stats/ statistics of the worldwide community].
# List your site on our [https://moodle.net/sites/ list of registered sites in your country]. (But if you want to keep it private, that’s fine too!)
# [[Course sharing|Share your courses]] on Moodle.net
# Make use of the messaging server https://messages.moodle.net/ for [[Mobile app notifications|Moodle mobile push notifications]].

==How about security?==
We don’t share your information with anyone. We don’t go into your site. We use the aggregated anonymous data to publish the statistics of the worldwide community and use the other data to help us in our decision making around new features and plugins.

==How do I register?==
Register your site by logging in as an administrator and going to ''Site administration > Registration''. If you’re not the admin, ask them nicely to check!

==I don’t want my details public==
Your registration is private to us unless you choose to make it public.

==Do I have to register? What happens if I don’t?==
Registration is optional, but we wouldn’t want you to miss out on any important security issues or upgrades and put your site at risk.

The more people who register, the better a picture we get of how Moodle is used and which aspects we can improve.

So registering is a win-win for you as well as for us.

==I can’t register my site!==
Only sites which are online can be registered. If your site is online and you have problems registering, please use the [https://moodle.com/contact/support/?selection=community#form Moodle.com contact form].

If you encounter a problem updating your registration, please try unregistering then re-registering your site. To unregister your site, click the ‘Unregister’ link at the bottom of the Registration page.

Note that it can take a while before your site is listed on https://moodle.net/sites/ so please be patient.

==See also==

* [https://moodle.org/mod/forum/discuss.php?d=362833 Annoying restored test Moodle] forum discussion about a test site and registration

[[Category:Site administration]]
[[Category:Moodle.net]]

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

RecordRTC

2020-07-28T10:44:35Z

Marycooch: removing ref to Atto plugin

{{Infobox plugin
|type = Editors
|entry = https://moodle.org/plugins/tinymce_recordrtc
|maintainer = [[User:Jesus Federico|Jesus Federico]]
|float = right
}}
==What is RecordRTC?==

RecordRTC is a set of plugins for the [https://moodle.org/plugins/tinymce_recordrtc TinyMCE editor], enabling users to add audio and video annotations to text, anywhere a text editor is present. This plugin adds buttons for recording audio or video (with audio) to the editor's toolbar. [[File:recordrtc_buttons.png]] (Note that the [[Atto editor]] has this feature as standard.)

Using [https://webrtc.org/ WebRTC] technologies, all recording is done instantly in the browser. After recording, users can embed the annotation directly into the text they are currently editing. The recording will appear as an audio or video player in the published writing.

The plugin works fine with Chrome, Firefox and Opera on Desktop computers running Windows, Linux, Mac OS and Chrome OS.

==How do I get it?==
*Administrators whose Moodle sites allow plugins to be installed directly can install RecordRTC by clicking the Install Plugins link from the Plugins area of Site administration and then searching for the or [https://moodle.org/plugins/tinymce_recordrtc TinyMCE RecordRTC plugin] as appropriate.
*Administrators who are not able to install plugins directly can download the plugin from the Moodle Plugins directory and upload it to the server.
*The plugins are also available on Github: [https://moodle.org/plugins/pluginversions.php?plugin=atto_recordrtc Here for Atto] and [https://moodle.org/plugins/pluginversions.php?plugin=tinymce_recordrtc here for TinyMCE] Look for the latest release and download zip file by using the link [[File:recordrtc_git_download.png]] See the FAQ below for set up with Ubuntu.

=== What are the admin settings? ===
The plugins will work with the defaults, but you can change them from theText editors pages (Atto or TinyMCE) from Plugins in Site administration.

Administrators can:

* Allow the users to record only audio, only video, or both by changing the buttons that appear in the editor toolbar.
* Change the target bitrate of recorded audio.
* Change the target bitrate of recorded video
* Set the recording time limit, to control maximum recording size

The default bitrate for recorded audio (128000) should lead to generate files of about 15kB per minute and the default bitrate for recorded video (2500000) to generate files of 20MB per minute. The lower the bitrate the smaller the file size.

The recording time limit is set to 120 seconds by default so the maximum size expected on video files should be of about 40MB

==How does it work?==
*The Atto or TinyMCE editors will display one or both icons for audio and/or video, depending on the administrator's setting.

[[File:RecordAtto.png]]
*Click the icon for audio or video recording. You'll see a button 'Start recording'. Click it and speak.
[[File:attachasannotation.png]]
*When you have finished, click to stop the recording. It will ask you to name it and attach the recording as an annotation.

== Troubleshooting ==
=== Recording stops after a few seconds ===
[[File:recordingrtc_error_limit_reached.png]]

There are two settings that establish the maximum file size that can be uploaded to Moodle. These are defined in php.ini for the web server.
post_max_size = 8M
upload_max_filesize = 2M
Just edit the file and increase their values to something between 40M-50M for 2 minutes video recordings.
In Ubuntu
vi /etc/php/7.0/apache2/php.ini

You can set some large values as described in [https://tracker.moodle.org/browse/MDL-62872?focusedCommentId=654424&page=com.atlassian.jira.plugin.system.issuetabpanels%3Acomment-tabpanel#comment-654424 this Moodle tracker issue]:
post_max_size = 1024M
upload_max_filesize = 1024M

== Known Issues ==
* The media files don't show duration
* The controls for navigating the files do not work properly in the player.

== F.A.Q. ==
=== Why won't these plugins work with all browsers? ===
WebRTC ("Web Real-Time Communication") is a collection of communications protocols and application programming interfaces that enable real-time communication over peer-to-peer connections. Implemented in browsers it enables applications such as video conferencing, file transfer, chat, or desktop sharing without the need of either internal or external plugins.[[https://en.wikipedia.org/wiki/WebRTC Wikipedia]]

MediaStream Recording API, sometimes simply referred to as the Media Recording API or the MediaRecorder API, is closely affiliated with the Media Capture and Streams API and the WebRTC API. The MediaStream Recording API makes it easy to record audio and/or video streams. When used with navigator.mediaDevices.getUserMedia(), it provides an easy way to record from the user's input devices and instantly use the result in web apps. Both audio and video may be recorded, separately or together. [[https://developer.mozilla.org/en-US/docs/Web/API/MediaRecorder MediaRecorder Documentation]]

As these plugins make use of diverse WebRTC technologies, they can only be used in browsers that have implemented both [[https://www.w3.org/TR/webrtc/ WebRTC 1.0]] and [[https://www.w3.org/TR/mediastream-recording/ MediaRecorder API]]. This is the case for [https://www.google.com/chrome/ Chrome], [https://www.mozilla.org/en-US/firefox/new/ Firefox] and [http://www.opera.com/ Opera]. [[https://webrtc.org/ See `Supported browsers and platforms`]] Therefore these are the only ones that the initial version of these plugins (1.0) support.

Edge has implemented WebRTC 1.0 in [https://www.microsoft.com/en-us/windows/microsoft-edge Microsoft Edge] but it does not include MediaRecorder API, so implementing the plugins for this browser requires some customisation to the libraries and the use of an external server.

Safari 11 for iOS will support WebRTC 1.0 [[https://webrtc.ventures/2017/06/webrtc-support-in-safari-11/ See]] but same as edge, the implementation of MediaRecorder API has not been announced.

As this covers only about the 60% of the browsers, there are plans for adding support to these two browsers by making use of Media Streaming as in version 2.0 of these plugins.

=== Can I have recordings of more than 2 minutes? ===
Yes. That can be changed in the plugin configuration. Keep in mind that as the file size will increase, the settings in php should also be edited.
Also, because the size can be too much for the browser itself, we recommend not going to large.
The only solution for giving a really large limit to the file size is to include a server component for doing a progressive upload and trans coding. But the first version of these plugins do not cover that possibility.

=== Where are the recordings stored? ===
Storing the RecordRTC recordings is not different than storing any other media file that is uploaded to Moodle. So, it depends of the file system your Moodle server has configured.
When using the default configuration, all files are stored in <code>/moodlepath/moodledata/filedir/xx/yy/</code> where xx and yy are the path defined by the API when the file was uploaded.
If you are a developer interested in learning more details about this you can see [https://docs.moodle.org/dev/File_API_internals#File_storage_on_disk File storage on disk]. It is an old article but it gives a good idea on what is underneath. Also see [[Amazon S3 repository]] for information on storing files externally in Amazon S3 buckets.

=== How do I set it up with Ubuntu?===
* Navigate to `moodle_root_path/lib/editor/atto/plugins` or `moodle_root_path/lib/editor/tinymce/plugins`, where `moodle_root_path` is the location where Moodle is installed (ex.: `/var/www/html/moodle`)
** For Atto execute <code>sudo git clone https://github.com/blindsidenetworks/moodle-atto_recordrtc.git recordrtc</code>
** For TinyMCE execute <code>sudo git clone https://github.com/blindsidenetworks/moodle-tinymce_recordrtc.git recordrtc</code>
* Log into a Moodle account with administration capabilities

==Notes for system administrators ==
=== Increasing max file size ===
The default maximum size of uploads in PHP is very small, it is recommended to set the upload_max_filesize setting to 40M and the post_max_size setting to 50M for a time limit of 2:00 to avoid getting an alert while recording.

The file size of recorded video for Firefox will likely be twice that of other browsers, even with the same settings; this is expected as it uses a different writing library for recording video. The audio file size should be similar across all browsers.

== Notes for developers ==
=== Updating libraries ===
These plugins makes use of two libraries. Adapter.js which makes all the WebRTC magic and Bowser.js that helps to identify the browser and OS where the application is running.

If trying to update Bowser or Adapter.js dependencies for the project, it is necessary to replace the named definition at the top of the file with an anonymous one, like so
For Bowser.js:

Old code:
<code>
!function (root, name, definition) {
if (typeof module != 'undefined' && module.exports) module.exports = definition()
else if (typeof define == 'function' && define.amd) define(name, definition)
else root[name] = definition()
}(this, 'bowser', function () {
</code>

New code:
<code>
define([], function() {
</code>

Or so for Adapter.js:

Old code
<code>
(function(f){if(typeof exports==="object"&&typeof module!=="undefined"){module.exports=f()}else if(typeof define==="function"&&define.amd){define([],f)}else{var g;if(typeof window!=="undefined"){g=window}else if(typeof global!=="undefined"){g=global}else if(typeof self!=="undefined"){g=self}else{g=this}g.adapter = f()}})(function(){
</code>

New code
<code>
define([], function() {
</code>

[[Category:Audio]]
[[Category:Video]]
[[Category:Language teaching]]

[[es:RecordRTC]]

Talk:Scales

2019-03-12T18:56:52Z

Marycooch:

: The Cool Scale - Not cool, Not very cool, Fairly cool, Cool, Very cool, The coolest thing ever!
:: (Valued as 0/5pts, 1/5pt, 2/5pts, 3/5pts, 4/5pts, and 5/5pts respectively in any '''normalized aggregation''' method)
:: (Valued as 1, 2, 3, 4, 5, and 6 respectively in the '''sum aggregation''' method)

Please explain what the dickens "normalized" and "sum" aggregation method means. Is 'Natural' grading "normalised" or "sum" ? Who knows?
Either way, scales don't seem to work with Natural grading and so the many teachers who want to use scales are excluded from using this intuitive method.

--[[User:Mark Pearson 2|Mark Pearson 2]] ([[User talk:Mark Pearson 2|talk]]) 22:55, 29 September 2015 (AWST)

I have just realised that this is the v2.9 doc page -- my comments apply to v2.8 , so it might be different in v2.9. Even so, it would be good to explain the difference between 'normalised' and 'sum' and explain where 'natural' fits in.

--[[User:Mark Pearson 2|Mark Pearson 2]] ([[User talk:Mark Pearson 2|talk]]) 22:58, 29 September 2015 (AWST)

Hi everyone,

I have a question concerning the possibility to move a scale. Where do I have to move it and why? I can only see a list of scales I created with edit and delete icons, but no arrows.
Not even the image shows arrows
Thank you for your answer, [[User:Daniela Rotelli|Daniela]]
==Response to Daniele==
Yes you are right - I can't move it either so I removed the word "move" Thanks again --[[User:Mary Cooch|Mary Cooch]] ([[User talk:Mary Cooch|talk]]) 18:56, 12 March 2019 (UTC)

Scales

2019-03-12T18:55:57Z

Marycooch: /* Editing a scale */

{{Grades}}
Scales are a way of evaluating or rating a students' performance. Administrators can create standard scales which are available across the site, and teachers can create custom scales just for their own course. (If you prefer, you can use [[Grade points|grade points]] or no grade at all.)

Scales may be used in [[Forums]], [[Glossaries]] and [[Assignments]] for rating and/or [[Grades|grading]] a student's activity.

==Creating a new scale==
New scales can be created by teachers with editing rights or by administrators or by any user with the [[Capabilities/moodle/course:managescales|manage scales role capability]].

===Creating course scales===

*Click the "Add a new scale" button in ''Course administration > Grades > Scales''.
*On the next page give your scale a name in the Name box that will identify it among other scales.
*'Standard' scale is a scale which can be applied to every course in Moodle. Only those with site permissions such as administrators can make a new scale 'standard'. A regular teacher can only create a scale for their own course.

[[Image:newscale.png|center|thumb|480px|Creating a new scale screen: Name, Scale, Description areas]]

*In the Scale box, create your scale. Each item in the scale should be separated by a comma. You can use as many options here as you require. You must order the comma separated elements in increasing order of value. '''For example, an A,B,C,D scale must be entered as D,C,B,A'''.
*Write a detailed description in the Description box to remind you (or other teachers) of how the scale is to be used.
*Save the changes.
====Single rating scale====

Only selecting one option allows you to create a "Like" scale similar to Facebook or a "Useful" scale similar to that on Moodle.org.
[[File:Like28.png|center|thumb|600px]]

===Creating a standard scale===

An administrator can create a standard scale which can be used in any course in ''Administration > Site administration > Grades > Scales''

==Using scales==
A teacher may select a scale by going to the ''Edit settings'' screen of an activity, for example an [[Assignment|assignment]],scrolling to 'Grade' and then selecting 'Scale' from the ''Type'' dropdown:

[[File:scale1.png]]

This will then open up the 'Scale' dropdown, allowing them to choose the scale they wish to use.

==Editing a scale==
If a scale has not yet been used, you will see an edit and delete icon in the edit column.[[Image:scalesedit.png|Editing a scale]]

Once a scale is used for an activity, it is no longer possible to delete it, and you can only edit the scale name and description.

==Example scales==

*''The Cool Scale'' - Not cool, Not very cool, Fairly cool, Cool, Very cool, The coolest thing ever!
**(Valued as 0/5pts, 1/5pt, 2/5pts, 3/5pts, 4/5pts, and 5/5pts respectively in '''any normalized aggregation method''')
**(Valued as 1, 2, 3, 4, 5, and 6 respectively in the '''sum aggregation method''')

*''General Introductions (The Affirmative Scale)'' - Welcome!, Glad to have you here!, Great post!
**(Valued as 0/2pts, 1/2pt, and 2/2pts respectively in any '''normalized''' aggregation method)
**(Valued as 1, 2, and 3 respectively in the '''sum''' aggregation method)

*If you would like two options in your scale (incomplete and complete) type "incomplete, complete" in the scale box.
**(Valued as 0/1pts and 1/1pt respectively in any '''normalized''' aggregation method like weighted mean, mean, simple weighted mean, etc.)
**(Valued as 1 and 2 respectively in the '''sum''' aggregation method)

*''Generic Social Forum'' (This scale only worked prior to the averaging function) - Please clarify., I don’t understand., Hmmm. Tell me more., Interesting, Very cool., Awesome!
**(Valued as 0/6pts, 1/6pt, 2/6pts, 3/6pts, 4/6pts, 5/6pts, and 6/6pts respectively in any '''normalized''' aggregation method)
**(Valued as 1, 2, 3, 4, 5, 6, and 7 respectively in the '''sum''' aggregation method)

*"Refer", pass, merit, distinction
**(Valued as 0/2pts, 1/2pt, and 2/2pts respectively in any '''normalized''' aggregation method)
**(Valued as 1, 2, and 3 respectively in the '''sum''' aggregation method)

*"Hesitant" Fail, Acceptable, Average, Excellent
**(Valued as 0/3pts, 1/3pt, 2/3pts, and 3/3pts respectively in any '''normalized''' aggregation method)
**(Valued as 1, 2, 3, and 4 respectively in the '''sum''' aggregation method)

*"Stars" ☆----, ☆☆---, ☆☆☆--, ☆☆☆☆-, ☆☆☆☆☆
**(Valued as 0/4pts, 1/4pt, 2/4pts, 3/4pts, and 4/4pts respectively in any '''normalized''' aggregation method)
**(Valued as 1, 2, 3, 4, and 5 respectively in the '''sum''' aggregation method) <br>

==Values calculated as percentage scores==
Moodle uses the last entry to determine the number of points in the scale for computing percentages. For example, if your scale is 0,5,6,7,8,9,10 then Moodle will use a 0-6 or 1-7 point scale depending on your chosen aggregation method.
*When using a '''normalized''' aggregation method, 0 will become 0/6, 5 will become 1/6, 6 will become 2/6, 7 will become 3/6, 8 will become 4/6, 9 will become 5/6, and 10 will become 6/6 for grade computation, respectively.
*When using the '''sum''' aggregation method, 0 will become 1, 5 will become 2, 6 will become 3, 7 will become 4, 8 will become 5, 9 will become 6, and 10 will become 7.

Either way, the numbers you enter for your scale are '''NOT''' calculated as entered, the system calculates the number of non-zero entries and then creates a scale from 0 to the total number of entries (n) with their values calculates as 0/n, 1/n, 2/n, 3/n....

:''TIP:'' If your scale is a custom non-value (not a number), Moodle's behavior in combining or averaging the scores into a percentage value is unpredictable. When an average or aggregate is important, then it is a good idea to stick with the standard 100% scale to compute an overall grade.

:''Tip:'' Some sites do not like the "0" (zero) in any normalized aggregation method.

==Scales capabilities==

*[[Capabilities/moodle/course:viewscales|View scales]]
*[[Capabilities/moodle/course:managescales|Manage scales]]

== See also ==
*[[Outcomes]]
*[[Ratings]]

Forum discussions:
* [http://moodle.org/mod/forum/discuss.php?d=106031 gradebook letter grade an item]
* [http://moodle.org/mod/forum/discuss.php?d=142262 Creating a new scale]
* [http://moodle.org/mod/forum/discuss.php?d=152689 Standard letter scale reversed] for information on how to delete a scale

Blog post by Matt Bury: [https://matbury.com/wordpress/2014/02/implementing-star-ratings-in-moodle/ Implementing star ratings in Moodle]

[[de:Bewertungsskalen]]
[[es:Escalas]]
[[fr:Barèmes]]
[[it:Scale]]

Building Feedback

2019-02-28T09:02:34Z

Marycooch: /* Required */

{{Feedback}}
After setting a new Feedback, you add questions by clicking the Edit questions tab and selecting the type of question from the drop down list. Add your question details and click 'Save question'.

[[Image:31feedbackquestions.png]]

== Standard options ==

The following apply to all or most question types.

=== Position ===

This number controls the order of the questions. Position 1 is the question nearest the top of the page, so when you create or edit a question, you can choose from the dropdown of available positions (which will vary depending on how many other questions there are). You can also rearrange questions by clicking the position up and down arrows on the main add questions screen.

=== Required ===

These questions are required to be answered and will prompt the user if they are left unaswered.

== Available question types ==

===Captcha===
A test to make sure a real person is filling in the form and not an automatic spamming program of some sort. Asks a person to write out some distorted text which is displayed on screen. You normally won't need this unless you find you are getting spammed a lot.

To use this question type you need to get a key from [https://www.google.com/recaptcha/ Google reCAPTCHA].

===Information===
This allows you to choose to display the course and/ or the category where the feedback is located.

=== Label ===

Like a standard Moodle label, this allows you to add abritrary text between questions allowing for extra explanation or to divide the Feedback into sections.

=== Longer Text Answer ===

This option is for creating a text box (you specify how big it will appear in rows and columns) which people can write a long answer into.

=== Multiple choice===

Selecting this then offers you three alternatives:

(1) Multiple choice single answer. This will give you a series of radio buttons, which starts on 'Not selected' and then has your options afterwards. Only one can be chosen and 'Not selected' is a valid answer if the question is not set to 'required'.

(2) Multiple choice, multiple answers

(3) Multiple choice - single answer allowed (dropdown list) This type will give you a dropdown list from which only one answer can be selected.

=== Dropdownlist (rated) ===

This is similar to the dropdownlist option, except that each option has a numerical value associated with it. This means that if asking a question like:

'''How much do you enjoy being in class?'''
* I love it
* I like it
* It's OK
* I don't like it
* I hate it
it's not possible to (easily) get out an "average" score - particularly if you're asking the same question before and after an event or course. If the Dropdownlist (rated) option is used, then numerical values are associated with each option, allowing an average or other measurements of any responses. The above question might look like:

'''How much do you enjoy being in class?'''
* [5] I love it
* [4] I like it
* [3] It's OK
* [2] I don't like it
* [1] I hate it
which might allow for an average (e.g. "4.5 this term, up from 3.9 last term") to be calculated.

=== Numeric answer ===
Here, you ask a question which must have a number as an answer and specify the acceptable range e.g. "How many arms would you like, if more than 2 were possible? (please specify 0-10)" with a range of 0-10 set in the options. It helps if you specify the acceptable range in the question text.

=== Multiple Choice (Rated) ===

This is similar to the other multiple choice options, except that each option has a numerical value associated with it. You have the choice of using radio buttons or a drop-down list to display the answers.

For example:

::'''''How much do you enjoy being in class?'''''
::*''I love it''
::*''I like it''
::*''It's OK''
::*''I don't like it''
::*''I hate it''

It's not possible to (easily) get out an "average" score - particularly if you're asking the same question before and after an event or course. If the Drop-down List (rated) option is used, then numerical values are associated with each option, allowing an average or other measurements of any responses.

The above question might look like:

::'''''How much do you enjoy being in class?'''''
::*''[5] I love it''
::*''[4] I like it''
::*''[3] Its OK''
::*''[2] I don't like it''
::*''[1] I hate it''

Which might allow for an average (e.g. "4.5 this term, up from 3.9 last term") to be calculated.

=== Short Text Answer ===

This option lets you specify a single line answer, with an input box which is a set number of characters long (you choose). You also specify the maximum number of characters you will accept, so that the answer is not too long and/or does not run over the length of the box on screen.

==Dependence item and Dependence value==
It is possible to direct the user to specific questions depending on a previous answer. For example, if they say 'Yes' to the question "Do you have a car?" they will be directed to a different question from if they answer 'No'. To set dependent questions:
*Set up your initial question and give it a name in the Label field:
[[File:dependence1.png]]
*Add a Page break
*Add the question to go to if (for example)the user replies 'Yes'.
*In 'Dependence item', select the Label of your first question.
*In 'Dependence value' type your dependent answer (such as 'Yes' in our example.)
[[File:dependence2.png]]
*Follow the same process for the other response (such as 'No')

==See also==
[[Feedback_templates|Feedback Templates]]

[[de:Feedback erstellen]]
[[es:Construyendo retroalimentación]]

Building Feedback

2019-02-28T09:01:47Z

Marycooch: removing time of response

{{Feedback}}
After setting a new Feedback, you add questions by clicking the Edit questions tab and selecting the type of question from the drop down list. Add your question details and click 'Save question'.

[[Image:31feedbackquestions.png]]

== Standard options ==

The following apply to all or most question types.

=== Position ===

This number controls the order of the questions. Position 1 is the question nearest the top of the page, so when you create or edit a question, you can choose from the dropdown of available positions (which will vary depending on how many other questions there are). You can also rearrange questions by clicking the position up and down arrows on the main add questions screen.

=== Required ===

These questions are required to be answered and will prompt the user if they are left unaswered. These questions are highlighted with a red star for users, and have a yellow exclamation point beside them when editing Feedback questions.

== Available question types ==

===Captcha===
A test to make sure a real person is filling in the form and not an automatic spamming program of some sort. Asks a person to write out some distorted text which is displayed on screen. You normally won't need this unless you find you are getting spammed a lot.

To use this question type you need to get a key from [https://www.google.com/recaptcha/ Google reCAPTCHA].

===Information===
This allows you to choose to display the course and/ or the category where the feedback is located.

=== Label ===

Like a standard Moodle label, this allows you to add abritrary text between questions allowing for extra explanation or to divide the Feedback into sections.

=== Longer Text Answer ===

This option is for creating a text box (you specify how big it will appear in rows and columns) which people can write a long answer into.

=== Multiple choice===

Selecting this then offers you three alternatives:

(1) Multiple choice single answer. This will give you a series of radio buttons, which starts on 'Not selected' and then has your options afterwards. Only one can be chosen and 'Not selected' is a valid answer if the question is not set to 'required'.

(2) Multiple choice, multiple answers

(3) Multiple choice - single answer allowed (dropdown list) This type will give you a dropdown list from which only one answer can be selected.

=== Dropdownlist (rated) ===

This is similar to the dropdownlist option, except that each option has a numerical value associated with it. This means that if asking a question like:

'''How much do you enjoy being in class?'''
* I love it
* I like it
* It's OK
* I don't like it
* I hate it
it's not possible to (easily) get out an "average" score - particularly if you're asking the same question before and after an event or course. If the Dropdownlist (rated) option is used, then numerical values are associated with each option, allowing an average or other measurements of any responses. The above question might look like:

'''How much do you enjoy being in class?'''
* [5] I love it
* [4] I like it
* [3] It's OK
* [2] I don't like it
* [1] I hate it
which might allow for an average (e.g. "4.5 this term, up from 3.9 last term") to be calculated.

=== Numeric answer ===
Here, you ask a question which must have a number as an answer and specify the acceptable range e.g. "How many arms would you like, if more than 2 were possible? (please specify 0-10)" with a range of 0-10 set in the options. It helps if you specify the acceptable range in the question text.

=== Multiple Choice (Rated) ===

This is similar to the other multiple choice options, except that each option has a numerical value associated with it. You have the choice of using radio buttons or a drop-down list to display the answers.

For example:

::'''''How much do you enjoy being in class?'''''
::*''I love it''
::*''I like it''
::*''It's OK''
::*''I don't like it''
::*''I hate it''

It's not possible to (easily) get out an "average" score - particularly if you're asking the same question before and after an event or course. If the Drop-down List (rated) option is used, then numerical values are associated with each option, allowing an average or other measurements of any responses.

The above question might look like:

::'''''How much do you enjoy being in class?'''''
::*''[5] I love it''
::*''[4] I like it''
::*''[3] Its OK''
::*''[2] I don't like it''
::*''[1] I hate it''

Which might allow for an average (e.g. "4.5 this term, up from 3.9 last term") to be calculated.

=== Short Text Answer ===

This option lets you specify a single line answer, with an input box which is a set number of characters long (you choose). You also specify the maximum number of characters you will accept, so that the answer is not too long and/or does not run over the length of the box on screen.

==Dependence item and Dependence value==
It is possible to direct the user to specific questions depending on a previous answer. For example, if they say 'Yes' to the question "Do you have a car?" they will be directed to a different question from if they answer 'No'. To set dependent questions:
*Set up your initial question and give it a name in the Label field:
[[File:dependence1.png]]
*Add a Page break
*Add the question to go to if (for example)the user replies 'Yes'.
*In 'Dependence item', select the Label of your first question.
*In 'Dependence value' type your dependent answer (such as 'Yes' in our example.)
[[File:dependence2.png]]
*Follow the same process for the other response (such as 'No')

==See also==
[[Feedback_templates|Feedback Templates]]

[[de:Feedback erstellen]]
[[es:Construyendo retroalimentación]]

Talk:Building Feedback

2019-02-28T09:00:31Z

Marycooch:

Hi everyone,

I can not find the option '' the time of responding'' as type of information nor the Dropdownlist (rated) as available question types. Maybe were they in an old version?

I have another question. According to this sentence ''These questions are required to be answered and will prompt the user if they are left unaswered. These questions are highlighted with a red star for users, and have a yellow exclamation point beside them when editing Feedback questions.'' I should not find red stars and yellow exclamation points, instead I can only see red exclamation points, red boxes and the word ''Required''. It's correct?

[[User:Daniela Rotelli|Daniela]]

==Reply==
Hi again. Yes I saw some tracker comments and I think the time of responding is no longer a visible option, and probably the "required" icons are from an old theme. I will change the docs and thankyou SO MUCH for your vigilance noticing things that need updating.

Talk:Managing blocks

2019-02-26T22:31:18Z

Marycooch:

Hi everyone,

I think this sentence is no longer valid for the release 3.5 ''The Administration block and Navigation block are already padlocked, as major difficulties arise if these blocks are deleted. Only unlock them if you are absolutely sure you understand the consequences and have alternative settings and navigation features in place.''

The two mentioned blocks are not padlocked, but when I enter their settings I can not delete them as I can with the others (except in the Boost theme but there is the navigation drawer).

In addition, even this sentence is not very useful ''(but see comments about the Administration block and Navigation block in the previous section)'' because the link ''Uninstall'' is not available for these blocks.

Thank you :) [[User:Daniela Rotelli|Daniela]]
==Reply==
Thanks - I've modified the page accordingly --[[User:Mary Cooch|Mary Cooch]] ([[User talk:Mary Cooch|talk]]) 22:31, 26 February 2019 (UTC)

Managing blocks

2019-02-26T22:30:38Z

Marycooch: /* Block deletion */

{{Blocks}}
==Manage blocks==

An administrator can manage Moodle's blocks for the site in ''Administration > Site administration > Plugins > Blocks > Manage blocks'', including any contributed blocks that have been added.

===Instances===

The blocks page lists the number of instance for each block. Clicking on a number results in the list of courses containing that block being displayed. See [[Block settings]] for configuration settings that might be of interest to a site administrator or someone with Front Page editing permissions.

===Version===

Listed with each block is its version number — in the format 2012061700. This is helpful to ensure that you have the latest version of each block.

===Hiding a block===

The hide/show column allows selected blocks to be hidden i.e. they do not appear in any course "Add a block" dropdown menu and cannot be used in any course. To hide a block, click the eye icon so that it changes to a closed eye.

To reduce the length of course "Add a block" dropdown menus, you should hide blocks which will not be used, such as mentees (unless you have added a [[Parent role|mentor role]]) and network servers (unless you are using [[MNet|Moodle Networking]]).

===Protecting blocks from deletion===

By clicking the padlock against a block in this column, you are preventing it from being deleted on the site. The [[Administration block]] and [[Navigation block]] cannot be uninstalled from the admin interface. Note that these blocks are not used if you use a [[Boost theme]] or Boost based theme.

===Block deletion===

Blocks can be deleted using the Uninstall link for the appropriate block. There is usually no reason for standard blocks to be uninstalled (they are usually hidden) However, non-standard blocks may need to be uninstalled before upgrading.

:''Note:'' To delete a block completely, in addition to uninstalling it on the blocks page, you also need to remove/delete the actual block folder from the ''moodle/blocks'' folder, otherwise Moodle will reinstall it next time you access the site administration.

===Block settings===

Certain blocks have additional settings, which can be accessed via the links in the settings column.

==Block capabilities==

*[[Capabilities/moodle/my:manageblocks|Manage dashboard blocks]]
*[[Capabilities/moodle/tag:editblocks|Edit blocks in tags pages]]
*[[Capabilities/moodle/user:manageownblocks|Manage blocks on own public user profile]]
*[[Capabilities/moodle/user:manageblocks|Manage blocks on user profile of other users]]
*[[Capabilities/moodle/block:edit|Edit a block's settings]]
*[[Capabilities/moodle/block:view|View block]]
*[[Capabilities/moodle/site:manageblocks|Manage blocks on a page]]

In addition, every block has an ''addinstance'' capability (e.g. [[Capabilities/block/comments:addinstance|block/comments:addinstance]]) and most blocks also 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 to a page or to their [[Dashboard]] respectively.

==Contributed blocks==

In addition to using the blocks included in the standard download, other Moodlers have developed their own blocks which they share with the Moodle community. You can download these contributed blocks from the Moodle.org [http://moodle.org/plugins Moodle Plugins directory]. See [[Installing plugins]] for details of how to install a block.

==See also==
*[[Block layout]]

[[Category:Site administration]]

[[de:Administration_von_Bl%C3%B6cken]]
[[es:Gestionando bloques]]
[[eu:Blokeak_%28Kudeatzailea%29]]
[[fr:Gestion des blocs]]
[[it:Gestire i blocchi]]
[[ja:ブロック管理 (管理者)]]

Managing blocks

2019-02-26T22:30:14Z

Marycooch: updating

{{Blocks}}
==Manage blocks==

An administrator can manage Moodle's blocks for the site in ''Administration > Site administration > Plugins > Blocks > Manage blocks'', including any contributed blocks that have been added.

===Instances===

The blocks page lists the number of instance for each block. Clicking on a number results in the list of courses containing that block being displayed. See [[Block settings]] for configuration settings that might be of interest to a site administrator or someone with Front Page editing permissions.

===Version===

Listed with each block is its version number — in the format 2012061700. This is helpful to ensure that you have the latest version of each block.

===Hiding a block===

The hide/show column allows selected blocks to be hidden i.e. they do not appear in any course "Add a block" dropdown menu and cannot be used in any course. To hide a block, click the eye icon so that it changes to a closed eye.

To reduce the length of course "Add a block" dropdown menus, you should hide blocks which will not be used, such as mentees (unless you have added a [[Parent role|mentor role]]) and network servers (unless you are using [[MNet|Moodle Networking]]).

===Protecting blocks from deletion===

By clicking the padlock against a block in this column, you are preventing it from being deleted on the site. The [[Administration block]] and [[Navigation block]] cannot be uninstalled from the admin interface. Note that these blocks are not used if you use a [[Boost theme]] or Boost based theme.

===Block deletion===

Blocks can be deleted using the Uninstall link for the appropriate block (but see comments about the [[Administration block]] and [[Navigation block]] in the previous section) There is usually no reason for standard blocks to be uninstalled (they are usually hidden) However, non-standard blocks may need to be uninstalled before upgrading.

:''Note:'' To delete a block completely, in addition to uninstalling it on the blocks page, you also need to remove/delete the actual block folder from the ''moodle/blocks'' folder, otherwise Moodle will reinstall it next time you access the site administration.

===Block settings===

Certain blocks have additional settings, which can be accessed via the links in the settings column.

==Block capabilities==

*[[Capabilities/moodle/my:manageblocks|Manage dashboard blocks]]
*[[Capabilities/moodle/tag:editblocks|Edit blocks in tags pages]]
*[[Capabilities/moodle/user:manageownblocks|Manage blocks on own public user profile]]
*[[Capabilities/moodle/user:manageblocks|Manage blocks on user profile of other users]]
*[[Capabilities/moodle/block:edit|Edit a block's settings]]
*[[Capabilities/moodle/block:view|View block]]
*[[Capabilities/moodle/site:manageblocks|Manage blocks on a page]]

In addition, every block has an ''addinstance'' capability (e.g. [[Capabilities/block/comments:addinstance|block/comments:addinstance]]) and most blocks also 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 to a page or to their [[Dashboard]] respectively.

==Contributed blocks==

In addition to using the blocks included in the standard download, other Moodlers have developed their own blocks which they share with the Moodle community. You can download these contributed blocks from the Moodle.org [http://moodle.org/plugins Moodle Plugins directory]. See [[Installing plugins]] for details of how to install a block.

==See also==
*[[Block layout]]

[[Category:Site administration]]

[[de:Administration_von_Bl%C3%B6cken]]
[[es:Gestionando bloques]]
[[eu:Blokeak_%28Kudeatzailea%29]]
[[fr:Gestion des blocs]]
[[it:Gestire i blocchi]]
[[ja:ブロック管理 (管理者)]]

Talk:Managing activities

2019-02-15T19:08:30Z

Marycooch: reply to Daniella

Hi all,

I'm translating this page and I wonder if this sentence is still available ''The Feedback module (which will eventually be replaced by a newer survey module) is hidden by default.'' because in the image the Feedback module is not hidden and in my version of Moodle too.

Thank you
[[User:Daniela Rotelli|Daniela]]

==Reply==
Thanks for the heads-up! I have removed the sentence from the 3.5 and 3.6 documentation
--[[User:Mary Cooch|Mary Cooch]] ([[User talk:Mary Cooch|talk]]) 19:08, 15 February 2019 (UTC)

Managing activities

2019-02-15T19:05:53Z

Marycooch: removing out of date sentence

{{Activities}}
==Manage activities==

From ''Administration > Site administration > Plugins > Activity modules > Manage activities'', the administrator can view a list of activities and manage their settings.[[Image:activity modules admin.png|thumb|Manage activities]]

===Number of activities===

The activities column lists how many activities for each module there are on your Moodle site. If you click on a number, the list of courses containing that activity will be displayed.

===Version===
The numbers against the modules tell you the version (or age) of the module. It is useful to know how up to date each module is and, particularly with contributed modules, it is important to ensure you have the most up to date version that matches your version of Moodle. The first four digits relate to the year of the module.

===Hiding a module===
The hide/show column allows selected modules to be hidden i.e. they do not appear in any course "Add an activity" dropdown menu and cannot be used in any course. To hide a module, click the eye icon so that it changes to a closed eye.

===Module deletion===

Apart from the [[Forum activity]], any module can be deleted using the link in the delete column. There is no reason for standard modules to be deleted, however contributed modules may need to be deleted before upgrading.

Note: To delete a module completely, in addition to deleting it on the manage activities page, you also need to remove/delete the actual module folder from the ''moodle/mod'' folder, otherwise Moodle will reinstall it next time you access the site administration.

===Settings===

Many of the modules have additional settings, mostly enabling default values to be set, which can be accessed via the links in the settings column.

==Common activity settings==

From ''Administration > Site administration > Plugins > Activity modules > Common activity settings'', the administrator can decide whether or not to force teachers to add a description to the activity or resource they are creating. The setting applies to all standard activities and resources on the site.

==Reducing the number of activities listed in the activity chooser==

By default, managers and teachers can add any activity module enabled on the site to a course. However, the list of activities in the activity chooser (or 'Add an activity' dropdown menu) may be reduced in number by preventing the capability to add instances of particular activity modules hiding the modules you wan't to display in ''Manage activities''.

==Managing activities in several languages==
The [https://moodle.org/plugins/availability_language restriction by language ] availability condition additional plugin makes it easy to show an English resource only to English users and an activity in French only to French speaking students. See [https://moodle.org/mod/forum/discuss.php?d=345816 this forum thread] for an example.

[[Category:Site administration]]

[[de:Aktivitäten verwalten]]
[[es:Gestionando actividades]]
[[eu:Moduluak_(Kudeatzailea)]]
[[fr:Modules (administrateur)]]
[[it:Gestire le attività]]
[[ja:モジュール管理 (管理者)]]

mod/customcert/mod

2019-02-13T09:40:05Z

Marycooch: Redirected page to Custom certificate module

#REDIRECT [[Custom certificate module]]
[[es:mod/customcert/mod]]

Server files repository

2019-01-29T12:06:30Z

Marycooch: updated screenshots

{{Repositories}}
==What are server files?==
The server files repository enables teachers and managers to access files used within a course and elsewhere on the site which they have permission to access.

Activity modules for which files are available in the server files repository are:

* [[File|File resource]]
* [[Folder|Folder resource]]
* [[Database activity module|Database]]
* [[Forum module|Forum]]
* [[Glossary module|Glossary]]
* [[Lesson module|Lesson]]

{|
| [[File:serverfilescategories.png|thumb|Whole site category view]]
| [[File:serverfilescourseview.png|thumb|Course view]]
| [[File:serverfilescoursesections.png|thumb|Course section view]]
|}

A search box at the top of the Server files screen allows those users with relevant permissions elsewhere on the site to search other courses for a required file. A teacher who teaches several courses for example can now quickly locate a document used in one of her older courses by typing its name into the Search field:

[[File:searchserverfiles.png]]

When a file from the server files repository is re-used elsewhere on Moodle, the teacher has the option to make a copy (a new, unconnected version) or to create a shortcut or alias. See [[Working with files]] for more details.

==Repository capabilities==

The capability [[Capabilities/repository/local:view|View server repository]], which is allowed for the default roles of manager, course creator, teacher and non-editing teacher, ensures that the server files repository is listed in the file picker. This capability should be allowed together with the [[Capabilities/moodle/course:managefiles|manage files capability]] to enable users to access files used within a course.

[[de:Dateien in Kursen]]
[[fr:Fichiers serveur]]
[[es:Repositorio archivos del servidor]]

File:searchserverfiles.png

2019-01-29T12:05:58Z

Marycooch:

File:serverfilescategories.png

2019-01-29T12:05:48Z

Marycooch:

File:serverfilescoursesections.png

2019-01-29T12:05:39Z

Marycooch:

File:serverfilescourseview.png

2019-01-29T12:05:30Z

Marycooch:

Talk:Course categories

2018-12-27T11:41:56Z

Marycooch:

Hi all,

I'm not sure about this content: ''The list of courses within a category by default shows the teachers and the summary of each course. If the number of courses within a category exceeds 9 (10 or more), then a short list without teachers and summary is shown''.
I can not see any summary, but only the name of the course and the teacher even if I change the 'Viewing'.

Thank you, [[User:Daniela Rotelli|Daniela]]

Correction: I found what you mean in the home page. Maybe it can be said. [[User:Daniela Rotelli|Daniela]]

Thanks for clarifying :)--[[User:Mary Cooch|Mary Cooch]] ([[User talk:Mary Cooch|talk]]) 11:41, 27 December 2018 (UTC)

Talk:Using Forum

2018-12-11T09:32:58Z

Marycooch: reverting and replying

Ls.

Nothing there about subscribtion and its screens which I do not understand at all.

Bert

Hello Bert. Apologies for the late reply - I have added some information about forum subscriptions to the page now.--[[User:Mary Cooch|Mary Cooch]] ([[User talk:Mary Cooch|talk]]) 09:32, 11 December 2018 (UTC)

Talk:Using Forum

2018-12-11T09:32:14Z

Marycooch: Reverted edits by Marycooch (talk) to last revision by Behoof

Ls.

Nothing there about subscribtion and its screens which I do not understand at all.

Bert

Using Forum

2018-12-11T09:32:03Z

Marycooch: note on subscribing

{{Forum}}
==For all users==
===Permalinks===

A permalink allows you to link directly to a specific forum post so you can share it easily with others. You will see the permalink option when clicking to reply to a post. If you click the permalink ''(1)'', it is highlighted to the side ''(2)'' and you will have a particular web address ''(3)'' which you can then copy and paste to use elsewhere:

[[File:permalinkexample.png|thumb|center|600px|Linking directly to a single post]]

===Forum preferences===
Users can set their forum preferences via Preferences in the user menu top right. (Defaults for each of these settings can be set by an administrator in ''Administration / Site administration / Accounts / User default preferences''.)

===Subscribing to forum discussions===
Users can subscribe to forum discussions in a number of ways, in order to receive notification about new posts.
# From the Preferences link in the user menu they can choose to be automatically subscribed to forum discussions when they post
# They can click on the open envelope icon next to a forum discussion. (It will then change to a closed envelope.)
#They can click into the forum and click the cog icon top right and subscribe to the whole forum.

===Track read and unread forum posts===
*Access the Preferences page from the user menu and select 'Forum preferences'.
* For 'Forum tracking', choose ''Yes: highlight new posts for me'' and if the forum administrator has set the 'Read tracking for this forum?' to On or Optional then unread posts will be highlighted for you:
{|
|[[File:forumtracking1.png|thumb|296px|left|Unread posts alert]]
|}

The posts will be highlighted in the following places:

* Course page
* Within the forum itself
* In forum discussion threads
{|
|[[File:forumtracking2.png|thumb|500px|left|Click to mark as read]]
|}

Only posts made in the last two weeks are tracked as read or unread. Older posts are all reported as read.

Note: You can also choose to have any forum post notifications automatically marked as read (so they don't appear in the Unread list.) Some people find this confusing and prefer to keep them as unread:

{|
|[[File:forumnotificationsread.png|thumb|left|600px|Forum post notification options]]
|}
===Display options===
[[Image:forumviewoptions.jpg|thumb|Reply display options]]A discussion thread may be displayed in four ways. Use the pull down menu at the top of each forum discussion to select a display type.

* Display replies flat, with oldest first
* Display replies flat, with newest first - The discussion will be displayed in one line and the chronological order from the newest to the oldest. This is the same as the above, just a different sort order.
* Display replies in threaded form - Only the post starting the discussion will be displayed in its full form; replies will be reduced to the headlines (including information about its author and date of release) and organised chronologically; moreover, replies will be shifted towards the right so that only replies to the same post were in the same line.
* Display replies in nested form - All posts are displayed in their full forms; replies will be reduced to the headlines (including information about its author and date of release) and organised chronologically; moreover, replies will be shifted towards the right so that only replies to the same post were in the same line.

{|
| [[Image:Forum Flat form mu.png|thumb|Flat Forum discussion, example from middle]]
| [[Image:Forum threaded form mu.png|thumb|Posts in threaded form]]
| [[Image:Forum nested form mu.png|thumb|"Nested reply example"]]
|}

===Forum posting===

The default content of '''Subject''' is usually 'Re: <the name of the 'parent' post>'. You can change it though.

==== Adding images, sound and video ====

*When an image is "attached" as a file to a forum message, it is immediately displayed full size after the message (i.e. no need to click on an attachment). This an excellent way of sharing images without having to go through the process of uploading them as files and linking them from within web pages.
*Images may be dragged and dropped into the box as well as uploading via the "add" link and the [[File picker]].
*If multimedia filters are enabled, a sound file (mp3) or accepted video file can be attached and it will be embedded into the forum post in an appropriate player.

====Tags====

Forum posts may be tagged.

Tags can be managed by a site administrator in [[Managing tags|Manage tags]] in the Site administration. Forum post tags may be added to a specified tag collection and standard tags may be suggested or forced. If desired, forum post tagging may be disabled completely.

====Post editing time limit====
Once a post has been made, students can go back and edit it within set time limit. This is usually 30 minutes and is set by an administrator in [[Site policies]] in the Site administration. Note that teachers can always edit their posts.

====Moving between forum threads====

Links top and bottom left and right (where applicable) take you to the previous and next forum discussion in a list:

[[File:navigateforums1.png|thumbnail|center|500px]]

===Post a copy to all groups===

Teachers and other users with the [[Capabilities/mod/forum:canposttomygroups|capability to post in all groups they have access to]] can post the same message once only to all groups by selecting 'All participants' and clicking the Add a new discussion topic button:

[[File:forumdiscussiongroup1.png]]

Once they have typed the post, they tick the box 'Post a copy to all groups':

[[File:forumdiscussiongroup2.png]]

When saved, the post will be reproduced for each group:

[[File:forumdiscussiongroup3.png]]

===Reply to posts via email===

If enabled by an administrator (in [[Mail configuration]]), you can reply to forum posts via email.

# Click the Reply by email link in the email. You will see a special unique email address to send your reply to.
# Reply using the email address provided. '''IMPORTANT: Make sure you remove the original email content so that your forum post does not contain the quoted text.'''
# You should receive an email saying your reply has been successfully posted.
# Your post now appears in the forum.

{|
| [[File:forumemailreplylatest.png|thumb|400px|(1) Click to reply by email]]
| [[File:specialemailaddress.png|thumb| 300px|(1a) Note the special email address to reply to]]
| [[File:forumemailreply2.png|thumb|400px|(2) Type and send your reply]]
|}

{|
| [[File:forumemailreply3.png|thumb|400px|(3) The success message]]
| [[File:forumemailreply4.png|thumb|400px| (4) Your reply is posted to the forum]]
|}

[[File:navigateforums1.png|thumbnail|center|500px]]

===Exporting forum posts===
Users with the ''mod/forum:exportdiscussion'' or ''mod/forum:exportownpost'' or ''mod/forum:exportpost'' permission can export forum posts to any portfolio the administrator has enabled:

[[File:Exportforum.png]]

See the discussion [https://moodle.org/mod/forum/discuss.php?d=320382 Printing/exporting forum discussions] for further details.

==For teachers==

===Pinned posts===

When adding a new discussion as a teacher, you can make it 'sticky' by ticking the box to 'pin' the discussion to the top of the list. Any forum discussions which come after that will appear underneath this pinned post. If you later untick the box to 'unpin' it, it will display as a regular forum discussion, moving down the list when others are posted.

[[File:pinnedpostexample.png]]

==='Send forum post notifications with no editing time delay'===

Teachers (and others with the [[Capabilities/moodle/course:manageactivities|capability to manage course activities]]) will see this option when posting to a forum. Ticking this box will send a notification to everyone subscribed to that forum with no editing time delay. (Users normally have 30 minutes to edit their posts.)

Note: For users who have enabled email digests in their forum preferences, the notification is NOT sent separately from other forum post notifications.

=== Display period ===

Teachers (and others with the capability [[Capabilities/mod/forum:viewhiddentimedposts|mod/forum:viewhiddentimedposts]]) can set a display period of a date and time for the forum post to appear.

[[File:timedposts.png]]

Note: Timed forum posts was included in previous versions of Moodle as an experimental feature. In Moodle 3.1 onwards it is enabled by default for new installations. For sites upgrading from a previous version, it may be enabled via ''Site administration > Plugins > Activity modules > Forum''.

===Locking a discussion===

Forum threads may be automatically locked after a certain period of inactivity. This is done from the setting 'Discussion locking' when creating or editing a new forum.

[[File:discussionlocking.png|center|thumb|600px|Locked discussion alert when viewing a forum.]]

*A period from a day to a year may be selected. The default is for discussions not to be locked.
*Watch the screencast [https://youtu.be/M9ZxCq50hiQ Discussion locking] to see a demonstration.
*Teachers and other users with the [[Capabilities/mod/forum:canoverridediscussionlock|capability to override locked discussions]] can unlock discussions simply by posting a reply.

===Moving a discussion===

Teachers and other users with the [[Capabilities/mod/forum:movediscussions|capability to move discussions]] can move a discussion to any other forum in the course for which they have appropriate rights.
# Click on the arrow in the 'Move this discussion to...' dropdown menu in the top right corner of the page and select a destination forum.
# Click the Move button.

Note: Moving a forum post will display incorrect results in the [[Participation_report|course participation report]] for the affected forums. For example, take a student who posted in forum A and had their post moved to forum B. In the course participation report the student will still be listed has having made a post in forum A, but will not be listed as having made a post yet in forum B.

Note: Discussion subscriptions are retained when a post is moved.

===Splitting a discussion===

Teachers and other users with the [[Capabilities/mod/forum:splitdiscussions|capability to split discussions]] can split a discussion thread. Splitting a discussion means that beginning with the post selected and going to the end of that sub-thread, the posts are cut from the current discussion topic and put into a newly created discussion topic. If discussion has strayed away from the original topic, splitting the discussion can provide new attention and space for the tangent discussion while keeping the original discussion on topic.

# Click the link 'Split' in the forum post
# Enter a new discussion name (optional)
# Click the Split button

Note: Discussion subscriptions are NOT retained when a post is split.

===Using groups with forums===
'Group mode' available from the Common module settings has three options. (Note that you must have groups in your course to use this feature.)

If the group mode is set to separate groups:

* Teachers are given the option of adding a new discussion topic for all participants or for a selected group. If a teacher adds a new discussion topic for a selected group, then only group members can reply to it.
* Students can only start discussions for their own group.
* Students can only reply to discussions started by other group members or discussions for their own group started by a teacher.

If the group mode is set to visible groups:

* Teachers are given the option of adding a new discussion topic for all participants or for a selected group. If a teacher adds a new discussion topic for a selected group, then only group members can reply to it.
* Students can only start discussions for their own group.
* Students can only reply to discussions started by other group members or teachers.

Teachers, and other users with the capability [[Capabilities/moodle/site:accessallgroups|moodle/site:accessallgroups]] set to allow, can view and post in all forum discussions, regardless of the group mode setting.

Where visible groups are used, the user's own groups will be shown first in the list, followed by other groups:

[[File:mygroupsfirst.png]]

Note: Single simple discussions cannot be set to separate groups (as this feature is not implemented). Instead, a standard forum should be used. If required, a permissions override may be set to prevent students from starting new discussions.
For teachers who have access to all or several groups in a forum, this setting allows them post the same message once only to all groups.

Where teacher have access to several groups, they can post the same message once only to all the groups they have access to by selecting 'All participants' and clicking the Add a new discussion topic button:

[[File:forumdiscussiongroup1.png]]

Once they have typed the post, they tick the box 'Post a copy to all groups':

[[File:forumdiscussiongroup2.png]]

When saved, the post will be reproduced for each group:

[[File:forumdiscussiongroup3.png]]

===Ideas for using forums===

Ask yourself

# you wish to have involvement in the forum or if you want the students to lead and own the space
# you want the forum to add value to the face to face environment or have a life of its own in its own right outside the lecture theatre/classroom or seminar room
# you are prepared to make appropriate contributions to the discussion in order to:
## encourage discussion if students are quiet
## help shape ideas if students begin to wander off-task
## your role will be defined as discussions/a course progresses
## you will explicitly but gradually relinquish control of the discussions
## you will encourage and support learners to share control of discussions(for example you might ask a learner/group of learners to summarise contributions to a discussion thread/topic or you might ask learners to initiate discussion topics)

[[de: Forum nutzen]]
[[fr:Afficher un forum]]
[[ja:フォーラムの閲覧]]
[[es:Usando Foro]]

Talk:Using Forum

2018-12-05T11:58:55Z

Marycooch: Blanked the page

Talk:Security

2018-12-02T05:44:57Z

Marycooch:

Hi everyone,
could you please add the italian link [[it:Sicurezza]]? I think also that the link [[Notifications]] should be [[Site notifications]]. Many thanks, [[User:Daniela Rotelli|Daniela]]

Done -thanks - --[[User:Mary Cooch|Mary Cooch]] ([[User talk:Mary Cooch|talk]]) 05:44, 2 December 2018 (UTC)

Security

2018-12-02T05:44:13Z

Marycooch:

{{Managing a Moodle site}}
*[[Security recommendations]] - Advice on how best to keep your site secure
*[[Security overview report]] - Checks for all kinds of potential security problems that you might have in your configuration
*[[Site security settings]] -Settings affecting the security and privacy of your site
*[[Site notifications]] - Information about update and login failure notifications
*[[Password salting]] - Details of the way of making passwords more secure by adding a random string of characters to passwords before their hash is calculated
*[[Increasing privacy in Moodle]] - Suggestions for settings changes to increase privacy of users
*[[Reducing spam in Moodle]] - Advice on how to minimize the risk of spam on your site

==See also==

*[[Security FAQ]]
*[https://moodle.org/security/ Security news on moodle.org]
*[[:dev:Moodle security procedures|Moodle security procedures]] in the dev docs which includes info on how to report a security issue

[[Category:Security]]

[[de:Sicherheit]]
[[es:Seguridad]]
[[it:Sicurezza]]

Security

2018-12-02T05:43:32Z

Marycooch: Italian link

{{Managing a Moodle site}}
*[[Security recommendations]] - Advice on how best to keep your site secure
*[[Security overview report]] - Checks for all kinds of potential security problems that you might have in your configuration
*[[Site security settings]] -Settings affecting the security and privacy of your site
*[[Notifications]] - Information about update and login failure notifications
*[[Password salting]] - Details of the way of making passwords more secure by adding a random string of characters to passwords before their hash is calculated
*[[Increasing privacy in Moodle]] - Suggestions for settings changes to increase privacy of users
*[[Reducing spam in Moodle]] - Advice on how to minimize the risk of spam on your site

==See also==

*[[Security FAQ]]
*[https://moodle.org/security/ Security news on moodle.org]
*[[:dev:Moodle security procedures|Moodle security procedures]] in the dev docs which includes info on how to report a security issue

[[Category:Security]]

[[de:Sicherheit]]
[[es:Seguridad]]
[[it:Sicurezza]]

Talk:Tracking progress

2018-11-28T17:04:44Z

Marycooch:

Hi,
I think that the path Course administration > Grades is not correct. It should be Course administration > Gradebook setup.
[[User:Daniela Rotelli|Daniela]]

Thanks - I have changed it. Feel free to edit the English version pages yourself where you are able :) --[[User:Mary Cooch|Mary Cooch]] ([[User talk:Mary Cooch|talk]]) 17:04, 28 November 2018 (UTC)

Tracking progress

2018-11-28T17:03:39Z

Marycooch: /* Grades */

{{Managing a Moodle course}}

There are several ways to track student progress in Moodle. This page outlines what is available to teachers in a course.
==Grades==
Every course has its own [[Gradebook]] which is accessible from ''Course administration > Gradebook setup.'' Some activities such as [[Assignment]] and [[Quiz]] send grades back to this gradebook. It is also possible for teachers to enter grades directly into the gradebook.
[[File:gradebook3.jpg||thumb|frame|[https://youtu.be/r61N7sFT2ZUGradebook screencast]]]

==Competencies==

[[Competencies]] describe the level of understanding or proficiency of a learner in certain subject-related skills. Competency-based education (CBE), also known as Competency-based learning or Skills-based learning, refers to systems of assessment and grading where students demonstrate these competencies.

==Activity completion==
If [[Activity completion]] is enabled by the administrator and in the course settings, teachers can indicate for each course item how they wish it to be registered as complete. A tick/checkmark will then appear against the activity. Students may either mark it complete manually or the item will automatically be registered as complete once a student has met the specified criteria. These may be viewing a resource, submitting an assignment, posting in a forum or other conditions. The teacher can see an overview of who has completed what in the activity completion report in ''Course administration > Reports > Activity completion.''

{|
|[[File:studentviewactivitycompletion.png|300px|thumb|Student view]]
|[[File:activitycompletionreport.png|thumb|300px|Teacher view]]
|}

==Course completion==
As an extension of activity completion, enabling [[Course completion]] allows for a course to be officially marked as finished, either manually or automatically according to speficied criteria. If the [[Course completion status block]] is added, students can see their progress during the course. Teachers can view the overall progress of students towards course completion from ''Course administration>Reports>Course completion.''

{|
|[[File:studentviewcoursecompletionreport.png|thumb|300px|Student view]]
|[[File:coursecompletionreport.png|thumb|300px|Teacher view]]
|}

==Badges==
[[Badges]] can be awarded either manually or using [[Activity completion|activity completion]] settings in a course and are a popular way to motivate students. Students may be awarded badges at different stages of the course for different levels of progress.

==Course reports==
A number of [[Course reports]] are available to the teacher in their course to help them track the progress of their students. In addition to the activity and course completion reports mentioned above (which are only available if these settings are enabled) there are also [[Activity report|activity reports]], [[Participation report|participation reports]] and general course [[Logs|logs]].

==Analytics==

The [[Analytics]] feature, in Moodle 3.4 onwards, provides detailed descriptive and prescriptive reports to support learners at risk.

[[de:Lernfortschritt]]
[[es:Monitoreo del progreso]]
[[fr:Suivi du progrès]]
[[it:Tracciare lo stato di avanzamento]]

User profiles

2018-11-28T12:37:29Z

Marycooch: updated re clearer data links in profile

{{Site appearance}}
Every user in Moodle has a Profile page which may be reached from the user menu top right and then clicking Profile. This page contains links to further pages allowing the user to [[Edit profile |edit their profile information]] and preferences, view their forum/blog posts, and check any reports they have access to.
{{New features}}
'''Note:''' From Moodle 3.5.3 onwards, the new Privacy and policies section provides clear links for contacting the Privacy officer, requesting data export and account deletion, along with a new data retention summary page (unless disabled by the administrator).

[[File:36NewProfilePage.png|thumb|center|600px|Example of a user's Profile page. Click to view full size.]]

If mobile access is enabled, a link to download the [[Moodle Mobile app]] is visible on the profile. (See screenshot above.)

==Viewing others's profiles==

Users with permission to view the profiles of other users can view them by clicking on their name. If they click on the name of a user within a course, the course profile will be displayed and the full profile may be viewed (if allowed) by clicking the link "Full profile" in the Miscellaneous section:

[[File:fullprofilelink.png]]

Note: All users are allowed to view the full profile of users listed as course contacts in the course description.

See [[View profile]] for more information on how the profile information is displayed and [[Edit profile]] for information on updating profiles.

==Site administration settings==

===Site policies===

An administrator can force users to login for profiles and select which roles are visible in user profiles (by default teacher, non-editing teacher and student) in ''Administration > Site administration > Security > Site policies''.

===Default profile page===

An administrator or manager (or any other user with the capability [[Capabilities/moodle/user:managesyspages|moodle/user:managesyspages]]) can set which blocks appear on the default profile page for all users from ''Administration > Site administration > Appearance > Default profile page''.

Clicking the button 'Reset profile for all users' will then apply these settings to the profile pages of everyone on the site.

==Preventing users from customizing their profile page==

By default, users can customize their public profile page and add blocks. To prevent this

# Go to ''Administration > Site administration > Users > Permissions > Define roles''
# Edit the authenticated user role and untick the capability [[Capabilities/moodle/user:manageownblocks|moodle/user:manageownblocks]]

==User profile capabilities==

System:
*[[Capabilities/moodle/user:editownprofile|Edit own user profile]]
*[[Capabilities/moodle/user:manageownblocks|Manage blocks on own public user profile]]
*[[Capabilities/moodle/user:managesyspages|Configure default page layout for public user profiles]]
*[[Capabilities/moodle/user:update|Update user profiles]]

Users:
*[[Capabilities/moodle/user:editprofile|Edit user profile]]
*[[Capabilities/moodle/user:manageblocks|Manage blocks on user profile of other users]]
*[[Capabilities/moodle/user:viewalldetails|View user full information]]

Course:
*[[Capabilities/moodle/user:viewdetails|View user profiles]]

==See also==

*[[View profile]]
*[[Activity report]]
*[[User profile fields]]
*[[Site policies]]
*[[Update profile]]

[[de:Nutzerprofil]]
[[es:Perfiles de usuario]]

File:36NewProfilePage.png

2018-11-28T12:36:33Z

Marycooch:

Talk:Managing a Moodle course

2018-11-26T17:37:31Z

Marycooch:

Hi,
I've changed the [http://youtu.be/iOyLq0B-rz0 old link] to the screencast ''What is a course'' replacing it with the new one for Moodle 3.5.
[[User:Daniela Rotelli|Daniela]]
Thanks - that is so helpful--[[User:Mary Cooch|Mary Cooch]] ([[User talk:Mary Cooch|talk]]) 17:37, 26 November 2018 (UTC)

Talk:New features

2018-11-24T16:24:40Z

Marycooch:

Hi,
Can you please change [[es:Nuevas características de Moodle 3.4]] to [[es:Nuevas características de Moodle 3.5]] for this 3.5 version page ?

And I guess the French link also,

Thanks in advance. :) [[User:German Valero|German Valero]] ([[User talk:German Valero|talk]])

Hi,
could you please add the italian version too?
[[it:Nuove funzionalità in Moodle 3.5]]

thank you :)
[[User:Daniela Rotelli|Daniela]]

Done :) --[[User:Mary Cooch|Mary Cooch]] ([[User talk:Mary Cooch|talk]]) 16:24, 24 November 2018 (UTC)

New features

2018-11-24T16:24:12Z

Marycooch: new Italian page

{{About Moodle}}
Moodle 3.5 focuses on GDPR compliance and enhanced usability and accessiblity.

Read on for Moodle 3.5 highlights, or watch our [https://www.youtube.com/playlist?list=PLxcO_MFWQBDcnwHQwhHZtObHNMHoONx-C Youtube playlist of 3.5 New features.]

Full details of the release with technical information can be found in the [[:dev:Moodle 3.5 release notes|Moodle 3.5 release notes]].
__NOTOC__

===For all users===
<div class="contentblock">
<div class="row-fluid">
<ul class="thumbnails">
<li class="span6">
<div class="thumbnail">
[[File:StudentProfile.png|600px]]
<div class="caption">
<h4>Privacy and policies area in Profile</h4>
<p>Access site policies and make data requests from links in your [[Profile]].</p>
</div>
</div>
</li>
<li class="span6">
<div class="thumbnail">
[[File:DashboardOverview.jpg|600px]]
<div class="caption">
<h4>Course images on the dashboard</h4>
<p>Images or coloured patterns brighten up course descriptions on the dashboard [[Course overview]].</p>
</div>
</div>
</li>
</ul>
</div>
<div class="contentblock">
<div class="row-fluid">
<ul class="thumbnails">
<li class="span6">
<div class="thumbnail">
[[File:Bootstrap4.jpg|600px]]
<div class="caption">
<h4>Clearer icons, accessible fonts</h4>
<p>The use of Bootstrap 4 stable means enhanced appearance for users and better theming options for developers.</p>
</div>
</div>
</li>
<li class="span6">
<div class="thumbnail">
[[File:recordrtc.png|600px]]
<div class="caption">
<h4>Directly record sound and video</h4>
<p>Buttons in the [[Atto editor]] allow you to record directly into Moodle</p>

</div>
</div>
</li>
</ul>
</div>
<div class="contentblock">
<div class="row-fluid">
<ul class="thumbnails">
<li class="span6">
<div class="thumbnail">
[[File:ChoiceDisplay.jpg|600px]]
<div class="caption">
<h4>Choice results display</h4>
<p>Know in advance how the Choice results will display</p>
</div>
</div>
</li>
<li class="span6">
<div class="thumbnail">
[[File:35MobileApp1.png|600px]]
<div class="caption">
<h4>Moodle from your Mobile!</h4>
<p>A new improved [[Moodle Mobile app|Moodle app]].</p>

</div>
</div>
</li>
</ul>
</div>

===For teachers===

<div class="row-fluid">
<ul class="thumbnails">
<li class="span6">
<div class="thumbnail">
[[File:BulkEditSelfEnrolled.jpg|600px]]
<div class="caption">
<h4>More efficient user management</h4>
<p>Search, filter and bulk edit or delete self enrolled learners from the [[Participants|Participants and Enrolments screen]].</p>
</div>
</div>
</li>
<li class="span6">
<div class="thumbnail">
[[File:AwardedBadgesBadges.jpg|600px]]
<div class="caption">
<h4>Award badges based on other badges</h4>
<p>Amongst new [[Using badges|badges]] criteria is the ability to award badges based on previously earned badges.</p>
</div>
</div>
</li>
</ul>
</div>
<div class="row-fluid">
<ul class="thumbnails">
<li class="span6">
<div class="thumbnail">
[[File: QuestionTags.jpg|600px]]
<div class="caption">
<h4>Filter questions by tag</h4>
<p>This Moodle Users Association funded project means tags may be added and filtered directly in the [[Question bank]] and when [[Building Quiz|adding random questions]].</p>
</div>
</div>
</li>
<li class="span6">
<div class="thumbnail">
[[File:EssayUpload.png|600px]]
<div class="caption">
<h4>Quiz Essay questions</h4>
<p>Specify accepted file types for the Quiz [[Essay question type]] and upload files when grading them</p>
</div>
</div>
</li>
</ul>
</div>

===For administrators===

<div class="row-fluid">
<ul class="thumbnails">
<li class="span6">
<div class="thumbnail">
[[File:GDPRSection.png|600px]]
<div class="caption">
<h4>GDPR features</h4>
<p>New Privacy and policies links help meet [[GDPR]] requirements.</p>
</div>
</div>
</li>
<li class="span6">
<div class="thumbnail">
[[File:SimpleSearch.jpg|600px]]
<div class="caption">
<h4> Simple Global Search</h4>
<p>A new, simple [[Global search]] feature is available without the need to install an external engine.</p>
</div>
</div>
</li>
</ul>
</div>
<div class="row-fluid">
<ul class="thumbnails">
<li class="span6">
<div class="thumbnail">
[[File:LTIAdvantage.png|600px]]
<div class="caption">
<h4>LTI Advantage 1.1 support</h4>
<p>[[External tool]] settings now include support for LTI Membership and AGS services..</p>
</div>
</div>
</li>
<li class="span6">
<div class="thumbnail">
[[File:ProfilePictureBadge.jpg|600px]]
<div class="caption">
<h4>More badge criteria</h4>
<p>[[Managing badges|Award badges]] for user picture upload, cohort membership and previously awarded badges.</p>
</div>
</div>
</li>
</ul>
</div>
<div class="row-fluid">
<ul class="thumbnails">
<li class="span6">
<div class="thumbnail">
[[File:CohortThemes.jpg|600px]]
<div class="caption">
<h4>Cohort themes</h4>
<p>Specify a theme for a [[Cohort sync|cohort]] for easy differentiation.</p>
</div>
</div>
</li>
<li class="span6">
<div class="thumbnail">
[[File:35NewCapabilities.png|600px]]
<div class="caption">
<h4>New capabilities</h4>
<p>There are eleven new capabilities, including several relating to data, privacy and policies.</p>
</div>
</div>
</li>
</ul>
</div>

[[Category:New features]]

[[de:Neue Funktionalitäten]]
[[es:Nuevas características de Moodle 3.5]]
[[fr:Nouveautés de Moodle 3.5]]
[[it:Nuove funzionalità in Moodle 3.5]]

Talk:User quick guide

2018-11-23T06:49:50Z

Marycooch: /* Reply */

Hi,
I think that the path Preferences > Messaging for Notifications is not correct. Maybe it could be Preferences > Notification preferences
[[User:Daniela Rotelli|Daniela]]

==Reply==
yes thanks- I have changed it to Preferences / Message preferences.--[[User:Mary Cooch|Mary Cooch]] ([[User talk:Mary Cooch|talk]]) 14:01, 22 November 2018 (UTC)

:I found also that the Message Block is no more available, so "Teachers can also add a Messages block to the course page to make messaging easier." is not correct. [[User:Daniela Rotelli|Daniela]]
==Reply 2==
Thanks- I have removed this as well--[[User:Mary Cooch|Mary Cooch]] ([[User talk:Mary Cooch|talk]]) 06:49, 23 November 2018 (UTC)

User quick guide

2018-11-23T06:49:13Z

Marycooch: /* Your notifications and messages */

{{About Moodle}}
So you've got a new Moodle account? What now? This page will help you navigate around your site as a student or teacher. The screencast '''[https://youtu.be/-0H9HLv41vY Finding your way around]''' is a good place to start.

==Your profile==

You can access your profile from the user menu top right. It's where you see your name and an arrow. Click there ''(1)'' to open up the menu ''(2)'' Clicking the Profile link will then display other options, such as a list of your courses, any forum and blog entries and a link to edit your profile (3).

[[File:newuserdocsprofile.png|600px|thumb|center|Your profile page]]

Clicking the Edit profile link will allow you to change certain information such as your correct timezone, add an avatar, description and, optionally, extra contact details. You cannot normally change your username and your admin might have restricted other changes too.

When you upload an image, it will appear in the user menu by your name and also on your [[Dashboard]] page.

==Your notifications and messages==

Your site can alert you when you have new messages from your teacher and other participants. You can receive alerts about new forum posts or graded assignments and more.

You can receive these alerts via email or pop up, and you can control how you receive them from ''Preferences / Message preferences'' in the user menu. The documentation [[Messaging]] gives more detail.

[[File:Messages35+.png|600px|thumb|center|Sending a message]]

If your Moodle admin has set the site up for the mobile app, you can also receive alerts on your mobile phone. See [[Moodle Mobile]] for more information.

You can message people from Messages in the user menu.

==Your courses==
How you find courses depends on how the administrator has set up the site.

'''Site front page''' - Some sites display all their courses on the front page and students click to enrol themselves into a course. When you are logged in, some site front pages may display only the courses you are enrolled in (to avoid clutter and confusion).

[[File:SearchCourses35+.png|600px|thumb|center|List of available courses]]

'''Dashboard''' - This is your personal page which you can customise and view your enrolled courses and outstanding tasks. More information in the section below.

==Your dashboard==
Every user has their own dashboard which they can customise. The screencast '''[https://youtu.be/NNuiUPAJrV0 Dashboard]''' gives a brief introduction to this, and the documentation on '''[[Dashboard]]''' gives further information.

[[File:UserQuickGuideDashboard.png|600px|thumb|center|Your dashboard]]

You can access your dashboard quickly, from the user menu top right and your site may redirect you automatically to your dashboard once you are logged in.

[[Category:Quick guide]]

[[de:Kurzanleitung für Nutzer/innen]]
[[es:Guía rápida del usuario]]
[[it:Guida rapida Utenti]]

Talk:User quick guide

2018-11-22T14:01:46Z

Marycooch: /* Reply */

Hi,
I think that the path Preferences > Messaging for Notifications is not correct. Maybe it could be Preferences > Notification preferences
[[User|Daniela Rotelli]]

==Reply==
yes thanks- I have changed it to Preferences / Message preferences.--[[User:Mary Cooch|Mary Cooch]] ([[User talk:Mary Cooch|talk]]) 14:01, 22 November 2018 (UTC)

User quick guide

2018-11-22T14:01:34Z

Marycooch: /* Your notifications and messages */

{{About Moodle}}
So you've got a new Moodle account? What now? This page will help you navigate around your site as a student or teacher. The screencast '''[https://youtu.be/-0H9HLv41vY Finding your way around]''' is a good place to start.

==Your profile==

You can access your profile from the user menu top right. It's where you see your name and an arrow. Click there ''(1)'' to open up the menu ''(2)'' Clicking the Profile link will then display other options, such as a list of your courses, any forum and blog entries and a link to edit your profile (3).

[[File:newuserdocsprofile.png|600px|thumb|center|Your profile page]]

Clicking the Edit profile link will allow you to change certain information such as your correct timezone, add an avatar, description and, optionally, extra contact details. You cannot normally change your username and your admin might have restricted other changes too.

When you upload an image, it will appear in the user menu by your name and also on your [[Dashboard]] page.

==Your notifications and messages==

Your site can alert you when you have new messages from your teacher and other participants. You can receive alerts about new forum posts or graded assignments and more.

You can receive these alerts via email or pop up, and you can control how you receive them from ''Preferences / Message preferences'' in the user menu. The documentation [[Messaging]] gives more detail.

[[File:Messages35+.png|600px|thumb|center|Sending a message]]

If your Moodle admin has set the site up for the mobile app, you can also receive alerts on your mobile phone. See [[Moodle Mobile]] for more information.

You can message people from Messages in the user menu. Teachers can also add a [[Messages block]] to the course page to make messaging easier.

==Your courses==
How you find courses depends on how the administrator has set up the site.

'''Site front page''' - Some sites display all their courses on the front page and students click to enrol themselves into a course. When you are logged in, some site front pages may display only the courses you are enrolled in (to avoid clutter and confusion).

[[File:SearchCourses35+.png|600px|thumb|center|List of available courses]]

'''Dashboard''' - This is your personal page which you can customise and view your enrolled courses and outstanding tasks. More information in the section below.

==Your dashboard==
Every user has their own dashboard which they can customise. The screencast '''[https://youtu.be/NNuiUPAJrV0 Dashboard]''' gives a brief introduction to this, and the documentation on '''[[Dashboard]]''' gives further information.

[[File:UserQuickGuideDashboard.png|600px|thumb|center|Your dashboard]]

You can access your dashboard quickly, from the user menu top right and your site may redirect you automatically to your dashboard once you are logged in.

[[Category:Quick guide]]

[[de:Kurzanleitung für Nutzer/innen]]
[[es:Guía rápida del usuario]]
[[it:Guida rapida Utenti]]

Talk:User quick guide

2018-11-22T14:01:13Z

Marycooch:

Hi,
I think that the path Preferences > Messaging for Notifications is not correct. Maybe it could be Preferences > Notification preferences
[[User|Daniela Rotelli]]

==Reply==
yes thanks- I have changed it to Preferences>Message preferences.--[[User:Mary Cooch|Mary Cooch]] ([[User talk:Mary Cooch|talk]]) 14:01, 22 November 2018 (UTC)

User quick guide

2018-11-22T14:00:27Z

Marycooch: minor edit

{{About Moodle}}
So you've got a new Moodle account? What now? This page will help you navigate around your site as a student or teacher. The screencast '''[https://youtu.be/-0H9HLv41vY Finding your way around]''' is a good place to start.

==Your profile==

You can access your profile from the user menu top right. It's where you see your name and an arrow. Click there ''(1)'' to open up the menu ''(2)'' Clicking the Profile link will then display other options, such as a list of your courses, any forum and blog entries and a link to edit your profile (3).

[[File:newuserdocsprofile.png|600px|thumb|center|Your profile page]]

Clicking the Edit profile link will allow you to change certain information such as your correct timezone, add an avatar, description and, optionally, extra contact details. You cannot normally change your username and your admin might have restricted other changes too.

When you upload an image, it will appear in the user menu by your name and also on your [[Dashboard]] page.

==Your notifications and messages==

Your site can alert you when you have new messages from your teacher and other participants. You can receive alerts about new forum posts or graded assignments and more.

You can receive these alerts via email or pop up, and you can control how you receive them from ''Preferences > Message preferences'' in the user menu. The documentation [[Messaging]] gives more detail.

[[File:Messages35+.png|600px|thumb|center|Sending a message]]

If your Moodle admin has set the site up for the mobile app, you can also receive alerts on your mobile phone. See [[Moodle Mobile]] for more information.

You can message people from Messages in the user menu. Teachers can also add a [[Messages block]] to the course page to make messaging easier.

==Your courses==
How you find courses depends on how the administrator has set up the site.

'''Site front page''' - Some sites display all their courses on the front page and students click to enrol themselves into a course. When you are logged in, some site front pages may display only the courses you are enrolled in (to avoid clutter and confusion).

[[File:SearchCourses35+.png|600px|thumb|center|List of available courses]]

'''Dashboard''' - This is your personal page which you can customise and view your enrolled courses and outstanding tasks. More information in the section below.

==Your dashboard==
Every user has their own dashboard which they can customise. The screencast '''[https://youtu.be/NNuiUPAJrV0 Dashboard]''' gives a brief introduction to this, and the documentation on '''[[Dashboard]]''' gives further information.

[[File:UserQuickGuideDashboard.png|600px|thumb|center|Your dashboard]]

You can access your dashboard quickly, from the user menu top right and your site may redirect you automatically to your dashboard once you are logged in.

[[Category:Quick guide]]

[[de:Kurzanleitung für Nutzer/innen]]
[[es:Guía rápida del usuario]]
[[it:Guida rapida Utenti]]

Wiki FAQ

2018-11-01T11:08:19Z

Marycooch: corrected link

{{Wiki}}
==Can I make a wiki that my students can read but not edit?==
*Although you used to be able to do this in older versions of Moodle, it's not really in the "spirit" of a wiki and is no longer possible without tweaking permissions. A [[Book]] might do the job just as well, or a simple[[ Page]].
*However, if you really need to do this then remove the student role from ''mod/wiki:editpage'' and ''mod/wiki:createpage'' when you create your wiki. See forum discussion here: [http://moodle.org/mod/forum/discuss.php?d=195179#p856311]

==Students can't see each others wikis==
If you have set the wiki to "individual", then only you the teacher and each individual student can see them. If you would like them to collaborate on a wiki, choose the collaborative option. However, this will just give one wiki for all the students.
==I've set my wiki to groups but they can't see the first page==
If you set your wiki to groups and want to create the first page for each group, remember to select each group and make the page individually:
[[File:GroupWiki.png]]

==How can I get my wiki to display on the Dashboard?==

Set an 'Expect completed by' date in the [[Activity completion]] section of your wiki.

==How can I have a TOC (table of contents)?==
This is automatically created if you use the appropriate headings in the toolbar of any of the wiki formats.
[[File:TOC.png]]

==How can I grade my students' wikis?==
There is no in-built grading facility in the wiki but you can manually add a grade item in the [[Gradebook]] called (for example) "yourwikiname" and enter your grades there.

==Can I export a wiki?==
While it was possible in earlier versions of Moodle to export wikis, for instance as zipped files, this is no longer the case. However, there is a [https://moodle.org/plugins/local_wikiexport | wiki export plugin].

==Can I reset a wiki?==
Yes. Wiki pages may be deleted (along with removing tags and deleting comments.)

==Why are embedded videos displaying twice in my wiki?==

When using the Media icon in the text editor to add a video link, be sure to enter a name in the name field. Don't leave it empty.

See also the discussion [https://moodle.org/mod/forum/discuss.php?d=265312 YouTube embed appears twice in a wiki].

==Any further questions?==

Please post in the [http://moodle.org/mod/forum/view.php?f=366 Wiki forum] on moodle.org

[[Category:FAQ]]

[[de:Wiki FAQ]]
[[es:Wiki FAQ]]
[[ja:WikiモジュールFAQ]]

PayPal enrolment

2018-10-30T10:40:39Z

Marycooch: paypal screencast

{{Enrolment}}
The PayPal enrolment plugin allows users to pay for courses and then be automatically enrolled.

==PayPal side setup==

# Create a PayPal account at https://www.paypal.com
#* Although not required, it may be wise to upgrade your account to "Premier" status and get "Verified".
# Set the encoding to UFT-8.
#* Go to Profile > Profile and settings > My selling tools > More selling tools > PayPal button language encoding
#* Make sure you have your website's language set to Western European Languages
#* Click the "More Options" button
#* Set encoding to "UTF-8" and let the same encoding be used for IPN, too.
# Enable instant payment notifications (IPN)
#* Go to Profile > Profile and settings > My selling tools > Getting paid and managing my risk > Instant payment notifications > Update
#* Turn IPN on and set the notification URL to your site's enrol/paypal/ipn.php (so it reads for example like <nowiki>https://my.school.edu/moodle/enrol/paypal/ipn.php</nowiki>).

You may wish to log in to https://developer.paypal.com/developer/accounts/ and experiment with PayPal Sandbox first. If doing do, put this to your config.php:

$CFG->usepaypalsandbox = 1;

==Enabling PayPal enrolment==

{{MediaPlayer | url = https://youtu.be/vBfnNZDjR0c | desc = How to set up payment for courses}}

An administrator can enable PayPal file enrolment as follows:

# ''Go to Site administration > Plugins > Enrolments > Manage enrol plugins'' and click the eye icon opposite PayPal. When enabled, it will no longer be greyed out. [[Manual enrolment]] must also be enabled, since the PayPal plugin requires it.
# Click the settings link, configure as required (see details of settings below), then click the 'Save changes' button.

* PayPal business email - This setting is case sensitive and must exactly match that in PayPal
* Default role assignment - This means the role that a new user will automatically be given in a course when they purchase access. Usually this would be "student" unless you have a special reason for choosing another role. As for other default settings, it may be overridden in individual courses.

Tip: If you wish to allow users to create their own accounts on your site then you need to set up [[Email-based_self-registration|Email based self registration]].

==Course settings for PayPal==

===Checking you have PayPal in your course===

# If you are using the [[Boost theme]], click the gear menu from the Participants link and then click Enrolment methods. If you are using a different theme, go to ''Course administration > Users > Enrolment methods''
# If you do not see PayPal, use the pull down menu "Add method" and select PayPal. If you are a course teacher, your admin will need to allow you the capability ''enrol/paypal:config'' in order for you to add this method.
# Make sure PayPal has its "eye" opened:

[[File:Paypalenrolmentmethod.png]]
{{Note|Make sure you don't have [[Self enrolment]] enabled as this would allow users to access the course without paying. If you do need some users to self enrol for free, then add an [[Enrolment key]] in the self enrolment settings.}}

===Setting a price for your course===

# In ''Course Administration > Users > Enrolment methods'', click the edit/hand/pen icon to the right of the PayPal option.
# Optional: Give a name to this enrolment method if you wish in "Custom Instance name"
# Ensure that "Allow PayPal enrolments" is set to "yes"
# In "Enrol cost", type in the cost of your course and in "Currency" choose your currency.
# Usually you would leave the "Assign role" as "student" unless you have a very special reason for allowing your users to enrol as, say, editing teachers etc
# Choose an enrolment period and/or start/end dates if desired.
# Click the "Save changes" button.

[[File:Paypalcoursesettings.png]]

===What the new user sees===

When a new user clicks on your course link, they will see a message inviting them to go to PayPal to purchase access to the course. In the list of courses, PayPal courses have a "P" icon next to them.
{|
| [[File:Paypaluserview.png|frame|left|Message inviting user to pay via PayPal]]
| [[File:Paypalicon.png|frame|left|PayPal course listed with "P" icon]]
|}

==PayPal capabilities==

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

== See also ==
*[http://moodle.org/mod/forum/discuss.php?d=171745#p977221 Testing the PayPal plugin in the PayPal Sandbox]

[[de:Paypal-Einschreibung]]
[[es:Inscripción por Paypal]]
[[fr:Inscription Paypal]]

Guest access

2018-10-30T10:38:49Z

Marycooch: videos on guest access

{{Enrolment}}
The Guest access plugin allows users with the [[Guest_role |Guest role]] to view the contents of a course. This might be used, for example, if a Moodle site serves as a website where certain courses contain publicly available information, or else with a commercial Moodle site where courses with guest access can offers a "taster" of the kind of courses which may be purchased. (Note that the guest cannot participate in any activities; they can only view content.)

==Course settings for guest access==

{{MediaPlayer | url = https://youtu.be/9X8dVVRw52w | desc = How to allow guests into courses}}
# With the [[Boost theme]], from the navigation drawer on the left, click 'Participants', and then from the gear menu on the right, click 'Enrolment method> Guest access'. With other themes, click ''Administration > Course administration > Users > Enrolment methods'' and then Guest access.
#Enable guest access by clicking on the "eye" icon or by choosing it in the 'Add method' dropdown menu.
# If you wish to set a password, then click the configure icon and type in your password here.

==Admin settings for guest access==

{{MediaPlayer | url = https://youtu.be/KA9VdsqPhoM | desc = How to allow guests onto your Moodle site}}

*In ''Administration > Site administration > Plugins > Enrolments > Manage enrol plugins'',ensure Guest access is enabled (has its eye open.) This enables Guest access.
* In ''Administration > Site administration > Plugins > Authentication > Manage authentication'' set the Guest login button to Show if you want the button on the Front page.
* Also Guest accounts can be logged - check the ''Administration> Site administration > Server > Cleanup > Log guest access'' setting
* A site policy for guests may be set in ''Site administration > Security > Site policies''. Guests then have to agree to the site policy before accessing a course with guest access.

===Default settings for guest access===
*Clicking on ''Administration > Site administration > Plugins > Enrolments > Guest access'' brings up the screen where admin can set defaults for guest access in courses.
**Clicking the 'Advanced' button next to 'Allow guest access' will hide this setting in a course and will instead display a 'Show more' link to click on to access the setting.
** Guest access can be turned on by default in all new courses and you can also:
**require each course with guest access to have a password for guests. (Note: this can confuse teachers who are not aware of the requirement.)
**use or ignore your Moodle's standard password policy for guest access passwords
**offer if needed the first letter of the password as a hint.

===Auto-login guests===
*In ''Administration > Site administration > Users > Permissions > User policies'', you can tick the box so that visitors are automatically logged in as guests when accessing a course with guest access (i.e. they don't have to click the "login as guest button".
*In ''Administration > Site administration > Plugins > Authentication > Manage Authentication'', you must have "Guest login button" set to "Show".
*In ''Administration > Site administration > Security > Site policies'' you can check "Open to Google" setting so that the Google search robot will be allowed to enter your site as a Guest. In addition, people coming in to your site via a Google search will automatically be logged in as a Guest.

==See also==

* [[Guest role]]
* [https://moodle.org/mod/forum/discuss.php?d=347107#p1400235 Re: Guest access to course sections!] forum post
*Tracker discussion 'Auto-login guests not working' MDLSITE-4903
[[de:Gastzugang zum Kurs]]

[[es:Acceso de invitados]]

Guest access

2018-10-30T10:37:29Z

Marycooch: video guest access courses

{{Enrolment}}
The Guest access plugin allows users with the [[Guest_role |Guest role]] to view the contents of a course. This might be used, for example, if a Moodle site serves as a website where certain courses contain publicly available information, or else with a commercial Moodle site where courses with guest access can offers a "taster" of the kind of courses which may be purchased. (Note that the guest cannot participate in any activities; they can only view content.)

==Course settings for guest access==

{{MediaPlayer | url = https://youtu.be/9X8dVVRw52w | desc = How to allow guests into courses}}
# With the [[Boost theme]], from the navigation drawer on the left, click 'Participants', and then from the gear menu on the right, click 'Enrolment method> Guest access'. With other themes, click ''Administration > Course administration > Users > Enrolment methods'' and then Guest access.
#Enable guest access by clicking on the "eye" icon or by choosing it in the 'Add method' dropdown menu.
# If you wish to set a password, then click the configure icon and type in your password here.

[[File:NGA.png|thumb|center|500px|Setting password from Enrolment methods page]]

==Admin settings for guest access==
*In ''Administration > Site administration > Plugins > Enrolments > Manage enrol plugins'',ensure Guest access is enabled (has its eye open.) This enables Guest access.
* In ''Administration > Site administration > Plugins > Authentication > Manage authentication'' set the Guest login button to Show if you want the button on the Front page.
* Also Guest accounts can be logged - check the ''Administration> Site administration > Server > Cleanup > Log guest access'' setting
* A site policy for guests may be set in ''Site administration > Security > Site policies''. Guests then have to agree to the site policy before accessing a course with guest access.

===Default settings for guest access===
*Clicking on ''Administration > Site administration > Plugins > Enrolments > Guest access'' brings up the screen where admin can set defaults for guest access in courses.
**Clicking the 'Advanced' button next to 'Allow guest access' will hide this setting in a course and will instead display a 'Show more' link to click on to access the setting.
** Guest access can be turned on by default in all new courses and you can also:
**require each course with guest access to have a password for guests. (Note: this can confuse teachers who are not aware of the requirement.)
**use or ignore your Moodle's standard password policy for guest access passwords
**offer if needed the first letter of the password as a hint.

===Auto-login guests===
*In ''Administration > Site administration > Users > Permissions > User policies'', you can tick the box so that visitors are automatically logged in as guests when accessing a course with guest access (i.e. they don't have to click the "login as guest button".
*In ''Administration > Site administration > Plugins > Authentication > Manage Authentication'', you must have "Guest login button" set to "Show".
*In ''Administration > Site administration > Security > Site policies'' you can check "Open to Google" setting so that the Google search robot will be allowed to enter your site as a Guest. In addition, people coming in to your site via a Google search will automatically be logged in as a Guest.

==See also==

* [[Guest role]]
* [https://moodle.org/mod/forum/discuss.php?d=347107#p1400235 Re: Guest access to course sections!] forum post
*Tracker discussion 'Auto-login guests not working' MDLSITE-4903
[[de:Gastzugang zum Kurs]]

[[es:Acceso de invitados]]

Cohorts

2018-10-30T10:35:58Z

Marycooch: cohorts screencast

{{Grouping users}}
==About cohorts==
Cohorts are site-wide or course category-wide groups. The purpose of cohorts is to enable all members of the cohort to be easily enrolled in a course. This can be done using [[Cohort sync]], which, as the name suggests, synchronises cohort membership with course enrolment. Alternatively, a cohort can be manually enrolled in a course.

{{MediaPlayer | url = https://youtu.be/ok27wqDAsEk | desc = How to create and add cohorts}}

==Creating a cohort==

Cohorts can be created by site administrators and other users with appropriate permissions.

1. Access ''Administration > Site administration > Users > Accounts > Cohorts''

[[File:Createcohort1.png|thumb|center|400px]]
2. Click the Add button. Note that in the dropdown you can choose between making your cohort available throughout the site "system" or in a named course category.

3. Cohorts are visible to teachers by default but unchecking the 'Visible' link will mean they are not available for teachers to use in their courses.

4. Complete the details and save the changes.

5. Follow the assign link opposite the cohort name in the list of available cohorts.

[[File:cohortscreen.png|thumb|center|600px]]
6. Select potential users from the list then click the Add button.

==Creating cohorts in bulk==

#Cohorts can be created with a csv file upload to the system or to a named category from ''Site administration > Users > Accounts > Cohorts > Upload cohorts''. More detailed information can be found on the [[Upload_cohorts|Upload cohorts]] page.
#Category managers can upload csv files to create cohorts from the Cohorts link in the Administration block of their category.
#An example file is below. The 'Students 2014-15' cohort will be created in the system and the 'History' cohort will be created in the (already existing) Humanities category:

[[File:cohortupload.png|center|thumb|600px]]

==Adding users to a cohort in bulk==

#Access ''Administration > Site administration > Users > Accounts > Bulk user actions''
#Find users by setting an appropriate filter
#Add users from the available list to the selected list
#Choose 'Add to cohort' with selected users

==Uploading users to a cohort==

An administrator can [[Upload users|upload users]] via CSV file to existing cohorts as follows:
#Access ''Administration > Site administration > Users > Accounts > Upload users''
#Upload a text file with the following format:

username,password,firstname,lastname,email,cohort1
tomjones,Pass1234*,Tom,Jones,tomjones@example.com,year3
marysmith,Pass1234*,Mary,Smith,marysmith@example.com,year4

where year3 and year4 are the '''cohort ids''' of existing cohorts (i.e. ''not their names'').

''Note: If the users already exist on the system, then you only need their username with the chosen cohort in your csv file.''

It is also possible to create the cohort at the same time as the users are uploaded to the system.
username,password, firstname,lastname,email,cohort1
jackbrown,Pass5678,Jack,Brown,jbrown@example.com,London Contingent
In the above example, the cohort named London Contingent will be created upon upload of the csv file.

==Searching cohorts==
When a site has a large number of cohorts, keywords may be entered into the Search Cohorts box to search for or filter the available
cohorts.

An All Cohorts screen accessed from ''Site administration > Users > Accounts > Cohorts'' allows an administrator to view and search through system and category cohorts.

[[File:AllCohortsscreen.png|thumb|center|600px]]

==Managing category cohorts==

Cohorts which have been created for a category rather than the system can be located by selecting the appropriate category and then clicking the ''Cohorts'' link in ''Administration > Category (name) > Cohorts''.

==Cohort capabilities==

*[[Capabilities/moodle/cohort:assign|Add and remove cohort members]]
*[[Capabilities/moodle/cohort:manage|Create, delete and move cohorts]]
*[[Capabilities/enrol/cohort:config|Configure cohort instances]]
*[[Capabilities/moodle/cohort:view|View site-wide cohorts]]

==Enrolling a cohort in a course==

There are two ways to enrol a cohort in a course:

# Cohort sync
# Manual enrolment of the cohort

With cohort sync, if users are later added or removed from the cohort, they are automatically enrolled or unenrolled from the course. For further details, see [[Cohort sync]].

Manual enrolment of the cohort however is a one-time action. Adding or removing users from the cohort later has no effect on course enrolment.

===Manual enrolment of a cohort===

To manually enrol all members of a cohort in a course:

# Go to ''Course administration > Enrolled users''
# Click the 'Enrol users' button and then 'Browse cohorts'
# Select a cohort then click the 'Finish enrolling users' button.

[[File:newcohortenrol.png|thumb|center|400px]]

The required capabilities for manually enrolling cohort members are:
* enrol/manual:enrol in course context
* moodle/course:enrolreview in course context

The default "Teacher" (editingteacher) role has all of these capabilities.

==Assigning user-context roles to all cohort members==

A user-context role may be assigned to all members of a cohort in ''Site administration > Users > Permissions > Assign user roles to cohort''.

This is useful for enabling mentors (or team managers) to review users' learning plans when using [[Competencies]].

{{Note|The changes may not appear immediately as the role is assigned after a scheduled task, 'Sync cohort role assignments', is run.}}

==See also==

*[[Cohort sync]] enrolment method
*[[cohort/upload|Upload cohorts]] bulk file uploads
*[http://youtu.be/FQ6RjeU3ybQ?list=PLxcO_MFWQBDdJmqW4tD5qXJ6pPXWTP7GL Cohorts 2.8 screencast] from Moodle HQ
*MDL-34189 Make category cohorts visible site-wide for site administrators
*[http://www.somerandomthoughts.com/blog/2011/11/22/using-cohorts-with-moodle-2-2/ Using cohorts with Moodle 2.2] blog entry by Gavin Henrick

[[Category:Site administration]]

[[fr:Cohortes]]
[[de:Globale Gruppen]]
[[es:Cohortes]]
[[ja:コーホート]]

Groups

2018-10-30T10:34:09Z

Marycooch: added screencast

{{Grouping users}}
==Why use groups?==
*You are a teacher in a course where you have several classes and you want to filter your activities and gradebook so you only see one class at a time.
*You are a teacher sharing a course with other teachers and you want to filter your activities and gradebook so you don’t see the students from your colleagues’ classes.
*You want to allocate a particular activity, resource or topic section to just one class or set of users and you don’t want others to see it.

{{MediaPlayer | url = https://youtu.be/Gaq1M9-ETtQ | desc = How to add groups to courses}}

*This [https://youtu.be/pKAFWItexUY screencast about using groups] also highlights the benefits of using groups.

==Group levels==
[[File:groupmodecourse.png|thumb|Groups settings in course settings]]
A group or grouping can be used on two levels:

*Course level - The group mode defined at the course level is the default mode for all activities defined within that course. To use groups you need first to set a group mode in ''Administration > Course administration > Edit settings.''

*Activity level - Each activity that supports groups can also have its own group mode defined. If the course setting "Force group mode" is set to "Yes" then the option to define the group mode for individual activities is not available. If it is set to "No", then the teacher may change the group mode:

===Group modes===

There are three group modes

*No groups - There are no sub groups, everyone is part of one big community
*Separate groups - Each group can only see their own group, others are invisible.
*Visible groups - Each group works in their own group, but can also see other groups. (The other groups' work is read-only.)

For example, enabling either separate or visible groups on an assignment drop-box enables staff to filter the student submissions to see only those from a particular tutor group. With visible groups, students can see which other groups are doing the same activities as they are; with separate groups, they do not know which other groups are doing the same activities.

Using groups with discussion forums allow teachers to restrict interaction between students. Separate groups mean only students in the same group can see and participate in discussions within a particular forum. Visible groups allow students to see other group's discussions, but only participate in their own group's discussions.

'''Note:''' Where visible groups are used or the participant can access all groups, the user's own group is shown first, followed by other groups:

[[File:mygroupsfirst.png]]

==Creating a group==
#Click the 'Create group' button in ''Administration > Course administration > Users > Groups''
#Add a group name and optional description (displayed above the list of group members on the participants page), [[Enrolment key|enrolment key]] and picture (displayed on the participants page and next to forum posts)
#Click the 'Save changes' button
#Select the group to which you want to add participants, then click the 'Add/remove users button
# In the "Potential members" list, select the users you want to add to the group. Multiple users may be selected using the Crtl key.
# Click the Add button to add the users to the group

An optional group ID number (an advanced setting) may be added for matching the group against external systems. Group ID numbers are not displayed anywhere on the site. Within a course, all group ID numbers must be unique. Thus it's not possible to create a group with a duplicate group ID number.

==Auto-create groups==
[[File:autocreategroups.png|thumb|Auto-create groups]]
Groups may be created automatically via the 'Auto-create groups' button in ''Administration > Course administration > Users > Groups''. To see all the settings, click the ''Expand all'' link top right.

===General===
A '''naming scheme''' can be created automatically. # is replaced by sequential numbers, and @ by letters. For example:
*''Group @'' will create group with a naming scheme Group A, Group B, Group C . . .
*''Group #'' will create group with a naming scheme Group 1, Group 2, Group 3 . . .

You can specify if you would like to create
*x number of Groups or
*each group contain x number of students

=== Prevent last small group ===

When selecting '''Members per group''', depending on the number of users in the course, the last group can end up with significantly fewer members than expected. You can select '''Prevent last small group''' to avoid the situation. If the last group would be smaller than 70% of the expected size, it will not be created. Instead, Moodle will allocate additional members to existing groups rather then create a new group with few members.

Example 1:
:You have a course with 80 students and you let auto-create groups with 30 members per group. There would be just 20 students in the third group which is 66% out of expected 30. Moodle will auto-create only two groups with 40 students in each.

Example 2:
:You have a course with 81 students and you let auto-create groups with 30 members per group. Moodle will create three groups with 30, 30 and 21 members respectively because 21 is 70% out of expected 30.

Hint: If you need to customize the 70% ratio used in these calculations on your site, ask your administrator to set the constant `AUTOGROUP_MIN_RATIO` in the main config.php.

define('AUTOGROUP_MIN_RATIO', 0.95); // Means the smallest group will have at least 95% of the expected size.

===Group members===
''Select members from ...'' allows you to choose from roles assigned within the course, available cohorts, groups or groupings.
'''Specify''' and '''Group/Member count''' work together.

The setting 'Select members from cohort' lists all cohorts which users enrolled on the current course are part of. The number in brackets is the number of users enrolled on the course in that cohort.

The 'Ignore users in groups' checkbox should be ticked to only select group members from users that are NOT already in a group in the course.

The 'Include only active enrolments' checkbox provides the option to choose whether to include suspended users in groups. The checkbox is only displayed to users with the [[Capabilities/moodle/course:viewsuspendedusers|capability to view suspended users]].

===Grouping===

'''Create in grouping''' and '''Grouping name''' allows you to create a new grouping and allocate the new auto-created groups to be created to it.

Prior to creating the groups, you can view the groups.

==Restricting an activity, resource or course topic to a particular group==
[[File:group restriction.png|frame|Restricting an activity to a particular group]]
To be able to restrict an activity, resource or course topic to a group, [[Restrict access]] must be enabled. This will result in a 'Restrict access' section in the activity, resource or topic settings and a group restriction can then be added.

==Groups and enrol plugins==

Where groups are created automatically with enrol plugins such as IMS Enterprise, members cannot be unenrolled manually via the groups screen inside a course. This has to be done from the plugin. Additionally, when group members are owned by a plugin like this, there is information below their name on the groups screen.

==Groups overview==

A overview of groups and groupings is available via the Overview tab in ''Administration > Course administration > Users > Groups''.

The table may be filtered to display particular [[Groupings|groupings]] or groups and it will also display students who are ''not'' in a group:
[[File:notinagroup1.png|center]]

==Groups capabilities==

*[[Capabilities/moodle/course:managegroups|Manage groups]]
*[[Capabilities/moodle/site:accessallgroups|Access all groups]]
*[[Capabilities/moodle/calendar:managegroupentries|Manage group calendar entries]]

==See also==

*[[Upload users]] - for importing users into groups
*[[Enrolment key]]

[[de:Gruppen]]
[[fr:Groupes]]
[[ja:グループ]]
[[es:Grupos]]

Manual enrolment

2018-10-30T09:44:22Z

Marycooch: screencast adding users to a course

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

{{MediaPlayer | url = https://youtu.be/PdQjI9i9N5s | desc = Course enrolment}}

==Course settings==

===Checking you have manual enrolment in your course===
*In a course, go to 'Enrolment methods' by clicking the gear menu in the nav drawer Participants link (or in ''Course administration > Users'' in the Administration block if you are using a theme other than Boost).
*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 from the Enrolment methods link.

{|
|[[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:enrolduration.png|thumb|Enrolling users method 1]]
# Go to 'Enrolled users' from the gear menu in the nav drawer Participants link (or in ''Course administration > Users'' in the Administration block if you are using a theme other than Boost)
# 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. (Note that if your course has cohort enrolment, you will see 2 radio buttons (as in the screenshot) To enrol users individually, click the Browse users button. It should be selected by default.)
# Click to expand the enrolment options and set them as appropriate. These include the enrolment duration
# Browse or search for the user (Note that when searching for users, exact matches are listed first)
# 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 the Site administration.

'''Method 2'''
[[File:manually enrolling users.png|thumb|Enrolling users method 2]]
# Go to 'Enrolment methods' from the gear menu in the nav drawer Participants link (or in ''Course administration > Users'' in the Administration block if you are using a theme other than Boost)
# 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

Note: When searching for users, by default the user's email address is displayed in addition to their name. If preferred, an admin can set other user identity fields such as ID number to be displayed in 'Show user identity' in [[User policies]] in the Site administration.

===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 'Enrolled users' from the gear menu in the nav drawer Participants link (or in ''Course administration > Users'' in the Administration block if you are using a theme other than Boost)
# 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 'Manage enrol plugins' in the Site administration.

Site-wide settings, including default settings for manual enrolment in new courses, may be set in 'Manual enrolments' in the Site administration.

* 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 start - this feature sets the time for when students are enrolled in a course. The default is 'Now', but it can also be set to 'Today' and 'Course start'.
* 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==

* [[Participants]]

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

Manual enrolment

2018-10-30T09:43:20Z

Marycooch:

{{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 'Enrolment methods' by clicking the gear menu in the nav drawer Participants link (or in ''Course administration > Users'' in the Administration block if you are using a theme other than Boost).
*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 from the Enrolment methods link.

{|
|[[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:enrolduration.png|thumb|Enrolling users method 1]]
# Go to 'Enrolled users' from the gear menu in the nav drawer Participants link (or in ''Course administration > Users'' in the Administration block if you are using a theme other than Boost)
# 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. (Note that if your course has cohort enrolment, you will see 2 radio buttons (as in the screenshot) To enrol users individually, click the Browse users button. It should be selected by default.)
# Click to expand the enrolment options and set them as appropriate. These include the enrolment duration
# Browse or search for the user (Note that when searching for users, exact matches are listed first)
# 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 the Site administration.

'''Method 2'''
[[File:manually enrolling users.png|thumb|Enrolling users method 2]]
# Go to 'Enrolment methods' from the gear menu in the nav drawer Participants link (or in ''Course administration > Users'' in the Administration block if you are using a theme other than Boost)
# 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

Note: When searching for users, by default the user's email address is displayed in addition to their name. If preferred, an admin can set other user identity fields such as ID number to be displayed in 'Show user identity' in [[User policies]] in the Site administration.

===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 'Enrolled users' from the gear menu in the nav drawer Participants link (or in ''Course administration > Users'' in the Administration block if you are using a theme other than Boost)
# 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 'Manage enrol plugins' in the Site administration.

Site-wide settings, including default settings for manual enrolment in new courses, may be set in 'Manual enrolments' in the Site administration.

* 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 start - this feature sets the time for when students are enrolled in a course. The default is 'Now', but it can also be set to 'Today' and 'Course start'.
* 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==

* [[Participants]]

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

Manual enrolment

2018-10-30T09:42:01Z

Marycooch: screencast - course enrolment

{{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 'Enrolment methods' by clicking the gear menu in the nav drawer Participants link (or in ''Course administration > Users'' in the Administration block if you are using a theme other than Boost).
*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 from the Enrolment methods link.

{|
|[[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:enrolduration.png|thumb|Enrolling users method 1]]
# Go to 'Enrolled users' from the gear menu in the nav drawer Participants link (or in ''Course administration > Users'' in the Administration block if you are using a theme other than Boost)
# 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. (Note that if your course has cohort enrolment, you will see 2 radio buttons (as in the screenshot) To enrol users individually, click the Browse users button. It should be selected by default.)
# Click to expand the enrolment options and set them as appropriate. These include the enrolment duration
# Browse or search for the user (Note that when searching for users, exact matches are listed first)
# 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 the Site administration.

'''Method 2'''
[[File:manually enrolling users.png|thumb|Enrolling users method 2]]
# Go to 'Enrolment methods' from the gear menu in the nav drawer Participants link (or in ''Course administration > Users'' in the Administration block if you are using a theme other than Boost)
# 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

Note: When searching for users, by default the user's email address is displayed in addition to their name. If preferred, an admin can set other user identity fields such as ID number to be displayed in 'Show user identity' in [[User policies]] in the Site administration.

==Screencast - enrolling users into courses==
This video explains both how a course teacher can enrol users into a course and how an administrator can bulk enrol into a course.
{{MediaPlayer | url = https://youtu.be/PdQjI9i9N5s | desc = Course enrolment}}

===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 'Enrolled users' from the gear menu in the nav drawer Participants link (or in ''Course administration > Users'' in the Administration block if you are using a theme other than Boost)
# 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 'Manage enrol plugins' in the Site administration.

Site-wide settings, including default settings for manual enrolment in new courses, may be set in 'Manual enrolments' in the Site administration.

* 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 start - this feature sets the time for when students are enrolled in a course. The default is 'Now', but it can also be set to 'Today' and 'Course start'.
* 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==

* [[Participants]]

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

Upload users

2018-10-30T09:38:28Z

Marycooch: screencast bulk upload users

{{Accounts}}
==Uploading users via text file==

There are many 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.

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

{{MediaPlayer | url = https://youtu.be/_kNMOr7Tdw0 | desc = How to bulk upload users and add to courses}}

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

''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 (eg, [https://notepad-plus-plus.org/ Notepad++]) for verification.

===Valid upload file for testing===
Here is an example of a simple valid upload file:
(Column headers on the first line of the file are only highlighted in bold in this example to distinguish it from the rest of the of the data/user details), assuming you have already created the course 'math102' and the two cohorts of the proper names.

'''username,password,firstname,lastname,email,course1,group1,cohort1'''
jonest,verySecret3$,Tom,Jones,jonest@example.com,math102,Section 1,year 3
reznort,someSecret4#,Trent,Reznor,reznort@example.com,math102,Section 3,year 4

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

===Required fields===

These are the required user identification fields:
<code>username,firstname,lastname,email</code>
Validity checks are performed for:
* '''username''' can only contain alphabetical '''lowercase''' letters , numbers, hypen '-', underscore '_', period '.', or at-sign '@'
* '''email''' is in the form: ''name@example.com''

===Passwords===

The "password" field is optional if the 'New user password' setting on the upload screen is set to "Create password if needed and send via email" but is required if the setting to "Field required in file".

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 '''changeme'''. If omitted, a password will be generated for each user (during the next Cron job) and welcome e-mails sent out. The text for the welcome e-mail is in the language settings in ''Site administration > Language > Language customisation'' with a String identifier of 'newusernewpasswordtext'.

===Optional user fields===

Note: Commas within a field must be encoded as &#44 - the script will decode these back to commas.
Tip: For Boolean fields with only two values, use '''0''' for false and '''1'''for true.

To provide values other than the default you can include one or more of these optional user fields:

<pre>institution,department,city,country,lang,auth,timezone,idnumber,icq,phone1,phone2,address,url,description,mailformat,maildisplay,maildigest,htmleditor,autosubscribe,interests</pre>

Most of the these are user profile fields or user preference fields that belong to the user profile and are the filled in the user or at manual creation. Some however require specific formats:

See [[Additional name fields]] for more details. Key things to note are:

'''country''' - use the country TWO LETTER CODE, in upper case, eg AU,ES,GB,US. These are all UPPER CASE. Using "au" or "es" or "USA" as a country code will result in a database error. If you are having trouble working out the two-letter code for a country, you can consult the list of [https://www.iso.org/obp/ui/#search country names and code elements] available on the ISO Website. A common error is to use UK for United Kingdom; it should be GB.

'''lang''' - use the two letter (or extended four lettter) code as defined in the Moodle language packs, e.g. en, es, en_us, de, in ''Site administration > Language > Language packs''.

'''auth''' - The auth field must be used if the site uses an alternative authentication method, such as LDAP, as otherwise the authentication method will default to manual and users using a different auth method won't be able to log in.
Use the shortname codes defined in Plugins > Authentication for the various types, e.g. manual, nlogin, ldap, cas, mnet, db, none. If you do not include an auth column, then newly created users will be created with the manual account type.

You can set "auth" to "nologin" in your csv file which will mean that then created users cannot login.

'''timezone''' - Should be in the format as found in the Location settings in terms of Zone/Region, eg. Australia/Sydney, Asia/Kathmandu, Europe/Madrid, etc. The entry is case sensitive so Europe/London will work but europe/london will not.

NOTE: Needed: settings for '''mailformat''','''maildisplay''','''htmleditor''','''autosubscribe'''

'''maildigest''' 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.

===Custom profile field names===

These are optional and depend on whether you have created any custom profile fields in your site. The name of the header in file is of the form 'profile__field_xxxxx' where xxxx is the unique shortname of custom user profile field name as you created it.

The field name should match the case of the profile field shortname. So, for instance if the shortname of your custom profile field is all upper case, for example, ''DOB'', then use a header of ''profile_field_DOB'' to match the case, not ''profile_field_dob'', which will produce a "is not a valid field name" error. Likewise, a mixed case shortname such as ''Dob'' should have a header of ''profile_field_Dob''. (The exception to this is if the shortname is all lower case, then any case will work in the field header, which is a historical quirk: but best practice is to match the case and you will avoid errors.)

<pre>profile_field_xxxxx</pre>

'''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 dates, use the ISO standard format YYYY-MM-DD, eg. 2014-06-19 which will then be properly localized in the interfaced. For example, a field called dohire for date of hire, the fields could be:
<pre>
username,firstname,lastname,email,profile_field_dohire
blumbergh,Bill,Lumbergh,blumbergh@example.com,1990-02-19
pgibbons,Peter,BGibbons,pgibbons@example.com,1996-06-05
tsmykowski,Tom,Smykowski,tsmykowski@example.com,1970-01-01
</pre>

For custom profile fields that are a menu, use the corresponding value in the menu list from field as you defined it. For example: a custom field 'corporatedivision' with one of three values 'Management', 'Development' or 'Training'. Just insert one of those three words (e.g. 'Training') as the value for that field. Eg.

<pre>
username,firstname,lastname,email,profile_field_corporatedivision
blumbergh,Bill,Lumbergh,blumbergh@example.com,Management
pgibbons,Peter,BGibbons,pgibbons@example.com,Development
tsmykowski,Tom,Smykowski,tsmykowski@example.com,Training
</pre>

=== Special user change fields===

Three special fields are used for managing user accounts, '''oldusername''', '''deleted''' and '''suspended'''. [[#Allow_renames|See below for details]].

===Enrolment fields===

You may optionally enrol users in already existing courses using manual enrolment. Only manual enrolment is done this way; if the manual enrolment method is disabled in a course, then no enrol is done.

You use fields in the upload file of this type:

<pre>course1,type1,role1,group1,enrolperiod1,enrolstatus1,course2,type2,role2,group2,enrolperiod2,enrolstatus2</pre> etc.

Header fields '''must''' have a numeric suffix such that type1,role1,group1,enrolperiod1 and enrolstatus1 all apply to course1 for course'''1''' to course'''n'''. Even if you are just doing one course enrolment, you must still use the number 1 on the heading name, i.e. course1,role1, etc. Do not use the bare headings without numbers, e.g. course,role, etc as those will generate an error.

'''course#''' is the shortname of the course, if present the user will be enrolled in that course. Do not use the fullname of the course or it will generate an error. This field is the ONLY required field for a succesful enrolment. All the others are optional.

'''type#''' sets the role to be used for the enrolment. A value of 1 is default course role, 2 is legacy Teacher role and 3 is legacy Non-editing Teacher.

'''role#''' may be used to specify roles directly, using either role short name or the role id (numeric names of roles are not supported). Usually you will use the role name that is the shortname of the role as defined in Users > Permissions > Define roles, eg. student, editingteacher. If the role column is left out, the users will be enroled in the course with the default role, which is normally student.

'''group#''' may be used to assign users to groups in course, using name or id (numeric group names are not supported). NOTE: if the group does not already exist, it will be created.

'''enrolperiod#''' may be used to set the enrolment duration, in days, for each course. If not explicitly set here, all the users will get the duration as set in the Manual enrolment method of the course (which defaults to 0 meaning unlimited.)

'''enrolstatus#''' is optional as by default all newly enrolled users are set to active. If used a value of 1, it will suspend users in the course and if a user is previously set as inactive / suspended then a value of 0 will unsuspend them and make them active again.

=== Cohort membership assignment===

You can assign users to any already existing Cohort by using only the "username" and the "Cohort ID" with just two fields in the file. Note that this is an exception to the usual case where the firstname, lastname and email address of the user are required.

'''cohort#''' is the form to use and like enrolment in courses, you have to add a number to each header, so cohort1,cohort2, etc.

Internal cohort id numbers or non-numeric Cohort IDs of existing cohorts must be used; do not use the full name are not allowed. (Note that cohort id is what is usually known elsewhere as the "shortname".)

Here is a sample CSV file:

<pre>
username,cohort1,cohort2
student1,nursing,2016class
student2,nursing,2014class
student3,nursing,2014class
</pre>

=== MNet ===

Existing [[MNet]]users can be added to courses, groups or cohorts as below by using the field header '''mnethostid'''

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

=== Set system roles ===
Users may also be assigned to already defined system roles, using the shortname of the system role as defined in ''Site administration > Users > Permissions > Define roles'' for roles with a system context defined.

<code>sysrole1,sysrole2,sysrole3</code> etc

Users may be uploaded to a system role (usually Manager or Course creator) by entering the shortname of that role. Other roles can only be uploaded if they have already been assigned in the 'system' context. See [[Creating custom roles]]. Multiple roles can be assigned using sysrole2, sysrole3, etc. fields. Note that the number suffix in no way relates to the number suffixes on the enrolment fields. The numbers must go up in sequence starting at 1.

Unassigning system roles
Users can also be removed from a given system role by entering the shortname of that role prefixed with a minus symbol: '-'. If the user is currently assigned to that role, they are removed from it. If the user is not currently assigned to that system role, the field value is ignored. However, the field value must refer to a system role that does exist on the system, otherwise an error will occur.
[[File:GlobalRoles1.png|thumb|500px|center|Example of a file for uploading users with global/system roles]]

==Upload user process==

# Create file for uploading
# Go to ''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 various settings to better control the desired upload behaviour. These settings are found on the "Upload users preview" page.

'''Warning''': errors updating existing accounts can affect your users badly. '''''Be careful''''' when using the options to update.

====Upload type====
The Upload type specifies how to handle existing accounts.

;Add new only, skip existing users : is the default Moodle upload type. It creates a new user account for each new record in the uploaded file. If an existing username is found in the uploaded file matches an existing username, that record is '''skipped'''. By skipping the existing user account, the data in the existing record is not touched (in contrast to the "Add new and update existing users" option) and a second new user account is '''not''' created (in contrast to the "Add all, append number to usernames if needed" option).

;Add all, append number to usernames if needed : creates a new user account for each record in the uploaded file. If an existing user account is found, a new account will be created with a number appended to the username. For example, if a user account for username 'jsmith' already exists and a new record in the uploaded file contains a record forusername 'jsmith' an additional user account is created with a 1 '''appended''' to the username to produce user 'jsmith1'.

;Add new and update existing users : creates a new user account for each new user in the upload file. If an existing user account with the same username is found, the account information is '''updated''' by the data in the uploaded file.
;Update existing users only : ignores any new users found in the upload file and updates the user account if a matching username record is found in the uploaded file.

====New user password====
When creating a new user account Moodle can create a new password (if one is not provided) or require a password in the uploaded file.

;Create password if needed : creates a default password for the new user account if one is not provided in the uploaded file.

;Field required in file : requires that a password be provided in the uploaded file in order. If a password is not provided, an error is generated and the user account is not created.

====Existing user details====
The Existing user details options are only available when the Upload type allows existing user accounts to be updated. It specifies how Moodle should process user detail information for existing users.

;No changes : ignores user detail data in the uploaded and leaves the existing user account data unchanged.
;Override with file : overwrites data in the existing user account with the data provided in the uploaded file.
;Override with file and defaults : overwrites data in the existing user account with data provided in the uploaded file and fills in the default values for existing user details when no data is provided in the uploaded file.
;Fill in missing from file and defaults : adds data in the existing user account with data provided in the uploaded file if the field is empty (does not already contain data) and fills in the default values for existing user details when no data is provided in the uploaded file.

====Existing user password====
The Existing user password option specifies how to handle password data for existing user accounts when Existing user details is set to overwrite data.
;No changes : ignores password field in the uploaded user file and leaves the existing user account password untouched
;Update : overwrites the existing user account password with the password provided in the uploaded file

====Force password change====
The Force password change option specifies when to tag a user account so that the next login attempt will require the user to change the user's password.

;Users having a weak password : If the user account has a weak password as defined by the site's [[Password_policy#Password_policy|Password policy]] then the user will be forced to change the password during the next login attempt. This option is not shown if there the site does not have a [[Password_policy#Password_policy|Password policy]].
;None : None of the users in the uploaded file will be forced to change the password during the user's next login attempt.
;All : All of the users in the uploaded file will be forced to change the password during the user's next login attempt.

====Allow renames====
If the uploaded file contains the special '''oldusername''' field, it is possible to rename a user from the '''oldusername''' to a new '''username'''. The default setting is to '''not''' allow renames. Keep in mind that renaming a user will require the user to use the new username when logging in.
;No : ignores the '''oldusername''' field and leaves the existing user account's username field unchanged.
;Yes : allows the existing user account's username to be changed by the data provided in the uploaded file's username field. The '''oldusername''' will be searched for and then updated with the data provided in the username column.

====Allow deletes====
If the uploaded file contains the '''deleted''' special field, it is possible to use the upload file to delete existing user accounts. The default setting is to '''not''' allow deletes. Keep in mind that deleting a user account will prevent that user from logging in. As a protection, site administrator user accounts cannot be deleted with this method.
;No : ignores the '''deleted''' special field in the uploaded file and leaves the existing user account unchanged
;Yes : allows the existing user account to be deleted when the value of the of the '''deleted''' field is 1.

====Allow suspending and activating of accounts====
If the uploaded file contains the '''suspended''' special field, it is possible to use the upload file to either suspend or make active (unsuspend) existing user accounts. The default setting is to allow suspending/activating of existing user accounts. Keep in mind that suspending an existing user account will prevent that user from logging in.
;Yes : allows the existing user account to be suspended when the value of the of the '''suspended''' field is 1.
;No : ignores the '''suspended''' special field in the uploaded file and leaves the existing user account status unchanged.

====Prevent email address duplicates====
It is possible, but '''not''' recommended to upload users with duplicate email addresses. By default, uploading users with duplicate email addresses is prevented. To allow duplicate email addresses, go to Site administration ► Plugins ► Authentication ► Manage authentication. You can tick "Allow accounts with same email". Then on the upload users screen you will be allowed to change the "Prevent email address duplicates" setting.

However, doing this is not recommended for file uploads. Test thoroughly any user uploads before implementing.

For more info, see the [[Managing_authentication#Allow_accounts_with_same_email|Managing authentication]] docs page
;Yes : prevents user accounts from being created from the uploaded if an existing user account already has the same email address as found in the uploaded file's '''email''' column.
;No : allows user accounts to be created if an existing user account already has the same email address found in the uploaded file's '''email''' column.

====Standardise usernames====
Standardise usernames is used by default to convert the username to all lower case and to strip out illegal characters. It is possible to not standardise the usernames; however, doing so is '''not''' recommended.
;Yes : standardises usernames found in the uploaded file before updating existing or creating new user accounts so that the username contains only lowercase letters and numbers.
;No : skips standardising usernames found in the uploaded file so that the newly created or updated usernames will be exactly as they are in the uploaded file ('''not recommended''').

For those seeking a more technical explanation, the process for standardising the usernames consists of ensuring the characters are all UTF-8 (fix_utf8) encoded, converting the username to lower case, and then stripping out non-letters/non-number characters (unless ''Site administration > Security > Site policies > Allow extended characters in usernames'' is set on) with something similar to:

<code>$username = preg_replace('/[^-\.@_a-z0-9]/', '', $username);</code>

====Select for bulk user actions====
After the uploaded file has finished being processed (all new accounts have been created and existing accounts updated as specified by the previous settings), there is an option to select some of those user accounts to perform additional [[admin/user/user_bulk|bulk user actions]] such as
*Confirm user accounts created through Email-based self-registration which are not yet confirmed by the user
*Send a message (requires Messaging to be enabled)
*Delete user accounts
*Display a list of users on a page
*Download user data in text, ODS or Excel file format
*Force users to change their passwords
*Add users to a cohort

By default, no users are selected for [[admin/user/user_bulk|bulk user actions]].

;No : No users are selected for [[admin/user/user_bulk|bulk user actions]]
;New users : Only newly created users are selected for [[admin/user/user_bulk|bulk user actions]]
;Updated users : Only updated user accounts are selected for [[admin/user/user_bulk|bulk user actions]]
;All users : All users found (existing updated users and newly created user accounts) in the uploaded file are selected for [[admin/user/user_bulk|bulk user actions]]

===Default values===

You can provide default user values for some fields not included in the uploaded file. Some fields include:
*Email display
*Forum auto-subscribe
*City/town
*ID number
*Institution
*Department

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

==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 '''deleted''' field is present, users with value 1 for it will be deleted. In this case, all the fields may be omitted, except for '''username'''. 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 '''suspended'''. 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:

username,firstname,lastname,deleted
jonest,Tom,Jones,0
reznort,,,1

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

===Field size limits===
Some fields have maximum character lengths, as defined in the database fields. 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. The error will be "User not added - error".

The sizes of some common fields, in number of characters, are currently (3.2):

*username - 100
*password - 255
*idnumber - 255
*firstname - 100
*lastname - 100
*lastnamephonetic - 255
*firstnamephonetic - 255
*middlename - 255
*alternatename - 255
*institution - 255
*department - 255
*address - 255
*city - 120
*icq -15
*skype - 50
*yahoo - 50
*aim - 50
*msn - 50
*phone1 - 20
*phone2 - 20

===All user fields listed here===
:All the user fields that are valid in an upload file are listed below, except for any custom fields you may have created (for which see below.)

<pre>firstname,lastname,username,email,password,auth,idnumber,institution,department,city,country,timezone,lang,mailformat,maildisplay,maildigest,htmleditor,autosubscribe,skype,msn,aim,yahoo,icq,phone1,phone2,address,url,description,descriptionformat,interests,oldusername,deleted,suspended,alternatename,lastnamephonetic,firstnamephonetic,middlename</pre>

The enrolments into courses information are <pre>course1,type1,role1,group1,enrolperiod1,enrolstatus1</pre>
where each enrolment is grouped by number.

===Capabilities===

You may wish to create a limited role to allow some users access to this function. Create a role at the system/site level with the following capabilities allowed:
* moodle/site:uploadusers
* moodle/role:assign

And
* In 'Allow role assignments' tab of this new role, permit it to assign the required roles that it may be uploading, especially Student, but also Teacher, Non-editing Teacher, and any other custom roles you may have created, which will be used in the uploads to assign users to.

In particular, don't forget the moodle/role:assign capability (even if these users have it in the courses they will be enrolling users in - it won't work).

== See also ==
* [[Flat file]] enrolment
* [[User profile fields]] for details of how to include data about custom user profile fields in the upload users file
* [[Upload courses]]

Forum discussions:
*[http://moodle.org/mod/forum/discuss.php?d=97903 Uploading users to custom roles]
*[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]]
[[es:Subir usuarios]]