Note: You are currently viewing documentation for Moodle 2.3. Up-to-date documentation for the latest stable version is available here: Display emoticons as images filter.

Display emoticons as images filter: Difference between revisions

From MoodleDocs
No edit summary
(DE-Link)
 
(3 intermediate revisions by one other user not shown)
Line 1: Line 1:
{{Filters}}
{{Filters}}
<p class="note">'''Please refer to [[Page_notes#Filters|these notes]] before editing this page.'''</p>
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 [[Image:tinymce-insert-emoticon-icon.gif]] ''Insert emoticon'' in the [[Text editor]] or by typing the emoticon characters e.g. <code>:-)</code>.


== Filter settings ==
[[Image:tinymce-insert-emoticon-popup.png|left|frame|Insert emoticon popup menu in the text editor]]


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 ''Settings > Site administration > Plugins > Filters > Manage filters''.


== Customizing emoticons ==
The 'Display emoticons as images' settings (''Settings > 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 at [[HTML settings]] page. See [[Emoticon images 2.0]] for more details.
===HTML settings===


[[Category:Filter]]
A site administrator can customize the list of available emoticons in ''Settings > Site administration > Appearence > HTML settings''. See [[Emoticon images]] for details.
 
[[Category: Site administration]]
 
[[de:Emoticon als Bild anzeigen]]

Latest revision as of 15:40, 27 April 2012

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

Emoticons may be added using the button tinymce-insert-emoticon-icon.gif Insert emoticon in the Text editor or by typing the emoticon characters e.g. :-).

Insert emoticon popup menu in the text editor


Site administration settings

Manage filters

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

The 'Display emoticons as images' settings (Settings > 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 Settings > Site administration > Appearence > HTML settings. See Emoticon images for details.