MoodleDocs - User contributions [en]

Capabilities/mod/bigbluebuttonbn:managerecordings

2023-07-21T16:07:02Z

Ghillenb:

*This capability allows users to manage (for example delete) the recordings of BigBlueButton sessions.
*It is allowed for the default roles of manager and teachers.

[[de:Capabilities/mod/bigbluebuttonbn:managerecordings]]

MoodleNet

2023-07-17T06:41:05Z

Ghillenb:

[https://moodle.net/ MoodleNet] is an open, social, media platform for educators, initially focused on sharing and curating collections of open content. It is a central place from where educators can easily detect quality content to meet the needs of their learners and courses. You can either use MoodleNet Central, the global public MoodleNet, or install your own instance of MoodleNet. Read the [https://docs.moodle.org/moodlenet/Main_Page MoodleNet documentation] for more information about MoodleNet.
==MoodleNet inbound settings==
As an administrator you can connect to an instance of MoodleNet so course teachers can browse for and import content.

# From ''Site administration > Advanced features,'' make sure Enable MoodleNet integration (inbound) is checked. (It is enabled by default.)
# From ''Site administration > General > MoodleNet settings'', check the settings in the link MoodleNet inbound settings.
# Optionally, from Site administration > Courses > Activity chooser > Activity chooser settings, select MoodleNet from the footer dropdown. This will then display a link in the [[Activity chooser]].

==MoodleNet outbound settings==
{{New features}}
As an administrator you can connect to an instance of MoodleNet so that course teachers or others with the capability [[Capabilities/moodle/moodlenet:shareactivity| moodlenet:shareactivity]] can send course content to the selected MoodleNet site. (Note that the feature does not currently support sharing whole courses.)

# From ''Site administration > Development > Experimental settings'', check the box Enable sharing to MoodleNet (outbound)
# You will then have an extra setting (Enable sharing to MoodleNet (outbound)) from ''Site administration > General > MoodleNet settings'', prompting you to set up a MoodleNet OAuth 2 service.
# From ''Site administration > Server > OAuth2 services'', click the MoodleNet button and set up your service. See [[OAuth 2 MoodleNet service]].
# Once the service is created, go to ''Site administration > General > MoodleNet outbound settings'' and set the OAuth 2 service to the service you just created.
# When everything is configured correctly, users with the Capabilities/moodle/moodlenet:shareactivity will see a link "Share to MoodleNet" from the More tab of an item they want to share.

[[File:ShareMoodleNet.png|More link to share to MoodleNet]]

[[Es:MoodleNet]]
[[de:MoodleNet]]

OAuth 2 Clever service

2023-07-17T06:37:33Z

Ghillenb:

To get a client ID and secret for Clever, you will need to register for a developer account with Clever. To do this, follow these steps:

# Go to the Clever developer website: https://clever.com/developers/
# Click on the "Sign Up" button in the top right corner of the page.
# Fill out the form with your personal and contact information, and agree to the Clever developer terms of service.
# Submit the form to register for a Clever developer account.

Once you have registered for a Clever developer account, you can access your client ID and secret by following these steps:

# Log in to your Clever developer account.
# Click on the "Applications" tab in the top menu.
# Click on the "Create New App" button.
# Fill out the form to create a new application, and click on the "Create" button.
# Your new app will be displayed in the list of applications. Click on the app to view its details.
# In the app details page, you will see your client ID and secret in the "Credentials" section.

Note: the content of this page has been created using GPT-3.

[[de:OAuth2 Clever Service]]

OAuth 2 MoodleNet service

2023-07-17T06:33:13Z

Ghillenb:

{{OAuth2}}
==Features requiring the MoodleNet OAuth 2 service==

You will need to set up a MoodleNet OAuth 2 service in order to use the following features:

* [[MoodleNet]] (Only the outbound "Share to MoodleNet" feature, not the inbound features)

==MoodleNet OAuth 2 service setup==

Note: Currently, only MoodleNet central ([https://moodle.net/ MoodleNet]) supports the share API. The OAuth 2 service template is preset to support configuration of this MoodleNet central application.

To set up the service in Moodle:

1. Go to OAuth 2 services (Site administration > Server > OAuth 2 services) and create a new MoodleNet service.

2. The service configuration form is now shown. Note the Service base URL is preset to MoodleNet central. You may change the name of the service here if you wish, however, please leave other fields unchanged.

3. Save the changes.

4. The service will now auto-configure itself and Moodle will redirect to the services listing. If you see a green tick in the "Discovery" column, your newly created service is ready for use.

[[es:Servicio OAuth 2 MoodleNet]]
[[de:OAuth2 MoodleNet Service]]

Course index

2023-04-26T09:06:41Z

Ghillenb:

The course index is the collapsible drawer on the left of the screen in Boost and Boost-based themes. It displays course sections and elements. As you move up and down the central course area, your location is highlighted in the Course index. Clicking on an item in the Course index will open it up directly in the course central area.

{{New features}}

Activities and resources which are indented in the course page are also indented in the Course index.

[[File:42indentcourseindex.png]]

Text and media areas also display in the Course index.

[[File:TMdisplay.png]]

[[es:Índice del curso]]
[[de:Kursindex]]

Capabilities/moodle/moodlenet:shareactivity

2023-04-26T08:57:53Z

Ghillenb:

{{New features}}

*This allows a user to share an activity or resource to an instance of MoodleNet, from the More link in an activity or resource's settings.
*This capability is allowed for the default roles of manager and teacher.

[[de:Capabilities/moodle/moodlenet:shareactivity]]

Capabilities/mod/bigbluebuttonbn:viewallrecordingformats

2023-04-26T08:54:58Z

Ghillenb:

{{New features}}

*This allows a user to view BigBlueButton recording formats which might be restricted from other users (for example, Statistics or Notes.)
*This capability is allowed for the default roles of manager and teacher.

Note: The admin can restrict or make available recording formats from ''Site administration > Plugins > BigBlueButton > Recording.''

[[de:Capabilities/mod/bigbluebuttonbn:viewallrecordingformats]]

TinyMCE editor (legacy)

2022-11-25T13:17:51Z

Ghillenb:

The TinyMCE MTML editor (legacy) is an editor plugin in Moodle which can be enabled, disabled or set as default from ''Administration > Site administration > Plugins > Text editors > Manage editors''.

In Moodle 4.1 an updated replacement TinyMCE editor is available and it is advised to use that instead of the legacy version.

If allowed by admin, users may select the '''TinyMCE HMTL editor (legacy) ''' from the user menu top right>''Preferences>Editor preferences''

==Collapsing and expanding the editor==

The TinyMCE editor first appears with just one row of buttons. Clicking the icon top left will expand it to three rows.

{|
|[[File:26tinymce1.png|250px|thumb|Collapsed view]]
|[[File:26tinymce2.png|250px|thumb|Expanded view]]
|}

==Toolbar buttons==
For those who are not familiar with the tool bar, here are the buttons as grouped in their rows. Remember that the site administrator can edit or provide additional buttons.

Row 1
{|
|[[File:26tinymcerow1.png|400px|thumb]]
|}

{| class="wikitable"
|-
|-
| 1:Expand
| 2.Formatting
| 3.Bold
| 4.Italic
|-
| 5.Bulleted list
| 6.Numbered list
| 7.Add link
| 8.Unlink
|-
| 9.Stop auto linking
| 10.Add image
| 11.Add emoticon
| 12.Add media
|-
| 13.Manage embedded files
|
|
|
|}
Row 2

{|
|[[File:26tinymcerow2.png|400px|thumb]]
|}

{| class="wikitable"
|-
|-
| 1:Undo
| 2.Redo
| 3.Underline
| 4.Strikethrough
|-
| 5.Subscript
| 6.Superscript
| 7.Align left
| 8.Align centre
|-
| 9.Align right
| 10.Decrease indent
| 11.Increase indent
| 12.Text colour
|-
| 13.Background colour
| 14.Left to Right
| 15.Right to Left
|
|-

|}
Row 3

{|
|[[File:26tinymcerow3.png|400px|thumb]]
|}

{| class="wikitable"
|-
|-
| 1:Font family
| 2.Font size
| 3.Edit HTML
| 4.Find
|-
| 5.Find/replace
| 6.Insert non-breaking space
| 7.Insert special character
| 8.Insert table
|-
| 9.Clean up messy code
| 10.Remove formatting
| 11.Paste as plain text
| 12.Paste from MS Word

|-
| 13.Toggle full screen
|-

|}

===Colour pickers===
*[[Image:26colourpickers.png]]
There are four levels of selecting a font or background colour,
*A quick pick 5x8 matrix of colours
*"More colours" that links to Picker, Pallet and Named tabs
<gallery>
Image:HTML_editor_color_selector_basic_1.png|A quick pick 5x8 matrix of colors
Image:HTML_editor_color_selector_more_picker_1.png|A rainbow color picker tab
Image:HTML_editor_color_selector_more_pallet_1.png|A Pallet tab with a 18x12 matrix of colors
Image:HTML_editor_color_selector_more_named_1.png|A Named tab with custom pallets
</gallery>

====Insert table====
<gallery widths="300px">
Image:HTMLeditor_Insert_Table_general_1.png|General tab
Image:HTMLeditor_Insert_Table_advanced_1.png|Advanced tab
</gallery>

'''To add borders to a table'''

Cell borders are crucial for helping readers to follow the rows across the screen. If they aren't showing already you can add them as follows:

#In the Wiki page containing your table, click its Edit tab
#Carefully select all the cells of the table
#Then right click (Macs: Command+click or Ctrl+Click) over any part of your selection to get a context menu; from it select Cell > Table Cell Properties; the cell properties dialog box then loads.
#Click on its Advanced tab, set Border Color to black (for instance), then click Apply, and then click Update.
#Click Save; the Wiki page containing your table will then load displaying its borders.

===TinyMCE editor settings===

The TinyMCE HTML editor has its own settings page ''Administration > Site administration > Plugins > Text editors > TinyMCE HTML editor > General settings'' with the following options:

====Plugins====
*Buttons for equations, emoticons,images, media, automatic linking, and legacy spell-checking may be enabled, disabled or uninstall here by clicking on their eye.
*Additionally the equation, emoticon and spell check buttons have links to their Settings screens.

[[File:26tinymceplugins.png |thumb|none|upright=2.0|alt="The TinyMCE editor plugins screen" | The TinyMCE editor plugins screen]]

=====Manage embedded files=====

This plugin allows users to add, delete or override files embedded in the current text area, for example in a label or topic summary. (It complements the [[Embedded files repository]])

{|
|[[File:26embeddedfiles1.png|thumb|The Manage files button]]
|
|[[File:26embeddefiles2.png|thumb|Managing embedded files from within TinyMCE]]
|}

=====Insert equation=====

Accessed from ''Administration>Site administration > Plugins > Text editors > TinyMCE HTML editor > Edit equation'', this allows you to enable or disable the TeX filter in the editor context and thereby display the Dragmath button. If you have a global custom TeX filter, then disable this setting.

=====Insert emoticon=====
Accessed from ''Administration > Site administration > Plugins > Text editors > TinyMCE HTML editor > Insert emoticon'', this allows you to enable or disable the emoticon filter in the editor context and thereby display the emoticon button.

===== Legacy spell checker=====
The legacy spell checker is visible in IE9 and lower only, but not in other browsers. If you want to disable it and rely on browser spell checker functionality instead, you can do this by disabling the ''legacy spellchecker'' plugin by clicking its eye in ''Administration > Site administration > Plugins > Text editors > TinyMCE HTML editor > General settings''

To spell-check via your browser, type your word (which if incorrectly spelt will have red lines under it) and press right click + CTRL
{|
|[[File:Browserspellcheck.png|thumb|Right-click+CTRL for browser spellcheck]]
|}

'''NOTE:'''
While the default spell engine is Google spell which can be changed in ''Administration>Site administration>Plugins>Text editors>TinyMCE HTML editor'', this is no longer supported by Google and will not work. (Note that it is only visible in IE9 and lower) It is due to be removed. See MDL-38867. In browser spell check is recommended.

If PSpell is selected then aspell 0.50 or later must be installed on your server and the path to aspell set in Administration > Site administration > Server > System Paths.

You can select a different spell engine from ''Administration> Site administration > Plugins > Text editors > TinyMCE HTML editor>Check spelling''.

{|
|[[File:Spellengine.png|thumb|Choosing a different spell engine]]
|}
According to: http://php.net/manual/en/book.pspell.php

"As of php 5.3. Pspell is no longer supported/bundled. Instead you can use the enchant which is bundled by default in 5.3."

If PSpell is selected then aspell 0.50 or later must be installed on your server and the path to aspell set in Administration > Site administration > Server > System Paths.

===Customising the editor toolbar===

An administrator can remove or add buttons to the TinyMCE editor toolbar by altering the Editor toolbar box in '' Administration > Site administration > Plugins > Text editors > TinyMCE HTML editor > General settings'' as demonstrated in the screencast [http://youtu.be/vTW1DImro9c Customise the text editor in 2.4].

{|
| [[File:editortoolbar.png|thumb|The Editor toolbar box]]
|[[File:horizontalrule.png|thumb|Example of toolbar with added horizontal rule button]]

|}

====Available fonts list====

In addition to the default fonts, a site administrator can add extra fonts by typing their name and string in the box in ''Administration > Site administration > Plugins > Text editors > TinyMCE HTML editor > General settings'' as demonstrated in the screencast [http://youtu.be/udP7Bnur30Y How to add extra fonts].

{|
|[[File:comicsans.png|thumb|Example of custom font]]
|}

====Custom configuration====

A setting in ''Administration>Site administration>Plugins>Text editors>TinyMCE HTML editor>General settings'' provides a box in which an administrator can apply custom formats. See MDL-37186 for more details with examples, and see also the [http://www.tinymce.com/wiki.php/Configuration:formats TinyMCE configuration page]

{|
|[[File:bottomtoolbar.png|thumb|Example 1:Toolbar at the bottom]]
|[[File:customstyles.png|thumb|Example 2: Custom styles]]
|}

*Example: Moving the toolbar to the bottom:

Add the following:
{"theme_advanced_toolbar_location" : "bottom"}

*Example: Adding your own custom styles.
(This might be useful for example if you want a "house style" for important notes, key points or similar)
In the editor toolbar, enter "styleselect" and then in the custom box add the following code, changing it to suit your purposes:
{"style_formats" : [
{"title" : "Bold text", "inline" : "b"},
{"title" : "Red text", "inline" : "span", "styles" : {"color" : "#ff0000"}},
{"title" : "Red header", "block" : "h1", "styles" : {"color" : "#ff0000"}} ]}

The following will let you use bootstrap CSS classes if you use a bootstrap based theme:

{"style_formats" : [
{"title" : "Well", "block" : "div", "classes" : "well"},
{"title" : "Label", "inline" : "span", "classes" : "label"},
{"title" : "Label - success", "inline" : "span", "classes" : "label label-success"},
{"title" : "Label - warning", "inline" : "span", "classes" : "label label-warning"},
{"title" : "Label - important", "inline" : "span", "classes" : "label label-important"},
{"title" : "Label - info", "inline" : "span", "classes" : "label label-info"},
{"title" : "Label - inverse", "inline" : "span", "classes" : "label label-inverse"},
{"title" : "Button", "inline" : "a", "classes" : "btn btn"},
{"title" : "Button - primary", "inline" : "a", "classes" : "btn btn-primary"},
{"title" : "Button - info", "inline" : "a", "classes" : "btn btn-info"},
{"title" : "Button - success", "inline" : "a", "classes" : "btn btn-success"},
{"title" : "Button - warning", "inline" : "a", "classes" : "btn btn-warning"},
{"title" : "Button - danger", "inline" : "a", "classes" : "btn btn-danger"},
{"title" : "Button - inverse", "inline" : "a", "classes" : "btn btn-inverse"}
]}

*Example: Enabling copy of rich content with styles from MS Word (tm) and paste into TineMCE without removing important styles:

{"paste_retain_style_properties" : "margin, padding, width, height, font-size,
font-weight, font-family, color, text-align, ul, ol, li,
text-decoration, border, background, float, display"}

==Speed of TinyMCE in Firefox and Chrome==
Some users have complained about the unreasonably slow loading of TinyMCE; for example, https://moodle.org/mod/forum/discuss.php?d=232089 and https://moodle.org/mod/forum/discuss.php?d=223125. [https://moodle.org/mod/forum/discuss.php?d=262235 Apparently,] TinyMCE takes longer to load in Firefox (10-20 seconds) than in Chrome (a couple of seconds).

To speed up TinyMCE you can try disabling ALL the plugins in the TinyMCE editor settings from your admin account: <moodle site address>/admin/settings.php?section=editorsettingstinymce . Then the editor loaded quickly. This has taken out a couple of minor functions, such as inserting emoticons, but loading speed is far more important for some users than the ability to insert emoticons.

[[de:TinyMCE-Editor (veraltet)]]

Course completion report

2022-11-24T17:48:51Z

Ghillenb:

{{Course completion}}
When [[Course completion]] is enabled from ''''Course navigation > More > Course completion'''', the course completion report becomes available from ''Course navigation > Reports.''

{{New features}}
The course completion report can include custom profile fields, if selected from Site administration > Users > User policies > Show user identity. See (1) in the screenshot below:

[[File:CCR.png|600px|center|Course completion report including a custom profile field]]

When viewing the completion information of a specific user, the time of completion is displayed alongside the date.

[[File:ccrtime.png|center]]

Note: The course completion report is different from the [[Activity completion report]]. If you need to manually complete an activity, you should do this from the Activity completion report.

If manual self completion or manual completion by others is enabled, then those columns will appear in the course completion report. The user with the role allowed to manually complete the course on behalf of the student will be able to mark it complete in the course completion report.

[[de:Kursabschlussbericht]]

Custom reports

2022-11-24T17:10:20Z

Ghillenb: /* Custom reports */

{{Sitewide reports}}
==Custom reports==
Formerly a feature of Moodle Workplace TM, the Report builder feature allows administrators to create and share custom reports. This page is about the custom reports feature in Moodle LMS. For the Workplace version see [[Report builder]]

Custom reports are accessed from ''Site administration > Reports > Report builder > Custom reports.'' A general overview video explains how to use [https://youtu.be/qYKyncTW2y4 Custom reports].

{{New features}}
With new report sources now available, the complete list of report sources is as follows]
* Badges
* Blogs
* Cohorts
* Comments
* Course participants
* Courses
* Files
* Groups
* Notes
* Tags
* Task logs
* Users

RELEASE VIDEO COMING SOON

==Create a report==
<p>Note the tabs at the top: Edit, Audience, Schedules and Access:</p>

<ol>
<li>Click New report , give it a name and select your source - whether you want to report on courses, a cohort or specified users.</li>
<li>Click Save. Depending on your source, you will be presented with columns relevant to the data you want. For example, clicking 'courses' will then show categories, course short and full names and ID number.</li>
<li>Remove any columns you don't want and add columns which you do want.</li>
<li> Note the options for Conditions, Filters, Sorting and Card view on the right.</li>
<li>Preview your report by clicking the Preview button top right.</li>
</ol>
==Give access to reports==
<p>From Audience you can select a system role, cohort or manually selected users by clicking the + against who you want and then saving your choice.</p>

You can check the actual users from the Access tab. If you have chosen the system role of Manager, then the Access tab will show you the names of any Managers you have on your site.

==Schedule reports==
<p>Once you have created a report and decided who has access, you can schedule it from the Schedules tab. The recipients will receive the report via email.</p>

<ol>
<li>Click New schedule;</li>
<li>Give it a name and choose its format ( .csv by default);</li>
<li>Decide when the report will first be sent out and how often to send it.</li>
<li>The audience will already be selected if you have defined your audience.</li>
<li>If desired, you can add a message to the recipients.</li>
<li>In Advanced, decide what to do if there is nothing to report.</li>
</ol>
==See also==
[[Custom report settings]]

[[es:Reportes personalizados]]
[[de:Nutzerdefinierte Berichte]]

Custom reports

2022-11-24T17:09:45Z

Ghillenb:

{{Sitewide reports}}
==Custom reports==
Formerly a feature of Moodle Workplace TM, the Report builder feature allows administrators to create and share custom reports. This page is about the custom reports feature in Moodle LMS. For the Workplace version see [[Report builder]]

Custom reports are accessed from ''Site administration > Reports > Report builder > Custom reports.'' A general overview video explains how to use [Custom reports https://youtu.be/qYKyncTW2y4]

{{New features}}
With new report sources now available, the complete list of report sources is as follows]
* Badges
* Blogs
* Cohorts
* Comments
* Course participants
* Courses
* Files
* Groups
* Notes
* Tags
* Task logs
* Users

RELEASE VIDEO COMING SOON

==Create a report==
<p>Note the tabs at the top: Edit, Audience, Schedules and Access:</p>

<ol>
<li>Click New report , give it a name and select your source - whether you want to report on courses, a cohort or specified users.</li>
<li>Click Save. Depending on your source, you will be presented with columns relevant to the data you want. For example, clicking 'courses' will then show categories, course short and full names and ID number.</li>
<li>Remove any columns you don't want and add columns which you do want.</li>
<li> Note the options for Conditions, Filters, Sorting and Card view on the right.</li>
<li>Preview your report by clicking the Preview button top right.</li>
</ol>
==Give access to reports==
<p>From Audience you can select a system role, cohort or manually selected users by clicking the + against who you want and then saving your choice.</p>

You can check the actual users from the Access tab. If you have chosen the system role of Manager, then the Access tab will show you the names of any Managers you have on your site.

==Schedule reports==
<p>Once you have created a report and decided who has access, you can schedule it from the Schedules tab. The recipients will receive the report via email.</p>

<ol>
<li>Click New schedule;</li>
<li>Give it a name and choose its format ( .csv by default);</li>
<li>Decide when the report will first be sent out and how often to send it.</li>
<li>The audience will already be selected if you have defined your audience.</li>
<li>If desired, you can add a message to the recipients.</li>
<li>In Advanced, decide what to do if there is nothing to report.</li>
</ol>
==See also==
[[Custom report settings]]

[[es:Reportes personalizados]]
[[de:Nutzerdefinierte Berichte]]

Common module settings

2022-11-24T15:45:20Z

Ghillenb:

{{Activities}}
On the settings page for many activities and resources, there is a section called "Common module settings".
==Availability==

The Available setting has up to 3 possible options (depending on whether 'Allow stealth activities' is enabled by an administrator in the Site administration).

;Show on course page
: The activity or resource is available to students (subject to any access restrictions which may be set).

;Hide from students
: The activity or resource is only available to users with permission to view hidden activities (by default, users with the role of teacher or non-editing teacher).

;Make available but not shown on course page
: For simplifying the course page. A link to the activity or resource must be provided from elsewhere, such as from a page resource. The activity is still listed in the gradebook and other reports.

See also [[Stealth activities]].

==ID number==

Setting an ID number provides a way of identifying the activityfor grade calculation purposes. If the activity is not included in any grade calculation then the ID number field can be left blank.

The ID number can also be set on the edit grade calculation page in the [[Gradebook]], though it can only be edited on the update activity page of the module in a course context.

The ID number may also be used by other modules and plugins.

==Force language==
{{New features}}
The teacher can force a language to be used in an individual activity, rather than for the whole course. An example is if students are studying a language and the course is in their native language but a particular activity such as an Assignment is forced to their target language, to encourage them to focus.

==Include in course content download==
If download course content is enabled, and if the content is downloadable (currently File, Folder, Page and Text and Media area) then should this item be downloaded?

==Group mode==
[[Groups]] are set up on the course level.
When course group mode is turned on and force is set to no, the [[Groups|group mode]] can be one of three levels on the activity level: no groups, separate groups or visible groups.

;No groups
:There are no groups and all students submit their individual activities in one area.

;Separate groups
:Students submit their activity and teachers/trainers can sort submissions by Group or view All Participants.

;Visible groups
:All students submits their assignment within a single Assignment area but may choose which Group to associate their submission with before uploading. Teachers/trainers can sort submissions by Group or view All Participants.

==Groupings==
[[Groupings]] are a collection of groups that are set up on the course level.

==See also==
Common module settings are used in
*[[Adding/editing an assignment]]
*[[Adding/editing a chat]]
*[[Adding/editing a choice]]
*[[Adding/editing a database]]
*[[Adding/editing a forum]]
*[[Adding/editing a glossary]]
*[[Adding/editing a lesson]]
*[[SCORM module]]
*[[Adding/editing a survey]] does not mention at all
*[[Adding/editing a quiz]]
*[[Adding/editing a wiki]]
Other areas
*[[Groupings]]
*[[Grade export]]
*[[Grade calculations#Assigning ID numbers|Assigning module ID numbers for Grade calculations]]

[[ja:共通モジュール設定]]
[[es:Configuraciones comunes del módulo]]
[[de:Weitere Einstellungen]]

Common module settings

2022-11-24T15:43:08Z

Ghillenb: /* Force language */

{{Activities}}
On the settings page for many activities and resources, there is a section called "Common module settings".
==Availability==

The Available setting has up to 3 possible options (depending on whether 'Allow stealth activities' is enabled by an administrator in the Site administration).

;Show on course page
: The activity or resource is available to students (subject to any access restrictions which may be set).

;Hide from students
: The activity or resource is only available to users with permission to view hidden activities (by default, users with the role of teacher or non-editing teacher).

;Make available but not shown on course page
: For simplifying the course page. A link to the activity or resource must be provided from elsewhere, such as from a page resource. The activity is still listed in the gradebook and other reports.

See also [[Stealth activities]].

==ID number==

Setting an ID number provides a way of identifying the activityfor grade calculation purposes. If the activity is not included in any grade calculation then the ID number field can be left blank.

The ID number can also be set on the edit grade calculation page in the [[Gradebook]], though it can only be edited on the update activity page of the module in a course context.

The ID number may also be used by other modules and plugins.

==Sprache erzwingen==
{{Neu}}
Trainer/innen können die Sprache auf der Ebene eines Arbeitsmaterials oder einer Aktivität festlegen, statt auf der Kursebene. Wenn es sich z.B. um einen Sprachkurs handelt, kann die Sprache des Kurses die Muttersprache sein, aber ein einzelnes Arbeitsmaterial oder eine einzelne Aktivität kann die Fremdsprache als Sprache eingestellt werden.

==Include in course content download==
If download course content is enabled, and if the content is downloadable (currently File, Folder, Page and Text and Media area) then should this item be downloaded?

==Group mode==
[[Groups]] are set up on the course level.
When course group mode is turned on and force is set to no, the [[Groups|group mode]] can be one of three levels on the activity level: no groups, separate groups or visible groups.

;No groups
:There are no groups and all students submit their individual activities in one area.

;Separate groups
:Students submit their activity and teachers/trainers can sort submissions by Group or view All Participants.

;Visible groups
:All students submits their assignment within a single Assignment area but may choose which Group to associate their submission with before uploading. Teachers/trainers can sort submissions by Group or view All Participants.

==Groupings==
[[Groupings]] are a collection of groups that are set up on the course level.

==See also==
Common module settings are used in
*[[Adding/editing an assignment]]
*[[Adding/editing a chat]]
*[[Adding/editing a choice]]
*[[Adding/editing a database]]
*[[Adding/editing a forum]]
*[[Adding/editing a glossary]]
*[[Adding/editing a lesson]]
*[[SCORM module]]
*[[Adding/editing a survey]] does not mention at all
*[[Adding/editing a quiz]]
*[[Adding/editing a wiki]]
Other areas
*[[Groupings]]
*[[Grade export]]
*[[Grade calculations#Assigning ID numbers|Assigning module ID numbers for Grade calculations]]

[[ja:共通モジュール設定]]
[[es:Configuraciones comunes del módulo]]
[[de:Weitere Einstellungen]]

My courses

2022-11-23T15:39:54Z

Ghillenb:

Accessed from the main site navigation at the top of the screen, the My courses page displays the [[Course overview block]] to display the courses a user is enrolled in.

If enabled by the administrator, users can specify whether to go first to the Dashboard or to the My courses page once logged in, by making their choice from ''My profile > Preferences > Home page.''

{{New features}}
If [[Course request]] is enabled and a user is allowed to request a course, they will see the option from the three dots at the top right of the My courses page.

[[File:mycoursescrequest.png|center|My courses page with location of Course request feature.]]

[[de:Meine Kurse]]

Custom reports

2022-11-23T15:38:05Z

Ghillenb:

{{Sitewide reports}}
==Custom reports==
Formerly a feature of Moodle Workplace TM, the Report builder feature allows administrators to create and share custom reports. This page is about the custom reports feature in Moodle LMS. For the Workplace version see [[Report builder]]

Custom reports are accessed from ''Site administration > Reports > Report builder > Custom reports.'' A general overview video explains how to use [Custom reports https://youtu.be/qYKyncTW2y4}

{{New features}}
With new report sources now available, the complete list of report sources is as follows:
* Badges
* Blogs
* Cohorts
* Comments
* Course participants
* Courses
* Files
* Groups
* Notes
* Tags
* Task logs
* Users

RELEASE VIDEO COMING SOON

==Create a report==
<p>Note the tabs at the top: Edit, Audience, Schedules and Access:</p>

<ol>
<li>Click New report , give it a name and select your source - whether you want to report on courses, a cohort or specified users.</li>
<li>Click Save. Depending on your source, you will be presented with columns relevant to the data you want. For example, clicking 'courses' will then show categories, course short and full names and ID number.</li>
<li>Remove any columns you don't want and add columns which you do want.</li>
<li> Note the options for Conditions, Filters, Sorting and Card view on the right.</li>
<li>Preview your report by clicking the Preview button top right.</li>
</ol>
==Give access to reports==
<p>From Audience you can select a system role, cohort or manually selected users by clicking the + against who you want and then saving your choice.</p>

You can check the actual users from the Access tab. If you have chosen the system role of Manager, then the Access tab will show you the names of any Managers you have on your site.

==Schedule reports==
<p>Once you have created a report and decided who has access, you can schedule it from the Schedules tab. The recipients will receive the report via email.</p>

<ol>
<li>Click New schedule;</li>
<li>Give it a name and choose its format ( .csv by default);</li>
<li>Decide when the report will first be sent out and how often to send it.</li>
<li>The audience will already be selected if you have defined your audience.</li>
<li>If desired, you can add a message to the recipients.</li>
<li>In Advanced, decide what to do if there is nothing to report.</li>
</ol>
==See also==
[[Custom report settings]]

[[es:Reportes personalizados]]
[[de:Nutzerdefinierte Berichte]]

Common module settings

2022-11-23T15:33:42Z

Ghillenb:

{{Activities}}
On the settings page for many activities and resources, there is a section called "Common module settings".
==Availability==

The Available setting has up to 3 possible options (depending on whether 'Allow stealth activities' is enabled by an administrator in the Site administration).

;Show on course page
: The activity or resource is available to students (subject to any access restrictions which may be set).

;Hide from students
: The activity or resource is only available to users with permission to view hidden activities (by default, users with the role of teacher or non-editing teacher).

;Make available but not shown on course page
: For simplifying the course page. A link to the activity or resource must be provided from elsewhere, such as from a page resource. The activity is still listed in the gradebook and other reports.

See also [[Stealth activities]].

==ID number==

Setting an ID number provides a way of identifying the activityfor grade calculation purposes. If the activity is not included in any grade calculation then the ID number field can be left blank.

The ID number can also be set on the edit grade calculation page in the [[Gradebook]], though it can only be edited on the update activity page of the module in a course context.

The ID number may also be used by other modules and plugins.

==Force language==
{{New features}}
The teacher can force a language to be used in an individual activity, rather than for the whole course. An example is if students are studying a language and the course is in their native language but a particular activity such as an Assignment is forced to their target language, to encourage them to focus.
==Include in course content download==
If download course content is enabled, and if the content is downloadable (currently File, Folder, Page and Text and Media area) then should this item be downloaded?

==Group mode==
[[Groups]] are set up on the course level.
When course group mode is turned on and force is set to no, the [[Groups|group mode]] can be one of three levels on the activity level: no groups, separate groups or visible groups.

;No groups
:There are no groups and all students submit their individual activities in one area.

;Separate groups
:Students submit their activity and teachers/trainers can sort submissions by Group or view All Participants.

;Visible groups
:All students submits their assignment within a single Assignment area but may choose which Group to associate their submission with before uploading. Teachers/trainers can sort submissions by Group or view All Participants.

==Groupings==
[[Groupings]] are a collection of groups that are set up on the course level.

==See also==
Common module settings are used in
*[[Adding/editing an assignment]]
*[[Adding/editing a chat]]
*[[Adding/editing a choice]]
*[[Adding/editing a database]]
*[[Adding/editing a forum]]
*[[Adding/editing a glossary]]
*[[Adding/editing a lesson]]
*[[SCORM module]]
*[[Adding/editing a survey]] does not mention at all
*[[Adding/editing a quiz]]
*[[Adding/editing a wiki]]
Other areas
*[[Groupings]]
*[[Grade export]]
*[[Grade calculations#Assigning ID numbers|Assigning module ID numbers for Grade calculations]]

[[ja:共通モジュール設定]]
[[es:Configuraciones comunes del módulo]]
[[de:Weitere Einstellungen]]

Grade summary report

2022-11-23T13:20:39Z

Ghillenb:

{{Grades}}
{{New features}}
==Grade summary report==
Accessed from ''Course navigation > Grades'', this report shows all gradeable activities in the course with their average grades.

The report can be filtered by activity:

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

[[de:Bewertungsbericht]]

Custom report settings

2022-11-23T13:18:35Z

Ghillenb:

{{New features}}
From ''Site administration > Reports > Report builder'', this page allows admins settings page allows the admin to:
* limit the number of custom reports.
* disable live editing.

Both these actions will then have a beneficial effect on performance, if required.

[[de:Einstellungen für nutzerdefinierte Berichte]]

Support contact

2022-06-23T16:09:50Z

Ghillenb:

From ''Site administration > Server > Support contact,'' the administrator must specify an email address and optional support page.

{{New features}}

The email address is mandatory because if a message fails to send then the email address will be displayed for users to contact support.

The link 'Contact site support' is accessed from the question mark icon bottom right of the desktop screen.

[[File:Contactlink.png|Contact site support link]]

[[es:Contacto para soporte]]
[[de:Supportanfragen]]

Site admin presets

2022-06-23T16:06:15Z

Ghillenb:

{{New features}}

'''Site admin presets''' allow administrators to create, apply, download and import different site configurations.

The feature is accessed from ''Site administration > Site admin presets.''

Two presets are available by default: the Starter and the Full. From the Actions menu, the admin can review the settings and apply a preset, or download it to use elsewhere.

An Import button allows the admin to import a preset to use on the site, and after changing some configurations, the admin can create a customised preset by pressing the Create button.

{{MediaPlayer | url = https://youtu.be/Ma-rio4ugUs | desc = Overview of site admin presets}}

==See also==

* The project page [[:dev:Site admin presets]]

[[es:Preconfiguraciones administrativas del sitio]]
[[de:Website-Admin-Vorlagen]]

Transitioning to HTTPS

2022-06-01T13:01:45Z

Ghillenb: /* See also */

{{Security}}
There are [https://developers.google.com/web/fundamentals/security/encrypt-in-transit/why-https numerous benefits] to running your moodle site using HTTPS. This increases the level of security especially involving sessions and passwords.

== Steps ==
=== Before you start ===
Check all the content you use supports https. Use the [[HTTPS conversion tool]] to do this.

Make sure you have a staging environment. You will want to set up HTTPS the first time on a staging environment rather than updating your live site. It will take some time to convert to https and you will need to update content (see below).

=== Setting up an SSL certificate ===
The first thing you will need to do is acquire an SSL certificate. You can create these yourself, but this is only helpful for development purposes. Instead you will want to get your SSL certificate from a certificate authority, so that the certificate will be publicly verified.

The cost of certificates has been somewhat prohibitive, they come at various costs from a few dollars to hundreds of dollars per year. For the budget constrained, the "price is right" with a new initiative brought to us by the Internet Security Research Group (ISRG). Free domain-validated certificates can be acquired from [https://letsencrypt.org Let's Encrypt]. Let's Encrypt also tries to make the process of installing and managing certificates as painless as possible and there are numerous methods and clients available.

=== Setting up your server ===
Then you will need enable SSL on your web server to add your certificate. This process will vary depending on your web server of choice.

If you are using a proxy or load balancer, depending on your setup you will most likely want to set up the SSL certificate on your proxy server

=== Setting up your Moodle ===

On a basic Moodle site, it will be simple to set up https. Simply edit config.php and change http:// to https:// in $CFG->wwwroot.

However, if you are using a proxy or load balancer, depending on your setup you may need to set $CFG->sslproxy to 1, and not use SSL on the Moodle server. Then the load balancer or proxy server can communicate directly to your Moodle site, but serve to the clients over SSL.

=== Redirecting the HTTP address to the new HTTPS address ===

You may want to add a redirection so that users who have the current http:// address to your site will be redirected automatically to the https:// address instead of getting a page with a message such as "For security reasons only https connections are allowed, sorry."

There are several ways to do redirections, depending on your web server, hosting, and how you prefer to do this. A common solution on Apache web servers is to create an .htaccess file with a rewrite rule such as:

<syntaxhighlight lang="apacheconf">
RewriteEngine On
RewriteCond %{SERVER_PORT} 80
RewriteRule ^(.*)$ https://www.yourmoodle.com/$1 [R,L]
</syntaxhighlight>
or in general
<syntaxhighlight lang="apacheconf">
RewriteEngine On
RewriteCond %{SERVER_PORT} 80
RewriteRule ^(.*)$ {SERVER_NAME}/$1 [R,L]
</syntaxhighlight>

Be sure to look up current ways to do this for your web server and host, such as the how-to article [https://www.ssl.com/how-to/force-https-connections-in-an-apache-server-environment/ Force HTTPS connections in an Apache server environment].

=== Updating content ===
You will need to change all embeded content from being requested over http. Links do not matter. But you will need to update images and iframes, scorm modules, and LTI external tools. You can modify external tools to open in a new window instead of in an iframe and they will work fine.

A new tool was added to Moodle 3.4 to aid in this process. This is available via a link in ''Site administration > Security > HTTP security > HTTPS conversion tool''. See MDL-46269 for details.

== See also ==

* [https://developers.google.com/web/fundamentals/security/encrypt-in-transit/why-https Why HTTPS Matters - Google Web Fundamentals]

[[es:Haciendo la transición a HTTPS]]
[[de:Moodle auf HTTPS umstellen]]

BigBlueButton

2022-05-31T15:24:38Z

Ghillenb:

{{Activities}}
{{New features}}
==What is the BigBlueButton activity?==
BigBlueButton lets you create from within Moodle links to real-time on-line classrooms using BigBlueButton, an open source web conferencing system for distance education. You can specify conference times, which are then added to the calendar, and, if allowed in your installation, the sessions may be recorded for viewing later.

<p class="note">Note: For data protection reasons, BigBlueButton is disabled by default. Administrators must enable it from Site administration > Plugins > Manage activities and then check the box to accept the data processing agreement.</p>

Free Tier Hosting is currently restricted as follows:
# The maximum length for each session is 60 minutes;
# The maximum number of concurrent users per session is 25;
# Recordings expire after seven (7) days and are not downloadable; and
# Viewers' (student) webcams are only visible to the moderator.

{{MediaPlayer | url = https://youtu.be/Bb7yYE_Fs3s | desc = Overview of BigBlueButton}}

==How is it set up?==

{{MediaPlayer | url = https://youtu.be/qXkzXuCF8aM | desc = How to set up and use BigBlueButton}}
*In a course, with Edit mode enabled, choose, BigBlueButton from the activity chooser.
*Choose a name and description, and, if desired, a welcome message which will appear in the Chat box when participants join the session.
*If you tick "wait for moderator", students can only join once someone with the moderator role has entered the room.
*From the Participants list you can, if needed, give specific roles to specific people, such as a moderator role.
*In the Schedule section you can set a start time and also a time after which student will not be able to enter the room.

==How does it work?==
*Once set up, the activity appears with a link to join when the time is correct. (Before then, or if a moderator is required first. a message appears saying the conference has not yet started.)
[[File:bbb-room.png|alt=]]
*On entering the room, a message will appear asking if you want to use your microphone or just listen. If you choose microphone you will need to check your settings.
*The moderator can choose whether to allow participants to use webcams and microphones or not.
*The central area can display presentations, polls, screensharing or an interactive whiteboard.
*There is also a chat option with public and private chat.

[[Category:BigBlueButton]]
[[es:BigBlueButton]]
[[de:BigBlueButton]]
[[File:bbb24 test-moodle.png|left|frameless|600x600px]]

Accessibility review block

2021-06-18T07:18:11Z

Ghillenb:

{{Blocks}}
{{New features}}
If the [[Accessibility toolkit]] is enabled by the site admin, course teachers may be allowed to add an accessibility review block. The block allows them to submit their course for an accessibility analysis and it will then display useful information including:

* A summary of the accessibility errors for the course categorized by type.
* A heatmap which highlights the errors for each course element. You can activate or hide the heatmap by clicking on the eye.
* A link to the accessibility toolkit which includes different reports and the error list with links to edit the mistakes
* A link to download the accessibility toolkit summary report in a printable pdf format.

Note: Students cannot see this block, as it is only for teachers.

[[{{ns:file}}:BrickfieldTeacher.png|600px|none|Accessibility heatmap on course main page]]

==Important Links==

* Registration Portal [https://account.mybrickfield.ie/register Brickfield registration portal]
* Brickfield partnership with Moodle [https://moodle.com/news/moodle-increases-focus-on-accessibility-through-collaboration-with-brickfield-education-labs/ Moodle News story] - [https://www.brickfield.ie/2021/04/27/brickfield-partnering-with-moodle/ Brickfield Blog]
* Blog Post [https://moodle.com/news/new-accessibility-checker-starter-toolkit-in-moodle-3-11/ New Accessibility Checker Starter Toolkit in Moodle 3.11]
* Enterprise version [https://www.brickfield.ie/brickfield-accessibility-enterprise-toolkit/ Brickfield Accessibility Toolkit].

[[Category:Accessibility]]
[[Category:Block]]

[[es:Bloque de revisión de accesibilidad]]
[[de:Barrierefreiheit prüfen]]

Accessibility review block

2021-06-18T07:17:35Z

Ghillenb:

{{Blocks}}
{{New features}}
If the [[Accessibility toolkit]] is enabled by the site admin, course teachers may be allowed to add an accessibility review block. The block allows them to submit their course for an accessibility analysis and it will then display useful information including:

* A summary of the accessibility errors for the course categorized by type.
* A heatmap which highlights the errors for each course element. You can activate or hide the heatmap by clicking on the eye.
* A link to the accessibility toolkit which includes different reports and the error list with links to edit the mistakes
* A link to download the accessibility toolkit summary report in a printable pdf format.

Note: Students cannot see this block, as it is only for teachers.

[[{{ns:file}}:BrickfieldTeacher.png|600px|none|Accessibility heatmap on course main page]]

[[Category:Accessibility]]
[[Category:Block]]

[[es:Bloque de revisión de accesibilidad]]
[[de:Barrierefreiheit prüfen]]

==Important Links==

* Registration Portal [https://account.mybrickfield.ie/register Brickfield registration portal]
* Brickfield partnership with Moodle [https://moodle.com/news/moodle-increases-focus-on-accessibility-through-collaboration-with-brickfield-education-labs/ Moodle News story] - [https://www.brickfield.ie/2021/04/27/brickfield-partnering-with-moodle/ Brickfield Blog]
* Blog Post [https://moodle.com/news/new-accessibility-checker-starter-toolkit-in-moodle-3-11/ New Accessibility Checker Starter Toolkit in Moodle 3.11]
* Enterprise version [https://www.brickfield.ie/brickfield-accessibility-enterprise-toolkit/ Brickfield Accessibility Toolkit].

[[de:Barrierfreiheit prüfen]]

New for students

2021-06-17T12:36:56Z

Ghillenb:

{{About Moodle}}
If you are a student on Moodle, here's a quick overview of the changes you can expect to see when your Moodle site is using Moodle 3.11
__NOTOC__
<div class="contentblock">
<div class="row-fluid">
<ul class="thumbnails">
<li class="span6">
<div class="thumbnail">
[[File:ActivityCompletion311.png|600px]]
<div class="caption">
<h4>Clear view of tasks and deadlines</h4>
<p>View activity dates and completion criteria on the course page</p>
</div>
</div>
</li>
<li class="span6">
<div class="thumbnail">
[[File:311CompletionWithinActivity.png|600px]]
<div class="caption">
<h4>Never miss a deadline or task</h4>
<p>View activity dates and completion criteria in the activity page.</p>
</div>
</div>
</li>
</ul>
</div>
<div class="contentblock">
<div class="row-fluid">
<ul class="thumbnails">
<li class="span6">
<div class="thumbnail">
[[File:StudentManualCompletion.png|600px]]
<div class="caption">
<h4>Streamlined manual completion</h4>
<p>Mark complete from within the activity and go directly to your next task</p>
</div>
</div>
</li>
<li class="span6">
<div class="thumbnail">
[[File:StudentQuizPass.png|600px]]
<div class="caption">
<h4>Quiz pass grades</h4>
<p>View pass grades when accessing a Quiz.</p>
</div>
</div>
</li>
</ul>
</div>
<div class="contentblock">
<div class="row-fluid">
<ul class="thumbnails">
<li class="span6">
<div class="thumbnail">
[[File:PlayRate.png|600px]]
<div class="caption">
<h4>Audio / Video playback rates</h4>
<p>Control how fast sound and video files play back.</p>
</div>
</div>
</li>
<li class="span6">
<div class="thumbnail">
[[File:QuizMinMaxStudent.png|600px]]
<div class="caption">
<h4>Essay word limits</h4>
<p>Be alerted when submitting too few or too many word in a Quiz Essay.</p>

</div>
</div>

[[Category:New features]]

[[es:Nuevo para estudiantes]]
[[de:Neu für Teilnehmer/innen]]
[[pt-br:Novo para estudantes]]

OAuth 2 Open Badges service

2021-06-11T08:21:16Z

Ghillenb:

{{OAuth2}}{{New features}}

You need to set up an OAuth 2 Open Badges service in order to enable users to connect to their Open Badges v 2.1 compliant backpack without having to enter their credentials into Moodle.

''Please add instructions here...''

==See also==

* The section 'Open Badge Connect API' in the dev doc [[:dev:OAuth 2 API|OAuth 2 API]]

[[Category: Badges]]

[[es:Servicio OAuth2 Open Badges]]
[[de:OAuth2 Open Badges Service]]

OAuth 2 Open Badges service

2021-06-11T08:20:32Z

Ghillenb:

H5P

2021-06-11T08:15:19Z

Ghillenb:

{{Managing content}}
==About H5P==

H5P is an abbreviation for HTML5 Package. It enables educators to create content such as interactive videos, quizzes and presentations. H5P content can be created in the [[Content bank]] or on the [https://h5p.com/ h5p.com site], or with the [https://next.lumi.education/ LUMI] app for desktop, and added to your course as an [[H5P activity]] (new in 3.9 onwards) or embedded into any other activity or resource.

H5P [https://moodle.org/mod/forum/discuss.php?d=420158#p1693270 does not yet feature the option for collaborative or competitive exercises].

==Important notice (warning)==
Due to how H5P behaves in Moodle, most content types allow for unlimited attempts by students. You should not use H5P for major assignments such as exams.

==Important information for H5P users in languages other than English==
Currently (april 2021) the names and descriptions of the H5P modules when using the Moodle [[Content bank]] are in English language only, but when using [https://next.lumi.education/ LUMI], these names and descriptions [https://docs.moodle.org/dev/Translating_plugins#Translation_of_H5P_module.27s_names_using_weblate may be translated] to other languages (Spanish example below):

[[File:H5P nombres en ingles en banco de contenido.png|600px]]

[[File:H5P LUMI 3.png|600px]]

==Creating and editing H5P content in the Content bank==

To create and edit H5P content,
# Go to the [[Content bank]], accessible when in a course from the Navigation drawer (Boost theme) or from Site pages in the Navigation block (Classic theme).
# Click the Add button and select a content type.

For more information, see [[Content bank]].

==Creating and editing H5P content elsewhere==
You can go to the [https://h5p.com/ h5p.com site], or you can install the [https://next.lumi.education/ LUMI] app for desktop (Windows, Mac and Linux versions available),

Make sure you download the newly created H5P file that you will later upload to your Moodle course.

You must be aware that some parameters limit the file upload size for H5P objects in your server. Course file size limit is one of them.

==Adding an H5P activity to a course==

See [[H5P activity]] for how to create an H5P activity in a course.

==Embedding H5P into other activities==
[[File:H5PiconAtto.png|thumb|H5P button in the Atto editor]]
You can embed H5P content into other activities and resources such as a [[Lesson]] or a [[Book]], by clicking the H5P button in the [[Atto editor]].

To embed H5P from the Content bank:

# Click the H5P button in Atto then click 'Browse repositories'.
# Browse the Content bank repository and select an H5P file.
# Choose to either make a copy of the file or create a shortcut.
# Click the button 'Select this file'.
# Click 'Insert H5P'.
[[File:creating a shortcut.png|thumb|Creating a shortcut to the file]]
Note: If you create a shortcut to the file, you can edit it in the Content bank and any activities with a link to the file will be updated.

==Admin settings==

For H5P content to display in other activities, the [[Display H5P filter]] must be enabled and the URL e.g. h5p.com should be listed as an allowed source in ''Site admin / Plugins / Filters / Display H5P''.

===Manage H5P content types===

Site administration / H5P / Manage H5P content types

For teachers to upload and display H5P files in their courses, [https://h5p.org/content-types-and-applications H5P content types] and libraries must be available on the site. A scheduled task ''Download available H5P content types from h5p.org'' does this automatically (but check if it is enabled and has already run after first upgrading your site).

If it is not possible to use this scheduled task, then the Site administration page 'Manage H5P content types' allows you to upload necessary files.

(If the scheduled task is not run and files are not uploaded, teachers will receive an error message when attempting to upload H5P content.)

{{New features}}In Moodle 3.11 onwards, an admin can choose to disable selected H5P content types, for example ones duplicating quiz functionality.

==Capabilities==

In addition to capabilities relating to the [[H5P activity]] and the [[Content bank]] there are further H5P capabilities as follows:

* [[Capabilities/atto/h5p:addembed|Add embedded H5P]] - allowed for the default role of teacher
* [[Capabilities/moodle/h5p:setdisplayoptions|Set H5P display options]] - allowed for the default role of teacher
* [[Capabilities/moodle/h5p:updatelibraries|Manage H5P content types]] - allowed for the default role of manager only
* [[Capabilities/moodle/h5p:deploy|Deploy H5P content]] - allowed for the default roles of manager and teacher

==See also==

* [[H5P activity]]
* [[H5P FAQ]]
* [https://next.lumi.education/ LUMI] is a free (Open Source) desktop app that allows you to create, edit and share H5P interactive content with dozens of different content types. It is in English natively, but it has great support for languages other than English.
* [https://elearningworld.h5p.com/content/1290985419330027149 Comparison chart of H5P questions and standard quiz questions]
* [https://www.youtube.com/watch?v=hxYgod9CIYg Moodle & H5P, Magic Together | Michelle Lomman | MoodleMoot Global 2020]
* [https://h5p.org/node/258172 H5P in Moodle documentation] with many useful tips and warnings

[[Category:H5P]]
[[Category:Language teaching]]

[[es:H5P]]
[[de:H5P]]

Backpacks

2021-06-10T13:59:50Z

Ghillenb: /* Open Badges v 2.1 */

{{Badges}}
Enabling users to connect to an external backpack means they can add badges from their Moodle site to their backpack and also display badges from other sites in their Moodle profile.
[[File:ManageBackPacks.png|thumb|Manage backpacks]]
==Site administration settings==

The backpack badgr.io is provided by default. Additional backpacks, for users with an account on eu.badgr.io, ca.badgr.io or au.badgr.io, may be added as follows:

# Go to Site administration / Badges / Manage backpacks.
# Click the button 'Add a new backpack'.
# Create this backpack with the following details:
#* Backpack API URL - https://api.eu.badgr.io/v2
#* Backpack URL - https://eu.badgr.io
#* API version - Open Badges v2.0
#* (Leave 'Include authentication details with the backpack' unticked.)

{{New features}}In Moodle 3.11 onwards, an admin can set the order in which backpacks are listed for users.

==Individual user settings==

You can connect to your backpack as follows:

# In the user menu (top right), select Preferences, then 'Backpack settings' under Badges.
# If necessary, select your backpack provider.
# Enter your Badgr user account email and password.
# Look in your mailbox for a verification email and copy and paste the link to verify your connection to the backpack.

After the backpack connection is successfully established, badges from your backpack can be displayed on your badges page and your profile page. Go to Manage badges (via Preferences / Badges) and click the icon to add your badge to your backpack.

You can also select collections of badges from your backpack that you would like to display in your profile.

==Open Badges v 2.1==

Moodle 3.11 is Open Badges v 2.1 compliant and a new [[OAuth 2 Open Badges service]] enables users to connect to their OB v 2.1 compliant backpack without having to enter their credentials into Moodle.

[[es:Mochilas]]
[[de:Backpacks]]

Activity completion report

2021-06-10T11:18:04Z

Ghillenb:

{{Course reports}}
Activity completion info can be viewed by managers, teachers and non-editing teachers (and any other users with the capability [[Capabilities/report/progress:view|report/progress:view]]) by clicking the gear icon top right and selecting "More> Reports>Activity completion" (with the Boost theme) or from ''Administration> Course administration> Reports > Activity completion'' with non-Boost themes.

Teachers can mark activities complete on behalf of students by clicking into the relevant completion boxes. This requires the capability [[Capabilities/moodle/course:overridecompletion|Override activity completion status]] which is enabled for editing and non-editing teachers by default. Activities marked complete by the teacher display with a red border in the activity completion report.

{{New features}}
In Moodle 3.11 onwards, the activity completion report can be filtered by activity type and order in the course.

[[File:activitycompletionreport311.png|center]]
[[Category: Completion]]

[[es:Reporte de finalización de actividad]]
[[de:Aktivitätsabschlussbericht]]

Activity completion report

2021-06-10T11:16:30Z

Ghillenb:

Accessibility Toolkit

2021-06-10T11:03:57Z

Ghillenb:

{{New features}}
==About the Accessibility Starter Toolkit==
Moodle 3.11 incorporates the Brickfield Accessibility Starter Toolkit to help organisations create accessible course content.

This page explains the usage of the Starter Toolkit. If you are looking for information on the enterprise product - please check the [https://www.brickfield.ie/brickfield-accessibility-toolkit/ Brickfield Education Labs website].

The Accessibility Starter Toolkit allows educators and administrators to assess the accessibility of their course content and to identify existing common accessibility issues.

You can also get a graphic display of types of error, and a report with an overview of all errors. In order to use it, first the site administrator has to register into Brickfield and then activate the plugin in the Moodle site.
{{MediaPlayer | url = https://youtu.be/Vj3aEgb1ihw | desc = Accessibility Toolkit in Moodle 3.11}}

==Registration==
From the Site administration panel, Moodle admins will find the Accessibility Toolkit under Admin tools in the Plugins section. The Accessibility Toolkit pages all initially redirect to the registration page, which needs to be submitted with a set of keys, an API key and a secret key, which are generated for you, once you have registered on the [https://account.mybrickfield.ie/login Brickfield registration portal].

[[{{ns:file}}:BrickfieldAdmin1.png|600px|none|Accessibility registration page]]

==Admin settings==
The accessibility Toolkit's main purpose is to process content accessibility analysis, and initially this is set to disabled to allow institutions to enable it when ready. This is done at Site administration / Plugins / Admin tools / Accessibility / Accessibility toolkit settings with the "Enable analysis requests" setting.

[[File:toolkitsettings.png|500px|center]]

==Teacher usage==
In your course, add the Accessibility review block and click the "Submit for analysis" button. After some minutes, you’ll see the results of the analysis. Please note that the first time that you run the analysis is not immediate. You can also run the analysis from the Edit cog

It includes the automated analysis of these requested Moodle course against a set of common accessibility rules, checking the content inside all of Moodle’s core activities. The Accessibility Toolkit then generates reports of all detected accessibility errors, which can also be broken down by type of content or type of activity. This provides insights to educators and organisations on the overall accessibility of their courses and the areas that should be improved.

Once a course has been analysed, any ongoing updates or edits or additions within the course will also be analysed automatically, being triggered by Moodle's event observers / callbacks.

==Report pages for the course==
The Accessibility Toolkit link to its reports is accessed via a course's Actions menu (Boost theme) or via the course administration block (Classic theme). It can also be accessed via the accessibility review block, if this has been added to the course.

The Accessibility Toolkit provides a number of reports, to display the detected accessibility errors:

* Error list with direct links, which makes it really easy to navigate to their location and fix them.
* Activity breakdown, showing pass ratios per activity
* Content types, showing error counts per type of content
* Summary report, showing a summary of the other reports combined

[[{{ns:file}}:SummaryReport.png|600px|none|Accessibility summary report]]

==Report pages for the site==
From Site Administration / Plugins tab / Admin Tools / Accessibility / Reports the administrator can access the site reports generated by the Accessibility Toolkit.

The accessibility toolkit provides a number of reports, to display the detected accessibility errors:

* Error list with direct links, which makes it really easy to navigate to their location and fix them.
* Activity breakdown, showing pass ratios per activity
* Content types, showing error counts per type of content
* Summary report, showing a summary of the other reports combined

This is a global-site report, provided data is from the whole site, not for each course. If you need more specific information about a course, go to the course Accessibility Toolkit.

[[{{ns:file}}:SummaryReport.png|600px|none|Accessibility summary report]]

==Course block==
The accessibility review block can be added to a course to display useful information to the teacher. See [[Accessibility review block]] for more information.

==Important Links==

* Registration Portal [https://account.mybrickfield.ie/register Brickfield registration portal]
* Brickfield partnership with Moodle [https://moodle.com/news/moodle-increases-focus-on-accessibility-through-collaboration-with-brickfield-education-labs/ Moodle News story] - [https://www.brickfield.ie/2021/04/27/brickfield-partnering-with-moodle/ Brickfield Blog]
* Blog Post [https://moodle.com/news/new-accessibility-checker-starter-toolkit-in-moodle-3-11/ New Accessibility Checker Starter Toolkit in Moodle 3.11]
* Enterprise version [https://www.brickfield.ie/brickfield-accessibility-enterprise-toolkit/ Brickfield Accessibility Toolkit].

==Any questions?==

Please post in the [https://moodle.org/mod/forum/view.php?id=8207 Accessibility and usability forum] on moodle.org.

[[Category: Accessibility]]

[[es:Herramientas de accesibilidad]]
[[de:Tools zur Barrierefreiheit]]

Accessibility review block

2021-06-10T10:58:33Z

Ghillenb:

{{Blocks}}
{{New features}}
If the [[Accessibility toolkit]] is enabled by the site admin, course teachers may be allowed to add an accessibility review block. The block allows them to submit their course for an accessibility analysis and it will then display useful information including:

* A summary of the accessibility errors for the course categorized by type.
* A heatmap which highlights the errors for each course element. You can activate or hide the heatmap by clicking on the eye.
* A link to the accessibility toolkit which includes different reports and the error list with links to edit the mistakes
* A link to download the accessibility toolkit summary report in a printable pdf format.

Note: Students cannot see this block, as it is only for teachers.

[[{{ns:file}}:BrickfieldTeacher.png|600px|none|Accessibility heatmap on course main page]]

[[Category:Accessibility]]
[[Category:Block]]

[[es:Bloque de revisión de accesibilidad]]
[[de:Barrierefreiheit prüfen]]

==Important Links==

* Registration Portal [https://account.mybrickfield.ie/register Brickfield registration portal]
* Brickfield partnership with Moodle [https://moodle.com/news/moodle-increases-focus-on-accessibility-through-collaboration-with-brickfield-education-labs/ Moodle News story] - [https://www.brickfield.ie/2021/04/27/brickfield-partnering-with-moodle/ Brickfield Blog]
* Blog Post [https://moodle.com/news/new-accessibility-checker-starter-toolkit-in-moodle-3-11/ New Accessibility Checker Starter Toolkit in Moodle 3.11]
* Enterprise version [https://www.brickfield.ie/brickfield-accessibility-enterprise-toolkit/ Brickfield Accessibility Toolkit].

H5P FAQ

2021-02-11T15:48:44Z

Ghillenb:

<div class="navtrail">[[Main page]] ► [[Managing content]] ► [[H5P]]</div>
<div class="sideblock right" style="width: 14em;">
<div class="header">[[H5P]]</div>
<div class="content">
* [[H5P FAQ]]
</div>
</div>

==How can I add H5P content to a Lesson or Book?==

You can easily add existing H5P content to a [[Lesson]], [[Book]], or other activity or resource via the H5P icon in the Atto editor.

See the section 'Embedding H5P' in [[H5P]] for details.

==How can I ensure that the grade from the H5P content is stored in the gradebook?==

You need to use a [[H5P activity]] rather than embedding the H5P content in a different activity.

==Can I migrate content from the mod_hvp plugin to the H5P activity in standard Moodle?==

Yes, with the [[H5P migration tool]].

==Is it possible to import H5P question types into the Moodle question bank?==

Yes - for some (though not all) H5P question types, using the [[H5P content types format]] plugin.

==How can I make sure that my H5P content is accessible?==

Please see the h5p.com documentation [https://documentation.h5p.com/content/1290410474004879128 Recommendations and overviews of content types].

==Is it possible to style H5P content the same as the rest of my site?==

Yes (in Moodle 3.10 onwards)! Please see the dev documentation [[:dev:H5P styles|H5P styles]].

==Any further questions?==

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

[[Category:H5P]]
[[Category:FAQ]]

[[es:H5P FAQ]]
[[de:H5P FAQ]]

H5P activity

2021-02-11T15:47:27Z

Ghillenb:

{{Activities}}
__NOTOC__
==What is the H5P activity?==
The H5P activity enables H5P content created in the [[Content bank]] or on h5p.com to be easily added to a course as an activity.

{{MediaPlayer | url =https://youtu.be/ctRh1vtVXFA | desc = The H5P activity}}

Note: You can also embed H5P content into any activity or resource, such as a [[Lesson]] or a [[Book]], via the H5P button in the Atto editor, as described in the [[H5P|H5P overview]].

==How is it set up?==
#Ensure that you first have an existing H5P activity to upload, or that you have created one in the [[Content bank]].
#In a course, with the editing turned on, choose 'H5P' from the activity chooser.
#Give it a name and, if needed, a description.
# From Package file > File picker, add your H5P file from the Upload a file link or from the Content bank. '''Note:''' If you add the content as an alias, any modifications will be displayed here but if you add it as a copy, the modifed version will not display. For more information see [[Working with files]]
#Expand the other sections to select the settings you want, and then click Save and return to course.

==How does it work?==
===Student view===
Students click on the H5P icon in the course to access it.

[[File:StudentH5Pview.png|center]]

Depending on the H5P activity and teacher's settings, the activity may be gradeable. Students can see their attempts from the View my attempts link top right.

[[File:StudentH5PScore.png|center]]

In the attempts report, the success column reports when the student has obtained 100% in the activity. The completion column reports whether the student went through the H5P content to the end. (The attempts report only displays data from the H5P content - there is no connection with the 'Grade to pass' activity setting nor with activity completion settings.)

===Teacher view===
Teachers can see all attempts by all users from the link above the activity. Note that the figure refers to the number of attempts, not to the number of students who have attempted the activity.
[[File:h5pteachersubmitted.png|center]]

==Capabilities==

There are 4 capabilities relating to the H5P activity:

* [[Capabilities/mod/h5pactivity:addinstance|Add a new H5P]] activity to the course
* [[Capabilities/mod/h5pactivity:reviewattempts|Review H5P attempts]]
* [[Capabilities/mod/h5pactivity:submit|Submit H5P attempts]]
* [[Capabilities/mod/h5pactivity:view|View H5P]]

==More information==

* [[H5P]] for more information on H5P in Moodle, including embedding H5P content.
* [[H5P FAQ]]
* [[H5P migration tool]] for migrating content from the mod_hvp plugin to the H5P activity

[[Category: H5P]]

[[es:Actividad H5P]]
[[de:H5P-Aktivität]]

admin/payment/manage account

2021-01-12T17:12:40Z

Ghillenb: Redirected page to Payment gateways

#redirect[[Payment gateways]]

Payment gateways

2021-01-12T17:02:27Z

Ghillenb:

{{Managing a Moodle site}}
{{New features}}
A payment gateway is a technology used by merchants to accept debit or credit card purchases from customers.

In Moodle 3.10 onwards, payment gateways are used with [[Enrolment on payment]] to provide different payment options when purchasing access to a course.

Payment gateways are a plugin type with the PayPal payment gateway included as standard. It is expected that more payment gateways will be developed in the future and shared in the [https://moodle.org/plugins/browse.php?list=category&id=80 Moodle plugins directory:Plugin type: Payment gateways].

==Payment gateway set-up==

# Go to ''Site administration / Plugins / Payment gateways'' and enable payment gateways as required.
# Click the settings link for each payment gateway to set a surcharge i.e. an additional percentage charged to users who choose to pay using this payment gateway, then save changes.

==Payment account set-up==

# Go to ''Site administration / Plugins / Payment gateways'' and click the link 'Payment accounts'.
# Click the button 'Create payment account' then enter an account name for identifying it when setting up enrolment on payment, then save changes.
# On the Payment accounts page, click the payment gateway link e.g. PayPal opposite the account name.
# Enter a client ID and secret from PayPal, tick the Enable box and save changes.

The payment gateway will then show as enabled for the account.

Multiple payment accounts may be set-up as required.

When done, the payment gateway and payment accounts are ready to be used with [[Enrolment on payment]].

{{MediaPlayer | url = https://www.youtube.com/watch?v=1jk05y7bTus | desc = Payment gateways}}

==See also==

* [[Enrolment on payment]]

[[es:Portales de pago]]
[[de:Zahlungs-Gateways]]

Capabilities/enrol/fee:manage

2021-01-07T11:09:59Z

Ghillenb:

{{Capabilities}}
* This capability allows a user to manage users enrolled through [[Enrolment on payment]].
* This capability is allowed for the default roles of manager and teacher.

[[Category:Capabilities|Enrol]]
[[Category:Enrolment]]

[[es:Capabilities/enrol/fee:manage]]
[[de:Capabilities/enrol/fee:manage]]

Capabilities/enrol/fee:config

2021-01-07T11:07:28Z

Ghillenb:

{{Capabilities}}
* This capability allows a user to configure (including delete) an [[Enrolment on payment]] instance for a course.
* This capability is allowed for the default role of manager only.

[[Category:Capabilities|Enrol]]
[[Category:Enrolment]]

[[es:Capabilities/enrol/fee:config]]
[[de:Capabilities/enrol/fee:config]]

Enrolment on payment

2021-01-06T11:34:54Z

Ghillenb:

{{Enrolment}}{{New features}}

{{MediaPlayer | url = https://www.youtube.com/watch?v=1jk05y7bTus | desc = Payment gateways}}

''Please add info...''

==Enrolment on payment capabilities==

*[[Capabilities/enrol/fee:config|Configure enrolment on payment instances]]
*[[Capabilities/enrol/fee:manage|Manage enrolled users]]
*[[Capabilities/enrol/fee:unenrol|Unenrol users from course]]
*[[Capabilities/enrol/fee:unenrolself|Unenrol self from course]]

[[es:Inscripción al pagar]]
[[de:Einschreibung bei Zahlung]]

Download course content

2021-01-06T11:26:10Z

Ghillenb:

{{New features}}
==Download course content==
Specific course items, currently content from the File, Folder, Page and Label can be downloaded if enabled site wide and in individual courses.

Note: This feature was made possible with funding from the '''[https://moodleassociation.org/| Moodle Users Association.]
'''
{{MediaPlayer | url = https://youtu.be/Dsef2LcmTN0 | desc = Downloading course content}}

==For students==
*''If the feature is made available by the administrator and enabled in a course by the teacher'', then students and other users with the [[Capabilities/moodle/course:downloadcoursecontent|capability to download course content]] will see a button top right in the course.
*Clicking the button will display a pop-up and link to a zipped file.

==For teachers==
*''If the features is made available by the administrator'', then course teachers see an option Enable download course content in the course settings.
*They can then choose Yes to make content downloadable, or No if they prefer not to.

==For administrators==
*Download course content can be made available from Site administration >Courses > Download course content.
*Here, the admin can also specify the maximum size of files which may be downloaded.
*Optionally, from Site administration > Courses >Course default settings, the admin can make the feature enabled by default in courses.

==Capabilities==
* [[Capabilities/moodle/course:configuredownloadcontent|Configure download course content]] - allowed for the default roles of manager and teacher.
* [[Capabilities/moodle/course:downloadcoursecontent|Download course content]] - allowed for the default roles of manager, teacher, non-editing teacher and student.

[[es:Descargar contenido del curso]]
[[de:Kursinhalt herunterladen]]

Capabilities/moodle/course:downloadcoursecontent

2021-01-06T11:23:06Z

Ghillenb:

{{Capabilities}}
{{New features}}
*This allows a user to download course content if the [[Download course content]] feature is enabled.
*This capability is allowed for the default roles of manager, teacher, non-editing teacher and student.

[[Category:Capabilities]]

[[es:Capabilities/moodle/course:downloadcoursecontent]]
[[de:Capabilities/moodle/course:downloadcoursecontent]]

Capabilities/moodle/course:configuredownloadcontent

2021-01-06T11:21:47Z

Ghillenb:

{{Capabilities}}
{{New features}}
*This allows a user to configure the [[Download course content]] feature.
*This capability is allowed for the default roles of manager and teacher.

[[Category:Capabilities]]

[[es:Capabilities/moodle/course:configuredownloadcontent]]
[[de:Capabilities/moodle/course:configuredownloadcontent]]

Capabilities/enrol/self:enrolself

2021-01-06T11:20:16Z

Ghillenb:

{{Capabilities}}{{New features}}
*This allows a user to self enrol in a course.
*This capability is allowed for the default role of authenticated user. It can be unset for the authenticated user role and allowed for particular roles to control who can self enrol in a course.
*This capability is new in Moodle 3.10 onwards.

[[Category:Capabilities|Enrol]]
[[Category:Enrolment]]

[[es:Capabilities/enrol/self:enrolself]]
[[de:Capabilities/enrol/self:enrolself]]

Capabilities/enrol/self:enrolself

2021-01-06T11:19:54Z

Ghillenb:

{{Capabilities}}{{New features}}
*This allows a user to self enrol in a course.
*This capability is allowed for the default role of authenticated user. It can be unset for the authenticated user role and allowed for particular roles to control who can self enrol in a course.
*This capability is new in Moodle 3.10 onwards.

[[C|thumb]]ategory:Capabilities|Enrol]]
[[Category:Enrolment]]

[[es:Capabilities/enrol/self:enrolself]]
[[de:Capabilities/enrol/self:enrolself]]

Capabilities/enrol/self:enrolself

2021-01-06T11:19:32Z

Ghillenb:

[[File:{{Capabilities}}{{New features}}
*This allows a user to self enrol in a course.
*This capability is allowed for the default role of authenticated user. It can be unset for the authenticated user role and allowed for particular roles to control who can self enrol in a course.
*This capability is new in Moodle 3.10 onwards.

[[C|thumb]]ategory:Capabilities|Enrol]]
[[Category:Enrolment]]

[[es:Capabilities/enrol/self:enrolself]]
[[de:Capabilities/enrol/self:enrolself]]

Accessible course design

2021-01-05T18:18:34Z

Ghillenb: /* See also */

==Headings==

Headings enable users to quickly navigate a page or document using assistive software, and provide structured sections which improves the readability of content.

To add a heading in Moodle

# Select the text to be made into a heading.
# Click the Styles button in the [[Text editor|text editor]] and choose a large, medium or small heading as appropriate.

==Hyperlinks==

===Consistent link behaviour===

Link behaviour means whether the link will open in the same window or a new window. Links should be set to be opened consistently. The following link behaviour is recommended:

* Links within the course should open in the same window.
* Links to external sites should open in a new window.

===Descriptive links===

A descriptive link is a link which describes where the link will lead to in the link text. For example, the sentence "Explore Moodle in action on the [https://school.moodledemo.net/ Mount Orange School site]." includes a descriptive link; "[https://school.moodledemo.net/ Click here] to explore Moodle in action." does not.

Plain URLs such as https://moodle.org should be avoided, as users of assistive technology must listen to the URL being read out.

To add a descriptive link in Moodle

# Select the descriptive link text.
# Click the link button in the [[Text editor|text editor]].
# Enter the URL and tick 'Open in new window' if appropriate
# Click 'Create link'.

==Text==

A [https://en.wikipedia.org/wiki/Sans-serif sans serif font] is recommended for ease of reading on a screen.

Important information should be emphasised by including it in a separate paragraph, using a word such as 'Important' or a symbol such as an asterisk. Styling such as '''bold''', ''italics'', underlining or a different colour should not be used, as users of assistive technology are often not aware of such styling.

Tip: Styling may be removed by selecting the text then clicking the 'Clear formatting' button in the text editor.

==See also==

* The [https://moodle.org/mod/forum/view.php?id=8207 Usability forum] on moodle.org
* [https://ukhomeoffice.github.io/accessibility-posters/posters/accessibility-posters.pdf A set of posters on how to design for accessibility] from the UK Home Office

[[es:Diseño accesible del curso]]
[[de:Barrierefreies Kursdesign]]

System status report

2020-08-11T17:50:34Z

Ghillenb:

{{Sitewide reports}}{{New features}}
The system status report provides information on the status of the following:

* Environment - whether the server environment meets all minimum requirements
* Upgrade - whether an upgrade is recommended
* Cron - whether the cron is running frequently
* Tasks max fail delay - whether there are any tasks failing
* Ad hoc task queue - whether the ad hoc task queue is empty

The system status report may be viewed by admins and users with the capability [[Capabilities/report/status:view|View system status]].

There is also a CLI status script. Please see MDL-47271 for details.

[[de:Systemstatus-Bericht]]
[[es:Reporte de estado del sistema]]

Policies

2020-08-11T17:24:12Z

Ghillenb: /* Capabilities */

{{Privacy}}
The policies tool provides a new user sign-on process, with ability to define multiple policies (site, privacy, third party), track user consents, and manage updates and versioning of the policies.

The policies tool forms part of Moodle’s privacy feature set assisting sites to become GDPR compliant.

==Site policy handler==

The Site policy handler in Site administration / Users / Privacy and policy / Policy settings determines how policies and user consents are managed. The default (core) handler enables a site policy URL and a site policy URL for guests to be specified. The policies handler enables site, privacy and other policies to be set. It also enables user consents to be viewed and, if necessary, consent on behalf of minors to be given.

===Default (core) handler===

When the site policy handler is set to 'Default (core)', a site policy may be set by entering the URL in 'Policy settings'. The URL can point to any type of file anywhere online that can be accessed without a log in to your Moodle site.

* The site policy will be displayed in a frame. You can view it via the URL ''<nowiki>yourmoodlesite.org/user/policy.php</nowiki>''.
* If [[Email-based self-registration]] is enabled on the site, a link to the site policy is displayed on the signup page.
* When a site policy URL is set, all users will be required to agree to it when they next log in before accessing the rest of the site.
* A site policy for guests may also be enabled. Guest users will need to agree to it before accessing a course with [[Guest access]] enabled.
* It is not recommended that a [[Page resource|page resource]] is used as a site policy, since the site header will be repeated in the iframe (see MDL-30486).
* It is recommended that the site policy is on the same domain as Moodle to avoid the problem of Internet Explorer users seeing a blank screen when the site policy is on a different domain.

===Policies (tool_policy) handler===

When the site policy handler is set to 'Policies (tool_policy)', two new pages appear in 'Privacy and policies' - 'Manage policies' and 'User agreements'. The remainder of this page describes the policies tool.

Note that when 'Policies (tool_policy)' is set as the site policy handler, the settings 'Site policy' and 'Site policy for guests' are ignored.

==Adding and managing policies==
[[File:policies and agreements.png|thumb|Policies and agreements]]
An admin or any user with the [[Capabilities/tool/policy:managedocs|Manage policies]] capability (by default manager) can access the page 'Manage policies' in the Site administration and:

* Add a new site / privacy / third parties / other policy for all users, authenticated users or guests
* Change the active / inactive status of each policy
* View the number and percentage of users who have agreed to each policy
* Edit a policy and specify whether it is a minor change (not requiring users to reconfirm their consent) or not
* View the current version of each policy and also previous versions
* Change the order in which policies are shown to users

To add a new policy:

# Go to 'Manage policies' in the Site administration.
# Click the button 'New policy'
# Complete the form and save changes.

Note that once created, a policy can be edited, or set to inactive, but if users have agreed to it, it can't be deleted.

The policy type (site / privacy / third parties) is only displayed at the 'Policies' page linked on the footer and the behaviour is the same for all the policy types.

==Giving consent to policies==
[[File:Agreeing to policies.png|thumb|Giving consent to policies]]
All users (with the exception of admins) will be required to give their consent to all policies defined either for “Authenticated users” or for “All users” before proceeding further on the site.

If a new policy is added, all users will be required to give their consent when they next log in. Similarly, if an existing policy is edited and is not marked as a minor change, all users will be required to give their consent when they next log in.

If [[Email-based self-registration]] is enabled on the site, new users will be required to give their consent to all policies before proceeding to the sign-up form. If digital age of consent verification is enabled in '[[Privacy|Privacy settings]]' in the Site administration, when a new user clicks the 'Create new account' button, they will be prompted to enter their age and country. If the user's age is lower than the age of consent for their country, they will see a message prompting them to ask their parent/guardian to contact the support contact (as specified in 'Support contact' in the Site administration).

==Policies for guests==
[[File:policies modal window.png|thumb|Policies for guests modal window]]
If a user logs in as a [[Guest access|guest]], a modal window will be shown at the bottom of the user's browser window with links to all policies defined either for guests or for all users.

==Minors==
[[File:No permission to agree to policies.png|thumb|Minor prevented from proceeding further on the site]]
Users who are younger than the age of digital consent, called 'minors', may be prevented from giving their consent by prohibiting the capability [[Capabilities/tool/policy:accept|Agree to policies]]. They will then be prevented from proceeding further on the site until someone can give consent on their behalf.

===Sites with minors as the majority of users===

To prohibit users from agreeing to policies because they are a minor:

# Go to 'Define roles' in the Site administration.
# Edit the role of authenticated user and set [[Capabilities/tool/policy:accept|Agree to policies]] to prohibit.
# Save changes.

To enable teachers and other users who are not minors to agree to policies:

# Go to 'Define roles' in the Site administration.
# Click the button 'Add a new role'.
# Give the role a name such as 'Able to give consent', short name and description.
# For context types where this role may be assigned, tick system.
# Enter policy in the filter box, then allow the capability Agree to policies.
# Click the button 'Create this role'.
# Go to 'Assign system roles' in the Site administration.
# Choose the 'Able to give consent' role to assign.
# Select teachers and other users in the Potential users list, and use the left-facing arrow button to add them to the Existing users list.

===Sites with only a few minors===

To prohibit users from agreeing to policies because they are a minor:

# Go to 'Define roles' in the Site administration.
# Click the button 'Add a new role'.
# Give the role a name such as 'Digital minor', short name and description.
# For context types where this role may be assigned, tick system.
# Enter policy in the filter box, then prohibit the capability Agree to policies.
# Click the button 'Create this role'.
# Go to 'Assign system roles' in the Site administration.
# Choose the 'Digital minor' role to assign.
# Select minors in the Potential users list, and use the left-facing arrow button to add them to the Existing users list.

==User agreements==
[[File:user agreements.png|thumb|User agreements filtered to show minors]]
An admin or any user with the [[Capabilities/tool/policy:viewacceptances|View user agreements reports]] capability (by default manager) can access the page 'User agreements' in the Site administration and:

* View user consents
* Filter by policy, permission, status or role
* Give consent on behalf of minors
* Download table data

User agreements for a particular policy may also be viewed via the 'Manage policies' page by clicking the link in the Agreements column.

==Giving consent on behalf of other users==

An admin or any user with the capability [[Capabilities/tool/policy:acceptbehalf|Agree to the policies on someone else's behalf]] can give consent on behalf of minors or when a written consent was obtained offline.

===Giving consent on behalf of multiple users===
[[File:Record of consents.png|thumb|Record of consents with remarks]]
Users with capability [[Capabilities/tool/policy:acceptbehalf|Agree to the policies on someone else's behalf]] in the system context, such as managers, can give consent on behalf of multiple users as follows:

# Go to 'User agreements' in the Site administration.
# If necessary, filter by 'Permission: Can not agree'.
# To give consent for multiple policies, tick the box next to selected users' names then click the consent button.
# To give consent for a single policy, click the red cross next to the user's name.

When giving consent on behalf of other users, there is an opportunity to add some remarks. Clicking on the link in the Overall column gives an overview with details of who gave consent and when, together with any remarks.

It's not yet possible to give consent in bulk, however a workaround would be to install and use a browser extension for checking all checkboxes on the page.

===Giving consent on behalf of a child===

A parent or guardian may be allowed to give consent on behalf of their child by giving them the capability [[Capabilities/tool/policy:acceptbehalf|Agree to the policies on someone else's behalf]] in the user context. See the [[Parent role]] for details of how to create the role and assign a parent to a student. The parent or guardian will then be able to give consent as follows:

# Go to the child's profile page.
# Click the link 'Policies and agreements'.
# Click the red cross next to the policy name.

==Capabilities==

* [[Capabilities/tool/policy:accept|Agree to policies]] - allowed for authenticated user role
* [[Capabilities/tool/policy:managedocs|Manage policies]] - allowed for default role of manager only
* [[Capabilities/tool/policy:viewacceptances|View user agreements reports]] - allowed for default role of manager only
* [[Capabilities/tool/policy:acceptbehalf|Agree to policies on someone else's behalf]] - allowed for default role of manager only

[[Category:Privacy]]

[[es:Plugin de políticas]]
[[de:Richtlinien]]
[[fr:Plugin Policies]]

Data privacy

2020-08-11T17:23:09Z

Ghillenb: /* Plugin privacy registry */

{{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.)

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==

{{New features}}In Moodle 3.9 onwards, 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]]