Joomla! Documentation™

Description

Provides an overview of the Users available on a Joomla site. The screen is used to find, add, edit and delete Users.

How to Access

• Click the Users button in the Control Panel.

• Select Users → Manage from the dropdown menu of the Administrator Panel.

Screenshot

Column Headers

In the table containing users these are the different columns as shown below. Click on the column heading to sort the list by that column's value.

• Checkbox. Check this box to select one or more users. To select all users, check the box in the column heading.
  Note: Many toolbar actions can work with multiple users.

• Name. The name of the user. You can open the user for editing by clicking on the Name.

• Add a Note. Create a Note for the user.
  • Display x note(s). Show the Note(s) for the user.

• Advanced Permissions Report. The Advanced Permissions Report allows you to map out the exact permissions for any given user across all extensions on your Joomla installation. See Debug Users for more information.

• Username. The name the user will log in as.

• Enabled. Whether or not the user is enabled.

• Activated. Whether or not the user is activated. Normally when a user registers from the Frontend, some type of activation is required. This is controlled by the New User Account Activation parameter in the Users Configuration → Component screen. See Users Options for more information.

• User Groups. The list of groups that the user belongs to. Note that a user may belong to more than one group.

• Email. The email address from the user is displayed here.

• Last Visit Date. Here you can see the date on which the user last logged in.

• Registration Date. The date the user was registered.

• ID. This is a unique identification number for this user assigned automatically by Joomla. It is used to identify the user internally, and you cannot change this number.

Column Filters

Above the column headers on the right, there are 2 dropdown input fields, Sort Table By: (preset to 'Name ascending') and a number (preset to '20') to display.

These column sorting input fields shows the current method of sorting applied to the table. Use the dropdown field choices and click the column heading name. Alternatively, click on the column heading to sort the list by that column's value.

This will also change the value in the drop field to correspond with the column header name. The list will then be sorted in order by that column and a sort icon (up or down arrow) will show next to the column name. Click a second time to reverse the sort, which will change the corresponding drop field.

• Name ascending (default). Shows ordering of selected column, ascending or descending.

• Number of users to display. Shows the number of users to display on one page, default is 20 users. If there are more users than this number, you can use the page navigation buttons to navigate between pages.

List Filters

The List Filters are a series of controls that let you limit what users show in the screen. More than one filter may be entered. In this case, only users that meet all of the filter conditions will show on the list.

Filter by Partial Title or ID

In the upper left is a search field and 2 buttons.

• To filter by partial title, enter part of the title and click 'Search'
• To filter by ID number, enter "id:xx", where "xx" is the ID number (for example, "id:29").
• Click 'Clear' to clear the Filter field and restore the list to its unfiltered state.

Search Tools

Above the column headings, there are 5 dropdown list boxes.

• State. Select the desired state (Enabled or Disabled) to limit the list based on state. Select "- State -" to list Enabled and Disabled users.
• Active State. Select "Activated" to list only users that have been Activated. Select "Unactivated" to select only users who have not yet been activated. Select "- Active State -" to select both type of users.
• Group. Select a group from the list box to list only users who are members of that group. Select "- Group -" to select users regardless of group.
• Last Visit Date. Select time frame from a list to show only users who visited in a selected time frame. Select "- Last Vist Date -" to select users regardless of last visited date.
• Registration Date. Select time frame from a list to show only users who registered in a selected time frame. Select "- Registration Date -" to select users regardless of registration date.

Automatic Pagination

Page Controls. When the number of users is more than one page, you will see a page control bar as shown below. The current page number being viewed is shaded.

• Start: Click to go to the first page.
• Prev: Click to go to the previous page.
• Page numbers: Click to go to the desired page.
• Next: Click to go to the next page.
• End: Click to go to the last page.

Toolbar

At the top left you will see the toolbar.

The functions are:

• New. Opens the editing screen to create a new user.

• Edit. Opens the editing screen for the selected user. If more than one user is selected (where applicable), only the first user will be opened. The editing screen can also be opened by clicking on the Name of the user.

• Activate. Activates one or more user.

• Block. Blocks one or more user.

• Unblock. Unblocks one or more user.

• Delete. Deletes the selected user. Works with one or multiple user selected.

• Batch. Batch processes the selected user. Works with one or multiple items selected.

• Help. Opens this help screen.

• Options. Opens the Options window where settings such as default parameters can be edited.

Batch Process

The Batch Process allows a change in settings for a group of selected users marked with a check-mark in the corresponding check-mark boxes. To use: select one or more users form the table of users being viewed and click on the 'Batch' Toolbar button. This will open a pop up window as shown below.

You can change one value or all values at one time.

How to Batch Process a group of users:

1. Select one or more users on the list by selecting the desired checkbox(es).
2. Click the 'Batch' Toolbar button.
3. Set one or more of the following values:

• To change the User Group, select the desired new User Group from the User Group list box.
• Choose Add To Group, Delete From Group or Set To Group to do the desired action.
• Decide if a Password Reset is wanted.

When all of the settings are entered, click on Process to perform the changes. A message "Batch process completed successfully." will show. Note: Nothing will happen if you don't have any users selected.

If you wish to clear your entered selections, click on the 'Cancel' button. Note: This does not uncheck the check boxes for the users.

Quick Tips

• Click on the name of a user to edit the user's properties.
• Click on the icon in the Enabled column to toggle between Enabled and Disabled status.
• Click on the Column Headers to sort the users by that column, ascending or descending.
• To understand user and group permissions, read: ACL Tutorial for Joomla! 3.x

Related Information

Related Help Screens	Description
Components Users Configuration	User Options configuration allows setting of parameters used globally for all users. Control the use of Captcha, registration allowed and type of registration, default user group new users, reset password or username counter, and new user registration email notice to administration.
Users Access Levels	In this screen you have the ability to look at a list of your Access Levels and sort them in different ways. You can also edit and create Access Levels.
Users Access Levels Edit	Access levels control which users can view which objects on your site. Objects include menu items, modules, categories, and component items (articles, contacts, and so on). Each object in the site is assigned to one access level. User groups are also assigned to each access level. If a user is a member of a group that in turn has permission for an access level, then that user can view all objects assigned to that access level. It is important to understand that user groups can be arranged in a parent-child hierarchy. If so, then a child group has access to all access levels that the parent group has access to. So you don't need to assign a child group access to levels that its parent group already has access to.
Users Debug Groups	The Debug Permissions report maps out the exact permissions for any given user group across all assets on your Joomla! installation.
Users Debug Users	The Debug Permissions report allows you to map out the exact permissions for any given user across all extensions on your Joomla installation.
Users Groups	User Groups control what actions a user may take on the site and which objects a user can view. This screen allows you to create, view, edit, and delete User Groups.
Users Groups Edit	User groups play a central role in what a user can do and see on the site. Creating user groups is normally the first step in setting up the security system for your site.
Users Mass Mail Users	The Mass Mail screen allows Users who are members of the "Super Administrator" group to send an email message to registered users for the site. Users can be selected based on groups.
Users User Manager Edit	In this screen, you have the ability to create a new user (if you clicked on the 'New' button in the User Manager), or edit an existing user (if you selected a user and clicked on the 'Edit' button in the User Manager, or clicked on the name of a user).
Users User Note Categories	This screen allows you to look at a list of your user note categories and sort them in different ways. You can also edit and create user note categories and access levels.
Users User Note Category Edit	This is where you can add a new Category or edit an existing Category. Categories are used to organize the User Notes. Categories allow you to display related User notes together on a page and to filter User Notes in the User Notes Manager. All User Notes are assigned either to a Category that you create or to the special Category called 'Uncategorized'.
Users User Notes	User notes are pieces of information which can be assigned to registered users on your Joomla! site. These notes can contain for example comments about 'offending' or 'difficult' users etc.
Users User Notes Edit	In this screen you can create an user note or edit an user note. The 'editor' will be the chosen 'editor' for the user editing the note. Examples: TinyMCE - JCE - Codemirror.