From version < 52.4 >
edited by Silvia Macovei
on 2012/03/19
To version < 52.5 >
edited by Manuel Smeria
on 2012/12/14
< >
Change comment: Rewording, added a screenshot, removed references to the Toucan skin

Summary

Details

Page properties
Author
... ... @@ -1,1 +1,1 @@
1 -XWiki.SilviaRusu
1 +XWiki.ManuelSmeria
Content
... ... @@ -3,88 +3,102 @@
3 3  {{/box}}
4 4  
5 5  {{info}}
6 -These instructions assume you're using XWiki 1.2 or later with **[[Albatross, Toucan or Colibri skins>>AdminGuide.Skins]]** (screenshots for Colibri).
6 +* These instructions assume you're using XWiki 1.2 or later with the **[[Albatross, Toucan or Colibri skins>>AdminGuide.Skins]]** (screenshots for Colibri).
7 +* The default skin is currently Colibri.
7 7  {{/info}}
8 8  
9 -{{info}}
10 -Note: The default skin is currently Colibri.
11 -{{/info}}
12 -
13 13  = Adding users to your wiki =
14 14  
15 -1. Log in as an administrator.
16 -1. Go to the administration page. (Colibri: Select **##Wiki/Administer Wiki##** from top left of screen) (Toucan: Select **##Administration##** link in the top right corner of the screen)
17 -1. Click on the **##Users##** icon to bring up an overview of all users.
18 -1. Click on **##Add new user##** button to open a registration page as shown on the image below.
19 -1. Complete the user information and press the **##Save##** button.
20 -
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
17 +1. Click "Save":
18 +(((
21 21  {{image reference="AddUser.png"/}}
20 +)))
22 22  
23 23  = Changing a user's password =
24 24  
25 25  == Changing the password for any user ==
26 26  
27 -1. Log in as an administrator.
28 -1. Go to the administration page. (Colibri: Select **##Wiki/Administer Wiki##** from top left of screen) (Toucan: Select **##Administration##** link in the top right corner of the screen)
29 -1. Click on the **##Users##** icon to bring up an overview of all users.
30 -1. Click on the name for the user for which to change the password. This lead you to the user's page.
31 -1. Go to my Preferences tab and click Change Password button.
32 -1. Modify the password and click the **##Update##** button to save your change. Don't forget to tell the user!
33 -
26 +1. Log in as an administrator
27 +1. Hover over "Wiki" and click on "Administer Wiki"
28 +1. Click on the "Users" link to bring up an overview of all the users
29 +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)
30 +1. Click on the "Preferences" tab
31 +1. Click on the "Change Password" button
32 +1. Enter the new password twice
33 +1. Click on the "Update" button
34 +(((
34 34  {{image reference="ChangePassword.png"/}}
36 +)))
37 +(((
38 +{{warning}}
39 +Don't forget to notify the user!
40 +{{/warning}}
41 +)))
35 35  
36 36  == Changing the password for the logged in user ==
37 37  
38 -To change **your own password**:
45 +To change **your own password** follow these steps:
39 39  
40 -1. Click on your user name in the top right corner of the screen. This will redirect you to your profile.
41 -1. Click on the Preferences tab and the click on **##Change password##** button.
42 -1. Modify the password and click the **##Update##** button to save your change.
43 -
47 +1. Click on your user name in the top right corner of the screen (this will redirect you to your profile)
48 +1. Click on the "Preferences" tab
49 +1. Click on the "Change password" button
50 +1. Enter the new password twice
51 +1. Click on the "Update" button
52 +(((
44 44  {{image reference="ChangePassword.png"/}}
54 +)))
45 45  
46 46  = Editing an existing user =
47 47  
48 -1. Log in as an administrator.
49 -1. Go to the administration page. (Colibri: Select **##Wiki/Administer Wiki##** from top left of screen) (Toucan: Select **##Administration##** link in the top right corner of the screen)
50 -1. Click on the **##Users##** icon to bring up an overview of all users.
58 +1. Log in as an administrator
59 +1. Hover over "Wiki" and click on "Administer Wiki"
60 +1. Click on the "Users" link to bring up an overview of all the users
51 51  1. You have two options:
52 -11. Click the user name for the user to edit.
53 -11*. On the user's page click **##on the button corresponding to the information you want to edit (info, password, etc)##**. This will open a page editing view containing the attributes than can be changed.
54 -11*. Click "**##Save and View##**" - to save the changes you have made.
55 -11. Click on the pencil icon near the user you want to edit.
56 -11*. This will open up a lightbox with the main information of that user, which you can edit in place.
57 -11*. After your modifications press ##**Save**## to be redirected to the **Users** view.
58 -11*. There is also a link to the complete user profile, where you can proceed as above (first option).
59 -
62 +11. Click the user name for the user you want to edit
63 +11*. On the user's profile page click on the small yellow pencil corresponding to the information you want to edit (profile or preferences)
64 +11*. Click "Save and View" to save the changes you have made
65 +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)
66 +11*. Make your modifications and click "Save"
67 +(((
68 +{{info}}
69 +There is also a link to the complete user profile, where you can proceed as above (first option).
70 +{{/info}}
71 +)))
72 +(((
60 60  {{image reference="EditUserProfile.png"/}}
74 +)))
61 61  
62 62  = Deleting a user =
63 63  
64 -1. Log in as an administrator.
65 -1. Go to the administration page. (Colibri: Select **##Wiki/Administer Wiki##** from top left of screen) (Toucan: Select **##Administration##** link in the top right corner of the screen)
66 -1. Click on the **##Users##** icon to bring up an overview of all users.
67 -1. Delete the user by using the **##X##** button for the user to delete. The user will automatically be removed from all the groups it belonged to.
68 -
78 +1. Log in as an administrator
79 +1. Hover over "Wiki" and click on "Administer Wiki"
80 +1. Click on the "Users" link to bring up an overview of all the users
81 +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)
82 +(((
69 69  {{info}}
70 -You won't be able to delete the currently logged in user and you'll need to log using other credentials. This is to prevent mistakes...
84 +You won't be able to delete the currently logged in user and you'll need to log-in using other credentials. This is don in order to prevent mistakes.
71 71  {{/info}}
72 -
86 +)))
87 +(((
73 73  {{image reference="DeleteUser.png"/}}
89 +)))
74 74  
75 75  = Modify the number of users displayed in the list =
76 76  
77 77  This is valid as of v3.5 (I think it works on any 3.x version).
78 78  
79 -You have to edit XWiki.AdminUsersSheet for users.
95 +You have to edit ##XWiki.AdminUsersSheet## for users. The page contains a line like this:
80 80  
81 -The page contains a line like this:
82 -
83 83  {{code}}
84 84  var ta = new XWiki.widgets.LiveTable("$url", "userstable", callback);
85 85  {{/code}}
86 86  
87 -Just replace it with:
101 +Replace it with:
88 88  
89 89  {{code}}
90 90  var ta = new XWiki.widgets.LiveTable("$url", "userstable", callback, {limit: 100});
... ... @@ -94,18 +94,16 @@
94 94  
95 95  = Customizing the Registration page =
96 96  
97 -You can also customize the way users are registered in your XWiki by creating a ##XWiki.Registration## page which will override the default registration page.
98 -
99 99  {{info}}
100 -Since 2.2M2 this 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.
112 +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]].
101 101  {{/info}}
102 102  
103 -If you don't know what to put in the page you can start by copying the content of ##http://yourserver/xwiki/templates/registerinline.vm ## and paste it in your ##XWiki.Registration## page. You'll have to be careful to remove the first test in the template or your registration page will loop forever:
115 +In order to customize the registration page you must follow these steps:
104 104  
105 -{{code language="none"}}
106 -#if(!$xwiki.hasAccessLevel("view","XWiki.Registration")||$xwiki.getDocument("XWiki.Registration").isNew())
107 -[...] ## here is the code you want to keep
108 -#else
109 -$xwiki.getDocument("XWiki.Registration").getTranslatedDocument().getRenderedContent()
110 -#end
111 -{{/code}}
117 +1. Log in as an administrator
118 +1. Hover over "Wiki" and click on "Administer Wiki"
119 +1. Click on the "Registration" link
120 +1. Make your modifications and click "Save":
121 +(((
122 +{{image reference="Registration.png"/}}
123 +)))

These instructions assume you're using XWiki 1.2 or later with Albatross, Toucan or Colibri skins (screenshots for Colibri).

Note: The default skin is currently Colibri.

Adding users to your wiki

  1. Log in as an administrator.
  2. Log in as an administrator
  3. Go to the administration page.  (Colibri: Select Wiki/Administer Wiki from top left of screen) (Toucan:  Select Administration link in the top right corner of the screen)
  4. Hover over "Wiki" and click on "Administer Wiki"
  5. Click on the Users icon to bring up an overview of all users.
  6. Click on the "Users" link to bring up an overview of all the users
  7. Click on Add new user button to open a registration page as shown on the image below.
  8. Click on the "Add new user" button to open a registration page as shown on the image below
  9. Complete the user information and press the Save button.
  10. Fill in the user information 
  11. Click "Save":

    AddUser.png

AddUser.png

Changing a user's password

Changing the password for any user

  1. Log in as an administrator.
  2. Log in as an administrator
  3. Go to the administration page.  (Colibri: Select Wiki/Administer Wiki from top left of screen) (Toucan:  Select Administration link in the top right corner of the screen)
  4. Hover over "Wiki" and click on "Administer Wiki"
  5. Click on the Users icon to bring up an overview of all users.
  6. Click on the "Users" link to bring up an overview of all the users
  7. Click on the name for the user for which to change the password. This lead you to the user's page.
  8. 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)
  9. Click on the "Preferences" tab
  10. Go to my Preferences tab and click Change Password button.
  11. Click on the "Change Password" button
  12. Enter the new password twice
  13. Modify the password and click the Update button to save your change. Don't forget to tell the user!
  14. Click on the "Update" button

    ChangePassword.png

    Don't forget to notify the user!

ChangePassword.png

Changing the password for the logged in user

To change your own password:

To change your own password follow these steps:

  1. Click on your user name in the top right corner of the screen. This will redirect you to your profile. 
  2. Click on your user name in the top right corner of the screen (this will redirect you to your profile) 
  3. Click on the "Preferences" tab 
  4. Click on the Preferences tab and the click on Change password button.
  5. Click on the "Change password" button
  6. Modify the password and click the Update button to save your change.
  7. Enter the new password twice
  8. Click on the "Update" button

    ChangePassword.png

ChangePassword.png

Editing an existing user

  1. Log in as an administrator.
  2. Log in as an administrator
  3. Go to the administration page.  (Colibri: Select Wiki/Administer Wiki from top left of screen) (Toucan:  Select Administration link in the top right corner of the screen)
  4. Hover over "Wiki" and click on "Administer Wiki"
  5. Click on the Users icon to bring up an overview of all users.
  6. Click on the "Users" link to bring up an overview of all the users
  7. You have two options:
    1. Click the user name for the user to edit.
      • On the user's page click on the button corresponding to the information you want to edit (info, password, etc). This will open a page editing view containing the attributes than can be changed.
      • Click "Save and View" - to save the changes you have made.
    2. Click the user name for the user you want to edit
      • On the user's profile page click on the small yellow pencil corresponding to the information you want to edit (profile or preferences)
      • Click "Save and View" to save the changes you have made
    3. Click on the pencil icon near the user you want to edit.
      • This will open up a lightbox with the main information of that user, which you can edit in place.
      • After your modifications press Save to be redirected to the Users view.
      • There is also a link to the complete user profile, where you can proceed as above (first option).
    4. 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)
      • Make your modifications and click "Save"

        There is also a link to the complete user profile, where you can proceed as above (first option).

        EditUserProfile.png

EditUserProfile.png

Deleting a user

  1. Log in as an administrator.
  2. Go to the administration page.  (Colibri: Select Wiki/Administer Wiki from top left of screen) (Toucan:  Select Administration link in the top right corner of the screen)
  3. Click on the Users icon to bring up an overview of all users.
  4. Delete the user by using the X button for the user to delete. The user will automatically be removed from all the groups it belonged to.

You won't be able to delete the currently logged in user and you'll need to log using other credentials. This is to prevent mistakes...

DeleteUser.png

  1. Log in as an administrator
  2. Hover over "Wiki" and click on "Administer Wiki"
  3. Click on the "Users" link to bring up an overview of all the users
  4. 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)

    You won't be able to delete the currently logged in user and you'll need to log-in using other credentials. This is don in order to prevent mistakes.

    DeleteUser.png

Modify the number of users displayed in the list

This is valid as of v3.5 (I think it works on any 3.x version).

You have to edit XWiki.AdminUsersSheet for users.

You have to edit XWiki.AdminUsersSheet for users. The page contains a line like this:

The page contains a line like this:

var ta = new XWiki.widgets.LiveTable("$url", "userstable", callback);

Just replace it with:

Replace it with:

var ta = new XWiki.widgets.LiveTable("$url", "userstable", callback, {limit: 100});

where 100 is the number of items displayed per page.

Customizing the Registration page

You can also customize the way users are registered in your XWiki by creating a XWiki.Registration page which will override the default registration page. 

Since 2.2M2 this is done by the Verified Registration Page, part of the 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.

Since XWiki Exterprise 2.2M2 customizing the registration page is done by the "Verified Registration" Page, part of the 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.

If you don't know what to put in the page you can start by copying the content of http://yourserver/xwiki/templates/registerinline.vm  and paste it in your XWiki.Registration page. You'll have to be careful to remove the first test in the template or your registration page will loop forever:

#if(!$xwiki.hasAccessLevel("view","XWiki.Registration")||$xwiki.getDocument("XWiki.Registration").isNew())
[...] ## here is the code you want to keep
#else
$xwiki.getDocument("XWiki.Registration").getTranslatedDocument().getRenderedContent()
#end

In order to customize the registration page you must follow these steps:

  1. Log in as an administrator
  2. Hover over "Wiki" and click on "Administer Wiki"
  3. Click on the "Registration" link
  4. Make your modifications and click "Save":