Wiki source code of User Management

Last modified by Manuel Leduc on 2022/05/23

Hide last authors
Silvia Macovei 52.3 1 {{box cssClass="floatinginfobox" title="**Contents**"}}
2 {{toc/}}
3 {{/box}}
Silvia Macovei 44.1 4
5 {{info}}
Ecaterina Moraru (Valica) 70.1 6 * These instructions assume you're using XWiki 1.2 or later with the **[[Albatross, Toucan or Colibri skins>>Documentation.AdminGuide.Skins]]** (screenshots for Colibri).
Manuel Smeria 52.5 7 * The default skin is currently Colibri.
Silvia Macovei 44.1 8 {{/info}}
Vincent Massol 50.3 9
Silvia Macovei 44.2 10 = Adding users to your wiki =
JanEldenmalm 1.1 11
Manuel Smeria 52.5 12 1. Log in as an administrator
13 1. Hover over "Wiki" and click on "Administer Wiki"
14 1. Click on the "Users" link to bring up an overview of all the users
15 1. Click on the "Add new user" button to open a registration page as shown on the image below
16 1. Fill in the user information
Dmitry Bakbardin 56.1 17 1. Click "Save":(((
Silvia Macovei 52.4 18 {{image reference="AddUser.png"/}}
Manuel Smeria 52.5 19 )))
DavidSowerby 48.1 20
Silvia Macovei 44.2 21 = Changing a user's password =
EvelinaSlatineanu 34.1 22
Silvia Macovei 44.2 23 == Changing the password for any user ==
Vincent Massol 35.1 24
Manuel Smeria 52.5 25 1. Log in as an administrator
26 1. Hover over "Wiki" and click on "Administer Wiki"
27 1. Click on the "Users" link to bring up an overview of all the users
28 1. Click on the name of the user for which you want to change the password (this will take you to the user's profile page)
29 1. Click on the "Preferences" tab
30 1. Click on the "Change Password" button
31 1. Enter the new password twice
Dmitry Bakbardin 56.1 32 1. Click on the "Update" button(((
Silvia Macovei 52.4 33 {{image reference="ChangePassword.png"/}}
Vincent Massol 57.1 34
Manuel Smeria 52.5 35 {{warning}}
36 Don't forget to notify the user!
37 {{/warning}}
38 )))
Silvia Macovei 52.3 39
Silvia Macovei 44.2 40 == Changing the password for the logged in user ==
JanEldenmalm 1.23 41
Manuel Smeria 52.5 42 To change **your own password** follow these steps:
Silvia Macovei 44.1 43
Manuel Smeria 52.5 44 1. Click on your user name in the top right corner of the screen (this will redirect you to your profile)
45 1. Click on the "Preferences" tab
46 1. Click on the "Change password" button
Thomas Delafosse 60.1 47 1. Enter your current password (only needed since XWiki 5.1) and the new password twice
48 1. Click on the "Save" button(((
Thomas Delafosse 58.1 49 {{image reference="ChangeOwnPassword.png"/}}
Manuel Smeria 52.5 50 )))
EvelinaSlatineanu 32.1 51
Simon Urli 83.1 52 == Changing the password security policy ==
Simon Urli 81.1 53
Alex Cotiugă 83.3 54 {{info}}XWiki 11.9{{/info}} You can define the password security for all the users of the wiki. The policy is defined by some rules available in the Administration > Users & Rights > Registration page. You can specify the minimum length of the password, and if it must contain numbers, lower/upper case characters, and symbol.
Simon Urli 81.1 55
56 {{image reference="password-policy-fields.png"/}}
57
Vincent Massol 83.2 58 Please note that when the rules are changed, all further password changes must comply with the new rules, but the older password are still all valid.
Simon Urli 81.1 59
Silvia Macovei 44.2 60 = Editing an existing user =
JanEldenmalm 1.14 61
Manuel Smeria 52.5 62 1. Log in as an administrator
63 1. Hover over "Wiki" and click on "Administer Wiki"
64 1. Click on the "Users" link to bring up an overview of all the users
Manuel Leduc 90.1 65 1. You have two options:
Manuel Smeria 52.5 66 11. Click the user name for the user you want to edit
67 11*. On the user's profile page click on the small yellow pencil corresponding to the information you want to edit (profile or preferences)
68 11*. Click "Save and View" to save the changes you have made
69 11. Click on the small yellow pencil near the user you want to edit (this will open up a lightbox with the main information of that user)
Dmitry Bakbardin 56.1 70 11*. Make your modifications and click "Save"(((
Manuel Smeria 52.5 71 {{info}}
72 There is also a link to the complete user profile, where you can proceed as above (first option).
73 {{/info}}
Vincent Massol 57.1 74
Silvia Macovei 74.1 75 {{image reference="EditUserProfile.png" width="580px"/}}
Manuel Smeria 52.5 76 )))
EvelinaSlatineanu 30.1 77
Manuel Leduc 86.1 78 = Disabling a user =
79
Manuel Leduc 90.1 80 == From the administration ==
Manuel Leduc 86.1 81
Manuel Leduc 90.1 82 [[image:user_administration_disable_account.png||height="271" width="960"]]
Manuel Leduc 86.1 83
84 1. Log in as an administrator
Manuel Leduc 90.1 85 1. Go to the User section of the Wiki administration
86 1. Click on the closed lock to disable a user
Manuel Leduc 86.1 87
88 To enable a user, follow the same steps but click on the opened lock.
89
90 == From a user profile ==
91
Manuel Leduc 90.1 92 [[image:user_profile_enabled_account.png||height="415" width="960"]]
Manuel Leduc 86.1 93
94 1. Login an an administrator
Manuel Leduc 90.1 95 1. Visit a user profile
96 1. Click on the "Disable this account" action.
Manuel Leduc 86.1 97
Manuel Leduc 90.1 98 [[image:user_profile_disabled_account.png||height="387" width="960"]]
Manuel Leduc 86.1 99
100 To enable a user, follow the same step but click on the "Enable this account" action.
101
Silvia Macovei 44.2 102 = Deleting a user =
JanEldenmalm 1.25 103
Manuel Smeria 52.5 104 1. Log in as an administrator
Manuel Leduc 86.1 105 1. Go to the User section of the Wiki administration
Dmitry Bakbardin 56.1 106 1. Delete the user by clicking the red "X" corresponding to the user you want to delete (the user will be automatically removed from all the groups it belonged to)(((
Silvia Macovei 44.1 107 {{info}}
Manuel Leduc 90.1 108 You won't be able to delete the currently logged in user and you'll need to log-in using other credentials. This is done in order to prevent mistakes.
Silvia Macovei 44.1 109 {{/info}}
Vincent Massol 57.1 110
Manuel Leduc 90.1 111 [[image:user_administration_disable_account.png||height="271" width="960"]]
Manuel Smeria 52.5 112 )))
EvelinaSlatineanu 31.1 113
AdrianFita 51.1 114 = Modify the number of users displayed in the list =
Silvia Macovei 52.3 115
AdrianFita 51.1 116 This is valid as of v3.5 (I think it works on any 3.x version).
117
Manuel Smeria 52.5 118 You have to edit ##XWiki.AdminUsersSheet## for users. The page contains a line like this:
AdrianFita 51.1 119
120 {{code}}
121 var ta = new XWiki.widgets.LiveTable("$url", "userstable", callback);
122 {{/code}}
123
Manuel Smeria 52.5 124 Replace it with:
AdrianFita 51.1 125
126 {{code}}
127 var ta = new XWiki.widgets.LiveTable("$url", "userstable", callback, {limit: 100});
128 {{/code}}
129
130 where 100 is the number of items displayed per page.
131
Silvia Macovei 44.2 132 = Customizing the Registration page =
133
Silvia Macovei 44.1 134 {{info}}
Manuel Smeria 52.5 135 Since [[XWiki Exterprise 2.2M2>>xwiki:ReleaseNotes.ReleaseNotesXWikiEnterprise22M2#HNewRegistrationpage]] customizing the registration page is done by the "Verified Registration" Page, part of the [[Administration Application>>extensions:Extension.Administration Application]]. This provides more features such as captcha and client side validation of user input. For more information about how to configure it, visit the [[application page>>extensions:Extension.Administration Application]].
Silvia Macovei 44.1 136 {{/info}}
Caleb James DeLisle 43.1 137
Manuel Smeria 52.5 138 In order to customize the registration page you must follow these steps:
Silvia Macovei 44.1 139
Manuel Smeria 52.5 140 1. Log in as an administrator
Silvia Macovei 71.1 141 1. Click on the right drawer icon, then click on "Administer Wiki"
142 1. Go to "Users & Rights" > "Registration"
Dmitry Bakbardin 56.1 143 1. Make your modifications and click "Save":(((
Silvia Macovei 74.1 144 {{image reference="Registration.png" width="960px"/}}
Manuel Smeria 52.5 145 )))
Dmitry Bakbardin 56.1 146
147 {{error}}
148 Be sure to fill in admin's e-mail in Administration -> Configuration -> Email. Otherwise XWiki prior 4.5 won't send verification e-mails while E-mail verification is on.
149 {{/error}}
Simon Urli 75.1 150
Simon Urli 76.1 151 = Enable/Disable User Account =
152
153 Starting with {{code}}XWiki 11.6RC1{{/code}} it is now possible to disable a user account and to enable it back from his/her profile.
154 A disabled user is able to login but cannot perform any action once logged-in.
155
156 {{gallery}}
Simon Urli 80.1 157 image:disable-account.png
158 image:enable-account.png
159 image:account-disabled-warning.png
Simon Urli 76.1 160 {{/gallery}}
161
Simon Urli 75.1 162 = Inactive Users =
163
164 If you configured the registration page to enable the **Use Email Verification**, then new registered users are by default inactive. The user account is activated by a link on the email. (See more information in [[Administration Application>>extensions:Extension.Administration Application]]).
165
Manuel Leduc 90.1 166 Starting with {{code}}XWiki 11.6RC1{{/code}} the inactive users are prevented to get access to most pages of the wiki by default. The page they can get access to can be configured in the [[configuration>>Documentation.AdminGuide.Configuration#HAllowedPagesforInactiveUsers]].
Simon Urli 75.1 167
168 Prior from that, the **Authentication Active Check** must be checked in order for inactive users to get access to the wiki.

Get Connected