MoodleDocs - User contributions [en]

Quiz quick guide

2017-11-16T15:32:09Z

Marycooch:

{{Quiz}}
The Quiz is a very powerful activity that can meet many teaching needs, from simple, multiple-choice knowledge tests to complex, self-assessment tasks with detailed feedback. This quick guide gets you started, but if you really want to make the most of everything a Quiz can do, make sure you study the full '''[[Quiz activity]]''' documentation. For a short video introduction, see also the screencast '''[https://youtu.be/OSI3HlNSoRM Quiz: Automatic grading].'''
__NOTOC__
==Before you start==
*A quiz is made up of two parts: (1) a set up page or 'front cover' where you add the criteria for the quiz, such as grading and time limits, and (2) the questions themselves. The questions are stored separately from your quiz in a course [[Question bank]]. This means you can reuse your questions in a later quiz. It also means you could display an empty quiz (a 'front cover' with no questions added) on your course page, so be careful!
*Some people prefer to make their quiz questions separately first and then add them to a quiz 'front cover' later. If you would like that, then look at the documentation on [[Question bank]] or just read on below until we get there!

==Set up the quiz 'front cover'==
*In the course where you want your quiz, turn on the editing and from the Activity Chooser, select 'Quiz'.
*Give it a name and if desired, a description telling students what the quiz is about.
*If you want, you can now scroll down to the bottom of the page, click 'Save and display' and start adding questions. (Go to the section 'Add your questions' below.)

[[File:QuizQuickStart030.png]]

===Default settings for your quiz===
If you don't change anything on the quiz setup page (your 'front cover'), then your quiz will work like this:
**It will not have a time limit and students can take it as many times as they wish, with the recorded grade being their best attempt.
**Each question will be on a different page and they can move freely between previous and later questions.
**Students won't know their score or get feedback until they complete the quiz.

To change some of those settings, read on:

===Quiz settings===
If you expand the sections in the quiz setup page and click the '''?''' icon and the 'Show more' links, you can explore alternative settings for your quiz. Here are some popular settings:

'''Time limit''' - if you only want to allow students a limited amount of time from when they start until they must have finished. If, instead you want students to finish by a certain date and time, set the '''Close the quiz''' setting.

'''How questions behave -Interactive with multiple tries''' -instead of the quiz being like a test where students only see their results at the end, this setting allows them to get immediate feedback for each question and keep trying. (Good for formative assessment.) Learn more about [[Question behaviours]].

'''Overall feedback''' -completing this will give your students customised feedback according to what grade range they obtained.

==Add your questions==
So you have completed the quiz set up page and clicked 'Save and display:

1. Click the button 'Edit quiz'

2. Click 'Add' on the right and then click '+ a new question'. (If you already made questions in the question bank, then click '+ from question bank' or if you wish to add a question randomly picked from a category of questions, click '+ a random question'.)

[[File:quizquideaddquestion.png]]

3. Choose the type of question you want to add and then click 'Add' at the bottom:
{|
| [[File:QuizQuickStart050.png|thumb]]
| [[File:QuizQuickStart060.png|thumb]]
|}

4. Add your question. If you need help, click the documentation link at the bottom of your question page or explore the [[Question types]] documentation. Note that students won't see the question name; it is for your records only.

5. Click 'Save changes' when you have made your question.

6. Repeat steps 2- 5 for as many questions as you need.

7. If you want to,change the maximum grade for your quiz to reflect the number of questions.

[[File:QuizQuickStart100.png]]

==Getting your quiz ready for students==
Once you have added all the questions you need, your quiz is ready for students and will already be visible on the page (unless you hid it while you were setting it up.)

It is a good idea to preview your quiz by clicking in the block ''Administration > Quiz administration > Preview.'' (1 below) You can then check for any oversights and edit a question directly from a link provided (2 below):

[[File:Quizpreviewedit.png]]

==Viewing quiz results==
To see the grades once students have done your quiz, you can either:
* click the quiz itself and then the link 'Attempts =' (where the number is the number of attempts) - or -
*click the quiz and then from the block ''Administration > Quiz administration'', expand 'Results' and select the analysis you need.

[[Category:Quick guide]]

[[es:Guía rápida del examen]]
[[de:Kurzanleitung zu Tests]]

Talk:Incoming mail configuration

2017-08-09T19:06:11Z

Marycooch: reply to Jessica

unless I'm mistaken this feature doesn't seem available in Moodle v3.1
==Reply to Jessica==
Hi there. I just checked on a Moodle 3.1.2+ (Build: 20161007) and it is definitely there. Also I did that screenshot at the time of 3.1 so it must have been there:)
--[[User:Mary Cooch|Mary Cooch]] ([[User talk:Mary Cooch|talk]]) 03:06, 10 August 2017 (AWST)

Capabilities/mod/feedback:complete

2017-08-08T08:44:55Z

Marycooch:

{{Capabilities}}
*This allows a user to complete a [[Feedback module|feedback form]]
*This capability is allowed for the default roles and ('''new in 3.1''' in new installations), authenticated user on the front page.

[[Category:Capabilities|Feedback]]
[[Category:Feedback]]

Capabilities/mod/feedback:view

2017-08-08T08:43:48Z

Marycooch:

{{Capabilities}}
*This allows a user to view a [[Feedback module|feedback activity]]
*This capability is allowed for the default roles of manager, teacher, non-editing teacher, student, guest and ('''new in 3.1''' in new installations) authenticated user on the front page.

[[Category:Capabilities|Feedback]]
[[Category:Feedback]]

Capabilities/mod/feedback:view

2017-08-08T08:42:07Z

Marycooch: updating from MDL-53209

{{Capabilities}}
*This allows a user to view a [[Feedback module|feedback activity]]
*This capability is allowed for the default roles of manager, teacher, non-editing teacher, student, guest and ('''new in 3.1''') authenticated user on the front page.

[[Category:Capabilities|Feedback]]
[[Category:Feedback]]

Capabilities/mod/feedback:complete

2017-08-08T08:40:51Z

Marycooch: updating from MDL-53209

{{Capabilities}}
*This allows a user to complete a [[Feedback module|feedback form]]
*This capability is allowed for the default roles and '''(new in 3.1)''' authenticated user on the front page.

[[Category:Capabilities|Feedback]]
[[Category:Feedback]]

Building Feedback

2017-08-07T16:47:10Z

Marycooch: updating following forum query

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

[[Image:31feedbackquestions.png]]

== Standard options ==

The following apply to all or most question types.

=== Position ===

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

=== Required ===

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

== Available question types ==

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

===Information===
This allows you to choose to display one of three types of information: the time of responding; the course and/ or the category where the feedback is located.

=== Label ===

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

=== Longer Text Answer ===

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

=== Multiple choice===

Selecting this then offers you three alternatives:

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

(2) Multiple choice, multiple answers

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

=== Dropdownlist (rated) ===

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

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

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

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

=== Multiple Choice (Rated) ===

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

For example:

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

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

The above question might look like:

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

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

=== Short Text Answer ===

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

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

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

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

Bulk enrolments

2017-05-12T13:39:50Z

Marycooch:

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

Bulk enrolments

2017-05-12T13:38:47Z

Marycooch:

{{local_mass_enrol}}
{{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]]

GIFT format

2017-02-18T09:33:25Z

Marycooch: link to cloze and GIFT generator

{{Export questions}}
'''GIFT format''' allows someone to use a text editor to write multiple-choice, true-false, short answer, matching missing word and numerical questions in a simple format that can be imported. The GIFT format is also an export file format available in Question bank. The format has been developed within the Moodle Community but other software may support it to a greater or lesser degree.

*When creating a large numbers of questions, GIFT can provide a quick way of bulk loading questions either into a [[Question bank|question category]], or into a [[Adding_a_question_page#Importing_questions|Lesson]].
*Sometimes it is easier proofing questions in a question category by viewing them in a GIFT file.

== General instructions ==
At least one blank line must be left between each question.

In the simple form, the question comes first, then the answers are set in between brackets, with an equal sign (=) indicating the correct answer(s) and tilde (~) the wrong answers. A hash (#) will insert a response. Questions can be weighted by placing percentage signs (%..%) around the weight. Comments are preceded by double slashes (//) and are not imported.

Here are some useful [http://moodle.org/pluginfile.php/134/mod_forum/attachment/236161/GIFT-examples.zip GIFT examples] than can be imported or used as rough template. Many of the examples below used the questions in the file as a starting point.

=== UTF-8 encoding ===
Any GIFT file '''must''' be correctly encoded in [[UTF-8]]. You can use Microsoft's text editor Notepad which comes with Windows to save your file in UTF-8.

'''Note''': ANSI format will (only) work for languages without any special characters (like ä, ö, ü, æ, å, ø, œ or ß). And don't use "Unicode" as format as this is actually UTF-16 and won't work. See [[Converting files to UTF-8]] for further information.

===Format symbols===

Here are some common GIFT symbols and their use.

{|
! Symbols !! Use
|-
| // text || Comment until end of line (optional)
|-
| ::title:: || Question title (optional)
|-
| text || Question text (becomes title if no title specified)
|-
| [...format...] || The format of the following bit of text. Options are [html], [moodle], [plain] and [markdown]. The default is [moodle] for the question text, other parts of the question default to the format used for the question text.
|-
| { || Start answer(s) -- without any answers, text is a description of following questions
|-
| {T} or {F} || True or False answer; also {TRUE} and {FALSE}
|-
| { ... =right ... } || Correct answer for multiple choice, (multiple answer? -- see page comments) or fill-in-the-blank
|-
| { ... ~wrong ... } || Incorrect answer for multiple choice or multiple answer
|-
| { ... =item -> match ... } || Answer for matching questions
|-
| #feedback text || Answer feedback for preceding multiple, fill-in-the-blank, or numeric answers
|-
| ####general feedback || General feedback
|-
| {# || Start numeric answer(s)
|-
| answer:tolerance || Numeric answer accepted within ± tolerance range
|-
| low..high || Lower and upper range values of accepted numeric answer
|-
| =%n%answer:tolerance || n percent credit for one of multiple numeric ranges within tolerance from answer
|-
| } || End answer(s)
|-
| \character || Backslash escapes the special meaning of ~, =, #, {, }, and :
|-
| \n || Places a newline in question text -- blank lines delimit questions
|}

Here are some quick examples:

// true/false
::Q1:: 1+1=2 {T}

// multiple choice with specified feedback for right and wrong answers
::Q2:: What's between orange and green in the spectrum?
{ =yellow # right; good! ~red # wrong, it's yellow ~blue # wrong, it's yellow }

// fill-in-the-blank
::Q3:: Two plus {=two =2} equals four.

// matching
::Q4:: Which animal eats which food? { =cat -> cat food =dog -> dog food }

// math range question
::Q5:: What is a number from 1 to 5? {#3:2}

// math range specified with interval end points
::Q6:: What is a number from 1 to 5? {#1..5}
// translated on import to the same as Q5, but unavailable from Moodle question interface

// multiple numeric answers with partial credit and feedback
::Q7:: When was Ulysses S. Grant born? {#
=1822:0 # Correct! Full credit.
=%50%1822:2 # He was born in 1822. Half credit for being close.
}

// essay
::Q8:: How are you? {}

===Format symbols explained===
The multiple choice format below as a comment line // for the question, when Moodle exports it the question unique id number will appear here.

The first set of :: precedes the question title.

The second :: precedes the actual question. The first { indicates the start of the answers. The correct answer is preceded by an = sign and wrong answers by a ~. Teacher responses have a # in front of them. The question ends with a } and then a blank line. NOTE it is { } not ( ) parenthesis! Usually these are obtained with help of the [AltGr] key.

//Comment line
::Question title
:: Question {
=A correct answer
~Wrong answer1
#A response to wrong answer1
~Wrong answer2
#A response to wrong answer2
~Wrong answer3
#A response to wrong answer3
~Wrong answer4
#A response to wrong answer4
}

The shortest format for a multiple choice question is:
Question{= A Correct Answer ~Wrong answer1 ~Wrong answer2 ~Wrong answer3 ~Wrong answer4 }

:''Tip:'' If you don't specify a question title the WHOLE question will be used as the title at the time of import into Moodle. There are pros and cons to allowing this to happen.
** Cons: This can add a lot of unnecessary words. This can include characters which might confuse the export GIFT process.
** Pros: On the other hand. if the start of each question is different, it can make finding a single question easier in a category list of questions. It will save you typing. Having the same title for every question is a very bad idea.

==Question format examples==
There are several ways to use a text editor to write a GIFT format. We will try to show the simple version for example and in some formats we will introduce some more complex features that can be imported into many Moodle Question formats.

===Multiple choice===
For multiple choice questions, wrong answers are prefixed with a tilde (~) and the correct answer is prefixed with an equal sign (=).

Here is a simple acceptable GIFT multiple choice format:
Who's buried in Grant's tomb?{=Grant ~no one ~Napoleon ~Churchill ~Mother Teresa }

Here is a longer format that uses most of the GIFT elements:

// question: 1 name: Grants tomb
::Grants tomb::Who is buried in Grant's tomb in New York City? {
=Grant
~No one
#Was true for 12 years, but Grant's remains were buried in the tomb in 1897
~Napoleon
#He was buried in France
~Churchill
#He was buried in England
~Mother Teresa
#She was buried in India
}

===Multiple choice with multiple right answers===

That is, using checkboxes, not radio buttons:

What two people are entombed in Grant's tomb? {
~%-100%No one
~%50%Grant
~%50%Grant's wife
~%-100%Grant's father
}

===True-false===

In this question-type the answer indicates whether the statement is true or false. The answer should be written as {TRUE} or {FALSE}, or abbreviated to {T} or {F}.

// question: 0 name: TrueStatement using {T} style
::TrueStatement about Grant::Grant was buried in a tomb in New York City.{T}

// question: 0 name: FalseStatement using {FALSE} style
::FalseStatement about sun::The sun rises in the West.{FALSE}

===Short answer===

Answers in Short Answer question-type are all prefixed by an equal sign (=), indicating that they are all correct answers. The answers must not contain a tilde.

Here are two examples using the simple method showing possible right answers for credit.
Who's buried in Grant's tomb?{=Grant =Ulysses S. Grant =Ulysses Grant}

Two plus two equals {=four =4}

If there is only one correct Short Answer, it may be written without the equal sign prefix, as long as it cannot be confused as True-False.

===Matching===
Matching pairs begin with an equal sign (=) and are separated by this symbol "->". There must be at least three matching pairs.

Match the following countries with their corresponding capitals. {
=Canada -> Ottawa
=Italy -> Rome
=Japan -> Tokyo
=India -> New Delhi
}

Matching questions do not support feedback or percentage answer weights.

===Missing word===
The Missing Word format automatically inserts a fill-in-the-blank line (like this _____) in the middle of the sentence. To use the Missing Word format, place the answers where you want the line to appear in the sentence.
Moodle costs {~lots of money =nothing ~a small amount} to download from moodle.org.

If the answers come before the closing punctuation mark, a fill-in-the-blank line will be inserted for the "missing word" format. All question types can be written in the Missing Word format.

There must be a blank line (double carriage return) separating questions. For clarity, the answers can be written on separate lines and even indented. Some examples:

Mahatma Gandhi's birthday is an Indian holiday on {
~15th
~3rd
=2nd
} of October.

Since {
~495 AD
=1066 AD
~1215 AD
~ 43 AD
}
the town of Hastings England has been "famous with visitors".

===Numerical questions===

The answer section for Numerical questions must start with a number sign (#). Numerical answers can include an error margin, which is written following the correct answer, separated by a colon. So for example, if the correct answer is anything between 1.5 and 2.5, then it would be written as follows {#2:0.5}. This indicates that 2 with an error margin of 0.5 is correct (i.e., the span from 1.5 to 2.5). If no error margin is specified, it will be assumed to be zero.

Here is a simple numerical format question. It will accept a range of 5 years.
When was Ulysses S. Grant born?{#1822:5}
It is a good idea to check the margins of the range, 3.141 is not counted as correct and 3.142 is considered in the range.
What is the value of pi (to 3 decimal places)? {#3.14159:0.0005}.

Optionally, numerical answers can be written as a span in the following format {#MinimumValue..MaximumValue}.

What is the value of pi (to 3 decimal places)? {#3.141..3.142}.

Moodle's browser interface does not support multiple numerical answers, but Moodle's code can and so does GIFT. This can be used to specify numerical multiple spans, and can be particularly usefully when combined with percentage weight grades. If multiple answers are used, they must be separated by an equal sign, like short answer questions.

When was Ulysses S. Grant born? {#
=1822:0
=%50%1822:2
}

Note that since Moodle's browser GUI didn't support multiple answers for Numerical questions, there's no way in older Moodle versions to see them or edit them through Moodle. The only way to change a numerical answer beyond the first, is to delete the question and re-import it (or use something like phpMyAdmin). But better would be to upgrade your Moodle to at least 1.9.

===Essay===
An essay question is simply a question with an empty answer field. Nothing is permitted between the curly braces at all.

Write a short biography of Dag Hammarskjöld. {}

===Description===
A description "question" has no answer part at all

You can use your pencil and paper for these next math questions.

==Options==

In addition to these basic question types, this filter offers the following options: line comments, question name, feedback and percentage answer weight.

===Line Comments===
Comments that will not be imported into Moodle can be included in the text file. This can be used to provide headers or more information about questions. All lines that start with a double backslash (not counting tabs or spaces) will be ignored by the filter.

// Subheading: Numerical questions below
What's 2 plus 2? {#4}

Comments will be exported from Moodle and will include the unique question id. The above question after it was imported and then exported from Moodle:
// question: 914 name: What's 2 plus 2?
::What's 2 plus 2?::What's 2 plus 2?{#
=4:0#
}

===Question Name===
A question name can be specified by placing it first and enclosing it within double colons (::...::).

::Kanji Origins::Japanese characters originally
came from what country? {=China}

::Thanksgiving Date::The American holiday of Thanksgiving is
celebrated on the {~second ~third =fourth} Thursday of November.

If no question name is specified, the entire question will be used as the name by default.

===Feedback===
Feedback can be included for each answer by following the answer with a number sign (# also known as a hash mark) and the feedback.

What's the answer to this multiple-choice question? {
~wrong answer#feedback comment on the wrong answer
~another wrong answer#feedback comment on this wrong answer
=right answer#Very good!
}

//From The Hitchhiker's Guide to the Galaxy
Deep Thought said " {
=forty two#Correct according to The Hitchhiker's Guide to the Galaxy!
=42#Correct, as told to Loonquawl and Phouchg
=forty-two#Correct!
} is the Ultimate Answer to the Ultimate Question of Life, The Universe, and Everything."

42 is the Absolute Answer to everything.{
FALSE#42is the Ultimate Answer.#You gave the right answer.}

For Multiple Choice questions, feedback is displayed only for the answer the student selected. For short answer, feedback is shown only when students input the corresponding correct answer. For true-false questions, there can be one or two feedback strings. The first is shown if the student gives the wrong answer. The second if the student gives the right answer.

===Percentage Answer Weights===
Percentage answer weights are available for both Multiple Choice and Short Answer questions. Percentage answer weights can be included by following the tilde (for Multiple Choice) or equal sign (for Short Answer) with the desired percent enclosed within percent signs (e.g., %50%). This option can be combined with feedback comments.

Difficult question.{~wrong answer ~%50%half credit answer =full credit answer}

::Jesus' hometown::Jesus Christ was from {
~Jerusalem#This was an important city, but the wrong answer.
~%25%Bethlehem#He was born here, but not raised here.
~%50%Galilee#You need to be more specific.
=Nazareth#Yes! That's right!
}.

::Jesus' hometown:: Jesus Christ was from {
=Nazareth#Yes! That's right!
=%75%Nazereth#Right, but misspelled.
=%25%Bethlehem#He was born here, but not raised here.
}

Note that the last two examples are essentially the same question, first as multiple choice and then as short answer.

Note that it is possible to specify percentage answer weights that are NOT available through the browser interface. The Match Grades drop-down on the import page determines how these are handled. You can either request that an error be reported or that the answer weight be adjusted to the nearest valid answer weight.

Specify text-formatting for the question
The question text (only) may have an optional text format specified. Currently the available formats are moodle (Moodle Auto-Format), html (HTML format), plain (Plain text format) and markdown (Markdown format). The format is specified in square brackets immediately before the question text. See [[Formatting text]] for further information.

[markdown]The *American holiday of Thanksgiving* is celebrated on the {
~second
~third
=fourth
} Thursday of November.

===Multiple Answers===
The Multiple Answers option is used for multiple choice questions when two or more answers must be selected in order to obtain full credit. The multiple answers option is enabled by assigning partial answer weight to multiple answers, while allowing no single answer to receive full credit.

What two people are entombed in Grant's tomb? {
~No one
~%50%Grant
~%50%Grant's wife
~Grant's father
}

Note that there is no equal sign (=) in any answer and the answers should total no more than 100%, otherwise Moodle will return an error. To avoid the problem of students automatically getting 100% by simply checking all of the answers, it is best to include negative answer weights for wrong answers.

What two people are entombed in Grant's tomb? {
~%-50%No one
~%50%Grant
~%50%Grant's wife
~%-50%Grant's father
}

===Special Characters ~ = # { }===
These symbols ~ = # { } : control the operation of this filter and cannot be used as normal text within questions. Since these symbols have a special role in determining the operation of this filter, they are called "control characters." But sometimes you may want to use one of these characters, for example to show a mathematical formula in a question. The way to get around this problem is "escaping" the control characters. This means simply putting a backslash (\) before a control character so the filter will know that you want to use it as a literal character instead of as a control character. For example:

Which answer equals 5? {
~ \= 2 + 2
= \= 2 + 3
~ \= 2 + 4
}

::GIFT Control Characters::
Which of the following is NOT a control character for the GIFT import format? {
~ \~ # \~ is a control character.
~ \= # \= is a control character.
~ \# # \# is a control character.
~ \{ # \{ is a control character.
~ \} # \} is a control character.
= \ # Correct! \ (backslash) is not a control character. BUT,
it is used to escape the control characters.
}

When the question is processed, the backslash is removed and is not saved in Moodle.

===HTML in answers===
The GIFT format will interpret HTML correctly if you add [html] in front of the question. See [https://moodle.org/mod/forum/discuss.php?d=334375 this forum thread].

===Specifying Categories===

It is possible to change the category into which the questions are added within the GIFT file. You can change the category as many times as you wish within the file. All questions after the modifier up to the next modifier or the end of the file will be added to the specified category. Up to the first category modifier the category specified on the import screen will be used. Note that for this to work the from file: box must be ticked on the import screen.

To include a category modifier include a line like this (with a blank line before and after):

$CATEGORY: tom/dick/harry

or simply

$CATEGORY: mycategory

...the first example specifies a path of nested categories. In this case the questions will go into harry. The categories are created if they do not exist.

To find out how your categories are organized, you might try exporting some questions including category data first and check the exported GIFT formatted file. The lowest level of system context might give you something like $CATEGORY: $system$/....

===Making questions case sensitive===
Short Answer questions can be made case sensitive by changing "0" to "1" in the following line '''of your moodle/question/format/gift/format.php file''':
$question->usecase = 0; // Ignore case

==Hints and Tips==
* Use the ::title:: at the beginning of every question to organize your questions when Moodle presents a list or exports them as another GIFT file. When the title is left blank, Moodle will put the beginning of the question as the title. Some teachers want to see something like "001 LIT101 Poe ref Purloin Letter" or "The Purloin Letter was written by (AmLit pg 254)" in the title.

* You can specify markup if you need to format the question by setting [html], [moodle], [plain] or [markdown] just before the question text. See more about this in the reference pdf below.
* In the Lesson module, in a question page, correct answers jump by default to Next page and incorrect answers jump to This page (i.e. student has to "try again"). When importing from a GIFT format file, this is exactly the mechanism which is used.
* If you want a student to be taken directly from one question to the next irrespective of their answer being correct or incorrect: in the Lesson Settings, set Maximum number of attempts: to 1.
**Please note, however, that a message "correct / incorrect" will still be displayed to the student upon answering each question. If you do not want this (default) feedback message to be displayed then enter your own feedback message (i.e. "continue", "---", etc.)
**In case you want no visible message displayed then enter a non-breaking space as feedback. Moodle will not put it's automatic response because it sees the blank space. To do this, put a # after the answer and write [[Image:Nbsp.png]] (without spaces between these characters).
* Need to use a special GIFT character in your question or answer? Put a \ in front of the GIFT character.
**For example if you want to use curly braces, { or }, or equal sign, =, or # or ~ in a GIFT file (in a math question including TeX expressions) you must "escape" them by preceding them with a \ directly in front of each { or } or =. It is possible to use a replace program/macro/editor filter to do this conversion before importing to Moodle.
* Want to change T/F type questions to multiple choice? Consider exporting the T/F questions as a GIFT file, then using a text editor to replace the (T) with (=True ~False). Perhaps change the title slightly so you will recognize the new questions.
* Alphabetic case-sensitive comparison is disabled by default. If you need case-sensitive comparison for short answer questions (an unusual need), precede them with:
$question->usecase = 1;
surrounded by blank lines.

==Word processor and spreadsheet tools that create GIFTs==
Several contributors have used macros to generate GIFT files from a more familiar popular programs.
*Here is a [http://hbwubecc.wixsite.com/jordan/tools Moodle Cloze and Gift generator] as presented at the 2017 Japanese Moodle mooot.
* There are Word macros available for easily creating GIFT files. See [https://moodle.org/mod/forum/discuss.php?d=135112 this forum thread] for links to downloadable files for different Word versions..
* There are several Excel spreadsheets for generating GIFT files. Several people have built upon other contributors work.
**The latest version was posted on 10 April 2007 and can be found in this thread with this file name: [http://moodle.org/mod/forum/discuss.php?d=66660 Excel2GIFTv1.1.zip by Timothy Takemoto]. There is also a set of instructions Excel2GIFTv1.1_Instructions.rtf by Jeff Shek on the same day in that thread.
** [http://video.google.com/videoplay?docid=-6612645502883459334# video tutorial] for using Excel2GIFTv2.xls
**An earlier version of this Excel spreadsheet for generating multiple choice GIFT files [http://moodle.org/mod/forum/discuss.php?d=45245 initially created by Olga Forlani and improved by A. T. Wyatt].
*There is a project, Libre Office templates, for generating GIFT files in Writer. It is located in
[https://code.google.com/p/libre-gift/downloads/list OOo template 2013 to write exams and convert to GIFT format]
*There are Open Office templates for generating GIFT files in Writer. These are located in the Quiz forum in the [http://moodle.org/mod/forum/discuss.php?d=20705&parent=168385 OOo template to write exams and convert to GIFT format thread].
**The most recent for OO 2.x is "OOo2GIFT_Template_05.zip" posted 17 December 2005 by Enrique Castro.
**An earlier version is "GIFT_template_OOo.zip" posted 22 March 2005 by Enrique Castro.
*There is an easy to use on line multiple question generator at [http://a4esl.org/c/qw.html a4esl.org]. Here you write your question(s) without formating marks, select Moodle and press the generate quiz button. This creates GIFT formatted text that can be pasted into a file for importing into Moodle.
**The initial format requires fewer keystrokes (it uses line position and returns) than the GIFT format, so you should save time and be less likely to create invalid data.
** Quiz authoring template for Microsoft Word [http://moodle.org/mod/data/view.php?d=13&rid=578 link]
** Moodle XML Converter [http://vletools.com]
** GIFT format parser library in Ruby [http://github.com/stuart/gift-parser]

==GIFT format with medias (images, sound...)==
The [https://moodle.org/plugins/pluginversions.php?plugin=qformat_giftmedia GIFT with medias optional plugin] is an import format similar to Gift and uses the same syntax, but instead of a text file it imports a zip file containing the gift text file and media files (images, sounds, ...).

==See also==

* Here is a 2-column PDF [http://buypct.com/gift_reference.pdf GIFT Reference Sheet]
*[[Import and export FAQ]]
*[[Aiken Format]]

==External links==
*[http://en.wikiversity.org/wiki/Google_Summer_of_Code_2010_Proposal:_GIFT_Conversion Google Summer of Code 2010 Proposal: GIFT Conversion] (Wikiversity)
*[http://www.moodlenews.com/2014/gift-format-for-quiz-items-with-images/ GIFT Format for Quiz Items with Images]
*[http://text2gift.atwebpages.com/Text2GiftConverter.html On line Gift format generator from plain text]
[[de:GIFT]]
[[es:Formato GIFT]]
[[fr:Format GIFT]]
[[ja:GIFTフォーマット]]

Talk:Assignment settings

2017-02-13T08:34:44Z

Marycooch: /* Reply */

Hello everyone!
I am reading the "Use marking (grading) workflow" and noticed that there is a screenshot of "Dropdown to select marking workflow state when quick grading" and I am wondering, does the quick grading works when the PDF annotation is enabled? Because, it doesn't seem to work for me... :/ ~anna.krassa 14:06, GTM+2, 11 Feb 2017.

==Reply to Anna==
Hello Anna. I haven't tried it but I can imagine that although you can grade each student, I am not sure the document would convert to a PDF if you clicked on it in the quick grading screen. What was your experience?--[[User:Mary Cooch|Mary Cooch]] ([[User talk:Mary Cooch|talk]]) 20:29, 11 February 2017 (AWST)

==Reply to Mary==
Hello Mary, thank you for the quick reply here.
Mary as far as I can remember, the "quick grading" allowed teachers to give a score through the submissions page (view all submissions). Now, if you click the "Grade" button (where the quick grading used to open) it takes you to the annotating grading environment. To me it seems that quick grading is not an option at all any more... Quick grading was a very helpful option for some cases but since it is not working, perhaps it would be better to remove the screenshot? ~anna.krassa 22:15, GTM+2, 11 Feb 2017.

==Reply to Anna==
Which quick grading screenshot do you mean, Anna? And I thought that if you click View all submissions instead of the Grade button then you can still select quick grading by ticking the box at the bottom?--[[User:Mary Cooch|Mary Cooch]] ([[User talk:Mary Cooch|talk]]) 16:58, 12 February 2017 (AWST)

==Reply to Mary==
Hi Mary, when I click the "view all submission" I don't see the option for "quick grading" any more neither in Moodle 3.1, nor in 3.2. The only options available are:

- Assignments per page

- Show only active enrolments

- Download submissions in folders (in 3.1 only)

The screenshot I am referring at is this one: https://docs.moodle.org/31/en/File:26quickgradingworkflow.png and it is under the "Use marking (grading) workflow" paragraph. V-. ~anna.krassa 12:14, GTM+2, 12 Feb 2017.
==Reply==
OK- I will need to find a site which has unoconv installed so that I can see with the PDF conversion. I do see the quick grading tick on the sandbox site demo.moodle.net and if you tick the box for marking workflow in the assignment settings, then you see the options in that screenshot when quick grading is on. However, the sandbox does not have unoconv so is probably not the same experience as you.--[[User:Mary Cooch|Mary Cooch]] ([[User talk:Mary Cooch|talk]]) 18:26, 12 February 2017 (AWST)

==Updated reply==
Please try to replicate this on the QA site -I know it is running 3.3 dev but nothing in terms of the assignment settings has changed and it does have unoconv. I have found that quick grading is possible and that dropdown in the screenshot does appear as it should, so perhaps you can check this? --[[User:Mary Cooch|Mary Cooch]] ([[User talk:Mary Cooch|talk]]) 16:34, 13 February 2017 (AWST)

Talk:Assignment settings

2017-02-12T10:26:58Z

Marycooch:

Talk:Assignment settings

2017-02-12T08:59:00Z

Marycooch:

Talk:Assignment settings

2017-02-11T12:30:12Z

Marycooch:

Dropbox repository

2017-02-02T09:50:35Z

Marycooch: updating Dropbox app info (MDL-52051)

{{Repositories}}
See MDL-52051 for details of the Dropbox API v2 migration.

The Dropbox repository enables users to copy or create a shortcut or alias to files from ''their own'' Dropbox. See [[Working with files]] for more details.

==Enabling the Dropbox repository==

The Dropbox repository may be enabled by a site administrator from the Manage repositories link in Site administration.

===Dropbox configuration===
*Once enabled the administrator will need to add a Dropbox API Key and Secret. To get one, click on the "Dropbox developers" link on the Dropbox repository settings page, opening it in a new tab for convenience:

[[File:dropboxrepo01.png|thumb|700px|center]]

*On the next screen, sign in or create an account on Dropbox. If you don't immediately see a blue button 'Create app' then click the Developers link at the bottom of the screen. On the next screen, click to create a new app.

* Choose '''Dropbox API', 'Full dropbox''' and name your app according to the branding rules:

[[File:dropboxrepo02.png|thumb|center|700px]]

* Click the blue 'Create app' button

* On the next screen you will see an App key and an App secret. Copy these and go back to your Moodle site Dropbox repository settings page.

* Paste these into the appropriate fields (1 below) and then copy the Redirect URL (2 below):

[[File:dropboxrepo4.png|thumb|center|700px]]

* Return to the Dropbox site. Paste in the Redirect URl and click Add:

[[File:dropboxrepo05.png|center]]

*If you wish, you can click the Branding tab and add extra information for your users, including a custom logo they will see when they connect to Dropbox on your site:

[[File:dropboxrepo06.png|center]]

==Using the Dropbox repository==

To select a file via Dropbox, editing teachers will click on the Dropbox link in the file picker and log on to access the files in their account. They will see a message requesting access:
[[File:dropboxlogin.png|center]]

When they are done, they can log out.

==Repository capabilities==

There is just one capability, [[Capabilities/repository/dropbox:view|View a Dropbox folder]], which is allowed for the default authenticated user role.

==See also==

* [http://www.somerandomthoughts.com/blog/2012/10/23/using-dropbox-repository-with-moodle/ Using Dropbox Repository with Moodle] blog post by Gavin Henrick

[[de:Dropbox Repository]]
[[ja:Dropbox]]

File:dropboxrepo06.png

2017-02-02T09:50:09Z

Marycooch:

File:dropboxrepo05.png

2017-02-02T09:50:00Z

Marycooch:

File:dropboxrepo4.png

2017-02-02T09:49:50Z

Marycooch:

File:dropboxrepo02.png

2017-02-02T09:49:42Z

Marycooch:

File:dropboxrepo01.png

2017-02-02T09:49:32Z

Marycooch:

Course completion settings

2017-01-25T12:04:32Z

Marycooch: copied from 3.2 docs

{{Course completion}}
==Enabling course completion==

An administrator can enable course completion for the site by ticking the 'Enable completion tracking' checkbox in ''Administration > Site administration > Advanced features''.

A teacher can then enable course completion for their course by setting 'Enable completion tracking' to Yes in ''Administration > Course administration > Edit settings''. (This also enables the use of [[Activity completion]].)

A 'Course completion' link will then be shown under Course administration in the Administration block.

==Course completion settings==

===General===

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

Choose here how you wish to mark the course complete -whether you want ''Any'' or ''All'' of the requirements that follow to count towards completion.
===Condition:Activity completion===
(These settings are collapsed by default.)
{|
|[[File:activitycompletion25.png|thumb|Activity completion settings expanded]]
|}
Tick the boxes of the activities you wish to count towards completion of the course. (You need to have [[Activity completion]] enabled to be able to do this. You can decide whether ALL of the activities must be completed or ANY one of them.
===Condition:Completion of other courses===
(These settings are collapsed by default.)
{|
|[[File:noothercoursecompletion25.png|thumb|Settings when no other courses have course completion enabled]]
|[[File:othercoursesompletion25.png|thumb|Settings when course completion is enabled in one or more other courses]]
|}

This setting allows you to make "the completion of another course" as a condition for completing the course you are currently working in. This does not block the student from your current course; it simply means that the current course will not be marked complete until the first course has been marked complete. Thus, completion of the current course is dependent upon completion of an earlier course. Just select one or more courses in the "Courses available box".

'''Note''': ''To remove a course from the list if it is not required, press CTRL+click on the highlighted course and it will be deselected.''

===Condition: Date===
(These settings are collapsed by default.)
{|
|[[File:completiondate25.png|thumb|Date settings expanded]]
|}
If you tick the ''Enable'' box you can then set a date after which the course will be declared complete.

===Condition: Enrolment duration===
(These settings are collapsed by default.)
{|
|[[File:completionenrolment25.png|thumb|Enrolment duration settings expanded]]
|}

If you tick the ''Enable'' box you can then choose a number of days after enrolment upon which the course will be marked complete.
===Condition: Unenrolment===
(This one setting is collapsed by default.)

If you tick "Enable" here then the course will be marked complete once the student is unenrolled.

===Condition: Course grade===
(These settings are collapsed by default.)
{|
|[[File:completioncoursegrade25.png|thumb|Course grades settings expanded]]
|}
If you tick the ''Enable'' box, you can set a passing grade for the course. Please note that course grade in Completion status is looking at total of points (rawgrade) rather than a percentage.

===Condition: Manual self-completion===
(These settings are collapsed by default.)
{|
|[[File:manualselfcompletion25.png|thumb|Manual self completion settings expanded]]
|}

If this is enabled then a student can mark the course complete themselves from the [[Self completion block]].

===Condition: Manual completion by others===
(These settings are collapsed by default.)
{|
|[[File:manualcompletionothers25.png|thumb|Manual completion by others settings expanded]]
|}
Users with selected roles may mark the course as complete if their role is ticked here. The roles listed are ones for which the capability [[Capabilities/moodle/course:markcomplete|Mark users as complete in course completion]] is allowed.

ALL means that each role must mark the course complete before; ANY means that it will be classed as complete once one role has marked it complete.

==Course administration settings==

''Course administration > Edit settings''

*Completion tracking must be enabled.

==Site administration settings==

Use ''Site administration > Advanced features > Enable completion tracking'' (check enabled) in order to allow completion tracking on your site.

You can set Completion tracking as On or Off in new courses as a course default in ''Site administration > Courses > Course default settings''.

==Course completion capabilities==

There are two capabilities, both of which are allowed for the default roles of manager, teacher and non-editing teacher:

*[[Capabilities/report/completion:view|View course completion report]]
*[[Capabilities/moodle/course:markcomplete|Mark users as complete in course completion]]

==Course completion blocks==

* [[Course completion status block]]
* [[Self completion block]]

[[Category:Site administration]]

[[eu:Ikastaro-osaketaren_jarraipenaren_ezarpenak]]
[[es:Configuraciones de finalización del curso]]

Course completion FAQ

2017-01-25T09:11:26Z

Marycooch: how to remove course requisite

{{Course completion}}
==How do I enable course completion?==

At the site level, Completion tracking must be enabled in ''Site administration > Advanced features > Enable completion tracking'' for it to be available for use in courses.

At the course level, Completion tracking must then be enabled for each course, in ''Course administration > Edit settings > Enable completion tracking''. Once enabled, the Course completion option will appear in the Course administration menu where completion can be defined.

For more, see [[Course completion settings]].

==Students have completed the criteria but the report does not show it==

Check in ''Site administration > Server > Scheduled tasks'' that the task 'Calculate regular completion data' is running frequently enough, such as every minute.

==I have set up course prerequisites but my students can still access the second course before they have finished the first==
This is by design. The course prerequisites feature does NOT prevent students from accessing courses they are actively enrolled in. It merely prevents the course from being marked as "complete" until they have completed the first course.

==How can I prevent my students accessing course 2 before they have completed course 1?==
This is currently not possible using completion settings (see MDL-22648).

The would have to be controlled by your Student Information System (SIS) which manages enrollments, if you have one.

Otherwise, if you use course self-enrolment, a workaround is to add a final activity at the end of course 1 - such as a quiz - inside which you give the enrolment key to the next course (in the quiz feedback for example, or in a label using access restrictions based on passing the quiz). Thus, only those who have completed course 1 can get access to the enrolment key for course 2.

==I made a mistake and had to erase my student data. Do my students have to redo the activities?==
No. For example, if you set the course completion for All aggregation methods and wanted to reset it to "Any", Moodle will warn you that you are deleting compiled student data. It will delete the student data only for the course completion information. When the scheduled task for handling completions next runs, it will recompile the course completion information.

==How can a teacher allow students to manually mark they have finished the course?==

Install the [[Self completion block]]. Be sure and give students some directions that when they click on the link in that block, that will indicate to the Teacher that they think they are done.

==A student received an error message when they click on "More information" in the course completion block==

This may happen at the start of the course when the student has not completed an activity and/or you have selected an aggregation method of All and have not checked off that they have completed the activity. See also [[Self_completion_block]]

== I can't remove a course requisite==
*In the Course completion settings, locate the box 'Available courses' where the course requisite is highlighted.
*Press CTRL+ click and this will deselect your previously highlighted (selected) course and it will no longer be a requirement.
==See also==

Moodle forum discussions:

*[http://moodle.org/mod/forum/discuss.php?d=194747 How to set course completion requirements to include a minimum quiz grade?] forum discussion

[[Category:FAQ]]

[[de:Kursabschluss FAQ]]
[[es:Finalización del curso FAQ]]

Cleanup

2016-12-12T11:31:53Z

Marycooch: correction

{{Server settings}}
An administrator can limit the size of certain tables in the database by setting appropriate options in ''Administration > Site administration > Server > Cleanup''.

==Delete unconfirmed users after==
'''Note:''' ''This feature is reported as not working. See https://tracker.moodle.org/browse/MDL-54106.''

If you're using [[Email-based self-registration]] users must confirm their account (complete the email registration process) within a certain time-frame. Once the time set here has passed, any account that hasn't been confirmed will be deleted. The default is 7 days.

==Delete incomplete users after==

Once users have confirmed their account, they must complete their profile within the time interval set here.

A ''complete profile'' is one where the following fields have been filled in (are not empty):
*First name
*Last name
*Email address
Just as a reference, given that the firstname, lastname and email are required fields of the [[Upload users]] module, any account created this way is automatically a complete account.

==Disable grade history==

History tracking of changes in grades-related tables may be disabled by checking the ''disablegradehistory'' box.

==Grade history lifetime==

The length of time that the history of changes in grade-related tables is kept may be set (from 30 days to never).

Note for users who have upgraded from earlier versions: The setting 'Keep logs for' is now located in the [[Logging|log store settings]].

==See also==

*Using Moodle [http://moodle.org/mod/forum/discuss.php?d=87795 How do I prune mdl_log table?] forum discussion

[[eu:Garbiketa]]
[[fr:Nettoyage]]
[[ja:クリーンアップ]]
[[de:Aufräumarbeiten]]
[[es:Limpieza]]

Cleanup

2016-12-12T11:31:36Z

Marycooch: /* Delete incomplete users after */

{{Server settings}}
An administrator can limit the size of certain tables in the database by setting appropriate options in ''Administration > Site administration > Server > Cleanup''.

==Delete unconfirmed users after==

If you're using [[Email-based self-registration]] users must confirm their account (complete the email registration process) within a certain time-frame. Once the time set here has passed, any account that hasn't been confirmed will be deleted. The default is 7 days.

==Delete incomplete users after==

Once users have confirmed their account, they must complete their profile within the time interval set here.

A ''complete profile'' is one where the following fields have been filled in (are not empty):
*First name
*Last name
*Email address
Just as a reference, given that the firstname, lastname and email are required fields of the [[Upload users]] module, any account created this way is automatically a complete account.

==Disable grade history==

History tracking of changes in grades-related tables may be disabled by checking the ''disablegradehistory'' box.

==Grade history lifetime==

The length of time that the history of changes in grade-related tables is kept may be set (from 30 days to never).

Note for users who have upgraded from earlier versions: The setting 'Keep logs for' is now located in the [[Logging|log store settings]].

==See also==

*Using Moodle [http://moodle.org/mod/forum/discuss.php?d=87795 How do I prune mdl_log table?] forum discussion

[[eu:Garbiketa]]
[[fr:Nettoyage]]
[[ja:クリーンアップ]]
[[de:Aufräumarbeiten]]
[[es:Limpieza]]

Cleanup

2016-12-12T11:23:08Z

Marycooch: copied from 3.2 docs

{{Server settings}}
An administrator can limit the size of certain tables in the database by setting appropriate options in ''Administration > Site administration > Server > Cleanup''.

==Delete unconfirmed users after==

If you're using [[Email-based self-registration]] users must confirm their account (complete the email registration process) within a certain time-frame. Once the time set here has passed, any account that hasn't been confirmed will be deleted. The default is 7 days.

==Delete incomplete users after==
'''Note:''' ''This feature is reported as not working. See https://tracker.moodle.org/browse/MDL-54106.''

Once users have confirmed their account, they must complete their profile within the time interval set here.

A ''complete profile'' is one where the following fields have been filled in (are not empty):
*First name
*Last name
*Email address
Just as a reference, given that the firstname, lastname and email are required fields of the [[Upload users]] module, any account created this way is automatically a complete account.

==Disable grade history==

History tracking of changes in grades-related tables may be disabled by checking the ''disablegradehistory'' box.

==Grade history lifetime==

The length of time that the history of changes in grade-related tables is kept may be set (from 30 days to never).

Note for users who have upgraded from earlier versions: The setting 'Keep logs for' is now located in the [[Logging|log store settings]].

==See also==

*Using Moodle [http://moodle.org/mod/forum/discuss.php?d=87795 How do I prune mdl_log table?] forum discussion

[[eu:Garbiketa]]
[[fr:Nettoyage]]
[[ja:クリーンアップ]]
[[de:Aufräumarbeiten]]
[[es:Limpieza]]

Calendar

2016-11-11T17:24:36Z

Marycooch: removed out of date link

{{More features}}
The calendar can display site (2), course (3), group and or user (1) events in addition to assignment and quiz deadlines, chat times and other course events. Note the colour coding on the screenshot below.

A calendar may be included in a course or the site [[Front page]] by adding a [[Calendar block]] or an [[Upcoming Events block]].

[[File:upcomingeventsnew.png|600px|thumb|center|Click to enlarge]]

*[[Calendar settings]]
*[[Using Calendar]]

==See also==

*[[Calendar FAQ]]

[[Category:Calendar]]

[[ca:Calendari]]
[[de:Kalender]]
[[eu:Egutegia]]
[[fr:Calendrier]]
[[es:Calendario]]

admin/tool/lp/edittemplate

2016-11-08T18:21:37Z

Marycooch: redirected

#Redirect [[Learning plans]]

admin/tool/lp/editcompetencyframework

2016-11-08T18:19:10Z

Marycooch: redirect

#Redirect [[Competency frameworks]]

Moodle Mobile FAQ

2016-11-07T10:46:49Z

Marycooch: communications

{{Mobile}}
==Students==

===How can I get the Moodle Mobile app?===

The Moodle Mobile app is available for free from Google Play and the Apple Store. See [https://download.moodle.org/mobile/ Moodle Mobile downloads] for links. You can also install the app directly from your mobile device by searching for 'Moodle Mobile' with author/owner 'Moodle Pty Ltd'.

===I can't get the app to work. What do I do?===

The Moodle Mobile app will ONLY work with Moodle sites that have been set up to allow it. Please talk to your Moodle administrator if you have any problems connecting.

===What permissions does the app require?===

The app requires the following permissions:

* Record audio - for uploading to your Moodle site
* Read and modify the contents of your SD card - for content to be downloaded to your SD Card for offline access.
* Network access - to be able to connect with your Moodle site and check if you are connected, and if not to switch to offline mode.
* Run at startup - to receive local notifications even when the app is running in the background.
* Prevent phone from sleeping - to receive push notifications anytime.

===I can't see my course on the app. What do I do?===
Check with your course tutor that you are correctly enrolled.

=== Why can't I upload my assignment on the app?===
Check with your Moodle site administrator.

===Why can't I sometimes access the app or submit anything to it?===
This could be because of interruptions in your internet connection. Wait a while and try again. If you continue to have problems, contact your Moodle site administrator.

===Is there a space limit on my files?===
Assignments will have a size limit which you can see. For other space limit questions, check with your Moodle site administrator.

===Who should I contact for help with the app?===
Your Moodle site administrator can assist you in getting the app to work correctly.

==Teachers==

===How can I enable videos in my course to be downloaded?===

See the section 'Media download for offline usage' in [[Creating Moodle Mobile friendly courses]].

===Which course format is it best to use?===

Topics or weekly course format is best suited to mobile devices.

===How do I make YouTube links open automatically in the app?===

Add YouTube links as a [[URL resource]].

===Why can't my students see their courses?====
If you or an administrator have correctly enrolled them in a course, they can see it in their mobile app. If they are correctly enrolled but can still not see their course, ask them to check with your Moodle site administrator.

=== I can't mark assignments in the app?===
Grading assignments is on the [https://docs.moodle.org/dev/Moodle_Mobile_Roadmap roadmap] and will be available shortly.

===What communications tools can I use in the app to engage with my learners?===
See [[Mobile app notifications]]. Chat, forums and messaging are all supported by the app.

==Administrators==

===I can't get the app to work. What can I do?===

Assuming you have enabled mobile services on your site, please check:

# If your site uses an SSL certificate, it must be a trusted certificate, not self-signed. Please use this tool or a similar one to check that your certificate is fine: [https://www.geocerts.com/ssl_checker SSL Checker]. All the checks must be ok, including the "Certificate Chain Complete". Otherwise the app might work on iOS but not on Android.
# [[Debugging]] is disabled (in ''Site administration > Development > Debugging'')
# The ADOdb debug option is disabled if you are using the external database auth or enrolment plugin (in ''Plugins > Authentication > External database'' and in ''Plugins > Enrolment > External database'').

If you still have a problem, please post in the [https://moodle.org/mod/forum/view.php?id=7798 Moodle for mobile forum].

=== I cannot access with old users, but I can with recently created ones! ===

Please, do a "Purge all caches" via the Moodle administration settings, this will solve the problem.

===I can't view the courses tab as an administrator===

The Moodle Mobile app only displays courses you are enrolled in. If you want to view a course as an admin, you need to enrol in it.

===My Moodle site uses a SSO auth method (Shibboleth, CAS, Google OAuth, etc) and the app is not working===

You must install the [[Moodle Mobile additional features]] plugin.

===Error messages===

===='Cannot connect: Verify that you have typed correctly the URL and that your site uses Moodle 2.4 or later'====

Please check:
# Mobile services are enabled for the site.
# The user is entering the correct URL for the site (see FAQ above)
# For https sites, the certificate is valid (see FAQ above)

===='We lost connection; you need to reconnect. Your token is now invalid.' on my custom version of Moodle Mobile ====

Please check:
# You have followed all the steps listed in [[:dev:Moodle Mobile Developing a plugin tutorial|Moodle Mobile Developing a plugin tutorial]]
# You have enabled the moodle/webservice:createtoken capability for the authenticated user

===='No permission to create web service token for the service local_mobile' when attempting to log in as an admin====

You need to create a token for the admin account (only) as follows:

# Go to ''Site administration > Plugins > Web services > Manage tokens''
# Click Add
# Enter the admin username and select 'Moodle Mobile additional features service' (i.e. do NOT leave it as 'Moodle Mobile web service')
# Click the 'Save changes' button.

===='Invalid response value detected' when accessing the site ====

The user quota global setting should be an integer. For more details, see the discussion [https://moodle.org/mod/forum/discuss.php?d=320873 How to enable Moodle Mobile App for all accounts].

===='A required parameter (username) was missing'====

This may happen if your site implements HTTP redirects; the request is redirected by the browser not passing the POST parameters.

Unfortunately, this is something we cannot control in the Mobile app (it can't be handled via JavaScript). For further information, see http://stackoverflow.com/questions/228225/prevent-redirection-of-xmlhttprequest and http://stackoverflow.com/questions/4168784/ajax-redirection-handling

The solution is to change the HTTP redirect and use an HTML page with a meta tag or JavaScript redirect.

===I think I found a bug with the app. What do I do?===

# Log in to the [https://tracker.moodle.org/browse/MOBILE Moodle Mobile tracker] (you'll need to [http://tracker.moodle.org/secure/Signup%21default.jspa create a tracker account] if you've not done so previously)
# Check whether the issue has already been reported by doing a [https://tracker.moodle.org/issues/?jql=project%20%3D%20MOBILE search]
# If not, report the bug by clicking the 'Create Issue' link at the top right of the page, selecting 'Moodle Mobile' as the project
# Add a detailed description, then click the Create button
# Attach the following files to the issue by selecting 'Attach Files' in the 'More actions' dropdown menu:
#* 'Device information' - this can be found in the app (''Settings -> Development -> Device info'', you can send yourself this information by email using the email button at the bottom)
#* App Log (''Settings -> Development -> Show Log'', again you can send yourself this information by email)

==Any further questions?==

Please post in the [http://moodle.org/mod/forum/view.php?id=7798 Moodle for mobile forum] on moodle.org.

[[Category:FAQ]]

[[de:Moodle Mobile FAQ]]
[[ca:Moodle Mobile FAQ]]
[[es:Moodle Mobile FAQ]]
[[fr:Moodle pour les mobiles]]
[[ja:モバイルMoodle FAQ]]

Moodle Mobile FAQ

2016-11-07T10:45:35Z

Marycooch: adding some more FAQs

{{Mobile}}
==Students==

===How can I get the Moodle Mobile app?===

The Moodle Mobile app is available for free from Google Play and the Apple Store. See [https://download.moodle.org/mobile/ Moodle Mobile downloads] for links. You can also install the app directly from your mobile device by searching for 'Moodle Mobile' with author/owner 'Moodle Pty Ltd'.

===I can't get the app to work. What do I do?===

The Moodle Mobile app will ONLY work with Moodle sites that have been set up to allow it. Please talk to your Moodle administrator if you have any problems connecting.

===What permissions does the app require?===

The app requires the following permissions:

* Record audio - for uploading to your Moodle site
* Read and modify the contents of your SD card - for content to be downloaded to your SD Card for offline access.
* Network access - to be able to connect with your Moodle site and check if you are connected, and if not to switch to offline mode.
* Run at startup - to receive local notifications even when the app is running in the background.
* Prevent phone from sleeping - to receive push notifications anytime.

===I can't see my course on the app. What do I do?===
Check with your course tutor that you are correctly enrolled.

=== Why can't I upload my assignment on the app?===
Check with your Moodle site administrator.

===Why can't I sometimes access the app or submit anything to it?===
This could be because of interruptions in your internet connection. Wait a while and try again. If you continue to have problems, contact your Moodle site administrator.

===Is there a space limit on my files?===
Assignments will have a size limit which you can see. For other space limit questions, check with your Moodle site administrator.

===Who should I contact for help with the app?===
Your Moodle site administrator can assist you in getting the app to work correctly.

==Teachers==

===How can I enable videos in my course to be downloaded?===

See the section 'Media download for offline usage' in [[Creating Moodle Mobile friendly courses]].

===Which course format is it best to use?===

Topics or weekly course format is best suited to mobile devices.

===How do I make YouTube links open automatically in the app?===

Add YouTube links as a [[URL resource]].

===Why can't my students see their courses?====
If you or an administrator have correctly enrolled them in a course, they can see it in their mobile app. If they are correctly enrolled but can still not see their course, ask them to check with your Moodle site administrator.

=== I can't mark assignments in the app?===
Grading assignments is on the [https://docs.moodle.org/dev/Moodle_Mobile_Roadmap roadmap] and will be available shortly.

==Administrators==

===I can't get the app to work. What can I do?===

Assuming you have enabled mobile services on your site, please check:

# If your site uses an SSL certificate, it must be a trusted certificate, not self-signed. Please use this tool or a similar one to check that your certificate is fine: [https://www.geocerts.com/ssl_checker SSL Checker]. All the checks must be ok, including the "Certificate Chain Complete". Otherwise the app might work on iOS but not on Android.
# [[Debugging]] is disabled (in ''Site administration > Development > Debugging'')
# The ADOdb debug option is disabled if you are using the external database auth or enrolment plugin (in ''Plugins > Authentication > External database'' and in ''Plugins > Enrolment > External database'').

If you still have a problem, please post in the [https://moodle.org/mod/forum/view.php?id=7798 Moodle for mobile forum].

=== I cannot access with old users, but I can with recently created ones! ===

Please, do a "Purge all caches" via the Moodle administration settings, this will solve the problem.

===I can't view the courses tab as an administrator===

The Moodle Mobile app only displays courses you are enrolled in. If you want to view a course as an admin, you need to enrol in it.

===My Moodle site uses a SSO auth method (Shibboleth, CAS, Google OAuth, etc) and the app is not working===

You must install the [[Moodle Mobile additional features]] plugin.

===Error messages===

===='Cannot connect: Verify that you have typed correctly the URL and that your site uses Moodle 2.4 or later'====

Please check:
# Mobile services are enabled for the site.
# The user is entering the correct URL for the site (see FAQ above)
# For https sites, the certificate is valid (see FAQ above)

===='We lost connection; you need to reconnect. Your token is now invalid.' on my custom version of Moodle Mobile ====

Please check:
# You have followed all the steps listed in [[:dev:Moodle Mobile Developing a plugin tutorial|Moodle Mobile Developing a plugin tutorial]]
# You have enabled the moodle/webservice:createtoken capability for the authenticated user

===='No permission to create web service token for the service local_mobile' when attempting to log in as an admin====

You need to create a token for the admin account (only) as follows:

# Go to ''Site administration > Plugins > Web services > Manage tokens''
# Click Add
# Enter the admin username and select 'Moodle Mobile additional features service' (i.e. do NOT leave it as 'Moodle Mobile web service')
# Click the 'Save changes' button.

===='Invalid response value detected' when accessing the site ====

The user quota global setting should be an integer. For more details, see the discussion [https://moodle.org/mod/forum/discuss.php?d=320873 How to enable Moodle Mobile App for all accounts].

===='A required parameter (username) was missing'====

This may happen if your site implements HTTP redirects; the request is redirected by the browser not passing the POST parameters.

Unfortunately, this is something we cannot control in the Mobile app (it can't be handled via JavaScript). For further information, see http://stackoverflow.com/questions/228225/prevent-redirection-of-xmlhttprequest and http://stackoverflow.com/questions/4168784/ajax-redirection-handling

The solution is to change the HTTP redirect and use an HTML page with a meta tag or JavaScript redirect.

===I think I found a bug with the app. What do I do?===

# Log in to the [https://tracker.moodle.org/browse/MOBILE Moodle Mobile tracker] (you'll need to [http://tracker.moodle.org/secure/Signup%21default.jspa create a tracker account] if you've not done so previously)
# Check whether the issue has already been reported by doing a [https://tracker.moodle.org/issues/?jql=project%20%3D%20MOBILE search]
# If not, report the bug by clicking the 'Create Issue' link at the top right of the page, selecting 'Moodle Mobile' as the project
# Add a detailed description, then click the Create button
# Attach the following files to the issue by selecting 'Attach Files' in the 'More actions' dropdown menu:
#* 'Device information' - this can be found in the app (''Settings -> Development -> Device info'', you can send yourself this information by email using the email button at the bottom)
#* App Log (''Settings -> Development -> Show Log'', again you can send yourself this information by email)

==Any further questions?==

Please post in the [http://moodle.org/mod/forum/view.php?id=7798 Moodle for mobile forum] on moodle.org.

[[Category:FAQ]]

[[de:Moodle Mobile FAQ]]
[[ca:Moodle Mobile FAQ]]
[[es:Moodle Mobile FAQ]]
[[fr:Moodle pour les mobiles]]
[[ja:モバイルMoodle FAQ]]

User tours

2016-10-31T09:22:11Z

Marycooch: CSS selector help

{{Infobox plugin
|type = Local plugin
|entry = https://moodle.org/plugins/local_usertours
|tracker = https://tracker.moodle.org/browse/MDL-52777
|discussion = https://moodle.org/mod/forum/discuss.php?d=335682
|maintainer = Andrew Nicols, Gavin Henrick
|float = right
}}

{{Site appearance}}
The User tours plugin allows administrators to create user tours of Moodle, which are visual and positional step by step guides. Tours can be created for a wide range of purposes: to guide new users around the interface, to introduce new features, highlight important information, and more. It is also enabled to cater for multilingual content if required using the [[Multi-language_content_filter| multi-lang filters]].

==Usage==
Once a user tour has been created and enabled, the first time that any user views a page which matches that user tour’s page (path) settings, the user tour will automatically start to display, starting with the first step. Each tour step will display its title and content, along with three button options:
*Prev - to return to the previous step in the tour
*Next - to go to the next step in the tour
*End Tour - to exit out of the tour completely

Any time a user wishes to re-run the page's tour, they can click on the "Reset user tour on this page" link at the bottom of the page.
[[File:usertour_in_action_screenshot.png|thumb|600px|center]]

==Creating User tours==
#Ensure that the user tours plugin is installed and enabled on your moodle site
#Login to your Moodle site as administrator
# Go to ''Administration > Site administration > Appearance > User tours''.
#You will now see a list of your existing user tours, along with three button options:
##Create a new tour - click on this to create a new tour
##Import tour - click on this to upload a tour file (in .json format)
##Tour repository - click on this to browse the user tours currently listed on our [https://moodle.net/mod/data/view.php?id=17 Moodle.net tour database]
[[File:usertour_listing_page.png|thumb|600px|center]]
#For each of your existing tours, you can click either directly on its name or on its View action icon to view its current listed steps
#Each tour can be individually enabled or disabled as required in its settings page.
#Please note: this plugin does allow you to have multiple tours created for the same page destination, however you should only have one enabled per page at any given time.
#Each tour has the following Actions options:
##View - to view and edit the individual steps in the tour
##Edit - to edit the tour settings, such as its name, page (specified page to which it is applied) and whether it is enabled or not. Tours will be displayed on any page whose URL matches the specified path value, for instance:
###/my/% - to match the Dashboard
###/course/view.php?id=2 - to match a specific course
###/mod/forum/view.php% - to match the forum discussion list
###/user/profile.php% - to match the user profile page
##Export - to export the tour’s full details and steps as a .json file
##Delete - to delete the tour entirely
#Each tour will be configured with default step settings which you can edit in the settings page:
##Placement: Top, Bottom (Default), Left, Right. This determines where the step shows relative to its matching block or CSS selector on the page.
##Show if target not found: No (Default), Yes. This determines whether the step is shown or not when the target has not been found.
##Show with backdrop: No (Default), Yes. If yes, the step appears surrounded by a darkened backdrop to emphasis its content and location.
## Move on click: No (Default), Yes. If yes, the tour continues to the next step when the user clicks within the block or area targeted by the current step.
{{Note|If you want users to be able to fill in forms as they work through the tour, then don't use a backdrop.'''}}
==Adding steps to your User tour==
#In your User tour's View page, you can add, edit, re-order and delete steps for your tour. Either click directly on its name or on its View action icon to view the currently listed steps.
#For instance, here are the initial steps for a sample tour for the Dashboard page.
[[File:usertour steps page.png|thumb|600px|center]]
#Each individual step has the following Actions options:
##Move Up and/or Down as relevant for re-ordering
##Edit - to edit the step settings
##Delete - to delete the step entirely
#To add a new step:
##Click on the 'New step' link.
##Select the appropriate type, or area, of the page to highlight:
###Block - to display next to a matching block on the page
###CSS Selector - to display next to a matching selector on the page
###Display in the middle of the page
##For blocks, select the relevant block from the dropdown
##For CSS selectors, type in the relevant selector to identify the target.
##Add the title and content
##For all types, select whether to display the step with a darkened backdrop
##For blocks or selectors, select the Placement option for where to place the display
##For blocks or selectors, select whether to display the step if its target isn’t found
##For blocks or selectors, select whether to move on click, ie move to next step when target is clicked
##Click on 'Save changes'
##Your new step should now appear at the end of your tour’s current listed steps

===Help with CSS selectors===
If you wish to use CSS selectors as part of your user tour, your browser's developer tools will be very useful in helping you create these selectors:
*[https://developer.chrome.com/devtools#dom-and-styles Google Chrome]
*[https://developer.mozilla.org/en-US/docs/Tools/DOM_Property_Viewer Mozilla Firefox]
*[https://developer.microsoft.com/en-us/microsoft-edge/platform/documentation/f12-devtools-guide/ Microsoft Edge]
*[https://developer.apple.com/library/content/documentation/AppleApplications/Conceptual/Safari_Developer_Guide/ResourcesandtheDOM/ResourcesandtheDOM.html#//apple_ref/doc/uid/TP40007874-CH3-SW1 Apple Safari]

==Multi-language capability==

If your Moodle site is already set up or intending to be enabled for multi-lingual usage, tours are completely compatible with this requirement. Using the multi-lang filter formatting, each tour step’s titles and content, displayed to the user, can be edited to cater for multi-lingual requirements. Please see [[Multi-language_content_filter]] for further detailed instructions on how to enable, format and submit multi-lingual strings for your Moodle site.

Please remember to go to '' Dashboard ► Site administration ► Plugins ► Filters ► Manage filters '' in order to enable the [[Multi-language_content_filter]] before importing any multi-language user tours into your site, or the users will see ALL the texts in ALL the languages simultaneously, as the following image illustrates:

[[File:Multilang user tour when multilang filter NOT properly configured.png|300px]]

When properly configured, a multi-language user tour will be automatically displayed in the user's preferred language, as seen in the following Dashboard tours starting pages in Spanish, English and French (in the same server):

[[File:Multilang user tour in Spanish.png|300px]]

[[File:Multilang user tour in English.png|300px]]

[[File:Multilang user tour in French.png|300px]]

==Translating user tours==
See [https://docs.moodle.org/dev/Translating_User_tours_from_Moodle.net how to translate user tours] in the developer's documentation..

==Sharing is caring==

We really hope that you are able to create some really powerful tours to help guide your users around your site. We certainly think you will and we encourage you to share any of the tours you create with others.

We've created a [https://moodle.net/mod/data/view.php?id=17 Moodle.net tour database] where you can share your creations and also find inspiration from the ideas of others.

This work was paid for and sponsored by the kind folk of [http://www.dcu.ie/ Dublin City University].

==See also==
* Moodle tracker MDL-52777 , about adding this plugin into Moodle 3.2 core

[[es:Tours para Usuarios]]

Jumps

2016-10-29T21:33:16Z

Marycooch: changed branch to content page

{{Lesson}}
Jumps are a unique feature of the Lesson module. Jumps are links and determine what happens after a student makes a choice on a lesson page. There are two basic types of jumps - Relative and Absolute. The teacher uses a pull down menu to see a selection of all possible jumps.

For example, a teacher creates 10 Lesson pages and titles them P1 to P10.

P1, P2, P3, P4, '''P5''', P6, P7, P8, P9, P10.

On P5, the teacher may want to send the student to P7 for one student choice and to "Next Page" for other choices. In this example "P7" is an absolute jump and "Next Page is a relative jump.

== Absolute jumps ==
The absolute jump always goes to the same page that a teacher has created. In our example we used P7.

P1, P2, P3, P4, '''P5''', P6, '''P7''', P8, P9, P10.

Note that the teacher can decide to change the title of "P7" to "Grading" as the page title. The jump from P5 will automatically change.

P1, P2, P3, P4, '''P5''', P6, '''Grading''', P8, P9, P10.

Moving either page will not effect any absolute jumps. In the example below the absolute jump in P5 will now skip 4 pages in the logical order.

P1, P2, '''P5''', P3, P4, P6, P8, '''Grading''', P9, P10.

Pages can have the same title and this can be confusing when setting jumps. For example, it is a good practice to retitle an End of Branch page so you don't end up with 5 pages all called End of Branch.

== Relative jumps ==
These kinds of jumps go to a position or create an effect. In our example, a Next Page jump in P5 is the next page in the logical order of the lesson is P6.

P1, P2, P3, P4, '''P5''', '''P6''', P7, P8, P9, P10.

The teacher may decide that more information is needed for those students going to P6. The teacher can insert a page (called P5-b)immediately after P5 and the Next Page jump will now go to P5-b.

P1, P2, P3, P4, '''P5, P5-b''', P6, P7, P8, P9, P10.

Or the teacher can move another page to the position right after P5, and the Next page jump will go there. In the example below P10 has been moved and it has become the "Next page".

P1, P2, P3, P4, '''P5, P10''', P5-b, P6, P7, P8, P9.

If the teacher moves P5 to another location in the logical order, the relative jump will still look for the "Next page" in our example this will now be P10.

P1, P2, P3, P4, P6, P7, P8, P9, '''P5, P10'''.

Here are a few of the relative jumps that a teacher might find in a Lesson page.

The random relative jumps need to be planned with care. The were designed to be used within a segment of a lesson.

===Next page===
We have covered this relative jump in our above example. It is also the default jump for the first answer of any question or content (branch table) page choices.

===This page===
This page takes the student back to the page they just viewed. Lesson will usually use this jump as a default in most question and content pages, if it didn't use "Next page".

===Previous page===
The page which is in front of the current page in the logical order.

===End of lesson===
The end of lesson is the splash screen a student sees when they have completed the lesson. In the simple lesson, this follows the last page in the logical order. It may show their score, offer a link to the next lesson or just say that they have completed the lesson. This jump is often used as a content page choice to allow the student to end the lesson at that point in the Lesson.

=== Unseen question within a content page ===
This will link to a randomly chosen unseen (by the student in this attempt) question between this content page and the End of the Lesson or the next End of Branch. This might be used in a segment of a lesson, where it is used in as a jump in C2 in the example below. Use with care.

C1, '''C2, Q1, Q2, Q3, EoB''', C3, C4, C5, Q4, C6.

=== Random question within a content page ===
This will link to a randomly chosen question between the current content page and the End of Lesson or the next End of Branch. If the student has already seen the question and attempts are greater than 1, they will get another chance to earn the point(s) for that question. If attempts are set to 1, the question will be skipped and another random question shown. Use with care.

C1, '''C2, Q1, Q2, Q3, EoB''', C3, C4,C5, Q4,C6.

=== Random content page ===
This will jump to a random Content page between the current Content page and the End of Lesson or the next End of Branch. It is used in a segment and is a jump in C2 shown below. Use with care.

C1, '''C2, C3, C4, C5 EoB''', Q1, Q2, Q3, Q4, C6.

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

[[fr:Sauts]]
[[de:Spr%C3%BCnge]]
[[ja:ジャンプ]]

Jumps

2016-10-29T21:30:52Z

Marycooch: /* Unseen question within a conteng page */

{{Lesson}}
Jumps are a unique feature of the Lesson module. Jumps are links and determine what happens after a student makes a choice on a lesson page. There are two basic types of jumps - Relative and Absolute. The teacher uses a pull down menu to see a selection of all possible jumps.

For example, a teacher creates 10 Lesson pages and titles them P1 to P10.

P1, P2, P3, P4, '''P5''', P6, P7, P8, P9, P10.

On P5, the teacher may want to send the student to P7 for one student choice and to "Next Page" for other choices. In this example "P7" is an absolute jump and "Next Page is a relative jump.

== Absolute jumps ==
The absolute jump always goes to the same page that a teacher has created. In our example we used P7.

P1, P2, P3, P4, '''P5''', P6, '''P7''', P8, P9, P10.

Note that the teacher can decide to change the title of "P7" to "Grading" as the page title. The jump from P5 will automatically change.

P1, P2, P3, P4, '''P5''', P6, '''Grading''', P8, P9, P10.

Moving either page will not effect any absolute jumps. In the example below the absolute jump in P5 will now skip 4 pages in the logical order.

P1, P2, '''P5''', P3, P4, P6, P8, '''Grading''', P9, P10.

Pages can have the same title and this can be confusing when setting jumps. For example, it is a good practice to retitle an End of Branch page so you don't end up with 5 pages all called End of Branch.

== Relative jumps ==
These kinds of jumps go to a position or create an effect. In our example, a Next Page jump in P5 is the next page in the logical order of the lesson is P6.

P1, P2, P3, P4, '''P5''', '''P6''', P7, P8, P9, P10.

The teacher may decide that more information is needed for those students going to P6. The teacher can insert a page (called P5-b)immediately after P5 and the Next Page jump will now go to P5-b.

P1, P2, P3, P4, '''P5, P5-b''', P6, P7, P8, P9, P10.

Or the teacher can move another page to the position right after P5, and the Next page jump will go there. In the example below P10 has been moved and it has become the "Next page".

P1, P2, P3, P4, '''P5, P10''', P5-b, P6, P7, P8, P9.

If the teacher moves P5 to another location in the logical order, the relative jump will still look for the "Next page" in our example this will now be P10.

P1, P2, P3, P4, P6, P7, P8, P9, '''P5, P10'''.

Here are a few of the relative jumps that a teacher might find in a Lesson page.

The random relative jumps need to be planned with care. The were designed to be used within a segment of a lesson.

===Next page===
We have covered this relative jump in our above example. It is also the default jump for the first answer of any question or content (branch table) page choices.

===This page===
This page takes the student back to the page they just viewed. Lesson will usually use this jump as a default in most question and content pages, if it didn't use "Next page".

===Previous page===
The page which is in front of the current page in the logical order.

===End of lesson===
The end of lesson is the splash screen a student sees when they have completed the lesson. In the simple lesson, this follows the last page in the logical order. It may show their score, offer a link to the next lesson or just say that they have completed the lesson. This jump is often used as a content page choice to allow the student to end the lesson at that point in the Lesson.

=== Unseen question within a content page ===
This will link to a randomly chosen unseen (by the student in this attempt) question between this content page and the End of the Lesson or the next End of Branch. This might be used in a segment of a lesson, where it is used in as a jump in C2 in the example below. Use with care.

C1, '''C2, Q1, Q2, Q3, EoB''', C3, C4, C5, Q4, C6.

=== Random question within a branch ===
This will link to a randomly chosen question between the current content page and the End of Lesson or the next End of Branch. If the student has already seen the question and attempts are greater than 1, they will get another chance to earn the point(s) for that question. If attempts are set to 1, the question will be skipped and another random question shown. Use with care.

C1, '''C2, Q1, Q2, Q3, EoB''', C3, C4,C5, Q4,C6.

=== Random branch table ===
This will jump to a random Content page between the current Content page and the End of Lesson or the next End of Branch. It is used in a segment and is a jump in C2 shown below. Use with care.

C1, '''C2, C3, C4, C5 EoB''', Q1, Q2, Q3, Q4, C6.

==Lesson jump pulldown example==
[[Image:Lesson Jump pulldown 3.JPG|center]]

Here is a pull down of jumps in a demo lesson for 1.8. Notice the relative and absolute pages. The relative pages are listed at the top and the absolute pages underneath them. Depending upon the current pages in a Lesson, some of the relative jumps may not be shown.

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

[[fr:Sauts]]
[[de:Spr%C3%BCnge]]
[[ja:ジャンプ]]

Jumps

2016-10-29T21:30:40Z

Marycooch: updated

{{Lesson}}
Jumps are a unique feature of the Lesson module. Jumps are links and determine what happens after a student makes a choice on a lesson page. There are two basic types of jumps - Relative and Absolute. The teacher uses a pull down menu to see a selection of all possible jumps.

For example, a teacher creates 10 Lesson pages and titles them P1 to P10.

P1, P2, P3, P4, '''P5''', P6, P7, P8, P9, P10.

On P5, the teacher may want to send the student to P7 for one student choice and to "Next Page" for other choices. In this example "P7" is an absolute jump and "Next Page is a relative jump.

== Absolute jumps ==
The absolute jump always goes to the same page that a teacher has created. In our example we used P7.

P1, P2, P3, P4, '''P5''', P6, '''P7''', P8, P9, P10.

Note that the teacher can decide to change the title of "P7" to "Grading" as the page title. The jump from P5 will automatically change.

P1, P2, P3, P4, '''P5''', P6, '''Grading''', P8, P9, P10.

Moving either page will not effect any absolute jumps. In the example below the absolute jump in P5 will now skip 4 pages in the logical order.

P1, P2, '''P5''', P3, P4, P6, P8, '''Grading''', P9, P10.

Pages can have the same title and this can be confusing when setting jumps. For example, it is a good practice to retitle an End of Branch page so you don't end up with 5 pages all called End of Branch.

== Relative jumps ==
These kinds of jumps go to a position or create an effect. In our example, a Next Page jump in P5 is the next page in the logical order of the lesson is P6.

P1, P2, P3, P4, '''P5''', '''P6''', P7, P8, P9, P10.

The teacher may decide that more information is needed for those students going to P6. The teacher can insert a page (called P5-b)immediately after P5 and the Next Page jump will now go to P5-b.

P1, P2, P3, P4, '''P5, P5-b''', P6, P7, P8, P9, P10.

Or the teacher can move another page to the position right after P5, and the Next page jump will go there. In the example below P10 has been moved and it has become the "Next page".

P1, P2, P3, P4, '''P5, P10''', P5-b, P6, P7, P8, P9.

If the teacher moves P5 to another location in the logical order, the relative jump will still look for the "Next page" in our example this will now be P10.

P1, P2, P3, P4, P6, P7, P8, P9, '''P5, P10'''.

Here are a few of the relative jumps that a teacher might find in a Lesson page.

The random relative jumps need to be planned with care. The were designed to be used within a segment of a lesson.

===Next page===
We have covered this relative jump in our above example. It is also the default jump for the first answer of any question or content (branch table) page choices.

===This page===
This page takes the student back to the page they just viewed. Lesson will usually use this jump as a default in most question and content pages, if it didn't use "Next page".

===Previous page===
The page which is in front of the current page in the logical order.

===End of lesson===
The end of lesson is the splash screen a student sees when they have completed the lesson. In the simple lesson, this follows the last page in the logical order. It may show their score, offer a link to the next lesson or just say that they have completed the lesson. This jump is often used as a content page choice to allow the student to end the lesson at that point in the Lesson.

=== Unseen question within a conteng page ===
This will link to a randomly chosen unseen (by the student in this attempt) question between this content page and the End of the Lesson or the next End of Branch. This might be used in a segment of a lesson, where it is used in as a jump in C2 in the example below. Use with care.

C1, '''C2, Q1, Q2, Q3, EoB''', C3, C4, C5, Q4, C6.

=== Random question within a branch ===
This will link to a randomly chosen question between the current content page and the End of Lesson or the next End of Branch. If the student has already seen the question and attempts are greater than 1, they will get another chance to earn the point(s) for that question. If attempts are set to 1, the question will be skipped and another random question shown. Use with care.

C1, '''C2, Q1, Q2, Q3, EoB''', C3, C4,C5, Q4,C6.

=== Random branch table ===
This will jump to a random Content page between the current Content page and the End of Lesson or the next End of Branch. It is used in a segment and is a jump in C2 shown below. Use with care.

C1, '''C2, C3, C4, C5 EoB''', Q1, Q2, Q3, Q4, C6.

==Lesson jump pulldown example==
[[Image:Lesson Jump pulldown 3.JPG|center]]

Here is a pull down of jumps in a demo lesson for 1.8. Notice the relative and absolute pages. The relative pages are listed at the top and the absolute pages underneath them. Depending upon the current pages in a Lesson, some of the relative jumps may not be shown.

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

[[fr:Sauts]]
[[de:Spr%C3%BCnge]]
[[ja:ジャンプ]]

Competencies FAQ

2016-10-27T10:10:53Z

Marycooch: more than one competency per course or activity

{{Competencies}}

==Can a competency be added to more than one course or activity?==
Definitely - and your organisation might well need to do this, if certain competencies need to be met in a series of courses or several activities within one course.
==I can't see evidence uploaded by my students==
*Are you a course teacher? You will not be able to see evidence of prior learning unless your administrator has given you a role with the capability moodle/competency:userevidenceview set to ''Allow'' .
==How does 'Attach evidence' work?==
*A teacher can set "Attach evidence" as an option when an activity or a course is completed. Once an activity or course has been completed, the activity or course in question will display as Evidence at the bottom of the competency in question in a student's learning plan. A manager or other user with the capability moodle/competency:userevidenceview set to ''Allow'' will be able to see this evidence.

[[File:evidencedisplayed.png|center]]

*However, they will not be alerted that the evidence is available, so the student should request a review, as below.
==How does "Request review" work?==
* A student can request a review of a competency, for example if they have submitted a piece of work as attached evidence and they wish to alert their course tutor to this. The student accesses the competencies from their learning plan and clicks'"Request review" from the Edit menu.
[[File:studentrequestreview.png|center]]
*The student will then see 'waiting for review' next to that competency.
*The course tutor/supervisor or anyone who is [[Capabilities/moodle/competency:usercompetencyreview| allowed to review competencies]] will see the request from the learning plans block on their dashboard:
[[File:sendforreview1.png|center]]
*They click the link to access the student's requested competency and (''1 in screenshot below'') click to start the review.
*When the review is in progress, the words the student sees change from 'waiting for review' to 'in review'.
*The course tutor can then review the evidence (''2 in screenshot below'') and then (''3'') click to finish the review. The message 'in review' no longer displays for the student.
*The course tutor can then rate the competency if required ''(4):''
[[File:sendforreview2.png|center|thumb|600px]]

==How do teachers rate competencies?==
Competencies may be met automatically upon activity completion (with the 'Default' scale as above) or teachers may rate competencies manually with a customised 'Proficient' scale.
*A teacher accesses the [[Competency breakdown report]], selects a student and clicks on a particular competency which has not yet been rated:
[[File:ratecompetencies12.png|center]]
*The teacher then clicks the 'Rate' button:
[[File:ratecompetencies2.png|center]]
*The teacher then chooses from the desired rating from the available options:
[[File:ratecompetencies3.png|center]]
*Once saved, the Proficient scale will change if the competency was met:
[[File:ratecompetencies4.png]]
*The competency breakdown report will reflect this, using the wording of the scale:
[[File:ratecompetencies5.png|center]]
*In the example below, the first competency was manually rated "Highly competent"; the second competency was automatically met upon activity completion and the third competency was manually rated "Not competent".
[[File:ratecompetencies6.png|center]]

==I can't see the Learning plans block==
*Are you a course teacher? You will not be able to see the [[Learning plans block]] unless your administrator has set the capability block/lp:view to Allow for teachers. However, administrators additionally need to set other capabilities in the system context relating to viewing learning plans and evidence for the block to display any useful information.
*It might be helpful to create a custom role, such as 'Supervisor', with the capabilities you wish to allow in the system context.
*If students have no learning plans, or if teachers/supervisors have no competencies needing reviewing, then the Learning plans block is not visible when editing is not turned on.

== I can't see competencies when trying to add them to a learning template==
Make sure you are in the right part of the site. If you added competencies to a category you will need to add the learning template to that category. If you added competencies to the system you will need to add your learning plan template to the system.

==The learning plan shows all competencies met but the course competencies screen shows some are still incomplete.==
*Competencies exist outside a course,so it might be that the competency has been met in another course but not the one you are in
*If a manager or other user who is [[Capabilities/moodle/competency:usercompetencyreview| allowed to review competencies]] chooses to ''rate'' a competency from the learning plan, then the competency will not show as complete inside the course, but it will display as complete in the learning plan.

==The progress bar shows 100% complete but the learning plan is not marked complete.==
*A learning plan does not automatically display as "complete" once all competencies have been met.
*It may be manually marked as complete by a user with the relevant capabilities - or -
* a due date may be set for completion when a learning plan template is created.
==What is the difference between 'default' and 'proficient' when setting up scales in a competency framework?==
*The default value is what is displayed in the breakdown report and for a student in their learning plan when a competency is automatically met upon activity completion. In the example below, 'competent" will display when a student completes a task satisfactorily.
*Items in the Proficient list can be displayed when a teacher rates a competency manually. There may be several different levels which can all be competent. In the example below, 'Just competent','Competent' or 'Highly competent' will result in the student achieving that competency:
[[File:levels.png|center|Custom competency scale]]

Note that the above is a custom created scale.

==How can students create their own learning plans?==
*If authenticated users have the capability ''[[Capabilities/moodle/competency:planviewowndraft|competency:planviewowndraft]]'' set to "Allow then they will see a button "Add new learning plan" when they access their learning plans from their profile.
*They can then create a draft learning plan and request a review of it by a manager or other user with the capability ''[[Capabilities/moodle/competency:planmanagedraft|moodle/competency:planmanagedraft]]''.

==How can I export or import competency frameworks?==
To export and import competency frameworks you need a plugin, for example the [https://moodle.org/plugins/tool_lpimportcsv Import competency framework admin tool.] See this [https://vimeo.com/181755841 video on .csv import and export] courtesy of Bernadette Parry of eWorks. See the plugins directory for [https://moodle.org/plugins/search.php?s=competency+framework&search=Search+plugins other import and export plugins.]

[[de:Kompetenzen FAQ]]
[[es:Competencias FAQ]]

Choice FAQ

2016-10-26T11:34:54Z

Marycooch: forum ref

{{Choice}}

==How can I enable users to participate in a front page choice activity?==

To enable logged-in users to participate in a front page choice activity:
# Click the edit icon of the Choice
# In the Settings block for the Choice, click ''Permissions''
# From the dropdown ''Advanced role override'', choose "authenticated user"
# Set the capability [[Capabilities/mod/choice:choose|mod/choice:choose]] to allow
# Click the 'Save changes' button

==Can I allow users to make more than one choice?==
Yes - see [[Choice settings]].

==Can I offer users just one option to select?==
Yes!
==All my choices say "full" and nobody is able to answer!==
Make sure if you selected "Yes" to "Limit the number of responses allowed" that you changed the limits number to greater than zero - otherwise the choice will be full before anyone can select.

[[File:choicelimit.png|center]]

==Can I use images or other file types as choice options instead of text?==

Yes. To do this, first upload your images or sound files (mp3) or video files to the internet and ensure the admin has unticked 'Remove HTML tags from all activity names' from ''Site administration>Appearance>HTML settings''.

#Copy the URL (web address) of the files you want to display.
#Paste it into a text editor like notepad (''This is not essential but makes it easier to add the code'')
#To display an image, add this code either side of your image URL:
<img src="YOUR_IMAGE_.jpg">
#To display a sound or video file -first ensure your site admin has multimedia plugins/filters enabled
#Add this code either side of your sound or video file:
<a href="YOUR_SOUND_FILE.mp3"></a>
#Set up your choice as normal and in the options boxes, paste the relevant code+URL.
'''Beware!''' Double check before you paste - any extra or missing space or bit of code and it won't work. See also this [https://moodle.org/mod/forum/discuss.php?d=341975#p1378404 forum thread on Choice with images] for potential issues elsewhere on your site.

==See also==

Moodle forum discussions:
*Using Moodle [http://moodle.org/mod/forum/view.php?id=735 Choice module forum]

* [[Group choice activity]] additional plugin for Moodle 2.2 to 3.0
* [[Choice Results]] - This guide takes you through setting up a Moodle web service to view live choice results in a real time dynamic graph - so replacing the clicker requirement and using the students' own mobile devices instead.

[[Category:FAQ]]
[[de:Abstimmung FAQ]]
[[es:Elección FAQ]]
[[fr:FAQ sur le sondage]]

Choice FAQ

2016-10-25T09:21:36Z

Marycooch: clarifying

{{Choice}}

==How can I enable users to participate in a front page choice activity?==

To enable logged-in users to participate in a front page choice activity:
# Click the edit icon of the Choice
# In the Settings block for the Choice, click ''Permissions''
# From the dropdown ''Advanced role override'', choose "authenticated user"
# Set the capability [[Capabilities/mod/choice:choose|mod/choice:choose]] to allow
# Click the 'Save changes' button

==Can I allow users to make more than one choice?==
Yes - see [[Choice settings]].

==Can I offer users just one option to select?==
Yes!
==All my choices say "full" and nobody is able to answer!==
Make sure if you selected "Yes" to "Limit the number of responses allowed" that you changed the limits number to greater than zero - otherwise the choice will be full before anyone can select.

[[File:choicelimit.png|center]]

==Can I use images or other file types as choice options instead of text?==

Yes. To do this, first upload your images or sound files (mp3) or video files to the internet and ensure the admin has unticked 'Remove HTML tags from all activity names' from ''Site administration>Appearance>HTML settings''.

#Copy the URL (web address) of the files you want to display.
#Paste it into a text editor like notepad (''This is not essential but makes it easier to add the code'')
#To display an image, add this code either side of your image URL:
<img src="YOUR_IMAGE_.jpg">
#To display a sound or video file -first ensure your site admin has multimedia plugins/filters enabled
#Add this code either side of your sound or video file:
<a href="YOUR_SOUND_FILE.mp3"></a>
#Set up your choice as normal and in the options boxes, paste the relevant code+URL.
'''Beware!''' Double check before you paste - any extra or missing space or bit of code and it won't work.

==See also==

Moodle forum discussions:
*Using Moodle [http://moodle.org/mod/forum/view.php?id=735 Choice module forum]

* [[Group choice activity]] additional plugin for Moodle 2.2 to 3.0
* [[Choice Results]] - This guide takes you through setting up a Moodle web service to view live choice results in a real time dynamic graph - so replacing the clicker requirement and using the students' own mobile devices instead.

[[Category:FAQ]]
[[de:Abstimmung FAQ]]
[[es:Elección FAQ]]
[[fr:FAQ sur le sondage]]

Teacher role

2016-10-20T14:18:45Z

Marycooch: /* Assigning The Teacher Role category or sitewide */

{{Standard roles}}
==Teacher role==

Teachers can do almost anything within a course, including adding or changing the activities and grading students. By default, teachers can also assign a [[Non-editing teacher role]] and a [[Student role]] to other users. (To allow teachers to enrol other teachers, see [[Assign roles]]

By default users are not assigned the role of Teacher throughout the site, but are only assigned (enrolled) as a teacher to a single course/class at a time. The same applies to students. Teachers can only teach in the courses they have been enrolled in. (If you really need your teacher to access all courses, see #13 of [[Roles FAQ]]

==Enrolling a user as a teacher in a course==

# As a manager or administrator, go to ''Administration > Course administration > Users > Enrolled users''
# Click the 'Enrol users' button at the top right or bottom left of the page
# From the 'Assign roles' dropdown choose the teacher role
# Select enrolment options as appropriate
# Browse or search for the user
# Click the Enrol button opposite the user. The user will indent in the list and the enrol button will disappear, indicating that the user is enrolled.
# When you have finished, click the 'Finish enrolling users' button (or simply close the enrol users box)

The user will then appear in the list of enrolled users and will no longer be available in the search list.

For more information on manually enrolling teachers, see [[Manual enrolment]]

==Changing Teacher Permissions==
''Note: if you need to modify the Teacher role significantly, it is advisable to create a new role rather than editing the default teacher role. See [[Creating custom roles]]
''

If you really need to change the default Teacher role, go to ''Administration>Site administration>Users>Permissions>Define roles.'' In the right pane you will see Manage Roles with a list of user roles. To the right of the teacher description, click on the edit icon.

From the Editing role 'Teacher' page you can change what a teacher can or cannot do by checking or unchecking the Allow check-boxes under Capability/Permission. Be careful what you allow a teacher to do here. Consider the security vulnerabilities of giving a teacher an inappropriate permission. Only give the teacher permissions that are necessary or appropriate. To the right of many of the Allow check boxes are colored triangles the notify you of possible security warnings for each choice. Use those warnings to help you decide which permissions you will or won't give to your teachers.

==Assigning The Teacher Role category wide==
As stated above, by default teachers are not given the role of teacher. However, under some conditions (such as for homeschool parents) you may want to assign a user, or some users, the role of teacher for all the courses in one category, or for all the courses in your whole site without having to enroll as a teacher for each class. If so, you can (If necessary, add a new role and) give that permission on this same ''Editing role 'Teacher''' page, under ''Role archetype''. Under ''Context types where this role may be assigned'' check whichever apply.
* ''Course'': (Default setting-already checked) allows you to enroll a teacher to a specific course.
* ''Category'': (Allows the user to be a teacher in any course contained in the specific category).If you click on the check-box for ''Category'', it enables a user to access all the courses in a particular category or multiple categories (depending to which they are assigned). To assign a Teacher to a ''Category'', navigate to that category, then use the ''Administration'' menu to ''Assign roles''. (If you are not inside the category the ''Assign roles'' menu item will not show.) If you want one Teacher to apply to all the Course Categories, then navigate to every category and Assign roles for each category.

If you want to give only some teachers these privileges, you may want to create another Teacher role that gives those permissions only to those trusted teachers who have been assigned that role.

== See also ==
* For more information about why we use the label of "Teacher" see the [http://moodle.org/mod/forum/discuss.php?d=43024 Why "teacher" discussion]

[[eu:Irakaslea]]
[[fr:Enseignant]]
[[it:Docente]]
[[ja:教師]]
[[zh:教师]]
[[de:Trainer-Rolle]]
[[es:Rol de profesor]]

Add a new user

2016-10-14T07:59:47Z

Marycooch: removed

{{Accounts}}
==Adding new users==
An administrator or manager (or any other user with the capability [[Capabilities/moodle/user:create|moodle/user:create]]) can create new user accounts in Site administration > Users > Accounts > Add a new user''. (To add users in bulk, see [[Upload users]].)

[[File:26manualreg.png]]

==General==

===Username===
The user will use this username to log in to the Moodle instance. It needs to be unique. This may be changed. A user's name can only contain alphabetical letters in lowercase, numbers, hyphen '-', underscore '_', period '.', or an at character '@' - unless you enable 'Allow extended characters in usernames' ( ''Site Administration > Security > Site Policies'')

===Authentication method===
The setting specifies how Moodle will check whether the user's specified password is correct.

Accounts created by an administrator use the '''Manual Accounts''' method, and accounts created by the user themselves using the email sign-up method use the E-mail based self-registration method.

===Suspended account===

Suspended user accounts cannot log in or use web services, and any outgoing messages are discarded.

===Generate password and notify user===
Moodle will generate a temporary password and email the user with instructions on how to log in and change it. The email message (as in the screenshot below)may be changed in ''Site administration>Administration>Language>Language settings.'' Select 'moodle.php' and the string identifier ''newusernewpasswordtext''
{|
|[[File:26emailpassword.png|thumb|new user email]]
|
|[[File:26changepasswordmessage.png|thumb|How to change the default message]]
|}

===Password===
This is the user's password. It is subject to the password policy in [[Site policies]]. A user can change their password via ''User menu > Preferences''.

===First Name===
The user's first name. It is displayed along with the last name in messages, forum posts, participants list, reports and anywhere where something about the user is shows on the page.

===Surname===
The user's surname. It is displayed along with the first name in messages, forum posts, participants list, reports and anywhere where something about the user is shows on the page.

===Email address===
Password reset notices, forum digests and other messages are sent to this email address from the Moodle site.

'''New in 3.0:''' Duplicate email addresses may be allowed if the setting 'Allow accounts with the same email' is enabled in ''Site administration > Plugins >Authentication >Manage authentication.''

===Email display===
This setting controls who can see the user's email address.

===Email format===
This setting can be used such that Moodle will send text-only emails to the user.

===Email digest type===
This setting set whether the user will receive an email for each new forum post in subscribed forums, or if new posts should be sent once per day in a digest, and which type of digest.
* No digest (one receives individual emails),
* Complete (a single digest daily) or
* Subjects (a single digest daily with only the post topics included).

===Forum auto-subscribe===
If a user subscribes to a forum, new posts will be sent in the digest as specified. This setting sets whether a user is automatically subscribed to forums or if a manual click on the subscription button in each forum is required.

===Forum tracking===
THis setting specifies whether new posts written since the user's last visit should be highlighted as such.

===When editing text===
This setting specifies whether the user prefers to see the WYSIWYG text editor or just a plain text box.

===Screen Reader===
Enabling this setting will improve the display of Moodle to make it more compatible with screen readers.

===City/town===
The user's city or town

===Country===
The user's country

Note: City and country defaults may be set in ''Administration > Site administration > Location > Location settings''.

===Timezone===
This setting is used to adjust the times of messages and assignment/quiz due dates to match the user's local time

===Description===
Information about the user that other users can see.

==User Picture==
The user's picture can be displayed next to the user's name next to any content he/she has posted in Moodle activities such as the forum. See [[User pictures]] for details.

==Interests==
The list of interests can be used as a way of connecting users with similar interests. [[Tags]] must be enabled on the site.

==Optional==
There are several optional fields that come with an standard install. These include:
Web Page, ICA number, Skype ID, AIM ID, Yahoo ID, MSN ID, ID number, Institution, Department, Phone, Mobile Phone, Address.

The site administrator may [[User profile fields|add more custom fields]] and/or turn off any of these "optional" fields.

[[de:Nutzer/in neu anlegen]]
[[es:Añadir un nuevo usuario]]

Using restrict access

2016-10-11T11:34:08Z

Marycooch: /* Gamification */

{{Restrict access}}
==A basic example==
Students are required to undertake 4 tasks in a precise order. According to their score in a quiz, the fourth task - a Moodle lesson - is either at a lower or more advanced level. They must
*view a page explaining the course
*post an introductory message in a forum
*take a quiz
* move onto a lesson tailored to their performance in the quiz.
Here is the teacher view.

[[Image:condactlinks.png|teacher view of sequence of conditional activities]]

Students will only see the first task (the webpage)with the second task (the forum) greyed out. The other tasks only appear once the conditions have been met.

[[File:studentcondactlinks.png]]

''How's it done?''

* Task 1, the page must be read (or at least viewed) before students can access the forum. In task 1 the activity completion condition is set to ''require view''
[[Image:usermustviewactivity.png|"require view" condition]]
*Task 2, the forum, needs to have the restrictions set such that the page ''Read This First'' must be marked complete. The "open" eye icon means the forum is greyed out until available:
[[Image:CAactivitycompletion1a.png|"must be marked complete"/greyed out"]]
*Task 2, the forum, needs to require students to make a post before they can do the quiz. The activity completion condition is set to " require posts"
[[Image:CA1a.png|"require posts"]]
*Task 3, the quiz, needs to have the restrictions set such that the forum must be marked complete. The "crossed out eye" icon means the quiz is completely hidden until a student has posted in the forum:
[[Image:CAactivitycompletion2a.png|"must be marked complete/hide activity entirely"]]
*The student must get a grade in the quiz for the activity to be complete:
[[Image:quizrequiregrade.png|"require grade"]]
*Task 4 is two lessons - either at level 1 (basic) or level 2 (advanced). If the student scores less than 50% in the quiz they do Level 1; if they score more, they do Level 2. In the Level 1 lesson, the restriction is set such that students can only access it if they get under 50% in the quiz
[[Image:Gradecompletion1.png|grade completion]]

The Level 2 lesson has the restriction set such that students can only access it if they get 50% or more:

[[Image:Gradecompletion2.png|grade completion]]

==An example of "all or any"==
*It's possible to set conditions such that a particular activity is available if one or more previous activities are marked complete, rather than all of them. In this screenshot, the Advanced task will become available either if the student gets above a certain grade in the quiz or if they receive a grade in the assignment.

[[File:eitheror1a.png]]

*When the first restriction is set, the teacher can then click the "Add restriction" button again to add a second (and subsequent) restrictions. The teacher can then change the "all" to "any" , thus changing the "and" to "or":

[[File:eitheror2.png]]

==An example of a Restriction set==
*The Restriction set button offers the possibility of creating several criteria using ''all/any'' to create complex conditions. In the screenshot below, students can only access the Assessment and Feedback section of the course if they have EITHER completed the work on Monet OR if they completed all the work on Pissarro.

[[File:restrictaccesslinks.png]]

*The actual settings for this are as follows:

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

==Tricks and techniques==

With a bit of lateral thinking, you can achieve some interesting results beyond the most obvious uses of the system. Here is one example:

===Project allocation===

Imagine that you let students choose one of two projects. Each project has its own activities (a forum for all the people doing that project, resources with information about the project, etc). You want it to hide all the activities that a student isn't doing.

This can already be achieved in Moodle using the [[Groupings]] system. However, conditional activities gives another way to set this up which might be preferable in some cases. Here's how:

# Create two forums called 'Frog project sign-up forum' and 'Zombie project sign-up forum'.
# Set both forums to be automatically marked complete once the user makes 1 post.
# Set each forum to be conditionally available only if the other forum is NOT complete.
# Create other activities for the frog and zombie projects. For each Frog activity, set it to be conditionally available only if the Frog sign-up forum is marked complete. For each Zombie activity, set it to be conditionally available only if the Zombie sign-up forum is marked complete.

When a student first visits the site, they see the frog and zombie sign-up forums and none of the project activities. As soon as they post in one of the forums, the other forum will disappear, and all the activities for their preferred project will appear. (If they want to change their mind, they can delete their forum post so that it isn't marked complete any more, and it'll be back to square one.)

==Gamification==
Many Moodlers are using Restrict access as a means to "gamify" their course. This section is for sharing examples and ideas:
*[https://moodle.org/mod/forum/discuss.php?d=263547 Now you see it; now you don't ]- forum post
*[http://www.slideshare.net/ghenrick/gamification-what-is-it-and-what-it-is-in-moodle What is Gamification and what is it in Moodle?]- presentation by Gavin Henrick
* [https://www.youtube.com/watch?v=E3794YBja6Q Gamify your Moodle courses in under 20 minutes] (using [[Restrict access]] and [[Badges]]) video on YouTube
* [[Quizventure_activity|Quizventure activity]] - an activity module that loads questions from the course it's added to. The possible answers come down as space ships and you have to shoot the correct one.
* [[Level up! quick guide|Level Up!]] - a customisable block which a teacher can add to a course to give experience points to students as they progress through a course.
* [[blocks/stash|Stash]] - a block that allows a teacher to create and then show items around a course. Students can then go and collect these items which will then appear in their stash block.
* [[Game module|Game module]] - This module contains 8 games: hangman, crosswords, cryptex, millionaire, sudoku, hidden picture, snakes& ladders and book with questions.
* [[Exabis games activity]] - the goal of this activity is to bring the aspect of game-based-learning into Moodle-courses.
* [[PhET simulations]] - interactive simulations for science ([[Physics|physics]], [[Biology|biology]], [[Chemistry|chemistry]], Earth sciences) and [[Mathematics|math]] at elementary, middle school, high school and University levels.

== Should you really use restrict access?==

The restrict access feature is a way for you to force your students to do things in a certain order. Is that really what you want? The answer will depend on your particular circumstances, but it is worth taking a moment to reflect upon the degree to which restricting access is appropriate for your course.It is certainly good course design to make it clear to your students what they are expected to do next, to give good guidance. Restricting access can be used to create alternative pathways and to introduce repetition. As course sizes grow, such mechanisms can allow teachers to offer learning experiences that cater more to individuals, providing reinforcement when it is needed. However, some may still prefer to use labels and layout rather than locks and keys to direct the learning path.

==See also==

*Forum thread [https://moodle.org/mod/forum/discuss.php?d=231400 Conditional by number of days] for using post threshold blocking to restrict access to topics by days.

[[Category:Game]]

[[de:Einsatzszenarien für Voraussetzungen]]
[[es:Usando restringir acceso]]

Using restrict access

2016-10-11T11:32:37Z

Marycooch: changed conditional activities to Restrict access

{{Restrict access}}
==A basic example==
Students are required to undertake 4 tasks in a precise order. According to their score in a quiz, the fourth task - a Moodle lesson - is either at a lower or more advanced level. They must
*view a page explaining the course
*post an introductory message in a forum
*take a quiz
* move onto a lesson tailored to their performance in the quiz.
Here is the teacher view.

[[Image:condactlinks.png|teacher view of sequence of conditional activities]]

Students will only see the first task (the webpage)with the second task (the forum) greyed out. The other tasks only appear once the conditions have been met.

[[File:studentcondactlinks.png]]

''How's it done?''

* Task 1, the page must be read (or at least viewed) before students can access the forum. In task 1 the activity completion condition is set to ''require view''
[[Image:usermustviewactivity.png|"require view" condition]]
*Task 2, the forum, needs to have the restrictions set such that the page ''Read This First'' must be marked complete. The "open" eye icon means the forum is greyed out until available:
[[Image:CAactivitycompletion1a.png|"must be marked complete"/greyed out"]]
*Task 2, the forum, needs to require students to make a post before they can do the quiz. The activity completion condition is set to " require posts"
[[Image:CA1a.png|"require posts"]]
*Task 3, the quiz, needs to have the restrictions set such that the forum must be marked complete. The "crossed out eye" icon means the quiz is completely hidden until a student has posted in the forum:
[[Image:CAactivitycompletion2a.png|"must be marked complete/hide activity entirely"]]
*The student must get a grade in the quiz for the activity to be complete:
[[Image:quizrequiregrade.png|"require grade"]]
*Task 4 is two lessons - either at level 1 (basic) or level 2 (advanced). If the student scores less than 50% in the quiz they do Level 1; if they score more, they do Level 2. In the Level 1 lesson, the restriction is set such that students can only access it if they get under 50% in the quiz
[[Image:Gradecompletion1.png|grade completion]]

The Level 2 lesson has the restriction set such that students can only access it if they get 50% or more:

[[Image:Gradecompletion2.png|grade completion]]

==An example of "all or any"==
*It's possible to set conditions such that a particular activity is available if one or more previous activities are marked complete, rather than all of them. In this screenshot, the Advanced task will become available either if the student gets above a certain grade in the quiz or if they receive a grade in the assignment.

[[File:eitheror1a.png]]

*When the first restriction is set, the teacher can then click the "Add restriction" button again to add a second (and subsequent) restrictions. The teacher can then change the "all" to "any" , thus changing the "and" to "or":

[[File:eitheror2.png]]

==An example of a Restriction set==
*The Restriction set button offers the possibility of creating several criteria using ''all/any'' to create complex conditions. In the screenshot below, students can only access the Assessment and Feedback section of the course if they have EITHER completed the work on Monet OR if they completed all the work on Pissarro.

[[File:restrictaccesslinks.png]]

*The actual settings for this are as follows:

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

==Tricks and techniques==

With a bit of lateral thinking, you can achieve some interesting results beyond the most obvious uses of the system. Here is one example:

===Project allocation===

Imagine that you let students choose one of two projects. Each project has its own activities (a forum for all the people doing that project, resources with information about the project, etc). You want it to hide all the activities that a student isn't doing.

This can already be achieved in Moodle using the [[Groupings]] system. However, conditional activities gives another way to set this up which might be preferable in some cases. Here's how:

# Create two forums called 'Frog project sign-up forum' and 'Zombie project sign-up forum'.
# Set both forums to be automatically marked complete once the user makes 1 post.
# Set each forum to be conditionally available only if the other forum is NOT complete.
# Create other activities for the frog and zombie projects. For each Frog activity, set it to be conditionally available only if the Frog sign-up forum is marked complete. For each Zombie activity, set it to be conditionally available only if the Zombie sign-up forum is marked complete.

When a student first visits the site, they see the frog and zombie sign-up forums and none of the project activities. As soon as they post in one of the forums, the other forum will disappear, and all the activities for their preferred project will appear. (If they want to change their mind, they can delete their forum post so that it isn't marked complete any more, and it'll be back to square one.)

==Gamification==
Many Moodlers are using Restrict access as a means to "gamify" their course. This section is for sharing examples and ideas:
*[https://moodle.org/mod/forum/discuss.php?d=263547 Now you see it; now you don't ]- forum post
*[http://www.slideshare.net/ghenrick/gamification-what-is-it-and-what-it-is-in-moodle What is Gamification and what is it in Moodle?]- presentation by Gavin Henrick
* [https://www.youtube.com/watch?v=E3794YBja6Q Gamify your Moodle courses in under 20 minutes] (using [[Conditional activities]] and [[Badges]]) video on YouTube
* [[Quizventure_activity|Quizventure activity]] - an activity module that loads questions from the course it's added to. The possible answers come down as space ships and you have to shoot the correct one.
* [[Level up! quick guide|Level Up!]] - a customisable block which a teacher can add to a course to give experience points to students as they progress through a course.
* [[blocks/stash|Stash]] - a block that allows a teacher to create and then show items around a course. Students can then go and collect these items which will then appear in their stash block.
* [[Game module|Game module]] - This module contains 8 games: hangman, crosswords, cryptex, millionaire, sudoku, hidden picture, snakes& ladders and book with questions.
* [[Exabis games activity]] - the goal of this activity is to bring the aspect of game-based-learning into Moodle-courses.
* [[PhET simulations]] - interactive simulations for science ([[Physics|physics]], [[Biology|biology]], [[Chemistry|chemistry]], Earth sciences) and [[Mathematics|math]] at elementary, middle school, high school and University levels.

== Should you really use restrict access?==

The restrict access feature is a way for you to force your students to do things in a certain order. Is that really what you want? The answer will depend on your particular circumstances, but it is worth taking a moment to reflect upon the degree to which restricting access is appropriate for your course.It is certainly good course design to make it clear to your students what they are expected to do next, to give good guidance. Restricting access can be used to create alternative pathways and to introduce repetition. As course sizes grow, such mechanisms can allow teachers to offer learning experiences that cater more to individuals, providing reinforcement when it is needed. However, some may still prefer to use labels and layout rather than locks and keys to direct the learning path.

==See also==

*Forum thread [https://moodle.org/mod/forum/discuss.php?d=231400 Conditional by number of days] for using post threshold blocking to restrict access to topics by days.

[[Category:Game]]

[[de:Einsatzszenarien für Voraussetzungen]]
[[es:Usando restringir acceso]]

Competencies FAQ

2016-10-06T09:44:54Z

Marycooch: /* What is the difference between 'default' and 'proficient' when setting up scales in a competency framework? */

{{Competencies}}
==I can't see evidence uploaded by my students==
*Are you a course teacher? You will not be able to see evidence of prior learning unless your administrator has given you a role with the capability moodle/competency:userevidenceview set to ''Allow'' .
==How does 'Attach evidence' work?==
*A teacher can set "Attach evidence" as an option when an activity or a course is completed. Once an activity or course has been completed, the activity or course in question will display as Evidence at the bottom of the competency in question in a student's learning plan. A manager or other user with the capability moodle/competency:userevidenceview set to ''Allow'' will be able to see this evidence.

[[File:evidencedisplayed.png|center]]

*However, they will not be alerted that the evidence is available, so the student should request a review, as below.
==How does "Request review" work?==
* A student can request a review of a competency, for example if they have submitted a piece of work as attached evidence and they wish to alert their course tutor to this. The student accesses the competencies from their learning plan and clicks'"Request review" from the Edit menu.
[[File:studentrequestreview.png|center]]
*The student will then see 'waiting for review' next to that competency.
*The course tutor/supervisor or anyone who is [[Capabilities/moodle/competency:usercompetencyreview| allowed to review competencies]] will see the request from the learning plans block on their dashboard:
[[File:sendforreview1.png|center]]
*They click the link to access the student's requested competency and (''1 in screenshot below'') click to start the review.
*When the review is in progress, the words the student sees change from 'waiting for review' to 'in review'.
*The course tutor can then review the evidence (''2 in screenshot below'') and then (''3'') click to finish the review. The message 'in review' no longer displays for the student.
*The course tutor can then rate the competency if required ''(4):''
[[File:sendforreview2.png|center|thumb|600px]]

==How do teachers rate competencies?==
Competencies may be met automatically upon activity completion (with the 'Default' scale as above) or teachers may rate competencies manually with a customised 'Proficient' scale.
*A teacher accesses the [[Competency breakdown report]], selects a student and clicks on a particular competency which has not yet been rated:
[[File:ratecompetencies12.png|center]]
*The teacher then clicks the 'Rate' button:
[[File:ratecompetencies2.png|center]]
*The teacher then chooses from the desired rating from the available options:
[[File:ratecompetencies3.png|center]]
*Once saved, the Proficient scale will change if the competency was met:
[[File:ratecompetencies4.png]]
*The competency breakdown report will reflect this, using the wording of the scale:
[[File:ratecompetencies5.png|center]]
*In the example below, the first competency was manually rated "Highly competent"; the second competency was automatically met upon activity completion and the third competency was manually rated "Not competent".
[[File:ratecompetencies6.png|center]]

==I can't see the Learning plans block==
*Are you a course teacher? You will not be able to see the [[Learning plans block]] unless your administrator has set the capability block/lp:view to Allow for teachers. However, administrators additionally need to set other capabilities in the system context relating to viewing learning plans and evidence for the block to display any useful information.
*It might be helpful to create a custom role, such as 'Supervisor', with the capabilities you wish to allow in the system context.
*If students have no learning plans, or if teachers/supervisors have no competencies needing reviewing, then the Learning plans block is not visible when editing is not turned on.

== I can't see competencies when trying to add them to a learning template==
Make sure you are in the right part of the site. If you added competencies to a category you will need to add the learning template to that category. If you added competencies to the system you will need to add your learning plan template to the system.

==The learning plan shows all competencies met but the course competencies screen shows some are still incomplete.==
*Competencies exist outside a course,so it might be that the competency has been met in another course but not the one you are in
*If a manager or other user who is [[Capabilities/moodle/competency:usercompetencyreview| allowed to review competencies]] chooses to ''rate'' a competency from the learning plan, then the competency will not show as complete inside the course, but it will display as complete in the learning plan.

==The progress bar shows 100% complete but the learning plan is not marked complete.==
*A learning plan does not automatically display as "complete" once all competencies have been met.
*It may be manually marked as complete by a user with the relevant capabilities - or -
* a due date may be set for completion when a learning plan template is created.
==What is the difference between 'default' and 'proficient' when setting up scales in a competency framework?==
*The default value is what is displayed in the breakdown report and for a student in their learning plan when a competency is automatically met upon activity completion. In the example below, 'competent" will display when a student completes a task satisfactorily.
*Items in the Proficient list can be displayed when a teacher rates a competency manually. There may be several different levels which can all be competent. In the example below, 'Just competent','Competent' or 'Highly competent' will result in the student achieving that competency:
[[File:levels.png|center|Custom competency scale]]

Note that the above is a custom created scale.

==How can students create their own learning plans?==
*If authenticated users have the capability ''[[Capabilities/moodle/competency:planviewowndraft|competency:planviewowndraft]]'' set to "Allow then they will see a button "Add new learning plan" when they access their learning plans from their profile.
*They can then create a draft learning plan and request a review of it by a manager or other user with the capability ''[[Capabilities/moodle/competency:planmanagedraft|moodle/competency:planmanagedraft]]''.

==How can I export or import competency frameworks?==
To export and import competency frameworks you need a plugin, for example the [https://moodle.org/plugins/tool_lpimportcsv Import competency framework admin tool.] See this [https://vimeo.com/181755841 video on .csv import and export] courtesy of Bernadette Parry of eWorks. See the plugins directory for [https://moodle.org/plugins/search.php?s=competency+framework&search=Search+plugins other import and export plugins.]

[[de:Kompetenzen FAQ]]
[[es:Competencias FAQ]]

Plugin Review Criteria

2016-10-05T08:30:51Z

Marycooch: forum discussion link

{{Installing Moodle}}
== Some Criteria to consider when looking at 3rd party plugins==

There are many great 3rd party plugins available for Moodle. However, it is important to assess the suitability and reliability of the plugin before adopting it.

This list is not exhaustive as there may be more or less questions depending on the individual installation and organisation.

This list was published originally by Gavin Henrick ([http://www.lts.ie/ Learning Technology Services]), see [http://www.somerandomthoughts.com/blog/2012/05/14/some-criteria-to-review-when-considering-a-plugin/ Some criteria to review when considering a plugin]

== Some initial questions==
*What is the purpose of the plugin?
*Is there nothing in the installation which can deliver this feature already?
*Is this the best solution for this requirement?
*What versions does it work with
*How many times has it been downloaded for your version

== Is it easy to install?==
*Is the source managed on svn/github
*Is it available in the Moodle.org plugins database
*Is the zip available to download into the correct folder name or does it need exploring to change
*Is it just a drop in and use notifications or is it more complex / require patches manual intervention / additional server software requirements (if so is this clearly indicated in the version.php - see [https://docs.moodle.org/dev/version.php Version docs])

== Is the documentation good?==
*Has it got a Moodle Docs page
*Has it got good readme.txt
*Has it got good help files & instructions
*Has it got screenshots

== Is it easy for teacher to use?==
*For the most common use case is it logical in usage?
*Are the instructions for use correct and usable?

== Is it easy for student to use?==
*For the most common use case is it logical in usage?
*Are the instructions for use correct and usable?

== Does it do what it says?==
*Are the instructions for use correct and usable?
*Does it provide the functionality as described in a good sensible way, is it a "full feature" or an interim solution.

== Features==
*Does it have a roadmap of potential improvements /changes?
*Will it work on Mobile theme and on Web?

== Feedback==
*Are there any comments from users on the plugin site?
*Are there any reviews of the module?
*Are there any discussions on it in the forums?

== Author Background (experience/reliability check)==
*Are they active in Moodle community for a good period of time?
*Do they respond well to queries on bugs etc.?
*Do they work for an established Moodle development team (Moodle partner, the OU, or HQ for example)?

== Technical==
*Does it work properly with the different database types?
*Is the mod being updated regularly with new Moodle versions?
*Does the module follow good Moodle coding standards? (Use [https://moodle.org/plugins/view.php?plugin=local_codechecker the Code Checker plugin])
*Does it properly use language files or has it got hardcoded text?
*Does it properly follow accessibility guidelines?
*Does it properly follow css and theming approaches?
*Does it conflict with anything else naming wise?
*Does it depend on another non-standard plugin (if so is this clearly indicated in the version.php - see [https://docs.moodle.org/dev/version.php Version docs])
*Does author regularly bug fix?
*Does it impact performance of Moodle in normal or high traffic usage?
*Does it have any security risks (is the user data protected/sanitised)
*What resources will it require to be used?
*Does backup/restore work?
*Has it got unit tests?

== See Also==
*[https://moodle.org/mod/forum/discuss.php?d=340821#p1373707 'How risky is this plugin?' forum discussion]
*[http://www.somerandomthoughts.com/blog/2012/05/14/some-criteria-to-review-when-considering-a-plugin/ Some criteria to review when considering a plugin] Gavin Henrick - May 2012
*[http://www.moodleaddons.com/book/ Moodle Addons Book] Gavin Henrick, Michael de Raadt - May 2013

[[Category:Contributed code]]

Competencies FAQ

2016-10-04T10:19:35Z

Marycooch: screencast on bulk upload plugins

{{Competencies}}
==I can't see evidence uploaded by my students==
*Are you a course teacher? You will not be able to see evidence of prior learning unless your administrator has given you a role with the capability moodle/competency:userevidenceview set to ''Allow'' .
==How does 'Attach evidence' work?==
*A teacher can set "Attach evidence" as an option when an activity or a course is completed. Once an activity or course has been completed, the activity or course in question will display as Evidence at the bottom of the competency in question in a student's learning plan. A manager or other user with the capability moodle/competency:userevidenceview set to ''Allow'' will be able to see this evidence.

[[File:evidencedisplayed.png|center]]

*However, they will not be alerted that the evidence is available, so the student should request a review, as below.
==How does "Request review" work?==
* A student can request a review of a competency, for example if they have submitted a piece of work as attached evidence and they wish to alert their course tutor to this. The student accesses the competencies from their learning plan and clicks'"Request review" from the Edit menu.
[[File:studentrequestreview.png|center]]
*The student will then see 'waiting for review' next to that competency.
*The course tutor/supervisor or anyone who is [[Capabilities/moodle/competency:usercompetencyreview| allowed to review competencies]] will see the request from the learning plans block on their dashboard:
[[File:sendforreview1.png|center]]
*They click the link to access the student's requested competency and (''1 in screenshot below'') click to start the review.
*When the review is in progress, the words the student sees change from 'waiting for review' to 'in review'.
*The course tutor can then review the evidence (''2 in screenshot below'') and then (''3'') click to finish the review. The message 'in review' no longer displays for the student.
*The course tutor can then rate the competency if required ''(4):''
[[File:sendforreview2.png|center|thumb|600px]]

==How do teachers rate competencies?==
Competencies may be met automatically upon activity completion (with the 'Default' scale as above) or teachers may rate competencies manually with a customised 'Proficient' scale.
*A teacher accesses the [[Competency breakdown report]], selects a student and clicks on a particular competency which has not yet been rated:
[[File:ratecompetencies12.png|center]]
*The teacher then clicks the 'Rate' button:
[[File:ratecompetencies2.png|center]]
*The teacher then chooses from the desired rating from the available options:
[[File:ratecompetencies3.png|center]]
*Once saved, the Proficient scale will change if the competency was met:
[[File:ratecompetencies4.png]]
*The competency breakdown report will reflect this, using the wording of the scale:
[[File:ratecompetencies5.png|center]]
*In the example below, the first competency was manually rated "Highly competent"; the second competency was automatically met upon activity completion and the third competency was manually rated "Not competent".
[[File:ratecompetencies6.png|center]]

==I can't see the Learning plans block==
*Are you a course teacher? You will not be able to see the [[Learning plans block]] unless your administrator has set the capability block/lp:view to Allow for teachers. However, administrators additionally need to set other capabilities in the system context relating to viewing learning plans and evidence for the block to display any useful information.
*It might be helpful to create a custom role, such as 'Supervisor', with the capabilities you wish to allow in the system context.
*If students have no learning plans, or if teachers/supervisors have no competencies needing reviewing, then the Learning plans block is not visible when editing is not turned on.

== I can't see competencies when trying to add them to a learning template==
Make sure you are in the right part of the site. If you added competencies to a category you will need to add the learning template to that category. If you added competencies to the system you will need to add your learning plan template to the system.

==The learning plan shows all competencies met but the course competencies screen shows some are still incomplete.==
*Competencies exist outside a course,so it might be that the competency has been met in another course but not the one you are in
*If a manager or other user who is [[Capabilities/moodle/competency:usercompetencyreview| allowed to review competencies]] chooses to ''rate'' a competency from the learning plan, then the competency will not show as complete inside the course, but it will display as complete in the learning plan.

==The progress bar shows 100% complete but the learning plan is not marked complete.==
*A learning plan does not automatically display as "complete" once all competencies have been met.
*It may be manually marked as complete by a user with the relevant capabilities - or -
* a due date may be set for completion when a learning plan template is created.
==What is the difference between 'default' and 'proficient' when setting up scales in a competency framework?==
*The default value is what is displayed in the breakdown report and for a student in their learning plan when a competency is automatically met upon activity completion. In the example below, 'competent" will display when.
*Items in the Proficient list can be displayed when a teacher rates a competency manually. There may be several different levels which can all be competent. In the example below, 'Just competent','Competent' or 'Highly competent' will result in the student achieving that competency:
[[File:levels.png|center|Custom competency scale]]

Note that the above is a custom created scale.

==How can students create their own learning plans?==
*If authenticated users have the capability ''[[Capabilities/moodle/competency:planviewowndraft|competency:planviewowndraft]]'' set to "Allow then they will see a button "Add new learning plan" when they access their learning plans from their profile.
*They can then create a draft learning plan and request a review of it by a manager or other user with the capability ''[[Capabilities/moodle/competency:planmanagedraft|moodle/competency:planmanagedraft]]''.

==How can I export or import competency frameworks?==
To export and import competency frameworks you need a plugin, for example the [https://moodle.org/plugins/tool_lpimportcsv Import competency framework admin tool.] See this [https://vimeo.com/181755841 video on .csv import and export] courtesy of Bernadette Parry of eWorks. See the plugins directory for [https://moodle.org/plugins/search.php?s=competency+framework&search=Search+plugins other import and export plugins.]

[[de:Kompetenzen FAQ]]
[[es:Competencias FAQ]]

Recycle bin

2016-09-30T07:31:26Z

Marycooch: /* Deleted courses */

{{More features}}
{{New features}}
==What is the recycle bin?==
*The recycle bin allows teachers to retrieve course elements they have mistakenly deleted. It also allows those with relevant category permissions to restore deleted courses.
*If deleted items are not needed, they are automatically permanently deleted after seven days (or a time specified by the admin.)
*The recycle bin was the first project funded by the [https://moodleassociation.org/ Moodle Users Association]. Watch the HQ screencast [https://www.youtube.com/watch?v=Wzieh7BYwfE Recycle bin]

==How does it work?==
===Deleted activities===

1. Before a course teacher deletes an item, a reminder message appears:

[[File:confirmdeletion.png]]

2. If you mistakenly click 'yes', all is not lost. Turn editing off or effectively reload the course page or navigate elsewhere in the course then go to the course administration block. The link "Recycle bin" will be visible.

[[File:courseadminrecylebinlink.png]]

3. Click the link and then click the 'restore' icon to retrieve the assignment or other item you accidentally deleted.

[[File:recycle bin.png]]

===Deleted courses===
1. Access the category that the course was in before you accidentally deleted it.
2. From the category administration block, click 'Recycle bin'

[[File:recyclebinrestorecourse1.png]]

3.Click 'Restore' to restore the deleted course:

[[File:recyclebinrestorecourse2.png]]

==How is it set up?==
*The recycle bin is available by default in all courses and categories, but the link in the administration block is only visible once something has been deleted.
*Administrators can turn off the recycle bin and modify the settings from ''Site administration > Plugins > Admin tools > Recycle bin''. Here they can decide how long an item or a course will remain available until it is permanently deleted. The admin can also decide to make the recycle bin visible in the administration block even when empty.

[[es:Papelera de reciclaje]]
[[de:Papierkorb]]

Recycle bin

2016-09-30T07:30:17Z

Marycooch: /* How is it set up? */

{{More features}}
{{New features}}
==What is the recycle bin?==
*The recycle bin allows teachers to retrieve course elements they have mistakenly deleted. It also allows those with relevant category permissions to restore deleted courses.
*If deleted items are not needed, they are automatically permanently deleted after seven days (or a time specified by the admin.)
*The recycle bin was the first project funded by the [https://moodleassociation.org/ Moodle Users Association]. Watch the HQ screencast [https://www.youtube.com/watch?v=Wzieh7BYwfE Recycle bin]

==How does it work?==
===Deleted activities===

1. Before a course teacher deletes an item, a reminder message appears:

[[File:confirmdeletion.png]]

2. If you mistakenly click 'yes', all is not lost. Turn editing off or effectively reload the course page or navigate elsewhere in the course then go to the course administration block. The link "Recycle bin" will be visible.

[[File:courseadminrecylebinlink.png]]

3. Click the link and then click the 'restore' icon to retrieve the assignment or other item you accidentally deleted.

[[File:recycle bin.png]]

===Deleted courses===
1. Access the category that the course was in before you accidentally deleted it.
2. From the category administration block, click 'Recycle bin'

[[File:recylebinrestorecourse1.png]]

3.Click 'Restore' to restore the deleted course:

[[File:recyclebinrestorecourse2.png]]
==How is it set up?==
*The recycle bin is available by default in all courses and categories, but the link in the administration block is only visible once something has been deleted.
*Administrators can turn off the recycle bin and modify the settings from ''Site administration > Plugins > Admin tools > Recycle bin''. Here they can decide how long an item or a course will remain available until it is permanently deleted. The admin can also decide to make the recycle bin visible in the administration block even when empty.

[[es:Papelera de reciclaje]]
[[de:Papierkorb]]

Recycle bin

2016-09-30T07:28:07Z

Marycooch: clarification about deleted courses

{{More features}}
{{New features}}
==What is the recycle bin?==
*The recycle bin allows teachers to retrieve course elements they have mistakenly deleted. It also allows those with relevant category permissions to restore deleted courses.
*If deleted items are not needed, they are automatically permanently deleted after seven days (or a time specified by the admin.)
*The recycle bin was the first project funded by the [https://moodleassociation.org/ Moodle Users Association]. Watch the HQ screencast [https://www.youtube.com/watch?v=Wzieh7BYwfE Recycle bin]

==How does it work?==
===Deleted activities===

1. Before a course teacher deletes an item, a reminder message appears:

[[File:confirmdeletion.png]]

2. If you mistakenly click 'yes', all is not lost. Turn editing off or effectively reload the course page or navigate elsewhere in the course then go to the course administration block. The link "Recycle bin" will be visible.

[[File:courseadminrecylebinlink.png]]

3. Click the link and then click the 'restore' icon to retrieve the assignment or other item you accidentally deleted.

[[File:recycle bin.png]]

===Deleted courses===
1. Access the category that the course was in before you accidentally deleted it.
2. From the category administration block, click 'Recycle bin'

[[File:recylebinrestorecourse1.png]]

3.Click 'Restore' to restore the deleted course:

[[File:recyclebinrestorecourse2.png]]
==How is it set up?==
*The recycle bin is available by default in all courses and categories, but the link in the administration block is only visible once something has been deleted.
*Administrators can turn off the recycle bin and modify the settings from ''Site administration > Plugins > Admin tools > Recycle bin''. Here they can decide how long an item or a course will remain available until it is permanently deleted.

[[es:Papelera de reciclaje]]
[[de:Papierkorb]]

File:recyclebinrestorecourse1.png

2016-09-30T07:27:52Z

Marycooch: Marycooch uploaded a new version of File:recyclebinrestorecourse1.png

File:recyclebinrestorecourse2.png

2016-09-30T07:24:08Z

Marycooch:

File:recyclebinrestorecourse1.png

2016-09-30T07:22:40Z

Marycooch: