mirror of https://github.com/SeanOMik/znc-push.git
60 lines
2.5 KiB
Markdown
60 lines
2.5 KiB
Markdown
Example Configurations
|
|
======================
|
|
|
|
|
|
Default Behavior
|
|
----------------
|
|
|
|
Most users that are new to ZNC Push expect to receive a push notification any
|
|
time they get mentioned in a channel or receive a private message. However,
|
|
by default, ZNC Push is configured to only send notifications when it's likely
|
|
that the user is either away from their computer, or not paying attention to
|
|
the conversation in question. This will ideally prevent you from getting
|
|
"spammed" with notifications every time you get mentioned or receive a PM,
|
|
especially when you are actively participating in discussion.
|
|
|
|
### Configuration
|
|
|
|
channel_conditions: all
|
|
query_conditions: all
|
|
|
|
away_only: no
|
|
client_count_less_than: 0
|
|
highlight:
|
|
idle: 0
|
|
last_active: 180
|
|
last_notification: 300
|
|
replied: yes
|
|
|
|
### Explanation
|
|
|
|
The use of `channel_conditions: all` and `query_conditions: all` means that
|
|
ZNC Push will evaluate all of the other conditions, and require that all of
|
|
them "pass" in order for a notification to be sent.
|
|
|
|
But the real key to understanding the default configuration is the use of
|
|
`last_active`, `last_notification`, and `replied` to try and determine if the
|
|
user is "active" in the conversation whenever they get highlighted or receive
|
|
a private message.
|
|
|
|
* `last_active` looks for whether the user has performed an action that would
|
|
generall require direct involvement, such as sending a message to a channel,
|
|
sending a private message, or sending an action (`/me ...`). This is
|
|
specific to the context in which the user receives a message. So by default,
|
|
if the user gets highlighted or receives a private message, a notification
|
|
will only get sent if the user hasn't sent a message to that context in the
|
|
last 180 seconds (three minutes).
|
|
|
|
* `last_notification` looks for the last time that a notification was sent to
|
|
the user. This is specific to the context in which a user receives a
|
|
message. So by default, if the user gets highlighted or receives a private
|
|
message, they will only get a notification if they haven't already received
|
|
a notification for that context within the last 300 seconds (five minutes).
|
|
|
|
* `replied` looks to see if the user has responded since the last time a
|
|
notification was sent. This is specific to the context in which the user
|
|
receives a message. By default, if the user gets highlighted or receives a
|
|
private message, a notification is only sent if the user has not yet received
|
|
a notification for that context, or if they have gotten a notification and
|
|
have since responded to that context.
|