MoodleDocs - User contributions [en]

Multitopic course format

2024-01-28T11:20:19Z

Marycooch:

{{Infobox plugin
|type = Course format
|entry = N/A
|tracker = https://github.com/james-cnz/moodle-format_multitopic/issues
|discussion = https://moodle.org/mod/forum/discuss.php?d=394619
|maintainer = [[User:James Calder|James Calder]]
|float = right
}}

Information about this plugin can be found in the [https://github.com/james-cnz/moodle-format_multitopic/wiki Multitopic course format documentation.]

MediaWiki:Sitenotice

2022-11-28T12:15:59Z

Marycooch: link to latest supported docs

-
<p class="note">''Note: You are currently viewing documentation for Moodle 3.10. Up-to-date documentation for the latest stable version of Moodle may be available here: '''[[:en:{{NAMESPACE}}:{{PAGENAME}}|{{PAGENAME}}]].'''''</p>

Gapfill question type

2022-01-06T10:54:48Z

Marycooch:

{{Questions}}

{{Infobox plugin
|type = question type
|entry = https://moodle.org/plugins/view.php?plugin=qtype_gapfill
|tracker = https://github.com/marcusgreen/moodle-qtype_gapfill/issues
|discussion = https://moodle.org/plugins/view.php?plugin=qtype_gapfill
|maintainer = [[user:Marcus Green|Marcus Green]]
|float = right
}}

==Installing this question type==

Follow the generic [[Installing plugins]] documentation.

== The Gapfill Question Type ==
All you need to learn to get started with this question type is the contents of one 7 word sentence as follows

''Put square braces around the missing words''

For the programmers and mathematicians, don't worry that it says square braces, you can use other delimiters on a per question basis. The classic example of a question is a question where the text reads.

''The [cat] sat on the [mat]''

Which will create a question with two gaps where the answers are cat and mat. Although it was designed with the idea of single missing words it will accept a sequence of words with spaces between them in the gaps. This type of question can be particularly useful for teaching languages.

== Example questions available ==
Over 500 example questions are available for re-use and modification under a creative commons license. The examples are installed with the question type but the latest versions of these can be found at
https://github.com/marcusgreen/moodle-qtype_gapfill/tree/master/examples/en. There are two files, gapfill_examples.xml has about 20 questions containing examples of how to use the features of the question type.

The other file, english_language.xml is aimed at people teaching english and is broken into approximately 31 categories such as irregular verbs, tenses etc, each question includes tags. This is a companion file to the additional 100 English questions that ships with the Wordselect question type
https://github.com/marcusgreen/moodle-qtype_wordselect/tree/master/examples/en
These files are in xml format, instructions on how to import them can be found here
[[Import_questions#Importing_questions_from_an_existing_file]].

[[Image:gapfill_edit11.png|Gapfill Edit]]

By default the student will see the questions in dragdrop mode where they can use the mouse to drag the answers from a displayed list into the matching field. When a student is answering one of these questions javascript only updates the text contents of the field, so even in this mode it is possible to type the answers into the field. As of version 1.4 it was updated to work with touch devices such as tablets and mobile phones and this post in the forum shows how it works with a wide range of devices.

https://moodle.org/mod/forum/discuss.php?d=251406#p1092014

==At Runtine==

[[Image:gfruntime.jpg|Gapfill runtime]]

Changing the display answer options allows the question to be presented with either no prompts or dropdown lists. Here is where you can make that change
[[Image:displayoptions.png|Display answer config]]

This is how the same question will appear with dropdown lists.

[[Image:dropdowns.png|Gapfill with dropdowns]]

There is a drop down list of alternative delimiting characters ## {} and @@ which will allow a question in the form The {cat} sat on the {mat}.
It is possible to select dropdown or gapfill mode. Dropdown shows a list of all possible answers in each field and gapfill shows only an empty field with no list of options to select.

By default marking is not case sensitive. So if the student enters CAT in a field of the form [cat] it will be considered correct. The editing form has an option to make the marking process case sensitive.

Each (correct) field is worth exactly 1 mark, so The [cat] sat on the [mat] has a maximum possible score of 2 marks. There is no concept of negative marking. The question supports the standard [[Question behaviours|behaviours]], hinting and combined feedback options. If an incorrect answer is entered and if display right answer has been selected in the quiz review options the correct answer will be shown next to the gap within braces as in the following screen shot.

[[Image:gapfill_correct_answer2.png|Gapfill complete]]

The editing form offers a field for adding wrong or distractor options. These only make sense in dragdrop or dropdown mode. Wrong answers must be entered as a comma delimited list and a shuffled list of correct and incorrect answers will be displayed with the question. If you need commas to appear in your distractors they can be escaped with a backslash \,
==Display Answers checkboxes==
Because only certain combinations of the checkboxes are logical, the checkboxes will become enabled/disabled according to the dropdown selected. So for example it makes no sense to have single use draggable selected with dropdown questions. This animation shows the checkboxes being enabled/disabled.
[[Image:gapfill_checkboxes2.gif|Checkboxes changing with dropdown selection]]

==Options After Text==
This setting only makes a difference in dragdrop mode. It positions the draggable answer options after the body of the text instead of above it. This can be useful where the gaps are at the end of an explanatory block of text. It means the answers do not have to be dragged as far and is useful on smaller screens such as mobile devices as it reduces the need for screen scroll.

[[Image:optionsaftertext2.png|Checkbox to display options after text]]

==Single use draggables==
This only applies to drag drop mode. When a draggable option is dropped into a gap it is removed from the list. This can be useful to simplify the selection of answer options.

[[Image:single_use_draggables.png|Single use draggables]]

==Letter Hints==
This setting only applies when the Interactive with multiple tries behaviour is used. Click the 'show more' options under the More options heading to see this setting.
[[Image:letterhints2.png|Checkbox to set letter hints]]

When a student gives an incorrect response they will be given incrementing letters from the correct answer when they press try again. So if the correct response is cat and the student responds with dog, on the next attempt that gap will contain c, and if they the respond with mouse, on the next response the gap will contain ca etc etc.

==In the Mobile App==
If you access a quiz with the mobile app that contains Gapfill questions it will be automatically loaded as a remote addon. The selection of "draggables" follows the pattern set by the core [[Drag and drop into text question type]]. Instead of dragging answers into gaps, the answer will be clicked to select and then a gap will be clicked to drop into. Clicking away from an answer and into a gap will allow a gap to be cleared. In the screen shot the word New has been selected ready to drop into the second gap.

[[Image:mobile_gapfill4.png|Gapfill in Moodle mobile]]

== Regular Expressions==
It is possible to use regular expressions in answers, for example if you wanted both the US and UK spelling of colour as an answer you could add a field with the broken bar operator to act as an OR as in "What [color|colour] is the sky?". You can search for any string that starts with c and ends with r as "What [c.*r] is the sky". More complex regular expressions should also work.

You could use regular expressions to mitigate common spelling errors, e.g. {cal[e|a]ndar} (note the selection of alternative delimiters to get around the use of the square brackets in the operator. This question type makes no attempt to check the validity of your regular expressions. You can read more about using regular expressions in the documentation for the PReg type see
[[Preg_question_type]] and also
[[Regular_Expression_Short-Answer_question_type]]

==Show Correct Responses ==
In interactive mode (set in the [[Question behaviours|question behaviour]] of the quiz) it is possible to have a question indicate the number of questions that are correct and for this to be displayed for each field. This takes the form of red/green background colour and a tick or cross. To make this happen check the "show number of correct responses option" in the hint field under the multiple tries option. Note, that if you have given an incorrect answer it will not show what the correct answer is. You can of course put in the text of the whole including all correct answer into the "For any partially correct response" text area in the combined feedback section.

[[Image:hints.jpg|hints r]]

==No Duplicates Mode ==
This allows a question in the form Name three examples of X. So you could ask "Name the colours of medals awarded in the Olympic Games". The syntax of the question fields would be [gold|silver|bronze] three times. Note the separator is the broken bar character which acts as an OR operator. Make sure you select gapfill mode for this type of question, otherwise you will have confusing draggable prompts appearing.

By checking the No duplicates box in the question editing form, when it comes to marking any duplicates will be discarded. Correct answers will still be displayed with a green check/tick (as they are actually correct), but marks will only be awarded for the first occurrence of the selection. As of version 1.1, when this happens the background of the duplicated values will be displayed in yellow and a message added to the feedback will say "Credit is partial because you have duplicate answers".

[[Image:duplicate_gapfill.png|Duplicate answers]]

==Tables with category columns==
By combining No duplicates mode with the | (or) operator it is possible to create tables with category columns. So in the following screen shot there are two distinct gaps containing [lion|tiger] [dog|wolf] but these are duplicated to allow for all four answers. These are then placed in a table to allow the student to drag into the appropriate category columns.
[[Image:gapfill_categories.gif|Gapfill Categories]]
<br/>This screen shot shows how the question text appears in the editor. Note that the shading for the heading row is done by including <th> tags for the first row instead of <td> tags and by setting the class table tag as <table class=gapfilltable>, The gapfilltable class is supplied in the css for the question type.
If you are using the HTML editor, switch to HTML mode and paste in the following code as an example.

<pre>
<table class="gapfilltable" border="2" rules="rows">
<tbody>
<tr><th>Feline</th><th>Canine</th></tr>
<tr><td>[tiger|lion]</td><td>[dog|wolf]</td></tr>
<tr><td>[tiger|lion]</td><td>[dog|wolf]</td></tr>
</tbody>
</table>
</pre>
==Tables with images==
Tables with images can be used to create a question where the student must drag the word into the gap next to the appropriate picture
[[Image:fruit2.png|Tables with images]]
<pre>
<table class="gapfilltable" border="0">
<tbody>
<tr>
<td><img src="http://apple.png" alt="" width="50" height="51" /></td>
<td>[apple]</td>
</tr>
<tr>
<td><img src="http://pear.png" alt="" width="58" height="55" /></td>
<td>[pear]</td>
</tr>
</tbody>
</table>
</pre>

==Gapfill crossword==
It is a bit of a fiddle but it is not wildly difficult. You might also be able to do this with [[Embedded Answers (Cloze) question type|the core Cloze question type]], but the source text would probably be a bit ugly.

[[File:Gapfill crossword.png|400px]]

In order to make the above crossword you would need to:
* Write in paper (preferably using a lined or graph paper) the completed crossword.
* Make a new Gapfill question instance
* Type the relevant instructions (if necessary)
* Type the Across and Down definitions of the words that the user must guess.
* Build a table with the proper number of rows and columns.
* Leave the empty table cells empty.
* Populate the interesting parts of the table with either
** a fixed character (if you will be helping the reader, as most crosswords do)
** or each character to be guessed enclosed within square brackets.
* Save your question and preview
* Fix mistakes (if present)
* Try as a student

Here is the HTML code that was used to create that example. Note that the gapfillcol class ships with the question type and sets the light grey background among other things. It is probably easiest to create the table/grid using the Moodle built in Atto editor and then tweak the HTML code afterwards.

<pre>
<table class="text-center gapfillcol" border="1">
<tbody>
<tr><td></td><td></td><td></td><td></td><td></td><td></td><td></td><td>1</td></tr>
<tr><td></td><td></td><td></td><td>2</td><td></td><td></td><td></td><td>[T]</td></tr>
<tr><td></td><td></td><td></td><td>[M]</td><td></td><td></td><td></td><td>[U]</td></tr>
<tr><td> </td><td>3</td><td>[L]</td><td>[O]</td><td>[N]</td><td>[D]</td><td>[O]</td><td>[N]</td></tr>
<tr><td></td><td></td><td></td><td>[O]</td><td></td><td></td><td></td><td>[E]</td></tr><tr><td> 4 </td><td>[W]</td><td>[I]</td><td>[N]</td><td>[E]</td><td></td><td></td><td></td></tr>
</tbody>
</table>
</pre>

==Disable Regex ==
The Gapfill question uses regular expressions by default to compare the answer given by a user with the correct answer stored in the database. There are times where it is more convenient to turn this off and use plain string comparisons. This is true where the answer text contains characters that have a special meaning in regular expressions such as < > * . / \. This can be done by checking the Disable Regex option in the More options section as in the screen shot.

[[Image:disableregex3.png |Disable Regex]]

==Fixed Gapsize==
When this is checked all gaps will be set to the size of the largest gap. If the gap includes the or operator | the size will be set to the widest of the words used.
[[Image:fixedgapsize.png |Fixed Gap size checkbox]]

==Letter Hints==
This setting only has an effect when the [[Question behaviours|interactive with multiple tries question behaviour]] is selected and when hints have been added to the question. If a student submits an incorrect answer the first letter of the correct answer will be added. If they submit another incorrect answer first two letters of the correct answer will be added and this continues for the number of hints that are added for the question.
[[Image:gapfill_letter_hints.png|Letter Hints]]

==Double Not ==
The use of !! indicates that a gap can be left empty and considered a correct response.

This is of particular use with the | or operator where one or more answers or a blank will be considered correct e.g. [cat|dog|!!].

This is illustrated in a new sample question in the sample_questions.xml files shipped with this question type called "Correct_empty_gaps with !!" As part of this change the calculation of maximum score per question instance has been modified, so a question with "The [cat] sat on the [!!]" will be worth two marks in total one for entering cat and one for leaving the second gap blank. This is necessary to ensure that if a value is put in the [!!] space a mark will be lost.

==Extended Characters==

Gapfill will only work with characters that will display in a standard HTML form. This means it will not render any [[HTML]] or [[LaTeX]]. It should be possible to display [[Unicode|unicode]] characters such as these examples of "powers".

What is ten to the power 3?[10³]

What is ten to the power 4?[10⁴]

What is ten to the power 5?[10⁵]

What is ten to the power 6?[10⁶]

What is ten to the power 7?[10⁷]

What is ten to the power 8?[10⁸ ]

What is ten to the power 9?[10⁹]

[[Image:tenpower.png|extended characters]]

Note: You ''can use some HTML codes'' inside gapfill questions, but you must first click on the <> button to show HTML code. Please note that you could actually type most of these codes directly. The following HTML codes are available:

* <code>&nbsp</code> - 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
* <code>&amp</code> - ampersand sign (&)
* <code>&apos</code> - apostrophe sign (')
* <code>&copy</code> - copyright sign (©)
* <code>&plusmn</code> - "plus or minus" sign (±)
* <code>&times</code> - multiply sign (*)
* <code>&divide</code> - divide sign (/)
* <code>&gt</code> - "greater than" sign ( > )
* <code>&lt</code> - "less than" sign (<)
* <code>&laquo</code> - quotation mark (‘)
* <code>&lsquo</code> - left single quotation sign (‘)
* <code>&rsquo</code> - right single quotation sign (’)

[[File:Gapfill with extended HTML characters.png|Gapfill using some HTML codes]]

==Set defaults for new questions==

Some default values can be configured for new instances of the question. With an admin login account go '' Site administration > Plugins > Question types '' and select '' Gapfill > Settings ''.

This was very easy with the Clean theme:

[[Image:gapfill_admin.png|Gapfill Admin with Clean theme]]

It may be a little cumbersome with the Boost theme:

[[Image:Boost gapfill admin.png|Gapfill Admin with Boost theme]]

Select settings and you will see the following form

[[Image:gapfill_settings.png|Gapfill Settings]]

==Prevent typing into gaps==
By default students can type into the gaps when dragdrop mode is enabled. This can be prevented by adding some css by a user with admin acces via the
additional HTML form. This can be found at http://yourmoodle.com/admin/settings.php?section=additionalhtml
<code>
<style>
.que.gapfill input.droptarget {
text-align: center;
cursor: pointer;
pointer-events: none;
}
</style>
</code>

It is the pointer-events:none that does the work. This is only a style change and a determined/knowledgeable student could always work around it.

==Use in modules other than quiz==
This question type has been used in other modules that use the quiz engine including the excellent [[StudentQuiz_module]]

==Related Question Types ==

There is a 'companion' question type called [[Wordselect question type|Wordselect]] that may be of interest to users of this question type. Word select questions are created in a similar way, i.e. putting sqare braces around certain words. The difference is that all words are shown and the student has to click on the words they consider to be correct.

This Gapfill question was designed to be simpler to use than the [[Embedded Answers (Cloze) question type|the core Cloze question type]]. However, the Gapfill type has fewer features than [[Embedded Answers (Cloze) question type|the Cloze type]]. There are [[Cloze editor module|cloze editors available for both TinyMCE and Atto]] that greatly ease the making of Cloze question types, without having to learn the complex cloze syntax.

There are two other core question types that cover a slightly similar area to Gapfill
* the [[Drag and drop into text question type]]
* and the [[Select missing words question type|Select missing words (gapselect) question type]].

[[Category:Language teaching]]

[[es:Tipo de pregunta llenarhueco]]

Using badges

2021-10-31T16:12:56Z

Marycooch: /* Badge details */ badge issuer

{{Badges}}This page is about how to add badges to a course or the site and how users can access their badges. For managing badges which have already been added, see [[Managing badges]].
==Adding a course badge==
If course badges have been enabled in ''Administration > Site administration > Badges > Badges'' settings then a teacher can add badges from ''Administration > Course administration > Badges > Add a new badge''.
===Badge details===
Add a name and description and upload your badge here.

As the badge issuer is set globally by the site admin, you could include the course teacher's name here if you wish.

A badge version and language may be added, along with information about the author of the image used for the badge.
===Badge expiry===
Set a date here if the badge will cease to be valid after a certain date. Leave it to never if you want the badge to be permanently displayed.
*When the settings are saved, you are then taken to the Manage badges screen where you can decide the criteria for awarding the badge along with other optional information.
*This information can now include Endorsements, Related badges and (external) Competencies. See [[Managing badges]] for more details.
===Criteria===
*For course badges, the criteria are: Manual issue by role; course completion, activity completion, previously awarded badges, and competencies.
*When selecting Manual completion by role, you can choose the role you wish to award the badge, so for example a teacher could allow a non-editing teacher to award badges in the course.
*For badges to be awarded for course or activity completion, [[Completion tracking]] must be enabled in the site and the course.
* For awarded badges, a site badge can only have another site badge as criterion, whereas a course badge can have either another course badge or a site badge as criterion.
[[File:CourseBadgeCriteria.png|thumb|400px|center|Choosing criteria for the badge]]
It's possible to add a description of the criterion/criteria to provide more information or relevant links.
[[File:criteriondescription.png|thumb|center|400px|Criterion description field]]
Once criteria have been set, you are returned to the Manage badges screen where you must "enable access" for the badge to be available:
[[File:enableaccesscoursebadge.png|thumb|400px|center|Click to enable access to the badge]]
===Awarding the badge===
Badges may be awarded manually from the Badges link in the navigation drawer with the Boost theme or from ''Course administration > Badges > Manage badges > Recipients'' with other themes such as Classic.

For information on the Overview, Edit details, Message and Recipients tab, see [[Managing badges]].

Tip: If your site has a large number of users, it's easier to search for email addresses than names.

'''New in 3.8:''' If your course uses groups, it is possible to select a group and award the badge to members of just that group.
[[File:GroupBadgesAward.png|center|Awarding badges]]
===Revoking a badge===
If a badge is awarded my mistake, it may be revoked from the 'Badge recipients' page. Click the badge in question, click the Award button, select the person whose badge you wish to revoke and click 'Revoke'.

Only badges which were awarded manually may be revoked.
==Adding a site badge==
*An administrator can add a site badge from ''Site administration / Badges / Add a new badge''.
*While the settings are basically the same as for a teacher in a course, the criteria are slightly different because of the global nature of the badge. These are: manual issue by role; completing a set of courses or profile completion, cohort membership and previously awarded badges. As part of the profile completion criteria, a badge may be awarded for uploading a profile picture.
*In order to be able to award a site badge based on completing one or more courses, [[Completion tracking|completion tracking]] needs to be enabled in the site and relevant courses. In each course, [[Activity completion|activity completion]] must be set for the chosen activities, which must be then checked in the [[Course completion settings|course completion settings]].
{|
|[[File:SiteBadgeCriteria.png|thumb|Badge criteria for site badges]]
|}
==Earning badges==
*Once all criteria are set and badge creator is happy with badge details and settings, site users can start earning it. For users to be able to earn a badge, a badge creator/administrator needs to enable access to this badge on a badge overview page or "Manage badges" page (as shown on the picture).

*Normally badges are awarded to users automatically based on their actions in the system. The completion criteria of an active badge are re-calculated every time an event such as completion of a course or activity, or updating user profile happens. If a user has completed all necessary requirements they are issued a badge and sent an email notification.
'''Only badges with enabled access are available to users and can be earned!'''
{|
|[[File:Badge enable access.png|thumb|Enabling badge access]]
|[[File:Earning a badge.png|thumb|Earning a badge]]
|}
==See also==
*[https://school.moodledemo.net/badges/index.php?type=1 School demo example: Managing site badges] (Log in with username: ''manager'', password: ''moodle'')
*[https://school.moodledemo.net/badges/index.php?type=2&id=62 School demo example: Managing course badges] (Log in with username: ''teacher'', password: ''moodle'')
*[https://school.moodledemo.net/badges/mybadges.php School demo example: Viewing your own badges] (Log in with username: ''student'', password: ''moodle'')
*[http://remediatingassessment.blogspot.co.nz/2013/07/research-design-principles-for-studying.html Research Design Principles for Studying Learning with Digital Badges] Re-mediating assessment blog post
*[https://info.badgr.com/resources/sharing-digital-badges-on-social-media.htm Badgr - A Guide to Sharing Digital Badges on Social Media]
[[es:Usando insignias]]
[[de:Auszeichnungen nutzen]]

Using Database

2021-09-07T17:10:27Z

Marycooch: /* See also */

{{Database}}
This page explores ways the [[Database activity]] may be used in your Moodle course.
==Views==
===View list===
The list view shows multiple entries, possibly in a more abbreviated form to ensure all the information fits. You may use the controls at the bottom of the screen to search and sort the contents.
* ''View single'': one item at a time
* ''View list'' : several items at a time (number is user defined)
* ''Add entry'' : add an item to the database
* ''Search'' : search the entries

[[Image:26databaseview.png]]

===Deleting multiple entries===
In List view, a checkbox will appear next to each entry. Select the entries you wish to delete and click the 'Delete selected' button. Alternatively, click the 'Select all' and the 'Delete all' buttons to delete all entries. A warning message will appear asking you to verify what you wish to delete.
==Automatically linking database entries==
If the [[Database auto-linking filter]] is enabled, any entries in a database will be automatically linked to where the concept words and/or phrases appear within the same course. This includes forum postings, internal resources, week summaries etc.

Note: If you do not want particular text to be linked (in a forum posting, say) then you should add <nolink> and </nolink> tags around the text. Alternatively the filter can be disabled for a particular activity.
==Approving and undoing approval of entries==
If, during database set up, 'Approval required' was set to 'Yes' then a teacher can approve an entry by clicking on the tick/checkmark icon.

Once an entry has been approved, it is possible to undo the approval by clicking the circle with a line through it icon.
{|
|[[File:26databaseapprove.png|thumb|Entry approved]]
|[[File:26databaseunapprove.png|thumb|Approval undone]]
|}
Entries waiting for approval may be highlighted for the teacher and the user who added the entry.
{|
|[[File:database highlighting.png|thumb|Highlighted entry waiting for approval]]
|}
==Importing many entries==
You can import entries via a CSV file if you click the "Import entries" link under 'Database activity administration' in the Administration block of your course. CSV means Comma-Separated-Values and is a common format for text interchange.

[[image:Databaseupload.png|800px]]

The easiest way to determine the format of the text file is to manually add an entry to the database and then export it. The resulting export text file may then be edited and used for importing entries. Here's a sample of what a very simple file will look like.

[[Image:Upload_csv_sample.png]]

The expected file format is a plain text file with a list of field names as the first record. The data then follows, one record per line.

The field delimiter defaults to a comma character and the field enclosure is not set by default (field enclosures are characters that surround each field in each record).

Records should be delimited by new lines (usually generated by pressing RETURN or ENTER in your text editor). Tabs can be specified using \t and newlines by \n.

Sample file:
name,height,weight
Kai,180cm,80kg
Kim,170cm,60kg
Koo,190cm,20kg
Note: Certain field types may not be supported.

Do not put spaces after your commas or upload will fail!

After upload page import.php comes back blank if it failed.
If successful you'll read a message like, "1 entries saved".
==Exporting entries==
You can export entries either in CSV (comma separated values) or ODS (OpenOffice Calc) formats by clicking the tab at the top or by clicking the "Export entries" link under 'Database activity administration' in the Administration block in your course. (Both CSV and ODS formats can be opened with MS Excel.)

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

When using the CSV format, the user can select either the comma, semicolon, or tab to separate the fields. The selection of the proper character is important. If users select to use a comma to separate the fields and some of the fields contain data with commas then the number of columns is going to be misaligned and likely cause confusion.

Users can select which fields from the database they wish to have exported. By default, all fields are checked to be included. Choose the fields that you wish to have included in the export.

Once the export type and the fields to be exported have been selected, clicking on the Export entries pushbutton will generate the file. The user will usually have the option of either opening or saving the file.

For information on converting the date export (and import) format, see the discussion [https://moodle.org/mod/forum/discuss.php?d=220505 Standard Database Module - Dates].
==Enabling an RSS feed of recently added entries==
To enable an RSS feed from a database activity, an administrator must first enable RSS feeds for database activities across the whole site as described in [[RSS feeds settings]]. A section called 'RSS' will then appear on the edit settings page of the database activity.
# Edit the database activity settings and set the number of entries in the RSS feed e.g. 5.
# Check that the RSS template includes the required fields.
# Log out and then access the database activity as a guest.
# Copy the 'RSS feed for this activity' link in the administration block.
The RSS feed may then be displayed in an [[Remote RSS feeds block]] or elsewhere.
==Exporting to an external portfolio==
If an external [[Portfolios|portfolio]] such as [[Mahara_portfolio|Mahara]] has been enabled by the administrator then users have the option to export individual entries to that portfolio if the ##export## tag is added to list and/or single templates. They will see at the bottom of a database entry an "export" icon to click on and select the portfolio to export to:

[[File:Exportdatabasentry.png]]
== Creative uses ==
You could use the database module to:
* allow collaboration on building a collection of web links/books/journal references related to a particular subject
* display student created photos/posters/websites/poems for peer comment and review
* gather comments and votes on a shortlist of potential logos/mascot names/project ideas
* provide a [http://moodle.org/mod/forum/discuss.php?d=52699 student file storage area]
* maintain a log of what was done in a face-to-face class each day, so that absent students can get caught up themselves. [http://moodle.org/mod/forum/discuss.php?d=115047 Example]
== See also ==
*[https://school.moodledemo.org/course/view.php?id=57&section=3 Examples of databases in the School demo site] (available for download)
* [[Glossary module]], which performs a similar though more specialised, text-based role
* Moodle in English [http://moodle.org/mod/forum/view.php?id=3505 Database activity module forum]
* [https://moodle.org/mod/data/view.php?d=54 Moodle.org jobs database] - example of a database activity on Moodle.org.
[[de:Datenbank nutzen]]
[[es:Usando BasedeDatos]]

Using Database

2021-09-07T17:10:12Z

Marycooch: /* Example databases */

{{Database}}
This page explores ways the [[Database activity]] may be used in your Moodle course.
==Views==
===View list===
The list view shows multiple entries, possibly in a more abbreviated form to ensure all the information fits. You may use the controls at the bottom of the screen to search and sort the contents.
* ''View single'': one item at a time
* ''View list'' : several items at a time (number is user defined)
* ''Add entry'' : add an item to the database
* ''Search'' : search the entries

[[Image:26databaseview.png]]

===Deleting multiple entries===
In List view, a checkbox will appear next to each entry. Select the entries you wish to delete and click the 'Delete selected' button. Alternatively, click the 'Select all' and the 'Delete all' buttons to delete all entries. A warning message will appear asking you to verify what you wish to delete.
==Automatically linking database entries==
If the [[Database auto-linking filter]] is enabled, any entries in a database will be automatically linked to where the concept words and/or phrases appear within the same course. This includes forum postings, internal resources, week summaries etc.

Note: If you do not want particular text to be linked (in a forum posting, say) then you should add <nolink> and </nolink> tags around the text. Alternatively the filter can be disabled for a particular activity.
==Approving and undoing approval of entries==
If, during database set up, 'Approval required' was set to 'Yes' then a teacher can approve an entry by clicking on the tick/checkmark icon.

Once an entry has been approved, it is possible to undo the approval by clicking the circle with a line through it icon.
{|
|[[File:26databaseapprove.png|thumb|Entry approved]]
|[[File:26databaseunapprove.png|thumb|Approval undone]]
|}
Entries waiting for approval may be highlighted for the teacher and the user who added the entry.
{|
|[[File:database highlighting.png|thumb|Highlighted entry waiting for approval]]
|}
==Importing many entries==
You can import entries via a CSV file if you click the "Import entries" link under 'Database activity administration' in the Administration block of your course. CSV means Comma-Separated-Values and is a common format for text interchange.

[[image:Databaseupload.png|800px]]

The easiest way to determine the format of the text file is to manually add an entry to the database and then export it. The resulting export text file may then be edited and used for importing entries. Here's a sample of what a very simple file will look like.

[[Image:Upload_csv_sample.png]]

The expected file format is a plain text file with a list of field names as the first record. The data then follows, one record per line.

The field delimiter defaults to a comma character and the field enclosure is not set by default (field enclosures are characters that surround each field in each record).

Records should be delimited by new lines (usually generated by pressing RETURN or ENTER in your text editor). Tabs can be specified using \t and newlines by \n.

Sample file:
name,height,weight
Kai,180cm,80kg
Kim,170cm,60kg
Koo,190cm,20kg
Note: Certain field types may not be supported.

Do not put spaces after your commas or upload will fail!

After upload page import.php comes back blank if it failed.
If successful you'll read a message like, "1 entries saved".
==Exporting entries==
You can export entries either in CSV (comma separated values) or ODS (OpenOffice Calc) formats by clicking the tab at the top or by clicking the "Export entries" link under 'Database activity administration' in the Administration block in your course. (Both CSV and ODS formats can be opened with MS Excel.)

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

When using the CSV format, the user can select either the comma, semicolon, or tab to separate the fields. The selection of the proper character is important. If users select to use a comma to separate the fields and some of the fields contain data with commas then the number of columns is going to be misaligned and likely cause confusion.

Users can select which fields from the database they wish to have exported. By default, all fields are checked to be included. Choose the fields that you wish to have included in the export.

Once the export type and the fields to be exported have been selected, clicking on the Export entries pushbutton will generate the file. The user will usually have the option of either opening or saving the file.

For information on converting the date export (and import) format, see the discussion [https://moodle.org/mod/forum/discuss.php?d=220505 Standard Database Module - Dates].
==Enabling an RSS feed of recently added entries==
To enable an RSS feed from a database activity, an administrator must first enable RSS feeds for database activities across the whole site as described in [[RSS feeds settings]]. A section called 'RSS' will then appear on the edit settings page of the database activity.
# Edit the database activity settings and set the number of entries in the RSS feed e.g. 5.
# Check that the RSS template includes the required fields.
# Log out and then access the database activity as a guest.
# Copy the 'RSS feed for this activity' link in the administration block.
The RSS feed may then be displayed in an [[Remote RSS feeds block]] or elsewhere.
==Exporting to an external portfolio==
If an external [[Portfolios|portfolio]] such as [[Mahara_portfolio|Mahara]] has been enabled by the administrator then users have the option to export individual entries to that portfolio if the ##export## tag is added to list and/or single templates. They will see at the bottom of a database entry an "export" icon to click on and select the portfolio to export to:

[[File:Exportdatabasentry.png]]
== Creative uses ==
You could use the database module to:
* allow collaboration on building a collection of web links/books/journal references related to a particular subject
* display student created photos/posters/websites/poems for peer comment and review
* gather comments and votes on a shortlist of potential logos/mascot names/project ideas
* provide a [http://moodle.org/mod/forum/discuss.php?d=52699 student file storage area]
* maintain a log of what was done in a face-to-face class each day, so that absent students can get caught up themselves. [http://moodle.org/mod/forum/discuss.php?d=115047 Example]
== See also ==
*[https://school.moodledemo.net/course/view.php?id=57&section=3 Examples of databases in the School demo site] (available for download)
* [[Glossary module]], which performs a similar though more specialised, text-based role
* Moodle in English [http://moodle.org/mod/forum/view.php?id=3505 Database activity module forum]
[[de:Datenbank nutzen]]
[[es:Usando BasedeDatos]]

Language FAQ

2021-05-18T10:35:28Z

Marycooch: /* Can I add another language keys to my Windows PC? */

{{Language}}

== General ==

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

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

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

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

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

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

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

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

== Default Language ==

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

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

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

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

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

To do updates for already existing users, you can:

* Tell users how to change it themselves in their user profiles by setting their Preferences > Preferred language
* Use the [[Upload users]] tool to do a mass update from a csv file changing the lang field
* If you have access to the database, you can change this with a simple query. See [[ad-hoc_contributed_reports#List_of_users_with_language|here for an example]] of how to do this.

=== When I log in, the language switches to English. Why? ===

* For logged-in users, the language is set to the one they have set as their preferred language (Preferences > User account > Preferred language).
* For logged-out visitors (before they log in) the situation depends on whether the language auto-detection is enabled. They can either get the language their browser claims to be the requested one, or the site default language.

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

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

Actually, the one and only place where Moodle requires some locales to be installed on the machine is when handling date translation (according to [https://tracker.moodle.org/browse/MDL-31622 this information]).

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

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

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

==Warning message: Your server does not seem to fully support the following languages:==
When you install or update a language pack, your server might display the following warning:
Your server does not seem to fully support the following languages:
followed by a list of non-supported languages and the text:
Instead, the global locale (en_AU.UTF-8) will be used to format certain strings such as dates and numbers.
[[File:Your_server_does_not_seem_to_fully_support.png|400px]]

* This is caused by either:
** a problem with the locale (Linux and Mac) or localewin (windows) setting in langconfig.php for your language pack (you can contact your language pack maintainer listed in the [https://lang.moodle.org/local/amos/credits.php translation credits])
** or the configuration of your server.
* If you have a Linux server (or a [[MoodleBox]]), see the documentation about [https://docs.moodle.org/dev/Table_of_locales installing additional locales].
* If you have a Windows or a Mac Moodle server that lacks the proper locales, we can not help you :(

* See the [https://docs.moodle.org/dev/Translation_langconfig developer's documentation]

== Language Customisation and Multi-language ==

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

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

See [[Language customisation]] for details.

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

See the section 'Finding the component and string identifier' in [[Language customisation]].

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

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

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

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

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

Another option is to create activities in different languages and restrict access to them using the [https://moodle.org/plugins/availability_language Restriction by language plugin].

See the discussion [https://moodle.org/mod/forum/discuss.php?d=383302 Multiple Languages] for further options.

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

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

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

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

===Is it possible to use a translation extension in the browser to display a Moodle site in another language===
Yes, according to [https://moodle.org/mod/forum/discuss.php?d=414236#p1669886 this forum post]:

* For Firefox:
** Install the [https://www.mozilla.org/en-US/exp/firefox/new/ Firefox brower] if not already installed on your computer.
** Open Firefox.
** Go to Firefox [https://addons.mozilla.org/en-US/firefox/ Browser Add-ons].
** Search the [https://addons.mozilla.org/en-US/firefox/addon/traduzir-paginas-web/ Translate Web Pages extension], by Filipe Ps, and add it to Firefox.
** Follow the instructions for this extension.

* For Chrome:
** Install [https://www.google.com/intl/en/chrome/ Google Chrome] if not already installed on your computer.
** Open Chrome.
** From the Google Web Store, install the [https://chrome.google.com/webstore/detail/google-translate/aapbdbdomjkkjkaonfhkkikfgjllcleb?utm_source=chrome-ntp-icon Google Translate extension].
** Turn translation on by following [https://www.howtogeek.com/407924/how-to-turn-translation-on-or-off-in-chrome/ these steps] (from How-To Geek).

===Is it possible to change the logo according to language selected, similar to multi-language content?===
Yes. See [https://moodle.org/mod/forum/discuss.php?d=345919 this forum thread]

== Other Language Questions ==

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

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

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

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

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

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

===Why do the characters for my language (not English) show up as hollow squares ?===

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

This problem may be caused by a missing/wrong character set or using a font that does not support the character map needed (see [https://moodle.org/mod/forum/discuss.php?d=327521 this forum thead]).

[[File:Language pack name is displayed.png|400px]]

===Are there statistics for language packs downloads?===
Yes. There are download stats for the past 60 days at [https://download.moodle.org/local/downloadmoodleorg/stats.php Moodle downloads stats]. See under Languages a long list of the different packs that have been downloaded:
[[File:Language packs downloads stats.png]]

===Is it possible to streamline the translation of a Moodle course?===
Kind of... See [https://docs.moodle.org/dev/Translation#Translating_a_Moodle_course Translating a Moodle course] in the developer's documentation.

===Can I disable google page translation on my Moodle site?===
Yes, according to [https://moodle.org/mod/forum/discuss.php?d=419424#p1690452 this post]:
The general answer is to add translate="no" to the html tag of your page, but that requires a code change.
So the Moodle html-page starts with (source https://stackoverflow.com/questions/12238396/how-to-disable-google-translate-from-html-in-chrome)
There are more options in the source discussion that are finer to control.
In moodle/admin/settings.php?section=additionalhtml, you can add in the section
<meta name="google" content="notranslate" />
and that should stop Google chrome to translate...

===Can I add another language key to my Windows PC?===
Yes. If you have an English keyboard in your PC, but you want to write Spanish words like "Hasta mañana" and you need to type the 'ñ' letter, see [https://support.microsoft.com/en-us/windows/manage-the-input-and-display-language-settings-in-windows-10-12a10cb4-8626-9b77-0ccb-5013e0c7c7a2 this link].

== See also ==

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

* MDL-57867 - Email notification language strings lose line breaks when customised bug

==Any further questions?==

Please post in the [http://moodle.org/mod/forum/view.php?f=26 Languages forum] on moodle.org.

[[Category:FAQ]]

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

Dashboard

2021-04-28T07:35:25Z

Marycooch: /* About the Dashboard */

{{Site appearance}}
==About the Dashboard==
The Dashboard is a customisable page for providing users with details of their progress and upcoming deadlines. In the centre is the [[Course overview block]] which allows students and teachers to easily track required activities and filter courses.

{{MediaPlayer | url = https://youtu.be/zHQNLF9ZgL8 | desc = Overview of the Dashboard}}

If course images have been added in the course settings, they will display in the dashboard. Where no images have been added, coloured patterns appear. ('''New in 3.8:''' The administrator can define the colours from Site administration / Appearance /Course pattern colours.)

Quick access to Dashboard is also available from the user menu top right of the screen once logged in:

[[File:usermenufontawesome.png|thumb|center|User menu]]

The Navigation drawer or block includes a Dashboard link directly above or below the Site home link. Once a regular user is logged in, the My courses link will also take them to their Dashboard.

Users can normally customise their Dashboard, adding or removing blocks and changing block positions. They can revert their Dashboard back to the original blocks as follows:

# Click the 'Customise this page' button.
# Click the 'Reset page to default' button.

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

(Note that an administrator can reset the Dashboard for all users from 'Default Dashboard page' in the Site administration).

==Default home page==

For new installations, Dashboard is the default home page for logged in users. An administrator can change the default home page in ''Administration > Site administration > Appearance > Navigation''.

If 'User preference' is selected as default home page, each user needs to set the desired page – Site home ore Dashboard – under User menu > Preferences > User account > Home page. Once selected, Moodle will remember which page to present them each time they log on.

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

==Setting the default Dashboard==

An administrator or manager (or other user with the capability [[Capabilities/moodle/my:configsyspages|moodle/my:configsyspages]]) can set the default blocks for all users from ''Administration > Site administration > Appearance > Default Dashboard page''.

Clicking the button 'Reset Dashboard for all users' will then apply these settings to the Dashboard for everyone on the site.

Default blocks are:
* [[Navigation block|Navigation]]
* [[Administration block|Administration]]
* [[Course overview block|Course overview]]
* [[Private files block|Private files]]
* [[Latest badges block|Latest badges]]
* [[Calendar block|Calendar]]
* [[Upcoming events block|Upcoming events]]
* [[Online users block|Online users]]

==Preventing users from customizing their Dashboard==

By default, users can customize their Dashboard and add blocks. An admin can prevent this as follows:

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

==Dashboard capabilities==

* [[Capabilities/moodle/my:manageblocks|Manage Dashboard blocks]] (see above)
* [[Capabilities/moodle/my:configsyspages|Configure system templates for Dashboard]]

In addition, all blocks which may be added to a Dashboard have a ''myaddinstance'' capability (e.g. [[Capabilities/block/comments:myaddinstance|block/comments:myaddinstance]]) for controlling whether a user with a particular role can add the block.

==Preventing users from adding a block to their Dashboard==

By default, users can add many blocks to their Dashboard. An admin can prevent them from adding a particular block, such as the [[Online users block]], as follows:

# Go to ''Administration > Site administration > Users > Permissions > Define roles''
# Edit the authenticated user role and untick the [[Capabilities/block/online users:myaddinstance|Add a new online users block to the Dashboard capability]]

==Blocks not available on the Dashboard==

The following blocks may not be added to a user's Dashboard (because it wouldn't make sense):

*[[Course completion status block]]
*[[Course/site summary block]]
*[[Self completion block]]

==See also==

* [https://moodle.org/mod/forum/discuss.php?d=340126 Show Categories of courses on Dashboard after sign in] forum discussion
* [https://moodle.org/mod/forum/discuss.php?d=418596#p1693029 Hide a block from student roles?] forum discussion

[[eu:Nire_Moodle]]
[[fr:Tableau de bord]]
[[de:Dashboard]]
[[es:Tablero]]

No authentication

2021-03-25T10:47:07Z

Marycooch: updating link from Site policies to Site security settings

{{Authentication}}
[[File:no auth.png|thumb|left|Login page when using no authentication]]An administrator can enable 'No authentication' in 'Manage authentication' in the Site administration.

With the "No Authentication" method enabled, a user can create an account without any kind of authentication from other systems, and with no email-based confirmation that the email address that they have provided is valid, or even exists!

{{warning|message=This creates a very insecure Moodle site, and is not recommended.}}

This is an option that would normally be used only for testing purposes or if your Moodle site is not available on the Internet.

The configuration page for this option only offers the ability to lock fields, enable or disable guest access, and provide an alternative login page, in the same way as other authentication plugins.

Note: You need to un-tick 'Email change confirmation' in 'Site security settings' to avoid new users being asked to confirm their email address after updating their profile.

If you want to change the text that appears under "Is this your first time here?", use the Language Customization tool to edit the language string 'loginstepsnone' found in moodle.php. Note, this string is different from 'loginsteps', which is the string used for Email-based Self-registration. Text added in the Instructions box found in Site administration ... Plugins ... Authentication ... Manage authentication is not displayed when No Authentication is used; you must edit the language string to make changes.

[[de:Ohne Authentifizierung]]
[[es:Sin Autenticación]]
[[eu:Autentifikatu_gabe]]
[[fr:Pas d'authentification]]
[[ja:認証なし]]

Messaging

2021-03-15T14:38:18Z

Marycooch: note about teachers being in the group with students for group messaging

{{More features}}

==About messaging==
Unless disabled by the administrator (in Site administration > Messaging > Messaging settings), teachers, students and other users may send and receive private messages via Moodle. This is in addition to receiving [[Notifications|notifications]] about assignments, forum discussions etc.

{{MediaPlayer | url = https://youtu.be/-hycmrpw0xA | desc = 3.7 New messaging features}}

*A number at the top of the screen reflects the number of people who have sent new messages.
*Clicking the icon displays the messaging drawer, divided into starred messages, group messages and personal messages.
*Contacts and contact requests may be accessed from the Contacts link.
*A star may be added by clicking the three dots when viewing a message
*From the three dots, messages may be muted, so that email notifications of new messages are no longer sent:

[[File:SmallMuteMessages.png]]

*Clicking the cog icon displays privacy settings, notification preferences and the option to press enter to send messages.

[[File:36messagingprivacysettings.png]]

==Personal messaging space==

Each user now has their own starred area where they can add draft messages, links and notes for later use:

[[File:SmallPersonalSpace.png]]

==Deleting messages==

Messages may be deleted by clicking them, ensuring they are selected (with a visible checkmark) and then clicking the bin/trash can icon at the bottom of the messaging drawer. Note that messages are only deleted for that particular user, not others involved in the conversation.

===Enabling teachers to delete the messages of others===

To enable a teacher to delete messages of others in a group conversion:

# Create a [[Creating custom roles|custom role]] with the capability [[Capabilities/moodle/site:deleteanymessage| moodle/site:deleteanymessage]] allowed.
# Assign the user this role as a system role (via Site admin / Users / Permissions / Assign system roles).

Note that it is fine for a user to have the role of teacher in a course and also a system role enabling them to delete any message.

[[File:DeleteAnyMessage.png]]

==Restricting who can message you==

By default when clicking the cog icon, a user has the option to restrict messages to their contacts only or to their contacts and others in their courses. However the administrator can enable site wide messaging, thus giving visibility to all users, from a setting in Site administration > Messaging > Messaging settings.

==Group messaging==

A teacher or user with the capability [[Capabilities/moodle/course:creategroupconversations | moodle/course:creategroupconversations]] can enable group messaging when setting up a course group. The group will then appear in the group messaging section of the messaging drawer. The teacher or other user should be a member of the group in order to see the group messages.

==Sending a message to selected course participants==

A teacher can send a message to course participants as follows:

# Go to the Participants page.
# Select participants from the list or use the "Select all" button at the bottom of the list.
# Choose "Add/send message" from the "With selected users..." drop-down menu.
# Assuming you are satisfied with the message, click the "Send" button.

Administrators can also send a message to users in many courses via [[Bulk user actions]].

==See also==
*[[Notifications]]
*[[Messaging settings]]
*[[Messaging FAQ]]

[[Category:Messaging]]

[[es:Mensajería]]
[[eu:Mezularitza]]
[[de:Mitteilungen]]
[[fr:Messagerie]]
[[ja:メッセージング]]

Groups

2021-03-15T14:37:36Z

Marycooch: note about teachers being in the group with students for group messaging

{{Grouping users}}
==Why use groups?==
*You are a teacher in a course where you have several classes and you want to filter your activities and gradebook so you only see one class at a time.
*You are a teacher sharing a course with other teachers and you want to filter your activities and gradebook so you don’t see the students from your colleagues’ classes.
*You want to allocate a particular activity, resource or topic section to just one class or set of users and you don’t want others to see it.

{{MediaPlayer | url = https://youtu.be/X9aQ2TiYXs0| desc = How to add groups to courses}}

*This [https://youtu.be/pKAFWItexUY screencast about using groups] also highlights the benefits of using groups.

==Group levels==
[[File:groupmodecourse.png|thumb|Groups settings in course settings]]
A group or grouping can be used on two levels:

*Course level - The group mode defined at the course level is the default mode for all activities defined within that course. To use groups you need first to set a group mode in ''Administration > Course administration > Edit settings.''

*Activity level - Each activity that supports groups can also have its own group mode defined. If the course setting "Force group mode" is set to "Yes" then the option to define the group mode for individual activities is not available. If it is set to "No", then the teacher may change the group mode:

===Group modes===

There are three group modes

*No groups - There are no sub groups, everyone is part of one big community
*Separate groups - Each group can only see their own group, others are invisible.
*Visible groups - Each group works in their own group, but can also see other groups. (The other groups' work is read-only.)

For example, enabling either separate or visible groups on an assignment drop-box enables staff to filter the student submissions to see only those from a particular tutor group. With visible groups, students can see which other groups are doing the same activities as they are; with separate groups, they do not know which other groups are doing the same activities.

Using groups with discussion forums allow teachers to restrict interaction between students. Separate groups mean only students in the same group can see and participate in discussions within a particular forum. Visible groups allow students to see other group's discussions, but only participate in their own group's discussions.

'''Note:''' Where visible groups are used or the participant can access all groups, the user's own group is shown first, followed by other groups:

[[File:mygroupsfirst.png]]

==Creating a group==
# Click the ''Create group'' button:
## (using the Boost theme) select ''Participants'' from the navigation drawer, click the ''⚙'' (actions menu) on the right, then ''Groups''.
## (using the Classic theme) ''Administration > Course administration > Users > Groups''
#Add a group name and optional description (displayed above the list of group members on the participants page), [[Enrolment key|enrolment key]] and picture (displayed on the participants page and next to forum posts)
#Tick the box Enable group messaging if you wish to enage in group conversations. You will then be able to send group messages from the messaging drawer. Make sure you are in the group as well as your students. See [[Messaging]] for more information.
#Click the 'Save changes' button
#Select the group to which you want to add participants, then click the 'Add/remove users button
# In the "Potential members" list, select the users you want to add to the group. Multiple users may be selected using the Crtl key.
# Click the Add button to add the users to the group

An optional group ID number (an advanced setting) may be added for matching the group against external systems. Group ID numbers are not displayed anywhere on the site. Within a course, all group ID numbers must be unique. Thus it's not possible to create a group with a duplicate group ID number.

Note: In Moodle 3.8, a default group icon is displayed in forum posts when there is no group picture set (MDL-67959). A workaround to the problem is to hide the picture in the group settings.

==Auto-create groups==
[[File:autocreategroups.png|thumb|Auto-create groups]]
Groups may be created automatically via the 'Auto-create groups' button in ''Administration > Course administration > Users > Groups''. To see all the settings, click the ''Expand all'' link top right.

===General===
A '''naming scheme''' can be created automatically. # is replaced by sequential numbers, and @ by letters. For example:
*''Group @'' will create group with a naming scheme Group A, Group B, Group C . . .
*''Group #'' will create group with a naming scheme Group 1, Group 2, Group 3 . . .

You can specify if you would like to create
*x number of Groups or
*each group contain x number of students

=== Prevent last small group ===

When selecting '''Members per group''', depending on the number of users in the course, the last group can end up with significantly fewer members than expected. You can select '''Prevent last small group''' to avoid the situation. If the last group would be smaller than 70% of the expected size, it will not be created. Instead, Moodle will allocate additional members to existing groups rather then create a new group with few members.

Example 1:
:You have a course with 80 students and you let auto-create groups with 30 members per group. There would be just 20 students in the third group which is 66% out of expected 30. Moodle will auto-create only two groups with 40 students in each.

Example 2:
:You have a course with 81 students and you let auto-create groups with 30 members per group. Moodle will create three groups with 30, 30 and 21 members respectively because 21 is 70% out of expected 30.

Hint: If you need to customize the 70% ratio used in these calculations on your site, ask your administrator to set the constant `AUTOGROUP_MIN_RATIO` in the main config.php.

define('AUTOGROUP_MIN_RATIO', 0.95); // Means the smallest group will have at least 95% of the expected size.

===Group members===
''Select members from ...'' allows you to choose from roles assigned within the course, available cohorts, groups or groupings.
'''Specify''' and '''Group/Member count''' work together.

The setting 'Select members from cohort' lists all cohorts which users enrolled on the current course are part of. The number in brackets is the number of users enrolled on the course in that cohort.

The 'Ignore users in groups' checkbox should be ticked to only select group members from users that are NOT already in a group in the course.

The 'Include only active enrolments' checkbox provides the option to choose whether to include suspended users in groups. The checkbox is only displayed to users with the [[Capabilities/moodle/course:viewsuspendedusers|capability to view suspended users]].

===Grouping===

'''Create in grouping''' and '''Grouping name''' allows you to create a new grouping and allocate the new auto-created groups to be created to it.

Prior to creating the groups, you can view the groups.

==Restricting an activity, resource or course topic to a particular group==
[[File:group restriction.png|frame|Restricting an activity to a particular group]]
To be able to restrict an activity, resource or course topic to a group, [[Restrict access]] must be enabled. This will result in a 'Restrict access' section in the activity, resource or topic settings and a group restriction can then be added.

==Groups and enrol plugins==

Where groups are created automatically with enrol plugins such as IMS Enterprise, members cannot be unenrolled manually via the groups screen inside a course. This has to be done from the plugin. Additionally, when group members are owned by a plugin like this, there is information below their name on the groups screen.

==Groups overview==

A overview of groups and groupings is available via the Overview tab in ''Administration > Course administration > Users > Groups''.

The table may be filtered to display particular [[Groupings|groupings]] or groups and it will also display students who are not in a group.

==Groups capabilities==

*[[Capabilities/moodle/course:managegroups|Manage groups]]
*[[Capabilities/moodle/site:accessallgroups|Access all groups]]
*[[Capabilities/moodle/calendar:managegroupentries|Manage group calendar entries]]

==See also==

* [[Upload users]] - for importing users into groups
* [[Enrolment key]]
* [https://moodle.org/plugins/local_autogroup Autogroup additionalplugin] - A local plugin which automatically assigns enrolled users on a course into groups dependant upon information within their user profile. (Now with custom profile field support - called User Info Field in settings.) This plugin will create, update, and delete groups automatically to match the users on your course.

[[de:Gruppen]]
[[fr:Groupes]]
[[ja:グループ]]
[[es:Grupos]]

Capabilities/moodle/course:creategroupconversations

2021-03-15T14:36:20Z

Marycooch:

This capability allows the user to enable group messaging when creating a course group.

It is allowed by default for the roles of [[Teacher]] and [[Manager]] and not set for other roles. Someone with this capability must ensure they are also a member of the group in order to see the messages.

[[es:Capabilities/moodle/course:creategroupconversations]]

Images

2021-02-20T19:49:51Z

Marycooch:

{{Working with media}}
Moodle allows teachers and students to upload and display images from a variety of sources via the image icon of the [[Atto editor]]. Course pages can be enhanced with images (or banners) in each section. Assignments can include images for extra clarification. Images attached to forum posts or quiz questions will appear embedded.

{{MediaPlayer | url = https://youtu.be/LbI3dTQCL_o | desc = Adding images}}
Moodle accepts .jpg,.png,.svg and .gif formats.

==Dragging and dropping an image==

*Images may be dragged and dropped directly into the [[Atto editor]] if you are using a supported browser (not IE 9, Safari 6 or below or earlier versions of Firefox) and can be dragged and dropped directly onto the course page if the editing is turned on and 'media drag and drop" is enabled in ''Administration > Site administration > Plugins > Activity modules > Label''.
* See [[Using Label]] for more information.

==Copying and pasting an image==

In Moodle 3.9 onwards, images can be copied from anywhere and pasted into the [[Atto editor]]. For example, you can copy and paste an image from a word-processed document or take a screenshot, copy it to your clipboard and then paste it into the Atto editor.

==Uploading and displaying an image from your computer==

*''Note:'' It is a good idea to resize your image before uploading, rather than altering its dimensions online.
*With the editing turned on, go to where you want to display your image (e.g. in a course summary, label or page)
*Click the image icon as below

[[File:ImageIcon310.png]]

*Either enter the URL of an image which is already online or click 'Browse repositories' to access the File picker
*Click [[Upload a file]]. Browse for and upload your image. For more information, see [[File picker]]
*Either add a description of the image or tick/check the box 'This image is decorative only'.
*Alter the size and alignment if needed and save the image

[[File:ImageUpload310.png]]

==Editing an uploaded image==

If you need to edit the image once it has been uploaded,you can double-click on the image from within the [[Text editor| Atto text editor]] and access the image properties window. ''Note it is much better to upload an image of the desired size rather than modifying it afterwards.''

==Displaying an image already online==
If you have images available elsewhere online, you can display them too without the need to upload to Moodle by entering their online address in the Enter URL field. ''Note:'' If the image is taken offline, it will be replaced by a red X on your course page. Linking [http://simple.wikipedia.org/wiki/Hot-linking] to images online if you don't own them yourself is not recommended.

[[de:Bilder]]
[[es:Imágenes]]
[[fr:Images]]

Talk:Keyholder role

2021-02-15T19:27:43Z

Marycooch: replying to Randy

Whoever put the Norman Bates with the shower icon as the keyholder: are you sure your mother would approve? ;) --[[User:Randy Thornton|Randy Thornton]] ([[User talk:Randy Thornton|talk]]) 19:18, 15 February
2021 (UTC)

Guilty as charged :) It was a long time ago though. If you think I should update the image I'm happy to do so, now I'm older and less light-hearted! --[[User:Mary Cooch|Mary Cooch]] ([[User talk:Mary Cooch|talk]]) 19:27, 15 February 2021 (UTC)

Groups

2021-02-12T07:20:55Z

Marycooch: /* Why use groups? */

{{Grouping users}}
==Why use groups?==
*You are a teacher in a course where you have several classes and you want to filter your activities and gradebook so you only see one class at a time.
*You are a teacher sharing a course with other teachers and you want to filter your activities and gradebook so you don’t see the students from your colleagues’ classes.
*You want to allocate a particular activity, resource or topic section to just one class or set of users and you don’t want others to see it.

{{MediaPlayer | url = https://youtu.be/X9aQ2TiYXs0| desc = How to add groups to courses}}

*This [https://youtu.be/pKAFWItexUY screencast about using groups] also highlights the benefits of using groups.

==Group levels==
[[File:groupmodecourse.png|thumb|Groups settings in course settings]]
A group or grouping can be used on two levels:

*Course level - The group mode defined at the course level is the default mode for all activities defined within that course. To use groups you need first to set a group mode in ''Administration > Course administration > Edit settings.''

*Activity level - Each activity that supports groups can also have its own group mode defined. If the course setting "Force group mode" is set to "Yes" then the option to define the group mode for individual activities is not available. If it is set to "No", then the teacher may change the group mode:

===Group modes===

There are three group modes

*No groups - There are no sub groups, everyone is part of one big community
*Separate groups - Each group can only see their own group, others are invisible.
*Visible groups - Each group works in their own group, but can also see other groups. (The other groups' work is read-only.)

For example, enabling either separate or visible groups on an assignment drop-box enables staff to filter the student submissions to see only those from a particular tutor group. With visible groups, students can see which other groups are doing the same activities as they are; with separate groups, they do not know which other groups are doing the same activities.

Using groups with discussion forums allow teachers to restrict interaction between students. Separate groups mean only students in the same group can see and participate in discussions within a particular forum. Visible groups allow students to see other group's discussions, but only participate in their own group's discussions.

'''Note:''' Where visible groups are used or the participant can access all groups, the user's own group is shown first, followed by other groups:

[[File:mygroupsfirst.png]]

==Creating a group==
# Click the ''Create group'' button:
## (using the Boost theme) select ''Participants'' from the navigation drawer, click the ''⚙'' (actions menu) on the right, then ''Groups''.
## (using the Classic theme) ''Administration > Course administration > Users > Groups''
#Add a group name and optional description (displayed above the list of group members on the participants page), [[Enrolment key|enrolment key]] and picture (displayed on the participants page and next to forum posts)
#Tick the box Enable group messaging if you wish to enage in group conversations. You will then be able to send group messages from the messaging drawer. See [[Messaging]] for more information.
#Click the 'Save changes' button
#Select the group to which you want to add participants, then click the 'Add/remove users button
# In the "Potential members" list, select the users you want to add to the group. Multiple users may be selected using the Crtl key.
# Click the Add button to add the users to the group

An optional group ID number (an advanced setting) may be added for matching the group against external systems. Group ID numbers are not displayed anywhere on the site. Within a course, all group ID numbers must be unique. Thus it's not possible to create a group with a duplicate group ID number.

Note: In Moodle 3.8, a default group icon is displayed in forum posts when there is no group picture set (MDL-67959). A workaround to the problem is to hide the picture in the group settings.

==Auto-create groups==
[[File:autocreategroups.png|thumb|Auto-create groups]]
Groups may be created automatically via the 'Auto-create groups' button in ''Administration > Course administration > Users > Groups''. To see all the settings, click the ''Expand all'' link top right.

===General===
A '''naming scheme''' can be created automatically. # is replaced by sequential numbers, and @ by letters. For example:
*''Group @'' will create group with a naming scheme Group A, Group B, Group C . . .
*''Group #'' will create group with a naming scheme Group 1, Group 2, Group 3 . . .

You can specify if you would like to create
*x number of Groups or
*each group contain x number of students

=== Prevent last small group ===

When selecting '''Members per group''', depending on the number of users in the course, the last group can end up with significantly fewer members than expected. You can select '''Prevent last small group''' to avoid the situation. If the last group would be smaller than 70% of the expected size, it will not be created. Instead, Moodle will allocate additional members to existing groups rather then create a new group with few members.

Example 1:
:You have a course with 80 students and you let auto-create groups with 30 members per group. There would be just 20 students in the third group which is 66% out of expected 30. Moodle will auto-create only two groups with 40 students in each.

Example 2:
:You have a course with 81 students and you let auto-create groups with 30 members per group. Moodle will create three groups with 30, 30 and 21 members respectively because 21 is 70% out of expected 30.

Hint: If you need to customize the 70% ratio used in these calculations on your site, ask your administrator to set the constant `AUTOGROUP_MIN_RATIO` in the main config.php.

define('AUTOGROUP_MIN_RATIO', 0.95); // Means the smallest group will have at least 95% of the expected size.

===Group members===
''Select members from ...'' allows you to choose from roles assigned within the course, available cohorts, groups or groupings.
'''Specify''' and '''Group/Member count''' work together.

The setting 'Select members from cohort' lists all cohorts which users enrolled on the current course are part of. The number in brackets is the number of users enrolled on the course in that cohort.

The 'Ignore users in groups' checkbox should be ticked to only select group members from users that are NOT already in a group in the course.

The 'Include only active enrolments' checkbox provides the option to choose whether to include suspended users in groups. The checkbox is only displayed to users with the [[Capabilities/moodle/course:viewsuspendedusers|capability to view suspended users]].

===Grouping===

'''Create in grouping''' and '''Grouping name''' allows you to create a new grouping and allocate the new auto-created groups to be created to it.

Prior to creating the groups, you can view the groups.

==Restricting an activity, resource or course topic to a particular group==
[[File:group restriction.png|frame|Restricting an activity to a particular group]]
To be able to restrict an activity, resource or course topic to a group, [[Restrict access]] must be enabled. This will result in a 'Restrict access' section in the activity, resource or topic settings and a group restriction can then be added.

==Groups and enrol plugins==

Where groups are created automatically with enrol plugins such as IMS Enterprise, members cannot be unenrolled manually via the groups screen inside a course. This has to be done from the plugin. Additionally, when group members are owned by a plugin like this, there is information below their name on the groups screen.

==Groups overview==

A overview of groups and groupings is available via the Overview tab in ''Administration > Course administration > Users > Groups''.

The table may be filtered to display particular [[Groupings|groupings]] or groups and it will also display students who are not in a group.

==Groups capabilities==

*[[Capabilities/moodle/course:managegroups|Manage groups]]
*[[Capabilities/moodle/site:accessallgroups|Access all groups]]
*[[Capabilities/moodle/calendar:managegroupentries|Manage group calendar entries]]

==See also==

* [[Upload users]] - for importing users into groups
* [[Enrolment key]]
* [https://moodle.org/plugins/local_autogroup Autogroup additionalplugin] - A local plugin which automatically assigns enrolled users on a course into groups dependant upon information within their user profile. (Now with custom profile field support - called User Info Field in settings.) This plugin will create, update, and delete groups automatically to match the users on your course.

[[de:Gruppen]]
[[fr:Groupes]]
[[ja:グループ]]
[[es:Grupos]]

Data privacy

2021-02-11T07:59:21Z

Marycooch: adding a note about Windows

{{Privacy}}
The Data privacy functionality provides the workflow for users to submit a data request (also known as a subject access request or SAR) and for the site administrator or privacy officer to process these requests.

==Privacy officer role==

It is recommended that you create a [[Privacy officer role]] and assign it to the person responsible. If there is nobody on the site with the role of privacy officer i.e. nobody with the capability to manage data requests, then a site admin can respond to data requests and manage the data registry.

==Data requests==
[[File:requesting data.png|thumb|Requesting data]]
Any user can send a message to the privacy officer via the 'Contact the privacy officer' link on their profile page.

In addition, they can request a copy of all of their personal data or request that their personal data should be deleted as follows:

# Go to your profile page (via the user menu).
# Click the link 'Data requests' then click the 'New request' button.
# Select 'Export all of my personal data' or 'Delete all of my personal data' as appropriate.
# Save changes.
[[File:Request approved.png|thumb|Request approved]]
The privacy officer will then receive a data request notification.

If the user has requested a copy of all of their personal data, once the request is approved, they will receive a notification to inform them that their personal data may be downloaded from their Data requests page. In Moodle 3.5.2 onwards, the user has by default one week to download their data before the download link expires. (An administrator can set a different expiry time for the data request in 'Privacy settings' in the Site administration.)

{{Note|Users on Windows computers are advised to use a program such as 7zip to extract their data from the downloaded folder, as the standard Windows unzipping feature will display an error message.}}

If the user has requested that their personal data should be deleted, once the request is approved, they will receive an email to inform them and they will no longer be able to log in to the site.

==Responding to data requests==
[[File:viewing a data request.png|thumb|Viewing a data request]]
The privacy officer can respond to data requests as follows:

# Go to 'Data requests' in the Site administration (or follow the link in the data request notification).
# In the Actions dropdown, select View, Approve, or Deny as appropriate.

If the user has sent a message, the privacy officer can view the message and copy the user's email address, then reply via email. In Moodle 3.5.2 onwards, after replying they can mark it as complete.

==Automatic approval of data export and deletion requests==

Data export and deletion requests may be automatically approved, rather than the privacy officer having to manually approve each one. This feature may be enabled in Site administration / Users / Privacy and policies / Privacy settings.

==Deletion of user data==

When a user's data is deleted, any forum posts are blanked and replaced with a sentence stating that the post has been removed. However, if the user started any discussions, their name is currently still shown on the forum page (MDL-62865).

==Allowing only the privacy officer to download data==

In Moodle 3.5.2 onwards, organisations with multiple systems and a centralised request process can prevent users from downloading their own data and instead enable a privacy officer to download it for them.

# Go to 'Define roles' in the Site administration.
# For the authenticated user role unset the capability [[Capabilities/tool/dataprivacy:downloadownrequest|Download your own exported data]] and save changes.
# For the privacy officer role allow the capability [[Capabilities/tool/dataprivacy:downloadallrequests|Download exported data for everyone]] and save changes.

The privacy officer can then make a data request on behalf of a user (via 'Data requests' in the Site administration), approve it and later download it via the Actions dropdown menu. In this situation, the privacy officer will receive notification messages and NOT the user.

==Data registry==
[[File:data registry.png|thumb|Data registry]]
The privacy officer can set purposes (why the organisation is processing data) with retention periods and categories for data stored in Moodle in the data registry. Different types of data may need to be stored for different lengths of time. For example, student submissions to an assessment may need to be retained indefinitely to be able to provide evidence of student accomplishments, whereas general coursework such as forum posts might only be retained until graduation + 12 months.

A default purpose and retention period may be set for course categories, courses, activity modules and blocks. The retention period is measured from the course end date for the course that an activity is in. For a user it is from the last login time for any user who is no longer enrolled (or has already been deleted).

===Example categories===

* Administrative: Civil status, identity, identification data, images …
* Personal life (lifestyle, family situation, etc.)
* Economic and financial information (income, financial situation, tax situation, etc.)
* Connection data (IP address, logs, etc.)
* Educational Data (Assessed Coursework, exam scripts etc)
* Records of Education Attainment (Results of exams, assessments, qualifications awarded etc)
* Location data (travel, GPS data, GSM, etc.)

===Data registry set-up===

To add purposes and categories:

# Go to 'Data registry' in the Site administration.
# In the Edit menu select Categories.
# On the 'Edit categories' page, click the + button to add a new category.
# Enter a category name and description then click the Save button.
# Go to 'Data registry' again and in the Edit menu select Purposes.
# On the 'Edit purposes' page, click the + button to add a new purpose.
# Enter a purpose name, description and retention period then click the Save button.

Purposes and categories need to be created before they can be set as defaults. Note that default data registry categories and purposes are only applied to all newly created instances of that type (a course for example). Any content that has been created before defaults are set are not impacted.

To set default categories and purposes:

# In 'Data registry' in the Site administration click the 'Set defaults' button.
# Select a default category and purpose for the site, and for users, course categories, courses, activity modules and blocks as required.
# Save changes.

=== Setting categories and purposes for existing contexts ===

The Data registry interface is used for navigation the contexts of the site to set the category and purpose for them, and thus the data retention period for that context.

At the very least, the site admin should set the category and purpose at the site level. Once this is saved, all lower contexts will inherit from that level. The admin can then choose to set different category and purposes for different levels of context, such as having a specific course with a longer or shorter retention period thus overriding the inherited values.

==Data deletion==

The Data deletion page (Site administration / Users / Privacy and policies / Data deletion) lists the contexts that are past their allocated retention period and need to be confirmed for user data deletion. Once the selected contexts have been confirmed for deletion, the user data related to these contexts will be deleted on the next execution of the "Delete expired contexts" [[Scheduled tasks|scheduled task]].

==Capabilities==

* [[Capabilities/tool/dataprivacy:managedataregistry|Manage data registry]]
* [[Capabilities/tool/dataprivacy:managedatarequests|Manage data requests]]
* [[Capabilities/tool/dataprivacy:makedatarequestsforchildren|Make data requests for children]]
* [[Capabilities/tool/dataprivacy:downloadallrequests|Download exported data for everyone]]
* [[Capabilities/tool/dataprivacy:downloadownrequest|Download your own exported data]]
* [[Capabilities/tool/dataprivacy:makedatadeletionrequestsforchildren|Request data deletion for minors]]
* [[Capabilities/tool/dataprivacy:requestdelete|Request data deletion for yourself]]
* [[Capabilities/tool/dataprivacy:requestdeleteforotheruser|Request data deletion on behalf of another user]]

==Plugin privacy registry==

The Plugin privacy registry (Site administration / Users / Privacy and policies / Plugin privacy registry) lists all plugins in Moodle, and identifies whether they comply with the privacy API or not. Any plugins which are flagged with the warning icon do not yet implement the Moodle privacy API. If this plugin stores any personal data it will not be able to be exported or deleted through Moodle's privacy system.

[[Category: Privacy]]

[[es:Privacidad de datos]]
[[de:Datenschutz]]
[[fr:Plugin Data Privacy]]

Data privacy

2021-02-11T07:58:04Z

Marycooch: adding a note about Windows

{{Privacy}}
The Data privacy functionality provides the workflow for users to submit a data request (also known as a subject access request or SAR) and for the site administrator or privacy officer to process these requests.

==Privacy officer role==

It is recommended that you create a [[Privacy officer role]] and assign it to the person responsible. If there is nobody on the site with the role of privacy officer i.e. nobody with the capability to manage data requests, then a site admin can respond to data requests and manage the data registry.

==Data requests==
[[File:requesting data.png|thumb|Requesting data]]
Any user can send a message to the privacy officer via the 'Contact the privacy officer' link on their profile page.

In addition, they can request a copy of all of their personal data or request that their personal data should be deleted as follows:

# Go to your profile page (via the user menu).
# Click the link 'Data requests' then click the 'New request' button.
# Select 'Export all of my personal data' or 'Delete all of my personal data' as appropriate.
# Save changes.
[[File:Request approved.png|thumb|Request approved]]
The privacy officer will then receive a data request notification.

If the user has requested a copy of all of their personal data, once the request is approved, they will receive a notification to inform them that their personal data may be downloaded from their Data requests page. In Moodle 3.5.2 onwards, the user has by default one week to download their data before the download link expires. (An administrator can set a different expiry time for the data request in 'Privacy settings' in the Site administration.)

Note that users on Windows computers are advised to use a program such as 7zip to extract their data from the downloaded folder, as the standard Windows unzipping feature will display an error message.

If the user has requested that their personal data should be deleted, once the request is approved, they will receive an email to inform them and they will no longer be able to log in to the site.

==Responding to data requests==
[[File:viewing a data request.png|thumb|Viewing a data request]]
The privacy officer can respond to data requests as follows:

# Go to 'Data requests' in the Site administration (or follow the link in the data request notification).
# In the Actions dropdown, select View, Approve, or Deny as appropriate.

If the user has sent a message, the privacy officer can view the message and copy the user's email address, then reply via email. In Moodle 3.5.2 onwards, after replying they can mark it as complete.

==Automatic approval of data export and deletion requests==

Data export and deletion requests may be automatically approved, rather than the privacy officer having to manually approve each one. This feature may be enabled in Site administration / Users / Privacy and policies / Privacy settings.

==Deletion of user data==

When a user's data is deleted, any forum posts are blanked and replaced with a sentence stating that the post has been removed. However, if the user started any discussions, their name is currently still shown on the forum page (MDL-62865).

==Allowing only the privacy officer to download data==

In Moodle 3.5.2 onwards, organisations with multiple systems and a centralised request process can prevent users from downloading their own data and instead enable a privacy officer to download it for them.

# Go to 'Define roles' in the Site administration.
# For the authenticated user role unset the capability [[Capabilities/tool/dataprivacy:downloadownrequest|Download your own exported data]] and save changes.
# For the privacy officer role allow the capability [[Capabilities/tool/dataprivacy:downloadallrequests|Download exported data for everyone]] and save changes.

The privacy officer can then make a data request on behalf of a user (via 'Data requests' in the Site administration), approve it and later download it via the Actions dropdown menu. In this situation, the privacy officer will receive notification messages and NOT the user.

==Data registry==
[[File:data registry.png|thumb|Data registry]]
The privacy officer can set purposes (why the organisation is processing data) with retention periods and categories for data stored in Moodle in the data registry. Different types of data may need to be stored for different lengths of time. For example, student submissions to an assessment may need to be retained indefinitely to be able to provide evidence of student accomplishments, whereas general coursework such as forum posts might only be retained until graduation + 12 months.

A default purpose and retention period may be set for course categories, courses, activity modules and blocks. The retention period is measured from the course end date for the course that an activity is in. For a user it is from the last login time for any user who is no longer enrolled (or has already been deleted).

===Example categories===

* Administrative: Civil status, identity, identification data, images …
* Personal life (lifestyle, family situation, etc.)
* Economic and financial information (income, financial situation, tax situation, etc.)
* Connection data (IP address, logs, etc.)
* Educational Data (Assessed Coursework, exam scripts etc)
* Records of Education Attainment (Results of exams, assessments, qualifications awarded etc)
* Location data (travel, GPS data, GSM, etc.)

===Data registry set-up===

To add purposes and categories:

# Go to 'Data registry' in the Site administration.
# In the Edit menu select Categories.
# On the 'Edit categories' page, click the + button to add a new category.
# Enter a category name and description then click the Save button.
# Go to 'Data registry' again and in the Edit menu select Purposes.
# On the 'Edit purposes' page, click the + button to add a new purpose.
# Enter a purpose name, description and retention period then click the Save button.

Purposes and categories need to be created before they can be set as defaults. Note that default data registry categories and purposes are only applied to all newly created instances of that type (a course for example). Any content that has been created before defaults are set are not impacted.

To set default categories and purposes:

# In 'Data registry' in the Site administration click the 'Set defaults' button.
# Select a default category and purpose for the site, and for users, course categories, courses, activity modules and blocks as required.
# Save changes.

=== Setting categories and purposes for existing contexts ===

The Data registry interface is used for navigation the contexts of the site to set the category and purpose for them, and thus the data retention period for that context.

At the very least, the site admin should set the category and purpose at the site level. Once this is saved, all lower contexts will inherit from that level. The admin can then choose to set different category and purposes for different levels of context, such as having a specific course with a longer or shorter retention period thus overriding the inherited values.

==Data deletion==

The Data deletion page (Site administration / Users / Privacy and policies / Data deletion) lists the contexts that are past their allocated retention period and need to be confirmed for user data deletion. Once the selected contexts have been confirmed for deletion, the user data related to these contexts will be deleted on the next execution of the "Delete expired contexts" [[Scheduled tasks|scheduled task]].

==Capabilities==

* [[Capabilities/tool/dataprivacy:managedataregistry|Manage data registry]]
* [[Capabilities/tool/dataprivacy:managedatarequests|Manage data requests]]
* [[Capabilities/tool/dataprivacy:makedatarequestsforchildren|Make data requests for children]]
* [[Capabilities/tool/dataprivacy:downloadallrequests|Download exported data for everyone]]
* [[Capabilities/tool/dataprivacy:downloadownrequest|Download your own exported data]]
* [[Capabilities/tool/dataprivacy:makedatadeletionrequestsforchildren|Request data deletion for minors]]
* [[Capabilities/tool/dataprivacy:requestdelete|Request data deletion for yourself]]
* [[Capabilities/tool/dataprivacy:requestdeleteforotheruser|Request data deletion on behalf of another user]]

==Plugin privacy registry==

The Plugin privacy registry (Site administration / Users / Privacy and policies / Plugin privacy registry) lists all plugins in Moodle, and identifies whether they comply with the privacy API or not. Any plugins which are flagged with the warning icon do not yet implement the Moodle privacy API. If this plugin stores any personal data it will not be able to be exported or deleted through Moodle's privacy system.

[[Category: Privacy]]

[[es:Privacidad de datos]]
[[de:Datenschutz]]
[[fr:Plugin Data Privacy]]

Front page settings

2021-02-10T10:50:52Z

Marycooch: removing out of date screenshots

{{Front page}}The site's [[Front page]] is similar to a course page. The front page settings can be found in 'Front page settings' in the Site administration.

===Full site name===
This name appears at the top of every page above the navigation bar.
[[Image:demositefrontpage01.png|frame|center|Front page full site name]]

===Short name for site===
The short name appears at the beginning of the navigation bar as a link back to your site front page.

===Front page summary===
This summary can be displayed on the left or right of the front page using the course/site summary block.

The summary is also used as the HTML metadata description in some themes, for the front page of the site. This is not generally seen by users, but can be useful for search engines that index the page.

===Front page and Front page items when logged in===
The centre of the front page can display any combination of the following: news items, a list of courses, a list of enrolled courses, a list of course categories, a list of categories and courses, a course search box or none. The order is determined by a combination box.

It is possible to create one setting for anyone who gets to the front page without logging in to the Moodle site, and another look for only those who have logged into the Moodle site. There are two combination boxes.

An alternative option for logged-in users is their [[Dashboard|dashboard]] (can be set in Site administration > Appearance > Navigation)

===Maximum category depth===
This specifies the maximum depth of child categories expanded when displaying categories or combo list. Deeper level categories will appear as links and user can expand them with AJAX request.

===Maximum number of courses===
Maximum number of courses to be displayed on the site's front page in course listings.

===Include a topic section===
This adds a topic section to the centre-top of the front page. When editing is turned on, resources and/or activities can be added to the topic section using the dropdown menus, in the same way as on a course page.

:Note: The label resource can be used to add text and/or an image to the centre-top of the front page.

===News items to show===
This setting only applies if the front page is set to display news items or if you are using the [[Latest announcements block]].

===Comments per page===
Each course may include a [[Comments block]] which allows the display of user comments. The number of comments displayed at any time is set here.

===Default front page role===

The default front page role enables logged-in users to participate in front page activities. See 'How do I enable logged-in users to participate in front page activities?' in [[Front page FAQ]] for more details. It is recommended that it is set to 'Authenticated user on frontpage'. It can also be set to Student. It should not be set to Guest.

==Front Page roles==
As in a course, you can assign users [[Roles|roles]] just in the [[Context|context]] of this page. Note this is different from the default Authenticated User on Front Page role found in front page settings. As a security issue, usually only admins can modify the front page, other users do not.

It is possible to upload users as students in the front page with a csv file using the site short name as 'course1' field, student in 'role1' field (and, if needed, chosen group name in 'group1' field.)

==Front Page backup==
You can backup the front page, similar to a [[Course backup]].

==Front Page restore==
As in a course, you can [[Restore]] a backed up version of the front page.

==Front Page questions==
The [[Question bank]] is accessible from the Front Page. For example, if "topic" is checked in the front page settings, you can add a [[Quiz module]] activity.

==Tips and Tricks==

A Moodle site's front page can be reconfigured from the default standard to give it a different look and or change how it functions. Depending upon the changes, this can be a simple or a more complex process. See [[Front page FAQ]] for some ideas on customising your front page.
====Central area, Courses or Categories?====
This is a major decision, what is it you want in the centre of your front page? You can have a list of categories, a list of categories and courses, or neither, a label with a table full of images works just as well. The issue is always the same, actually, what looks good.

====Clean look, topic checked, no blocks====
The standard Moodle page format of [[Block]]s on the left and blocks on the right is not always appropriate or considered pretty. The [[Administrator|site administrator]] can change this basic format by simply deleting or hiding blocks that can be seen by users. Navigation can be placed on the dock.

====The two column format====
The Administrator decides which blocks should appear on the front page and moves all of them to the left or right side. This format allows you to decide what you want in the centre, and where you want the blocks, left or right.
:Tip: It is possible to force a block column to assume a specific width. For example, placing an image of 400 px in a block will force that column to 400 px.

====The clean look example====
Some sites want an uncluttered look. A site administrator or designer wants to start with the most basic look and then add features.

# The site administrator will turn on editing and hide or delete all blocks that can be see by teachers or students on the front page.
# Then go to the Front Page settings and:
## Set the "Front page" list to None, None, None, None
## Set "Front page items when logged in" list to the same
## Check the box for "Include Topic section"
## Save

All the above was done with 1 theme, and a simple front page.

If you're using a theme such as Clean or More you can then do some cool things with Bootstrap layout elements, as described in the thread [https://moodle.org/mod/forum/discuss.php?d=267662 LOOK & LEARN: How to add marketing spots as a front page topic].

==Block settings==
Each block has a number of configuration settings that you can change. See [[Managing blocks]] for more details.

==Other settings that change the look of the Main Page==
Some components of the Main Page, such as the logo, heading and Navigation bar may be changed by an administrator in Themes in the Site administration and clicking on the theme name. Different themes may have fewer or more options to set. There are some other settings available in 'Theme settings'.

==See also==
*[[Front Page FAQ]]

[[Category:Site administration]]

[[de:Einstellungen_f%C3%BCr_die_Startseite]]
[[es:Configuraciones de la portada]]
[[eu:Hasiera-orriaren_ezarpenak]]
[[fr:Réglages page d'accueil]]
[[pl:Ustawienia strony głównej]]

Front page settings

2021-02-10T10:49:47Z

Marycooch: /* Block settings */

{{Front page}}The site's [[Front page]] is similar to a course page. The front page settings can be found in 'Front page settings' in the Site administration.

===Full site name===
This name appears at the top of every page above the navigation bar.
[[Image:demositefrontpage01.png|frame|center|Front page full site name]]

===Short name for site===
The short name appears at the beginning of the navigation bar as a link back to your site front page.

===Front page summary===
This summary can be displayed on the left or right of the front page using the course/site summary block.

The summary is also used as the HTML metadata description in some themes, for the front page of the site. This is not generally seen by users, but can be useful for search engines that index the page.

===Front page and Front page items when logged in===
The centre of the front page can display any combination of the following: news items, a list of courses, a list of enrolled courses, a list of course categories, a list of categories and courses, a course search box or none. The order is determined by a combination box.

It is possible to create one setting for anyone who gets to the front page without logging in to the Moodle site, and another look for only those who have logged into the Moodle site. There are two combination boxes.

{| class="nicetable"
|-
!colspan="3"|Combination boxes
|-
|[[Image:FrontPage settings frontpage pd.png|thumb|left|frontpage showing pulldown]]
| The image on the left shows the first Front Page settings dialog - what visitors will see before they log in.

The image on the right shows a second front Page settings dialog - what Authenticated Users will see when logged in.

:An alternative option for logged-in users is their [[Dashboard|dashboard]] (can be set in Site administration > Appearance > Navigation)
|[[Image:FrontPage_settings_frontpageloggedin.png|thumb|right|frontpage for login user box]]
|}

===Maximum category depth===
This specifies the maximum depth of child categories expanded when displaying categories or combo list. Deeper level categories will appear as links and user can expand them with AJAX request.

===Maximum number of courses===
Maximum number of courses to be displayed on the site's front page in course listings.

===Include a topic section===
This adds a topic section to the centre-top of the front page. When editing is turned on, resources and/or activities can be added to the topic section using the dropdown menus, in the same way as on a course page.

:Note: The label resource can be used to add text and/or an image to the centre-top of the front page.

===News items to show===
This setting only applies if the front page is set to display news items or if you are using the [[Latest announcements block]].

===Comments per page===
Each course may include a [[Comments block]] which allows the display of user comments. The number of comments displayed at any time is set here.

===Default front page role===

The default front page role enables logged-in users to participate in front page activities. See 'How do I enable logged-in users to participate in front page activities?' in [[Front page FAQ]] for more details. It is recommended that it is set to 'Authenticated user on frontpage'. It can also be set to Student. It should not be set to Guest.

==Front Page roles==
As in a course, you can assign users [[Roles|roles]] just in the [[Context|context]] of this page. Note this is different from the default Authenticated User on Front Page role found in front page settings. As a security issue, usually only admins can modify the front page, other users do not.

It is possible to upload users as students in the front page with a csv file using the site short name as 'course1' field, student in 'role1' field (and, if needed, chosen group name in 'group1' field.)

==Front Page backup==
You can backup the front page, similar to a [[Course backup]].

==Front Page restore==
As in a course, you can [[Restore]] a backed up version of the front page.

==Front Page questions==
The [[Question bank]] is accessible from the Front Page. For example, if "topic" is checked in the front page settings, you can add a [[Quiz module]] activity.

==Tips and Tricks==

A Moodle site's front page can be reconfigured from the default standard to give it a different look and or change how it functions. Depending upon the changes, this can be a simple or a more complex process. See [[Front page FAQ]] for some ideas on customising your front page.
====Central area, Courses or Categories?====
This is a major decision, what is it you want in the centre of your front page? You can have a list of categories, a list of categories and courses, or neither, a label with a table full of images works just as well. The issue is always the same, actually, what looks good.

====Clean look, topic checked, no blocks====
The standard Moodle page format of [[Block]]s on the left and blocks on the right is not always appropriate or considered pretty. The [[Administrator|site administrator]] can change this basic format by simply deleting or hiding blocks that can be seen by users. Navigation can be placed on the dock.

====The two column format====
The Administrator decides which blocks should appear on the front page and moves all of them to the left or right side. This format allows you to decide what you want in the centre, and where you want the blocks, left or right.
:Tip: It is possible to force a block column to assume a specific width. For example, placing an image of 400 px in a block will force that column to 400 px.

====The clean look example====
Some sites want an uncluttered look. A site administrator or designer wants to start with the most basic look and then add features.

# The site administrator will turn on editing and hide or delete all blocks that can be see by teachers or students on the front page.
# Then go to the Front Page settings and:
## Set the "Front page" list to None, None, None, None
## Set "Front page items when logged in" list to the same
## Check the box for "Include Topic section"
## Save

All the above was done with 1 theme, and a simple front page.

If you're using a theme such as Clean or More you can then do some cool things with Bootstrap layout elements, as described in the thread [https://moodle.org/mod/forum/discuss.php?d=267662 LOOK & LEARN: How to add marketing spots as a front page topic].

==Block settings==
Each block has a number of configuration settings that you can change. See [[Managing blocks]] for more details.

==Other settings that change the look of the Main Page==
Some components of the Main Page, such as the logo, heading and Navigation bar may be changed by an administrator in Themes in the Site administration and clicking on the theme name. Different themes may have fewer or more options to set. There are some other settings available in 'Theme settings'.

==See also==
*[[Front Page FAQ]]

[[Category:Site administration]]

[[de:Einstellungen_f%C3%BCr_die_Startseite]]
[[es:Configuraciones de la portada]]
[[eu:Hasiera-orriaren_ezarpenak]]
[[fr:Réglages page d'accueil]]
[[pl:Ustawienia strony głównej]]

Front page settings

2021-02-10T10:49:17Z

Marycooch: removing out of date screenshots

{{Front page}}The site's [[Front page]] is similar to a course page. The front page settings can be found in 'Front page settings' in the Site administration.

===Full site name===
This name appears at the top of every page above the navigation bar.
[[Image:demositefrontpage01.png|frame|center|Front page full site name]]

===Short name for site===
The short name appears at the beginning of the navigation bar as a link back to your site front page.

===Front page summary===
This summary can be displayed on the left or right of the front page using the course/site summary block.

The summary is also used as the HTML metadata description in some themes, for the front page of the site. This is not generally seen by users, but can be useful for search engines that index the page.

===Front page and Front page items when logged in===
The centre of the front page can display any combination of the following: news items, a list of courses, a list of enrolled courses, a list of course categories, a list of categories and courses, a course search box or none. The order is determined by a combination box.

It is possible to create one setting for anyone who gets to the front page without logging in to the Moodle site, and another look for only those who have logged into the Moodle site. There are two combination boxes.

{| class="nicetable"
|-
!colspan="3"|Combination boxes
|-
|[[Image:FrontPage settings frontpage pd.png|thumb|left|frontpage showing pulldown]]
| The image on the left shows the first Front Page settings dialog - what visitors will see before they log in.

The image on the right shows a second front Page settings dialog - what Authenticated Users will see when logged in.

:An alternative option for logged-in users is their [[Dashboard|dashboard]] (can be set in Site administration > Appearance > Navigation)
|[[Image:FrontPage_settings_frontpageloggedin.png|thumb|right|frontpage for login user box]]
|}

===Maximum category depth===
This specifies the maximum depth of child categories expanded when displaying categories or combo list. Deeper level categories will appear as links and user can expand them with AJAX request.

===Maximum number of courses===
Maximum number of courses to be displayed on the site's front page in course listings.

===Include a topic section===
This adds a topic section to the centre-top of the front page. When editing is turned on, resources and/or activities can be added to the topic section using the dropdown menus, in the same way as on a course page.

:Note: The label resource can be used to add text and/or an image to the centre-top of the front page.

===News items to show===
This setting only applies if the front page is set to display news items or if you are using the [[Latest announcements block]].

===Comments per page===
Each course may include a [[Comments block]] which allows the display of user comments. The number of comments displayed at any time is set here.

===Default front page role===

The default front page role enables logged-in users to participate in front page activities. See 'How do I enable logged-in users to participate in front page activities?' in [[Front page FAQ]] for more details. It is recommended that it is set to 'Authenticated user on frontpage'. It can also be set to Student. It should not be set to Guest.

==Front Page roles==
As in a course, you can assign users [[Roles|roles]] just in the [[Context|context]] of this page. Note this is different from the default Authenticated User on Front Page role found in front page settings. As a security issue, usually only admins can modify the front page, other users do not.

It is possible to upload users as students in the front page with a csv file using the site short name as 'course1' field, student in 'role1' field (and, if needed, chosen group name in 'group1' field.)

==Front Page backup==
You can backup the front page, similar to a [[Course backup]].

==Front Page restore==
As in a course, you can [[Restore]] a backed up version of the front page.

==Front Page questions==
The [[Question bank]] is accessible from the Front Page. For example, if "topic" is checked in the front page settings, you can add a [[Quiz module]] activity.

==Tips and Tricks==

A Moodle site's front page can be reconfigured from the default standard to give it a different look and or change how it functions. Depending upon the changes, this can be a simple or a more complex process. See [[Front page FAQ]] for some ideas on customising your front page.
====Central area, Courses or Categories?====
This is a major decision, what is it you want in the centre of your front page? You can have a list of categories, a list of categories and courses, or neither, a label with a table full of images works just as well. The issue is always the same, actually, what looks good.

====Clean look, topic checked, no blocks====
The standard Moodle page format of [[Block]]s on the left and blocks on the right is not always appropriate or considered pretty. The [[Administrator|site administrator]] can change this basic format by simply deleting or hiding blocks that can be seen by users. Navigation can be placed on the dock.

====The two column format====
The Administrator decides which blocks should appear on the front page and moves all of them to the left or right side. This format allows you to decide what you want in the centre, and where you want the blocks, left or right.
:Tip: It is possible to force a block column to assume a specific width. For example, placing an image of 400 px in a block will force that column to 400 px.

====The clean look example====
Some sites want an uncluttered look. A site administrator or designer wants to start with the most basic look and then add features.

# The site administrator will turn on editing and hide or delete all blocks that can be see by teachers or students on the front page.
# Then go to the Front Page settings and:
## Set the "Front page" list to None, None, None, None
## Set "Front page items when logged in" list to the same
## Check the box for "Include Topic section"
## Save

All the above was done with 1 theme, and a simple front page.

If you're using a theme such as Clean or More you can then do some cool things with Bootstrap layout elements, as described in the thread [https://moodle.org/mod/forum/discuss.php?d=267662 LOOK & LEARN: How to add marketing spots as a front page topic].

==Block settings==
[[Image:Editconfigblock.png|thumb|200px|right|Editing block settings]]
Each block has a number of configuration settings that you can change. See [[Managing blocks]] for more details.

==Other settings that change the look of the Main Page==
Some components of the Main Page, such as the logo, heading and Navigation bar may be changed by an administrator in Themes in the Site administration and clicking on the theme name. Different themes may have fewer or more options to set. There are some other settings available in 'Theme settings'.

==See also==
*[[Front Page FAQ]]

[[Category:Site administration]]

[[de:Einstellungen_f%C3%BCr_die_Startseite]]
[[es:Configuraciones de la portada]]
[[eu:Hasiera-orriaren_ezarpenak]]
[[fr:Réglages page d'accueil]]
[[pl:Ustawienia strony głównej]]

Images

2021-02-10T10:45:58Z

Marycooch: updated image

{{Working with media}}
Moodle allows teachers and students to upload and display images from a variety of sources via the image icon of the [[Atto editor]]. Course pages can be enhanced with images (or banners) in each section. Assignments can include images for extra clarification. Images attached to forum posts or quiz questions will appear embedded.

{{MediaPlayer | url = https://youtu.be/fEtGcVz0pzE | desc = Adding images}}
Moodle accepts .jpg,.png,.svg and .gif formats.

==Dragging and dropping an image==

*Images may be dragged and dropped directly into the [[Atto editor]] if you are using a supported browser (not IE 9, Safari 6 or below or earlier versions of Firefox) and can be dragged and dropped directly onto the course page if the editing is turned on and 'media drag and drop" is enabled in ''Administration > Site administration > Plugins > Activity modules > Label''.
* See [[Using Label]] for more information.

==Copying and pasting an image==

In Moodle 3.9 onwards, images can be copied from anywhere and pasted into the [[Atto editor]]. For example, you can take a screenshot, copy it to your clipboard and then paste it into the Atto editor.

==Uploading and displaying an image from your computer==

*''Note:'' It is a good idea to resize your image before uploading, rather than altering its dimensions online.
*With the editing turned on, go to where you want to display your image (e.g. in a course summary, label or page)
*Click the image icon as below

[[File:ImageIcon310.png]]

*Either enter the URL of an image which is already online or click 'Browse repositories' to access the File picker
*Click [[Upload a file]]. Browse for and upload your image. For more information, see [[File picker]]
*Either add a description of the image or tick/check the box 'This image is decorative only'.
*Alter the size and alignment if needed and save the image

[[File:ImageUpload310.png]]

==Editing an uploaded image==

If you need to edit the image once it has been uploaded,you can double-click on the image from within the [[Text editor| Atto text editor]] and access the image properties window. ''Note it is much better to upload an image of the desired size rather than modifying it afterwards.''

==Displaying an image already online==
If you have images available elsewhere online, you can display them too without the need to upload to Moodle by entering their online address in the Enter URL field. ''Note:'' If the image is taken offline, it will be replaced by a red X on your course page. Linking [http://simple.wikipedia.org/wiki/Hot-linking] to images online if you don't own them yourself is not recommended.

[[de:Bilder]]
[[es:Imágenes]]
[[fr:Images]]

File:ImageIcon310.png

2021-02-10T10:44:39Z

Marycooch: