Wiki source code of User Management
Last modified by Xavier Richard on 2025/05/09
Hide last authors
| author | version | line-number | content |
|---|---|---|---|
 |
52.3 | 1 | {{box cssClass="floatinginfobox" title="**Contents**"}} |
| 2 | {{toc/}} | ||
| 3 | {{/box}} | ||
| |
44.1 | 4 | |
 |
110.1 | 5 | {{toc depth="2"/}} |
| 6 | |||
| |
44.2 | 7 | = Adding users to your wiki = |
 |
1.1 | 8 | |
 |
52.5 | 9 | 1. Log in as an administrator |
| 10 | 1. Hover over "Wiki" and click on "Administer Wiki" | ||
| 11 | 1. Click on the "Users" link to bring up an overview of all the users | ||
| 12 | 1. Click on the "Add new user" button to open a registration page as shown on the image below | ||
| 13 | 1. Fill in the user information | ||
| |
56.1 | 14 | 1. Click "Save":((( |
| |
52.4 | 15 | {{image reference="AddUser.png"/}} |
| |
52.5 | 16 | ))) |
| |
48.1 | 17 | |
| |
44.2 | 18 | = Changing a user's password = |
| |
34.1 | 19 | |
| |
44.2 | 20 | == Changing the password for any user == |
 |
35.1 | 21 | |
| |
52.5 | 22 | 1. Log in as an administrator |
 |
106.1 | 23 | 1. Open the drawer and click on "User Index" |
| |
52.5 | 24 | 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) |
| 25 | 1. Click on the "Preferences" tab | ||
| 26 | 1. Click on the "Change Password" button | ||
| 27 | 1. Enter the new password twice | ||
| |
56.1 | 28 | 1. Click on the "Update" button((( |
| |
52.4 | 29 | {{image reference="ChangePassword.png"/}} |
| |
57.1 | 30 | |
| |
52.5 | 31 | {{warning}} |
| 32 | Don't forget to notify the user! | ||
| 33 | {{/warning}} | ||
| 34 | ))) | ||
| |
52.3 | 35 | |
| |
44.2 | 36 | == Changing the password for the logged in user == |
| |
1.23 | 37 | |
| |
92.2 | 38 | To change your own password follow these steps: |
| |
44.1 | 39 | |
| |
107.1 | 40 | 1. Click on your user avatar in the top right corner of the screen (this will redirect you to your profile) |
| |
52.5 | 41 | 1. Click on the "Preferences" tab |
| |
110.1 | 42 | 1. Click on the "Change password" button (on top of the column at right) |
| |
107.1 | 43 | 1. {{version since="5.1"}}Enter your current password{{/version}} |
| 44 | 1. Enter the new password twice | ||
| |
60.1 | 45 | 1. Click on the "Save" button((( |
| |
58.1 | 46 | {{image reference="ChangeOwnPassword.png"/}} |
| |
52.5 | 47 | ))) |
| |
32.1 | 48 | |
 |
83.1 | 49 | == Changing the password security policy == |
| |
81.1 | 50 | |
| |
92.2 | 51 | 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. |
| |
81.1 | 52 | |
| 53 | {{image reference="password-policy-fields.png"/}} | ||
| 54 | |||
| |
83.2 | 55 | 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. |
| |
81.1 | 56 | |
| |
44.2 | 57 | = Editing an existing user = |
| |
1.14 | 58 | |
| |
52.5 | 59 | 1. Log in as an administrator |
| 60 | 1. Hover over "Wiki" and click on "Administer Wiki" | ||
| 61 | 1. Click on the "Users" link to bring up an overview of all the users | ||
 |
90.1 | 62 | 1. You have two options: |
| |
52.5 | 63 | 11. Click the user name for the user you want to edit |
| 64 | 11*. On the user's profile page click on the small yellow pencil corresponding to the information you want to edit (profile or preferences) | ||
| 65 | 11*. Click "Save and View" to save the changes you have made | ||
| 66 | 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) | ||
| |
56.1 | 67 | 11*. Make your modifications and click "Save"((( |
| |
52.5 | 68 | {{info}} |
| 69 | There is also a link to the complete user profile, where you can proceed as above (first option). | ||
| 70 | {{/info}} | ||
| |
57.1 | 71 | |
| |
74.1 | 72 | {{image reference="EditUserProfile.png" width="580px"/}} |
| |
52.5 | 73 | ))) |
| |
30.1 | 74 | |
| |
44.2 | 75 | = Deleting a user = |
| |
1.25 | 76 | |
| |
52.5 | 77 | 1. Log in as an administrator |
| |
86.1 | 78 | 1. Go to the User section of the Wiki administration |
| |
56.1 | 79 | 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)((( |
| |
44.1 | 80 | {{info}} |
| |
90.1 | 81 | 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. |
| |
44.1 | 82 | {{/info}} |
| |
57.1 | 83 | |
| |
97.3 | 84 | [[image:user_administration_disable_account.png||width="960"]] |
| |
52.5 | 85 | ))) |
| |
31.1 | 86 | |
| |
51.1 | 87 | = Modify the number of users displayed in the list = |
| |
52.3 | 88 | |
| |
92.2 | 89 | Edit the ##XWiki.AdminUsersSheet## page. It contains a line like this: |
| |
51.1 | 90 | |
| 91 | {{code}} | ||
| 92 | var ta = new XWiki.widgets.LiveTable("$url", "userstable", callback); | ||
| 93 | {{/code}} | ||
| 94 | |||
| |
52.5 | 95 | Replace it with: |
| |
51.1 | 96 | |
| 97 | {{code}} | ||
| 98 | var ta = new XWiki.widgets.LiveTable("$url", "userstable", callback, {limit: 100}); | ||
| 99 | {{/code}} | ||
| 100 | |||
| |
92.2 | 101 | where ##100## is the number of items displayed per page. |
| |
51.1 | 102 | |
| |
44.2 | 103 | = Customizing the Registration page = |
| 104 | |||
| |
92.2 | 105 | 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]]. |
 |
43.1 | 106 | |
| |
52.5 | 107 | In order to customize the registration page you must follow these steps: |
| |
44.1 | 108 | |
| |
52.5 | 109 | 1. Log in as an administrator |
| |
71.1 | 110 | 1. Click on the right drawer icon, then click on "Administer Wiki" |
| 111 | 1. Go to "Users & Rights" > "Registration" | ||
| |
56.1 | 112 | 1. Make your modifications and click "Save":((( |
| |
74.1 | 113 | {{image reference="Registration.png" width="960px"/}} |
| |
52.5 | 114 | ))) |
| |
56.1 | 115 | |
| |
76.1 | 116 | = Enable/Disable User Account = |
| 117 | |||
| |
92.2 | 118 | It is possible to disable a user account and to enable it back from his/her profile. A disabled user is able to login but cannot perform any action once logged-in. |
| |
100.1 | 119 | [[image:account-disabled-warning.png||width="960"]] |
| |
76.1 | 120 | |
| |
100.1 | 121 | == From the administration == |
| |
76.1 | 122 | |
| |
100.1 | 123 | [[image:user_administration_disable_account.png||width="960"]] |
| 124 | |||
| 125 | 1. Log in as an administrator | ||
| 126 | 1. Go to the User section of the Wiki administration | ||
| 127 | 1. Click on the closed lock to disable a user | ||
| 128 | |||
| 129 | To enable a user, follow the same steps but click on the opened lock. | ||
| 130 | |||
| 131 | == From a user profile == | ||
| 132 | |||
| |
100.2 | 133 | [[image:disable-account.png||width="350"]] |
| |
100.1 | 134 | |
| 135 | 1. Login an an administrator | ||
| 136 | 1. Visit a user profile | ||
| 137 | 1. Click on the "Disable this account" action. | ||
| 138 | |||
| |
100.4 | 139 | [[image:enable-account.png||width="350"]] |
| |
100.1 | 140 | |
| 141 | To enable a user, follow the same step but click on the "Enable this account" action. | ||
| 142 | |||
| |
75.1 | 143 | = Inactive Users = |
| 144 | |||
| 145 | 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]]). | ||
| 146 | |||
| |
92.2 | 147 | Inactive users are prevented to get access to most pages of the wiki by default. The pages they can get access to can be configured in the [[configuration>>Documentation.AdminGuide.Configuration#HAllowedPagesforInactiveUsers]]. Prior to that, the ##Authentication Active Check## must be enabled in order for inactive users to get access to the wiki. |
| |
93.1 | 148 | |
| 149 | = User Storage = | ||
| 150 | |||
| 151 | Users are stored inside wiki pages containing an XObject of the ##XWiki.XWikiUsers## XClass. To see all the user metadata, you can navigate to the profile page of a user and edit it using the Object editor. |
