Skip to content

Commit

Permalink
Merge pull request #11370 from nextcloud/feat/admin/out-of-office
Browse files Browse the repository at this point in the history
feat(admin): document the new out-of-office feature
  • Loading branch information
st3iny authored Dec 7, 2023
2 parents 22284a1 + eae95d9 commit 32bcc30
Show file tree
Hide file tree
Showing 2 changed files with 38 additions and 1 deletion.
3 changes: 2 additions & 1 deletion admin_manual/groupware/index.rst
Original file line number Diff line number Diff line change
Expand Up @@ -8,4 +8,5 @@ Groupware

calendar
contacts
mail
mail
out_of_office
36 changes: 36 additions & 0 deletions admin_manual/groupware/out_of_office.rst
Original file line number Diff line number Diff line change
@@ -0,0 +1,36 @@
=====================
Out-of-office feature
=====================

.. versionadded:: 28.0.0

The out-of-office feature allows users to schedule an out-of-office period including a status and
message that is integrated with other apps such as Nextcloud Mail. Please refer to the user
documentation for more information about the feature itself. It may be disabled globally by admins.

The feature relies on users to configure their preferred calendar time zones correctly. However, if
a user does not configure their time zone, the default time zone of the server is used. It can be
configured by setting ``default_timezone`` in the `config.php` file of your Nextcloud server. The
configuration value accepts IANA identifiers like ``Europe/Berlin`` and defaults to ``UTC``. Please
refer to the `Nextcloud configuration` section for more information about the value.

To disable the out-of-office feature for all users the ``hide_absence_settings`` app configuration
value of the `dav` app has to be set to `yes`. This can be achieved by running the following
command on your server:

::

occ config:app:set --value=yes dav hide_absence_settings

.. note::

Out-of-office periods that were scheduled before the feature was disabled will not be deleted.
Disabling it will only hide the feature from the user interface. If the feature is enabled
again, the periods will be visible again.

Set the value for `hide_absence_settings` to `no` or delete the configuration option entirely to enable the feature again. The following
command can be used to do so:

::

occ config:app:set --value=no dav hide_absence_settings

0 comments on commit 32bcc30

Please sign in to comment.