feat(adminmanual): Document system address book in 27

* Exposed for everyone now
* Property scopes
* Enumeration

Signed-off-by: Christoph Wurst <christoph@winzerhof-wurst.at>
This commit is contained in:
Christoph Wurst
2023-05-12 09:51:05 +02:00
parent c6a10eaf9f
commit 4de1a10310
3 changed files with 27 additions and 0 deletions

View File

@@ -1,3 +1,5 @@
.. _file-sharing-configuration:
============
File Sharing
============

View File

@@ -1,3 +1,5 @@
.. _profile:
=====================
Profile configuration
=====================
@@ -9,6 +11,8 @@ Personal info settings under the Personal settings section.
As an administrator you may change the default for new users and may also
disable profile globally to remove all profile functionality.
Profile properties are also written into the :ref:`system address book<system-address-book>`.
To enable or disable profile by default for new users switch the toggle in
Basic settings under the Administration settings section.
@@ -35,6 +39,8 @@ To disable profile globally add the following line to your ``config.php``
Please refer to :doc:`../configuration_server/config_sample_php_parameters` for
all available ``config.php`` options.
.. _profile-property-scopes:
Property scopes
---------------

View File

@@ -9,10 +9,29 @@ Nextcloud ships a CardDAV backend for users to store and share their address boo
System Address Book
-------------------
.. versionchanged:: 27
The system address book is now accessible to all Nextcloud users
Nextcloud maintains a read-only address book containing contact information of all users of the instance.
Disabled users are removed from this address book.
Privacy and User Property Scopes
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Contact information in the system address book is taken from users' :ref:`profile information<profile>`. Profile properties are only written to the system contact if the :ref:`scope<profile-property-scopes>` is set to *Local* or higher.
Users who set all their property scopes to *Private* are removed from the system address book and therefore not seen by other users.
:ref:`File sharing settings<file-sharing-configuration>` controls the enumeration of other users.
* If username autocompletion is not allowed, the system address book will only show user's own system contact but no other contacts.
* If username autocompletion is allowed, users will see contact cards for all other users.
* If autocompletion is limited to users within the same groups, users will see contact cards for other users in shared groups.
* If autocompletion is limited to matching phone numbers, the system address book will only show user's own system contact but no other contacts.
* If autocompletion is limited to users within the same groups **and** matching phone numbers, users will see contact cards for other users in shared groups.
Address Book Sync
^^^^^^^^^^^^^^^^^