From 490e06f7708dd74d1175cd415a41354a37aeb530 Mon Sep 17 00:00:00 2001 From: Robby Date: Mon, 10 Mar 2025 23:23:31 +0100 Subject: [PATCH] Add various missing information to the example configs. * Add missing restriction exemptions in example configs, and remove blockcaps. * Add missing extbans in example help config, and remove blockcaps. * Add missing user and channel modes in example help config. * Add the extban names in addition to the characters. --- docs/conf/help.example.conf | 97 +++++++++++++++++++-------------- docs/conf/inspircd.example.conf | 6 +- 2 files changed, 61 insertions(+), 42 deletions(-) diff --git a/docs/conf/help.example.conf b/docs/conf/help.example.conf index 096d69523..847ea66bb 100644 --- a/docs/conf/help.example.conf +++ b/docs/conf/help.example.conf @@ -862,6 +862,8 @@ using their cloak when they quit. (requires the account module). S Strips formatting codes out of private messages to the user (requires the stripcolor module). + T Enables blocking private messages that contain CTCPs + (requires the noctcp module). W Receives notifications when a user uses WHOIS on them (server operators only, requires the showwhois module). "> @@ -878,6 +880,13 @@ using their cloak when they quit. q Gives owner status to , preventing them from being kicked (Services or +q only, requires the customprefix module). + y Grants the server operator-only channel operprefix + status to . Can not be directly set by users, + gets set automatically on server operators. + (requires the operprefix module). + Y Grants the server operator-only channel official-join + status to . Can not be directly set by users, + use /OJOIN to have it set (requires the ojoin module). b Bans from the channel. e Excepts from bans (requires the @@ -973,9 +982,14 @@ using their cloak when they quit. channel (requires the stripcolor module). T Blocks /NOTICEs to the channel from users who are not at least halfop (requires the nonotice module). + U Hides the messages of unprivileged users from other + unprivileged users (requires the opmoderated module). X : Makes users of or higher exempt to the specified restriction . For example: flood:h (requires the exemptchanops module). + Z [=] Add and remove modes via their long names (requires + the namedmodes module). + Possible restriction types to exempt with +X are: anticaps Channel mode +B @@ -984,12 +998,14 @@ using their cloak when they quit. auditorium-vis Permission required to be visible in a +u channel (requires the auditorium module). blockcolor Channel mode +c + delaymsg Channel mode +d filter Channel mode +g flood Channel mode +f nickflood Channel mode +F noctcp Channel mode +C nonick Channel mode +N nonotice Channel mode +T + opmoderated Channel mode +U regmoderated Channel mode +M repeat Channel mode +E stripcolor Channel mode +S @@ -1093,49 +1109,50 @@ setting +I . Matching extbans: - a: Matches user with both a matching banmask and real name, - where is in the format nick!user@host+realname - (requires realnameban module). - j: Matches anyone in the given channel. Does not support - wildcards (requires the channelban module). - n: Matches users in a matching connect class (requires - the classban module). - r: Matches users with a matching real name (requires the - realnameban module). - s: Matches users on a matching server (requires the - serverban module). - z: Matches users having the given TLS certificate - fingerprint (requires the sslmodes module). - w: Matches users who are connecting via a WebIRC gateway that - matches . - O: Matches server operators of a matching type, mostly - useful as an invite exception (requires the - operchans module). - R: Matches users logged into a matching account (requires - the account module). - U: Matches unregistered users matching the given banmask. - (requires the account module). +realmask:, a: Matches user with both a matching banmask and real name, where + is in the format nick!user@host+realname (requires the + realnameban module). +channel:, j: Matches anyone in the given channel. Supports wildcards + (requires the channelban module). +class:, n: Matches users in a matching connect class (requires the + classban module). +oper:, o: Checks whether users are logged into a server operator account + with a name matching (requires the operchans module). +realname:, r: Matches users with a matching real name (requires the + realnameban module). +server:, s: Matches users on a matching server (requires the serverban + module). +sslfp:, z: Matches users having the given TLS certificate fingerprint + (requires the sslmodes module). +gateway:, w: Matches users who are connecting via a WebIRC gateway that + matches (requires the gateway module). +country:, G: Matches against the two letter country code for the country + that users are connecting from (requires the geoban module). +opertype:, O: Matches server operators of a matching type, mostly useful as + an invite exception (requires the operchans module). +account:, R: Matches users logged into a matching account (requires the + account module). +unauthed:, U: Matches unregistered users matching the given banmask (requires + the account module). Acting extbans: - c: Blocks any messages that contain formatting codes from - matching users (requires the blockcolor module). - m: Blocks messages from matching users (requires the muteban - module). Users with +v or above are not affected. - A: Blocks invites by matching users even when +A is set - (requires the allowinvite module). - B: Blocks all capital or nearly all capital messages from - matching users (requires the blockcaps module). - C: Blocks CTCPs from matching users (requires the noctcp - module). - N: Blocks nick changes from matching users (requires - the nonicks module). - Q: Blocks kicks by matching users (requires the nokicks - module). - S: Strips formatting codes from messages from matching - users (requires the stripcolor module). - T: Blocks notices from matching users (requires the - nonotice module). +blockcolor:, c: Blocks any messages that contain formatting codes from matching + users (requires the blockcolor module). +mute:, m: Blocks messages from matching users (requires the muteban + module). Users with +v or above are not affected. +opmoderated:, u: Blocks matching users from speaking to unprivileged users in + the channel (requires the opmoderated module). +blockinvite:, A: Blocks invites by matching users even when +A is set (requires + the allowinvite module). +noctcp:, C: Blocks CTCPs from matching users (requires the noctcp module). +nonick:, N: Blocks nick changes from matching users (requires the nonicks + module). +nokick:, Q: Blocks kicks by matching users (requires the nokicks module). +stripcolor:, S: Strips formatting codes from messages from matching users + (requires the stripcolor module). +nonotice:, T: Blocks notices from matching users (requires the nonotice + module). A ban given to an Acting extban may either be a nick!user@host mask (unless stated otherwise), matched against users as for a normal ban, diff --git a/docs/conf/inspircd.example.conf b/docs/conf/inspircd.example.conf index badc60b35..4a0e2fb46 100644 --- a/docs/conf/inspircd.example.conf +++ b/docs/conf/inspircd.example.conf @@ -690,8 +690,6 @@ # a +u channel (requires the auditorium module). # - auditorium-vis Permission required to be visible in a +u channel # (requires the auditorium module). - # - blockcaps Channel mode +B - blocks messages with too many capital - # letters (requires the blockcaps module). # - blockcolor Channel mode +c - blocks messages with formatting codes # (requires the blockcolor module). # - delaymsg Channel mode +d - blocks sending messages until specified @@ -708,8 +706,12 @@ # changing nicks (requires the nonicks module). # - nonotice Channel mode +T - blocks /NOTICEs to the channel # (requires the nonotice module). + # - opmoderated Channel mode +U - hides the messages of unprivileged users + # from other unprivileged users (requires the opmoderated module). # - regmoderated Channel mode +M - blocks unregistered users from # speaking (requires the account module). + # - repeat Channel mode +E - allows blocking of similar messages + # (requires the repeat module). # - stripcolor Channel mode +S - strips formatting codes from # messages (requires the stripcolor module). # - topiclock Channel mode +t - limits changing the topic to (half)ops