comparison mod_push2/push2.md @ 6200:1c16bb49f6f6

mod_push2: rename chat to filter
author Stephen Paul Weber <singpolyma@singpolyma.net>
date Fri, 11 Apr 2025 20:08:56 -0500
parents 2f2539ce8f3b
children
comparison
equal deleted inserted replaced
6199:6b3deaa523ad 6200:1c16bb49f6f6
14 <enable xmlns='urn:xmpp:push2:0'> 14 <enable xmlns='urn:xmpp:push2:0'>
15 <service>pusher@push.example.com</service> 15 <service>pusher@push.example.com</service>
16 <client>https://push.example.com/adlfkjadafdasf</client> 16 <client>https://push.example.com/adlfkjadafdasf</client>
17 <match profile="urn:xmpp:push2:match:archived-with-body"> 17 <match profile="urn:xmpp:push2:match:archived-with-body">
18 <grace>144</grace> 18 <grace>144</grace>
19 <chat jid="somemuc@conference.example.com"> 19 <filter jid="somemuc@conference.example.com">
20 <mention/> 20 <mention/>
21 </chat> 21 </filter>
22 <send xmlns="urn:xmpp:push2:send:notify-only:0"/> 22 <send xmlns="urn:xmpp:push2:send:notify-only:0"/>
23 </match> 23 </match>
24 </enable> 24 </enable>
25 ``` 25 ```
26 26
28 28
29 The `<client/>` element contains an opaque string that will be included in all communication with the push service. It may be used to convey client identifiers used by the push notification service to route notifications. 29 The `<client/>` element contains an opaque string that will be included in all communication with the push service. It may be used to convey client identifiers used by the push notification service to route notifications.
30 30
31 The `<match/>` and `<send/>` elements define what profiles to use for matching stanzas and sending notifications. These are described later in this document. 31 The `<match/>` and `<send/>` elements define what profiles to use for matching stanzas and sending notifications. These are described later in this document.
32 32
33 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. 33 The optional `<filter/>` 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.
34 34
35 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. 35 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.
36 36
37 ## Match and send profiles 37 ## Match and send profiles
38 38