The "chanfilter" Module (v3)

Description

This module adds channel mode g (filter) which allows channel operators to define glob patterns for inappropriate phrases that are not allowed to be used in the channel.

Configuration

To load this module use the following <module> tag:

<module name="chanfilter">

<chanfilter>

The <chanfilter> tag defines settings about how the chanfilter module should behave. This tag can only be defined once.

Name	Type	Default Value	Description
hidemask	Boolean	No	Whether users can see the inappropriate phrase that their message matched.
notifyuser	Boolean	Yes	Whether to notify users when they have matched a filter.
maxlen	Number	35	The maximum length of a parameter for channel mode g (filter).

Example Usage

<chanfilter hidemask="no"
            notifyuser="yes"
            maxlen="50">

<class>

This module extends the core <class:privs> field with the following values:

Name	Description
channels/ignore-chanfilter	New in v3.13.0! Allows server operators to send a message to a channel that matches a filter entry.

Example Usage

Allows server operators with the class named BasicOper to send a message to a channel that matches a filter entry.

<class name="BasicOper"
       ...
       privs="... channels/ignore-chanfilter ...">

Channel Modes

Name	Character	Type	Parameter Syntax	Usable By	Description
filter	g	List	<glob>	Channel operators	Prevents users from sending messages that match <glob>.

Exemptions

Name	Description
filter	Allows exempted users to send messages that contain censored phrases.

Special Notes

Due to limitations of the IRC protocol filters containing spaces can not be added.