X-Git-Url: https://git.mxchange.org/?a=blobdiff_plain;f=dav%2FREADME.md;h=b86d47fc8e2b44532c74b08b3597086f9fe3f574;hb=HEAD;hp=bab0a1dda29dd38f8966f876452b8ecb0d710e73;hpb=ecb88c93f0403854858ef16ec0bb0ae52b73dd4f;p=friendica-addons.git diff --git a/dav/README.md b/dav/README.md index bab0a1dd..b86d47fc 100644 --- a/dav/README.md +++ b/dav/README.md @@ -1,4 +1,6 @@ -Calendar with CalDAV Support +# Calendar with CalDAV Support + +**THIS ADDON IS UNSUPPORTED** This is a rewrite of the calendar system used by the german social network [Animexx](http://www.animexx.de/). It's still in a very early stage, so expect major bugs. Please feel free to report any of them, by mail (cato@animexx.de) or Friendica: http://friendica.hoessl.eu/profile/cato @@ -6,33 +8,38 @@ It's still in a very early stage, so expect major bugs. Please feel free to repo At the moment, the calendar system supports the following features: - A web-based drag&drop interface for managing events - All-Day-Events, Multi-Day-Events, and time-based events +- Giving the subject, a description, a location and a color for the event (the color is not available through CalDAV, though) +- Recurrences (not the whole set of options given in the iCalendar spec, but the most important ones) +- Notification by e-mail. Multiple notifications can be set per event +- Multiple calendars per user - Access to the events using CalDAV (using iPhone, Thunderbird Lightning etc., see below) -- read-only access to the friendica-native events (also using CalDAV) +- Read-only access to the friendica-native events (also using CalDAV) - The friendica-contacts are made available using CardDAV (confirmed to work with iOS) -- Giving the subject, a description, a location and a color for the event (the color is not available through CalDAV, though) +- The events of a calendar can be exported as ICS file. ICS files can be imported into a calendar + -Internationalization: +## Internationalization: - At the moment, settings for the US and the german systems are selectable (regarding the date format and the first day of the week). More will be added on request. - The basic design of the system is aware of timezones; however this is not reflected in the UI yet. It currently assumes that the timezone set in the friendica-installation matches the user's local time and matches the local time set in the user's operating system. -CalDAV device compatibility: +## CalDAV device compatibility: - iOS (iPhone/iPodTouch) works -- Thunderbird Lightning should work, not tested yet -- Android: http://dmfs.org/caldav/ seems to work, not much tested yet, though +- Thunderbird Lightning works +- Android: + - aCal (http://andrew.mcmillan.net.nz/projects/aCal) works, available in F-Droid and Google Play + - CalDAV-Sync (http://dmfs.org/caldav/) works, non-free -Installation -After activating, serveral tables in the database have to be created. The admin-interface of the plugin will try to do this automatically. +## Installation +After activating, serveral tables in the database have to be created. The admin-interface of the addon will try to do this automatically. In case of errors, the SQL-statement to create the tables manually are shown in the admin-interface. -Functuality missing: (a.k.a. "Roadmap") -- Recurrence of events (this is only supported using the CalDAV-interface; recurring events saved using CalDAV will appear correctly multiple times in the web-based frontend; hovever those events will be read-only at the web-based frondend) -- Sharing events; all events are private at the moment, therefore this system is not yet a complete replacement for the friendica-native events +## Functuality missing: (a.k.a. "Roadmap") +- Sharing events; all events are private at the moment, therefore this system is not a complete replacement for the friendica-native events - Attendees / Collaboration - -Used libraries +## Used libraries SabreDAV http://code.google.com/p/sabredav/ @@ -46,10 +53,6 @@ jQueryUI http://jqueryui.com/ Dual-licenced: MIT and GPL licenses -iCalCreator -http://kigkonsult.se/iCalcreator/ -GNU Lesser General Public License - TimePicker http://www.texotela.co.uk/code/jquery/timepicker/ Dual-licenced: MIT and GPL licenses @@ -60,7 +63,7 @@ MIT License -Author of this plugin (the parts that are not part of the libraries above): +Author of this addon (the parts that are not part of the libraries above): Tobias Hößl http://friendica.hoessl.eu/profile/cato http://www.hoessl.eu/