MoodleDocs - User contributions [en]

Building Quiz

2016-02-09T07:22:39Z

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

{{Quiz}}

==How a Moodle quiz works==
{{Note|If you're new to quiz creation, try the [[Quiz quick guide]] first.}}
Once a quiz has been added to the course and the [[Quiz settings]] established,the teacher can start to build the quiz. The teacher can access the quiz to edit the questions by clicking directly on the Quiz name on the course home page or by clicking "Edit quiz" in ''Administration>Quiz administration.'' (You can also make questions in the [[Question bank]] without first creating a quiz. These questions may then be used later.)

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

|}

==Adding questions==

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

#Click the 'Add' link as in the screenshot below. (''Note that in the US, the term 'marks' is replaced by 'points'.'')
#When it opens up, choose either to add a new question, to select a question from the question bank or to add a random question.

{|
| [[File:newaddquestion.png|thumb|450px|Adding a question]]

|}

===Creating a new question===

1. To make a brand new question, click 'Add' and then '+ a new question'.

2. From the next screen, choose the question type you want to add and click "Next" ('When you click on a question type on the left, helpful information appears on the right''. )

{|
| [[File:questionpicker.png|thumb|440px|Selecting a question type]]

|}

3. Fill in the question form, making sure to give a grade to the correct answer.

4. Click "Save changes".

{|
| [[File:newlycreatedquestion.png|thumb|430px|A question when it has been created]]

|}

{{ Note| If you have a very complex question, and you want to check it as you go along, you can preview it and then click "Save changes and continue editing".}}

When a question has been created, an icon and words display its type (eg multiple choice). It can be modified by clicking the edit icon (eg [[File:editicon.png]]) and previewed or deleted by clicking the magnifying glass or X icons:(eg [[File:previewdelete1.png]])
====Adding responses and feedback====
5. When you add responses and feedback, remember you can expand the toolbar to show more buttons.

6. You can continue adding questions this way, clicking 'Add' and '+ a new question' each time.

===Choosing a pre-made question===
*If other teachers in the course have made questions, or if a teacher made questions in an earlier quiz, these can be added to the current quiz by clicking 'Add' and '+ from question bank' .
* Click the + sign next to one question you want to add it (1 in screenshot below)
* If you have several questions, or you want to add all the questions, tick the box of each question or the top box (2 in screenshot below) and then click 'Add selected questions to the quiz' (3 in the screenshot below).
* To sort the questions, click the column headings. The default sort order (T) is short for question type. (2 in the screenshot below)
* To ensure all previously made questions are available, make sure to tick the boxes "also show questions from sub-categories/old questions".

{|
| [[File:addfromqbank1.png|thumb|350px|Using a previously made question]]

|}

'''Note:''' It is also possible to import pre-made questions into your quiz, from ''Quiz administration>Question bank>Import.'' See [[Import questions]] for more information. Sample questions are available from the [http://moodle.net/mod/data/view.php?d=1&mode=list&perpage=40&search=&sort=0&order=DESC&advanced=0&filter=1&advanced=1&f_2=Quiz+questions&f_11=&f_13=&f_12=&f_9=&f_8= Moodle.net content database.]

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

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

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

|}

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

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

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

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

==Quiz layout==

*You can choose in '' Administration>Quiz administration>Edit settings>Layout'' whether to have a new page for every question or after a certain number of questions.
* You can add a page break between questions by clicking the arrow icon (where the arrows are pointing away from each other) (1 in the screenshot below) A new page will be created. (2 in the screenshot below)
*You can remove pages by clicking the arrow icon (where the arrows are pointing towards each other). (3 in the screenshot below)

[[File:addpagebreak.png|thumb|500px|center]]
*You can also change the layout of the whole quiz by clicking the 'Repaginate' button:

[[File:repaginate.png|thumb|center|500px]]

*Questions may be moved by dragging and dropping using the crosshairs icon: [[File:crosshairsicon.png]]

===Section headings===

*Section headings may be added to each new page.
*For the first page, click the 'pencil' icon at the top (1) and add your heading (2):

[[File:sectionheading1.png]]

*For other pages, click the 'Add' link (1) and choose 'a new section heading' (2), and then add your heading as for Page 1:

[[File:sectionheading2.png]]

*The section headings are displayed in the Quiz navigation block:

[[File:quiznavsectionheadings.png]]

===Randomising the order questions appear===

*The order in which questions appear to the student may be randomised or 'shuffled' by ticking the 'Shuffle' box at the top of the screen:

[[File:shuffle1.png]]

*Where questions are in different sections (see ''Section headings'' above), each section has its own 'Shuffle' box to tick. This means that you can mix up questions on one section, but in another section, where their order is important, you can keep them in the order you need them to display:

[[File:shuffle2.png]]

==Making questions conditional upon other questions==

*If using the ''Interactive with multiple tries'' or ''Immediate Feedback'' behaviour and with the navigation method set to 'Free', it is possible to make the display of a question dependent on a previous question being answered first.
*The question editing page will display padlock icons to the right of each question:

[[File:locks1.png|thumb|center|400px|Padlocks - all unlocked]]

*If you want to make a question, for example Q2, conditional upon answering Q1, then click the padlock just above Q2:

[[File:lock2.png|thumb|center|400px|Padlocks - Q2 locked]]

*When a student accesses the quiz, they will see a message that Q2 is not available until they give a response to Q1:

[[File:lock3.png|thumb|center|550px|What students see]]

*In the Quiz navigation block, Q2 will be greyed out:
[[File:locksnav.png]]

*In the following example, note that, Q1 follows a description, and a description 'questions' cannot be finished. Therefore, Q1 cannot depend on the previous question. Similarly, Q4 follows an Essay question. The Essay cannot be finished during the attempt, so the following question cannot depend on it. Note the lack of padlocks in the following screenshot because of the description and Essay question:

[[File:conditionalquestionpadlocks.png|thumb|center|500px]]

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

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

{|
| [[File:allquizgrades.png|thumb|450px|Points per question and max grade]]
| [[File:editmaxmark.png|thumb|450px|Edit individual marks]]

|}

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

==Previewing the quiz==
*You can preview individual questions by clicking the magnifying glass icon.
*You can preview the whole quiz by clicking the "Preview" link in ''Administration>Quiz administration>Preview''
*The quiz works like a real quiz so you can see your grades and any feedback for correct/incorrect answers just as a student would see them.

'''NOTE''': ''To get a more accurate view of how a student would view your quiz, it is advised to log in with a "dummy" student account created by the admin for testing activities. This is more reliable than the 'switch role to student' feature.

*See also the question: 'How can a teacher '-dry run a quiz..?' in [[Quiz FAQ]]''
{|
| [[File:singleqp.png|thumb|300px|Previewing a single question]]
| [[File:previewquiz.png|thumb|200px|Click to preview the whole quiz]]
| [[File:quizpreviewed.png|thumb|200px|Quiz in preview mode]]

|}

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

You can change the order of questions, regrade them, preview an individual question and click on an question edit link that will allow you to directly edit the question stored in the question bank.
{{Note| You can delete all quiz attempts by students and then edit the quiz as if no students had attempted it. To do this,click the quiz name and then the Results link in the Administration block. This will present a list of students and their scores. Click "Select all" and then "Delete selected attempts".}}
===Dealing with faulty questions===
There are several ways to deal with "bad" questions in a quiz.
::*Change the grade for the bad question to 0 in the quiz.
::*Edit the question, changing what you will accept as a correct answer, then regrading the exam. Remember when changing a question that the next time it is used it will be as it was in the last edit. Also, regrading will only affect one quiz at a time.
::*You can edit the question to explain the situation to the student and then you can set the grade for the question to zero. After you make such changes you should regrade the quiz by clicking on the '''Results''' tab and then the '''Regrade''' tab. This will change the grade for all students who have taken the quiz so far. Remember, if the question is used by another quiz, your "explanation" will appear as part of that quiz.
::*You can change the grade for the bad question and then move or delete the question from your question category. The question will still appear on the quiz. Some places do not like to delete any question, but will move them to a "dead" or "bad" question category.
::*When you discover a bad question in your quiz, it may affect the question bank. Remember that a final might be made up of a certain number of random questions drawn from different question categories, the same categories used in a smaller subject quiz. It can be very important do something about bad or invalid questions in a question category when the categories are use in other places.

==See also==
*[[Question types]]
*[https://youtu.be/Y1TaqOLPNiY The Moodle Quiz Activity] MoodleBites video on YouTube
*[https://youtu.be/0FaxWt_4FQI Moodle Quiz Questions] MoodleBites video on YouTube

[[Category:Questions]]

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

Question bank

2016-02-09T07:21:10Z

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

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

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

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

===Categories are shared in contexts===

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

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

==Edit, duplicate, preview, delete and move==

[[File:questionicons.png]]

Each question in the question bank has four icons which allow you to edit, quickly duplicate, preview and delete the question. (The question may not be deleted if it is already in use elsewhere.) To duplicate a question, click the duplicate icon (second from the left) and a copy of the question editing screen will appear. You can either edit this new copy or simply scroll down and click "Save changes."To move a question into a different category or subcategory, click into the box on its left; scroll down to "With Selected..." and choose "Move to.."

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

==Sharing and Managing Question banks==

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

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

See:

*[[How to let teachers share questions between courses]]
*[[How to minimize the question bank when doing backup/restore]]

==See also==
*[https://youtu.be/0FaxWt_4FQI Moodle Quiz Questions] MoodleBites video on YouTube

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

Questions

2016-02-09T07:19:06Z

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

{{Managing a Moodle course}}
Questions can be created in Moodle for use in [[Quiz module|quizzes]] and for import into [[Lesson module|lessons]].

==[[Question types]]==
*[[Calculated question type|Calculated]]
*[[Simple calculated question type|Simple Calculated]]
*[[Drag and drop into text question type|Drag and drop into text]]
*[[Drag and drop markers question type|Drag and drop markers]]
*[[Drag and drop onto image question type|Drag and drop onto image]]
*[[Calculated multichoice question type|Calculated Multichoice]]
*[[Description question type|Description]]
*[[Essay question type|Essay]]
*[[Matching question type|Matching]]
*[[Embedded Answers (Cloze) question type|Embedded Answers (Cloze)]]
*[[Multiple Choice question type|Multiple Choice]]
*[[Random Short-Answer Matching question type|Random Short Answer Matching]]
*[[Select missing words question type|Select missing words]]
*[[Short-Answer question type|Short-Answer]]
*[[Numerical question type|Numerical]]
*[[True/False question type|True/False]]
*[[Third-party_question_types|Third-party question types]]

==See also==
*[[Managing questions]]
**[[Question bank]]
**[[Question categories]]
**[[Import questions]]
**[[Export questions]]
*[[Question behaviours]]
*[[Questions FAQ]]

*[https://youtu.be/0FaxWt_4FQI Moodle Quiz Questions] MoodleBites video on YouTube

[[de:Fragen]]
[[es:Preguntas]]
[[fr:Questions]]

[[Category:Questions]]
[[Category:Quiz]]

Quiz activity

2016-02-09T07:17:54Z

Cttxg: /* See also */ updating MoodleBites Quiz activity video link

Quiz settings

2016-02-09T07:16:01Z

Cttxg: /* See also */ updating MoodleBites Quiz activity video link

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

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

==General==
Add a name here (which students will click on to access the quiz) and, if desired, a description of what they must do.

==Timing==
{{Note|You can change quiz availability and duration for different groups or users in the Group or User override sections of the Quiz Administration settings block .}}
;Open the quiz
:You can specify times when the quiz is accessible for people to make attempts. Before the opening time the quiz will be unavailable to students. They will be able to view the quiz introduction but will not be able to view the questions. Quizzes with start times in the future diasplay both the open and close date for students.
;Close the quiz
:After the closing time, the students will not be able to start new attempts. Answers that the student submits after the quiz closing date will be saved but they will not be marked.
: Even after the quiz has closed students will still be able to see the quiz description and review their attempts. What exactly they will see depends on the settings you choose for review options (see below).
;Time limit
:By default, quizzes do not have a time limit, which allows students as much time as they need to complete the quiz. If you do specify a time limit, several things are done to try and ensure that quizzes are completed within that time:

[[File:quiz timer.png|thumb|Navigation block showing quiz timer]]

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

There are three options as to what will happen when the time limit is up. Choose the one you need from the dropdown menu:
# Open attempts are submitted automatically (This is the default)
# There is a grace period when open attempts can be submitted, but no more questions answered
# Attempts must be submitted before time expires, or they are not counted

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

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

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

==Grade==
;Grade category
If you have categories in your gradebook, select the one you wish the quiz to be in here.
;Attempts allowed
:Students may be allowed to have multiple attempts at a quiz. This can help make the process of taking the quiz more of an educational activity rather than simply an assessment.
{{Note|You can change the allowed number of attempts for different groups or users in the Group or User override sections of the Quiz Administration settings block.}}
;Grade to pass
Here you can set a passing grade for the quiz. This may be connected with [[Activity completion]] and [[Conditional activities]] such that a student will not be able to access a follow up activity until they have passed the quiz.
;Grading method
:When multiple attempts are allowed, there are different ways you can use the grades to calculate the student's final grade for the quiz.
* Highest grade - the final grade is the highest (best) grade in any attempt
* Average grade - the final grade is the average (simple mean) grade of all attempts
* First grade - the final grade is the grade earned on the first attempt (other attempts are ignored)
* Last grade - the final grade is the grade earned on the most recent attempt only

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

Choose ''Sequential'' instead of ''Free'', if you want to force the student to progress through the questions in order and not go back to a previous question or skip to a later one.

==Question behaviour==
;How questions behave
:See [[Question behaviours]].
;Allow redo within an attempt (available by clicking "Show more")
:If using Interactive or Immediate feedback mode, enabling this setting means students can try a question again even if they have used up their allowed attempts. This is helpful if they wish to learn from the feedback given at the end of their attempts. They will be given a different question from the one they were working on previously if there are other questions available. A student's grade for that question slot is based on the most recent question they have started.
;Each attempt builds on the last (available by clicking "Show more")
:If multiple attempts are allowed and this setting is set to Yes, then each new attempt contains the results of the previous attempt. This allows the student on the new attempt to concentrate on just those questions that were answered incorrectly on the previous attempt. If this option is chosen then each attempt by a particular student uses the same questions in the same order, independent of randomization settings. To show a fresh quiz on every attempt, select No for this setting.

==Review options==
(These settings are collapsed by default)

[[File:quizreview.png|thumb|600px|Review options expanded]]

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

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

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

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

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

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

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

==Appearance==
;Show the user's picture
:It is now possible, when displaying the user's profile picture for proctoring purposes, to choose whether a large image or thumbnail will be displayed.
;Decimal places in grades
:This option determines how many digits will be shown after the decimal separator (see [[dev:Translation_langconfig|langconfig]] ) when the grade is displayed. A setting of 0 for example means that the grades are displayed as integers. This setting is only used for the display of grades, not for the display or marking of answers.

==Extra restrictions on attempts==
;Require password
:If you specify a password in here then participants must enter the same password before they are allowed to make an attempt on the quiz. This is useful to give only a selected group of students access to the quiz.
;Require network address
:You can restrict access for a quiz to particular subnets on the LAN or Internet by specifying a comma-separated list of partial or full IP address numbers. This is especially useful for a proctored (invigilated) quiz, where you want to be sure that only people in a certain room are able to access the quiz. For example: 192.168. , 231.54.211.0/20, 231.3.56.211

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

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

:Spaces are ignored.

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

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

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

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

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

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

|[[File:seb24.png|thumb|Student view of quiz question with full screen popup.]]

:* The students are prevented, as far as is possible, from using facilities like copy and paste.

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

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

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

==Overall feedback==
Overall feedback is shown to a student after they have completed an attempt at the quiz. The text that is shown can depend on the grade the student got. Click "Show editing tools" to display the rich text editor, and drag the bottom right of the text box out to expand it.

For example, if you entered:

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

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

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

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

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

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

==Outcomes==
This setting will only appear if [[Outcomes]] have been enabled by the administrator and are used in the course. See [[Outcomes]] for how to remove an outcome once it has been added to a quiz.

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

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

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

The following automatic activity completion conditions apply to the quiz:

:''Require view'' - the student clicks on the quiz to view it
:''Require grade'' - the student obtains a grade
:''Require a passing grade'' - a 'Grade to pass' is specified for the quiz in the gradebook.
:''All available attempts completed'' - a certain number of attempts were allowed on the quiz and the student has completed them all.

==Group and User overrides==

[[File:overridesquiz.png|thumb|Location of overrides]]

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

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

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

==Site administration settings==

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

The time period settings for a quiz (such as time limit, submission grace period, autosave period and so on) can be set here with a duration of seconds, minutes, hours, days or weeks. These defaults will then be used when new quizzes are created.

;Autosave period
:If enabled, student responses will be saved at regular period according to the selection here. the default is one minute. This is useful so that students don't lose work but does increase the load on the server.

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

==See also==
*[https://youtu.be/Y1TaqOLPNiY The Moodle Quiz Activity] MoodleBites video on YouTube
*[https://youtu.be/0FaxWt_4FQI Moodle Quiz Questions] MoodleBites video on YouTube

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

Quiz activity

2016-02-09T07:07:01Z

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

Grades FAQ

2016-01-19T20:32:06Z

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

{{Grades}}
== General ==

===How can I change how grades are displayed?===

Grades may be displayed as as actual grades, as percentages (in reference to the minimum and maximum grades) or as letters.

The default grade display type for the site is set by an administrator in ''Administration > Grades > [[Grade item settings]]''. However, this may be changed at course level.

To change how grades are displayed for particular [[Grade items|grade items]], or category and course summaries (called aggregations):

# Go to ''Course administration > Gradebook setup''.
# Click the Edit then edit settings link opposite the grade item or category total. (For the course total, click the Edit then 'Edit settings' link at the top of the actions column, opposite the name of the course.)
# On the edit category page, click the 'Show more...' link under 'Category total'.
# From the Grade display type menu, select real (for actual grades), percentage or letter.
# Click the "Save changes" button at the bottom of the page.

Alternatively, to change how grades are displayed for the whole course:

# Go to ''Course administration > Gradebook setup''.
# Select "Course grade settings" in the administration block.
# From the Grade display type menu, select real (for actual grades), percentage or letter, or a combination of these.
# Click the "Save changes" button.

===How can I hide entered grades until a specified date?===

To set a "Hidden until" date:

# Go to ''Course administration > Gradebook setup''.
#Click on the edit icon opposite the activity for which a "Hidden until" date is to be set.
#On the edit grade item page, ensure that advanced settings are displayed. (Click the "Show advanced" button if not.)
#Enable the "Hidden until" setting by unchecking the disable checkbox, then set a date.
#Click the "Save changes" button.

=== Is it possible to show the teachers/administrators' grades in the grader report? ===
Yes, at the site level you can define which roles will appear in the grader report. This can be found in [[General_grade_settings#Graded_Roles|Administration > Grades > General settings]]. Also read [http://moodle.org/mod/forum/discuss.php?d=92612 this discussion] for some more ideas.

===Why can't I change a grade within an assignment after changing it in the gradebook?===

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

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

===How do I get groups to show up in the grader report?===

For groups to show up in the grader report, group mode should be set to visible or separate groups in the [[Course settings|course settings]]. This will result in a groups dropdown menu being displayed, enabling a teacher to view the grades of all participants, or only the grades for a selected group.

===The quiz grades keep disappearing from the student view, even after I un-hide them!===

Check your quiz settings. Under the '''Review options''' heading, in the '''Later, while the quiz is still open''' and/or the '''After the quiz is closed''' columns, you probably have Scores un-checked. Each time a student completes a quiz, these settings are consulted and the scores will be hidden from ''all'' students. If your students don't all take the quiz at the same time, it can look like quiz scores reset themselves to 'hidden' randomly, even after you un-hide them. (If there is no end date for the quiz, the quiz never actually closes and will never display grades unless Scores is checked in "Later, while the quiz is still open."

===How can I make the gradebook simpler for teachers?===

See [[Simplifying the gradebook by changing permissions]].

==Grades and user removals==

===What happens to gradebook data when a user is unenrolled from a course?===

On re-enrolling, you can recover their grades from before. See the section 'Unenrolment and grade history' in [[Unenrolment]] for more details.

==Advanced grading==

===Why can't I see the advanced grading option??===
To see the option for Advanced grading, you first have to create an assignment and choose Advanced grading/Rubric from the Grading method dropdown. Advanced grading will then appear in ''Settings>Assignment administration.''

===How can I allow teachers to save rubrics as templates for others?===
Create a new role and assign it in the system context. Give this role the capability ''moodle/grade:sharegradingforms'' (for sharing as a template) and if desired ''moodle/grade:managesharedforms'' (for editing or deleting templates created by others) Assign this role to those teachers you wish to have this ability.

===How do students see the Marking guide?===
Assuming the teacher has allowed this in the [[Marking guide]] settings, the student may click "submissions grading" under the assignment name in their navigation block:

[[File:submissionsgrading.png]]

===Why can't students see feedback when Blind Marking is used?===
If you use '''Blind Marking''' to conceal student identities when assessing in the Assignment module, it waits until ''all'' submissions are marked, and '''Reveal student identities''' is clicked, to enter final grades into the Gradebook. Only at this point does it release Rubric marks/comments and inline feedback for student view (if Advanced Grading: Rubrics and Inline Comment Feedback are used in the Assignment).

== Reports ==
=== How do I create my own custom gradebook reports? ===
Here is a [[Development:Gradebook_Report_Tutorial|tutorial]] explaining all the main steps involved.
===How can I sort or change the order of column headings?===
Go to Grades link, then select one of the "Category & items" actions from the pulldown on the top left. Use the move icon to change the position of the graded item. And/or you could create categories for the items and move them into a category so they will be grouped that way first.

===How can I remove user ID numbers and/or email addresses from the grader report===

Go to ''Settings > Site administration > Users > Permissions > [[Roles settings|User policies]]'' and untick the 'ID number' and/or 'email address' checkboxes for 'Show user identity'.

Note that this will result in ID numbers and/or email addresses not being shown when searching for users and displaying lists of users. See the section 'Show user identity' in [[Roles settings]] for a list of locations where user identity fields are shown.

=== How can I interpret the quiz report statistics?===

See [https://docs.moodle.org/dev/Quiz_report_statistics Quiz report statistics] in the developers documentation.

== Aggregation ==
=== I can't find where to change the aggregation type for my gradebook categories! ===

# Go to ''Course administration > Gradebook setup''.
# Click the edit settings link opposite the category.

=== How can I grade some of my activities without the results affecting my students' course total? ===

# Go to ''Course administration > Gradebook setup''.
#Add two [[Grade categories]], one for your "Graded activities" and one for your "Not graded activities". In the "Not graded activities" category choose "None" in grading type.
#Ensure that "Aggregate including subcategories" (an option visible only in "full view") is unchecked for your top level course grade category.
#If you want to completely hide the "Not graded activities" category from your students tick the "Hidden" icon too.
#Save your changes.
#Move all your normally graded activities into the "Graded activities" category.
#Move all your excluded from grading activities into "Not graded activities" category.

'''Note''': Following the above steps the not graded activities will be completely hidden from your students. So...

*'''IF''' you want the activity grades of the "Not graded activities" category, to remain visible to your student without their grades affecting their course total, simply click the eye to show the "Not graded activities" category.

*'''IF''' you want students to be able to see the activity grades and the category total of the "Not graded activities", then you have to let the category visible and also choose a grading type between value, scale or text, by editing the category.

In this case you can exclude the "Not graded activities" from course total using the "Weighted mean of grades" aggregation method in Course category and assigning 100 weight to the "Graded activities" and 0 weight to the "Not graded activities".

*'''IF''' you don't want to use grade categories, you can also exclude the grades of a specific activity by changing the "Multiplicator" (visible only in "full view") from 1.0 into 0.0.

*Last, '''IF''' you want to exclude the grade of an activity only to one or some specific students, then follow these steps:
#From the grader report "Turn editing on"
#Click the "Edit grade" icon of the activity of the student you want to exclude.
#In the Edit grade page, check the tick box next to the "Excluded" option and "Save changes".

=== My student completed only one activity out of 5, but his course total shows 100%. How do I show a more "progressive" course total? ===

==== Step-by-Step Explanation ====

# Go to ''Course administration > Gradebook setup''.
# At the top line there is a folder icon and an edit icon on the right, click the edit icon
# You'll then see the title "Grade category," the 3rd item is "Aggregate only non-empty grades."
# Uncheck this.
# Save.

==== Another Explanation ====
By default, only non-empty grades are aggregated, the others are ignored. However, you can change this setting as well as others that affect the course total, by turning "Editing" on in the grader report, and clicking the "Edit" icon next to the course category (the very top row of the grader report).

You can untick the box "Aggregate only non-empty grades" if you want to show a more "progressive" score for each student. Their empty grades will count as a 0 and will be counted in the course mean/total.

If you prefer to show a sum of points, rather than a percentage, you can change the course category's aggregation method to "Natural".

=== How can I display the average grade for my course categories (not grade categories)? ===
In Moodle 3.0 there is no way to aggregate course totals within each category. The gradebook is course-centered, and there is currently no User Interface for showing grades within an entire course category at once. However, the Grades link from the User dropdown menu will show students their Total Grades from each course that they are enrolled in.

=== Why is the Category Total blank for one of my categories? ===
One possibility is that you accidentally entered some grades into the Category Total column and then erased them. When you do that, an override flag gets set and then the totals won't calculate. Here's how to check, and fix it:

# Go to the [[Grader report]] view of the gradebook.
# Click the "Turn editing on" button for the gradebook. (There's a separate one for the gradebook from the one on the main page.)
# Find the box for the problem category and the first student affected.
# Click on the icon of a gear *in that box*.
# See if the box marked "[[Grade_editing#Overridden|Overridden]]" (third line down) is checked. If it is, uncheck it.
# Repeat (4) and (5) for each student affected,

(Overridden grades are normally shaded a dark yellow in the grader report, which makes finding them much easier.)

== Categories ==
=== How many depths of categories/subcategories can I create? ===
There is no programmatic limit, but there are practical limits. Very deeply nested structures are difficult to manage. 3 levels of categories should be sufficient for most situations. Note that there is always at least one level of categories, since the Course category always encompasses all other categories and grade items, can cannot be deleted.

=== I can't find setting X in the grade category edit page! Where is it? ===
If a setting documented on the [[Grade categories]] page does not appear on your edit page, it may mean that it is set globally in your site. See [[Grade_category_settings#Forcing_settings|Forcing settings]] for more information.

== Outcomes ==
=== I want to set up an outcome item for my course. What are the steps required? ===
#The site administrator needs to have enabled outcomes via ''Administration>Site Administration > Advanced Features >Enable Outcomes''
#In your course, go to ''Administration>Course administration>Grades>Scales'' and create the scale you need.
#[[Scales#Creating_a_new_scale|Create a scale]]
#In Administration>Course administration>Outcomes, create a course outcome assigning it to the scale you just created.
#Read the [[Outcomes| outcomes documentation]] for instructions).
#You can now give your students a rating on the outcome dimension you just created. If you created a standard outcome, you will be able to use it in other courses and follow your students' performance across these courses.

===How can I remove an outcome from an activity?===

An outcome can be removed from an activity by deleting it via ''Course administration > Gradebook setup''. This results in the outcomes being deselected on the update activity page.

== Modules ==
=== The activity module (Module name) doesn't support grading. How can I give my students a grade anyway? ===
You can create a [[Grade_items#Manual_grade_items|grade item]] manually in the gradebook. You will have to grade your students through the [[Grader report]] interface (in editing mode).

=== I just graded some of my students using the (Module name) interface, but the results aren't showing up in the grader report. What's going on? ===
Here are some of the possible reasons:
#The site settings>Grades>General settings may not have the correct graded roles checked off to appear in grade book. If you see no students in the Gradebook but do see columns for the graded activities, then check the graded role settings.
#The corresponding [[Grade items|grade item]] is [[Grade_locking#In_grade_items|locked]], or its parent [[Grade categories|category]] is [[Grade_locking#In_grade_categories|locked]].
#The module code is not using the [[Development:Grades#API_for_communication_with_modules.2Fblocks|gradebook API]] correctly

=== I just created a new assignment with the "Grade" setting set to "No grade", but it still appears in the gradebook ===
The reason is that the gradebook is now the place where both numerical and textual types of feedback are recorded for all activity modules. The word "Grading" in assignment relates only to numerical grades, but the ability to give text feedback remains, and must be recorded in the gradebook. This is why a grade item is created for it. You can hide the grade item if you do not want it to appear in the user reports.

==Weights and extra credits==

===How do weighted grades influence the category or course total?===
Weighted grades behave differently in Weighted Mean of Grades and Natural Grading.

WEIGHTED MEAN OF GRADES
A weight (also called coefficient) only has meaning in reference to other weights. If you only have one grade item, changing its weight will not have any effect. However, if you have two grade items, each with a different weight, the "heavier" item will have more influence on the total grade than the "lighter" one.

You can set the weights to any positive numerical value you choose. Usually, at least one of the weights will be 1 and serve as the baseline for other weights. If another item has a weight of 2, its grades will be multiplied by 2 compared with the grades of the first grade item, before being averaged. The denominator used for averaging is the sum of all the weights.

An example follows:
item 1 weight: 1
item 2 weight: 3
item 3 weight: 0.5

item 1 grade: 40/100
item 2 grade: 60/100
item 3 grade: 20/100

Calculation:
total = ((40 * 1) + (60 * 3) + (20 * 0.5)) / (1 + 3 + 0.5)
= (40 + 180 + 10) / (4.5)
= 230 / 4.5
= 51.11

The total for this category will then be 51.11 out of 100

NATURAL GRADING

Natural grading automatically calculates the weight value in response to the maximum grade that is set for all of the grade items. The weighting column will always add up to 100%.

If you change the weight for one of the grade items, the weighting of the other grade items will all readjust in response to the change.

Example:

item 1 grade: 40/100
item 2 grade: 60/100
item 3 grade: 20/100

Natural Weight (because all items are of equal value (100 points):
item 1: 33.33%
item 2: 33.33%
item 3: 33.33%

If you then adjust the weight for item 1 to 50%, the other two grades will adjust to 25% each -
item 1: 50%
item 2: 25%
item 3: 25%

Calculation:
total = ((40 * 50) + (60 * 25) + (20 * 25)) / 100
= (2000 + 1500 + 500) / 100
= 4000 / 100
= 40

===Do I have to put a value in each "weight" input box?===
WEIGHTED MEAN OF GRADES
No. If you do not put a value, it will default to 1. If all items are set to 1 then they all have equal weight. If you set a weight to 0, the item's grades will not count at all in the category or course average.

NATURAL GRADING
The weights will adjust in response to the weights that you do change. If you only change 2 of 6 total grade items' weight, the other four weights will adjust so that all weights add up to 100.

===Do all the weights have to add up to 100 or some similar value?===
WEIGHTED MEAN OF GRADES
No, the numbers you put as weights are completely arbitrary. They must be positive numbers, and can add up to anything you want. Note however that the following four sets of weights are identical in value:

(1 1.75 3)
(4 7 12)
(8 14 24)
(400 700 1200)

NATURAL GRADING
Natural grading weights MUST equal 100%. If you manually adjust the values of EVERY grade item, and they do not equal 100%, upon saving they will be adjusted to equal 100%, retaining your weighting preferences. If you only adjust a few of your grade items, the remaining items weights will be adjusted so that the total comes to 100%.

Example:
If you set your weights as follows:
item1: 2
item2: 2
item3: 4

Natural grading will adjust them as follows:
item1: 25%
item2: 25%
item3: 50%

===What is the difference between Weight and Extra Credit?===
Weight is only available with "Weighted mean of grades" and "Natural" grading. For the "Simple weighted mean of grades", the weight is taken from the grade item's maximum grade. A weight is used to give a grade item more or less importance in the computation of the category total or average, compared with the other items of the same category.

Extra credit replaces grade item weight if the aggregation method is "Mean of grades (with extra credits)", "Natural", or "Simple weighted mean of grades". The effect of extra credit is different in each case, hence some confusion:

*Mean of grades (with extra credits): A value of 0 does nothing. Any other value is used to multiply the grade and add it to the total after the computation of the mean. This grade is not used in the computation of the mean, however, only added afterwards. Additionally, this cannot bring the category total over its maximum grade unless grades over 100% are enabled by the site administrator (since 1.9.5). This grade item is not counted either in the denominator used to compute the category mean.

*Natural: Extra credit is a checkbox, not a number. Normally, with Natural, the category's maximum grade is the sum of the maximum grades of all its grade items. If one of them is set as "Extra Credit", however, its maximum grade is not added to the category's maximum grade, but its grades will be. This way it is possible to achieve maximum grade (or grades over maximum if enabled by the site administrator) in the category without getting the maximum grade in all the grade items.

*Simple weighted mean of grades: Extra credit is a checkbox, not a number. The "Extra Credit" grades are counted in the numerator used to compute the category mean, but not the denominator. See [[Category_aggregation#Simple_weighted_mean|here]] for more information.

To change a graded item to an extra credit item for Natural or Simple weighted mean of grades:

# Go to ''Course administration > Gradebook setup''.
# Find the extra credit item. To the right of the item, click "Edit > Edit Settings."
# On the Grade Item page, scroll to the bottom and check "Extra credit."
# Click the "Save changes" button.

===How do I create an assignment for which students can receive a grade above the maximum/above 100%?===

#Ask your administrator to go to ''Administration > Site administration > Grades > General settings'' and tick the box 'Unlimited grades'.
#In Grade point maximum (just below the unlimited grades setting) enter the maximum grade point value you wish to be available for all activities.
#In Grade point default (if you wish) enter the default grade point value you wish to display, if you want it to be above 100%.
[[File:gradepointmaxdefault.png]]

===Why can't I enter a grade higher than the maximum?===
See the answer to the question above. Ask your administrator to check ''Administration > Site administration > Grades > General settings''
==Formulas==

===How do I give a fixed score for a successful quiz attempt===

Suppose you want to give 5 points for a passing grade (say, 40) in a certain quiz (which has a maximum score of 100). Possible scenario ([http://moodle.org/mod/forum/discuss.php?d=148576]): extra credit points to every student that gets a "passing grade" in a "practice test" at the end of each chapter covered in the course, to encourage them to practice after the homework quizzes and to get familiar with a "test type" situation before the actual test.

The following formula should do the trick:

=min(round((||quiz||/40)-0.49,0),1)*5

The formula may be added to a designated grade item or category.

Sample calculations:
Score 40 (pass):
=min(round((40/40)-0.49,0),1)*5
=min(round(1-0.49,0),1)*5
=min(round(0.51,0),1)*5
=min(1,1)*5
=1*5
=5

Score 39 (not pass):
=min(round((39/40)-0.49,0),1)*5
=min(round(0.975-0.49,0),1)*5
=min(round(0.485,0),1)*5
=min(0,1)*5
=0*5
=0

Score 100 (pass):
=min(round((100/40)-0.49,0),1)*5
=min(round(2.5-0.49,0),1)*5
=min(round(2.01,0),1)*5
=min(2,1)*5
=1*5
=5

==See also==
* [https://youtu.be/lWcheVbQe2E The Moodle Gradebook] MoodleBites video on YouTube

*Using Moodle [http://moodle.org/mod/forum/view.php?id=2122 Gradebook forum]

Using Moodle forum discussions: (These forum discussions are from before the implementation of the Natural Grading aggregation method but have been left here because they still contain some good information)
*[http://moodle.org/mod/forum/discuss.php?d=123143 Excluding practice quizzes from gradebook]
*[http://moodle.org/mod/forum/discuss.php?d=193705 Course total not sum of max grade column?]
*[https://moodle.org/mod/forum/discuss.php?d=167596 Why do only certain items have multiplicator & offset boxes?]
*[https://moodle.org/mod/forum/discuss.php?d=235640 Extra credit]
*[https://moodle.org/mod/forum/discuss.php?d=269534#unread Change grading method only for some students]

[[Category:FAQ]]

[[ca:PMF de les qualificacions]]
[[de:Bewertungen FAQ]]
[[es:Calificaciones FAQ]]
[[fr:FAQ des notes]]
[[ja:評定FAQ]]

Grade settings

2016-01-19T20:31:11Z

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

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

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

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

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

==Grader report preferences==

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

For example it's possible to set the grader report to only show active participants or all participants (including suspended users) from the ''Show only active enrolments'' setting. (Users may be suspended from the course by changing their status in ''Enrolled users>Edit enrolment.'')

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

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

==Site administration settings==

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

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

===Graded Roles===

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

===User profile report===

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

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

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

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

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

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

===Recover grades default===

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

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

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

==Grade point maximum/Grade point default==

The administrator can set here the maximum point value in activities, and also the default point value which will appear when a teacher uses points for activities in their course. (Both these are set to 100 initially)

[[File:gradepointmaxdefault.png]]

==Grade capabilities==

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

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

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

Grader report

2016-01-19T20:29:39Z

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

{{Grades}}
All the grades for each student in a course can be found in the course gradebook, or 'Grader report' in ''Administration > Course administration > Grades''. For an introduction to the gradebook, see the HQ screencast: [https://www.youtube.com/watch?v=XLxALUCbBgI Where is the Gradebook?]

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

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

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

==Hiding settings globally==

New settings hide parts of the user interface:

*''Site administration>Grades>General settings'': 'Show minimum grade' . If this setting is disabled, the minimum grade will default to zero and cannot be edited.
*''Site administration>Grades>Grade category settings'': 'Allow category grades to be manually overridden'. If this setting is disabled, users cannot override category grades.

===Scrolling through the gradebook===

The gradebook allows for smooth and stable scrolling horizontally and vertically through grades. It uses the whole window, making it accessible on all platforms.( Note: horizontal scrolling is at the bottom of the browser window, and there is no horizontal scrollbar at the top.)

{|
| [[File:scrolling28a.png|thumb|500px|Scrolling in all directions]]
| [[File:wholewindow.png|thumb|500px|Using the whole window]]
|}

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

==Display==

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

[[Image:gradereportcategories.png|center|thumb|600px]]

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

There are three ways that the categories can be displayed:

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

Each section has a small icon immediately to the right of its name. Clicking this will cycle through these display modes for that category;

[[Image:grades3iconsa.png|thumb|500px|center]]

===Sorting by columns===

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

You can also access the [[Single view]] by clicking the pencil icon next to the arrows (2 below).

[[File:iconsgrades.png]]

You can sort the students by clicking the arrow (1 below), access individual [[User report| user reports]] by clicking the icon (2 below) and similar to the grade items you can access [[Single view]] by clicking the pencil icon (3 below)

[[File:studentsort.png]]

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

It is also possible to search students by first name and last name:

[[File:gradebooksearch.png]]

==Editing==

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

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

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

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

===Altering the grades using Single View===
There is a new way to enter grades into the grader report using the Single View tab (or listing in the dropdown) under Setup. (This interface can also be accessed by clicking on the pencil icon at the top of the column by the item name).
The single view interface allows you to enter grades in bulk for a specific grade item or a specific user. To change a specific grade or all grades, click on the Override checkbox by the specific grade row or use the Override All link to check every row. If you wish to override all grades with a set grade, check the Bulk Insert checkbox and enter the grade that you wish to insert. You can select whether to fill the grade for just empty grades or for all grades from the dropdown list.
Click on Save and you will now see in the Grader Report that all grades the specific item/user have been overridden with the grade/grades that you entered.

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

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

==Gradebook capabilities==

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

==Extending the gradebook==

The Gradebook can be extended in three main ways:

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

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

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

==See also==

* Join the discussions about gradebook plugins in the [https://moodle.org/mod/forum/view.php?id=2122 Gradebook forum].
* [http://youtu.be/CMXvtFPmd0o?list=PLxcO_MFWQBDdJmqW4tD5qXJ6pPXWTP7GL Gradebook 2.8 screencast] from Moodle HQ
*[http://youtu.be/ShGv7lwMfm0 Greg Egan - Introduction to grading and the gradebook - iMoot 2013] Excellent clarification of Grader Report, Categories and Items, Scales, Aggregation (especially helpful for accurate overall grades!), Letter Grades, and Rubrics. Outcomes are not covered.
* [https://youtu.be/lWcheVbQe2E The Moodle Gradebook] MoodleBites video on YouTube

[[de:Bewertungen]]
[[es:Libro de calificaciones]]
[[fr:Carnet de notes]]
[[ja:評定表]]

Quiz settings

2016-01-02T21:47:06Z

Cttxg: /* See also */ updating MoodleBites Quiz activity video link

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

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

==General==
Add a name here (which students will click on to access the quiz) and, if desired, a description of what they must do.

==Timing==
{{Note|You can change quiz availability and duration for different groups or users in the Group or User override sections of the Quiz Administration settings block .}}
;Open the quiz
:You can specify times when the quiz is accessible for people to make attempts. Before the opening time the quiz will be unavailable to students. They will be able to view the quiz introduction but will not be able to view the questions. Quizzes with start times in the future diasplay both the open and close date for students.
;Close the quiz
:After the closing time, the students will not be able to start new attempts. Answers that the student submits after the quiz closing date will be saved but they will not be marked.
: Even after the quiz has closed students will still be able to see the quiz description and review their attempts. What exactly they will see depends on the settings you choose for review options (see below).
;Time limit
:By default, quizzes do not have a time limit, which allows students as much time as they need to complete the quiz. If you do specify a time limit, several things are done to try and ensure that quizzes are completed within that time:

[[File:quiz timer.png|thumb|Navigation block showing quiz timer]]

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

There are three options as to what will happen when the time limit is up. Choose the one you need from the dropdown menu:
# Open attempts are submitted automatically (This is the default)
# There is a grace period when open attempts can be submitted, but no more questions answered
# Attempts must be submitted before time expires, or they are not counted

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

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

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

==Grade==
;Grade category
If you have categories in your gradebook, select the one you wish the quiz to be in here.
;Attempts allowed
:Students may be allowed to have multiple attempts at a quiz. This can help make the process of taking the quiz more of an educational activity rather than simply an assessment.
{{Note|You can change the allowed number of attempts for different groups or users in the Group or User override sections of the Quiz Administration settings block.}}
;Grade to pass
Here you can set a passing grade for the quiz. This may be connected with [[Activity completion]] and [[Conditional activities]] such that a student will not be able to access a follow up activity until they have passed the quiz.
;Grading method
:When multiple attempts are allowed, there are different ways you can use the grades to calculate the student's final grade for the quiz.
* Highest grade - the final grade is the highest (best) grade in any attempt
* Average grade - the final grade is the average (simple mean) grade of all attempts
* First grade - the final grade is the grade earned on the first attempt (other attempts are ignored)
* Last grade - the final grade is the grade earned on the most recent attempt only

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

Choose ''Sequential'' instead of ''Free'', if you want to force the student to progress through the questions in order and not go back to a previous question or skip to a later one.

==Question behaviour==
;How questions behave
:See [[Question behaviours]].
;Allow redo within an attempt (available by clicking "Show more")
:If using Interactive or Immediate feedback mode, enabling this setting means students can try a question again even if they have used up their allowed attempts. This is helpful if they wish to learn from the feedback given at the end of their attempts. They will be given a different question from the one they were working on previously if there are other questions available. A student's grade for that question slot is based on the most recent question they have started.
;Each attempt builds on the last (available by clicking "Show more")
:If multiple attempts are allowed and this setting is set to Yes, then each new attempt contains the results of the previous attempt. This allows the student on the new attempt to concentrate on just those questions that were answered incorrectly on the previous attempt. If this option is chosen then each attempt by a particular student uses the same questions in the same order, independent of randomization settings. To show a fresh quiz on every attempt, select No for this setting.

==Review options==
(These settings are collapsed by default)

[[File:quizreview.png|thumb|600px|Review options expanded]]

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

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

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

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

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

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

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

==Appearance==
;Show the user's picture
:It is now possible, when displaying the user's profile picture for proctoring purposes, to choose whether a large image or thumbnail will be displayed.
;Decimal places in grades
:This option determines how many digits will be shown after the decimal separator (see [[dev:Translation_langconfig|langconfig]] ) when the grade is displayed. A setting of 0 for example means that the grades are displayed as integers. This setting is only used for the display of grades, not for the display or marking of answers.

==Extra restrictions on attempts==
;Require password
:If you specify a password in here then participants must enter the same password before they are allowed to make an attempt on the quiz. This is useful to give only a selected group of students access to the quiz.
;Require network address
:You can restrict access for a quiz to particular subnets on the LAN or Internet by specifying a comma-separated list of partial or full IP address numbers. This is especially useful for a proctored (invigilated) quiz, where you want to be sure that only people in a certain room are able to access the quiz. For example: 192.168. , 231.54.211.0/20, 231.3.56.211

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

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

:Spaces are ignored.

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

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

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

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

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

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

|[[File:seb24.png|thumb|Student view of quiz question with full screen popup.]]

:* The students are prevented, as far as is possible, from using facilities like copy and paste.

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

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

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

==Overall feedback==
Overall feedback is shown to a student after they have completed an attempt at the quiz. The text that is shown can depend on the grade the student got. Click "Show editing tools" to display the rich text editor, and drag the bottom right of the text box out to expand it.

For example, if you entered:

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

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

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

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

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

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

==Outcomes==
This setting will only appear if [[Outcomes]] have been enabled by the administrator and are used in the course. See [[Outcomes]] for how to remove an outcome once it has been added to a quiz.

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

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

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

The following automatic activity completion conditions apply to the quiz:

:''Require view'' - the student clicks on the quiz to view it
:''Require grade'' - the student obtains a grade
:''Require a passing grade'' - a 'Grade to pass' is specified for the quiz in the gradebook.
:''All available attempts completed'' - a certain number of attempts were allowed on the quiz and the student has completed them all.

==Group and User overrides==

[[File:overridesquiz.png|thumb|Location of overrides]]

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

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

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

==Site administration settings==

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

The time period settings for a quiz (such as time limit, submission grace period, autosave period and so on) can be set here with a duration of seconds, minutes, hours, days or weeks. These defaults will then be used when new quizzes are created.

;Autosave period
:If enabled, student responses will be saved at regular period according to the selection here. the default is one minute. This is useful so that students don't lose work but does increase the load on the server.

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

==See also==
*[https://youtu.be/y8HOnsKt6qg The Moodle Quiz Activity] MoodleBites video on YouTube

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

Quiz settings

2015-02-04T07:56:14Z

Cttxg: /* See also */ Updating MoodleBites video link

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

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

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

;Description
:Describe the purpose of the glossary and provide instructions or background information, links etc. Click the icon top left to expand the toolbars, and drag the bottom right of the text box out to expand it.

;'''Display description on course page'''
:If ticked, the quiz description will appear on the course page directly under the quiz name.

==Timing==
(These settings are collapsed by default)
{|
|[[File:quiztiming.png|thumb|452px|Timing settings expanded]]
|}

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

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

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

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

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

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

;When time expires..

There are three options as to what will happen when the time limit is up. Choose the one you need from the dropdown menu:
# Open attempts are submitted automatically (This is the default)
# There is a grace period when open attempts can be submitted, but no more questions answered
# Attempts must be submitted before time expires, or they are not counted

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

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

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

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

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

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

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

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

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

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

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

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

==Question behaviour==
(These settings are collapsed by default)
{|
|[[File:quizquestionbehaviour.png|thumb|447px|Question behaviour settings expanded]]
|}
;Shuffle within questions
:If set to 'yes', then each time the student takes a quiz the parts of the question will be shuffled randomly.

;How questions behave
:See [[Question behaviours]].

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

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

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

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

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

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

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

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

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

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

:Show the user's picture
It is now possible, when displaying the user's profile picture for proctoring purposes, to choose whether a large image or thumbnail will be displayed.

;Decimal places in grades
:This option determines how many digits will be shown after the decimal separator (see [[dev:Translation_langconfig|langconfig]] ) when the grade is displayed. A setting of 0 for example means that the grades are displayed as integers. This setting is only used for the display of grades, not for the display or marking of answers.

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

;Require password
:This field is optional.

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

;Require network address
:This field is optional.

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

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

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

:Spaces are ignored.

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

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

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

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

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

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

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

{|
|[[File:seb24.png|thumb|465px|Student view of quiz question with full screen popup. (Click to see enlarged)]]
|}
:* The students are prevented, as far as is possible, from using facilities like copy and paste.

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

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

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

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

For example, if you entered:

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

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

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

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

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

If you're getting confusing error messages about a boundary being out of sequence (when it's obviously *in* sequence), or "boundaries must be between 0% and 100%" (and they are) -- check that the Maximum Grade for this quiz is set to something greater than zero.
==Outcomes==
This setting will only appear if [[Outcomes]] have been enabled by the administrator and are used in the course. See [[Outcomes]] for how to remove an outcome once it has been added to a quiz.

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

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

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

The following automatic activity completion conditions apply to the quiz:

:''Require view'' - the student clicks on the quiz to view it
:''Require grade'' - the student obtains a grade

[[File:quizpassinggrade.png|thumb|500px|center]]

{{New features}}
:''Require a passing grade'' - a 'Grade to pass' is specified for the quiz in the gradebook.
:''All available attempts completed'' - a certain number of attempts were allowed on the quiz and the student has completed them all.

==Group and User overrides==

[[File:overridesquiz.png]]

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

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

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

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

==Site administration settings==

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

;Autosave period
:If enabled, student responses will be saved every minute/two minutes/five minutes (according to selection) This is useful so that students don't lose work but does increase the load on the server.

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

==See also==
*[http://youtu.be/I87h6ijtjls The Moodle Quiz Activity] MoodleBites video on YouTube

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

Quiz activity

2015-02-04T07:55:00Z

Cttxg: Adding MoodleBites YouTube video link

{{Activities}}

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

[[Image:Quizexample.png]]

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

== Features ==

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

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

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

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

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

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

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

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

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

==See also==
*[https://docs.moodle.org/dev/Quiz Quiz] developer's documentation
*[http://www.youtube.com/watch?v=sfGlV5WaZE8 Quiz in Moodle 2.0 video]
*[https://docs.moodle.org/310/en/Word_table_format Microsoft Word table format add-on]
*[http://youtu.be/I87h6ijtjls The Moodle Quiz Activity] MoodleBites video on YouTube
*[http://youtu.be/YQEx0PxRb4c Creating Quiz Questions (part 1)] MoodleBites video on YouTube
*[http://youtu.be/FGIh-5CYwzs Creating Quiz Questions (part 2)] MoodleBites video on YouTube
*[http://youtu.be/BRDbe7JcCBw Creating Quiz Questions (part 3)] MoodleBites video on YouTube
*[http://www.open.edu/openlearnworks/course/view.php?id=1581 eAssessment with Moodle] by the Open University, which showcases the features of the Moodle Quiz

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

Installing a new theme

2015-01-24T08:48:17Z

Cttxg:

{{Themes}}
A new theme can be installed in the same way as any other plugin. Please see [[Installing plugins]] for details.

==Changing the theme==
You may select different themes depending upon the device that will be viewing Moodle. For example, you might have one theme for computers with monitors and another for mobile phones and another for tablets.

# Log in as admin and go to ''Administration > Site administration > Appearance > Themes > Theme Selector''
# Click on "Clear theme caches" button
# Click on the "Select theme" button on the right of the current theme being used for the device
# Scroll down to find the theme you wish to use
# Click the "Use theme" button next to that theme
# Moodle will tell you it has been saved as the default theme
# Check your Moodle site by going to the Moodle site's home page
# You may have to refresh your browser to see the new theme

{|
| [[Image:instheme07.png|thumb|Open the Appearance > Theme selector page]]
| [[Image:instheme09.png|thumb|Click the Select theme button]]
| [[Image:instheme10.png|thumb|Click the Use theme button]]
| [[Image:instheme11.png|thumb|Checking if the theme is the one selected]]
|}

==See also==
* [http://youtu.be/K3MYE8am7M4 Install a New Theme] MoodleBites video on YouTube

[[de:Ein_neues_Design_installieren]]

Themes

2015-01-24T08:47:53Z

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

{{Site appearance}}
Themes provide a "skin" to completely change the look and feel of your site (or even an individual course).

*[[Theme settings]]
*[[Standard themes]] including information on changing your theme
*[[Installing a new theme]]

==See also==

* [[Themes FAQ]]
* [[Theme credits]]
* [[:dev:Themes]]
* [http://www.slideshare.net/ghenrick/a-look-at-moodle-2-themes Themes white paper] by Gavin Henrick
* [http://youtu.be/K3MYE8am7M4 Install a New Theme] MoodleBites video on YouTube

[[Category:Themes]]

[[es:Temas]]
[[eu:Itxurak]]
[[de:Designs]]
[[fr:Thèmes]]
[[ja:テーマ]]

Installing a new theme

2015-01-24T08:47:07Z

Cttxg: Adding MoodleBites YouTube video link

{{Themes}}
A new theme can be installed in the same way as any other plugin. Please see [[Installing plugins]] for details.

==Changing the theme==
You may select different themes depending upon the device that will be viewing Moodle. For example, you might have one theme for computers with monitors and another for mobile phones and another for tablets.

# Log in as admin and go to ''Administration > Site administration > Appearance > Themes > Theme Selector''
# Click on "Clear theme caches" button
# Click on the "Select theme" button on the right of the current theme being used for the device
# Scroll down to find the theme you wish to use
# Click the "Use theme" button next to that theme
# Moodle will tell you it has been saved as the default theme
# Check your Moodle site by going to the Moodle site's home page
# You may have to refresh your browser to see the new theme

==See also==
* [http://youtu.be/K3MYE8am7M4 Install a New Theme] MoodleBites video on YouTube

{|
| [[Image:instheme07.png|thumb|Open the Appearance > Theme selector page]]
| [[Image:instheme09.png|thumb|Click the Select theme button]]
| [[Image:instheme10.png|thumb|Click the Use theme button]]
| [[Image:instheme11.png|thumb|Checking if the theme is the one selected]]
|}

[[de:Ein_neues_Design_installieren]]

Installing plugins

2015-01-24T08:42:18Z

Cttxg: /* See also */ Adding MBites video

{{Installing Moodle}}
Plugins enable you to add additional features and functionality to Moodle, such as new activities, new quiz question types, new reports, integrations with other systems and many more.

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

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

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

==Installing a plugin==

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

Plugin code may be deployed from within Moodle, either directly from the Moodle plugins directory or by uploading a ZIP file. The web server process has to have write access to the plugin type folder where the new plugin is to be installed in order to use either of these methods.

Alternatively, a plugin may be deployed manually at the server.

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

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

===Installing via uploaded ZIP file===

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

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

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

===Installing manually at the server===

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

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

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

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

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

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

==Troubleshooting==

===Errors===

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

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

===A file permissions error has occurred===

A common error after installing plugins is that when you create an instance of the module and then save and display it, it reports the error, "A file permissions error has occurred. Please check the permissions on the script and the directory it is in and try again." If you get this, the file permissions of the package are mostl likely set to 711 preventing them from running correctly. With your preferred FTP client or via your web hosts control panel, set the file permissions of all the files and directories in the installed module, e.g. /moodle/mod/[myplugin]/ to 755 and then see if you can successfully view the module instance.

===When installing manually===

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

===Obtaining help===

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

==Uninstalling a plugin==

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

==Plugins overview==

[[File:plugins overview.png|thumb|center|400px|Plugins overview highlighting available check button]]

The Plugins overview page in ''Administration > Site Administration > Plugins > Plugins overview'' lists all installed plugins, together with the version number,release ''(new in 2.7)'', availability (enabled or disabled) and settings link (if applicable).

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

===Plugin updating from within Moodle===

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

==Preventing installing plugins from within Moodle==

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

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

==See also==

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

For developers:

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

[[Category:Contributed code]]

[[de:Plugins installieren]]
[[es:Instalar complementos]]

Theme settings

2015-01-19T04:28:11Z

Cttxg: Adding MoodleBites YouTube video link

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

[[File:Themesettings.png]]

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

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

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

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

'''NOTE:''' the user's theme will not be available in mobile and tablet devices unless the option ''enabledevicedetection'' is unchecked.

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

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

'''NOTE:''' the course theme will not be available in mobile and tablet devices unless the option ''enabledevicedetection'' is unchecked.

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

'''NOTE:''' the category theme will not be available in mobile and tablet devices unless the option ''enabledevicedetection'' is unchecked.

===Allow theme changes in the URL===

*If this is checked then the theme may be changed by adding <code>?theme=theme_name</code> (or <code>&theme=theme_name</code> if there are other URL parameters) to the URL in the browser.

Theme names used as the URL parameter should be the shortname of the theme, which you can see in ''Site administration > Plugins > Plugins overview'' and scroll down to the Themes section near the bottom. Remove the "theme_" prefix to find the proper shortname. Theme shortnames are usually the same as the main theme name, eg. Clean is 'clean', so your URL parameter for it will be: <code>?theme=clean</code>. Shortnames are always lower case. Themes with multiple words are usually the same but spaces are replaced by underscores, for example the theme "Formal white" should be entered as <code>?theme=formal_white</code>.

[[File:themeshortnames.jpg]]

''Tip:'' You can turn this on to aid in troubleshooting problems that may be theme related. This will allow you to switch to a standard or different theme for your own session without affecting other users or the site theme.

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

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

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

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

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

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

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

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

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

====User menu items====
{{New features}}
The admin may configure the contents of the user menu here. (Note that the log out link is always present.)

'''IMPORTANT NOTE:''' Although it is possible with the custom menu items above to use ### characters as dividers, these should NOT be used in the user menu as this will currently break your Moodle site. See MDL-48542 for more information.

[[File:customusermenu.png|center]]

To add an item you can use three elements:

# a plain text description or a string in "langstringname, componentname" form
# the URL of the page you want to direct to
# an icon (if desired) This can be either the pix icon or the URL of an uploaded icon.

For example, if you wish to add an 'Edit profile' link, add

editmyprofile,core|/user/edit.php|edit

==== Multilanguage support ====

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

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

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

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

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

==Special themes==

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

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

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

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

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

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

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

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

==Particular theme settings==

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

==See also==
*[http://youtu.be/QfhANg1MAZ0 Moodle Theme Settings Page] MoodleBites video on YouTube

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

User profiles

2014-09-21T04:55:24Z

Cttxg: /* See also */ Adding MoodleBites video

{{Site appearance}}
A user's profile may be viewed by clicking on their name. See [[View profile]] for more information on how the profile information is displayed and [[Edit profile]] for information on updating profiles.

==Site administration settings==

===Site policies===

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

===Default profile page===

An administrator or manager (or any other user with the capability [[Capabilities/moodle/user:managesyspages|moodle/user:managesyspages]]) can set which blocks appear on the default profile page for new users.

# Access ''Administration > Site administration > Appearance > Default profile page''.
# Select the required blocks from the "Add a block" drop-down menu. Configure each block as desired.
# Reposition blocks using the arrow icons in the block headers.

==Adding a block to all profile pages==

An administrator can add a new block to all profile pages as follows:

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

==Preventing users from customizing their profile page==

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

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

==User profile capabilities==

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

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

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

==See also==
*[[My profile]]
*[[View profile]]
*[[User profile fields]]
*[[Site policies]]
*[[Update profile]]

* [http://youtu.be/Q3cHQBgp-nA My Profile Settings] MoodleBites video on YouTube

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

Managing a Moodle course

2014-09-21T04:54:55Z

Cttxg: Adding MoodleBites video

{{Main page}}
A'' course'' in Moodle is an area where a teacher will add [[Resources|resources]] and [[Activities|activities]] for their students to complete.It might be a simple page with downloadable documents or it might be a complex set of tasks where learning progresses through interaction. Progress can be [[Tracking progress|tracked]] in a number of ways.

The course page is made up of central sections which contain the tasks and (if desired) [[Block|blocks]] to the side. The course teacher has control over the layout of the [[Course homepage|course homepage]] and can change it at any time.

Students can be [[Course enrolment|enrolled]] manually by the teacher, automatically by the administrator, or they can be allowed to enrol themselves. Students can also be added to [[Grouping users|groups]] if they need to be separated from classes sharing the same course or if tasks need to be differentiated.

* [[Courses]] - how to set up your courses.
* [[Editing text]] - how to use the text editor and what the icons mean.
* [[Activities]] - how to involve students actively in their learning.
* [[Resources]] - how to add static materials to your course.
* [[Blocks]] - how to add extra items and information to the sides of your course page.
* [[Questions]] - how to create questions for use in [[Quiz|quizzes]] and Moodle's [[Lesson|lesson module]]
* [[Course enrolment]] - how to give students access to your course.
* [[Grouping users]] - how to put students into groups and why this is useful.
* [[Grades]] - how to use the gradebook, scales and advanced grading methods.
* [[Tracking progress]] - how to control and display progress through a course.
* [[Reusing activities]] - how to copy or recycle elements of your course.

===See Also===
* [http://youtu.be/lOxTQJfTnvs Course Administration Block] MoodleBites video on YouTube

[[de:Moodle-Kurs verwalten]]
[[es:Gestionando un curso Moodle]]

Administration block

2014-09-21T04:54:06Z

Cttxg: Adding/Updating MoodleBites videos

{{Blocks}}
The Administration block provides context-sensitive links to settings pages.

What appears in the Administration block depends upon the [[Context]] (Page being shown and user's permissions). For example, a site administrator on the front page will have Front page settings while a teacher in a course will have more options in Course administration than a student.

Here are examples of the Administration block:
<gallery widths="200px" heights="200px" perrow="3">

Image:25frontpageadmin.png|Admin view from Front page (collapsed)
Image:25teacheradmin.png|Teacher view in a course (expanded)
Image:25studentadmin.png|Student view in a course (collapsed)
</gallery>

===Administration block menus===
The main menu items (Front page settings, Course Administration, My profile settings and Site Administration) contain a submenu and can be collapsed or expanded to display the (typical) full menu as shown below:
*[[Front_page_settings_block|Front page settings]]
**Turn edit on/off
**Edit settings
**Users
**Filters
**Backup
**Restore
**Questions
**Files

*[[Managing a Moodle course|Course administration]]
**Turn editing on
**Edit settings
**Users
**Filters
**Reports
**Grades
**Badges (if enabled)
**Backup
**Restore
**Import
**Publish
**Reset
**Question bank

*[[Profile |My profile settings]]
**Edit profile
**Change password
**Roles
**Portfolios (if available at site level)
**Security keys
**Messaging
**Blogs
**Make this my default home page (if set at site level)

*[[Site_administration|Site administration]]
**Notifications
**Registration
**Advanced features
**Users
**Courses
**Grades
**Badges
**Location
**Language
**Plugins
**Security
**Appearance
**Front page
**Server
**Reports
**Development
**Question engine upgrade helper

===See also===
* [http://youtu.be/lOxTQJfTnvs Course Administration Block] MoodleBites video on YouTube
* [http://youtu.be/Q3cHQBgp-nA My Profile Settings] MoodleBites video on YouTube

[[de:Einstellungen-Block]]
[[es:Bloque de administración]]
[[eu:Ezarpenak_blokea]]

Folder resource settings

2014-09-13T05:11:41Z

Cttxg: /* See also */ updating MoodleBites video link

{{Folder}}

==Adding a folder to your course==

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

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

====Quick method====

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

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

====Longer method====

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

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

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

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

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

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

==Display folder contents==

Decide here whether to have the folder displayed on a separate page (the default) or inline with or without subfolders expanded or collapsed.

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

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

==Folder capabilities==

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

==Site administration settings==

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

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

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

[[de:Verzeichnis konfigurieren]]
[[es:Configuraciones del recurso carpeta]]

URL resource settings

2014-08-25T00:01:45Z

Cttxg: /* See Also */

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

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

==General==

[[File:urlgeneral25.png]]

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

==Content==

[[File:Url.png]]

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

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

[[File:urlappearance.png]]

===Display===

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

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

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

==URL variables==
(These settings are collapsed by default.)

[[File:url.png]]

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

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

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

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

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

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

==URL module capabilities==

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

==Site administration settings==

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

===Frame height===

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

===Require activity description===

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

===Password===

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

===Include role names in parameters===

===Available display options===

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

===Default values for activity settings===

Here you can set the defaults for this resource.

==See Also==
* [http://youtu.be/X32dao-UENQ The Moodle URL Resource] MoodleBites video on YouTube

[[de:Link/URL konfigurieren]]
[[fr:Paramètres de l'URL]]
[[es:Configuraciones del recurso URL]]

URL resource settings

2014-08-25T00:01:27Z

Cttxg: Adding MoodleBites video

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

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

==General==

[[File:urlgeneral25.png]]

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

==Content==

[[File:Url.png]]

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

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

[[File:urlappearance.png]]

===Display===

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

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

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

==URL variables==
(These settings are collapsed by default.)

[[File:url.png]]

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

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

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

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

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

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

==URL module capabilities==

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

==Site administration settings==

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

===Frame height===

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

===Require activity description===

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

===Password===

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

===Include role names in parameters===

===Available display options===

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

===Default values for activity settings===

Here you can set the defaults for this resource.

===See Also===
* [http://youtu.be/X32dao-UENQ The Moodle URL Resource] MoodleBites video on YouTube

[[de:Link/URL konfigurieren]]
[[fr:Paramètres de l'URL]]
[[es:Configuraciones del recurso URL]]

Using Page

2014-08-25T00:00:25Z

Cttxg: Adding MoodleBites video

{{Page}}==Why a page and not a file?==
#Opens seamlessly - no clunky attempts to launch third party software (e.g. Microsoft Word) which some users may not be able to access.
#Can be accessed by mobile devices e.g. smartphones (again, not all smartphones can handle word-processed documents)
#Much easier for the Teacher to edit (i.e. saves time)
#Much more accessible, and readily configurable for reading (easier to resize text, change colours, etc, in the web browser)
#Can contain links - e.g. to files, to web pages, or to Glossary entries

===When to use a page rather than a file ===
Use a page if:
*The document doesn't need to be printed
*You need to update it fairly often
*You don't need to impose strict control over the way it looks (for accessibility reasons you should, if educationally appropriate, avoid taking control)
*Your students may need to refer to it (on their smartphone for example) frequently for reference e.g. timetable, schedule, tutorial groups, reading list.

==How to create a page==

===Typing directly into the Editor===
See [[Page module settings]]
===Drag and drop text into a page===
It's possible to select text from a website or a word processed document and create a page by drag and drop.

''Note: this does not work with IE, Safari 6 or below and is unreliable with Firefox''
*Drag and drop upload of text/links must be enabled in ''Administration > Site administration > Development > Experimental > Experimental settings''
*Select the text you wish to use, for example in a Word document. '''Note: Pasting from MS Word is fraught with danger.''' See [[#Pasting from another document]] below.
*With the editing turned on, drag the text over to the section you want it to appear.
*From the box that appears, choose "Create a new page resource"
*Give it a name and then click "upload".
{|
|[[File:pagedragdrop1.png|thumb|Select your text and drag into the course page]]
|[[File:pagedragdrop2.png|thumb|Give your page a name]]
|[[File:pagedragdrop3.png|thumb|The page is created]]
|[[File:pagedragdrop4.png|thumb|View of the page created from dragged and dropped text]]
|}

===Pasting from another document===
To safeguard against unpredictable, ugly, and inaccessible results, it's important to take some easy extra steps when pasting word processed and other text into web authoring software including Moodle.

#Open the document containing the text you want to paste into your new Page, and copy that text ready to paste.
#Follow steps 1-6 for the section above on 'Typing directly into the editor'.
#When you are ready to paste the content into Moodle, you have two choices:
#*If you want to keep the original formatting then click the Paste From Word icon; a pane loads containing an empty text field and you can press your keyboard's Control and V keys to paste what you copied into the text field; then click the Insert button; your text appears and can be edited within learn.gold. N.b. if the original formatting does not conform to Web accessibility requirements, it won't be transferred.
#*Alternatively, if you want to strip away all formatting, rather than the Paste From Word icon you instead click the Paste As Plain Text icon and proceed to paste directly.
#Follow steps 8-9 for the section above on 'Typing directly into the editor'.

==See also==
* [http://youtu.be/j1uHPVFJFdM The Moodle Page Resource] MoodleBites video on YouTube

[[de:Textseiten nutzen]]

Page resource settings

2014-08-24T23:59:47Z

Cttxg: /* See also */ Updating MoodleBites video

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

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

==General==
[[File:pagegeneral26.png]]

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

==Content==
[[File:pagecontent26.png]]

Add your page content here. You can use the features of the [[Text editor|Text editor]] to add media, images, links and more.

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

[[File:pageappearance26.png]]

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

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

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

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

==Page module capabilities==

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

==Site administration settings==

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

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

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

===Default values for activity settings===

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

==See also==
* [http://youtu.be/j1uHPVFJFdM The Moodle Page Resource] MoodleBites video on YouTube

[[de:Textseite konfigurieren]]
[[es:Configuraciones del módulo página]]

File resource settings

2014-08-24T23:58:26Z

Cttxg: /* See also */ Updating MoodleBites video

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

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

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

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

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

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

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

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

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

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

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

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

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

To summarise:

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

===Show size.type===

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

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

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

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

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

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

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

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

==File module capabilities==

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

==Site administration settings==

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

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

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

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

===Default values for activity settings===

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

==See also==
*HQ Youtube video tutorial: [https://www.youtube.com/watch?v=Vr41LtX8Mlc&index=21&list=PLxcO_MFWQBDdQjcGsbROYKwEIM-IlXmpR Dragging and dropping files into Moodle]
*HQ Youtube video tutorial: [https://www.youtube.com/watch?v=07MpjfRIpXY&list=PLxcO_MFWQBDdQjcGsbROYKwEIM-IlXmpR&index=21 Uploading files to Moodle]
* [http://youtu.be/Rg2Xwe4HOFQ The Moodle File Resource] MoodleBites video on YouTube
*[http://youtu.be/ZPaVskLCRb4 Moodle 2 file management] MoodleBites video on YouTube

[[de:Datei konfigurieren]]
[[es:Configuraciones del recurso archivo]]

Using Label

2014-08-24T23:56:58Z

Cttxg: /* See also */ Adding MBites video

{{Label}}
A label is a versatile module that can serve a spacer between resources on a course page. It can provide a space for embedding banners, sound or video files or displaying code from Web 2.0 widgets.
==Adding images to a label==

===Drag and drop images===
''Note: this does not work with IE 9, Safari 6 or below or earlier versions of Firefox)''
*Media drag and drop must be enabled in ''Administration > Site administration > Plugins > Activity modules > Label''
*With the editing turned on, drag your image into the section you want it to appear.
*In the box that follows, choose "add image"
*It will appear embedded in a label.

{|
| [[File:dragdrop1.png|thumb|Drag an image onto your course page]]
|[[File:dragdrop2.png|thumb|Choose "add image.."]]
|[[File:dragdrop3.png|thumb|And here it is!]]
|}

===Conventional method===
*Follow the instructions for [[Label_module_settings| adding a label]]
*Click the image icon in the [[HTML_editor|text editor]]
[[File:Imageicon.png]]
*Click "Browse repositories"
*Choose and upload your image using the filepicker.(Details on how to do this[[File_picker| here]])
*Click "Save and return to course"

[[File:Labelbanner2.png]]

==Adding text to a label==
===Conventional method===
As the label uses the [[Text editor]] it is straightforward to enter text and other required symbols and equations. It is however possible also to drag and drop text directly into a label.

===Drag and drop text===
''Note: this does not work with IE, Safari 6 or below and is unreliable with Firefox''
*Drag and drop upload of text/links must be enabled in ''Administration > Site administration > Development > Experimental > Experimental settings''
*Select the text you wish to use, for example in a Word document.
*With the editing turned on, drag the text over to the section you want it to appear.
*From the box that appears, choose "add a label" and then "upload".

{|
|[[File:textdragdrop1.png|thumb|Text selected from a Word document is dragged over]]
|[[File:textdragdrop2.png|thumb|Choose "add a label" (or page if you prefer)]]
|[[File:textdragdrop3.png|thumb|And here it is!]]
|}

==Adding a link to a label==
===Conventional method===
As the label uses the [[Text editor]] it is straightforward to click the "link" icon and enter your linked URL. It is however possible also to drag and drop links directly into a label.

===Drag and drop links===
''Note: this does not work with IE, Safari 6 or below and is unreliable with Firefox''
*Drag and drop upload of text/links must be enabled in ''Administration > Site administration > Development > Experimental > Experimental settings''
*Open up a new window with the URL you wish to link to. Select the link in the browser bar.
*With the editing turned on, drag the URL over to the section you want it to appear.
*From the box that appears, name the link and then click "upload".

{|
|[[File:linkdragdrop1.png|thumb|Select your URL]]
|[[File:linkdragdrop2.png|thumb|Name the link]]
|[[File:linkdragdrop3.png|thumb|Here it is!]]
|}

==Adding sound or video to a label==
If multimedia filters are enabled, a label is a neat way of displaying sound or video in an inline player on the course page.
*Follow the instructions for [[Label_module_settings| adding a label]]
*Click the media icon in the [[HTML_editor|text editor]]

[[File:Addmedia.png]]

*Click "Find or upload an sound,video or applet"
*Choose and upload your sound or video file using the filepicker.(Details on how to do this[[File_picker| here]])
*Note: You can search youtube for a video to embed if your admin has enabled the youtube repository.
*Leave Common module settings at "show" if you wish the label to be visible.
*Click "Save and return to course"

[[File:Videoinlabel.png]]

==Adding code to a label==
An example of this is the ability to embed a Google map into a label.
*Follow the instructions for [[Label_module_settings| adding a label]]
*Expand the toolbar and click the HTML icon in the [[HTML_editor|text editor]]

[[File:Codelabel.png]]

*This brings up the screen in code (HTML) view.
*Paste the code you grabbed from Google maps into this screen
*Scroll down and click "Update"
[[File:Addcode.png]]

*Leave Common module settings at "show" if you wish the label to be visible.
*Click "Save and return to course"

[[File:Googlemaplabel.png]]

Note: The success in adding code to a label depends both on the type of code and the permissions of the user. (Details to follow)

==See also==
* [http://youtu.be/C6wZaC5gOHk The Moodle Label Resource] MoodleBites video on YouTube

Using Moodle forum discussions:
*[http://moodle.org/mod/forum/discuss.php?d=165626 Right align not behaving as desired]

[[de:Textfelder nutzen]]

Label module settings

2014-08-24T23:56:29Z

Cttxg: /* See also */ updating MBites video

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

==General==
{|
|[[File:Atto1row.png|thumb|Editor with single toolbar]]
|[[File:Atto2rows.png|thumb|Editor expanded]]
|}

*Type your chosen words or add your resources.

*Note: Because the label has the [[HTML_editor| text editor]], it is possible not just to type words but also to add images, links, media or code from within the labels' editor. See [[Using_Label| here]] for suggestions about using labels in your course.

==Common module settings==
(These settings are collapsed by default.)
*Leave Common Module settings as "show" for the label to be visible.
==Restrict access/Activity completion==
(These settings are collapsed by default)

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

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

[[File:newlabel25.png]]

==Label capabilities==

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

==See also==
* [http://youtu.be/C6wZaC5gOHk The Moodle Label Resource] MoodleBites video on YouTube

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

Course formats

2014-08-14T09:33:31Z

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

{{Courses}}
A course format refers to the layout of a course. The course format can be selected in ''Administration > Course administration > Edit settings''.

An administrator can enable, disable or delete course formats for courses in ''Administration > Site administration > Plugins > Course formats > Manage course formats.'' They can also change the order in which available course formats are displayed to teachers in the course settings.

{|
|[[File:managecourseformats.png|thumb|Manage course formats screen for admins]]
|}

==Standard course formats==

===Weekly format===
[[Image:Weeklyoutline.png|thumb|Weekly format example]] The course is organized week by week, with a clear start date and a finish date. Moodle will create a section for each week of your course. You can add content, forums, quizzes, and so on in the section for each week.

:''TIP:'' If you want all your students to work on the same materials at the same time, this would be a good format to choose.

:''NOTE:'' Make sure your course start date is correct. If it is not your weeks will have the wrong date on it. This is especially important if you are restoring a course to use with a new section of students.

===Topics format===
[[Image:Topicoutline.png|thumb|Topic format example]]The course is organised into topic sections that a teacher can give titles to. Each topic section consists of activities, resources and labels.

TIP: This is great to use if your course is objective based and each objective may take different amounts of time to complete. An example of this would be scaffolding where the students are building upon the knowledge from earlier topics.

===="Show only one section"====

With the Weekly, Topics and any contributed format that implements the functionalty, it is possible via ''Administration > Course administration > Edit settings'' to "show one section per page". Here is a course with eight topics, with the third one currently shown. The links left and right lead to topics two and four:

[[Image:Single_section_page.png|frame|center|Single section page]]

''Notes:''
*The course home page shows just the section names and any text in the section description along with activity and resource numbers, with the names being click-able.
*If editing is ON, then the Main course page will display all the content in all the sections.
*There is a 'Jump to...' menu at the bottom of each single section page (new in 2.5 onwards).

===Social format===
[[Image:Socialformat.png|thumb|Social format example]] This format is oriented around one main [[Forum module|forum]], the social forum, which appears listed on the main page. It is useful for situations that are more free form. They may not even be courses. The [http://moodle.org/course/view.php?id=55 Moodle Lounge] is an example of a social format course.

The social forum can be edited by clicking the 'Update this forum' button on the social forum page. The forum introduction is displayed at the top of the course page. Activities and resources can be added on side utilising the [[Social activities block]].

===Single activity format===
The single activity format only has 1 section, and allows the teacher to add one activity only to the course. When the single activity format is selected, a drop down menu appears for the teacher to choose the activity they wish to use. See the "See also" section below for a screencast and working example of the single activity course format.

{|
|[[File:26singleactivity.png|200px|thumb|Selecting the Single activity format]]
|}

Note: This course format replaces the SCORM format in earlier versions of Moodle, as it is possible here to select a SCORM package as the single activity.

Single activity format with a forum as the activity and social format are very similar. The only difference is when the course contains other activities. The single activity format displays them as "orphaned" and for teachers only; the social format displays them in an activities block and available for students.

==Contributed Course Formats==
The Moodle community has developed a number of course formats, available in the [https://moodle.org/plugins/browse.php?list=category&id=19 plugins directory]. If you plan to create a new one, see [https://docs.moodle.org/dev/Course_formats Developers documentation].

See MDL-27646 and MDL-28555 and maybe the discussion http://moodle.org/mod/forum/discuss.php?d=175758#p770737

===Collapsed Topics===

This is a format that is essentially the same as the standard Topic and Weekly formats but with a 'toggle' for each section except '0'. The toggles' purpose is to reduce the amount of initial information presented to the user thus reducing the 'scroll of death' that can plague courses with a lot of content. The 'state' of the toggles is remembered on a per course per user basis. For more information, please visit [[Collapsed_Topics_course_format]].

==== Overview ====

For an overview of 'Collapsed Topics' please see this video:

<mediaplayer>https://www.youtube.com/watch?v=c9NaEAPPC5E</mediaplayer>

===Daily format===
The [https://moodle.org/plugins/view.php?plugin=format_days daily format] is a modification of the weekly format that shows sections by day rather than by week.

===Grid format===
The [https://moodle.org/plugins/view.php?plugin=format_grid grid format] is a modular and visual course format. Hides all topics and creates a grid of icons (one for each topic) with short titles. Clicking on an icon brings up the content from the corresponding topic in a "lightbox" style display.

===Menutopic format===
The [https://moodle.org/plugins/view.php?plugin=format_menutopic menutopic format] allows you to display the topics/sections in a menu.

===Noticeboard format===
The [https://moodle.org/plugins/view.php?plugin=format_noticebd Noticeboard format] presents the latest post in the news forum at the top of the course.

===Onetopic format===
The [https://moodle.org/plugins/view.php?plugin=format_onetopic onetopic format] shows each topic in a tab, keeping the current tab between calls to resources, in such a way that when it returns from a module as the blog or the glossary it returns to tab from where you started. This format is based on the Moodle standard format: “Topics”.

===Topic format (colors)===
The [https://moodle.org/plugins/view.php?plugin=format_colours colored topic format] is based on the 'Topics' standard format and allows a teacher to specify the foreground and background colours for each course section.

===Flexible sections format===
The [https://moodle.org/plugins/view.php?plugin=format_flexsections flexible sections format] for Moodle 2.4+ allows to have nested sections and each section may be displayed expanded (with all content on the parent section page) or collapsed (as a link to a separate page)

Other contributed course formats are available from the [http://moodle.org/plugins modules and plugins database].

==See also==
* [http://youtu.be/19ke-cvhnug Moodle Course Settings] MoodleBites video on YouTube
*Screencast: [http://www.youtube.com/watch?v=bkdgPGHJi3Q&feature=share&list=SPxcO_MFWQBDe8RRnGjoUDqbcm9PSlIoWn&index=2 Single Activity course format]
*Example of a single activity course format on school.demo.moodle.net: [http://school.demo.moodle.net/mod/quiz/view.php?id=1511 Moodle History Quiz] (Log in with username: ''parent'' and password: ''moodle'')

*Using Moodle [http://moodle.org/mod/forum/view.php?id=47 Course formats forum]
*[http://www.moodleman.net/archives/47 Getting the most out of course design] blog post describing various contributed course formats

Using Moodle forum discussions:
*[http://moodle.org/mod/forum/discuss.php?d=116428 Social format: where to put an introduction]
*[http://moodle.org/mod/forum/discuss.php?d=136453 RSS Feed for forum in a Social Format course]

[[de:Kursformate]]
[[es:Formatos de curso]]
[[fr:Formats de cours]]

Course settings

2014-08-14T09:30:09Z

Cttxg: /* See also */

{{Courses}}
A teacher, or other user with the [[Capabilities/moodle/course:update|update course settings capability]], can change course settings in ''Administration > Course administration > Edit settings''.

==General==
{|
|[[File:generalcourse25.png|thumb|500px|General settings,expanded by default]]
|}

===Course full name===

This is the name of the course. It is displayed as a link on course lists on the [[Front page]] and on [[My home]] and in reports. It is also used in the browser title bar when the course is viewed.

The capability [[Capabilities/moodle/course:changefullname|moodle/course:changefullname]] controls whether a user can edit the course full name.

===Short name===

Many institutions have a shorthand way of referring to a course, such as BP102 or COMMS. Even if you do not already have such a name for your course, make one up here. It will be used in several places where the long name is not appropriate, such as the Navigation block.

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

By default, only course full names are displayed in the list of courses. However an administrator can enable short names to be displayed too if required by ticking the checkbox in ''Administration > Site administration > Appearance > Courses''.

=== Course category===

The site administrator may have created course categories to help teachers and students find their courses easily. Course categories may be reflected in the [[Navigation block]].

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

===Course start date===

This setting affects the display of logs and the weekly format topic dates.

If you use the "Weekly" course format, the start date will appear in the first section of the course. For example selecting 27 July, will display "27 July - 2 August" in the first section (when default display is selected for that section).

This setting will have an effect on the display of logs. This will be the earliest possible date the log activity will display.

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

:''TIP:'' If your institution runs on a weekly schedule, you may want to consider setting the start date for courses on the first day of the week, like a Monday. Please note that the 'first day of the week' is set by the [https://docs.moodle.org/dev/Translation_langconfig langconfig file] of your [[Language]], and might be different from the default Monday of the English language pack.

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

:''TIP:'' See self enrolment course settings to prevent students from entering the course before a certain date/time.

===Visible===

Here you can "hide" your course completely. It will not appear on any course listings, except for managers, course creators, teachers and any other users with the [[Capabilities/moodle/course:viewhiddencourses|view hidden courses capability]]. Even if students try to access the course URL directly, they will not be allowed to enter.

The [[Capabilities/moodle/course:visibility|hide/show courses capability]] controls whether a user can hide a course.

Note: In earlier versions of Moodle, this setting was named 'Course availability'.

=== Course ID number===

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

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

==Description==
{|
|[[File:coursesummary.png|thumb|500px|Description settings expanded by default]]
|}

===Course summary===

The summary appears on the course listings page. This field is searched when searching for a course and also appears in the Course/Site description block.

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

===Course summary files===

An image (and if allowed by the administrator, other file types) may be attached to the course summary. They will be accessible by anyone from outside of the course just like the course name and/or summary. Only users with [[Capabilities/moodle/course:changesummary| moodle/course:changesummary capability]] are able to upload/change course summary files.
''Note that if this is not allowed by the administrator, then no box will appear to upload course summary files''.

By default, only jpg, gif and png file types are allowed as course summary files. An administrator can change the allowed file types in ''Administration > Site administration > Appearance > Courses''.

==Course format==

(These settings are collapsed by default.)
{|
|[[File:coursefomat25.png|thumb|500px|Course format settings expanded]]
|}

===Format===

See [[Course formats]]

===Number of sections===

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

If the number of weeks/topics is changed for an existing course so that the number is less than the number of course sections containing activities (for example the course contains activities in 3 sections and the number or weeks/topics is set to 2) then when editing is turned on section(s) at the bottom of the course page will be shown with the title 'Orphaned activities'.

The number of weeks/topics may be set to 0, so that only the top general section is displayed on the course page and there are no numbered sections.

By default, the maximum number of weeks/topics is 52, but an administrator can set a different maximum number which will apply to all courses on the site (see below).

===Hidden sections===

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

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

===Course layout===

The Course layout setting determines whether the whole course is displayed on one page or split over several pages. The setting currently applies to the topics and weekly core course formats and contributed collapsed topics course format only.

Teachers choose from the dropdown whether they wish to "show all sections on one page" in the familiar scrolling format, or "show one section per page".

If one section per page is selected, the course page is abbreviated to a list of links to individual sections. If an individual section is shown, next and previous sections may be accessed via links above and below the section.

{|
| [[File:one section per page course format.png|thumb|Course page for course using one section per page course layout]]
| [[File:Single_section_page.png|thumb|Individual section of a course using one section per page course layout]]
|}

Visit the School demo site course [http://school.demo.moodle.net/course/view.php?id=37 The Types of Sport] to see the "Show one section per page" course layout in action!

For further details plus screenshots, see blog post [http://www.somerandomthoughts.com/blog/2012/05/08/moodle-2-3-section-per-page/ Moodle 2.3 – Section per page] by Gavin Henrick.

==Appearance==

(These settings are collapsed by default.)

{|
|[[File:appearancecourse252.png|thumb|500px|Appearance settings expanded]]
|}

===Force theme===

If the site administrator has allowed the teacher to set a course [[Themes|theme]], this pull down menu will appear with a list of themes on the site. Teachers can use this to choose a different look for the course from the rest of the Moodle site.

=== Force language===

If you force a language in a course, the interface of Moodle in this course will be in this particular language, even if a student has selected a different preferred language in his/her personal profile.
{{New features}}
The capability [[Capabilities/moodle/site:forcelanguage|moodle/site:forcelanguage]] may be allowed by the admin for users who need to override this language (for example, when testing problems in a course in a language they do not know.)

===News items to show===

How many news items should show the [[Latest news block]]. Set it to 0 and Latest news block will not appear.

The Latest News block relies on the use of the associated News Forum. News posted in other forums do not display in the latest News block

===Show gradebook to students===

Here you can decide whether to allow students to see the link to [[Grades|grades]] in the Administration block. If your course doesn't use graded activities, it makes sense to disable this. If grades are used and this link is disabled, students can still see their grade from the actual activity itself, such as an [[Assignment|assignment]]

===Show activity reports===

Here you can decide whether to show students their [[Activity_report#Individual_Activity_Report|activity reports]]. Doing so places a load on the server however, which is why the setting is disabled by default.

==Files and uploads==

(These settings are collapsed by default.)

===Maximum upload size===

Here you can decide the largest size of file that students can upload to a course. The site administrator can determine [[Site_policies#Maximum_uploaded_file_sizefile |sizes available]] for the teacher to select.

Editing teachers or other users may be allowed to upload files larger than the maximum size by giving them the capability [[Capabilities/moodle/course:ignorefilesizelimits|moodle/course:ignorefilesizelimits]]

==Completion tracking==

(These settings are collapsed by default.)

Completion tracking must be enabled for [[Activity completion]]. [[Course completion]] criteria may also be based upon Activity completion values found in the activity's settings.

==Guest access==

(These settings are collapsed by default.)
{|
|[[File:guestaccess25.png|thumb|500px|Guest access settings expanded]]
|}
Here you can decide whether to allow logged in users to access the course as a guest, and whether or not they need to enter a password. See [[Guest role|Guest role]] for more information.

==Groups==

(These settings are collapsed by default.)
{|
|[[File:coursegroups25.png|thumb|500px|Groups settings expanded]]
|}

===Group mode===

Here you can define the [[Groups|group mode]] at the course level by a pull down menu. "[[Groups#No_groups|No groups]]", "[[Groups#Separate_groups|Separate groups]]" and "[[Groups#Visible_groups|Visible groups]]" are the choices. The selected setting will be the default group mode for all activities defined within that course. The group setting can affect what users see in the [[Participants]] list and who they can interact with in activities.

===Force===

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

===Default grouping===

If [[Groupings|groupings]] are enabled, a default grouping for course activities and resources may be set.

==Role renaming==

(These settings are collapsed by default.)
{|
|[[File:rolerenaming.png|thumb|500px|Role renaming settings expanded]]
|}
You can rename the [[Roles|roles]] used in your course. For example, you may wish to rename the [[Teacher role]] as "Facilitator", "Tutor" or "Guide". These new role names will appear within the course. For example on the [[Participants|participants]] and the override permissions pages.

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

== Site administration settings==

An administrator can set course default settings in ''Administration > Site administration > Courses > Course default settings''.

The maximum number of weeks/topics may be set for all courses on the site. The default value is 52.

==Preventing teachers from editing course settings==

Any/all of the following fields - course full name, short name, ID number and category, summary - may be locked to prevent teachers from editing them. To do so:

#Access ''Site Administration > Users > Permissions > Define roles''.
#Click the edit icon opposite the teacher role.
#Change any/all of the capabilities [[Capabilities/moodle/course:changefullname|moodle/course:changefullname]], [[Capabilities/moodle/course:changeshortname|moodle/course:changeshortname]], [[Capabilities/moodle/course:changeidnumber|moodle/course:changeidnumber]], [[Capabilities/moodle/course:changecategory|moodle/course:changecategory]], [[Capabilities/moodle/course:changesummary|moodle/course:changesummary]] from allow to not set.
#Click the "Save changes" button at the bottom of the page.

==See also==
* [http://youtu.be/19ke-cvhnug Moodle Course Settings] MoodleBites video on YouTube
* [http://youtu.be/rg6rUuBwITo Moodle 2 Administration Courses] MoodleBites video on YouTube

[[de:Kurseinstellungen]]
[[es:Configuraciones del curso]]
[[eu:Ikastaroaren_ezarpenak]]
[[fr:Paramètres du cours]]
[[ja:コース設定]]

Adding a new course

2014-08-14T09:29:41Z

Cttxg: /* Screencasts */ Updating MoodleBites video link

{{Courses}}

By default a regular teacher can't add a new course. To add a new course to Moodle, you need to have either [[Administrator|Administrator]], [[Course creator|Course Creator]] or [[Manager|Manager]] rights.

==Adding a course==
To add a course:
*Go to ''Administration>Site Administration>Courses>Manage courses and categories''
{|
|[[File:26addcourse.png|200px|thumb|Link to add a new course]]
|[[File:26addcourse1.png|200px|thumb|Click New course in the category page on the right]]
|}

*Click on the category where you want your course to be. For more information see [[Course categories|Course categories]]
*Click the "New course" link
*Enter the [[Course settings|course settings]], then click the "Save changes" button.
*On the next screen, choose your students/teachers to assign to the course.

==Deleting a course(s)==

A regular teacher can't delete a course. Administrators and managers (i.e. users with a role for which the capability [[Capabilities/moodle/course:delete|moodle/course:delete]] is allowed) can delete courses. A [[Course creator|Course creator]] can delete courses they have created themselves.

To delete a course (as an administrator or manager):
*Go to ''Administration>Site Administration>Courses>Manage courses and categories''
*Click the course's category and click the course in the screen on the right.
*Click the Delete link.

{|
|[[File:26coursedelete.png|200px|thumb|Deleting a course]]
|}

You can delete multiple courses by:
*Creating a new (temporary) category. You can name it "To be deleted".
*Select and '''move''' the "About to be deleted" courses to that category ("To be deleted").
*Delete the category ("To be deleted") and choose "Delete ALL - cannot be undone".

There is no user interface for course creators to delete courses they have created; however they can do so by editing the URL of the course from <nowiki>http://yourmoodlesite.net/course/view.php?id=N</nowiki> to <nowiki>http://yourmoodlesite.net/course/delete.php?id=N</nowiki> (replacing 'view' with 'delete').

==Course requests==

[[File:Courserequest.png|thumb|Course request screen]]The course request feature can be enabled by an administrator in ''Settings > Site administration > Courses > Course request''.

An admin can set the default category for course requests, whether users can select a category when requesting a course, and who can receive notification of course requests (from a list of users with the capability [[Capabilities/moodle/site:approvecourse|moodle/site:approvecourse]]).

A 'Request a new course' button will then appear on the 'All courses' page. The All courses page can be accessed via a link in the [[Courses block]].

If course requests are enabled, by default all authenticated users can make course requests. See [[Course requester role]] for details of how to restrict users who can make course requests.

==Bulk course creation==
For full details on how to bulk create courses and use course templates, see [[Upload courses]].

# Go to ''Administration > Site Administration > Courses > Upload courses''.
# Upload a CSV file either by dragging and dropping or using the button to select from the File picker.
# Select your import options and click Preview. If the settings are acceptable, click Upload.

==Course templates==
It is possible, from ''Administration>Site Administration>Courses>Upload courses'' to specify a course and settings to use as template for future courses:

===Using an existing course as a template===

First, create or locate on your Moodle the course you wish to use as a template and make a note of its shortname. A template course might for example have common headings or section summaries or policy agreements used throughout the site for consistency.

''Note that only the content of the course will be restored; not its settings. Settings are added separately.''

====Method 1====

*Create your csv file. See [[Upload courses]] for accepted fields.
*From ''Site administration>Administration>Courses>Upload courses'', add your file.
*Preview it and scroll down to 'Course process'. In the box 'Restore from this course after upload', add the shortname of your template course.
*If you are creating several courses using the same template and you wish them all to have the same settings, you can specify these in the Default course values.
*Upload your csv file.

{|
|[[File:template1.png|thumb|400px|Adding shortname of template course]]
|
|[[File:26defaultcoursevalues.png|thumb|400|Default course values]]
|}

====Method 2====
*All the settings and the chosen template course can be specified in the csv file you create. Use ''templatecourse'' as the field for your chosen template course, and use the course shortname. See [[Upload courses]] for full list of fields you can include.
*Here is an example of a csv file for restoring a course to be used as a template. It specifies for example the theme, language, enrolment method and alternative names for student and teacher.

<code bash>
shortname,fullname,category,newsitems,theme,lang,format,enrolment_1,enrolment_1_role,role_student,role_teacher,templatecourse
Knit,Knitting,2,0,afterburner,fr,topics,manual,student,NewKnitter,MasterKnitter,OMT
</code>
*Go to Administration>Site administration>Courses>Upload courses and add your csv file.

===Using a backup course as a template===
It is possible during the process of creating courses with a csv file in ''Site administration>Administration>Courses>Upload courses'' to specify and upload a backup file to be used as a template.

*Create your csv file. See [[Upload courses]] for accepted fields.
*From ''Site administration>Administration>Courses>Upload courses'', add your file.
*Preview it and scroll down to 'Course process'. In the box 'Restore from this file after upload', add the backup file you wish to use as the template.
*If you are creating several courses using the same template and you wish them all to have the same settings, you can specify these in the 'Default course values' section.
*Alternatively, you can specify the course settings (such as format, enrolment methods, language) in the csv file. This method is useful if you wish different courses using the same template to have different settings.
*Upload your csv file.
{|
|[[File:template2.png|thumb|400px|Uploading a template course]]
|}

==See also==

===Screencasts===
* [http://youtu.be/MzK2jb-9SwE Bulk course creation]
* [http://youtu.be/19ke-cvhnug Moodle Course Settings] MoodleBites video on YouTube
* [http://youtu.be/rg6rUuBwITo Moodle 2 Administration Courses] MoodleBites video on YouTube

===Forum discussions===
*Using Moodle [http://moodle.org/mod/forum/discuss.php?d=83830 Hide Courses from some users or students] forum discussion

[[de:Kurs anlegen]]
[[es:Añadiendo un nuevo curso]]
[[eu:Ikastaroak_%28Kudeatzaileak%29]]

Course settings

2014-08-14T09:28:46Z

Cttxg: /* See also */ Updating MoodleBites video link

{{Courses}}
A teacher, or other user with the [[Capabilities/moodle/course:update|update course settings capability]], can change course settings in ''Administration > Course administration > Edit settings''.

==General==
{|
|[[File:generalcourse25.png|thumb|500px|General settings,expanded by default]]
|}

===Course full name===

This is the name of the course. It is displayed as a link on course lists on the [[Front page]] and on [[My home]] and in reports. It is also used in the browser title bar when the course is viewed.

The capability [[Capabilities/moodle/course:changefullname|moodle/course:changefullname]] controls whether a user can edit the course full name.

===Short name===

Many institutions have a shorthand way of referring to a course, such as BP102 or COMMS. Even if you do not already have such a name for your course, make one up here. It will be used in several places where the long name is not appropriate, such as the Navigation block.

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

By default, only course full names are displayed in the list of courses. However an administrator can enable short names to be displayed too if required by ticking the checkbox in ''Administration > Site administration > Appearance > Courses''.

=== Course category===

The site administrator may have created course categories to help teachers and students find their courses easily. Course categories may be reflected in the [[Navigation block]].

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

===Course start date===

This setting affects the display of logs and the weekly format topic dates.

If you use the "Weekly" course format, the start date will appear in the first section of the course. For example selecting 27 July, will display "27 July - 2 August" in the first section (when default display is selected for that section).

This setting will have an effect on the display of logs. This will be the earliest possible date the log activity will display.

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

:''TIP:'' If your institution runs on a weekly schedule, you may want to consider setting the start date for courses on the first day of the week, like a Monday. Please note that the 'first day of the week' is set by the [https://docs.moodle.org/dev/Translation_langconfig langconfig file] of your [[Language]], and might be different from the default Monday of the English language pack.

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

:''TIP:'' See self enrolment course settings to prevent students from entering the course before a certain date/time.

===Visible===

Here you can "hide" your course completely. It will not appear on any course listings, except for managers, course creators, teachers and any other users with the [[Capabilities/moodle/course:viewhiddencourses|view hidden courses capability]]. Even if students try to access the course URL directly, they will not be allowed to enter.

The [[Capabilities/moodle/course:visibility|hide/show courses capability]] controls whether a user can hide a course.

Note: In earlier versions of Moodle, this setting was named 'Course availability'.

=== Course ID number===

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

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

==Description==
{|
|[[File:coursesummary.png|thumb|500px|Description settings expanded by default]]
|}

===Course summary===

The summary appears on the course listings page. This field is searched when searching for a course and also appears in the Course/Site description block.

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

===Course summary files===

An image (and if allowed by the administrator, other file types) may be attached to the course summary. They will be accessible by anyone from outside of the course just like the course name and/or summary. Only users with [[Capabilities/moodle/course:changesummary| moodle/course:changesummary capability]] are able to upload/change course summary files.
''Note that if this is not allowed by the administrator, then no box will appear to upload course summary files''.

By default, only jpg, gif and png file types are allowed as course summary files. An administrator can change the allowed file types in ''Administration > Site administration > Appearance > Courses''.

==Course format==

(These settings are collapsed by default.)
{|
|[[File:coursefomat25.png|thumb|500px|Course format settings expanded]]
|}

===Format===

See [[Course formats]]

===Number of sections===

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

If the number of weeks/topics is changed for an existing course so that the number is less than the number of course sections containing activities (for example the course contains activities in 3 sections and the number or weeks/topics is set to 2) then when editing is turned on section(s) at the bottom of the course page will be shown with the title 'Orphaned activities'.

The number of weeks/topics may be set to 0, so that only the top general section is displayed on the course page and there are no numbered sections.

By default, the maximum number of weeks/topics is 52, but an administrator can set a different maximum number which will apply to all courses on the site (see below).

===Hidden sections===

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

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

===Course layout===

The Course layout setting determines whether the whole course is displayed on one page or split over several pages. The setting currently applies to the topics and weekly core course formats and contributed collapsed topics course format only.

Teachers choose from the dropdown whether they wish to "show all sections on one page" in the familiar scrolling format, or "show one section per page".

If one section per page is selected, the course page is abbreviated to a list of links to individual sections. If an individual section is shown, next and previous sections may be accessed via links above and below the section.

{|
| [[File:one section per page course format.png|thumb|Course page for course using one section per page course layout]]
| [[File:Single_section_page.png|thumb|Individual section of a course using one section per page course layout]]
|}

Visit the School demo site course [http://school.demo.moodle.net/course/view.php?id=37 The Types of Sport] to see the "Show one section per page" course layout in action!

For further details plus screenshots, see blog post [http://www.somerandomthoughts.com/blog/2012/05/08/moodle-2-3-section-per-page/ Moodle 2.3 – Section per page] by Gavin Henrick.

==Appearance==

(These settings are collapsed by default.)

{|
|[[File:appearancecourse252.png|thumb|500px|Appearance settings expanded]]
|}

===Force theme===

If the site administrator has allowed the teacher to set a course [[Themes|theme]], this pull down menu will appear with a list of themes on the site. Teachers can use this to choose a different look for the course from the rest of the Moodle site.

=== Force language===

If you force a language in a course, the interface of Moodle in this course will be in this particular language, even if a student has selected a different preferred language in his/her personal profile.
{{New features}}
The capability [[Capabilities/moodle/site:forcelanguage|moodle/site:forcelanguage]] may be allowed by the admin for users who need to override this language (for example, when testing problems in a course in a language they do not know.)

===News items to show===

How many news items should show the [[Latest news block]]. Set it to 0 and Latest news block will not appear.

The Latest News block relies on the use of the associated News Forum. News posted in other forums do not display in the latest News block

===Show gradebook to students===

Here you can decide whether to allow students to see the link to [[Grades|grades]] in the Administration block. If your course doesn't use graded activities, it makes sense to disable this. If grades are used and this link is disabled, students can still see their grade from the actual activity itself, such as an [[Assignment|assignment]]

===Show activity reports===

Here you can decide whether to show students their [[Activity_report#Individual_Activity_Report|activity reports]]. Doing so places a load on the server however, which is why the setting is disabled by default.

==Files and uploads==

(These settings are collapsed by default.)

===Maximum upload size===

Here you can decide the largest size of file that students can upload to a course. The site administrator can determine [[Site_policies#Maximum_uploaded_file_sizefile |sizes available]] for the teacher to select.

Editing teachers or other users may be allowed to upload files larger than the maximum size by giving them the capability [[Capabilities/moodle/course:ignorefilesizelimits|moodle/course:ignorefilesizelimits]]

==Completion tracking==

(These settings are collapsed by default.)

Completion tracking must be enabled for [[Activity completion]]. [[Course completion]] criteria may also be based upon Activity completion values found in the activity's settings.

==Guest access==

(These settings are collapsed by default.)
{|
|[[File:guestaccess25.png|thumb|500px|Guest access settings expanded]]
|}
Here you can decide whether to allow logged in users to access the course as a guest, and whether or not they need to enter a password. See [[Guest role|Guest role]] for more information.

==Groups==

(These settings are collapsed by default.)
{|
|[[File:coursegroups25.png|thumb|500px|Groups settings expanded]]
|}

===Group mode===

Here you can define the [[Groups|group mode]] at the course level by a pull down menu. "[[Groups#No_groups|No groups]]", "[[Groups#Separate_groups|Separate groups]]" and "[[Groups#Visible_groups|Visible groups]]" are the choices. The selected setting will be the default group mode for all activities defined within that course. The group setting can affect what users see in the [[Participants]] list and who they can interact with in activities.

===Force===

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

===Default grouping===

If [[Groupings|groupings]] are enabled, a default grouping for course activities and resources may be set.

==Role renaming==

(These settings are collapsed by default.)
{|
|[[File:rolerenaming.png|thumb|500px|Role renaming settings expanded]]
|}
You can rename the [[Roles|roles]] used in your course. For example, you may wish to rename the [[Teacher role]] as "Facilitator", "Tutor" or "Guide". These new role names will appear within the course. For example on the [[Participants|participants]] and the override permissions pages.

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

== Site administration settings==

An administrator can set course default settings in ''Administration > Site administration > Courses > Course default settings''.

The maximum number of weeks/topics may be set for all courses on the site. The default value is 52.

==Preventing teachers from editing course settings==

Any/all of the following fields - course full name, short name, ID number and category, summary - may be locked to prevent teachers from editing them. To do so:

#Access ''Site Administration > Users > Permissions > Define roles''.
#Click the edit icon opposite the teacher role.
#Change any/all of the capabilities [[Capabilities/moodle/course:changefullname|moodle/course:changefullname]], [[Capabilities/moodle/course:changeshortname|moodle/course:changeshortname]], [[Capabilities/moodle/course:changeidnumber|moodle/course:changeidnumber]], [[Capabilities/moodle/course:changecategory|moodle/course:changecategory]], [[Capabilities/moodle/course:changesummary|moodle/course:changesummary]] from allow to not set.
#Click the "Save changes" button at the bottom of the page.

==See also==
* [http://youtu.be/19ke-cvhnug Creating a Course and Course Settings] MoodleBites video on YouTube
* [http://youtu.be/rg6rUuBwITo Moodle 2 Administration Courses] MoodleBites video on YouTube

[[de:Kurseinstellungen]]
[[es:Configuraciones del curso]]
[[eu:Ikastaroaren_ezarpenak]]
[[fr:Paramètres du cours]]
[[ja:コース設定]]

Groups FAQ

2014-08-14T09:27:24Z

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

{{Grouping users}}
==General==
===What is the 'groups mode' setting?===

You can have several classes/groups working in a single course with different (or the same) teacher. Groups mode is a way of filtering the students so that work and grades can be accessed separately. See [[Groups]] for more information. There are three different groups modes – No groups, Separate Groups, Visible Groups. In ‘Separate groups’ mode, each group can only see their own group – other groups are invisible. In ‘Visible groups’ mode, each group works in their own group, but can also see other groups.

Teachers are normally able to see other teachers' groups's activities as well as their own unless the capability [[Capabilities/moodle/site:accessallgroups]] has been set to "prevent".

===What is the difference between a cohort and a group?===

A group exists only within a course. You might have a class 10B for example which you want to enrol in course 1 and course 2. The group would need to be created in both courses and its members enrolled separately in both courses. [[Cohorts]] are groups of users created by admin which can then be brought in "en masse" to courses. So if class 10B is created as a cohort by admin, then it can be selected in those courses where enrolment via cohort has been enabled. (For more information on creating and using cohorts, see here: [[Cohorts]]) Once members of a cohort have been added to a course, they can be included in a group, either by using the "auto create groups" feature or by adding the members to an empty or pre-created group.

===What is the 'force' setting?===

If force is set to yes, then all activities are group activities. This overrides any settings for individual activities. If force is set to no, then activities are only group activities if they have been set to group mode. In this case, each activity requires to be set to group mode individually.

===Can I automatically add users to a group at the same time that I enroll them via a csv file?===

Yes. One of the optional field names that can be uploaded in the flat file is "group1, group2, etc". The group must be associated to the corresponding course and the course short name used in the field course1. If the group doesn't already exist then Moodle will create the group. Here is an example of a portion of a csv file that would enroll students into a group entitled 'Class A' within a course entitled 'Astro1'. (Note that you can assign students to groups using this file even if they are already enrolled in Moodle, as you can select to update the user details when uploading the file.)

username, password, firstname, lastname, email, course1, group1,...
jdoe, changeme, Jane, Doe, jdoe@email.org, Astro1, Class A,...

===How do I assign a teacher to a group? Can a teacher be in more than one group?===

You can assign a teacher to a group in exactly the same way that you assign a student to a group.

===How do I restrict a teacher to view only information about the groups that they are in?===

For Separate Groups mode, the capability [[Capabilities/moodle/site:accessallgroups|moodle/site:accessallgroups]] may be used to restrict access to all groups in a particular context. If this capability is removed from the teacher role (either within a course or globally if appropriate) then they will only see the students they teach when accessing the gradebook for example.

To do this for all teachers globally:
#Site administration>Users>Permissions>Define roles
#Select the editing teacher role;
#Click to edit the role
#Click the Show advanced button
#Type in the search box ''accessallgroups''
#When it appears, click ''Prevent''

To do this within a course:
#Course administration>Users>Permissions
#Type ''accessallgroups'' into the filter
#Click the X to remove from the editing teacher (Teacher) role.

===What determines whether students can see a teacher's profile?===

A student can see the profile of all teachers that are members of their group or that have edit rights.

===I have two groups that meet on different days. Can I set up activities for different times for the two groups?===

You can use [[Groupings]] to achieve this to some degree. If you are using Moodle's [[Quiz]] you can set different times for different groups using the Group override settings.

===Can I use the same groups for more than one course?===

Not directly, although there are some workarounds to accomplish this.

* Use the [[Import_groups]] Import tool to import a file with the groups and settings (though not memberships).
* Create the groups by import or manually with enrollment keys on them and give the students group enrolment keys to enrol themselves into the right group for each course.
* Admins and managers can enrol users in bulk via File Upload or [[Cohorts]] to include group membership.
* Make a template with the enrolments and groups and restore it to a new course with user data.
* Create a master course with all the students enrolled and in the correct groups, and then to make each of the courses a metacourse based on that master course. Note that metacourses do not carry over group enrolments. See the documentation on [[Metacourses]].

===Can a student be a member of more than one group? ===
Yes, a student can be in more than one group.

===If one student is in a group, do all students have to be in some group?===
No, a student does not have to belong to any group.

===If I have several groups, can I make a specific activity or resource visible to just one of those groups?===

You can organise groups into [[Groupings|groupings]], then assign an activity (or resource) to a particular grouping.
If you want to show a resource (such as a file or folder) to only one group then Make sure that you admin has enabled "available for group members only" in ''Settings>Site administration>Development>Experimental'' and then see [[Available for group members only]]

In any version of Moodle you can make a forum post visible to just one group. You must first select that specific group from the dropdown and post the message to that group (rather than to "all participants")

===Can I have one set of groups for Activity A and another set of groups for Activity B?===

You can create two different [[Groupings|groupings]] (a grouping is a set of groups), and assign different groupings to the two activities.

===Is it possible to view all the groups in a course as a list to print out?===

The groups overview page in ''Settings > Course administration > Users > Groups'' provides a table listing groups, group members and a user count.

===When I try to add a student, they are always added to the first group, whichever group I select?===

Make sure that the students name does not include any punctuation. There is also a workaround – give each group a temporary name at the start of the alphabet, put your students in the group and then rename the group.

===How can I delete a group?===

After clicking, "Groups" in ''Settings>Course administration>Users>Groups..''

# Select the group that you want to delete.
# Click the "Delete selected group" button

===How can I import a list of students into a group?===

Please check [[Upload users]].

===How can I sort students automatically into groups during enrolment?===

You can make use of [[Enrolment key|enrolment keys]]. Set an enrolment key in ''Settings>Course administration>Users>Enrolment methods>Self enrolment'' (to enforce the enrolment key dialogue form when students enrol). That key is only for students who should not be in a group and to keep out any unwanted students. Then in ''Settings>Course administration>Users>Groups'' you create your groups and add a different enrolment key for each group. When a student enrols, using an enrolment key that is connected to a certain group, the student will automatically be part of that group.

===How can I change the sort order of the participants?===

The admin can change the "fullnamedisplay" variable which will affect the sort order of participants for the entire Moodle site. This can be found in the [[Site administration block]] under Security>Site Policies>Full name format. The default is First+Surname, with First, and Surname+First as options. Some language packs have other options.

===What is the difference between a group and a grouping?===

See Groups versus groupings forum post http://moodle.org/mod/forum/discuss.php?d=131905. A grouping can be thought of as a category of groups. A grouping is a meta group. Student membership to a "grouping" can only happen by their membership to a group that is associated with the grouping.

===What is an orphan group?===

An orphan group is a group that does not belong to any grouping.

===Is there any way to enable students to choose a group?===
There is a contributed module [http://moodle.org/plugins/view.php?plugin=mod_choicegroup| ChoiceGroup] which will do this. See also on youtube:[http://www.youtube.com/watch?v=JQFaDLtHZdY&feature=player_embedded| this screencast]

===How can I view the participants list for just one group?===
For this, you need Groups mode switched ON at course level in Course settings.

==Activity modules and groups==

Different activity modules vary as to how they treat groups – some have better support for groups than others!

In general if you have questions about how an activity supports groups, you’re advised to post in the forum for the activity module, and not the groups forum.

===Which activity modules do NOT support group mode?===

All activity modules support the use of group mode apart from Glossary, Lesson, and SCORM.

===What happens if I switch an activity from being in non-groups mode to being in groups mode?===

This depends on the activity module in question.

For forums, posts made before the forum is put into groups mode are visible to all students after you have put the forum into group mode. However students cannot reply to these posts if they have no group (i.e. blank).

===What happens if I change the groups for an activity in groups mode e.g. if I move a student from one group to another?===

Again this depends on the activity module. You may find that grades or activity logs are lost, so check for the specific activity module first.

===How do I post a message in a forum that only one group can see?===

Before you click 'Add a new topic', you need to choose the group from the Separate groups drop-down menu at the top left.

===As a teacher I want to put the same post in each group's forum with students able to reply to that post. How can I do this?===

You need to post the same message into the forum for each group. There is currently no way to do this in one go if you want students to be able to reply to your post. If you don't mind students not being able to reply, then you can of course just post the message to all participants.

===How can I hide an activity/resource in the course from anyone who is not assigned to a group?===
You can use the [[Available for group members only]] experimental setting for allowing access to an activity/resource only to participants who are assigned to a group. If no participant on the course site is assigned to a group, ticking the 'Available for group members only' will effectively hide the activity/resource from everyone.

==See also==

* [[Groupings FAQ]]
* Using Moodle [http://moodle.org/mod/forum/view.php?f=320 Groups forum]
* [http://youtu.be/amyQjAESkZM Moodle Forum Types and Group Mode] MoodleBites video on YouTube

[[Category:FAQ]]

[[fr:FAQ des groupes]]
[[ru:FAQ по группам]]
[[de:Gruppen_FAQ]]
[[es:Grupos FAQ]]

Groups

2014-08-14T09:26:23Z

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

{{Grouping users}}
A teacher can organise users into groups within the course or within particular activities.

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

==Group levels==
A group or grouping can be used on two levels:

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

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

[[File:groupmodecourse.png]]

===Group modes===

There are three group modes

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

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

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

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

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

[[File:groups.png]]

==Auto-create groups==

Groups may be created automatically via the 'Auto-create groups' button in ''Administration > Course administration > Users > Groups''. To see all the settings, click the ''Expand all'' link top right.

[[File:autocreategroups.png]]

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

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

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

===Group members===
''Select members from ...'' allows you to choose from roles or available cohorts.
'''Specify''' and '''Group/Member count''' work together.

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

===Grouping===

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

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

==Groups and enrol plugins==

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

==Groups overview==

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

The table may be filtered to display particular [[Groupings|groupings]] or groups.

==Groups capabilities==

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

==See also==
*[[Upload users]] - for importing users into groups
*[[Enrolment key]]
*[[Available for group members only]]
* [http://youtu.be/amyQjAESkZM Moodle Forum Types and Group Mode] MoodleBites video on YouTube

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

Using Forum

2014-08-14T09:24:22Z

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

{{Forum}}
The teacher can set the format of what the student sees under the introduction by selecting the forum type in [[Forum settings]].

==Views==

===A single simple discussion===

Students will see the text you have placed in the [[Adding/editing_a_forum#Forum_introduction|Forum introduction setting]] as the first post of the discussion. Below you will find the replies that have been posted. In the example below, the student sees that their reply was rated.

{|
| [[File:Forum homepage view Simple student mu.png|thumb|Student view of "A single simple discussion" forum type]]

|}

===Each person posts one discussion===
The view will be basically the same as in the previous case, the only difference being the 'Add a new discussion' option. Viewing a forum page, the student will see the text you have written at the 'Forum introduction' space while creating the forum, and, if there are any, the discussions that have been started.

{|
| [[File:Forum homepage view Single student mu.png|thumb|443px|Student view of "Each person posts one discussion" forum type]]

|}

===Standard forum for general use===

In this forum type, students will see the introduction text in a separate space above the discussion field, in which you will see the information such as the title of the discussion (which means the forum's title), its author, the number of replies and the date of the last post.

{|
| [[File:standardforum.png|thumb|467px|Student view of "Standard forum" type]]

|}

===Question and Answer forum===

The Q & A forum is best used when you have a particular question that you wish to have answered. In a Q and A forum, teachers post the question and students respond with possible answers. By default a Q and A forum requires students to post once before viewing other students' postings. [[Using Forum#Question and Answer forum 2 |More details here]]

{|
| [[File:QA1.png|thumb|Inital view of Q&A forum]]
| [[File:QA2.png|thumb|Students cannot see posts until they post]]
| [[FIle:QA3.png|thumb|Other posts visible when editing time is over]]
|}

===Standard forum displayed in blog-like format===

{|
| [[File:Bloglikeforum.png|thumb|450px|Blog like forum]]

|}

In the upper right corner of the home forum screen (above the introduction), the student may see the options the teacher has set for [[Adding/editing_a_forum#Force_everyone_to_be_subscribed.3F|subscriptions to the forum]], and the 'Jump to' field, with which you can 'jump' to any part of the course. This is also place where the teacher will find the "Update this forum" button.

==Display options==
[[Image:forumviewoptions.jpg|thumb|Reply display options]]A discussion thread may be displayed in four ways. Use the pull down menu at the top of each forum discussion to select a display type.

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

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

==Forum posting==

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

When writing text in Moodle there are several formats you can choose to produce your text, depending on your expertise and the type of browser you are using. Please refer to [[Formatting text]] for further information.

=== Sharing images through forums ===

*When an image is "attached" as a file to a forum message, it is immediately displayed full size after the message (i.e. no need to click on an attachment). This an excellent way of sharing images without having to go through the process of uploading them as files and linking them from within web pages.

*Images may be dragged and dropped into the box as well as uploading via the "add" link and the [[File picker]].

[[File:forumdragdrop.png]]

===Sharing sound and video through forums===
*If multimedia filters are enabled, a sound file (mp3) or accepted video file can be attached and it will be embedded into the forum post in an appropriate player.
*As with images in the previous section, multimedia files may be dragged and dropped from the desktop instead of uploaded via the [[File picker]].

===Post length===

Extra-long posts cause problems when doing a forum search and can be difficult to read on screen. Rather than creating a very long post, consider copying and pasting the text into a text file and add it as an attachment to your forum post.

===Post editing time limit===

There is a time limit for editing posts, usually 30 minutes. It is set by an administrator in ''Administration > Security > [[Site policies]]''.

The Using Moodle forum discussion [http://moodle.org/mod/forum/discuss.php?d=5367 The philosophy underlying "no editing after 30 minutes"] includes reasons why it is a good idea to have a time limit for editing posts.

===Mail now===

A mail now checkbox is available for anyone with the [[Capabilities/moodle/course:manageactivities|capability to manage course activities]], normally teachers and admins.

Checking the "Mail now" box results in a notification being sent immediately (i.e. when the [[Cron|cron]] next runs) to everyone subscribed to the forum, rather than after the post editing time limit.

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

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

[[File:Exportforum.png]]

==Moving a discussion==

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

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

==Guidelines for Teaching and Learning Forums==

When you decide to use a discussion forum as an activity in an e-learning environment, it is important to be aware that your time will be needed in some sense in order to make the activity successful. If your goal is to encourage discussion, the forum will only work if:

a) '''participants feel there is a need/reason to participate and they will gain something from the experience.''' Incentives for learning, gathering support, etc. should be explored and encouraged early on in order to clearly convey the purpose of the forum to others. Anyone considering offering grades or marks for participation is advised to think very carefully about the difference between quantity and quality of discussions in forums.

b) a sense of community and purpose can be fostered amongst participants. This sense of community can be fostered through tutor/teacher initiative and scaffolding, or primarily through the students/participants themselves depending on the intentions of the activity.

==Selecting forum type==

Moodle has four kinds of forums each with a slightly different [[Viewing a forum|layout]] and purpose.

Which of the forums will best suit your needs for a particular activity? In order to answer this question, it is useful to think how you might lead such a discussion in a face-to-face environment. Would you throw the question out to the class and sit back to observe them in their answers? Or would you break them up into smaller groups first and ask them to have discussions with a partner before bringing them back to the main group? Or perhaps you would like to keep them focused on a particular aspect of a question and ensure that they do not wander away from the topic at hand? All of the above approaches are both valid and useful, depending on your learning outcomes, and you can replicate all of them in Moodle forums.

===A standard forum for general use===
The standard forum ([[Viewing_a_forum#Standard_forum_for_general_use|view here]]) probably most useful for large discussions that you intend to monitor/guide or for social forums that are student led. This does not mean that you need to make a new posting for each reply in each topic, although, in order to ensure that the discussion does not get 'out of control', you may need to be prepared to spend a significant amount of time finding the common threads amongst the various discussions and weaving them together. Providing overall remarks for particular topics can also be a key aspect of your responsibilities in the discussion. Alternatively, you could ask students to summarize discussion topics at agreed points, once a week or when a thread comes to an agreed conclusion. Such a learner-centred approach may be particularly useful once the online community has been established and, perhaps, when you have modeled the summarizing process.

===A single simple discussion===
The simple forum ([[Viewing_a_forum#A_single_simple_discussion|view here]]) is most useful for short/time-limited discussion on a single subject or topic. This kind of forum is very productive if you are interested in keeping students focused on a particular issue.

===Each person posts one discussion===
This forum ([[Viewing_a_forum#Each_person_posts_one_discussion|view here]]) is most useful when you want to achieve a happy medium between a large discussion and a short and focused discussion. A single discussion topic per person allows students a little more freedom than a single discussion forum, but not as much as a standard forum where each student can create as many topics as he or she wishes. Successful forums of this selection can be active, yet focused, as students are not limited in the number of times they can respond to others within threads.

===Question and Answer forum===
The Q & A forum ([[Viewing_a_forum#Question_and_Answer_forum|view here]]) is best used when you have a particular question that you wish to have answered. In a Q and A forum, tutors post the question and students respond with possible answers. By default a Q and A forum requires students to post once before viewing other students' postings. After the initial posting and once the editing time (usually 30 minutes) has elapsed, students can view and respond to others' postings. This feature allows equal initial posting opportunity among all students, thus encouraging original and independent thinking.

''Note:'' Students do not see the "add a new question" button in the Q & A forum. If you wish students to be able to add new questions, they need to be given the capability [[Capabilities/mod/forum:addquestion|mod/forum:addquestion]]

===Standard forum displayed in blog-like format===
This forum behaves in the same way as the default standard forum for general use, allowing users to start their own discussions. However, it displays differently in that the first post of each discussion is displayed (as in a blog) so that users can read it and then choose to respond by clicking the "Discuss this topic" button bottom right of the post.

====Tips for Question and Answer====
When the Question and Answer mode is selected, Moodle hides the replies to the initial thread post by the teacher but not the entire forum itself.

:''Tip:'' Post each question as a thread in the forum and then have students post replies to the question. In this fashion, Moodle will protect the replies from being viewable (subject to the caveat above) by other students but allow the initial post/thread visible for reply by all students.

:''Tip:'' Do not post the question in the forum summary because every student answer will become a thread and visible to all students. In this scenario, it may appear as if the Question and Answer forum is not working correctly, since the new initial posts in the thread are intentionally designed not to be hidden, just their replies.

:''Tip:'' If you have set up groups for your forum the facilitator needs to post a question to each of the groups and not to 'all participants' as questions asked of all participants (students) are able to be read by ALL students. Questions posed to group members are only visible to those group members and replies are only visible once a group member has posted a message.

==Forum subscription==

When a person is '''subscribed''' to a forum it means that they will be notified (according to their [[Messaging settings]] preferences) of every subsequent post in that forum. Posters have 30 minutes by default to edit their post before it is sent though this time limit can be changed by an administrator.

People can usually choose whether or not they want to be subscribed to each forum. However, if a teacher forces subscription on a particular forum then this choice is taken away and everyone in the class will get notified.This is especially useful in the News forum and in forums towards the beginning of the course (before everyone has worked out that they can subscribe to these emails themselves).

Note that even if you force subscriptions every user can elect not to be notified in [[Messaging settings]], or elect to have all email sent once a day in a digest contain either all posts or simply the subject headings.

Choosing ''Everyone can choose to be subscribed'' enables you to check (and modify) the number of subscribers (''Settings > Forum administration > Show/edit current subscribers'') and to subscribe to (or unsubscribe from) the forum ('Subscribe to this forum' / 'Unsubscribe from this forum').

An overview of your forum subscriptions is available on the forums index page e.g. http://moodle.org/mod/forum/index.php?id=5

==Concepts for use in forums==
===Participation and Scaffolding ===

Whilst one of the great advantages of e-learning is the flexibility it affords participants, this does not mean that days or weeks should pass without response and discussion in a forum (unless it is appropriate for it to do so). This is perhaps most especially true at the beginning of a course or programme when students and tutors are new to each other and in need of welcome messages/encouragement. Whilst e-learning, and discussions in particular, can support learning that is not always tutor/teacher-centred, your role will be important, especially as an online community begins to develop. It is during these initial stages of introductory material that a group of students can become a community of participants who begin to grow in their understandings of course material and individual contributions to the knowledge construction process.

As the discussions progress and learners become accustomed to the mechanics and the tone of the forums then there are key ways in which your input can be reduced, thereby helping to foster a community that is less dependent on the tutor/teacher. Even then, however, you will probably want to be a presence in the discussions although you may choose to be one of many contributors rather than the font of all wisdom.

===Commitment and Participation===

Ask yourself if

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

===Student Centered Forums===

With the growing popularity of social networking software like Facebook, Bebo, MySpace and the like, students are leaving schools and coming to Higher and Further Education with a new technological sophistication and with new expectations for communication. And as school, colleges and universities recognise that reflective and life long learning are significant goals in education, student centered learning and the creation of student centered spaces online are also gaining credence in educational settings. We know that effective learning requires access to social and academic networks for both study material and emotional support; as such, online communities can offer a holistic knowledge construction and support mechanism and recognize that affective activity is effective.

Social forums, often called ‘Virtual Cafes’ or ‘Common Rooms’ can be set up for courses or for programmes, depending on the student need. Such spaces provide a common area for students to come together and discuss unlimited topics, including social activities and educational ideas. They are supportive spaces for students, most successful with large first and second year courses where students would not otherwise have the opportunity to communicate with others outside their own tutorial group. It is arguable that students will experience a greater sense of community within and a sense of belonging to an educational institution or individual department having had the experience and convenience of the social forum on their course; this could arguably have implications for retention.

These spaces are typically highly active, especially in first term. Depending on your institution, they are usually self monitored by students, who understand that the same ‘rules’ and ‘netiquette’ that apply to them within any computing space, also apply in Moodle.

===The News Forum===

Moodle courses automatically generate a [[News forum]] which defaults to automatically subscribe all participants in a course. The name of the News Forum can be changed to something more appropriate, such as ‘Important Announcements’ or the like. This is a useful feature and many use this forum in a Moodle course to announce exam dates, times or changes to exams, lectures or seminars, as well as important information about course work throughout a term or special announcements relating to events.

===Teacher/Tutor forums===
A teacher/tutor-only forum may be added to a course by creating a hidden forum. Teachers are able to view hidden course activities whereas students cannot.

==Some forum suggestions to consider==

#If your course is at a distance, if your face to face time is limited, or if you just wish to foster a sense of community in your Moodle course which supplements your face to face course, it is good practice to begin with a welcome or introductory message or thread in one of your forums. This welcome or introduction from you invites participants, for example, to post some specific details to introduce themselves to you and their peers. This can be your icebreaker or you can have an icebreaker separately.
#If you have two questions for participants to answer, starting the two strands or topics within the forum itself will both help learners to see where to put their responses, and remind them to answer all parts of your question.
#Remember that you are communicating in an environment that does not have the benefit of verbal tone, eye contact, body language and the like. Careful consideration of your communication is, therefore, necessary.
#Postings to a forum are always written but they can take different forms and you may wish to consider what form best suits the activity. For instance, you might choose to articulate a form of contribution in order to be explicit. Thus you might say, 'This is a think-aloud forum in which, together, we will try to tease out ideas and possibilities' or 'This is a formal forum in which you are invited to share your ideas on (topic)' and, where you select the latter, you might have already suggested learners plan those ideas offline or in another kind of activity within Moodle.
#Create a forum where only the teacher can start discussions, but the students can only reply. Each thread you start contains an essay question (or several similar ones). The students make a bullet point plan for the essay and post it as a reply. This works well as a revision strategy as the students can see how others have approached the same task. Once everyone has posted their plan, you can start a discussion as to which plans seem better and why. Creating a scale to use for rating the posts can be useful so that the students can see how helpful other people think their effort were. (Note: At this time, there is no option to hide the "Add new discussion topic" button, so you need to tell your students not to start discussion threads, but to only reply to threads started by the teacher. If you only need one thread, then you can use the "a single simple discussion" format and the "Add new discussion topic" button is not available to the students.)

===Grading forums===

The teacher can use the [[Forum ratings|ratings]] [[Scales|scales]] to [[Grades|grade]] student activities in a forum. There are several methods for calculating the grade for a forum that can be found in the [[Adding/editing_a_forum#Grade|Forum settings under grades]]. There are 5 ways to [[Adding/editing_a_forum#Aggregate_type|aggregate ratings]] automatically to calculate a forum grade for the [[Gradebook]]. These include: Average, Max, Min, Count and Sum.

==Forum ratings allow users to evaluate posts in a forum==

Forum ratings use [[Scales]] to standardize the reporting of performance. A forum rating can be included as part of a student's [[Grades|grade]]. For example, a teacher might use a custom rating scale in a forum and allow students to rate forum posts.

Forum ratings must be allowed and the potential rater must have [[Roles|role]] permission. Teachers by default have this ability. The teacher role is also able to give permission to a [[Student|student role]] in a specific forum to be able to assign a rating to a post. Forum settings and [[Forum_permissions#Enabling_students_to_rate_posts| Enabling student ratings]] has more information.

===How to use===
[[Image:Forum rating example1 mu.png|thumb|Teacher view of a previously rated student post]]When rating is allowed, the qualified user will see "Rate this post" and a pull down menu after an entry (not their own). The menu displays a [[Scales|scale]] that the forum creator selected in the [[Adding/editing_a_forum#Grade|Forum grade settings]]. The user can rate more than one post at a time. When finished they should click the "submit my ratings" button at the bottom of the page.

===AJAX forum rating===

Forum rating can be made more user-friendly with the use of AJAX. Users can rate forum posts almost instantly without needing to scroll to the bottom of the page and click the "Send in my latest ratings" button.

AJAX forum rating requires AJAX to be enabled by an administrator in ''Settings > Site administration > Appearance > [[AJAX and Javascript settings|AJAX and Javascript]]'' and by users in their [[Edit profile|user profile]].

===Separate and connected knowing===
You can rate forum posts with the [[Separate_and_Connected_Knowing| Separate and Connected Knowing]] scale here.

===Good Practice and shared discussions===
*There are lots of discussions about Forum good use and Forum assessment in the Teaching Strategies Forum http://moodle.org/mod/forum/view.php?id=41.

*A useful discussion about Forum assessment can be found here http://moodle.org/mod/forum/discuss.php?d=66008.

== See also ==
* [http://youtu.be/amyQjAESkZM Moodle Forum Types and Group Mode] MoodleBites video on YouTube
* Using Moodle [http://moodle.org/mod/forum/view.php?f=116 Forum module]
*[http://www.moodleblog.onet/?page_id=148 Peer Assessment using a Moodle Forum] blog post with screencast

Using Moodle forum discussions:
* [http://moodle.org/mod/forum/discuss.php?d=5367 The philosophy underlying "no editing after 30 minutes"]
* [http://moodle.org/mod/forum/discuss.php?d=66008 Best Practices for grading discussions]
* [http://moodle.org/mod/forum/discuss.php?d=88000 Two Courses, One Forum?]
* [http://moodle.org/mod/forum/discuss.php?d=93304 Using a forum for 1 to 1 teaching]
* [http://moodle.org/mod/forum/discuss.php?d=95470 Technicalities of managing a Forum]
* [http://moodle.org/mod/forum/discuss.php?d=67360 Role names showing next to posting photos]

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

Forum settings

2014-08-14T09:22:59Z

Cttxg: Adding MoodleBites YouTube video link

{{Forum}}
==Adding and editing a forum==
#With the editing turned on, in the section you wish to add your forum, click the "Add an activity or resource" link (or, if not present, the "Add an activity" drop down menu )and choose ''Forum''.
# This will take you to the forum settings page titled "Adding a new forum".

You can access an existing forum by clicking the configure icon or clicking on the forum and then ''Administration > Forum administration > Edit settings''.

==General==
{|
|[[File:fileforumgeneral26.png|thumb|436px|The General settings, expanded by default.]]
|}

===Forum name===
A short name of the forum (e.g. "Favourite colour"), which will be displayed on the course homepage.
===Description===
Provide instructions for your students here so they are clear what they have to do. Click the icon top left to expand the toolbars drag the bottom right of the text box out to expand it.

===Display description on course page===
Enabling this will display the description on the course page just below the link to the forum.
===Forum type===
There are five forum types to choose from:

*A single simple discussion - A single topic discussion developed on one page, which is useful for short focused discussions (cannot be used with separate groups)
*Standard forum for general use - An open forum where anyone can start a new topic at any time; this is the best general-purpose forum
*Each person posts one discussion - Each person can post exactly one new discussion topic (everyone can reply to them though); this is useful when you want each student to start a discussion about, say, their reflections on the week's topic, and everyone else responds to these
*Q and A Forum - Instead of initiating discussions participants pose a question in the initial post of a discussion. Students may reply with an answer, but they will not see the replies of other Students to the question in that discussion until they have themselves replied to the same discussion.
*Standard forum displayed in a blog-like format

'''Note''': [[News forum]] is a special type of forum that is automatically created with a new course.

==Attachments and word count==
(This setting is collapsed by default)

{|
|[[File:attachmentsandwordcount.png|thumb|292px|Attachments and word count settings expanded]]
|}

===Maximum attachment size===

The maximum file size that may be attached to a forum post will first be determined by the Moodle site settings. The teacher may want a smaller size limit for the forum. Server file capacity, student downloading speeds and discouraging images in a document centered discussion are a few reasons to limit file size.

===Maximum number of attachments===
The maximum number of attachments a user can add to their forum post (from 0 to 100) can be specified here.

===Display word count===

If "Display word count" is enabled, then the number of words in forum posts will be shown at the bottom of each post.

==Subscription and tracking==
(This setting is collapsed by default)

{|
|[[File:subscriptionandtracking.png|thumb|267px|Subscription and tracking settings expanded]]
|}

===Subscription mode===

When a user is subscribed to a forum it means that they will receive notification (via popup and/or email, depending on the user’s messaging settings preferences) of each new posting. By default, posts are recorded about 30 minutes after the post was first written. Depending upon the email settings of each forum member, they may be sent an email immediately after the 30 minute edit window is closed, or in a batch at a time fixed by the site administrator (see below).

People can usually choose whether or not they want to be subscribed to each forum. However, the teacher can choose to force subscription on a particular forum then all course users will be subscribed automatically, even those that enrol at a later time.

There are 4 subscription mode options:
* Optional subscription - Participants can choose whether to be subscribed
* Forced subscription - Everyone is subscribed and cannot unsubscribe
* Auto subscription - Everyone is subscribed initially but can choose to unsubscribe at any time
* Subscription disabled - Subscriptions are not allowed.

The subscription mode and subscribe or unsubscribe links appear in'' Navigation>Forum administration'' when viewing the forum. teachers can quickly change the mode via the 'Subscription mode' options and view the current subscribers via the 'Show/edit current subscribers' link.

Tips:
* Forcing everyone to subscribe is especially useful in the news forum and in forums towards the beginning of the course (before everyone has worked out that they can subscribe to these emails themselves).
* Changing the setting from "Yes, initially" to "No" will not unsubscribe existing users; it will only affect those who enrol in the course in the future. Similarly changing "Yes, initially" will not subscribe existing course users but only those enrolling later.
* There is also a "Subscriptions not allowed" setting which prevents Students from subscribing to a Forum. Teachers may choose to subscribe to a forum if they wish.

===Read tracking for this forum?===

"Read tracking" for a forum allows users to track read and unread forum posts.
{|
|[[File:forum administration.png|thumb|325px|Don't track unread posts link]]
|}
There are three options for this setting:
* Optional - Students can turn tracking on or off for the forum via a link 'Track / Don't track unread posts' in ''Administration > Forum administration'', or via their profile 'Forum Tracking' option.
* Off - It is not possible to track unread forum posts
* Forced - Tracking is always on in this forum, regardless of user preference or setting. No link in is present in ''Administration > Forum administration''. This setting is only available when the 'Allow forced read tracking' administrative setting is enabled.

==RSS==
(This setting is collapsed by default and will only appear if RSS has been enabled sitewide and for forums)

{|
|[[File:rss25.png|thumb|306px|RSS settings expanded]]
|}
===RSS feed for this activity===

This turns RSS on or off for this forum. When set to “None,” RSS is disabled. When set to “Discussions,” the RSS feed will send out new discussions to subscribers. When set to “Posts,” the RSS feed will send out any new posts to subscribers.

Note: [[RSS feeds]] must be enabled for the site and for forums in order for the RSS settings to appear.

===Number of RSS recent articles===

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

The administrative cron (admin/cron.php) must run after the forum is created and posts or discussions have been made. Otherwise the user will receive an error "Error reading RSS data"

==Post threshold for blocking==
(This setting is collapsed by default)

{|
|[[File:postthresholdforblocking.png|thumb|389px|Post threshold for blocking settings expanded]]
|}

===Time period for blocking===
Choose here the time period in which can be blocked from posting more than a given number of posts. (To make a user exempt, give them the capability ''mod/forum:postwithoutthrottling'')
===Post threshold for blocking===
Set the number of posts here that users may add before they are blocked.
===Post threshold for warning===
Set the number of posts here after which users will be warned they are about to be blocked.

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

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

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

===Roles with permissions to rate===
Forum posts can be rated using a [[Scales|scale]]. By default, only teachers can rate forum posts, though students can be given permission to do so if desired (see Forum permissions below). This is a useful tool for giving students participation grades. Any ratings given in the forum are recorded in the [[Gradebook|gradebook]].

===Aggregate type===

You can set an aggregate type, in other words, decide how all the ratings given to posts in a forum are combined to form the final grade (for each post and for the whole forum activity).See [[Ratings]] for an explanation of aggregate types and which one is best for you.

===Restrict ratings to items with dates in this range===
The teacher can allow only posts within a certain date range to be rated. This is useful if the teacher wants to keep students focused on the most recent content and maintain a specific pace within the forum or course.

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

{|
|[[File:cm25.png|thumb|392px|Common module settings expanded]]
|}

See [[Common module settings]] for more information, but note the details below relating specifically to use of forums with groups.

===Group mode===

The '''group mode''' setting has three options:

# No groups
# Separate groups - each group can only see their own group; others are invisible
# Visible groups - each group works in their own group, but can also see other groups

If the group mode is set to separate groups:
{|
|[[File:groupsforum.gif|403px|thumb|Adding a new discussion topic to a forum set to separate groups]]
|}
* Teachers are given the option of adding a new discussion topic for all participants or for a selected group. If a teacher adds a new discussion topic for a selected group, then only group members can reply to it. If a teacher adds a new discussion topic for all participants, then students can't reply to it. (This is to ensure that groups are kept separate.)
* Students can only start discussions for their own group.
* Students can only reply to discussions started by other group members or discussions for their own group started by a teacher.

If the group mode is set to visible groups:

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

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

:''Note'': Single simple discussions cannot be set to separate groups (as this feature is not implemented). Instead, a standard forum should be used, with the teacher copying and pasting the same discussion topic for each separate group. If required, a permissions override may be set to prevent students from starting new discussions.

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

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

==Locally assigned roles==

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

===Forum moderator===

A student can be given the rights to moderate a forum by assigning them the role of non-editing teacher in the forum.

# In ''Settings > Forum administration > Locally assigned roles'' click on student
# Select the student from the potential users list on the right, and use the Add button to add them to the existing users list on the left. Multiple users may be selected by holding down the Apple or Ctrl key whilst clicking on the users' names.

See also [[Forum moderator role]].

==Forum permissions==

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

Common permissions changes include:

===Enabling students to rate posts===

Click the Allow icon (+) opposite the capability to rate posts and allow the role of student.

===Archiving a forum===

A forum can be closed / archived so that students may no longer start new discussions, nor add replies, but can still read all the discussions by clicking the Prevent icon (X) for the student role for the capabilities 'Start new discussions' and 'Reply to posts'.

===Guests and posting in a forum===

There are certain things, such as posting in a forum, that guests are never allowed to do, despite the permissions interface suggesting otherwise.

The guest role has some special functionality, for example when a guest user attempts to post in a forum, they obtain the message "Sorry, guests are not allowed to post. Would you like to log in now with a full user account?"

(Note: If guests don't obtain the "Sorry, guests are not allowed to post" message because they have no reply link, then self enrolment needs enabling in ''Settings > Course administration > Users > Enrolment methods''.)

If you wish guests to be able to post in a forum, you can use the [[Forum poster role]]

==User administration settings==

Users can choose whether or not to track unread posts in their profile settings under 'Forum tracking'. The settings are:

* Yes: highlight new posts for me
* No: don't keep track of posts I have seen

If the user chooses 'Yes: highlight new posts for me' and the forum administrator has set the 'Read tracking for this forum?' to On or Optional then the user will have new posts highlighted for them.
{|
|[[File:forumtracking1.png|thumb|296px|left|Unread posts alert]]
|}

The posts will be highlighted in the following places:

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

==Site administration settings==

The forum module has additional settings which may be changed by an administrator in ''Administration > Site administration > Plugins > Activity modules > Forum'' and, for 'Maximum time to edit posts', in ''Administration > Site administration > Security > Site policies''.

===Use email address in reply===

By default, a user's email is set as the 'From' address for forum notifications (unless the user has hidden their email address in their profile) so that recipients can choose to reply personally rather than via the forum. To set noreply@yourmoodlesite.org as 'From' address for all forum notification emails, untick the forum_replytouser checkbox.

===Long and short posts===

The long and short post setting determine how forum posts on the site front page, social format course pages, and user profiles are displayed. (Note: There is currently an unresolved issue - "Site news - forum length setting has no effect for certain users" - MDL-4781.)

===Enabling timed posts===

Timed forum posts may be enabled i.e. having the option to set a display start and end date for a new discussion. Timed posts can then be created by users with the [[Capabilities/mod/forum:viewhiddentimedposts|capability to view hidden timed posts]] (normally admins and teachers).

===Maximum time to edit posts===

This specifies the amount of time people have to re-edit forum postings, glossary comments etc. Usually 30 minutes is a good value. The setting may be changed by an administrator in ''Administration > Site administration > Security > Site policies''.

===Read tracking===

Sets the default 'Read tracking' selection when creating new forums. If 'Forced' is selected, the 'Allow forced read tracking' checkbox (below) must be ticked, otherwise 'Optional' will be the default setting.

===Allow forced read tracking===

With this option set, "Forced" will be an option for "Read tracking" when creating or editing Forums. Forced forums have read tracking enabled regardless of user preference.

This setting can place additional load on servers. With this setting disabled, users who set their profile setting to not track read posts see faster load times of courses pages. With this setting enabled, that performance increase is lost, and all course views see the same performance as if the users personal setting was on.

When disabled, any forums previously set to "Forced" (or "On" prior to Moodle 2.6) will be treated as optional.

===Mark post read after 'X' days===

This setting is forum_oldpostdays and specifies the number of days after which any post is considered to be read. E.g. If this is set to 14 days then any post older than 14 days will be considered read. If you set this to 0 then '''ALL''' posts are instantly considered to be read. If you don't want any posts to be considered read without the user reading them then set a high figure (e.g. 1000)

===Changing the subject line of forum notifications===
{{New features}}
Normally when forum subscribers receive emails from forums, the subject line is of the form: Course short name + Subject of post:

[[File:forum1.png]]

The subject line can be changed - for example to: Course short name + Forum name + Subject by going to ''Site administration>Language>Language customisation'' and in forum.php changing the string ''postmailsubject'' to
{$a->courseshortname} {$a->forumname} {$a->subject}

[[File:forum2.png]]

==See also==
* [http://youtu.be/lTLdIiSxclU The Moodle Forum] MoodleBites video on YouTube
* [http://youtu.be/amyQjAESkZM Moodle Forum Types and Group Mode] MoodleBites video on YouTube

[[de:Forum konfigurieren]]
[[fr:Ajouter/modifier un forum]]
[[ja:フォーラムの追加/編集]]
[[es:Configuraciones del foro]]

Forum activity

2014-08-14T09:21:51Z

Cttxg: Adding MoodleBites YouTube video links

{{Activities}}
The forum module is an activity where students and teachers can exchange ideas by posting comments. There are four basic forum types. Forum posts can be graded by the teacher or other students.

[[Image:Forumexample.png]]

A forum can contribute significantly to successful communication and community building in an online environment. You can use forums for many innovative purposes in educational settings, but teaching forums and student forums are arguably the two more significant distinctions.

* [[Forum settings]]
* [[Using Forum]]
* [[Forum FAQ]]

==See also==
* [http://youtu.be/amyQjAESkZM Moodle Forum Types and Group Mode] MoodleBites video on YouTube

[[Category:Forum]]

[[de:Forum]]
[[es:Módulo foro]]
[[eu:Foroak]]
[[fr:Forum]]
[[it:Modulo forum]]
[[ja:フォーラムモジュール]]

Atto editor

2014-08-06T08:12:58Z

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

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

The default text editor in Moodle is the Atto editor, built specifically for Moodle. There is also a version of the [[TinyMCE editor]] and a plain text editor.

Text editors can be enabled, disabled or a different one set to default from ''Administration > Site administration > Plugins > Text editors > Manage editors''. The order of priority may also be specified here.

An individual user can select an editor in their profile from ''Administration > My Profile settings > Edit profile.''

==Atto HTML editor==
{{New features}}

[[File:Atto1.png]]

Atto Row 1

{| class="nicetable"
|-
|-
| 1:Expand
| 2.Style
| 3.Bold
| 4.Italic
|-
| 5.Bulleted list
| 6.Numbered list
| 7.Add link
| 8.Unlink
|-
| 9.Add image
| 10.Add media
| 11.Manage embedded files

|}

[[File:Atto22.png]]

Atto Row 2

{| class="nicetable"
|-
|-
| 1. Underline
| 2. Strikethrough
| 3. Subscript
| 4. Superscript
|-
| 5. Align left
| 6. Align centre
| 7. Align right
| 8. Increase indent
|-
| 9. Decrease indent
| 10. Equation editor
| 11. Special character
| 12. Table
|-
| 13. Clear formatting
| 14. Undo/redo
| 15. Undo/redo
| 16. Accessibility checker
|-
| 17. Screenreader helper
| 18. HTML/code view
|}

==Equation editor==

{{New features}}If either the [[MathJax filter|MathJax]] or the [[TeX notation filter|TeX notation]] filters are enabled (in ''Administration > Site administration > Plugins > Filters > Manage filters'') then an equation editor button is provided in the toolbar for launching the equation editor.
{|
| [[File:equation editor.png|thumb|Equation editor]]
|}

==Site administration settings==

===Toolbar settings===

The administrator can specify which plugins to display and in which order from ''Administration > Site administration > Plugins > Text editors > Atto HTML editor > Atto toolbar settings''.
[[File:atto-plugins.png|thumb|center|450px|Atto Plugins]]

Extra plugins from the list (for example 'Font color' or 'Emoticon') may be added by typing the toolbarconfig term into the toolbar config table.

[[File:toolbarconfig.png]]

Here for example are the available colours when 'fontcolor' is added:

[[File:fontcolor.png]]

The icons are displayed in related groups and the administrator can decide how many groups to display in the default collapsed state of the toolbar (that is, how many groups to display on Row 1).

===Equation editor settings===

Equation editor commands may be removed, added or reordered in ''Administration > Site administration > Plugins > Text editors > Atto HTML editor > Equation editor settings''.

[[File:equationeditor.png]]

==See also==

* [http://youtu.be/GNQSK_fPV98 Moodle HQ screencast demonstrating Atto editor]
* [http://youtu.be/ZoOAkpK9Oho The Moodle Text Editor - Atto] MoodleBites video on YouTube
* [[Text editor FAQ]]
* [[Embedded files repository]]
* [https://moodle.org/mod/forum/discuss.php?d=258631 New 2.7 Equation Editor - Missing Key Items] forum discussion and associated issue MDL-45067

[[Category:Site administration]]

[[de:Text-Editor]]
[[es:Editor de texto]]

admin/setting/editorsettingsatto

2014-07-01T01:47:39Z

Cttxg: adding images & category

[[File:atto-plugins.png|thumb|Atto Plugins]]
This page provides the Administrator with a list of the Atto plugins installed on the site.

[[File:attotoolbarconfig.png|thumb|Atto Toolbar Config]]
Some plugins allow configuration via the Settings link.
Administrators can also set the default icons for the toolbar for all users on the site.

[[Category:Site administration]]
[[Category:Editing text]]

File:attotoolbarconfig.png

2014-07-01T01:47:01Z

Cttxg: Screenshot showing the config of the Atto icons for a site

Screenshot showing the config of the Atto icons for a site

File:atto-plugins.png

2014-07-01T01:44:46Z

Cttxg: Screenshot showing the Atto plugins

Screenshot showing the Atto plugins

admin/setting/editorsettingsatto

2014-07-01T01:42:02Z

Cttxg:

This page provides the Administrator with a list of the Atto plugins installed on the site. Some plugins allow configuration via the Settings link.
Administrators can also set the default icons for the toolbar for all users on the site.

[[Category:Site administration]]
[[Category:Editing text]]

admin/setting/editorsettingsatto

2014-07-01T01:38:34Z

Cttxg: creating initial page

Site policies

2014-06-05T02:11:35Z

Cttxg: Adding MoodleBites YouTube video link

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

===Protect usernames===

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

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

===Force users to login===

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

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

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

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

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

===Open to Google===

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

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

===Maximum uploaded file size===

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

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

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

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

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

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

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

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

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

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

===User quota===

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

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

===Enable trusted content===

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

===Maximum time to edit posts===

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

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

===Full name format===

This setting has been moved in Moodle 2.6 onwards to ''Administration > Site administration > Users > Permissions > [[Roles settings|User policies]]''.

===Allow extended characters in usernames===

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

===Site policy URL===

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

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

===Keep tag name casing===

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

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

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

===Profiles for enrolled users only===

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

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

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

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

===Account lockout===

Account lockout may be enabled.

Account lockout threshold: After a specified number of failed login attempts, a user's account is locked and they are sent an email containing a URL to unlock the account. Setting this to 'No' means there is no threshold and an account attempting to log in can do so an unlimited number of times.

Account lockout observation window: Observation time for lockout threshold, if there are no failed attempts the threshold counter is reset after this time. This is the counter for how long to watch for more failed attempts by an account trying to log in even after being locked out, the counter will reset at each attempt and last this long.

Account lockout duration: Locked out account is automatically unlocked after this duration.

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

===Password policy===

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

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

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

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

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

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

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

===Disable user profile images===

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

===Email change confirmation===

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

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

===Strict validation of required fields===
If enabled, users are prevented from entering a space or line break only in required fields in forms. (note: add more info)

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

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

Using RSS feeds

2014-06-05T02:06:05Z

Cttxg: Adding MoodleBites YouTube video link

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

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

== Subscribing to RSS feeds==

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

==Restricting access to RSS feeds==

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

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

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

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

[[de:RSS-Feeds nutzen]]

Site-wide reports

2014-06-05T02:03:33Z

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

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

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

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

[[Category:Report]]

[[es:Reportes del sitio]]
[[de:Systemweite Berichte]]

Quiz settings

2014-06-05T01:55:55Z

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

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

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

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

;Description
:Describe the purpose of the glossary and provide instructions or background information, links etc. Click the icon top left to expand the toolbars, and drag the bottom right of the text box out to expand it.

;'''Display description on course page'''
:If ticked, the quiz description will appear on the course page directly under the quiz name.

==Timing==
(These settings are collapsed by default)
{|
|[[File:quiztiming.png|thumb|452px|Timing settings expanded]]
|}

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

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

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

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

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

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

;When time expires..

There are three options as to what will happen when the time limit is up. Choose the one you need from the dropdown menu:

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

''For detailed information on how CBM works and how students can benefit from it, see [[Using certainty-based marking]].''
{|
| [[File:cbm03.png|thumb|correct answer; very sure]]
| [[File:cbm05.png|thumb|correct answer; fairly sure]]
| [[File:cmb04.png|thumb|correct answer; not very sure]]
| [[File:cbm01.png|thumb|wrong answer; very sure]]
| [[File:cbm99.png|thumb|wrong answer; not very sure]]
|}

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

(See also the forum discussion: [https://moodle.org/mod/forum/discuss.php?d=225920 CBM too harsh?]

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

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

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

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

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

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

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

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

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

:Show the user's picture
It is now possible, when displaying the user's profile picture for proctoring purposes, to choose whether a large image or thumbnail will be displayed.

;Decimal places in grades
:This option determines how many digits will be shown after the decimal separator (see [[dev:Translation_langconfig|langconfig]] ) when the grade is displayed. A setting of 0 for example means that the grades are displayed as integers. This setting is only used for the display of grades, not for the display or marking of answers.

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

;Require password
:This field is optional.

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

;Require network address
:This field is optional.

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

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

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

:Spaces are ignored.

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

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

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

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

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

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

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

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

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

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

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

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

For example, if you entered:

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

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

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

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

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

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

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

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

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

==Group and User overrides==

[[File:overridesquiz.png]]

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

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

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

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

==Site administration settings==

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

;Autosave period
:If enabled, student responses will be saved every minute/two minutes/five minutes (according to selection) This is useful so that students don't lose work but does increase the load on the server.

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

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

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

Question bank

2014-06-05T01:51:45Z

Cttxg: Adding MoodleBites YouTube video link

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

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

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

===Categories are shared in contexts===

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

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

==Edit, duplicate, preview, delete and move==

{{New features}}

[[File:questionicons.png]]

Each question in the question bank has four icons which allow you to edit, quickly duplicate, preview and delete the question. (The question may not be deleted if it is already in use elsewhere.) To move a question into a different category or subcategory, click into the box on its left; scroll down to "With Selected..." and choose "Move to.."

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

==Sharing and Managing Question banks==

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

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

See:

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

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

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

Quiz activity

2014-06-05T01:50:47Z

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

{{Activities}}

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

[[Image:Quizexample.png]]

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

== Features ==

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

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

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

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

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

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

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

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

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

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

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

Building Quiz

2014-06-05T01:50:05Z

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

{{Quiz}}

==How a Moodle quiz works==

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

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

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

Note that it is possible to create questions directly in the [[Question bank]] without first creating a quiz. These questions may then be used later.

Once a quiz has been added to the course and the [[Quiz settings]] established,the teacher can start to build the quiz. The teacher can access the quiz to edit the questions by clicking directly on the Quiz name on the course home page or by clicking "Edit quiz" in ''Administration>Quiz administration.''

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

|}

==Adding questions==

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

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

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

|}

===Creating a new question===

1. To make a brand new question, click "Add a question".

2. From the next screen, choose the question type you want to add and click "Next"

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

{|
| [[File:questionpicker.png|thumb|440px|Selecting a question type]]

|}

3. Fill in the question form, making sure to give a grade to the correct answer.

4. Click "Save changes".

{|
| [[File:questionadded.png|thumb|430px|A question when it has been created]]

|}

{{New features}}

'''Note:''' If you have a very complex question, and you want to check it as you go along, you can preview it and then click "Save changes and continue editing".

{|
| [[File:savechangesandcontinuediting.png|thumb|398px|Save changes and continue editing]]

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

When you add responses and feedback you can display one or more toolbars in the editor:
{|
| [[File:quizform1.png|thumb|350px|With one toolbar]]
| [[File:quizform2.png|thumb|350px|With three toolbars]]

|}

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

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

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

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

|}

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

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

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

|}

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

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

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

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

==Quiz layout==

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

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

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

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

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

|}

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

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

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

|}

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

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

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

===Dealing with faulty questions===

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

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

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