Difference between revisions of "Filters"

Jump to: navigation, search

Note: You are currently viewing documentation for Moodle 2.0. Up-to-date documentation for the latest stable version is available here: Filters.

(See also: link added)
(enabling filters, image added)
Line 1: Line 1:
[[Image:Filters_configuration_table.JPG|thumb|Moodle 1.6 Filters administration]]
 
 
Location: ''Administration > Modules > Filters''
 
Location: ''Administration > Modules > Filters''
  
Filters allow for the automatic transformation of entered text into different, often more complex forms. For example the titles of [[Resources|resources]] can automatically become hyperlinks that take you to the relevant resource, URLs pointing to [[mp3]] files can become [[Flash]] controls embedded in the web page that let you pause and rewind the audio. The possibilities are endless and there are a number of standard filters included with Moodle and many more specialized filters contributed by the community.
+
Filters allow for the automatic transformation of entered text into different, often more complex forms. For example the titles of [[Resources|resources]] can automatically become hyperlinks that take you to the relevant resource, URLs pointing to [[mp3]] files can become [[Flash]] controls embedded in the web page that let you pause and rewind the audio. The possibilities are endless and there are a number of standard filters included with Moodle and many more specialized filters available from the Moodle.org [http://moodle.org/mod/data/view.php?id=6009 Modules and plugins database].
  
  
==Filters administration==
+
==Enabling filters==
 +
[[Image:filters admin.png|thumb|Filters administration in Moodle 1.8]]
 +
To enable a filter:
 +
#Access Administration > Modules > Filters.
 +
#On the filters administration page, click the eye icon opposite the filter you want to enable, so that it changes to an open eye.
 +
#Use the up/down arrow icons to arrange the filters in the order in which they should be applied.
  
In Moodle 1.6 onwards, the filters administration page enables individual filters to be shown (enabled) or hidden (disabled). Only enabled filters will be applied to displayed text. The order in which filters are applied to displayed text can be significant - you can change the order in which enabled filters are applied using the up and down buttons. The enabled filters are applied from the top of the list down. Some filters have their own settings screen. Please refer to the documentation for the individual filter for more information.
+
Certain filters have additional settings, which can be accessed via the links in the settings column.
  
Prior to Moodle 1.6, the filters administration screen has two columns - active and inactive. The arrows are used to move filters from one column to the other. Only filters in the active column will be applied. Note that up and down arrows are provided to the left of the active column to enable the order in which filters are applied to be changed. In some cases this can be significant.
+
Note: Filter settings which apply to more than one filter can be found in ''Administration > Appearance > [[Filter settings]]''.
  
 
==Standard filters==
 
==Standard filters==
 +
 +
Filters included in the standard download are:
  
 
*Activity Names Auto-linking - This scans text for activity titles that exist in the same course and creates a link.
 
*Activity Names Auto-linking - This scans text for activity titles that exist in the same course and creates a link.

Revision as of 13:13, 5 October 2007

Location: Administration > Modules > Filters

Filters allow for the automatic transformation of entered text into different, often more complex forms. For example the titles of resources can automatically become hyperlinks that take you to the relevant resource, URLs pointing to mp3 files can become Flash controls embedded in the web page that let you pause and rewind the audio. The possibilities are endless and there are a number of standard filters included with Moodle and many more specialized filters available from the Moodle.org Modules and plugins database.


Enabling filters

Filters administration in Moodle 1.8

To enable a filter:

  1. Access Administration > Modules > Filters.
  2. On the filters administration page, click the eye icon opposite the filter you want to enable, so that it changes to an open eye.
  3. 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.

Note: Filter settings which apply to more than one filter can be found in Administration > Appearance > Filter settings.

Standard filters

Filters included in the standard download are:

  • Activity Names Auto-linking - This scans text for activity titles that exist in the same course and creates a link.
  • Algebra - This filter will convert algebra code into GIF images. It requires the tex filter to be installed (see below). Note also that your system must also include the following Perl module: HTML::Entities.pm
  • Database auto-linking - As the name suggests, this filter enables automatic linking of Database module entries.
  • Email Protection - This filter scans the text for any email addresses. Where found they are changed to reduce the chance of being added to a spammers list.
  • 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.
  • Multi language content - This filter enables resources to be created in multiple languages. It looks for <span lang="xx" class="multilang">...</span> 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. Please note: going to the past, the multilang filter supported the <lang> tag. Then, officially, we changed it to the standard HTML <span> tag and the <lang> solution is now deprecated.
  • Multimedia plugins
  • Resource Names Auto-linking - The titles of Resources can automatically become hyperlinks that take you to the relevant resource within the same course.
  • TeX notation
  • 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 Tidy Filter for Moodle 1.5 contains more details.
  • Wiki Page Auto-linking
  • Word censorship - This filter "blacks out" words found on a list.

Non-standard filters

Filters are one of Moodle's pluggable resources and may be added or removed simply by using a file manager to add or remove them from the /filters directory. Moodle detects those that are present and makes them available to use.

  • Jmol - for interactive 3D viewing of molecular structures
  • Code Syntax Highlighting - for more readable excerpts of programming languages including PHP, HTML, CSS, and XML amongst many others

See also