diff mod_push2/push2.md @ 6184:2f2539ce8f3b

mod_push2: implement grace period
author Stephen Paul Weber <singpolyma@singpolyma.net>
date Mon, 24 Mar 2025 22:18:47 -0500
parents e53f0967520c
children 1c16bb49f6f6
line wrap: on
line diff
--- a/mod_push2/push2.md	Mon Mar 24 13:01:05 2025 -0500
+++ b/mod_push2/push2.md	Mon Mar 24 22:18:47 2025 -0500
@@ -15,6 +15,7 @@
     <service>pusher@push.example.com</service>
     <client>https://push.example.com/adlfkjadafdasf</client>
     <match profile="urn:xmpp:push2:match:archived-with-body">
+        <grace>144</grace>
         <chat jid="somemuc@conference.example.com">
             <mention/>
         </chat>
@@ -31,6 +32,8 @@
 
 The optional `<chat/>` child of `<match/>` allows extra filtering of pushes for only specific chats. No specified filters means muted, do not push. `<mention/>` means push on mentions, `<reply/>` means push on replies.
 
+The optional `<grace/>` child of `<match/>` allows specifying a "grace period" in seconds where activity on another session by the same user (such as sending a message) will temporarily pause sending push notifications.
+
 ## Match and send profiles
 
 Different clients and push services have different requirements for push notifications, often due to the differing capabilities of target platforms.