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.

Chanfilter: Difference between revisions

From ZNC
Jump to navigation Jump to search
>Jpnurmi
the latest dev is no longer needed
KindOne (talk | contribs)
Restore Chanfilter from archive.org - 2016/11/07
 
Line 2: Line 2:
{{External Module}}
{{External Module}}


The channel filter module maintains client specific channel lists for identified clients. A typical use case is to have a subset of channels visible for a mobile client.
The channel filter module maintains client specific channel lists for identified clients. A typical use case is to have a subset of channels visible to a mobile client.


The source code is available on [https://github.com/jpnurmi/znc-chanfilter GitHub]. See also instructions for [[compiling modules]].
The source code is available on [https://github.com/jpnurmi/znc-chanfilter GitHub]. See also instructions for [[compiling modules]].
Line 8: Line 8:
=== Usage ===
=== Usage ===


When an identified client connects ZNC first time, all channels are joined. The list of channels is automatically updated when the client joins and parts channels. Next time the identified client connects, it joins the channels it had visible from the last session.
When a client connects to ZNC for the first time, all channels are joined. The list of channels is automatically updated when the client joins and parts channels. Next time the identified client connects, it joins the channels it had visible from the last session.
 
This only happens to clients that are identified and ''added'' (see below).
 
Note that because this module intercepts <code>/part</code>, joining a new channel and then parting it in an identified client will leave it attached in ZNC (and other clients). Typing <code>/part #channel</code> another time will pass the action through to ZNC and part the channel on the network.


{{Module arguments|no}}
{{Module arguments|no}}

Latest revision as of 19:24, 2 April 2017

The channel filter module maintains client specific channel lists for identified clients. A typical use case is to have a subset of channels visible to a mobile client.

The source code is available on GitHub. See also instructions for compiling modules.

Usage

When a client connects to ZNC for the first time, all channels are joined. The list of channels is automatically updated when the client joins and parts channels. Next time the identified client connects, it joins the channels it had visible from the last session.

This only happens to clients that are identified and added (see below).

Note that because this module intercepts /part, joining a new channel and then parting it in an identified client will leave it attached in ZNC (and other clients). Typing /part #channel another time will pass the action through to ZNC and part the channel on the network.

Arguments

This user module takes no arguments.

Read loading modules to learn more about loading modules.

Identifiers

ZNC supports passing a client identifier in the password:

username@identifier/network:password

or in the username:

username@identifier/network

Commands

Add a client:

/msg *chanfilter AddClient <identifier>

Delete a client:

/msg *chanfilter DelClient <identifier>

List all channels of a client:

/msg *chanfilter ListChans [client]

List known clients and their hidden channels:

/msg *chanfilter ListClients

Restore the hidden channels of a client:

/msg *chanfilter RestoreChans [client]