MoodleDocs - User contributions [en]

Journal module

2020-06-23T08:52:38Z

Finns:

{{Infobox plugin
|type = Activity
|entry = https://moodle.org/plugins/view.php?plugin=mod_journal
|tracker = http://tracker.moodle.org/browse/CONTRIB/component/10880
|discussion = http://moodle.org/mod/forum/view.php?id=736
|maintainer = David Monllaó
|float = Right
}}

==Background==
In Moodle 2.0 the Journal was removed from the core install, and is now available only as a plugin. For the history, please see this discussion: https://moodle.org/mod/forum/discuss.php?d=96334

The journal module allows teachers to collect online text from students, review it and provide feedback including grades. The work students submit is visible only to the teacher and not to the other students.

[[File:Journal_Example.png]]

A journal entry is one in which students type directly into a text field in Moodle. A Journal does not allow students to submit any digital content (files), including, for example, word-processed documents, spreadsheets, images, audio and video clips. Journals do not consist of file uploads.

A journal has a 'Days available' setting that controls the number of days the journal is open for changes.

Markers are not notified every time a student submits an assignment, or for late submissions. The entries for a whole class or group is shown to a marker, at the same time. Markers can choose to give students feedback in the form of text and grade.

==The purpose of the Journal==
The Journal is suitable for simple, short, online writing assignments in which students will refine their entries over time based on feedback from the marker. Journal assignments should be simple because it allows online text only and it does not allow for file uploads or use of the rubric or marking guide. Journal assignments should be short to prevent the 'scroll of death' for markers, because entries for all participants or groups are shown to the marker at the same time on one page.

==See also==

Using Moodle forum discussions:
*[http://moodle.org/mod/forum/discuss.php?d=257145 What does the Journal do?]

[[es:Módulo Journal]]

Drag and drop onto image question type

2020-05-07T09:39:00Z

Finns:

{{Questions}}

This question type allows students to drag words, images or both from a list and drop them into pre-defined gaps on a base image.

==How to create a question==
Give the question a descriptive name to help you find it in the question bank. (Students won't see the name.)

Add the question to the text editor, using any formatting you wish.

In the '''Preview''' section, click the background image button to upload an image. Larger images will be displayed at a maximum 600 x 400.Your image will then display under the file upload box.

In the '''Draggable items''' section, you can upload images if you leave the type as 'draggable image' or you can type in words if you change the type to 'draggable text'. You may have a mixture of images and text.

In the '''Drop zones''' section, you choose which items to go in which zone. Click the 'Refresh preview' button.

You can then position the items on the background image and this will add their coordinates.

Note:(1) Draggable images cannot be more than 150 x 100 pixels. If they are larger, they will be scaled on import. Remember to add a short text descriptor too. If you change your mind about an image, simply upload a diferent one to replace it.

Note (2) You can format draggable text using <nowiki> , , , , , and </nowiki>

Note (3) Choices that are within the same Group are colour coded and may only be dropped on a drop zone with the corresponding colour. Choices that are marked as 'Unlimited' may be used in multiple locations.

===Example one===
''Based on the Moodle documentation '''[[Pedagogy]]''', participants must 'climb the Moodle ladder' by ordering the stages of using Moodle as a teacher.''

In the '''Preview''' section, a basic image of steps is uploaded.

In the '''Draggable items''' section, the 'type' is chosen as 'draggable text' and the text for each stage is added. (Groups and the Unlimited setting are not used in this example)
[[File:imagedragdropdraggabletextu.png|thumb|center|500px]]
In the '''Drop zones''' section, an item from the previously added options is chosen from the drop down:
[[File:choosingdropzonetext.png|thumb|500px|center]]
These texts will now appear under the background image:
[[File:imagedragdroptextpreview.png|thumb|500px|center]]
The text boxes are dragged to their correct positions on the image (steps on the staircase) This will then add the co-ordinates to the Dropzones section automatically:
[[File:imagedragdropdropzonescoords.png|thumb|500px|center]]
Other settings are completed (see below) and the question is saved.

Participants must drag the Moodle stages to the correct step:
[[File:climbthemoodleladder.png|thumb|center|500px]]

===Example two===
''Participants must add the correct country flag and capital city onto a map of Europe.''

This question has images as well as text and makes use of the Groups feature.

In the '''Preview''' section, a basic map of Europe is uploaded.

In the '''Draggable items''' section, the capital cities are added as the type 'draggable text' and the flags are added as the type "draggable image"

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

All draggable images (the flags) are in Group 1 and all draggable text items (the capital cities) are in Group 2.

In the '''Drop zones''' section, an item from the previously added options is chosen from the drop down. The Group 1 boxes will display in a different colour from the Group 2 boxes.

When the boxes are dragged to their appropriate places on the background image, the coordinates in the Drop zones section are updated automatically.

Other settings are completed (see below) and the question is saved.

[[File:dragddropimageflagcity.png]]

==Scoring and feedback==
All gaps are weighted identically. Only drop zones that are filled correctly gain marks. There is no negative marking of drop zones that are filled incorrectly.

Whether or not Combined feedback is shown to students is governed by the Specific feedback setting on the quiz settings form.

'''Penalty for each incorrect try''': The available mark is reduced by the penalty for second and subsequent tries. In the example above a correct answer at the second try will score 0.6666667 of the available marks and a correct answer at the third try will score 0.3333334 of the available marks.

If the question is used in 'interactive with multiple tries' behaviour the marking is modified as follows:

# The mark is reduced for each try by the penalty factor.
# Allowance is made for when a correct choice is first chosen providing it remains chosen in subsequent tries.

'''Hint''': You can complete as many of these boxes as you wish. If you wish to give the student three tries at a question you will need to provide two hints. At runtime when the hints are exhausted the question will finish and the student will be given the general feedback and the question score will be calculated.

'''Clear incorrect responses''': When ‘Try again’ is clicked incorrect choices are cleared.

'''Show the number of correct responses''': Include in the feedback a statement of how many choices are correct.

==Accessibility==
Drag and drop questions are keyboard accessible. Use the <tab> key to move between the drop zones and the <space> key to cycle around the possible choices for each drop zone.

==Changing the dimensions of the images==
[https://moodle.org/mod/forum/discuss.php?d=358512 According to the plugin author], You can easily change the max dimensions of an image in this question type by changing [https://github.com/moodle/moodle/blob/MOODLE_33_STABLE/question/type/ddimageortext/questiontype.php#L30 these] and [https://github.com/moodle/moodle/blob/MOODLE_33_STABLE/question/type/ddmarker/questiontype.php#L31 these] constants in the code in your server:

define('QTYPE_DDIMAGEORTEXT_BGIMAGE_MAXWIDTH', 600);
define('QTYPE_DDIMAGEORTEXT_BGIMAGE_MAXHEIGHT', 400);
define('QTYPE_DDIMAGEORTEXT_DRAGIMAGE_MAXWIDTH', 150);
define('QTYPE_DDIMAGEORTEXT_DRAGIMAGE_MAXHEIGHT', 100);

define('QTYPE_DDMARKER_BGIMAGE_MAXWIDTH', 600);
define('QTYPE_DDMARKER_BGIMAGE_MAXHEIGHT', 400);

==Example (muscles in anatomy)==
* [https://moodle.org/mod/forum/discuss.php?d=358512 Anatomy drag and drop into image] example in a forum thread:
** Originally designed questions (1 and 2) look ugly:
[[File:DDinto_image_anatomy_muscles_example1.png|600px]]

[[File:DDinto_image_anatomy_muscles_example2.png|600px]]

** New questions (3 and 4) which use additional CSS code, look nice and they work perfectly:
[[File:DDinto_image_anatomy_muscles_example3.png|600px]]

[[File:DDinto_image_anatomy_muscles_example4.png|600px]]

**In order to make the text markers more look-alike the conventional legends of scientific diagrams, I (Joseph Rézeau) have added a few [https://docs.moodle.org/dev/CSS CSS] rules to my local site's Administration / Appearance / Additional HTML /When BODY is opened CSS as follows:

<code css>
<style type="text/css">
.que.ddimageortext .dropzone {
border: none;
background-color:transparent;
}
.que.ddimageortext .drag, form.mform fieldset#id_previewareaheader .drag {
border: none;
background-color:transparent;
}
.que.ddimageortext div.dragitems div.draghome,
.que.ddimageortext div.dragitems div.drag,
form.mform fieldset#id_previewareaheader div.draghome,
form.mform fieldset#id_previewareaheader div.drag {
font: 10px/1.231 arial, helvetica, clean, sans-serif;
}
</style>
</code>

** In order to have the correct responses remain in place, you have to do the following: When editing the drag & drop question, go to the Multiple Tries section and under Hint 1 options tick Options Clear incorrect responses.

== See also ==
This question type was originally developed by the UK Open University and was a contributed plugin for several years before becoming part of standard Moodle. Find more [https://moodle.org/plugins/browse.php?list=set&id=10 Open University plugins here].

[[Category:Questions]]
[[Category:Medicine]]

[[es:Tipo de pregunta arrastrar y soltar en imagen]]
[[de:Fragetyp Drag-and-Drop auf Bild]]
[[fr:Question glisser-déposer sur image]]

File:seb24.png

2020-04-27T12:53:15Z

Finns: Finns uploaded a new version of File:seb24.png

Calculated question type

2020-04-23T07:22:57Z

Finns: /* DO NOT PUT THE = sign in the formula. */

{{Questions}}
Calculated questions offer a way to create individual numerical questions by the use of wildcards (i.e you can use common variables names as '''x''' , '''y''' enclosed in curly braces to create the wildcards '''{x}''' and '''{y}''') that are substituted with random values when the quiz is taken.

For example, if you want to create a large number of '''"Calculate the area of a rectangle"''' problems to drill your students, you could create a question with two wildcards (i.e. '''{base}''', '''{height}''' created from the common '''base''', '''height''' variable names) and put in the "'''Correct Answer Formula='''" input field '''{base}''' * '''{height}''' ( * being the multiplication sign ).

'''Correct Answer Formula=''' {base}*{height}

When a student takes the test, Moodle will randomly select values for '''{base}''' and '''{height}''' and grade the response using the result of the '''Correct Answer Formula'''.

The test will very rarely appear the same way twice.

== Is this really the question type for you? ==
The main purpose of the calculated question is to create multiple versions of a question with different numerical values. This means you must have '''at least one''' wildcard in one of the answers.

If you don't need a random element, use the [[Numerical question type]] instead.
== Simple calculated question type ==

The [[Simple calculated question type|simple calculated]] question offers the most used features of the calculated question with a much simpler creation interface.

==Wildcards and datasets==

When Moodle delivers a Calculated question to the student, the wildcards are replaced with randomly-selected values. However, these values are not completely random - rather, they are randomly selected from a pre-defined ''dataset'' of possible values. This allows you some control over the possible values chosen - for example, in order to make sure the numbers are realistic.

These datasets can be ''private'' or ''shared'' - private datasets are used by one wildcard within one calculated question; shared datasets are used by one wildcard within all calculated questions that use it.

==Question set-up==
To create (or modify) a calculated question there are three pages to work through. The instructions below take you through the pages, step by step:

===Page 1. Editing a Calculated question ===

#Select the question '''category'''
#Any shared wildcards for this category are listed beneath. If you change category, you'll need to click the "Update the category" button to refresh this list. There may not be any shared wildcards yet - if not, you can create them later if you wish.
#Give the question a descriptive '''name''' - this allows you to identify it in the question bank.
#Enter the '''question text'''. This should be the question you want the student to answer, and it must include all the information they need to calculate an answer. Therefore it must contain at least one wildcard, inside curly braces. For example, if you wanted the student to sum numbers A and B, the question text might read: "What is {A} + {B}?" You may also include quantities computed from wildcards using the syntax "{=...}: for example, the question "What is {={A}+{B}} - {A}?" with wildcard values A=4 and B=3 would display as "What is 7 - 4?"
#Select an image to display if you want to add a picture to the question. For the student, it appears immediately after the question text and before the choices. If you want more control over how the image appears, include it in the question text above, using the HTML editor.
#Set the '''default question grade''' (i.e. the maximum number of marks for this question).
#Set the '''Penalty factor''' (see [[Calculated_question_type#Penalty_factor|Penalty factor]] below).
#''Moodle 1.7+:'' If you wish, add general feedback. This is text that appears to the student after he/she has answered the question.
#Next add the '''formula for the answer'''. This formula must contain at least the wildcards that appear in the question text. See [[Calculated_question_type#Correct_answer_formula_syntax|Correct answer formula syntax]] for further details.
# Choose the '''grade''' that the student will get for this question if they give this answer. This should be a percentage of the total marks available. For example, you could give 100% for a correct answer, and 50% for an answer that is nearly right. '''One of the answers must have a 100% grade'''.
#Determine the '''tolerance''' for error that you will accept in the answer. The tolerance and tolerance type settings combine to give a range of acceptable scores. So, if tolerance = t, correct answer = x and the difference between the user's answer and the correct answer is dx, then the tolerance types are as follows:
##Nominal - mark correct if |dx| <= t
##Relative - mark correct if |dx| / x <= t
##Geometric - mark correct if x/(1+t) <= (x+dx) <= x*(1+t)
# The next 2 settings, "Correct answer shows" and "Format" determine the '''precision''' of the answer. Use these to select the number of decimal places or significant figures you want to use.
# Add some '''feedback''' which the student will see if they enter this answer.
# You can specify as many answer formulae as you like - click "Add another answer blank" to add more.
# You can also specify units for the answers. For example, if you enter a unit of 'cm' here, and the accepted answer is 15, then the answers '15cm' and '15' are both accepted as correct. If you add more than one unit, you can also specify a multiplier. So, if your main answer was 5500 with unit W, you can also add the unit kW with a multiplier of 0.001. This means that the answers '5500', '5500W' or '5.5kW' would all be marked correct. Note that the accepted error is also multiplied, so an allowed error of 100W would become an error of 0.1kW.
# Finally (!) you can click "Next page" to save what you've done and move on. If you are editing an existing question, you can click "Next page (new question)" to create a completely new question based on an existing one.

==== Penalty factor ====

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

===Tolerance===

As for numerical questions it is possible to allow a margin within which all responses are accepted as correct. The "Tolerance" field is used for this. However, there are three different types of tolerances. These are Relative, Nominal and Geometric. If we say that the correct answer at quiz time is calculated to 200 and the tolerance is set to 0.5 then the different tolerance types work like this:

Relative: A tolerance interval is calculated by multiplying the correct answer with 0.5, ie in this case we get 100 so for this tolerance the correct response must be between 100 and 300. (200 ± 100)
This is useful if the magnitude of the correct answer can differ greatly between different wildcard values.

Nominal: This is the simplest tolerance type but not very powerful. The correct response must be between 199.5 and 200.5 (200 ± 0.5)
This tolerance type can be useful if the differences between different correct answers are small.

Geometric: The upper limit of the tolerance interval is calculated as 200 + 0.5*200 and is the same as for the relative case. The lower limit is calculated as 200/(1 + 0.5). The correct response must then be between 133.33 and 300.
This is useful for complex calculation that must have great tolerances where relative tolerances of 1 or more would be used for the upper limit but clearly not acceptable for the lower limit as it would make zero a correct answer for all cases.

The field Significant Figures does only relate to how the correct answer should be presented in the review or the reports. Examples: If it is set to 3 then the correct answer 13.333 would be presented as 13.3; 1236 would be presented as 1240; 23 would be presented as 23.0 etc.

===Page 2. Choose dataset properties ===

Each wildcard that you specify in the answer formula must have an associated set of possible values - this is its ''dataset''. Each of the wildcards is listed on this page along with a choice of dataset:
*'''private''' i.e. only used by this question
*'''shared''' i.e shared with other calculated questions in the same category

Using a shared dataset can save time when you are creating a lot of similar calculated questions.

Note that even when creating a question for the first time, this page may say that your wildcard "will use the same existing private dataset as before." This just means that Moodle has already tentatively created a private data set for that wildcard: if a private dataset is what you want, leave this choice selected.

If there is anything in the question text that looks like a wildcard, but does not appear in any of the answer formulae, you can specify whether or not this is meant to be a wildcard. If it is, you can choose whether it should use a private or shared dataset.

To continue, simply choose your preferred dataset for each wildcard, then click "Next Page".

===Page 3. Edit the datasets ===

Now we need to create the set of possible values that each wildcard can take. ''Warning'' - this page is a bit confusing!

There are two ways of creating values - you can type them in yourself and add them to the list, or you can have Moodle generate them for you.

==== Adding/deleting your own values ====

Adding individual values to the list is easy:

# In the 'Param' field for each wildcard, enter the value you want
# Scroll down to the 'Add' section and click the Add button (leaving the number of items set to 1)
# Repeat the above steps as many times as necessary (the maximum number of items is 100)

To delete values from the list:

# In the 'Delete' section, select the number of items to delete
# Click the Delete button

==== Letting Moodle create values ====

# Start with the "Range of Values" fields, and enter the lower and upper limits for the values you would accept
# Choose a number of decimal places for the value
# Choose the distribution of values between the limits - 'uniform' means any value between the limits is equally likely to be generated; 'loguniform' means that values towards the lower limit are more likely.
# Now move down to the 'Add' section and click on "force regeneration"
# In the menu next to the Add button, choose the number of sets of random values (items) you wish to add to the list. (Note that the maximum total number of items in your list is 100.)
# Finally, click Add to append the new values to the list
# '''Note:''' If you want more control over the items that Moodle adds, you can do them one at a time and preview the values before you add them. Click the "Get New Item to Add" button to make Moodle generate new values in the "Item to Add" section at the top. If you like them, click "Add" for 1 item; if not, click "Get New Item to Add" again to get new values.

==== Finishing off ====

Once your list of items (values) is complete, you are finished. It's up to you how many values you add - the more values you add, the more a question can be used by the students without them seeing the same values repeatedly.

Note that if you delete values from the list, you can put them back again. Change the "Next Item to Add" option to "reuse previous value if available", then the next time you add items, Moodle will restore your previously-deleted items from the dataset.

Once your list of values is complete, you can click 'Save changes' to finish.

==== What does the 'Update the datasets parameters' button do? ====

Warning: This button can affect several questions, so be careful before using it.
Assume you have selected dataset parameter for {a} to be any value between 1-10 and generated a question. In the second question also you decide to use a SHARED wildcard called {a}. Inherently, it will show a value between 1-10. However, your need here changes and you want to make it 11-100 instead. Then, you change them in the range and click this button. Voila! the values change and you can add new items here using the 'Get New item to add'. However, if you go back to your previous question, you will see that values would change there too, because it is a shared dataset. If you do not update parameters, then this may not happen and will generate a new set of values and displays them in the "Item to Add" section.

==Correct answer formula syntax==

=== DO NOT PUT THE = sign in the formula. ===

* In the recent versions of the calculated question type, you could have more than one answer formula and applied a specific grading value to each of them as long as there is at least one 100% correct answer formula.
If more than one correct answer formula input field are displayed when editing,
your site has the multiple answer feature.

* As a general rule, write these formulas like you would in a calculator e.g. <code>3 + 5 * sin(3/{x})</code> A notable exception is exponentiation, where x3 cannot be entered as <code>{x}^3</code>, but instead should be entered as <code>pow({x}, 3)</code>.
* Each function's placeholders and other arguments should be in parentheses (brackets). For example, if you want students to calculate the sine of one angle and cosine of two times another angle, you would enter <code>sin({a}) + cos({b}*2)</code> or <code>sin({a}) + cos(2*{b})</code>.
* It's usually better to have too many parentheses (brackets) than too few. The server won't care, and the more specific you are about what you mean, the more likely it will like your complex formulas.
* There is no implicit multiplication. To you, the human editor, "5(23)" or "5x" may seem perfectly obvious. To the server doing the math, it's crazy talk and won't be understood. Always use the "*" for multiplication.
* Any special mathematical function must have parentheses around its values. Take the sine function in the first bullet point for instance. Notice that the ''3 / x'' is wrapped in parentheses (brackets)--this is so the server can understand it properly. Without those parentheses, the server won't know if you mean "(sin 3) / x" or "sin (3 / x)" and will reject the entire formula accordingly.

==Available functions==

Calculated questions can use more than simple arithmetic operators. The following functions are allowed in versions 1.5 and newer.

{| width="97%" border="1px"
!Function
!Explanation
|-
|abs
|Absolute value
|-
|acos
|Arc cosine -- output in radians.
|-
|acosh
|Inverse hyperbolic cosine -- output in radians.
|-
|asin
|Arc sine -- output in radians.
|-
|asinh
|Inverse hyperbolic sine.-- output in radians.
|-
|atan2
|Arc tangent of two variables -- pass in two values like (y, x), and you'll get the atan(y/x), adjusted to the proper quadrant. (Note: The variables are in the reverse order to atan2(x,y) in Excel) Output is radians.
|-
|atan
|Arc tangent -- output in radians.
|-
|atanh
|Inverse hyperbolic tangent-- output in radians.
|-
|bindec
|Binary to decimal
|-
|ceil
|Round fractions up
|-
|cos
|Cosine -- in radians!!! Convert your degree measurement to radians before you take the cos of it.
|-
|cosh
|Hyperbolic cosine -- in radians!!! Convert your degree measurement to radians before you take the cosh of it.
|-
|decbin
|Decimal to binary
|-
|decoct
|Decimal to octal
|-
|deg2rad
|Converts the number in degrees to the radian equivalent
|-
|exp
|Calculates the exponent of e
|-
|expm1
|Returns exp(number) - 1, computed in a way that is accurate even when the value of number is close to zero
|-
|floor
|Round fractions down
|-
|fmod
|Returns the floating-point modulus of two numbers - i.e. the remainder when the first is divided by the second.
|-
|is_finite
|Finds whether a value is a legal finite number
|-
|is_infinite
|Finds whether a value is infinite
|-
|is_nan
|Finds whether a value is not a number
|-
|log10
|Base-10 logarithm
|-
|log1p
|Returns log(1 + number), computed in a way that is accurate even when the value of number is close to zero
|-
|log
|Natural logarithm (''ln'')
|-
|max
|Find highest value
|-
|min
|Find lowest value
|-
|octdec
|Octal to decimal
|-
|pi()
|Get value of pi - the function does not take an argument, like in Excel.
|-
|pow (numberToRaise, NumberRaisedTo)
|Exponential expression
|-
|rad2deg
|Converts the radian number to the equivalent number in degrees
|-
|rand
|Generate a random integer
|-
|round
|Rounds a float
|-
|sin
|Sine -- in radians!!! Convert your degree measurement to radians before you take the sin of it.
|-
|sinh
|Hyperbolic sine -- in radians!!! Convert your degree measurement to radians before you take the sinh of it.
|-
|sqrt
|Square root
|-
|tan
|Tangent -- in radians!!! Convert your degree measurement to radians before you take the tan of it.
|-
|tanh
|Hyperbolic tangent -- in radians!!! Convert your degree measurement to radians before you take the tanh of it.
|}

==Predefined constants==
Actually there is NO Predefined constant that is allowed other than pi() as a function without parameter.

==Synchronization==

You could use shared wild cards to get the same values across questions in a quiz.

A simple example will be to use the same radius in a first question asking for the perimiter of a circle of {radius}cm and a second question asking for the surface of a circle of {radius}cm.

When the quiz will be shown to the student the two questions will shown the same {radius} value.

However the synchronization will work '''ONLY''' if the questions are kept in the '''SAME''' category and have the '''SAME NUMBER OF DATASETS''' .

If you need to move the synchronized questions to another category, you need to do it by editing the questions.

(This restriction should be released by sept. 2010).

== I have a problem: The wild card values are reset when trying to add a new parameter==
* As described in MDL-37744 and [https://moodle.org/mod/forum/discuss.php?d=337851 this forum thread].
* You should perhaps take a look at the [[Formulas question type]].

==See also==

Using Moodle forum discussions:

* [http://moodle.org/mod/forum/discuss.php?d=150923 couple questions about "edit datasets page" in calculated questions]
* [https://moodle.org/mod/forum/discuss.php?d=230558 Capital vs lower case letters with units]

[[Category:Mathematics]]

[[de:Fragetyp Berechnet]]
[[es:Tipo de Pregunta Calculada]]
[[fr:Question calculée]]
[[zh:計算題]]
[[ja:計算問題タイプ]]

Using Lesson

2020-04-20T07:32:42Z

Finns:

{{Lesson}}
This page outlines how students and teachers interact with Moodle lessons once they have been created. For details on how to set up and then organise a lesson, see [[Lesson settings]] and [[Building Lesson]]

== What the student sees ==
*A student clicking on a Lesson will see an introductory page with one or more buttons which they choose from to select the path they wish to take.
*The display may vary according to how the teacher has set up the lesson in [[Lesson settings]]. For example; there may or may not be a list of pages down the side; there may or may not be an ongoing score.
*Students progress through the lesson with either content pages (of information, which is not graded) or various types of question pages (which may be graded). When a question page is used, the following page gives the answer and feedback if offered:
[[File:studentviewoflesson.png|500px]]
*The lesson is ended when the student has met the criteria set by the teacher. This could be answering a certain number of questions correctly, accessing a certain number of pages with content (text, audio or video) or following a certain navigational path. A final page appears where the student can check their score, if applicable, and return to the main course page.
[[File:studentendoflesson.png|400px]]]

Note: If the gradebook is hidden from the student (via ''Course administration>Edit settings'') or if the lesson is a practice lesson, then the 'View grades' link will not be displayed. However, the score will still be displayed at the end of the lesson, unless it is a practice lesson:
[[File:lessongradebookhidden.png|thumb|400px|center]]

==What the teacher sees==
*A teacher clicking on a lesson will see tabs at the top offering them the chance to preview, edit, view reports or grade essays in the lesson:
[[File:teacherviewoflesson.png|400px]]
===Preview===
*The lesson opens up in preview mode for the teacher. However, it will not show the score unless the teacher switches their role to a student.
===Edit===
*The Edit tab allows teachers to alter the lesson once it has been set up. There are two views - Collapsed and Expanded. See [[Building Lesson]] for more details on editing the lesson.

===Reports===
*The reports tab shows the performance of students taking the lesson. There is a general "Overview" and a "Detailed Statistics" tab.
====Overview====
[[File:lessonreportsoverview1.png|500px]]

By clicking on the specific attempt, the teacher can view the student's answers to specific questions. It is also possible to delete a student attempt by checking the attempt and using the pull down menu to change "Choose" to "Delete".

*Below the "Overview" can also be seen general statistics: Average score, Average time, High score, Low score, High time, Low time.
[[File:lessonreportstatistics.png|500px]]

====Detailed Statistics====
More detailed reports on individual questions are available from this tab, as in the following screenshot:

[[File:lessonreportsdetailed.png|500px]]

==Grading lessons==
*Note that for a lesson to be graded, it must have at least one question where a student can receive a score and the lesson can not be a practice lesson. Grades are calculated when the student has completed a lesson. Grades are kept for every student attempt.
===Grading lesson essays===
*If a lesson essay question has been included, the teacher can grade it from the Grade essays tab - #1 in the screenshot below - or from ''Lesson administration>Grade essays'' - #2 in the screenshot below:
[[File:gradelessonessays.png]]

*Completed essays are listed next to the students' names:
[[File:gradelessonessays1.png]]

*Ungraded essays are red in colour -#1 in the screenshot below:
*When a teacher clicks on an essay and grades it, the colour changes to a yellow shade - #2 in the screenshot below:
*When a teacher clicks 'Email graded essays' to notify the student, the colour changes to a green shade - #3 in the screenshot below:
[[File:colourchangegradedessays.png|thumb|600px|center|Colour changes when grading essays]]

==Understanding Flow control==
*''Administration > Lesson administration > Edit settings > Flow control group''

*Here are some examples to help you understand the Lesson flow control settings. Please note:
*"Allow student review" setting applies to the review of a whole Lesson, whereas
*"Provide option to try a question again" setting applies to the review of an individual question page. When the student does not select the correct answer, 'Provide option to try a question again" setting will display 2 buttons. One will direct the student back to the question and the other to continue.
*"Maximum number of attempts" is designed to prevent a student from being stuck on "This page" where they continually put or select the wrong answer. It will override other settings, such as review or the option to try the question again. When exceeded, it will not allow a score to be recorded for that question.

====Case 1 ====
The teacher wants the student to be able to attempt any question no more than 3 times and be given the chance to answer the question again. The teacher wants the student to see the response attached to their answer.

:Flow control settings
::Allow student review '''Yes'''
::Provide option to try a question again '''No'''
::Maximum number of attempts '''3'''
::Display default feedback '''No'''
::Number of pages to show '''0'''
::Slideshow '''No'''

:Student selects wrong answer and will see:
:: "Response for the wrong answer" (if any is shown)
:: "Yes, I'd like to try again" button
:: "Continue" button.

:Student selects correct answer and will see:
:: "Response for the correct answer" (if any is shown)
:: "Continue" button

====Case 2 ====
The teacher wants to allow the student 3 attempts at all questions but not see any feedback except the site default feedback for wrong answers.
*Flow control settings
::Allow student review '''No'''
::Provide option to try a question again '''Yes'''
::Maximum number of attempts '''3'''
::Display default feedback '''No'''
::Number of pages to show '''0'''
::Slideshow '''No'''

*Student selects wrong answer and will see:
::''Not quite. Would you like to try again?'' as text over the
::"Yes, I'd like to try again" button
::'"No, I just want to go on to the next question" button

:''Note:'' If the wrong answer jump is set to "This page" and the number of attempts is under the maximum, then the student will return to the question, regardless if they select "No, I just want to go on".

*Student selects correct answer and will see:
:: "Your answer: {gives the student's answer)"
:: Response attached to the correct answer (if any)

==== Case 3 ====
"Speed bump for speed clickers". Teacher only wants the student to get once chance to record an answer on any question. They will only see the response the teacher provides for any question, or the default feedback if no response has been set for the answer the student selected.

*Flow control settings
::Allow student review '''No'''
::Provide option to try a question again '''No'''
::Maximum number of attempts '''1'''
::Display default feedback '''Yes'''
::Number of pages to show '''0'''
::Slideshow '''No'''

*Student selects wrong answer and will see:
:: "Response for the wrong answer" (if any is shown)
:: "Yes, I'd like to try again" button
:: "Continue" button.

: ''Note:'' When teacher sets the Jump to "This page" for a wrong answer, they will return to the page but their score will not change.

* Student
::"Response for the correct answer" (if any is show)
::"Continue" button

==Ideas for using Lessons==
*Because of its "branching" nature, the lesson module lends itself to a wide variety of activities, not all of which need to be graded. In addition to merely working through a list of question pages, here are some other suggestions:
====Self-directed learning of a new topic====
*Use the lesson to introduce a new topic. The learner starts out knowing nothing but can progress at his own pace, reviewing what he is not sure of and moving on when he feels ready. This can be much enhanced by...
====Allow for different learning styles====
*When using the lesson to introduce a new topic, offer pages that deliver the content in different ways, according to how the students prefer to learn. For example the button "do you prefer to read?" goes to a page of text; "do you prefer to watch a video?" goes to a screencast ; "do you prefer to listen to instructions?" -goes to a podcast and so on.
====Role play simulations/Decision-making exercises====
*Use the lesson to set up situations where the learner has to make a choice each time and the scenario changes according to their selection. This could be a medical emergency for example, deciding upon the correct treatment, or a customer relations exercise, learning how best to deal with an awkward client. In an educational establishment it could serve well in Humanities subjects considering moral/ethical issues.
====Interactive fiction====
*For younger (and not so younger!) students, the lesson can be used to create a "choose your own ending" type of story where the student reads a page (or even watches a video/listens to an audio file) and then decides upon the character's next move. Apart from the entertainment value of this, it could be used to help guide pre-teens to behave responsibly by taking decisions for a character who is in a potentially dangerous situation.
====Differentiated revision guides====
*Students can be taken to different sets of revision questions according to their answers, allowing them to progress from basic to intermediate to advanced according to their prior knowledge.
== See also ==

[https://school.moodledemo.net/mod/lesson/view.php?id=432 A working example of a Lesson from the School demo site.]

[[fr:Afficher une leçon]]
[[de:Lektion nutzen]]
[[es:Usando Lección]]
[[ja:レッスンの利用]]

File:lessonreportsdetailed.png

2020-04-20T07:31:50Z

Finns: Finns uploaded a new version of File:lessonreportsdetailed.png

Using Lesson

2020-04-20T07:29:38Z

Finns:

{{Lesson}}
This page outlines how students and teachers interact with Moodle lessons once they have been created. For details on how to set up and then organise a lesson, see [[Lesson settings]] and [[Building Lesson]]

== What the student sees ==
*A student clicking on a Lesson will see an introductory page with one or more buttons which they choose from to select the path they wish to take.
*The display may vary according to how the teacher has set up the lesson in [[Lesson settings]]. For example; there may or may not be a list of pages down the side; there may or may not be an ongoing score.
*Students progress through the lesson with either content pages (of information, which is not graded) or various types of question pages (which may be graded). When a question page is used, the following page gives the answer and feedback if offered:
[[File:studentviewoflesson.png|500px]]
*The lesson is ended when the student has met the criteria set by the teacher. This could be answering a certain number of questions correctly, accessing a certain number of pages with content (text, audio or video) or following a certain navigational path. A final page appears where the student can check their score, if applicable, and return to the main course page.
[[File:studentendoflesson.png|400px]]]

Note: If the gradebook is hidden from the student (via ''Course administration>Edit settings'') or if the lesson is a practice lesson, then the 'View grades' link will not be displayed. However, the score will still be displayed at the end of the lesson, unless it is a practice lesson:
[[File:lessongradebookhidden.png|thumb|400px|center]]

==What the teacher sees==
*A teacher clicking on a lesson will see tabs at the top offering them the chance to preview, edit, view reports or grade essays in the lesson:
[[File:teacherviewoflesson.png|400px]]
===Preview===
*The lesson opens up in preview mode for the teacher. However, it will not show the score unless the teacher switches their role to a student.
===Edit===
*The Edit tab allows teachers to alter the lesson once it has been set up. There are two views - Collapsed and Expanded. See [[Building Lesson]] for more details on editing the lesson.

===Reports===
*The reports tab shows the performance of students taking the lesson. There is a general "Overview" and a "Detailed Statistics" tab.
====Overview====
[[File:lessonreportsoverview1.png|500px]]

By clicking on the specific attempt, the teacher can view the student's answers to specific questions. It is also possible to delete a student attempt by checking the attempt and using the pull down menu to change "Choose" to "Delete".

*Below the "Overview" can also be seen general statistics: Average score, Average time, High score, Low score, High time, Low time.
[[File:lessonreportstatistics.png|500px]]

====Detailed Statistics====
More detailed reports on individual questions are available from this tab, as in the following screenshot:

[[File:lessonreportsdetailed.png]]

==Grading lessons==
*Note that for a lesson to be graded, it must have at least one question where a student can receive a score and the lesson can not be a practice lesson. Grades are calculated when the student has completed a lesson. Grades are kept for every student attempt.
===Grading lesson essays===
*If a lesson essay question has been included, the teacher can grade it from the Grade essays tab - #1 in the screenshot below - or from ''Lesson administration>Grade essays'' - #2 in the screenshot below:
[[File:gradelessonessays.png]]

*Completed essays are listed next to the students' names:
[[File:gradelessonessays1.png]]

*Ungraded essays are red in colour -#1 in the screenshot below:
*When a teacher clicks on an essay and grades it, the colour changes to a yellow shade - #2 in the screenshot below:
*When a teacher clicks 'Email graded essays' to notify the student, the colour changes to a green shade - #3 in the screenshot below:
[[File:colourchangegradedessays.png|thumb|600px|center|Colour changes when grading essays]]

==Understanding Flow control==
*''Administration > Lesson administration > Edit settings > Flow control group''

*Here are some examples to help you understand the Lesson flow control settings. Please note:
*"Allow student review" setting applies to the review of a whole Lesson, whereas
*"Provide option to try a question again" setting applies to the review of an individual question page. When the student does not select the correct answer, 'Provide option to try a question again" setting will display 2 buttons. One will direct the student back to the question and the other to continue.
*"Maximum number of attempts" is designed to prevent a student from being stuck on "This page" where they continually put or select the wrong answer. It will override other settings, such as review or the option to try the question again. When exceeded, it will not allow a score to be recorded for that question.

====Case 1 ====
The teacher wants the student to be able to attempt any question no more than 3 times and be given the chance to answer the question again. The teacher wants the student to see the response attached to their answer.

:Flow control settings
::Allow student review '''Yes'''
::Provide option to try a question again '''No'''
::Maximum number of attempts '''3'''
::Display default feedback '''No'''
::Number of pages to show '''0'''
::Slideshow '''No'''

:Student selects wrong answer and will see:
:: "Response for the wrong answer" (if any is shown)
:: "Yes, I'd like to try again" button
:: "Continue" button.

:Student selects correct answer and will see:
:: "Response for the correct answer" (if any is shown)
:: "Continue" button

====Case 2 ====
The teacher wants to allow the student 3 attempts at all questions but not see any feedback except the site default feedback for wrong answers.
*Flow control settings
::Allow student review '''No'''
::Provide option to try a question again '''Yes'''
::Maximum number of attempts '''3'''
::Display default feedback '''No'''
::Number of pages to show '''0'''
::Slideshow '''No'''

*Student selects wrong answer and will see:
::''Not quite. Would you like to try again?'' as text over the
::"Yes, I'd like to try again" button
::'"No, I just want to go on to the next question" button

:''Note:'' If the wrong answer jump is set to "This page" and the number of attempts is under the maximum, then the student will return to the question, regardless if they select "No, I just want to go on".

*Student selects correct answer and will see:
:: "Your answer: {gives the student's answer)"
:: Response attached to the correct answer (if any)

==== Case 3 ====
"Speed bump for speed clickers". Teacher only wants the student to get once chance to record an answer on any question. They will only see the response the teacher provides for any question, or the default feedback if no response has been set for the answer the student selected.

*Flow control settings
::Allow student review '''No'''
::Provide option to try a question again '''No'''
::Maximum number of attempts '''1'''
::Display default feedback '''Yes'''
::Number of pages to show '''0'''
::Slideshow '''No'''

*Student selects wrong answer and will see:
:: "Response for the wrong answer" (if any is shown)
:: "Yes, I'd like to try again" button
:: "Continue" button.

: ''Note:'' When teacher sets the Jump to "This page" for a wrong answer, they will return to the page but their score will not change.

* Student
::"Response for the correct answer" (if any is show)
::"Continue" button

==Ideas for using Lessons==
*Because of its "branching" nature, the lesson module lends itself to a wide variety of activities, not all of which need to be graded. In addition to merely working through a list of question pages, here are some other suggestions:
====Self-directed learning of a new topic====
*Use the lesson to introduce a new topic. The learner starts out knowing nothing but can progress at his own pace, reviewing what he is not sure of and moving on when he feels ready. This can be much enhanced by...
====Allow for different learning styles====
*When using the lesson to introduce a new topic, offer pages that deliver the content in different ways, according to how the students prefer to learn. For example the button "do you prefer to read?" goes to a page of text; "do you prefer to watch a video?" goes to a screencast ; "do you prefer to listen to instructions?" -goes to a podcast and so on.
====Role play simulations/Decision-making exercises====
*Use the lesson to set up situations where the learner has to make a choice each time and the scenario changes according to their selection. This could be a medical emergency for example, deciding upon the correct treatment, or a customer relations exercise, learning how best to deal with an awkward client. In an educational establishment it could serve well in Humanities subjects considering moral/ethical issues.
====Interactive fiction====
*For younger (and not so younger!) students, the lesson can be used to create a "choose your own ending" type of story where the student reads a page (or even watches a video/listens to an audio file) and then decides upon the character's next move. Apart from the entertainment value of this, it could be used to help guide pre-teens to behave responsibly by taking decisions for a character who is in a potentially dangerous situation.
====Differentiated revision guides====
*Students can be taken to different sets of revision questions according to their answers, allowing them to progress from basic to intermediate to advanced according to their prior knowledge.
== See also ==

[https://school.moodledemo.net/mod/lesson/view.php?id=432 A working example of a Lesson from the School demo site.]

[[fr:Afficher une leçon]]
[[de:Lektion nutzen]]
[[es:Usando Lección]]
[[ja:レッスンの利用]]

File:lessonreportstatistics.png

2020-04-20T07:28:02Z

Finns: Finns uploaded a new version of File:lessonreportstatistics.png

File:lessonreportsoverview1.png

2020-04-20T07:26:45Z

Finns: Finns uploaded a new version of File:lessonreportsoverview1.png

Using Lesson

2020-04-20T07:17:41Z

Finns:

{{Lesson}}
This page outlines how students and teachers interact with Moodle lessons once they have been created. For details on how to set up and then organise a lesson, see [[Lesson settings]] and [[Building Lesson]]

== What the student sees ==
*A student clicking on a Lesson will see an introductory page with one or more buttons which they choose from to select the path they wish to take.
*The display may vary according to how the teacher has set up the lesson in [[Lesson settings]]. For example; there may or may not be a list of pages down the side; there may or may not be an ongoing score.
*Students progress through the lesson with either content pages (of information, which is not graded) or various types of question pages (which may be graded). When a question page is used, the following page gives the answer and feedback if offered:
[[File:studentviewoflesson.png|500px]]
*The lesson is ended when the student has met the criteria set by the teacher. This could be answering a certain number of questions correctly, accessing a certain number of pages with content (text, audio or video) or following a certain navigational path. A final page appears where the student can check their score, if applicable, and return to the main course page.
[[File:studentendoflesson.png|400px]]]

Note: If the gradebook is hidden from the student (via ''Course administration>Edit settings'') or if the lesson is a practice lesson, then the 'View grades' link will not be displayed. However, the score will still be displayed at the end of the lesson, unless it is a practice lesson:
[[File:lessongradebookhidden.png|thumb|400px|center]]

==What the teacher sees==
*A teacher clicking on a lesson will see tabs at the top offering them the chance to preview, edit, view reports or grade essays in the lesson:
[[File:teacherviewoflesson.png|400px]]
===Preview===
*The lesson opens up in preview mode for the teacher. However, it will not show the score unless the teacher switches their role to a student.
===Edit===
*The Edit tab allows teachers to alter the lesson once it has been set up. There are two views - Collapsed and Expanded. See [[Building Lesson]] for more details on editing the lesson.

===Reports===
*The reports tab shows the performance of students taking the lesson. There is a general "Overview" and a "Detailed Statistics" tab.
====Overview====
[[File:lessonreportsoverview1.png]]

By clicking on the specific attempt, the teacher can view the student's answers to specific questions. It is also possible to delete a student attempt by checking the attempt and using the pull down menu to change "Choose" to "Delete".

*Below the "Overview" can also be seen general statistics: Average score, Average time, High score, Low score, High time, Low time.
[[File:lessonreportstatistics.png]]

====Detailed Statistics====
More detailed reports on individual questions are available from this tab, as in the following screenshot:

[[File:lessonreportsdetailed.png]]

==Grading lessons==
*Note that for a lesson to be graded, it must have at least one question where a student can receive a score and the lesson can not be a practice lesson. Grades are calculated when the student has completed a lesson. Grades are kept for every student attempt.
===Grading lesson essays===
*If a lesson essay question has been included, the teacher can grade it from the Grade essays tab - #1 in the screenshot below - or from ''Lesson administration>Grade essays'' - #2 in the screenshot below:
[[File:gradelessonessays.png]]

*Completed essays are listed next to the students' names:
[[File:gradelessonessays1.png]]

*Ungraded essays are red in colour -#1 in the screenshot below:
*When a teacher clicks on an essay and grades it, the colour changes to a yellow shade - #2 in the screenshot below:
*When a teacher clicks 'Email graded essays' to notify the student, the colour changes to a green shade - #3 in the screenshot below:
[[File:colourchangegradedessays.png|thumb|600px|center|Colour changes when grading essays]]

==Understanding Flow control==
*''Administration > Lesson administration > Edit settings > Flow control group''

*Here are some examples to help you understand the Lesson flow control settings. Please note:
*"Allow student review" setting applies to the review of a whole Lesson, whereas
*"Provide option to try a question again" setting applies to the review of an individual question page. When the student does not select the correct answer, 'Provide option to try a question again" setting will display 2 buttons. One will direct the student back to the question and the other to continue.
*"Maximum number of attempts" is designed to prevent a student from being stuck on "This page" where they continually put or select the wrong answer. It will override other settings, such as review or the option to try the question again. When exceeded, it will not allow a score to be recorded for that question.

====Case 1 ====
The teacher wants the student to be able to attempt any question no more than 3 times and be given the chance to answer the question again. The teacher wants the student to see the response attached to their answer.

:Flow control settings
::Allow student review '''Yes'''
::Provide option to try a question again '''No'''
::Maximum number of attempts '''3'''
::Display default feedback '''No'''
::Number of pages to show '''0'''
::Slideshow '''No'''

:Student selects wrong answer and will see:
:: "Response for the wrong answer" (if any is shown)
:: "Yes, I'd like to try again" button
:: "Continue" button.

:Student selects correct answer and will see:
:: "Response for the correct answer" (if any is shown)
:: "Continue" button

====Case 2 ====
The teacher wants to allow the student 3 attempts at all questions but not see any feedback except the site default feedback for wrong answers.
*Flow control settings
::Allow student review '''No'''
::Provide option to try a question again '''Yes'''
::Maximum number of attempts '''3'''
::Display default feedback '''No'''
::Number of pages to show '''0'''
::Slideshow '''No'''

*Student selects wrong answer and will see:
::''Not quite. Would you like to try again?'' as text over the
::"Yes, I'd like to try again" button
::'"No, I just want to go on to the next question" button

:''Note:'' If the wrong answer jump is set to "This page" and the number of attempts is under the maximum, then the student will return to the question, regardless if they select "No, I just want to go on".

*Student selects correct answer and will see:
:: "Your answer: {gives the student's answer)"
:: Response attached to the correct answer (if any)

==== Case 3 ====
"Speed bump for speed clickers". Teacher only wants the student to get once chance to record an answer on any question. They will only see the response the teacher provides for any question, or the default feedback if no response has been set for the answer the student selected.

*Flow control settings
::Allow student review '''No'''
::Provide option to try a question again '''No'''
::Maximum number of attempts '''1'''
::Display default feedback '''Yes'''
::Number of pages to show '''0'''
::Slideshow '''No'''

*Student selects wrong answer and will see:
:: "Response for the wrong answer" (if any is shown)
:: "Yes, I'd like to try again" button
:: "Continue" button.

: ''Note:'' When teacher sets the Jump to "This page" for a wrong answer, they will return to the page but their score will not change.

* Student
::"Response for the correct answer" (if any is show)
::"Continue" button

==Ideas for using Lessons==
*Because of its "branching" nature, the lesson module lends itself to a wide variety of activities, not all of which need to be graded. In addition to merely working through a list of question pages, here are some other suggestions:
====Self-directed learning of a new topic====
*Use the lesson to introduce a new topic. The learner starts out knowing nothing but can progress at his own pace, reviewing what he is not sure of and moving on when he feels ready. This can be much enhanced by...
====Allow for different learning styles====
*When using the lesson to introduce a new topic, offer pages that deliver the content in different ways, according to how the students prefer to learn. For example the button "do you prefer to read?" goes to a page of text; "do you prefer to watch a video?" goes to a screencast ; "do you prefer to listen to instructions?" -goes to a podcast and so on.
====Role play simulations/Decision-making exercises====
*Use the lesson to set up situations where the learner has to make a choice each time and the scenario changes according to their selection. This could be a medical emergency for example, deciding upon the correct treatment, or a customer relations exercise, learning how best to deal with an awkward client. In an educational establishment it could serve well in Humanities subjects considering moral/ethical issues.
====Interactive fiction====
*For younger (and not so younger!) students, the lesson can be used to create a "choose your own ending" type of story where the student reads a page (or even watches a video/listens to an audio file) and then decides upon the character's next move. Apart from the entertainment value of this, it could be used to help guide pre-teens to behave responsibly by taking decisions for a character who is in a potentially dangerous situation.
====Differentiated revision guides====
*Students can be taken to different sets of revision questions according to their answers, allowing them to progress from basic to intermediate to advanced according to their prior knowledge.
== See also ==

[https://school.moodledemo.net/mod/lesson/view.php?id=432 A working example of a Lesson from the School demo site.]

[[fr:Afficher une leçon]]
[[de:Lektion nutzen]]
[[es:Usando Lección]]
[[ja:レッスンの利用]]

File:teacherviewoflesson.png

2020-04-20T07:16:41Z

Finns: Finns uploaded a new version of File:teacherviewoflesson.png

Using Lesson

2020-04-20T07:14:42Z

Finns: /* What the student sees */

{{Lesson}}
This page outlines how students and teachers interact with Moodle lessons once they have been created. For details on how to set up and then organise a lesson, see [[Lesson settings]] and [[Building Lesson]]

== What the student sees ==
*A student clicking on a Lesson will see an introductory page with one or more buttons which they choose from to select the path they wish to take.
*The display may vary according to how the teacher has set up the lesson in [[Lesson settings]]. For example; there may or may not be a list of pages down the side; there may or may not be an ongoing score.
*Students progress through the lesson with either content pages (of information, which is not graded) or various types of question pages (which may be graded). When a question page is used, the following page gives the answer and feedback if offered:
[[File:studentviewoflesson.png|500px]]
*The lesson is ended when the student has met the criteria set by the teacher. This could be answering a certain number of questions correctly, accessing a certain number of pages with content (text, audio or video) or following a certain navigational path. A final page appears where the student can check their score, if applicable, and return to the main course page.
[[File:studentendoflesson.png|400px]]]

Note: If the gradebook is hidden from the student (via ''Course administration>Edit settings'') or if the lesson is a practice lesson, then the 'View grades' link will not be displayed. However, the score will still be displayed at the end of the lesson, unless it is a practice lesson:
[[File:lessongradebookhidden.png|thumb|400px|center]]

==What the teacher sees==
*A teacher clicking on a lesson will see tabs at the top offering them the chance to preview, edit, view reports or grade essays in the lesson:
[[File:teacherviewoflesson.png]]
===Preview===
*The lesson opens up in preview mode for the teacher. However, it will not show the score unless the teacher switches their role to a student.
===Edit===
*The Edit tab allows teachers to alter the lesson once it has been set up. There are two views - Collapsed and Expanded. See [[Building Lesson]] for more details on editing the lesson.

===Reports===
*The reports tab shows the performance of students taking the lesson. There is a general "Overview" and a "Detailed Statistics" tab.
====Overview====
[[File:lessonreportsoverview1.png]]

By clicking on the specific attempt, the teacher can view the student's answers to specific questions. It is also possible to delete a student attempt by checking the attempt and using the pull down menu to change "Choose" to "Delete".

*Below the "Overview" can also be seen general statistics: Average score, Average time, High score, Low score, High time, Low time.
[[File:lessonreportstatistics.png]]

====Detailed Statistics====
More detailed reports on individual questions are available from this tab, as in the following screenshot:

[[File:lessonreportsdetailed.png]]

==Grading lessons==
*Note that for a lesson to be graded, it must have at least one question where a student can receive a score and the lesson can not be a practice lesson. Grades are calculated when the student has completed a lesson. Grades are kept for every student attempt.
===Grading lesson essays===
*If a lesson essay question has been included, the teacher can grade it from the Grade essays tab - #1 in the screenshot below - or from ''Lesson administration>Grade essays'' - #2 in the screenshot below:
[[File:gradelessonessays.png]]

*Completed essays are listed next to the students' names:
[[File:gradelessonessays1.png]]

*Ungraded essays are red in colour -#1 in the screenshot below:
*When a teacher clicks on an essay and grades it, the colour changes to a yellow shade - #2 in the screenshot below:
*When a teacher clicks 'Email graded essays' to notify the student, the colour changes to a green shade - #3 in the screenshot below:
[[File:colourchangegradedessays.png|thumb|600px|center|Colour changes when grading essays]]

==Understanding Flow control==
*''Administration > Lesson administration > Edit settings > Flow control group''

*Here are some examples to help you understand the Lesson flow control settings. Please note:
*"Allow student review" setting applies to the review of a whole Lesson, whereas
*"Provide option to try a question again" setting applies to the review of an individual question page. When the student does not select the correct answer, 'Provide option to try a question again" setting will display 2 buttons. One will direct the student back to the question and the other to continue.
*"Maximum number of attempts" is designed to prevent a student from being stuck on "This page" where they continually put or select the wrong answer. It will override other settings, such as review or the option to try the question again. When exceeded, it will not allow a score to be recorded for that question.

====Case 1 ====
The teacher wants the student to be able to attempt any question no more than 3 times and be given the chance to answer the question again. The teacher wants the student to see the response attached to their answer.

:Flow control settings
::Allow student review '''Yes'''
::Provide option to try a question again '''No'''
::Maximum number of attempts '''3'''
::Display default feedback '''No'''
::Number of pages to show '''0'''
::Slideshow '''No'''

:Student selects wrong answer and will see:
:: "Response for the wrong answer" (if any is shown)
:: "Yes, I'd like to try again" button
:: "Continue" button.

:Student selects correct answer and will see:
:: "Response for the correct answer" (if any is shown)
:: "Continue" button

====Case 2 ====
The teacher wants to allow the student 3 attempts at all questions but not see any feedback except the site default feedback for wrong answers.
*Flow control settings
::Allow student review '''No'''
::Provide option to try a question again '''Yes'''
::Maximum number of attempts '''3'''
::Display default feedback '''No'''
::Number of pages to show '''0'''
::Slideshow '''No'''

*Student selects wrong answer and will see:
::''Not quite. Would you like to try again?'' as text over the
::"Yes, I'd like to try again" button
::'"No, I just want to go on to the next question" button

:''Note:'' If the wrong answer jump is set to "This page" and the number of attempts is under the maximum, then the student will return to the question, regardless if they select "No, I just want to go on".

*Student selects correct answer and will see:
:: "Your answer: {gives the student's answer)"
:: Response attached to the correct answer (if any)

==== Case 3 ====
"Speed bump for speed clickers". Teacher only wants the student to get once chance to record an answer on any question. They will only see the response the teacher provides for any question, or the default feedback if no response has been set for the answer the student selected.

*Flow control settings
::Allow student review '''No'''
::Provide option to try a question again '''No'''
::Maximum number of attempts '''1'''
::Display default feedback '''Yes'''
::Number of pages to show '''0'''
::Slideshow '''No'''

*Student selects wrong answer and will see:
:: "Response for the wrong answer" (if any is shown)
:: "Yes, I'd like to try again" button
:: "Continue" button.

: ''Note:'' When teacher sets the Jump to "This page" for a wrong answer, they will return to the page but their score will not change.

* Student
::"Response for the correct answer" (if any is show)
::"Continue" button

==Ideas for using Lessons==
*Because of its "branching" nature, the lesson module lends itself to a wide variety of activities, not all of which need to be graded. In addition to merely working through a list of question pages, here are some other suggestions:
====Self-directed learning of a new topic====
*Use the lesson to introduce a new topic. The learner starts out knowing nothing but can progress at his own pace, reviewing what he is not sure of and moving on when he feels ready. This can be much enhanced by...
====Allow for different learning styles====
*When using the lesson to introduce a new topic, offer pages that deliver the content in different ways, according to how the students prefer to learn. For example the button "do you prefer to read?" goes to a page of text; "do you prefer to watch a video?" goes to a screencast ; "do you prefer to listen to instructions?" -goes to a podcast and so on.
====Role play simulations/Decision-making exercises====
*Use the lesson to set up situations where the learner has to make a choice each time and the scenario changes according to their selection. This could be a medical emergency for example, deciding upon the correct treatment, or a customer relations exercise, learning how best to deal with an awkward client. In an educational establishment it could serve well in Humanities subjects considering moral/ethical issues.
====Interactive fiction====
*For younger (and not so younger!) students, the lesson can be used to create a "choose your own ending" type of story where the student reads a page (or even watches a video/listens to an audio file) and then decides upon the character's next move. Apart from the entertainment value of this, it could be used to help guide pre-teens to behave responsibly by taking decisions for a character who is in a potentially dangerous situation.
====Differentiated revision guides====
*Students can be taken to different sets of revision questions according to their answers, allowing them to progress from basic to intermediate to advanced according to their prior knowledge.
== See also ==

[https://school.moodledemo.net/mod/lesson/view.php?id=432 A working example of a Lesson from the School demo site.]

[[fr:Afficher une leçon]]
[[de:Lektion nutzen]]
[[es:Usando Lección]]
[[ja:レッスンの利用]]

File:lessongradebookhidden.png

2020-04-20T07:13:55Z

Finns: Finns uploaded a new version of File:lessongradebookhidden.png

Using Lesson

2020-04-20T07:08:14Z

Finns: /* What the student sees */

{{Lesson}}
This page outlines how students and teachers interact with Moodle lessons once they have been created. For details on how to set up and then organise a lesson, see [[Lesson settings]] and [[Building Lesson]]

== What the student sees ==
*A student clicking on a Lesson will see an introductory page with one or more buttons which they choose from to select the path they wish to take.
*The display may vary according to how the teacher has set up the lesson in [[Lesson settings]]. For example; there may or may not be a list of pages down the side; there may or may not be an ongoing score.
*Students progress through the lesson with either content pages (of information, which is not graded) or various types of question pages (which may be graded). When a question page is used, the following page gives the answer and feedback if offered:
[[File:studentviewoflesson.png|500px]]
*The lesson is ended when the student has met the criteria set by the teacher. This could be answering a certain number of questions correctly, accessing a certain number of pages with content (text, audio or video) or following a certain navigational path. A final page appears where the student can check their score, if applicable, and return to the main course page.
[[File:studentendoflesson.png|400px]]]

Note: Since Moodle 2.8.3, If the gradebook is hidden from the student (via ''Course administration>Edit settings'') or if the lesson is a practice lesson, then the 'View grades' link will not be displayed. However, the score will still be displayed at the end of the lesson, unless it is a practice lesson:
[[File:lessongradebookhidden.png|thumb|300px|center]]

==What the teacher sees==
*A teacher clicking on a lesson will see tabs at the top offering them the chance to preview, edit, view reports or grade essays in the lesson:
[[File:teacherviewoflesson.png]]
===Preview===
*The lesson opens up in preview mode for the teacher. However, it will not show the score unless the teacher switches their role to a student.
===Edit===
*The Edit tab allows teachers to alter the lesson once it has been set up. There are two views - Collapsed and Expanded. See [[Building Lesson]] for more details on editing the lesson.

===Reports===
*The reports tab shows the performance of students taking the lesson. There is a general "Overview" and a "Detailed Statistics" tab.
====Overview====
[[File:lessonreportsoverview1.png]]

By clicking on the specific attempt, the teacher can view the student's answers to specific questions. It is also possible to delete a student attempt by checking the attempt and using the pull down menu to change "Choose" to "Delete".

*Below the "Overview" can also be seen general statistics: Average score, Average time, High score, Low score, High time, Low time.
[[File:lessonreportstatistics.png]]

====Detailed Statistics====
More detailed reports on individual questions are available from this tab, as in the following screenshot:

[[File:lessonreportsdetailed.png]]

==Grading lessons==
*Note that for a lesson to be graded, it must have at least one question where a student can receive a score and the lesson can not be a practice lesson. Grades are calculated when the student has completed a lesson. Grades are kept for every student attempt.
===Grading lesson essays===
*If a lesson essay question has been included, the teacher can grade it from the Grade essays tab - #1 in the screenshot below - or from ''Lesson administration>Grade essays'' - #2 in the screenshot below:
[[File:gradelessonessays.png]]

*Completed essays are listed next to the students' names:
[[File:gradelessonessays1.png]]

*Ungraded essays are red in colour -#1 in the screenshot below:
*When a teacher clicks on an essay and grades it, the colour changes to a yellow shade - #2 in the screenshot below:
*When a teacher clicks 'Email graded essays' to notify the student, the colour changes to a green shade - #3 in the screenshot below:
[[File:colourchangegradedessays.png|thumb|600px|center|Colour changes when grading essays]]

==Understanding Flow control==
*''Administration > Lesson administration > Edit settings > Flow control group''

*Here are some examples to help you understand the Lesson flow control settings. Please note:
*"Allow student review" setting applies to the review of a whole Lesson, whereas
*"Provide option to try a question again" setting applies to the review of an individual question page. When the student does not select the correct answer, 'Provide option to try a question again" setting will display 2 buttons. One will direct the student back to the question and the other to continue.
*"Maximum number of attempts" is designed to prevent a student from being stuck on "This page" where they continually put or select the wrong answer. It will override other settings, such as review or the option to try the question again. When exceeded, it will not allow a score to be recorded for that question.

====Case 1 ====
The teacher wants the student to be able to attempt any question no more than 3 times and be given the chance to answer the question again. The teacher wants the student to see the response attached to their answer.

:Flow control settings
::Allow student review '''Yes'''
::Provide option to try a question again '''No'''
::Maximum number of attempts '''3'''
::Display default feedback '''No'''
::Number of pages to show '''0'''
::Slideshow '''No'''

:Student selects wrong answer and will see:
:: "Response for the wrong answer" (if any is shown)
:: "Yes, I'd like to try again" button
:: "Continue" button.

:Student selects correct answer and will see:
:: "Response for the correct answer" (if any is shown)
:: "Continue" button

====Case 2 ====
The teacher wants to allow the student 3 attempts at all questions but not see any feedback except the site default feedback for wrong answers.
*Flow control settings
::Allow student review '''No'''
::Provide option to try a question again '''Yes'''
::Maximum number of attempts '''3'''
::Display default feedback '''No'''
::Number of pages to show '''0'''
::Slideshow '''No'''

*Student selects wrong answer and will see:
::''Not quite. Would you like to try again?'' as text over the
::"Yes, I'd like to try again" button
::'"No, I just want to go on to the next question" button

:''Note:'' If the wrong answer jump is set to "This page" and the number of attempts is under the maximum, then the student will return to the question, regardless if they select "No, I just want to go on".

*Student selects correct answer and will see:
:: "Your answer: {gives the student's answer)"
:: Response attached to the correct answer (if any)

==== Case 3 ====
"Speed bump for speed clickers". Teacher only wants the student to get once chance to record an answer on any question. They will only see the response the teacher provides for any question, or the default feedback if no response has been set for the answer the student selected.

*Flow control settings
::Allow student review '''No'''
::Provide option to try a question again '''No'''
::Maximum number of attempts '''1'''
::Display default feedback '''Yes'''
::Number of pages to show '''0'''
::Slideshow '''No'''

*Student selects wrong answer and will see:
:: "Response for the wrong answer" (if any is shown)
:: "Yes, I'd like to try again" button
:: "Continue" button.

: ''Note:'' When teacher sets the Jump to "This page" for a wrong answer, they will return to the page but their score will not change.

* Student
::"Response for the correct answer" (if any is show)
::"Continue" button

==Ideas for using Lessons==
*Because of its "branching" nature, the lesson module lends itself to a wide variety of activities, not all of which need to be graded. In addition to merely working through a list of question pages, here are some other suggestions:
====Self-directed learning of a new topic====
*Use the lesson to introduce a new topic. The learner starts out knowing nothing but can progress at his own pace, reviewing what he is not sure of and moving on when he feels ready. This can be much enhanced by...
====Allow for different learning styles====
*When using the lesson to introduce a new topic, offer pages that deliver the content in different ways, according to how the students prefer to learn. For example the button "do you prefer to read?" goes to a page of text; "do you prefer to watch a video?" goes to a screencast ; "do you prefer to listen to instructions?" -goes to a podcast and so on.
====Role play simulations/Decision-making exercises====
*Use the lesson to set up situations where the learner has to make a choice each time and the scenario changes according to their selection. This could be a medical emergency for example, deciding upon the correct treatment, or a customer relations exercise, learning how best to deal with an awkward client. In an educational establishment it could serve well in Humanities subjects considering moral/ethical issues.
====Interactive fiction====
*For younger (and not so younger!) students, the lesson can be used to create a "choose your own ending" type of story where the student reads a page (or even watches a video/listens to an audio file) and then decides upon the character's next move. Apart from the entertainment value of this, it could be used to help guide pre-teens to behave responsibly by taking decisions for a character who is in a potentially dangerous situation.
====Differentiated revision guides====
*Students can be taken to different sets of revision questions according to their answers, allowing them to progress from basic to intermediate to advanced according to their prior knowledge.
== See also ==

[https://school.moodledemo.net/mod/lesson/view.php?id=432 A working example of a Lesson from the School demo site.]

[[fr:Afficher une leçon]]
[[de:Lektion nutzen]]
[[es:Usando Lección]]
[[ja:レッスンの利用]]

File:studentendoflesson.png

2020-04-20T07:07:28Z

Finns: Finns uploaded a new version of File:studentendoflesson.png

File:studentendoflesson.png

2020-04-20T06:56:12Z

Finns: Finns uploaded a new version of File:studentendoflesson.png

File:studentviewoflesson.png

2020-04-20T06:52:36Z

Finns: Finns uploaded a new version of File:studentviewoflesson.png

Using Lesson

2020-04-20T06:46:22Z

Finns:

{{Lesson}}
This page outlines how students and teachers interact with Moodle lessons once they have been created. For details on how to set up and then organise a lesson, see [[Lesson settings]] and [[Building Lesson]]

== What the student sees ==
*A student clicking on a Lesson will see an introductory page with one or more buttons which they choose from to select the path they wish to take.
*The display may vary according to how the teacher has set up the lesson in [[Lesson settings]]. For example; there may or may not be a list of pages down the side; there may or may not be an ongoing score.
*Students progress through the lesson with either content pages (of information, which is not graded) or various types of question pages (which may be graded). When a question page is used, the following page gives the answer and feedback if offered:
[[File:studentviewoflesson.png|500px]]
*The lesson is ended when the student has met the criteria set by the teacher. This could be answering a certain number of questions correctly, accessing a certain number of pages with content (text, audio or video) or following a certain navigational path. A final page appears where the student can check their score, if applicable, and return to the main course page.
[[File:studentendoflesson.png]]

Note: Since Moodle 2.8.3, If the gradebook is hidden from the student (via ''Course administration>Edit settings'') or if the lesson is a practice lesson, then the 'View grades' link will not be displayed. However, the score will still be displayed at the end of the lesson, unless it is a practice lesson:
[[File:lessongradebookhidden.png|thumb|300px|center]]

==What the teacher sees==
*A teacher clicking on a lesson will see tabs at the top offering them the chance to preview, edit, view reports or grade essays in the lesson:
[[File:teacherviewoflesson.png]]
===Preview===
*The lesson opens up in preview mode for the teacher. However, it will not show the score unless the teacher switches their role to a student.
===Edit===
*The Edit tab allows teachers to alter the lesson once it has been set up. There are two views - Collapsed and Expanded. See [[Building Lesson]] for more details on editing the lesson.

===Reports===
*The reports tab shows the performance of students taking the lesson. There is a general "Overview" and a "Detailed Statistics" tab.
====Overview====
[[File:lessonreportsoverview1.png]]

By clicking on the specific attempt, the teacher can view the student's answers to specific questions. It is also possible to delete a student attempt by checking the attempt and using the pull down menu to change "Choose" to "Delete".

*Below the "Overview" can also be seen general statistics: Average score, Average time, High score, Low score, High time, Low time.
[[File:lessonreportstatistics.png]]

====Detailed Statistics====
More detailed reports on individual questions are available from this tab, as in the following screenshot:

[[File:lessonreportsdetailed.png]]

==Grading lessons==
*Note that for a lesson to be graded, it must have at least one question where a student can receive a score and the lesson can not be a practice lesson. Grades are calculated when the student has completed a lesson. Grades are kept for every student attempt.
===Grading lesson essays===
*If a lesson essay question has been included, the teacher can grade it from the Grade essays tab - #1 in the screenshot below - or from ''Lesson administration>Grade essays'' - #2 in the screenshot below:
[[File:gradelessonessays.png]]

*Completed essays are listed next to the students' names:
[[File:gradelessonessays1.png]]

*Ungraded essays are red in colour -#1 in the screenshot below:
*When a teacher clicks on an essay and grades it, the colour changes to a yellow shade - #2 in the screenshot below:
*When a teacher clicks 'Email graded essays' to notify the student, the colour changes to a green shade - #3 in the screenshot below:
[[File:colourchangegradedessays.png|thumb|600px|center|Colour changes when grading essays]]

==Understanding Flow control==
*''Administration > Lesson administration > Edit settings > Flow control group''

*Here are some examples to help you understand the Lesson flow control settings. Please note:
*"Allow student review" setting applies to the review of a whole Lesson, whereas
*"Provide option to try a question again" setting applies to the review of an individual question page. When the student does not select the correct answer, 'Provide option to try a question again" setting will display 2 buttons. One will direct the student back to the question and the other to continue.
*"Maximum number of attempts" is designed to prevent a student from being stuck on "This page" where they continually put or select the wrong answer. It will override other settings, such as review or the option to try the question again. When exceeded, it will not allow a score to be recorded for that question.

====Case 1 ====
The teacher wants the student to be able to attempt any question no more than 3 times and be given the chance to answer the question again. The teacher wants the student to see the response attached to their answer.

:Flow control settings
::Allow student review '''Yes'''
::Provide option to try a question again '''No'''
::Maximum number of attempts '''3'''
::Display default feedback '''No'''
::Number of pages to show '''0'''
::Slideshow '''No'''

:Student selects wrong answer and will see:
:: "Response for the wrong answer" (if any is shown)
:: "Yes, I'd like to try again" button
:: "Continue" button.

:Student selects correct answer and will see:
:: "Response for the correct answer" (if any is shown)
:: "Continue" button

====Case 2 ====
The teacher wants to allow the student 3 attempts at all questions but not see any feedback except the site default feedback for wrong answers.
*Flow control settings
::Allow student review '''No'''
::Provide option to try a question again '''Yes'''
::Maximum number of attempts '''3'''
::Display default feedback '''No'''
::Number of pages to show '''0'''
::Slideshow '''No'''

*Student selects wrong answer and will see:
::''Not quite. Would you like to try again?'' as text over the
::"Yes, I'd like to try again" button
::'"No, I just want to go on to the next question" button

:''Note:'' If the wrong answer jump is set to "This page" and the number of attempts is under the maximum, then the student will return to the question, regardless if they select "No, I just want to go on".

*Student selects correct answer and will see:
:: "Your answer: {gives the student's answer)"
:: Response attached to the correct answer (if any)

==== Case 3 ====
"Speed bump for speed clickers". Teacher only wants the student to get once chance to record an answer on any question. They will only see the response the teacher provides for any question, or the default feedback if no response has been set for the answer the student selected.

*Flow control settings
::Allow student review '''No'''
::Provide option to try a question again '''No'''
::Maximum number of attempts '''1'''
::Display default feedback '''Yes'''
::Number of pages to show '''0'''
::Slideshow '''No'''

*Student selects wrong answer and will see:
:: "Response for the wrong answer" (if any is shown)
:: "Yes, I'd like to try again" button
:: "Continue" button.

: ''Note:'' When teacher sets the Jump to "This page" for a wrong answer, they will return to the page but their score will not change.

* Student
::"Response for the correct answer" (if any is show)
::"Continue" button

==Ideas for using Lessons==
*Because of its "branching" nature, the lesson module lends itself to a wide variety of activities, not all of which need to be graded. In addition to merely working through a list of question pages, here are some other suggestions:
====Self-directed learning of a new topic====
*Use the lesson to introduce a new topic. The learner starts out knowing nothing but can progress at his own pace, reviewing what he is not sure of and moving on when he feels ready. This can be much enhanced by...
====Allow for different learning styles====
*When using the lesson to introduce a new topic, offer pages that deliver the content in different ways, according to how the students prefer to learn. For example the button "do you prefer to read?" goes to a page of text; "do you prefer to watch a video?" goes to a screencast ; "do you prefer to listen to instructions?" -goes to a podcast and so on.
====Role play simulations/Decision-making exercises====
*Use the lesson to set up situations where the learner has to make a choice each time and the scenario changes according to their selection. This could be a medical emergency for example, deciding upon the correct treatment, or a customer relations exercise, learning how best to deal with an awkward client. In an educational establishment it could serve well in Humanities subjects considering moral/ethical issues.
====Interactive fiction====
*For younger (and not so younger!) students, the lesson can be used to create a "choose your own ending" type of story where the student reads a page (or even watches a video/listens to an audio file) and then decides upon the character's next move. Apart from the entertainment value of this, it could be used to help guide pre-teens to behave responsibly by taking decisions for a character who is in a potentially dangerous situation.
====Differentiated revision guides====
*Students can be taken to different sets of revision questions according to their answers, allowing them to progress from basic to intermediate to advanced according to their prior knowledge.
== See also ==

[https://school.moodledemo.net/mod/lesson/view.php?id=432 A working example of a Lesson from the School demo site.]

[[fr:Afficher une leçon]]
[[de:Lektion nutzen]]
[[es:Usando Lección]]
[[ja:レッスンの利用]]

File:studentviewoflesson.png

2020-04-20T06:45:33Z

Finns: Finns uploaded a new version of File:studentviewoflesson.png

Lesson activity

2020-04-20T05:26:22Z

Finns:

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

{{MediaPlayer | url = https://youtu.be/PEPGNaXZNSI | desc = Overview of the Lesson activity}}

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

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

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

==See also==
Using Moodle [http://moodle.org/mod/forum/discuss.php?d=207365&parent=910023#p910107 Difference between Lesson and Book]

[[Category:Lesson]]
[[es:Actividad de lección]]
[[eu:Ikasgaiak]]
[[fr:Leçon]]
[[de:Lektion]]
[[fi:Oppitunti (aktiviteetti)]]

File:lesson.svg

2020-04-20T05:24:39Z

Finns:

mod/journal/view

2020-02-23T23:49:17Z

Finns: Redirected page to Journal module

#REDIRECT [[Journal module]]

error/choicegroup/nogroupincourse

2020-01-22T10:09:15Z

Finns:

The creation of a Group choice activity is only meaningful if groups exist in the course.

For this reason, you need to first create at least one group in the course, before being able to create a Group choice activity.

[[Category:Error]]

[[es:error/choicegroup/nogroupincourse]]
[[de:error/choicegroup/nogroupincourse]]

Differentiator local plugin

2020-01-03T11:13:49Z

Finns:

{{Infobox plugin
|type = Local plugin
|entry = https://moodle.org/plugins/local_differentiator
|tracker = https://github.com/lucaboesch/moodle-local_differentiator/issues
|discussion = https://moodle.org/plugins/local_differentiator
|maintainer = [https://moodle.org/user/profile.php?id=1350696 Luca Bösch]
|float = right
}}
==Description==
A tool to efficiently formulate and save [[Outcomes|learning goals]]. This plugin is based off The Differentiator by Ian Byrd http://byrdseed.com/differentiator/.

[[File:Differentiator plugin 01.png|800px]]

==Languages available==
The 1.3 version of this plugin currently ships with the important words inside the templates shown in the following languages:
* English
* German
* Italian
* French
* International Spanish
* Mexican Spanish
* Portuguese
* Dutch

[[File:Differentiator plugin 01 fr.png|800px]]

If you would like to make a translation for another language (it will take you 2-3 hours working in a GoogleDocs spreadsheet document), please add a suggestion at https://github.com/lucaboesch/moodle-local_differentiator/issues .

==Plugin usage==
Once installed, you can use this plugin by going to 'Site administration > Courses > Differentiator'.

[[File:Differentiator plugin 03.png|400px]]

* As there is no navigation node created, you have got to direct your users to that address otherwise, eg. by a link in the footer or in a custom menu.
** In a localhost server the link should point to '''http://localhost/local/differentiator'''. You should substitute //localhost/ with your server's address.

==User tours available==
* When you install this plugin, there will be a file named ''differentiator_user_tour.json'' inside the ''moodle/local/differentiatior'' folder.
* You can add this file to your [[User tours]] collection.
** As an administrator, access 'User tours' from Site administration > Appearance > User tours > Import.
** Drag and drop the ''differentiator_user_tour.json'' file into the dotted lines box to add the tour and click on 'Save changes'.
* Make sure that the [[Multi-language content filter]] is activated in order to show the user tour in the supported languages listed above.
** Go to Site administration > Plugins > Filters > Manage filters and in the dropdown menu for multi-language content select 'On'.

[[File:Differentiator plugin 02.png|400px]]

[[es:Plugin local Diferenciador]]

Differentiator local plugin

2019-12-28T17:18:15Z

Finns:

{{Infobox plugin
|type = Local plugin
|entry = https://moodle.org/plugins/local_differentiator
|tracker = https://github.com/lucaboesch/moodle-local_differentiator/issues
|discussion = https://moodle.org/plugins/local_differentiator
|maintainer = [https://moodle.org/user/profile.php?id=1350696 Luca Bösch]
|float = right
}}
==Description==
A tool to efficiently formulate and save [[Outcomes|learning goals]]. This plugin is based off The Differentiator by Ian Byrd http://byrdseed.com/differentiator/.

[[File:Differentiator plugin 01.png|800px]]

==Languages available==
The 1.2 version of this plugin currently ships with the important words inside the templates shown in the following languages:
* English
* German
* Italian
* French
* International Spanish
* Mexican Spanish
* Portuguese

[[File:Differentiator plugin 01 fr.png|800px]]

If you would like to make a translation for another language (it will take you 2-3 hours working in a GoogleDocs spreadsheet document), please add a suggestion at https://github.com/lucaboesch/moodle-local_differentiator/issues .

==Plugin usage==
Once installed, you can use this plugin by going to 'Site administration > Courses > Differentiator'.

[[File:Differentiator plugin 03.png|400px]]

* As there is no navigation node created, you have got to direct your users to that address otherwise, eg. by a link in the footer or in a custom menu.
** In a localhost server the link should point to '''http://localhost/local/differentiator'''. You should substitute //localhost/ with your server's address.

==User tours available==
* When you install this plugin, there will be a file named ''differentiator_user_tour.json'' inside the ''moodle/local/differentiatior'' folder.
* You can add this file to your [[User tours]] collection.
** As an administrator, access 'User tours' from Site administration > Appearance > User tours > Import.
** Drag and drop the ''differentiator_user_tour.json'' file into the dotted lines box to add the tour and click on 'Save changes'.
* Make sure that the [[Multi-language content filter]] is activated in order to show the user tour in the supported languages listed above.
** Go to Site administration > Plugins > Filters > Manage filters and in the dropdown menu for multi-language content select 'On'.

[[File:Differentiator plugin 02.png|400px]]

[[es:Plugin local Diferenciador]]

Differentiator local plugin

2019-12-28T17:17:05Z

Finns: /* Plugin usage */

{{Infobox plugin
|type = Local plugin
|entry = https://moodle.org/plugins/local_differentiator
|tracker = https://github.com/lucaboesch/moodle-local_differentiator/issues
|discussion = https://moodle.org/plugins/local_differentiator
|maintainer = [https://moodle.org/user/profile.php?id=1350696 Luca Bösch]
|float = right
}}
==Description==
A tool to efficiently formulate and save [[Outcomes|learning goals]]. This plugin is based off The Differentiator by Ian Byrd http://byrdseed.com/differentiator/.

[[File:Differentiator plugin 01.png|800px]]

==Languages available==
The 1.1 version of this plugin currently ships with the important words inside the templates shown in the following languages:
* English
* German
* Italian
* French
* International Spanish
* Mexican Spanish

[[File:Differentiator plugin 01 fr.png|800px]]

If you would like to make a translation for another language (it will take you 2-3 hours working in a GoogleDocs spreadsheet document), please add a suggestion at https://github.com/lucaboesch/moodle-local_differentiator/issues .

==Plugin usage==
Once installed, you can use this plugin by going to 'Site administration > Courses > Differentiator'.

[[File:Differentiator plugin 03.png|400px]]

* As there is no navigation node created, you have got to direct your users to that address otherwise, eg. by a link in the footer or in a custom menu.
** In a localhost server the link should point to '''http://localhost/local/differentiator'''. You should substitute //localhost/ with your server's address.

==User tours available==
* When you install this plugin, there will be a file named ''differentiator_user_tour.json'' inside the ''moodle/local/differentiatior'' folder.
* You can add this file to your [[User tours]] collection.
** As an administrator, access 'User tours' from Site administration > Appearance > User tours > Import.
** Drag and drop the ''differentiator_user_tour.json'' file into the dotted lines box to add the tour and click on 'Save changes'.
* Make sure that the [[Multi-language content filter]] is activated in order to show the user tour in the supported languages listed above.
** Go to Site administration > Plugins > Filters > Manage filters and in the dropdown menu for multi-language content select 'On'.

[[File:Differentiator plugin 02.png|400px]]

[[es:Plugin local Diferenciador]]

mod/studentquiz/view

2019-12-05T09:30:52Z

Finns:

#REDIRECT [[StudentQuiz module]]

[[de:mod/studentquiz/view]]
[[es:mod/studentquiz/view]]

File:state new.svg

2019-11-16T17:01:06Z

Finns:

StudentQuiz module

2019-11-16T17:00:31Z

Finns:

{{Infobox plugin
|type = Activity
|entry = https://moodle.org/plugins/mod_studentquiz
|tracker = https://github.com/frankkoch/moodle-mod_studentquiz/issues
|discussion = https://moodle.org/plugins/mod_studentquiz
|maintainer = [https://moodle.org/user/profile.php?id=16927 Frank Koch]
|float = right
}}

This documentation is meant for everyone interested in the usage, management,
and development of the StudentQuiz Moodle Plugin.

=Introduction=
'''StudentQuiz''' is a plugin listed in the official Moodle Plugin Directory. While Moodle’s Quiz module allows teachers to define quizzes to be answered by students,
StudentQuiz moves a step further allowing students to construct questions themselves and to share these questions with their peers.

;Gamification: Using ranking points StudentQuiz motivates students to deliver high quality questions and to improve their learning progress.

;Constructivism: To answer a question is good, to construct a question is better! This way, knowledge is actively constructed by the learner, not passively received from the environment.

;Crowd-Sourcing: Each student can rate and comment the questions, which enables the cohort to control the quality of the question collection.

Even if a student contributes a few questions only, a larger cohort can easily build up an extensive question base. That is why StudentQuiz provides comprehensive filters to let students focus on the questions they want to work with.

Furthermore, teachers can moderate questions by approving or disapproving them. Teachers can also delete or hide unsuitable or wrong question.

=Student Manual=
Your teacher has created one or more StudentQuiz activities in a Moodle course you are enrolled. This manual explains the way you can use StudentQuiz activities to practice for exams or to revise course materials, how to contribute to the question pool and the formulas used to calculate your contribution, learning progress, and ranking within your peer group.

==Practice==
===Open Studentquiz===
To open a StudentQuiz go to your course. StudentQuiz activities are marked with a StudentQuiz icon.
[[File:studentquiz_icon.png|100px]]

Click on the desired StudentQuiz activity to open it. Now you are in the main view of this StudentQuiz.

If nobody has contributed any question yet, you only see a button to create a new question.

[[File:empty_studentquiz.png|800px]]

See [[StudentQuiz_module#Contribute|contribute]] for more information about contributing a question.

As soon as questions are available, the question bank displays all of them at the bottom half of the view.
[[File:studentquiz_overview.png|800px]]

===Actions===
The following actions are available to you:
* Create a new question with “Create new question” button
* Filter questions with the fast filter buttons or with the filter form behind the "Show more..." link
* De-/select questions by check-marking them
* Practice the selected questions with the “Start Quiz” button
* Sort questions by the different column headers
* Preview, edit or delete your own questions. Note, you cannot edit your question once it became approved or disapproved by the teacher.

===Table information===
The table of this view has various columns with different information:

* Checkbox, represents the check column. You can de-/select questions to practice them
* T, stands for Type and displays an image of the question type used for the given question
* S, stands for State and displays whether a teacher has approved or disapproved the question (✗ = not approved, ✓ = approved). Other states are [[Image:state_new.svg|16px|baseline]] = new and [[Image:state_changed.svg|16px|baseline]] = changed.
* Question, shows the question name
* Actions, doesn’t have a title, but it will show different icons depending the available actions (preview, edit, delete, hide)
* Created by, shows the question creator and the creation date. This field may be anonymized and not show the creator’s name
* Tags, shows tags assigned to a question
* My Attempts, shows the number of times this question has been answered and if the last attempt was correct or incorrect
* Difficulty, shows the difficulty of the particular questions, based on answers (from 0 = very simple to 1 = very difficult) * The amount of bolts is the difficulty for the logged in student (from 0 = very simple to 5 = very difficult) * The blue bar in the background is the difficulty for the respective peer group (from 0% = very simple to 100% = very difficult)
* Rating, shows ratings of a questions. * The amount of yellow stars is the rating given by the logged in student from 1 (= very poor) to 5 (= very good) * The blue bar in the background is the rating of the respective peer group
* C stands for Comments and displays the number of comments that have been made on that question

===Filter questions===
On the upper half, a filter section provides various filters to select sets of questions. This is especially recommended when a lot of questions have been added to this StudentQuiz. There are many more filtering options behind the "Show more..." link

Use filters to select the questions you want to practice.

===Start a quiz===
As soon as you are happy with your question selection, hit the “Start Quiz” button. StudentQuiz will start a Quiz with the selected questions for you. You can now answer questions and navigate through the set of questions.

While answering questions you might be required to rate and comment questions. See [[StudentQuiz_module#Rating a question|rating a question]] to learn more about rating .See [[StudentQuiz_module#Commenting a question|commenting a question]] to learn more about commenting.

==Contribute==
As a student you can contribute in various ways to the question pool of the StudentQuiz Activity in your course.

# Add a new question
# Rate a question
# Comment a question

===Adding a question===
To create a question, use the “Create new question” button. You can select from a variety of questions types; however, the teacher can restrict the available question types. You find more information about how to create the different question types in the Moodle Documentation [https://docs.moodle.org/en/Question_types].

[[File:moodle_existing_questiontypes.png|400px]]

===Rating a question===
If you practice on a question and the question is checked, it shows the answer and any feedback.

The first time you answer a question you will be asked to rate the question for its usefulness and suitability on a scale of 1 to 5 stars. Your teacher might have given you some guidance on what is considered to be a good question, but in the end it is you and your fellow students enrolled in the class that define the rating of the questions within StudentQuiz. The author of the question will receive ranking points based on your rating.

The yellow stars display your rating while the blue background displays the average number of stars given by your peer group.

The teacher can turn off the rating requirement. See [[StudentQuiz_module#Reports|reports]] to learn more about ranking points.

===Commenting a question===
If you practice on a question and the question is checked, it shows the answer and any feedback.

You can discuss the solution or the question in the comments. The author of the question will receive an email notification about your comment. The teacher has the option to make commenting questions mandatory.

==Evaluation Process==
Students from your peer group will rate and comment your questions. The teacher might also evaluate your questions. StudentQuiz provides the following processes:

===Evaluation from your peer group===
* Rating: The students from your peer group can rate your question after answering with stars (from 1 = very poor to 5 = very good). You are awarded with rating points for each star you're receiving from your peer group and the better the rating of your question, the more points you get. The blue background bar in the Rating column represents the average number of stars received by your peer group, while your own rating on your question appears as yellow stars. E.g., [[File:rating_bar.png|100px]] shows an average peer rating of about 2.8 stars, while the logged in user has assigned 4 stars.

* Comment: The students from your peer group can comment your question. You will receive an email-notification with the comment. As the author, you might want to reply with another comment within this question. All participants of your peer group can see comments.

===Evaluation from the teacher===
* Question State: A new question automatically receives the state "new". The teacher can alter the state of the question to "approve" or "disapprove". Once your question became approved or disapproved you cannot edit it anymore. If the teacher wants you to edit your question again, he/she can assign the "changed" state. As long as the question is in the state "new" or "changed" you can edit your question. In the following image Test Question 1 is in state "change", Test Question 2 in state "approved", Test Question 3 in state "disapproved", and Test Question 4 in state "new". Note that editing is not available for Questions 2 and 3.
[[File:question_states.png|900px]]

* Question visibility: The teacher might hide your question if he/she does not want it to be seen by the members of your peer group. As the author, you can still see this question greyed out and you can continue to preview, edit or delete it, but you will not receive any ranking points as long as this question is hidden. The teacher might also delete your question. In this case, the question is not available anymore and will not receive any ranking points for it. In the following image, Test Question 5 is "hidden" and therefore greyed out. Only the author and the teacher can see it. In contrast, Question 5 is visible to all users.
[[File:question_visibility.png|900px]]

==Learning Assistance==
The Learning Assistance gives you an overview of your contribution and learning progress.

The upper bar represents your learning progress. In the example below there are 13 questions in this StudentQuiz. Out of this you have answered 3 questions correctly, 2 questions incorrectly, and you have not yet provided an answer for 8 questions. Please note that you can answer a question multiple times, but only your last answer counts.

The lower bar represents your contribution progress. In the example below, you have contributed 4 questions to this StudentQuiz. Out of this 2 questions were approved by the teacher, 1 question was disapproved, and 1 question is still lacking an approval/disapproval by the teacher.

[[File:learning_assistance.png|300px]]

==Reports==
StudentQuiz also provides students with two different reports to compare yourself with your peer group. You can find the reports in the navigation:

[[File:studentquiz_navigation.png|150px]]

===Statistics===
The left column of the statistics report gives you an overview of your contribution and learning progress. For comparison, you see the averaged contribution and learning progress of your peer group in the right column.

[[File:studentquiz_statistics1.png|600px]]

===Ranking===
The ranking table might motivate students to challenge each other. The ranking table explains the calculus of the ranking points. The sum of all your ranking points determines your rank within your peer group.

[[File:studentquiz_ranking.png|600px]]

=Teacher Manual=
Your Moodle administrator has installed the StudentQuiz Plugin to your school’s Moodle Website. This guide explains how to create and configure a StudentQuiz activity within a Moodle course, how you can encourage and moderate your students to contribute question to the question pool, what statistics you can draw from your students' activities and how you can recycle the question pool of one course to another.

==Create a StudentQuiz Activity==
Creating a StudentQuiz activity has no difference to other activities. Go to your course and press on the “Turn editing on” button. Choose your topic where you want the new Student-Quiz activity and press “+ Add an activity or resource” on the right side.

[[File:studentquiz_add_activity.png]]

Choose StudentQuiz and press “Add”. Give a name to the new activity. You have the following options to configure the StudentQuiz activity.

==Configure a StudentQuiz Activity==
===Ranking Settings===
The Ranking Settings are important. You have some options that you can configure

[[File:ranking_settings.png|800px]]

; Make students anonymous : This option will prevent students from seeing the names of the question’s author. However, students will still see their own names on questions they created themselves. Teachers will always see the creator’s names.

; Publish new questions : This will make newly created questions visible to all students right away. Turn this option off if you want to approve questions before they become visible to the students.

; Created question factor : Points for each created question

; Approved question factor : Points for each approved question

; Rating factor : Points for each star received

; Latest correct answer factor : Points for each correct answer on the last attempt

; Latest wrong answer factor : Points for each wrong or partially wrong answer on the last attempt

; Exclude roles in ranking : If you do not want the teacher to show up in the ranking table, you can exclude the teacher role. You can do so with all other available user roles.

===Question Settings===
The Question Settings are also important. You have some options that you can configure

[[File:question_settings.png|900px]]

; Allowed question types : Here you can specify which types of questions one can add to this StudentQuiz.

; Enforce rating : This option requires a student to rate a question right after answering the question for the first time.

; Enforce commenting : This option requires a student to comment a question.

==Removing a StudentQuiz Activity==
Removing a StudentQuiz Activity can be done the same way as removing any other Moodle Activities. Go to your course and click on the “Turn editing on” button. Choose the StudentQuiz Activity you want to remove and press “Edit -> Delete”. Together with the StudentQuiz activity all associated questions will be deleted as well. You might want to save the questions into an export file first.

==Moderate==
===Moderate question state===
In the main view, students can only preview, edit or delete their own questions, while teachers can preview, edit and delete all questions. The "S"=State column has clickable icons, which allows teachers to change the state of a particular question. The "Change state" button also offers a bulk option to change the state of multiple questions at once.

A new question automatically receives the state "new". The teacher can alter the state of the question to "approve" or "disapprove". Once a question is approved or disapproved the author cannot edit it anymore. If the teacher wants the author to edit the question again, he/she can assign the "changed" state. As long as the question is in the state "new" or "changed" the author can edit the question. In the following image Test Question 1 is in state "change", Test Question 2 in state "approved", Test Question 3 in state "disapproved", and Test Question 4 in state "new".

[[File:studentquiz_overview2.png]]

===Moderate question visibility===
As a teacher, you might want to click the eye-icon to hide this question from students. The question is still visible to the teacher and the author but appears greyed out. The author can continue to preview, edit, or delete this question but he will not receive any points for it while it is not visible.

As a teacher, you might also want to delete a question. In this case, the question is not available anymore and the author loses the associated points.

In the following image, Test Question 5 is "hidden" and therefore greyed out. Only the author and the teacher can see it. In contrast, Question 4 is visible to all users.

[[File:studentquiz_overview3.png]]

==Evaluate==
===Statistics===
In the submenu “Statistics”, users can view their own statistics and see the community statistics.

[[File:studentquiz_statistics1.png|600px]]

===Ranking===
The Ranking page shows the calculus behind the ranking points. It is ordered descendent by the total of ranking points. From this numbers the teacher can derive the individual contribution progress and learning progress of each student. For further calculations, the data can be copied into a spreadsheet like Excel.

[[File:studentquiz_ranking1.png|600px]]

==Reuse==
===Question bank===
As a teacher, you get access to all question bank functions using the question bank in the StudentQuiz activity.

[[File:studentquiz_questionbank.png]]

Its main purpose is to get overview of all questions, for importing or exporting whole sets of questions and possibly to move around questions between categories. This view should not be used to edit questions, as it will not notify students of the applied changes.

StudentQuiz loads all questions from its question category and its subcategories. Thus, you can also move questions into subcategories of the StudentQuiz question category to organize the questions to your liking.

===Important===
Use the question bank in the StudentQuiz activity, otherwise you will not be in the context of StudentQuiz and you can’t see its question categories.

=Administrator Manual=
You are the Moodle administrator maintaining the Moodle installation of your institution. This guide explains the relevant procedures of installation and upgrades as well as the process of an uninstalling StudentQuiz.

==Install==
Download StudentQuiz from the [https://moodle.org/plugins/mod_studentquiz Moodle Plugin Directory] and install by going to the ‘Site administration -> Plugins -> Install’ plugins page. You can try StudentQuiz without installing on the [https://studentquiz.hsr.ch/moodle/ StudentQuiz Demo Page].

==Configure==
You can setup the ranking settings and question settings as site wide default values. The teacher can always overwrite these defaults in the settings of each StudentQuiz activity.

* For more information about ranking settings see [[StudentQuiz_module#Ranking Settings|Ranking Settings]].

* For more information about question settings see [[StudentQuiz_module#Question Settings|Question Settings]].

==Upgrade==
Manually, the same steps as install. Moodle also provides you a hint when there are new versions, once you logged in as admin or when you Open ‘Site administration > Notifications’

{{Note|We highly recommend you to read the [https://github.com/frankkoch/moodle-mod_studentquiz/releases release notes on github] for more insights about the changes.}}==Uninstall==
{{Note|Make sure all the questions have been backed up! One way to do this is to export them usind the moodle question bank, as removing or uninstalling the StudentQuiz activity also removes all questions in the same context.}}To uninstall the StudentQuiz Activity follow the navigation as follows: “Site administration -> Plugins -> Plugins overview”

Look for StudentQuiz and click “Uninstall”.

If “Uninstall” is not available, it means you are using the deprecated StudentQuiz Question Behaviour plugin prior to StudentQuiz 3.0. Remove the Question Behaviour plugin by deleting the directory your_moodle_directory/question/behaviour/studentquiz.

=Links=
* [https://moodle.org/plugins/mod_studentquiz Moodle Plugin Directory Page for StudentQuiz Plugin]
* [https://github.com/frankkoch/moodle-mod_studentquiz Github Repository of StudentQuiz Plugin]
* [https://www.travis-ci.org/frankkoch/moodle-mod_studentquiz Continuous Integration]
* [http://studentquiz.hsr.ch Live Demo Sandbox of StudentQuiz]
* [https://tube.switch.ch/videos/d91a8a0d StudenQuiz demo video] in YouTube

==See also==
* [[Hot Question]] - a Moodle plugin that can be used to better understand topics that a group collectively want to know more about. You ask participants to submit questions, or responses to a prompt, for example a recorded lecture, a topical issue, readings, revision class etc. Participants can then submit questions related to that topic, which appear in an ordered list (newest questions appear first). Participants then 'rate' others' questions by clicking a Thumbs Up icon - this gives the question / response heat. The more votes, the hotter the question and the higher up the list it will appear.

[[Category:Quiz]]
[[Category:Questions]]
[[Category:Contributed code]]

[[es:Módulo StudentQuiz]]
[[de:StudentQuiz]]

File:state changed.svg

2019-11-16T16:55:33Z

Finns:

StudentQuiz module

2019-11-15T16:03:14Z

Finns:

{{Infobox plugin
|type = Activity
|entry = https://moodle.org/plugins/mod_studentquiz
|tracker = https://github.com/frankkoch/moodle-mod_studentquiz/issues
|discussion = https://moodle.org/plugins/mod_studentquiz
|maintainer = [https://moodle.org/user/profile.php?id=16927 Frank Koch]
|float = right
}}

This documentation is meant for everyone interested in the usage, management,
and development of the StudentQuiz Moodle Plugin.

=Introduction=
'''StudentQuiz''' is a plugin listed in the official Moodle Plugin Directory. While Moodle’s Quiz module allows teachers to define quizzes to be answered by students,
StudentQuiz moves a step further allowing students to construct questions themselves and to share these questions with their peers.

;Gamification: Using ranking points StudentQuiz motivates students to deliver high quality questions and to improve their learning progress.

;Constructivism: To answer a question is good, to construct a question is better! This way, knowledge is actively constructed by the learner, not passively received from the environment.

;Crowd-Sourcing: Each student can rate and comment the questions, which enables the cohort to control the quality of the question collection.

Even if a student contributes a few questions only, a larger cohort can easily build up an extensive question base. That is why StudentQuiz provides comprehensive filters to let students focus on the questions they want to work with.

Furthermore, teachers can moderate questions by approving or disapproving them. Teachers can also delete or hide unsuitable or wrong question.

=Student Manual=
Your teacher has created one or more StudentQuiz activities in a Moodle course you are enrolled. This manual explains the way you can use StudentQuiz activities to practice for exams or to revise course materials, how to contribute to the question pool and the formulas used to calculate your contribution, learning progress, and ranking within your peer group.

==Practice==
===Open Studentquiz===
To open a StudentQuiz go to your course. StudentQuiz activities are marked with a StudentQuiz icon.
[[File:studentquiz_icon.png|100px]]

Click on the desired StudentQuiz activity to open it. Now you are in the main view of this StudentQuiz.

If nobody has contributed any question yet, you only see a button to create a new question.

[[File:empty_studentquiz.png|800px]]

See [[StudentQuiz_module#Contribute|contribute]] for more information about contributing a question.

As soon as questions are available, the question bank displays all of them at the bottom half of the view.
[[File:studentquiz_overview.png|800px]]

===Actions===
The following actions are available to you:
* Create a new question with “Create new question” button
* Filter questions with the fast filter buttons or with the filter form behind the "Show more..." link
* De-/select questions by check-marking them
* Practice the selected questions with the “Start Quiz” button
* Sort questions by the different column headers
* Preview, edit or delete your own questions. Note, you cannot edit your question once it became approved or disapproved by the teacher.

===Table information===
The table of this view has various columns with different information:

* Checkbox, represents the check column. You can de-/select questions to practice them
* T, stands for Type and displays an image of the question type used for the given question
* S, stands for State and displays whether a teacher has approved or disapproved the question (✗ = not approved, ✓ = approved). Other states are ⧠ = new and ⭯ = changed.
* Question, shows the question name
* Actions, doesn’t have a title, but it will show different icons depending the available actions (preview, edit, delete, hide)
* Created by, shows the question creator and the creation date. This field may be anonymized and not show the creator’s name
* Tags, shows tags assigned to a question
* My Attempts, shows the number of times this question has been answered and if the last attempt was correct or incorrect
* Difficulty, shows the difficulty of the particular questions, based on answers (from 0 = very simple to 1 = very difficult) * The amount of bolts is the difficulty for the logged in student (from 0 = very simple to 5 = very difficult) * The blue bar in the background is the difficulty for the respective peer group (from 0% = very simple to 100% = very difficult)
* Rating, shows ratings of a questions. * The amount of yellow stars is the rating given by the logged in student from 1 (= very poor) to 5 (= very good) * The blue bar in the background is the rating of the respective peer group
* C stands for Comments and displays the number of comments that have been made on that question

===Filter questions===
On the upper half, a filter section provides various filters to select sets of questions. This is especially recommended when a lot of questions have been added to this StudentQuiz. There are many more filtering options behind the "Show more..." link

Use filters to select the questions you want to practice.

===Start a quiz===
As soon as you are happy with your question selection, hit the “Start Quiz” button. StudentQuiz will start a Quiz with the selected questions for you. You can now answer questions and navigate through the set of questions.

While answering questions you might be required to rate and comment questions. See [[StudentQuiz_module#Rating a question|rating a question]] to learn more about rating .See [[StudentQuiz_module#Commenting a question|commenting a question]] to learn more about commenting.

==Contribute==
As a student you can contribute in various ways to the question pool of the StudentQuiz Activity in your course.

# Add a new question
# Rate a question
# Comment a question

===Adding a question===
To create a question, use the “Create new question” button. You can select from a variety of questions types; however, the teacher can restrict the available question types. You find more information about how to create the different question types in the Moodle Documentation [https://docs.moodle.org/en/Question_types].

[[File:moodle_existing_questiontypes.png|400px]]

===Rating a question===
If you practice on a question and the question is checked, it shows the answer and any feedback.

The first time you answer a question you will be asked to rate the question for its usefulness and suitability on a scale of 1 to 5 stars. Your teacher might have given you some guidance on what is considered to be a good question, but in the end it is you and your fellow students enrolled in the class that define the rating of the questions within StudentQuiz. The author of the question will receive ranking points based on your rating.

The yellow stars display your rating while the blue background displays the average number of stars given by your peer group.

The teacher can turn off the rating requirement. See [[StudentQuiz_module#Reports|reports]] to learn more about ranking points.

===Commenting a question===
If you practice on a question and the question is checked, it shows the answer and any feedback.

You can discuss the solution or the question in the comments. The author of the question will receive an email notification about your comment. The teacher has the option to make commenting questions mandatory.

==Evaluation Process==
Students from your peer group will rate and comment your questions. The teacher might also evaluate your questions. StudentQuiz provides the following processes:

===Evaluation from your peer group===
* Rating: The students from your peer group can rate your question after answering with stars (from 1 = very poor to 5 = very good). You are awarded with rating points for each star you're receiving from your peer group and the better the rating of your question, the more points you get. The blue background bar in the Rating column represents the average number of stars received by your peer group, while your own rating on your question appears as yellow stars. E.g., [[File:rating_bar.png|100px]] shows an average peer rating of about 2.8 stars, while the logged in user has assigned 4 stars.

* Comment: The students from your peer group can comment your question. You will receive an email-notification with the comment. As the author, you might want to reply with another comment within this question. All participants of your peer group can see comments.

===Evaluation from the teacher===
* Question State: A new question automatically receives the state "new". The teacher can alter the state of the question to "approve" or "disapprove". Once your question became approved or disapproved you cannot edit it anymore. If the teacher wants you to edit your question again, he/she can assign the "changed" state. As long as the question is in the state "new" or "changed" you can edit your question. In the following image Test Question 1 is in state "change", Test Question 2 in state "approved", Test Question 3 in state "disapproved", and Test Question 4 in state "new". Note that editing is not available for Questions 2 and 3.
[[File:question_states.png|900px]]

* Question visibility: The teacher might hide your question if he/she does not want it to be seen by the members of your peer group. As the author, you can still see this question greyed out and you can continue to preview, edit or delete it, but you will not receive any ranking points as long as this question is hidden. The teacher might also delete your question. In this case, the question is not available anymore and will not receive any ranking points for it. In the following image, Test Question 5 is "hidden" and therefore greyed out. Only the author and the teacher can see it. In contrast, Question 5 is visible to all users.
[[File:question_visibility.png|900px]]

==Learning Assistance==
The Learning Assistance gives you an overview of your contribution and learning progress.

The upper bar represents your learning progress. In the example below there are 13 questions in this StudentQuiz. Out of this you have answered 3 questions correctly, 2 questions incorrectly, and you have not yet provided an answer for 8 questions. Please note that you can answer a question multiple times, but only your last answer counts.

The lower bar represents your contribution progress. In the example below, you have contributed 4 questions to this StudentQuiz. Out of this 2 questions were approved by the teacher, 1 question was disapproved, and 1 question is still lacking an approval/disapproval by the teacher.

[[File:learning_assistance.png|300px]]

==Reports==
StudentQuiz also provides students with two different reports to compare yourself with your peer group. You can find the reports in the navigation:

[[File:studentquiz_navigation.png|150px]]

===Statistics===
The left column of the statistics report gives you an overview of your contribution and learning progress. For comparison, you see the averaged contribution and learning progress of your peer group in the right column.

[[File:studentquiz_statistics1.png|600px]]

===Ranking===
The ranking table might motivate students to challenge each other. The ranking table explains the calculus of the ranking points. The sum of all your ranking points determines your rank within your peer group.

[[File:studentquiz_ranking.png|600px]]

=Teacher Manual=
Your Moodle administrator has installed the StudentQuiz Plugin to your school’s Moodle Website. This guide explains how to create and configure a StudentQuiz activity within a Moodle course, how you can encourage and moderate your students to contribute question to the question pool, what statistics you can draw from your students' activities and how you can recycle the question pool of one course to another.

==Create a StudentQuiz Activity==
Creating a StudentQuiz activity has no difference to other activities. Go to your course and press on the “Turn editing on” button. Choose your topic where you want the new Student-Quiz activity and press “+ Add an activity or resource” on the right side.

[[File:studentquiz_add_activity.png]]

Choose StudentQuiz and press “Add”. Give a name to the new activity. You have the following options to configure the StudentQuiz activity.

==Configure a StudentQuiz Activity==
===Ranking Settings===
The Ranking Settings are important. You have some options that you can configure

[[File:ranking_settings.png|800px]]

; Make students anonymous : This option will prevent students from seeing the names of the question’s author. However, students will still see their own names on questions they created themselves. Teachers will always see the creator’s names.

; Publish new questions : This will make newly created questions visible to all students right away. Turn this option off if you want to approve questions before they become visible to the students.

; Created question factor : Points for each created question

; Approved question factor : Points for each approved question

; Rating factor : Points for each star received

; Latest correct answer factor : Points for each correct answer on the last attempt

; Latest wrong answer factor : Points for each wrong or partially wrong answer on the last attempt

; Exclude roles in ranking : If you do not want the teacher to show up in the ranking table, you can exclude the teacher role. You can do so with all other available user roles.

===Question Settings===
The Question Settings are also important. You have some options that you can configure

[[File:question_settings.png|900px]]

; Allowed question types : Here you can specify which types of questions one can add to this StudentQuiz.

; Enforce rating : This option requires a student to rate a question right after answering the question for the first time.

; Enforce commenting : This option requires a student to comment a question.

==Removing a StudentQuiz Activity==
Removing a StudentQuiz Activity can be done the same way as removing any other Moodle Activities. Go to your course and click on the “Turn editing on” button. Choose the StudentQuiz Activity you want to remove and press “Edit -> Delete”. Together with the StudentQuiz activity all associated questions will be deleted as well. You might want to save the questions into an export file first.

==Moderate==
===Moderate question state===
In the main view, students can only preview, edit or delete their own questions, while teachers can preview, edit and delete all questions. The "S"=State column has clickable icons, which allows teachers to change the state of a particular question. The "Change state" button also offers a bulk option to change the state of multiple questions at once.

A new question automatically receives the state "new". The teacher can alter the state of the question to "approve" or "disapprove". Once a question is approved or disapproved the author cannot edit it anymore. If the teacher wants the author to edit the question again, he/she can assign the "changed" state. As long as the question is in the state "new" or "changed" the author can edit the question. In the following image Test Question 1 is in state "change", Test Question 2 in state "approved", Test Question 3 in state "disapproved", and Test Question 4 in state "new".

[[File:studentquiz_overview2.png]]

===Moderate question visibility===
As a teacher, you might want to click the eye-icon to hide this question from students. The question is still visible to the teacher and the author but appears greyed out. The author can continue to preview, edit, or delete this question but he will not receive any points for it while it is not visible.

As a teacher, you might also want to delete a question. In this case, the question is not available anymore and the author loses the associated points.

In the following image, Test Question 5 is "hidden" and therefore greyed out. Only the author and the teacher can see it. In contrast, Question 4 is visible to all users.

[[File:studentquiz_overview3.png]]

==Evaluate==
===Statistics===
In the submenu “Statistics”, users can view their own statistics and see the community statistics.

[[File:studentquiz_statistics1.png|600px]]

===Ranking===
The Ranking page shows the calculus behind the ranking points. It is ordered descendent by the total of ranking points. From this numbers the teacher can derive the individual contribution progress and learning progress of each student. For further calculations, the data can be copied into a spreadsheet like Excel.

[[File:studentquiz_ranking1.png|600px]]

==Reuse==
===Question bank===
As a teacher, you get access to all question bank functions using the question bank in the StudentQuiz activity.

[[File:studentquiz_questionbank.png]]

Its main purpose is to get overview of all questions, for importing or exporting whole sets of questions and possibly to move around questions between categories. This view should not be used to edit questions, as it will not notify students of the applied changes.

StudentQuiz loads all questions from its question category and its subcategories. Thus, you can also move questions into subcategories of the StudentQuiz question category to organize the questions to your liking.

===Important===
Use the question bank in the StudentQuiz activity, otherwise you will not be in the context of StudentQuiz and you can’t see its question categories.

=Administrator Manual=
You are the Moodle administrator maintaining the Moodle installation of your institution. This guide explains the relevant procedures of installation and upgrades as well as the process of an uninstalling StudentQuiz.

==Install==
Download StudentQuiz from the [https://moodle.org/plugins/mod_studentquiz Moodle Plugin Directory] and install by going to the ‘Site administration -> Plugins -> Install’ plugins page. You can try StudentQuiz without installing on the [https://studentquiz.hsr.ch/moodle/ StudentQuiz Demo Page].

==Configure==
You can setup the ranking settings and question settings as site wide default values. The teacher can always overwrite these defaults in the settings of each StudentQuiz activity.

* For more information about ranking settings see [[StudentQuiz_module#Ranking Settings|Ranking Settings]].

* For more information about question settings see [[StudentQuiz_module#Question Settings|Question Settings]].

==Upgrade==
Manually, the same steps as install. Moodle also provides you a hint when there are new versions, once you logged in as admin or when you Open ‘Site administration > Notifications’

{{Note|We highly recommend you to read the [https://github.com/frankkoch/moodle-mod_studentquiz/releases release notes on github] for more insights about the changes.}}==Uninstall==
{{Note|Make sure all the questions have been backed up! One way to do this is to export them usind the moodle question bank, as removing or uninstalling the StudentQuiz activity also removes all questions in the same context.}}To uninstall the StudentQuiz Activity follow the navigation as follows: “Site administration -> Plugins -> Plugins overview”

Look for StudentQuiz and click “Uninstall”.

If “Uninstall” is not available, it means you are using the deprecated StudentQuiz Question Behaviour plugin prior to StudentQuiz 3.0. Remove the Question Behaviour plugin by deleting the directory your_moodle_directory/question/behaviour/studentquiz.

=Links=
* [https://moodle.org/plugins/mod_studentquiz Moodle Plugin Directory Page for StudentQuiz Plugin]
* [https://github.com/frankkoch/moodle-mod_studentquiz Github Repository of StudentQuiz Plugin]
* [https://www.travis-ci.org/frankkoch/moodle-mod_studentquiz Continuous Integration]
* [http://studentquiz.hsr.ch Live Demo Sandbox of StudentQuiz]
* [https://tube.switch.ch/videos/d91a8a0d StudenQuiz demo video] in YouTube

==See also==
* [[Hot Question]] - a Moodle plugin that can be used to better understand topics that a group collectively want to know more about. You ask participants to submit questions, or responses to a prompt, for example a recorded lecture, a topical issue, readings, revision class etc. Participants can then submit questions related to that topic, which appear in an ordered list (newest questions appear first). Participants then 'rate' others' questions by clicking a Thumbs Up icon - this gives the question / response heat. The more votes, the hotter the question and the higher up the list it will appear.

[[Category:Quiz]]
[[Category:Questions]]
[[Category:Contributed code]]

[[es:Módulo StudentQuiz]]
[[de:StudentQuiz]]

File:QuizQuickStart050.png

2019-11-06T07:42:31Z

Finns: Finns uploaded a new version of File:QuizQuickStart050.png

File:QuizQuickStart060.png

2019-11-06T07:41:38Z

Finns: Finns uploaded a new version of File:QuizQuickStart060.png

Quiz quick guide

2019-11-06T07:36:08Z

Finns: /* Add your questions */

{{Quiz}}
The Quiz is a very powerful activity that can meet many teaching needs, from simple, multiple-choice knowledge tests to complex, self-assessment tasks with detailed feedback. This quick guide gets you started, but if you really want to make the most of everything a Quiz can do, make sure you study the full '''[[Quiz activity]]''' documentation.
{{MediaPlayer | url = https://youtu.be/AcQETDptJro | desc = Quiz overview}}

__NOTOC__
==Before you start==
*A quiz is made up of two parts: (1) a set up page or 'front cover' where you add the criteria for the quiz, such as grading and time limits, and (2) the questions themselves. The questions are stored separately from your quiz in a course [[Question bank]]. This means you can reuse your questions in a later quiz. It also means you could display an empty quiz (a 'front cover' with no questions added) on your course page, so be careful!
*Some people prefer to make their quiz questions separately first and then add them to a quiz 'front cover' later. If you would like that, then look at the documentation on [[Question bank]] or just read on below until we get there!

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

[[File:QuizQuickStart030.png]]

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

To change some of those settings, read on:

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

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

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

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

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

1. Click the button 'Edit quiz'

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

[[File:quizquideaddquestion.png|200px]]

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

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

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

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

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

[[File:QuizQuickStart100.png]]

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

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

[[File:Quizpreviewedit.png]]

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

[[Category:Quick guide]]

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

File:quizquideaddquestion.png

2019-11-06T07:35:46Z

Finns: Finns uploaded a new version of File:quizquideaddquestion.png

Quiz quick guide

2019-11-06T07:31:55Z

Finns: /* Add your questions */

{{Quiz}}
The Quiz is a very powerful activity that can meet many teaching needs, from simple, multiple-choice knowledge tests to complex, self-assessment tasks with detailed feedback. This quick guide gets you started, but if you really want to make the most of everything a Quiz can do, make sure you study the full '''[[Quiz activity]]''' documentation.
{{MediaPlayer | url = https://youtu.be/AcQETDptJro | desc = Quiz overview}}

__NOTOC__
==Before you start==
*A quiz is made up of two parts: (1) a set up page or 'front cover' where you add the criteria for the quiz, such as grading and time limits, and (2) the questions themselves. The questions are stored separately from your quiz in a course [[Question bank]]. This means you can reuse your questions in a later quiz. It also means you could display an empty quiz (a 'front cover' with no questions added) on your course page, so be careful!
*Some people prefer to make their quiz questions separately first and then add them to a quiz 'front cover' later. If you would like that, then look at the documentation on [[Question bank]] or just read on below until we get there!

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

[[File:QuizQuickStart030.png]]

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

To change some of those settings, read on:

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

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

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

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

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

1. Click the button 'Edit quiz'

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

[[File:quizquideaddquestion.png]]

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

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

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

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

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

[[File:QuizQuickStart100.png]]

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

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

[[File:Quizpreviewedit.png]]

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

[[Category:Quick guide]]

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

Using Wiki

2019-11-05T12:49:23Z

Finns:

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

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

[[File:WikiFirstPage.png]]

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

*A page once created no longer has italics.

==Navigating page to page==
To navigate pages, you have to create your own hyperlinks. Fortunately it is easy. Copy the URL at the top of one page into a hyperlink on another page. Save your work and now when that hyperlink is activated, the Wiki goes to that page.

For example, if you have a table of contents, each entry can have a link to a respective page. From the other pages, you can have a return hyperlink back to the Table of Contents. Copy/paste the return hyperlink onto other pages and save time.

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

== Wiki editing in general ==

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

[[File:editingwiki.png]]

*The '''View''' tab allows users to display and view the wiki page.
*The '''Edit''' tab users to edit the wiki page.
*The '''Comments''' tab allows users to see and add comments about the wiki - providing comments are enabled on the site.
*The '''History''' tab allows users to see what has been altered in the wiki. Compare edits by clicking the "Compare Selected" button. Click the "Restore" button of the version you wish to restore if the latest edit is unsuitable

*The '''Map''' tab allows users to view areas of the wiki such as a list of pages, updated or orphaned pages etc. (Orphaned pages are pages not linked to anywhere.)
*To select what you want to see, click the Map menu dropdown box.
*The '''Files''' tab allows users to access any files which have been added to the wiki.Only the teacher role can by default add and manage files to the '''Files''' tab, but you can allow students to add and manage them with a permissions override to the '''Manage wiki files''' capability (mod/wiki:managefiles) in any particular wiki.
*The '''Administration''' tab is available to editing teachers in the course to delete page versions or selected pages. Clicking the "list all" button will list available pages to delete. The first page of the wiki cannot be deleted.

==Deleting pages==

Teachers and other users with the'' mod/wiki:managewiki'' capability can delete any page or page version, with the exception of the first page, via the Administration tab.

==Why use a wiki?==

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

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

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

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

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

== See also ==

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

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

error/quiz/notenoughrandomquestions

2019-10-24T13:52:52Z

Finns:

This error shows when there are not enough questions in the [[Question bank|question bank]] inside the requested [[Question categories|category]] (the particular quiz, the particular course, the course category or the system level), for a particular quiz in order to produce the requested [[Random question type|random question(s)]].

Please create more questions (in the appropriate quiz, course, course category, or system level) for this quiz, or remove the random questions from the quiz.

[[Category:Error]]

[[es:error/quiz/notenoughrandomquestions]]
[[de:error/quiz/notenoughrandomquestions]]

Capabilities/mod/lesson:manageoverrides

2019-10-18T21:49:58Z

Finns: Created page with "{{Capabilities}} *This allows a user manage Lesson overrides *This capability is allowed for the default roles of manager and teacher Assignment..."

{{Capabilities}}
*This allows a user manage [[Lesson]] overrides
*This capability is allowed for the default roles of manager and teacher

[[Category:Capabilities|Assignment]]
[[Category:Lesson]]

[[de:Capabilities/mod/assign:manageoverrides]]

Restrict access settings

2019-08-12T16:32:24Z

Finns: /* Restricting whole course section access */

{{Restrict access}}
==Enabling the use of restrict access sitewide==

To use the restrict access feature, it must be enabled by an administrator by checking the "Enable conditional access" box in ''Administration > Site administration > Advanced features''. A restrict access section will then appear for teachers on the Activity settings screen, with an 'Add restriction' button. This section applies to all activities and resources, and is the second to last section in each activities settings area, above [[Activity completion]] (if it has been turned on).

== Enabling or disabling specific restrictions==

In ''Site administration > Plugins > Availability restrictions > Manage restrictions'' you can enable or disable (Hide/Show)any of the individual restriction types for use throughout the site.

[[File:manageavailabilityrestrictions_m30.png]]

==Restricting activity access==

In the settings of each activity there is a Restrict Access section. To get to this, click 'Edit' alongside the activity you want to restrict and then choose 'Edit Settings', or add a new activity, which will bring you to the settings page.

In the 'Restrict Access' section of the activity settings page, click the 'Add restriction' button. A choice of conditions appears:

[[File:add restriction popup.png]]

Restriction can be based upon [[Activity completion]], date, grade, the group or grouping the students are in or even user profile fields. The 'Restriction set' button also allows for more complex criteria requiring nested conditions.

===Activity completion===
See [[Activity completion]]. Note that this button only appears if you have Activity completion enabled by the administrator in your site, and it is enabled in your course in ''Course administration > Edit settings > Completion tracking''.

===Date===
Access can be restricted from or until a certain date and time.

[[File:availabilityrestrictionbydatefromuntil_m30.png]]

===Grade===
You can specify a condition on any grade in the course: the full course grade, the grade for any activity, or a custom grade that you create manually. You can enter either a minimum value (at least percentage), a maximum value (less than percentage), both, or neither. The activity will only appear if the student has a value for the specified grade, and if it falls within any specified number range. You can add more than one grade condition. All conditions must be met in order for the activity to appear.

* The range numbers can be fractional (with up to five decimal places) if necessary.
* Be careful with the maximum value; if the maximum is 7, a student who scores exactly 7 will not see the activity. You could set it to 7.01 if you really wanted to include 7.
* If creating several different activities that appear according to grade ranges, use the same number for the maximum of one activity, and the minimum of the next. For example, you might create one activity with a maximum of 7 and another with a minimum of 7. The first would appear to everyone scoring between 0 and 6.99999, and the second would appear to everyone scoring 7.00000 to 10. This guarantees that everyone with a grade will see one or other.To remove a grade condition, set the assessment name to 'none' and remove the range number values
* If you want to use a condition for students with blank grades then you can add a grade restriction and select the activity you want to use as a restriction. Do not select a checkbox for either the greater than or less than criteria. This will require the student to have a grade. This means students with blank grades do not meet that criterion.

===Group and groupings===
If groups or groupings are used in the course, it is possible to restrict the activity to a certain group or grouping. If they are turned off for this course and not available, these options will not be present for use as an restriction.

[[File:grouprestrict.png]]

'''NOTE''': This button only appears if you have groups '''enabled''' in your course.

===User profile===

Access can be restricted using one of the following user fields:

* Address - This is the value in the 'address' column
* AIM ID - This is the value in the 'aim' column
* City/town - This is the value in the 'city' column
* Country - This is the two letter country code, NOT the name of the country.
* Department - This is the value in the 'department' column
* Email Address - This is the value in the 'email' column
* First name - This is the value in the 'firstname' column
* ICQ number - This is the value in the 'icq' column
* ID number - This is the value in the 'idnumber' column
* Institution - This is the value in the 'institution' column
* Mobile phone - This is the value in the 'phone2' column
* MSN ID - This is the value in the 'msn' column
* Phone - This is the value in the 'phone1' column
* Skype ID - This is the value in the 'skype' column
* Surname - This is the value in the 'lastname' column
* Web page - This is the value in the 'url' column
* Yahoo ID - This is the value in the 'yahoo' column

===Restriction set===
This allows you to add a set of complex restrictions to apply complex logic. See [[Using restrict access]] for an example.

==Hiding the conditions==
*If the eye is SHUT then students who do not meet that part of the condition will not see the activity at all.
*If the eye is OPEN the students who do not meet that part of the condition will see the activity but it will be greyed out and have information about why they can't access it yet.

The shut eye takes precedence. For example, you could have 2 conditions, one based on date (with eye shut) and one based on completing a previous activity (with eye open). That way, the activity will not appear at all until the date; then it will appear, but tell you that you need to complete the other activity; then when you complete the other activity you can access it.

For OR and NOT AND type conditions, you only get a single eye icon instead of one for each condition

[[File:daterestrict1.png]]

==ALL or ANY Conditions==
Further restrictions may be added by clicking the 'Add restriction' button again, and it is possible to specify that ALL the conditions or ANY of the conditions are required before the activity is made available. Thus, it is possible to use 'Or' as well as 'And' conditions. See [[Using Conditional activities]] for an example.

{|
|[[File:AND.png|thumb|400px|'and' condition]]
|[[File:OR.png|thumb|400px|'or' condition]]
|}

==Restricting whole course section access==

It is possible to restrict access to activities and resources within a whole course section by specifying the conditions in the settings for that particular section. Do this by editing the section settings in ''Topic menu > Edit topic > Restrict access''.

[[File:sectiontopicrestrictaccess_m30.png|500px]]

[[de:Einstellungen zur bedingten Verfügbarkeit]]
[[es:Configuraciones de actividades condicionales]]

File:sectiontopicrestrictaccess m30.png

2019-08-12T16:31:42Z

Finns: Finns uploaded a new version of File:sectiontopicrestrictaccess m30.png

Screenshot of Section / Topic access restriction setting in Moodle 3.0

File:calendar block showing 3 day event.png

2019-08-12T15:17:40Z

Finns: Finns uploaded a new version of File:calendar block showing 3 day event.png

Using Calendar

2019-08-12T15:12:02Z

Finns: /* Calendar export */

{{Calendar}}
==Adding an event==

To add a calendar event:
# Click month on Calendar to get an expanded month view
# In Calendar view click the New Event button
# On a New Event page select the type of event
* A '''User Event''' will only be visible by the user currently logged in (i.e. the one creating the event)
* A '''Group Event''' will be visible to a particular Group on the course (chosen from a drop-down list)
[[File:groupcalendar.png|thumb|Group icon and details]]
Group events will display a group icon in the calendar block and in the event page, the name of the group will be visible next to the event title:

* A '''Course Event''' will be visible to participants on the course in question. Only users with the capability to manage calendar entries at the course level can add course events.
* A '''Site Event''' is a "global" event - visible in every course and on the calendar on the home page. Only users with the capability to manage calendar entries at the system level can add site events.
# Set the event properties
# Click Save changes

The different types of events can be visually filtered.

For example, if you (as a teacher) wanted to hide Group event dates (events assigned to learner Groups you create), click "Group events" on the bottom of the Calendar. This would hide all group events, and the color code would disappear from the link on the calendar. To show the events again, click the Group Events link again. This can make the calendar easier to read (especially if there are many events on the calendar).
[[File:calendar block showing 3 day event.png|thumb|Calendar block showing an event with duration of 3 days]]
Other features
* Adding closing dates to course activities — [[Assignment module|assignments]], [[Quiz module|quizzes]] etc. will cause them to show up in the [[Calendar block|calendar block]] as course events.
*View previous or future months.
*Current date is outlined.
* The duration of an event lasting more than one day is indicated.

==Calendar export==

Moodle allows users to export calendars so they may be imported into other calendar programs, as a backup or to create a copy. The Moodle export process creates an ics file

There are two ways to create the ics file: creating an ics file for immediate downloading to a computer, or creating a url link that will create a defined calendar from a link without actually logging into the site.

[[Image:Calendar Export-iCal buttons.jpg|300px|right]]
At the bottom of a calendar page you will see the "Export calendar" and "iCal" links.

===iCal quick link===
Click on the "iCal" link at the bottom of the Moodle calendar to show a "Opening icalexport.ics" popup window. Here you can save the file to your local computer or open it with MS Outlook.
:Note: you cannot select individual items to include in the exported file with iCal, all events will be included.

===Export options for an ics file===
Click on the "Export calendar" button at the bottom of a calendar will bring you to the Export page with options.

[[Image:exportcalendar.png|500px]]

#Select "All events" or "Events related to courses"
#Select the time frame: "This week", "This month", "Recent and next 60 days" or a custom range. The range can be set from ''Administration>Site administration>Appearance>Calendar'' by the page administrator.

Now you have a choice to create an icalexport.ics file or to create a url that will create the icslexport.ics file via a link.

Click on the "Export" button will bring up a "Opening icalexport.ics" popup window. Either save the file or have MS Outlook open the file directly.

===URL file===
After pressing the "Export calendar" button at the bottom of the calendar page, select the events and time frames you wish. The "Get URL address" button will create a URL address. Copy and paste the url link into an email or any HTML page. This link will compile the icalexport.ics file. For example: 
:<nowiki>http://demo.moodle.net/calendar/export_execute.php?preset_what=courses&preset_time=recentupcoming&username=teacher&authtoken=35b0202e4f270c4cc9864e46dad56cb0c90ed382</nowiki>

==Importing Moodle calendar into other calendars==

===Mozilla Thunderbird/Lightning ===

* Enter into calendar mode by clicking the Calendar icon at the bottom-right of the client
* Click Calendar -> Import... then locate the exported iCal file

Note: changing an event in Thunderbird/Lightning will not change the event in a Moodle calendar as well, you must do that yourself.

===Subscribing to a calendar in Outlook 2007===
If you use an Outlook 2007 calendar, you can have your Moodle calendar events overlaid on top (or placed side by side) by following these steps:

#Go to the calendar view in your Moodle install and find the orange ical icon at the bottom and right click it, choosing "copy link location". This link will permanently subscribe to the calendar events for the currently logged in user.
#Open Outlook 2007 and go to Tools->account settings->internet calendars->new.
#Paste in the address you copied from Moodle.
#Click OK and close.
#You should now see another calendar available on the left hand calendar bar, underneath 'My Calendars'. Enable this and Outlook will update the calendar every time it opens.
#Right-click on the tabs to choose between 'side by side mode' and 'overlay mode'.

===Google calendar===

====Dynamic Link to Moodle Calendar====
In Moodle, after pressing the "Export calendar" button at the bottom of the calendar page, select the events and time frames you wish. The "Get URL address" button will create a URL address.

In Google Calendar's "Other calendars" menu, choose "Add by URL" and supply the URL generated in the process described above. This version of the Google calendar will update whenever changes are made in the source Moodle calendar (including new, changed or deleted events), although it may take several hours for the changes to appear.

Note that this may be more or less useful. The calendar will be relative to the Moodle user. That is, if the user who generates the URL is enrolled in several courses, it is this information that will appear in the calendar. There is no way (at this time) to generate a URL that only applies to one course.

====One-time import (future updates in Moodle won't appear)====
In Moodle create an export file (icalexport.ics, as detailed above) and save it on your computer.

In Google Calendar, use the settings link (usually near the sign out and help links) and select the settings tab. This will bring up the "Import Calendar" pop up window. Select the file to import and the Google Calendar the file should be imported into. Note that this method doesn't allow new (or modified) events from the Moodle calendar to appear in the Google calendar, unless you repeat this process. See the Dynamic Link method above.

==Importing multiple events==

See [[Calendar import]] for details of how to import external calendars (such as Google Calendar, or a calendar from another Moodle site) into Moodle's calendar.

==List format==
The calendar displays event lists one day at a time. There is no capacity to display a list of all site or course events over an extended period. To obtain date lists for publications, the only option is to link directly to the SQL database, select by the "courseid" and perform calculations to convert the UNIX "timestart" to a publishable date format:

Using a Microsoft Access query, collect data from the '''mdl_event''' table and create 2 calculated fields:

*'''calcdate''': DateValue("1/1/1970")+[timestart]/60/60/24+10/24
*'''daysavdate''': IIf([calcdate] Between #2/04/2006# And #29/10/2006#,[calcdate],[calcdate]+1/24)

Then, use additional calculated fields to separate the date, day of week and time (if needing to be formatted separately:

*Dte: Format([daysavdate],"mmm dd")
*DayName: Format([daysavdate],"ddd")
*Tme: Format([daysavdate],"hh:nn am/pm")

:''TIP:'' The dates for daylight saving need to be changed each year to match your location.
:''TIP:'' Very brief summary process for creating connection to moodle database in Windows environment: Install MySQL [[ODBC]] Driver 3.51 / Start settings control panel / admin tools/ Data Sources/ ODBC / add new service/ select MySQL ODBC driver/ follow prompts for User & password/ open access/ get external data/ point to MySQL ODBC connection

==Navigating months==
There is no easy way to jump to a specific month in the year other than to directly edit the URL variable for month "m=" : calendar/view.php?view=month&cal_d=1&cal_'''m=02'''&cal_y=2006

==Display current day events==

Use link: http://moodle.org/calendar/view.php?view=day

==See also==

*[[Calendar block]]
*[[Upcoming events block]]
*[[Calendar editor role]]

[[de:Kalender nutzen]]
[[es:Uso del Calendario]]
[[fr:Utiliser le Calendrier]]

File:Calendar Export-iCal buttons.jpg

2019-08-12T15:11:17Z

Finns: Finns uploaded a new version of File:Calendar Export-iCal buttons.jpg

Using Calendar

2019-08-12T15:06:22Z

Finns: /* Export options for an ics file */

{{Calendar}}
==Adding an event==

To add a calendar event:
# Click month on Calendar to get an expanded month view
# In Calendar view click the New Event button
# On a New Event page select the type of event
* A '''User Event''' will only be visible by the user currently logged in (i.e. the one creating the event)
* A '''Group Event''' will be visible to a particular Group on the course (chosen from a drop-down list)
[[File:groupcalendar.png|thumb|Group icon and details]]
Group events will display a group icon in the calendar block and in the event page, the name of the group will be visible next to the event title:

* A '''Course Event''' will be visible to participants on the course in question. Only users with the capability to manage calendar entries at the course level can add course events.
* A '''Site Event''' is a "global" event - visible in every course and on the calendar on the home page. Only users with the capability to manage calendar entries at the system level can add site events.
# Set the event properties
# Click Save changes

The different types of events can be visually filtered.

For example, if you (as a teacher) wanted to hide Group event dates (events assigned to learner Groups you create), click "Group events" on the bottom of the Calendar. This would hide all group events, and the color code would disappear from the link on the calendar. To show the events again, click the Group Events link again. This can make the calendar easier to read (especially if there are many events on the calendar).
[[File:calendar block showing 3 day event.png|thumb|Calendar block showing an event with duration of 3 days]]
Other features
* Adding closing dates to course activities — [[Assignment module|assignments]], [[Quiz module|quizzes]] etc. will cause them to show up in the [[Calendar block|calendar block]] as course events.
*View previous or future months.
*Current date is outlined.
* The duration of an event lasting more than one day is indicated.

==Calendar export==

Moodle allows users to export calendars so they may be imported into other calendar programs, as a backup or to create a copy. The Moodle export process creates an ics file

There are two ways to create the ics file: creating an ics file for immediate downloading to a computer, or creating a url link that will create a defined calendar from a link without actually logging into the site.

[[Image:Calendar Export-iCal buttons.jpg|right]]
At the bottom of a calendar page you will see the "Export calendar" and "iCal" links.

===iCal quick link===
Click on the "iCal" link at the bottom of the Moodle calendar to show a "Opening icalexport.ics" popup window. Here you can save the file to your local computer or open it with MS Outlook.
:Note: you cannot select individual items to include in the exported file with iCal, all events will be included.

===Export options for an ics file===
Click on the "Export calendar" button at the bottom of a calendar will bring you to the Export page with options.

[[Image:exportcalendar.png|500px]]

#Select "All events" or "Events related to courses"
#Select the time frame: "This week", "This month", "Recent and next 60 days" or a custom range. The range can be set from ''Administration>Site administration>Appearance>Calendar'' by the page administrator.

Now you have a choice to create an icalexport.ics file or to create a url that will create the icslexport.ics file via a link.

Click on the "Export" button will bring up a "Opening icalexport.ics" popup window. Either save the file or have MS Outlook open the file directly.

===URL file===
After pressing the "Export calendar" button at the bottom of the calendar page, select the events and time frames you wish. The "Get URL address" button will create a URL address. Copy and paste the url link into an email or any HTML page. This link will compile the icalexport.ics file. For example: 
:<nowiki>http://demo.moodle.net/calendar/export_execute.php?preset_what=courses&preset_time=recentupcoming&username=teacher&authtoken=35b0202e4f270c4cc9864e46dad56cb0c90ed382</nowiki>

==Importing Moodle calendar into other calendars==

===Mozilla Thunderbird/Lightning ===

* Enter into calendar mode by clicking the Calendar icon at the bottom-right of the client
* Click Calendar -> Import... then locate the exported iCal file

Note: changing an event in Thunderbird/Lightning will not change the event in a Moodle calendar as well, you must do that yourself.

===Subscribing to a calendar in Outlook 2007===
If you use an Outlook 2007 calendar, you can have your Moodle calendar events overlaid on top (or placed side by side) by following these steps:

#Go to the calendar view in your Moodle install and find the orange ical icon at the bottom and right click it, choosing "copy link location". This link will permanently subscribe to the calendar events for the currently logged in user.
#Open Outlook 2007 and go to Tools->account settings->internet calendars->new.
#Paste in the address you copied from Moodle.
#Click OK and close.
#You should now see another calendar available on the left hand calendar bar, underneath 'My Calendars'. Enable this and Outlook will update the calendar every time it opens.
#Right-click on the tabs to choose between 'side by side mode' and 'overlay mode'.

===Google calendar===

====Dynamic Link to Moodle Calendar====
In Moodle, after pressing the "Export calendar" button at the bottom of the calendar page, select the events and time frames you wish. The "Get URL address" button will create a URL address.

In Google Calendar's "Other calendars" menu, choose "Add by URL" and supply the URL generated in the process described above. This version of the Google calendar will update whenever changes are made in the source Moodle calendar (including new, changed or deleted events), although it may take several hours for the changes to appear.

Note that this may be more or less useful. The calendar will be relative to the Moodle user. That is, if the user who generates the URL is enrolled in several courses, it is this information that will appear in the calendar. There is no way (at this time) to generate a URL that only applies to one course.

====One-time import (future updates in Moodle won't appear)====
In Moodle create an export file (icalexport.ics, as detailed above) and save it on your computer.

In Google Calendar, use the settings link (usually near the sign out and help links) and select the settings tab. This will bring up the "Import Calendar" pop up window. Select the file to import and the Google Calendar the file should be imported into. Note that this method doesn't allow new (or modified) events from the Moodle calendar to appear in the Google calendar, unless you repeat this process. See the Dynamic Link method above.

==Importing multiple events==

See [[Calendar import]] for details of how to import external calendars (such as Google Calendar, or a calendar from another Moodle site) into Moodle's calendar.

==List format==
The calendar displays event lists one day at a time. There is no capacity to display a list of all site or course events over an extended period. To obtain date lists for publications, the only option is to link directly to the SQL database, select by the "courseid" and perform calculations to convert the UNIX "timestart" to a publishable date format:

Using a Microsoft Access query, collect data from the '''mdl_event''' table and create 2 calculated fields:

*'''calcdate''': DateValue("1/1/1970")+[timestart]/60/60/24+10/24
*'''daysavdate''': IIf([calcdate] Between #2/04/2006# And #29/10/2006#,[calcdate],[calcdate]+1/24)

Then, use additional calculated fields to separate the date, day of week and time (if needing to be formatted separately:

*Dte: Format([daysavdate],"mmm dd")
*DayName: Format([daysavdate],"ddd")
*Tme: Format([daysavdate],"hh:nn am/pm")

:''TIP:'' The dates for daylight saving need to be changed each year to match your location.
:''TIP:'' Very brief summary process for creating connection to moodle database in Windows environment: Install MySQL [[ODBC]] Driver 3.51 / Start settings control panel / admin tools/ Data Sources/ ODBC / add new service/ select MySQL ODBC driver/ follow prompts for User & password/ open access/ get external data/ point to MySQL ODBC connection

==Navigating months==
There is no easy way to jump to a specific month in the year other than to directly edit the URL variable for month "m=" : calendar/view.php?view=month&cal_d=1&cal_'''m=02'''&cal_y=2006

==Display current day events==

Use link: http://moodle.org/calendar/view.php?view=day

==See also==

*[[Calendar block]]
*[[Upcoming events block]]
*[[Calendar editor role]]

[[de:Kalender nutzen]]
[[es:Uso del Calendario]]
[[fr:Utiliser le Calendrier]]

Using Calendar

2019-08-12T15:05:17Z

Finns: /* Export options for an ics file */

{{Calendar}}
==Adding an event==

To add a calendar event:
# Click month on Calendar to get an expanded month view
# In Calendar view click the New Event button
# On a New Event page select the type of event
* A '''User Event''' will only be visible by the user currently logged in (i.e. the one creating the event)
* A '''Group Event''' will be visible to a particular Group on the course (chosen from a drop-down list)
[[File:groupcalendar.png|thumb|Group icon and details]]
Group events will display a group icon in the calendar block and in the event page, the name of the group will be visible next to the event title:

* A '''Course Event''' will be visible to participants on the course in question. Only users with the capability to manage calendar entries at the course level can add course events.
* A '''Site Event''' is a "global" event - visible in every course and on the calendar on the home page. Only users with the capability to manage calendar entries at the system level can add site events.
# Set the event properties
# Click Save changes

The different types of events can be visually filtered.

For example, if you (as a teacher) wanted to hide Group event dates (events assigned to learner Groups you create), click "Group events" on the bottom of the Calendar. This would hide all group events, and the color code would disappear from the link on the calendar. To show the events again, click the Group Events link again. This can make the calendar easier to read (especially if there are many events on the calendar).
[[File:calendar block showing 3 day event.png|thumb|Calendar block showing an event with duration of 3 days]]
Other features
* Adding closing dates to course activities — [[Assignment module|assignments]], [[Quiz module|quizzes]] etc. will cause them to show up in the [[Calendar block|calendar block]] as course events.
*View previous or future months.
*Current date is outlined.
* The duration of an event lasting more than one day is indicated.

==Calendar export==

Moodle allows users to export calendars so they may be imported into other calendar programs, as a backup or to create a copy. The Moodle export process creates an ics file

There are two ways to create the ics file: creating an ics file for immediate downloading to a computer, or creating a url link that will create a defined calendar from a link without actually logging into the site.

[[Image:Calendar Export-iCal buttons.jpg|right]]
At the bottom of a calendar page you will see the "Export calendar" and "iCal" links.

===iCal quick link===
Click on the "iCal" link at the bottom of the Moodle calendar to show a "Opening icalexport.ics" popup window. Here you can save the file to your local computer or open it with MS Outlook.
:Note: you cannot select individual items to include in the exported file with iCal, all events will be included.

===Export options for an ics file===
Click on the "Export calendar" button at the bottom of a calendar will bring you to the Export page with options.

[[Image:exportcalendar.png|500px]]

#Select "All events" or "Events related to courses"
#Select the time frame: "This week", "This month", "Recent and next 60 days" or a custom range. The range can be set from ''Administration>Site administration>Appearance>Calendar.''

Now you have a choice to create an icalexport.ics file or to create a url that will create the icslexport.ics file via a link.

Click on the "Export" button will bring up a "Opening icalexport.ics" popup window. Either save the file or have MS Outlook open the file directly.

===URL file===
After pressing the "Export calendar" button at the bottom of the calendar page, select the events and time frames you wish. The "Get URL address" button will create a URL address. Copy and paste the url link into an email or any HTML page. This link will compile the icalexport.ics file. For example: 
:<nowiki>http://demo.moodle.net/calendar/export_execute.php?preset_what=courses&preset_time=recentupcoming&username=teacher&authtoken=35b0202e4f270c4cc9864e46dad56cb0c90ed382</nowiki>

==Importing Moodle calendar into other calendars==

===Mozilla Thunderbird/Lightning ===

* Enter into calendar mode by clicking the Calendar icon at the bottom-right of the client
* Click Calendar -> Import... then locate the exported iCal file

Note: changing an event in Thunderbird/Lightning will not change the event in a Moodle calendar as well, you must do that yourself.

===Subscribing to a calendar in Outlook 2007===
If you use an Outlook 2007 calendar, you can have your Moodle calendar events overlaid on top (or placed side by side) by following these steps:

#Go to the calendar view in your Moodle install and find the orange ical icon at the bottom and right click it, choosing "copy link location". This link will permanently subscribe to the calendar events for the currently logged in user.
#Open Outlook 2007 and go to Tools->account settings->internet calendars->new.
#Paste in the address you copied from Moodle.
#Click OK and close.
#You should now see another calendar available on the left hand calendar bar, underneath 'My Calendars'. Enable this and Outlook will update the calendar every time it opens.
#Right-click on the tabs to choose between 'side by side mode' and 'overlay mode'.

===Google calendar===

====Dynamic Link to Moodle Calendar====
In Moodle, after pressing the "Export calendar" button at the bottom of the calendar page, select the events and time frames you wish. The "Get URL address" button will create a URL address.

In Google Calendar's "Other calendars" menu, choose "Add by URL" and supply the URL generated in the process described above. This version of the Google calendar will update whenever changes are made in the source Moodle calendar (including new, changed or deleted events), although it may take several hours for the changes to appear.

Note that this may be more or less useful. The calendar will be relative to the Moodle user. That is, if the user who generates the URL is enrolled in several courses, it is this information that will appear in the calendar. There is no way (at this time) to generate a URL that only applies to one course.

====One-time import (future updates in Moodle won't appear)====
In Moodle create an export file (icalexport.ics, as detailed above) and save it on your computer.

In Google Calendar, use the settings link (usually near the sign out and help links) and select the settings tab. This will bring up the "Import Calendar" pop up window. Select the file to import and the Google Calendar the file should be imported into. Note that this method doesn't allow new (or modified) events from the Moodle calendar to appear in the Google calendar, unless you repeat this process. See the Dynamic Link method above.

==Importing multiple events==

See [[Calendar import]] for details of how to import external calendars (such as Google Calendar, or a calendar from another Moodle site) into Moodle's calendar.

==List format==
The calendar displays event lists one day at a time. There is no capacity to display a list of all site or course events over an extended period. To obtain date lists for publications, the only option is to link directly to the SQL database, select by the "courseid" and perform calculations to convert the UNIX "timestart" to a publishable date format:

Using a Microsoft Access query, collect data from the '''mdl_event''' table and create 2 calculated fields:

*'''calcdate''': DateValue("1/1/1970")+[timestart]/60/60/24+10/24
*'''daysavdate''': IIf([calcdate] Between #2/04/2006# And #29/10/2006#,[calcdate],[calcdate]+1/24)

Then, use additional calculated fields to separate the date, day of week and time (if needing to be formatted separately:

*Dte: Format([daysavdate],"mmm dd")
*DayName: Format([daysavdate],"ddd")
*Tme: Format([daysavdate],"hh:nn am/pm")

:''TIP:'' The dates for daylight saving need to be changed each year to match your location.
:''TIP:'' Very brief summary process for creating connection to moodle database in Windows environment: Install MySQL [[ODBC]] Driver 3.51 / Start settings control panel / admin tools/ Data Sources/ ODBC / add new service/ select MySQL ODBC driver/ follow prompts for User & password/ open access/ get external data/ point to MySQL ODBC connection

==Navigating months==
There is no easy way to jump to a specific month in the year other than to directly edit the URL variable for month "m=" : calendar/view.php?view=month&cal_d=1&cal_'''m=02'''&cal_y=2006

==Display current day events==

Use link: http://moodle.org/calendar/view.php?view=day

==See also==

*[[Calendar block]]
*[[Upcoming events block]]
*[[Calendar editor role]]

[[de:Kalender nutzen]]
[[es:Uso del Calendario]]
[[fr:Utiliser le Calendrier]]

Using Calendar

2019-08-12T15:04:21Z

Finns: /* Export options for an ics file */

{{Calendar}}
==Adding an event==

To add a calendar event:
# Click month on Calendar to get an expanded month view
# In Calendar view click the New Event button
# On a New Event page select the type of event
* A '''User Event''' will only be visible by the user currently logged in (i.e. the one creating the event)
* A '''Group Event''' will be visible to a particular Group on the course (chosen from a drop-down list)
[[File:groupcalendar.png|thumb|Group icon and details]]
Group events will display a group icon in the calendar block and in the event page, the name of the group will be visible next to the event title:

* A '''Course Event''' will be visible to participants on the course in question. Only users with the capability to manage calendar entries at the course level can add course events.
* A '''Site Event''' is a "global" event - visible in every course and on the calendar on the home page. Only users with the capability to manage calendar entries at the system level can add site events.
# Set the event properties
# Click Save changes

The different types of events can be visually filtered.

For example, if you (as a teacher) wanted to hide Group event dates (events assigned to learner Groups you create), click "Group events" on the bottom of the Calendar. This would hide all group events, and the color code would disappear from the link on the calendar. To show the events again, click the Group Events link again. This can make the calendar easier to read (especially if there are many events on the calendar).
[[File:calendar block showing 3 day event.png|thumb|Calendar block showing an event with duration of 3 days]]
Other features
* Adding closing dates to course activities — [[Assignment module|assignments]], [[Quiz module|quizzes]] etc. will cause them to show up in the [[Calendar block|calendar block]] as course events.
*View previous or future months.
*Current date is outlined.
* The duration of an event lasting more than one day is indicated.

==Calendar export==

Moodle allows users to export calendars so they may be imported into other calendar programs, as a backup or to create a copy. The Moodle export process creates an ics file

There are two ways to create the ics file: creating an ics file for immediate downloading to a computer, or creating a url link that will create a defined calendar from a link without actually logging into the site.

[[Image:Calendar Export-iCal buttons.jpg|right]]
At the bottom of a calendar page you will see the "Export calendar" and "iCal" links.

===iCal quick link===
Click on the "iCal" link at the bottom of the Moodle calendar to show a "Opening icalexport.ics" popup window. Here you can save the file to your local computer or open it with MS Outlook.
:Note: you cannot select individual items to include in the exported file with iCal, all events will be included.

===Export options for an ics file===
Click on the "Export calendar" button at the bottom of a calendar will bring you to the Export page with options.

[[Image:exportcalendar.png|500px]]

#Select "All events" or "Events related to courses"
#Select the time frame: "This week", "This month", "Recent and next 60 days" or a custom range (new in 2.5). The range can be set from ''Administration>Site administration>Appearance>Calendar.''

Now you have a choice to create an icalexport.ics file or to create a url that will create the icslexport.ics file via a link.

Click on the "Export" button will bring up a "Opening icalexport.ics" popup window. Either save the file or have MS Outlook open the file directly.

===URL file===
After pressing the "Export calendar" button at the bottom of the calendar page, select the events and time frames you wish. The "Get URL address" button will create a URL address. Copy and paste the url link into an email or any HTML page. This link will compile the icalexport.ics file. For example: 
:<nowiki>http://demo.moodle.net/calendar/export_execute.php?preset_what=courses&preset_time=recentupcoming&username=teacher&authtoken=35b0202e4f270c4cc9864e46dad56cb0c90ed382</nowiki>

==Importing Moodle calendar into other calendars==

===Mozilla Thunderbird/Lightning ===

* Enter into calendar mode by clicking the Calendar icon at the bottom-right of the client
* Click Calendar -> Import... then locate the exported iCal file

Note: changing an event in Thunderbird/Lightning will not change the event in a Moodle calendar as well, you must do that yourself.

===Subscribing to a calendar in Outlook 2007===
If you use an Outlook 2007 calendar, you can have your Moodle calendar events overlaid on top (or placed side by side) by following these steps:

#Go to the calendar view in your Moodle install and find the orange ical icon at the bottom and right click it, choosing "copy link location". This link will permanently subscribe to the calendar events for the currently logged in user.
#Open Outlook 2007 and go to Tools->account settings->internet calendars->new.
#Paste in the address you copied from Moodle.
#Click OK and close.
#You should now see another calendar available on the left hand calendar bar, underneath 'My Calendars'. Enable this and Outlook will update the calendar every time it opens.
#Right-click on the tabs to choose between 'side by side mode' and 'overlay mode'.

===Google calendar===

====Dynamic Link to Moodle Calendar====
In Moodle, after pressing the "Export calendar" button at the bottom of the calendar page, select the events and time frames you wish. The "Get URL address" button will create a URL address.

In Google Calendar's "Other calendars" menu, choose "Add by URL" and supply the URL generated in the process described above. This version of the Google calendar will update whenever changes are made in the source Moodle calendar (including new, changed or deleted events), although it may take several hours for the changes to appear.

Note that this may be more or less useful. The calendar will be relative to the Moodle user. That is, if the user who generates the URL is enrolled in several courses, it is this information that will appear in the calendar. There is no way (at this time) to generate a URL that only applies to one course.

====One-time import (future updates in Moodle won't appear)====
In Moodle create an export file (icalexport.ics, as detailed above) and save it on your computer.

In Google Calendar, use the settings link (usually near the sign out and help links) and select the settings tab. This will bring up the "Import Calendar" pop up window. Select the file to import and the Google Calendar the file should be imported into. Note that this method doesn't allow new (or modified) events from the Moodle calendar to appear in the Google calendar, unless you repeat this process. See the Dynamic Link method above.

==Importing multiple events==

See [[Calendar import]] for details of how to import external calendars (such as Google Calendar, or a calendar from another Moodle site) into Moodle's calendar.

==List format==
The calendar displays event lists one day at a time. There is no capacity to display a list of all site or course events over an extended period. To obtain date lists for publications, the only option is to link directly to the SQL database, select by the "courseid" and perform calculations to convert the UNIX "timestart" to a publishable date format:

Using a Microsoft Access query, collect data from the '''mdl_event''' table and create 2 calculated fields:

*'''calcdate''': DateValue("1/1/1970")+[timestart]/60/60/24+10/24
*'''daysavdate''': IIf([calcdate] Between #2/04/2006# And #29/10/2006#,[calcdate],[calcdate]+1/24)

Then, use additional calculated fields to separate the date, day of week and time (if needing to be formatted separately:

*Dte: Format([daysavdate],"mmm dd")
*DayName: Format([daysavdate],"ddd")
*Tme: Format([daysavdate],"hh:nn am/pm")

:''TIP:'' The dates for daylight saving need to be changed each year to match your location.
:''TIP:'' Very brief summary process for creating connection to moodle database in Windows environment: Install MySQL [[ODBC]] Driver 3.51 / Start settings control panel / admin tools/ Data Sources/ ODBC / add new service/ select MySQL ODBC driver/ follow prompts for User & password/ open access/ get external data/ point to MySQL ODBC connection

==Navigating months==
There is no easy way to jump to a specific month in the year other than to directly edit the URL variable for month "m=" : calendar/view.php?view=month&cal_d=1&cal_'''m=02'''&cal_y=2006

==Display current day events==

Use link: http://moodle.org/calendar/view.php?view=day

==See also==

*[[Calendar block]]
*[[Upcoming events block]]
*[[Calendar editor role]]

[[de:Kalender nutzen]]
[[es:Uso del Calendario]]
[[fr:Utiliser le Calendrier]]

File:exportcalendar.png

2019-08-12T15:02:01Z

Finns: Finns uploaded a new version of File:exportcalendar.png

File:quizreview.png

2019-07-05T12:26:02Z

Finns: Finns uploaded a new version of File:quizreview.png

File:quiz timer.png

2019-07-05T12:09:55Z

Finns: Finns uploaded a new version of File:quiz timer.png