diff --git a/user_manual/pim/calendar.rst b/user_manual/pim/calendar.rst index 7272ee556..4ed3d9672 100644 --- a/user_manual/pim/calendar.rst +++ b/user_manual/pim/calendar.rst @@ -1,3 +1,141 @@ ====================== Using the calendar app ====================== + +.. note:: The calendar app is not enabled by default and needs to be installed + separately from our App Store. Please ask your Administrator for it. + +The Nextcloud Calendar app works similar to other calendar applications you can +sync your Nextcloud calendars and events with. + +When you first access the Calendar app, a default first calendar will be +pre-generated for you. + +.. figure:: images/calendar_application.png + +Managing your calendars +----------------------- + +Import a Calendar +~~~~~~~~~~~~~~~~~ + +If you want to transfer your calendar and their respective events to your Nextcloud +instance, importing is the best way to do so. + +.. figure:: images/calendar_settings.png + :scale: 50% + +1. Click on the settings-icon labeled with ``Settings & Import`` at the left-bottom. + +2. After clicking on ``+ Import Calendar`` you can select one or more calendar files + from your local device to upload. + +3. The upload can take some time and depends on how big the calendar you import + is. + +.. note:: The Nextcloud Calendar application only supports iCalendar-compatible + ``.ics``-files, defined in RFC 5545. + +Create a new Calendar +~~~~~~~~~~~~~~~~~~~~~ + +If you plan to setup a new calendar without transferring any old data from your +previous calendar, creating a new calendar is the way you should go. + +.. figure:: images/calendar_create.gif + +1. Click on ``+ New Calendar`` in the left sidebar. + +2. Type in a name for your new calendar, e.g. "Work", "Home" or "Studies". + +3. After clicking on the checkmark, your new calendar is created and can be + synced across your devices, filled with new events and shared with your friends + and colleagues. + +Edit, Download or Delete a Calendar +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +Sometimes you may want to change the color or the entire name of a previous +imported or created calendar. You may also want to export it to your local +hard drive or delete it forever. + +.. note:: Please keep in mind that deleting a calendar is a irreversible action. + After deletion, there is no way of restoring the calendar unless you + have a local backup. + +.. figure:: images/calendar_dropdown.png + :scale: 50% + +1. Click on the three-dot-menu of the respective calendar. + +.. figure:: images/calendar_editing.png + :scale: 50% + +2. Click on ``Edit``, ``Download`` or ``Delete``. + +Subscribe to a Calendar +~~~~~~~~~~~~~~~~~~~~~~~ + +You can subscribe to iCal calendars directly inside of your Nextcloud. By +supporting this interoperable standard (RFC 5545) we made Nextcloud calendar +compatible to Google Calendar, Apple iCloud and many other calendar-servers +you can exchange your calendars with. + +1. Click on ``+ New Subscription`` in the left sidebar. +2. Type in the link of the shared calendar you want to subscribe to. + +Finished. Your calendar subscriptions will be updated regularly. + +Managing Events +--------------- + +Create a new event +~~~~~~~~~~~~~~~~~~ + +Events can be created by clicking in the area when the event is scheduled. +In the day- and week-view of the calendar you just click, pull and left your +cursor over the area when the event is taking place. + +.. figure:: images/calendar_new-event_week.gif + +The month-view only requires a single click into the area of the specific day. + +.. figure:: images/calendar_new-event_month.gif + +After that, you can type in the events name (e.g. **Meeting with Lukas**), choose +the calendar in which you want to choose the event (e.g. **Personal**, **Work**) +check and concretize the time span or set the event as all-day event. + +If you want to edit advanced details such as the **Location**, a **Description**, +**Attendees**, **Reminders** or to set the event as a repeating-event click on +the ``More...``-button to open the advanced sidebar-editor. + +.. note:: If you always want to open the advanced sidebar-editor instead of the + simple event editor popup, you can set a ``Skip simple event + editor``-checkmark in the ``Settings & Import``-section of the app. + +Clicking on the blue ``Create``-button will finally create the event. + +Edit or Delete an event +~~~~~~~~~~~~~~~~~~~~~~~ + +If you want to edit or delete a specific event, you just need to click on it. +After that you will be able to re-set all of the events details and open the +advanced sidebar-editor by clicking on ``More...``. + +Clicking on the blue ``Update``-button will update the event. Clicking on the +``Cancel``-button will not save your edits. + +If you click on the red ``Delete``-button the event will be removed from your +calendar. + +Birthday calendar +----------------- + +The birthday calendar is a auto-generated calendar which will automatically +fetch the birthdays from your contacts. The only way to edit this calendar is by +filing your contacts with birthday dates. You can not directly edit this calendar +from the calendar-app. + +.. note:: If you do not see the birthday calendar, your Administrator may has + disabled this for your server. diff --git a/user_manual/pim/images/calendar_application.png b/user_manual/pim/images/calendar_application.png new file mode 100644 index 000000000..cb6e772fd Binary files /dev/null and b/user_manual/pim/images/calendar_application.png differ diff --git a/user_manual/pim/images/calendar_create.gif b/user_manual/pim/images/calendar_create.gif new file mode 100644 index 000000000..643335503 Binary files /dev/null and b/user_manual/pim/images/calendar_create.gif differ diff --git a/user_manual/pim/images/calendar_dropdown.png b/user_manual/pim/images/calendar_dropdown.png new file mode 100644 index 000000000..06bcb82e2 Binary files /dev/null and b/user_manual/pim/images/calendar_dropdown.png differ diff --git a/user_manual/pim/images/calendar_editing.png b/user_manual/pim/images/calendar_editing.png new file mode 100644 index 000000000..1da6f6cb4 Binary files /dev/null and b/user_manual/pim/images/calendar_editing.png differ diff --git a/user_manual/pim/images/calendar_new-event_month.gif b/user_manual/pim/images/calendar_new-event_month.gif new file mode 100644 index 000000000..7489b224b Binary files /dev/null and b/user_manual/pim/images/calendar_new-event_month.gif differ diff --git a/user_manual/pim/images/calendar_new-event_week.gif b/user_manual/pim/images/calendar_new-event_week.gif new file mode 100644 index 000000000..e12891280 Binary files /dev/null and b/user_manual/pim/images/calendar_new-event_week.gif differ diff --git a/user_manual/pim/images/calendar_settings.png b/user_manual/pim/images/calendar_settings.png new file mode 100644 index 000000000..6ef9b5273 Binary files /dev/null and b/user_manual/pim/images/calendar_settings.png differ