Initial Release of the calendar plugin

dav/README.md

@@ -0,0 +1,61 @@
+Calendar with CalDAV Support
+
+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
+
+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
+- Access to the events using CalDAV (using iPhone, Thunderbird Lightning etc., see below)
+- 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)
+
+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:
+- iOS (iPhone/iPodTouch) works
+- Thunderbird Lightning should work, not tested yet
+- Android: http://dmfs.org/caldav/ seems to work, not much tested yet, though
+
+Installation
+After activating, serveral tables in the database have to be created. The admin-interface of the plugin 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
+- Attendees / Collaboration
+
+
+
+Used libraries
+
+SabreDAV
+http://code.google.com/p/sabredav/
+New BSD License
+
+wdCalendar
+http://www.web-delicious.com/jquery-plugins/
+GNU Lesser General Public License
+
+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
+
+ColorPicker
+http://laktek.com/2008/10/27/really-simple-color-picker-in-jquery/
+MIT License
+
+