docs/conf/filter.conf.example

   1 # Configuration file for the filter module
   2
   3 # The tags for this module are formatted as follows:
   4 #
   5 # <keyword      pattern="any glob pattern here"
   6 #               reason="reason for filtering"
   7 #               action="action to take"
   8 #               flags="filter flags"
   9 #               duration="optional length of gline">
  10 #
  11 # Valid actions for 'action' are:
  12 #
  13 # warn          This allows the line and sends out a notice to all opers
  14 #               with +s.
  15 #
  16 # block         This blocks the line, sends out a notice to all opers with
  17 #               +s and informs the user that their message was blocked.
  18 #
  19 # silent        This blocks the line only, and informs the user their message
  20 #               was blocked, but does not notify opers.
  21 #
  22 # none          This action causes nothing to be done except logging. This
  23 #               is the default action if none is specified.
  24 #
  25 # kill          This disconnects the user, with the 'reason' parameter as
  26 #               the kill reason.
  27 #
  28 # gline         G-LINE the user for 'duration' length of time. Durations may
  29 #               be specified using the notation 1y2d3h4m6s in a similar way to
  30 #               other glines, omitting the duration or setting it to 0 makes
  31 #               any glines set by this filter be permanent.
  32 #
  33 # zline         Z-LINE the user for 'duration' length of time. Durations may
  34 #               be specified using the notation 1y2d3h4m6s in a similar way to
  35 #               other zlines, omitting the duration or setting it to 0 makes
  36 #               any zlines set by this filter be permanent.
  37 #
  38 # You can add filters from IRC using the /FILTER command. If you do this, they
  39 # will be set globally to your entire network.
  40 #
  41 # Valid characters for 'flags' are one or more of:
  42 #
  43 # p: Block private and channel messages
  44 # n: Block private and channel notices
  45 # P: Block part messages
  46 # q: Block quit messages
  47 # o: Don't match against opers
  48 # c: Strip color codes from text before trying to match
  49 # *: Represents all of the above flags
  50 # -: Does nothing, a no-op for when you do not want to specify any flags
  51
  52 # Example filters:
  53 #
  54 # <keyword pattern="*qwerty*" reason="You qwertied!" action="block" flags="pn">
  55 # <keyword pattern="*killmenow*" reason="As you request." action="kill" flags="*">
  56 # <keyword pattern="*blah*" reason="Dont blah!" action="gline" duration="1d6h" flags="-">
  57
  58 # An example regexp filter:
  59 #
  60 # <keyword pattern="^blah.*?$" reason="Dont blah!" action="gline" duration="1d6h" flags="pnPq">
  61
  62 # You may specify specific channels that are exempt from being filtered:
  63 #<exemptfromfilter target="#opers">
  64 #<exemptfromfilter target="#help">
  65
  66 # You can also exempt messages from being filtered if they are sent to
  67 # specific nicks.
  68 # Example that exempts all messages sent *to* NickServ:
  69 #<exemptfromfilter target="NickServ">
  70
  71 # Note that messages *from* services are never subject to filtering;
  72 # <exemptfromfilter> tags are only for exempting messages sent *to* the
  73 # configured targets.