Clarify presence router docs. (#16529)

This commit is contained in:
Patrick Cloke 2023-10-20 11:40:26 -04:00 committed by GitHub
parent e9069c9f91
commit d2eab22de7
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
2 changed files with 12 additions and 3 deletions

1
changelog.d/16529.doc Normal file
View File

@ -0,0 +1 @@
Improve documentation of presence router.

View File

@ -1,8 +1,16 @@
# Presence router callbacks # Presence router callbacks
Presence router callbacks allow module developers to specify additional users (local or remote) Presence router callbacks allow module developers to define additional users
to receive certain presence updates from local users. Presence router callbacks can be which receive presence updates from local users. The additional users
registered using the module API's `register_presence_router_callbacks` method. can be local or remote.
For example, it could be used to direct all of `@alice:example.com` (a local user)'s
presence updates to `@bob:matrix.org` (a remote user), even though they don't share a
room. (Note that those presence updates might not make it to `@bob:matrix.org`'s client
unless a similar presence router is running on that homeserver.)
Presence router callbacks can be registered using the module API's
`register_presence_router_callbacks` method.
## Callbacks ## Callbacks