MoodleDocs - User contributions [en]

New features

2016-05-23T14:23:51Z

Marycooch: French link

{{About Moodle}}
Moodle 2.9 brings together features and enhancements developed by our core team and community contributors. These include: streamlined navigation, useful improvements to activities such as Lesson and Quiz, along with new admin settings which refine the course management process.

Read on for Moodle 2.9 highlights, or watch the screencasts on the official [https://youtu.be/JsUz1DMg-24?list=PLxcO_MFWQBDclJEctfdxCFeo8QuyR1Hw_ Moodle HQ YouTube page].

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

=== For all users ===
<div class="contentblock">
<div class="row-fluid">
<ul class="thumbnails">
<li class="span6">
<div class="thumbnail">
[[File:TestDashboard.png|600px]]
<div class="caption">
<h4>My home is now Dashboard</h4>
<p>My home has been renamed to Dashboard, while retaining its full functionality as before. Where courses have assignments, these are only now displayed in the [[Course overview block]] when they need attention from the teacher (grading) or the student (submitting/resubmitting). [[Dashboard|Read more...]]</p>
</div>
</div>
</li>
<li class="span6">
<div class="thumbnail">
[[File:Grades29.png|600px]]
<div class="caption">
<h4>New Grades page</h4>
<p>The user menu now includes a new Grades page which display grades from all courses users are students in, with links to the relevant user reports. Courses users are teaching in are also displayed, with links to the relevant course gradebook. [[Overview report|Read more...]] </p>
</div>
</div>
</li>
</ul>
</div>

<div class="contentblock">
<div class="row-fluid">
<ul class="thumbnails">
<li class="span6">
<div class="thumbnail">
[[File:TestProfile2.png|600px]]
<div class="caption">
<h4>New Profile page</h4>
<p>Accessed from the user menu, the new Profile page provides quick links to blog entries, forum post, badges and, depending on the user’s privileges, a variety of reports including a new [[Browser sessions|browser sessions page.]] The page includes links formerly in the Navigation block. [[User profiles|Read more...]]</p>
</div>
</div>
</li>
<li class="span6">
<div class="thumbnail">
[[File:TestBrowsersessions.png|600px]]
<div class="caption">
<h4>Browser sessions page</h4>
<p>A new page displays your current browser sessions allowing you to check if you forgot to log off on a different computer (and log off now) and reassure yourself nobody is using your account. [[Browser sessions| Read more...]]</p>
</div>
</div>
</li>
</ul>
</div>

<div class="contentblock">
<div class="row-fluid">
<ul class="thumbnails">
<li class="span6">
<div class="thumbnail">
[[File:TestPreferences2.png|600px]]
<div class="caption">
<h4>New Preferences page</h4>
<p>AlI your preferences can easily be reviewed and altered from one page, accessed from the user menu. Easily change your choice of editor, update your forum notifications, change your password and more. This page includes settings formerly in the Administration block. [[Preferences|Read more...]] </p>
</div>
</div>
</li>
<li class="span6">
<div class="thumbnail">
[[File:TestMessages.png|600px]]
<div class="caption">
<h4>Improved messaging</h4>
<p>A messages button on profile pages enables you to send messages via pop-up box without leaving the page you are on. [[Messaging|Read more...]]</p>
</div>
</div>
</li>
</ul>
</div>

<div class="contentblock">
<div class="row-fluid">
<ul class="thumbnails">
<li class="span6">
<div class="thumbnail">
[[File:TestAttoDrag.png|600px]]
<div class="caption">
<h4>Drag and drop into Atto</h4>
<p>It's now possible to drag and drop images directly into the Atto editor, for example when editing a course summary or when posting in a forum. [[Text editor|Read more...]]</p>
</div>
</div>
</li>
<li class="span6">
<div class="thumbnail">
[[File:TestSearch.png|600px]]
<div class="caption">
<h4>Search Server files</h4>
<p>Users with permissions to access Server files can now use a search facility, allowing for easy location of files in other courses they have access to. [[Server files|Read more...]]</p>
</div>
</div>
</li>
</ul>
</div>

=== Activity enhancements ===

<div class="row-fluid">
<ul class="thumbnails">
<li class="span6">
<div class="thumbnail">
[[File:TestLesson.png|600px]]
<div class="caption">
<h4>Lesson</h4>
<p> Along with enhancements such as group support, user and group overrides better logging and improved essay grading interface, the [[Lesson|lesson]] activity now boasts a new completion condition “Require time spent”. [[Lesson settings|Read more...]]</p>
</div>
</div>
</li>
<li class="span6">
<div class="thumbnail">
[[File:TestQuiz2.png|600px]]
<div class="caption">
<h4> Quiz</h4>
<p> [[Quiz|Quizzes]] can now have section headings and questions can be shuffled on different pages. It is now possible to require that a particular question be answered before a subsequent one may be accessed, and quizzes along with responses and feedback will now display attractively when printed from the browser. [[Building Quiz|Read more...]]</p>
</div>
</div>
</li>
</ul>
</div>

<div class="row-fluid">
<ul class="thumbnails">
<li class="span6">
<div class="thumbnail">
[[File:TesForumGroup.png|600px]]
<div class="caption">
<h4>Easily post to all groups in a forum</h4>
<p> If your [[Forum|forum]] has groups, you only need to post once and your post is copied for each group.</p>
</div>
</div>
</li>
<li class="span6">
<div class="thumbnail">
[[File:TestDatabase.png|600px]]
<div class="caption">
<h4> Extra options for Database and Glossary</h4>
<p> Along with displaying user pictures in the [[Database activity module|database]], you can set certain fields as 'required'. When importing [[Glossary|glossary]] entries, embedded images and attached files will also be included.</p>
</div>
</div>
</li>
</ul>
</div>

<div class="row-fluid">
<ul class="thumbnails">
<li class="span6">
<div class="thumbnail">
[[File:TestActivityResultsBlock.png|600px]]
<div class="caption">
<h4>Activity results</h4>
<p> As well as displaying quiz results in competitive league table style, a new Activity results block can show scores from any graded or rated activity in your course. [[Activity results block|Read more...]]</p>
</div>
</div>
</li>
<li class="span6">
<div class="thumbnail">
[[File:TestGradetopass.png|600px]]
<div class="caption">
<h4> Grade to pass</h4>
<p> If you are using graded activities it is now possible to set a passing grade during the activity set up process instead of having to edit the gradebook directly.</p>
</div>
</div>
</li>
</ul>
</div>

=== Course management===

<div class="row-fluid">
<ul class="thumbnails">
<li class="span6">
<div class="thumbnail">
[[File:TestDelete.png|600px]]
<div class="caption">
<h4>Delete course sections</h4>
<p>A new option in each course section allows you to completely remove the section and its content, regardless of where the section is located on your course page. [[Course homepage|Read more...]]</p>
</div>
</div>
</li>
<li class="span6">
<div class="thumbnail">
[[File:TestCohortsync.png|600px]]
<div class="caption">
<h4> Faster addition of cohorts and meta linked courses</h4>
<p> You can enrol many cohorts or multiple courses with the [[Cohort sync|cohort sync]] and [[Course meta link|course meta link]] methods much faster now with a new "Add method and create another" button. Users from linked courses can also be synced into a group; a much voted-for feature.</p>
</div>
</div>
</li>
</ul>
</div>
<div class="row-fluid">
<ul class="thumbnails">
<li class="span6">
<div class="thumbnail">
[[File:TestKeyholder.png|600px]]
<div class="caption">
<h4>Keyholder</h4>
<p> A new capability [[Capabilities/enrol/self:holdkey|enrol/self:holdkey]] will make it easy for certain members of your organisation - not necessarily teachers- to be the keyholder to self-enrolled courses. [[Keyholder|Read more...]] </p>
</div>
</div>
</li>
</ul>
</div>

===New options for administrators and developers===
<div class="row-fluid">
<ul class="thumbnails">
<li class="span6">
<div class="thumbnail">
[[File:TemplateLibrary.png|600px]]
<div class="caption">
<h4>New template library for renderers</h4>
<p>A new element library will make it easier to create and style the user interface, give Moodle a more consistent look and feel and improve site performance. [[dev:Render_library_specification|Read more...]] </p>
</div>
</div>
</li>
<li class="span6">
<div class="thumbnail">
[[File:TestFileType.png|600px]]
<div class="caption">
<h4>Add custom file types</h4>
<p>A new admin tool lists all existing file types and allows you to add new ones specific to programs your organisation might be using. This will make the display of such file types clearer and downloading them less confusing. [[Working with files|Read more...]]</p>
</div>
</div>
</li>
</ul>
</div>

==See also==

* [[:Category:New features|Category:New features]] - list of pages documenting new features in Moodle 2.9

[[es:Nuevas características de Moodle 2.9]]
[[de:Neue Funktionalitäten]]
[[fr:Nouveautés de Moodle 2.9]]

Course backup

2016-03-01T13:44:35Z

Marycooch: removed ref to experimental backup as no longer relevant

{{Backup}}
A course can be saved with some or all of its parts by using the course backup. Typically, the site administrator will set a schedule of [[Automated course backup|automated course backups]] for the whole site. A teacher with editing privileges can create a backup or download an existing backup for safe keeping, or for use on another Moodle site. See the screencast [https://www.youtube.com/watch?v=BVHHC-wBhEM Course backup: Save and reuse your course] for information on how to back up your course as a teacher.

==Backing up a course==

To backup a course

* Go to ''Administration > Course administration > Backup''
* Initial settings - Select activities, blocks, filters and other items as required then click the Next button. Users with appropriate permissions, such as administrators and managers, can choose whether to [[Backup of user data|include users]], anonymize user information, or include user role assignments, user files, comments, user completion details, course logs and grade history in the backup. '''New in 2.9''': Groups and Groupings may be included in the backup.

[[File:backupgroups.png|thumb|center|Backup settings]]

* Schema settings - Select/deselect specific items to include in backup, then click the Next button.

* If desired, select specific types of activity to be backed up by clicking the link 'Show type options'

{|
|[[File:26backuprestore1.png|thumb|Back up screen with option to select all or none]]
|
|[[File:26backuprestore2.png|thumb|Back up screen with option to select activity types]]
|}

* Confirmation and review - Check that everything is as required, using the Previous button if necessary, otherwise click the 'Perform backup' button
* Complete - Click the Continue button

A backup file (with distinctive .mbz extension to avoid confusion with .zip files) is then saved in the course backup area. Backup file names are of the form ''backup-moodle2-course-coursename-date-hour.mbz'', ending in ''-nu.mbz'' when backed up with no users and ''-an.mbz'' with anonymized names.

===Quick backup===

If you are satisfied with the default settings and don't wish to go through all the backup screens, you can simply click 'Jump to final step' to perform the backup.
[[File:jumptofinalstep.png|center]]

==Anonymizing user information==

Anonymize user information is a backup feature which "protects user identities" by making each user anonymous. If this box is checked in the backup initial settings, Moodle will substitute aliases for real names, substituting @doesntexist.com email addresses and so forth. For example "Max Manager" might become "anonfirstname4 anonlastname4".

==Backup and restore of assignments from Moodle 2.2 and older==

The assignment activity module was completely rewritten in Moodle 2.3. Thus, assignments from Moodle 2.2 and older (e.g. from Moodle 1.9) need to be upgraded in order to continue being usable. See the section 'Restoring course backups from Moodle 2.2 and older' in [[Assignment upgrade tool]] for details of what to do.

==CLI backup script==
Performs via command line a backup of the given course.

===Options===
* --courseid=INTEGER (Course ID for backup.)
* --courseshortname=STRING (Course shortname for backup.)
* --destination=STRING (Path where to store backup file. If not set the backup will be stored within the course backup file area.)
* -h, --help (Print out this help.)

===Example===
\$sudo -u www-data /usr/bin/php admin/cli/backup.php --courseid=2 --destination=/moodle/backup/

==Tips and tricks==
* Lose content after a restore in Moodle 2.0 ? Do you see topic headings that say "Orphaned activities"? Solution: Go to course settings and increase the number of topic sections and things will return to normal.

==Creative uses==
The backup and restore processes can offer the teacher and administrators many creative solutions.
*Duplicating courses or specific activities in one course to another course (similar to Import)
*Updating a production Moodle site course, with material from a localhost site course
*Transferring a course to a new Moodle site.
*In earlier versions of Moodle, a way of rolling a course forward without past student activity
*Creating a blank activity, save just that activity and then restore it to the course or another course one or more times.

==General backup defaults==

Default settings for course backups can be set by a site administrator in ''Administration > Site administration > Courses > Backups > General backup defaults''.

Selected settings may be locked, so that they cannot be changed when creating a course backup.

By selecting a time in the "Keep logs for.." dropdown, it is possible to specify how long backup logs information is kept before being deleted. As this information may be very large, it is recommended the length of time chosen be quite short.

==Course backup capabilities==

*[[Capabilities/moodle/backup:anonymise|Anonymise user data on backup]]
*[[Capabilities/moodle/backup:backupcourse|Backup courses]]
*[[Capabilities/moodle/backup:backupsection|Backup sections]]
*[[Capabilities/moodle/backup:backuptargethub|Backup for hub]]
*[[Capabilities/moodle/backup:backuptargetimport|Backup for import]]
*[[Capabilities/moodle/backup:configure|Configure backup options]]
*[[Capabilities/moodle/backup:downloadfile|Download files from backup areas]]
*[[Capabilities/moodle/backup:userinfo|Backup user data]]

==See also==
*Forum post [https://moodle.org/mod/forum/discuss.php?d=310227#p1241735 Back up via command line]
*[[Course restore]]
*[[Backup of user data]]
*[[Activity backup]]
* [http://youtu.be/rg6rUuBwITo Moodle 2 Administration Courses] MoodleBites video on YouTube

[[de:Kurssicherung]]
[[es:Respaldo del curso]]
[[eu:Ikastaroaren_Segurtasun-kopia]]
[[fr:Sauvegarde de cours]]
[[ja:コースバックアップ]]

Moodle video tutorials

2016-02-29T10:07:37Z

Marycooch: /* Video tutorials in English */

There are a large number of free online video tutorials about Moodle and this page collates them for Moodle 2. If you have made some Moodle 2 video tutorials or have a link to some free Moodle 2 video tutorials, please add them here.

==Video tutorials in English==

*[https://www.youtube.com/watch?v=eATTzWUrK1s What is Moodle? Simple, short explainer video by HowToMoodle]
*[http://www.youtube.com/moodlehq Videos made by Moodle HQ]
*[http://moodle.com/6-instructional-video-sites-for-moodle-users/ 6 Instructional Video Sites for Moodle Users: ]
**[https://www.youtube.com/user/moodlehq Moodle HQ YouTube channel] '''Learn Moodle''': The twice-yearly MOOC includes basic video tutorials for the recent and latest versions of Moodle.
**[http://mistreamnet.org/videos/list?utf8=?&search=Moodle+Moot Mi Stream – MoodleMoot Michigan] Hosted in Mid-Michigan at the beginning of the year, the past recordings of the MoodleMoot has some interesting insight into creative uses of Moodle and shared experiences.
**[https://www.youtube.com/channel/UCPJxOKUfOwIZ4uS6i7H65Vw Synergy Learning] UK Moodle Partner, Synergy Learning, has announced their new Youtube channel. While there are only a handful of videos at present, watch this space in 2015 for more resources to appear on this site.
**[https://www.youtube.com/user/LambdaSolutionsInc Lambda Solutions] Lambda Solutions is a full service Moodle Partner offering services in both US and Canada. Their channel offers experiences and demonstrations of Moodle to provide a good overview for users.
**[https://www.youtube.com/channel/UCsLt8oYvDYGpSHcGhRBBkyw Nellie Deutsch] Dr. Nellie Deutsch is faculty at Atlantic University in the MA transpersonal and leadership studies. Her channel offers a bevy of Moodle how-tos and elearning best practices.

*[http://www.youtube.com/HRDNZMoodlePartner Videos made by HRDNZ]
*[http://www.webanywhere.co.uk/video/training-videos Videos made by Webanywhere]

==Video tutorials in other languages==
*[http://youtube.com/Moodle2Ourlearning video tutorials in French/en Français]

==See also==

*[[Moodle manuals]]
*[[Moodle presentations]]

[[es:Tutoriales de Moodle en video]]

Moodle video tutorials

2016-02-29T10:07:22Z

Marycooch: /* Video tutorials in English */

There are a large number of free online video tutorials about Moodle and this page collates them for Moodle 2. If you have made some Moodle 2 video tutorials or have a link to some free Moodle 2 video tutorials, please add them here.

==Video tutorials in English==

*[https://www.youtube.com/watch?v=eATTzWUrK1s What is Moodle? Simple, short explainer video by HowToMoodle]
*[http://www.youtube.com/moodlehq Videos made by Moodle HQ]
*[http://moodle.com/6-instructional-video-sites-for-moodle-users/ 6 Instructional Video Sites for Moodle Users: ]
**[https://www.youtube.com/user/moodlehq Moodle HQ YouTube channel] '''Learn Moodle''': The twice-yearly MOOC includes basic video tutorials for the recent and latest versions of Moodle.
**[https://www.youtube.com/user/moodlehq Pukunui YouTube channel] Australasian Moodle Partner, Pukunui, runs the annual iMoot online and provides Moodle services to a range of industry sectors. Their channel offers recordings from past events and helpful how-to videos.
**[http://mistreamnet.org/videos/list?utf8=?&search=Moodle+Moot Mi Stream – MoodleMoot Michigan] Hosted in Mid-Michigan at the beginning of the year, the past recordings of the MoodleMoot has some interesting insight into creative uses of Moodle and shared experiences.
**[https://www.youtube.com/channel/UCPJxOKUfOwIZ4uS6i7H65Vw Synergy Learning] UK Moodle Partner, Synergy Learning, has announced their new Youtube channel. While there are only a handful of videos at present, watch this space in 2015 for more resources to appear on this site.
**[https://www.youtube.com/user/LambdaSolutionsInc Lambda Solutions] Lambda Solutions is a full service Moodle Partner offering services in both US and Canada. Their channel offers experiences and demonstrations of Moodle to provide a good overview for users.
**[https://www.youtube.com/channel/UCsLt8oYvDYGpSHcGhRBBkyw Nellie Deutsch] Dr. Nellie Deutsch is faculty at Atlantic University in the MA transpersonal and leadership studies. Her channel offers a bevy of Moodle how-tos and elearning best practices.

*[http://www.youtube.com/HRDNZMoodlePartner Videos made by HRDNZ]
*[http://www.webanywhere.co.uk/video/training-videos Videos made by Webanywhere]

==Video tutorials in other languages==
*[http://youtube.com/Moodle2Ourlearning video tutorials in French/en Français]

==See also==

*[[Moodle manuals]]
*[[Moodle presentations]]

[[es:Tutoriales de Moodle en video]]

Rubrics

2016-01-22T12:20:04Z

Marycooch: copied from 3.0 docs

{{Advanced grading methods}}
[[image:gradingform-rubric-icon.png]] '''Rubrics''' are [[Advanced grading methods|advanced grading forms]] used for criteria-based assessment. The rubric consists of a set of criteria. For each criterion, several descriptive levels are provided. A numerical grade is assigned to each of these levels. The rater chooses which level answers/describes the given criterion best. The raw rubric score is calculated as a sum of all criteria grades. The final grade is calculated by comparing the actual score with the worst/best possible score that could be received.

== Rubric editor ==

[[image:gradingfrom-rubric-editor.png|thumb|right|Rubric editor]]

The rubric editor is available via the advanced grading method management screen which in turn is available via the 'Advanced grading' link in the activity settings block. The editor lets you set the rubric form name, the description and the rubric itself. The editor lets you add new criteria and levels, delete them and change the criteria order. There are several rubric options that can be configured, too. For each criterion, the criterion description should be filled. For each level, the level definition and the number of points associated with the level should be specified. Neither the criterion description nor the level definition text fields support embedded images yet.

The rubric definition must be saved using either 'Save rubric and make it ready' or 'Save as draft' button. The button sets the form definition status respectively as described at the [[Advanced grading methods]] page.

''Hint:'' You can modify the effective weight of a criterion by setting the value of the points assigned to its levels. If there is one criterion with levels 0, 1, 2, 3 and the second one with levels 0, 2, 4, 6 then the later one's impact on the final grade is twice as much as the first one's.

''Hint:'' Use the Tab key to jump to the next level/criteria and even to add new criteria.

== Using the rubric ==

[[image:gradingfrom-rubric-usage.png|thumb|right|Filling the rubric to assess a submission in the Assignment module]]

When teachers use the rubric to assess some student's work, they select the level describing the student's performance best for each criterion. Currently selected levels are highlighted in light green. If the rubric filling is re-edited later, the previously selected level is highlighted in light red. A level must be selected for each criterion, otherwise the rubric is not validated by the server as the final grade can't be calculated.

If the form definition allows it, an optional remark can be filled for each criterion providing a detailed feedback/explanation of the assessment.

== Grade calculation ==

The rubric normalized score (ie basically a percentage grade) is calculated as

: <math>G_s = \frac{\sum_{i=1}^N (g_i - min_i) }{\sum_{i=1}^N (max_i - min_i)}</math>
: where <math>g_i \in \mathbb{N}</math> is the number of points given to the i-th criterion, <math>min_i \in \mathbb{N}</math> is the minimal possible number of points for of the i-th criterion, <math>max_i \in \mathbb{N}</math> is the maximal possible number of points for the i-th criterion and <math>N \in \mathbb{N} </math> is the number of criteria in the rubric.

Example of a single criterion can be: ''Overall quality of the paper'' with the levels ''5 - An excellent paper'', ''3 - A mediocre paper'', ''0 - A weak paper'' (the number represent the number of points).

''Example:'' let us have an assessment form with two criteria, which both have four levels 1, 2, 3, 4. The teacher chooses level with 2 points for the first criterion and 3 points for the second criterion. Then the normalized score is:

: <math>G_s = \frac{(2 - 1) + (3 - 1)}{(4 - 1) + (4 - 1)} = \frac{3}{6} = 50 %</math>

Note that this calculation may be different from how you intuitively use rubric. For example, when the teacher in the previous example chose both levels with 1 point, the plain sum would be 2 points. But that is actually the lowest possible score so it maps to the grade 0 in Moodle.

TIP: '''To avoid confusion from this sort of thing, we recommend including a level with 0 points in every rubric criterion.'''

A student's score is calculated by subtracting the minimum score available on the rubric from the student's actual score achieved on the rubric, and dividing the resulting answer by the difference between the maximum and minimum score available"

==How students access the rubric==

{|
|[[image:rubricbeforesubmission.png|thumb|How students view a rubric]]
|}

When students click on an assignment which has a rubric attached to it, they will see the rubric as part of the information about their assignment. Thus, they can see the rubric before they submit.
==How teachers access the rubric==
Teachers will see the rubric when they click 'View/grade all submissions' and access the work of a particular student. They don't by default see the rubric on the grading page before grading. If you wish to allow teachers to see the rubric, then the site administrator must set the capabililty [[Capabilities/mod/assign:submit|mod/assign:submit]] to 'Allow' for the editing teacher role in that assignment (or sitewide if really necessary). '''NOTE:''' This then has the side effect of the teacher appearing in the gradebook.

==FAQ==
===Where do you go to edit a rubric?===
To edit a rubric go to
''Administration > Assignment Administration > Advanced grading > Define Rubric''.
Select 'Rubric' from Change active grading method to drop down menu.
You can see your created rubric with three options above Edit the current form definition, Delete the currently defined form, Publish the form as a new template. Click "Edit the current form definition" to edit your predefined rubric form.

===How do you choose another rubric for an assignment?===
From ''Administration>Assignment administration>Advanced grading'' access your rubric and delete it. The see #5 in [[Advanced grading methods]]

===Why are total grades coming out strange?===
It's likely that the lowest total grade in your rubric is not zero. In this case your rubric grades from RUBRIC MIN to RUBRIC MAX are being converted to the assignment grades of ZERO to ASSIGNMENT MAX, which is probably what you don't want. To fix this, just make sure you have a ZERO level in each of your rubric criteria (even if you never use them).

==See also==

* [http://school.demo.moodle.net/grade/grading/form/rubric/preview.php?areaid=33 School demo example of student view of rubric] (Log in as username '''student'''/password '''moodle''')
* [http://school.demo.moodle.net/mod/assign/view.php?id=205&rownum=1&action=grade School demo example of teacher view of rubric in student assignment] (Log in as username '''teacher'''/password '''moodle''')
*[http://youtu.be/KXavtUhDINA A first look at rubrics] Screencast
* [[Advanced grading methods]] page for general concepts of advanced grading in Moodle
* [http://en.wikipedia.org/wiki/Rubric_(academic) Rubric description] at Wikipedia
* [http://school.discoveryeducation.com/schrockguide/assess.html Examples of Assessment Rubrics] at Kathy Schrock's Guide for Educators
* http://rubistar.4teachers.org/ - a free tool to help teachers create quality rubrics
* [https://digiteacher.wordpress.com/2014/11/20/my-teacher-is-a-zombie-marking-by-rubric-on-moodle/ My Teacher is a Zombie – Marking by Rubric on Moodle] Using an electronic rubric frees up the time to ...

[[de:Rubriken]]
[[es:Rúbricas]]

Using RSS feeds

2016-01-10T09:45:39Z

Marycooch:

{{RSS feeds}}
==Activities and other areas that produce RSS feeds==

* [[Blogs]]
* [[Database]]
* [[Forum]]
* [[Glossary]]

== Subscribing to RSS feeds==

To subscribe to an RSS feed from Moodle, click on the activity and look in the Administration block for a link "RSS feeds for (this activity)" and copy the address from your browser bar to your RSS reader software.
.

==Restricting access to RSS feeds==

To ensure security and privacy, RSS feed URLs contain a special token that identifies the user they are for. This prevents users from accessing areas of Moodle they shouldn't have access to via RSS feeds.

Users have this token automatically created for them the first time they access an area of Moodle that produces an RSS feed. If a user feels that their RSS feed token has been compromised in some way they can request a new one by going to the User menu > ''Preferences > Security keys'' and clicking the Reset link next to the RSS key.

To provide a public RSS feed for use on another site, login to your Moodle site as a guest, then copy the RSS feed address.
Important to use this function on an other site, guest users do not have to accept any "Site policy URL for guests" in site policies options. --[[User:Arnould Olivier|Arnould Olivier]] ([[User talk:Arnould Olivier|talk]]) 21:28, 11 October 2015 (AWST)

==See also==
*[http://youtu.be/Zx9o-ueJ-II Moodle 2.0 - RSS] MoodleBites video on YouTube

[[de:RSS-Feeds nutzen]]

Course completion FAQ

2016-01-08T08:19:44Z

Marycooch: badge enrolment plugin

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

See [[Course completion settings]].

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

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

==I have set up course prerequisites but my students can still access the second course before they have finished the first==
Sorry - the course prerequisites feature does NOT prevent students from accessing courses. It merely prevents the course from being marked as "complete" until they have completed another course.

==How can I prevent my students accessing course 2 before they have completed course 1?==
This is currently not possible using completion settings- see MDL-22648 .The usual workaround is to add a final activity at the end of course 1 - such as a quiz - inside which you give the enrolment key to the next course (in the quiz feedback for example) Thus, only those who have completed course 1 can get access to course 2. That doesn't stop them sharing the key however, but you could see any cheaters in the logs.

Another workaround is to install the [https://docs.moodle.org/29/en/enrol_badgeenrol Badge enrolment plugin] which restricts access to a second course until the student has obtained a badge in the first course.

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

==My student got an error message when they click on more information in the course completion block==

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

==Where do my students tell me they have finished the course?==

Did you install the [[Self completion block]]? When they click on the link in that block, that will indicate they think they are done.

==How can I set my course completion to be longer than 30 days after enrolment?==

Currently the dropdown menu only allows you to choose from up to 30 days after enrolment. There is a tracker entry about this here MDL-34678. However, if you are happy editing the database then you can manually change the value as follows:

# Look in the mdl_course_completion_criteria table. The Duration After Enrolment criteria will have the "criteriatype" value of 5 and the number of days is recorded in the column "enrolperiod" in seconds (so #days x 86400).
# Adjust the enrolperiod value and after the next cron run everything will use the new value.

==See also==

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

[[Category:FAQ]]

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

Course completion settings

2016-01-07T08:54:12Z

Marycooch: removed fixed issue

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

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

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

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

==Course completion settings==

===General===

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

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

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

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

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

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

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

===Condition: Course grade===
(These settings are collapsed by default.)
{|
|[[File:completioncoursegrade25.png|thumb|Course grades settings expanded]]
|}
If you tick the ''Enable'' box, you can set a passing grade for the course.

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

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

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

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

==Course administration settings==

''Course administration > Edit settings''

*Completion tracking must be enabled.

==Site administration settings==

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

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

==Course completion capabilities==

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

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

==Course completion blocks==

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

[[Category:Site administration]]

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

Forum settings

2016-01-06T09:00:11Z

Marycooch: groups and single simple discussion

{{Forum}}
A teacher can add a Forum activity in a course when editing is turned on by clicking an 'Add an activity or resource' link (or, if not present, the "Add an activity" drop down menu) and selecting Forum.
==Activity settings==
To see all the settings expanded, click the link "Expand all" top right.

Give the Forum a name (which students see on the course page) and a description if required. (For the Single simple discussion forum type, your description must include the question or topic you wish to discuss.)

Clicking the question mark icon [[File:helppopup.png]]next to any setting you don't understand will display extra help.

===Attachments and word count===

The maximum file size that may be attached to a forum post depends on the Moodle site settings. The teacher may want a smaller size limit for the forum and should bear in mind the download speeds of the course participants.

If "Display word count" is enabled, then the number of words in forum posts will be shown at the bottom of each post.

===Forum subscriptions===

When a user is subscribed to a forum it means that they will receive notification (depending on the user’s messaging settings preferences) of each new posting. By default, posts are recorded about 30 minutes after the post was first written. Depending upon the email settings of each forum member, they may be notified immediately after the 30 minute edit window is closed, or in a batch at a time fixed by the site administrator (see below).

People can usually choose whether or not they want to be subscribed to each forum. However, the teacher can choose to force subscription on a particular forum then all course users will be subscribed automatically, even those that enrol at a later time.

The subscription mode and subscribe or unsubscribe links appear in'' Navigation>Forum administration'' when viewing the forum. Teachers can quickly change the mode via the 'Subscription mode' options and view the current subscribers via the 'Show/edit current subscribers' link.

Tips:
* Forcing everyone to subscribe is especially useful in the news forum and in forums towards the beginning of the course (before everyone has worked out that they can subscribe to these emails themselves).
* Changing the setting from "Yes, initially" to "No" will not unsubscribe existing users; it will only affect those who enrol in the course in the future. Similarly changing "Yes, initially" will not subscribe existing course users but only those enrolling later.
* There is also a "Subscriptions not allowed" setting which prevents Students from subscribing to a Forum. Teachers may choose to subscribe to a forum if they wish.

====Subscribe to individual forum discussions====

In a forum with optional or auto subscription you can choose which discussions to subscribe to by clicking the 'dot' icon to the right of the discussion. An envelope tells you are already subscribed.
[[File:forumsubscribe.png|thumb|center|600px]]

When you reply to a post you will see a tickbox 'Discussion subscription'. It will already be ticked if you have chosen in your forum preferences to be subscribed to discussions you post in by default. If you have chosen not to subscribe to forum discussions by default, then you can tick this box to be notified of posts from this particular thread.

===RSS===
If [[RSS feeds]] are enabled for the site and for forums, then an expandable section for RSS settings will appear. Here the teacher can turn RSS feeds on or off for that forum.When set to “Discussions,” the RSS feed will send out new discussions to subscribers. When set to “Posts,” the RSS feed will send out any new posts to subscribers.

Cron must be working regularly for the RSS feed to work; otherwise participants will see ' Error reading RSS data'.

===Blocking posts===
By default, course participants can post any number of messages to forums. If you want to restrict this number and block them after a certain number or time, the expandable section 'Post threshold for blocking' allows you to specify your choice. You can also send a warning that they are about to be blocked.

===Grade and Ratings===
Forums use a rating [[Scales|scale]] which you can customise. You can also set a "Grade to pass" which may be connected with [[Activity completion]] and [[Conditional activities]] such that a student will not be able to access a follow up activity until they have obtained a required grade (rating) in the forum.

By default, only teachers can rate forum posts, though students can be given permission to do so if desired (see forum permissions below). This is a useful tool for giving students participation grades. Any ratings given in the forum are recorded in the [[Gradebook|gradebook]].

You can set an 'aggregate type' to decide how all the ratings given to posts in a forum are combined to form the final grade (for each post and for the whole forum activity). See [[Ratings]] for an explanation of aggregate types and which one is best for you.

===Other settings===
Depending on what is enabled for your site and course, you may also need to explore [[Common module settings]], [[Conditional activities| Restrict access]] and [[Activity completion]]

If your Forum activity doesn't display as you wish, check the site settings below:

===Using groups with Forums===
For 'Group mode' in the expandable Common module settings section allows you to specify how your forum works with groups. Note that Single simple discussion forum types cannot be used with groups as this feature is not implemented. For more information about using groups with forums, see the documentation [[Using Forum]]
The '''group mode''' setting has three options:

==Site settings==

A description for the Forum may or may not be obligatory depending on ''Site administration > Plugins > Activity modules > Common settings,''

The forum module has additional settings which may be changed by an administrator in ''Administration > Site administration > Plugins > Activity modules > Forum'' and, for 'Maximum time to edit posts', in ''Administration > Site administration > Security > Site policies''.

===Changing the subject line of forum notifications===

Normally when forum subscribers receive emails from forums, the subject line is of the form: Course short name + Subject of post:

[[File:forum1.png]]

The subject line can be changed - for example to: Course short name + Forum name + Subject by going to ''Site administration>Language>Language customisation'' and in forum.php changing the string ''postmailsubject'' to
{$a->courseshortname} {$a->forumname} {$a->subject}

[[File:forum2.png]]

[[de:Forum konfigurieren]]
[[fr:Ajouter/modifier un forum]]
[[ja:フォーラムの追加/編集]]
[[es:Configuraciones del foro]]

Security keys

2016-01-04T10:50:48Z

Marycooch: /* Secure RSS feeds */

{{RSS feeds}}
A security key or token enables other systems to access Moodle securely. A security key may be used for secure RSS feeds or web services.

A user can obtain a security key via the Preferences link in the user menu top right and entering the key in an external application accessing Moodle.

At any time, a user can reset their key by clicking the reset link. A new different key is automatically generate which will then need to be entered in the external application.

'''Note:''' The security keys page can not generate web service keys/tokens for admins. Admins can create a token manually from the administration block: '' Site administration > Plugins > Web services > Manage tokens''.

==Secure RSS feeds==

Secure RSS feeds are a way you can read [[Using_RSS_feeds|forum posts, blog entries, etc]] while you are offline, and without having to log in. For example, if you want to read the posts in a forum, you usually need to log in to Moodle. But if your site administrator has [[RSS_feeds_settings|enabled RSS]], these posts are available as a feed you can subscribe to with a [http://en.wikipedia.org/wiki/Comparison_of_feed_aggregators feed reader], and you can read entries even when you don't have access to the Internet.

Secure RSS feeds allow your feed reader, which usually expects feeds to be publicly available, to download material from Moodle without having to log in.

Whenever you are viewing an activity that provides an RSS feed, look in the Administration block for a link labelled "RSS feed of posts". This link is unique to your Moodle account. Paste it into your feed reader to have it obtain new entries for you automatically.

If you ever think your RSS feed token has been compromised in some way, e.g. you have lost a mobile phone that subscribed to a news forum, you can request a new one by clicking the ''Reset'' link on the ''Security Keys'' page accessed from the Preferences link in you user menu. This will disable the old feed token and generate a new one. You can then visit the activities you wish to subscribe to and copy the URL, which will contain your new security key.

[[Category:Web Services]]

[[ja:セキュリティキー]]
[[es:Claves de seguridad]]

Security keys

2016-01-04T10:48:30Z

Marycooch: security keys

{{RSS feeds}}
A security key or token enables other systems to access Moodle securely. A security key may be used for secure RSS feeds or web services.

A user can obtain a security key via the Preferences link in the user menu top right and entering the key in an external application accessing Moodle.

At any time, a user can reset their key by clicking the reset link. A new different key is automatically generate which will then need to be entered in the external application.

'''Note:''' The security keys page can not generate web service keys/tokens for admins. Admins can create a token manually from the administration block: '' Site administration > Plugins > Web services > Manage tokens''.

==Secure RSS feeds==

Secure RSS feeds are a way you can read [[Using_RSS_feeds|forum posts, blog entries, etc]] while you are offline, and without having to log in. For example, if you want to read the posts in a forum, you usually need to log in to Moodle. But if your site administrator has [[RSS_feeds_settings|enabled RSS]], these posts are available as a feed you can subscribe to with a [http://en.wikipedia.org/wiki/Comparison_of_feed_aggregators feed reader], and you can read entries even when you don't have access to the Internet.

Secure RSS feeds allow your feed reader, which usually expects feeds to be publicly available, to download material from Moodle without having to log in.

Whenever you are viewing an activity that provides an RSS feed, look in the "Settings" block for a link labelled "RSS feed of posts". This link is unique to your Moodle account. Paste it into your feed reader to have it obtain new entries for you automatically.

If you ever think your RSS feed token has been compromised in some way, e.g. you have lost a mobile phone that subscribed to a news forum, you can request a new one by clicking the ''Reset'' link on the ''Security Keys'' page in your Moodle profile. This will disable the old feed token and generate a new one. You can then visit the activities you wish to subscribe to and copy the URL, which will contain your new security key.

[[Category:Web Services]]

[[ja:セキュリティキー]]
[[es:Claves de seguridad]]

User pictures

2015-12-17T16:38:18Z

Marycooch: changed Settings to Administration

{{Accounts}}
[[File:Example.jpg]]

==Viewing all user pictures==
*An administrator can do a quick check of the user pictures by typing in the browser http://www.YOURMOODLESITE.com/userpix when logged in as admin.

== Updating user pictures ==

Users can update their picture by editing their user profile in ''Administration > My profile > Edit profile''. (The site administrator can disable this ability in ''Administration > Site administration > Security > Site policies''.)

The user's picture is usually displayed next to the user's name. For example, next to content they have has posted in a forum, or in a participant list.

There is a default image that is used by the Moodle site. The site administrator can change the default picture for the site by replacing the F1 and F2 images in the theme folder '''/theme/''themename''/pix_core/u/''' or in the core folder '''/pix/u/'''. Remember to refresh your browser [Ctrl + F5] to see any picture changes!

* There is a delete box when checked will delete the picture when the profile is saved.
* There is a browse button for the user to find and upload a picture file.
* The upload image will be reduced and saved in two files of 100px by 100px and 35px by 35px.
* The picture description appears when the mouse rolls over the picture.

Tip: If you want the default picture to be blank, then replace it with a 1px x 1px transparent spacer image with the same filename. It can be either a '.png' or '.gif' file extension.

==Uploading user pictures in bulk==

An administrator can upload a zip file containing user images in ''Adminisrtration > Site administration > Users > Accounts > Upload user pictures''.

[[File:Uploaduserpictures.png]]

*The image files should be named after the username, the idnumber or the id of the student (along with the correct image file extension.) For example, a student with the username ''jbrown98'' would have a picture called ''jbrown98.jpg''
*Image types supported include gif, jpg, and png.
*Image file names are not case sensitive.

==Gravatars==

An administrator can enable the use of gravatars in ''Settings > Site administration > Users > Permissions > User policies''. If a user has not uploaded a user picture, Moodle will check whether the user's email address has an associated gravatar and if so, will use the gravatar as the user's picture.

See also (for 2.3.3 onwards) Gravatar default image URLs in [[Roles settings]]

==See also==

*Using Moodle [http://moodle.org/mod/forum/discuss.php?d=141378 Cannot upload or change profile pictures] forum discussion

[[eu:Erabiltzailearen_irudiak]]
[[es:Imágenes de usuarios]]
[[fr:Image des utilisateurs]]
[[de:Nutzerbilder]]

Language FAQ

2015-12-09T13:34:31Z

Marycooch: MoodleCloud customising language

{{Language}}

== General ==

=== Which is the official language for Moodle? ===
The [http://lang.moodle.org/mod/forum/discuss.php?d=2617 "official"] language for Moodle is actually the Australian English (''hey mate!'') , which in 100% the same as UK English. The default language on a new installation of Moodle, unless you change it, will be this version of English, denoted by the language code "en".

=== What do codes like "en" and "en_us" or "es" and "es_mx" and "es_ve" mean?? ===

These are the language codes for each language. There is a standard for these, see [https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes ISO language code list].

The second part, "_us" or "_mx" and "_ve" for example, represent localisations of the main language for a particular country or dialect. Typically these will include variant spellings and other preferred local terminology and phrasing. So "es_mx" has spellings and idioms (and a very important [[Decimal separator]]) used in Mexican Spanish which are distinct from international Spanish. The es_ve has small differences from the international spanish that are of significance to Moodle users in Venezuela.

"en_us" is the English - United States language pack; "en" is Australian English, which is practically the same as British English.

=== I found a mistake or typo in a language pack. Or my language is only partial, much of it is still English. What do I do? ===

Language packs have maintainers and Moodle has its own language translation toolkit, known as AMOS. Other than some core languages maintained by Moodle HQ, most languages are maintained by volunteer maintainers.

See the [https://docs.moodle.org/dev/Translation_FAQ Translation FAQ page] for how to report issues and [https://lang.moodle.org/mod/page/view.php?id=9 the AMOS for newcomers page] for more information.

== Default Language ==

=== Where can I set the default language for the site? ===

''Site Administration > Language > [[Language settings]]''

Note you can only choose to set as default a Language pack that is already installed. If the language you want is not on the list, you will need to install the language pack first. See [[Language packs]].

=== When I change to a new default language, users still have the old language. ===

Correct. When you change to a new site default language, this does not update the language setting in the profile for already existing users. It only sets a new default for new user accounts you create from now on.

To do updates for already existing users, you can:

* Tell users how to change it themselves in their user profiles
* Use the [[Upload users]] tool to do a mass update
* If you have access to the database, you can change this with a simple query. See [https://docs.moodle.org/29/en/ad-hoc_contributed_reports#List_of_users_with_language here for an example] of how to do this.

=== I've set a default site language but when I log in it switches to English. Why? ===

By default, Moodle detects a user's language from their browser setting. This language auto-detection may be disabled so that the default site language is used instead in ''Site administration > Language > [[Language settings]]''.

=== I've set a default site language, but the Moodle calendar is in English. Why? ===

If your Moodle calendar is not translated, then the string 'locale' (for *nix servers) or the string 'localewin' (for Windows servers) in the 'langconfig.php' file is wrong (or your server is not configured to support the language). There are quite a few languages that are not supported by Windows servers and the localewin server can not be set. In that case, you have to run your Moodle on a *nix server to make the translation of your Moodle calendar work. See [[:dev:Translation_langconfig]] for details.

=== How can I disable (hide) the language dropdown menu on the site front page? ===

Go to ''Site administration > Language > Language settings'' and un-tick the 'Display language menu' checkbox.

Because it is a customisation, Moodle will not erase the xx_local language files in Moodledata with an upgrade. Moodle will upgrade any language folders it finds in the moodle/lang folder.

== Language Customisation and Multi-language ==

=== How can I change a word or phrase used in Moodle? ===

In ''Administration > Site Administration > Language > Language customisation''.

See [[Language customisation]] for details.

=== How can I find where a language string is located? ===

Tick the 'Show origin of languages strings' checkbox in ''Administration > Site administration > Development > Debugging'' then visit the page containing the string you want to customise. Add to the URL of the page <code>?strings=1</code> (or if it doesn't work try <code>&strings=1</code>) then reload the page.

===Why are my changes not saved in my MoodleCloud site?===
Unfortunately customising language strings is not supported in MoodleCloud. (The same string cache is used for for all sites and is read-only.)

=== Why are my changes not saved if I edit a language pack with the Moodle language pack editor? ===

This could be caused by the caching on the server. Language strings are cached into server memory for performance reasons and when you save changes, they may not be immediately picked up. First, refresh your own browser cache to refresh the pages from the site. Then if the strings are still not there, an administrator can purge the cache of the server.

===How can I provide course content in more than one language?===

Labels, web pages, activity descriptions etc. may be provided in more than one language using the [[Multi language content|Multi language content filter]].

===How can I provide course headings in more than one language?===

Set the multi language content filter to apply to content AND headings in ''Site administration > Plugins > Filters > Manage filters''.

===Are there any short cuts for editing a language?===
Yes, but be careful. You can make use of the customise language process. Basically copy the php files that contain the strings you want to change to the moodledata/lang/local folder. For example, copy the /lang/en/moodle.php file to someplace. Edit the file with a search and replace with whole word and case sensitive turned on, change Teacher to Instructor and Teachers to Instructors, do the same for teacher and teachers. Now copy that saved copy of the moodle.php file to the moodledata/lang/en_local folder. Be careful not to change the String name.

===Is it possible to customise language strings per theme?===
Not by default, as when strings are customised, they are customised for the whole site. However, it is possible to make a new language pack based on your main language and apply that pack to the course which has the theme. See this forum post for more information: https://moodle.org/mod/forum/discuss.php?d=220671

== Other Language Questions ==

===Will installing several language packs decrease my server performance?===
Installing many (20+) language packs have [https://moodle.org/mod/forum/discuss.php?d=241098 almost 0 impact] on Moodle performance. A copy of the language packs installed are stored in your site's local /mooodledata directory. Also, actively used language strings are cached in memory by your server as well to help performance, so as long as your server has sufficient RAM there will be no impact from having many language packs installed.

=== What is this Pirate version of English doing on my site? ===

It has become something of a custom in the Moodle community over the years to observe [https://en.wikipedia.org/wiki/International_Talk_Like_a_Pirate_Day 'Talk Like a Pirate Day'] (September 19th) by temporarily changing the language of a site to allow the the English - Pirate (en_ar) language pack. See the discussion [https://moodle.org/mod/forum/discuss.php?d=132888 here] for more.

===Lang pack download failed with 'HTTP response code: HTTP/1.1 404 Not Found' after new release ===

After we branch for a new release, Moodle will try and download the new version of lang packs, however for a while development is on-sync and no new language string differences will be introduced between the two branches. During this period, AMOS is not branched and so Moodle will fail to download new language packs.

This is expected and it will be resolved once AMOS is opened up for new changes in the new version. See MDL-34028 for example.

== See also ==

* Using Moodle [http://moodle.org/mod/forum/view.php?f=26 Languages forum]

Using Moodle forum discussions:
* [http://moodle.org/mod/forum/discuss.php?d=131927#p604462 Edited Strings Not Visible]
* [https://moodle.org/mod/forum/discuss.php?d=316623#unread Months names in Arabic language pack]

[[Category:FAQ]]

[[fr:FAQ de langue]]
[[de:Sprache FAQ]]
[[es:Idioma FAQ]]

Portfolios

2015-12-07T16:02:07Z

Marycooch: emoved confusing ref

{{Managing content}}
Portfolios in Moodle make it easy for a student to export their work to an external portfolio. For example, student work might include forum posts or assignment submissions that they believe demonstrates their knowledge.

Portfolios are disabled by default in Moodle and must be enabled by a site administrator. See [[Managing portfolios]] for details.

* [[Box portfolio|Box]]
* [[File download]]
* [[Flickr.com portfolio|Flickr.com]]
* [[Google Drive portfolio|Google Drive]]
* [[Picasa portfolio|Picasa]]
* [[Mahara portfolio|Mahara ePortfolio]]
* [[Portfolios FAQ]]

==Exporting to portfolio==

When portfolios are enabled, forum posts and other exportable data (see below) have an export to portfolio icon or link beside them.

To export a forum post to a portfolio

# Click the 'Export to portfolio' link
# Select the portfolio you wish to export to e.g. Google Docs or file download (this step will be skipped if there's only one)
# If prompted, select an export format e.g. HTML
# If file download was selected in step 2, you can then save the file, otherwise you will be given the option to return to the page you were previously viewing or visit your portfolio (certain portfolios only)

{|
| [[File:Forum post for export.png|thumb|1. Forum post for export]]
| [[File:Portfolio export select destination.png|thumb|2. Selecting the export destination]]
| [[File:Portfolio export select format.png|thumb|3. Selecting an export format]]
|}

==Items which may be exported to portfolio==

* Assignment submissions - single and multiple file uploads
* Chat sessions
* Database activity module entries (##export## tag may be added to list and single templates)
* Database activities
* Forum posts
* Glossary entries

==Export formats==

Possible export formats include
* HTML
* [[Development:LEAP2A_Portfolio_Implementation|LEAP2A]], a specification for e-portfolio portability
* Images
* Text
* File

==Managing your own portfolios==
While the administrator determines which portfolios are enabled on the site in [[Managing portfolios]], an individual user can choose which portfolios to display or hide from the preferences page of the user menu top right, in the section "Portfolios."

==See also==

* [[Exabis e-portfolio block]]
* [[Portfolio module]]
* [[Portfolio Plugin for Evernote]]
* [http://www.youtube.com/watch?v=Ic2j6esjPR8 Portfolios in Moodle 2.0 video]
* [http://en.wikipedia.org/wiki/Electronic_portfolio e-Portfolio] overview at Wikipedia

[[Category:Portfolios]]

[[es:Portafolios]]
[[eu:Portfolioak]]
[[de:Portfolios]]

Portfolios

2015-12-07T15:19:06Z

Marycooch: updated settings

{{Managing content}}
Portfolios in Moodle make it easy for a student to export their work to an external portfolio. For example, student work might include forum posts or assignment submissions that they believe demonstrates their knowledge.

Portfolios are disabled by default in Moodle and must be enabled by a site administrator. See [[Managing portfolios]] for details.

* [[Box portfolio|Box]]
* [[File download]]
* [[Flickr.com portfolio|Flickr.com]]
* [[Google Drive portfolio|Google Drive]]
* [[Picasa portfolio|Picasa]]
* [[Mahara portfolio|Mahara ePortfolio]]
* [[Portfolios FAQ]]

==Exporting to portfolio==

When portfolios are enabled, forum posts and other exportable data (see below) have an export to portfolio icon or link beside them.

To export a forum post to a portfolio

# Click the 'Export to portfolio' link
# Select the portfolio you wish to export to e.g. Google Docs or file download (this step will be skipped if there's only one)
# If prompted, select an export format e.g. HTML
# If file download was selected in step 2, you can then save the file, otherwise you will be given the option to return to the page you were previously viewing or visit your portfolio (certain portfolios only)

{|
| [[File:Forum post for export.png|thumb|1. Forum post for export]]
| [[File:Portfolio export select destination.png|thumb|2. Selecting the export destination]]
| [[File:Portfolio export select format.png|thumb|3. Selecting an export format]]
|}

==Items which may be exported to portfolio==

* Assignment submissions - single and multiple file uploads
* Chat sessions
* Database activity module entries (##export## tag may be added to list and single templates)
* Database activities
* Forum posts
* Glossary entries

==Export formats==

Possible export formats include
* HTML
* [[Development:LEAP2A_Portfolio_Implementation|LEAP2A]], a specification for e-portfolio portability
* Images
* Text
* File

PDF is available for File Download.

==Managing your own portfolios==
While the administrator determines which portfolios are enabled on the site in [[Managing portfolios]], an individual user can choose which portfolios to display or hide from the preferences page of the user menu top right, in the section "Portfolios."

==See also==

* [[Exabis e-portfolio block]]
* [[Portfolio module]]
* [[Portfolio Plugin for Evernote]]
* [http://www.youtube.com/watch?v=Ic2j6esjPR8 Portfolios in Moodle 2.0 video]
* [http://en.wikipedia.org/wiki/Electronic_portfolio e-Portfolio] overview at Wikipedia

[[Category:Portfolios]]

[[es:Portafolios]]
[[eu:Portfolioak]]
[[de:Portfolios]]

Portfolios

2015-12-07T15:14:25Z

Marycooch: pdf file download

{{Managing content}}
Portfolios in Moodle make it easy for a student to export their work to an external portfolio. For example, student work might include forum posts or assignment submissions that they believe demonstrates their knowledge.

Portfolios are disabled by default in Moodle and must be enabled by a site administrator. See [[Managing portfolios]] for details.

* [[Box portfolio|Box]]
* [[File download]]
* [[Flickr.com portfolio|Flickr.com]]
* [[Google Drive portfolio|Google Drive]]
* [[Picasa portfolio|Picasa]]
* [[Mahara portfolio|Mahara ePortfolio]]
* [[Portfolios FAQ]]

==Exporting to portfolio==

When portfolios are enabled, forum posts and other exportable data (see below) have an export to portfolio icon or link beside them.

To export a forum post to a portfolio

# Click the 'Export to portfolio' link
# Select the portfolio you wish to export to e.g. Google Docs or file download (this step will be skipped if there's only one)
# If prompted, select an export format e.g. HTML
# If file download was selected in step 2, you can then save the file, otherwise you will be given the option to return to the page you were previously viewing or visit your portfolio (certain portfolios only)

{|
| [[File:Forum post for export.png|thumb|1. Forum post for export]]
| [[File:Portfolio export select destination.png|thumb|2. Selecting the export destination]]
| [[File:Portfolio export select format.png|thumb|3. Selecting an export format]]
|}

==Items which may be exported to portfolio==

* Assignment submissions - single and multiple file uploads
* Chat sessions
* Database activity module entries (##export## tag may be added to list and single templates)
* Database activities
* Forum posts
* Glossary entries

==Export formats==

Possible export formats include
* HTML
* [[Development:LEAP2A_Portfolio_Implementation|LEAP2A]], a specification for e-portfolio portability
* Images
* Text
* File

PDF is available for File Download.

==Managing your own portfolios==
While the administrator determines which portfolios are enabled on the site in [[Managing portfolios]], an individual user can choose which portfolios to display or hide from ''Settings>My profile settings>Portfolios>Configure'' and can see the record of all items exported from ''Settings>My profile settings>Portfolios>Transfer logs''

{|
| [[File:portfoliosettingsprofile.png|thumb|Managing your own portfolios]]
| [[File:transferlogs.png|thumb|Viewing the record of exports to portfolios]]

|}

==See also==

* [[Exabis e-portfolio block]]
* [[Portfolio module]]
* [[Portfolio Plugin for Evernote]]
* [http://www.youtube.com/watch?v=Ic2j6esjPR8 Portfolios in Moodle 2.0 video]
* [http://en.wikipedia.org/wiki/Electronic_portfolio e-Portfolio] overview at Wikipedia

[[Category:Portfolios]]

[[es:Portafolios]]
[[eu:Portfolioak]]
[[de:Portfolios]]

Capabilities/moodle/site:uploadusers

2015-11-24T10:26:16Z

Marycooch:

{{Capabilities}}
*This allows a user to [[Upload users|upload users]] via text file in ''Site administration > Users > Accounts > Upload users''
*This capability is allowed for the default manager role only
*This capability can only be applied in the system context i.e. via a system role

[[Category:Accounts]]
[[Category:Capabilities|Site]]

[[eu:Capabilities/moodle/site:uploadusers]]

Participation report

2015-11-23T11:39:10Z

Marycooch: removed resolved tracker issue

{{Course reports}}
A participation report for a particular activity can be generated by a manager, teacher or non-editing teacher (or any other user with the capability [[Capabilities/report/participation:view|report/participation:view]]) in ''Administration > Course administration > Reports > Course participation''.

[[Image:Participation_report_example.jpg]]

The definition of View and Post for the selected activity type will be given on screen.

For example:
*Forum View: View Discussion, Search, Forum, Forums, Subscribers
*Forum Post: Add Discussion, Add Post, Delete Discussion, Delete Post, Move Discussion, Prune Post, Update Post

An extremely useful feature of the participation report is the option to send a message to all students who have not completed a certain action. Other options with selected users are to add a note or extend enrolment.

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

[[es:Reporte de participación]]
[[fr:Rapport de participation]]
[[de:Kursbeteiligung]]

Talk:Decimal separator

2015-11-18T09:40:39Z

Marycooch: reply to German

Hi German
Just thinking this page might be better in the developer docs. Would you like to move it there or shall I? (Also thinking about the 3.0 documentation)
--[[User:Mary Cooch|Mary Cooch]] ([[User talk:Mary Cooch|talk]]) 22:05, 17 November 2015 (AWST)
Hi Mary
Please go ahead and move it yourself, as long as all pages that linked to it will still be linked to the new location. [[User:German Valero|German Valero]] ([[User talk:German Valero|talk]])

Hi German - hopefully this should do it. --[[User:Mary Cooch|Mary Cooch]] ([[User talk:Mary Cooch|talk]]) 17:40, 18 November 2015 (AWST)

Decimal separator

2015-11-18T09:39:47Z

Marycooch: redirecting

#REDIRECT [[dev:Decimal separator]]

Decimal separator

2015-11-18T09:29:08Z

Marycooch: moved page WIP

This page has now been moved to the Developer documentation: [https://docs.moodle.org/dev/Decimal_separator Decimal separator]

Forum FAQ

2015-11-18T09:06:49Z

Marycooch: I meant copied from 3.0 docs

{{Forum}}
==How can I easily see which posts I have read and not read?==
#Go to the user menu (top right) and select 'Preferences'.
#Click 'Forum preferences' and for 'Forum tracking' select: ''Yes; highlight new posts for me''
#Unread posts will now display on your [[Dashboard]] and in a forum itself you will be see which posts are read and unread.

[[File:forumtracking2.png]]

==Why are students unable to post in the forum?==

The most likely reason is that the forum is a [[News forum]] i.e. a special forum for general announcements which is automatically created for each course, and which by default only teachers and administrators can post in.

To create a standard forum in which students can post, turn editing on for the course, click the 'Add an activity or resource' link and then choose Forum.

Students may also be unable to post to a forum where a [[Forum_settings#Common_module_settings|Group Mode]] other than 'No Groups' has been used but the student is not a member of any group in the course. They will see the message "Adding discussions to this forum requires group membership". In this case, either add the student to a [[Groups|group]] or change the [[Forum_settings#Common_module_settings|Group Mode]] to 'No Groups'.

==How do I enable students to rate forum posts?==

In ''Administration > Forum administration > Permissions'' click the + symbol opposite the capability to rate posts and allow the role of student.

===How can I have a 'Like' button for my forum discussions?===

*From ''Course administration>Grades>Scales'' add a new scale with just one item. This could be 'Like' or it could be 'Useful' for example.
*Enable ratings in your forum and if you want students to 'like' the posts, in ''Administration > Forum administration > Permissions'' click the + symbol opposite the capability to rate posts and allow the role of student.

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

==Why can I not get ratings to work on my forums?==
Assuming you have followed the instructions above correctly and still cannot see ratings, then check you have json support enabled on your server. You can see this in ''Settings>Site administration>Server>PHP info.''

[[File:Json.png]]

See also this discussion:[ http://moodle.org/mod/forum/discuss.php?d=170563]

==How can I create a teacher-only forum?==

A teacher/tutor-only forum may be added to a course by creating a hidden forum. Teachers are able to view hidden course activities whereas students cannot.

==My users can't add attachments to my forum, either with drag and drop or with the file picker.==

Check that in the forum settings that you have changed the maximum number of attachments allowed to a number greater than 0 ;)

==How can I remove the news forum from a course?==

#Delete the news forum from the course homepage.
#In ''Administration > Course administration > Edit settings'' set "News items to show" to 0.
#Delete the Latest news block.

==How can I remove test messages from a new forum?==
There are several options ([https://moodle.org/mod/forum/discuss.php?d=95470#p421687 Here is a nice graphic]). Remember you can
*Move the discussion/thread to another forum
*Edit the post with your moderator powers
*Delete the post with your moderator powers
*Split the thread at a particular post and move it to another thread
*Split>move>delete your test messages.

==How can I set a display period for news forum announcements?==

Timed posts are disabled by default, but the feature can be enabled by checking the ''forum_enabletimedposts'' checkbox in ''Administration > Site administration > Plugins > Activity modules > Forum''. Timed posts can then be created by users with the [[Capabilities/mod/forum:viewhiddentimedposts|capability to view hidden timed posts]] (normally managers and teachers).

==Why are email copies of forum posts not being sent?==

The most likely reason is that the cron is not set up. Please refer to the [[Cron|cron instructions]].

Tips:
* Try the default settings in ''Settings > Site administration > Plugins > Message outputs > Email''. This generally works.
*Make sure that 'Allow user to select character set' in ''Settings > Site administration > Plugins > Message outputs > Email'' is set to No.

==How do I enable guests to post in a forum?==

It's not possible to enable guests to post in a forum, though there is a workaround. Please see [[Forum poster role]] for details.

==How can I close/archive a forum?==
*You might want to do this if, for example, you want to put an end to a student discussion topic but still want them to be able to see posts which had been made without being able to reply any more.

*In ''Administration > Forum administration > Permissions'' click the Prevent icon (X) for the student role for the capabilites 'Start new discussions' and 'Reply to posts'.

{|
|[[File:forum-permissions-page1.gif|thumb|The screen and relevant capabilities. (Click to enlarge]]
|}

'''NOTE:''' If you are a teacher in a course, you should be able to do this by default, but if you don't see these options, ask your admin to do the following:
#Go to ''Administration > Site Administration > Users > Permissions > Define roles''
#Edit the teacher role and change the capability moodle/role:safeoverride to allow
#Click the button "Save changes"
#Click the tab "Allow role overrides" (in ''Settings > Site administration > Users > Permissions > Define roles'')
#Check the appropriate box(s) in the teacher row to set which role(s) they can override. Most likely it will just be the student role, so check the box where the teacher row intersects with the student column
#Click the button "Save changes"

To make a single thread read only, you need a forum which has already been closed/archived. Move the the thread to this read-only forum.

==How can I quarantine a forum post?==
If a student makes an inappropriate post, rather than deleting it, you can "quarantine" it by sending it to a hidden forum and then alerting your superior and the child's guardians. To do this you first need to create a forum "Hidden forum for Offensive Posts" (for example) and hide it with its eye.
**Find the offensive post and click 'split' (between 'edit' and 'delete')
**This will take you to a second page where you will be asked to verify the split. Confirm it by pressing the 'split' button near the top of the page.
**The post(s) will now be split. You should see the post/discussion individually on a separate page. In the right-hand corner will be a dropdown bar and a button that says 'move.'
**Choose 'Hidden Forum for Offensive Posts' in the dropdown and click 'move.'

Make sure you inform the child why their post has been quarantined, as well as your superior and the child's guardians.
''
(with thanks to Ben Reynolds)''

==Can I set up forum moderation or an approval process before a post appears?==
Not in core Moodle.
*Check out the tracker item https://tracker.moodle.org/browse/CONTRIB/component/10440
*And https://tracker.moodle.org/browse/CONTRIB-2260
*If anyone discovers a plugin to allow this, please post details

==Can I subscribe to just one discussion in a forum?==

Yes. Please see [[Forum settings]]

==How can I receive forum emails in digest form?==

A daily digest of either complete forum posts or with subjects only can be enabled in ''Settings > My profile settings > Edit profile''.

==How can I allow students to add new questions in a Q & A forum type?==

Only teachers and managers by default see the "add a new question" button. If you wish students to be able to add new questions, they need to be given the capability [[Capabilities/mod/forum:addquestion|mod/forum:addquestion]]

==How can I make sure my students are notified of forum posts?==

For students to be notified of forum posts, they need to be ''subscribed'' to the forum. A teacher can choose to force subscription on a particular forum either initially (auto subscription) or permanently (forced subscription) using the subscription mode setting. See the section on subscription mode in [[Forum settings]] for further details.

A teacher can also subscribe selected students to the forum via ''Settings > Forum administration > Show/edit current subscribers''.

==How can I change the 'From' address for forum notifications sent via email?==

By default, a user's email is set as the 'From' address for forum notifications (unless the user has hidden their email address in their profile) so that recipients can choose to reply personally rather than via the forum. To set noreply@yourmoodlesite.org as 'From' address for all forum notification emails, untick the forum_replytouser checkbox in ''Administration > Site administration > Plugins > Activity modules > Forum''.

==How can I remove the words "Site news"?==
You can change the words to something else from ''Administration>Forum administration>Edit settings'' but to have no words at all - and without touching the code - do the following:
*As admin go to ''Administration>Site administration>Appearance>HTML settings'' and uncheck/untick ''Remove HTML tags from all activity names''
*Go to ''Administration>Forum administration<Edit settings'' (for the site news) and type:
[[File:sitenewsname.png]]

*Save. What this does is code a space into the name field so Moodle thinks there is something in the required field - but that something is a space, not words.
==Can I have different email digests for different forums?==

This is possible, although there is not currently a setting for it. In the course you wish to manage the daily digests, type into your browser ''http://YOURMOODLESITE/mod/forum/index.php?id=2'' (where ''YOURMOODLESITE'' is your Moodle and the ''=number'' is the course ID) This will bring you to the index page of all your subscribed forums and you can specify how you want to receive notifications from there.
{|
|[[File:26forumdigest.png|thumb|Per forum digest settings]]
|}

==How can a teacher see all of a student's forum posts in a course?==
If a teacher clicks on the profile of a particular student, for example via the Participants link, they can then access a link ''Forum posts'' from the Navigation block. Expanding this link will offer the option either to see all posts or any discussions started by that student.

[[File:studentforumposts.png]]

==How can a user see all their forum posts on Moodle?==
A user can view all their forum posts by going to the Navigation block and clicking ''My profile>Forum posts.'' Expanding this link will offer the option either to see all posts or any discussions started.

[[File:seeallforumposts.png]]

==How can I remove a rating from a forum post?==
It is not currently possible to remove a rating which might have been made by mistake or by malice. However, if a certain poster gives inappropriate ratings on a regular basis, it is possible to create a custom system role preventing them from rating posts and applying this role to the specified posters.

==See also==

* Using Moodle [http://moodle.org/mod/forum/view.php?f=116 Forum module forum]

Using Moodle forum discussions:

* [http://moodle.org/mod/forum/discuss.php?d=148055 Ability to post anonymously]
* [http://moodle.org/mod/forum/discuss.php?d=178331 How to resend forum posts]
* [http://moodle.org/mod/forum/discuss.php?d=196698 Discussion Count]

[[Category:FAQ]]
[[de:Forum FAQ]]
[[fr:FAQ sur le forum]]
[[es:Foro FAQ]]

Forum FAQ

2015-11-18T09:06:19Z

Marycooch: copied from 2.9 docs

{{Forum}}
==How can I easily see which posts I have read and not read?==
#Go to the user menu top right and select 'Preferences'.
#Click 'Forum preferences' and for 'Forum tracking' select: ''Yes; highlight new posts for me''
#Unread posts will now display on your [[Dashboard]] and in a forum itself you will be see which posts are read and unread.

[[File:forumtracking2.png]]

==Why are students unable to post in the forum?==

The most likely reason is that the forum is a [[News forum]] i.e. a special forum for general announcements which is automatically created for each course, and which by default only teachers and administrators can post in.

To create a standard forum in which students can post, turn editing on for the course, click the 'Add an activity or resource' link and then choose Forum.

Students may also be unable to post to a forum where a [[Forum_settings#Common_module_settings|Group Mode]] other than 'No Groups' has been used but the student is not a member of any group in the course. They will see the message "Adding discussions to this forum requires group membership". In this case, either add the student to a [[Groups|group]] or change the [[Forum_settings#Common_module_settings|Group Mode]] to 'No Groups'.

==How do I enable students to rate forum posts?==

In ''Administration > Forum administration > Permissions'' click the + symbol opposite the capability to rate posts and allow the role of student.

===How can I have a 'Like' button for my forum discussions?===

*From ''Course administration>Grades>Scales'' add a new scale with just one item. This could be 'Like' or it could be 'Useful' for example.
*Enable ratings in your forum and if you want students to 'like' the posts, in ''Administration > Forum administration > Permissions'' click the + symbol opposite the capability to rate posts and allow the role of student.

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

==Why can I not get ratings to work on my forums?==
Assuming you have followed the instructions above correctly and still cannot see ratings, then check you have json support enabled on your server. You can see this in ''Settings>Site administration>Server>PHP info.''

[[File:Json.png]]

See also this discussion:[ http://moodle.org/mod/forum/discuss.php?d=170563]

==How can I create a teacher-only forum?==

A teacher/tutor-only forum may be added to a course by creating a hidden forum. Teachers are able to view hidden course activities whereas students cannot.

==My users can't add attachments to my forum, either with drag and drop or with the file picker.==

Check that in the forum settings that you have changed the maximum number of attachments allowed to a number greater than 0 ;)

==How can I remove the news forum from a course?==

#Delete the news forum from the course homepage.
#In ''Administration > Course administration > Edit settings'' set "News items to show" to 0.
#Delete the Latest news block.

==How can I remove test messages from a new forum?==
There are several options ([https://moodle.org/mod/forum/discuss.php?d=95470#p421687 Here is a nice graphic]). Remember you can
*Move the discussion/thread to another forum
*Edit the post with your moderator powers
*Delete the post with your moderator powers
*Split the thread at a particular post and move it to another thread
*Split>move>delete your test messages.

==How can I set a display period for news forum announcements?==

Timed posts are disabled by default, but the feature can be enabled by checking the ''forum_enabletimedposts'' checkbox in ''Administration > Site administration > Plugins > Activity modules > Forum''. Timed posts can then be created by users with the [[Capabilities/mod/forum:viewhiddentimedposts|capability to view hidden timed posts]] (normally managers and teachers).

==Why are email copies of forum posts not being sent?==

The most likely reason is that the cron is not set up. Please refer to the [[Cron|cron instructions]].

Tips:
* Try the default settings in ''Settings > Site administration > Plugins > Message outputs > Email''. This generally works.
*Make sure that 'Allow user to select character set' in ''Settings > Site administration > Plugins > Message outputs > Email'' is set to No.

==How do I enable guests to post in a forum?==

It's not possible to enable guests to post in a forum, though there is a workaround. Please see [[Forum poster role]] for details.

==How can I close/archive a forum?==
*You might want to do this if, for example, you want to put an end to a student discussion topic but still want them to be able to see posts which had been made without being able to reply any more.

*In ''Administration > Forum administration > Permissions'' click the Prevent icon (X) for the student role for the capabilites 'Start new discussions' and 'Reply to posts'.

{|
|[[File:forum-permissions-page1.gif|thumb|The screen and relevant capabilities. (Click to enlarge]]
|}

'''NOTE:''' If you are a teacher in a course, you should be able to do this by default, but if you don't see these options, ask your admin to do the following:
#Go to ''Administration > Site Administration > Users > Permissions > Define roles''
#Edit the teacher role and change the capability moodle/role:safeoverride to allow
#Click the button "Save changes"
#Click the tab "Allow role overrides" (in ''Settings > Site administration > Users > Permissions > Define roles'')
#Check the appropriate box(s) in the teacher row to set which role(s) they can override. Most likely it will just be the student role, so check the box where the teacher row intersects with the student column
#Click the button "Save changes"

To make a single thread read only, you need a forum which has already been closed/archived. Move the the thread to this read-only forum.

==How can I quarantine a forum post?==
If a student makes an inappropriate post, rather than deleting it, you can "quarantine" it by sending it to a hidden forum and then alerting your superior and the child's guardians. To do this you first need to create a forum "Hidden forum for Offensive Posts" (for example) and hide it with its eye.
**Find the offensive post and click 'split' (between 'edit' and 'delete')
**This will take you to a second page where you will be asked to verify the split. Confirm it by pressing the 'split' button near the top of the page.
**The post(s) will now be split. You should see the post/discussion individually on a separate page. In the right-hand corner will be a dropdown bar and a button that says 'move.'
**Choose 'Hidden Forum for Offensive Posts' in the dropdown and click 'move.'

Make sure you inform the child why their post has been quarantined, as well as your superior and the child's guardians.
''
(with thanks to Ben Reynolds)''

==Can I set up forum moderation or an approval process before a post appears?==
Not in core Moodle.
*Check out the tracker item https://tracker.moodle.org/browse/CONTRIB/component/10440
*And https://tracker.moodle.org/browse/CONTRIB-2260
*If anyone discovers a plugin to allow this, please post details

==Can I subscribe to just one discussion in a forum?==

Yes. Please see [[Forum settings]]

==How can I receive forum emails in digest form?==

A daily digest of either complete forum posts or with subjects only can be enabled in ''Settings > My profile settings > Edit profile''.

==How can I allow students to add new questions in a Q & A forum type?==

Only teachers and managers by default see the "add a new question" button. If you wish students to be able to add new questions, they need to be given the capability [[Capabilities/mod/forum:addquestion|mod/forum:addquestion]]

==How can I make sure my students are notified of forum posts?==

For students to be notified of forum posts, they need to be ''subscribed'' to the forum. A teacher can choose to force subscription on a particular forum either initially (auto subscription) or permanently (forced subscription) using the subscription mode setting. See the section on subscription mode in [[Forum settings]] for further details.

A teacher can also subscribe selected students to the forum via ''Settings > Forum administration > Show/edit current subscribers''.

==How can I change the 'From' address for forum notifications sent via email?==

By default, a user's email is set as the 'From' address for forum notifications (unless the user has hidden their email address in their profile) so that recipients can choose to reply personally rather than via the forum. To set noreply@yourmoodlesite.org as 'From' address for all forum notification emails, untick the forum_replytouser checkbox in ''Administration > Site administration > Plugins > Activity modules > Forum''.

==How can I remove the words "Site news"?==
You can change the words to something else from ''Administration>Forum administration>Edit settings'' but to have no words at all - and without touching the code - do the following:
*As admin go to ''Administration>Site administration>Appearance>HTML settings'' and uncheck/untick ''Remove HTML tags from all activity names''
*Go to ''Administration>Forum administration<Edit settings'' (for the site news) and type:
[[File:sitenewsname.png]]

*Save. What this does is code a space into the name field so Moodle thinks there is something in the required field - but that something is a space, not words.
==Can I have different email digests for different forums?==

This is possible, although there is not currently a setting for it. In the course you wish to manage the daily digests, type into your browser ''http://YOURMOODLESITE/mod/forum/index.php?id=2'' (where ''YOURMOODLESITE'' is your Moodle and the ''=number'' is the course ID) This will bring you to the index page of all your subscribed forums and you can specify how you want to receive notifications from there.
{|
|[[File:26forumdigest.png|thumb|Per forum digest settings]]
|}

==How can a teacher see all of a student's forum posts in a course?==
If a teacher clicks on the profile of a particular student, for example via the Participants link, they can then access a link ''Forum posts'' from the Navigation block. Expanding this link will offer the option either to see all posts or any discussions started by that student.

[[File:studentforumposts.png]]

==How can a user see all their forum posts on Moodle?==
A user can view all their forum posts by going to the Navigation block and clicking ''My profile>Forum posts.'' Expanding this link will offer the option either to see all posts or any discussions started.

[[File:seeallforumposts.png]]

==How can I remove a rating from a forum post?==
It is not currently possible to remove a rating which might have been made by mistake or by malice. However, if a certain poster gives inappropriate ratings on a regular basis, it is possible to create a custom system role preventing them from rating posts and applying this role to the specified posters.

==See also==

* Using Moodle [http://moodle.org/mod/forum/view.php?f=116 Forum module forum]

Using Moodle forum discussions:

* [http://moodle.org/mod/forum/discuss.php?d=148055 Ability to post anonymously]
* [http://moodle.org/mod/forum/discuss.php?d=178331 How to resend forum posts]
* [http://moodle.org/mod/forum/discuss.php?d=196698 Discussion Count]

[[Category:FAQ]]
[[de:Forum FAQ]]
[[fr:FAQ sur le forum]]
[[es:Foro FAQ]]

Talk:Decimal separator

2015-11-17T14:05:54Z

Marycooch: comment about moving page

Quiz FAQ

2015-11-17T13:29:06Z

Marycooch: /* Workarounds for allowing guests to see a quiz */

{{Quiz}}

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

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

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

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

[[File:quizgroupoverride.png]]

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

==Is there a nice way to print a copy of a quiz?==
{{New features}}
Yes - use your browser printer option (for example by right-clicking and selecting Print) When a student prints their finished quiz, responses and feedback will also be printed.

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

===Other printing options===

* The [http://www.academic-moodle-cooperation.org Academic Moodle Cooperation] of the University of Vienna and the Vienna University of Technology have contributed the [[mod/offlinequiz/mod| Offline quiz activity]] for Moodle 2.6, available from the [https://moodle.org/plugins/view.php?plugin=mod_offlinequiz Moodle plugins database] (Moodle 2.2 and 2.5 versions are available via Github, and a 2.8 version will probably appear soon). This MC Offline quiz module (mod/offlinequiz) adds paper-and-pencil multiple-choice quizzes to Moodle. In offline quizzes students mark answers to questions on a sheet of paper (the answer form).
* See [https://github.com/bumoodle/moodle-quiz_papercopy https://github.com/bumoodle/moodle-quiz_papercopy] - Paper Copy quiz report for Moodle - allows an instructor to create and grade printable copies of Moodle Quizzes
* Eoin Campbell has a plugin that may be usefull here: https://moodle.org/plugins/view.php?plugin=qformat_htmltable
* See this [https://moodle.org/plugins/view.php?plugin=qformat_wordtable Word table format plugin] for exporting questions (including images) in a question bank into a Word file

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

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

If this is not the case think carefully about how to handle the graded attempts.

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

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

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

[[File:quizfilter.png]]

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

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

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

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

==Can I have a quiz that is not graded?==

Yes:

# On the quiz editing page, set the score for each question, and the total score for the quiz to 0.
# On the quiz settings page, there is a grid of check-boxes. Turn off all the ones in the score column.

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

Remember you can tell gradebook not to include the quiz.

==How do I allow a person to retake a quiz if I have it set for 1 attempt?==
*In the Quiz administration settings block, there is a link "user overrides".
*Click this link and you can change the allowed number of attempts for that user.
[[File:quizuseroverride.png]]

==How can I give particular students extra time in a timed quiz?==
*In the Quiz administration settings block there is a link "user overrides"
*Click this link and you will be able to choose one or more users and change the timing of their quiz

[[File:quizuseroverride.png]]

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

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

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

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

See [[Quiz submission notification]].

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

This is difficult to implement for technical reasons.

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

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

If you would like to see this implemented, please vote for MDL-17892.

=== Workarounds for allowing guests to see a quiz===
* A workaround is to create a visitor account, say with username = guest, password = visitor, for everyone to share.

==Can you explain the error The number of random questions required is more than are still available in the category!==

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

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

[[File:quizemail.png]]

==Can I download the quiz questions in a non-Moodle format?==
You might want to keep a local copy of quiz questions as evidence. While Moodle doesn't offer a built-in method of doing this, suggestions include:
#previewing the quiz, getting to the review page and from your computer, choosing "Save as...webpage complete" and
#exporting the question as Moodle XML, or GIFT format. If you open either of those files in a text-editor, you should be able to see most details of each question. Not very pretty, but accurate.

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

[[File:flag.png]]

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

==How do I create system-wide question categories?==
* As an administrator or user with system permissions, go to ''Question bank>categories'' in any course.
*Using the "Add category form" at the bottom of the page, set the parent of the new category to be the system context.

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

For example using the Afterburner theme: Site Administration >Appearance >Themes >Afterburner and enter this in the CSS code area:

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

There are other css solutions.

==How can I minimise the load on the server while using quizzes?==
*Try to avoid a lot of students starting a quiz at the same time
*Check these discussions:
**https://moodle.org/mod/forum/discuss.php?d=213259
**https://moodle.org/mod/forum/discuss.php?d=215641
**https://moodle.org/mod/forum/discuss.php?d=215130

For other notes on performance with quizzes, see the section 'Performance of different Moodle modules' in [[Performance recommendations]].
==How can I make the quiz timer "float" or move down the page?==
See this forum thread: [https://moodle.org/mod/forum/discuss.php?d=210049 How to make the quiz timer float] for one suggestion.

==Why are images not included when exporting quiz questions?==
Images are only included if you export the questions using Moodle XML format. For all other question export formats (including GIFT), you will get broken images. Please see forum post [https://moodle.org/mod/forum/discuss.php?d=244615 Students not able to see images in exported quiz questions]

==Why does the quiz timer keep counting down when the student is not looking at the quiz?==
It is not possible to stop the timer and start it again. Moodle cannot tell the difference between legitimate reasons for doing this (such as a fire alarm requiring evacuation of the test room) or a student simply using time going to another browser and googling the answers. Nor can Moodle tell if the connection has been lost, although the student does now get a warning MDL-42504

It might be preferable in certain circumstances, such as timed examinations using Quiz, to manually announce the start/end time, rather then rely on the quiz timer.

For further comments see:
* https://moodle.org/mod/forum/discuss.php?d=96194
* https://moodle.org/mod/forum/discuss.php?d=177180
* https://moodle.org/mod/forum/discuss.php?d=237847

==How can a "Never submitted quiz" be submitted?==
Currently there is no way to retrieve an attempt that was "Never Submitted", and get it back into the "In progress" state, but there is a tracker issue MDL-35745. Perhaps the best solution is to plan ahead and set your quiz to set your quiz to be submitted automatically. Failing that, see also this [https://moodle.org/mod/forum/discuss.php?d=212819 forum thread] which suggests:
# Update the quiz : set the "close the quiz" date after today
# Set "When time expires" to "There is a grace period ..."
#Under Grade set "Attempts allowed" to "unlimited"
#Question behavior: Each attempt builds on the last "Yes"
# Invite the students who did not close their exams
# Allow them to start a new attempt, and close it immediately.

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

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

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

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

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

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

===Method 1===
You can use the Preview feature available to you as a teacher as you are making the quiz.

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

===Method 3===
* Set up a Moodle Playground course for your teachers.
* Add teachers with dual role (teacher and student).
* This provides them a place to test things out.
* Teachers can later copy the quiz/assignment/whatever over to their live class.

==How can I prevent a student doing a quiz for another student?==
For some ideas on preventing cheating, see the forum thread [https://moodle.org/mod/forum/discuss.php?d=271100#p1168345 User dependent locking and unlocking of quizzes].

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

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

==How can students upload images to an Essay question?==
When creating the question, in the section ''Response format'', choose "HTML editor + uploaded files."

==I would like to know if there is such a thing like "quiz as video overlay" in moodle some where?==
If you use [http://discover.techsmith.com/try-camtasia/?gclid=CJGjxND588UCFZAAaQodcRcA8w Camtasia], you can insert questions into the video itself, then export it as a [[SCORM module|SCORM]] package and bring it into Moodle. The quiz questions will automatically be added to the gradebook. See [https://moodle.org/mod/forum/discuss.php?d=314580#unread this forum post].

==Is there a way to make a face-to-face quiz with all students answering the questions at the same time?==
* See this [https://moodle.org/plugins/view/mod_activequiz Active quiz optional plugin], which is an enhanced plugin, based on the original [https://moodle.org/plugins/view/mod_realtimequiz Realtime quiz optional plugin].

==Is there a way to prevent students who passed a quiz from reattempting it?==
Use the [https://moodle.org/plugins/view/quizaccess_reattemptchecker Reattempt checker] quiz access rule plugin.

==How can I make a neater more beautiful quiz?==
You can move the question information that is usually on a left block to a horizontal position above the question text and thus have a wider area for your question as the following screen:

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

The CSS changes used were:
.que .info {
float: none;
width: auto;
}
.que .info > div {
margin-left: 15px;
margin-right: 15px;
}
.que .info > div {
display: inline;
}
.que .content {
margin: 0 0 0 0;
width: auto;
}
.que .info {
background-color: #eee;
border: 1px solid #bce8f1;
border-radius: 4px;
margin-bottom: -5px;
padding: 8px;
}
.que h3.no {
display: inline;
font-size: 12px;
line-height: 1;
margin-left: 10px;
}

* To make it look like one block you should change:
- border: 1px solid #bce8f1;
- margin-bottom: -5px;

* See the [https://moodle.org/mod/forum/discuss.php?d=319464 How can I make quizzes neater and more beautiful?] forum thread
* See the [https://moodle.org/mod/forum/discuss.php?d=237589 How to extend the width of the quiz question area?] and [https://moodle.org/mod/forum/discuss.php?d=276651 using Essential theme how to move info div in quiz attempt section to the top of question] forum threads

==See also==
* [[Quiz Time Limit]]

Using Moodle forum discussions:

*[http://moodle.org/mod/forum/discuss.php?d=96326 Removing "Submit all and Finish" button]
*[http://moodle.org/mod/forum/discuss.php?d=141003 How do you keep people from cheating while taking a quiz?]
*[http://moodle.org/mod/forum/discuss.php?d=131325 Scientific notation in quiz answers]
*[http://moodle.org/mod/forum/discuss.php?d=158846 Quiz answers appear in wrong language]
*[http://moodle.org/mod/forum/discuss.php?d=196206 Random Order Override]

Related FAQs:
* [[Import and export FAQ]] - for hints on importing questions
* [[XML FAQ]] - for information on creating and importing questions in Moodle XML format

==External links==
* [http://www.alfiekohn.org/teaching/cheating.htm Who is Cheating Whom] article

[[Category:FAQ]]

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

Talk:Guide for new administrators

2015-11-17T13:27:58Z

Marycooch: removing talk

Lesson settings

2015-11-15T19:50:27Z

Marycooch: Undo revision 120365 by Danielle tilinca (talk)

{{Lesson}}
=Lesson administration settings=

This page explains the settings involved when first creating a lesson.
To add a lesson to your Moodle course page:
*With the editing turned on, in the section you wish to add your lesson, click the "Add an activity or resource" link (or, if not present, the "Add an activity" drop down menu) and choose ''Lesson'' All settings may expanded by clicking the "Expand all" link top right.

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

===Name===
Whatever you type here will form the link learners click on to view the lesson so it is helpful to give it a name that suggests its purpose.

===Description===

Add a description of your lesson here.

===Display description on the course page===
If this box is ticked, the description will appear on the course page just below the name of the lesson.

==Appearance==
(These settings are collapsed by default)
{|
|[[File:lessonappearance.png|thumb|404px|Appearance settings expanded]]
|}
===File pop===
If you want to include a link to a file on the lesson page for students to refer to, upload it here.
===Progress bar===
Choose this to show a bar at the bottom of the page showing how far into the lesson the student has got.
* For lessons containing '''only''' ''Content pages'', once a lesson has been taken to the end, if that same lesson is re-taken, the progress bar will not be "reset", i.e. it will show a 100% progress from page 1!

* For lessons containing ''Question pages'' and set to "Re-take" '''Yes''', the progress bar is always "reset" at 0% upon re-take.

* Note that the Lesson Progress bar only works correctly for lessons with a "straightforward" navigation, such as page 1 -> page 2 -> page n -> end of lesson. It is not guaranteed to work with pages "jumping all over the place".

===Display ongoing score===
Choose this to let students see their score as they work through the lesson.
===Display left menu===
Choose this if you want to show a list of the pages in the Lesson so a student can see what is coming up.
===Minimum grade to display menu===
Choose this if you want the student to go through the lesson once and get a grade before they can (on review) see and navigate through all the different pages.
===Slideshow===

Slideshow height, width and background colour are set for the whole site by an administrator in ''Settings > Site administration > Plugins > Activity modules > Lesson''.

===Maximum Number of Answers===
Here you can set the default number of answer boxes available when you add your question or content pages. For instance, if you are only going to use True/False, you would only need 2. You can change this at any time so it's not crucial.
===Use default feedback===
Choose this if you want to show a set phrase regardless of their answer. If you have set your own default feedback such as "well done; correct" or "never mind; better luck next time" etc it will appear. If you have not, then Moodle's default feedback will appear.

===Link to next activity===
Choose this to give students a link to another activity when they reach the end of the lesson. ''(Note: this can also be achieved using [[Conditional activities]])''
==Availability==
(These settings are collapsed by default)
{|
|[[File:lessontimelimit.png|thumb|470px|Availability settings expanded]]
|}
===Available from/Deadline===
Here you can set a start and end date and time for your Lesson.
===Time limit===
{{New features}}
This allows you to set a time limit on the lesson which can now be seconds, minutes, hours, days or weeks. Students will see a countdown counter in a block as they work.

[[File:lessontimeremaining.png]]

The timer does not stop them doing the lesson when the time is up, but correct answers are no longer scored.

===Password protected lesson===
*Change to "Yes" and enter the password if you want students only to access it when they know the password.

==Prerequisite lesson==
*''Note: You will only see this setting if you have a course with prerequisite lessons upgraded from an earlier version of Moodle.''
*You will see a warning that prerequisites are due to be removed completely.
*Please use access restrictions instead. See [[Conditional activities]] for more information.

==Flow control==
(These settings are collapsed by default)
{|
|[[File:flowcontrol.png|thumb|450px|Flow control settings expanded]]
|}

===Allow Student Review===
This puts a "Review Lesson" button on the last screen of the lesson to encourage the students to navigate through the lesson again from the start.
:Note that the students will not be able to ''change'' their answers, only ''view'' them.

===Provide option to try a question again===
*This displays a button after an incorrectly answered question so that the student can try again (but not get credit for it)
:''TIP:'' Leave this off if you are using essay questions.
===Maximum Number of Attempts===
*Decide here how many times you want students to be able to attempt each question. When they reach the maximum, they will be taken automatically to the next page.
'''''Note:''''' this setting works in combination with the above setting, or independently.

*When 'provide an option to try again' is set to No, students will be able to retake the question as many times as it is set here, with a score penalty.

*When 'provide an option to try again' is set to Yes, then students will be able to retake the question as many times as it set here without a score penalty. In this case an extra dialogue appears.

Consequently when the relevant jump 'this page' is used in wrong answer while the 'provide an option to try again' is set to No and 'maximum number of attempts' is set to 1, a student that will answer wrongly will be moved into the next page, since he/she has the change to try the question just once.

'''''Tip:''''' Ensure you check lesson using a real student account, as the teacher preview or the 'switch role to student' may not give you the exact picture.

===Action after a Correct Answer===
Choose here where you want a student to be sent to if they get a question right. See [[Using Lesson]] for more details on this setting. The options are:
**the next part of the Lesson (default setting)
**a random, unexpected page
**a random page which they have not yet answered.
===Number of pages to show===
You only need this if you have set "Action after a correct answer" to show an unseen or unanswered page. Otherwise, all pages will be seen

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

Set a grade and grade category here, along with a "Grade to pass" which may be connected with [[Activity completion]] and [[Conditional activities]] such that a student will not be able to access a follow up activity until they have obtained the required grade in the lesson.

===Practice lesson===
'''New in 2.9:''' Practice lessons are now saved; this means they will appear in the reports .You must enable the "Retakes allowed" setting if you want students to be able to attempt a practice lesson several times.

'''Note''': If you are upgrading from an earlier version, be aware that all practice lessons will have " Re-takes allowed" set to "Yes" . If you are restoring a practice lesson made before this change, you may need to modify the "Re-takes allowed" setting if needed.

===Custom Scoring===
Use this to give a particular number score (negative or positive) to each answer
===Re-takes allowed===
Choose this if you want your students to be able to do the lesson more than once.
:Note that this setting only applies to lessons containing ''Question pages''. Lessons consisting '''only''' of ''Content pages'' can be re-taken even if 'Re-takes allowed' is set to ''No''.
====Handling of re-take====
If you allow your students to re-take the lesson, then decide here if the grade for all lesson attempts is the mean or the maximum.

:Note that the Question Analysis always uses the answers from the first tries of the lesson. Re-takes by students are ignored.

===Minimum Number of Questions===
Set here the minimum number of questions that will be used to calculate a student's score. Students will be told how many they have answered and how many more they need to answer.
*If you are using Content pages, then set this to 0.
*If you use this setting, then add some explanatory text at the start of the lesson so the student knows how many questions they must answer as a minimum. (They may answer more.

==Common module settings==
(These settings are collapsed by default.)

'''New in 2.9''': The Lesson activity now supports groups and groupings.

See [[Common module settings]]

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

*The Restrict access and Activity completion settings are visible if [[Conditional activities]] and [[Activity completion]] have been enabled in the site and the course.
*Note that in addition to the standard activity completion conditions, the Lesson also has 'Require end reached' and 'Require time spent' criteria . {{New features}}
*To learn more about the Lesson completion conditions, see [[Activity completion settings]].

==User and group overrides==
{{New features}}
When a lesson has been created, it is possible to overrride certain settings for individuals and groups. The settings for this are located in the Lesson administration block:

[[File:lessonoverrides.png]]

It is possible to override passwords, availability/deadline, time limits and question retries and lesson retakes.
Selecting one of the options, for example 'User' will display a button to click. From the next screen you can choose the user or group to override and the settings you wish to override:

[[File:lessonoverrideuser.png]]

When the override is saved, it is displayed on a screen along with any other overrides previously set:

[[File:lessonoverrideexamples.png]]

==Site administration settings==

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

===Slideshow width===
Sets the width of the slideshow only when this feature is enabled in a Lesson's "Change settings".
*Variable name: lesson_slideshowwidth, Default 640.

===Slideshow height===
Sets the height of the slideshow only when this feature is enabled in a Lesson's "Change settings".
*Variable name: lesson_slideshowheight, Default 480.

===Slideshow background colour===
Background colour to for the slideshow if it is enabled.
*Variable name: lesson_slideshowbgcolor, Default #FFFFFF.

===Popup window width===
Sets the width of the popup displayed for a linked media file
*Variable name: lesson_mediawidth, Default 640.

===Popup window height===
Sets the height of the popup displayed for a linked media file
*Variable name: lesson_mediaheight, Default 480.

===Show close button:===
Displays a close button as part of the popup generated for a linked media file
*Variable name: lesson_mediaclose, Default No.

===Number of high scores displayed===
'''NOTE''': This feature is currently broken. Its future is being discussed in MDL-49581

===Maximum number of answers===
Default maximum number of answers per page for site
*Variable name: lesson_maxanswers, Default: 4.

===Action after correct answer===
The default action to take after a correct answer
*Variable name: lesson_defaultnextpage, Default: Normal - follow lesson path

==See also==
*[http://youtu.be/cUDV0WE5ZYY Moodle 2.x Lesson (part 1)] MoodleBites video on YouTube
*[http://youtu.be/Mfj-8w-Ze0A Moodle 2.x Lesson (part 2)] MoodleBites video on YouTube
*[http://youtu.be/jXjqHtgC9c0 Moodle 2.x Lesson (part 3)] MoodleBites video on YouTube

[[de:Lektion konfigurieren]]
[[fr:Ajouter/modifier une leçon]]
[[ja:レッスンの設定]]
[[es:Configuraciones de lección]]

File system repository

2015-11-15T13:03:17Z

Marycooch: /* Setting up an individual file system repository instance */

{{Repositories}}
The file system repository allows access to files which have been uploaded (e.g. via FTP) into designated folders on the server. ''(Note that these folders are '''not''' created inside the Moodle site, but on the server where Moodle is hosted.)''

A file system repository may be available site wide for everyone or within an individual course (set up by admin) or for an individual administrator. See MDL-28656 regarding course and individual repository configuration.

This must be done by a systems admin who has write permissions to the server directories.

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

Once a repository has been created and files uploaded to it, the files can be made available within the file picker for use within a course. There are several steps to take to implement this feature:-

These must be done by a systems admin who has write permissions to the server directories and admin permissions within Moodle.

==Creating folders for your file system repositories==
*Find the moodledata folder on the server
*Inside it, create a folder called "repository"
*Inside that folder, create as many folders as you need, named appropriately.

{|
| [[File:filesystemonserver.png|thumb|250px|Creating repositories on the server]]
|}

*Copy into the appropriate folder the files you want (using FTP, SFTP, shared folder etc.). (The folders can hold all types of files)

== Enabling the File System repository plugin==
*Go to ''Administration > Site administration > Plugins > Repositories > Manage Repositories'';
*Select from the drop down next to File system "Enabled and visible"
''Note'': Ignore the similarly named repository 'Server Files' (enabled by default).

{|
| [[File:filesystemrepo23.png|thumb|350px|Enabling the file system repository]]
|}
*Click the '''Settings''' link..

==Setting up a site-wide file system repository==
Having clicked the "Settings" link as above:
*Scroll down to Repositories instances of the site
*Click ''Create a repository instance''
*Give it a name and (if there are several folders on the server) choose from the dropdown the one you want. Click '''Save.'''
*It will now be available in the file picker in all courses.

{|
| [[File:createinstance23.png|thumb|Creating a new file system repository]]
| [[File:setuprepo23.png|thumb|Selecting and naming the repository]]
|}

''NOTE: Just repeat the process to get more than one site wide file system repository''

==Setting up a repository inside a course==
''NOTE only Moodle admins can do this''

Enable repositories as in the instructions above. On the Settings page:
*Check the top box allowing users to add a repository instance to the course (1 below)
*Go to the desired course and click on “repositories” in the administration block(2 below)
*Scroll down and click "Create File System instance" (3 below)

{|
| [[File:courseinstancerepo.png|thumb|1:Enable course repositories]]
| [[File:coursesettingsrepo1.png|thumb|2:Click "Repositories" in Course admin]]
| [[File:createcourseinstance.png|thumb|3:Click to create an instance in the course]]
|}

*Follow the same process as [[#Setting_up_a_site-wide_file_system_repository|here]]

==Setting up an individual file system repository instance==
''NOTE: Only Moodle admins can do this''

Enable repositories as in the instructions above. On the Settings page:
*Check the top box allowing users to add a repository instance to the user context (1 below)
*Click the user menu >Preferences
*Click on “Repositories”
*Click “Create File System instance”
*Follow the same process as [[#Setting_up_a_site-wide_file_system_repository|here]]
*This will create a personal file system repository connecting just you to a folder on the server (2 below)

{|
| [[File:userinstancerepo.png|thumb|1:Enable user repository instances]]
| [[File:userprivaterepo.png|thumb|2:Adding files from individual repository]]
|}

*Upload any files required by course creators to the appropriate folders

Server permissions are needed here to add via FTP (or other method) the required files.

From this point on the check boxes need not be set - leaving them set just invites people to create a repository instance and then advises them that they do not have sufficient privilges.

===Using a File System repository file===

* A user can now make use of the uploaded files by accessing the repository from within the file picker, creating a resource link to a document, for example. This process copies the uploaded file into Moodle and students may access the resource.

{|
| [[File:newfilerepodisplay1.png|thumb|350px|Adding a file from a file system repository]]
|}

Note that file types are respected (based on file extensions), so if you are adding an image in the editor, then you won't see Office docs (for example) appear in the File Picker.

==Repository capabilities==

There is just one capability, [[Capabilities/repository/filesystem:view|View file system repository]], which is allowed for the default authenticated user role.
This means that if a student is required to upload a file - upload assignment, for example, then the repository files may be browsed. It may be more appropriate for this permission to be changed so that course creators have the capabilty, but not students.

==See also==
*[[File_system_repository_FAQ|File system repository FAQ]]
* [[Restoring file aliases]]
* Overview of [[Repositories|Repositories]]
* [http://www.somerandomthoughts.com/blog/2010/06/15/ftp-files-into-moodle-2-0-with-the-repository-api/ FTP files into Moodle 2.0 with the repository API article from somerandomthoughts.com] including screencast

[[Category:Site administration]]
[[de:Dateisystem-Repository]]
[[es:Repositorio_sistema_de_archivo]]

File system repository

2015-11-15T12:59:21Z

Marycooch: updating

{{Repositories}}
The file system repository allows access to files which have been uploaded (e.g. via FTP) into designated folders on the server. ''(Note that these folders are '''not''' created inside the Moodle site, but on the server where Moodle is hosted.)''

A file system repository may be available site wide for everyone or within an individual course (set up by admin) or for an individual administrator. See MDL-28656 regarding course and individual repository configuration.

This must be done by a systems admin who has write permissions to the server directories.

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

Once a repository has been created and files uploaded to it, the files can be made available within the file picker for use within a course. There are several steps to take to implement this feature:-

These must be done by a systems admin who has write permissions to the server directories and admin permissions within Moodle.

==Creating folders for your file system repositories==
*Find the moodledata folder on the server
*Inside it, create a folder called "repository"
*Inside that folder, create as many folders as you need, named appropriately.

{|
| [[File:filesystemonserver.png|thumb|250px|Creating repositories on the server]]
|}

*Copy into the appropriate folder the files you want (using FTP, SFTP, shared folder etc.). (The folders can hold all types of files)

== Enabling the File System repository plugin==
*Go to ''Administration > Site administration > Plugins > Repositories > Manage Repositories'';
*Select from the drop down next to File system "Enabled and visible"
''Note'': Ignore the similarly named repository 'Server Files' (enabled by default).

{|
| [[File:filesystemrepo23.png|thumb|350px|Enabling the file system repository]]
|}
*Click the '''Settings''' link..

==Setting up a site-wide file system repository==
Having clicked the "Settings" link as above:
*Scroll down to Repositories instances of the site
*Click ''Create a repository instance''
*Give it a name and (if there are several folders on the server) choose from the dropdown the one you want. Click '''Save.'''
*It will now be available in the file picker in all courses.

{|
| [[File:createinstance23.png|thumb|Creating a new file system repository]]
| [[File:setuprepo23.png|thumb|Selecting and naming the repository]]
|}

''NOTE: Just repeat the process to get more than one site wide file system repository''

==Setting up a repository inside a course==
''NOTE only Moodle admins can do this''

Enable repositories as in the instructions above. On the Settings page:
*Check the top box allowing users to add a repository instance to the course (1 below)
*Go to the desired course and click on “repositories” in the administration block(2 below)
*Scroll down and click "Create File System instance" (3 below)

{|
| [[File:courseinstancerepo.png|thumb|1:Enable course repositories]]
| [[File:coursesettingsrepo1.png|thumb|2:Click "Repositories" in Course admin]]
| [[File:createcourseinstance.png|thumb|3:Click to create an instance in the course]]
|}

*Follow the same process as [[#Setting_up_a_site-wide_file_system_repository|here]]

==Setting up an individual file system repository instance==
''NOTE: Only Moodle admins can do this''

Enable repositories as in the instructions above. On the Settings page:
*Check the top box allowing users to add a repository instance to the user context (1 below)
*Click the user menu >Preferences
*Click on “Repositories”
*Click “Create File System instance”
*Follow the same process as [[#Setting_up_a_site-wide_file_system_repository|here]]
*This will create a personal file system repository connecting just you to a folder on the server (3 below)

{|
| [[File:userinstancerepo.png|thumb|1:Enable user repository instances]]
| [[File:userprivaterepo.png|thumb|3:Adding files from individual repository]]
|}

*Upload any files required by course creators to the appropriate folders

Server permissions are needed here to add via FTP (or other method) the required files.

From this point on the check boxes need not be set - leaving them set just invites people to create a repository instance and then advises them that they do not have sufficient privilges.

===Using a File System repository file===

* A user can now make use of the uploaded files by accessing the repository from within the file picker, creating a resource link to a document, for example. This process copies the uploaded file into Moodle and students may access the resource.

{|
| [[File:newfilerepodisplay1.png|thumb|350px|Adding a file from a file system repository]]
|}

Note that file types are respected (based on file extensions), so if you are adding an image in the editor, then you won't see Office docs (for example) appear in the File Picker.

==Repository capabilities==

There is just one capability, [[Capabilities/repository/filesystem:view|View file system repository]], which is allowed for the default authenticated user role.
This means that if a student is required to upload a file - upload assignment, for example, then the repository files may be browsed. It may be more appropriate for this permission to be changed so that course creators have the capabilty, but not students.

==See also==
*[[File_system_repository_FAQ|File system repository FAQ]]
* [[Restoring file aliases]]
* Overview of [[Repositories|Repositories]]
* [http://www.somerandomthoughts.com/blog/2010/06/15/ftp-files-into-moodle-2-0-with-the-repository-api/ FTP files into Moodle 2.0 with the repository API article from somerandomthoughts.com] including screencast

[[Category:Site administration]]
[[de:Dateisystem-Repository]]
[[es:Repositorio_sistema_de_archivo]]

File system repository

2015-11-15T12:57:54Z

Marycooch: updating

{{Repositories}}
The file system repository allows access to files which have been uploaded (e.g. via FTP) into designated folders on the server. ''(Note that these folders are '''not''' created inside the Moodle site, but on the server where Moodle is hosted.)''

A file system repository may be available site wide for everyone or within an individual course (set up by admin) or for an individual administrator. See MDL-28656 regarding course and individual repository configuration.

This must be done by a systems admin who has write permissions to the server directories.

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

Once a repository has been created and files uploaded to it, the files can be made available within the file picker for use within a course. There are several steps to take to implement this feature:-

These must be done by a systems admin who has write permissions to the server directories and admin permissions within Moodle.

==Creating folders for your file system repositories==
*Find the moodledata folder on the server
*Inside it, create a folder called "repository"
*Inside that folder, create as many folders as you need, named appropriately.

{|
| [[File:filesystemonserver.png|thumb|250px|Creating repositories on the server]]
|}

*Copy into the appropriate folder the files you want (using FTP, SFTP, shared folder etc.). (The folders can hold all types of files)

== Enabling the File System repository plugin==
*Go to ''Administration > Site administration > Plugins > Repositories > Manage Repositories'';
*Select from the drop down next to File system "Enabled and visible"
''Note'': Ignore the similarly named repository 'Server Files' (enabled by default).

{|
| [[File:filesystemrepo23.png|thumb|350px|Enabling the file system repository]]
|}
*Click the '''Settings''' link..

==Setting up a site-wide file system repository==
Having clicked the "Settings" link as above:
*Scroll down to Repositories instances of the site
*Click ''Create a repository instance''
*Give it a name and (if there are several folders on the server) choose from the dropdown the one you want. Click '''Save.'''
*It will now be available in the file picker in all courses.

{|
| [[File:createinstance23.png|thumb|Creating a new file system repository]]
| [[File:setuprepo23.png|thumb|Selecting and naming the repository]]
|}

''NOTE: Just repeat the process to get more than one site wide file system repository''

==Setting up a repository inside a course==
''NOTE only Moodle admins can do this''

Enable repositories as in the instructions above. On the Settings page:
*Check the top box allowing users to add a repository instance to the course (1 below)
*Go to the desired course and click on “repositories” in the administration block(2 below)
*Scroll down and click "Create File System instance" (3 below)

{|
| [[File:courseinstancerepo.png|thumb|1:Enable course repositories]]
| [[File:coursesettingsrepo1.png|thumb|2:Click "Repositories" in Course admin]]
| [[File:createcourseinstance.png|thumb|3:Click to create an instance in the course]]
|}

*Follow the same process as [[#Setting_up_a_site-wide_file_system_repository|here]]

==Setting up an individual file system repository instance==
''NOTE: Only Moodle admins can do this''

Enable repositories as in the instructions above. On the Settings page:
*Check the top box allowing users to add a repository instance to the user context (1 below)
*Click the user menu >Profile
*Click on “Repositories” (2 below)
*Click “Create File System instance”
*Follow the same process as [[#Setting_up_a_site-wide_file_system_repository|here]]
*This will create a personal file system repository connecting just you to a folder on the server (3 below)

{|
| [[File:userinstancerepo.png|thumb|1:Enable user repository instances]]
| [[File:profilerepolink.png|thumb|2:Click the Repositories link in profile]]
| [[File:userprivaterepo.png|thumb|3:Adding files from individual repository]]
|}

*Upload any files required by course creators to the appropriate folders

Server permissions are needed here to add via FTP (or other method) the required files.

From this point on the check boxes need not be set - leaving them set just invites people to create a repository instance and then advises them that they do not have sufficient privilges.

===Using a File System repository file===

* A user can now make use of the uploaded files by accessing the repository from within the file picker, creating a resource link to a document, for example. This process copies the uploaded file into Moodle and students may access the resource.

{|
| [[File:newfilerepodisplay1.png|thumb|350px|Adding a file from a file system repository]]
|}

Note that file types are respected (based on file extensions), so if you are adding an image in the editor, then you won't see Office docs (for example) appear in the File Picker.

==Repository capabilities==

There is just one capability, [[Capabilities/repository/filesystem:view|View file system repository]], which is allowed for the default authenticated user role.
This means that if a student is required to upload a file - upload assignment, for example, then the repository files may be browsed. It may be more appropriate for this permission to be changed so that course creators have the capabilty, but not students.

==See also==
*[[File_system_repository_FAQ|File system repository FAQ]]
* [[Restoring file aliases]]
* Overview of [[Repositories|Repositories]]
* [http://www.somerandomthoughts.com/blog/2010/06/15/ftp-files-into-moodle-2-0-with-the-repository-api/ FTP files into Moodle 2.0 with the repository API article from somerandomthoughts.com] including screencast

[[Category:Site administration]]
[[de:Dateisystem-Repository]]
[[es:Repositorio_sistema_de_archivo]]

Quiz FAQ

2015-11-12T18:56:53Z

Marycooch: removing guest preview

{{Quiz}}

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

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

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

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

[[File:quizgroupoverride.png]]

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

==Is there a nice way to print a copy of a quiz?==
{{New features}}
Yes - use your browser printer option (for example by right-clicking and selecting Print) When a student prints their finished quiz, responses and feedback will also be printed.

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

===Other printing options===

* The [http://www.academic-moodle-cooperation.org Academic Moodle Cooperation] of the University of Vienna and the Vienna University of Technology have contributed the [[mod/offlinequiz/mod| Offline quiz activity]] for Moodle 2.6, available from the [https://moodle.org/plugins/view.php?plugin=mod_offlinequiz Moodle plugins database] (Moodle 2.2 and 2.5 versions are available via Github, and a 2.8 version will probably appear soon). This MC Offline quiz module (mod/offlinequiz) adds paper-and-pencil multiple-choice quizzes to Moodle. In offline quizzes students mark answers to questions on a sheet of paper (the answer form).
* See [https://github.com/bumoodle/moodle-quiz_papercopy https://github.com/bumoodle/moodle-quiz_papercopy] - Paper Copy quiz report for Moodle - allows an instructor to create and grade printable copies of Moodle Quizzes
* Eoin Campbell has a plugin that may be usefull here: https://moodle.org/plugins/view.php?plugin=qformat_htmltable
* See this [https://moodle.org/plugins/view.php?plugin=qformat_wordtable Word table format plugin] for exporting questions (including images) in a question bank into a Word file

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

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

If this is not the case think carefully about how to handle the graded attempts.

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

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

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

[[File:quizfilter.png]]

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

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

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

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

==Can I have a quiz that is not graded?==

Yes:

# On the quiz editing page, set the score for each question, and the total score for the quiz to 0.
# On the quiz settings page, there is a grid of check-boxes. Turn off all the ones in the score column.

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

Remember you can tell gradebook not to include the quiz.

==How do I allow a person to retake a quiz if I have it set for 1 attempt?==
*In the Quiz administration settings block, there is a link "user overrides".
*Click this link and you can change the allowed number of attempts for that user.
[[File:quizuseroverride.png]]

==How can I give particular students extra time in a timed quiz?==
*In the Quiz administration settings block there is a link "user overrides"
*Click this link and you will be able to choose one or more users and change the timing of their quiz

[[File:quizuseroverride.png]]

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

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

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

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

See [[Quiz submission notification]].

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

This is difficult to implement for technical reasons.

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

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

If you would like to see this implemented, please vote for MDL-17892.

=== Workarounds for allowing guests to see a quiz===
* A workaround is to create a visitor account, say with username = password = visitor, for everyone to share.

==Can you explain the error The number of random questions required is more than are still available in the category!==

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

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

[[File:quizemail.png]]

==Can I download the quiz questions in a non-Moodle format?==
You might want to keep a local copy of quiz questions as evidence. While Moodle doesn't offer a built-in method of doing this, suggestions include:
#previewing the quiz, getting to the review page and from your computer, choosing "Save as...webpage complete" and
#exporting the question as Moodle XML, or GIFT format. If you open either of those files in a text-editor, you should be able to see most details of each question. Not very pretty, but accurate.

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

[[File:flag.png]]

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

==How do I create system-wide question categories?==
* As an administrator or user with system permissions, go to ''Question bank>categories'' in any course.
*Using the "Add category form" at the bottom of the page, set the parent of the new category to be the system context.

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

For example using the Afterburner theme: Site Administration >Appearance >Themes >Afterburner and enter this in the CSS code area:

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

There are other css solutions.

==How can I minimise the load on the server while using quizzes?==
*Try to avoid a lot of students starting a quiz at the same time
*Check these discussions:
**https://moodle.org/mod/forum/discuss.php?d=213259
**https://moodle.org/mod/forum/discuss.php?d=215641
**https://moodle.org/mod/forum/discuss.php?d=215130

For other notes on performance with quizzes, see the section 'Performance of different Moodle modules' in [[Performance recommendations]].
==How can I make the quiz timer "float" or move down the page?==
See this forum thread: [https://moodle.org/mod/forum/discuss.php?d=210049 How to make the quiz timer float] for one suggestion.

==Why are images not included when exporting quiz questions?==
Images are only included if you export the questions using Moodle XML format. For all other question export formats (including GIFT), you will get broken images. Please see forum post [https://moodle.org/mod/forum/discuss.php?d=244615 Students not able to see images in exported quiz questions]

==Why does the quiz timer keep counting down when the student is not looking at the quiz?==
It is not possible to stop the timer and start it again. Moodle cannot tell the difference between legitimate reasons for doing this (such as a fire alarm requiring evacuation of the test room) or a student simply using time going to another browser and googling the answers. Nor can Moodle tell if the connection has been lost, although the student does now get a warning MDL-42504

It might be preferable in certain circumstances, such as timed examinations using Quiz, to manually announce the start/end time, rather then rely on the quiz timer.

For further comments see:
* https://moodle.org/mod/forum/discuss.php?d=96194
* https://moodle.org/mod/forum/discuss.php?d=177180
* https://moodle.org/mod/forum/discuss.php?d=237847

==How can a "Never submitted quiz" be submitted?==
Currently there is no way to retrieve an attempt that was "Never Submitted", and get it back into the "In progress" state, but there is a tracker issue MDL-35745. Perhaps the best solution is to plan ahead and set your quiz to set your quiz to be submitted automatically. Failing that, see also this [https://moodle.org/mod/forum/discuss.php?d=212819 forum thread] which suggests:
# Update the quiz : set the "close the quiz" date after today
# Set "When time expires" to "There is a grace period ..."
#Under Grade set "Attempts allowed" to "unlimited"
#Question behavior: Each attempt builds on the last "Yes"
# Invite the students who did not close their exams
# Allow them to start a new attempt, and close it immediately.

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

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

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

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

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

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

===Method 1===
You can use the Preview feature available to you as a teacher as you are making the quiz.

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

===Method 3===
* Set up a Moodle Playground course for your teachers.
* Add teachers with dual role (teacher and student).
* This provides them a place to test things out.
* Teachers can later copy the quiz/assignment/whatever over to their live class.

==How can I prevent a student doing a quiz for another student?==
For some ideas on preventing cheating, see the forum thread [https://moodle.org/mod/forum/discuss.php?d=271100#p1168345 User dependent locking and unlocking of quizzes].

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

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

==How can students upload images to an Essay question?==
When creating the question, in the section ''Response format'', choose "HTML editor + uploaded files."

==I would like to know if there is such a thing like "quiz as video overlay" in moodle some where?==
If you use [http://discover.techsmith.com/try-camtasia/?gclid=CJGjxND588UCFZAAaQodcRcA8w Camtasia], you can insert questions into the video itself, then export it as a [[SCORM module|SCORM]] package and bring it into Moodle. The quiz questions will automatically be added to the gradebook. See [https://moodle.org/mod/forum/discuss.php?d=314580#unread this forum post].

==Is there a way to make a face-to-face quiz with all students answering the questions at the same time?==
* See this [https://moodle.org/plugins/view/mod_activequiz Active quiz optional plugin], which is an enhanced plugin, based on the original [https://moodle.org/plugins/view/mod_realtimequiz Realtime quiz optional plugin].

==Is there a way to prevent students who passed a quiz from reattempting it?==
Use the [https://moodle.org/plugins/view/quizaccess_reattemptchecker Reattempt checker] quiz access rule plugin.

==How can I make a neater more beautiful quiz?==
You can move the question information that is usually on a left block to a horizontal position above the question text and thus have a wider area for your question as the following screen:

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

The CSS changes used were:
.que .info {
float: none;
width: auto;
}
.que .info > div {
margin-left: 15px;
margin-right: 15px;
}
.que .info > div {
display: inline;
}
.que .content {
margin: 0 0 0 0;
width: auto;
}
.que .info {
background-color: #eee;
border: 1px solid #bce8f1;
border-radius: 4px;
margin-bottom: -5px;
padding: 8px;
}
.que h3.no {
display: inline;
font-size: 12px;
line-height: 1;
margin-left: 10px;
}

* To make it look like one block you should change:
- border: 1px solid #bce8f1;
- margin-bottom: -5px;

* See the [https://moodle.org/mod/forum/discuss.php?d=319464 How can I make quizzes neater and more beautiful?] forum thread
* See the [https://moodle.org/mod/forum/discuss.php?d=237589 How to extend the width of the quiz question area?] and [https://moodle.org/mod/forum/discuss.php?d=276651 using Essential theme how to move info div in quiz attempt section to the top of question] forum threads

==See also==
* [[Quiz Time Limit]]

Using Moodle forum discussions:

*[http://moodle.org/mod/forum/discuss.php?d=96326 Removing "Submit all and Finish" button]
*[http://moodle.org/mod/forum/discuss.php?d=141003 How do you keep people from cheating while taking a quiz?]
*[http://moodle.org/mod/forum/discuss.php?d=131325 Scientific notation in quiz answers]
*[http://moodle.org/mod/forum/discuss.php?d=158846 Quiz answers appear in wrong language]
*[http://moodle.org/mod/forum/discuss.php?d=196206 Random Order Override]

Related FAQs:
* [[Import and export FAQ]] - for hints on importing questions
* [[XML FAQ]] - for information on creating and importing questions in Moodle XML format

==External links==
* [http://www.alfiekohn.org/teaching/cheating.htm Who is Cheating Whom] article

[[Category:FAQ]]

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

Activity completion settings

2015-11-02T14:29:57Z

Marycooch: screenshot and extra details

{{Activity completion}}
==Activity settings==

Depending on the type of activity, there are different completion requirements. For example, a [[Page|Page]] might have the requirement to ''require view''; a [[Quiz|Quiz]] might have the requirement to ''require grade'' while a [[Forum|Forum]] might have the requirement to ''require posts/discussions/replies''.

<gallery widths="300px">
File:Activity_completion_settings_common.png|Common settings for most graded activities
File:Forumactivitycompletion.png|Forum activity settings
File:24assignmentsubmit.png|Assignment settings
</gallery>

===Completion tracking===
There are three options:

*''Do not indicate activity completion'' - this will not show checks (ticks) next to the activity
*''Students can manually mark the activity as completed'' - students press the check (tick) to change it. (Note: they can do this even without doing the activity!)
*''Show activity as complete when conditions are met'' - the selected completion criteria must be met before the check (tick) will change style

===Require view===

When this option is turned on, students have to view the activity in order to complete it.

* In most cases, clicking the link is enough to 'view' the activity.
* You should usually not turn on the 'view' condition if you have other requirements - this makes extra work for the server and it's unlikely that a student could meet any other conditions without viewing the activity.

===Require grade===

When this option is turned on, students have to get a grade on the activity in order to complete it. For example, a quiz would be marked completed as soon as the user submits it (so long as it doesn't contain any "essay" questions).

It does not matter how well the student did. Getting any grade will mark the activity completed.

====Setting a grade to pass for a quiz====

It is possible to distinguish between 'pass' and 'fail' grades so that a quiz becomes 'completed, passed' or 'completed, not passed' instead of just 'completed'. These results show a different icon and alternative text in ''Course administration >Reports >Activity completion:
''
[[File:quizpassfail.png|thumb|400px|center]]

To set this up, you need to specify the pass value for the quiz activity's individual grade:

# Go to the Quiz settings and in the Grade section, locate the 'Grade to pass' field.
# Enter a grade value (e.g. 5.0)
# Click the 'Save changes' button

'Completed, passed' shows a green tick and 'Completed, not passed' shows a red cross.

Once you have done this, anybody submitting the quiz will receive either the pass or fail completion icon. If the quiz can be taken multiple times, the completion icon will automatically update whenever the grade does.

There is one limitation: this only works if grades are immediately visible to students. The grade must be neither permanently hidden, nor hidden until a certain date. If a grade is hidden then only the standard 'completed' state will be displayed - even once the hidden date has passed.

===Quiz completion settings===

The following settings are specific to the quiz (in addition to the standard ones).
[[File:quizpassinggrade.png|thumb|500px|center]]

====Require passing grade====

If a 'Grade to pass' is set for the quiz then it will be marked complete once the student obtains this grade.

====All available attempts completed====

If a certain number of attempts are allowed, the quiz may be marked complete once the student has done them all (even if, for example, they did not achieve the passing grade.)

===Lesson completion settings===
{{New features}}The following settings are specific to the Lesson activity (in additon to the standard ones)

[[File:newlessonconditions.png]]

====Require end reached====
In order for the lesson to be marked complete, the student must go to the very last page of the lesson.

====Require time spent====
In order for the lesson to be marked complete, the student must stay within the lesson pages for the time specified by the teacher here. The time can range from seconds to weeks. If they finish the lesson sooner, they will see an alert saying they did not reach the minimum time acceptable and may have to repeat the lesson.

[[File:lessonstudentviewrequiretimespent.png|thumb|400px|center|Student message if the condition is not met.]]

===Require submission===

This setting appears in assignments and means that an assignment may be considered as completed once the student has submitted - but before the teacher has had time to grade it.

===Expect completed on===

The date is not shown to students and is only displayed in the [[Activity completion report]].

===Require posts===
This setting is seen in forums. For the forum to be classed as "complete" the student must either start a discussion or reply to a discussion. The number of posts they must make can be specified in the box.

===Require discussions===
This setting is seen in forums. For the forum to be classed as "complete", the student must start a discussion topic. The number of posts they must make can be specified in the box.

===Require replies===
This setting is seen in forums. For the forum to be classed as "complete" the student must reply to a discussion. The number of posts they must make can be specified in the box.

==Locked completion options==

If at least one person has completed an activity, completion options are 'locked'. This is because changing these options may result in unexpected behaviour. For example, if somebody has ticked an activity as manually completed, and you then set it to automatic completion, the activity will become unticked - very confusing for the student who had already ticked it!

:''Tip:'' It is best not to unlock options unless you are sure it won't cause problems - for example, if you know that students don't have access to the course yet, so it will only be staff who have marked the activity completed when testing.

==What happens when you unlock==

Once you unlock options and then click 'Save changes', all completion information for the activity will be deleted and, if possible, regenerated according to the new settings.

* If the new completion option is manual, everyone will be set to 'not completed' regardless of any previous setting.
* If it is automatic then, depending on the options chosen, the system may or may not be able to construct a correct current value for everyone.
** The 'viewed' requirement will not work - even if a student has viewed the activity before, it will not be marked completed until they view it again.
** Most other options will be recalculated successfully.

If you change completion options while a student is logged in, they may not see the changes for some minutes.

==Required site settings==
To use activity completion, the feature needs to be enabled for the site by an administrator as follows:
*In ''Administration > Site administration > [[Advanced_features| Advanced features]]'' check the "Enable completion tracking" box.
*The admin may also set the default completion tracking setting when adding new activities, choosing from 'Do not indicate completion' or ' Use activity default'
{|
|[[File:26defaultactivtycompletion.png|thumb|Selecting the default completion tracking setting]]
|}

* Click the 'Save changes' button

==Required course settings==

''Administration > Course administration > Edit settings'' and look for the ''Completion tracking'' section.

You must enable this setting.

[[Category: Completion]]

[[de:Einstellungen zum Aktivitätsabschluss]]
[[es:Configuraciones de finalización de actividad]]

File:quizpassfail.png

2015-11-02T14:28:12Z

Marycooch:

Using TeX Notation

2015-10-30T10:11:16Z

Marycooch:

{{Filters}}
{{Work in progress}}
TeX ('''/'tɛx/tekh''', often pronounced TeK in English) is a very widespread and popular way of representing Mathematics notation using only characters that you can type on a keyboard (see [https://en.wikipedia.org/wiki/TeX Wikipedia]). This makes it a useful format to use in Moodle, since it can be entered anywhere you can type text, from forum posts to quiz questions.

TeX expressions can be entered in multiple ways:
* typing them directly into texts.
* using the Java-based Dragmath editor in Moodle's TinyMCE editor.
* using the HTML-based equation editor in Moodle's Atto editor (since Moodle 2.7).

Afterwards, TeX expressions are rendered into Mathematics notation:
* using the TeX filter in Moodle, which uses a TeX binary installed on the server to convert expressions into .gif images (or if that is not available, it falls back to a simple built-in mimetex binary).
* using the [[MathJax_filter]] which identifies TeX expressions and uses the Mathjax JS library to render them in browsers at display time (since Moodle 2.7).
* using other third-party solutions.

As you can imagine, the whole field is not simple as we'd like, especially because there are many flavours of TeX and slight variations between tools.

This page focusses only on using TeX in core Moodle. See the links at the bottom of this page for more information on setting up TeX editors and filters, including other tools from the Moodle community that may be suitable for advanced users.

'''WARNING:''' This Wiki environment uses a DIFFERENT TeX renderer to Moodle, especially when it comes to control sequences. For this reason images are sometimes used to represent what it should look like in Moodle. YMMV.

==Language Conventions==

To identify a TeX sequence in your text, surround it with $$ markers. To invoke a particular command or control sequence, use the backslash, \. A typical control sequence looks like:

$$ x\ =\ \frac{\sqrt{144}}{2}\ \times\ (y\ +\ 12) $$
{| class="nicetable"
|-
| [[Image: cfmimetex10.gif|frame|center]]
|-
|Fraction and square root.
|}

Additional spaces can be placed into the equation using the \ without a trailing character.

==Reserved Characters and Keywords==

Most characters and numbers on the keyboard can be used at their default value. As with any computing language, though, there are a set of reserved characters and keywords that are used by the program for its own purposes. TeX Notation is no different, but it does have a very small set of Reserved Characters. This will not be a complete list of reserved characters, but some of these are:

@ # $ % ^ & * ( ) .

To use these characters in an equation just place the \ in front of them like \$ or \%. If you want to use the backslash, just use \backslash. The only exception here seems to be the &, ampersand.

==Superscripts, Subscripts and Roots==

Superscripts are recorded using the caret, ^, symbol. An example for a Maths class might be:

$$ 4^2 \ \times \ 4^3 \ = 4^5 $$
This is a shorthand way of saying:
(4 x 4) x (4 x 4 x 4) = (4 x 4 x 4 x 4 x 4)
or
16 x 64 = 1024.

<math>4^2 \ \times \ 4^3 \ = 4^5</math>

Subscripts are similar, but use the underscore character.

$$ 3x_2 \ \times \ 2x_3 $$

<math>3x_2 \ \times \ 2x_3</math>

This is OK if you want superscripts or subscripts, but square roots are a little different. This uses a control sequence.

$$ \sqrt{64} \ = \ 8 $$

<math>\sqrt{64} \ = \ 8</math>

You can also take this a little further, but adding in a control character. You may ask a question like:

$$ If \ \sqrt[n]{1024} \ = \ 4, \ what \ is \ the \ value \ of \ n? $$

<math>If \ \sqrt[n]{1024} \ = \ 4, \ what \ is \ the \ value \ of \ n?</math>

Using these different commands allows you to develop equations like:

$$ The \sqrt{64} \ \times \ 2 \ \times \ 4^3 \ = \ 1024 $$

<math>The \sqrt{64} \ \times \ 2 \ \times \ 4^3 \ = \ 1024</math>

Superscripts, Subscripts and roots can also be noted in [[Using TeX Notation 4 | Matrices]].

==Fractions==

Fractions in TeX are actually simple, as long as you remember the rules.

$$ \frac{numerator}{denominator} $$ which produces <math>\frac{numerator}{denominator}</math> .

This can be given as:

<math>\frac{5}{10} \ is \ equal \ to \ \frac{1}{2}</math>.

This is entered as:

$$ \frac{5}{10} \ is \ equal \ to \ \frac{1}{2}.$$

With fractions (as with other commands) the curly brackets can be nested so that for example you can implement negative exponents in fractions. As you can see,

$$\frac {5^{-2}}{3}$$ will produce <math>\frac {5^{-2}}{3}</math>

$$\left(\frac{3}{4}\right)^{-3}$$ will produce <math>\left(\frac{3}{4}\right)^{-3}</math> and

$$\frac{3}{4^{-3}}$$ will produce <math> \frac{3}{4^{-3}} </math>

You likely do not want to use $$\frac{3}{4}^{-3}$$ as it produces <math>\frac{3}{4}^{-3}</math>

You can also use fractions and negative exponents in [[Using TeX Notation 4 | Matrices]].

==Brackets==

As students advance through Maths, they come into contact with brackets. Algebraic notation depends heavily on brackets. The usual keyboard values of ( and ) are useful, for example:

<math>d = 2 \ \times \ (4 \ - \ j)</math>

This is written as:

$$ d = 2 \ \times \ (4 \ - \ j) $$

Usually, these brackets are enough for most formulae but they will not be in some circumstances. Consider this:

<math>4x^3 \ + \ (x \ + \ \frac{42}{1 + x^4})</math>

Is OK, but try it this way:

<math>4x^3 \ + \ \left(x \ + \ \frac{42}{1 + x^4}\right)</math>

This can be achieved by:

$$ 4x^3 \ + \ \left(x \ + \ \frac{42}{1 + x^4}\right) $$

A simple change using the \left( and \right) symbols instead. Note the actual bracket is both named and presented. Brackets are almost essential in [[Using TeX Notation 4 | Matrices]].

==Ellipsis==

The Ellipsis is a simple code:

<math>x_1, \ x_2, \ \ldots, \ x_n</math>

Written like:

$$ x_1, \ x_2, \ \ldots, \ x_n $$

A more practical application could be:

Question:
"Add together all the numbers from 1 <math>\ldots</math> 38.
What is an elegant and simple solution to this problem?
Can you create an algebraic function to explain this solution?
Will your solution work for all numbers?"

Answer:
The question uses an even number to demonstrate a mathematical process and generate an algebraic formula.

{| class = "nicetable"
|-
| Part 1:
| Part 2.
| Part 3.
|-
|
<math>1. \ 1 \ + \ 38 \ = \ 39</math>

<math>2. \ 2 \ + \ 37 \ = \ 39</math>

<math>3. \ 3 \ + \ 36 \ = \ 39</math>

<math>\ldots</math>

<math>19. 19 \ + \ 20 \ = \ 39 </math>

<math>\therefore x \ = \ 39 \ \times \ 19 </math>

<math>\therefore x \ = \ 741 </math>

|An algebraic function might read something like:
<math>t = (1 + n) \times n/2 </math>

Where t = total and n = the last number.

|The solution is that, using the largest and the smallest numbers, the numbers are added and then multiplied by the number of different combinations to produce the same result adding the first and last numbers.
The answer must depend on the number, <math>\frac{n}{2}</math> being a whole number. Therefore, the solution will not work for an odd range of numbers, only an even range.

|}

==Symbols==

These are not all the symbols that may be available in TeX Notation for Moodle, just the ones that I have found to work in Moodle.

{| class="nicetable"
|-
| \amalg
| <math>\amalg</math>
| \cup
| <math>\cup</math>
| \oplus
| <math>\oplus</math>
| \times
| <math>\times</math>
|-
|\ast
|<math>\ast</math>
|\dagger
|<math>\dagger</math>
| \oslash
| <math>\oslash</math>
| \triangleleft
| <math>\triangleleft</math>
|-
| \bigcirc
| <math>\bigcirc</math>
| \ddagger
| <math>\ddagger</math>
| \otimes
| <math>\otimes</math>
| \triangleright
| <math>\triangleright</math>
|-
| \bigtriangledown
| <math>\bigtriangledown</math>
| \diamond
| <math>\diamond</math>
| \pm
| <math>\pm</math>
| \odot
| <math>\odot</math>
|-
| \bigtriangleup
| <math>\bigtriangleup</math>
| \div
| <math>\div</math>
| \ominus
| <math>\ominus</math>
| \wr
| <math>\wr</math>
|-
| \circ
| <math>\circ</math>
| \wedge
| <math>\wedge</math>
| \vee
| <math>\vee</math>
| \sqcup
| <math>\sqcup</math>
|-
| \leq
| <math>\leq</math>
| \geq
| <math>\geq</math>
| \equiv
| <math>\equiv</math>
| \prec
| <math>\prec</math>
|-
| \succ
| <math>\succ</math>
| \sim
| <math>\sim</math>
| \perp
| <math>\perp</math>
| \preceq
| <math>\preceq</math>
|-
| \succeq
| <math>\succeq</math>
| \simeq
| <math>\simeq</math>
| \mid
| <math>\mid</math>
| \ll
| <math>\ll</math>
|-
| \gg
| <math>\gg</math>
| \asymp
| <math>\asymp</math>
| \parallel
| <math>\parallel</math>
| \subset
| <math>\subset</math>
|-
| \supset
| <math>\supset</math>
| \subseteq
| <math>\subseteq</math>
| \supseteq
| <math>\supseteq</math>
| \approx
| <math>\approx</math>
|-
| \neq
| <math>\neq</math>
| \ni
| <math>\ni</math>
| \notin
| <math>\notin</math>
| \in
| <math>\ni</math>
|-
| \vdash
| <math>\vdash</math>
| \dashv
| <math>\dashv</math>
| \bullet
| <math>\bullet</math>
| \cdot
| <math>\cdot</math>
|}

==Arrows==

{| class="nicetable"
|-
| \leftarrow
| <math> \leftarrow</math>
| \longleftarrow
| <math> \longleftarrow</math>
| \Leftarrow
| <math> \Leftarrow</math>
| \Longleftarrow
| <math> \Longleftarrow</math>
|-
| \rightarrow
| <math> \rightarrow</math>
| \longrightarrow
| <math> \longrightarrow</math>
| \Rightarrow
| <math> \Rightarrow</math>
| \Longrightarrow
| <math> \Longrightarrow</math>
|-
| \uparrow
| <math> \uparrow</math>
| \Uparrow
| <math> \Uparrow</math>
| \downarrow
| <math> \downarrow</math>
| \Downarrow
| <math> \Downarrow</math>
|-
| \leftrightarrow
| <math> \leftrightarrow</math>
| \longleftrightarrow
| <math> \longleftrightarrow</math>
| \updownarrow
| <math> \updownarrow</math>
| \Updownarrow
| <math> \Updownarrow</math>
|-
| \Leftrightarrow
| <math> \Leftrightarrow</math>
| \Longleftrightarrow
| <math> \Longleftrightarrow</math>
| \leftrightharpoons
| <math> \rightleftharpoons</math>
| \Im
| <math> \Im</math>
|-
| \nearrow
| <math> \nearrow</math>
| \nwarrow
| <math> \nwarrow</math>
| \swarrow
| <math> \swarrow</math>
| \searrow
| <math> \searrow</math>

|}

==Delimiters and Maths Constructs==

NOTE: Most delimiters and constructs need additional parameters for them to appear appropriately.

{| class="nicetable"
|-
| \{x
| <math> \{x </math>
| x | \}
| <math>x | \} </math>
| \rangle
| <math> \rangle </math>
| \langle
| <math> \langle </math>
|-
| \angle
| <math> \angle </math>
| \=
| <math> \| </math>
| \sqrt{ab}
| <math> \sqrt{ab}</math>
| \sqrt[n]{ab}
| <math> \sqrt[n]{ab}</math>
|-
| \frac{ab}{cd}
| <math> \frac{ab}{cd}</math>
| \backslash
| <math> \backslash</math>
| \widehat{ab}
| <math> \widehat{ab}</math>
| \$
| <math> \$ </math>
|-
| \overline{ab}
| <math> \overline{ab}</math>
| \underline{ab}
| <math> \underline{ab}</math>
| \therefore
| <math> \therefore</math>
| \ddots
| <math> \ddots</math>
|-
| \%
| <math> \%</math>
| \#
| <math> \# </math>
| \vdots
| <math> \vdots</math>
| \emptyset
| <math> \emptyset</math>
|}
WARNINGS: The & character in LaTeX usually requires a backslash, \. In TeX Notation for Moodle, apparently, it does not. Other packages, AsciiMath, may use it differently again so be careful using it. The copyright character may use the MimeTeX charset, and produces a copyright notice for John Forkosh Associates who provided a lot of the essential packages for the TeX Notation for Moodle, so I understand. I have been, almost reliably, informed that a particular instruction will produce a different notice though .:)

There are also a number of characters that can be used in TeX Notation for Moodle but do not render in this page:

{| class="nicetable"
|-
| [[Image: cfmimetex08.png|frame|left]]
| Larger \left(x and \right) brackets
|-
|[[Image: cfmimetex06.gif|frame|left]]
| \widetilde{ab}
|-
|[[Image: cfmimetex09.gif|frame|left]]
| \textdegree or (50)^\circ
|}

==Greek Letters==

{| class="nicetable"
|-
| <math>\alpha</math>
| \alpha
| <math>\beta</math>
| \beta
| <math>\gamma</math>
| \gamma
|-
| <math>\delta</math>
| \delta
| <math>\epsilon</math>
| \epsilon
| <math>\zeta</math>
| \zeta
|-
| <math>\eta</math>
| \eta
| <math>\theta</math>
| \theta
| <math>\iota</math>
| \iota
|-
| <math>\kappa</math>
| \kappa
| <math>\lambda</math>
| \lambda
| <math>\mu</math>
| \mu
|-
| <math>\xi</math>
| \xi
| <math>\pi</math>
| \pi
| <math>\rho</math>
| \rho
|-
| <math>\sigma</math>
| \sigma
| <math>\tau</math>
| \tau
| <math>\upsilon</math>
| \upsilon
|-
| <math>\phi</math>
| \phi
| <math>\chi</math>
| \chi
| <math>\psi</math>
| \psi
|-
| <math>\omega</math>
| \omega
| <math>\Omega</math>
| \Omega
| <math>\Theta</math>
| \Theta
|-
| <math>\Delta</math>
| \Delta
| <math>\Pi</math>
| \Pi
| <math>\Phi</math>
| \Phi
|-
| <math>\Gamma </math>
| \Gamma
| <math>\Lambda </math>
| \Lambda
| <math>\Sigma </math>
| \Sigma
|-
| <math>\Psi </math>
| \Psi
| <math>\Xi </math>
| \Xi
| <math>\Upsilon</math>
| \Upsilon
|-
| <math>\vartheta </math>
| \vartheta
| <math>\varrho </math>
| \varrho
| <math>\varphi </math>
| \varphi
|-
| <math>\varsigma </math>
| \varsigma
|}

'''Notable Exceptions'''

Greek letter omicron (traditionally, mathemeticians don't make much use of omicron due to possible confusion with zero). Simply put, lowercase omicron is an "o" redered as <i>o</i>. But note \omicron may now work with recent TeX implementations including MathJax.

At the time of writing, these Greek capital letters cannot be rendered by TeX Notation in Moodle:

Alpha, Beta, Zeta, Eta, Tau, Chi, Mu, Iota, Kappa and Epsilon.

TeX methematics adopts the convention that lowercase Greek symbols are displayed as italics whereas uppercase Greek symbols are displayed as upright characters. Therefore, the missing Greek capital letters can simply be represented by the \mathrm{ } equivalent

<math>\mathrm{A, B, Z, H, T, X, M, I, K, E}</math>

==Boolean algebra==

There are a number of different conventions for representing Boolean (logic) algebra. Common conventions used in computer science and electronics are detailed below:

Negation, NOT, ¬, !, ~, <sup>−</sup>
\lnot, !, \sim, \overline{ }
Conjunction, AND, ∧, <math>\cdot</math>
\land, \wedge, \cdot
Dysjunction, OR, ∨, +,
\lor, \vee, +
Exclusive dysjunction, XOR ⊻, ⊕
\veebar, \oplus
Equivalence, If and only if, Iff, ≡, ↔, ⇔
\equiv, \leftrightarrow \iff

Example: two representations of De Morgan's laws:

<math>A \cdot B = \overline{\overline{A} + \overline{B}}</math>
$$ A \cdot B = \overline{\overline{A} + \overline{B}} SS

<math>(A \land B) \equiv \lnot(\lnot{A} \lor \lnot{B})</math>
$$ (A \land B) \equiv \lnot(\lnot{A} \lor \lnot{B}) $$

==Fonts==

To use a particular font you need to access the font using the same syntax as demonstrated above.

A math calligraphic font:

<math>\mathcal{ABCDEFGHIJKLMNOPQRSTUVXYZ}</math>

or

$$ \mathcal{ABCDEFGHIJKLMNOPQRSTUVXYZ}$$

Blackboard bold, a Castellar type font:

<math>\mathbb{ABCDEFGHIJKLMNOPQRSTUVXYZ}</math>

or

$$ \mathbb{ABCDEFGHIJKLMNOPQRSTUVXYZ}$$

Often used in number theory. For example: <math>\mathbb{N}</math> = set of natural numbers including 0 {0, 1, 2, 3, ...}, <math>\mathbb{Z}</math> = set of integers {-..., -3, -2, -1, 0, 1, 2, 3, ... }, <math>\mathbb{Q}</math> = set of rational numbers, including integers, <math>\mathbb{R}</math> = set of real numbers, which includes the natural numbers, rational numbers and irrational numbers.

Fraktur, an Old English type font:

<math>\mathfrak{ABCDEFGHIJKLMNOPQRSTUVXYZ}</math>

or

$$ \mathfrak{ABCDEFGHIJKLMNOPQRSTUVXYZ}$$

This is different in Tex Notation in Moodle than it is for other, full, TeX packages.

An italic font:

<math>\mathit{ABCDEFGHIJKLMNOPQRSTUVXYZ}</math>

or

$$ \mathit{ABCDEFGHIJKLMNOPQRSTUVXYZ} $$

A normal, upright non-italic, Roman font:

<math>\mathrm{ABCDEFGHIJKLMNOPQRSTUVXYZ}</math>

or

$$ \mathrm{ABCDEFGHIJKLMNOPQRSTUVXYZ} $$
A bold-face font:

<math>\mathbf{ABCDEFGHIJKLMNOPQRSTUVXYZ}</math>

or

$$ \mathbf{ABCDEFGHIJKLMNOPQRSTUVXYZ} $$

==Size of displays==

The default size is rendered slightly larger than normal font size. TeX Notation in Moodle uses eight different sizes ranging from "tiny" to "huge". However,these values seem to mean different things and are, I suspect, dependent upon the User's screen resolution. The sizes can be noted in four different ways:

{| class="nicetable"
|-
| \fontsize{0} to \fontsize{7}
| $$\fontsize{2} x \ = \ \frac{\sqrt{144}}{2} \ \times \ (y \ + \ 12)$$
| [[Image:cfmimetex10.gif|left]]
|-
| \fs{0} to \fs{7}
| $$\fs{4} x \ = \ \frac{\sqrt{144}}{2} \ \times \ (y \ + \ 12)$$
| [[Image:cfmimetex10.gif|left]]
|-
| \fs0 to \fs7
| $$\fs6 x \ = \ \frac{\sqrt{144}}{2} \ \times \ (y \ + \ 12)$$
| [[Image:cfmimetex11c.gif|left]]
|-
| As well, you can use \tiny \small
\normalsize \large \Large
\LARGE \huge \Huge
| $$\normalsize x \ = \ \frac{\sqrt{144}}{2} \ \times \ (y \ + \ 12)$$
| [[Image:cfmimetex11d.gif|left]]
|}

It appears that TeX Notation in Moodle now allows \fs6, \fs7, \huge and \Huge to be properly rendered.

==Colour==

Unlike many scripting languages, we only need to name the colour we want to use. You may have to experiment a little with colours, but it will make for a brighter page. Once named, the entire statement will appear in the colour, and if you mix colours, the last named colour will dominate. Some examples:

{| class="nicetable"
|-
| $$ \red x \ = \ \frac{\sqrt{144}}{2} \ \times \ (y \ + \ 12) $$
| [[Image: cfmimetex30a.gif|right]]
|-
| $$ \blue x \ = \ \frac{\sqrt{144}}{2} \ \times \ (y \ + \ 12) $$
| [[Image: cfmimetex30b.gif|right]]
|-
| $$ \green x \ = \ \frac{\sqrt{144}}{2} \ \times \ (y \ + \ 12) $$
| [[Image: cfmimetex30c.gif|right]]
|-
| $$ \red x \ = \ \frac{\sqrt{144}}{2}$$ $$ \times $$
$$\green (y \ + \ 12) $$ $$ \ = $$ $$ \ \blue 6^3 $$
| [[Image: cfmimetex30d.gif|right]]
|}

Moodle 2.2 note: You may find this doesn't work for you. You can try to add "\usepackage{color}" to your tex notation setting "LaTeX preamble" (under Site adminstration/Plugins/Filters/TeX notation)and then use this new syntax: $$ \color{red} x \ = \ \frac{\sqrt{144}}{2} \ \times \ (y \ + \ 12) $$

You may note this last one, it is considerably more complex than the previous for colours. TeX Notation in Windows does not allow multicoloured equations, if you name a number of colours in the equation, only the last named will be used.

==Geometric Shapes==

There are two ways to produce geometric shapes, one is with circles and the other is with lines. Each take a bit of practice to get right, but they can provide some simple geometry. It may be easier to produce the shapes in Illustrator or Paint Shop Pro or any one of a number of other drawing packages and use them to illustrate your lessons, but sometimes, some simple diagrams in Moodle will do a better job.

==Circles==

Circles are easy to make.

{| class="nicetable"
|-
| [[Image:cfmimetex20.gif|left]]
| Circles are easily created, and only needs a number to determine how large the circle is.
To create the circle use $$ \circle(150) $$. This makes a circle of 150 pixels in diameter.

|}

==Creating Arcs==

Arcs are also easy to produce, but require some additional parameters. The same code structure used in circles create the basic shape, but the inclusion of a start and end point creates only the arc. However, notice where the 0 point is, not at the true North, but rather the East and run in an anti-clockwise direction.

{| class="nicetable"
|-
| [[Image:cfmimetex21a.gif|left]]
| $$ \circle(120;90,180)$$
| [[Image:cfmimetex21b.gif|left]]
| $$ \circle(120;0,90)$$
|-
| [[Image:cfmimetex21c.gif|left]]
| $$ \circle(120;180,270)$$
| [[Image:cfmimetex21d.gif|left]]
| $$ \circle(120;270,360)$$
|}

This structure breaks down into the \circle command followed by the diameter, not the radius, of the circle, followed by a semi-colon, then the demarcation of the arc, the nomination of the start and end points in degrees from the 0, East, start point. Note that the canvas is the size of the diameter nominated by the circle's parameters.

==The \picture Command==

Using circles and arcs as shown above is somewhat limiting. The \picture command allows you to use a frame in which to build a picture of many layers. Each part of the picture though needs to be in its own space, and while this frame allows you to be creative, to a degree, there are some very hard and fast rules about using it.

All elements of a picture need to be located within the picture frame. Unexpected results occur when parts of an arc, for example, runs over the border of the frame. (This is particularly true of lines, which we will get to next, and the consequences of that overstepping of the border can cause serious problems.)

The \picture command is structured like:
\picture(100){(50,50){\circle(200)}}
\command(size of frame){(x co-ordinate, y co-ordinate){\shape to draw(size or x co-ordinate, y co-ordinate)})

'''NOTE:''' The brace is used to enclose each set of required starting point coordinates. Inside each set of braces, another set of braces is used to isolate each set of coordinates from the other, and those coordinates use their proper brackets and backslash. Count the opening and closing brackets, be careful of the position,

{| class="nicetable"
|-
| [[Image:cfmimetex24a.gif|left]]
| $$ \picture(100){(50,50){\circle(200)}}&&

The picture frame brings elements together that you may not otherwise see.

Because of the frame size of 100px and the centre point of the circle in the mid-point of the frame, the 200px circle will be squashed. Unexpected results occur when sizes are not correct.
| [[Image:cfmimetex24b.gif|left]]
|
Using the picture frame, you can layer circles
and lines over each other, or they can intersect.

$$ \picture(100){(50,50){\circle(99)} (50,50){\circle(80)}} $$
|-
| [[Image:cfmimetex24c.gif|left]]
| You may want to see an image of a circle with a dot in the middle.
You may have to try to place the centre dot correctly , but the
ordering of the elements in the image may have an impact.

$$ \picture(100){(48,46){\bullet}(50,50){\circle(99)}} $$
| [[Image:cfmimetex24d.gif|left]]
| Using the same ideas as above, you can make semi-circles.

$$\picture(150){(50,50){\circle(100;0,180)}(100,50){\circle(100;180,360)}}$$
|}

==Lines==

----

'''Warning:''' Drawing lines in TeX Notation in Moodle is an issue, go to the [[Using_TeX_Notation#Reserved_Characters_and_Keywords| Using Text Notation]] for more information. If the line is not noted properly then the parser will try to correctly draw the line but will not successfully complete it. This means that every image that needs be drawn will be drawn until it hits the error. When the error is being converted, it fails, so no subsequent image is drawn. Be careful and make sure your line works BEFORE you move to the next problem or next image.

----
{| class="nicetable"
|-
| [[Image: cfmimetex26.gif|frame|left| a couple of lines]]
| $$\red \picture(200){(20,0){ \line(180,0)}{(20,180){\line(180,0}$$

The structure of the picture box is that the \picture(200) provides a square image template.

The (20,0) provides the starting coordinates for any line that comes after. In this case the start point is at 20pixels in the x axis and 0 pixels in the y axis. The starting point for all coordinates, 0,0, is the bottom left corner and they run in a clockwise manner. '''Do not confuse this with arcs.'''

The \line(180,0) determines the length and inclination of the line. In this case, the inclination is 0 and the length is 180px.

These are enclosed in braces, all inside one set of braces owned by the \picture() control sequence.

The next set of commands are the same, that is, the (20,200) are the coordinates of the next line. The x co-ordinate is the 20, that is the distance to the right from the 0 point. The y co-ordinates is the distance from the bottom of the image. Whereas the first line started and ran on the bottom of the picture frame, the y co-ordinate starts at the 200 pixel mark from the bottom of the image. The line, at 180 pixels long and has no y slope. This creates a spread pair of parallel lines.
| [[Image: cfmimtex27.gif|thumb|right|150px|\picture explained]]
|}

While this explains the structure of a line, there is a couple of elements that you need to go through to do more with them.

==Squares and Rectangles==
Drawing squares and rectangles is similar, but only slightly different.

There should be a square box tool, and there is, but unless it has something inside it, it does not display. It is actually easier to make a square using the \line command.

{| class="nicetable"
|-
| [[Image: line03.gif|left]]
|This box is constructed using:
$$ \picture(250){(10,10){\line(0,230)}(10,10){\line(230,0)}(240,10){\line(0,230)}(10,240){\line(230,0)}}$$
It is a 250 pixel square box with a 230 pixel square inside it.
| [[Image: line04.gif|left]]
|This box is different in that is has the equal length indicators that are used in a square.
$$ \picture(250){(10,10){\line(0,230)}
(5,120){\line(10,0)}
(10,10){\line(230,0)}
(120,5){\line(0,10)}
(240,10){\line(0,230)}
(235,120){\line(10,0)}
(10,240){\line(230,0)}
(120,235){\line(0,10)}}$$
|-
| [[Image: line05.gif|left]]
| The rectangle then becomes the same thing, but with one side shorter. For a portrait canvas it would be:
$$ \picture(250){(10,10){\line(0,230)}(10,10){\line(150,0)}(160,10){\line(0,230)}(10,240){\line(150,0)}}$$
| [[Image: line06.gif|left]]
|The rectangle can also produce a landscape shape:
$$ \picture(250){(10,10){\line(0,160)}(10,10){\line(230,0)}(240,10){\line(0,160)}(10,170){\line(230,0)}}$$
|}

==Controlling Angles==

Controlling angles is a little different. They involve a different perception, but not one that is unfamiliar. Consider this:

We have a point from which we want to draw a line that is on an angle. The notation used at this point can be positive, positive or positive, negative or negative, positive or negative, negative. Think of it like a number plane or a graph, using directed numbers. The 0,0 point is in the centre, and we have four quadrants around it that give us one of the previously mentioned results.

{| class="nicetable"
|-
| rowspan="4"|[[Image:co-ordquadrants.png|left]]
| [[Image:line06a.gif|left]] $$\picture(100){(50,50){\line(40,45)}}$$,
a positive x and positive y
|-
| [[Image:line06b.gif|left]]$$\picture(100){(50,50){\line(-40,45)}}$$
a negative x and positive y
|-
| [[Image:line06c.gif|left]]$$\picture(100){(50,50){\line(-40,-45)}}$$
a negative x and negative y
|-
| [[Image:line06d.gif|left]]$$\picture(100){(50,50){\line(40,-45)}}$$
a positive x and a negative y
|}

Essentially, what these points boil down to is that anything above the insertion point is a positive on the y axis, anything below is a negative. Anything to the left of the insertion point is a negative while everything to the right is a positive.

{| class="nicetable"
|-
|[[Image:line06e.gif|left]]
| $$\picture(100){(50,50){\line(40,45)}(50,50){\line(-40,45)}(50,50){\line(-40,-45)}(50,50){\line(40,-45)}}$$

The co-ordinate alignment process in TeX is not that good that you can use one set of co-ords as a single starting point for all lines. The layering of each object varies because of the position of the previous object, so each object needs to be exactly placed.

This co-ord structure has a great deal of impact on intersecting lines, parallel lines and triangles.
|}

==Intersecting Lines==

You can set up an intersecting pair easily enough, using the \picture control sequence.

{| class="nicetable"
|-
| [[Image:cfmimetex31.gif|left]]
| $$ \picture(200){(10,0){\line(150,150)} (0,130){\line(180,-180)}} $$

The lines that are drawn can be labeled.

$$ \picture(200){(10,0){\line(150,150)}(0,130){\line(180,-180)}
(0,10){A}(0,135){B}(140,0){C}(140,150){D}(62,80){X}} $$

To produce another image.
| [[Image:cfmimetex32.gif|right]]
|-
| colspan="3" style="text-align: center;"| To which you may want to ask the question:
$$The \ \angle \ of \ AXB \ is \ 72\textdegree. \ What \ is \ the \ value \ of \ \angle BXD? $$
[[Image: cfmimetex32a.gif|center]]

NOTE: Labeling this image, above-right, turned out to be fairly simple. Offsetting points by a few pixels at the start or end points of the lines proved a successful strategy. The X point proved a little more problematic, and took a number of adjustments before getting it right. Experience here will help.
|-
| colspan="2"| With labels the drawing can become a little more like your traditional geometric drawing, but the devil is in the details. The parallel markers need to be placed properly, and that is where experience really comes into it. On lines that are vertical or horizontal, you can get away with using the > or < directly from the keyboard, or the <math>\gg</math> or <math>\ll</math> symbols. In either case, you need to position them properly.

The code:
$$\picture(200){(15,45){\line(170,0)} (15,30){c}(170,28){d}(15,160){\line(170,0)}(15,145){e}(180,143){f}(50,20){\line(110,175)}(58,20){a}(140,185){b}(42,32){\kappa}(53,48){\beta}
(150,165){\kappa}
(90,38){\gg}(80,153){\gg}
}$$
| [[Image:line10.gif|right]]
|}

==Lines and Arcs==

Combining lines and arcs is a serious challenge actually, on a number of levels. For example lets take an arc from the first page on circles.
{| class="nicetable"
|-
| [[Image: cfmimetex21a.gif|left]]
| Fairly innocuous of itself, but when we start to add in elements, it changes dramatically.

$$ \circle(120;90,180) $$
|-
| [[Image: line12.gif|left]]
| $$\picture(150){(75,75){\circle(120;90,180)}(75,75){\line(-70,0)}(75,75){\line(0,75)}} $$
All elements in this drawing start in the same place. Each is layered, and properly placed on the canvas, and using the same co-ord to start makes it easy to control them. No matter the size of the arc, intersecting lines can all be drawn using the centre co-ords of the arc.
|}

==Triangles ==

Of all the drawing objects, it is actually triangles that present the most challenge. For example:

{|
|-
| [[Image:line13.gif|left]]
$$\picture(350){(10,10){\line(0,320)}(10,330){\line(330,0)}(10,10){\line(330,320)}}$$
|This is a simple triangle, one that allows us to establish a simple set of rules for the sides. The vertical always has an x=0 co-ord and the horizontal always has a y=0 co-ord.

In this case with an x value of 330 on the horizontal, and a y value of 320 on the vertical, the hypotenuse should then have a value of x=340, and the y=330, but not so, they actually have an x=330 and a y=320.

There is no need to add the starting point co-ords to the x and y values of the line.
| [[Image:line14.gif|right]]
$$picture(350){(10,10){\line(330,0)}(340,10){\line(0,320)}(340,330){\line(-330,-320)}}$$

|}

This triangle has been developed for a Trigonometry page - but the additional notation should provide insight into how you can use it.

{| class="nicetable"
|-
| [[Image:line16.gif|left]]
| This is a labeled image, but it has an \fbox in it with its little line. With some effort, it could be replaced with two intersecting short lines.
$$\picture(350,150){(25,25){\line(300,0)}(325,25){\line(0,110)}(25,25){\line(300,110)}(309,25){\fbox{\line(5,5)}}
(307,98){\theta}(135,75){\beta}(150,5){\alpha}(335,75){\epsilon}}$$
|}

{| class="nicetable"
|-
| The triangle shows like:
[[Image:trig01.gif|left]]
|We use the different elements of the triangle to identify those things we need to know about a right-angled triangle.

The hypotenuse is always the side that is opposite the right angle. The longest side is always the Hypotenuse.

To identify the other elements of the triangle we look for the sign <math>\theta</math>. <math>\Theta</math> is the starting point for naming the other sides.

The side that is opposite <math>\angle \theta</math> is known as the Opposite.

The side that lies alongside <math>\angle \theta</math> is known as the Adjacent side.

To determine which is which, draw a line that bisects <math>\angle \theta</math> and whatever line it crosses is the Opposite side.
|-
| colspan="2"| The code:
$$ \picture(350,250){(25,25){\line(300,0)}(25,25){\line(0,220)}(25,245){\line(300,-220)}(310,25){\circle(100;135,180)}(20,100){\line(310,-75)} (25,25){\fbox{\line(5,5)}}(25,25){\line(150,150)}(165,140){Hypotenuse}(120,2){Adjacent}(2,80){\rotatebox{90}{Opposite}}(270,40){\theta}}$$
|}

=Matrices=
A Matrix is a rectangular array of numbers arranged in rows and columns which can be used to organize numeric information. Matrices can be used to predict trends and outcomes in real situations - i.e. polling.

==A Matrix==
A matrix can be written and displayed like [[Image: matrices03.gif|A matrix]]

In this case the matrix is constructed using the brackets before creating the array:
$$ M = \left[\begin{array}{ccc} a&b&1 \ c&d&2 \ e&f&3\end{array}\right] $$
The internal structure of the array is generated by the &, ampersand, and the double backslash.

You can also create a grid for the matrix.

{| class="nicetable"
|-
|A dashed line
|A solid line
|A mixed line
|-
|[[Image: matrices04.gif]]
|[[Image: matrices05.gif]]
|[[Image: matrices06.gif]]
|-
|$$ M = \left[\begin{array}'''{c.c.c}''' a&b&1 \ '''\hdash''' c&d&2 \ '''\hdash''' e&f&3\end{array}\right] $$
|$$ M = \left[\begin{array}'''{c|c|c}''' a&b&1 \ '''\hline''' c&d&2 \ '''\hline''' e&f&3\end{array}\right] $$
|$$ M = \left[\begin{array}'''{c.c|c}''' a&b&1 \ '''\hline''' c&d&2 \ '''\hdash''' e&f&3\end{array}\right] $$
|}

The command sequences here are the {c|c.c} and \hdash and \hline. The pipe, |, and the full stop determine the line type for the vertical line.

Matrices also respond to other TeX Notation commands such as size and colour.

{| class="nicetable"
|-
|
Colour
| colspan="2"|Size
|-
|[[Image: matrices07.gif]]
|[[Image: matrices08.gif]]
|[[Image: matrices09.gif]]
|-
|$$ '''\blue''' M = \left[\begin{array}{c.c.c} a&b&1 \ \hdash c&d&2 \ \hdash e&f&3\end{array}\right] $$
|$$ '''\fs7''' M = \left[\begin{array}{c.c.c} a&b&1 \ \hdash c&d&2 \ \hdash e&f&3\end{array}\right] $$
|$$ '''\fs2''' M = \left[\begin{array}{c.c.c} a&b&1 \ \hdash c&d&2 \ \hdash e&f&3\end{array}\right] $$
|}

==Creating equal and unequal matrices==
Equal and unequal matrices are simply matrices that either share or not share the same number of rows and columns. To be more precise, equal matrices share the same order and each element in the corresponding positions are equal. Anything else is unequal matrices.

Actually equal and unequal matrices are constructed along similar lines, but have different shapes:

{| class="nicetable"
|-
|Equal Matrix
|An unequal matrix
|-
|[[Image: matrices10.gif]]
|[[Image: matrices11.gif]]
|-
| $$ \left[\begin{array} a&b&1 \ c&d&2 \ e&f&3\end{array}\right] \ = \ \left[\begin{array} 12&11&z \ 10&9&y \ 8&7&x\end{array}\right] $$
| $$ \left[\begin{array} a&b \ c&d \ e&f \end{array}\right] \ \neq \ \left[\begin{array} 12&11&z \ 10&9&y \ 8&7&x\end{array}\right] $$
|}

==Labeling a Matrix==

Addition and subtraction matrices are similar again, but the presentation is usually very different. The problem comes when trying to mix labels into arrays. The lack of sophistication in the TeX Notation plays against it here.

Moodle allows an easy adoption of tables to make it work though. For example:

Bill the baker supplies three shops, A, B and C with pies, pasties and sausage rolls.
He is expected to determine the stock levels of those three shops in his estimation of supplies.

It is better to use the Moodle Fullscreen editor for this, to have a better idea of how the end product will look and to take advantage of the additional tools available. Design decisions need occupy our attention for a while. We need a table of five rows and four columns. The first row is a header row, so the label is centred. The next row needs four columns, a blank cell to start and labels A, B and C. The next three rows are divided into two columns, with the labels, pies, pasties and sausage rolls in each row of the first column and the matrix resides in a merged set of columns there. So first the table:

{| class="nicetable"
|-
| Insert Table - initial properties
| Merge Cells Button
| Advanced Properties
|-
| rowspan="2"|[[Image: matricestable01.png|Table properties]]
| [[Image: matricestable02.png | Merge cells]]
| [[Image: matricestable03.png | Cell properties button]]
|-
| colspan="2"| You may need to look into the Advanced properties setting of the tables and cells to make this work.
|}

This is the immediate result:

[[Image: matricestable04.png | The resulting table]]

While not a very good look, it can be made better by tweaking the table using the advanced settings and properties buttons and then you can tweak the matrix itself.

==Tweaking the Matrix==

[[Image: matricestable05a.png | A tweaked matrix]]

Things are not always as they seem, be aware, the "c" does not stand for "column", it actually stands for "centre". The columns are aligned by the letters l, for left, c for centre and r for right.

Each column is spread across 50 pixels, so the value of 50 is entered into the alignment declaration. The plus sign before the value is used to "propogate" or to force the value across the whole matrix, but is not used when wanting to separate only one column.

To set the rows is a little more problematic. The capital letter C sets the vertical alignment to the centre, (B is for baseline, but that does not guarantee that the numbers will appear on the base line, and there does not appear to be any third value). The plus sign and following value sets the height of all rows to the number given. In this I have given it a value of 25 pixels for the entire matrix. If there were four or five rows, the same height requirement is made.

The order things appear is also important. If you change the order of these settings, they will either not work at all, or will not render as you expect them to. If something does not work properly, then check to make sure you have the right order first.

==An Addition Matrix==

The rule for performing operations on matrices is that they must be equal matrices. For example, addition matrices look like:

[[Image: matricestable06.png | An addition matrix]]

with the results obvious. The code is:

$$\left[\begin{array}{c+50C+25.c.c}
11&14&12 \ \hdash16&12&22 \ \hdash 14&17&15
\end{array}\right] + \left[\begin{array}{c+50C+25.c.c}
60&60&60 \ \hdash 40&40&30 \ \hdash 30&30&30
\end{array}\right] $$

==A Subtraction Matrix==

Similar to an addition matrix in its construction, the subtraction matrix is subject to the same rules of equality.

Using the same essential data, we can calculate the daily sales of each of the shops.

[[Image: matricestable07.png | A subtraction matrix]]

The code is:
$$ \left[\begin{array}{c+50C+25.c.c}
72&95&68 \ \hdash 54&61&65 \ \hdash 48&51&60
\end{array}\right] - \left[\begin{array}{c+50C+25.c.c}
11&14&12 \ \hdash 16&12&22 \ \hdash 14&17&15
\end{array}\right] = \left[\begin{array}{c+50C+25.c.c}
61&81&56 \ \hdash 38&49&43 \ \hdash 34&34&48
\end{array}\right] $$

This code looks more complex than it really is, it is cluttered by the lines and alignment sequences.

==Multiplication Matrices==

Different than the addition or subtraction matrices, the multiplication matrix comes in three parts, the row matrix, the column matrix and the answer matrix. This implies it has a different construction methodology.

[[Image: matrices16.gif | A multiplication matrix]]

And the code for this is:
$$ \begin{array} 10&14&16\end{array} \
\left[\begin{array} 45 \\ 61 \\ 19 \end{array}\right]
\ = \ \begin{array} 450&854&304\end{array} $$

While different, it is not necessarily more complex. For example a problem like:

Bill the baker is selling his product to Con the cafe owner, who
wants to make sure his overall prices are profitable for himself.
Con needs to make sure that his average price is providing sufficient
profit to be able to keep the cafes open. Con makes his calculations
on a weekly basis, comparing cost to sale prices.

With the pies, pasties and sausage rolls in that order he applies them to the cost and sale price columns :

[[Image: matrices17.gif | A multiplication matrix]]

The code for this is:
$$\left[\begin{array} 350&310&270 \end{array}\right] \
\left[\begin{array} \$2.10&\$3.60 \ \$2.05&\$3.60 \ \$1.90&\$3.10 \end{array}
\right] \ = \ \left[\begin{array} \$735.00&\$1260.00 \ \$635.50&\$1116.00 \
\$513.00&$\837.00 \end{array}\right] $$

==See Also==
* [[MathJax_filter]] - available in Moodle 2.7 and later
* [[TeX notation filter]] To turn on the TeX Notation
* [[Advanced Maths Tools]] Moodle 2.x - The Next Generation of TeX Tools
* [[DragMath equation editor]]
* [[Chemistry notation using mhchem]]

[[Category:Mathematics]]

Using TeX Notation

2015-10-30T09:59:21Z

Marycooch: pronunciation

{{Filters}}
{{Work in progress}}
TeX ('''/'tɛx/tekh''' often pronounced TeK in English) is a very widespread and popular way of representing Mathematics notation using only characters that you can type on a keyboard (see [https://en.wikipedia.org/wiki/TeX Wikipedia]). This makes it a useful format to use in Moodle, since it can be entered anywhere you can type text, from forum posts to quiz questions.

TeX expressions can be entered in multiple ways:
* typing them directly into texts.
* using the Java-based Dragmath editor in Moodle's TinyMCE editor.
* using the HTML-based equation editor in Moodle's Atto editor (since Moodle 2.7).

Afterwards, TeX expressions are rendered into Mathematics notation:
* using the TeX filter in Moodle, which uses a TeX binary installed on the server to convert expressions into .gif images (or if that is not available, it falls back to a simple built-in mimetex binary).
* using the [[MathJax_filter]] which identifies TeX expressions and uses the Mathjax JS library to render them in browsers at display time (since Moodle 2.7).
* using other third-party solutions.

As you can imagine, the whole field is not simple as we'd like, especially because there are many flavours of TeX and slight variations between tools.

This page focusses only on using TeX in core Moodle. See the links at the bottom of this page for more information on setting up TeX editors and filters, including other tools from the Moodle community that may be suitable for advanced users.

'''WARNING:''' This Wiki environment uses a DIFFERENT TeX renderer to Moodle, especially when it comes to control sequences. For this reason images are sometimes used to represent what it should look like in Moodle. YMMV.

==Language Conventions==

To identify a TeX sequence in your text, surround it with $$ markers. To invoke a particular command or control sequence, use the backslash, \. A typical control sequence looks like:

$$ x\ =\ \frac{\sqrt{144}}{2}\ \times\ (y\ +\ 12) $$
{| class="nicetable"
|-
| [[Image: cfmimetex10.gif|frame|center]]
|-
|Fraction and square root.
|}

Additional spaces can be placed into the equation using the \ without a trailing character.

==Reserved Characters and Keywords==

Most characters and numbers on the keyboard can be used at their default value. As with any computing language, though, there are a set of reserved characters and keywords that are used by the program for its own purposes. TeX Notation is no different, but it does have a very small set of Reserved Characters. This will not be a complete list of reserved characters, but some of these are:

@ # $ % ^ & * ( ) .

To use these characters in an equation just place the \ in front of them like \$ or \%. If you want to use the backslash, just use \backslash. The only exception here seems to be the &, ampersand.

==Superscripts, Subscripts and Roots==

Superscripts are recorded using the caret, ^, symbol. An example for a Maths class might be:

$$ 4^2 \ \times \ 4^3 \ = 4^5 $$
This is a shorthand way of saying:
(4 x 4) x (4 x 4 x 4) = (4 x 4 x 4 x 4 x 4)
or
16 x 64 = 1024.

<math>4^2 \ \times \ 4^3 \ = 4^5</math>

Subscripts are similar, but use the underscore character.

$$ 3x_2 \ \times \ 2x_3 $$

<math>3x_2 \ \times \ 2x_3</math>

This is OK if you want superscripts or subscripts, but square roots are a little different. This uses a control sequence.

$$ \sqrt{64} \ = \ 8 $$

<math>\sqrt{64} \ = \ 8</math>

You can also take this a little further, but adding in a control character. You may ask a question like:

$$ If \ \sqrt[n]{1024} \ = \ 4, \ what \ is \ the \ value \ of \ n? $$

<math>If \ \sqrt[n]{1024} \ = \ 4, \ what \ is \ the \ value \ of \ n?</math>

Using these different commands allows you to develop equations like:

$$ The \sqrt{64} \ \times \ 2 \ \times \ 4^3 \ = \ 1024 $$

<math>The \sqrt{64} \ \times \ 2 \ \times \ 4^3 \ = \ 1024</math>

Superscripts, Subscripts and roots can also be noted in [[Using TeX Notation 4 | Matrices]].

==Fractions==

Fractions in TeX are actually simple, as long as you remember the rules.

$$ \frac{numerator}{denominator} $$ which produces <math>\frac{numerator}{denominator}</math> .

This can be given as:

<math>\frac{5}{10} \ is \ equal \ to \ \frac{1}{2}</math>.

This is entered as:

$$ \frac{5}{10} \ is \ equal \ to \ \frac{1}{2}.$$

With fractions (as with other commands) the curly brackets can be nested so that for example you can implement negative exponents in fractions. As you can see,

$$\frac {5^{-2}}{3}$$ will produce <math>\frac {5^{-2}}{3}</math>

$$\left(\frac{3}{4}\right)^{-3}$$ will produce <math>\left(\frac{3}{4}\right)^{-3}</math> and

$$\frac{3}{4^{-3}}$$ will produce <math> \frac{3}{4^{-3}} </math>

You likely do not want to use $$\frac{3}{4}^{-3}$$ as it produces <math>\frac{3}{4}^{-3}</math>

You can also use fractions and negative exponents in [[Using TeX Notation 4 | Matrices]].

==Brackets==

As students advance through Maths, they come into contact with brackets. Algebraic notation depends heavily on brackets. The usual keyboard values of ( and ) are useful, for example:

<math>d = 2 \ \times \ (4 \ - \ j)</math>

This is written as:

$$ d = 2 \ \times \ (4 \ - \ j) $$

Usually, these brackets are enough for most formulae but they will not be in some circumstances. Consider this:

<math>4x^3 \ + \ (x \ + \ \frac{42}{1 + x^4})</math>

Is OK, but try it this way:

<math>4x^3 \ + \ \left(x \ + \ \frac{42}{1 + x^4}\right)</math>

This can be achieved by:

$$ 4x^3 \ + \ \left(x \ + \ \frac{42}{1 + x^4}\right) $$

A simple change using the \left( and \right) symbols instead. Note the actual bracket is both named and presented. Brackets are almost essential in [[Using TeX Notation 4 | Matrices]].

==Ellipsis==

The Ellipsis is a simple code:

<math>x_1, \ x_2, \ \ldots, \ x_n</math>

Written like:

$$ x_1, \ x_2, \ \ldots, \ x_n $$

A more practical application could be:

Question:
"Add together all the numbers from 1 <math>\ldots</math> 38.
What is an elegant and simple solution to this problem?
Can you create an algebraic function to explain this solution?
Will your solution work for all numbers?"

Answer:
The question uses an even number to demonstrate a mathematical process and generate an algebraic formula.

{| class = "nicetable"
|-
| Part 1:
| Part 2.
| Part 3.
|-
|
<math>1. \ 1 \ + \ 38 \ = \ 39</math>

<math>2. \ 2 \ + \ 37 \ = \ 39</math>

<math>3. \ 3 \ + \ 36 \ = \ 39</math>

<math>\ldots</math>

<math>19. 19 \ + \ 20 \ = \ 39 </math>

<math>\therefore x \ = \ 39 \ \times \ 19 </math>

<math>\therefore x \ = \ 741 </math>

|An algebraic function might read something like:
<math>t = (1 + n) \times n/2 </math>

Where t = total and n = the last number.

|The solution is that, using the largest and the smallest numbers, the numbers are added and then multiplied by the number of different combinations to produce the same result adding the first and last numbers.
The answer must depend on the number, <math>\frac{n}{2}</math> being a whole number. Therefore, the solution will not work for an odd range of numbers, only an even range.

|}

==Symbols==

These are not all the symbols that may be available in TeX Notation for Moodle, just the ones that I have found to work in Moodle.

{| class="nicetable"
|-
| \amalg
| <math>\amalg</math>
| \cup
| <math>\cup</math>
| \oplus
| <math>\oplus</math>
| \times
| <math>\times</math>
|-
|\ast
|<math>\ast</math>
|\dagger
|<math>\dagger</math>
| \oslash
| <math>\oslash</math>
| \triangleleft
| <math>\triangleleft</math>
|-
| \bigcirc
| <math>\bigcirc</math>
| \ddagger
| <math>\ddagger</math>
| \otimes
| <math>\otimes</math>
| \triangleright
| <math>\triangleright</math>
|-
| \bigtriangledown
| <math>\bigtriangledown</math>
| \diamond
| <math>\diamond</math>
| \pm
| <math>\pm</math>
| \odot
| <math>\odot</math>
|-
| \bigtriangleup
| <math>\bigtriangleup</math>
| \div
| <math>\div</math>
| \ominus
| <math>\ominus</math>
| \wr
| <math>\wr</math>
|-
| \circ
| <math>\circ</math>
| \wedge
| <math>\wedge</math>
| \vee
| <math>\vee</math>
| \sqcup
| <math>\sqcup</math>
|-
| \leq
| <math>\leq</math>
| \geq
| <math>\geq</math>
| \equiv
| <math>\equiv</math>
| \prec
| <math>\prec</math>
|-
| \succ
| <math>\succ</math>
| \sim
| <math>\sim</math>
| \perp
| <math>\perp</math>
| \preceq
| <math>\preceq</math>
|-
| \succeq
| <math>\succeq</math>
| \simeq
| <math>\simeq</math>
| \mid
| <math>\mid</math>
| \ll
| <math>\ll</math>
|-
| \gg
| <math>\gg</math>
| \asymp
| <math>\asymp</math>
| \parallel
| <math>\parallel</math>
| \subset
| <math>\subset</math>
|-
| \supset
| <math>\supset</math>
| \subseteq
| <math>\subseteq</math>
| \supseteq
| <math>\supseteq</math>
| \approx
| <math>\approx</math>
|-
| \neq
| <math>\neq</math>
| \ni
| <math>\ni</math>
| \notin
| <math>\notin</math>
| \in
| <math>\ni</math>
|-
| \vdash
| <math>\vdash</math>
| \dashv
| <math>\dashv</math>
| \bullet
| <math>\bullet</math>
| \cdot
| <math>\cdot</math>
|}

==Arrows==

{| class="nicetable"
|-
| \leftarrow
| <math> \leftarrow</math>
| \longleftarrow
| <math> \longleftarrow</math>
| \Leftarrow
| <math> \Leftarrow</math>
| \Longleftarrow
| <math> \Longleftarrow</math>
|-
| \rightarrow
| <math> \rightarrow</math>
| \longrightarrow
| <math> \longrightarrow</math>
| \Rightarrow
| <math> \Rightarrow</math>
| \Longrightarrow
| <math> \Longrightarrow</math>
|-
| \uparrow
| <math> \uparrow</math>
| \Uparrow
| <math> \Uparrow</math>
| \downarrow
| <math> \downarrow</math>
| \Downarrow
| <math> \Downarrow</math>
|-
| \leftrightarrow
| <math> \leftrightarrow</math>
| \longleftrightarrow
| <math> \longleftrightarrow</math>
| \updownarrow
| <math> \updownarrow</math>
| \Updownarrow
| <math> \Updownarrow</math>
|-
| \Leftrightarrow
| <math> \Leftrightarrow</math>
| \Longleftrightarrow
| <math> \Longleftrightarrow</math>
| \leftrightharpoons
| <math> \rightleftharpoons</math>
| \Im
| <math> \Im</math>
|-
| \nearrow
| <math> \nearrow</math>
| \nwarrow
| <math> \nwarrow</math>
| \swarrow
| <math> \swarrow</math>
| \searrow
| <math> \searrow</math>

|}

==Delimiters and Maths Constructs==

NOTE: Most delimiters and constructs need additional parameters for them to appear appropriately.

{| class="nicetable"
|-
| \{x
| <math> \{x </math>
| x | \}
| <math>x | \} </math>
| \rangle
| <math> \rangle </math>
| \langle
| <math> \langle </math>
|-
| \angle
| <math> \angle </math>
| \=
| <math> \| </math>
| \sqrt{ab}
| <math> \sqrt{ab}</math>
| \sqrt[n]{ab}
| <math> \sqrt[n]{ab}</math>
|-
| \frac{ab}{cd}
| <math> \frac{ab}{cd}</math>
| \backslash
| <math> \backslash</math>
| \widehat{ab}
| <math> \widehat{ab}</math>
| \$
| <math> \$ </math>
|-
| \overline{ab}
| <math> \overline{ab}</math>
| \underline{ab}
| <math> \underline{ab}</math>
| \therefore
| <math> \therefore</math>
| \ddots
| <math> \ddots</math>
|-
| \%
| <math> \%</math>
| \#
| <math> \# </math>
| \vdots
| <math> \vdots</math>
| \emptyset
| <math> \emptyset</math>
|}
WARNINGS: The & character in LaTeX usually requires a backslash, \. In TeX Notation for Moodle, apparently, it does not. Other packages, AsciiMath, may use it differently again so be careful using it. The copyright character may use the MimeTeX charset, and produces a copyright notice for John Forkosh Associates who provided a lot of the essential packages for the TeX Notation for Moodle, so I understand. I have been, almost reliably, informed that a particular instruction will produce a different notice though .:)

There are also a number of characters that can be used in TeX Notation for Moodle but do not render in this page:

{| class="nicetable"
|-
| [[Image: cfmimetex08.png|frame|left]]
| Larger \left(x and \right) brackets
|-
|[[Image: cfmimetex06.gif|frame|left]]
| \widetilde{ab}
|-
|[[Image: cfmimetex09.gif|frame|left]]
| \textdegree or (50)^\circ
|}

==Greek Letters==

{| class="nicetable"
|-
| <math>\alpha</math>
| \alpha
| <math>\beta</math>
| \beta
| <math>\gamma</math>
| \gamma
|-
| <math>\delta</math>
| \delta
| <math>\epsilon</math>
| \epsilon
| <math>\zeta</math>
| \zeta
|-
| <math>\eta</math>
| \eta
| <math>\theta</math>
| \theta
| <math>\iota</math>
| \iota
|-
| <math>\kappa</math>
| \kappa
| <math>\lambda</math>
| \lambda
| <math>\mu</math>
| \mu
|-
| <math>\xi</math>
| \xi
| <math>\pi</math>
| \pi
| <math>\rho</math>
| \rho
|-
| <math>\sigma</math>
| \sigma
| <math>\tau</math>
| \tau
| <math>\upsilon</math>
| \upsilon
|-
| <math>\phi</math>
| \phi
| <math>\chi</math>
| \chi
| <math>\psi</math>
| \psi
|-
| <math>\omega</math>
| \omega
| <math>\Omega</math>
| \Omega
| <math>\Theta</math>
| \Theta
|-
| <math>\Delta</math>
| \Delta
| <math>\Pi</math>
| \Pi
| <math>\Phi</math>
| \Phi
|-
| <math>\Gamma </math>
| \Gamma
| <math>\Lambda </math>
| \Lambda
| <math>\Sigma </math>
| \Sigma
|-
| <math>\Psi </math>
| \Psi
| <math>\Xi </math>
| \Xi
| <math>\Upsilon</math>
| \Upsilon
|-
| <math>\vartheta </math>
| \vartheta
| <math>\varrho </math>
| \varrho
| <math>\varphi </math>
| \varphi
|-
| <math>\varsigma </math>
| \varsigma
|}

'''Notable Exceptions'''

Greek letter omicron (traditionally, mathemeticians don't make much use of omicron due to possible confusion with zero). Simply put, lowercase omicron is an "o" redered as <i>o</i>. But note \omicron may now work with recent TeX implementations including MathJax.

At the time of writing, these Greek capital letters cannot be rendered by TeX Notation in Moodle:

Alpha, Beta, Zeta, Eta, Tau, Chi, Mu, Iota, Kappa and Epsilon.

TeX methematics adopts the convention that lowercase Greek symbols are displayed as italics whereas uppercase Greek symbols are displayed as upright characters. Therefore, the missing Greek capital letters can simply be represented by the \mathrm{ } equivalent

<math>\mathrm{A, B, Z, H, T, X, M, I, K, E}</math>

==Boolean algebra==

There are a number of different conventions for representing Boolean (logic) algebra. Common conventions used in computer science and electronics are detailed below:

Negation, NOT, ¬, !, ~, <sup>−</sup>
\lnot, !, \sim, \overline{ }
Conjunction, AND, ∧, <math>\cdot</math>
\land, \wedge, \cdot
Dysjunction, OR, ∨, +,
\lor, \vee, +
Exclusive dysjunction, XOR ⊻, ⊕
\veebar, \oplus
Equivalence, If and only if, Iff, ≡, ↔, ⇔
\equiv, \leftrightarrow \iff

Example: two representations of De Morgan's laws:

<math>A \cdot B = \overline{\overline{A} + \overline{B}}</math>
$$ A \cdot B = \overline{\overline{A} + \overline{B}} SS

<math>(A \land B) \equiv \lnot(\lnot{A} \lor \lnot{B})</math>
$$ (A \land B) \equiv \lnot(\lnot{A} \lor \lnot{B}) $$

==Fonts==

To use a particular font you need to access the font using the same syntax as demonstrated above.

A math calligraphic font:

<math>\mathcal{ABCDEFGHIJKLMNOPQRSTUVXYZ}</math>

or

$$ \mathcal{ABCDEFGHIJKLMNOPQRSTUVXYZ}$$

Blackboard bold, a Castellar type font:

<math>\mathbb{ABCDEFGHIJKLMNOPQRSTUVXYZ}</math>

or

$$ \mathbb{ABCDEFGHIJKLMNOPQRSTUVXYZ}$$

Often used in number theory. For example: <math>\mathbb{N}</math> = set of natural numbers including 0 {0, 1, 2, 3, ...}, <math>\mathbb{Z}</math> = set of integers {-..., -3, -2, -1, 0, 1, 2, 3, ... }, <math>\mathbb{Q}</math> = set of rational numbers, including integers, <math>\mathbb{R}</math> = set of real numbers, which includes the natural numbers, rational numbers and irrational numbers.

Fraktur, an Old English type font:

<math>\mathfrak{ABCDEFGHIJKLMNOPQRSTUVXYZ}</math>

or

$$ \mathfrak{ABCDEFGHIJKLMNOPQRSTUVXYZ}$$

This is different in Tex Notation in Moodle than it is for other, full, TeX packages.

An italic font:

<math>\mathit{ABCDEFGHIJKLMNOPQRSTUVXYZ}</math>

or

$$ \mathit{ABCDEFGHIJKLMNOPQRSTUVXYZ} $$

A normal, upright non-italic, Roman font:

<math>\mathrm{ABCDEFGHIJKLMNOPQRSTUVXYZ}</math>

or

$$ \mathrm{ABCDEFGHIJKLMNOPQRSTUVXYZ} $$
A bold-face font:

<math>\mathbf{ABCDEFGHIJKLMNOPQRSTUVXYZ}</math>

or

$$ \mathbf{ABCDEFGHIJKLMNOPQRSTUVXYZ} $$

==Size of displays==

The default size is rendered slightly larger than normal font size. TeX Notation in Moodle uses eight different sizes ranging from "tiny" to "huge". However,these values seem to mean different things and are, I suspect, dependent upon the User's screen resolution. The sizes can be noted in four different ways:

{| class="nicetable"
|-
| \fontsize{0} to \fontsize{7}
| $$\fontsize{2} x \ = \ \frac{\sqrt{144}}{2} \ \times \ (y \ + \ 12)$$
| [[Image:cfmimetex10.gif|left]]
|-
| \fs{0} to \fs{7}
| $$\fs{4} x \ = \ \frac{\sqrt{144}}{2} \ \times \ (y \ + \ 12)$$
| [[Image:cfmimetex10.gif|left]]
|-
| \fs0 to \fs7
| $$\fs6 x \ = \ \frac{\sqrt{144}}{2} \ \times \ (y \ + \ 12)$$
| [[Image:cfmimetex11c.gif|left]]
|-
| As well, you can use \tiny \small
\normalsize \large \Large
\LARGE \huge \Huge
| $$\normalsize x \ = \ \frac{\sqrt{144}}{2} \ \times \ (y \ + \ 12)$$
| [[Image:cfmimetex11d.gif|left]]
|}

It appears that TeX Notation in Moodle now allows \fs6, \fs7, \huge and \Huge to be properly rendered.

==Colour==

Unlike many scripting languages, we only need to name the colour we want to use. You may have to experiment a little with colours, but it will make for a brighter page. Once named, the entire statement will appear in the colour, and if you mix colours, the last named colour will dominate. Some examples:

{| class="nicetable"
|-
| $$ \red x \ = \ \frac{\sqrt{144}}{2} \ \times \ (y \ + \ 12) $$
| [[Image: cfmimetex30a.gif|right]]
|-
| $$ \blue x \ = \ \frac{\sqrt{144}}{2} \ \times \ (y \ + \ 12) $$
| [[Image: cfmimetex30b.gif|right]]
|-
| $$ \green x \ = \ \frac{\sqrt{144}}{2} \ \times \ (y \ + \ 12) $$
| [[Image: cfmimetex30c.gif|right]]
|-
| $$ \red x \ = \ \frac{\sqrt{144}}{2}$$ $$ \times $$
$$\green (y \ + \ 12) $$ $$ \ = $$ $$ \ \blue 6^3 $$
| [[Image: cfmimetex30d.gif|right]]
|}

Moodle 2.2 note: You may find this doesn't work for you. You can try to add "\usepackage{color}" to your tex notation setting "LaTeX preamble" (under Site adminstration/Plugins/Filters/TeX notation)and then use this new syntax: $$ \color{red} x \ = \ \frac{\sqrt{144}}{2} \ \times \ (y \ + \ 12) $$

You may note this last one, it is considerably more complex than the previous for colours. TeX Notation in Windows does not allow multicoloured equations, if you name a number of colours in the equation, only the last named will be used.

==Geometric Shapes==

There are two ways to produce geometric shapes, one is with circles and the other is with lines. Each take a bit of practice to get right, but they can provide some simple geometry. It may be easier to produce the shapes in Illustrator or Paint Shop Pro or any one of a number of other drawing packages and use them to illustrate your lessons, but sometimes, some simple diagrams in Moodle will do a better job.

==Circles==

Circles are easy to make.

{| class="nicetable"
|-
| [[Image:cfmimetex20.gif|left]]
| Circles are easily created, and only needs a number to determine how large the circle is.
To create the circle use $$ \circle(150) $$. This makes a circle of 150 pixels in diameter.

|}

==Creating Arcs==

Arcs are also easy to produce, but require some additional parameters. The same code structure used in circles create the basic shape, but the inclusion of a start and end point creates only the arc. However, notice where the 0 point is, not at the true North, but rather the East and run in an anti-clockwise direction.

{| class="nicetable"
|-
| [[Image:cfmimetex21a.gif|left]]
| $$ \circle(120;90,180)$$
| [[Image:cfmimetex21b.gif|left]]
| $$ \circle(120;0,90)$$
|-
| [[Image:cfmimetex21c.gif|left]]
| $$ \circle(120;180,270)$$
| [[Image:cfmimetex21d.gif|left]]
| $$ \circle(120;270,360)$$
|}

This structure breaks down into the \circle command followed by the diameter, not the radius, of the circle, followed by a semi-colon, then the demarcation of the arc, the nomination of the start and end points in degrees from the 0, East, start point. Note that the canvas is the size of the diameter nominated by the circle's parameters.

==The \picture Command==

Using circles and arcs as shown above is somewhat limiting. The \picture command allows you to use a frame in which to build a picture of many layers. Each part of the picture though needs to be in its own space, and while this frame allows you to be creative, to a degree, there are some very hard and fast rules about using it.

All elements of a picture need to be located within the picture frame. Unexpected results occur when parts of an arc, for example, runs over the border of the frame. (This is particularly true of lines, which we will get to next, and the consequences of that overstepping of the border can cause serious problems.)

The \picture command is structured like:
\picture(100){(50,50){\circle(200)}}
\command(size of frame){(x co-ordinate, y co-ordinate){\shape to draw(size or x co-ordinate, y co-ordinate)})

'''NOTE:''' The brace is used to enclose each set of required starting point coordinates. Inside each set of braces, another set of braces is used to isolate each set of coordinates from the other, and those coordinates use their proper brackets and backslash. Count the opening and closing brackets, be careful of the position,

{| class="nicetable"
|-
| [[Image:cfmimetex24a.gif|left]]
| $$ \picture(100){(50,50){\circle(200)}}&&

The picture frame brings elements together that you may not otherwise see.

Because of the frame size of 100px and the centre point of the circle in the mid-point of the frame, the 200px circle will be squashed. Unexpected results occur when sizes are not correct.
| [[Image:cfmimetex24b.gif|left]]
|
Using the picture frame, you can layer circles
and lines over each other, or they can intersect.

$$ \picture(100){(50,50){\circle(99)} (50,50){\circle(80)}} $$
|-
| [[Image:cfmimetex24c.gif|left]]
| You may want to see an image of a circle with a dot in the middle.
You may have to try to place the centre dot correctly , but the
ordering of the elements in the image may have an impact.

$$ \picture(100){(48,46){\bullet}(50,50){\circle(99)}} $$
| [[Image:cfmimetex24d.gif|left]]
| Using the same ideas as above, you can make semi-circles.

$$\picture(150){(50,50){\circle(100;0,180)}(100,50){\circle(100;180,360)}}$$
|}

==Lines==

----

'''Warning:''' Drawing lines in TeX Notation in Moodle is an issue, go to the [[Using_TeX_Notation#Reserved_Characters_and_Keywords| Using Text Notation]] for more information. If the line is not noted properly then the parser will try to correctly draw the line but will not successfully complete it. This means that every image that needs be drawn will be drawn until it hits the error. When the error is being converted, it fails, so no subsequent image is drawn. Be careful and make sure your line works BEFORE you move to the next problem or next image.

----
{| class="nicetable"
|-
| [[Image: cfmimetex26.gif|frame|left| a couple of lines]]
| $$\red \picture(200){(20,0){ \line(180,0)}{(20,180){\line(180,0}$$

The structure of the picture box is that the \picture(200) provides a square image template.

The (20,0) provides the starting coordinates for any line that comes after. In this case the start point is at 20pixels in the x axis and 0 pixels in the y axis. The starting point for all coordinates, 0,0, is the bottom left corner and they run in a clockwise manner. '''Do not confuse this with arcs.'''

The \line(180,0) determines the length and inclination of the line. In this case, the inclination is 0 and the length is 180px.

These are enclosed in braces, all inside one set of braces owned by the \picture() control sequence.

The next set of commands are the same, that is, the (20,200) are the coordinates of the next line. The x co-ordinate is the 20, that is the distance to the right from the 0 point. The y co-ordinates is the distance from the bottom of the image. Whereas the first line started and ran on the bottom of the picture frame, the y co-ordinate starts at the 200 pixel mark from the bottom of the image. The line, at 180 pixels long and has no y slope. This creates a spread pair of parallel lines.
| [[Image: cfmimtex27.gif|thumb|right|150px|\picture explained]]
|}

While this explains the structure of a line, there is a couple of elements that you need to go through to do more with them.

==Squares and Rectangles==
Drawing squares and rectangles is similar, but only slightly different.

There should be a square box tool, and there is, but unless it has something inside it, it does not display. It is actually easier to make a square using the \line command.

{| class="nicetable"
|-
| [[Image: line03.gif|left]]
|This box is constructed using:
$$ \picture(250){(10,10){\line(0,230)}(10,10){\line(230,0)}(240,10){\line(0,230)}(10,240){\line(230,0)}}$$
It is a 250 pixel square box with a 230 pixel square inside it.
| [[Image: line04.gif|left]]
|This box is different in that is has the equal length indicators that are used in a square.
$$ \picture(250){(10,10){\line(0,230)}
(5,120){\line(10,0)}
(10,10){\line(230,0)}
(120,5){\line(0,10)}
(240,10){\line(0,230)}
(235,120){\line(10,0)}
(10,240){\line(230,0)}
(120,235){\line(0,10)}}$$
|-
| [[Image: line05.gif|left]]
| The rectangle then becomes the same thing, but with one side shorter. For a portrait canvas it would be:
$$ \picture(250){(10,10){\line(0,230)}(10,10){\line(150,0)}(160,10){\line(0,230)}(10,240){\line(150,0)}}$$
| [[Image: line06.gif|left]]
|The rectangle can also produce a landscape shape:
$$ \picture(250){(10,10){\line(0,160)}(10,10){\line(230,0)}(240,10){\line(0,160)}(10,170){\line(230,0)}}$$
|}

==Controlling Angles==

Controlling angles is a little different. They involve a different perception, but not one that is unfamiliar. Consider this:

We have a point from which we want to draw a line that is on an angle. The notation used at this point can be positive, positive or positive, negative or negative, positive or negative, negative. Think of it like a number plane or a graph, using directed numbers. The 0,0 point is in the centre, and we have four quadrants around it that give us one of the previously mentioned results.

{| class="nicetable"
|-
| rowspan="4"|[[Image:co-ordquadrants.png|left]]
| [[Image:line06a.gif|left]] $$\picture(100){(50,50){\line(40,45)}}$$,
a positive x and positive y
|-
| [[Image:line06b.gif|left]]$$\picture(100){(50,50){\line(-40,45)}}$$
a negative x and positive y
|-
| [[Image:line06c.gif|left]]$$\picture(100){(50,50){\line(-40,-45)}}$$
a negative x and negative y
|-
| [[Image:line06d.gif|left]]$$\picture(100){(50,50){\line(40,-45)}}$$
a positive x and a negative y
|}

Essentially, what these points boil down to is that anything above the insertion point is a positive on the y axis, anything below is a negative. Anything to the left of the insertion point is a negative while everything to the right is a positive.

{| class="nicetable"
|-
|[[Image:line06e.gif|left]]
| $$\picture(100){(50,50){\line(40,45)}(50,50){\line(-40,45)}(50,50){\line(-40,-45)}(50,50){\line(40,-45)}}$$

The co-ordinate alignment process in TeX is not that good that you can use one set of co-ords as a single starting point for all lines. The layering of each object varies because of the position of the previous object, so each object needs to be exactly placed.

This co-ord structure has a great deal of impact on intersecting lines, parallel lines and triangles.
|}

==Intersecting Lines==

You can set up an intersecting pair easily enough, using the \picture control sequence.

{| class="nicetable"
|-
| [[Image:cfmimetex31.gif|left]]
| $$ \picture(200){(10,0){\line(150,150)} (0,130){\line(180,-180)}} $$

The lines that are drawn can be labeled.

$$ \picture(200){(10,0){\line(150,150)}(0,130){\line(180,-180)}
(0,10){A}(0,135){B}(140,0){C}(140,150){D}(62,80){X}} $$

To produce another image.
| [[Image:cfmimetex32.gif|right]]
|-
| colspan="3" style="text-align: center;"| To which you may want to ask the question:
$$The \ \angle \ of \ AXB \ is \ 72\textdegree. \ What \ is \ the \ value \ of \ \angle BXD? $$
[[Image: cfmimetex32a.gif|center]]

NOTE: Labeling this image, above-right, turned out to be fairly simple. Offsetting points by a few pixels at the start or end points of the lines proved a successful strategy. The X point proved a little more problematic, and took a number of adjustments before getting it right. Experience here will help.
|-
| colspan="2"| With labels the drawing can become a little more like your traditional geometric drawing, but the devil is in the details. The parallel markers need to be placed properly, and that is where experience really comes into it. On lines that are vertical or horizontal, you can get away with using the > or < directly from the keyboard, or the <math>\gg</math> or <math>\ll</math> symbols. In either case, you need to position them properly.

The code:
$$\picture(200){(15,45){\line(170,0)} (15,30){c}(170,28){d}(15,160){\line(170,0)}(15,145){e}(180,143){f}(50,20){\line(110,175)}(58,20){a}(140,185){b}(42,32){\kappa}(53,48){\beta}
(150,165){\kappa}
(90,38){\gg}(80,153){\gg}
}$$
| [[Image:line10.gif|right]]
|}

==Lines and Arcs==

Combining lines and arcs is a serious challenge actually, on a number of levels. For example lets take an arc from the first page on circles.
{| class="nicetable"
|-
| [[Image: cfmimetex21a.gif|left]]
| Fairly innocuous of itself, but when we start to add in elements, it changes dramatically.

$$ \circle(120;90,180) $$
|-
| [[Image: line12.gif|left]]
| $$\picture(150){(75,75){\circle(120;90,180)}(75,75){\line(-70,0)}(75,75){\line(0,75)}} $$
All elements in this drawing start in the same place. Each is layered, and properly placed on the canvas, and using the same co-ord to start makes it easy to control them. No matter the size of the arc, intersecting lines can all be drawn using the centre co-ords of the arc.
|}

==Triangles ==

Of all the drawing objects, it is actually triangles that present the most challenge. For example:

{|
|-
| [[Image:line13.gif|left]]
$$\picture(350){(10,10){\line(0,320)}(10,330){\line(330,0)}(10,10){\line(330,320)}}$$
|This is a simple triangle, one that allows us to establish a simple set of rules for the sides. The vertical always has an x=0 co-ord and the horizontal always has a y=0 co-ord.

In this case with an x value of 330 on the horizontal, and a y value of 320 on the vertical, the hypotenuse should then have a value of x=340, and the y=330, but not so, they actually have an x=330 and a y=320.

There is no need to add the starting point co-ords to the x and y values of the line.
| [[Image:line14.gif|right]]
$$picture(350){(10,10){\line(330,0)}(340,10){\line(0,320)}(340,330){\line(-330,-320)}}$$

|}

This triangle has been developed for a Trigonometry page - but the additional notation should provide insight into how you can use it.

{| class="nicetable"
|-
| [[Image:line16.gif|left]]
| This is a labeled image, but it has an \fbox in it with its little line. With some effort, it could be replaced with two intersecting short lines.
$$\picture(350,150){(25,25){\line(300,0)}(325,25){\line(0,110)}(25,25){\line(300,110)}(309,25){\fbox{\line(5,5)}}
(307,98){\theta}(135,75){\beta}(150,5){\alpha}(335,75){\epsilon}}$$
|}

{| class="nicetable"
|-
| The triangle shows like:
[[Image:trig01.gif|left]]
|We use the different elements of the triangle to identify those things we need to know about a right-angled triangle.

The hypotenuse is always the side that is opposite the right angle. The longest side is always the Hypotenuse.

To identify the other elements of the triangle we look for the sign <math>\theta</math>. <math>\Theta</math> is the starting point for naming the other sides.

The side that is opposite <math>\angle \theta</math> is known as the Opposite.

The side that lies alongside <math>\angle \theta</math> is known as the Adjacent side.

To determine which is which, draw a line that bisects <math>\angle \theta</math> and whatever line it crosses is the Opposite side.
|-
| colspan="2"| The code:
$$ \picture(350,250){(25,25){\line(300,0)}(25,25){\line(0,220)}(25,245){\line(300,-220)}(310,25){\circle(100;135,180)}(20,100){\line(310,-75)} (25,25){\fbox{\line(5,5)}}(25,25){\line(150,150)}(165,140){Hypotenuse}(120,2){Adjacent}(2,80){\rotatebox{90}{Opposite}}(270,40){\theta}}$$
|}

=Matrices=
A Matrix is a rectangular array of numbers arranged in rows and columns which can be used to organize numeric information. Matrices can be used to predict trends and outcomes in real situations - i.e. polling.

==A Matrix==
A matrix can be written and displayed like [[Image: matrices03.gif|A matrix]]

In this case the matrix is constructed using the brackets before creating the array:
$$ M = \left[\begin{array}{ccc} a&b&1 \ c&d&2 \ e&f&3\end{array}\right] $$
The internal structure of the array is generated by the &, ampersand, and the double backslash.

You can also create a grid for the matrix.

{| class="nicetable"
|-
|A dashed line
|A solid line
|A mixed line
|-
|[[Image: matrices04.gif]]
|[[Image: matrices05.gif]]
|[[Image: matrices06.gif]]
|-
|$$ M = \left[\begin{array}'''{c.c.c}''' a&b&1 \ '''\hdash''' c&d&2 \ '''\hdash''' e&f&3\end{array}\right] $$
|$$ M = \left[\begin{array}'''{c|c|c}''' a&b&1 \ '''\hline''' c&d&2 \ '''\hline''' e&f&3\end{array}\right] $$
|$$ M = \left[\begin{array}'''{c.c|c}''' a&b&1 \ '''\hline''' c&d&2 \ '''\hdash''' e&f&3\end{array}\right] $$
|}

The command sequences here are the {c|c.c} and \hdash and \hline. The pipe, |, and the full stop determine the line type for the vertical line.

Matrices also respond to other TeX Notation commands such as size and colour.

{| class="nicetable"
|-
|
Colour
| colspan="2"|Size
|-
|[[Image: matrices07.gif]]
|[[Image: matrices08.gif]]
|[[Image: matrices09.gif]]
|-
|$$ '''\blue''' M = \left[\begin{array}{c.c.c} a&b&1 \ \hdash c&d&2 \ \hdash e&f&3\end{array}\right] $$
|$$ '''\fs7''' M = \left[\begin{array}{c.c.c} a&b&1 \ \hdash c&d&2 \ \hdash e&f&3\end{array}\right] $$
|$$ '''\fs2''' M = \left[\begin{array}{c.c.c} a&b&1 \ \hdash c&d&2 \ \hdash e&f&3\end{array}\right] $$
|}

==Creating equal and unequal matrices==
Equal and unequal matrices are simply matrices that either share or not share the same number of rows and columns. To be more precise, equal matrices share the same order and each element in the corresponding positions are equal. Anything else is unequal matrices.

Actually equal and unequal matrices are constructed along similar lines, but have different shapes:

{| class="nicetable"
|-
|Equal Matrix
|An unequal matrix
|-
|[[Image: matrices10.gif]]
|[[Image: matrices11.gif]]
|-
| $$ \left[\begin{array} a&b&1 \ c&d&2 \ e&f&3\end{array}\right] \ = \ \left[\begin{array} 12&11&z \ 10&9&y \ 8&7&x\end{array}\right] $$
| $$ \left[\begin{array} a&b \ c&d \ e&f \end{array}\right] \ \neq \ \left[\begin{array} 12&11&z \ 10&9&y \ 8&7&x\end{array}\right] $$
|}

==Labeling a Matrix==

Addition and subtraction matrices are similar again, but the presentation is usually very different. The problem comes when trying to mix labels into arrays. The lack of sophistication in the TeX Notation plays against it here.

Moodle allows an easy adoption of tables to make it work though. For example:

Bill the baker supplies three shops, A, B and C with pies, pasties and sausage rolls.
He is expected to determine the stock levels of those three shops in his estimation of supplies.

It is better to use the Moodle Fullscreen editor for this, to have a better idea of how the end product will look and to take advantage of the additional tools available. Design decisions need occupy our attention for a while. We need a table of five rows and four columns. The first row is a header row, so the label is centred. The next row needs four columns, a blank cell to start and labels A, B and C. The next three rows are divided into two columns, with the labels, pies, pasties and sausage rolls in each row of the first column and the matrix resides in a merged set of columns there. So first the table:

{| class="nicetable"
|-
| Insert Table - initial properties
| Merge Cells Button
| Advanced Properties
|-
| rowspan="2"|[[Image: matricestable01.png|Table properties]]
| [[Image: matricestable02.png | Merge cells]]
| [[Image: matricestable03.png | Cell properties button]]
|-
| colspan="2"| You may need to look into the Advanced properties setting of the tables and cells to make this work.
|}

This is the immediate result:

[[Image: matricestable04.png | The resulting table]]

While not a very good look, it can be made better by tweaking the table using the advanced settings and properties buttons and then you can tweak the matrix itself.

==Tweaking the Matrix==

[[Image: matricestable05a.png | A tweaked matrix]]

Things are not always as they seem, be aware, the "c" does not stand for "column", it actually stands for "centre". The columns are aligned by the letters l, for left, c for centre and r for right.

Each column is spread across 50 pixels, so the value of 50 is entered into the alignment declaration. The plus sign before the value is used to "propogate" or to force the value across the whole matrix, but is not used when wanting to separate only one column.

To set the rows is a little more problematic. The capital letter C sets the vertical alignment to the centre, (B is for baseline, but that does not guarantee that the numbers will appear on the base line, and there does not appear to be any third value). The plus sign and following value sets the height of all rows to the number given. In this I have given it a value of 25 pixels for the entire matrix. If there were four or five rows, the same height requirement is made.

The order things appear is also important. If you change the order of these settings, they will either not work at all, or will not render as you expect them to. If something does not work properly, then check to make sure you have the right order first.

==An Addition Matrix==

The rule for performing operations on matrices is that they must be equal matrices. For example, addition matrices look like:

[[Image: matricestable06.png | An addition matrix]]

with the results obvious. The code is:

$$\left[\begin{array}{c+50C+25.c.c}
11&14&12 \ \hdash16&12&22 \ \hdash 14&17&15
\end{array}\right] + \left[\begin{array}{c+50C+25.c.c}
60&60&60 \ \hdash 40&40&30 \ \hdash 30&30&30
\end{array}\right] $$

==A Subtraction Matrix==

Similar to an addition matrix in its construction, the subtraction matrix is subject to the same rules of equality.

Using the same essential data, we can calculate the daily sales of each of the shops.

[[Image: matricestable07.png | A subtraction matrix]]

The code is:
$$ \left[\begin{array}{c+50C+25.c.c}
72&95&68 \ \hdash 54&61&65 \ \hdash 48&51&60
\end{array}\right] - \left[\begin{array}{c+50C+25.c.c}
11&14&12 \ \hdash 16&12&22 \ \hdash 14&17&15
\end{array}\right] = \left[\begin{array}{c+50C+25.c.c}
61&81&56 \ \hdash 38&49&43 \ \hdash 34&34&48
\end{array}\right] $$

This code looks more complex than it really is, it is cluttered by the lines and alignment sequences.

==Multiplication Matrices==

Different than the addition or subtraction matrices, the multiplication matrix comes in three parts, the row matrix, the column matrix and the answer matrix. This implies it has a different construction methodology.

[[Image: matrices16.gif | A multiplication matrix]]

And the code for this is:
$$ \begin{array} 10&14&16\end{array} \
\left[\begin{array} 45 \\ 61 \\ 19 \end{array}\right]
\ = \ \begin{array} 450&854&304\end{array} $$

While different, it is not necessarily more complex. For example a problem like:

Bill the baker is selling his product to Con the cafe owner, who
wants to make sure his overall prices are profitable for himself.
Con needs to make sure that his average price is providing sufficient
profit to be able to keep the cafes open. Con makes his calculations
on a weekly basis, comparing cost to sale prices.

With the pies, pasties and sausage rolls in that order he applies them to the cost and sale price columns :

[[Image: matrices17.gif | A multiplication matrix]]

The code for this is:
$$\left[\begin{array} 350&310&270 \end{array}\right] \
\left[\begin{array} \$2.10&\$3.60 \ \$2.05&\$3.60 \ \$1.90&\$3.10 \end{array}
\right] \ = \ \left[\begin{array} \$735.00&\$1260.00 \ \$635.50&\$1116.00 \
\$513.00&$\837.00 \end{array}\right] $$

==See Also==
* [[MathJax_filter]] - available in Moodle 2.7 and later
* [[TeX notation filter]] To turn on the TeX Notation
* [[Advanced Maths Tools]] Moodle 2.x - The Next Generation of TeX Tools
* [[DragMath equation editor]]
* [[Chemistry notation using mhchem]]

[[Category:Mathematics]]

Capabilities/moodle/tag:edit

2015-10-28T10:35:10Z

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

{{Capabilities}}
*This allows a user to [[Using tags|edit a tag]] to add a description and related tags.
* The default authenticated user role has this capability set to allow
* This capability may only be applied in the system context i.e. as a system role

[[Category:Capabilities|Tag]]
[[Category:Tags]]

[[fr:Capabilities/moodle/tag:edit]]
[[ja:ケイパビリティ/moodle/tag:edit]]
[[es:Capabilities/moodle/tag:edit]]

Capabilities/moodle/tag:edit

2015-10-28T10:32:54Z

Marycooch: not set auth user

{{Capabilities}}
*This allows a user to [[Using tags|edit a tag]] to add a description and related tags.
* This capability is Not set by default for the role of authenticated user.
* This capability may only be applied in the system context i.e. as a system role

[[Category:Capabilities|Tag]]
[[Category:Tags]]

[[fr:Capabilities/moodle/tag:edit]]
[[ja:ケイパビリティ/moodle/tag:edit]]
[[es:Capabilities/moodle/tag:edit]]

Question types

2015-10-26T09:29:58Z

Marycooch: /* Standard question types */

{{Questions}}You may add a variety of different types of questions in the Quiz and Lesson modules. This page is about [[Quiz module]] question types; some will be similar to [[Lesson questions]] types, which are fewer in number and function differently. The standard quiz question types are listed below with brief descriptions. '''Please use the links on the right side of this page to find more detailed information about standard questions types.'''

==Changing the order of the question types==
The administrator can specify the order the question types appear in the question chooser so that teachers are presented with the most common ones at the top. This is done from ''Site administration > Plugins > Question types > Manage question types.'' The administrator uses the arrows to reorder the question types and the teacher will then see their favourites first when creating a new question:

[[File:commonquestions.png|thumb|400px|center|Most common question types first]]

==Standard question types==

=== Calculated ===
Calculated questions offer a way to create individual numerical questions by the use of wildcards that are substituted with individual values when the quiz is taken. [[Calculated_question_type|More on the Calculated question type]]

===Calculated multi-choice===
Calculated multichoice questions are like multichoice questions with the additonal property that the elements to select can include formula results from numeric values that are selected randomly from a set when the quiz is taken. They use the same wildcards than Calculated questions and their wildcards can be shared with other Calculated multichoice or regular Calculated questions.

The main difference is that the formula is included in the answer choice as {=...} i.e if you calculate the surface of a rectangle {={l}*{w}}.

[https://docs.moodle.org/29/en/Calculated_multichoice_question_type More on the Calculated Multi-Choice question type.]

===Calculated simple===
Simple calculated questions offer a way to create individual numerical questions whose response is the result of a numerical formula which contain variable numerical values by the use of wildcards (i.e {x} , {y}) that are substituted with random values when the quiz is taken.

The simple calculated questions offers the most used features of the calculated question with a much simpler creation interface. [https://docs.moodle.org/29/en/Simple_calculated_question_type More on the Simple Calculated Question type.]

=== Description ===
This question type is not actually a question. It just prints some text (and possibly graphics) without requiring an answer. This can be used to provide some information to be used by a subsequent group of questions, for example. [[Description_question_type|More on the Description question type]]

=== Essay ===
This allows students to write at length on a particular subject and must be manually graded.

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

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

=== Matching ===
A list of sub-questions is provided, along with a list of answers. The respondent must "match" the correct answers with each question. [[Matching_question_type|More on the Matching question type]]

=== Embedded Answers ([http://en.wikipedia.org/wiki/Cloze_test Cloze Test] / Gap Fill) ===
These very flexible questions consist of a passage of text (in Moodle format) that has various answers embedded within it, including multiple choice, short answers and numerical answers. [[Embedded_Answers_(Cloze)_question_type|More on the Embedded Answers question type]]

=== Multiple choice ===
With the [[Multiple Choice question type]] you can create single-answer and multiple-answer questions, include pictures, sound or other media in the question and/or answer options (by inserting HTML) and weight individual answers.

=== Short Answer ===
In response to a question (that may include an image), the respondent types a word or phrase. There may several possible correct answers, with different grades. Answers may or may not be sensitive to case. [[Short-Answer_question_type|More on the Short Answer question type]]

=== Numerical ===
From the student perspective, a numerical question looks just like a short-answer question. The difference is that numerical answers are allowed to have an accepted error. This allows a continuous range of answers to be set. [[Numerical_question_type|More on the Numerical question type]]
===Random short-answer matching===
From the student perspective, this looks just like a Matching question. The difference is that the sub-questions are drawn randomly from Short Answer questions in the current category. [[Random_Short-Answer_Matching_question_type|More on the Random Short-Answer Matching question type]]
=== True/False ===
In response to a question (that may include an image), the respondent selects from two options: True or False. [[True/False_question_type|More on the True/False question type]]

==Third-party question types==

Besides the standard question types that are part of the core Moodle distribution, there are a number of [https://moodle.org/plugins/browse.php?list=category&id=29 question type add-ons] in [https://moodle.org/plugins the add-ons database].

Some of those add-ons have additional documentation in [[Third-party_question_types|Third-party question types]]:

==See also==
* [[Lesson questions]]
* [https://moodle.org/plugins/view.php?plugin=mod_qpractice Question practice] additional activity

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

[[ca:Tipus_de_preguntes]]
[[es:Tipos de preguntas]]
[[eu:Galdera-motak]]
[[fr:Types de questions]]
[[ja:問題タイプ]]

File:commonquestions.png

2015-10-26T09:28:11Z

Marycooch:

Talk:Guide for new administrators

2015-10-13T15:16:36Z

Marycooch:

This is very nicely done. I am sure that there are things that can be tweaked but I think it hits all the important bases really well for beginning moodle admins.

--[[User:Mark Pearson 2|Mark Pearson 2]] ([[User talk:Mark Pearson 2|talk]]) 22:56, 13 October 2015 (AWST)

==Reply==
Thanks for the comment- as it is a wiki, people are welcome to suggest improvements or tweaks :) --[[User:Mary Cooch|Mary Cooch]] ([[User talk:Mary Cooch|talk]]) 23:16, 13 October 2015 (AWST)

Course completion status block

2015-10-08T07:09:58Z

Marycooch: /* Teacher view of Course completion status block */

{{Blocks}}
==Displaying the status of course completion==

The course completion status block shows what has been done towards [[Course completion|completing the course]]. The student and teacher will both see this block. The "More information" link will lead to a more detailed report. This report can have some interactive elements in the form of check boxes for the student and teacher.

==Student view of Course completion status block==
The student can see their progress in the course by looking at the content of the block or clicking on the "More details" link to see a report.

The student, if required, can mark an activity as completed on the course's homepage.

<gallery widths=250" perrow="3">
File:CompletionBlock_Complete_Student.jpg|Course completion status block, student view
File:Course completion report student 01.PNG|Course completion report, student view, 1 course
File:Course completion report student 02.png|Course completion report, student view, 2 courses - teacher needs to mark complete
File:Course completion course homepage student view.png|Course homepage, students has completed lesson, needs to self complete quiz
</gallery>

==Teacher view of Course completion status block==

This block shows the status for each student. It is also the place where the teacher (or others) can mark the course as complete.

Note: The course completion status block will only appear if completion tracking criteria are set in ''Administration > Course administration > Completion tracking''. This is what the teacher sees:

<gallery >
File:Course completion status block teacher.PNG|Course completion status block, teacher view, 1 course
File:Course completion report teacher 01.PNG|Course completion report, teacher view, 1 course
File:Course completion report teacher 2.png|Course completion report, teacher view, showing prerequisite
</gallery>

==Capabilities==

There is just one capability: [[Capabilities/moodle/course:isincompletionreports| Be shown on completion reports]]

==See also==

* [[Course completion]]

[[Category:Completion]]

[[eu:Ikastaro-osaketaren_egoera_blokea]]
[[de:Kursbearbeitungsstatus-Block]]
[[es:Bloque de status de finalización del curso]]

Statistics

2015-10-06T15:00:47Z

Marycooch: /* Statistics not working? */

{{Course reports}}
If statistics are enabled for the site, graphs and tables of user activity may be generated.

[[File:Statistics.png]]

The statistics graphs and tables show how many '''hits''' there have been on various parts of your site during various time frames. They '''do not''' show how many distinct users there have been. They are processed daily at a time you specify. You must enable statistics before you will see anything.

==Enabling statistics==

Statistics must be enabled by a site administrator in ''Administration > Site administration > Advanced features''.

In Moodle 2.4.2 onwards, once statistics have been enabled, the screen to configure them becomes visible as a link in ''Administration > Site administration > Server > Statistics''. (In older versions the link was always available irrespective of whether statistics was enabled.)

The Course overview report will also then be accessible from ''Administration> Site administration > Reports''.

==Site administration settings==

Various settings for statistics may be set by an administrator in ''Administration > Site administration > Server > Statistics''.

As stats processing is quite resource intensive, it is recommended that you should set the stats processing to start in the early morning.

:''TIP:'' Set the stats processing to start an hour before your automated course backups are scheduled to start, then set the maximum runtime to 1 hour. This ensures that stats are not being processed at the same time as course backups are being made.

==Statistics not working?==

If statistics isn't working and you have checked all the obvious (such as whether it's enabled), check ''Administration > Site administration > Plugins > Activity modules'' for any old hidden modules in the database which miss the files in the ''moodle/mod'' folder on your server. If you find any, they should be deleted.

You can also try limiting the length of time logs are kept for to reduce the size of the tables. Go to ''Site administration > Plugins > Logging > Standard log''.

To run stats manually, go to the database, go to the mdl_config table and set statslastdaily, statslastweekly and statslastmonthly to 0 (leave statslastmonthly alone if you think it might be large logtables causing the problem). Then go to ''Administration > Site administration > Server > Scheduled tasks'' and look for the task "Background processing for statistics"; set this to be a minute or two into the future by adjusting the hour and minute values. If you manually run cron, you should see output there showing that stats are processing, but be patient if it appears to hang - this can take between 5 mins and several hours depending on how big your site is, so just leave it going. Afterwards, you might want to return the Scheduled task's values back to asterisks so that it returns to the defined schedule.

==Viewing statistics==

A manager, teacher or non-editing teacher (or any other user with the capability [[Capabilities/report/stats:view|report/stats:view]]) can view statistics for their course in ''Administration > Course administration > Reports > Statistics''.

An administrator can view statistics for the site in ''Administration > Site administration > Reports > Statistics''.

[[Category:Site administration]]

[[de:Statistiken]]
[[es:Estadísticas]]
[[fr:Statistiques]]

Drag and drop marker question type

2015-10-04T15:41:04Z

Marycooch:

{{Questions}}
This page is about the [https://moodle.org/plugins/view.php?id=234 drag and drop marker question type], which is a question type allowing students to drop markers onto an area on a background image. Drag and drop marker questions differ from [[Drag and drop onto image question type]] in that there are no predefined areas on the underlying image that are visible to the student.

==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.) In our example, students must correctly locate regions of Australia.

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 maxiumum 600 x 400.Your image will then display under the file upload box. Note that gridlines are visible:

[[File:dragdropmarkerimageupload.png]]

In the '''Markers''' section, add the words you want the students to drag onto the areas you select.

[[File:ddmarkerswords.png]]

In the 'Number' dropdown, you can select the number of times the marker can be used. Selecting 1 means that when it has been used once, it will no longer be available in the list. It is fine to leave the numbers as the default 'Infinite'; it just means that each marker will still remain once it has been used.

In the '''Dropzones''' section, decide the shape you want the selectable areas to be:circle, polygon or rectangle. Our example uses a rectangle. In each 'Marker' dropdown, choose the item you want for that area.

You will now see by your uploaded image that these names are displayed:

[[File:ddmarkersimageandwords.png]]

Now you need manually to add the coordinates of the areas into which you want students to position the marker.

Click the question mark icon [[File:helppopup.png]] next to Drop zone 1 to see how to add these for your chosen shape.

Our example uses a rectangle. We need to define four numbers:
# the top left corner of our selected area, by counting the boxes in from the left...
#and down from the top. Each box is ten pixels so three boxes = 300 for example.
#the width of our selected area, by counting the boxes across
#the height of our selected area, by counting the boxes up

The numbers are separated by commas, with a semi-colon separating the corner coordinates from the size, eg: 20,50:150,200

[[File:ddcoordinatesexample.png]]

The image updates immediately so you can check your accuracy and adapt the coordinates. The above co-ordinates preview as below:

[[File:ddcoordinates.png]]

Once all co-ordinates have been manually entered, you can save the changes and preview the question.

'''IMPORTANT NOTE:''' When dragging a marker, students must position the little circle top left of the marker in the centre of the area they have selected, ''not the whole marker'', as this might cause confusion and an unexpected incorrect answer.

[[File:ddexamplepositioning1.png]]

===Using markers and drop zones more than once===
If 'Infinite' is selected from the 'Numbers' dropdown in the '''Markers''' section, then the markers may be used more than once.

If the same coordinates must used for several markers in the '''Drop zones''' section, then more than one marker may be placed in a single area, as in the example below (1) , where students identify regions of Great Britain, the UK and the British Isles (2):

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

==Accessibility==
Marker questions are keyboard accessible. Use the <tab> key to move between the markers and the <arrow> keys to position the markers.

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

If more markers are placed on the image than there are drop-zones a penalty is applied for the extra markers. If there are n drop zones and n+m markers are placed of which p are placed correctly the score is calculated as p/(m+n).

If the question is used in 'interactive with multiple tries' style 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.

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

'''State which markers are incorrectly placed:''' Include in the feedback a list of markers which are incorrectly placed.

'''Move incorrectly placed markers back to default start position below image:''' When ‘Try again’ is clicked incorrectly positioned labels are removed.

== More documentation ==

More [http://www.open.edu/openlearnworks/course/view.php?id=1581 documentation is available] in the [http://www.open.edu/openlearnworks/mod/oucontent/view.php?id=52747 Open University's reference manual].

== See also ==

* [http://moodle.org/plugins/browse.php?list=set&id=10 Other Moodle plugins from the Open University]
* [http://moodle.org/plugins/browse.php?list=category&id=29 Other third-party question type plugins]
* [http://labspace.open.ac.uk/course/view.php?id=3484 eAssessment at the Open University with open source software]
* [http://www.somerandomthoughts.com/blog/2012/02/20/review-question-type-drag-and-drop-marker-for-moodle-2/ Review of this question type]
* [http://www.youtube.com/watch?v=Tvl4GuGvtxc Video tutorial: How to Create a Question Using the Drag and Drop with Markers Question Type]

[[Category:Contributed code]]
[[Category:Open University]]

[[es:Tipo de pregunta arrastrar y soltar marcador]]

question/type/ddmarker

2015-10-04T15:40:29Z

Marycooch: redirecting

#REDIRECT [[Drag and drop marker question type]]

Drag and drop into text

2015-10-02T12:05:37Z

Marycooch: Redirected page to Drag and drop into text question type

#REDIRECT [[Drag and drop into text question type]]

question/type/ddwtos

2015-10-02T12:04:43Z

Marycooch: redirecting

#REDIRECT [[Drag and drop into text question type]]

Third-party question types

2015-10-02T12:03:35Z

Marycooch:

{{Questions}}
Besides the standard [[Question types]] that are part of the core Moodle distribution, there are a number of [https://moodle.org/plugins/browse.php?list=category&id=29 additional question type plugins] in [https://moodle.org/plugins the plugins database].

Some of those additional question types have their documentation links below. There are many question types available for assessing the knowledge of [[:Category:Chemistry|chemistry]], [[:Category:Mathematics|maths]], [[:Category:Music|music]] and [[:Category:Programming|computer programming]], but as more new additional plugins are continuously being developed, this list might be outdated. The Supported Moodle versions listed here were those available at the time this documentation page was made and might have been updated (or not):

* [[2D/3D structure display short answer]] (Moodle 2.3 to 2.6)
* [[Algebra question type]]
* [[All or nothing multiple choice question type]]
* [[Calculated Objects question type]] (Moodle 2.0 to 2.3)
* [[Cloze editor module]]
* [[Combined question type]]
* [[Concept map question type]]
* [[Correct writing question type]]
* [[Drag and drop into text question type]]
* [[Drag and drop marker question type]]
* [[Drag and drop matching question type]]
* [[Drag and drop onto image question type]]
* [[Drag and drop organic chemestry nomenclature question type]] (Moodle 2.3 to 2.7)
* [[Electron pushing / curved question type]] (Moodle 2.3 to 2.7)
* [[Fischer projections question type]] (Moodle 2.3 to 2.6)
* [[Formulas question type]]
* [[Freehand drawing question type]] (Moodle 2.5 only)
* [[Gapfill question type]]
* [[Java Molecular Editor question type]]
* [[Javaunittest question type]]
* [[Lewis structures]] (Moodle 2.3 to 2.6 only)
* [[Matrix question type]] (Moodle 2.2 only)
* [[Multinumerical question type]] (Moodle 2.0 to 2.7 only)
* [[Music interval question type]] (Moodle 2.3 and 2.4 only)
* [[Music key signature question type]] (Moodle 2.3 and 2.4 only)
* [[Music scale question type]] (Moodle 2.3 and 2.4 only)
* [[Music theory question type]]
* [[Name to structure or reaction question type]] (Moodle 2.3 to 2.7)
* [[Newman projections question type]] (Moodle 2.3 to 2.6)
* [[Opaque question type]]
* [[Ordering question type]]
* [[OU multiple response question type]]
* [[Pattern-match question type]]
* [[Pattern-match with JME question type]]
* [[Perl-compatible regular expression question type]]
* [[POAS abstract question type]]
* [[PoodLL recording question type]]
* [[Preg question type]]
* [[Regular Expression Short-Answer question type]] (Moodle 2.2 to 2.7 only)
* [[Reverse pattern match question type]]
* [[Select atoms or molecules question type]] (Moodle 2.3 to 2.6)
* [[Select missing words question type]]
* [[Set splitting question type]] (Moodle 2.2 only)
* [[Spreadsheet question type]] (Moodle 2.1 to 2.5 only)
* [[STACK question type]]
* [[Structure match with editor question type]] (Moodle 2.4 to 2.7 only)
* [[Variable numeric question type]]
* [[Variable numeric set question type]]
* [[Variable numeric set with units question type]]
* [[Vertical matching question type]] (Moodle 2.2 to 2.4 only)
* [[WIRIS math & science questions]]

==See also==
* [https://moodle.org/plugins/view.php?plugin=mod_qpractice Question practice] additional activity

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

[[es:Preguntas de terceros]]

Third-party question types

2015-10-02T12:03:19Z

Marycooch:

{{Questions}}
Besides the standard [[Question types]] that are part of the core Moodle distribution, there are a number of [https://moodle.org/plugins/browse.php?list=category&id=29 additional question type plugins] in [https://moodle.org/plugins the plugins database].

Some of those additional question types have their documentation links below. There are many question types available for assessing the knowledge of [[:Category:Chemistry|chemistry]], [[:Category:Mathematics|maths]], [[:Category:Music|music]] and [[:Category:Programming|computer programming]], but as more new additional plugins are continuously being developed, this list might be outdated. The Supported Moodle versions listed here were those available at the time this documentation page was made and might have been updated (or not):

* [[2D/3D structure display short answer]] (Moodle 2.3 to 2.6)
* [[Algebra question type]]
* [[All or nothing multiple choice question type]]
* [[Calculated Objects question type]] (Moodle 2.0 to 2.3)
* [[Cloze editor module]]
* [[Combined question type]]
* [[Concept map question type]]
* [[Correct writing question type]]
* [[Drag and drop into text] question type]
* [[Drag and drop marker question type]]
* [[Drag and drop matching question type]]
* [[Drag and drop onto image question type]]
* [[Drag and drop organic chemestry nomenclature question type]] (Moodle 2.3 to 2.7)
* [[Electron pushing / curved question type]] (Moodle 2.3 to 2.7)
* [[Fischer projections question type]] (Moodle 2.3 to 2.6)
* [[Formulas question type]]
* [[Freehand drawing question type]] (Moodle 2.5 only)
* [[Gapfill question type]]
* [[Java Molecular Editor question type]]
* [[Javaunittest question type]]
* [[Lewis structures]] (Moodle 2.3 to 2.6 only)
* [[Matrix question type]] (Moodle 2.2 only)
* [[Multinumerical question type]] (Moodle 2.0 to 2.7 only)
* [[Music interval question type]] (Moodle 2.3 and 2.4 only)
* [[Music key signature question type]] (Moodle 2.3 and 2.4 only)
* [[Music scale question type]] (Moodle 2.3 and 2.4 only)
* [[Music theory question type]]
* [[Name to structure or reaction question type]] (Moodle 2.3 to 2.7)
* [[Newman projections question type]] (Moodle 2.3 to 2.6)
* [[Opaque question type]]
* [[Ordering question type]]
* [[OU multiple response question type]]
* [[Pattern-match question type]]
* [[Pattern-match with JME question type]]
* [[Perl-compatible regular expression question type]]
* [[POAS abstract question type]]
* [[PoodLL recording question type]]
* [[Preg question type]]
* [[Regular Expression Short-Answer question type]] (Moodle 2.2 to 2.7 only)
* [[Reverse pattern match question type]]
* [[Select atoms or molecules question type]] (Moodle 2.3 to 2.6)
* [[Select missing words question type]]
* [[Set splitting question type]] (Moodle 2.2 only)
* [[Spreadsheet question type]] (Moodle 2.1 to 2.5 only)
* [[STACK question type]]
* [[Structure match with editor question type]] (Moodle 2.4 to 2.7 only)
* [[Variable numeric question type]]
* [[Variable numeric set question type]]
* [[Variable numeric set with units question type]]
* [[Vertical matching question type]] (Moodle 2.2 to 2.4 only)
* [[WIRIS math & science questions]]

==See also==
* [https://moodle.org/plugins/view.php?plugin=mod_qpractice Question practice] additional activity

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

[[es:Preguntas de terceros]]

Drag and drop into text question type

2015-10-02T12:02:52Z

Marycooch: added to this page for consistency with other pages

{{Questions}}A drag and drop question type where missing words have to be dragged into gaps in a paragraph of text.
==Moodle versions available==
This question type is available for Moodle 2.1 to 2.9 from the [https://moodle.org/plugins/pluginversions.php?plugin=qtype_ddwtos Moodle plugins database].

==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.
*Use double square brackets wo sets of square brackets <nowiki>'[[n]]' </nowiki> with a number in place of the word you wish the students to find:

[[File:dragdroptextquestion.png|400px|center]]

*Add the missing words or phrases in the correctly numbered boxes in the 'Choice' section. (You may add extra ones to make the question harder. If you tick 'Shuffle' the display order will be shuffled:

[[File:dragdroptextchoices.png|400px|center]]

*Limited formatting of text using <nowiki> <sub>, <sup>, <b>, <i>, <em> and <strong> </nowiki> is allowed.

===Groups===

*Choices that are within the same Group are colour coded and may only be dropped in a gap with the corresponding colour. Choices that are marked as 'infinite' may be used in multiple locations.
*In the example below, Group 1 are verbs and Group 2 are possessive adjectives:
[[File:dragdroptextgroupchoice.png|400px|center]]
*The students see Group 1 as white boxes and Group 2 as grey boxes:

[[File:dragdroptextgroupdisplay.png|400px|center]]

It is not possible to have drag boxes containing multiple lines. If you want to drag long sentences - don't. Give each a label and drag the label.

===Accessibility===

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

===Scoring and Feedback===

All gaps are weighted identically. Only gaps that are filled correctly gain marks. There is no negative marking of gaps that are filled incorrectly. The scoring and feedback systems are similar to standard question types.

===Is there a wildcard for blanks to be empty?===
The only way to do this is to make a drag item that looks empty, and make students drag that into the boxes that should be empty. As the code ignores drag items that comprise only spaces, you will need to try to use something like a non-breaking space (easy to do with 1 click in the [[TinyMCE_editor]], or type <nowiki>&nbsp</nowiki> in other [[Text editor]]).

== More documentation ==
* See the [http://www.open.edu/openlearnworks/mod/oucontent/view.php?id=52747&section=2.3.1 original page]] at the O U site.
* More [http://www.open.edu/openlearnworks/course/view.php?id=1581 documentation is available] in the [http://www.open.edu/openlearnworks/mod/oucontent/view.php?id=52747 Open University's reference manual].
* Nice YouTube video clip: https://www.youtube.com/watch?v=ohoTEfiNGA4

== See also ==

* [http://moodle.org/plugins/browse.php?list=set&id=10 Other Moodle plugins from the Open University]
* [http://moodle.org/plugins/browse.php?list=category&id=29 Other third-party question type plugins]
* [http://labspace.open.ac.uk/course/view.php?id=3484 eAssessment at the Open University with open source software]

[[Category:Contributed code]]
[[Category:Open University]]

[[de:question/type/ddwtos]]
[[es:Tipo de pregunta arrastrar y soltar al texto]]

Drag and drop into text question type

2015-10-02T12:01:57Z

Marycooch: Created page with "."