Avii/Radicale
1
0
Fork 0
Code Issues Pull Requests Actions 2 Packages Projects Releases Wiki Activity

sharing/update doc

Browse Source
This commit is contained in:
Peter Bieringer
2026-02-28 07:53:25 +01:00
parent 9b6f6b2cd6
commit 2fab856fea
1 changed files with 13 additions and 1 deletions
Download Patch File Download Diff File Expand all files Collapse all files

14
SHARING.md
View File

@@ -40,7 +40,9 @@ Types of supported sharing configuration:
(_>= 3.7.0_)
One CSV file containing one row per sharing config, separated by `,` and containing header with columns from above.
One CSV file containing one row per sharing config, separated by `;` and containing header with columns from above.
If given, properties are stored in JSON format in CSV.
#### Files
@@ -121,6 +123,7 @@ Can be selected by `HTTP_ACCEPT`
* `Permissions`: effective permission of the share
* `Enabled`: owner/user selected by authentication
* `Hidden`: owner/user selected by authentication
* `Properties`: properties to overlay
#### API Hooks
@@ -285,4 +288,13 @@ ApiVersion=1
Status=success
```
## Properties Overlay
Owner or user can define per share a set of properties to overlay on PROPFIND response during create or update via API.
Whitelisted ones are defined in `OVERLAY_PROPERTIES_WHITELIST` in `radicale/sharing/__init__.py`:
* `C:calendar-description` (_>= 3.7.0_)
* `ICAL:calendar-color` (_>= 3.7.0_)
* `CR:addressbook-description` (_>= 3.7.0_)
* `INF:addressbook-color` (_>= 3.7.0_)