Note: This documentation is for Moodle 2.7. For up-to-date documentation see Display emoticons as images filter.

Display emoticons as images filter: Difference between revisions

From MoodleDocs
mNo edit summary
mNo edit summary
 
(9 intermediate revisions by 6 users not shown)
Line 1: Line 1:
{{Moodle 2.0}}
{{Filters}}
The filter '''Display emoticons as images''' converts emoticon (smiley) characters into images.


The filter '''Display emoticons as images''' converts emoticon (smiley) characters into images. In Moodle 1.x, this feature is integrated directly into text format processing functions.
Emoticons may be added using the button [[file:attoemoticon.png]] ''Insert emoticon'' in the [[Text editor]] or by typing the emoticon characters e.g. <code>:-)</code>.


== Filter settings ==
The emoticon button can be added from ''Site administration>Plugins>Text editor>Atto HTML editor>Atto toolbar settings.''


Since Moodle 2.0, the site administrator has to enable the filter to convert emoticon characters like <code>:-)</code> into images. In the filter settings, choose the input text formats where the filter should be applied. The default values are backward compatible with Moodle 1.x behaviour.


== Inserting emoticons in HTML editor ==
==Site administration settings==
[[Image:tinymce-insert-emoticon-popup.png|right|thumb|Insert emoticon popup menu in Moodle 2.0]]


Users can insert emoticons by direct typing the emoticon characters, eg <code>:-)</code>. If the emoticon filter is enabled, a button [[Image:tinymce-insert-emoticon-icon.gif]] ''Insert emoticon'' is available in TinyMCE HTML editor. It lets the user to insert the emoticon image from the popup menu.
===Manage filters===


Emoticon images inserted via the popup menu are automatically converted back into their text representation before the text is submitted to the server. And vice versa, all emoticons are automatically converted into images when the editor loads. This way, users using TinyMCE HTML editor can see emoticon images while users working with the plain web form field (textarea) can see the text representation of the smilies.
A site administrator can enable / disable the 'Display emoticons as images' filter site-wide in ''Administration > Site administration > Plugins > Filters > Manage filters''.


== Customizing emoticons ==
The 'Display emoticons as images' settings (''Administration > Site administration > Plugins > Filters > Display emoticons as images'') enable the site administrator to select which formats the filter is applied to. By default, the filter is applied to Moodle auto-format, HTML format and Markdown format.


Both the filter and TinyMCE popup menu use a list of emoticons defined by the site administrator. The list of available emoticon images can be configured at ''Site administration > Appearance > HTML settings'' page. See [[HTML settings]] for more details.
===HTML settings===


[[Category:Filter]]
A site administrator can customize the list of available emoticons in ''Administration > Site administration > Appearance > HTML settings''. See [[Emoticon images]] for details.
 
[[Category: Site administration]]
 
[[de:Emoticon als Bild anzeigen]]
[[es:Filtro para mostrar emoticones como imágenes]]

Latest revision as of 11:23, 17 June 2014

The filter Display emoticons as images converts emoticon (smiley) characters into images.

Emoticons may be added using the button attoemoticon.png Insert emoticon in the Text editor or by typing the emoticon characters e.g. :-).

The emoticon button can be added from Site administration>Plugins>Text editor>Atto HTML editor>Atto toolbar settings.


Site administration settings

Manage filters

A site administrator can enable / disable the 'Display emoticons as images' filter site-wide in Administration > Site administration > Plugins > Filters > Manage filters.

The 'Display emoticons as images' settings (Administration > Site administration > Plugins > Filters > Display emoticons as images) enable the site administrator to select which formats the filter is applied to. By default, the filter is applied to Moodle auto-format, HTML format and Markdown format.

HTML settings

A site administrator can customize the list of available emoticons in Administration > Site administration > Appearance > HTML settings. See Emoticon images for details.