Skip to content

Developer Resources

Jump to bottom
Thomas Citharel edited this page Jan 24, 2022 · 17 revisions

Resources

RFCs

(Support means support at the server level, not that we have all the features in the Calendar app or the groupware settings)

General RFCs

Specific features

Recent RFCs

Upcoming Drafts

Non-standard

Nextcloud-specific CalDAV properties

General

  • {http://owncloud.org/ns}read-only whether the collection or object is read-only

Groups

  • {http://owncloud.org/ns}groups exposes contacts groups (from CATEGORIES vcard property)
  • {http://owncloud.org/ns}group contact group name

Sharing

This part mixes files, address book and calendar sharing, so not everything might be relevant!

  • {http://owncloud.org/ns}principal ?
  • {http://owncloud.org/ns}owner-principal to identify the principal for the calendar owner
  • {http://owncloud.org/ns}owner-displayname to identify the the calendar owner's display name
  • {http://owncloud.org/ns}group-share if the share is a group share ?
  • {http://owncloud.org/ns}share-types the type of shares (see OCP\Share\IShare)
Share invitations
  • {http://owncloud.org/ns}invite to list invitations
    • {http://owncloud.org/ns}organizer to identify the event organizer
      • {http://owncloud.org/ns}common-name
      • {http://owncloud.org/ns}first-name
      • {http://owncloud.org/ns}last-name
    • {http://owncloud.org/ns}user to identify the event organizer
      • {http://owncloud.org/ns}common-name
      • {http://owncloud.org/ns}summary
      • {http://owncloud.org/ns}invite-accepted
      • {http://owncloud.org/ns}access
        • {http://owncloud.org/ns}read
        • {http://owncloud.org/ns}read-write
List sharees
  • {http://nextcloud.org/ns}sharees gives a list of
    • {http://nextcloud.com/ns}sharee a sharee with the following children properties
      • {http://nextcloud.com/ns}id
      • {http://nextcloud.com/ns}display-name
      • {http://nextcloud.com/ns}type
Manage shares
  • {http://owncloud.org/ns}share for sharing
    • {http://owncloud.org/ns}set sharees to add
    • {http://owncloud.org/ns}remove sharees to remove
    • Sharee representation
      • {http://owncloud.org/ns}read-write if the share is read-only
      • {http://owncloud.org/ns}summary a comment on the share
      • {http://owncloud.org/ns}common-name a common name for the sharee (maps to {DAV:}displayname)

Search

  • {http://nextcloud.com/ns}calendar-search for CalDAV search, as well as the following prop filters
    • {http://nextcloud.com/ns}comp-filter
    • {http://nextcloud.com/ns}prop-filter
    • {http://nextcloud.com/ns}param-filter
    • {http://nextcloud.com/ns}search-term
    • {http://nextcloud.com/ns}limit
    • {http://nextcloud.com/ns}offset

Birthday calendar

  • {http://nextcloud.com/ns}enable-birthday-calendar for birthday calendars

Subscriptions

  • {http://nextcloud.com/ns}refresh-interval for the subscriptions refresh-interval
    Should be replaced DAV:subscription-suggested-refresh-interval in the long-term. See the draft-ietf-calext-serverside-subscriptions draft.

Calendar trashbin

  • {http://nextcloud.com/ns}deleted-at for deleted calendars in the trashbin
  • {http://nextcloud.com/ns}trash-bin to identify the trashbin collection

Nextcloud-specific iCalendar properties

Birthday calendar

  • X-NEXTCLOUD-BC-FIELD-TYPE on a birthday calendar event, one of BDAY, DEATHDATE or ANNIVERSARY
  • X-NEXTCLOUD-BC-UNKNOWN-YEAR on a birthday calendar event, one of 1 or 0 if the birthday year is unknown (or before unix time)
  • X-NEXTCLOUD-BC-YEAR on a birthday calendar event, the birthday year if we had X-APPLE-OMIT-YEAR in the vcard data
Clone this wiki locally