nikdoof/rustical
1
1
Fork 0
mirror of https://github.com/lennart-k/rustical.git synced 2026-01-30 17:38:22 +00:00
Code Issues Packages Projects Releases Wiki Activity

Update documentation for simplified calendar home set

Browse Source
This commit is contained in:
Lennart K
2025-07-18 12:18:40 +02:00
parent 69163404a1
commit e4f188d299
1 changed files with 12 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files

12
docs/setup/client.md
View File

@@ -13,6 +13,10 @@ Following resources are available.
# Calendar home # Calendar home
/caldav/principal/<user_id>/<calendar_id> /caldav/principal/<user_id>/<calendar_id>
/caldav/principal/<user_id>/_birthdays_<addressbook_id> /caldav/principal/<user_id>/_birthdays_<addressbook_id>
# CalDAV root
/caldav-compat
/caldav-compat/principal...
``` ```
``` ```
@@ -29,6 +33,14 @@ Following resources are available.
Authenticate with HTTP Basic authentication using your user id and a generated app token. Authenticate with HTTP Basic authentication using your user id and a generated app token.
## `/caldav` vs `/caldav-compat` (relevant for group sharing)
To discover shared calendars the `calendar-home-set` property is used to list all principals the user has access to.
However, some clients don't support `calendar-home-set` containing multiple paths (e.g. Apple Calendar).
As a workaround `/caldav-compat` offers the same endpoints as `/caldav` with the only difference being that it does not return all calendar homes in `calendar-home-set`.
This means that clients under this path will probably not auto-discover group calendars so you can instead add them one-by-one using the principal path `/caldav-compat/principal/<principal_id>`.
## DAVx5 ## DAVx5
You can set up DAVx5 through the Nextcloud login flow. Collections including group collections will automatically be discovered. You can set up DAVx5 through the Nextcloud login flow. Collections including group collections will automatically be discovered.