Text editor: Difference between revisions
mNo edit summary |
|||
Line 127: | Line 127: | ||
==Dragging/dropping images into the text editor== | ==Dragging/dropping images into the text editor== | ||
* If your browser supports it, you can drag and drop images into a [[Page]], [[Questions]] and [[Labels]]. | * If your browser supports it, you can drag and drop images into a [[Page]], [[Questions]] and [[Labels]]. | ||
* Images dragged into a [[Forum ]] post will not appear. | * Images dragged into a [[Forum ]] post will not appear unless you are using Atto and have the Plugin for Drag and Drop installed. (https://moodle.org/plugins/view.php?plugin=atto_imagedragdrop) | ||
* Images cannot be dragged and dropped using Chrome or IE, but it is possible with Firefox. | * Images cannot be dragged and dropped using Chrome or IE, but it is possible with Firefox. | ||
* [https://moodle.org/mod/forum/discuss.php?d=270053 This forum thread] has more discussion on the matter. | * [https://moodle.org/mod/forum/discuss.php?d=270053 This forum thread] has more discussion on the matter. | ||
* There is a tracker item for drag and drop here: https://tracker.moodle.org/browse/MDL-43996 | * There is a tracker item for drag and drop into Atto here: https://tracker.moodle.org/browse/MDL-43996 | ||
==See also== | ==See also== |
Revision as of 20:21, 30 November 2014
The text editor (sometimes referred to as the 'HTML editor' has many icons to assist the user in entering content. Many of these icons and functions should be familiar to anyone who uses a word processor. However, writing for the web on the web is different, and especially with accessibility and design considerations Atto sometimes you may not do what you expect with a normal editor, or even the old default editor in Moodle.
For some comment on this, please see this post
Some examples of where you will see the text editor include: Editing Section headings, description of an activity, writing an answer to a quiz question or editing the content of many blocks.
The default text editor in Moodle is the Atto editor, built specifically for Moodle. There is also a version of the TinyMCE editor and a plain text editor.
Text editors can be enabled, disabled or a different one set to default from Administration > Site administration > Plugins > Text editors > Manage editors. The order of priority may also be specified here.
An individual user can select an editor in their profile from Administration > My Profile settings > Edit profile.
Atto HTML editor
New feature
in Moodle 2.7!
Atto Row 1
1:Expand | 2.Style | 3.Bold | 4.Italic |
5.Bulleted list | 6.Numbered list | 7.Add link | 8.Unlink |
9.Add image | 10.Add media | 11.Manage embedded files |
Atto Row 2
1. Underline | 2. Strikethrough | 3. Subscript | 4. Superscript |
5. Align left | 6. Align centre | 7. Align right | 8. Increase indent |
9. Decrease indent | 10. Equation editor | 11. Special character | 12. Table |
13. Clear formatting | 14. Undo/redo | 15. Undo/redo | 16. Accessibility checker |
17. Screenreader helper | 18. HTML/code view |
Equation editor
New feature
in Moodle 2.7!
If either the MathJax or the TeX notation filters are enabled (in Administration > Site administration > Plugins > Filters > Manage filters) then an equation editor button is provided in the toolbar for launching the equation editor.
Site administration settings
Toolbar settings
The administrator can specify which plugins to display and in which order from Administration > Site administration > Plugins > Text editors > Atto HTML editor > Atto toolbar settings.
Extra plugins from the list (for example 'Font color' or 'Emoticon') may be added by typing the toolbarconfig term into the toolbar config table.
Here for example are the available colours when 'fontcolor' is added:
The icons are displayed in related groups and the administrator can decide how many groups to display in the default collapsed state of the toolbar (that is, how many groups to display on Row 1).
Non default Atto plugins
Not all plugins are enabled by default and the administrator of each site should give careful thought as to which plugins they choose to enable for their users. Here are some things to consider before enabling the non-default plugins:
Background colour / Font colour
While these are very popular plugins, there are downsides to enabling their use on a site. Firstly - user specified colours may conflict visually with the site colours chosen by the theme designer. Even if the colours of the content does not conflict with the colours of the current theme, if the theme is changed in future, or the content is reused on a different site conflicts may be introduced. There are 2 possible types of conflicts, the first is just a visually unappealing combination of colours, the second is a combination of colours that may produce text that is hard to read for some people. It is preferable if the theme designer uses some interesting colours that meet the accessibility standards required for the site in the theme for the site, and the person creating the content simply uses the proper heading levels (for example) to make use of those styles.
Emoticons
The emoticon plugin inserts text representations of the emoticons in the content. The emoticon filter is responsible for converting these text sequences into proper smiley images. The emoticon filter is not enabled by default, which is why the emoticon plugin for Atto is not enabled by default.
No-auto link
In general, the more plugins are added to the Atto toolbar, the harder it becomes to find specific plugins. Because the no-auto link plugin is not felt to be widely used it is not enabled by default.
Right to left
Because this plugin is only useful for courses where text needs to be written in a mixture of both "left to right" and "right to left" languages, it is not enabled by default.
Moodle plugins directory
There are more plugins available for Atto than just those included in a default install.
See the Moodle plugins directory for additional plugins.
Some examples include
Equation editor settings
Equation editor commands may be removed, added or reordered in Administration > Site administration > Plugins > Text editors > Atto HTML editor > Equation editor settings.
Dragging/dropping images into the text editor
- If your browser supports it, you can drag and drop images into a Page, Questions and Labels.
- Images dragged into a Forum post will not appear unless you are using Atto and have the Plugin for Drag and Drop installed. (https://moodle.org/plugins/view.php?plugin=atto_imagedragdrop)
- Images cannot be dragged and dropped using Chrome or IE, but it is possible with Firefox.
- This forum thread has more discussion on the matter.
- There is a tracker item for drag and drop into Atto here: https://tracker.moodle.org/browse/MDL-43996
See also
- Moodle HQ screencast demonstrating Atto editor
- The Moodle Text Editor - Atto MoodleBites video on YouTube
- Text editor FAQ
- Embedded files repository
- New 2.7 Equation Editor - Missing Key Items forum discussion and associated issue MDL-45067