# ContentFilter Plugin Readme

## Overview

The content filter plugin allows admins to configure various actions based on message content. These actions include notifying the admin of content matches, notifying the sender that a message was rejected or masking the content with alternative content.

## Installation

Copy the contentfilter.jar into the plugins directory of your Wildfire installation. The plugin will then be automatically deployed. To upgrade to a new version, copy the new contentfilter.jar file over the existing file.

## Configuration

By default, after the plugin has been deployed all of its features are disabled. This plugin is configured via the "Content Filter" sidebar item located under the "System" tab in the Wildfire Admin Console.

The default comma separated patterns are "fox,dog". This will perform a case sensitive match on all words containing these strings. e.g. "fox", "firefox", "foxy", "dog", "hotdog", "dogdays" but not "Fox", "firefoX". These simple patterns can be enhanced with more complex regular expressions as required e.g.:

- for a complete word match, add boundary checks with \b e.g. \bfox\b will match against the word "fox" and nothing else.
- for case insensitive matchs add (?i) e.g. (?i)\bfox\b will match against "fox", "Fox", "foX" etc.

Want to know more about regular expressions in Java? This official tutorial is useful.

## Using the Plugin

After the plugin has been configured, nothing else needs to be done to use it. TODO - update