Skip to content

Commit 3fa7510

Browse files
fix: move admin email change setting to User Config chapter
Also fixed some typos, grammar, etc. Signed-off-by: Josh <[email protected]>
1 parent f221805 commit 3fa7510

File tree

1 file changed

+64
-51
lines changed

1 file changed

+64
-51
lines changed

admin_manual/configuration_user/user_configuration.rst

Lines changed: 64 additions & 51 deletions
Original file line numberDiff line numberDiff line change
@@ -13,19 +13,19 @@ On the User management page of your Nextcloud Web UI you can:
1313
* View and set quotas
1414
* Create and edit their email addresses
1515
* Send an automatic email notification to new users
16-
* Disable and Enable users
16+
* Disable and enable users
1717
* Delete them with a single click
1818

1919
The default view displays basic information about your users.
2020

2121
.. figure:: ../images/user-config.png
2222

23-
The Group filters on the left sidebar lets you quickly filter users by their
24-
group memberships, and create new groups.
23+
The group filters on the left sidebar let you quickly filter users by their
24+
group memberships and create new groups.
2525

2626
.. figure:: ../images/user-config-groups.png
2727

28-
.. note: User counts for certain groups such as "All accounts" may not be
28+
.. note:: User counts for certain groups, such as "All accounts," may not be
2929
visible when using certain backends such as LDAP/AD/SAML.
3030

3131
Click the gear icon on the lower left sidebar to set a default storage quota,
@@ -38,37 +38,36 @@ Show user backend, Send email to new users,** and **Show email address**.
3838
User accounts have the following properties:
3939

4040
*Login Name (Username)*
41-
The unique ID of a Nextcloud user, and it cannot be changed.
41+
The unique ID of a Nextcloud user, which cannot be changed.
4242

4343
*Full Name*
4444
The user's display name that appears on file shares, the Nextcloud Web
45-
interface, and emails. Admins and users may change the Full Name anytime. If
46-
the Full Name is not set it defaults to the login name.
45+
interface, and emails. Admins and users may change the Full Name at any time. If
46+
the Full Name is not set, it defaults to the login name.
4747

4848
*Password*
49-
The admin sets the new user's first password. Both the user and the admin can
50-
change the user's password at anytime.
49+
The admin sets the new user's initial password. Both the user and the admin can
50+
change the user's password at any time.
5151

5252
*Email address*
5353
You can set an email address for a user.
54-
This address can be used when you first set-up an account
55-
so the user receive a mail asking them to create a password if none is provided.
56-
This address can be used for password reset request.
54+
This address can be used when you first set up an account
55+
so the user receives an email asking them to create a password if none is provided.
56+
This address can also be used for password reset requests.
5757

5858
*Groups*
59-
You may create groups, and assign group memberships to users. By default new
59+
You may create groups and assign group memberships to users. By default, new
6060
users are not assigned to any groups.
6161

6262
*Group Admin*
63-
Group admins are granted administrative privileges on specific groups, and
63+
Group admins are granted administrative privileges for specific groups and
6464
can create and remove users from their groups. This means they can modify the
65-
username, password, email, quota, etc. of members of the group. Group admins
65+
username, password, email, quota, etc., of members of the group. Group admins
6666
are not allowed to add existing users to their groups.
6767

68-
6968
*Quota*
70-
The maximum disk space assigned to each user. Any user that exceeds the quota
71-
cannot upload or sync data. You have the the option to include external
69+
The maximum disk space assigned to each user. Any user who exceeds the quota
70+
cannot upload or sync data. You have the option to include external
7271
storage in user quotas.
7372

7473
*Manager*
@@ -89,8 +88,8 @@ To create a user account:
8988
.. figure:: ../images/user-config-new-user.png
9089

9190
Login names may contain letters (a-z, A-Z), numbers (0-9), dashes (-),
92-
underscores (_), periods (.), spaces ( ) and at signs (@). After creating the user, you
93-
may fill in their **Full Name** if it is different than the login name, or
91+
underscores (_), periods (.), spaces ( ), and at signs (@). After creating the user, you
92+
may fill in their **Full Name** if it is different from the login name, or
9493
leave it for the user to complete.
9594

9695
If you have checked **Send email to new user** in the control panel on the
@@ -99,8 +98,8 @@ Nextcloud will automatically send them a notification with their new login
9998
information. You may edit this email using the email template editor on your
10099
Admin page (see :doc:`../configuration_server/email_configuration`).
101100

102-
Set the **Send email to new user**-checkbox allows you to leave the **Password**
103-
field empty. The user will get an activation-email to set their own password.
101+
Setting the **Send email to new user** checkbox allows you to leave the **Password**
102+
field empty. The user will get an activation email to set their own password.
104103

105104
Reset a user's password
106105
-----------------------
@@ -126,47 +125,45 @@ the display name of a user, but you cannot change the login name of any user.
126125
To set or change a user's display name:
127126

128127
* Hover your cursor over the user's **Full Name** field
129-
* Click on the **Pencil icon**
128+
* Click on the **pencil icon**
130129
* Enter the user's new display name
131130

132-
133131
Granting administrator privileges to a user
134132
-------------------------------------------
135133

136134
Nextcloud has two types of administrators: **Super Administrators** and **Group
137-
Administrators**. Group administrators have the rights to create, edit and
135+
Administrators**. Group administrators have the rights to create, edit, and
138136
delete users in their assigned groups. Group administrators cannot access
139-
system settings, or add or modify users in the groups that they are not **Group
140-
Administrators** for. Use the dropdown menus in the **Group Admin** column to
137+
system settings or add or modify users in groups for which they are not **Group
138+
Administrators**. Use the dropdown menus in the **Group Admin** column to
141139
assign group admin privileges.
142140

143141
.. figure:: ../images/user-config-group-admin.png
144142

145-
**Super Administrators** have full rights on your Nextcloud server, and can
143+
**Super Administrators** have full rights on your Nextcloud server and can
146144
access and modify all settings. To assign the **Super Administrators** role to
147145
a user, simply add them to the ``admin`` group.
148146

149-
150147
Managing groups
151148
---------------
152149

153-
You can assign new users to groups when you create them, and create new groups
150+
You can assign new users to groups when you create them and create new groups
154151
when you create new users. You may also use the **Add Group** button at the top
155152
of the left pane to create new groups. New group members will immediately
156153
have access to file shares that belong to their new groups.
157154

158-
Setting Storage quotas
155+
Setting storage quotas
159156
----------------------
160157

161-
Click the gear on the lower left pane to set a default storage quota. This is
158+
Click the gear icon on the lower left pane to set a default storage quota. This is
162159
automatically applied to new users. You may assign a different quota to any user
163160
by selecting from the **Quota** dropdown, selecting either a preset value or
164-
entering a custom value. When you create custom quotas, use the normal
165-
abbreviations for your storage values such as 500 MB, 5 GB, 5 TB, and so on.
161+
entering a custom value. When you create custom quotas, use the standard
162+
abbreviations for your storage values, such as 500 MB, 5 GB, 5 TB, and so on.
166163

167164
You now have a configurable option in ``config.php`` that controls whether
168-
external storage is counted against user's quotas. This is still
169-
experimental, and may not work as expected. The default is to not count
165+
external storage is counted against users' quotas. This is still
166+
experimental and may not work as expected. The default is to not count
170167
external storage as part of user storage quotas. If you prefer to include it,
171168
then change the default ``false`` to ``true``.
172169

@@ -178,7 +175,7 @@ then change the default ``false`` to ``true``.
178175
be calculable and will be **ignored**.
179176

180177
Metadata (such as thumbnails, temporary files, and encryption keys) takes up
181-
about 10% of disk space, but is not counted against user quotas. Users can check
178+
about 10% of disk space but is not counted against user quotas. Users can check
182179
their used and available space on their Personal pages. Only files that
183180
originate with users count against their quotas, and not files shared with them
184181
that originate from other users. For example, if you upload files to a
@@ -191,13 +188,13 @@ is calculated against the user's quota.
191188

192189
Deleted files that are still in the trash bin do not count against quotas. The
193190
trash bin is set at 50% of quota. Deleted file aging is set at 30 days. When
194-
deleted files exceed 50% of quota then the oldest files are removed until the
191+
deleted files exceed 50% of quota, the oldest files are removed until the
195192
total is below 50%.
196193

197-
When version control is enabled, the older file versions are not counted
194+
When version control is enabled, older file versions are not counted
198195
against quotas.
199196

200-
When a user creates a public share via URL, and allows uploads, any uploaded
197+
When a user creates a public share via URL and allows uploads, any uploaded
201198
files count against that user's quota.
202199

203200
Disable and enable users
@@ -206,22 +203,22 @@ Disable and enable users
206203
.. figure:: ../images/user-config-actions.png
207204

208205
Sometimes you may want to disable a user without permanently deleting their
209-
settings and files. The user can be activated any time again, without data-loss.
206+
settings and files. The user can be activated again at any time, without data loss.
210207

211-
Hover your cursor over their name on the **Users** page until the "..."-menu icon
208+
Hover your cursor over their name on the **Users** page until the "..." menu icon
212209
appears at the far right. After clicking on it, you will see the **Disable** option.
213210

214-
The user will not longer be able to access their Nextcloud until you enable them again.
215-
Also all external shares, via public link or email, will not be accessible.
216-
Internal shares will still be working, so that other users on Nextcloud can continue working.
211+
The user will no longer be able to access their Nextcloud until you enable them again.
212+
Also, all external shares, via public link or email, will not be accessible.
213+
Internal shares will still be working, so other users on Nextcloud can continue working.
217214

218215
If you wish for internal shares to be disabled as well when a user is disabled,
219216
activate the configuration option files_sharing:hide_disabled_user_shares::
220217

221218
occ config:app:set files_sharing hide_disabled_user_shares --value yes
222219

223-
You will find all disabled users in the **disabled**-section on the left pane.
224-
Enabling users is as easy as disabling them. Just click on the "..."-menu, and
220+
You will find all disabled users in the **disabled** section on the left pane.
221+
Enabling users is as easy as disabling them. Just click on the "..." menu, and
225222
select **Enable**.
226223

227224
Deleting users
@@ -230,15 +227,31 @@ Deleting users
230227
.. figure:: ../images/user-config-actions.png
231228

232229
Deleting a user is easy: hover your cursor over their name on the **Users** page
233-
until the "..."-menu icon appears at the far right. After clicking on it, you will
234-
see the **Delete** option. Clicking on it, deletes a user with all their data immediately.
230+
until the "..." menu icon appears at the far right. After clicking on it, you will
231+
see the **Delete** option. Clicking on it deletes a user with all their data immediately.
235232

236-
You'll see an undo button at the top of the page, which remains for some seconds.
237-
When the undo button is gone you cannot recover the deleted user.
233+
You'll see an undo button at the top of the page, which remains for a few seconds.
234+
When the undo button is gone, you cannot recover the deleted user.
238235

239236
All of the files owned by the user are deleted as well, including all files they
240237
have shared. If you need to preserve the user's files and shares, you must first
241238
download them from your Nextcloud Files page, which compresses them into a zip
242239
file, or use a sync client to copy them to your local computer. See
243240
:doc:`../configuration_files/file_sharing_configuration` to learn how to create
244241
persistent file shares that survive user deletions.
242+
243+
Disabling the "Your email address [...] was changed" email
244+
----------------------------------------------------------
245+
246+
If an email address of a user is changed by an admin, then it triggers an email
247+
to the user that states "Your email address on [URL] was changed by an
248+
administrator.". In some cases this should not be triggered, because it was a
249+
normal maintenance change. To disable this specific email the appconfig option
250+
``disable_email.email_address_changed_by_admin`` can be set to ``yes``::
251+
252+
occ config:app:set settings disable_activity.email_address_changed_by_admin --value yes
253+
254+
To disable this behaviour change it to any other value or delete the app config::
255+
256+
occ config:app:delete settings disable_activity.email_address_changed_by_admin
257+

0 commit comments

Comments
 (0)