MoodleDocs - User contributions [en]

question/type/stack/adminui/caschat

2025-02-05T08:33:49Z

Koen: Created page with "More information on testing CAS can be found on https://github.com/maths/moodle-qtype_stack/blob/master/doc/en/Installation/Testing_installation.md"

More information on testing CAS can be found on https://github.com/maths/moodle-qtype_stack/blob/master/doc/en/Installation/Testing_installation.md

Maintaining a language pack

2024-05-30T05:55:08Z

Koen: /* The role of language pack maintainer */ check for outdated strings can only be done by the language pack maintainer

{{Translation}}
==Volunteering to become a language pack maintainer==
If your language currently doesn't have a language pack maintainer, and you would like to volunteer, please [http://lang.moodle.org/login/signup.php create an account on the Translation site] and contact our Moodle translation coordinator, Koen Roggemans, [mailto:translation@moodle.org translation@moodle.org].
== The role of language pack maintainer==
A language pack maintainer for a Moodle language pack takes responsibility for that language pack. It means contributing to the translation, reviewing contributions of other contributors and approving, improving or rejecting them within a reasonable time frame. The language pack maintainer must pay special attention to the consistency of all Moodle and other terminology all over the language pack. He/She must also pay special attention to the technical correctness of what goes in the language pack since problematic strings can ultimately cause a site in that language to break.

The language pack maintainer should regularly check for outdated strings. Outdated strings are strings that have a modified translation that should be reviewed. The language pack maintainer is the only person who can perform this task. Select all components, tick the "outdated strings only" box and hit "Show strings". Now review all listed strings

The aim of a language pack maintainer is to get the language pack complete for a standard Moodle installation.
== Steps for the maintainer, making own contributions==
# Use AMOS translator interface to translate missing strings or amend the current translation
# Go to the Stage page
# Make a meaningful comment about your work in the 'Commit message' form
# Click on 'Commit'
== Approving contributions from others==
AMOS allows community members to help with the translation of Moodle strings.
[[image:amos4.png|300px|thumb|right|Contribution details page]]
# When a user submits a new contribution, you will receive an automatically generated email from AMOS containing a link to the contribution.
# Press 'Start review' button. That will assign the contribution to yourself, change the status from 'New' to 'In review', send an automatically generated email to the contributor and will copy the submitted strings into your stage. You should check that your stage is empty before you apply the submitted strings unless you want to merge several contributions into one commit.
# Review the submitted strings, eventually edit them. Commit the stage. It is nice to mention the contributor's name in the commit message and attribute the original authorship to them.
# Go back to the contribution record and change the status to Accepted or Rejected. An automatically generated email will be sent to the contributor whenever you change the status.
# Use contribution record comments for further communication with the contributor about the submitted translation.
# Accepted and Rejected contributions are not shown at the contributions page unless you click the 'Show resolved contributions' button.
# You will get a weekly reminder of contributed strings that are not processed yet.
==Translating strings offline==
You can use the [[:en:Language customization|Language customisation]] tool in your local Moodle server to enhance the translation of language strings for the Moodle core files.
If you want to translate the strings of a particular plugin, you must have that plugin installed on your server first.
Your translated files will be located inside the local language folder in your Moodle server.
You can upload these files to AMOS, one file at a time, or zip many files and upload the zip file (which will be un-zipped automatically inside AMOS).
==Uploading a file of translations==
To avoid making changes one by one, you can do your translations offline (as above) and upload them to AMOS.
# Click 'Stage' in the Navigation block.
# Choose 'Import translated strings from file'.
# Dag and drop the file.
# Click the 'Import' button.
*Note: You can import several files at once if you zip them first and upload the zip file. The zip file is not allowed to contain any folders, only files.
==See also==
* [[AMOS manual]] for further information about the AMOS translation toolkit
* [[:en:Language packs|Language packs]] user documentation

Moodle XML format

2024-03-20T15:51:23Z

Koen: /* See also */ redirects to the same page

{{Export questions}}
The XML Format is a Moodle-specific format for importing and exporting questions to be used with the [[Quiz module]]. The format has been developed within the Moodle Community but other software may support it to a greater or lesser degree.
==A word about validity (and CDATA)==
The XML parser assumes that the XML file is well formed and does not detect or report errors. If it is not you are very likely to get unexpected errors. If you are hand-coding the XML file it is strongly recommended that you pass it through some sort of XML verifier before importing into Moodle. A simple way to do this is to open the XML file using Firefox or Internet Explorer.

Note particularly that embedded HTML fragments should be within [https://en.wikipedia.org/wiki/CDATA CDATA sections]. CDATA example:

<code xml>
<questiontext format="html">
<text><![CDATA[
Now I can include <strong>any</strong> HTML that I<br />
wish. Without the CDATA, the <i>HTML</i> tags would break
the XML!!
]]>
</text>
</questiontext>
</code>
==Overall structure of XML file==
The file is enclosed by tags as follows. It is '''important''' to make sure the xml tag only is really the first line of the file. A blank first line, or additional tags on the first line will confuse the Moodle XML parser.

<code xml>
<?xml version="1.0" ?>
<quiz>
.
.
.
</quiz>
</code>

Within the <quiz> tags are any number of <question> tags. One of these <question> tags can be a dummy question with a ''category'' type to specify a category for the import/export.

<code xml>
<question type="category">
<category>
<text>$course$/XXXX</text>
</category>
</question>
</code>

Where XXXX is the new category name. If the category exists, the question(s) will be added to the existing course; otherwise a new category will be created. This only works if you have "Get category from file" checked.

Multiple categories can be specified in the same file. Just add another dummy 'category' question each time you would like to establish a new category and the questions that follow it will be placed there.

The file must be encoded in [[UTF8]]

Moodle XML import and export are balanced in functionality, so if you need to understand the format you can simply create some questions and export them to see what it looks like.
==Tags common to all question types==
A question is written as follows.

<code xml>
<question type="multichoice|truefalse|shortanswer|matching|cloze|essay|numerical|description">
<name>
<text>Name of question</text>
</name>
<questiontext format="html">
<text>What is the answer to this question?</text>
</questiontext>
.
.
.
</question>
</code>

Each question requires a <name> tag and <question-text> tag for the XML file to import into Moodle properly.

"Format" selects the [[Formatting options]] for the question text. The options are '''html''' (the default), '''moodle_auto_format''', '''plain_text''' and '''markdown'''. The choice effects the way in which the text will be displayed.

Further tags, which usually include at least one <answer> tag, follow in the space marked with dots as child nodes to the <question> tag. The response-related tags are listed further down on this page. Various (optional?) tags are possible.
* tags (non-hierarchical keywords)
* penalty
* generalfeedback
* defaultgrade
* hidden
Even though question tags (non-hierarchical keywords) are not fully supported in the question engine, they can be imported and exported via XML.

<code xml>
<question ...>
...
<tags>
<tag>
<text>keyword1</text>
</tag>
<tag>
<text>keyword2</text>
</tag>
...
</tags>
...
</question>
</code>

The <image> tag contains the url of any included image. Nested within the <image> tag may be an <image_base64> tag which contains the actual image data encoded in base64 [http://www.php.net/manual/en/function.base64-encode.php].
{{Note|If you export questions from a Moodle 1.9 server, the exported file might contain only the relative URL to the image hosted in the 1.9 server, while exported questions from Moodle 2.x and 3.x servers might contain the actual image encoded in base 64. This explains why some question bank import-export operations include all the images and some others don't.}}
'''In the following question type examples the common parts of the question are not shown to improve clarity. It's a good idea to export some examples yourself to see a full example.'''
==Multiple choice==
MC questions have one <answer> tag for each choice. Each choice can carry feedback and score weighting (by using the fraction attribute). In addition, an MC question has the following tags:
* single ''(values: true/false)''
* shuffleanswers ''(values: 1/0)''
* correctfeedback
* partiallycorrectfeedback
* incorrectfeedback
* answernumbering (allowed values: 'none', 'abc', 'ABCD' or '123')
The <single> tag is used to distinguish single response (radio button) and multiple response (checkbox) variants.

<code xml>
<question type="multichoice">
<answer fraction="100">
<text>The correct answer</text>
<feedback><text>Correct!</text></feedback>
</answer>
<answer fraction="0">
<text>A distractor</text>
<feedback><text>Ooops!</text></feedback>
</answer>
<answer fraction="0">
<text>Another distractor</text>
<feedback><text>Ooops!</text></feedback>
</answer>
<shuffleanswers>1</shuffleanswers>
<single>true</single>
<answernumbering>abc</answernumbering>
</question>
</code>
== True/false ==
Two answer tags are given, one which is true, and one which is false. The fraction attribute of the answer tag identifies which option is correct (100) and which is false (0). Feedback is supported. The following example shows the format when true is the correct answer and false is wrong.

<code xml>
<question type="truefalse">
<answer fraction="100">
<text>true</text>
<feedback><text>Correct!</text></feedback>
</answer>
<answer fraction="0">
<text>false</text>
<feedback><text>Ooops!</text></feedback>
</answer>
</question>
</code>
== Short answer ==
The short answer question type supports alternative correct responses, each with its own weighting and feedback. The Moodle XML format uses one <answer> tag for each of the alternative correct answers.

The <usecase> tag toggles case-sensitivity with the values 1/0.

<code xml>
<question type="shortanswer">
<answer fraction="100">
<text>The correct answer</text>
<feedback><text>Correct!</text></feedback>
</answer>

<question type="shortanswer">
<answer fraction="100">
<text>The correct answer</text>
<feedback><text>Correct!</text></feedback>
</answer>
<answer fraction="100">
<text>An alternative answer</text>
<feedback><text>Correct!</text></feedback>
</answer>

</question>
</code>
== Numerical response ==
The following is a simplified version of the Moodle XML format for numerical responses.

<code xml>
<question type="numerical">
<answer fraction="100">
<text>23</text>
<feedback><text>Feedback</text></feedback>
</answer>
</question>
</code>

Moodle also supports a <tolerance> tag (how accurate must the number be?) and one or more <unit> tags. Unit tags have names and multipliers. E.g. if the main answer is in kilometres, an additional answer could be the equivalent in metres with a multiplier of 1000.

'''Note:''' prior to 1.7.2 the fraction was expressed as a value between 0 and 1 in a <fraction> element and the answer value was '''not''' enclosed in <text> tags. This format of the numerical question type is deprecated but will still be correctly imported if found (for now).
== Matching ==
Pair matching responses use the <shuffleanswers> tag to determine whether the order of the items should be randomized.
Each pair is contained inside a <subquestion> tag. The first item of each pair is contained with a <text> tag, while the second has an <answer> tag around it as well. Feedback and score weighting is not supported by Moodle for this response type.

<code xml>
<question type="matching">
<subquestion>
<text>This is the 1st item in the 1st pair.</text>
<answer>
<text>This is the 2nd item in the 1st pair.</text>
</answer>
</subquestion>
<subquestion>
<text>This is the 1st item in the 2nd pair.</text>
<answer>
<text>This is the 2nd item in the 2nd pair.</text>
</answer>
</subquestion>
<shuffleanswers>true</shuffleanswers>
</question>
</code>
== Essay ==
An example of the essay type question...

<code xml>
<question type="essay">
<answer fraction="0">
<text></text>
</answer>
</question>
</code>

There isn't an answer and there isn't a grade in this case.

'''Note:''' prior to 1.7.2 the fraction was expressed as a value between 0 and 1 in a <fraction> element and the answer value was '''not''' enclosed in <text> tags. This format of the essay question type is deprecated but will still be correctly imported if found (for now).
== Other question types ==
=== Cloze ===
It is supported, and depends on a special format for the <questiontext> tag.
=== Description response type===
This response type has no further tags other than those contained in the question header (such as <questiontext>).
=== Random matching ===
Moodle has a question type which consists of taking short answer questions in the same quiz and displaying them as a pair matching exercise. However Moodle is neither able to export nor import this question type.
==Text formats==
Moodle XML files should explicitly specify the text format ('''html''', '''moodle_auto_format''', '''plain_text''' and '''markdown''' - these correspond to the constants, FORMAT_HTML, FORMAT_MOODLE, etc. used in the Moodle code) for each piece of content. Note that, by default, the format should be specified on the parent of the <text> element. This is slightly odd, but a remnant of history.

If the format is not specified for the questiontext, then '''html''' is the default. If the format is not specified on any other part of the question, then the format of the questiontext is the default.

(This default changed around November 2011. Before that, the default was '''moodle_auto_format''' whenever the format was not specified.)
==Useful utilities==
*[https://moodle.org/plugins/qformat_crossxml Cross XML format] This input format plugin is a handy utility that converts question from one question type to another.
*[http://vletools.com Online Moodle XML converter] Convert from existing text files glossaries and quizzes to Moodle XML format. Also can convert from Moodle XMl to text.
*[https://moodle.org/mod/forum/discuss.php?d=398452 R script for converting spreadsheet quiz questions into Moodle XML] - This is an R script to turn a spreadsheet with quiz questions into a Moodle XML file. I included an example spreadsheet. I wrote up a quick start guide, but I can only upload two files. Feel free to modify for personal use. If you make useful modifications, please share them with me. I have only written support for multichoice (single correct answer), shortanswer, or truefalse question types. I have only tested this with Moodle 3.7
*[http://www.R-exams.org/ R/exams] is a one-for-all exams generator that can export Moodle XML (among various other output formats) from potentially dynamic exercises written in R/Markdown or R/LaTeX. A brief tutorial for Moodle is available at: [http://www.R-exams.org/tutorials/elearning/ E-Learning Quizzes with R/exams for Moodle and OpenOLAT].
*[https://digitaliser.getmarked.ai/ getmarked] is a quiz export tool that can be used to move quizzes from Google Forms to Moodle. According to [https://moodle.org/mod/forum/discuss.php?d=436849#p1758035If this post] "To move your Google Form quiz into Moodle, give getmarked permission to access your forms through OAuth, then you export it as a Moodle XML. If you want to move your Moodle question bank to Google Form, simply do the reverse by exporting your Moodle questions as Moodle XML, upload to getmarked and they can generate a Google Form from it.In addition, they can also import and export to QTI, Zoom, kahoot , quizizz and many other platforms too, it's really amazing!"
== See also ==
*[[Aiken format]]
*[[Import and export FAQ]]
* [[User:Frank Ralf/Moodle XML1]] (work in progress)
[[https://docs.moodle.org/ja/Moodle XMLフォーマット]]
[[https://docs.moodle.org/de/ Moodle XML-Format]]
[[https://docs.moodle.org/fr/Format XML Moodle]]
[[https://docs.moodle.org/es/Formato Moodle XML]]

Translation langconfig

2023-11-02T18:01:18Z

Koen: /* localecldr,core_lanconfig */ adding a practical test for determing the correct cldr

{{Translation}}
Langconfig is an important file in a language pack, dealing with all the configuration parameters of that language. It is good practice to review this first when starting of a new language pack or when taking on responsibility of an existing language pack. You can edit it by going to lang.moodle.org and find it as the core_langconfig component for your language.

On this page you find a little documentation for each setting to help you deciding what should go there for your language.

===alphabet,core_langconfig===
The alphabet in your language. Used e.g. for the list of letters on the participants page.
===am,core_langconfig===
The way to indicate morning in your language. This is used on servers that only support 24 hour time for your language. (see https://tracker.moodle.org/browse/MDL-74379).
===amcaps,core_langconfig===
The way to indicate morning in capitals.
===backupnameformat,core_langconfig===
===decsep,core_langconfig===
How decimals are separated in your language. [https://en.wikipedia.org/wiki/Decimal_separator Usually a dot or a comma]. Take note that some countries which seem to share the same language may have a different character to separate the integer part from the fractional part of a number written in decimal form. e.g. Central American Spanish-speaking countries use the decimal point, while South American Spanish-speaking countries use the decimal comma. More info on the [[Decimal separator]] page.

Example:
* English: 36.5
* Dutch: 36,5
===firstdayofweek,core_langconfig===
The first day of the week in your language. Allowed values are 0,1,2,3,4,5,6, where 0 stands for Sunday.
===iso6391,core_langconfig===
The ISO 639.1 value for your language. You can find this value easily on [https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes Wikipedia].
===iso6392,core_langconfig===
The ISO 639.2 value for your language. You can find this value easily on [https://en.wikipedia.org/wiki/List_of_ISO_639-2_codes Wikipedia].
===labelsep,core_langconfig===
How a label is separated from a form. Could be a colon, a space and a colon or something different, according to what's generally used in your language. This character is not read by screen readers for accessibility reasons.
===listsep,core_langconfig===
The symbol usually used in your language, for separating items in a list. This is used e.g. when using formulas with multiple items in the gradebook. This must be a symbol different from the decsep symbol.
===locale,core_langconfig===
locale for *nix servers.

If your Moodle calendar is not translated, then this string is wrong (or your server is not configured to support the language)
{{Note|Locales, used in language packs should come only from the table of locales at [[Table_of_locales]] and the list at [[List_of_locales_supported_on_Moodle_community_servers]]}}
An unsupported locale in a Mac or Linux site will produce the following error when you try to update your language pack:

[[File:Unsupported locale mac.png|400px|link=Special:FilePath/Unsupported_locale_mac.png]]

And, more important, it may produce an intermitent 'undefined' error message:

[[File:ERROR undefined.png|400px]]
===localecldr,core_lanconfig===
See http://cldr.unicode.org/index/cldr-spec/picking-the-right-language-code

A practical test can be found on https://util.unicode.org/UnicodeJsps/languageid.jsp
===localewin,core_langconfig===
locale for Windows servers.

If your Moodle calendar is not translated, then this string 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
===localewincharset,core_langconfig===
The character set to use when Moodle is installed on a Windows server
===oldcharset,core_langconfig===
Necessary to upgrade from prior to 1.6. This string defines the charset used in 1.5 and earlier for this language pack. For language packs that start later then Moodle 1.5, this can be left empty
===parentlanguage,core_langconfig===
The original Moodle default Australian language pack has this field empty (as the Australian English language IS the official Moodle language).

If your language pack relies on another one (it is a 'child' language of a 'parent' language), then this is the place to point out which language pack. '''For most language packs, this should be left empty''', to default to English if strings are missing.

Example: Canadian French (fr_ca) is mostly the same as French (fr) apart from a few changes. Creating a language pack with as parent language French will shop French if a string does not exist in the language pack Canadian French. If a string doesn't exist in both language packs, English is shown.

On the download page for the language packs (https://download.moodle.org/langpack/3.7/) you can see how many strings are different from the parent language pack. In Moodle 3.7, Canadian French had 998 changes from French.
{{Note|Using language customization for parentlanguage inside langconfig.php in an existing Moodle server, where you add a parent language (while the AMOS parentlanguage string is actually empty) will ask for the installation of said parent language in the server, but will not substitute the missing translations in the child language with those of the parent language; English will be shown. Surgically editing (a dangerous, never recommended procedure) the langconfig.php file of the server would work, until the next language pack update -manual or cron made- erases the change.}}
===pm,core_langconfig===
The way to indicate afternoon in your language. This is used on servers that only support 24 hour time for your language. (see https://tracker.moodle.org/browse/MDL-74379).
===pmcaps,core_langconfig===
The way to indicate afternoon in capitals.
===questioniconfollowlangdirection===
*The setting to specify whether the question icon follows the language direction (or not.)
*Set it to 'yes' for RTL languages such as Arabic where the question mark is flipped.
*Set it to 'no' for Hebrew where the question mark is not flipped.
Note: Since this is a setting, as with all settings, it must be in English, either 'yes' or 'no', even in languages other than English.
===strftimedate,core_langconfig===
How time and date are displayed in Moodle. Usually it is fine to check the order of the English one and use the same symbols. If that doesn't serve your needs, the complete reference for what is possible can be found on http://www.w3schools.com/php/func_date_strftime.asp
===strftimedatefullshort,core_langconfig===
How time and date are displayed in Moodle. Usually it is fine to check the order of the English one and use the same symbols. If that doesn't serve your needs, the complete reference for what is possible can be found on http://www.w3schools.com/php/func_date_strftime.asp
===strftimedateshort,core_langconfig===
How time and date are displayed in Moodle. Usually it is fine to check the order of the English one and use the same symbols. If that doesn't serve your needs, the complete reference for what is possible can be found on http://www.w3schools.com/php/func_date_strftime.asp
===strftimedatetime,core_langconfig===
How time and date are displayed in Moodle. Usually it is fine to check the order of the English one and use the same symbols. If that doesn't serve your needs, the complete reference for what is possible can be found on http://www.w3schools.com/php/func_date_strftime.asp
===strftimedatetimeshort,core_langconfig===
How time and date are displayed in Moodle. Usually it is fine to check the order of the English one and use the same symbols. If that doesn't serve your needs, the complete reference for what is possible can be found on http://www.w3schools.com/php/func_date_strftime.asp
===strftimedaydate,core_langconfig===
How time and date are displayed in Moodle. Usually it is fine to check the order of the English one and use the same symbols. If that doesn't serve your needs, the complete reference for what is possible can be found on http://www.w3schools.com/php/func_date_strftime.asp
===strftimedaydatetime,core_langconfig===
How time and date are displayed in Moodle. Usually it is fine to check the order of the English one and use the same symbols. If that doesn't serve your needs, the complete reference for what is possible can be found on http://www.w3schools.com/php/func_date_strftime.asp
===strftimedayshort,core_langconfig===
How time and day are displayed in short in Moodle. Usually it is fine to check the order of the English one and use the same symbols. If that doesn't serve your needs, the complete reference for what is possible can be found on http://www.w3schools.com/php/func_date_strftime.asp
===strftimedaytime,core_langconfig===
How time and day are displayed in Moodle. Usually it is fine to check the order of the English one and use the same symbols. If that doesn't serve your needs, the complete reference for what is possible can be found on http://www.w3schools.com/php/func_date_strftime.asp
===strftimemonthyear,core_langconfig===
How month and year are displayed in Moodle. Usually it is fine to check the order of the English one and use the same symbols. If that doesn't serve your needs, the complete reference for what is possible can be found on http://www.w3schools.com/php/func_date_strftime.asp
===strftimerecent,core_langconfig===
How time and date are displayed in Moodle. Usually it is fine to check the order of the English one and use the same symbols. If that doesn't serve your needs, the complete reference for what is possible can be found on http://www.w3schools.com/php/func_date_strftime.asp
===strftimerecentfull,core_langconfig===
How time and date are displayed for recent activities in Moodle. Usually it is fine to check the order of the English one and use the same symbols. If that doesn't serve your needs, the complete reference for what is possible can be found on http://www.w3schools.com/php/func_date_strftime.asp
===strftimetime,core_langconfig===
How time is displayed in Moodle. Usually it is fine to check the order of the English one and use the same symbols. If that doesn't serve your needs, the complete reference for what is possible can be found on http://www.w3schools.com/php/func_date_strftime.asp
===thisdirection,core_langconfig===
In which direction your language should be displayed on the screen. The only possible options are ltr (left to right) or rtl (right to left).'''Do not attempt to translate these''', or [https://moodle.org/mod/forum/discuss.php?d=328567#p1323101 you will wreak havoc on many themes].
===thisdirectionvertical,core_langconfig===
How text that is printed vertical on the screen is oriënted (like in a docked block).

The only possible values can be btt (bottom to top) or ttb (top to bottom). '''Do not attempt to translate these''', or [https://moodle.org/mod/forum/discuss.php?d=328567#p1323101 you will wreak havoc on many themes].
===thislanguage,core_langconfig===
The name of your language in your own language
===thislanguageint,core_langconfig===
The name of your language in English
===thousandssep,core_langconfig===
How you separate thousands in your language.
Important: this can not be a space (more information in discussion http://lang.moodle.org/mod/forum/discuss.php?d=1450#p1730). If you want a space, you can try with &nbsp; but that is not fully tested yet.

Example:
* in Dutch 1.000.000 (with a dot)
* in English 1,000,000 (with a comma)

[[Category:Language]]
[[https://docs.moodle.org/es/Langconfig]]

Plagiarism Prevention Using Compilatio

2023-08-29T10:25:13Z

Koen: /* Creating a Moodle Activity */ do not refer to specific documentation version

{{Plagiarism prevention}}
The Compilatio Plagiarism Plugin for Moodle 2 currently supports the old Assignment module in Moodle 2.0/2.1/2.2 and the new assignment module in Moodle 2.3

==Creating a Moodle Activity==
#Turn editing on inside your course: https://docs.moodle.org/en/Turn_editing_on
#in the drop lists provided select the activity module you wish to add(in Moodle 2.3 Compilatio only currently works with the assignment types)
# Configure Compilatio settings for this activity

[[File:CompilatioAssignmentSettings.png]]

==Viewing the Compilatio generated reports==
After a student has uploaded a file to Moodle, the file is passed to Compilatio behind the scenes and
it can take some time before a report is available.
# click on the link to view submitted assignments [[File:ViewSubmittedAssignments.png]]
# on the submissions page all the students are listed – beside each file is the response from Compilatio

[[File:CompilatioSubmissions.png]]

error/moodle/filereferenceproblem

2023-08-29T09:07:30Z

Koen: Created page with "Possible use of a filename containing ; or } See https://tracker.moodle.org/browse/MDL-79017 for workaround"

Possible use of a filename containing ; or }

See https://tracker.moodle.org/browse/MDL-79017 for workaround

error/moodle/dmlwriteexception

2023-08-23T12:21:17Z

Koen: /* MySQL */another cause for this: max_binlog_cache_size

This indicates that a general error occurred when Moodle tried to write to the database. If you turn on [[Debugging]] you will get more detailed information about what the problem is.
==dmlwriteexception error when trying to save page that has content in texteditor==
The most common reason for Moodle users to having this error is when copy-pasting materials from outern source e.g. MS Word or webpages. If the source material contains formattings the source code may not entirely get copied and when pasting the material the source code has open tags or other formatting. The result is broken code that leads to dmlwriteexception. You can paste the material with paste special option or clear formatting (or simply just copy-paste the text to text-editor and then copy-paste the text to Moodle).
==MySQL==
If you're using a MySQL database for your Moodle installation, this error can be caused by the server's <code>max_allowed_packet</code> size being configured incorrectly. [https://moodle.org/mod/forum/discuss.php?d=230681#p1001751 Increasing this value may resolve the issue.]

Another reason on MySQL can be that the <code>max_binlog_cache_size</code> is too small. [https://dev.mysql.com/doc/refman/8.0/en/replication-options-binary-log.html#sysvar_max_binlog_cache_size This can be increased up to 4GB max on MySQL 8].
==dmlwriteexception error when restoring a course==
If you obtain a dmlwriteexception error when restoring a course, it is recommended that InnoDB tables are converted to the Barracuda file format. See the section 'Converting InnoDB tables to Barracuda' in [[Administration via command line]] for details of why this is recommended plus information on a tool for converting tables.
==dmlwriteexeption error when importing quiz questions==
Make sure the uploaded file is UTF-8 without BOM
==See also==
* [[Development:DML exceptions]]
[[Category:Error|Dmlwriteexception]]
[[es:error/moodle/dmlwriteexception]]
[[fr:error/moodle/dmlwriteexception]]

Talk:Translation langconfig

2023-08-23T06:24:13Z

Koen:

Question:
In questioniconfollowlangdirection

*The setting to specify whether the question icon follows the language direction (or not.)
*Set it to 'yes' for RTL languages such as Arabic where the question mark is flipped.

In non-English languages the 'yes' should be the English string 'yes' or the translated string for 'yes' ? [[User:German Valero|German Valero]] ([[User talk:German Valero|talk]])

Since it is a setting, it should remain in English. --[[User:koen roggemans|koen roggemans]] ([[User talk:koen roggemans|talk]]) 06:24, 23 August 2023 (UTC)

Quiz FAQ

2023-03-20T13:58:02Z

Koen: /* Can I edit questions after a quiz is started or submitted */ Procedure for Moodle 4+

{{Quiz}}
==General==
===How can guests answer a Moodle quiz?===

It is not possible for guests to use [[Activities|activities]] in Moodle.

But you can build a quiz on Google Forms and give a link from within Moodle.

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

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

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

Method 2:

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

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

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

See [[Quiz submission notification]].

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

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

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

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

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

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

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

=== How can I print all the students' quiz questions and answers?===
*Two options are available:
** Install the [https://moodle.org/plugins/quiz_archive quiz archive report] additional plugin - Moodle quiz report plugin to achieve archiving your test, by printing out all attempts at once.
** Install the [https://moodle.org/plugins/quiz_answersheets Export quiz attempts] additional plugin - This quiz report allows you to get view of a quiz attempt that is formatted for easy printing.
=== How can I optimize a Moodle server for performing more concurrent quizzes? ===

See [[Performance recommendations]], also the forum discussion [https://moodle.org/mod/forum/discuss.php?d=418615 Quiz with 400+ concurrent users: what‘s best?]

=== Can I release the answers to students who did not attempt a quiz? ===
Yes. One way to handle this with standard Moodle would be to open the quiz after the deadline and add a time limit to the quiz of one second. Unless students are extremely quick they will not be able to gain any points, but would see the general feedback.

=== How can I make Moodle quizzes if my school does not have enough computers / fast internet / a good Moodle server? ===
* Check the [[Offline quiz activity]] additional plugin.
* Check the [https://moodle.org/plugins/mod_exam exam] additional plugin. It allows the teacher to build quizzes with multiple choice question based on Quiz module. Main purpose of Exam module is to improve performance of quiz and to reduce database overhead, so that a large number of users can attempt quiz simultaneously. Warning - Technically it is possible for students to manipulate their exam grades if they know right parameters or they could see correct answers if they could read javascript objets being transmitted in their browser. Use with Caution.
* Read about the use of Chromebooks and iPad in the [[https://docs.moodle.org/38/en/Safe_Exam_Browser | Safe Exam Browser]] Moodle documentation for version until 3.8.
* Visit the page for [https://www.eventbrite.com.au/o/transforming-exams-e-exams-symposium-17431618115 Transforming Exams] - Transforming Exams is an Australian Government funded research project looking at approaches to conducting authentic digital assessment in the exam rooms of Australian universities via the use of Bring-your-own laptops. The project involves 10 Australian university partners and is lead out of Monash University. See [http://transformingexams.com/ TransformingExams.com] for project information.

===Can I print the quiz results without the answers history?===
If you want to print the results of all the student attempts, but omit the answers history, as it might take much space, you can do so by accessing the settings on Site admin -> Appearance -> Additional HTML. In the 'Within head' setting, put something like:

<style type="text/css">
@media print {
.que .history {
display: none;
}
}
</style>

===Is it possible for a teacher to add a personal/private note to a student's quiz submission?===
Not really, but as a workaround, you can use the buit-in [[Notes]] feature.

===Copying a quiz===
When you add questions to a quiz, you are not actually adding questions, but rather links or pointers to questions in the question bank. When you copy a quiz, two things can happen depending on where the questions are placed:

* If the questions are placed in a question category of the quiz, for example the "Default category for questions shared in the quiz context", the quiz is copied as well as the question category together with the questions it contains. See [[https://docs.moodle.org/404/en/Question_contexts#How_to_access_the_Quiz_activity_context How to access the Quiz activity context]].
* If the questions are not placed in a question category of the quiz, the quiz is copied but not the questions. However, the links to the original questions are copied. Therefore, when editing the quiz copy, you are also editing the questions of the original quiz, because the question links point to the same questions. Be careful!

=== Can I know the marks per each section of a quiz?===
An additional plugin [https://moodle.org/plugins/quiz_markspersection Marks per section] does exactly that.

==Setup==

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

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

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

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

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

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

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

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

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

===Can I make a second quiz start right away after a first quiz is finished?===
By using a hack (See [https://moodle.org/mod/forum/discuss.php?d=377382 this forum thread]).

In the 'Overall feedback' for the first quiz, add some code which redirects to the second quiz. Make a big button to make that obvious:

<nowiki><div style="text-align:center;padding:20px;">
<a href="https://--your domain--/mod/quiz/view.php?id=--quiz 2 no--" target="_blank">
<button type="button" style="height:100px;font-size:24px;">Click here to access Quiz 2</button>
</a>
</div></nowiki>

It would look like this:

[[File:Click here to access Quiz 2.png|200px]]

Notes:

* The button will not appear in the gradebook.
* In the quiz settings and under Review options, select 'Overall feedback' under 'Immediately after the attempt'. Deselect 'Overall feedback' under 'Later, while the quiz is still open' and 'After the quiz is closed'.

===Prevent entry to a quiz some time after its start===
Suppose a quiz is set to open at 13:00 and the time limit is set to 45 minutes or some other value. Students have to enter the quiz from 13:00 to 13:15, otherwise they should not be able to do so. Proceed as follows to prevent students from entering the quiz after 13:15.

Create another quiz, let's call it an 'entry' quiz, containing a simple multiple choice, true or false, or short answer question, such as "Do you want to take the quiz? Y or N" or any other similar question. Tell students that they must answer and "Submit all and finish" in order to access the main quiz. In the settings of this entry quiz, set "Open the quiz" to 13:00 and "Close the quiz" to 13:15, that is, it is only open for the first 15 minutes.

In the main quiz settings and under "Restrict access", add a "Grade" restriction and select the entry quiz. If you do not specify a grade, the restriction is satisfied regardless of the grade obtained in the entry quiz.

You can also add "Date" restrictions to both the entry quiz and the main quiz to control their display.

Thus, punctual students will have access to the entry quiz from 13:00 to 13:15 and therefore to the main quiz throughout its 45 minutes duration. Latecomers will not have access to the entry quiz after 13:15 and therefore they will not be able to access the main quiz at all.

==Attempts==

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

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

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

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

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

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

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

This is difficult to implement for technical reasons.

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

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

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

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

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

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

There are other CSS solutions.

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

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

=== Can I force a user to reattempt only incorrect questions in subsequent attempts?===

The easiest way to implement this solution is to use javascript or modify the source code on your Moodle site. The javascript solution described in [https://moodle.org/mod/forum/discuss.php?d=395125 this forum thread] is as follows:

* Insert the following code in the HTML of the text of a description question.
* Include this description question in the quizzes. If the quizzes are displayed on multiple pages, add the description question on each page.
* If you are using the [[Adaptable theme]] you can put the JS in the JS section of the [[Adaptable theme]]. With the standard [[Boost theme]] or [[Classic theme]] place the script in the Site Administration / Appearance / Additional HTML section. This way you don't have to include the script in every quiz.

<nowiki><h3>Title of the quiz</h3> // optional
<p>Give some info.</p> // optional

<script src="https://ajax.googleapis.com/ajax/libs/jquery/3.4.1/jquery.min.js"></script>
<script>
$(document).ready(function() {
// Clear sessionStorage after a certain delay
if (sessionStorage.getItem("setTime") != "set") {
nd = new Date();
lastTime = nd.getTime().toString();
sessionStorage.setItem("time", lastTime);
sessionStorage.setItem("setTime", "set");
}
// Set the delay to say 5 minutes: aferXmin = 5
// (Use 0.33 minutes, i.e. 20 sec, for demonstration purposes)
afterXmin = 5;
maxDelay = afterXmin * 60 * 1000;
d = new Date();
newTime = d.getTime()
lastTime = sessionStorage.getItem("time")
delay = newTime - lastTime;
if (delay > maxDelay) {
sessionStorage.clear();
}
// Show or hide correct or incorrect questions in the previous attempt:
i = 0;
$(".que").each(function() {
i++;
var x = i.toString();
if ($(this).hasClass("correct")) {
sessionStorage.setItem(x, "correct");
}
if ($(this).hasClass("incorrect")) {
sessionStorage.setItem(x, "incorrect");
}
if ($(this).hasClass("answersaved") && sessionStorage.getItem(x) == "correct") {
$(this).hide();
}
if ($(this).hasClass("answersaved") && sessionStorage.getItem(x) == "incorrect") {
$(this).show();
}
});
});
</script></nowiki>

===Prevent students from taking the quiz some time after its opening time===

Suppose a quiz opens at 14:00 on April 12, 2022. You don't want students to be able to start it after 14:10. Here is one way to do it. Note that the solution below is a workaround until a custom quiz access rule plugin is developed.

*Create a [[Label|label]] just above the quiz.
*In the label settings and in the "Label text", insert a message such as "Click the [Mark as done] button below to access the quiz:"
*Under "[[Restrict access]]", add a "Date" restriction "until 12 April 2022 14 10" as shown below.
*Under "[[Activity completion]]", set "Completion tracking" to "Students can manually mark the activity as completed" as shown below.

<div style="border:6px solid #eee;">[[{{ns:file}}:MoodleDocs_20210412_1528.png|850px]]</div>

*In the quiz settings and under "[[Restrict access]]", set an "[[Activity completion]]" to "Click the [Mark as done] button below to access th... must be marked complete" as shown below.

<div style="border:6px solid #eee;">[[{{ns:file}}:MoodleDocs_20210412_1536.png|800px]]</div>

Between 14:00 and 14:10, students will see the following.
*If they do not click the [Mark as done] button, the quiz is not visible nor accessible:
<div style="border:6px solid #eee;">[[{{ns:file}}:MoodleDocs_20210412_1554.png|750px]]</div>

*If they click the [Mark as done] button, the quiz is visible and accessible:
<div style="border:6px solid #eee;">[[{{ns:file}}:MoodleDocs_20210412_1556.png|750px]]</div>

After 2:10 pm, the "Click the [Mark as done] button below to access th..." label is no longer visible. So for students who have not clicked the [Mark as done] button, the quiz is no longer visible nor accessible. For students who clicked the [Mark as done] button, the quiz is accessible and remains accessible even if they temporarily quit and return to the quiz.

You could add another [[Label|label]] with the text "It is past 2:10 PM so you missed the opening of the quiz. It is no longer available.", with "Date" and "[[Activity completion]]" restrictions set in such a way that this label is displayed after 2:10 pm and only to students who have not clicked the [Mark as done] button.

==Grades==

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

Go to the editing quiz page and check that you have a maximum grade that is more than 0 - if your score is 0, then the quiz will not appear in the gradebook.

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

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

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

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

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

===How can I have a quiz that is not graded?===

On the Edit quiz page, change the total score and each question's score to 0 instead of the defaults of 10 and 1 per question:
[[File:quizscore0.png|600px]]

===Can I edit questions after a quiz is started or submitted?===
There are a number of cases when you want to do that: you notice a typo or a missing image in a question while the quiz is running, you notice an error in the grading of a question after students have finished the test.
In both cases make sure your quiz is set to use the latest version of the problem question, improve and save the question. Then click on the "Regrade all" button in the quiz grading screen. The behaviour in Moodle 4+ quiz is that questions set to use the latest version, will be reloaded in the quiz by pressing the regrade button to use your latest changes. Running and submitted quizzes will now use the new version of the question.

==Appearance==

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

[[File:flag.png|119px]]

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

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

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

If you have a custom theme, you can add CSS like this:
<syntaxhighlight lang="css">
.que .info .grade { display: none; }
</syntaxhighlight>
or you could try to make it more specific, and only hide the grade before the question is answered:
<syntaxhighlight lang="css">
.que.answersaved .info .grade,
.que.invalidanswer .info .grade,
.que.notyetanswered .info .grade { display: none; }
</syntaxhighlight>
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.
<syntaxhighlight lang="php">
$options->marks = self::extract($quiz->reviewmarks, $when,
self::MARK_AND_MAX, self::HIDDEN);
</syntaxhighlight>

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

===How can I delay the quiz feedback after the quiz has passed===
* Suppose the students take a "Main" one-hour quiz from 2 April 14:00 to 2 April 15:00. They shall not have any feedback during and after the quiz until the following week.
* Students take a "Follow up" quiz a week later, starting 9 April 14:00. If they succeed the "Follow up" quiz, they can then review the "Main" quiz and get their points.

This can be done by editing the "Main" and "Follow up" quiz settings, and the Gradebook set up as follows:

[[File:MoodleDocs201904041052.png|280px|thumb|right]]
'''"Main" quiz settings''' ''See also the image on the right'' ->

Timing
Open the quiz: 2 April 14:00
Close the quiz: 9 April 14:00
Review options
During the attempt
Uncheck feedbacks
Immediately after the attempt
Uncheck feedbacks
Later, while the quiz is still open
Uncheck feedbacks
After the quiz is closed
Check feedbacks
Restrict access
Student must match any of the following
Date: until 2 April 15:00
or
Student must match all of the following (restriction set)
Date: from 9 April 14:00
and
Grade: Follow up
Check must be ≥ 1 %

'''"Follow up" quiz settings'''

Timing
Open the quiz: 9 April 14:00

'''Gradebook set up'''
Main quiz: Weight 0.0, ID number "main"
Follow up quiz: Weight 0.0, ID number "followup"
Grade item "Total": Weight 100.0, Calculation = [[main]] + [[followup]] ''(<- do not copy/paste this equation, rewrite it)''

===Is there a way to display submitted images instead of titles of Images on the review page for the quiz?===
Yes. See [https://moodle.org/mod/forum/discuss.php?d=392623#p1582739 this forum post].

==Errors==

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

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

===I'm getting the error ' There are not enough questions in the category... ' when trying to add random questions but I DO definitely have enough questions!===
Check to see if you have any questions marked as 'Draft' rather than 'Ready'. They will not be available when you want to add random questions until you set them as 'Ready'.

==Quiz plugins==

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

==See also==

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

==Any further questions?==

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

[[Category:FAQ]]

[[de:Test FAQ]]
[[es:Examen FAQ]]
[[fr:FAQ sur les tests]]

Lesson FAQ

2023-02-02T11:15:03Z

Koen: Adding to faq that reviewing a lesson after finishing is not possible

{{Lesson}}
==How can I monitor my students' / teachers' actions in a Lesson?==
One way is to use [[Event monitoring]]. There are events for viewing content pages and answering question pages (students) and creating, updating and deleting pages (teachers).
==Jumps not working in a question==
A wrong answer should go to "this page" in my lesson. But after the student answers it, the student goes to the next page.

If the maximum attempt is set to 1, then the student will be advanced to the next page after they choose a wrong answer that is sent to "this page". If it is set to 2, after the student selects the wrong answer the 2nd time they will be sent to the next page. This can be used to keep the student out of an endless loop when than can not answer a question correctly.
==Edits of answers are not saved==
I have a 4 answer multiple choice question. I can only seem to save the first two answers, their jumps and feedback. Any edits on the last answers, their jumps and feedbacks are not saved. Moodle does not tell me there is anything wrong. Same thing happened with a Content page. I can not seem to get the last two descriptions change after I save an edit. GRRRRR!
*Go back to your lesson settings. Maximum number of answers is probably set to 2; change it to 4 or the maximum number of answers or descriptions in your lesson. Now the edits can be saved.
::''Tip:'' Changing the "Maximum number" as a teacher builds a lesson is a trick used to limit scrolling passed unused answers or branch choices to get to the save button. For example, 15 pages have 4 choices but one page will have 8 choices. The teacher will use "Maximum number" at 8 setting only when they initially create that page, then switch it back to 4. They (and their students) will always see all 8 answers but the lesson setting will prevent them from editing some of them.
==Multiple Choice and Multianswer issues==
When I check the multianswer box in a multiple choice question, it does not work. It makes random jumps and does not put the teacher's response with the students choice.
*In a Lesson module [[Lesson_module#Multiple_choice|multianswer question]], all the correct choices must have the same jump and teacher response. All the wrong choices must also have the same jump and teacher response.
==Are there some examples of Lessons I can see?==
There are several examples of lessons on the School demo site http://school.moodledemo.net/ which you can access as a guest or log in to use it more interactively.
# A lesson about dyslexia: http://school.moodledemo.net/mod/lesson/view.php?id=752
# A decision making exercise on mountaineering : http://school.moodledemo.net/mod/lesson/view.php?id=432
#A lesson on understanding water shortages: http://school.moodledemo.net/mod/lesson/view.php?id=156
==The lesson was completed but it does not record it==
*Every lesson must have one question that a student must answer in order for it to show up in some reports. This can affect [[Grades]] and a Lesson's dependency setting (see other FAQs below).
::''Tip:'' There are lots of creative ways to put in a question, such as setting a multiple choice question so that all answers are correct and the answers act like a content page. Or put in content and then award 1 point for "next page" as the answer and do not include the score in grades.
::''Tip:'' Due to a specific Lesson's design, some students can complete the lesson without answering one or more questions which have been placed in the Lesson. When Lesson can not record any scores for a student, no grade is pushed to the gradebook. It may appear therefore that Lesson is being inconsistent in recording grades.
==Dependency in Lesson does not work==
The second lesson tells the student they must complete the first one. They did - what is wrong?
*For dependency to work, you need to have at least 1 question page in the lesson. The student may not need a minimum score, but Lesson needs to know that the student tried a question. You can always put a question as the first or last page, You don't need to ask a question but do put in an answer of "continue" with a jump of the next page.

*Also for dependency to work, the lesson can not be a practice lesson.
==How to add sound to a lesson page==
*[[Audio in Moodle]] has an overview and tool recommendations.
==Can I turn off the answer shuffle in a lesson?==
* In short, no. Turning off the page and answer shuffle are Quiz options, but neither is found in Lesson. A [https://moodle.org/mod/forum/discuss.php?d=99225 minor hack to the Lesson code] is possible but that would impact the entire Moodle site.
::''TIP:'' If you don't need to score students answers in a question, then consider using a Content page instead of a Multiple Choice or a True/False question.
==Can I change standard words used by Lesson?==
*Yes. You or your site administrator can edit the language file called Lesson.php. This will impact the whole site. Your site administrator might create a language just for you and then in Lesson settings use the force language option.
==Grrr something happened -lesson list is not right - I can't move things==
Try a backup and restore of your course to solve some of those "quirky" issues.
*Example: I was building a course, started adding lessons to topic 2 and then realized I should move it up to become Topic 1. Did that and continue to add lessons to topic 1, then lessons to topic 2 etc. Later I had to add lessons to topic 1. I did but could not move them between those first lessons I created. Every time I tried to move them they went to the bottom of topic 2! I also noticed that my list of just lessons, showed those first lessons as being in the correct course display order but showed they were in Topic 2!.
*Moral: Sometimes a backup and a restore will re-establish harmony and fix things.
==What happened to my HTML code on a Lesson page?==
I had the lesson page formatted just the way I wanted by using the HTML source toggle on the tool bar. I went back in to tweak my code and some of my code was missing!
*Lesson will "clean" up your HTML code every time you toggle into HTML text. This can be frustrating, especially if you are trying to get a flash file to display just right. Save you work in a text editor, so the next time you tweak it, you can paste all your code back in.
==Pages are not displayed in the lesson's left menu==
The Lesson module's left menu navigation feature, only displays content pages. If your lesson only has question pages, it will not display any pages. Use a content page before a series of question pages, so your students will know where the series starts. Alternative, use the same content page and put links to each of the question using descriptions and jumps. Remember, you can effectively have the student jump past (not view) this content page as they go through the lesson and only reach it via the left menu.
==Students are not returning to where they left the lesson==
A student has left the lesson after looking at 10 pages. The next time they return to the lesson they start at the beginning again. How can the student return to the same place?
:You have seen more than one page of this lesson already. Do you want to start at the last page you saw?
Several things must be met before this will happen. First make sure your lesson settings allow the student to retake the lesson and that this lesson is not a "practice" lesson. The important thing is that the above words are not exactly correct. They are correct only when the student left immediately after answering a question in a Lesson. For the purposes of returning to the same place, Lesson only remembers question pages as benchmarks. So lastly, make sure you have questions scattered in your Lesson for this feature to work and tell students.
:''TIPs:'' Use a content page at the start of the lesson as a table of contents, so the student are forced to remember where they are but can jump to your teaching points. Or put a question at the start or end of every "teaching point". And of course, you can tell your students how it is going to work.
==Can I change the End of Lesson page display==
Yes it is possible for the site administrator to change the text strings for all Lessons which use a specific language. For example, some sites do not want a student to see any reference to grades. By editing the correct text string, it is possible to replace "Your score is 9 (out of 10)" with "Be sure to get your certificate". Or change "Congratulations - end of lesson reached" to "We hoped this lesson helped you".
:''Tip:'' It is possible to force a language in a course in the Appearance settings. A site administrator can create a "new" language, with different text strings. This would allow different courses to have what appears to the student as different end of lesson pages. [https://moodle.org/mod/forum/discuss.php?d=220671 See this post for creating a new language based upon another.]
==Can a student review a lesson attempt after finishing it==
No, that is not possible. See https://tracker.moodle.org/browse/MDL-19948

==See also==
* Using Moodle [http://moodle.org/mod/forum/view.php?f=333 Lesson module forum]
[[Category:FAQ]]
[[de:Lektion_FAQ]]
[[es:Lección FAQ]]
[[fr:FAQ sur la leçon]]

Using Lesson

2023-02-02T10:54:09Z

Koen: /* See also */ removing dead link

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Lesson module/Lesson questions

2023-01-30T15:41:23Z

Koen: /* Multiple choice */ max number of answers

{{Work in progress}}
*Other links [[Lesson module]] or [[Lesson module/draftoutline]][[Lesson module/draft]]
Lesson questions are similar but not exactly the same as Quiz questions. For example, Lesson questions have jumps, and also some types can be scored or evaluated differently than a similar Quiz question. In Moodle 2.0, Quiz and Lesson questions will be coming closer together. On this page we will refer you to other MoodleDoc pages about Questions types when they apply to a Lesson.
==Parts of a lesson question==
Parts of a Lesson question include title, content, answer, feedback and jump. Jumps are unique to the Lesson activity and can be thought of a links tied to answers. Like a Quiz question, each answer can be evaluated and scored differently.
===Multiple choice ===
In a multiple choice question, the student is given a question and a list of answers (max 4). In a Lesson, the answer list will be shuffled every time the question is view by a student. In a multiple choice question, the student selects one answer.

Questions can use pictures. Indeed, pictures can be used as answers when the [[HTML editor]] is turned on and the page reloaded. Each answer in a multichoice question can be scored separately. It is possible to give a negative score for an answer, or partial credit for a wrong answer. The teacher can give a response based upon the answer selected by the student.
====With multianswer box checked====
A check in the multianswer box allows the teacher to determine that more than 1 answer is required for the student to receive credit for the question. There is no partial credit and the student must select just correct answers from a list.

An example of a multianswer question is:
::'''Which of the following are animals'''?
::- A dog
::- A cow
::- A rock
::- A rose
To ensure the multianswer feature works, all correct answers should be in first lines of the answer list, receive the same score (let say 1), response and jump to the same page. Then wrong answers should hve the same score (usually 0), response and all jump to the same page. In other words, you should have two groups of answers (correct answers first and then incorrect ones) with the identical scores, responses and jumps for each group.

A student who does not select all the correct answers, or includes any wrong answer will receive the "wrong answer" score, response and jump.

See also [[Multiple Choice question type]] which is a quiz question and works differently.
===Short answer===
In a short answer question the student is expected to answer with one word or a few words. [[Short-Answer question type]] gives more information about this kind of question

Starting with Moodle 1.6, there are two different ''student answer'' analysis systems available for the Short Answer type of question in the Lesson Module: the '''simple system ''' and the new '''regular expressions system'''. The simple system is the default and is the same used by the Quiz Module. There is a "Use Regular Expressions" option box on the Edit Question Page screen in the Lesson Module.

We suggest first reading about the [[Short-Answer question type|Short answer question page]] with the examples of the "simple analysis", and then read the [[Short answer analysis]] page that gives more information about "Regular Expression analysis".

[[#top|Table of Contents]]
===True / false===
The True/False question type is a special case of the multiple choice question. The student is prompted to choose which is the correct option. See [[Lesson module#Multiple choice|multiple choice question]] above for details.
===Matching questions===
[[Image:Question Matching pulldown 1.JPG||thumb|80px|right|Matching]]
Matching questions consist of a list of names or statements, or pictures which must be correctly matched against another list. For example "Match the letter with its position in the alphabet. One list would have A, B, C, D, Z and the other in a pull down menu next to each item would have 2, 4, 3, 1, 26 .

Unlike the ''Multichoice question'' where the choices are shown in a random order, the first list of items in a ''Matching question'' is not shuffled but shown in the same order as entered. The second list is scrambled.

In 1.9 there is one score, one response and one jump associated with the right answers (where all matches are correct) and one score, one response and one jump associated with a wrong match (where one or more are not matched correctly).

See [[Matching question type]] for more information.
===Numerical Question===
This type of question requires a number as the answer. In it's simplest form it requires just one answer to be specified. For example "What is 2 plus 2?", where 4 is the correct answer. A numerical question will also accept a number in a range as being correct. The answers are similar to short answer, where the order that the teacher lists the answers is important.

See [[Numerical question type]] for more information.

The lesson numerical question differs from the numerical quiz question and the numerical embedded question (Cloze), in a couple of ways when it evaluates answers. For example, there is no wild card.

[[#top|Table of Contents]]
===Essay Questions===
Short essay questions were introduced in Moodle version 1.5. These are meant for short, paragraph or two type of essays one often finds on exams. Thus we did not use the html editor, preferring a simple text field. For longer essays, the assignment module is a better choice.

The student simply enters their essay in the box provided. The teacher sees ungraded essay questions when opening the lesson. After grading, the teacher can email their responses to the student.

[[Essay question type]] page has more information.

Essay question type

2022-12-13T07:03:19Z

Koen: /* Question grading */

{{Questions}}<p class="note">'''Note''': This page is about the essay question type in the [[Quiz]] activity. For information about the essay question type in a Lesson activity, see the documentation [[Building Lesson]].</p>

==About the essay question type==

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

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

==Creating an essay question==

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

===Response options===

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

*'''New in 3.11:''' You can set a maximum and minimum word count for the Essay question. Learners will be alerted if they write too few or too many words.
[[File:EssayWordCount.png|center|400px]]

===Response template===

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

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

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

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

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

Then you can choose one question from that quiz, and grade that question for all the students.

[[File:Manual grading question4 Moodle 4.png|600px]]

[[File:Manual grading for same question Moodle 4.png|600px]]

If you choose the 'Responses' tab, you can browse all the questions from all the students.. and you might discover (in the following image) that some students have nearly identical answers, which suggests cheating...

[[File:Manual grading questioncheating Moodle 4.png|1000px]]

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

If necessary the teacher can also upload a file such as an image (or even record audio/video) in the essay grading box.

==See also==

* [https://moodle.org/mod/forum/discuss.php?d=380839 Need help with understanding manual grading] forum discussion
* [[Essay (auto-grade) question type]] - additional plugin
* The [https://h5p.org/content-types/essay Essay module] for [https://moodle.org/plugins/mod_hvp H5P] - A free HTML5-based content type that allows students to receive instant feedback to a text that they have composed. Authors can define a set of keywords that will trigger individual responses if they are found or missing in the text. Let students become creative with H5P and Essay in Moodle.

[[ca:Tipus de pregunta de resposta oberta]]
[[de:Fragetyp Freitext]]
[[es:Tipo de pregunta de ensayo]]
[[fr:Question composition]]
[[ja:作文問題タイプ]]
[[zh:申論題]]

mod/cardbox/view

2022-10-04T14:14:29Z

Koen: Created page with "More documentation on https://help.itc.rwth-aachen.de/en/service/8d9eb2f36eea4fcaa9abd0e1ca008b22/article/572e0d476dc440ff8ea288591b5b9186/"

More documentation on https://help.itc.rwth-aachen.de/en/service/8d9eb2f36eea4fcaa9abd0e1ca008b22/article/572e0d476dc440ff8ea288591b5b9186/

error/moodle/invalidcoursemodule

2022-09-05T05:45:03Z

Koen: Adding extra possibility why "course module invalid" can appear.

The ID for the course module is invalid.
Please contact the site admin.

For some unknown reason, this happens sometimes when deleting a user. Clicking the back button of the browser and deleting the user again, makes the deleting process continue and delete the user.

It can also happen when "Legacy course files" is enabled. Disabling this can solve the issue.
[[Category:Error]]
[[es:error/moodle/invalidcoursemodule]]

admin/setting/tool cohortdatabase

2022-09-01T12:02:39Z

Koen: added cli options

Documentation on https://github.com/catalyst/moodle-tool_cohortdatabase/blob/master/README.md

Command line:

php moodle/admin/tool/cohortdatabase/cli/sync.php

Options:

* -h help
* -v verbose

admin/setting/tool cohortdatabase

2022-08-30T06:26:50Z

Koen: Created page with "Documentation on https://github.com/catalyst/moodle-tool_cohortdatabase/blob/master/README.md"

Documentation on https://github.com/catalyst/moodle-tool_cohortdatabase/blob/master/README.md

User tours

2022-08-11T08:12:40Z

Koen: /* Translating user tours */ removing pointer to outdated docs

{{Site appearance}}
==About user tours==
User tours are step-by-step guides to various areas of Moodle. The [[Multi-language content filter|multi-lang filter]] allows for tours to display in different languages.
{{MediaPlayer | url = https://youtu.be/hhLVvyP3DU0 | desc = User tours}}

==How is it set up?==
* As an administrator, access 'User tours' from Site administration, Appearance.
*Here you see any existing user tours and have the option to create a new tour, import a tour or browse user tours on the [https://archive.moodle.net/mod/data/view.php?id=17 User tours repository]. (An administrator and a teacher tour have been added to new and upgraded sites to introduce the [[Boost theme]] and get you started.)
[[File:Usertours38.png|thumb|600px|center]]
*For each of your existing tours, you can click either directly on its name or on its View action icon to view its current listed steps
*Each tour can be individually enabled or disabled as required in its settings page.
*A 'Duplicate' icon allows you to copy a tour to adapt it (new in 3.8).
'''Note:''' ''You can have multiple tours created for the same page destination, but you should only have one per page enabled at one time.''
*Tours will be displayed on any page whose URL matches the specified path value, for instance:
#/my/% - to match the Dashboard
#/course/view.php% - to match all courses
#/course/view.php?id=2 - to match a specific course (e.g. the course with id=2)
#/mod/forum/view.php% - to match the forum discussion list
#/user/profile.php% - to match the user profile page
#FRONTPAGE to use the tour on your site's home page.
*Each tour will be configured with default step settings which you can edit in the settings page:
*Placement: Top, Bottom (Default), Left, Right. This determines where the step shows relative to its matching block or CSS selector on the page.
*Show if target not found: No (Default), Yes. This determines whether the step is shown or not when the target has not been found.
*Show with backdrop: No (Default), Yes. If yes, the step appears surrounded by a darkened backdrop to emphasis its content and location.
*Move on click: No (Default), Yes. If yes, the tour continues to the next step when the user clicks within the block or area targeted by the current step.
'''Note:''' ''If you want users to be able to fill in forms as they work through the tour, then don't use a backdrop.''
*Tour filters allow you to choose the role(s) and theme(s) for which the tour will be displayed.

==How do I add steps to a tour ?==
* Either click directly on its name or on its View action icon to view the currently listed steps.
*Here are the initial steps for a sample tour for the Dashboard page:
[[File:usertour steps page.png|thumb|600px|center]]
*Click on the 'New step' link and select what you want to highlight:
#Block - to display next to a matching block on the page. Select the block you want from the dropdown. (''Note you can select blocks which are not available on your chosen area. If they are later added, then the tour will display that step.)''
#CSS Selector - to display next to a matching selector on the page. Type in the relevant selector. (See examples below.)
#Display in the middle of the page
*Add the title and content
*For all types, select whether to display the step with a darkened backdrop
*For blocks or selectors, select the Placement option for where to place the display
*For blocks or selectors, select whether to display the step if its target isn't found
*For blocks or selectors, select whether to move on click, i.e. move to next step when target is clicked
*Click on 'Save changes'

==How do user tours work?==
[[File:usertours01.png|thumb|600px|center]]
Once a user tour has been created and enabled, the first time that any user views a page which matches that user tour's page (path) settings, the user tour will automatically start to display, starting with the first step. Each tour step will display its title and content, along with three button options:
*Prev - to return to the previous step in the tour
*Next - to go to the next step in the tour
*End Tour - to exit out of the tour completely
Any time a user wishes to re-run the page's tour, they can click on the "Reset user tour on this page" link at the bottom of the page.
==Filters==
Tours may be filtered to display depending on:
*Access - a user tour may be restricted according to:
**Account creation
**First access
**Last access
*Category
*Courses
*Course format
*Role
*Theme
*CSS selector - the tour will only be shown when the specified CSS selector is found on the page.

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

===Example of a very simple CSS selector===

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

The settings above will produce this in the user tour:

[[File:user picture chosen by CSS selector in a user tour.png|400px]]

* How did we know that .userpicture would select just the Moodle user picture?
* By looking at the page with an HTML inspector in Firefox, as described in the 'Help with CSS selectors' section above.

===Other simple CSS selector examples===
'''.breadcrumb''' These site links (known as breadcrumbs) will always show where you are in the site and how to return to a main page, such as your Dashboard or your course main page.

'''.usermenu''' This is the user menu. It contains links to your Dashboard, Messages, Profile, and your Preferences.

'''[value="Customise this page"]''' Add your own blocks of content by clicking here!

==Multi-language capability==

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

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

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

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

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

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

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

==Translating user tours==
User tours are translated together with the language pack. See [[Contributing_a_translation|contributing a translation]] when the default tours are not translated in your language.

==A note about user tours and keyboard focus (tab stops)==

If you test your user tour with the keyboard, you may notice that sometimes there appear to be two tab stops where there should be one. For example, if you have the HTML

<pre>
<div class="my-link">
<a href="https://moodle.org/">Example link</a>
</div>
</pre>

and use the CSS selector <tt>.my-link</tt> for your tour step, then, while the tour is visible, it will appear that there are two tab stops for the one link. This is because the target of the tour is always made into a tab stop.

The way to avoid this is to target the tour at the link itself in your tour, using <tt>.my-link a</tt>. The same thing applies in other similar situations.

==Sharing user tours==

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

A number of user tours are available from the [https://archive.moodle.net/mod/data/view.php?id=17 archive.moodle.net User tours repository]. Coming soon is Moodle.net, where you will be able to share your own user tours.

==User tour capabilities==

There is just one capability, which is allowed for the default role of manager:

* [[Capabilities/tool/usertours:managetours|Create, edit and remove user tours]]

==See also==

* [http://jsonlint.com/ JSONLint - a JSON validator] useful for checking the workings of a JSON file
* [https://moodle.org/mod/forum/discuss.php?d=357009 How to go to HTML Blocks in User Tour?] forum discussion
* [https://moodle.org/mod/forum/discuss.php?d=380950 User tours - can't get Dashboard User tours to work, using path '/my/%'] forum discussion

[[es:Tours para Usuarios]]
[[fr:Visites guidées]]
[[de:Geführte Touren]]

Starting a new language pack

2022-08-09T07:21:34Z

Koen: linking langconfig to user docs page

{{Translation}}
If Moodle is not yet translated into your language and you would like to help, please [http://lang.moodle.org/login/signup.php create an account on the Translation site] and contact our Moodle translation coordinator, Koen Roggemans, [mailto:translation@moodle.org translation@moodle.org].

Once your language pack has been set up, you can follow the instructions provided in [[Maintaining a language pack]].

First:
* '''Make sure [[Translation_langconfig|langconfig]] is properly set up'''. It would be a very good idea to ask for other translators to double-check your translation of this extremely important file by posting a request in the [https://lang.moodle.org/mod/forum/view.php?id=5 Translating Moodle forum].
* Take a look at [[Translation priority]]. All files have a rating according to how urgent they need translating.

If you have any questions about using AMOS, please post in the [http://lang.moodle.org/mod/forum/view.php?id=5 Using AMOS forum].

==Starting a child language of an existing language pack==
If your country uses a variation of an existing language, that has a few (or many) differences from an [https://docs.moodle.org/dev/Translation_langconfig#parentlanguage.2Ccore_langconfig existing parent language] (ie, Canadian French is a variation of French, or US English has some spelling differences from UK English), a child language might be a good solution, as only the strings that need changes have to be uploaded to AMOS.
Some examples of existing child languages and the changes from the parent language for Moodle 4.0 are:

* Català (Valencià) , 4416 changes from ca
*Dansk (kursus) , 22 changes from da
*Dansk Rum , 857 changes from da
*Davvisámegiella , 7235 changes from no
*Deutsch community , 246 changes from de_du
*Deutsch - Du , 1051 changes from de
*Deutsch - Kids , 273 changes from de_du
*English - Pirate , 1545 changes from en
*English for kids , 75 changes from en
*English - United States , 705 changes from en
*Español de México para niños , 140 changes from es_mx
*Español Venezuela , 157 changes from es
*Filipino , 945 changes from tl
*Finlandssvenska , 3049 changes from sv
*Français - Canada , 973 changes from fr
*Hebrew kids , 1284 changes from he
*Japanese kids , 117 changes from ja.
*Kalaallisut , 561 changes from da
*Lithuanian (university) , 13414 changes from lt
*Lulesamisk , 8 changes from no
*Norsk , 798 changes from no
*Norsk - nynorsk , 3608 changes from no
*Sørsamisk , 8 changes from no
*Suomi+ , 983 changes from fi
*Wolof , 203 changes from fr

If your local language only has a few differences from an existing language, it still qualifies as a different language for Moodle, and it can have its own language pack (if someone is willing to create and maintain it).

==Defining the language code==
For historical reasons we use the [https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes ISO-639-1] code for the representation of the language. If that doesn't exist, we use the [https://en.wikipedia.org/wiki/List_of_ISO_639-3_codes ISO639-3 code] (e.g. Moroccan Tamazight).
In some exceptional cases, like the Occitan languages, we combine the [https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes ISO 639-1] code with the [https://en.wikipedia.org/wiki/List_of_ISO_639-6_codes ISO 639-6] code, eg oc_gsc (keep in mind that the [https://en.wikipedia.org/wiki/List_of_ISO_639-6_codes ISO 639-6] standard is [http://www.iso.org/iso/catalogue_detail?csnumber=43380 withdrawn]).
Other exceptions includes the _kids addition for language packs for very young children and some other exceptions. These exceptions should be kept to a minimum.

Talk:Language settings

2022-08-05T11:06:37Z

Koen:

===Language selection priority===

This figure shows Moodle priority when selecting languages and should help you understand the relationship of the various settings for Site, Course, and User.

[[File:mdl_lang_selection_priority.png|640px|Moodle language selection priority]]

: Seems like a good scheme, making the process clear, Ralph. Thank you for that. Can you add it to the article? --[[User:koen roggemans|koen roggemans]] ([[User talk:koen roggemans|talk]]) 11:06, 5 August 2022 (UTC)

===Dead links===
Do you want something like this? https://www.shellhacks.com/linux-define-locale-language-settings/ or this https://www.tecmint.com/set-system-locales-in-linux/

Translation langconfig

2022-08-05T10:23:30Z

Koen: /* decsep,core_langconfig */ adding link to decimal separator page

{{Translation}}
Langconfig is an important file in a language pack, dealing with all the configuration parameters of that language. It is good practice to review this first when starting of a new language pack or when taking on responsibility of an existing language pack. You can edit it by going to lang.moodle.org and find it as the core_langconfig component for your language.

On this page you find a little documentation for each setting to help you deciding what should go there for your language.

===alphabet,core_langconfig===
The alphabet in your language. Used e.g. for the list of letters on the participants page.

===am,core_langconfig===
The way to indicate morning in your language. This is used on servers that only support 24 hour time for your language. (see https://tracker.moodle.org/browse/MDL-74379).

===amcaps,core_langconfig===
The way to indicate moring in capitals.

===backupnameformat,core_langconfig===

===decsep,core_langconfig===
How decimals are separated in your language. [http://en.wikipedia.org/wiki/Decimal_separator Usually a dot or a comma]. Take note that some countries which seem to share the same language may have a different character to separate the integer part from the fractional part of a number written in decimal form. e.g. Central American Spanish-speaking countries use the decimal point, while South American Spanish-speaking countries use the decimal comma. More info on the [[Decimal separator]] page.

Example:
* English: 36.5
* Dutch: 36,5

===firstdayofweek,core_langconfig===
The first day of the week in your language. Allowed values are 0,1,2,3,4,5,6, where 0 stands for Sunday.

===iso6391,core_langconfig===
The ISO 639.1 value for your language. You can find this value easily on [https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes Wikipedia].

===iso6392,core_langconfig===
The ISO 639.2 value for your language. You can find this value easily on [https://en.wikipedia.org/wiki/List_of_ISO_639-2_codes Wikipedia].

===labelsep,core_langconfig===
How a label is separated from a form. Could be a colon, a space and a colon or something different, according to what's generally used in your language. This character is not read by screen readers for accessibility reasons.

===listsep,core_langconfig===
The symbol usually used in your language, for separating items in a list. This is used e.g. when using formulas with multiple items in the gradebook. This must be a symbol different from the decsep symbol.

===locale,core_langconfig===
locale for *nix servers.

If your Moodle calendar is not translated, then this string is wrong (or your server is not configured to support the language)

{{Note|Locales, used in language packs should come only from the table of locales at https://docs.moodle.org/dev/Table_of_locales and the list at https://docs.moodle.org/dev/List_of_locales_supported_on_Moodle_community_servers}}

An unsupported locale in a Mac or Linux site will produce the following error when you try to update your language pack:

[[File:Unsupported locale mac.png|400px]]

And, more important, it may produce an intermitent 'undefined' error message:

[[File:ERROR undefined.png|400px]]

===localecldr,core_lanconfig===

See http://cldr.unicode.org/index/cldr-spec/picking-the-right-language-code

===localewin,core_langconfig===
locale for Windows servers.

If your Moodle calendar is not translated, then this string 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

===localewincharset,core_langconfig===
The character set to use when Moodle is installed on a Windows server

===oldcharset,core_langconfig===
Necessary to upgrade from prior to 1.6. This string defines the charset used in 1.5 and earlier for this language pack. For language packs that start later then Moodle 1.5, this can be left empty

===parentlanguage,core_langconfig===
The original Moodle default Australian language pack has this field empty (as the Australian English language IS the official Moodle language).

If your language pack relies on another one (it is a 'child' language of a 'parent' language), then this is the place to point out which language pack. '''For most language packs, this should be left empty''', to default to English if strings are missing.

Example: Canadian French (fr_ca) is mostly the same as French (fr) apart from a few changes. Creating a language pack with as parent language French will shop French if a string does not exist in the language pack Canadian French. If a string doesn't exist in both language packs, English is shown.

On the download page for the language packs (https://download.moodle.org/langpack/3.7/) you can see how many strings are different from the parent language pack. In Moodle 3.7, Canadian French had 998 changes from French.

{{Note|Using language customization for parentlanguage inside langconfig.php in an existing Moodle server, where you add a parent language (while the AMOS parentlanguage string is actually empty) will ask for the installation of said parent language in the server, but will not substitute the missing translations in the child language with those of the parent language; English will be shown. Surgically editing (a dangerous, never recommended procedure) the langconfig.php file of the server would work, until the next language pack update -manual or cron made- erases the change.}}

===pm,core_langconfig===
The way to indicate afternoon in your language. This is used on servers that only support 24 hour time for your language. (see https://tracker.moodle.org/browse/MDL-74379).

===pmcaps,core_langconfig===
The way to indicate afternoon in capitals.

===strftimedate,core_langconfig===
How time and date are displayed in Moodle. Usually it is fine to check the order of the English one and use the same symbols. If that doesn't serve your needs, the complete reference for what is possible can be found on http://www.w3schools.com/php/func_date_strftime.asp

===strftimedatefullshort,core_langconfig===
How time and date are displayed in Moodle. Usually it is fine to check the order of the English one and use the same symbols. If that doesn't serve your needs, the complete reference for what is possible can be found on http://www.w3schools.com/php/func_date_strftime.asp
===strftimedateshort,core_langconfig===
How time and date are displayed in Moodle. Usually it is fine to check the order of the English one and use the same symbols. If that doesn't serve your needs, the complete reference for what is possible can be found on http://www.w3schools.com/php/func_date_strftime.asp
===strftimedatetime,core_langconfig===
How time and date are displayed in Moodle. Usually it is fine to check the order of the English one and use the same symbols. If that doesn't serve your needs, the complete reference for what is possible can be found on http://www.w3schools.com/php/func_date_strftime.asp
===strftimedatetimeshort,core_langconfig===
How time and date are displayed in Moodle. Usually it is fine to check the order of the English one and use the same symbols. If that doesn't serve your needs, the complete reference for what is possible can be found on http://www.w3schools.com/php/func_date_strftime.asp
===strftimedaydate,core_langconfig===
How time and date are displayed in Moodle. Usually it is fine to check the order of the English one and use the same symbols. If that doesn't serve your needs, the complete reference for what is possible can be found on http://www.w3schools.com/php/func_date_strftime.asp
===strftimedaydatetime,core_langconfig===
How time and date are displayed in Moodle. Usually it is fine to check the order of the English one and use the same symbols. If that doesn't serve your needs, the complete reference for what is possible can be found on http://www.w3schools.com/php/func_date_strftime.asp
===strftimedayshort,core_langconfig===
How time and day are displayed in short in Moodle. Usually it is fine to check the order of the English one and use the same symbols. If that doesn't serve your needs, the complete reference for what is possible can be found on http://www.w3schools.com/php/func_date_strftime.asp
===strftimedaytime,core_langconfig===
How time and day are displayed in Moodle. Usually it is fine to check the order of the English one and use the same symbols. If that doesn't serve your needs, the complete reference for what is possible can be found on http://www.w3schools.com/php/func_date_strftime.asp
===strftimemonthyear,core_langconfig===
How month and year are displayed in Moodle. Usually it is fine to check the order of the English one and use the same symbols. If that doesn't serve your needs, the complete reference for what is possible can be found on http://www.w3schools.com/php/func_date_strftime.asp
===strftimerecent,core_langconfig===
How time and date are displayed in Moodle. Usually it is fine to check the order of the English one and use the same symbols. If that doesn't serve your needs, the complete reference for what is possible can be found on http://www.w3schools.com/php/func_date_strftime.asp
===strftimerecentfull,core_langconfig===
How time and date are displayed for recent activities in Moodle. Usually it is fine to check the order of the English one and use the same symbols. If that doesn't serve your needs, the complete reference for what is possible can be found on http://www.w3schools.com/php/func_date_strftime.asp
===strftimetime,core_langconfig===
How time is displayed in Moodle. Usually it is fine to check the order of the English one and use the same symbols. If that doesn't serve your needs, the complete reference for what is possible can be found on http://www.w3schools.com/php/func_date_strftime.asp

===thisdirection,core_langconfig===
In which direction your language should be displayed on the screen. The only possible options are ltr (left to right) or rtl (right to left).'''Do not attempt to translate these''', or [https://moodle.org/mod/forum/discuss.php?d=328567#p1323101 you will wreak havoc on many themes].

===thisdirectionvertical,core_langconfig===
How text that is printed vertical on the screen is oriënted (like in a docked block).

The only possible values can be btt (bottom to top) or ttb (top to bottom). '''Do not attempt to translate these''', or [https://moodle.org/mod/forum/discuss.php?d=328567#p1323101 you will wreak havoc on many themes].

===thislanguage,core_langconfig===
The name of your language in your own language

===thislanguageint,core_langconfig===
The name of your language in English

===thousandssep,core_langconfig===
How you separate thousands in your language.
Important: this can not be a space (more information in discussion http://lang.moodle.org/mod/forum/discuss.php?d=1450#p1730). If you want a space, you can try with &nbsp; but that is not fully tested yet.

Example:
* in Dutch 1.000.000 (with a dot)
* in English 1,000,000 (with a comma)

[[Category:Language]]

[[es:Langconfig]]

Translation FAQ

2022-08-05T10:20:20Z

Koen: /* Can the subtitles for Moodle HQ YouTube videos be translated? */ This doesn't exist anymore

{{Translation}}
==How can I help with translating Moodle?==
Please see the guide [[Contributing a translation]].
==I've found an error in a language pack. What do I do?==
* You are welcome to [[Contributing a translation|contribute a fix]] for the error. Alternatively you can contact the language pack maintainer as listed in the [http://lang.moodle.org/local/amos/credits.php Translation credits].
* English language string typo fixes and suggested improvements can be [[Improving English language strings|contributed to the English (fixes) (en_fix) language pack]].
==The month names and days are displayed in English. How can I translate them?==
This is neither Moodle bug nor a missing translation. Names of days and months are pulled out of your operating system. Your server, where the Moodle is running, does not seem to have the specific [https://en.wikipedia.org/wiki/Locale_(computer_software) locale] installed. You need to contact the server administrator and ask them to install the needed locale. See [[Table of locales]] for details.

The particular locale to use for the given language is configured in the langconfig.php file in strings ''locale'' (for Unix like operating systems) and ''localewin'' (for Windows operating systems).

On Ubuntu/Debian, the package <tt>locale-all</tt> can be installed to support all existing languages.

Mac OS is known to have a very limited support for locales. This can not be fixed.
==Why are log descriptions displayed in English?==
In log reports, descriptions are intended to be displayed in English only; it is not possible to translate them. For example "The user with id '2' viewed the course with id '4'."
==I'm starting a new language pack or I'm contributing to one. Can I do the user interface strings first?==
No, there is no way to know which strings will be shown for users and which not. But to help you a little bit, there are some unofficial priorities you can take into account.

First:
* make sure [[Translation_langconfig|langconfig]] is properly set up.
* take a look at [[Translation priority]]. All files have a rating according to how urgent they need translating.
* less urgent are also the contributed plugins, since they are not part of a standard Moodle distribution. There is a list of [https://moodle.org/plugins/stats.php the 20 top plugins downloads for Moodle] which might be worth considering for translation priority.
==How many words are there in the English language pack?==
See the discussion [http://lang.moodle.org/mod/forum/discuss.php?d=3651 How many words are there in the English language pack?].
==Moodle languages with several available language packs==
===Are there translations for the American (and other branches of the) English language?===
The [http://lang.moodle.org/mod/forum/discuss.php?d=2617 "official"] language for Moodle is actually Australian English (''G'day mate!'') , which is almost 100% the same as UK English. [http://english.stackexchange.com/questions/74737/what-is-the-origin-of-the-phrase-two-nations-divided-by-a-common-language Someone] once said "America and England are two nations divided by a common language".
* The English - United States (en_us)] language pack mostly contains different spellings (color ''versus'' colour, enroll ''versus'' enrol etc).
* The English - Pirate (en_ar)] language pack is used in the '[https://moodle.org/mod/forum/discuss.php?d=132888 Talk Like a Pirate]' day.
* The English - United States K12 (en_us_k12) language pack is used in the [https://en.wikipedia.org/wiki/K%E2%80%9312 K-12] (kindergarten to grade 12) primary and secondary education in the USA, Canada, and other English speaking countries. It includes spellings from the en_us language pack and the term "course" is renamed as "class".
* The English for kids (en_kids) language pack seems to be a simplified version of the most common English strings seen by Moodle users, considered easier/suitable for small children.
* The English (fixes) (en_fix) language pack is used to suggest Moodle core language strings improvements and typo fixes, as described in the guide [[Improving English language strings]].
===Why does Moodle have four different language packs for the German language?===
* In Germany we have a formal language where people are talking with „Sie“ to each other. This is the language of the formal adults. I think it’s something like using „Sir“ in english language. The normal German language pack is using this formal language. Nearly all strings in the Moodle language pack and in the translated plugins are translated in the formal language.

* You can’t use these formal words in school … there you are using an informal language with „du“. Students are talking to each other like friends. Therefor we made the language pack „German personal“ (de_du). It come with the personal words „du“, „dein“, „dir“ and so on where the formal words are „Sie“, „Ihre“, „Ihnen“ (yes, these words are written with an uppercase letter).

* For my (Ralf Krause) personal use I take „German personal" (de_du) or „German Kids“ (de_kids). „German Kids“ uses the personal words „du“, „dein“ and „dir“ but it also uses an easier to understand language.

* Some time ago we tried to make Moodle as a platform for social communication but nobody wanted to use it. Therefore we made "German community“. In a social platform, nobody would talk about teachers or students or participants or classrooms or courses … in a social platform, you would use members of a group and meetings. I don’t know if this pack will be used in future.
===Why does Moodle have several different language packs for the Spanish language?===
* Spain and many South American countries use a (comma) [[Decimal separator]] that is different from the (decimal point) used in Mexico and Central America.
** Moodle core in English uses by default a decimal point for calculations, and Moodle Docs do too.
** This caused many problems in the [[Gradebook]] calculations and with the [https://docs.moodle.org/all/es/P%C3%A1gina_Principal Spanish Moodle Docs].
* Just as "America and England are two nations divided by a common language", so are Spain and Mexico. See [https://docs.moodle.org/all/es/Espa%C3%B1ol_de_M%C3%A9xico the Mexican Spanish documentation page] in Spanish.
* The Venezuelan Spanish (es_ve) is a very small child language of the international Spanish language.
* The Colombian Spanish (es_co) is a very small child language of the international Spanish language.
* The Mexican Spanish (es_mx) is a very modern, comprehensive, independent, language pack, specially made for Mexican Moodlers.
* The Mexican Spanish for kids (es_mx_kids) is a simplified version of the most common Mexican Spanish strings seen by Moodle users, considered easier/suitable for small children.
* You can read about [https://docs.moodle.org/all/es/Espa%C3%B1ol_internacional#Idiomas_hijos_que_depend.C3.ADan_del_Espa.C3.B1ol_internacional two (now defunct) other Spanish child languages].

===Why do other languages have child languages?===
* Languages with ''-kids'' in their code names are all child languages with a simplified version of common language strings aimed at small children.
* If you have the time, it is probably a good idea to have one such child language for kids for your main language pack.
* Current (mid 2022) languages for kids are:
** Deutsch (kids)
** English (kids)
** Español de México para niños (Mexican Spanish for kids)
** Ελληνικά για παιδιά (Greek for kids)
** עברית בתי־ספר (Hebrew for kids)
** हिंदी (Hindi for kids)
** Japanese (kids)
** Deutsch - Kids

* Norwegian (Primary) language pack is aimed at primary education.

* Finnish for companies is aimed at companies.

* Languages ending in "_wp" are supplementary languages for [https://docs.moodle.org/37/en/Moodle_Workplace Moodle Workplace]. They are maintained by the companies offering [https://docs.moodle.org/37/en/Moodle_Workplace Moodle Workplace].
==Are there items which are NOT to be translated?==
===Moodle variables enclosed within {curly brackets}===
The following words, when enclosed within {curly brackets}, are placeholders for Moodle names of variables. They should not be translated, but must remain as they are within the curly brackets:
firstname, lastname, username, email, city, country, lang, timezone, mailformat, maildisplay, maildigest, htmleditor, ajax, autosubscribe , institution, department, idnumber, skype , msn, aim, yahoo, icq, phone1, phone2, address, url, description, descriptionformat, password, auth, oldusername , deleted, suspended, course1, course2, course3, course4
They must also be written exactly like this in all translations of the documentation pages (such as this page.) However, the translator might like to include a translation enclosed in brackets. For example, in the Spanish documentation pages you might find: password (''contraseña'').

The fact is: '''no placeholders can be translated in AMOS'''. There is no official list of "reserved" $a properties. Whatever xyz is put in {$a->xyz}, it must be kept as it is in AMOS.

Example:

[[Image: 26 AMOS fullnamedisplay_core original.png]]

'''Must''' be (in this case, when translated into Mexican Spanish):

[[File:26 AMOS fullnamedisplay_core.png]]

unless your language uses lastname before the firstname, as Japanese does, which translates to:

[[File:26 AMOS fullnamedisplay_core Japanese.png]]

===Placeholders enclosed within % characters (%example%) must not be translated===
The [https://moodle.org/plugins/local_moodlecloudsignup Moodle Cloud Signup and Portal strings] local plugin is used for accessing the [https://moodle.com/cloud/ MoodleCloud] and it includes several strings that have some words surrounded by % characters (eg, %date%). These words must not be translated, they must be copied exactly into the language pack translation, but the rest of the string might or might not be translated.
* Example of one string that can not be translated and must be copied exactly:
[[File:AMOS placeholders with percentace character.png|600px]]
* Example of one string with one placeholder (highlighted) and some regular text that can be easily translated:
[[File:AMOS text with placeholders with percentace character.png|600px]]
===Placeholders in H5P prefixed with % or : characters must not be translated===
The [http://h5p.org/ H5P editor] integrated with Moodle since 3.9 has some variables prefixed with "%" or ":" that must not be translated because they are transformed internally with the correct value. They should be treated as the Moodle curly brackets variables.
* Example of variables with "%" that can not be translated and must be copied exactly:
"Parameters contain %used while only %supported or earlier are supported."

In that case, %used and %supported must not be translated. So, for instance, the Spanish translation would be something like:
"Parámetros contiene %used mientras que sólo se soportan %supported o anterior."
* Example of variables with ":" that can not be translated and must be copied exactly:
"The :property value exceeds the maximum of :max."

In that case, :property and :max must not be translated. The Spanish translation for this string would be something like:
"El valor de :property excede el máximo de :max."
=== All fieldnames must be kept in English===
* These names are hooks that are used in the software. You should not translate them.
* See the example below for the string uploadcourses_help in the file tool_uploadcourse for Moodle 3.1:
[[File:Fieldnames are not to be translatd.png]]
* Notice that the string text indicates (red rectangle) that these words (enclosed in green rectangles) are fieldnames. Also notice that the Spanish translation clearly indicates, at the final part of the paragraph ''(así escritos, en inglés)'' that these fieldnames must be written in English as they are written here.
* Some used fieldnames in Moodle are:
category, category_id, category_idnumber, category_path, context, course, description, descriptionformat, email, enrolmentkey, firstname, fullname, groupname, hidepicture, idnumber, intro, lastname, maxgrade, maxrequest, name, password, picture, section, shortname, teachers, timeopen, timeclose, timeend, timestart, username, visible,
* Examples of strings where these fielnames appear are uploadcohorts_help | core_cohort, importgroups_help | core_group, uploadcourses_help | tool_uploadcourse and uploadusers_help | tool_uploaduser.
* Note that these fieldnames may appear as real fieldnames (must not be translated) or as regular words in another context (can and must be translated). You should exercise caution and, If possible, always check that Moodle works correctly by testing your translations with some data in a real or test server.
===Local addresses after <a href="../===
Addresses inside a Language string that have <a href="../ reference a specific URL inside your Moodle server and you must keep the address part of the expression, but you can translate the descriptive name part. See the following example:
noassignableroles | tool_cohortautoroles
There are currently no roles that can be assigned in the user context. <a href="../../roles/manage.php">Manage roles</a>
* You must keep the <a href="../../roles/manage.php"> part, as this references to the [https://docs.moodle.org/31/en/PHP PHP] code in your Moodle server that will be executed in order to manage roles
* You can/should/must translate 'Manage roles'
* Do not forget to keep the ending </a>
===Moodle Docs addresses after <syntaxhighlight lang="php"><nowiki><a href="http://docs.moodle.org/en/</nowiki></syntaxhighlight>===
Addresses inside a Language string that have <syntaxhighlight lang="php"><nowiki><a href="http://docs.moodle.org/en/ </nowiki></syntaxhighlight>reference a specific URL in the Moodle English Documentation. You must look at that address and '''only''' if your language has a valid translation for that page, you can/should replace the original English Docs address with your own language address. See the following example:
core backup | nonisowarning
Warning: this backup is from a non-Unicode version of Moodle (pre 1.6). If this backup contains any non-ISO-8859-1 texts then they may be CORRUPTED if you try to restore them to this Unicode version of Moodle. See the <a href="http://docs.moodle.org/en/Backup_FAQ">Backup FAQ</a> for more information about how to recover this backup correctly.
* There are six different language translations for that page. So, you can only replace this address if your language is one of these.
===Other internet addresses after <a href="http://===
* You must proceed as with Moodle Docs addresses:
* Example:
auth_radius | auth_radiusdescription
This method uses a <a href="http://en.wikipedia.org/wiki/RADIUS">RADIUS</a> server to check whether a given username and password is valid.
* You must check the (English language wikipedia) page about the RADIUS server, and then you can decide whether to keep this address or replace it with your own language matching wikipedia translation.
===HTML codes that must not be translated===
The following HTML codes are reserved words that must not be translated. However, it is important for the translators to understand their meaning in order to decide whether to keep them in the translation and if so, whether they can be rearranged.
* <syntaxhighlight lang="php">&nbsp</syntaxhighlight> - non-breaking space i.e. a space but there will never be a line-break inserted instead of this space at the end of a line.
* <syntaxhighlight lang="php">&ensp</syntaxhighlight> and <syntaxhighlight lang="php">&emsp</syntaxhighlight> - denote an en space and an em space respectively, where an en space is half the point size and an em space is equal to the point size of the current font. For fixed pitch fonts, the user agent can treat the en space as being equivalent to a single space character, and the em space as being equuivalent to two space characters.
* <syntaxhighlight lang="php">&amp</syntaxhighlight> - ampersand sign (&)
* <syntaxhighlight lang="php">&apos</syntaxhighlight> - apostrophe sign (')
* <syntaxhighlight lang="php">&copy</syntaxhighlight> - copyright sign (©)
* <syntaxhighlight lang="php">&plusmn</syntaxhighlight> - "plus or minus" sign (±)
* <syntaxhighlight lang="php">&times</syntaxhighlight> - multiply sign (*)
* <syntaxhighlight lang="php">&divide</syntaxhighlight> - divide sign (/)
* <syntaxhighlight lang="php">&gt</syntaxhighlight> - "greater than" sign ( > )
* <syntaxhighlight lang="php">&lt</syntaxhighlight> - "less than" sign (<)
* <syntaxhighlight lang="php">&laquo</syntaxhighlight> - quotation mark (‘)
* <syntaxhighlight lang="php">&lsquo</syntaxhighlight> - left single quotation sign (‘)
* <syntaxhighlight lang="php">&rsquo</syntaxhighlight> - right single quotation sign (’)
* <syntaxhighlight lang="php">&ouml</syntaxhighlight> - small letter o with diaeresis (ö)
* <syntaxhighlight lang="php">&mdash</syntaxhighlight> - [https://en.wikipedia.org/wiki/Dash#Em_dash em dash] sign (—)
===Calculation functions must not be translated===
[https://docs.moodle.org/32/en/Grade_calculations#Calculation_functions Calculation functions] start with an equal sign (=). Following is an expression using operators and functions supported by the system.
[[File:DO NOT translate calculation functions.png]]
===The 'thisdirection' and 'thisdirectionvertical' strings in core_langconfig should never be translated===
'''The 'thisdirection' and 'thisdirectionvertical' strings in core_langconfig should never be translated, as they are not variables meant to be translated. They are prefixing selectors used by the themes to display left-to-right or right-to-left languages. Read [https://moodle.org/mod/forum/discuss.php?d=328567#p1323101 more about problems with these variables].
===MoodleBox===
The word 'MoodleBox' must be kept in all languages.
===Safe Exam Browser===
A feedback by the Safe Exam Browser main developer:
The software is called “Safe Exam Browser” in any language, we don’t translate the name of the application. So it doesn’t make sense to translate it in any plugin, you could use it as a subtitle or in brackets, like “Safe Exam Browser (Navegador de Examen Seguro)”.

==Is there a way to check the integrity of all placeholders in a language pack?==
* Not a at the moment. See MDL-51775 .
* You can use [https://lang.moodle.org/mod/forum/discuss.php?d=4661 this trick] to check for integrity:
** Load the language pack in a [https://download.moodle.org/windows/ local instance of Moodle].
** In order to generate a [https://lang.moodle.org/mod/forum/discuss.php?d=4098 translation memory], load the language pack in the [https://docs.moodle.org/29/en/Language_customisation Language customization] tool, so that the texts are loaded in the database.
** Run the sql instance in the file (tm_generator.txt)
** Insert the result of the query in template.tmx file
** The result is a translation memory that can be analysed with [http://www.opentag.com/okapi/wiki/index.php?title=CheckMate Checkmate].
** The problem: probably you will get many errors due to some characters that are not allowed by Checkmate so you will have to remove manually some translation units. After doing it, you will get a report with some possible errors (see the attached image).
** Of course, it would be great to have an integrated quality check system in Moodle. Vote for MDL-51775 .

* The contents of the file tm_generator.txt are ('''change the language from eu to your language'''):
SELECT concat('<tu tuid="',mdl_tool_customlang_components.name,'|',mdl_tool_customlang.stringid,'">
<tuv xml:lang="en"><seg>',mdl_tool_customlang.original,'</seg></tuv>
<tuv xml:lang="',mdl_tool_customlang.lang,'"><seg>',mdl_tool_customlang.master,'</seg></tuv>
</tu>') as txt
FROM mdl_tool_customlang INNER JOIN mdl_tool_customlang_components ON mdl_tool_customlang.componentid = mdl_tool_customlang_components.id
WHERE (((mdl_tool_customlang.lang)="eu") AND ((mdl_tool_customlang.original) Is Not Null) AND ((mdl_tool_customlang.master) <>mdl_tool_customlang.original));
* the contents of the template.tmx file are:
<?xml version="1.0" encoding="UTF-8"?>
<tmx version="1.4"><header creationtool="SQLQuery" creationtoolversion="unknown" segtype="paragraph" o-tmf="unknown" adminlang="en" srclang="en" datatype="unknown"></header><body>
PLACE HERE THE RESULT OF THE SQL QUERY
</body>
</tmx>
==What is a ''translation memory'' and how can I create a translation memory out of a Moodle language pack?==
* Read the 'Is there a way to check the integrity of all placeholders in a language pack?' section above.
* See [https://lang.moodle.org/mod/forum/user.php?id=1489&page=1 this post] and [https://dl.dropboxusercontent.com/u/86242384/moodle/en/publish/moodle_tm/website_index.html this tutorial].
==How can I help with translating Moodle documentation?==
Please see the guide [[Translating Moodle Docs]].
==How can I find out the context of the strings?==
You can find where a language string is located as described in the user docs [[:en:Language_customisation#Finding_the_component_and_string_identifier|Finding the component and string identifier]] and [[:en:Language FAQ|Language FAQ]].

You may wish to use two windows (perhaps using two monitors), with one displaying the page in English and the other displaying the page in your language.

[[File:two windows translation.jpg|Two simultaneous windows in two languages|800px]]

If you think the original English language strings have more than one meaning and you can't guess which one applies, you are welcome to post in the [https://lang.moodle.org/mod/forum/view.php?id=5 AMOS translation forum].
==Is there a list of Moodle error messages which can be translated?==
Error messages are listed in the user docs [[:en:Category:Error|Category:Error]].

==Can the User Tours from Moodle.net be translated?==
* Yes. See [[Translating User tours from Moodle.net]]
==How can I test my plugins translations of several (different) Moodle branches?==
*Linux
** You can have several Moodle branches in one Ubuntu (or any other Linux distro) machine by following [https://docs.moodle.org/31/en/Step-by-step_Installation_Guide_for_Ubuntu#Hosting_several_Moodle_branches_in_one_Ubuntu_server these steps].

* Windows
** You can have several [https://download.moodle.org/windows/ local Moodle servers] in different folders in a Windows (7,8,10) PC. It is very easy to start one branch server, work on it, stop it and then start a different branch.
{{Note|Some early local Moodle (versions before 3.0) server packages from [https://download.moodle.org/windows/ https://download.moodle.org/windows/] only work in Windows 7, but apparently not in Windows 8 and definitely not in Windows 10, regardless of compatibility settings. For these you would need to install XAMP separately. Moodle 3.0 and newer branches do work under Windows 10.}}
*Mac
**We need to write about this...
==Can I translate a language pack offline / can I use another language then English as source language?==
Yes you can, but it is not recommended because there is a high risk of causing problems (remember - sites update language packs automatically, so your problem spreads quickly over the world).
One problem is that you absolutely have to avoid untranslated strings or strings in the wrong language in the language pack. This should NEVER happen. Another problem is that there is no way to know which strings are already translated. There is also a higher risk for syntax errors. If you have to, you can follow the following procedure:
* download the English language pack (or another one if you want a different source language)
* translate directly in the php file, preferably using something with syntax highlighting (Geany, Gedit, Notepad++ on Windows, ...)
* IMPORTANT: delete all not-translated lines from the file, before uploading - therefore it is probably best to translate line by line and keep the original source files, so you can work with a record of processed line numbers.
* import the files in the translation portal following the manual on https://docs.moodle.org/dev/AMOS_manual#Importing_a_file (IMPORTANT: zip file cannot contain any folders)
==How can I translate H5P content types?==
Use [https://translate-h5p.tk/weblate/projects/h5p/ the Weblate H5P project translation page] or see the h5p.org guide [https://h5p.org/adding-content-type-translation-via-github Adding content type translations via GitHub] and the forum discussion [https://moodle.org/mod/forum/discuss.php?d=414325 Translate H5P items].
==See also==
* [[:en:Language customization|Language customization]] in the user docs for information on how to edit an existing language pack
* [https://lang.moodle.org/mod/forum/discuss.php?d=4098#p4879 Generating a translation memory and running a quality test] forum discussion
* [https://moodle.org/mod/forum/discuss.php?d=347843 translation in context] forum discussion
[[de:Übersetzung FAQ]]
[[category:Language]]

Translation langconfig

2022-08-05T10:18:42Z

Koen: adding the new parameters that were in dev docs but not in wiki docs.

{{Translation}}
Langconfig is an important file in a language pack, dealing with all the configuration parameters of that language. It is good practice to review this first when starting of a new language pack or when taking on responsibility of an existing language pack. You can edit it by going to lang.moodle.org and find it as the core_langconfig component for your language.

On this page you find a little documentation for each setting to help you deciding what should go there for your language.

===alphabet,core_langconfig===
The alphabet in your language. Used e.g. for the list of letters on the participants page.

===am,core_langconfig===
The way to indicate morning in your language. This is used on servers that only support 24 hour time for your language. (see https://tracker.moodle.org/browse/MDL-74379).

===amcaps,core_langconfig===
The way to indicate moring in capitals.

===backupnameformat,core_langconfig===

===decsep,core_langconfig===
How decimals are separated in your language. [http://en.wikipedia.org/wiki/Decimal_separator Usually a dot or a comma]. Take note that some countries which seem to share the same language may have a different character to separate the integer part from the fractional part of a number written in decimal form. e.g. Central American Spanish-speaking countries use the decimal point, while South American Spanish-speaking countries use the decimal comma.

Example:
* English: 36.5
* Dutch: 36,5

===firstdayofweek,core_langconfig===
The first day of the week in your language. Allowed values are 0,1,2,3,4,5,6, where 0 stands for Sunday.

===iso6391,core_langconfig===
The ISO 639.1 value for your language. You can find this value easily on [https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes Wikipedia].

===iso6392,core_langconfig===
The ISO 639.2 value for your language. You can find this value easily on [https://en.wikipedia.org/wiki/List_of_ISO_639-2_codes Wikipedia].

===labelsep,core_langconfig===
How a label is separated from a form. Could be a colon, a space and a colon or something different, according to what's generally used in your language. This character is not read by screen readers for accessibility reasons.

===listsep,core_langconfig===
The symbol usually used in your language, for separating items in a list. This is used e.g. when using formulas with multiple items in the gradebook. This must be a symbol different from the decsep symbol.

===locale,core_langconfig===
locale for *nix servers.

If your Moodle calendar is not translated, then this string is wrong (or your server is not configured to support the language)

{{Note|Locales, used in language packs should come only from the table of locales at https://docs.moodle.org/dev/Table_of_locales and the list at https://docs.moodle.org/dev/List_of_locales_supported_on_Moodle_community_servers}}

An unsupported locale in a Mac or Linux site will produce the following error when you try to update your language pack:

[[File:Unsupported locale mac.png|400px]]

And, more important, it may produce an intermitent 'undefined' error message:

[[File:ERROR undefined.png|400px]]

===localecldr,core_lanconfig===

See http://cldr.unicode.org/index/cldr-spec/picking-the-right-language-code

===localewin,core_langconfig===
locale for Windows servers.

If your Moodle calendar is not translated, then this string 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

===localewincharset,core_langconfig===
The character set to use when Moodle is installed on a Windows server

===oldcharset,core_langconfig===
Necessary to upgrade from prior to 1.6. This string defines the charset used in 1.5 and earlier for this language pack. For language packs that start later then Moodle 1.5, this can be left empty

===parentlanguage,core_langconfig===
The original Moodle default Australian language pack has this field empty (as the Australian English language IS the official Moodle language).

If your language pack relies on another one (it is a 'child' language of a 'parent' language), then this is the place to point out which language pack. '''For most language packs, this should be left empty''', to default to English if strings are missing.

Example: Canadian French (fr_ca) is mostly the same as French (fr) apart from a few changes. Creating a language pack with as parent language French will shop French if a string does not exist in the language pack Canadian French. If a string doesn't exist in both language packs, English is shown.

On the download page for the language packs (https://download.moodle.org/langpack/3.7/) you can see how many strings are different from the parent language pack. In Moodle 3.7, Canadian French had 998 changes from French.

{{Note|Using language customization for parentlanguage inside langconfig.php in an existing Moodle server, where you add a parent language (while the AMOS parentlanguage string is actually empty) will ask for the installation of said parent language in the server, but will not substitute the missing translations in the child language with those of the parent language; English will be shown. Surgically editing (a dangerous, never recommended procedure) the langconfig.php file of the server would work, until the next language pack update -manual or cron made- erases the change.}}

===pm,core_langconfig===
The way to indicate afternoon in your language. This is used on servers that only support 24 hour time for your language. (see https://tracker.moodle.org/browse/MDL-74379).

===pmcaps,core_langconfig===
The way to indicate afternoon in capitals.

===strftimedate,core_langconfig===
How time and date are displayed in Moodle. Usually it is fine to check the order of the English one and use the same symbols. If that doesn't serve your needs, the complete reference for what is possible can be found on http://www.w3schools.com/php/func_date_strftime.asp

===strftimedatefullshort,core_langconfig===
How time and date are displayed in Moodle. Usually it is fine to check the order of the English one and use the same symbols. If that doesn't serve your needs, the complete reference for what is possible can be found on http://www.w3schools.com/php/func_date_strftime.asp
===strftimedateshort,core_langconfig===
How time and date are displayed in Moodle. Usually it is fine to check the order of the English one and use the same symbols. If that doesn't serve your needs, the complete reference for what is possible can be found on http://www.w3schools.com/php/func_date_strftime.asp
===strftimedatetime,core_langconfig===
How time and date are displayed in Moodle. Usually it is fine to check the order of the English one and use the same symbols. If that doesn't serve your needs, the complete reference for what is possible can be found on http://www.w3schools.com/php/func_date_strftime.asp
===strftimedatetimeshort,core_langconfig===
How time and date are displayed in Moodle. Usually it is fine to check the order of the English one and use the same symbols. If that doesn't serve your needs, the complete reference for what is possible can be found on http://www.w3schools.com/php/func_date_strftime.asp
===strftimedaydate,core_langconfig===
How time and date are displayed in Moodle. Usually it is fine to check the order of the English one and use the same symbols. If that doesn't serve your needs, the complete reference for what is possible can be found on http://www.w3schools.com/php/func_date_strftime.asp
===strftimedaydatetime,core_langconfig===
How time and date are displayed in Moodle. Usually it is fine to check the order of the English one and use the same symbols. If that doesn't serve your needs, the complete reference for what is possible can be found on http://www.w3schools.com/php/func_date_strftime.asp
===strftimedayshort,core_langconfig===
How time and day are displayed in short in Moodle. Usually it is fine to check the order of the English one and use the same symbols. If that doesn't serve your needs, the complete reference for what is possible can be found on http://www.w3schools.com/php/func_date_strftime.asp
===strftimedaytime,core_langconfig===
How time and day are displayed in Moodle. Usually it is fine to check the order of the English one and use the same symbols. If that doesn't serve your needs, the complete reference for what is possible can be found on http://www.w3schools.com/php/func_date_strftime.asp
===strftimemonthyear,core_langconfig===
How month and year are displayed in Moodle. Usually it is fine to check the order of the English one and use the same symbols. If that doesn't serve your needs, the complete reference for what is possible can be found on http://www.w3schools.com/php/func_date_strftime.asp
===strftimerecent,core_langconfig===
How time and date are displayed in Moodle. Usually it is fine to check the order of the English one and use the same symbols. If that doesn't serve your needs, the complete reference for what is possible can be found on http://www.w3schools.com/php/func_date_strftime.asp
===strftimerecentfull,core_langconfig===
How time and date are displayed for recent activities in Moodle. Usually it is fine to check the order of the English one and use the same symbols. If that doesn't serve your needs, the complete reference for what is possible can be found on http://www.w3schools.com/php/func_date_strftime.asp
===strftimetime,core_langconfig===
How time is displayed in Moodle. Usually it is fine to check the order of the English one and use the same symbols. If that doesn't serve your needs, the complete reference for what is possible can be found on http://www.w3schools.com/php/func_date_strftime.asp

===thisdirection,core_langconfig===
In which direction your language should be displayed on the screen. The only possible options are ltr (left to right) or rtl (right to left).'''Do not attempt to translate these''', or [https://moodle.org/mod/forum/discuss.php?d=328567#p1323101 you will wreak havoc on many themes].

===thisdirectionvertical,core_langconfig===
How text that is printed vertical on the screen is oriënted (like in a docked block).

The only possible values can be btt (bottom to top) or ttb (top to bottom). '''Do not attempt to translate these''', or [https://moodle.org/mod/forum/discuss.php?d=328567#p1323101 you will wreak havoc on many themes].

===thislanguage,core_langconfig===
The name of your language in your own language

===thislanguageint,core_langconfig===
The name of your language in English

===thousandssep,core_langconfig===
How you separate thousands in your language.
Important: this can not be a space (more information in discussion http://lang.moodle.org/mod/forum/discuss.php?d=1450#p1730). If you want a space, you can try with &nbsp; but that is not fully tested yet.

Example:
* in Dutch 1.000.000 (with a dot)
* in English 1,000,000 (with a comma)

[[Category:Language]]

[[es:Langconfig]]

Translation

2022-08-05T10:08:31Z

Koen: /* So you'd like to help with translating Moodle? */

{{Translation}}

==So you'd like to help with translating Moodle?==

Great! :-) All translation of Moodle LMS and the plugins happens on our '''[http://lang.moodle.org Moodle translation site]''', so you'll need to start by creating an account there.

Perhaps you've found some words or phrases not yet translated into your language? Or you've spotted a mistake? If so, please see the guide to [[Contributing a translation]].

Note: If you'd like to help translate more than just a few strings, please contact the maintainer of your language pack as listed in the [http://lang.moodle.org/local/amos/credits.php Translation credits] and ask where you can help.

Did you end up here, wanting to translate the [https://moodle.academy Moodle Academy courses], please start at [[Translating Moodle Academy]]

==Wish to take on responsibility for a language pack?==

Please see [[Maintaining a language pack]] and the [[AMOS manual]] for further information about the AMOS translation toolkit.

==Is Moodle not yet translated into your language?==

Please see [[Starting a new language pack]].

==Any questions?==

Please check the [[Translation FAQ]] and join us in the [http://lang.moodle.org/mod/forum/view.php?id=5 Using AMOS forum].

[[fr:Traduction]]
[[de:Übersetzung]]
[[es:Traducción]]
[[category:Language]]

Translating Moodle Academy

2022-08-05T10:07:58Z

Koen: Created page with "{{Translation}} The translation of the Moodle Academy courses is a different process then the translation of the Moodle interface. While the translation of the Moodle interfa..."

{{Translation}}

The translation of the Moodle Academy courses is a different process then the translation of the Moodle interface. While the translation of the Moodle interface is about changing the code, the translation of the Moodle academy is about changing the content of Moodle courses. Therefore, the process is different and it happens on another location.

You start by [https://moodle.academy/course/view.php?id=52 following a course about translating Moodle Academy]. When you completed the course, the Moodle Academy managers will review your work and upgrade your rights on the site. This process takes a couple of days.

When your rights are upgraded, you will have an extra icon next to every item in the courses on [https://moodle.academy Moodle Academy], allowing you to translate the content directly into your language. Changes will take effect immediately.

So move on to [https://moodle.academy/course/view.php?id=52 the Moodle Academy translation course] and create valuable documentation for your colleagues and other users of your language.

[[category:Language]]

Template:Translation

2022-08-05T10:03:32Z

Koen: adding moodle academy

<div class="sideblock right">
<div class="header">[[Translation]]</div>
<div class="content">
*[[Contributing a translation]]
*[[Maintaining a language pack]]
*[[AMOS manual]]
*[[Starting a new language pack]]
*[[Translating plugins]]
*[[Translating Moodle Docs]]
*[[Translating the Moodle app]]
*[[Translating Moodle Academy]]
*[[Translation FAQ]]
</div>
</div>

<includeonly>[[Category:Translation]]</includeonly>
<noinclude>This template will categorize articles that include it into [[:Category:Translation]].</noinclude>

Translation FAQ

2022-08-05T10:00:17Z

Koen:

{{Translation}}
==How can I help with translating Moodle?==
Please see the guide [[Contributing a translation]].
==I've found an error in a language pack. What do I do?==
* You are welcome to [[Contributing a translation|contribute a fix]] for the error. Alternatively you can contact the language pack maintainer as listed in the [http://lang.moodle.org/local/amos/credits.php Translation credits].
* English language string typo fixes and suggested improvements can be [[Improving English language strings|contributed to the English (fixes) (en_fix) language pack]].
==The month names and days are displayed in English. How can I translate them?==
This is neither Moodle bug nor a missing translation. Names of days and months are pulled out of your operating system. Your server, where the Moodle is running, does not seem to have the specific [https://en.wikipedia.org/wiki/Locale_(computer_software) locale] installed. You need to contact the server administrator and ask them to install the needed locale. See [[Table of locales]] for details.

The particular locale to use for the given language is configured in the langconfig.php file in strings ''locale'' (for Unix like operating systems) and ''localewin'' (for Windows operating systems).

On Ubuntu/Debian, the package <tt>locale-all</tt> can be installed to support all existing languages.

Mac OS is known to have a very limited support for locales. This can not be fixed.
==Why are log descriptions displayed in English?==
In log reports, descriptions are intended to be displayed in English only; it is not possible to translate them. For example "The user with id '2' viewed the course with id '4'."
==I'm starting a new language pack or I'm contributing to one. Can I do the user interface strings first?==
No, there is no way to know which strings will be shown for users and which not. But to help you a little bit, there are some unofficial priorities you can take into account.

First:
* make sure [[Translation_langconfig|langconfig]] is properly set up.
* take a look at [[Translation priority]]. All files have a rating according to how urgent they need translating.
* less urgent are also the contributed plugins, since they are not part of a standard Moodle distribution. There is a list of [https://moodle.org/plugins/stats.php the 20 top plugins downloads for Moodle] which might be worth considering for translation priority.
==How many words are there in the English language pack?==
See the discussion [http://lang.moodle.org/mod/forum/discuss.php?d=3651 How many words are there in the English language pack?].
==Moodle languages with several available language packs==
===Are there translations for the American (and other branches of the) English language?===
The [http://lang.moodle.org/mod/forum/discuss.php?d=2617 "official"] language for Moodle is actually Australian English (''G'day mate!'') , which is almost 100% the same as UK English. [http://english.stackexchange.com/questions/74737/what-is-the-origin-of-the-phrase-two-nations-divided-by-a-common-language Someone] once said "America and England are two nations divided by a common language".
* The English - United States (en_us)] language pack mostly contains different spellings (color ''versus'' colour, enroll ''versus'' enrol etc).
* The English - Pirate (en_ar)] language pack is used in the '[https://moodle.org/mod/forum/discuss.php?d=132888 Talk Like a Pirate]' day.
* The English - United States K12 (en_us_k12) language pack is used in the [https://en.wikipedia.org/wiki/K%E2%80%9312 K-12] (kindergarten to grade 12) primary and secondary education in the USA, Canada, and other English speaking countries. It includes spellings from the en_us language pack and the term "course" is renamed as "class".
* The English for kids (en_kids) language pack seems to be a simplified version of the most common English strings seen by Moodle users, considered easier/suitable for small children.
* The English (fixes) (en_fix) language pack is used to suggest Moodle core language strings improvements and typo fixes, as described in the guide [[Improving English language strings]].
===Why does Moodle have four different language packs for the German language?===
* In Germany we have a formal language where people are talking with „Sie“ to each other. This is the language of the formal adults. I think it’s something like using „Sir“ in english language. The normal German language pack is using this formal language. Nearly all strings in the Moodle language pack and in the translated plugins are translated in the formal language.

* You can’t use these formal words in school … there you are using an informal language with „du“. Students are talking to each other like friends. Therefor we made the language pack „German personal“ (de_du). It come with the personal words „du“, „dein“, „dir“ and so on where the formal words are „Sie“, „Ihre“, „Ihnen“ (yes, these words are written with an uppercase letter).

* For my (Ralf Krause) personal use I take „German personal" (de_du) or „German Kids“ (de_kids). „German Kids“ uses the personal words „du“, „dein“ and „dir“ but it also uses an easier to understand language.

* Some time ago we tried to make Moodle as a platform for social communication but nobody wanted to use it. Therefore we made "German community“. In a social platform, nobody would talk about teachers or students or participants or classrooms or courses … in a social platform, you would use members of a group and meetings. I don’t know if this pack will be used in future.
===Why does Moodle have several different language packs for the Spanish language?===
* Spain and many South American countries use a (comma) [[Decimal separator]] that is different from the (decimal point) used in Mexico and Central America.
** Moodle core in English uses by default a decimal point for calculations, and Moodle Docs do too.
** This caused many problems in the [[Gradebook]] calculations and with the [https://docs.moodle.org/all/es/P%C3%A1gina_Principal Spanish Moodle Docs].
* Just as "America and England are two nations divided by a common language", so are Spain and Mexico. See [https://docs.moodle.org/all/es/Espa%C3%B1ol_de_M%C3%A9xico the Mexican Spanish documentation page] in Spanish.
* The Venezuelan Spanish (es_ve) is a very small child language of the international Spanish language.
* The Colombian Spanish (es_co) is a very small child language of the international Spanish language.
* The Mexican Spanish (es_mx) is a very modern, comprehensive, independent, language pack, specially made for Mexican Moodlers.
* The Mexican Spanish for kids (es_mx_kids) is a simplified version of the most common Mexican Spanish strings seen by Moodle users, considered easier/suitable for small children.
* You can read about [https://docs.moodle.org/all/es/Espa%C3%B1ol_internacional#Idiomas_hijos_que_depend.C3.ADan_del_Espa.C3.B1ol_internacional two (now defunct) other Spanish child languages].

===Why do other languages have child languages?===
* Languages with ''-kids'' in their code names are all child languages with a simplified version of common language strings aimed at small children.
* If you have the time, it is probably a good idea to have one such child language for kids for your main language pack.
* Current (mid 2022) languages for kids are:
** Deutsch (kids)
** English (kids)
** Español de México para niños (Mexican Spanish for kids)
** Ελληνικά για παιδιά (Greek for kids)
** עברית בתי־ספר (Hebrew for kids)
** हिंदी (Hindi for kids)
** Japanese (kids)
** Deutsch - Kids

* Norwegian (Primary) language pack is aimed at primary education.

* Finnish for companies is aimed at companies.

* Languages ending in "_wp" are supplementary languages for [https://docs.moodle.org/37/en/Moodle_Workplace Moodle Workplace]. They are maintained by the companies offering [https://docs.moodle.org/37/en/Moodle_Workplace Moodle Workplace].
==Are there items which are NOT to be translated?==
===Moodle variables enclosed within {curly brackets}===
The following words, when enclosed within {curly brackets}, are placeholders for Moodle names of variables. They should not be translated, but must remain as they are within the curly brackets:
firstname, lastname, username, email, city, country, lang, timezone, mailformat, maildisplay, maildigest, htmleditor, ajax, autosubscribe , institution, department, idnumber, skype , msn, aim, yahoo, icq, phone1, phone2, address, url, description, descriptionformat, password, auth, oldusername , deleted, suspended, course1, course2, course3, course4
They must also be written exactly like this in all translations of the documentation pages (such as this page.) However, the translator might like to include a translation enclosed in brackets. For example, in the Spanish documentation pages you might find: password (''contraseña'').

The fact is: '''no placeholders can be translated in AMOS'''. There is no official list of "reserved" $a properties. Whatever xyz is put in {$a->xyz}, it must be kept as it is in AMOS.

Example:

[[Image: 26 AMOS fullnamedisplay_core original.png]]

'''Must''' be (in this case, when translated into Mexican Spanish):

[[File:26 AMOS fullnamedisplay_core.png]]

unless your language uses lastname before the firstname, as Japanese does, which translates to:

[[File:26 AMOS fullnamedisplay_core Japanese.png]]

===Placeholders enclosed within % characters (%example%) must not be translated===
The [https://moodle.org/plugins/local_moodlecloudsignup Moodle Cloud Signup and Portal strings] local plugin is used for accessing the [https://moodle.com/cloud/ MoodleCloud] and it includes several strings that have some words surrounded by % characters (eg, %date%). These words must not be translated, they must be copied exactly into the language pack translation, but the rest of the string might or might not be translated.
* Example of one string that can not be translated and must be copied exactly:
[[File:AMOS placeholders with percentace character.png|600px]]
* Example of one string with one placeholder (highlighted) and some regular text that can be easily translated:
[[File:AMOS text with placeholders with percentace character.png|600px]]
===Placeholders in H5P prefixed with % or : characters must not be translated===
The [http://h5p.org/ H5P editor] integrated with Moodle since 3.9 has some variables prefixed with "%" or ":" that must not be translated because they are transformed internally with the correct value. They should be treated as the Moodle curly brackets variables.
* Example of variables with "%" that can not be translated and must be copied exactly:
"Parameters contain %used while only %supported or earlier are supported."

In that case, %used and %supported must not be translated. So, for instance, the Spanish translation would be something like:
"Parámetros contiene %used mientras que sólo se soportan %supported o anterior."
* Example of variables with ":" that can not be translated and must be copied exactly:
"The :property value exceeds the maximum of :max."

In that case, :property and :max must not be translated. The Spanish translation for this string would be something like:
"El valor de :property excede el máximo de :max."
=== All fieldnames must be kept in English===
* These names are hooks that are used in the software. You should not translate them.
* See the example below for the string uploadcourses_help in the file tool_uploadcourse for Moodle 3.1:
[[File:Fieldnames are not to be translatd.png]]
* Notice that the string text indicates (red rectangle) that these words (enclosed in green rectangles) are fieldnames. Also notice that the Spanish translation clearly indicates, at the final part of the paragraph ''(así escritos, en inglés)'' that these fieldnames must be written in English as they are written here.
* Some used fieldnames in Moodle are:
category, category_id, category_idnumber, category_path, context, course, description, descriptionformat, email, enrolmentkey, firstname, fullname, groupname, hidepicture, idnumber, intro, lastname, maxgrade, maxrequest, name, password, picture, section, shortname, teachers, timeopen, timeclose, timeend, timestart, username, visible,
* Examples of strings where these fielnames appear are uploadcohorts_help | core_cohort, importgroups_help | core_group, uploadcourses_help | tool_uploadcourse and uploadusers_help | tool_uploaduser.
* Note that these fieldnames may appear as real fieldnames (must not be translated) or as regular words in another context (can and must be translated). You should exercise caution and, If possible, always check that Moodle works correctly by testing your translations with some data in a real or test server.
===Local addresses after <a href="../===
Addresses inside a Language string that have <a href="../ reference a specific URL inside your Moodle server and you must keep the address part of the expression, but you can translate the descriptive name part. See the following example:
noassignableroles | tool_cohortautoroles
There are currently no roles that can be assigned in the user context. <a href="../../roles/manage.php">Manage roles</a>
* You must keep the <a href="../../roles/manage.php"> part, as this references to the [https://docs.moodle.org/31/en/PHP PHP] code in your Moodle server that will be executed in order to manage roles
* You can/should/must translate 'Manage roles'
* Do not forget to keep the ending </a>
===Moodle Docs addresses after <syntaxhighlight lang="php"><nowiki><a href="http://docs.moodle.org/en/</nowiki></syntaxhighlight>===
Addresses inside a Language string that have <syntaxhighlight lang="php"><nowiki><a href="http://docs.moodle.org/en/ </nowiki></syntaxhighlight>reference a specific URL in the Moodle English Documentation. You must look at that address and '''only''' if your language has a valid translation for that page, you can/should replace the original English Docs address with your own language address. See the following example:
core backup | nonisowarning
Warning: this backup is from a non-Unicode version of Moodle (pre 1.6). If this backup contains any non-ISO-8859-1 texts then they may be CORRUPTED if you try to restore them to this Unicode version of Moodle. See the <a href="http://docs.moodle.org/en/Backup_FAQ">Backup FAQ</a> for more information about how to recover this backup correctly.
* There are six different language translations for that page. So, you can only replace this address if your language is one of these.
===Other internet addresses after <a href="http://===
* You must proceed as with Moodle Docs addresses:
* Example:
auth_radius | auth_radiusdescription
This method uses a <a href="http://en.wikipedia.org/wiki/RADIUS">RADIUS</a> server to check whether a given username and password is valid.
* You must check the (English language wikipedia) page about the RADIUS server, and then you can decide whether to keep this address or replace it with your own language matching wikipedia translation.
===HTML codes that must not be translated===
The following HTML codes are reserved words that must not be translated. However, it is important for the translators to understand their meaning in order to decide whether to keep them in the translation and if so, whether they can be rearranged.
* <syntaxhighlight lang="php">&nbsp</syntaxhighlight> - non-breaking space i.e. a space but there will never be a line-break inserted instead of this space at the end of a line.
* <syntaxhighlight lang="php">&ensp</syntaxhighlight> and <syntaxhighlight lang="php">&emsp</syntaxhighlight> - denote an en space and an em space respectively, where an en space is half the point size and an em space is equal to the point size of the current font. For fixed pitch fonts, the user agent can treat the en space as being equivalent to a single space character, and the em space as being equuivalent to two space characters.
* <syntaxhighlight lang="php">&amp</syntaxhighlight> - ampersand sign (&)
* <syntaxhighlight lang="php">&apos</syntaxhighlight> - apostrophe sign (')
* <syntaxhighlight lang="php">&copy</syntaxhighlight> - copyright sign (©)
* <syntaxhighlight lang="php">&plusmn</syntaxhighlight> - "plus or minus" sign (±)
* <syntaxhighlight lang="php">&times</syntaxhighlight> - multiply sign (*)
* <syntaxhighlight lang="php">&divide</syntaxhighlight> - divide sign (/)
* <syntaxhighlight lang="php">&gt</syntaxhighlight> - "greater than" sign ( > )
* <syntaxhighlight lang="php">&lt</syntaxhighlight> - "less than" sign (<)
* <syntaxhighlight lang="php">&laquo</syntaxhighlight> - quotation mark (‘)
* <syntaxhighlight lang="php">&lsquo</syntaxhighlight> - left single quotation sign (‘)
* <syntaxhighlight lang="php">&rsquo</syntaxhighlight> - right single quotation sign (’)
* <syntaxhighlight lang="php">&ouml</syntaxhighlight> - small letter o with diaeresis (ö)
* <syntaxhighlight lang="php">&mdash</syntaxhighlight> - [https://en.wikipedia.org/wiki/Dash#Em_dash em dash] sign (—)
===Calculation functions must not be translated===
[https://docs.moodle.org/32/en/Grade_calculations#Calculation_functions Calculation functions] start with an equal sign (=). Following is an expression using operators and functions supported by the system.
[[File:DO NOT translate calculation functions.png]]
===The 'thisdirection' and 'thisdirectionvertical' strings in core_langconfig should never be translated===
'''The 'thisdirection' and 'thisdirectionvertical' strings in core_langconfig should never be translated, as they are not variables meant to be translated. They are prefixing selectors used by the themes to display left-to-right or right-to-left languages. Read [https://moodle.org/mod/forum/discuss.php?d=328567#p1323101 more about problems with these variables].
===MoodleBox===
The word 'MoodleBox' must be kept in all languages.
===Safe Exam Browser===
A feedback by the Safe Exam Browser main developer:
The software is called “Safe Exam Browser” in any language, we don’t translate the name of the application. So it doesn’t make sense to translate it in any plugin, you could use it as a subtitle or in brackets, like “Safe Exam Browser (Navegador de Examen Seguro)”.

==Is there a way to check the integrity of all placeholders in a language pack?==
* Not a at the moment. See MDL-51775 .
* You can use [https://lang.moodle.org/mod/forum/discuss.php?d=4661 this trick] to check for integrity:
** Load the language pack in a [https://download.moodle.org/windows/ local instance of Moodle].
** In order to generate a [https://lang.moodle.org/mod/forum/discuss.php?d=4098 translation memory], load the language pack in the [https://docs.moodle.org/29/en/Language_customisation Language customization] tool, so that the texts are loaded in the database.
** Run the sql instance in the file (tm_generator.txt)
** Insert the result of the query in template.tmx file
** The result is a translation memory that can be analysed with [http://www.opentag.com/okapi/wiki/index.php?title=CheckMate Checkmate].
** The problem: probably you will get many errors due to some characters that are not allowed by Checkmate so you will have to remove manually some translation units. After doing it, you will get a report with some possible errors (see the attached image).
** Of course, it would be great to have an integrated quality check system in Moodle. Vote for MDL-51775 .

* The contents of the file tm_generator.txt are ('''change the language from eu to your language'''):
SELECT concat('<tu tuid="',mdl_tool_customlang_components.name,'|',mdl_tool_customlang.stringid,'">
<tuv xml:lang="en"><seg>',mdl_tool_customlang.original,'</seg></tuv>
<tuv xml:lang="',mdl_tool_customlang.lang,'"><seg>',mdl_tool_customlang.master,'</seg></tuv>
</tu>') as txt
FROM mdl_tool_customlang INNER JOIN mdl_tool_customlang_components ON mdl_tool_customlang.componentid = mdl_tool_customlang_components.id
WHERE (((mdl_tool_customlang.lang)="eu") AND ((mdl_tool_customlang.original) Is Not Null) AND ((mdl_tool_customlang.master) <>mdl_tool_customlang.original));
* the contents of the template.tmx file are:
<?xml version="1.0" encoding="UTF-8"?>
<tmx version="1.4"><header creationtool="SQLQuery" creationtoolversion="unknown" segtype="paragraph" o-tmf="unknown" adminlang="en" srclang="en" datatype="unknown"></header><body>
PLACE HERE THE RESULT OF THE SQL QUERY
</body>
</tmx>
==What is a ''translation memory'' and how can I create a translation memory out of a Moodle language pack?==
* Read the 'Is there a way to check the integrity of all placeholders in a language pack?' section above.
* See [https://lang.moodle.org/mod/forum/user.php?id=1489&page=1 this post] and [https://dl.dropboxusercontent.com/u/86242384/moodle/en/publish/moodle_tm/website_index.html this tutorial].
==How can I help with translating Moodle documentation?==
Please see the guide [[Translating Moodle Docs]].
==How can I find out the context of the strings?==
You can find where a language string is located as described in the user docs [[:en:Language_customisation#Finding_the_component_and_string_identifier|Finding the component and string identifier]] and [[:en:Language FAQ|Language FAQ]].

You may wish to use two windows (perhaps using two monitors), with one displaying the page in English and the other displaying the page in your language.

[[File:two windows translation.jpg|Two simultaneous windows in two languages|800px]]

If you think the original English language strings have more than one meaning and you can't guess which one applies, you are welcome to post in the [https://lang.moodle.org/mod/forum/view.php?id=5 AMOS translation forum].
==Is there a list of Moodle error messages which can be translated?==
Error messages are listed in the user docs [[:en:Category:Error|Category:Error]].

==Can the subtitles for Moodle HQ YouTube videos be translated?==
You can contribute translations for Moodle videos used in [[https://moodle.academy/|Moodle Academy]] courses. Enrol in 'Translate Moodle Academy' course in https://moodle.academy/enrol/index.php?id=52

==Can the User Tours from Moodle.net be translated?==
* Yes. See [[Translating User tours from Moodle.net]]
==How can I test my plugins translations of several (different) Moodle branches?==
*Linux
** You can have several Moodle branches in one Ubuntu (or any other Linux distro) machine by following [https://docs.moodle.org/31/en/Step-by-step_Installation_Guide_for_Ubuntu#Hosting_several_Moodle_branches_in_one_Ubuntu_server these steps].

* Windows
** You can have several [https://download.moodle.org/windows/ local Moodle servers] in different folders in a Windows (7,8,10) PC. It is very easy to start one branch server, work on it, stop it and then start a different branch.
{{Note|Some early local Moodle (versions before 3.0) server packages from [https://download.moodle.org/windows/ https://download.moodle.org/windows/] only work in Windows 7, but apparently not in Windows 8 and definitely not in Windows 10, regardless of compatibility settings. For these you would need to install XAMP separately. Moodle 3.0 and newer branches do work under Windows 10.}}
*Mac
**We need to write about this...
==Can I translate a language pack offline / can I use another language then English as source language?==
Yes you can, but it is not recommended because there is a high risk of causing problems (remember - sites update language packs automatically, so your problem spreads quickly over the world).
One problem is that you absolutely have to avoid untranslated strings or strings in the wrong language in the language pack. This should NEVER happen. Another problem is that there is no way to know which strings are already translated. There is also a higher risk for syntax errors. If you have to, you can follow the following procedure:
* download the English language pack (or another one if you want a different source language)
* translate directly in the php file, preferably using something with syntax highlighting (Geany, Gedit, Notepad++ on Windows, ...)
* IMPORTANT: delete all not-translated lines from the file, before uploading - therefore it is probably best to translate line by line and keep the original source files, so you can work with a record of processed line numbers.
* import the files in the translation portal following the manual on https://docs.moodle.org/dev/AMOS_manual#Importing_a_file (IMPORTANT: zip file cannot contain any folders)
==How can I translate H5P content types?==
Use [https://translate-h5p.tk/weblate/projects/h5p/ the Weblate H5P project translation page] or see the h5p.org guide [https://h5p.org/adding-content-type-translation-via-github Adding content type translations via GitHub] and the forum discussion [https://moodle.org/mod/forum/discuss.php?d=414325 Translate H5P items].
==See also==
* [[:en:Language customization|Language customization]] in the user docs for information on how to edit an existing language pack
* [https://lang.moodle.org/mod/forum/discuss.php?d=4098#p4879 Generating a translation memory and running a quality test] forum discussion
* [https://moodle.org/mod/forum/discuss.php?d=347843 translation in context] forum discussion
[[de:Übersetzung FAQ]]
[[category:Language]]

Translation

2022-08-05T09:59:14Z

Koen: Sorry, it's the other way round

{{Translation}}

==So you'd like to help with translating Moodle?==

Great! :-) All translation of Moodle LMS and the plugins happens on our '''[http://lang.moodle.org Moodle translation site]''', so you'll need to start by creating an account there.

Perhaps you've found some words or phrases not yet translated into your language? Or you've spotted a mistake? If so, please see the guide to [[Contributing a translation]].

Note: If you'd like to help translate more than just a few strings, please contact the maintainer of your language pack as listed in the [http://lang.moodle.org/local/amos/credits.php Translation credits] and ask where you can help.

Did you end up here, wanting to translate the [https://moodle.academy Moodle Academy courses], please start at [[Translation Moodle Academy]]

==Wish to take on responsibility for a language pack?==

Please see [[Maintaining a language pack]] and the [[AMOS manual]] for further information about the AMOS translation toolkit.

==Is Moodle not yet translated into your language?==

Please see [[Starting a new language pack]].

==Any questions?==

Please check the [[Translation FAQ]] and join us in the [http://lang.moodle.org/mod/forum/view.php?id=5 Using AMOS forum].

[[fr:Traduction]]
[[de:Übersetzung]]
[[es:Traducción]]
[[category:Language]]

Translation

2022-08-05T09:57:37Z

Koen: reverting my template change - needs further disussion. Added category link in stead.

{{Language}}

==So you'd like to help with translating Moodle?==

Great! :-) All translation of Moodle LMS and the plugins happens on our '''[http://lang.moodle.org Moodle translation site]''', so you'll need to start by creating an account there.

Perhaps you've found some words or phrases not yet translated into your language? Or you've spotted a mistake? If so, please see the guide to [[Contributing a translation]].

Note: If you'd like to help translate more than just a few strings, please contact the maintainer of your language pack as listed in the [http://lang.moodle.org/local/amos/credits.php Translation credits] and ask where you can help.

Did you end up here, wanting to translate the [https://moodle.academy Moodle Academy courses], please start at [[Translation Moodle Academy]]

==Wish to take on responsibility for a language pack?==

Please see [[Maintaining a language pack]] and the [[AMOS manual]] for further information about the AMOS translation toolkit.

==Is Moodle not yet translated into your language?==

Please see [[Starting a new language pack]].

==Any questions?==

Please check the [[Translation FAQ]] and join us in the [http://lang.moodle.org/mod/forum/view.php?id=5 Using AMOS forum].

[[fr:Traduction]]
[[de:Übersetzung]]
[[es:Traducción]]
[[category:Translation]]

Translation

2022-08-05T09:42:16Z

Koen: adding translation category

{{Language}}
{{Translation}}
==So you'd like to help with translating Moodle?==

Great! :-) All translation of Moodle LMS and the plugins happens on our '''[http://lang.moodle.org Moodle translation site]''', so you'll need to start by creating an account there.

Perhaps you've found some words or phrases not yet translated into your language? Or you've spotted a mistake? If so, please see the guide to [[Contributing a translation]].

Note: If you'd like to help translate more than just a few strings, please contact the maintainer of your language pack as listed in the [http://lang.moodle.org/local/amos/credits.php Translation credits] and ask where you can help.

Did you end up here, wanting to translate the [https://moodle.academy Moodle Academy courses], please start at [[Translation Moodle Academy]]

==Wish to take on responsibility for a language pack?==

Please see [[Maintaining a language pack]] and the [[AMOS manual]] for further information about the AMOS translation toolkit.

==Is Moodle not yet translated into your language?==

Please see [[Starting a new language pack]].

==Any questions?==

Please check the [[Translation FAQ]] and join us in the [http://lang.moodle.org/mod/forum/view.php?id=5 Using AMOS forum].

[[fr:Traduction]]
[[de:Übersetzung]]
[[es:Traducción]]

Translation FAQ

2022-08-05T09:41:33Z

Koen: adding translation category

{{Language}}
{{Translation}}
==How can I help with translating Moodle?==
Please see the guide [[Contributing a translation]].
==I've found an error in a language pack. What do I do?==
* You are welcome to [[Contributing a translation|contribute a fix]] for the error. Alternatively you can contact the language pack maintainer as listed in the [http://lang.moodle.org/local/amos/credits.php Translation credits].
* English language string typo fixes and suggested improvements can be [[Improving English language strings|contributed to the English (fixes) (en_fix) language pack]].
==The month names and days are displayed in English. How can I translate them?==
This is neither Moodle bug nor a missing translation. Names of days and months are pulled out of your operating system. Your server, where the Moodle is running, does not seem to have the specific [https://en.wikipedia.org/wiki/Locale_(computer_software) locale] installed. You need to contact the server administrator and ask them to install the needed locale. See [[Table of locales]] for details.

The particular locale to use for the given language is configured in the langconfig.php file in strings ''locale'' (for Unix like operating systems) and ''localewin'' (for Windows operating systems).

On Ubuntu/Debian, the package <tt>locale-all</tt> can be installed to support all existing languages.

Mac OS is known to have a very limited support for locales. This can not be fixed.
==Why are log descriptions displayed in English?==
In log reports, descriptions are intended to be displayed in English only; it is not possible to translate them. For example "The user with id '2' viewed the course with id '4'."
==I'm starting a new language pack or I'm contributing to one. Can I do the user interface strings first?==
No, there is no way to know which strings will be shown for users and which not. But to help you a little bit, there are some unofficial priorities you can take into account.

First:
* make sure [[Translation_langconfig|langconfig]] is properly set up.
* take a look at [[Translation priority]]. All files have a rating according to how urgent they need translating.
* less urgent are also the contributed plugins, since they are not part of a standard Moodle distribution. There is a list of [https://moodle.org/plugins/stats.php the 20 top plugins downloads for Moodle] which might be worth considering for translation priority.
==How many words are there in the English language pack?==
See the discussion [http://lang.moodle.org/mod/forum/discuss.php?d=3651 How many words are there in the English language pack?].
==Moodle languages with several available language packs==
===Are there translations for the American (and other branches of the) English language?===
The [http://lang.moodle.org/mod/forum/discuss.php?d=2617 "official"] language for Moodle is actually Australian English (''G'day mate!'') , which is almost 100% the same as UK English. [http://english.stackexchange.com/questions/74737/what-is-the-origin-of-the-phrase-two-nations-divided-by-a-common-language Someone] once said "America and England are two nations divided by a common language".
* The English - United States (en_us)] language pack mostly contains different spellings (color ''versus'' colour, enroll ''versus'' enrol etc).
* The English - Pirate (en_ar)] language pack is used in the '[https://moodle.org/mod/forum/discuss.php?d=132888 Talk Like a Pirate]' day.
* The English - United States K12 (en_us_k12) language pack is used in the [https://en.wikipedia.org/wiki/K%E2%80%9312 K-12] (kindergarten to grade 12) primary and secondary education in the USA, Canada, and other English speaking countries. It includes spellings from the en_us language pack and the term "course" is renamed as "class".
* The English for kids (en_kids) language pack seems to be a simplified version of the most common English strings seen by Moodle users, considered easier/suitable for small children.
* The English (fixes) (en_fix) language pack is used to suggest Moodle core language strings improvements and typo fixes, as described in the guide [[Improving English language strings]].
===Why does Moodle have four different language packs for the German language?===
* In Germany we have a formal language where people are talking with „Sie“ to each other. This is the language of the formal adults. I think it’s something like using „Sir“ in english language. The normal German language pack is using this formal language. Nearly all strings in the Moodle language pack and in the translated plugins are translated in the formal language.

* You can’t use these formal words in school … there you are using an informal language with „du“. Students are talking to each other like friends. Therefor we made the language pack „German personal“ (de_du). It come with the personal words „du“, „dein“, „dir“ and so on where the formal words are „Sie“, „Ihre“, „Ihnen“ (yes, these words are written with an uppercase letter).

* For my (Ralf Krause) personal use I take „German personal" (de_du) or „German Kids“ (de_kids). „German Kids“ uses the personal words „du“, „dein“ and „dir“ but it also uses an easier to understand language.

* Some time ago we tried to make Moodle as a platform for social communication but nobody wanted to use it. Therefore we made "German community“. In a social platform, nobody would talk about teachers or students or participants or classrooms or courses … in a social platform, you would use members of a group and meetings. I don’t know if this pack will be used in future.
===Why does Moodle have several different language packs for the Spanish language?===
* Spain and many South American countries use a (comma) [[Decimal separator]] that is different from the (decimal point) used in Mexico and Central America.
** Moodle core in English uses by default a decimal point for calculations, and Moodle Docs do too.
** This caused many problems in the [[Gradebook]] calculations and with the [https://docs.moodle.org/all/es/P%C3%A1gina_Principal Spanish Moodle Docs].
* Just as "America and England are two nations divided by a common language", so are Spain and Mexico. See [https://docs.moodle.org/all/es/Espa%C3%B1ol_de_M%C3%A9xico the Mexican Spanish documentation page] in Spanish.
* The Venezuelan Spanish (es_ve) is a very small child language of the international Spanish language.
* The Colombian Spanish (es_co) is a very small child language of the international Spanish language.
* The Mexican Spanish (es_mx) is a very modern, comprehensive, independent, language pack, specially made for Mexican Moodlers.
* The Mexican Spanish for kids (es_mx_kids) is a simplified version of the most common Mexican Spanish strings seen by Moodle users, considered easier/suitable for small children.
* You can read about [https://docs.moodle.org/all/es/Espa%C3%B1ol_internacional#Idiomas_hijos_que_depend.C3.ADan_del_Espa.C3.B1ol_internacional two (now defunct) other Spanish child languages].

===Why do other languages have child languages?===
* Languages with ''-kids'' in their code names are all child languages with a simplified version of common language strings aimed at small children.
* If you have the time, it is probably a good idea to have one such child language for kids for your main language pack.
* Current (mid 2022) languages for kids are:
** Deutsch (kids)
** English (kids)
** Español de México para niños (Mexican Spanish for kids)
** Ελληνικά για παιδιά (Greek for kids)
** עברית בתי־ספר (Hebrew for kids)
** हिंदी (Hindi for kids)
** Japanese (kids)
** Deutsch - Kids

* Norwegian (Primary) language pack is aimed at primary education.

* Finnish for companies is aimed at companies.

* Languages ending in "_wp" are supplementary languages for [https://docs.moodle.org/37/en/Moodle_Workplace Moodle Workplace]. They are maintained by the companies offering [https://docs.moodle.org/37/en/Moodle_Workplace Moodle Workplace].
==Are there items which are NOT to be translated?==
===Moodle variables enclosed within {curly brackets}===
The following words, when enclosed within {curly brackets}, are placeholders for Moodle names of variables. They should not be translated, but must remain as they are within the curly brackets:
firstname, lastname, username, email, city, country, lang, timezone, mailformat, maildisplay, maildigest, htmleditor, ajax, autosubscribe , institution, department, idnumber, skype , msn, aim, yahoo, icq, phone1, phone2, address, url, description, descriptionformat, password, auth, oldusername , deleted, suspended, course1, course2, course3, course4
They must also be written exactly like this in all translations of the documentation pages (such as this page.) However, the translator might like to include a translation enclosed in brackets. For example, in the Spanish documentation pages you might find: password (''contraseña'').

The fact is: '''no placeholders can be translated in AMOS'''. There is no official list of "reserved" $a properties. Whatever xyz is put in {$a->xyz}, it must be kept as it is in AMOS.

Example:

[[Image: 26 AMOS fullnamedisplay_core original.png]]

'''Must''' be (in this case, when translated into Mexican Spanish):

[[File:26 AMOS fullnamedisplay_core.png]]

unless your language uses lastname before the firstname, as Japanese does, which translates to:

[[File:26 AMOS fullnamedisplay_core Japanese.png]]

===Placeholders enclosed within % characters (%example%) must not be translated===
The [https://moodle.org/plugins/local_moodlecloudsignup Moodle Cloud Signup and Portal strings] local plugin is used for accessing the [https://moodle.com/cloud/ MoodleCloud] and it includes several strings that have some words surrounded by % characters (eg, %date%). These words must not be translated, they must be copied exactly into the language pack translation, but the rest of the string might or might not be translated.
* Example of one string that can not be translated and must be copied exactly:
[[File:AMOS placeholders with percentace character.png|600px]]
* Example of one string with one placeholder (highlighted) and some regular text that can be easily translated:
[[File:AMOS text with placeholders with percentace character.png|600px]]
===Placeholders in H5P prefixed with % or : characters must not be translated===
The [http://h5p.org/ H5P editor] integrated with Moodle since 3.9 has some variables prefixed with "%" or ":" that must not be translated because they are transformed internally with the correct value. They should be treated as the Moodle curly brackets variables.
* Example of variables with "%" that can not be translated and must be copied exactly:
"Parameters contain %used while only %supported or earlier are supported."

In that case, %used and %supported must not be translated. So, for instance, the Spanish translation would be something like:
"Parámetros contiene %used mientras que sólo se soportan %supported o anterior."
* Example of variables with ":" that can not be translated and must be copied exactly:
"The :property value exceeds the maximum of :max."

In that case, :property and :max must not be translated. The Spanish translation for this string would be something like:
"El valor de :property excede el máximo de :max."
=== All fieldnames must be kept in English===
* These names are hooks that are used in the software. You should not translate them.
* See the example below for the string uploadcourses_help in the file tool_uploadcourse for Moodle 3.1:
[[File:Fieldnames are not to be translatd.png]]
* Notice that the string text indicates (red rectangle) that these words (enclosed in green rectangles) are fieldnames. Also notice that the Spanish translation clearly indicates, at the final part of the paragraph ''(así escritos, en inglés)'' that these fieldnames must be written in English as they are written here.
* Some used fieldnames in Moodle are:
category, category_id, category_idnumber, category_path, context, course, description, descriptionformat, email, enrolmentkey, firstname, fullname, groupname, hidepicture, idnumber, intro, lastname, maxgrade, maxrequest, name, password, picture, section, shortname, teachers, timeopen, timeclose, timeend, timestart, username, visible,
* Examples of strings where these fielnames appear are uploadcohorts_help | core_cohort, importgroups_help | core_group, uploadcourses_help | tool_uploadcourse and uploadusers_help | tool_uploaduser.
* Note that these fieldnames may appear as real fieldnames (must not be translated) or as regular words in another context (can and must be translated). You should exercise caution and, If possible, always check that Moodle works correctly by testing your translations with some data in a real or test server.
===Local addresses after <a href="../===
Addresses inside a Language string that have <a href="../ reference a specific URL inside your Moodle server and you must keep the address part of the expression, but you can translate the descriptive name part. See the following example:
noassignableroles | tool_cohortautoroles
There are currently no roles that can be assigned in the user context. <a href="../../roles/manage.php">Manage roles</a>
* You must keep the <a href="../../roles/manage.php"> part, as this references to the [https://docs.moodle.org/31/en/PHP PHP] code in your Moodle server that will be executed in order to manage roles
* You can/should/must translate 'Manage roles'
* Do not forget to keep the ending </a>
===Moodle Docs addresses after <syntaxhighlight lang="php"><nowiki><a href="http://docs.moodle.org/en/</nowiki></syntaxhighlight>===
Addresses inside a Language string that have <syntaxhighlight lang="php"><nowiki><a href="http://docs.moodle.org/en/ </nowiki></syntaxhighlight>reference a specific URL in the Moodle English Documentation. You must look at that address and '''only''' if your language has a valid translation for that page, you can/should replace the original English Docs address with your own language address. See the following example:
core backup | nonisowarning
Warning: this backup is from a non-Unicode version of Moodle (pre 1.6). If this backup contains any non-ISO-8859-1 texts then they may be CORRUPTED if you try to restore them to this Unicode version of Moodle. See the <a href="http://docs.moodle.org/en/Backup_FAQ">Backup FAQ</a> for more information about how to recover this backup correctly.
* There are six different language translations for that page. So, you can only replace this address if your language is one of these.
===Other internet addresses after <a href="http://===
* You must proceed as with Moodle Docs addresses:
* Example:
auth_radius | auth_radiusdescription
This method uses a <a href="http://en.wikipedia.org/wiki/RADIUS">RADIUS</a> server to check whether a given username and password is valid.
* You must check the (English language wikipedia) page about the RADIUS server, and then you can decide whether to keep this address or replace it with your own language matching wikipedia translation.
===HTML codes that must not be translated===
The following HTML codes are reserved words that must not be translated. However, it is important for the translators to understand their meaning in order to decide whether to keep them in the translation and if so, whether they can be rearranged.
* <syntaxhighlight lang="php">&nbsp</syntaxhighlight> - non-breaking space i.e. a space but there will never be a line-break inserted instead of this space at the end of a line.
* <syntaxhighlight lang="php">&ensp</syntaxhighlight> and <syntaxhighlight lang="php">&emsp</syntaxhighlight> - denote an en space and an em space respectively, where an en space is half the point size and an em space is equal to the point size of the current font. For fixed pitch fonts, the user agent can treat the en space as being equivalent to a single space character, and the em space as being equuivalent to two space characters.
* <syntaxhighlight lang="php">&amp</syntaxhighlight> - ampersand sign (&)
* <syntaxhighlight lang="php">&apos</syntaxhighlight> - apostrophe sign (')
* <syntaxhighlight lang="php">&copy</syntaxhighlight> - copyright sign (©)
* <syntaxhighlight lang="php">&plusmn</syntaxhighlight> - "plus or minus" sign (±)
* <syntaxhighlight lang="php">&times</syntaxhighlight> - multiply sign (*)
* <syntaxhighlight lang="php">&divide</syntaxhighlight> - divide sign (/)
* <syntaxhighlight lang="php">&gt</syntaxhighlight> - "greater than" sign ( > )
* <syntaxhighlight lang="php">&lt</syntaxhighlight> - "less than" sign (<)
* <syntaxhighlight lang="php">&laquo</syntaxhighlight> - quotation mark (‘)
* <syntaxhighlight lang="php">&lsquo</syntaxhighlight> - left single quotation sign (‘)
* <syntaxhighlight lang="php">&rsquo</syntaxhighlight> - right single quotation sign (’)
* <syntaxhighlight lang="php">&ouml</syntaxhighlight> - small letter o with diaeresis (ö)
* <syntaxhighlight lang="php">&mdash</syntaxhighlight> - [https://en.wikipedia.org/wiki/Dash#Em_dash em dash] sign (—)
===Calculation functions must not be translated===
[https://docs.moodle.org/32/en/Grade_calculations#Calculation_functions Calculation functions] start with an equal sign (=). Following is an expression using operators and functions supported by the system.
[[File:DO NOT translate calculation functions.png]]
===The 'thisdirection' and 'thisdirectionvertical' strings in core_langconfig should never be translated===
'''The 'thisdirection' and 'thisdirectionvertical' strings in core_langconfig should never be translated, as they are not variables meant to be translated. They are prefixing selectors used by the themes to display left-to-right or right-to-left languages. Read [https://moodle.org/mod/forum/discuss.php?d=328567#p1323101 more about problems with these variables].
===MoodleBox===
The word 'MoodleBox' must be kept in all languages.
===Safe Exam Browser===
A feedback by the Safe Exam Browser main developer:
The software is called “Safe Exam Browser” in any language, we don’t translate the name of the application. So it doesn’t make sense to translate it in any plugin, you could use it as a subtitle or in brackets, like “Safe Exam Browser (Navegador de Examen Seguro)”.

==Is there a way to check the integrity of all placeholders in a language pack?==
* Not a at the moment. See MDL-51775 .
* You can use [https://lang.moodle.org/mod/forum/discuss.php?d=4661 this trick] to check for integrity:
** Load the language pack in a [https://download.moodle.org/windows/ local instance of Moodle].
** In order to generate a [https://lang.moodle.org/mod/forum/discuss.php?d=4098 translation memory], load the language pack in the [https://docs.moodle.org/29/en/Language_customisation Language customization] tool, so that the texts are loaded in the database.
** Run the sql instance in the file (tm_generator.txt)
** Insert the result of the query in template.tmx file
** The result is a translation memory that can be analysed with [http://www.opentag.com/okapi/wiki/index.php?title=CheckMate Checkmate].
** The problem: probably you will get many errors due to some characters that are not allowed by Checkmate so you will have to remove manually some translation units. After doing it, you will get a report with some possible errors (see the attached image).
** Of course, it would be great to have an integrated quality check system in Moodle. Vote for MDL-51775 .

* The contents of the file tm_generator.txt are ('''change the language from eu to your language'''):
SELECT concat('<tu tuid="',mdl_tool_customlang_components.name,'|',mdl_tool_customlang.stringid,'">
<tuv xml:lang="en"><seg>',mdl_tool_customlang.original,'</seg></tuv>
<tuv xml:lang="',mdl_tool_customlang.lang,'"><seg>',mdl_tool_customlang.master,'</seg></tuv>
</tu>') as txt
FROM mdl_tool_customlang INNER JOIN mdl_tool_customlang_components ON mdl_tool_customlang.componentid = mdl_tool_customlang_components.id
WHERE (((mdl_tool_customlang.lang)="eu") AND ((mdl_tool_customlang.original) Is Not Null) AND ((mdl_tool_customlang.master) <>mdl_tool_customlang.original));
* the contents of the template.tmx file are:
<?xml version="1.0" encoding="UTF-8"?>
<tmx version="1.4"><header creationtool="SQLQuery" creationtoolversion="unknown" segtype="paragraph" o-tmf="unknown" adminlang="en" srclang="en" datatype="unknown"></header><body>
PLACE HERE THE RESULT OF THE SQL QUERY
</body>
</tmx>
==What is a ''translation memory'' and how can I create a translation memory out of a Moodle language pack?==
* Read the 'Is there a way to check the integrity of all placeholders in a language pack?' section above.
* See [https://lang.moodle.org/mod/forum/user.php?id=1489&page=1 this post] and [https://dl.dropboxusercontent.com/u/86242384/moodle/en/publish/moodle_tm/website_index.html this tutorial].
==How can I help with translating Moodle documentation?==
Please see the guide [[Translating Moodle Docs]].
==How can I find out the context of the strings?==
You can find where a language string is located as described in the user docs [[:en:Language_customisation#Finding_the_component_and_string_identifier|Finding the component and string identifier]] and [[:en:Language FAQ|Language FAQ]].

You may wish to use two windows (perhaps using two monitors), with one displaying the page in English and the other displaying the page in your language.

[[File:two windows translation.jpg|Two simultaneous windows in two languages|800px]]

If you think the original English language strings have more than one meaning and you can't guess which one applies, you are welcome to post in the [https://lang.moodle.org/mod/forum/view.php?id=5 AMOS translation forum].
==Is there a list of Moodle error messages which can be translated?==
Error messages are listed in the user docs [[:en:Category:Error|Category:Error]].

==Can the subtitles for Moodle HQ YouTube videos be translated?==
You can contribute translations for Moodle videos used in [[https://moodle.academy/|Moodle Academy]] courses. Enrol in 'Translate Moodle Academy' course in https://moodle.academy/enrol/index.php?id=52

==Can the User Tours from Moodle.net be translated?==
* Yes. See [[Translating User tours from Moodle.net]]
==How can I test my plugins translations of several (different) Moodle branches?==
*Linux
** You can have several Moodle branches in one Ubuntu (or any other Linux distro) machine by following [https://docs.moodle.org/31/en/Step-by-step_Installation_Guide_for_Ubuntu#Hosting_several_Moodle_branches_in_one_Ubuntu_server these steps].

* Windows
** You can have several [https://download.moodle.org/windows/ local Moodle servers] in different folders in a Windows (7,8,10) PC. It is very easy to start one branch server, work on it, stop it and then start a different branch.
{{Note|Some early local Moodle (versions before 3.0) server packages from [https://download.moodle.org/windows/ https://download.moodle.org/windows/] only work in Windows 7, but apparently not in Windows 8 and definitely not in Windows 10, regardless of compatibility settings. For these you would need to install XAMP separately. Moodle 3.0 and newer branches do work under Windows 10.}}
*Mac
**We need to write about this...
==Can I translate a language pack offline / can I use another language then English as source language?==
Yes you can, but it is not recommended because there is a high risk of causing problems (remember - sites update language packs automatically, so your problem spreads quickly over the world).
One problem is that you absolutely have to avoid untranslated strings or strings in the wrong language in the language pack. This should NEVER happen. Another problem is that there is no way to know which strings are already translated. There is also a higher risk for syntax errors. If you have to, you can follow the following procedure:
* download the English language pack (or another one if you want a different source language)
* translate directly in the php file, preferably using something with syntax highlighting (Geany, Gedit, Notepad++ on Windows, ...)
* IMPORTANT: delete all not-translated lines from the file, before uploading - therefore it is probably best to translate line by line and keep the original source files, so you can work with a record of processed line numbers.
* import the files in the translation portal following the manual on https://docs.moodle.org/dev/AMOS_manual#Importing_a_file (IMPORTANT: zip file cannot contain any folders)
==How can I translate H5P content types?==
Use [https://translate-h5p.tk/weblate/projects/h5p/ the Weblate H5P project translation page] or see the h5p.org guide [https://h5p.org/adding-content-type-translation-via-github Adding content type translations via GitHub] and the forum discussion [https://moodle.org/mod/forum/discuss.php?d=414325 Translate H5P items].
==See also==
* [[:en:Language customization|Language customization]] in the user docs for information on how to edit an existing language pack
* [https://lang.moodle.org/mod/forum/discuss.php?d=4098#p4879 Generating a translation memory and running a quality test] forum discussion
* [https://moodle.org/mod/forum/discuss.php?d=347843 translation in context] forum discussion
[[de:Übersetzung FAQ]]

Translation

2022-08-05T09:39:54Z

Koen: Creating a landing page for translation of Moodle academy

{{Language}}
==So you'd like to help with translating Moodle?==

Great! :-) All translation of Moodle LMS and the plugins happens on our '''[http://lang.moodle.org Moodle translation site]''', so you'll need to start by creating an account there.

Perhaps you've found some words or phrases not yet translated into your language? Or you've spotted a mistake? If so, please see the guide to [[Contributing a translation]].

Note: If you'd like to help translate more than just a few strings, please contact the maintainer of your language pack as listed in the [http://lang.moodle.org/local/amos/credits.php Translation credits] and ask where you can help.

Did you end up here, wanting to translate the [https://moodle.academy Moodle Academy courses], please start at [[Translation Moodle Academy]]

==Wish to take on responsibility for a language pack?==

Please see [[Maintaining a language pack]] and the [[AMOS manual]] for further information about the AMOS translation toolkit.

==Is Moodle not yet translated into your language?==

Please see [[Starting a new language pack]].

==Any questions?==

Please check the [[Translation FAQ]] and join us in the [http://lang.moodle.org/mod/forum/view.php?id=5 Using AMOS forum].

[[fr:Traduction]]
[[de:Übersetzung]]
[[es:Traducción]]

Translation

2022-08-05T09:39:03Z

Koen: /* So you'd like to help with translating Moodle? */

{{Language}}
==So you'd like to help with translating Moodle?==

Great! :-) All translation of Moodle LMS and the plugins happens on our '''[http://lang.moodle.org Moodle translation site]''', so you'll need to start by creating an account there.

Perhaps you've found some words or phrases not yet translated into your language? Or you've spotted a mistake? If so, please see the guide to [[Contributing a translation]].

Note: If you'd like to help translate more than just a few strings, please contact the maintainer of your language pack as listed in the [http://lang.moodle.org/local/amos/credits.php Translation credits] and ask where you can help.

Did you end up here, wanting to translate the [https://moodle.academy Moodle Academy courses], please start at [Translation Moodle Academy]

==Wish to take on responsibility for a language pack?==

Please see [[Maintaining a language pack]] and the [[AMOS manual]] for further information about the AMOS translation toolkit.

==Is Moodle not yet translated into your language?==

Please see [[Starting a new language pack]].

==Any questions?==

Please check the [[Translation FAQ]] and join us in the [http://lang.moodle.org/mod/forum/view.php?id=5 Using AMOS forum].

[[fr:Traduction]]
[[de:Übersetzung]]
[[es:Traducción]]

Decimal separator

2022-08-05T08:31:25Z

Koen: /* Using English language pack with a decimal comma */ updating outdated links

{{Translation}}
The langconfig file is an important file in a language pack, dealing with all the configuration parameters of that language, including the decimal separator.

The original Moodle code in English uses a [https://en.wikipedia.org/wiki/Decimal_mark decimal point as a separator], but some countries (and their language packs) might use a decimal comma.

==Countries where a dot "." is used as decimal mark:==
* Australia
* Bangladesh
* Botswana
* British West Indies
* Brunei
* Canada (when using English)
* China, People's Republic of
* Dominican Republic
* Egypt
* Ghana
* Guatemala
* Honduras
* Hong Kong
* India
* Ireland
* Israel
* Japan
* Jordan
* Kenya
* Korea (both North and South)
* Lebanon
* Luxembourg (uses both marks officially)
* Macau (in Chinese and English text)
* Malaysia
* Malta
* Mexico
* Mongolia
* Nepal
* New Zealand
* Nicaragua
* Nigeria
* Pakistan
* Palestine
* Panama
* Philippines
* Singapore
* Sri Lanka
* Switzerland
* Taiwan
* Tanzania
* Thailand
* Uganda
* United Kingdom
* United States (including insular areas)
* Zimbabwe

==Countries where a comma "," is used as decimal mark:==
* Albania
* Algeria
* Andorra
* Angola
* Argentina
* Armenia
* Austria
* Azerbaijan
* Belarus
* Belgium
* Bolivia
* Bosnia and Herzegovina
* Brazil
* Bulgaria
* Cameroon
* Canada (when using French)
* Chile
* Colombia
* Costa Rica
* Croatia (comma used officially, but both forms are in use)
* Cuba
* Cyprus
* Czech Republic
* Denmark
* East Timor
* Ecuador
* Estonia
* Faroes
* Finland
* France
* Germany
* Georgia
* Greece
* Greenland
* Hungary
* Iceland
* Indonesia
* Italy
* Kazakhstan
* Kosovo
* Kyrgyzstan
* Latvia
* Lebanon
* Lithuania
* Luxembourg (uses both marks officially)
* Macau (in Portuguese text)
* Macedonia
* Moldova
* Mongolia
* Morocco
* Mozambique
* Namibia
* The Netherlands
* Norway
* Paraguay
* Peru
* Poland
* Portugal
* Romania
* Russia
* Serbia
* Slovakia
* Slovenia
* South Africa
* Spain
* Switzerland
* Sweden
* Tunisia
* Turkey
* Ukraine
* Uruguay
* Uzbekistan
* Venezuela
* Vietnam

===Problems with language packs using a decimal comma===
If a language pack uses a comma (,) as a decimal separator, it '''must''' use a semicolon (;) as a [https://docs.moodle.org/dev/Translation_langconfig#listsep.2Ccore_langconfig list separator], or serious errors might happen.

* See all the reported issues (fixed and not-fixed) at [https://tracker.moodle.org/browse/MDL-28238?jql=text%20~%20%22decimal%20comma%22 the Moodle Tracker]

* It is not uncommon for Moodle users with a language pack that has a comma used as a decimal separator to experience problems when using formulas copied from the Moodle English online and built-in documentation.

====Gradebook problems====
The [https://docs.moodle.org/en/Grader_report Gradebook] calculations might use "=average(item1, item2, item3, item4, item5, item6)" which is easy to understand and use in English, but a teacher with (for example) the international spanish (es) language pack will strugle until he/she realizes that this formula should be changed to "=average(item1; item2; item3; item4; item5; item6)"

====Cloze questions problems====
Cloze marks a correct numeric answer as a wrong one while using a comma as a decimal separator. See MDL-33744

====Pmatch and other Open University question types problems=====
[https://docs.moodle.org/31/en/Pattern-match_question_type Pmatch] (and other question types made by the Open University) was created for use in an English university. Therefore, all the special code for handing numbers just assumes the decimal separator is a full stop. See [https://moodle.org/mod/forum/discuss.php?d=340313 this forum thread]. The suggested fix is to only use a full stop as a decimal separator.

====Quiz problems====
As reported in [https://moodle.org/mod/forum/discuss.php?d=312003 this forum thread], there are no hints on interactive with multiple tries quiz when using comma on some languages that use a comma as decimal marker in the answer (as opposed to a full stop). The quiz does not show hints (using interactive with multiple attempts). The quiz instead regards the use of the comma as "incomplete" even though it will mark this answer as correct or incorrect on deferred feedback. The suggested fix is to never use a decimal comma as a thousand separator.

==Problem fixing==
A Moodle adminer who uses a language pack with a decimal comma must check the [https://docs.moodle.org/dev/Translation_langconfig langconfig file] and make sure that the decsep, listsep and thousandssep characters are properly set for the language or use the [https://docs.moodle.org/en/Language_customisationLanguage customization] to fix his/her server.

==Using English language pack with a decimal comma==
* If you want English text, but with non-english decimal separator, the way to achieve this is to make a new language pack en_commadecimal, or something like that.
* You should only need to create the langconfig.php part of the language pack, to say that the parent language is English, and what the decimal and thousands separators are.
* See https://docs.moodle.org/en/Starting_a_new_language_pack and https://docs.moodle.org/en/Language_packs
* See [https://moodle.org/mod/forum/discuss.php?d=342323 this forum thread]

[[es:Separador decimal]]

Decimal separator

2022-08-05T08:29:55Z

Koen: This is important information for translators

{{Translation}}
The langconfig file is an important file in a language pack, dealing with all the configuration parameters of that language, including the decimal separator.

The original Moodle code in English uses a [https://en.wikipedia.org/wiki/Decimal_mark decimal point as a separator], but some countries (and their language packs) might use a decimal comma.

==Countries where a dot "." is used as decimal mark:==
* Australia
* Bangladesh
* Botswana
* British West Indies
* Brunei
* Canada (when using English)
* China, People's Republic of
* Dominican Republic
* Egypt
* Ghana
* Guatemala
* Honduras
* Hong Kong
* India
* Ireland
* Israel
* Japan
* Jordan
* Kenya
* Korea (both North and South)
* Lebanon
* Luxembourg (uses both marks officially)
* Macau (in Chinese and English text)
* Malaysia
* Malta
* Mexico
* Mongolia
* Nepal
* New Zealand
* Nicaragua
* Nigeria
* Pakistan
* Palestine
* Panama
* Philippines
* Singapore
* Sri Lanka
* Switzerland
* Taiwan
* Tanzania
* Thailand
* Uganda
* United Kingdom
* United States (including insular areas)
* Zimbabwe

==Countries where a comma "," is used as decimal mark:==
* Albania
* Algeria
* Andorra
* Angola
* Argentina
* Armenia
* Austria
* Azerbaijan
* Belarus
* Belgium
* Bolivia
* Bosnia and Herzegovina
* Brazil
* Bulgaria
* Cameroon
* Canada (when using French)
* Chile
* Colombia
* Costa Rica
* Croatia (comma used officially, but both forms are in use)
* Cuba
* Cyprus
* Czech Republic
* Denmark
* East Timor
* Ecuador
* Estonia
* Faroes
* Finland
* France
* Germany
* Georgia
* Greece
* Greenland
* Hungary
* Iceland
* Indonesia
* Italy
* Kazakhstan
* Kosovo
* Kyrgyzstan
* Latvia
* Lebanon
* Lithuania
* Luxembourg (uses both marks officially)
* Macau (in Portuguese text)
* Macedonia
* Moldova
* Mongolia
* Morocco
* Mozambique
* Namibia
* The Netherlands
* Norway
* Paraguay
* Peru
* Poland
* Portugal
* Romania
* Russia
* Serbia
* Slovakia
* Slovenia
* South Africa
* Spain
* Switzerland
* Sweden
* Tunisia
* Turkey
* Ukraine
* Uruguay
* Uzbekistan
* Venezuela
* Vietnam

===Problems with language packs using a decimal comma===
If a language pack uses a comma (,) as a decimal separator, it '''must''' use a semicolon (;) as a [https://docs.moodle.org/dev/Translation_langconfig#listsep.2Ccore_langconfig list separator], or serious errors might happen.

* See all the reported issues (fixed and not-fixed) at [https://tracker.moodle.org/browse/MDL-28238?jql=text%20~%20%22decimal%20comma%22 the Moodle Tracker]

* It is not uncommon for Moodle users with a language pack that has a comma used as a decimal separator to experience problems when using formulas copied from the Moodle English online and built-in documentation.

====Gradebook problems====
The [https://docs.moodle.org/en/Grader_report Gradebook] calculations might use "=average(item1, item2, item3, item4, item5, item6)" which is easy to understand and use in English, but a teacher with (for example) the international spanish (es) language pack will strugle until he/she realizes that this formula should be changed to "=average(item1; item2; item3; item4; item5; item6)"

====Cloze questions problems====
Cloze marks a correct numeric answer as a wrong one while using a comma as a decimal separator. See MDL-33744

====Pmatch and other Open University question types problems=====
[https://docs.moodle.org/31/en/Pattern-match_question_type Pmatch] (and other question types made by the Open University) was created for use in an English university. Therefore, all the special code for handing numbers just assumes the decimal separator is a full stop. See [https://moodle.org/mod/forum/discuss.php?d=340313 this forum thread]. The suggested fix is to only use a full stop as a decimal separator.

====Quiz problems====
As reported in [https://moodle.org/mod/forum/discuss.php?d=312003 this forum thread], there are no hints on interactive with multiple tries quiz when using comma on some languages that use a comma as decimal marker in the answer (as opposed to a full stop). The quiz does not show hints (using interactive with multiple attempts). The quiz instead regards the use of the comma as "incomplete" even though it will mark this answer as correct or incorrect on deferred feedback. The suggested fix is to never use a decimal comma as a thousand separator.

==Problem fixing==
A Moodle adminer who uses a language pack with a decimal comma must check the [https://docs.moodle.org/dev/Translation_langconfig langconfig file] and make sure that the decsep, listsep and thousandssep characters are properly set for the language or use the [https://docs.moodle.org/en/Language_customisationLanguage customization] to fix his/her server.

==Using English language pack with a decimal comma==
* If you want English text, but with non-english decimal separator, the way to achieve this is to make a new language pack en_commadecimal, or something like that.
* You should only need to create the langconfig.php part of the language pack, to say that the parent language is English, and what the decimal and thousands separators are.
* See https://docs.moodle.org/dev/Starting_a_new_language_pack and https://docs.moodle.org/31/en/Language_packs
* See [https://moodle.org/mod/forum/discuss.php?d=342323 this forum thread]

[[es:Separador decimal]]

Category:Translation

2022-08-05T08:27:55Z

Koen: Creating page

These pages contain important information for users who want to translate the Moodle software in their own language.

AMOS

2022-08-05T08:16:18Z

Koen: wrong redirct

#REDIRECT [[AMOS_manual]]

mod/diary/report

2022-01-17T11:12:31Z

Koen: Redirected page to Diary

#REDIRECT [[Diary]]

mod/diary/mod

2022-01-17T11:10:36Z

Koen: Redirected page to Diary

#REDIRECT [[Diary]]

mod/diary/view

2022-01-17T11:10:05Z

Koen: Redirected page to Diary

#REDIRECT [[Diary]]

mod/diary/reportsingle

2022-01-17T11:08:08Z

Koen: Redirected page to Diary

#REDIRECT [[Diary]]

Talk:Standards

2021-09-15T07:15:38Z

Koen:

This page is in need of an update, as it does not mention LTI Advantage certification, LTI 2.0 (declared deprecated when 1.3 / Advantage was released).

Also, more clarity on the nature of the supported open standards is welcome.
<hr>
Ical for importing / exporting calendar events is also missing
For authentication, enrolment etc it might be better to explicitly point to the documentation, since there are a lot of standards supported. Now it looks like it's only LDAP.
--[[User:koen roggemans|koen roggemans]] ([[User talk:koen roggemans|talk]]) 07:15, 15 September 2021 (UTC)

Language packs

2021-08-12T07:56:24Z

Koen: /* Parent language packs and child language packs */ removing inaccurate list and replace the list with a reference to the automatically up to date information.

{{Language}}
==Language pack installation and uninstallation==
[[File:installing a lang pack.png|thumb|Installing a language pack]]
Over 100 language packs are available for an administrator to install on your Moodle site in 'Language packs' in the Site administration. Simply select the languages you require from the list of available language packs and click on the "Install selected language pack" button.

'''New in 3.11:''' A new search box allows administrators to quickly locate a language pack for installation.

Multiple language packs may be selected for install by holding down the Apple or Ctrl key whilst clicking on the language packs.

Installing many (20+) language packs has [https://moodle.org/mod/forum/discuss.php?d=241098 almost 0 impact] on Moodle performance.

Multiple language packs may be uninstalled, once selected, by clicking the 'Uninstall selected language packs" button.
===Language packs and manual download===
Language packs are a work-in-progress, since new language strings are added for new features in each new version of Moodle. Lang packs can be manually downloaded from [https://download.moodle.org/langpack/{{Version}}/ Language packs for Moodle {{Version}}]. The page also lists the percentage of language strings translated in each language pack.
==Parent language packs and child language packs==
Certain language packs (a child language pack) contain only the modified language strings from their parent language, rather than a complete set. Thus, it is necessary to install the parent language pack too. On <nowiki>https://download.moodle.org/langpack/3.11/</nowiki> (replace 3.11 by the correct version number) you can see those languages printed in ''italic'').

Note: If your site uses a child language pack and if you use the [[Multi-language content filter]], you need to be very careful about how to use if (as reported in MDL-55197). See [[Multi-language content filter]] for more details and examples.
==Manual language pack installation==
In general, the easiest way to install additional language packs is from within Moodle. However, it is also possible to install a language pack manually by downloading the zip file from [https://download.moodle.org/langpack/{{Version}}/ Language packs for Moodle {{Version}}] and unzipping it to a directory called ''lang'' in your ''moodledata'' directory.
==Language pack updates==
* Language packs can be updated via ''Administration > Site administration > Language > Language packs''.
* You can see which language packs have updates because they are listed in both 'Installed language packs' and 'Available language packs'.
* To update all installed language packs (except English and any local language packs) click the 'Update all installed language packs' button.
* For sites with a large number of language packs installed, to update just a few installed language packs at a time, select the languages from the 'Available language packs' list and click the 'Install selected language pack(s)' button.
* The English language pack is updated automatically each time the site is upgraded.
* As most language packs are a work in progress, it is a good idea to update them regularly.
All installed language packs are updated as a [[Scheduled tasks|scheduled task]]. By default the task is run daily.
==Moodle can not connect to download.moodle.org==
This can happen if:
* You configured over-zealous security restrictions in your server. Check that your server can contact the download.moodle.org server.
* The download.moodle.org server is down and if you try to manually download the language pack, it fails too. Please try again later.
* Your internet service is faulty :(
[[File:ERROR language import not available.png|600px]]
==Inside a language pack==
A standard Moodle comes with an English language pack only. It is installed in ''moodledata/lang/en.''

The English language terms (or 'strings') for the main (core) Moodle features such as administration, roles etc, are stored in ''lang/en.'' Language files relating to modules, blocks and other plugins are stored with the files of that particular plugin. So if you wanted to see the language strings for the badges block for example, you would look in ''blocks/badges/lang/en''. If you wanted to see the language files for the workshop module, you would look in'' mod/workshop/lang/en''.

If you install another language pack, you will then get a folder such as ''lang/fr'' which would have French translations of Moodle terms. Unlike with English, other language packs such as ''lang/fr'' will contain all translations along with the main core terms so you would find see for example the badges strings in ''lang/fr/block_badges.php'' and the workshop strings in ''lang/fr/workshop.php''.

These files (which all end in .php) contain short phrases, often called "strings". Strings may contain a placeholder (between the curly brackets below). This placeholder is replaced with the chosen words from the language pack when the string is displayed. The term between the square brackets is called the 'string identifier' or the 'string name'. Examples:
$string['addnewcourse'] = 'Add a new course';
$string['hidesection'] = 'Hide section {$a}';
If a string hasn't been translated, then Moodle will use the parent language or the original English version. Thus, you might see a Moodle site where some terms have been translated into a language but others still display in English.
==Can I personalize language strings per theme?==
Not directly, but you can use new local (child) language packs to achieve different courses behaviours/looks
===Changing the look of a course===
You can have a course with a different theme 'and' a different child language pack. You will then have personalized language strings in the only course that uses that particular theme.
===Changing the behaviour of a course===
* If you do not want a student to see any reference to grades when he/she finishes a lesson, by editing the correct text string, it is possible to replace "Your score is 9 (out of 10)" with "Be sure to get your certificate". Or change "Congratulations - end of lesson reached" to "We hoped this lesson helped you". See [[Lesson_FAQ#Can_I_change_the_End_of_Lesson_page_display|how to change the end of lesson page display]].
* You can have several different courses, each using a different (child) language pack and each one showing personalized language strings.
* See [https://moodle.org/mod/forum/discuss.php?d=220671 this forum post] for detailed instructions on how to create your new child languages.
==Can I install one particular language pack and supplement the missing translations using a second (related) language pack?==
* The short answer is No.
* But there is a complicated way to achieve this :(
** You can use the [[Language customization]] tool. If you do make your own translations, please consider [https://docs.moodle.org/dev/Contributing_a_translation contribuiting your translated strings] to the language pack maintainers, so that your language pack can grow.
** See the Spanish language Moodle Documentation page at [https://docs.moodle.org/all/es/Suplementar_todas_las_traducciones_faltantes_del_Espa%C3%B1ol_internacional_con_traducciones_del_Espa%C3%B1ol_de_M%C3%A9xico Suplementar todas las traducciones faltantes del Español internacional] and [https://docs.moodle.org/all/es/Personalizaci%C3%B3n_del_idioma_(transplantar_archivos) https://docs.moodle.org/all/es/Personalización del idioma (transplantar archivos)] about grafting files from one language into another.
==Can I make a language pack for kids?==
* Yes.
* The current existing language packs for kids are:
** de_kids (which require de)
** en_kids (which require the default en)
** he_kids (which requires he)
** ja_kids (which requires ja)

* If you want to make a language pack for kids in a language different from the ones listed above, use the following method:

** Install the (en_kids) English for kids language pack in your local Moodle server
** You will have to edit 10 files (which are stored in the moodledata/lang/en_kids folder).
** You can use [https://notepad-plus-plus.org/ Notepad++] or any other text editor, but avoid using MS Word or MS Notepad.
* Start with langconfig.php and choose your main language as the parentlanguage
* When you have finished translating all the strings, you can [https://docs.moodle.org/dev/Starting_a_new_language_pack request a new language pack] to the person administering all Moodle language packs.
* Upload into AMOS the 10 files in your moodledata/lang/en_kids folder
* Remember to keep updating and expanding your new language pack
==Why do some languages have several different language packs available?==
See [https://docs.moodle.org/dev/Translation_FAQ#Moodle_languages_with_several_available_language_packs the developer's documentation] about this.
==Why has my language pack suddenly forgotten some translations?==
See the following image showing (Insignias) a properly translated Spanish language string (green rectangle) and an unstranslated English language string (red rectangle) for 'Badges' plus a mixture of translated and untranslated strings with a language pack that should have 100% of the core strings translated.

[[File:Language packs mixed-up llanguages shown.png|200px]]

If you try to update your language packs you will get a message indicating 'Update of 'xxxx_old' language pack skipped.

[[File:Something_old language pack can not be updated.png|300px]]

Read the following section for the cause and the fix.
==Why do I have a language pack named xx_old' that I never installed?==
Sometimes you may find (see image below) that your server has, in addition to your usual language packs (eg, en, es_mx), an odd-named language pack with an _old name ending (eg, es_mx_old), that -obviously- can not be updated.
* This came from an incomplete automated language pack update because the lang pack update fails in the middle of the process.
**The update first renames the existing lang directory so that it has the _old suffix and then it tries to unzip the new one.
** If unzipping is successful, the old directory is removed.
** Check that the [https://docs.moodle.org/404/en/admin/environment/php_extension/zip ZIP] PHP extension is OK in the [[Environment]].
** If your server has languages other than English, the language packs update process will need to download all the corresponding language packs, which will take some time. If you have a low speed internet provider, you could get a script timeout error. To prevent this, you will need to edit the server/php/php.ini file and change the line that has 'max_execution_time = 30' into 'max_execution_time = 600'.
* There may also be a language pack that has mixed languages, like 'English (es_mx)', that obviously can not be.
[[File:Odd-named installed language pack.png|400px]]
* The reason why the language menu shows it is because moodledata/lang/es_mx/ is incomplete and its langconfig.php is missing so the translation of the string "thislanguage" (name of it) falls back to the default English.

* You must uninstall all strange-looking language packs and re-install your usual language packs.
[[File:Language packs uninstall all mixed-up languages.png|400px]]
==See also==
* List of [http://en.wikipedia.org/wiki/List_of_ISO_639-1_codes language codes] on Wikipedia
* [[:dev:Translation]] and help us to translate Moodle to more languages
[[eu:Hizkuntza-paketeak]]
[[es:Paquetes de idioma]]
[[fr:Paquetages de langue]]
[[ja:言語インポートユーティリティ]]
[[de:Sprachpakete]]

Flashcard module

2021-01-02T15:43:53Z

Koen: /* See also */ removed dead link

{{Infobox plugin
|type = Activity
|entry = https://moodle.org/plugins/mod_flashcard
|tracker = https://github.com/vfremaux/moodle-mod_flashcard
|discussion = https://moodle.org/plugins/mod_flashcard
|maintainer = [[User:Valery Fremaux|Valery Fremaux]]
|float = right
}}

The flashcard module allows editing and playing flashcards. Flashcards are a "memory training" device that uses the concept of repetition. Checking a flashcard deck will present the student the couples of relationships to be memorized. More often the associations are reviewed, deeper the memorization will be engraved into our memorial circuits.

The flashcard module has been useful for formative assessment of anatomy, histology and pathology concepts, definitions and images in the teaching of human and veterinary medicine at undergraduate and postgraduate levels.

==Features==

* Getting cards from a "matching question"
* Editing cards
* Multimedia cards: text, image, sound and image + sound together
* Automated backpropagation of cards (can be disabled)
* Customizable decks

==Configuration==

[[Flashcard module: Configuration Parameters]]

[[Flashcard module: Capabilities]]

==Usage==
===Adding new cards===
# Add new "Flash Card Set" into the course
# Enter required field "Name" and click "Save and display" button
# Click "Edit the cards" tabs - you will be brought to screen like below
[[File:flashcard1.jpg]]
# Click "Add three new questions" button
# Add text for questions and answers
# Click "Update" button

==Screens==

===Student Screens===

*[[Flashcard module: Freeplay Screen|Freeplay Screen]]
* Leitner Play Screens
** [[Flashcard module: Leitner Choose A Deck|Choose a deck to play with]]
** [[Flashcard module: Leitner Use A Deck|Use a deck]]

===Teacher Screens===

* Summary Screens
**[[Flashcard module: By User Summary|By User Summary]]
**[[Flashcard module: By Card Summary|By Card Summary]]
*[[Flashcard module: Edit Screen|Edit Screen]]

== See also ==
* The [https://h5p.org/flashcards flashcards module] and [https://h5p.org/dialog-cards dialog cards] for [https://moodle.org/plugins/mod_hvp H5P] - Free interactive HTML5 flashcards. Create a set of stylish and intuitive flashcards that have images paired with questions and answers. Use this content type with H5P in publishing systems like Moodle.
* [[Lesson_module#The_Flash_card_lesson|Flash card presentation]] in the [[Lesson module]] is an alternative to this module.

[[Category:Contributed code]]
[[Category:Medicine]]

[[fr: Flashcard]]
[[es:Módulo flashcard]]

Flashcard module

2021-01-02T15:43:07Z

Koen: /* See also */ removed dead link

{{Infobox plugin
|type = Activity
|entry = https://moodle.org/plugins/mod_flashcard
|tracker = https://github.com/vfremaux/moodle-mod_flashcard
|discussion = https://moodle.org/plugins/mod_flashcard
|maintainer = [[User:Valery Fremaux|Valery Fremaux]]
|float = right
}}

The flashcard module allows editing and playing flashcards. Flashcards are a "memory training" device that uses the concept of repetition. Checking a flashcard deck will present the student the couples of relationships to be memorized. More often the associations are reviewed, deeper the memorization will be engraved into our memorial circuits.

The flashcard module has been useful for formative assessment of anatomy, histology and pathology concepts, definitions and images in the teaching of human and veterinary medicine at undergraduate and postgraduate levels.

==Features==

* Getting cards from a "matching question"
* Editing cards
* Multimedia cards: text, image, sound and image + sound together
* Automated backpropagation of cards (can be disabled)
* Customizable decks

==Configuration==

[[Flashcard module: Configuration Parameters]]

[[Flashcard module: Capabilities]]

==Usage==
===Adding new cards===
# Add new "Flash Card Set" into the course
# Enter required field "Name" and click "Save and display" button
# Click "Edit the cards" tabs - you will be brought to screen like below
[[File:flashcard1.jpg]]
# Click "Add three new questions" button
# Add text for questions and answers
# Click "Update" button

==Screens==

===Student Screens===

*[[Flashcard module: Freeplay Screen|Freeplay Screen]]
* Leitner Play Screens
** [[Flashcard module: Leitner Choose A Deck|Choose a deck to play with]]
** [[Flashcard module: Leitner Use A Deck|Use a deck]]

===Teacher Screens===

* Summary Screens
**[[Flashcard module: By User Summary|By User Summary]]
**[[Flashcard module: By Card Summary|By Card Summary]]
*[[Flashcard module: Edit Screen|Edit Screen]]

== See also ==
* The [https://h5p.org/flashcards flashcards module] and [https://h5p.org/dialog-cards dialog cards] for [https://moodle.org/plugins/mod_hvp H5P] - Free interactive HTML5 flashcards. Create a set of stylish and intuitive flashcards that have images paired with questions and answers. Use this content type with H5P in publishing systems like Moodle.
* [[Lesson_module#The_Flash_card_lesson|Flash card presentation]] in the [[Lesson module]] is an alternative to this module.
* [http://docs.activeprolearn.com/en/doku.php?id=:mod:flashcard|Complete original documentation in English]

[[Category:Contributed code]]
[[Category:Medicine]]

[[fr: Flashcard]]
[[es:Módulo flashcard]]

backup/copy

2020-08-26T15:03:34Z

Koen: redirect to course copy page

#REDIRECT [[Course_copy]]

Universal Office Converter (unoconv)

2020-03-24T12:16:24Z

Koen:

{{Document converters}}
==What is unoconv?==

"unoconv" is a command line program that is used to convert between different office document file formats. It uses an instance of [http://libreoffice.org LibreOffice] to do the conversion and is used by the [[Assignment activity]] to convert documents to pdf so that they can be annotated. If unoconv is not installed - the only impact is that the assignment activities will only allow annotations when students upload a pdf document.

The steps required to install unoconv are different depending on the operating system that you have installed Moodle on.

== Installing unoconv on Linux ==
The required version of unoconv is at least 0.7. Depending on your flavour of linux, this may be available in your package manager and you can install it directly with:

===Ubuntu 18.04 LTS===
<pre>
apt-get install unoconv
mkdir /var/www/.config
chown www-data:www-data /var/www/.config
</pre>

===Ubuntu 16.04 LTS===
<pre>
apt-get install unoconv
</pre>

If your package manager contains an older version of the package, you will have to find a newer version and install it manually ([https://packages.debian.org/stretch/unoconv Debian Testing]). Unoconv itself is just a python script, so it has few dependencies.

Potential problems:
* On some systems the apache user home directory is set to a non existent folder. This can cause unoconv to fail. There are 2 solutions to this - one is to make a (writable) home directory for the apache user (like /home/www-data). The other is to run a unoconv listener (described below) as another user other than the apache user (someone with a valid, writable home directory).
* If you are still running 14.04LTS then unoconv won't work as shipped. This might not be the most efficient route but it worked by first installing unoconv (version 0.6) from the package manager as above. You will then need to grab unoconv 0.7 from Github (https://github.com/dagwieers/unoconv), then upgrade to the latest libreoffice using the PPA (https://launchpad.net/~libreoffice/+archive/ubuntu/ppa). Point moodle at the Github version of unoconv. You need to modify the Python unoconv file by changing 'python' in the first line to 'python3'. You also need to change the permissions on the directory /var/www so that the user www-data can write to it (www-data needs to write to its home directory which it cannot do by default).
On Debian Stable, the cleanest method to install [https://packages.debian.org/jessie-backports/unoconv unoconv] is using Jessie-backports. First, enable backports repo line in /etc/apt/sources.list:
<pre>
#### Jessie-backports ####
deb http://ftp.debian.org/debian jessie-backports main
</pre>

Then, update and install unoconv from jessie-backports:
<pre>
apt-get update
apt-get install -t jessie-backports unoconv
</pre>

The package will bring all necessary dependencies for you.

===Ubuntu 14.04 LTS===

1) Navigate to opt directory
<pre>
cd /opt
</pre>

2) Download unoconv
<pre>
sudo wget https://raw.githubusercontent.com/dagwieers/unoconv/master/unoconv
</pre>

3) Modify the Python unoconv file by changing 'python' in the first line to 'python3'
<pre>
sudo nano /opt/unoconv
</pre><br>
eg. <pre>#!/usr/bin/env python3</pre>

4) Make unoconv executable
<pre>
sudo chmod ugo+x /opt/unoconv
</pre>

5) Add LibreOffice PPA to your system and install the latest version
<pre>
sudo add-apt-repository ppa:libreoffice/ppa
sudo apt-get update
sudo apt-get install libreoffice
</pre>

6) Change permissions so apache can write to its home directory
<pre>
sudo chown www-data /var/www
</pre>

7) From your browser navigate to
''Site administration > Server > System paths'' and add the path to unoconv<br>
/opt/unoconv
*Note: if you would like to preserve the default path add a symbolic link to /usr/bin:
<pre>
sudo ln -s /opt/unoconv /usr/bin/
</pre>

8) Navigate to
''Site administration > Plugins > Activity modules > Assignment > Feedback plugins > Annotate PDF > Test unoconv path'' <br>
You should see: <br>
"The unoconv path appears to be properly configured."<br>
*Download the converted pdf test file. (if the PDF fails to load ensure that www-data can write to its home directory: /var/www)

===CentOS / RedHat===
Just before you start, you might like to consider installing the latest [http://www.tecmint.com/install-libreoffice-on-rhel-centos-fedora-debian-ubuntu-linux-mint/ LibreOffice 6.3.2] directly from RPM packages, that are not part of the distribution you are using.
As of nov-2016, CentOS and RedHat 7.2 comes with OpenOffice 4.3 . so if you are not interested in using this version and would like to install latest 6.3 independent LibreOffice 6.3 , please remove any openoffice packages you might have on your OS by issuing:
<pre>
yum remove openoffice* libreoffice*
</pre>
It is recommended to chose your localized libreoffice version for better document conversions.
<pre>
yum install libreoffice libreoffice-pyuno
git clone https://github.com/dagwieers/unoconv.git
# copy
cp unoconv/unoconv /usr/bin
# or link unoconv to /usr/bin
ln -s unoconv/unoconv /usr/bin/unoconv
</pre>
Note: depends on what version you are installing, openoffice or libreoffice, make sure you installed the *-pyuno package. (the headless package is already compiled into the core)

Make sure it is properly configured:
http://your-moodle/admin/search.php?query=unoconv

Production servers should consider running unoconv in listener mode, see [[Installing_unoconv#Run_a_unoconv_listener]] or follow directions bellow
<pre>
vi /etc/systemd/system/unoconv.service
</pre>
And then copy and paste the following configuration into it:
<pre>
[Unit]
Description=Unoconv listener for document conversions
Documentation=https://github.com/dagwieers/unoconv
After=network.target remote-fs.target nss-lookup.target

[Service]
Type=simple
Environment="UNO_PATH=/usr/lib64/libreoffice/program"
ExecStart=/usr/bin/unoconv --listener

[Install]
WantedBy=multi-user.target
</pre>
And then enable and start the above service
<pre>
systemctl enable unoconv.service
systemctl start unoconv.service
</pre>
If your selinux is enable yous should set
<pre>
#setsebool -P httpd_execmem on
</pre>

== Installing unoconv on OS X ==
Download and install LibreOffice for Mac. Unfortunately - newer versions of LibreOffice are not currently compatible with unoconv for mac and you will have to install LibreOffice 4.2 (Direct download link - https://downloadarchive.documentfoundation.org/libreoffice/old/4.2.5.2/mac/x86_64/LibreOffice_4.2.5.2_MacOS_x86-64.dmg).

Get the latest version of the unoconv python script. One way to do this is with http://brew.sh/ brew.
<pre>
brew install unoconv
</pre>

If you haven't done it already - install ghostscript. One way to install ghostscript is also with http://brew.sh/ brew
<pre>
brew install ghostscript
</pre>

Set the paths to unoconv and ghostscript in Moodle (''Site administration > Server > System paths''). If you used brew, they will both be installed to /usr/local/bin.

LibreOffice needs write access to the current users home directory to create some temporary files. When unoconv is run as the webserver user (_www) it does not normally have this permission.

There are some ways to get around this - one way is just to give the "_www" user write access to /Library/WebServer.

Another solution is to convince LibreOffice that this users home directory is somewhere else. This can be done by inserting this code into the top of the unoconv python script.
Code to insert:
<pre>
# Set home to a writable folder.
os.environ['HOME'] = '/tmp/'
</pre>

This needs to be inserted at line 36 immediately after the line "exitcode = 0"

== Installing unoconv on Windows ==
Download and install LibreOffice for Windows. Open Office will work just as well, but the documentation for unonconv is set to Libre Office.

Download the latest version of the unoconv script from https://github.com/dagwieers/unoconv/releases (download the zip version).

From the downloaded zip file - extract the one file "unoconv-0.7\unoconv" (no file extension). This is the unoconv script - none of the other files in the package are required.

Rename the downloaded script to '''unoconv.py''' and copy it to a folder in either C:\Program Files or C:\Program Files (x 86)

Create a batch file in the same folder as unoconv.py name it something like '''unoconv.bat''', it must be a batch file, with these contents:

<code>@"C:\Program Files\LibreOffice (or Open Office #v)\program\python.exe" c:\unoconv\unoconv.py %* </code>

Next, you have to '''Set paths in Moodle.'''

Login as admin and go to ''Site administration > Server > System paths''

Set:
<code>Path to Ghostscript (pathtogs) C:\Program Files\gs\gsversion\bin\gswin64c.exe </code>
Do not use gswin32.exe or gswin64.exe, these are not command line programs - use gswin32c.exe or gswin64c.exe.

Set:
<code>Path to Python (pathtopython) to C:\Program Files (x86)\OpenOffice v#(or Libra Office v#)\program\python.exe </code>
Identify in the path whichever program you use and include the full exe name for both Ghostscript and Python.

Save the pathto statements and a green tick should appear if Moodle is communicating with the required files.

Go to Site administration > Plugins > Document converters and enable '''Unoconv''' then select Settings

Enter the path statement to
<code>Path to unoconv document converter : C:\Program Files (x86)\unoconv\unoconv.bat</code>
Include the full name of the .bat file.

Test ghostscript and unoconv are working correctly in the admin test pages "Site administration > Plugins > Activity modules > Assignment > Feedback plugins > Annotate PDF".

== Run a unoconv listener ==
Unoconv utilises a client/server process when converting documents. By default, when there is no running server process - each time unoconv runs it will start a server process, send its request and shut down the server process when the request is complete. The drawback of this mode is that if 2 requests are submitted simultaneously - this can cause the first request to shutdown the server process when the second request is still in progress - and the second conversion request fails. A more robust way to configure unoconv is to start a server process at boot time, and/or run a script to monitor it and restart it if it crashes.

To start a unoconv listener at boot time - you need a start up script. Different operating systems and Linux distributions use different startup scripts - but here are some examples of startup scripts for different systems.

[[mod/assign/feedback/editpdf/testunoconv/upstart | Upstart script for Ubuntu based systems]]

[[mod/assign/feedback/editpdf/testunoconv/launchd | Launchd script for OS X]]

[[mod/assign/feedback/editpdf/testunoconv/initd | Init script for Debian]]

[[mod/assign/feedback/editpdf/testunoconv/initdcentos6 | Init script for CentOS/RedHat 6.x]]

[[mod/assign/feedback/editpdf/testunoconv/systemd | SystemD service script for CentOS/RedHat 7.x]]

== Offload processing to a different server ==
Processing office documents can put increased load on your webserver, which may impact on the responsiveness of your site. If you are installing unoconv on a large site you may want to consider running unoconv on a server that is not also serving web requests.

How to do this:

Install unoconv on each webservers and the remote server following the installation instructions above.

Make sure unoconv is started at boot time on the remote server with the "--listener" argument and is monitored and restarted if it exits (see Debian init script for an example of how to do this). By default, unoconv will only listen on localhost (127.0.0.1): if you want to connect to the listener process from another server, you need to start the unoconv listener process with the "--server" argument too!

An example command for starting a listener on a remote server (0.0.0.0 listens on all interfaces):
<pre>
unoconv --listener --server 0.0.0.0 --port 2002
</pre>

Open the firewall port 2002 between the moodle webservers and the machine running unoconv.

Share the moodle data root between the webservers and the machine running unoconv. This folder must be mounted at the same path on all servers.

Install a wrapper for unoconv on the webservers that forwards the requests to the remote server. Example:
<pre>
#!/bin/bash
# Wrapper script for unoconv to forward processing.
# Install to /usr/bin/unoconv-remote with 755 permissions
/usr/bin/unoconv --server=<ip of remote server> "$@"
</pre>

Configure the path to unoconv in the Moodle admin settings to point to this wrapper script.

==Additional resources==

[https://github.com/dagwieers/unoconv GitHub dagwieers/unoconv] has additional information on installation of unoconv and troubleshooting tips.

==Troubleshooting==
* [http://webnetkit.com/soffice-bin-using-100-cpu-moodle/ soffice.bin using 100% of CPU MOODLE]

==See also==

* [https://moodle.org/mod/forum/discuss.php?d=335310 Is the unoconv installation a security risk?] forum discussion

[[Category:Site administration]]
[[Category:Assignment]]

[[es:Universal Office Converter (unoconv)]]
[[de:Universal Office Konverter]]
[[fr:Universal Office Converter]]

TeX notation filter

2019-11-25T11:01:05Z

Koen: /* See also */ Link that works for TeX filters

{{Filters}}
The TeX Filter is a core Moodle filter intended to allow one to convert tex expressions into GIF, PNG or SVG images. The filter relies on some additional binaries to accomplish this for expressions contained between appropriate tokens. Where these binaries are not available, Moodle provides for a fallback through the use of Mimetex. Versions of MimeTex for Linux (glib2.3 32bit), Windows, Mac OS X and FreeBSD are included in the Moodle distribution. There are other technologies available for displaying Tex (see the section on [[Mathematics]] tools for a discussion.)

'''Note''': being based on binaries it requires the availability of three PHP program execution functions: <code><nowiki>exec</nowiki></code>, <code><nowiki>shell_exec</nowiki></code> and <code><nowiki>system</nowiki></code>.

== Methods and Usage ==

To avoid confusion you should note that the TeX filter has two separate methods for converting the TeX notation to images. The preferred method is a collection of three binaries that you are responsible for installing (if they are not already present, though many webhosts make these available) and configuring on your server. The filter settings page relates entirely to this method. If this fails for any reason the filter will fall back to a single binary - MimeTeX. A number of different builds are included in the Moodle distribution for popular operating systems, though Mimetex and its bigger brother, MathTex are easy enough to compile and install if you have systems administration experience.

Before doing anything else, you need to go to ''Settings > Site administration > Plugins > Filters'' and activate the TeX Notation Filter. If you want to use the Algebra filter (another core filter) since the Algebra Filter is really only a "front end" to the Tex filter, you should also turn on the Algebra filter. For more information on the Algebra Filter see the [[Algebra filter]].

Once the filter is turned on and properly configured you can make use of it by
including a TeX expression delimited by double-dollar signs. Example:

$$ \sqrt{x + y} $$

If this does not display properly, see the information on debugging.

== MimeTeX ==

Moodle may use a pre-built MimeTeX binary (located in the filters/tex directory) as a fallback if it can't properly access dvips, convert and latex binaries. There are a number of different versions for different operating systems. The TeX filter picks the appropriate binary for the detected host operating system (you will need to hack the script if your operating system is not included). Note that your web server needs to be set up with appropriate permissions for running binaries in that location.

The [http://www.forkosh.com/mimetexmanual.html MimeTeX manual] is available but is arguably intended for persons with systems administration experience and does not specifically address the Moodle environment.

You should only use MimeTeX if installing the full LaTeX system fails or the binaries are not available on your system. The results are not nearly as good.

== Compatability with MathJax ==

In Moodle 2.8 onwards, the TeX Notation and MathJaxloader filter may be used in combination. If both filters are enabled on the page, images will be displayed first by the TeX notation filter, and the MathJax version of the TeX expression will replace a little while later when MathJax has finished loading and processing. If both filters are available, a teacher may decide which to use in an activity by enabling one and disabling the other.

== Site administration settings ==

Location: TeX Notation settings link in ''Settings > Site administration > Plugins > Filters > Manage filters''

The TeX filter settings page are primarily intended to adjust the operation of the LaTeX renderer. The defaults for the three path settings are selected according to the detection of the operating system on which Moodle is running. These are simply suggested common values - Moodle does not check that the binaries actually exist at these locations. More recent versions of Moodle show a green tick or a red cross next to the path setting - this shows that the binary exists at that location (only). The settings have no effect on the operation of the MimeTex binary (used if any of these binaries are not found).

==== Installing the binaries ====

This depends on your platform, but for a typical install you are going to need a LaTeX implementation. On modern Linux implementations you should look for the 'texlive' package (e.g. ''apt-get install texlive'') although a Windows version is available (see [http://www.tug.org/texlive/doc/texlive-en/texlive-en.html Tex Live]). It is highly unlikely that you will have all these binaries as part of a standard install. If you cannot find texlive you may have to install LaTeX, Ghostscript and ImageMagick separately. While not endorsed by Moodle.org, a simple installation binary for Windows is [http://miktex.org/| MikTeX].

The filter settings page will try to guess the most likely location for the binary files depending on the detected platform. If correct, green ticks will appear against each setting. If red crosses appear you will need to check and modify the settings as required. A simple check is made to establish if the binaries exist at the given paths. A tick or a cross is displayed alongside each as a result. Note that this does not check that the application actually works, just that it is there.

Some systems supply the fonts as separate packages. If you are having problems make sure you have all the fonts you need installed. You may need to track down an 'extra' fonts package to get the required maths fonts.

==== LaTeX preamble ====

Enables the LaTeX preamble to be specified. The default should work for most users, but you may need to change it to support non-latin character sets etc. Please see the LaTeX documentation for further details.

==== Transparent colour ====

This should be set to your normal text background colour. The default setting is #FFFFFF (i.e., white).

==== Density ====

This setting effects the size of the resulting image. The default setting is 120 pixels, and it produces an image of reasonable quality, but for some complicated equations, this still may not be enough. It may be that anything less is not going to produce an image of sufficient quality but the image size can be controlled by the TeX encoding when the page is rendered.

==== Path of ''latex'' binary ====

Path to standard latex binary.

On Unix based systems it is normally "/usr/bin/latex". On a MacOS X, the path is "/usr/texbin/".

In Windows, using MiKTeX, it is usually something like C:\texmf\miktex\bin\latex.exe

==== Path of ''dvips'' binary ====

Path to standard dvips binary - generally distributed as part of a LaTeX system.

On Unix based systems it is normally "/usr/bin/dvips". On a MacOS X, the path is "/usr/texbin/".

On Windows using MikTeX is is usually something like C:\texmf\miktex\bin\dvips.exe

==== Path of ''convert'' binary ====

Path to standard convert binary. It is necessary to produce GIF or PNG images from using the latex and dvips binaries. This is distributed as part of the Ghostscript system, or ImageMagick in Linux.

On Unix based systems it is normally "/usr/bin/convert". On a MacOS X, the path is "/usr/local/bin/".

On a Windows based PC the path is something like C:\Program Files\ImageMagick\convert.exe (for ImageMagick, but something else for GhostScript.)

==== Path of ''dvisvgm'' binary ====

This binary is used instead of convert to produce SVG images. This is distributed as part of TeXlive on Linux although it may be require the full or extra packages to be installed.

On Unix based systems it is normally "/usr/bin/dvisvgm".

On a Windows based PC a compiled binary is available from [http://dvisvgm.sourceforge.net/Downloads sourceforge] and can placed in the same directory with the latex binary.

==== Path of ''mimetex'' binary ====

If this is blank and the binaries above are missing or fail, the TeX filter will attempt to use a mimetex binary distributed with Moodle. If you have installed mimetex on the server and would rather use it include the path here.

== Debugging TeX filter ==

The TeX filter has a debugging script (which will be much more helpful if you turn on [[Debugging]]) included that should help if you are having problems. The URL will be as follows...

<nowiki>http://your.moodle.path/filter/tex/texdebug.php</nowiki>

You can either enter this path explicitly or with appropriate role permissions the TeX images (or more likely incorrectly rendered text, if you need debugging) will link to this. On more recent versions of Moodle you are ''required'' to be logged in as an Administrator to access this facility.

== See also ==

* [http://academy.edulabs.org/mod/glossary/print.php?id=764&mode&hook=ALL&sortkey&sortorder&offset=0&pagelimit=10 TeX Filter Glossary] - a [[Glossary|glossary]] you can add to your course which details usage of the supported [[TeX notation]].
* [http://www.latex-project.org/ LaTeX] - the LaTeX document preparation system.
* [http://www.ghostscript.com/ ghostscript] - required to render the image
* [http://www.forkosh.com/mimetexmanual.html MimeTeX Manual] - Default TeX notation manual
* [http://www.miktex.org/ MikTeX] - LaTeX for Windows systems
* [http://www.imagemagick.org/script/index.php ImageMagick] - required to render images for Windows
* [[Using TeX Notation]]
* [[Advanced Maths Tools]] for Moodle 2.x - SEE - The Next Generation of TeX Tools
* [https://moodle.org/mod/forum/view.php?id=752 Mathematics tools forum] on moodle.org

[[Category:Site administration]]
[[Category:Mathematics]]

[[de:TeX-Notation]]
[[es:Filtro de notación TeX]]

Logging

2019-09-05T08:55:44Z

Koen:

The site administrator can define which log stores are available, and in which order, from ''Administration>Site administration>Plugins>Logging>Manage log stores.''

Available stores are: Standard, Legacy and External database.

''Note:'' A new Moodle site will have Standard logging enabled and Legacy logging disabled. A site which has been upgraded will have both enabled.

The default Standard log is very detailed and should meet most requirements. The Legacy log should be disabled unless you have old custom reports that need it. An External database log store also allows you to connect to an external log database.

Note that if you disable Legacy logs, you won't be able to look/show/display (existing) Legacy logs, and no new Legacy logs will be generated. This could be a problem for non -standard plugins which still generate Legacy logs instead of Standard logs. In time it is to be hoped all contributed plugins will use Standard logs. You can disable the legacy store plugin completely OR you can only disable writing to legacy log inside the plugin settings. In the second case, you will be able to read from the log but no new entries will be added. This is also what will be set automatically during upgrade.

The "Write buffer size" is the number of log entries inserted in one batch database operation, which improves performance.

[[File:logstores.png]]

From ''Site administration>Plugins>Reports>Manage reports'', the administrator can see which log stores support which given report:

[[File:reportslogstore.png]]

== External log stores (logstore_database) ==

An External database log store also allows you to connect to an external log database.

This log storage plugin is responsible for storing and retrieving the logs ([https://docs.moodle.org/dev/Logging_2#Figure1 steps 2 and 3 from Figure 1]). There is no interface to read or display from it provided with Moodle core.

==See also==

* [[Logs]]
* [[Events list report]]
* [[:dev:Event_2 | Developer documentation on Events (giving examples of levels)]]
* [https://moodle.org/plugins/browse.php?list=category&id=54 Log storage plugins]

[[Category:Site administration]]

[[es:Usar bitácoras]]
[[de:Logging]]

Cohort external database

2019-06-06T13:08:08Z

Koen: Created page with "{{Infobox plugin |type = Admin tool |entry = https://moodle.org/plugins/tool_cohortdatabase |tracker = https://github.com/catalyst/moodle-tool_cohortdatabase/issues |discussio..."

{{Infobox plugin
|type = Admin tool
|entry = https://moodle.org/plugins/tool_cohortdatabase
|tracker = https://github.com/catalyst/moodle-tool_cohortdatabase/issues
|discussion =
|maintainer = Dan Marden, Catalyst IT
|float = right
}}

Cohort external databaseplugin creates site-level cohorts using a connection to an external database.

* Can be triggered via CLI and/or scheduled task.
* Creates site-level cohorts
* Synchronises users in cohorts
* Optionally auto create users

Create an external database (various types supported) containing your users and cohorts (username, firstname, lastname, email, cohort).

Using the settings of the plugin on moodle/admin/settings.php?section=tool_cohortdatabase and create mappings to the correct fields of your external database.

For testing, tick tool_cohortdatabase | debugdb and run the synchronisation script on the command line. In moodle/admin/tool/cohortdatabase/cli, execute: php sync.php. Observe the output for possible errors.