Modules/it

Panoramica

I Moduli vengono usati per estendere e modificare le funzioni dello ZNC. Gli utenti interagiscono con i mouduli inviando messaggi ad un utente speciale su IRC. Per esempio, per vedere le parole chiave evidenziate (highlight keywords) nella watch list, puoi inviare il comando "/msg *watch list". Quando lo ZNC vede che il nick a cui stai inviando un messaggio inizia con un asterisco, non inoltra il messaggio all'IRCd/server, ma lo invia al modulo appropriato per l'elaborazione. In questo caso, il modulo watch riceverà il messaggio, e risponderà con un elenco delle parole chiave (keywords) impostate in precedenza. Ciò costituisce un modo molto comodo e standard di configurare o comunicare in altro modo con i moduli caricati, nonché un modo comune e standard per i moduli caricati di visualizzare lo stato o altre informazioni. Si noti che questo è per i moduli caricati. È necessario caricare un determinato modulo, ad esempio "/znc loadmod watch", prima di potersi interfacciare con il modulo watch. La maggior parte dei moduli risponde al comando "/msg *nome-del-modulo help" con un elenco di comandi disponibili.

I moduli ZNC possono essere caricati in tre "diversi livelli": livello globale, livello network e livello utente. Ogni modulo definisce autonomamente se è disponibile per il caricamento globale, specifico per una rete, o specifico per un utente. Il livello utente e i moduli di network possono fare cose che vanno da manipolare messaggi di entrata/uscita a implementare un client Twitter completo. Possono anche svolgere attività IRC più tradizionali come auto-op basata sulla sfida, impostare il tuo away (l'assenza), o logging su disco. Ogni utente può caricare e configurare il proprio set di moduli per personalizzare la propria esperienza in base alle proprie preferenze.

I moduli globali sono caricabili dagli amministratori e forniscono funzionalità o modificano il comportamento di tutti gli utenti. Per esempio, il modulo partyline deve essere globale poiché fornisce funzionalità a tutti gli utenti di una determinata istanza ZNC per poter comunicare tra loro all'interno dello ZNC stesso. I moduli globali possono fare tutto ciò che possono fare i moduli a livello utente, nonché alcuni extra. Possono sostituire il sistema di autenticazione, modificare il processo di scrittura della configurazione, gesstire i CAP, etc.

I moduli possono collegarsi allo ZNC anche tramite interfaccia web per fornire contenuti via web. Il modulo web più comune è il webadmin che consente agli amministratori di aggiungere/rimuovere utenti, consentendo a questi ultimi di osservare e configurare le impostazioni del proprio ZNC anche attraverso il browser.

Developers

ZNC modules are written in C++ natively. There are also a couple of modules that embed an interpreter to allow you to load Perl, Python, or Tcl modules. To learn more about creation of modules you should read Perl Modules, Python Modules, TCL Modules, or C++ Modules.

Feel free to create wikipages about modules you have created, but don't forget to add a download link, contact information, and use the same layout as the rest of the modules. Contributions are always much appreciated.

Module List

Global Modules

adminlog

Log user connects, disconnects, and failed logins to a file and/or to syslog.

blockuser

Blocks certain users from using ZNC, saying their account was disabled.

certauth

This module lets users to log in via SSL client keys.

cyrusauth

This module is intended for admins who run a shell/web/email/etc server and want to provide ZNC access to their existing users.

fail2ban

Block IPs for some time after a failed login.

identfile

Posts the ident of a user to a file when they are trying to connect.

imapauth

Allow users to authenticate via IMAP.

lastseen

Logs when a user last logged in to ZNC.

modperl

Loads Perl scripts as ZNC modules.

modpython

Allows you to use modules written on Python.

notify_connect

Sends a notice to all admins when a user logs in or out of ZNC.

partyline

Allows ZNC users to join internal channels and query other ZNC users on the same ZNC.

webadmin

Allows you to add/remove/edit users and settings on the fly via a web browser.

User Modules

admin

(Now controlpanel) Allows you to add/remove/edit users and settings on the fly via IRC messages.

autoattach

Watches your detached channels and reattaches you automatically when there is specified activity in a channel you added to your autoattach list.

autoreply

Gives a automatic reply if someone messages you while you are away.

block_motd

Blocks the server's Message of the Day.

bouncedcc

Bounces DCC transfers through the znc server instead of sending them directly to the user.

buffextras

Add nick changes, joins, parts, topic changes etc. to your playback buffer.

chansaver

Saves channels to config when user joins and parts.

charset

Normalizes (i.e. converts) character encodings.

clearbufferonmsg

This module attempts to bridge the gap between being inundated with old buffer if you have KeepBuffer=true; and possibly missing messages when you ping out, if you have KeepBuffer=false.

clientnotify

Notify about new incoming connections to your user.

controlpanel

Allows you to add/remove/edit users and settings on the fly via IRC messages.

ctcpflood

This module tries to block CTCP floods.

dcc

This module allows you to transfer files to and from ZNC

disconkick

This module will kick your client from all channels if ZNC disconnects from server.

flooddetach

This module detaches you from channels which are flooded.

listsockets

This module displays a list of all open sockets in ZNC.

log

Log chat activity to file.

missingmotd

This user module will send 422 to clients when they login.

notes

Keep and replay notes. This is an example of WebMods.

sample

This is an example module to help with writing modules to do whatever you want.

send_raw

Allows you to send raw traffic to IRC from other users.

shell

Access your Unix shell via query right inside of your IRC client.

Network Modules

autocycle

Rejoin a channel when you are the only one there (to gain operator status).

autoop

Automatically give operator status to the good guys.

modtcl

Allows you to run Tcl scripts in ZNC.

autovoice

Automatically give voice status to everyone who joins some channel.

awaynick

Change your nick while you are away.

awaystore

When you are set away or detached, this module will save all private messages for you. The messages can be read until you delete them. This module will also set you away when you are idle some time.

cert

This module lets users use their own SSL certificate to connect to a server.

crypt

Encryption for channel/private messages.

keepnick

Tries to get and keep your primary nick if it is taken.

kickrejoin

Implements auto-rejoin-on-kick.

modules_online

Fakes online status of ZNC modules to fix some clients.

nickserv

Auths you with NickServ.

perform

Performs commands on connect.

q

Auths you with Q (and a little more).

raw

View all of the raw traffic.

route_replies

Routes back answers to the right client when connected with multiple clients.

sasl

Allows you to authenticate to an IRC network via SASL

savebuff

Saves your channel buffers into an encrypted file so they can survive restarts and reboots.

schat

SSL (encrypted) DCC chats.

simple_away

Automatically set you away on IRC when disconnected from the bouncer.

stickychan

Keeps you in specified channels.

watch

Monitor activity for specific text patterns from specific users and have the text sent to a special query window.

More Modules

For more modules, see Category:Modules.

Managing Modules

Modules can be added or removed easily. Modules can be stored in ~/.znc/modules and /usr/local/lib/znc by default. ZNC installs its modules to that second directory, which in fact is ${prefix}/lib/znc, but this can be changed with ./configure --module-prefix=DIR before compiling.

ZNC will first look in the local sub-directory modules when searching for modules. Only files that end with ".so" will be seen as a module. To remove modules you can simply delete them from the folder. No other configuration changes or restarts are necessary. To remove, but also keep a module for later use you can also change the name, like: mv sample.so sample.so_.

To compile a new module you must first save the source as a ".cpp" file. Compiling modules describes the process in detail.

(Un)Loading Modules

Global, user, and network modules can be (un)loaded from webadmin or via the *status query window, like:

/msg *status LoadMod [--type=global|user|network] <module> <parameters>
/msg *status UnloadMod [--type=global|user|network] <module>

• * is the StatusPrefix set in your configuration. Usually it's just an asterisk ("*").
• [--type=global|user|network] optionally specifies whether to (un)load the module as a global, user, or network module. Not all modules can be loaded at all levels; see individual Module documentation to find out where it may be loaded.
• <module> is based on the modules file name, excluding the ".so" extension.
• <parameters> are specific for each module and not required: You can provide parameters when loading the module, or you can set up the module after loading it.

So, to load the log module at the global level (as opposed to user or network) and remove all color/formatting control codes with the -sanitize parameter, you would type:

/msg *status LoadMod --type=global log -sanitize

For older versions of ZNC, you won't have the option to specify [--type=global|user|network]. In that case, just use:

/msg *status LoadMod <module> <parameters>
/msg *status UnloadMod <module>

Please keep in mind that a user is not able to load a module if the directive "DenyLoadMod" is set to true. Trying to load a module will fail with "Unable to load [<module>] Access Denied.".

If a module prevents ZNC from starting up and therefore you can't unload the module using webadmin, you can edit znc.conf and remove the corresponding LoadModule line.

Using modules

It is recommended to read the module's wikipage if you want to find out how a module works. Alternatively the following command can be used to get a command list:

/msg *<module> help

• * is the StatusPrefix set in your configuration. Usually it's just an asterisk ("*").

External modules

Please see Category:External Modules for a comprehensive list.