History: Users

• «
• »

            ! Users Management

!! General
Users management is done by the admin of the Tiki, or any other users in a group with the permission to admin users granted (__tiki_p_admin_users__). User A in a group with that permission will be able to raise permissions of other user B, up to the higher group within the group hierarchy within Tiki, but not higher than that. 

A common scenario of group hierarchy could be: "__Anonymous < Registered < Contributors < Editors < Admins__".

A user of the Editors group, when it has been granted that  __tiki_p_admin_users__ permission, will be able to raise users in the Registered to the groups Contributors and/or to Editors, but not to Admins.  

Users can either be added by the admin or they can register themselves from the homepage. When some users register themselves, they receive an email with a confirmation link. This concludes their registration.  They automatically become members of the default group "Registered"  and are entitled to all the rights that you have given to this group. For more information see the ((Groups Management|groups management page)).

!! Adding a new user
After you have installed the software and logged in as the admin you will see the ''Menu'' on the left side. One of the items is ''Admin''.

You can manage users of your Tiki through "__Admin (menu) > Users__" (''tiki-adminusers.php'').

Remember that to unfold the menu entries under one section you need to 
click on section name.

This Admin Users screen shows the form for adding a user, and a list of current users with their relevant information. The user administration screen allows admins to create and edit users. You can create new users (useful if users can't register themselves), remove users and assign groups to a particular user. You can find users by login name using the find button at the top of the listing (it will act as a filter).

{img src="display955" link="display955" width="500" rel="box[g]" imalign="center" desc="Click to expand" align="center" styleimage="border"}

Enter the name of a new user, that (s)he is going to use on your system, in the User field. Be sure to use only a combination of A..Z, a..z, 0-9. Other characters in the username may be problematic.

You can either create a password for the new user or have the system generate one for you by clicking on the Generate a password link. When you generate a password, copy it in both of the password fields. The repeat password field is there to make sure that you entered the password that you intended and to ensure that you can login with that password.

Fill in the email address and finish the registration with a click on the "__Add__" button.

The new user will receive an email that will ask for confirmation of the registration by clicking on a URL that is in the confirmation email. When the user clicks on the link (s)he is registered and automatically logged in. 

!! Adding new users in bulk
You can upload a list of users from a file. The file needs to be in a CSV format. 

{img src="display956" link="display956" width="500" rel="box[g]" imalign="center" desc="Click to expand" align="center" styleimage="border"}

The first line will contain the list of field names. The fields are login, password, email and groups. The next lines have a user per line.

^login,password,email,groups,default_group,realName
user1,pass1,email1,group1,group1,Real Name1
user2,pass2,email2,"group1,group2",group1,Real Name2^

Notes:
* Only login, password, email are mandatory. 
* Use an empty password for automatic password generation. 
* Use same login and email if the login use email. 
* Groups are separated by comma. 
* With group name with comma, double the comma.
* These groups must exist, unless you click at the checkbox to create the groups if they are missing.

Additional options in the feature to import users in bulk through csv file are:
|| Parameter | Description
Overwrite groups: |  Select this if you want the groups to be overwritten
Create groups:  | Select this if you want the new groups indicated in the csv file to be created
User must change password at first login:  | Select this if you want to force the user to change their passwords the first time that they log in to Tiki site
Send an email to the user in order to allow him to validate his account. | Select this if you want to require users to validate first their email account prior to their first login. 
||

!!! Example of CSV File

{CODE(colors="csv", ln="1", caption="Example of CSV File for Batch Upload")}
login,password,email,groups,default_group,realName
John Doe,passe,john@example.com,"Editors,Foo",Foo,John Doe Jr.
durant,passe,durant@example.com,Foo,Foo,Mary Durant
{CODE}
 
!! Adding a user to a group
Click the Key icon next to the user you want to assign a group to.

{img src="display957" link="display957" width="500" rel="box[g]" imalign="center" desc="Click to expand" align="center" styleimage="border"}

You will see a list of groups available below the User Information
Under action you can click what group you want to add this user to

{img src="display961" link="display961" width="500" rel="box[g]" imalign="center" desc="Click to expand" align="center" styleimage="border"}


!! Finding a user
In the user management module there is a field where you can enter the name of a user that you want to find. The name you enter doesn't need to be exactly like the name you want to find. It is for instance not case sensitive. To search on part of a name is also supported. Searching on 'an' finds all the users with 'an' somewhere in their username.  

Since ((Tiki12)) you can also use the Jquery Sortable Tables interface, which allows for a more interactive management of the users list.

{img src="display958" link="display958" width="700" rel="box[g]" imalign="center" desc="Click to expand" align="center" styleimage="border"}

You can enable it in "__Admin home > Features > Interface > jQuery plugins and add-ons > Experimental > jQuery Sortable Tables__".

You can find more information on the jQuery Sortable Tables here:
http://doc.tiki.org/jQuery#jQuery_Sortable_Tables

!!! Filters
Filters in this screen provide several ways to select just some users from the whole list:

{img src="display959" link="display959" width="400" rel="box[g]" imalign="center" desc="Click to expand" align="center" styleimage="border"}

!!! Actions on many users at once
You can do some actions at once on a multiple selection of users:

{img src="display960" link="display960" width="500" rel="box[g]" imalign="center" desc="Click to expand" align="center" styleimage="border"}

Admins can easily ((Banning|ban)) multiple IPs from spam registrations directly with just a few clicks. They can also optionally remove the user accunts and their user tracker items, as well as their user pages.

!! Deleting a user
To delete a user,  click on the red cross behind the users name. You are asked to confirm the deletion, go back to the user management module or return to the homepage. After confirmation the user is deleted.

!! Modifying existing user information
Click on the corresponding icons of the "__Actions__" column from the users list. This way you will be able to:
* Assign the user to groups, as explained above.
* Edit Account Settings
* Change User Preferences
* See More User Information
* Delete the User
 
!!! Groups management
See ((Groups Management))

-=related=-
*(related(Groups))
*(related(Permissions))

-=alias=-
*(alias(Users Management))
*(alias(User))