MoodleDocs - User contributions [en]

Upload cohorts

2017-10-24T06:53:33Z

Marycooch: copied from 3.3 docs

{{Accounts}}
An administrator can upload multiple cohorts from a CSV (comma separated values) formatted text file in ''Administration > Site administration > Users > Accounts > Cohorts > Upload cohorts''. Cohorts can be created in both the system (site-wide) context or in the [[Course_categories|course category context]].

'''Note:''' ''The current cohort upload form only allows you to add new users to an existing cohort and does not allow removal from an existing cohort. See MDL-60563''

==Upload cohort process==
Here is an outline of the process:

# Create cohort file for uploading (CSV text file with a 'name' column and the name of each new cohort on a new line)
# Go to ''Administration > Site administration > Users > Accounts > Cohorts > Upload cohorts'
# Add file to upload
# Upload cohort preview - review settings and check for any errors. If errors are reported with the file, correct as needed.
# Upload cohorts - click "Upload cohorts"
# Upload cohorts results - shows how many cohorts were created
# Upload cohorts results - click "Continue"
# Returns to Upload users screen

===Settings===
====File====
The CSV formatted text file containing cohort data to be uploaded. See the [[cohort/upload#File_format_for_the_upload_cohorts_file|File format for the upload cohorts file]] section for more detailed information about the cohorts upload file.

====CSV delimiter====
The character used as a delimiter between fields in the cohort upload file. The delimiter separates the various fields on a single line. By default, a comma (',') is used as the delimiter; however, other options are available.
; <pre>,</pre> - uses the comma character as the field delimiter
; <pre>;</pre> - uses the semicolon character as the field delimiter
; <pre>:</pre> - uses the colon character as the field delimiter
; <pre>\t</pre> - uses \t (tab) as the field delimiter

====Encoding====
You can specify the character encoding of the upload cohorts file. The default character encoding is UTF-8.
====Default context====
You can specify the default context to use from a list of available contexts. The default context is the System context (i.e. site-wide). A list of course categories will be listed and one of those course categories can be selected as the default context if one is not provided in the upload cohorts file. If the <code>contextid</code> (or one of the available fields to lookup the <code>contextid</code>) is provided, then that value will be used; however, if a contextid is not provided for a particular cohort the default context will be used.

==File format for the upload cohorts file==
The upload cohorts CSV text file has fields separated by a comma (or other delimiter). The first line contains valid field names (preferrably lower case). The rest of the lines (records) contain information about each new cohort.

'':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 spreadsheet program to create the file with the required columns and fields. Then save the file as "CSV (comma delimited)". These files can then be opened with simple text editors for verification.

===Valid upload file for testing===
Here is an example of a simple valid upload cohorts 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)

'''name,idnumber,description'''
Class of 2019,2019,Members of the Class of 2019
Class of 2020,2020,Members of the Class of 2020

===Fields that can be included===

*'''Required fields''':
:<code>name</code> - the name of the cohort to be created

*'''Optional fields''': To provide values other than the default include one or more of the following optional fields:
:<code>contextid</code> - used to specify the context id number of the cohorts you are uploading. For example, the context id number of a particular course category.
:<code>idnumber</code> - used to provide an id number for the cohorts you are uploading
:<code>description</code> - used to provide a description for the cohorts you are uploading
:<code>descriptionformat</code> - used to specify the text format of the description. By default, the descriptionformat is set to the recommended value of 1 (FORMAT_HTML); however, values of 0 (FORMAT_MOODLE) and 2 (FORMAT_PLAIN) are also available. These format values are defined in lib/weblib.php.
:<code>visible</code> - used to specify whether the cohorts you are uploading should be visible (1) or not (0).

*'''Additional fields''' : If needed, there are some additional fields that while not normally used can be utilized. Additional fields typically require looking up information in other tables (such as the course categories or context tables). The additional fields provide an alternative way of finding the course category context id. A bit of extra caution is recommended in using these additional fields. The list of additional fields includes:
:<code>context</code> - used to specify the name of the context name for each of the cohorts you are uploading.
:<code>category</code> - used to specify the name of the category name for each of the cohorts you are uploading. For example, the category name of a particular course category.
:<code>category_id</code> - used to specify the course category id (not idnumber) of the category for each of the cohorts you are uploading. For example, the course category id of a particular course category.
:<code>category_idnumber</code> - used to specify the course category idnumber (not id) of the category for each of the cohorts you are uploading. For example, the course category idnumber of a particular course category.
:<code>category_path</code> - used to specify the course category path of the category for each of the cohorts you are uploading. For example, the course category path of a particular course category.

== See also ==
* [[Cohorts]]
* [[Cohorts#Creating_cohorts_in_bulk|Creating cohorts in bulk]]

[[es:Subir cohortes]]
[[de:Globale Gruppen hochladen]]

Private files

2017-10-04T07:27:48Z

Marycooch: copied from 3.3 docs

{{Repositories}}
==The private files area==
Each user has a private files area for uploading and managing a set of files. If enabled by the administrator, users can also email files to their private files area.

The private files area can be accessed via the Navigation drawer in the [[Boost theme]] or the [[My private files block]]. If the private files repository is enabled by a site admin, it is available as a source within the filepicker when selecting files to use in a course.

==Private files management==

To add a file to your private files area
#If you are using the [[Boost theme]] navigate to the Private files link. Alternatively, navigate to your dashboard and to the Private files block.
#Click the link 'Manage private files'
# The file manager will appear.
# If desired, create a folder for your file(s)
#Click on the Add button to upload from the File picker or drag and drop from your desktop. It will look like the files are already there, but they aren't until you '''do the next step!'''
# Click the 'Save changes' button

[[File:newprivatefiles.png]]

*Once uploaded, files will appear as thumbnails. Clicking the icons top right will display them in table or list view as an alternative.
[[File:uploadedprivatefiles.png]]

==Emailing private files as an attachment==

*This requires the administrator to have enabled incoming mail processing in ''Site administration>Server>[[Incoming mail configuration]]>Mail settings'' and Email to private files in ''Site administration>Server>[[Incoming mail configuration]]>Message handlers.''
*When these settings are enabled, users will see an email address in their private files screen:

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

*This is the email address to which the email including the attached file should be sent. It will appear after cron in the user's private files after cron has run.
*For a demonstration of emailing to private files, [http://youtu.be/3cElj4svlQQ?t=1m8s watch the Usability screencast] from Moodle HQ, starting at 1m8s.

==Making an alias/shortcut to a file in the private files area==

If a file is uploaded into your private files area, it is possible when using it elsewhere on Moodle to select it as an alias/shortcut. This means that if you update the file in your private files area, it will automatically update elsewhere on Moodle.

[[File:privatefilesalias.png]]

See [[Working with files]] for more information.

==Private files size limit==

The size limit for each user's private files area is set by a site administrator in User quota in ''Administration > Site administration > Security > Site policies''.
==Checking space used by Private files==
See the discussion: [https://moodle.org/mod/forum/discuss.php?d=359453&parent=1449745#p1449873 How do you check space used by Private files?] to see how, as an admin, you can see private files usage on your site.

==Preventing access to Private files==
*To prevent all users having access to Private files, the administrator should disable the repository in ''Administration>Site administration>Plugins>Repositories>Manage repositories.'' and in ''Administration>Site administration>Users>Permissions>Define Roles'' edit the authenticated user role and set the capabilities 'moodle/user:manageownfiles' and 'repository/user:view' to prohibit.
*If only students are to be prevented from accessing private files (but teachers etc, allowed) then a new role should be made and assigned system wide. See FAQ 6 in [[Repositories FAQ]] for more information.

==Private files capabilities==

* [[Capabilities/moodle/user:manageownfiles|Manage files in own private file area]]
*[[Capabilities/repository/user:view|View user private files]]

[[es:Archivos privados]]
[[eu:Fitxategi_pribatuak]]
[[fr:Fichiers personnels]]
[[ja:プライベートファイル]]
[[de:Eigene Dateien]]

Video

2017-09-06T13:23:32Z

Marycooch: note about linking files

{{Working with media}}

Video is a very powerful tool to use in a Moodle course, allowing students, for example to catch up on lectures they missed, learn from a "how to" screencast, or improve their language skills by watching native speakers interact.

==Where to host the videos==

If you upload your videos to your Moodle site, storing them on your own server, then you retain ultimate control. If you are worried about multiple copies of the same video taking up lots of space, then that is not a problem; the Moodle file system is clever enough to only store a single copy of a file, no matter how many times you upload it to your server.

When server space or upload limits are restricted, it is convenient to upload videos to an online site like [http://www.youtube.com YouTube] or [http://vimeo.com Vimeo]. They can easily be embedded inside Moodle from such sites and privacy can still be maintained if you choose their private video sharing option.

===Cross domain video hosting===

Flash video players require permission to play videos hosted on a different URL, e.g. yourmoodle.org needs permission to play video files hosted at yourvideo.org. The permission files are stored on the root domain of where the video files are hosted, e.g. yourvideos.org/crossdomain.xml. If yourvideos.org does not have a cross domain policy file that permits yourmoodle.org to play videos, Flash Player will not permit it. Further details are available here [http://code.google.com/p/moodle-mplayer/wiki/CrossDomainSecurity].

Many public video hosting services, such as YouTube.com, already have catch-all cross domain policy files in place and so videos can be played from them via your Moodle without any cross domain security issues arising.

==Ways of displaying video==

===Linking to a video online elsewhere===
*If your video is hosted elsewhere online (such as youtube) you can simply link to the relevant page by choosing [[URL]] from 'Add an activity or resource' and pasting in the relevant link.
*Note that, in an establishment where certain video sharing sites might be banned, your students might not be able to access your video through Moodle.

===Uploading a video for students to download===
*Choose this option if you wish to upload your video to Moodle and give users the option to download it to their own computers.
*Choose ''Add an activity or resource>[[File|File]]''
*Note that the way the video will display depends on the software the user has on their own computer. This could mean that some students might be unable to view your video.

===Embedding a video in its own player===
Moodle uses [[VideoJS player]] as its default player as it is responsive and displays video well across devices and browsers. With the [[Multimedia plugins filter]] enabled, videos may be embedded as follows:

====Using the Moodle media icon====
{{New features}}
''(Note that these instructions are for the [[Atto editor]])''
*With your editing turned on, click into the Atto editor text box where you wish to embed your video.
*Click the Moodle media icon as in the following screenshot:
[[File:Addmedia.png]]
*If your video is online, paste its URL in to the Source URL box.
*If your video is one you want to upload, click the Video tab.
[[File:DocsVideoInsertMedia.png]]
*Click the Browse repositories button to locate and upload your video from the repository where it is stored. (What you see depends on what the admin has enabled.) If you have it in more than one file type (such as .mov and .mp4) then you can upload an alternative video by clicking 'Add alternative source'.
*'''Display options''' allows you to specify a height and width for the video
*'''Advanced settings''' allows you to decide how the video will play
*'''Subtitles and captions''' allows you to add subtitle files (VTT) in different languages and/or caption files, with descriptions, chapters and metadata. Subtitles, captions, chapters and descriptions can be added to videos and audios using WebVTT file format. These files can be created using caption making software or just plain text editor. Find out more about WebVTT format here (https://w3c.github.io/webvtt/) '''NOTE:''' ''The files must be uploaded to Moodle; they will not display if they are linked from elsewhere.''
*Click the Insert media button when you are ready.
*Your video will appear a blue link until you save the changes.

[[File:DocsVideoVideoJS.png]]

====Using a hyperlink====
''(Note: this method has no advantage over using the media icon.)''
*With your editing turned on, click into the Atto editor where you wish to embed your video.
*Type some blank spaces (or some text) and select them.
*Click the hyperlink icon as in the following screenshot.(The icon will only be clickable if you have selected text or spaces)
[[File:Hyperlinkicon.png]]
*Click 'Browse repositories'
*This takes you to the file picker. Follow the instructions for uploading/selecting your video as for using the Moodle media icon.
*When your video is chosen, it will appear in the link URL box as below. Click ''Insert:''
*'''''Don't panic!''''' You will now only get a blue line (if you selected blank spaces) or the actual text underlined in the Atto editor:
[[File:linklinkatto.png]]
*When you click ''save changes'' to return to the main course page, your video will display.

====Using embed code to display external videos====
*Go to your chosen video sharing site and find the embed code of the video you wish to display. Copy this code.
*With your editing turned on, click into the Atto editor where you wish to embed your video.
*Click the HTML code icon as in the following screenshot:
[[File:AttoEmbedCode.png]]
*Paste your embed code into the box:
*Save your changes
*Your video will display embedded in a player. Youtube videos by default play via the [[VideoJS player]].
[[File:VideoJSOfficialMusicVideo.png]]

==See also==
*[[Media FAQ]]
*[[Multimedia plugins filter]]

Forum discussions:
*[http://moodle.org/mod/forum/discuss.php?d=143478 Best video format]
*[https://moodle.org/mod/forum/discuss.php?d=344662 download h5p interactive video in moodle]

[[de:Video]]
[[es:Video]]

Private files block

2017-09-05T10:20:44Z

Marycooch:

{{Blocks}}The private files block enables access to a user's [[Private files|private files]] area.

[[File:PrivateFilesNew.png]]

[[es:Bloque de archivos privados]]
[[eu:Nire_fitxategi_pribatuak_blokea]]
[[de:Meine-Dateien-Block]]
[[fr:Bloc Fichiers personnels]]
[[ja:プライベートファイルブロック]]

File:PrivateFilesNew.png

2017-09-05T10:19:44Z

Marycooch:

Courses block

2017-09-05T10:14:35Z

Marycooch:

{{Blocks}}The '''Courses''' block lists and allows navigation between all of the courses in which the logged in user is enrolled in. The block title shows as "My courses" and allows one-click access to a course's home page.

[[File:CoursesBlockNew.png]]

There is a also the option to list ''All courses...'' available within the Moodle site. This will display a list of course types and a click on one of the types will reveal all the courses in that category. There is also a search all courses option on this page.

A brand new user to a Moodle site, who has not enrolled in any course, will see the block title as "Course Categories".

When a student enters an unassigned course using the course block, they will be asked to enroll.

Note: The [[Navigation block]] also includes a list of all courses a user is enrolled in.

==Site administration settings==

The courses block has some settings which may be changed by an administrator in ''Administration > Site administration > Plugins > Blocks > Course list''.

*''block_course_list_adminview'' - This determines what administrators see in the block.
*''block_course_list_hideallcourseslink'' - This enables you to hide the "All courses" link at the bottom of the block from everyone except administrators.

==See also==

*Using Moodle [http://moodle.org/mod/forum/discuss.php?d=92190 How to make users can only see their own courses?] forum discussion

[[Category:Course]]
[[Category:Site administration]]

[[de:Kurse_%28Block%29]]
[[es:Bloque de cursos]]
[[fr:Bloc Cours]]

Courses block

2017-09-05T10:14:26Z

Marycooch:

{{Blocks}}The '''Courses''' block lists and allows navigation between all of the courses in which the logged in user is enrolled in. The block title shows as "My courses" and allows one-click access to a course's home page.

[[File:CoursesBlockNew.png]

There is a also the option to list ''All courses...'' available within the Moodle site. This will display a list of course types and a click on one of the types will reveal all the courses in that category. There is also a search all courses option on this page.

A brand new user to a Moodle site, who has not enrolled in any course, will see the block title as "Course Categories".

When a student enters an unassigned course using the course block, they will be asked to enroll.

Note: The [[Navigation block]] also includes a list of all courses a user is enrolled in.

==Site administration settings==

The courses block has some settings which may be changed by an administrator in ''Administration > Site administration > Plugins > Blocks > Course list''.

*''block_course_list_adminview'' - This determines what administrators see in the block.
*''block_course_list_hideallcourseslink'' - This enables you to hide the "All courses" link at the bottom of the block from everyone except administrators.

==See also==

*Using Moodle [http://moodle.org/mod/forum/discuss.php?d=92190 How to make users can only see their own courses?] forum discussion

[[Category:Course]]
[[Category:Site administration]]

[[de:Kurse_%28Block%29]]
[[es:Bloque de cursos]]
[[fr:Bloc Cours]]

File:CoursesBlockNew.png

2017-09-05T10:12:42Z

Marycooch:

Course completion status block

2017-09-05T10:10:38Z

Community finder block

2017-09-05T09:49:30Z

Marycooch: removed ref to hubs other than Moodle.net

{{Blocks}}The community finder block enables users to access [http://moodle.net Moodle.net], and search for courses to download or enrol in.

* Downloadable courses may be immediately restored to your Moodle site
* Links to enrollable courses are saved in the community finder block

{|
| [[File:community finder block.png|thumb|Community finder block]]
| [[File:search for community course.png|thumb|Search for community courses]]
|}

==Downloading courses from a hub==

# In the community finder block click Search
# Select [http://moodle.net Moodle.net]
# Select 'Courses I can download' and then click the Search button
# For any courses of interest, click 'Visit demo' then if you're happy with the course, click 'Download'
# The course backup will then be downloaded and saved in your private files. Click Yes to immediately restore the course

==Finding courses to enrol in==

# In the community finder block click Search
# Select a hub, such as [http://moodle.net Moodle.net]
# Select 'Courses I can enrol in' and then click the Search button
# For any courses of interest, click 'Visit site' then if you're happy with the course, click 'Save a link to this course'

The link to the course will then be displayed in the community finder block.

If you wish to remove any saved links, click the X icon after the link.

==Capabilities==

By default, users with the role of manager or teacher can use the community finder block.

The following capabilities control access to the block:
* [[Capabilities/moodle/community:add|moodle/community:add]] - allows a user to use the Community block to search for courses on a hub
* [[Capabilities/moodle/community:download|moodle/community:download]] - allows a user to use the Community block to download courses from a hub

==See also==

* [[Community hub]]
* [[Restoring file aliases]] for details of what happens when restoring a course which has been downloaded from a hub and which contains file aliases

[[Category:Hub]]

[[de:Community-Suche]]
[[fr:Bloc Recherche communauté]]
[[es:Bloque de buscador de comunidad]]

Essay question type

2017-09-05T09:44:24Z

Marycooch: copying from 3.3 docs

{{Questions}}'''Note''': This page is about the essay question type in the [[Quiz]] activity. For information about the essay question type in a Lesson activity, see the documentation [[Building Lesson]].

==About the essay question type==

The essay question type provides the option of answering by uploading one or more files and/or entering text online. (For longer essays, text or file uploads, you may wish to consider using the [[Assignment activity]] rather than this question type.)

Essay questions are created in the same way as other quiz question types. The difference is that essay questions have to be marked manually, and the student will not get a final grade until the teacher has marked their essay.

==Creating an essay question==

*If you haven't yet made a quiz, access the [[Question bank]] from ''Course administration>Question bank'' and click the button 'Create a new question', choosing 'Essay'.
*If you have made a quiz, access the Edit quiz screen and from the ''Add'' drop down, choose 'Add a new question', choosing 'Essay'.
*Give the question a descriptive name - this allows you to identify it in the Question bank.
*Enter the question in the 'Question text' field. This will be the title of and information about the essay you wish them to write.
*Set the 'default mark' and any 'General Feedback' if required. This is text that appears to the student once you have graded their essay.

===Response options===

*'Response format' allows you to choose what is available for the students when typing their essays, for example the regular WYSIWYG editor with or without the option to upload files, or a plain text editor (with no formatting.) ''No inline text'' means they cannot type any text. You cannot select this if you don't allow attachments, as the students will have nothing to submit. If you have programming students, they may require ''plain text with monospaced font'' for their code.
*'Require text' allows you to decide whether or not students must add text into the text editor when they do the question. If you only want them to upload a word-processed file as an essay, then you can set this to 'Text input is optional'. ''(Note that this setting does not force the student to type text into the text editor; they can still leave it blank and continue to another question.)''

[[File:essaytext.png]]

===Response template===

It is possible for a teacher to create a template to scaffold the student's answer in order to give them extra support. The template is then reproduced in the text editor when the student starts to answer the question. See Youtube video [http://youtu.be/BAZa66WvyWQ Essay scaffold with the Moodle quiz] It is also possible to include grading information for teachers marking the essay to refer to as they assess the essays:

{|
| [[File:responsetemplategraderinfo.png|thumb|400px|Response template and grader info set up]]
| [[File:quizessaytemplate.png|thumb|400px|What the student sees]]
|[[File:teacherviewessayq.png|thumb|400px|What the teacher sees]]
|
|}
==Question grading==

The essay question will not be assigned a grade until it has been reviewed by a teacher and manually graded. Until that happens, the student's grade will be 0.

To grade essays answer in quizzes using [[Boost]],click on the quiz and then, from the gear menu, click 'Manual grading'. For other themes, click ''Manual grading' from the Quiz results section of your quiz administration block.

[[File:QuizManualGradingLink.png]]

When manually grading an essay question, the grader is able to enter a custom comment in response to the essay and assign a score for the essay.

==See also==

* [http://moodle.org/mod/forum/discuss.php?d=159689 Grading essay questions] forum discussion

[[ca:Tipus_de_pregunta_de_resposta_oberta]]
[[de:Freitext-Fragen]]
[[es:Tipo de pregunta de ensayo]]
[[fr:Question composition]]
[[ja:作文問題タイプ]]
[[zh:申論題]]

File:QuizManualGradingLink.png

2017-09-05T09:44:14Z

Marycooch:

Main menu block

2017-09-03T15:37:15Z

Marycooch: updated screenshots

{{Blocks}}The main menu block can be added to the front page of the site by a site administrator. Resources and activities can then be added to the front page,( for example to create a side menu for your Moodle site.)

[[Image:MainMenuBoost.png]]

==The main menu block as a side menu==
It is possible to use the main menu block with Moodle pages to create a side menu for your Moodle site, instead of or as well as the custom menu items at the top of your site. Thus you could have pages "About", "Contact" and so on.

#Turn on the editing on the front page
#From the "Add block" link, add the main menu block if it is not already present
#From "Add an activity or resource" choose [[Page]] and add your information.
#Repeat for other pages.

When the editing is turned off the menu block appears as in the screenshot below:
[[File:mainmenuside.png|center]]

''Note:'' If you don't wish to have the pages also appear in the Navigation block then see [[Blocks FAQ]] "How do I get rid of a link Site pages that's appeared in the Navigation block?"

[[de:Hauptmenü (Block)]]
[[es:Bloque de menú principal]]

File:MainMenuBoost.png

2017-09-03T15:36:44Z

Marycooch:

Using Wiki

2017-09-01T17:19:15Z

Marycooch: copied from 33 docs

{{Wiki}}
This section outlines how to use wikis after the teacher has added a wiki acivity. To set up a wiki in your course, see [[Wiki settings]]

== Creating the first page==
*Once the wiki is set up, a user will click the link and reach the following screen:

[[File:newwikipage.png]]

==Adding more pages==
*Type the name of your page inside double brackets. (''1'' in screenshot below) You can preview it by clicking the "preview" button towards the bottom of the screen.
*Press the "save" button.
*Now click the (red) link for one of the pages (''2'' in screenshot below) and you will be prompted to create it in the same way you create the first page:
[[File:newpageswiki.png]]

*A page once created has a blue link.
Note: Non-Boost themes have a '''New''' option from the navigation block for creating new pages, but you will still need to copy and paste the name of the new page onto the immediate parent page and surround it with double brackets. This creates a link to your new page and makes it accessible from the main Wiki page. Otherwise nobody will recognise the so called lost new page.

== Wiki editing in general ==

Depending on the type of the wiki, there are several ways to edit your page.
But don't worry: The best thing of a wiki is, that nothing is lost. The old version will be there - and if someone changes your version of the page - your version will also be there.
Note that the options for editing, commenting viewing history, map and files may all be accessed both from tabs at the top (''1'' in screenshot below) and links in the navigation block (''2'' in screenshot below):

[[File:editingwiki.png]]

==View==
*The '''View''' tab at the top or link in the navigation block allows users to display and view the wiki page.

==Edit==
The '''Edit''' tab at the top or link in the navigation block allows users to edit the wiki page.

==Comments==
*The '''Comments''' tab at the top or link in the navigation block allows users to see and add comments about the wiki.

==History==
*The '''History''' tab at the top or link in the navigation block allows users to see what has been altered in the wiki.
*Compare edits by clicking the "Compare Selected" button.
*Click the "Restore" button of the version you wish to restore if the latest edit is unsuitable:

[[File:comparewiki.png]]

==Map==
*The '''Map''' tab at the top or link in the navigation block allows users to view areas of the wiki such as a list of pages (as in the following screenshot), updated or orphaned pages etc. (Orphaned pages are pages not linked to anywhere.)
*To select what you want to see, click the Map menu dropdown box.

[[File:wikimap.png]]

==Files==
*The '''Files''' tab at the top or link in the navigation block allows users to access any files which have been added to the wiki.

* By default, the Teacher role can add and manage files to the '''Files''' tab, but the Student role can only view them. You could change this though with a permissions override to the '''Manage wiki files''' capability (mod/wiki:managefiles) in any particular wiki.

==Administration==
*The '''Administration''' tab at the top or link in the navigation block is available to editing teachers in the course so they can delete page versions or selected pages. Clicking the "list all" button will list available pages to delete. The first page of the wiki cannot be deleted.

[[File:adminwiki.png]]

==Deleting pages==

Teachers and other users with the'' mod/wiki:managewiki'' capability can delete any page or page version, with the exception of the first page, via the Administration link in the navigation block or the Adminstration tab. See the section '''Administration''' above.

== Markup language ==
You miss all the formatting you know from other moodle activities?
That's because the wiki-type of your wiki is e.g. nwiki. See [[Nwiki markup]]

==Why use a wiki?==

Wikis are a simple, flexible tool for collaboration. They can be used for everything from simple lists of web links to building entire encyclopedias. As an example, [http://www.wikipedia.org| Wikipedia] is the largest wiki in the world.
In your own class it's important to have a plan for your wiki so students know how it fits in with their learning. If it's a individual wiki, will they be graded? Is it simply a staging area for group work that will be submitted as assignments later? Will you let the students be completely responsible for the work? How will you deal with offensive content? The great advantage of a wiki is that all edits are clearly visible and reversible.

==Ideas for using wikis==
===Group lecture notes===
Creating a wiki for group lecture notes after a lecture gives students a chance to combine all their notes. Those that missed information can get it from their peers. The group can also decide what information is critical and give it proper emphasis. Group lecture notes could be done with the entire class, if it is small enough, or with small working groups. Groups can also compare notes for further discussion and refinement.

===Group Project management===
A teacher assigning a group project can give students a place to work by creating a wiki with the group mode enabled. This will give each group their own space to record research, to develop outlines and to create the final product.

===Brainstorming===
Brainstorming is a non-judgmental group creative process in which group members are encouraged to give voice to any ideas they personally consider relevant to the group exercise. In a face-to-face meeting, a brainstorming facilitator will usually stand in front of a big piece of paper and elicit ideas from the participants in the room. A teacher can create an online version of this process by setting up a wiki for the entire class or for smaller student groups and asking people to submit ideas around a brainstorming topic. People can add ideas as they occur and link to other pages for elaboration.

===Contribute to other wikis===
A teacher might assign his or her class the task of contributing to [http://en.wikipedia.org Wikipedia], [http://en.wikiversity.org Wikiversity], or to another wiki on the Web, on any class topic, perhaps by assigning students to groups (or making it a class project if the class is small enough and the topic broad enough) and challenging them to collaboratively create an article they would feel confident posting to a public-information space. Students will use the course wiki to create drafts of the article they will eventually publish to the community at the end of the semester.
===Collaborative story-telling===
Younger students could be encourage to work together on a wiki to build up a story -each adding a sentence following on from the previous contribution.

== See also ==

*Using Moodle [http://moodle.org/mod/forum/view.php?f=366 Wiki module forum]
*[[Creole format]]

[[fr:Afficher un wiki]]
[[de:Wiki ansehen]]
[[es:Uso de Wiki]]
[[ja:Wikiを閲覧する]]

Learning plans

2017-08-31T09:10:56Z

Marycooch: updated screenshots

{{Competencies}}
== Setting up a learning plan template ==

*Once a [[Competency frameworks|Competency framework]] has been set up, you can then create a learning plan template. A learning plan template defines a set of competencies which you can assign to a group of users. This is better than creating individual learning plans for many different students and means you only need update the template and the changes will appear for all students.
*Go to ''Site administration > Competencies > Learning plan templates.'' Any existing plans are displayed here, and you can click the button 'Add new learning plan template' to create a new one.

===Adding competencies to a learning plan template===

To add competencies to a template, click the learning plan's name (under the left-hand Name column) to go to the page where you can add, edit and remove competencies. It will also show which competencies are not assigned to any course.

Once you have added competencies to the template, you can assign it to individual students, or to an entire cohort of students as described below.

==Assigning learning plans to users or cohorts==
*Once a learning plan template has been created, it may be assigned to students individually or in bulk to a (pre-made) cohort.
*If you're not already there, navigate to Site administration > Competencies > Learning plan templates.
*On the row for the template you wish to assign, click the "Edit" icon. A dropdown menu will appear showing:
** Edit
** Duplicate
** Create learning plans
** Add cohorts to sync
** Delete
*'''To assign a learning plan to a cohort,''' click 'Add cohorts to sync'
{{Note|Moodle will only create 50 learning plans immediately. If you have a very large cohort, a scheduled task will create the learning plans. See MDL-52690.'''}}

[[File:learningplantemplatescohort.png]]
*Search for and add your chosen cohort(s)

[[File:cohortlp2.png]]
*A message will appear with the number of learning plans created.

[[File:cohortlp3.png]]

*To assign a learning plan to an individual student, click 'Create learning plan'

[[File:learningplantemplatescohortindividual.png]]

*Then search for and select the student(s) you wish to make the learning plans for:

[[File:createlearningplansindividual.png]]

== Viewing learning plans ==

Anyone can see their own learning plans from their profile page, accessed from the user menu:

[[File:studentlearningplanaccess.png|thumb|600px|center|Learning plans in profile]]
When a student clicks the link they see which plans have been applied to them:

[[File:studentlp2.png|thumb|600px|center|Student view of assigned learning plans]]
When a student clicks the name of a learning plan, they see the associated competencies. They can see their progress towards completion and also click 'Edit' to request a review of any competency:

[[File:lp3.png|thumb|600px|center|List of competencies and requesting a review]]

*Some users (e.g. supervisors) with the [[Capabilities/moodle/competency:planview|capability to view all learning plans]] in the user context will be able to see the learning plans of other users.
*Users with the [[Capabilities/moodle/competency:planviewowndraft|capability to view their own draft learning plans]] have the ability to create a draft learning plan for themselves. A draft learning plan can be sent for approval to create an active learning plan from the draft. Note that this capability is not set for any of the default roles.
*Users with the [[Capabilities/moodle/competency:planmanagedraft|capability to manage draft learning plans]] can approve a draft learning plan.

== Evidence of prior learning ==

Anyone with the [[Capabilities/moodle/competency:userevidencemanageown|capability to manage their own evidence]] can provide a list of evidence of prior learning. This can be used to demonstrate proficiency for one or more competencies.

To upload evidence of prior learning, access your own learning plans page from your profile and click on the "Evidence of prior learning" link (1) On the next page, click on the "Add new evidence" button (2) and provide as much detail about the evidence as possible (including files and urls to verify the evidence). Once the evidence is listed, you can link it to one or more competencies from any of your learning plans. Then you can request that someone reviews your competency to decide if the evidence is sufficient and rate the competency.

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

==See also==

* [[Learning plan viewer|Learning plan viewer role]] - for enabling course teachers to view their students' learning plans
* [[Learning plan supervisor|Learning plan supervisor role]] - for enabling course teachers to create, manage and view learning plans for their students
* The [https://moodle.org/plugins/report_lpmonitoring Monitoring of Learning Plans] additional report at the Moodle plugins database. The main goal of this plugin is to facilitate the work of learning plan managers.

[[es:Planes de aprendizaje]]
[[fr:Plans de formation]]
[[de:Lernpläne]]

File:learningplantemplatescohortindividual.png

2017-08-31T09:07:55Z

Marycooch:

File:learningplantemplatescohort.png

2017-08-31T09:07:36Z

Marycooch:

2017-08-01T16:46:06Z

Marycooch: MDL-37669

{{Forum}}
This page contains extra information for students and teachers about using the forum activity.

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

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

* Dashboard
* Course page
* Within the forum itself
* In forum discussion threads
{|
|[[File:forumtracking2.png|thumb|447px|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.

====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 administration > Security > [[Site policies]]'. 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===
{{New features}}

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.

*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)
(WIP)

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

File:forumnotificationsread.png

2017-08-01T16:45:40Z

Marycooch:

Self enrolment

2017-07-31T17:00:08Z

Marycooch: MDL-29110

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

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

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

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

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

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

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

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

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

===Setting the enrolment period===

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

=== Enrolment duration===

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

You can also add other placeholders to your custom message:
User email {$a->email}
User fullname {$a->fullname}

The welcome message may be sent from the course contact, the keyholder or from the default no-reply address. If the course contact is chosen, then this is the first teacher to be added to the course (if there is more than one teacher.)

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

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

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

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

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

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

==Self enrolment capabilities==

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

[[de:Selbsteinschreibung]]
[[es:Auto inscripción]]

Short-Answer question type

2017-07-31T09:44:46Z

Marycooch: from UX-47

{{Questions}}
In a short answer question, the student types in a word or phrase in response to a question (that may include a image). Answers may or may not be case sensitive. The answer could be a word or a phrase, but it must match one of your acceptable answers exactly. It's a good idea to keep the required answer as short as possible to avoid missing a correct answer that's phrased differently.

The [[Quiz]] and [[Lesson module|Lesson]] modules both have short answer question types. The analysis of the question given below works for both modules. However there is another analysis type available for Lesson which is not available in a Quiz (see note below).

==Question set-up==
#Select the question category
#Give your question a descriptive name.
#Create the question text. If you're using the HTML Editor, you can format the question just like a word processing document.
#*Tip: if the answer is intended to fill a gap in the text, use underscores (5 or more) to indicate where the gap is.
#Select an image to display if you want to add a picture to the question (see step 4 in [[Multiple Choice question type]] for more detail).
# Set the 'default question grade' (i.e. the maximum number of marks for this question).
# Set the 'Penalty factor' (see [[Short-Answer_question_type#Penalty_factor|Penalty factor]] below).
# If you wish, add general feedback. This is text that appears to the student after he/she has answered the question.
#Choose whether the answers are case-sensitive. Case sensitivity can be tricky where capitalization is important. Will you accept '' Ban Ki-moon'' as well as ''ban ki-moon'' as an answer?
#Next, fill in the answers you will accept. You could give common misspellings partial credit with this option. For example will you accept "Ban Ki moon"? Use [[Short-Answer_question_type#Wildcard_usage|wildcards]] to allow for variants on a word pr phrase.
#Add grade for each answer.
#Create feedback for any and all answers. This will appear if the student enters that answer.
#*'''Note:''' It is good practice to add a single wild card * for the last answer, so you can create a feedback response and a score for all other answers students might have.
#Click Save Changes to add the question to the category.

=== Penalty factor ===

The 'penalty factor' only applies when the question is used in a quiz using adaptive mode - i.e. where the student is allowed multiple attempts at a question even within the same attempt at the quiz. If the penalty factor is more than 0, then the student will lose that proportion of the '''maximum''' grade upon each successive attempt. For example, if the default question grade is 10, and the penalty factor is 0.2, then each successive attempt after the first one will incur a penalty of 0.2 x 10 = 2 points.

==Wildcard usage==

You can use the asterisk character (*) as a wildcard to match any series of characters. For example, use <code>ran*ing</code> to match any word or phrase starting with ''ran'' and ending with ''ing''. If you really do want to match an asterisk then use a backslash like this: <code>\*</code>

If you want one question with the two answers ''fuel'' and ''oxygen'', you ought to be able to limit the number of variants by writing <code>fuel*oxygen</code>. This would accept ''"fuel oxygen", "fuel, oxygen", "fuel; oxygen", "fuel and oxygen", "fuel & oxygen" "fuel oxygen", "fuel und oxygen" "fuel&&oxygen"''. It would even accept ''"fuel or oxygen", "fuel but not oxygen" "fuel|oxygen"'' which might not be so good but you can never be completely safe!

Here are some answers and scores for a question "What does a rocket burn?". 
#<code>oxygen*fuel</code> with a score 100% 
#<code>*fuel*</code> with a score 50% 
#<code>*oxygen*</code> with a score 50% 
#<code>*air*</code> with a score 40% 
#<code>* </code> with a score of 0% 

The order of the answers is important. The answers are evaluated from 1st to last. When a match is found the process stops. If no match is found the question is scored wrong and the general response is used. It is a good practice to put a wild card as the last answer so the evaluation process knows what to do when nothing above it matches.

Without wildcards, the answers are compared exactly, so be careful with your spelling!

==Feedback for wrong answers==

When you wish to have short answer type questions, you naturally have a limited number of variations that would be acceptable. So in case you wish to give a feedback in case of a wrong answer, you must spell out the right answers exactly and then use * as a final answer which will have grade as zero, and feedback will be the one for wrong answer.

Effectively, ANYTHING other than the specific answers mentioned by you will be treated as this option due to wildcard and will be deemed wrong; it'll give 0 marks and show the feedback for a wrong answer.

Here is an example:

What is a rabbit?

answer1: animal 
feedback: right 
grade: 100%

answer2: mammal 
feedback: right 
grade: 100%

answer3: vertebrate 
feedback: right 
grade: 100%

answer4: * 
feedback: ouch! that was wrong 
grade: none

Remember: you cannot do negative marking in this type and ANYTHING other than your right answer will be treated as option 4 due to the wildcard and given that feedback and zero marks.

==Tip: Prototype your questions==
You may like to prototype your short answer questions to catch common acceptable answers you hadn't thought of. Start out by creating a few acceptable answers, then include the question in a quiz for no points. Be sure to tell students you are testing a new question. Once the quiz is over, review students' answers and add their acceptable answers to the list.

==Lesson module note==

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

==See also==
* [[MP3_player#Inserting_sounds_into_questions|Adding sound to a question]]
* [[Pattern-match question type]]. A very ingenious question type from the Open University to automatically mark free text questions without error.

[[Category:Quiz]]

[[fr:Question à réponse courte]]
[[ca:Tipus_de_pregunta_de_resposta_breu]]
[[ja:記述問題タイプ]]
[[de:Kurzantwort-Fragen]]
[[es:Tipo de Pregunta de Respuesta corta]]

Groups

2017-07-03T15:49:40Z

Marycooch: Mark Glynn 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.
*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

:When selecting '''Members per group''' the '''Prevent last small group''' will allocate additional members to an existing group rather then create a new group with fewer members than x. This setting is found by clicking on the Show More link.

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

===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, [[Conditional activities]] 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]]
* [http://youtu.be/amyQjAESkZM Moodle Forum Types and Group Mode] MoodleBites video on YouTube

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

Quiz FAQ

2017-06-27T17:03:30Z

Marycooch: copied from 33 docs

{{Quiz}}
==General==

===How can I try a quiz before it is released?===

You have prepared a quiz exam for your students. It is currently in a hidden state. The exam opens on the day of the exam, at a time that the students know about. However, to satisfy yourself that it is doable in the time allotted, You wish to do a dry run yourself before that date. How can You accomplish this?

Method 1: Use the Preview feature available to you as a teacher as you are making the quiz.

Method 2:

# Make a dummy account with a name like "Test Student".
# Enrol that user in the course as a student.
# Add a "User override" to the quiz, so "Test Student" can attempt the quiz before it is open to everyone else.
# Log in as "Test student".
# Attempt the quiz.
# Log back in as teacher.
# Review the attempt.
# Go to Results -> Grades and delete the test attempt.
# Un-enrol "Test Student" from your course.

Method 3: Set up a Moodle Playground course for your teachers. Add teachers with dual role (teacher and student). Teachers can later copy the quiz/assignment/whatever over to their live class.

===How can I enable notification of quiz submissions?===

See [[Quiz submission notification]].

===How do I send a bulk message to all students who haven't completed a quiz?===
*From your navigation block, click ''Reports>Course participation''
*From the drop down, choose your quiz.
*In ''Show only'', choose "Student" and in ''Actions'', choose "post"
*In the list that appears, tick/check the boxes next to those you wish to message.
*In the bottom dropdown ''With selected users'', choose "send message"

[[File:quizemail.png]]

===How can build a quiz that picks X questions randomly from a larger question bank?===
See the section on adding random questions in [[Building Quiz]].

===How can I print a copy of a quiz?===

Use your browser printer option (for example by right-clicking and selecting Print) When a student prints their finished quiz, responses and feedback will also be printed.

[[File:browserquizprint29.png|thumb|center|400px|Print preview of finished quiz - Click to enlarge]]

You can also export the question as Moodle XML, or GIFT format. If you open either of those files in a text-editor, you should be able to see most of the details of each question.

=== How can I optimize a Moodle server for performing more concurrent quizzes? ===

See [[Performance recommendations]].

==Setup==

===Why am I no longer allowed to add or remove questions?===
Most likely it is because you have students that have already attempted the quiz. You will need to delete all of the attempts by selecting them and choosing to delete them if you need to add/remove questions from a quiz.

If you are developing a new quiz where the attempts have just been trials then deleting the previous attempts will have no consequences in the grade book.

There are several ways of getting to the “attempts #” which you need to click on to delete the previous attempts. Use which ever works for you.
#Click on the quiz that you want to amend. It will take you to a page with “attempts #" at the top.
#If you are on a page with this message “You cannot add or remove questions because the quiz has been attempted (attempts #)” Click on "attempts #".
#If you have navigated away from the page with the message go to the Settings block > Quiz Administration > Edit Quiz.
Whichever way you find “attempts #” click on it and you will go to a page with a drop down menu at the top. Select “all users who have attempted the quiz”. There are several other click boxes select whatever applies to your situation.
Click “Show Report” and then “select all”. Click “Delete selected attempts” and confirm selection.

Go back to Quiz Administration > Edit Quiz and you will now be able to add or delete questions.

===How can I remove a problem question after the quiz has been taken?===

You can not remove a question once a quiz has been taken by one student or more. However you can change the score and flag the question so you know it has problems.

Set the score for that question to 0.
*Caution: In some versions of Moodle if you use this question in an other quiz, this will potentially change the question in that quiz as well. A trick is to score the question as 0, then regrade the just completed quiz. This will establish the new grade for gradebook. Now go back and change the score to the original value.

Find the question in Question Bank. Maybe edit the title (e.g. 'Do not use in Bio101'). Or if you do not share the question category with other teachers, create a sub category, move the offending question there, and perhaps create a better question to replace the one you just moved. Create a new quiz and if necessary hide the old one.
*Caution: if other departments or teachers use a question category it might be wise to check with the team before moving or changing any question. This is one reason importing questions in a course is a good best practice in some situations.

===How can I turn off glossary auto-linking in a quiz? ===
*In the Quiz administration settings block there will be a link "filter".
*Click the link and you will have the option to disable filters just for that particular quiz:

==Attempts==

===How can I give particular students extra time or numbers of attempts?===
*In the Quiz administration there is a link "User overrides"
*Click this link and you will be able to choose one or more users and change quiz dates, times or number of attempts.

[[File:quizuseroverride.png]]

===Can I have different start times/timings/numbers of attempts for different groups?===
*In the Quiz administration settings block, there is a link "group overrides" that allows you to do things like grant extensions to certain groups of students.
*Click this link and you will be able to select your groups and change the quiz dates, times and number of attempts:

[[File:quizgroupoverride.png]]

===What happens if students submit answers after the quiz closing date?===
It is possible for students to still submit answers after the quiz has closed (for example if they started the attempt before the closing date but then took a long time before submitting). These responses are stored by the quiz module, but the students are not given any credit for them. The teacher can see these answers when reviewing the student's attempts and can give the student credit for them by manually entering a grade in the gradebook. Also the teacher could change the closing date after the fact and regrade the attempts. The students' answers would then get graded.

===How can a "Never submitted quiz" attempt be submitted?===
Currently there is no way to retrieve an attempt that was "Never Submitted", and get it back into the "In progress" state. Perhaps the best solution is to plan ahead and set your quiz to set your quiz to be submitted automatically. Alternatively, you can
# Update the quiz : set the "close the quiz" date after today
# Set "When time expires" to "There is a grace period ..."
#Under Grade set "Attempts allowed" to "unlimited"
#Question behavior: Each attempt builds on the last "Yes"
# Invite the students who did not close their exams
# Allow them to start a new attempt, and close it immediately.

===Why can't people (guests) attempt a quiz without creating an account and logging in?===

This is difficult to implement for technical reasons.

To explain: The quiz has to link all information about an attempt to a particular 'user' record in the database, and each user can only have one open quiz attempt at a time. All not-logged-in users share the same 'guest' user database record. Therefore, two guests could not attempt the quiz at the same time, and even if they could, it would be difficult to prevent one guest seeing another guest's attempts.

Of course, given enough work, it would be possible to change some of those assumptions, and so make it possible for guests to attempt quizzes. Indeed, some of the obstructions to implementing this have already been removed while doing other work on the quiz, but there is still some way to go. If you would like to see this implemented, please vote for MDL-17892.

A workaround is to create a visitor account, say with username = guest, password = visitor, for everyone to share.

===How can I prevent a student from reviewing or jumping around questions in a quiz?===
You can block the quiz navigation block and the summary of quiz page with CSS code in a theme. However, if a student fails to answer a question, they will not know if you implement this "solution". Also if others on the site do not want this patch, make sure the theme you select for the course is not used by others.

For example using the Afterburner theme, enter this in the CSS code area:

:div#mod_quiz_navblock {visibility:hidden;}
:table.quizsummaryofattempt {visibility:hidden;}

There are other CSS solutions.

===How can I force my students to answer all the question in a quiz before they submit?===

There are various ways to answer this:
# You can't.
# Your students are not stupid. They know they will get zero marks for any question they do not answer, so they already have a strong incentive to answer every question. Furthermore, at the end of the quiz there is the summary page where they can easily check that they have answered all the questions before they submit, so they won't accidentally miss questions.
# OK, so you want us to write code that won't let students submit before they have answered each question. Well, all that does is forces the student to put random junk like "asdf" into each question before they click the button, or randomly make a choice in each multiple choice question. There is no educational benefit in this. You get more meaningful information if students leave those questions blank rather than putting in random responses.

==Grades==

===Why is my quiz not displaying in the gradebook?===

Check that you have a maximum score that is more than 0 - if your score is 0, then the quiz will not appear in the gradebook.

===I've entered quiz grades manually in the gradebook. How can I allow students to improve on these grades?===

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

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

===How can I set a grade to pass?===

See the section 'Setting a grade to pass for a quiz' in [[Activity completion settings]] for details.

===How can I have a quiz that is not graded?===
On the Edit quiz page, change the total score and each question's score to 0 instead of the defaults of 10 and 1 per question:
[[File:quizscore0.png]]

==Appearance==

===How can I turn off question flagging?===
By default, flags are available in quiz questions.

[[File:flag.png]]

There is a capability attached to this: [[Capabilities/moodle/question:flag]]. Remove this capability from roles that you don't want to see the flags. You can either do that by editing the role definitions globally, or by overriding the permissions in just one quiz or course.

===How can I hide the number of marks available for each question?===

This is not really possible unless you are prepared to edit the code.

If you have a custom theme, you can add CSS like this:
<code css>
.que .info .grade { display: none; }
</code>
or you could try to make it more specific, and only hide the grade before the question is answered:
<code css>
.que.answersaved .info .grade,
.que.invalidanswer .info .grade,
.que.notyetanswered .info .grade { display: none; }
</code>
You can also add this CSS using the [[Header_and_footer|Additional HTML admin setting]].

Alternatively, you can alter the PHP code here: https://github.com/moodle/moodle/blob/4de51c25ae227a727dcba7c39f6f644a5d47ce7a/mod/quiz/locallib.php#L1820. Change that line to give the behaviour you want, e.g.
<code php>
$options->marks = self::extract($quiz->reviewmarks, $when,
self::MARK_AND_MAX, self::HIDDEN);
</code>

Be warned that any of these approaches will affect every quiz in the Moodle site.

==Errors==

===I obtain the error 'The number of random questions required is more than are still available in the category!'===

Review your quiz and verify Moodle has enough questions from each category of questions it will be pulling from. You may have inadvertently selected more questions than what exists in the category. Also make sure you're not pulling questions from a category that has zero questions. Because you are picking random questions, rather than a specific question, it may not be apparent at first that you have run out of questions to ask!

==Quiz plugins==

There are a number of ways to extend quizzes, such as adding new reports and questions types. See [https://moodle.org/plugins/browse.php?list=category&id=28 Moodle plugins directory: Plugin type: Quiz].

==See also==

* [[Effective quiz practices]]
* [[Questions FAQ]]

==Any further questions?==

Please post in the [https://moodle.org/mod/forum/view.php?id=737 Quiz forum] on moodle.org.

[[Category:FAQ]]

[[de:Test FAQ]]
[[es:Examen FAQ]]

File:quizscore0.png

2017-06-27T17:03:09Z

Marycooch:

Private files

2017-06-23T16:13:45Z

Marycooch: /* The private files area */

{{Repositories}}
==The private files area==
Each user has a private files area for uploading and managing a set of files. If enabled by the administrator, users can also email files to their private files area.

The private files area can be accessed via the Navigation drawer in the [[Boost theme]] or the [[My private files block]]. If the private files repository is enabled by a site admin, it is available as a source within the filepicker when selecting files to use in a course.

==Private files management==

To add a file to your private files area
#If you are using the [[Boost theme]] navigate to the Private files link. Alternatively, navigate to your dashboard and to the Private files block.
#Click the link 'Manage private files'
# The file manager will appear.
# If desired, create a folder for your file(s)
#Click on the Add button to upload from the File picker or drag and drop from your desktop. It will look like the files are already there, but they aren't until you '''do the next step!'''
# Click the 'Save changes' button

[[File:newprivatefiles.png]]

*Once uploaded, files will appear as thumbnails. Clicking the icons top right will display them in table or list view as an alternative.
[[File:uploadedprivatefiles.png]]

==Emailing private files as an attachment==

*This requires the administrator to have enabled incoming mail processing in ''Site administration>Server>[[Incoming mail configuration]]>Mail settings'' and Email to private files in ''Site administration>Server>[[Incoming mail configuration]]>Message handlers.''
*When these settings are enabled, users will see an email address in their private files screen:

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

*This is the email address to which the email including the attached file should be sent. It will appear after cron in the user's private files after cron has run.
*For a demonstration of emailing to private files, [http://youtu.be/3cElj4svlQQ?t=1m8s watch the Usability screencast] from Moodle HQ, starting at 1m8s.

==Making an alias/shortcut to a file in the private files area==

If a file is uploaded into your private files area, it is possible when using it elsewhere on Moodle to select it as an alias/shortcut. This means that if you update the file in your private files area, it will automatically update elsewhere on Moodle.

[[File:privatefilesalias.png]]

See [[Working with files]] for more information.

==Private files size limit==

The size limit for each user's private files area is set by a site administrator in User quota in ''Administration > Site administration > Security > Site policies''.

==Preventing access to Private files==
*To prevent all users having access to Private files, the administrator should disable the repository in ''Administration>Site administration>Plugins>Repositories>Manage repositories.'' and in ''Administration>Site administration>Users>Permissions>Define Roles'' edit the authenticated user role and set the capabilities 'moodle/user:manageownfiles' and 'repository/user:view' to prohibit.
*If only students are to be prevented from accessing private files (but teachers etc, allowed) then a new role should be made and assigned system wide. See FAQ 6 in [[Repositories FAQ]] for more information.

==Private files capabilities==

* [[Capabilities/moodle/user:manageownfiles|Manage files in own private file area]]
*[[Capabilities/repository/user:view|View user private files]]

[[es:Archivos privados]]
[[eu:Fitxategi_pribatuak]]
[[fr:Fichiers personnels]]
[[ja:プライベートファイル]]
[[de:Eigene Dateien]]

Private files

2017-06-23T16:12:01Z

Marycooch: private files in Boost

{{Repositories}}
==The private files area==
Each user has a private files area for uploading and managing a set of files. If enabled by the administrator, users can also email files to their private files area.

The private files area can be accessed via the dashboard or the [[My private files block]]. If the private files repository is enabled by a site admin, it is available as a source within the filepicker when selecting files to use in a course.

==Private files management==

To add a file to your private files area
#If you are using the [[Boost theme]] navigate to the Private files link. Alternatively, navigate to your dashboard and to the Private files block.
#Click the link 'Manage private files'
# The file manager will appear.
# If desired, create a folder for your file(s)
#Click on the Add button to upload from the File picker or drag and drop from your desktop. It will look like the files are already there, but they aren't until you '''do the next step!'''
# Click the 'Save changes' button

[[File:newprivatefiles.png]]

*Once uploaded, files will appear as thumbnails. Clicking the icons top right will display them in table or list view as an alternative.
[[File:uploadedprivatefiles.png]]

==Emailing private files as an attachment==

*This requires the administrator to have enabled incoming mail processing in ''Site administration>Server>[[Incoming mail configuration]]>Mail settings'' and Email to private files in ''Site administration>Server>[[Incoming mail configuration]]>Message handlers.''
*When these settings are enabled, users will see an email address in their private files screen:

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

*This is the email address to which the email including the attached file should be sent. It will appear after cron in the user's private files after cron has run.
*For a demonstration of emailing to private files, [http://youtu.be/3cElj4svlQQ?t=1m8s watch the Usability screencast] from Moodle HQ, starting at 1m8s.

==Making an alias/shortcut to a file in the private files area==

If a file is uploaded into your private files area, it is possible when using it elsewhere on Moodle to select it as an alias/shortcut. This means that if you update the file in your private files area, it will automatically update elsewhere on Moodle.

[[File:privatefilesalias.png]]

See [[Working with files]] for more information.

==Private files size limit==

The size limit for each user's private files area is set by a site administrator in User quota in ''Administration > Site administration > Security > Site policies''.

==Preventing access to Private files==
*To prevent all users having access to Private files, the administrator should disable the repository in ''Administration>Site administration>Plugins>Repositories>Manage repositories.'' and in ''Administration>Site administration>Users>Permissions>Define Roles'' edit the authenticated user role and set the capabilities 'moodle/user:manageownfiles' and 'repository/user:view' to prohibit.
*If only students are to be prevented from accessing private files (but teachers etc, allowed) then a new role should be made and assigned system wide. See FAQ 6 in [[Repositories FAQ]] for more information.

==Private files capabilities==

* [[Capabilities/moodle/user:manageownfiles|Manage files in own private file area]]
*[[Capabilities/repository/user:view|View user private files]]

[[es:Archivos privados]]
[[eu:Fitxategi_pribatuak]]
[[fr:Fichiers personnels]]
[[ja:プライベートファイル]]
[[de:Eigene Dateien]]

Upload courses

2017-06-20T12:36:51Z

Marycooch: enrolment method names examples

{{Courses}}
{{Note|This page is about creating courses with a text (.csv) file. If you want to upload a course backup in .mbz or .tgz format, see [[Course restore]].}}

==Upload courses==

In addition to creating new courses, the upload courses functionality may also be used to update or delete courses, or import content from another course. For information on using this functionality to create course templates, see [[Adding a new course]].

To upload one or more courses

# Go to ''Administration > Site administration > Courses > Upload courses''
# Either drag and drop the CSV file or click the 'Choose a file' button and select the file in the file picker
# Select appropriate import options carefully, then click the preview button.

{|
|[[File:26uploadcourses.png|250px|thumb|Upload courses admin screen]]
|
|[[File:uploadcoursesresults.png|250px|thumb|Courses successfully uploaded]]
|}

Note: It is also possible to use the command-line tool ''admin/tool/uploadcourse/cli/uploadcourse.php''.

When using the web interface, use the ''Preview'' option to see if any errors were detected in the previewed rows. If you proceed with the upload and there were something wrong detected with a course, it will be ignored.

=== Short file example ===
uploadcourse.csv:

Note: shortname, fullname, and category are required.

The category field takes the id of the category, with the default category Miscellaneous having id 1. Categories must already exist. If you put a category id that does not exist, you will receive a "Could not resolve category by ID" error during upload preview, and courses in that category will not be created.

<code bash>
shortname,fullname,category,summary,enrolment_1,enrolment_1_role,enrolment_1_enrolperiod,role_student
courserestored,Course restored,1,a summary,manual,student,1 month,
courserestored2,Course restored 2,1,a summary,,,,
courserestored3,Course restored 3,1,a summary,,,,padawan
courserestored4,Course restored 4,1,"a summary, with comma",manual,student,1 month,padawan
</code>
Notice there are no spaces between the items.

==Creating the text file==

The text file to upload courses must be a CSV file. It accepts the following columns which are divided in two categories, the course information, and the course actions.

===Course information fields===

Most of those settings are available on the settings page of a course. Please refer to [[Course settings]] for more information. Field names must be lower-case.

;shortname
: The shortname
;fullname
: The full name
;idnumber
: The ID number
;category
: The ID of the category to place the course in. This takes precedence over ''category_idnumber'' and ''category_path''.
;category_idnumber
: The ID number of the category to place the course in. This takes precedence over ''category_path''.
;category_path
: The path of the category to place the course in. If you want to place the course in a category named "Science-Fiction" which is located under the category "Movies", the value to provide is: <code>Movies / Science-Fiction</code>. Note that the separator must be <code>[space]/[space]</code>. Also note that the category MUST exist, it will not be created. If you want to place the course in the top-level category "Movies", the value to provide is: <code>Movies</code>
;visible
: 1 if the course is visible, 0 if hidden
;startdate
: The time at which the course starts. Please note that this value is passed to the PHP function [http://php.net/manual/en/function.strtotime.php strtotime] to generate a timestamp. Example 01.12.2014 (1st December 2014)
;enddate
: The time at which the course ends. Please note same as with startdate that this value is passed to the PHP function [http://php.net/manual/en/function.strtotime.php strtotime] to generate a timestamp. Example 01.12.2014 (1st December 2014)
;summary
: The summary of the course
;format
: The course format to use, this must be a valid course format plugin name. E.g. ''weeks'', ''topics''.
;theme
: The theme to use
;lang
: The language to use
;newsitems
: The number of news items
;showgrades
: 1 to show the gradebook to students, 0 to hide it.
;showreports
: 1 to show the activity reports, 0 to hide it.
;legacyfiles
: 1 to enable the legacy course files, 0 not to.
;maxbytes
: The maximum upload size of the course in bytes. Use 0 for the site limit.
;groupmode
: 0 for ''No groups'', 1 for ''Separate groups'' and 2 for ''Visible groups''.
;groupmodeforce
: 1 to force the group mode, otherwise enter 0.
;enablecompletion
: 1 to enable the activity completion, 0 not to.

====Enrolment fields====

Some fields can be constructed to enable and configure enrolment methods. The fields must be named ''enrolment_[number]'' for the enrolment method name, and ''enrolment_[number]_property'' for its properties.

;enrolment_[number]
: The name of the enrolment method (eg manual, guest, self)
;enrolment_[number]_delete
: 1 to delete this enrolment method from the course, if set to 1 all the other properties will be ignored.
;enrolment_[number]_disable
: 1 to disable this enrolment method from the course, if set to 1 all the other properties will be ignored.
;enrolment_[number]_startdate
: The enrolment start date. This value is passed to the PHP function strtotime().
;enrolment_[number]_enddate
: The enrolment end date. This value is passed to the PHP function strtotime().
;enrolment_[number]_enrolperiod
: Number of seconds, or if not a value understood by strtotime() such as "4 days".
;enrolment_[number]_role
: The role short name
;enrolment_[number]_[property]
: Where property is understood by the specified enrolment method
;enrolment_[number]_password
: The course enrolment key

Note: Upload courses is not yet compatible with all [[Enrolments|enrolment methods]] (MDL-43127).

'''Example'''

enrolment_1: manual
enrolment_1_role: student
enrolment_1_enrolperiod: 1 month

enrolment_2: self
enrolment_2_startdate: 2013-01-30

====Role renaming====

To rename some roles, using the following pattern:

;role_[shortname]
: The new name of the role ''[shortname]''.

'''Example'''

role_student: Apprentice
role_teacher: Master
role_mycustomrole: Jedi

It is worth noting that the short name for the teacher role is ''editingteacher'' and the short name for the non-editing teacher is ''teacher''.

===Course action fields===

Those settings take precedence over the ''Course process'' parameters.

;delete
: 1 to delete the course
;rename
: The shortname to rename the course to
;backupfile
: An absolute path to a backup file (.mbz) to import in the course.

(This means the full path to your course, for example ''/home/yourmoodle/public_html/moodle27/transfert/backup.mbz'' . If you are unsure of this, look at include_path in ''Site administration>Server>PHP info.)''
;templatecourse
: The short name of a course to import the content from
;reset
: 1 to reset the course

===Mandatory fields===

;shortname
: This field is mandatory for every operation, with the only exception of creating new courses. See details on the course process parameter ''Shortname template'' for more information.
;fullname
: Required when creating a new course.
;category, category_idnumber, category_path
: One of these is required when creating a course.

===Import options===

To prevent unexpected behaviour, you have to specify what you want the tool to be able to do.

;Upload mode
: This allows you to specify if courses can be created and/or updated.
;Update mode
: If you allow courses to be updated, you also have to tell the tool what to update the courses with.
;Allow deletes
: Whether the ''delete'' field is accepted or not
;Allow renames
: Whether the ''rename'' field is accepted or not
;Allow resets
: Whether the ''reset'' field is accepted or not

===Course process===

This allows you to specify actions to be taken for every course uploaded.

;Shortname template
: If you are creating courses without a shortname, you can use this field to automatically generate a shortname. This field accepts two placeholders: %i for the ID number, %f for the summary.
;Restore file
: A backup file (.mbz) to import in the course after create/update.
;Restore from course
: The shortname of a course to import content from after create/update.
;Reset after upload
: Whether to reset the course after creating/updating it.

===Default course values===

Those are values that can be set in the web interface for all the fields that are not specified in the CSV file. Note that they are always used when creating a course, but only when specified during update (see ''Update mode'').

==Increasing speed==

When importing the content of a backup file, or another course, you are advised to enable the setting ''keeptempdirectoriesonbackup''. This will considerably speed up the process of the upload if you are importing multiple times from the same source.

==See also==

* Demo screencast: [http://youtu.be/MzK2jb-9SwE Bulk course creation]
* [[Upload users]]
* [http://www.moodleblog.net/2013/11/24/creating-course-templates-in-moodle-2-6/ Creating course templates in Moodle 2.6] blog post by Mary Cooch

[[de:Kurse hochladen]]
[[es:Subir cursos]]

PayPal enrolment

2017-06-20T08:12:15Z

Marycooch: updated for Boost

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

==PayPal account creation==

# Go to https://www.paypal.com and create a PayPal account. Not required but recommended for selling: Upgrade your account to "Premier" status and get "Verified".
# Set the Encoding to UFT-8. In Paypal, go to ''Profile > Language Encoding'' (under the Selling Preferences column) and set your website's language (like select "Western European Languages (including English)" as it is the only English version). Then click on the "More Options" button and set the Encoding to "UTF-8", select "Yes" to use the same encoding for data sent from PayPal to you, and save.
# Optionally setup IPN in PayPal to interact with Moodle. Log into PayPal, go to "Profile > Instant Payment Notifications (IPN)”, click "Turn On IPN", click the "Edit settings" and enter a URL that references your IPN file in your Moodle installation (for example: <nowiki>http://<domain name>/moodle/enrol/paypal/ipn.php</nowiki>).

==Enabling PayPal enrolment==

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
# 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 dollar sign 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 dollar sign icon]]
|}

==Changing the dollar symbol==
[[File:PaypalGBP.png|frame|PayPal course listed with GBP sign icon]]
The default currency symbol for PayPal is a dollar sign. If you are using GBP or Euros or another currency, you can change this by creating your own customised icon with your choice of currency. Make it 16x 16 pixels and call it ''icon.gif'' Upload your new icon via FTP to your ''moodle directory>enrol>paypal>pix''. Your icon.gif will override the dollar sign. Make sure you refresh your page to be sure of the changes.

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

Bulk enrolments

2017-05-12T13:40:29Z

Marycooch: adding infobox for clarity

{{Infobox plugin
|type = local plugin
|entry = https://moodle.org/plugins/local_mass_enroll

maintainer = [[Rogier Van Dongen]]
|float = right
}}
Bulk enrolments allows you to enrol students and add them to groups in a Moodle course using an excel file containing the students' email address or userid.
Before you start, you will require an excel file containing a complete list of the students' email address or userids in the first column. Subsequent columns contain the names of any groups you want to add each student to.

'''Create your CSV'''

In order to upload your students successfully, you will need to create a CSV file with the students details. CSVs are simple to create - one way is in a spreadsheet package, making sure to save it as a .csv file type.
At minimum, your CSV file should contain one column for the main student identifier, usually their email address but it can also be their userid, or student ID number.
Ensure you have column labels - this is because Moodle anticipates these and so ignores the first row of CSV file. In other words, don't put any actual student data in your file's top row. If you are using email then put 'email', if you are using user IDs then put 'userid'.
If you want to enrol the students into Groups, include a second column which gives the group name for each student. Be careful to type these exactly. Give it a column heading 'group'.
You can add subsequent groups in subsequent columns.

[[File:bulk_upload_csv.JPG]]

'''Enrol the Students'''

In the '''Settings''' block on your course, under '''Course administration''', click '''Users''' > '''Bulk enrolments'''.

Select '''Choose a file''' and upload your CSV file.
Make sure '''Role''' to assign is left as '''student'''.
Set '''First column contains''' to reflect they type of data you have used in your spreadsheet, either the students' email address, userid or ID number.
If you need to create groups, ensure '''Create group(s) if needed''' is set to Yes.
If you would like to create groupings in your course, based on the groups that the students will been placed into, ensure '''Create grouping(s) if needed''' is kept to yes. If you do not want to create groupings, set this to No.
To receive an email report confirming which students have been enrolled and which groups they have been placed into, keep '''Send me a mail report''' set to '''Yes'''.
Click '''Enrol them to my course'''.
Check the students have been enrolled in their groups by going to the '''Settings''' menu and under '''Course Administration''' click on '''Users''' then '''Groups'''.
You should see the groups listed, followed by the number of students in each group in brackets.
You can also bulk unenrol students from your course by clicking on Bulk unenrolments in the block, and following the instructions above.

[[File:bulk_upload.png]]