Developer Resources

Resources

• Building a CalDAV client
• jsical reference
• CalConnect resources list
• CalConnect glossary

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

• ✅ Internet Calendaring and Scheduling Core Object Specification (iCalendar) (RFC 5545) (previously RFC 2445)
• ✅ Calendaring Extensions to WebDAV (CalDAV) (RFC 4791)
• ✅ New Properties for iCalendar (RFC 7986)
• ✅ Parameter Value Encoding in iCalendar and vCard (RFC 6868)

Specific features

• ✅ iCalendar Transport-Independent Interoperability Protocol (iTIP) (RFC 5546)
• ✅ iCalendar Message-Based Interoperability Protocol (iMIP) (RFC 6047)
• ✅ CalDAV Scheduling (RFC 6638)
• ✅ Calendaring Extensions to WebDAV (CalDAV): Time Zones by Reference (RFC 7809)
• ✅ Calendar Availability (RFC 7953)

Recent RFCs

• ❌ Calendaring Extensions to WebDAV (CalDAV): Managed Attachments (RFC 8607)
• ❌ Event Publishing Extensions to iCalendar (RFC 9073)
• ❌ "VALARM" Extensions for iCalendar (RFC 9074)

Upcoming Drafts

• Support for iCalendar Relationships (draft-ietf-calext-ical-relations)
• Serverside Subscriptions (draft-ietf-calext-serverside-subscriptions)
• Support for Series in iCalendar (draft-ietf-calext-icalendar-series)
• Task Extensions to iCalendar (draft-apthorp-ical-tasks)
• JSCalendar: Converting from and to iCalendar (draft-ietf-calext-jscalendar-icalendar)
• Calendar subscription upgrades (draft-ietf-calext-subscription-upgrade)
• VPOLL: Consensus Scheduling Component for iCalendar (draft-ietf-calext-vpoll)

Non-standard

• ❌ CalDAV: Calendar User Notifications
• ✅ Shared and Published Calendars in CalDAV Support from Sabre is based on an old abandoned draft
• ✅ Calendar User Proxy Functionality in CalDAV
• Apple has some more non-standard extensions in https://github.com/apple/ccs-calendarserver/tree/master/doc/Extensions

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 ?

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.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