# Calendaring introduction

Anyone can read calendars shared publicly at Example orga.

Your personal [[account]] grants read-only access to closed-group shared calendars.

Custom group accounts provide write access to (closed-group or public) shared calendars.


## Special strings

NB! This documentation uses special strings
which you may want to adapt for your local setup:

organisation: Example orga
eventhost: event.example.org


## Clients

Recommended calendaring client depends on the operating system you use:

  * Mac, iPhone and iPad: Apple Calendar
  * Windows and Linux: [Mozilla Lightning](https://www.mozilla.org/en-US/projects/calendar/)
  * Android: [DAVdroid](https://f-droid.org/app/at.bitfire.davdroid)
    and [ICSdroid](https://f-droid.org/app/at.bitfire.icsdroid)


## Read-only access

When you only need to read a calendar,
the best (most efficient) is to subscribe to an **iCal** calender:

 1. Copy address of relevant calendar from web page
    <http://event.example.org/>.
 2. Open calendaring client, and add new account profile of type "ical".
 3. Paste the calendar address as server address.

Closed-group calendars also require username and password,
and require a secure connection (TLS or SSL, or "https://" address).


## Read-write access

To both read a calendar and help maintain its content,
you need to setup a **CalDAV** profile:

 1. Open calendaring client, and add new account profile of type "CalDAV".
 2. Server address: **event.example.org:8443**
 3. Username and password: Either personal or calendar-group account credentials.

If above fails, or if you want to specifically pick a single calender,
use this alternative approach:

 1. Copy address of relevant calendar from web page
    **https://event.example.org:8443/calendars/users/USERNAME/**  
    (replace USERNAME with either personal or calendar-group account name)
 2. Open calendaring client, and add new account profile of type "CalDAV".
 3. Paste the calendar address as server address.


## FIXME

FIRST: open Calender -
Under Calendar>Preferences>Accounts find the old kpstaff calendar,
mark it and hit the - in the button to delete it,
It is not working anymore and can not be used.

THEN: set up the new one following the steps below.

Step 1:
Under Calendar>Preferences>Accounts create a new account by pressing the "+"
and select "Other CalDAV Account"

If it says 'AUTOMATIC' change it to \'91MANUAL\'92 in the top drop down menu.

Step 2:
Fill in the following:

Username: Your Username
Password: Your Password

URL: <https://event.homebase.dk/

press "add"

All team calendars + staff and room booking calendar should now pop up.
And we can all edit them (students cannot of course).

How to create an additional calendar?

Step 3: Press the "+" icon in the bottom left of the screen:
you now have a new calendar.
Name it what you want by double clicking on it and editing it.

This new Calendar is personal and is not shared to other,
but is synchronised between your own devices.

If you want let's say a new Team xx calendar to be read/write for all staff,
then create it and write <mailto:teknik@lists.homebase.dk>
and ask to make it available for all staff.

How do the students see the calendar(s)?

Go to <http://event.homebase.dk/>,
copy the URL to the calendar(s) they need,
and mail it to them,
then in Calendar,
by going to Calendar > Subscribe in the menu and pasting the URL
or just dobbelclik the link you send (works most of the time).
They still need to refresh to update
and any changes you make will take 10 minutes to go across.

For tech support, contact the teknik list.
<teknik@lists.homebase.dk>

Important: Never ever share passwords.
Not to technicians, not to police.
Never.