wilde: doc/raw-howtos web-calendar.txt,NONE,1.1

[cvs at kolab.org]

Author: wilde

Update of /kolabrepository/doc/raw-howtos
In directory doto:/tmp/cvs-serv25228

Added Files:
	web-calendar.txt 
Log Message:
Added mini doc for new anonymous web calendar.


--- NEW FILE: web-calendar.txt ---
------------------------------------------------------------------------
                   The anonymous Kolab Web Calendar
------------------------------------------------------------------------
Sascha Wilde <wilde at intevation.de>


Since 2009/10/09 the CVS kolab_2_2_branch contains a new feature,
allowing to integrate a view of dedicated calendars into third party
web sites.


Concept:

A dedicated "proxy" user is created and the id and password of this
user is made known to certain parts of the webclient.

The proxy user is granted read access to one or more calendar by
regular Kolab users.

A view of the events in these shared calendars is offered for
anonymous (read: no authorization required) integration in websites.


Usage:

1. Create an new user account e.g. "proxy at example.com" with password
   "secret".

2. In /kolab/etc/kolab/templates/webclient-kolab-conf.template the
   lines
     $conf['ics']['default_user'] = 'proxy@@@@postfix-mydomain@@@';
     $conf['ics']['default_pass'] = 'proxy';
   must be uncommented and filled with the correct credentials a
   chosen in 1.

3. Grant list/read access for some calendar folders to the user
   "proxy at example.com".

4. Add to any web-page following lines:
     <div id="calendar"></div>
     <script type="text/javascript"
       src="https://KOLABSERVER.example.com/client/kronolith/imple_kolab.php?imple=Embed/container=calendar/view=eventlist">
     </script>
   The <div> tag will be replaced by an view of all upcoming events in
   the calendars accessible for the proxy user.


Security considerations:

One should note, that the data from calendars shared to the proxy user
is freely, world wide readable unless the access to the Kolab
Webclient server is restricted by other means.