MoodleDocs - User contributions [en]

TinyMCE editor

2024-03-08T11:39:24Z

Raortegar: /* Tiny premium */

{{Editing text}}
==What is TinyMCE?==
TinyMCE is a powerful rich-text editor that allows users to create formatted content within a user-friendly interface.

The popular editor is the default editor in new installations of Moodle 4.2 onwards and can be made default in upgraded sites from ''Administration > Site administration > Plugins > Text editors > Manage editors''.

If enabled, users may select the '''TinyMCE editor''' from the ''User menu > Preferences > Editor preferences.''
{{MediaPlayer | url = https://youtu.be/Q-D6nWSusrY | desc = Overview of TinyMCE}}

== Tiny Toolbar ==
The following buttons are available on the toolbar (not all buttons might show in all scenarios:)
[[File:latestTiny.png|center]]

The available buttons are as follows:
{| class="wikitable"
|+
!#
!Button
!#
!Button
!#
!Button
|-
|1
|Undo and Redo
|10
|No auto-link NEW IN 4.3
|18
|Numbered list
|-
|2
|Bold and Italic
|11
|Full screen NEW IN 4.3
|19
|Equation editor
|-
|3
|Insert image/modify properties
|12
|Align left
|20
|Toggle second toolbar (if present)
|-
|4
|Insert audio/video/modify properties
|13
|Align centre
|21
|
|-
|5
|[[Audio|Record audio]]
|14
|Align right
|
|
|-
|6
|[[Video|Record video]]
|15
|L/R and R/L directionality
|
|
|-
|7
|Insert H5P / modify H5P properties
|16
|Decrease/increase indent
|
|
|-
|8
|Link
|17
|Bullets list
|
|
|-
|9
|Unlink
|
|
|
|
|}
Some button have pre-requisites to display, for instance, the equation editor button will only show if either the [[MathJax filter|MathJax]] or the [[TeX notation filter|TeX notation]] filters are enabled (in ''Site administration > Plugins > Filters > Manage filters''), while the H5P option will only show if the ''tiny/h5p:addembed'' capability has been granted.

== Tiny features ==
[[File:Tiny - Insert menu.png|thumb]]
The following features are available from the '''Insert''' menu:
=== Insert / Edit image ===
The easiest way to insert an image is via drag'n'drop. Alternatively, you can use the ''Insert image'' tool, which gives you more control over some image properties:
* '''URL''': The (internal or external) address of the image. You can either enter a URL manually or select an image from the repository browser, which adds the URL automatically.
*'''Description''': Unless the image is labelled decorative only, a description must be provided for screenreader users
*'''Size''': Initially, the image's width and height are set. These can be adjusted to fit your text. When the ''Auto size'' checkbox remains ticked, the image's width-height ratio stays intact.
* '''Alignment''': Options are ''Top'', ''Middle'', and ''Bottom''.
[[File:Tiny - Image.png|border|center|frameless|450x450px]]
To modify image properties once it has been added to your text, select the image and press the ''Image'' button on the mini toolbar that shows up.
=== Insert / Edit Link ===
When inserting or editing a link to another (internal or external) page, you can provide the following settings:
* '''URL''': The address of the page to navigate to. If left empty, the option ''<top>'' and ''<bottom>'' are available
* '''Text to display''': The text that is shown in the text, represented as a link
* '''Title''': The text shown when hovering over the link
* '''Browse repositories''': Upload a file to link to.
* '''Open link in...''': The page can either be opened in the '''Current Window''' or a '''New window'''
[[File:Tiny - Link.png|border|center|frameless|450x450px]]
=== Insert / Edit Multimedia ===
To insert existing audio or videos clips, the TinyMCE editor supports Moodle standard [[Media embedding|Media embedding interface]].
[[File:Tiny - Audio & Video.png|thumb]]
=== Record audio and video ===
TinyMCE lets users record [[audio]] and [[video]] clips which will attach to the text once recorded. Each recording comprises three steps:
# '''Start recording''': when ready, press the ''Start recording'' button
# '''Stop recording''': when completed, press the ''Stop recording'' button
# '''Review recording''': you can listen to or watch the recording via the provided controls. Either attach the clip to your text or record it again.

The maximum length and quality (bitrate) can be [[TinyMCE editor#Tiny Record RTC plugin for Moodle|configured]] at admin level.
=== Insert / Edit code sample ===
The Tiny editor lets you insert and embed syntax color highlighted code snippets into the editable area.
[[File:Tiny - Code Sample.png|border|center|frameless|600x600px]]
While you can select the (programming) language at the top, it doesn't have any impact on the way the code is displayed.

Tiny also supports formatting of code elements (''Format -> Code''), which changes the selected text to the internally defined <code>code style</code>.
=== Insert Table ===
Tiny comes with comprehensive table management functionality to handle grid-like structures in your text. In addition to the Insert table menu item, an entire main menu has been dedicated to tables.
[[File:Tiny - Table.png|border|center|frameless|450x450px]]
Once a table has been added, you can customise individual cells, row, columns, and the properties of the entire table. The following self-explanatory menu items are available, all supporting standard HTML table options:
* Cell
** Cell properties
** Merge cells
** Split cells
* Row
** Insert row before
** Insert row after
** Delete row
** Row properties
** Cut row
** Copy row
** Paste row before
** Paste row after
* Column
** Insert column before
** Insert column after
** Delete column
** Cut column
** Copy column
** Paste column before
** Paste column after
* Table properties
* Delete table
[[File:Tiny - Table operations.png|border|center|frameless|600x600px]]
The table editor also shows context-sensitive menus when editing different table elements.
=== Insert special character ===
The special character picker lets you insert letters and symbols (a map of special unicode characters) that are difficult or impossible to access via your keyboard. You can either search by keyword and / or browse categories.
[[File:Tiny - Special character.png|border|center|frameless|450x450px]]
=== Insert Emojis ===
Bring a smiley to your content: The emoji picker lets you insert pictograms. You can either search by keyword and / or browse categories.
[[File:Tiny - Emojis.png|border|center|frameless|450x450px]]
=== Insert HTML elements ===
The following 4 HTML elements are supported by TinyMCE via menus:
* '''Insert horizontal line''': Adds an HTML line to your text.

* '''Insert page break''': Adds a page break (<code><nowiki></nowiki></code>) to your text.

* '''Insert nonbreaking space''': Add an nonbreaking space (<code>&nbsp;</code>) at the current cursor location.

* '''Insert anchor''': Insert anchors (sometimes referred to as a bookmarks) to your text. Users will be prompted via a dialog box to enter a string. The string will be inserted into the HTML as an anchor id at the location of the cursor. For example, a user places their cursor at the beginning of "Moodle" and clicks on the anchor button and enters "start" in the dialog box. The resulting HTML will take the form of <code><nowiki><a id="start"></a></nowiki>Moodle<nowiki></nowiki></code>.
=== Insert date/time ===
The Insert date/time options lets you easily insert the current date and/or time into the editable area at the cursor insertion point.
[[File:Tiny - DateTime.png|border|center|frameless]]
The available format options depend on the selected language.
[[File:Tiny - Equation editor.png|thumb]]
=== Equation editor ===
If either the [[MathJax filter|MathJax]] or the [[TeX notation filter|TeX]] filters are enabled (in ''Site administration > Plugins > Filters > Manage filters'') then the ''Insert equation'' option is provided in the TinyMCE editor for launching the equation editor.

Internally, the equation editor uses the [https://docs.moodle.org/400/en/TeX_notation_filter TeX notation] which can either be entered manually and / or interactively. The interactive elements are grouped into 4 categories (Operators, Arrows, Greek symbols, and Advanced). The content of each tab can be configured via the [[Equation editor settings]].

At the bottom of the editor, a preview is shown.
=== Configure H5P content ===
You can embed [[H5P]] content via the ''Configure H5P content'' menu as follows:
# Browse the Content bank repository and select an H5P file
# Choose to either make a copy of the file or create a shortcut
# Optionally, configure the H5P options (Allow download, Embed button, Copyright button)
# Click the button 'Select this file'
# Click 'Insert H5P'These steps will automatically enter the internal address in the H5P URL field. Alternatively, you can enter any internal or external H5P URL manually.
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.
== Tiny tools ==
[[File:Tiny - Tools menu.png|thumb]]
The following tools are available in vie the '''Tools''' menu:
=== View source code ===
The source code pop up window displays the code of the page, usually HTML or JS. The code can be modified in plain text; once the window is closed, any changes will be reflected in the WYSIWYG mode.
[[File:Tiny - Source code.png|center|frameless|900x900px]]
=== Word count ===
The word pop up windows displays the number of words and the number of characters (with and without spaces) of the entire document and the selected text, respectively.
[[File:Tiny - Word count.png|border|center|frameless|600x600px|alt=]]

The number of words are also shown in the editor's footer.
=== Accessibility checker ===
The automated [[accessibility]] checker checks for some common errors in the text. These are usually elements in the way the text is constructed that can prevent all users from having equal access to information and functionality. The list of problems that the accessibility checker looks for is:
* Images with missing or empty alt text (unless they have the presentation role)
* Contrast of font colour and background colour meets [https://en.wikipedia.org/wiki/Web_Content_Accessibility_Guidelines WCAG AA guidelines]
* Long blocks of text are sufficiently broken up into headings
* All tables require captions
* Tables should not contain merged cells as they are difficult to navigate with screen readers
* All tables should contain row or column headers
=== Media Manager ===
The media manager shows all media files that have been embedded in the text.

The top part of the media manager shows the familiar file management element where you can add, download, and delete attached files.

Files that have been attached and deleted again are shown at the bottom half of the screen.
[[File:Tiny - Media manager.png|border|center|frameless|600x600px]]
== Keyboard shortcuts ==
The following keyboard shortcuts will work in the Tiny text editor in most browsers. Note that for many of these commands to work you need to either click in the text editor or select content in the text editor.
=== Editor shortcuts ===
{| class="wikitable"
!Windows Command
!Mac Command
!Function
|-
|Ctrl + Shift + f
|⌘ + Shift + f
|Full screen toggle
|-
|Ctrl + c
|⌘ + c
|Copy
|-
|Ctrl + v
|⌘ + v
|Paste
|-
|Ctrl + Shift + v
|⌘ + Shift + v
|Paste without formatting (very useful)
|-
|Ctrl + x
|⌘ + x
|Cut
|-
|Ctrl + z
|⌘ + z
|Undo
|-
|Ctrl + y
|⌘ + y
|Redo
|-
|Ctrl + a
|⌘ + a
|Select all
|-
|Ctrl + f
|⌘ + f
|Find and replace
|-
|F3
|<s>F3</s>
|Find next
|-
|Shift + F3
|<s>Shift + F3</s>
|Find previous
|-
|Ctrl + b
|⌘ + b
|Bold
|-
|Ctrl + i
|⌘ + i
|Italics
|-
|Ctrl + u
|⌘ + u
|Underline
|-
|Ctrl + k
|⌘ + k
|Insert/edit link
|-
|Ctrl + Right arrow
|Option + Right arrow
|Move to the end of the next word
|-
|Ctrl + Left arrow
|Option + Left arrow
|Move to the end of the previous word
|-
|Ctrl + Shift + Right arrow
|Shift + Option + Right arrow
|Select the next word or letter
|-
|Ctrl + Shift + Left arrow
|Shift + Option + Left arrow
|Select the previous word or letter
|-
|Ctrl + Shift + Home
|<s>⌘ + Shift + Home</s>
|Select from the cursor to the beginning of the page
|-
|Ctrl + Shift + End
|<s>⌘ + Shift + End</s>
|Select from the cursor to the end of the page
|-
|Ctrl + Home
|⌘ + Up arrow
|Move to the beginning of the page
|-
|Ctrl + End
|⌘ + Down arrow
|Move to the end of the page
|-
|Ctrl + Backspace
|<s>⌘ + Backspace</s>
|Delete word or letter to the left
|-
|Ctrl + Delete
|<s>⌘ + Delete</s>
|Delete word or letter to the right
|-
|Ctrl + P
|⌘ + P
|Print
|-
|Alt+Shift+1
|Ctrl+Option+1
|Header 1
|-
|Alt+Shift+2
|Ctrl+Option+2
|Header 2
|-
|Alt+Shift+3
|Ctrl+Option+3
|Header 3
|-
|Alt+Shift+4
|Ctrl+Option+4
|Header 4
|-
|Alt+Shift+5
|Ctrl+Option+5
|Header 5
|-
|Alt+Shift+6
|Ctrl+Option+6
|Header 6
|-
|Alt+Shift+7
|Ctrl+Option+7
|Paragraph
|-
|Alt+Shift+8
|Ctrl+Option+8
|Div
|-
|Alt+Shift+9
|Ctrl+Option+9
|Address
|-
|Alt+0
|Option+0
|Help dialogue (list of shortcuts)
|-
|Ctrl and +
|⌘ and +
|Zoom in (not specific to the editor, but very useful)
|-
|Ctrl and -
|⌘ and -
|Zoom out (not specific to the editor, but very useful)
|-
|Ctrl and 0
|⌘ and 0
|Reset zoom (not specific to the editor, but very useful)
|-
|Double-click
|Double-click
|Select word
|-
|Triple-click
|Triple-click
|Select line
|}
=== Keyboard navigation ===
The sections of the outer UI of the editor - the menubar, toolbar, sidebar and footer - are all keyboard navigable.
==== Activating keyboard navigation ====
There are multiple ways to activate keyboard navigation:
* Focus the menubar: Alt + F9 (Windows) or ⌥F9 (MacOS)
* Focus the toolbar: Alt + F10 (Windows) or ⌥F10 (MacOS)
* Focus the footer: Alt + F11 (Windows) or ⌥F11 (MacOS)
Focusing the menubar or toolbar will start keyboard navigation at the first item in the menubar or toolbar, which will be highlighted with a gray background. Focusing the footer will start keyboard navigation at the first item in the element path, which will be highlighted with an underline.
==== Moving between UI sections ====
When keyboard navigation is active, pressing tab will move the focus to the next major section of the UI, where applicable. These sections are:
* the menubar
* each group of the toolbar
* the sidebar
* the element path in the footer
* the wordcount toggle button in the footer
* the branding link in the footer
* the editor resize handle in the footer
Pressing shift + tab will move backwards through the same sections, except when moving from the footer to the toolbar. Focusing the element path then pressing shift + tab will move focus to the first toolbar group, not the last.
==== Moving within UI sections ====
Keyboard navigation within UI sections can usually be achieved using the left and right arrow keys. This includes:
* moving between menus in the menubar
* moving between buttons in a toolbar group
* moving between items in the element path
In all these UI sections, keyboard navigation will cycle within the section. For example, focusing the last button in a toolbar group then pressing right arrow will move focus to the first item in the same toolbar group.
==== Executing buttons ====
To execute a button, navigate the selection to the desired button and hit space or enter.
==== Opening, navigating and closing menus ====
When focusing a menubar button or a toolbar button with a menu, pressing space, enter or down arrow will open the menu. When the menu opens the first item will be selected. To move up or down the menu, press the up or down arrow key respectively. This is the same for submenus, which can also be opened and closed using the left and right arrow keys.

To close any active menu, hit the escape key. When a menu is closed the selection will be restored to its previous selection. This also works for closing submenus.
==== Context toolbars and menus ====
To focus an open context toolbar such as the table context toolbar, press Ctrl + F9 (Windows) or ⌃F9 (MacOS).

Context toolbar navigation is the same as toolbar navigation, and context menu navigation is the same as standard menu navigation.
==== Dialog navigation ====
There are two types of dialog UIs in TinyMCE: tabbed dialogs and non-tabbed dialogs.

When a non-tabbed dialog is opened, the first interactive component in the dialog will be focused. Users can navigate between interactive components by pressing tab. This includes any footer buttons. Navigation will cycle back to the first dialog component if tab is pressed while focusing the last component in the dialog. Pressing shift + tab will navigate backwards.

When a tabbed dialog is opened, the first button in the tab menu is focused. Pressing tab will navigate to the first interactive component in that tab, and will cycle through the tab's components, the footer buttons, then back to the tab button. To switch to another tab, focus the tab button for the current tab, then use the arrow keys to cycle through the tab buttons.
==== Accessibility shortcuts ====
This is a list of available keyboard shortcuts within the editor user interface.
{| class="wikitable"
!Windows Command
!Mac Command
!Function
|-
|Enter / Spacebar
|Enter / Spacebar
|Execute command
|-
|Tab
|Tab
|Focus on next UI Element(such as: Menu bar, Toolbar, Toolbar Group, Status Bar Item)
|-
|Shift+Tab
|Shift+Tab
|Focus on previous UI Element(such as: Menu bar, Toolbar, Toolbar Group, Status Bar Item)
|-
|Right Arrow / Down Arrow
|Right Arrow / Down Arrow
|Focus next Control(such as: toolbar button, menu, or menu item)
|-
|Left Arrow / Up Arrow
|Left Arrow / Up Arrow
|Focus previous Control(such as: toolbar button, menu, or menu item)
|-
|Down Arrow / Spacebar
|Down Arrow / Spacebar
|Open menu or toolbar menu button
|-
|Spacebar
|Spacebar
|Open group toolbar button
|-
|Down Arrow
|Down Arrow
|Open split toolbar button
|-
|Shift+Enter
|Shift+Enter
|Open the popup menu on split toolbar buttons
|-
|Right Arrow
|Right Arrow
|Open submenu
|-
|Left Arrow / Esc
|Left Arrow / Esc
|Close submenu
|-
|Esc
|Esc
|Close dialog
|-
|Esc
|Esc
|Close menu
|-
|Esc
|Esc
|Move focus back to editor body
|}
'''Note''': Browsers and Screen Readers provide additional shortcuts within the editor context.
==Site administration settings==
=== General settings ===
From ''Site administration > Plugins > Text editors > TinyMCE editor'' you can disable and enable certain settings, for example '''New in 4.3''' the Tiny HTML formatter, Tiny no-auto link and access the setting for the paid service Tiny premium.

You can also disable the TinyMCE branding logo which appears at the bottom of the editor.
{{New features}}
====Tiny premium====
TinyMCE Premium requires a paid subscription. Your API key is available on your [https://www.tiny.cloud/ Tiny Cloud] account page if you have purchased a subscription, or if you are on a free trial. Enter the API key from Site administration > Plugins > Text editors > Tiny premium

With TinyMCE Premium, you'll experience significant improvements in your content creation workflows, leading to increased productivity, engagement, and output.

Please note that not all plugins listed on the website are currently available to Moodle Users.

TinyMCE features you can choose from with a Premium subscription are:

* Advanced Tables
* Advanced Typography
* Case Change
* Checklist
* Enhanced Image Editing
* Export
* Footnotes
* Format Painter
* Link Checker
* Page Embed
* Permanent Pen
* PowerPaste
* Spell Checker Pro
* Spelling Autocorrect
* Table of Contents

=== Equation editor settings ===
[[File:Tiny - Equation editor settings.png|thumb]]
The equation editor has 4 tabs: Operators, Arrows, Greek symbols, and Advanced. The commands that are available on each tab and their order can be configured in ''Site administration > Plugins > Text editors > TinyMCE editor > Equation editor settings''.

For each group, the list of commands is shown in TeX format.
=== Tiny Record RTC plugin for Moodle ===
[[File:Tiny - RTC settings.png|thumb]]
Tiny fully supports media recording through. Internally, RecordRTC is utilised, an open source JavaScript library using WebRTC for audio and video recording. To configure its settings, navigate to ''Site administration > Plugins > Text editors > TinyMCE editor > RecordRTC'':

The following options have an impact on server resources, both in terms of bandwidth and disk usage:
* '''Allowed types''': You can specify whether '''Audio and video''' recording are supported or '''Audio only''' or '''Video only'''. There are two capabilities to control access to the TinyMCE buttons: '''[[Capabilities/tiny/recordrtc:recordvideo]]''' and '''[[Capabilities/tiny/recordrtc:recordaudio]]'''
* '''Audio bitrate''' and '''Video bitrate''': The lower the bitrates, the smaller the file sizes, and vice versa. The default bitrate for recorded audio (128000) should generate files of about 15 KB per minute; the default bitrate for recorded video (2500000) to files of approximately 20 MB per minute.
* '''Audio time limit in seconds''' and '''Video time limit in seconds''': The default time limit is 2 minutes for audio and video recording. Again, the longer the maximum recording length, the bigger the resulting files.

Recordings are stored in subdirectories of ''$CFG->dataroot>/filedir''. Ensure ''post_max_size'' and ''upload_max_filesize'' are configured in line with your expected maximum recording sizes.

[[es:Editor TinyMCE]]
[[de:TinyMCE-Editor]]
[[fr:Éditeur TinyMCE]]

TinyMCE editor

2024-03-08T10:43:47Z

Raortegar: /* Tiny premium */

{{Editing text}}
==What is TinyMCE?==
TinyMCE is a powerful rich-text editor that allows users to create formatted content within a user-friendly interface.

The popular editor is the default editor in new installations of Moodle 4.2 onwards and can be made default in upgraded sites from ''Administration > Site administration > Plugins > Text editors > Manage editors''.

If enabled, users may select the '''TinyMCE editor''' from the ''User menu > Preferences > Editor preferences.''
{{MediaPlayer | url = https://youtu.be/Q-D6nWSusrY | desc = Overview of TinyMCE}}

== Tiny Toolbar ==
The following buttons are available on the toolbar (not all buttons might show in all scenarios:)
[[File:latestTiny.png|center]]

The available buttons are as follows:
{| class="wikitable"
|+
!#
!Button
!#
!Button
!#
!Button
|-
|1
|Undo and Redo
|10
|No auto-link NEW IN 4.3
|18
|Numbered list
|-
|2
|Bold and Italic
|11
|Full screen NEW IN 4.3
|19
|Equation editor
|-
|3
|Insert image/modify properties
|12
|Align left
|20
|Toggle second toolbar (if present)
|-
|4
|Insert audio/video/modify properties
|13
|Align centre
|21
|
|-
|5
|[[Audio|Record audio]]
|14
|Align right
|
|
|-
|6
|[[Video|Record video]]
|15
|L/R and R/L directionality
|
|
|-
|7
|Insert H5P / modify H5P properties
|16
|Decrease/increase indent
|
|
|-
|8
|Link
|17
|Bullets list
|
|
|-
|9
|Unlink
|
|
|
|
|}
Some button have pre-requisites to display, for instance, the equation editor button will only show if either the [[MathJax filter|MathJax]] or the [[TeX notation filter|TeX notation]] filters are enabled (in ''Site administration > Plugins > Filters > Manage filters''), while the H5P option will only show if the ''tiny/h5p:addembed'' capability has been granted.

== Tiny features ==
[[File:Tiny - Insert menu.png|thumb]]
The following features are available from the '''Insert''' menu:
=== Insert / Edit image ===
The easiest way to insert an image is via drag'n'drop. Alternatively, you can use the ''Insert image'' tool, which gives you more control over some image properties:
* '''URL''': The (internal or external) address of the image. You can either enter a URL manually or select an image from the repository browser, which adds the URL automatically.
*'''Description''': Unless the image is labelled decorative only, a description must be provided for screenreader users
*'''Size''': Initially, the image's width and height are set. These can be adjusted to fit your text. When the ''Auto size'' checkbox remains ticked, the image's width-height ratio stays intact.
* '''Alignment''': Options are ''Top'', ''Middle'', and ''Bottom''.
[[File:Tiny - Image.png|border|center|frameless|450x450px]]
To modify image properties once it has been added to your text, select the image and press the ''Image'' button on the mini toolbar that shows up.
=== Insert / Edit Link ===
When inserting or editing a link to another (internal or external) page, you can provide the following settings:
* '''URL''': The address of the page to navigate to. If left empty, the option ''<top>'' and ''<bottom>'' are available
* '''Text to display''': The text that is shown in the text, represented as a link
* '''Title''': The text shown when hovering over the link
* '''Browse repositories''': Upload a file to link to.
* '''Open link in...''': The page can either be opened in the '''Current Window''' or a '''New window'''
[[File:Tiny - Link.png|border|center|frameless|450x450px]]
=== Insert / Edit Multimedia ===
To insert existing audio or videos clips, the TinyMCE editor supports Moodle standard [[Media embedding|Media embedding interface]].
[[File:Tiny - Audio & Video.png|thumb]]
=== Record audio and video ===
TinyMCE lets users record [[audio]] and [[video]] clips which will attach to the text once recorded. Each recording comprises three steps:
# '''Start recording''': when ready, press the ''Start recording'' button
# '''Stop recording''': when completed, press the ''Stop recording'' button
# '''Review recording''': you can listen to or watch the recording via the provided controls. Either attach the clip to your text or record it again.

The maximum length and quality (bitrate) can be [[TinyMCE editor#Tiny Record RTC plugin for Moodle|configured]] at admin level.
=== Insert / Edit code sample ===
The Tiny editor lets you insert and embed syntax color highlighted code snippets into the editable area.
[[File:Tiny - Code Sample.png|border|center|frameless|600x600px]]
While you can select the (programming) language at the top, it doesn't have any impact on the way the code is displayed.

Tiny also supports formatting of code elements (''Format -> Code''), which changes the selected text to the internally defined <code>code style</code>.
=== Insert Table ===
Tiny comes with comprehensive table management functionality to handle grid-like structures in your text. In addition to the Insert table menu item, an entire main menu has been dedicated to tables.
[[File:Tiny - Table.png|border|center|frameless|450x450px]]
Once a table has been added, you can customise individual cells, row, columns, and the properties of the entire table. The following self-explanatory menu items are available, all supporting standard HTML table options:
* Cell
** Cell properties
** Merge cells
** Split cells
* Row
** Insert row before
** Insert row after
** Delete row
** Row properties
** Cut row
** Copy row
** Paste row before
** Paste row after
* Column
** Insert column before
** Insert column after
** Delete column
** Cut column
** Copy column
** Paste column before
** Paste column after
* Table properties
* Delete table
[[File:Tiny - Table operations.png|border|center|frameless|600x600px]]
The table editor also shows context-sensitive menus when editing different table elements.
=== Insert special character ===
The special character picker lets you insert letters and symbols (a map of special unicode characters) that are difficult or impossible to access via your keyboard. You can either search by keyword and / or browse categories.
[[File:Tiny - Special character.png|border|center|frameless|450x450px]]
=== Insert Emojis ===
Bring a smiley to your content: The emoji picker lets you insert pictograms. You can either search by keyword and / or browse categories.
[[File:Tiny - Emojis.png|border|center|frameless|450x450px]]
=== Insert HTML elements ===
The following 4 HTML elements are supported by TinyMCE via menus:
* '''Insert horizontal line''': Adds an HTML line to your text.

* '''Insert page break''': Adds a page break (<code><nowiki></nowiki></code>) to your text.

* '''Insert nonbreaking space''': Add an nonbreaking space (<code>&nbsp;</code>) at the current cursor location.

* '''Insert anchor''': Insert anchors (sometimes referred to as a bookmarks) to your text. Users will be prompted via a dialog box to enter a string. The string will be inserted into the HTML as an anchor id at the location of the cursor. For example, a user places their cursor at the beginning of "Moodle" and clicks on the anchor button and enters "start" in the dialog box. The resulting HTML will take the form of <code><nowiki><a id="start"></a></nowiki>Moodle<nowiki></nowiki></code>.
=== Insert date/time ===
The Insert date/time options lets you easily insert the current date and/or time into the editable area at the cursor insertion point.
[[File:Tiny - DateTime.png|border|center|frameless]]
The available format options depend on the selected language.
[[File:Tiny - Equation editor.png|thumb]]
=== Equation editor ===
If either the [[MathJax filter|MathJax]] or the [[TeX notation filter|TeX]] filters are enabled (in ''Site administration > Plugins > Filters > Manage filters'') then the ''Insert equation'' option is provided in the TinyMCE editor for launching the equation editor.

Internally, the equation editor uses the [https://docs.moodle.org/400/en/TeX_notation_filter TeX notation] which can either be entered manually and / or interactively. The interactive elements are grouped into 4 categories (Operators, Arrows, Greek symbols, and Advanced). The content of each tab can be configured via the [[Equation editor settings]].

At the bottom of the editor, a preview is shown.
=== Configure H5P content ===
You can embed [[H5P]] content via the ''Configure H5P content'' menu as follows:
# Browse the Content bank repository and select an H5P file
# Choose to either make a copy of the file or create a shortcut
# Optionally, configure the H5P options (Allow download, Embed button, Copyright button)
# Click the button 'Select this file'
# Click 'Insert H5P'These steps will automatically enter the internal address in the H5P URL field. Alternatively, you can enter any internal or external H5P URL manually.
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.
== Tiny tools ==
[[File:Tiny - Tools menu.png|thumb]]
The following tools are available in vie the '''Tools''' menu:
=== View source code ===
The source code pop up window displays the code of the page, usually HTML or JS. The code can be modified in plain text; once the window is closed, any changes will be reflected in the WYSIWYG mode.
[[File:Tiny - Source code.png|center|frameless|900x900px]]
=== Word count ===
The word pop up windows displays the number of words and the number of characters (with and without spaces) of the entire document and the selected text, respectively.
[[File:Tiny - Word count.png|border|center|frameless|600x600px|alt=]]

The number of words are also shown in the editor's footer.
=== Accessibility checker ===
The automated [[accessibility]] checker checks for some common errors in the text. These are usually elements in the way the text is constructed that can prevent all users from having equal access to information and functionality. The list of problems that the accessibility checker looks for is:
* Images with missing or empty alt text (unless they have the presentation role)
* Contrast of font colour and background colour meets [https://en.wikipedia.org/wiki/Web_Content_Accessibility_Guidelines WCAG AA guidelines]
* Long blocks of text are sufficiently broken up into headings
* All tables require captions
* Tables should not contain merged cells as they are difficult to navigate with screen readers
* All tables should contain row or column headers
=== Media Manager ===
The media manager shows all media files that have been embedded in the text.

The top part of the media manager shows the familiar file management element where you can add, download, and delete attached files.

Files that have been attached and deleted again are shown at the bottom half of the screen.
[[File:Tiny - Media manager.png|border|center|frameless|600x600px]]
== Keyboard shortcuts ==
The following keyboard shortcuts will work in the Tiny text editor in most browsers. Note that for many of these commands to work you need to either click in the text editor or select content in the text editor.
=== Editor shortcuts ===
{| class="wikitable"
!Windows Command
!Mac Command
!Function
|-
|Ctrl + Shift + f
|⌘ + Shift + f
|Full screen toggle
|-
|Ctrl + c
|⌘ + c
|Copy
|-
|Ctrl + v
|⌘ + v
|Paste
|-
|Ctrl + Shift + v
|⌘ + Shift + v
|Paste without formatting (very useful)
|-
|Ctrl + x
|⌘ + x
|Cut
|-
|Ctrl + z
|⌘ + z
|Undo
|-
|Ctrl + y
|⌘ + y
|Redo
|-
|Ctrl + a
|⌘ + a
|Select all
|-
|Ctrl + f
|⌘ + f
|Find and replace
|-
|F3
|<s>F3</s>
|Find next
|-
|Shift + F3
|<s>Shift + F3</s>
|Find previous
|-
|Ctrl + b
|⌘ + b
|Bold
|-
|Ctrl + i
|⌘ + i
|Italics
|-
|Ctrl + u
|⌘ + u
|Underline
|-
|Ctrl + k
|⌘ + k
|Insert/edit link
|-
|Ctrl + Right arrow
|Option + Right arrow
|Move to the end of the next word
|-
|Ctrl + Left arrow
|Option + Left arrow
|Move to the end of the previous word
|-
|Ctrl + Shift + Right arrow
|Shift + Option + Right arrow
|Select the next word or letter
|-
|Ctrl + Shift + Left arrow
|Shift + Option + Left arrow
|Select the previous word or letter
|-
|Ctrl + Shift + Home
|<s>⌘ + Shift + Home</s>
|Select from the cursor to the beginning of the page
|-
|Ctrl + Shift + End
|<s>⌘ + Shift + End</s>
|Select from the cursor to the end of the page
|-
|Ctrl + Home
|⌘ + Up arrow
|Move to the beginning of the page
|-
|Ctrl + End
|⌘ + Down arrow
|Move to the end of the page
|-
|Ctrl + Backspace
|<s>⌘ + Backspace</s>
|Delete word or letter to the left
|-
|Ctrl + Delete
|<s>⌘ + Delete</s>
|Delete word or letter to the right
|-
|Ctrl + P
|⌘ + P
|Print
|-
|Alt+Shift+1
|Ctrl+Option+1
|Header 1
|-
|Alt+Shift+2
|Ctrl+Option+2
|Header 2
|-
|Alt+Shift+3
|Ctrl+Option+3
|Header 3
|-
|Alt+Shift+4
|Ctrl+Option+4
|Header 4
|-
|Alt+Shift+5
|Ctrl+Option+5
|Header 5
|-
|Alt+Shift+6
|Ctrl+Option+6
|Header 6
|-
|Alt+Shift+7
|Ctrl+Option+7
|Paragraph
|-
|Alt+Shift+8
|Ctrl+Option+8
|Div
|-
|Alt+Shift+9
|Ctrl+Option+9
|Address
|-
|Alt+0
|Option+0
|Help dialogue (list of shortcuts)
|-
|Ctrl and +
|⌘ and +
|Zoom in (not specific to the editor, but very useful)
|-
|Ctrl and -
|⌘ and -
|Zoom out (not specific to the editor, but very useful)
|-
|Ctrl and 0
|⌘ and 0
|Reset zoom (not specific to the editor, but very useful)
|-
|Double-click
|Double-click
|Select word
|-
|Triple-click
|Triple-click
|Select line
|}
=== Keyboard navigation ===
The sections of the outer UI of the editor - the menubar, toolbar, sidebar and footer - are all keyboard navigable.
==== Activating keyboard navigation ====
There are multiple ways to activate keyboard navigation:
* Focus the menubar: Alt + F9 (Windows) or ⌥F9 (MacOS)
* Focus the toolbar: Alt + F10 (Windows) or ⌥F10 (MacOS)
* Focus the footer: Alt + F11 (Windows) or ⌥F11 (MacOS)
Focusing the menubar or toolbar will start keyboard navigation at the first item in the menubar or toolbar, which will be highlighted with a gray background. Focusing the footer will start keyboard navigation at the first item in the element path, which will be highlighted with an underline.
==== Moving between UI sections ====
When keyboard navigation is active, pressing tab will move the focus to the next major section of the UI, where applicable. These sections are:
* the menubar
* each group of the toolbar
* the sidebar
* the element path in the footer
* the wordcount toggle button in the footer
* the branding link in the footer
* the editor resize handle in the footer
Pressing shift + tab will move backwards through the same sections, except when moving from the footer to the toolbar. Focusing the element path then pressing shift + tab will move focus to the first toolbar group, not the last.
==== Moving within UI sections ====
Keyboard navigation within UI sections can usually be achieved using the left and right arrow keys. This includes:
* moving between menus in the menubar
* moving between buttons in a toolbar group
* moving between items in the element path
In all these UI sections, keyboard navigation will cycle within the section. For example, focusing the last button in a toolbar group then pressing right arrow will move focus to the first item in the same toolbar group.
==== Executing buttons ====
To execute a button, navigate the selection to the desired button and hit space or enter.
==== Opening, navigating and closing menus ====
When focusing a menubar button or a toolbar button with a menu, pressing space, enter or down arrow will open the menu. When the menu opens the first item will be selected. To move up or down the menu, press the up or down arrow key respectively. This is the same for submenus, which can also be opened and closed using the left and right arrow keys.

To close any active menu, hit the escape key. When a menu is closed the selection will be restored to its previous selection. This also works for closing submenus.
==== Context toolbars and menus ====
To focus an open context toolbar such as the table context toolbar, press Ctrl + F9 (Windows) or ⌃F9 (MacOS).

Context toolbar navigation is the same as toolbar navigation, and context menu navigation is the same as standard menu navigation.
==== Dialog navigation ====
There are two types of dialog UIs in TinyMCE: tabbed dialogs and non-tabbed dialogs.

When a non-tabbed dialog is opened, the first interactive component in the dialog will be focused. Users can navigate between interactive components by pressing tab. This includes any footer buttons. Navigation will cycle back to the first dialog component if tab is pressed while focusing the last component in the dialog. Pressing shift + tab will navigate backwards.

When a tabbed dialog is opened, the first button in the tab menu is focused. Pressing tab will navigate to the first interactive component in that tab, and will cycle through the tab's components, the footer buttons, then back to the tab button. To switch to another tab, focus the tab button for the current tab, then use the arrow keys to cycle through the tab buttons.
==== Accessibility shortcuts ====
This is a list of available keyboard shortcuts within the editor user interface.
{| class="wikitable"
!Windows Command
!Mac Command
!Function
|-
|Enter / Spacebar
|Enter / Spacebar
|Execute command
|-
|Tab
|Tab
|Focus on next UI Element(such as: Menu bar, Toolbar, Toolbar Group, Status Bar Item)
|-
|Shift+Tab
|Shift+Tab
|Focus on previous UI Element(such as: Menu bar, Toolbar, Toolbar Group, Status Bar Item)
|-
|Right Arrow / Down Arrow
|Right Arrow / Down Arrow
|Focus next Control(such as: toolbar button, menu, or menu item)
|-
|Left Arrow / Up Arrow
|Left Arrow / Up Arrow
|Focus previous Control(such as: toolbar button, menu, or menu item)
|-
|Down Arrow / Spacebar
|Down Arrow / Spacebar
|Open menu or toolbar menu button
|-
|Spacebar
|Spacebar
|Open group toolbar button
|-
|Down Arrow
|Down Arrow
|Open split toolbar button
|-
|Shift+Enter
|Shift+Enter
|Open the popup menu on split toolbar buttons
|-
|Right Arrow
|Right Arrow
|Open submenu
|-
|Left Arrow / Esc
|Left Arrow / Esc
|Close submenu
|-
|Esc
|Esc
|Close dialog
|-
|Esc
|Esc
|Close menu
|-
|Esc
|Esc
|Move focus back to editor body
|}
'''Note''': Browsers and Screen Readers provide additional shortcuts within the editor context.
==Site administration settings==
=== General settings ===
From ''Site administration > Plugins > Text editors > TinyMCE editor'' you can disable and enable certain settings, for example '''New in 4.3''' the Tiny HTML formatter, Tiny no-auto link and access the setting for the paid service Tiny premium.

You can also disable the TinyMCE branding logo which appears at the bottom of the editor.
{{New features}}
====Tiny premium====
If you have purchased Tiny Premium or have a free trial from [https://www.tiny.cloud/ Tiny Cloud] enter the API key from Site administration > Plugins > Text editors > Tiny premium.

Note that premium features charging is done on "per request" basis (number of editor loads.)

TinyMCE features you can choose from with a Premium subscription are:

* Advanced Tables
* Advanced Typography
* Case Change
* Checklist
* Enhanced Image Editing
* Export
* Footnotes
* Format Painter
* Link Checker
* Page Embed
* Permanent Pen
* PowerPaste
* Spell Checker Pro
* Spelling Autocorrect
* Table of Contents

=== Equation editor settings ===
[[File:Tiny - Equation editor settings.png|thumb]]
The equation editor has 4 tabs: Operators, Arrows, Greek symbols, and Advanced. The commands that are available on each tab and their order can be configured in ''Site administration > Plugins > Text editors > TinyMCE editor > Equation editor settings''.

For each group, the list of commands is shown in TeX format.
=== Tiny Record RTC plugin for Moodle ===
[[File:Tiny - RTC settings.png|thumb]]
Tiny fully supports media recording through. Internally, RecordRTC is utilised, an open source JavaScript library using WebRTC for audio and video recording. To configure its settings, navigate to ''Site administration > Plugins > Text editors > TinyMCE editor > RecordRTC'':

The following options have an impact on server resources, both in terms of bandwidth and disk usage:
* '''Allowed types''': You can specify whether '''Audio and video''' recording are supported or '''Audio only''' or '''Video only'''. There are two capabilities to control access to the TinyMCE buttons: '''[[Capabilities/tiny/recordrtc:recordvideo]]''' and '''[[Capabilities/tiny/recordrtc:recordaudio]]'''
* '''Audio bitrate''' and '''Video bitrate''': The lower the bitrates, the smaller the file sizes, and vice versa. The default bitrate for recorded audio (128000) should generate files of about 15 KB per minute; the default bitrate for recorded video (2500000) to files of approximately 20 MB per minute.
* '''Audio time limit in seconds''' and '''Video time limit in seconds''': The default time limit is 2 minutes for audio and video recording. Again, the longer the maximum recording length, the bigger the resulting files.

Recordings are stored in subdirectories of ''$CFG->dataroot>/filedir''. Ensure ''post_max_size'' and ''upload_max_filesize'' are configured in line with your expected maximum recording sizes.

[[es:Editor TinyMCE]]
[[de:TinyMCE-Editor]]
[[fr:Éditeur TinyMCE]]

Multi-factor authentication

2023-12-20T11:26:24Z

Raortegar: Include an example on SMS factor

{{Authentication}}
==What is multi-factor authentication (MFA)?==
[https://en.wikipedia.org/wiki/Multi-factor_authentication Multi-factor authentication (MFA)] is a security measure that requires users to verify their identity using two or more factors of authentication. Factors can be something users know, like a password, something they have, like a phone or security token, or something they are, like a fingerprint.

MFA helps improve security of your Moodle site because it is more difficult for attackers to compromise multiple factors.
==Manage multi-factor authentication==
From Site administration > Plugins > Admin tools > Manage multi-factor authentication, you can turn MFA on by checking the box MFA plugin enabled.

If you’re configuring MFA for your site for the first time, we recommend that you check out the [[Multi-factor authentication#Recommendations and example setups|Recommendations and example setups]] to streamline the experience for your users.
=== Weights and factors ===
In Site administration > Plugins > Admin tools > Manage multi-factor authentication, you can see a list of the available factors and select the ones that make up MFA for your site.

These factors have weight points, and users have to reach 100 points in order to be able to log in. By configuring multiple factors and adjusting their weights, you can create complex and flexible rules for multi-factor authentication.

For example, you could have two factors with 100 points each, if you want to give users different methods of authentication. Or you could have two factors with 50 points each, meaning that users will have to go through both factors to be able to log in.

During the login process, factors that don't require user input, like IP address or user role, are assessed first. Then, the remaining factors are evaluated in order of weight, starting from the highest, until either the cumulative points reach the login threshold (100) or all factors have been checked and login is denied.
==== Available authentication factors ====
===== Standard authentication factors =====
These are well known, usual authentication factors used in many products and software:

'''Email''': This factor requires users to enter a code received via email during the login process. When a user attempts to log in, the system generates a unique, temporary code and sends it to the user’s registered email address. The user must then enter this code along with their password to successfully complete the login process. This code has a limited validity period, which you can customise, ensuring that it cannot be used for unauthorised access.

'''Authenticator app''': This factor uses a mobile application to generate a temporary code for user authentication. During the login process, Moodle prompts the user to enter a code generated by their authenticator app, in addition to their password. This code changes periodically, ensuring that it can’t be reused for unauthorised access. '''Users must have an app installed on their mobile device and configure this factor themselves.'''

'''Security key''': This factor utilises physical hardware tokens, like USB or NFC security keys, or physical biometrics such as fingerprints. During the login process, users must physically use their security on their device to verify their identity. '''Users must configure this factor themselves'''.

'''IP range''': This factor utilises users’ IP address to verify their identity, providing enhanced security when accessing from a trusted network. It requires no upfront setup from your users, allowing you to configure full login access on a trusted network. '''This factor requires no setup by your users.'''

'''SMS Mobile phone''': This factor requires a mobile phone capable of receiving SMS (text) messages. During the login process, Moodle generates a unique, one-time code and sends it to the user's registered mobile phone number via SMS. The user enters this code along with their password to successfully complete the login process. '''Users must configure this factor themselves'''.
=====User-filtering factors=====
User-filtering factors are a way to easily create groups of users who will or will not be required to use multi-factor authentication (MFA).

'''Non administrator''': This factor requires only administrators to have two or more authentication factors, while not affecting other users. It does so by giving factor points to all users who are not an administrator.
'''Authentication type:''' This factor allows certain users to skip additional authentication steps based on their authentication type. This can be useful for situations where certain authentication types, such as [https://en.wikipedia.org/wiki/Security_Assertion_Markup_Language SAML] via [https://en.wikipedia.org/wiki/Active_Directory_Federation_Services ADFS] , already provide a high level of security, making additional authentication checks unnecessary.

'''Role''': This factor has to be used in combination with other factors, as it allows you to specify which roles must use other factors to authenticate. For example, it enables you to require that individuals with elevated access privileges, such as managers and administrators, undergo a more stringent authentication process, while other non-specified roles such students can bypass MFA.

'''Cohort''': This factor has to be used in combination with other factors, as it allows you to specify which cohorts must use other factors to authenticate.

'''User capability''': This factor is similar to the Role factor, and must also be combined with other factors, as it allows you to specify which users must use other factors to authenticate. It does so by checking whether users have the capability ‘factor/capability:cannotpassfactor’ at system level. Users who do not have the capability ‘factor/capability:cannotpassfactor’ will be given points for this factor and can bypass MFA, while users with this capability will need to use another type of authentication.

For example: You assign the capability ‘factor/capability:cannotpassfactor’ to all Managers, and also enable the Email factor. When a Manager logs in, they will have to use the Email factor. But when a student tries to log in, they will not.

Since Admin users have all capabilities allowed by default, including “factor/capability:cannotpassfactor”, there’s an additional setting that will allow Admins to gain points for this factor despite having the capability.
=====Other factors =====
These factors provide additional flexibility and control over the authentication process.

'''Trust this device''': This factor allows users to mark a device as trusted during MFA logins. Once a device is designated as trusted, users can bypass MFA for a specified period of time when logging in from that device.

To implement this feature effectively, assign a score of 100 points to this factor.

'''Grace period''': This factor is essential when you turn on factors that require upfront setup from users, like authenticator app or security key. It allows users to log in without engaging with multi-factor authentication (MFA) for a specified time frame, providing a buffer period to complete the setup of additional authentication factors. If a user is still within their grace period upon reaching the first post-login page, regardless of whether they used grace mode as a login factor, a notification will inform them of the remaining grace period length and the potential need to set up additional factors to prevent account lockout when the grace period expires.

To implement this feature effectively, assign a score of 100 points to this factor. To receive points for this factor, there must be no other user-input factors requiring user interaction during the login process. Place this factor at the end of the list to ensure all other factors are addressed first.

If the grace period ends and users have not set up their authentication methods, they will not be able to log in to your site. You can extend the grace period to allow them to log in, or enable other factors temporarily, such as IP range or role.

'''No other factors''': This factor allows people to log in if they have not set up any other MFA factors. For example, if you want to offer MFA to your users but not make it compulsory, give 100 points to ‘no other factors’ to allow those who don’t want to use MFA to log in to the site. Once another factor is set up for a user, they will no longer gain points for this one.
===User setup===
If you enable the factors '''Authenticator app''' and '''Security key''', your users will need to configure multi-factor authentication themselves. The authentication settings can be accessed through User menu > Preferences > Multi-factor authentication preferences. There, they will be able to set up and see their authenticator apps or security keys, as well as revoke access to any factors they have configured.
==Recommendations and example setups==

When setting up MFA for your site, it’s important to ensure that you’re making your site more secure, but also creating a good experience for your users, including making sure that they are able to log in if they follow the right steps. Here are some recommendations to ensure that MFA is streamlined for your users:
# Make sure you turn on the '''Grace period''' factor when you turn on an authentication factor that requires users to configure something themselves ('''Authenticator app''' or '''Security key'''). This will give your users time to set up MFA before they are required to use it.
#If you don’t want to make MFA mandatory, enable '''No other factors'''. This will allow users with no other factors to log in using only their password.
#'''IP range''' factor is a very straightforward authentication method if all your users are using the same network. Once users are logged in using this factor, you can allow them to set up additional factors, such as an authenticator app, and then use those other factors to log in when not on your secure network.
#The '''SMS mobile phone''' factor relies on Amazon Simple Notification Service (SNS) for the delivery of secure and efficient SMS messages.
===Example setups===

These are some examples of common MFA setups to increase the security of your Moodle site.

'''a) Email verification'''
#Enable MFA.
#Turn on factor '''Email''' and give it 100 points.
#You can turn on '''Trust your device''' to allow your users to bypass MFA for a specified period of time after they have verified it with MFA for the first time.
#Let your users know that email verification is now enabled. Next time your users try to log in, they will see a message that asks them to check their email and enter a code that has been sent there.

'''b) Authenticator app'''
#Enable MFA.
#Turn on the factor '''Grace period''' and give it 100 points. This will allow your users a period of time to set up their authenticator apps and prevent them from being locked out of your site. Use the '''Grace period warning banner''' to let your users know that MFA will be enabled soon and encourages them to set up their authenticator app.
#Turn on the factor '''Authenticator app''' and give it 100 points.
# You can turn on '''Trust your device''' to allow your users to bypass MFA for a specified period of time after they have verified it with MFA for the first time.

'''c) Email OR authenticator app'''
#Enable MFA.
#Turn on the factor '''Email''' and give it 100 points.
#Turn on the factor '''Grace period''' and give it 100 points. This will allow your users a period of time to set up their authenticator apps and prevent them from being locked out of your site. Use the '''Grace period warning banner''' to let your users know that MFA will be enabled soon and encourages them to set up their authenticator app.
#Turn on the factor '''Authenticator app''' and give it 100 points.
#You can turn on '''Trust your device''' to allow your users to bypass MFA for a specified period of time after they have verified it with MFA for the first time.

'''d) Email AND authenticator app'''
#Enable MFA.
# Turn on the factor '''Email''' and give it 50 points.
#Turn on the factor '''Grace period''' and give it 100 points. This will allow your users a period of time to set up their authenticator apps and prevent them from being locked out of your site. Use the '''Grace period warning banner''' to let your users know that MFA will be enabled soon and encourages them to set up their authenticator app.
#Turn on the factor '''Authenticator app''' and give it 50 points. Users will have to pass both factors to get to 100 points and be able to log in.
#You can turn on Trust your device to allow your users to bypass MFA for a specified period of time after they have verified it with MFA for the first time.

'''e) SMS Mobile phone:'''

# Enable MFA.
# Turn on the '''SMS Mobile phone''' and give it 100 points.
# Configure your Amazon SNS for SMS Authentication following the [https://docs.aws.amazon.com/sns/ AWS SNS Documentation].
# Add your Key and Secret codes to the SMS Mobile phone settings in Moodle.
# Inform your users that SMS mobile phone verification is now activated. During their next login, they can proceed to set up SMS mobile phone authentication in the user profile preferences page.
# You can turn on '''Trust your device''' to allow your users to bypass MFA for a specified period of time after they have verified it with MFA for the first time.

==Summary of good conditions for login ==
Here are listed the factors selected and their total weighting, adding up to 100.
==General MFA settings==
*The MFA plugin enabled box should be checked for MFA to work.
*From this section you can add any relative URL from the siteroot for which the MFA check will not redirect from
*Links to any guidance pages or files may be uploaded here.
===Admin locked out of site - how to resolve===
Be careful as an administrator when configuring and testing the factors that you do not lock yourself out of the site. If you do then MFA can be disable from the command line by entering:
<syntaxhighlight lang="php">
: php admin/cli/cfg.php --component=tool_mfa --name=enabled --set=0</syntaxhighlight>
[[https://docs.moodle.org/es/Autenticación de múltiples factores]]
[[https://docs.moodle.org/de/Multi-Faktor-Authentifizierung]]