znc-push/doc/examples.md

2.5 KiB

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.