ContentFilter Plugin Readme

On 29 October 2020, this git repository was rewritten to remove unrelated history to this plugin.

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 Jive Messenger 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 Jive Messenger 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.:

If you choose to filter your users presence status and there is a content match then:

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

The default mask is "***", you can change it to anything you like including smilies!

Using the plugin

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

Trouble shooting

If the plugin behaviour is not as expected you can enable server debug logging. This will allow the plugin to start logging. Server debug logging should only be enabled temporarily, as it will generate a lot of additional logging that will both slow your server down and consume a lot of disk space.