Skip to content

Commit

Permalink
Example: add property-update trigger
Browse files Browse the repository at this point in the history
  • Loading branch information
rfc2822 committed Feb 24, 2025
1 parent fe554f6 commit 88c29cb
Show file tree
Hide file tree
Showing 2 changed files with 7 additions and 2 deletions.
6 changes: 4 additions & 2 deletions content.mkd
Original file line number Diff line number Diff line change
Expand Up @@ -131,7 +131,7 @@ This section describes how a client can detect

To provide information about WebDAV-Push support, new properties are defined. A WebDAV-Push server is REQUIRED to provide the `transports`, `topic` and `supported-triggers` properties for collections that support WebDAV-Push.

The `transports` element contains push transports are supported by the server (one child element per transport). Within the scope of this document, the only supported transport is `web-push` (see {{transport-web-push}}).
The `transports` element lists available push transports. Although the property is defined on every collection, its value is usually the same for every collection on the server. Within the scope of this document, the only supported transport is `web-push` (see {{transport-web-push}}).

The `topic` is a globally unique identifier for the collection. A specific collection could be reachable at different URLs, but it can only have one push topic. A server could for instance use a server-internal ID that is not going to change or a random UUID per collection.

Expand All @@ -158,7 +158,9 @@ HTTP/1.1 207 Multi-Status
{::include xml/sample-propfind-multistatus.xml}
~~~

In this case, the requested collection supports WebDAV-Push in general (because it has a push topic). It supports the Web Push transport. [^todo vapid key] Push notifications can be requested for content updates of internal members.
[^todo] vapid key

In this case, the requested collection supports WebDAV-Push in general (because it has a push topic). It supports the Web Push transport. Push notifications can be requested on content updates of internal members and on property updates of the collection itself.

The comment shows how support for some other (not yet defined) transport could be advertised together with additional specific information that is required to use it.

Expand Down
3 changes: 3 additions & 0 deletions xml/sample-propfind-multistatus.xml
Original file line number Diff line number Diff line change
Expand Up @@ -15,6 +15,9 @@
<P:content-update>
<sync-level>1</sync-level>
</P:content-update>
<P:property-update>
<depth>0</depth>
</P:property-update>
</P:supported-triggers>
</prop>
</response>
Expand Down

0 comments on commit 88c29cb

Please sign in to comment.