To create new wiki account, please join us on #znc at Libera.Chat and ask admins to create a wiki account for you. You can say thanks to spambots for this inconvenience.

Modules/pt: Difference between revisions

From ZNC
Jump to navigation Jump to search
Created page with "{{Languages|Módulos}} == Introdução == Os '''Módulos''' são utilizados para extender a forma como o ZNC funciona. Os utilizadores interagem com os módulos mais habitualmente por envio de mensagens ao um utilizador especial no IRC. Por exemplo, para ver palavras-chave em realce o na sua lista de watch, você enviaria ''/msg *watch list''. quando o ZNC vir que o nick ao qual está a mandar mensagem começa com um asterisco, não irá encaminhar a mensagem para o ser..."
 
No edit summary
 
(One intermediate revision by the same user not shown)
Line 2: Line 2:


== Introdução ==
== Introdução ==
Os '''Módulos''' são utilizados para extender a forma como o ZNC funciona. Os utilizadores interagem com os módulos mais habitualmente por envio de mensagens ao um utilizador especial no IRC. Por exemplo, para ver palavras-chave em realce o na sua lista de watch, você enviaria ''/msg *watch list''. quando o ZNC vir que o nick ao qual está a mandar mensagem começa com um asterisco, não irá encaminhar a mensagem para o servidor de IRC mas em vez disso, envia-a para o módulo apropriado para processamento. Neste caso, o módulo watch irá receber a mensagem e responder para si com a listagem das suas palavras-chave. Isto torna muito conviniente e uma forma comum para configurar, isto é, comunicar com os seus módulos carregados, assim como uma forma comum para os seus módulos carregados de mostrarem o estado ou outra informação. Note que isto é para os módulos carregados. você tem de carregar um dado módulo, por exemplo ''/znc loadmod watch'', antes de poder interagir com o módulo watch. A maioria dos módulos irão responder ao ''/msg *module help'' com uma listagem de comandos disponíveis.
Os '''módulos''' são utilizados para extender a forma como o ZNC funciona. Os utilizadores interagem com os módulos mais habitualmente por envio de mensagens ao um utilizador especial no IRC. Por exemplo, para ver palavras-chave em realce o na sua lista de watch, você enviaria ''/msg *watch list''. quando o ZNC vir que o nick ao qual está a mandar mensagem começa com um asterisco, não irá encaminhar a mensagem para o servidor de IRC mas em vez disso, envia-a para o módulo apropriado para processamento. Neste caso, o módulo watch irá receber a mensagem e responder para si com a listagem das suas palavras-chave. Isto torna muito conviniente e uma forma comum para configurar, isto é, comunicar com os seus módulos carregados, assim como uma forma comum para os seus módulos carregados de mostrarem o estado ou outra informação. Note que isto é para os módulos carregados. você tem de carregar um dado módulo, por exemplo ''/znc loadmod watch'', antes de poder interagir com o módulo watch. A maioria dos módulos irão responder ao ''/msg *module help'' com uma listagem de comandos disponíveis.


Os módulos do ZNC são carregados '''globalmente''', '''por-rede''' ou '''por-utilizador'''. Cada módulo define para ele próprio se está disponível para ser carregado como global, especifico-para-a-rede e/ou especifico-para-o-utilizador. Os módulos ao nível de utilizador e rede podem fazer coisas como [[crypt|manipular as mensagens de entrada/saída]]. Eles também podem fazer mais tarefas tradicionais do IRC como [[autoop|challenge based auto-op]], [[simple_away|defini-lo(a) como ausente]] ou [[log|registar logs para o disco]]. Cada utilizador pode carregar e configurar o seu conjunto de módulos para personalizar a sua experiência para satisfazer as suas preferências.
Os módulos do ZNC são carregados '''globalmente''', '''por-rede''' ou '''por-utilizador'''. Cada módulo define para ele próprio se está disponível para ser carregado como global, especifico-para-a-rede e/ou especifico-para-o-utilizador. Os módulos ao nível de utilizador e rede podem fazer coisas como [[crypt|manipular as mensagens de entrada/saída]]. Eles também podem fazer mais tarefas tradicionais do IRC como [[autoop|challenge based auto-op]], [[simple_away|defini-lo(a) como ausente]] ou [[log|registar logs para o disco]]. Cada utilizador pode carregar e configurar o seu conjunto de módulos para personalizar a sua experiência para satisfazer as suas preferências.
Line 17: Line 17:
== Lista de Módulos ==
== Lista de Módulos ==
=== Módulos Globais ===
=== Módulos Globais ===
; [[adminlog]] : Log user connects, disconnects, and failed logins to a file and/or to syslog.
; [[adminlog]] : Regista as entradas, saídas e inicio de sessão falhadas para um ficheiro e/ou para o syslog.
; [[blockuser]] : Blocks certain users from using ZNC, saying their account was disabled.
; [[blockuser]] : BloBloqueia certos utilizadores de utilizar o ZNC, dizendo que a conta deles foi desactivada.
; [[certauth]] : This module lets users to log in via SSL client keys.
; [[certauth]] : Este m´doulo permite aos utilizadores iniciar sessão através de chaves de cliente SSL.
; [[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.
; [[cyrusauth]] : Este módulo é para administradores que executam a servidor de shell/web/email/etc e querem fornecer acesso ZNC aos seus utilizadores existentes.
; [[fail2ban]] : Block IPs for some time after a failed login.
; [[fail2ban]] : Bloqueia IPs por algum tempo após um inicio de sessão falhada.
; [[identfile]] : Posts the ident of a user to a file when they are trying to connect.
; [[identfile]] : Coloca a ident de um utilizador em ficheiro quando ele está a tentar ligar.
; [[imapauth]] : Allow users to authenticate via IMAP.
; [[imapauth]] : Permite aos utilizadores autenticar-se utilizando IMAP.
; [[lastseen]] : Logs when a user last logged in to ZNC.
; [[lastseen]] : Regista quando foi o último inicio de sessão no ZNC.
; [[modperl]] : Loads Perl scripts as ZNC modules.
; [[modperl]] : Carrega scripts de Perl como módulos de ZNC.
; [[modpython]] : Allows you to use modules written on Python.
; [[modpython]] : Permite-lhe a si utilizar módulos escritos em Python.
; [[notify_connect]] : Sends a notice to all admins when a user logs in or out of ZNC.
; [[notify_connect]] : Envia uma notificação para todos os administradores quando um utilizador inicia ou sai da sessão de ZNC.
; [[partyline]] : Allows ZNC users to join internal channels and query other ZNC users on the same ZNC.
; [[partyline]] : Permite aos utilizadores de ZNC de juntarem-se a canais internos e fazer mensagens privadas a outros utilizadores de ZNC no mesmo ZNC.
; [[webadmin]] : Allows you to add/remove/edit users and settings on the fly via a web browser.
; [[webadmin]] : Permite-lhe a si adicionar/remover/editar utilizadores e definições imediatamente utilizando um navegador da web.


=== User Modules ===
=== Módulos de Utilizador ===
; [[controlpanel|admin]] : (Now [[controlpanel]]) Allows you to add/remove/edit users and settings on the fly via IRC messages.
; [[controlpanel|admin]] : (Agora [[controlpanel]]) Permite-lhe adicionar/remover/editar utilizadores e definições imediatamente utilizando mensagens de IRC.
; [[autoattach]] : Watches your [[Detaching|detached]] channels and reattaches you automatically when there is specified activity in a channel you added to your autoattach list.
; [[autoattach]] : Observa os seus canais [[Detaching|desunidos]] e une-o(a) automaticamente quando existe actividade especifica num canal que adicionou na lista de autoattach.
; [[autoreply]] : Gives a automatic reply if someone messages you while you are away.
; [[autoreply]] : Fornece uma resposta automática se alguém enviar-lhe uma mensagem enquanto você estiver ausente.
; [[block_motd]] : Blocks the server's Message of the Day.
; [[block_motd]] : Bloqueia a Message of the Day (Mensagem do Dia) do servidor.
; [[bouncedcc]] : Bounces DCC transfers through the znc server instead of sending them directly to the user.
; [[bouncedcc]] : Redirecciona as transferências de DCC através do servidor de ZNC em vez de as enviar directamente ao utilizador.
; [[buffextras]] : Add nick changes, joins, parts, topic changes etc. to your playback buffer.
; [[buffextras]] : Adiciona alterações de nick, entradas, partidas, alterações de tópico etc. à sua reprodução de buffer.
; [[chansaver]] : Saves channels to config when user joins and parts.
; [[chansaver]] : Guarda canais para para o config quando o utilizador entra ou parte.
; [[charset]] : Normalizes (i.e. converts) character encodings.
; [[charset]] : Normaliza (ex. converte) codificação de caracteres.
; [[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.
; [[clearbufferonmsg]] : Este módulo tenta fazer a ponte em cima do vazio com buffer antigo se tiver KeepBuffer=true; e possivelmente mensagens em falta quando falhou o ping, se tiver KeepBuffer=false.
; [[clientnotify]] : Notify about new incoming connections to your user.
; [[clientnotify]] : Notifica acerca das ligações a chegar ao seu utilizador.
; [[controlpanel]] : Allows you to add/remove/edit users and settings on the fly via IRC messages.
; [[controlpanel]] : Permite-lhe a si adicionar/remover/editar utilizadores e definições imediatamente utilizando mensagens de IRC.
; [[ctcpflood]] : This module tries to block CTCP floods.
; [[ctcpflood]] : Este módulo tenta bloquear flood de CTCP.
; [[dcc]] : This module allows you to transfer files to and from ZNC
; [[dcc]] : Este módulo permite-lhe transferir ficheiros para e do ZNC.
; [[disconkick]] : This module will kick your client from all channels if ZNC disconnects from server.
; [[disconkick]] : Este módulo irá chutá-lo o cliente de todos os canais se o ZNC se desligar do servidor.
; [[flooddetach]] : This module detaches you from channels which are flooded.
; [[flooddetach]] : Este módulo desune-o(a) dos canais que estão com flood.
; [[listsockets]] : This module displays a list of all open sockets in ZNC.
; [[listsockets]] : Este módulo mostra uma lista de todos os sockets abertos no ZNC.
; [[log]] : Log chat activity to file.
; [[log]] : Regista a actividade do chat para ficheiro.
; [[missingmotd]] : This user module will send 422 to clients when they login.
; [[missingmotd]] : Este módulo de utilizador irá enviar 422 para os clientes quando eles iniciarem a sessão.
; [[notes]] : Keep and replay notes. This is an example of [[WebMods]].
; [[notes]] : Mantém e reproduz notas. Isto é um exemplo de [[WebMods]].
; [[sample]] : This is an example module to help with [[writing modules]] to do whatever you want.
; [[sample]] : Isto é um módulo de exemplo para ajudar com [[writing modules]] para fazer o que quiser.
; [[send_raw]] : Allows you to send raw traffic to IRC from other users.
; [[send_raw]] : Permite-lhe a si enviar tráfego raw para o IRC de outros utilizadores.
; [[shell]] : Access your Unix shell via query right inside of your IRC client.
; [[shell]] : Aceda à sua shell Unix através de mensagem privada mesmo dentro do seu cliente de IRC.


=== Network Modules ===
=== Módulos de Rede ===
; [[autocycle]] : Rejoin a channel when you are the only one there (to gain operator status).
; [[autocycle]] : Fazer entrar outra vez num canal quando é o(a) único(a) la (para ganhar status de operador).
; [[autoop]] : Automatically give operator status to the good guys.
; [[autoop]] : Automaticamente dá status de operador às pessoas boas.
; [[modtcl]] : Allows you to run Tcl scripts in ZNC.
; [[modtcl]] : Permite-lhe a si executar script Tcl no ZNC.
; [[autovoice]] : Automatically give voice status to everyone who joins some channel.
; [[autovoice]] : Automaticamente dá status de voice a toda a gente que nalgum canal.
; [[awaynick]] : Change your nick while you are away.
; [[awaynick]] : Altera o seu nick enquanto estiver ausente.
; [[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.
; [[awaystore]] : Quando estiver definido(a) como ausente ou desunido, este módulo irá guardar todas as mensagens privadas para si. As mensagens pode ser lidas até que as apague. Este módulo irá também defini-lo(a) como ausente quando não estiver a fazer nada por algum tempo.
; [[cert]] : This module lets users use their own SSL certificate to connect to a server.
; [[cert]] : Este módulo deixa os utilizadores os seus próprios certificados SSL para ligar a um servidor.
; [[crypt]] : Encryption for channel/private messages.
; [[crypt]] : Encriptação para as mensagens de canal e mensagens privadas.
; [[keepnick]] : Tries to get and keep your primary nick if it is taken.
; [[keepnick]] : Tenta obter e manter o seu nick principal se for tirado.
; [[kickrejoin]] : Implements auto-rejoin-on-kick.
; [[kickrejoin]] : Implementa auto-rejoin-on-kick (automaticamente entrar no canal onde foi chutado(a) por um utilizador/bot de IRC).
; [[modules_online]] : Fakes online status of ZNC modules to fix some clients.
; [[modules_online]] : Falseia o estado online de módulos de ZNC para consertar alguns clientes.
; [[nickserv]] : Auths you with NickServ.
; [[nickserv]] : Autentica-o(a) com o NickServ.
; [[perform]] : Performs commands on connect.
; [[perform]] : Executa comandos ao ligar ao IRC.
; [[q]] : Auths you with Q (and a little more).
; [[q]] : Autentica-o(a) com o Q (e um pouco mais).
; [[raw]] : View all of the raw traffic.
; [[raw]] : Visualizar todo o tráfego raw.
; [[route_replies]] : Routes back answers to the right client when connected with multiple clients.
; [[route_replies]] : Devolve de volta respostas para o cliente certo quando estão 2 ou mais clientes ligados.
; [[sasl]] : Allows you to authenticate to an IRC network via SASL
; [[sasl]] : Permite-lhe a si autenticar a uma rede de IRC utilizando SASL
; [[savebuff]] : Saves your channel buffers into an encrypted file so they can survive restarts and reboots.
; [[savebuff]] : Guarda o buffer de canal para um ficheiro encriptado para que eles possam sobreviver a reinicios.
; [[schat]] : SSL (encrypted) DCC chats.
; [[schat]] : Chat DCC com SSL (encriptado).
; [[simple_away]] : Automatically set you away on IRC when disconnected from the bouncer.
; [[simple_away]] : Automaticamente define-o(a) como ausente no IRC quando desligado do bouncer.
; [[stickychan]] : Keeps you in specified channels.
; [[stickychan]] : Mantém-o(a) em canais específicos.
; [[watch]] : Monitor activity for specific text patterns from specific users and have the text sent to a special query window.
; [[watch]] : Monitoriza a actividade por padrões específicos de texto de utilizadores específicos e ter o texto mantido para uma janela específica de mensagem privada.


=== More Modules ===
=== Mais Módulos ===
For more modules, see [[:Category:Modules]].
Para mais módulos, veja [[:Category:Modules]].


== Managing Modules ==
== Gerir Módulos ==
Modules can be added or removed easily. Modules can be stored in <code>~/.znc/modules</code> and <code>/usr/local/lib/znc</code> by default. ZNC installs its modules to that second directory, which in fact is <code>${prefix}/lib/znc</code>, but this can be changed with <code>./configure --module-prefix=DIR</code> before compiling.
Os módulos podem ser adicionados ou recuperados facilmente. Os módulos podem ser guardados em <code>~/.znc/modules</code> and <code>/usr/local/lib/znc</code> por defeito. O ZNC instala os seus módulos para esse segundo directório que é de facto <code>${prefix}/lib/znc</code>, mas isto pode ser alterado com <code>./configure --module-prefix=DIR</code> antes de compilar.


ZNC will first look in the local sub-directory <code>modules</code> 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: <code>mv sample.so sample.so_</code>.
O ZNC irá primeiro procurar no sub-directório local <code>modules</code> quando procurar por módulos. Apenas os ficheiros que terminarem com ".so" irão ser vistos como um módulo. Para remover módulos, pode simplesmente eliminá-los a partir da pasta. Nenhuma outra alteração ou reinício de configuração será necessária. Para remover e também manter um módulo para ser usado mais tarde, pode também alterar o nome, como: <code>mv sample.so sample.so_</code>.


To compile a new module you must first save the source as a ".cpp" file. [[Compiling modules]] describes the process in detail.
Para compilar um novo módulo, tem de primeiro guardar a source com um ficheiro ".cpp". [[Compiling modules|Compilar módulos]] descreve o processo em detalhe.


=== (Un)Loading Modules ===
=== (Des)carregar Módulos ===
Global, user, and network modules can be (un)loaded from [[webadmin]] or via the <tt>*status</tt> query window, like:
Os módulos globais, de utilizador e de rede podem ser (des)carregados a partir do [[webadmin]] ou a partir da janela de mensagem privada <tt>*status</tt>, tipo:


  /msg *status LoadMod [--type=global|user|network] <module> <parameters>
  /msg *status LoadMod [--type=global|user|network] <módulo> <parâmetros>
  /msg *status UnloadMod [--type=global|user|network] <module>
  /msg *status UnloadMod [--type=global|user|network] <módulo>


* <code>*</code> is the StatusPrefix set in your [[configuration]]. Usually it's just an asterisk ("*").
* <code>*</code> é o StatusPrefix definido na sua [[configuration|configuração]]. Normalmente é apenas um asterisco ("*").
* <code>[--type=global|user|network]</code> 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 [[:Category:Modules|Module documentation]] to find out where it may be loaded.
* <code>[--type=global|user|network]</code> opcionalmente especofoca se (des)carrega o módulo como um módulo global, de utilizador ou de rede. Nem todos os módulos podem ser carregados a todos os niveis; veja a [[:Category:Modules|Documentação do módulo]] individual para saber mais onde ele pode ser carregado.
* <code><module></code> is based on the modules file name, excluding the ".so" extension.
* <code><módulo></code> é baseado no nome do ficheiro do módulo, tirando a extensão ".so".
* <code><parameters></code> 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.
* <code><parâmetros></code> são específicos para cada módulo e não necessário: Pode fornecer parâmetros quando carregar o módulo ou pode definir ou configurar o módulo depois de o carregar.


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 '''<code>-sanitize</code>''' parameter, you would type:
Então, para carregar o módulo '''[[log]]''' ao nível '''global''' (em vez de nível de utilizador ou de rede) e remover todos os códigos de controlo de cores/formatações com o parâmetro '''<code>-sanitize</code>''', você digitaria:


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


For older versions of ZNC, you won't have the option to specify <code>[--type=global|user|network]</code>. In that case, just use:
Para as versões antigas do ZNC, não irá ter a opção para especificar <code>[--type=global|user|network]</code>. Neste caso, apenas utilize:
  /msg *status LoadMod <module> <parameters>
  /msg *status LoadMod <módulo> <parâmetros>
  /msg *status UnloadMod <module>
  /msg *status UnloadMod <módulo>


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.".
Por favor, fixe na sua cabeça que um utilizador não é capaz de carregar um módulo se a directiva "DenyLoadMod" estiver definida como true. Tentar carregar irá falhar com a mensagem "Não foi possível carregar [<módulo>] Acesso Negado.".


If a module prevents ZNC from starting up and therefore you can't unload the module using [[webadmin]], you can edit [[configuration|znc.conf]] and remove the corresponding <code>LoadModule</code> line.
Se um módulo impedir o ZNC de iniciar e por conseguinte não poder descarregar o módulo utilizando o [[webadmin]], pode editar a linha [[configuration|znc.conf]] e remover o correspondente <code>LoadModule</code>.


== Using modules ==
== Utilizar Módulos ==
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:
É recomendado ler o wiki do módulo se quiser saber mais sobre como um módulo funciona. Alternativamente, o comando seguinte pode ser utilizado para obter uma lista de comandos:
  /msg *<module> help
  /msg *<módulo> help
* <code>*</code> is the StatusPrefix set in your [[configuration]]. Usually it's just an asterisk ("*").
* <code>*</code> é o StatusPrefix definido na sua [[configuration|configuração]]. Normalmente é apenas um asterisco ("*").


== External modules ==
== Módulos Externos ==
Please see [[:Category:External Modules]] for a comprehensive list.
Por favor, veja [[:Category:External Modules|Módulos Externos]] para uma lista completa.


[[Category:Modules]]
[[Category:Modules]]

Latest revision as of 15:48, 12 June 2023

Introdução

Os módulos são utilizados para extender a forma como o ZNC funciona. Os utilizadores interagem com os módulos mais habitualmente por envio de mensagens ao um utilizador especial no IRC. Por exemplo, para ver palavras-chave em realce o na sua lista de watch, você enviaria /msg *watch list. quando o ZNC vir que o nick ao qual está a mandar mensagem começa com um asterisco, não irá encaminhar a mensagem para o servidor de IRC mas em vez disso, envia-a para o módulo apropriado para processamento. Neste caso, o módulo watch irá receber a mensagem e responder para si com a listagem das suas palavras-chave. Isto torna muito conviniente e uma forma comum para configurar, isto é, comunicar com os seus módulos carregados, assim como uma forma comum para os seus módulos carregados de mostrarem o estado ou outra informação. Note que isto é para os módulos carregados. você tem de carregar um dado módulo, por exemplo /znc loadmod watch, antes de poder interagir com o módulo watch. A maioria dos módulos irão responder ao /msg *module help com uma listagem de comandos disponíveis.

Os módulos do ZNC são carregados globalmente, por-rede ou por-utilizador. Cada módulo define para ele próprio se está disponível para ser carregado como global, especifico-para-a-rede e/ou especifico-para-o-utilizador. Os módulos ao nível de utilizador e rede podem fazer coisas como manipular as mensagens de entrada/saída. Eles também podem fazer mais tarefas tradicionais do IRC como challenge based auto-op, defini-lo(a) como ausente ou registar logs para o disco. Cada utilizador pode carregar e configurar o seu conjunto de módulos para personalizar a sua experiência para satisfazer as suas preferências.

OS módulos globais são carregáveis por administradores e fornecem funcionalidade ou alteram o comportamento para todos os utilizadores. Por exemplo, o módulo partyline tem de ser global visto que ele fornece a funcionalidade para todos os utilizadores para uma dada instância do ZNC ser capaz de comunicarem ambos de dentro do próprio ZNC. Os módulos globais podem fazer tudo que os módulos do nível-de-utilizador podem fazer, tal como algumas coisas mais. Eles podem substituir o sistema de autenticação do ZNC, modificar o processo de escrita da configuração, lidar com o CAP, etc.

Os módulos podem tambem fixar-se ao interface web do ZNC e fornecer conteúdo da web. O módulo web mais comum é o webadmin que permite aos administradores adicionar/remover utilizadores e permite aos utilizadores configurarem as suas definições a partir de um navegador.

Programadores

OS módulos do ZNC estão escritos nativamente em C++. Existem também 2 módulos que se incorporam como interpretador para lhe permitir carregar módulos Perl, Python ou Tcl. Para saber mais sobre a criação, deve ler módulos Perl, módulos Python, módulos TCL ou módulos C++.

Sinta-se À vontade para criar páginas de wiki acerca de módulos que você criou mas não se esqueça de fornecer um link de transferência, informação de contacto e utilizar o mesmo layout como os restantes módulos. As contribuições serão muito bem apreciadas.

Lista de Módulos

Módulos Globais

adminlog
Regista as entradas, saídas e inicio de sessão falhadas para um ficheiro e/ou para o syslog.
blockuser
BloBloqueia certos utilizadores de utilizar o ZNC, dizendo que a conta deles foi desactivada.
certauth
Este m´doulo permite aos utilizadores iniciar sessão através de chaves de cliente SSL.
cyrusauth
Este módulo é para administradores que executam a servidor de shell/web/email/etc e querem fornecer acesso ZNC aos seus utilizadores existentes.
fail2ban
Bloqueia IPs por algum tempo após um inicio de sessão falhada.
identfile
Coloca a ident de um utilizador em ficheiro quando ele está a tentar ligar.
imapauth
Permite aos utilizadores autenticar-se utilizando IMAP.
lastseen
Regista quando foi o último inicio de sessão no ZNC.
modperl
Carrega scripts de Perl como módulos de ZNC.
modpython
Permite-lhe a si utilizar módulos escritos em Python.
notify_connect
Envia uma notificação para todos os administradores quando um utilizador inicia ou sai da sessão de ZNC.
partyline
Permite aos utilizadores de ZNC de juntarem-se a canais internos e fazer mensagens privadas a outros utilizadores de ZNC no mesmo ZNC.
webadmin
Permite-lhe a si adicionar/remover/editar utilizadores e definições imediatamente utilizando um navegador da web.

Módulos de Utilizador

admin
(Agora controlpanel) Permite-lhe adicionar/remover/editar utilizadores e definições imediatamente utilizando mensagens de IRC.
autoattach
Observa os seus canais desunidos e une-o(a) automaticamente quando existe actividade especifica num canal que adicionou na lista de autoattach.
autoreply
Fornece uma resposta automática se alguém enviar-lhe uma mensagem enquanto você estiver ausente.
block_motd
Bloqueia a Message of the Day (Mensagem do Dia) do servidor.
bouncedcc
Redirecciona as transferências de DCC através do servidor de ZNC em vez de as enviar directamente ao utilizador.
buffextras
Adiciona alterações de nick, entradas, partidas, alterações de tópico etc. à sua reprodução de buffer.
chansaver
Guarda canais para para o config quando o utilizador entra ou parte.
charset
Normaliza (ex. converte) codificação de caracteres.
clearbufferonmsg
Este módulo tenta fazer a ponte em cima do vazio com buffer antigo se tiver KeepBuffer=true; e possivelmente mensagens em falta quando falhou o ping, se tiver KeepBuffer=false.
clientnotify
Notifica acerca das ligações a chegar ao seu utilizador.
controlpanel
Permite-lhe a si adicionar/remover/editar utilizadores e definições imediatamente utilizando mensagens de IRC.
ctcpflood
Este módulo tenta bloquear flood de CTCP.
dcc
Este módulo permite-lhe transferir ficheiros para e do ZNC.
disconkick
Este módulo irá chutá-lo o cliente de todos os canais se o ZNC se desligar do servidor.
flooddetach
Este módulo desune-o(a) dos canais que estão com flood.
listsockets
Este módulo mostra uma lista de todos os sockets abertos no ZNC.
log
Regista a actividade do chat para ficheiro.
missingmotd
Este módulo de utilizador irá enviar 422 para os clientes quando eles iniciarem a sessão.
notes
Mantém e reproduz notas. Isto é um exemplo de WebMods.
sample
Isto é um módulo de exemplo para ajudar com writing modules para fazer o que quiser.
send_raw
Permite-lhe a si enviar tráfego raw para o IRC de outros utilizadores.
shell
Aceda à sua shell Unix através de mensagem privada mesmo dentro do seu cliente de IRC.

Módulos de Rede

autocycle
Fazer entrar outra vez num canal quando é o(a) único(a) la (para ganhar status de operador).
autoop
Automaticamente dá status de operador às pessoas boas.
modtcl
Permite-lhe a si executar script Tcl no ZNC.
autovoice
Automaticamente dá status de voice a toda a gente que nalgum canal.
awaynick
Altera o seu nick enquanto estiver ausente.
awaystore
Quando estiver definido(a) como ausente ou desunido, este módulo irá guardar todas as mensagens privadas para si. As mensagens pode ser lidas até que as apague. Este módulo irá também defini-lo(a) como ausente quando não estiver a fazer nada por algum tempo.
cert
Este módulo deixa os utilizadores os seus próprios certificados SSL para ligar a um servidor.
crypt
Encriptação para as mensagens de canal e mensagens privadas.
keepnick
Tenta obter e manter o seu nick principal se for tirado.
kickrejoin
Implementa auto-rejoin-on-kick (automaticamente entrar no canal onde foi chutado(a) por um utilizador/bot de IRC).
modules_online
Falseia o estado online de módulos de ZNC para consertar alguns clientes.
nickserv
Autentica-o(a) com o NickServ.
perform
Executa comandos ao ligar ao IRC.
q
Autentica-o(a) com o Q (e um pouco mais).
raw
Visualizar todo o tráfego raw.
route_replies
Devolve de volta respostas para o cliente certo quando estão 2 ou mais clientes ligados.
sasl
Permite-lhe a si autenticar a uma rede de IRC utilizando SASL
savebuff
Guarda o buffer de canal para um ficheiro encriptado para que eles possam sobreviver a reinicios.
schat
Chat DCC com SSL (encriptado).
simple_away
Automaticamente define-o(a) como ausente no IRC quando desligado do bouncer.
stickychan
Mantém-o(a) em canais específicos.
watch
Monitoriza a actividade por padrões específicos de texto de utilizadores específicos e ter o texto mantido para uma janela específica de mensagem privada.

Mais Módulos

Para mais módulos, veja Category:Modules.

Gerir Módulos

Os módulos podem ser adicionados ou recuperados facilmente. Os módulos podem ser guardados em ~/.znc/modules and /usr/local/lib/znc por defeito. O ZNC instala os seus módulos para esse segundo directório que é de facto ${prefix}/lib/znc, mas isto pode ser alterado com ./configure --module-prefix=DIR antes de compilar.

O ZNC irá primeiro procurar no sub-directório local modules quando procurar por módulos. Apenas os ficheiros que terminarem com ".so" irão ser vistos como um módulo. Para remover módulos, pode simplesmente eliminá-los a partir da pasta. Nenhuma outra alteração ou reinício de configuração será necessária. Para remover e também manter um módulo para ser usado mais tarde, pode também alterar o nome, como: mv sample.so sample.so_.

Para compilar um novo módulo, tem de primeiro guardar a source com um ficheiro ".cpp". Compilar módulos descreve o processo em detalhe.

(Des)carregar Módulos

Os módulos globais, de utilizador e de rede podem ser (des)carregados a partir do webadmin ou a partir da janela de mensagem privada *status, tipo:

/msg *status LoadMod [--type=global|user|network] <módulo> <parâmetros>
/msg *status UnloadMod [--type=global|user|network] <módulo>
  • * é o StatusPrefix definido na sua configuração. Normalmente é apenas um asterisco ("*").
  • [--type=global|user|network] opcionalmente especofoca se (des)carrega o módulo como um módulo global, de utilizador ou de rede. Nem todos os módulos podem ser carregados a todos os niveis; veja a Documentação do módulo individual para saber mais onde ele pode ser carregado.
  • <módulo> é baseado no nome do ficheiro do módulo, tirando a extensão ".so".
  • <parâmetros> são específicos para cada módulo e não necessário: Pode fornecer parâmetros quando carregar o módulo ou pode definir ou configurar o módulo depois de o carregar.

Então, para carregar o módulo log ao nível global (em vez de nível de utilizador ou de rede) e remover todos os códigos de controlo de cores/formatações com o parâmetro -sanitize, você digitaria:

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

Para as versões antigas do ZNC, não irá ter a opção para especificar [--type=global|user|network]. Neste caso, apenas utilize:

/msg *status LoadMod <módulo> <parâmetros>
/msg *status UnloadMod <módulo>

Por favor, fixe na sua cabeça que um utilizador não é capaz de carregar um módulo se a directiva "DenyLoadMod" estiver definida como true. Tentar carregar irá falhar com a mensagem "Não foi possível carregar [<módulo>] Acesso Negado.".

Se um módulo impedir o ZNC de iniciar e por conseguinte não poder descarregar o módulo utilizando o webadmin, pode editar a linha znc.conf e remover o correspondente LoadModule.

Utilizar Módulos

É recomendado ler o wiki do módulo se quiser saber mais sobre como um módulo funciona. Alternativamente, o comando seguinte pode ser utilizado para obter uma lista de comandos:

/msg *<módulo> help
  • * é o StatusPrefix definido na sua configuração. Normalmente é apenas um asterisco ("*").

Módulos Externos

Por favor, veja Módulos Externos para uma lista completa.