Diff

mod_push2/push2.md @ 6215:e53f0967520c

mod_push: Allow filtering pushes for particular chats
author Stephen Paul Weber <singpolyma@singpolyma.net>
date Mon, 24 Mar 2025 13:01:05 -0500
parent 6190:aa240145aa22
child 6216:2f2539ce8f3b
line wrap: on
line diff
--- a/mod_push2/push2.md	Mon Mar 24 09:28:25 2025 -0500
+++ b/mod_push2/push2.md	Mon Mar 24 13:01:05 2025 -0500
@@ -15,6 +15,9 @@
     <service>pusher@push.example.com</service>
     <client>https://push.example.com/adlfkjadafdasf</client>
     <match profile="urn:xmpp:push2:match:archived-with-body">
+        <chat jid="somemuc@conference.example.com">
+            <mention/>
+        </chat>
         <send xmlns="urn:xmpp:push2:send:notify-only:0"/>
     </match>
 </enable>
@@ -26,6 +29,8 @@
 
 The `<match/>` and `<send/>` elements define what profiles to use for matching stanzas and sending notifications. These are described later in this document.
 
+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.
+
 ## Match and send profiles
 
 Different clients and push services have different requirements for push notifications, often due to the differing capabilities of target platforms.