From da8da265fdc04bbec101a157e0ac443fb9fbd600 Mon Sep 17 00:00:00 2001 From: Thomas Citharel Date: Thu, 26 Sep 2019 16:05:50 +0200 Subject: [PATCH] Add Groupware section Signed-off-by: Thomas Citharel --- .../configuration_server/occ_command.rst | 6 +++ admin_manual/contents.rst | 1 + admin_manual/groupware/calendar.rst | 48 +++++++++++++++++++ admin_manual/groupware/index.rst | 9 ++++ 4 files changed, 64 insertions(+) create mode 100644 admin_manual/groupware/calendar.rst create mode 100644 admin_manual/groupware/index.rst diff --git a/admin_manual/configuration_server/occ_command.rst b/admin_manual/configuration_server/occ_command.rst index d9f5ff374..dbf3cee19 100644 --- a/admin_manual/configuration_server/occ_command.rst +++ b/admin_manual/configuration_server/occ_command.rst @@ -451,6 +451,7 @@ A set of commands to create and manage addressbooks and calendars:: dav:list-calendars List all calendars of a user dav:move-calendar Move a calendar from an user to another dav:remove-invalid-shares Remove invalid dav shares + dav:send-event-reminders Sends event reminders dav:sync-birthday-calendar Synchronizes the birthday calendar dav:sync-system-addressbook Synchronizes users to the system addressbook @@ -483,6 +484,11 @@ This example will move calendar named personal from user dennis to user sabine:: ``dav:remove-invalid-shares`` will remove invalid shares created by a bug into the calendar app +``dav:send-event-reminders`` is a command that should be called regularly through a dedicated +cron job to send event reminder notifications. + +See :doc:`../groupware/calendar` for more information on how to use this command. + ``dav:sync-birthday-calendar`` adds all birthdays to your calendar from addressbooks shared with you. This example syncs to your calendar from user bernie:: diff --git a/admin_manual/contents.rst b/admin_manual/contents.rst index 5955b3b58..40247e8bd 100644 --- a/admin_manual/contents.rst +++ b/admin_manual/contents.rst @@ -14,6 +14,7 @@ Table of contents configuration_user/index configuration_files/index file_workflows/index + groupware/index configuration_database/index configuration_mimetypes/index maintenance/index diff --git a/admin_manual/groupware/calendar.rst b/admin_manual/groupware/calendar.rst new file mode 100644 index 000000000..1adfc96c0 --- /dev/null +++ b/admin_manual/groupware/calendar.rst @@ -0,0 +1,48 @@ +======== +Calendar +======== + +Invitations +----------- +Nextcloud can send invitations for event attendees if this option is activated. +Be sure to have configured the email server first so that the invitations go through. +See :doc:`../configuration_server/email_configuration`. + +Birthday calendar +----------------- +Contacts that have a birthday date filled are automatically added as events to a special Birthday calendar. +If you deactivate this option, all users will no longer have this calendar. + +When activating this option, users birthday calendars won't be available right away because they need to be generated +by a background task. See :doc:`../configuration_server/occ_command` section Dav commands. + +Reminder notifications +---------------------- +Since version 17, Nextcloud handles sending notifications for events. As this can be a expensive task, +depending on the number of events, reminders and event sharees and attendees that also needs to happen +often enough so that the notifications are send on time, you can use a dedicated occ command that should be run +more often than the standard cron system:: + + # crontab -u www-data -e + */5 * * * * php -f /var/www/nextcloud/occ dav:send-event-reminders + +See :doc:`../configuration_server/occ_command` section Dav commands. + +You'll also need to change the sending mode from ``background-job`` to ``occ``:: + + php occ config:app:set dav sendEventRemindersMode --value occ + +If you don't use this dedicated command, the reminders will just be send as soon as possible when the background +jobs run. + +Nextcloud currently handles two types of reminder notifications: Build-in Nextcloud notifications and +email notifications. For the emails to be send, you'll need a configured email server. +See :doc:`../configuration_server/email_configuration`. + +FreeBusy +-------- + +Nextcloud returns FreeBusy information. + +webcalAllowLocalAccess +---------------------- diff --git a/admin_manual/groupware/index.rst b/admin_manual/groupware/index.rst new file mode 100644 index 000000000..1670736e1 --- /dev/null +++ b/admin_manual/groupware/index.rst @@ -0,0 +1,9 @@ +=============== +Groupware +=============== + + +.. toctree:: + :maxdepth: 2 + + calendar \ No newline at end of file