Filters: Difference between revisions

From MoodleDocs
(Replaced with content from Filters 2.0)
(updated video)
 
(37 intermediate revisions by 12 users not shown)
Line 1: Line 1:
{{Filters}}
{{Managing content}}
<p class="note">'''Please refer to [[Page_notes#Filters|these notes]] before editing this page.'''</p>
Filters can be used to add links, insert multimedia players, convert Mathematical expressions or emoticons into images and more.


Filters can transform simple text into different often more complex forms.  The potential for a filter is set at the site level and then it can be applied as needed in site on a context level. HTML hyperlinking, or a text link that automatically calls up a sound player are examples of text filters.
A filter may be enabled at the site level and then removed as needed at the course or activity level. Thus a teacher can disable glossary auto-linking in a quiz for example.


There are many applications for filters. You could turn on the LaTeX filter just for courses in the Maths and Physics categories so users could create math formula notations with text based short cuts. Here the LaTeX filter would need to be enabled for the site and you would need permission in the context of those course categories to edit the filter settings.  A teacher could turn off glossary linking in a course exam, or in the entire course.
{{MediaPlayer | url =https://youtu.be/_WGN7bxtCyU | desc = Overview of course filters}}


Filters are one of the general categories that can be selected for a course backup or as part of the course import process.
==Standard filters==
 
 
==Managing filters at site level==


[[Image:Manage filters 2.png|thumb|Manage filters]]
Filters in Moodle include:
#In the settings block access ''Site administration > Plugins > Filters > Manage filters''
#Select 'On', 'Off but available' or 'Disabled' as required for each filter
#Use the up/down arrow icons to arrange the filters in the order in which they should be applied
 
Certain filters have additional settings, which can be accessed via the links in the settings column.
 
==Managing filters at course or activity level==
[[Image:Filter settings in forum.png|thumb|Filter settings in a forum]]
#In the settings block access ''Course administration > Filters'' or ''Activity administration > Filters''
#Set each filter on or off as required
#Click the 'Save changes' button
 
==Standard filters==


*Activity Names Auto-linking - This scans text for activity titles that exist in the same course and creates a link.
*[[Activity names auto-linking filter|Activity names auto-linking]] - Scans course text for activity titles that exist in the same course and creates a link to them
*[[Algebra filter|Algebra]] - This filter will convert algebra code into GIF images. It requires the [[TeX notation filter|TeX filter]] to be installed. Note also that your system must also include the following Perl module: HTML::Entities.pm
*[[Algebra filter|Algebra notation]] - Convert algebra code into images
*Database auto-linking - As the name suggests, this filter enables automatic linking of [[Database module]] entries.
*[[Convert URLs into links filter|Convert URLs into links and images]] - Converts URLs in selected formats, such as Moodle auto-format, to click-able links
:''Note'': If entries are required before viewing, the database auto-linking filter should be disabled. This is because the database auto-linking filter can't determine whether a user has submitted the required number of entries.
*[[Database auto-linking filter|Database auto-linking]] - Enables automatic linking of [[Database module|course Database activity]] entries
*Email Protection - This filter scans the text for any email addresses. Where found they are changed (obfuscated) to reduce the chance of being added to a spammers list.
*[[Display emoticons as images filter|Display emoticons as images]] - Converts textual emoticon (smiley) characters into images
*Glossary auto-linking - As the name suggests, this filter enables automatic linking of [[Glossary module]] entries. In addition to this filter, individual glossary entries should have the "This entry should be automatically linked" box checked.
*[[Email protection filter|Email protection]] - Obfuscates email address links to make them more difficult for spammers to harvest
*[[Multi language content]] - This filter enables resources to be created in multiple languages. It looks for &lt;span&nbsp;lang="xx" class="multilang"&gt;...&lt;/span&gt; tags which indicate that a text contains multiple languages. Then it selects and outputs the best language for the current user. The language of the resource will change when the user changes their selected Moodle language.
*[[Glossary auto-linking filter|Glossary auto-linking]] - Scans text for glossary entries that exist in the same course and creates a link
*[[Multimedia plugins]]
*[[HTML tidy filter|HTML tidy]] - Checks any added HTML code that it is XHMTL compliant
*Resource Names Auto-linking - The titles of [[Resources]] can automatically become hyperlinks that take you to the relevant resource within the same course.
*[[MathJax filter|MathJax]] - For adding mathematical equations and expressions using an equation editor
*[[TeX notation filter|TeX notation]]
*[[Multimedia plugins filter|Multimedia plugins]] - Converts HTML links in text that points to a multimedia resource and replaces the link with an appropriate multimedia players
*HTML tidy - This filter checks whether HTML code is XHTML compliant, tidying where necessary. To make this filter work you need to have PHP compiled with the libtidy option; see http://www.php.net/tidy. The Using Moodle discussion [http://moodle.org/mod/forum/discuss.php?d=28418 Tidy Filter for Moodle 1.5] contains more details.
*[[Multi-language content filter|Multi-Language content]] - Enables resources to be created in multiple languages
*Wiki Page Auto-linking - As the name suggests, this filter enables automatic linking between wiki pages, based on the name of the page.  It does not, however, change the behavior of linking of pages by using CamelCase or [square brackets].
*[[TeX notation filter|TeX notation]] Displaying math formulae in TeX notation using images
*[[Word censorship]] - This filter "blacks out" words found on a list.
*[[Word censorship]] - This filter "blacks out" words found on a list you can manage


There are two new filters in Moodle 2.0 onwards:
==Contributed filters==


*[[Display emoticons as images]] - This filter converts emoticons, for example :-) into smilie images.
Filters have also been [https://moodle.org/plugins/browse.php?list=category&id=7 made by developers in the community]. Some docs online for these include:
*Convert URLs into links - This filter converts URLs in selected formats, such as Moodle auto-format, to click-able links.
*[[FontAwesome_filter|FontAwesome]] - This scans text for icons that can be embedded using the FontAwesome icon set.
*[[IPA_filter|IPA]] - Renders simple X-SAMPA markup in the International Phonetic Alphabet
*[[PoodLL_filter|PoodLL]] - is the core PoodLL plugin for Moodle. It contains all the recorders, widgets and the code that makes it possible to use them around Moodle. It is a required component for all the other PoodLL plugins.
*[[filter generico]] - gives you considerable ability to customize your Moodle site without having to resort to multiple plugins, or custom PHP coding
*[[filter multiembed]] - Facilitates embedding of third-party content from a growing list of service providers (e.g. Prezi, Haiku Deck, etc.)


==See also==
==See also==


*[[Common filter settings]]
*[[Managing filters]]
*[[Filter settings|Common filter settings]] for the site
*[[Filters FAQ]]
*[[Filters FAQ]]
*[[Filters used on the Moodle.org forums]]
*[[Development:Filters 2.0]]


[[Category:Filter]]
[[Category:Filter]]
[[Category:Mathematics]]


[[fr:Filtres 2.0]]
[[fr:Réglages communs aux filtres]]
[[de:Filter]]
[[es:Filtros]]

Latest revision as of 11:36, 13 May 2022

Filters can be used to add links, insert multimedia players, convert Mathematical expressions or emoticons into images and more.

A filter may be enabled at the site level and then removed as needed at the course or activity level. Thus a teacher can disable glossary auto-linking in a quiz for example.

Overview of course filters

Standard filters

Filters in Moodle include:

Contributed filters

Filters have also been made by developers in the community. Some docs online for these include:

  • FontAwesome - This scans text for icons that can be embedded using the FontAwesome icon set.
  • IPA - Renders simple X-SAMPA markup in the International Phonetic Alphabet
  • PoodLL - is the core PoodLL plugin for Moodle. It contains all the recorders, widgets and the code that makes it possible to use them around Moodle. It is a required component for all the other PoodLL plugins.
  • filter generico - gives you considerable ability to customize your Moodle site without having to resort to multiple plugins, or custom PHP coding
  • filter multiembed - Facilitates embedding of third-party content from a growing list of service providers (e.g. Prezi, Haiku Deck, etc.)

See also