Actions

Help25

Difference between revisions of "Users User Manager"

From Joomla! Documentation

(Move pagination into its own section)
(Column Headers: Fix red link)
 
(12 intermediate revisions by one user not shown)
Line 1: Line 1:
{{Page|needs review}}{{RightTOC}}
+
{{RightTOC}}
 
==How to access==
 
==How to access==
 
To access this screen you can either:
 
To access this screen you can either:
 
* Click the '''User Manager''' button in the [[Help25:Site Control Panel|Control Panel]], or
 
* Click the '''User Manager''' button in the [[Help25:Site Control Panel|Control Panel]], or
* Select '''Site → Users''' from the drop-down menus.
+
* Select '''Users → User Manager''' from the drop-down menus.
  
 
==Description==
 
==Description==
In this screen you have the ability to look at a list of your users and sort them in different ways. You can also edit and create users, groups and access levels.
+
In this screen you have the ability to look at a list of your users and sort them in different ways. You can also edit and create users.
  
 
==Screenshot==
 
==Screenshot==
Line 13: Line 13:
 
==Column Headers==
 
==Column Headers==
 
In the table containing the users from your Joomla! site, you will see different columns. Here you can read what they mean and what is displayed in that column.
 
In the table containing the users from your Joomla! site, you will see different columns. Here you can read what they mean and what is displayed in that column.
 
 
{{Chunk25:colheader|Checkbox}}
 
{{Chunk25:colheader|Checkbox}}
 
*'''Name'''. The full name of the user.
 
*'''Name'''. The full name of the user.
 
*'''User Name'''. The name the user will log in as.
 
*'''User Name'''. The name the user will log in as.
 
*'''Enabled'''. Whether or not the user is enabled.
 
*'''Enabled'''. Whether or not the user is enabled.
*'''Activated'''. Whether or not the user is activated. Normally when a user registers from the front end, some type of activation is required. This is controlled by the New User Account Activation parameter in the Users Configuration → Component screen. See [[Help25:Users_Options#Component_Settings|Users Options - Component Settings]] for more information.
+
*'''Activated'''. Whether or not the user is activated. Normally when a user registers from the front end, some type of activation is required. This is controlled by the New User Account Activation parameter in the Users Configuration → Component screen. See [[Help25:Users_User_Manager#Component|Users Options - Component Settings]] 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.
 
*'''User Groups'''. The list of groups that the user belongs to. Note that a user may belong to more than one group.
 
{{colheader|E-mail}}
 
{{colheader|E-mail}}
Line 25: Line 24:
 
{{Chunk25:colheader|Id}}
 
{{Chunk25:colheader|Id}}
  
==Pagination==
+
==List Filters==
{{colheader|Display}}
+
'''Filter by Partial User Name'''
 +
*'''Search Users'''. In the upper left is a Search field and two buttons, as shown below.
 +
 
 +
[[Image:Help25-Users User Manager-Search-Filter-screen.png]]
 +
 
 +
Enter part of the user's name and press the Search to find matching names. Press Reset to clear the search field and restore the list of users.
 +
 
 +
'''Filter by User State, Activation, Group or Registration Date'''
 +
 
 +
In the upper right, above the column headings, are four drop-down list boxes as shown below.
 +
 
 +
[[Image:Help25-Users User Manager-Other-Filter-screen.png]]
 +
 
 +
*'''State'''. Select the desired state (Enabled or Disabled) to limit the list based on state. Select "- State -" to list Enabled and Disabled users.
 +
*'''Active'''. Select "Activated" to list only users that have been Activated. Select "Unactivated" to select only users who have not yet been activated. Select "- Active -" 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.
 +
*'''Registration Date'''. Allows the users to be filtered by those who registered within certain groups of time.
 +
{{Chunk25:colheader|Manager Pagination}}
  
 
==Toolbar==
 
==Toolbar==
Line 43: Line 59:
 
{{Chunk25:Help_screen_toolbar_icon_Help}}
 
{{Chunk25:Help_screen_toolbar_icon_Help}}
  
==List Filters==
+
==Options==
'''Filter by Partial User Name'''
+
{{Chunk25:Help-screen-users-component-options}}
*'''Search Users'''. In the upper left is a Search field and two buttons, as shown below.
+
 
+
[[Image:Help25-Users User Manager-Search-Filter-screen.png]]
+
 
+
Enter part of the user's name and press the Search to find matching names. Press Reset to clear the search field and restore the list of users.
+
 
+
'''Filter by User State, Activation, or Group'''
+
 
+
In the upper right, above the column headings, are three drop-down list boxes as shown below.
+
 
+
[[Image:Help25-Users User Manager-Other-Filter-screen.png]]
+
 
+
*'''State'''. Select the desired state (Enabled or Disabled) to limit the list based on state. Select "- State -" to list Enabled and Disabled users.
+
*'''Active'''. Select "Activated" to list only users that have been Activated. Select "Unactivated" to select only users who have not yet been activated. Select "- Active -" 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.
+
==Options Modal Pop up Window==
+
[[File:Help25-Users-User-Manager-Options-modal-window.png]]
+
  
 
==Quick Tips==
 
==Quick Tips==
Line 70: Line 69:
 
==Related information==
 
==Related information==
 
* [[Help25:Users_User_Manager_Edit|User Manager: Add/Edit User]]
 
* [[Help25:Users_User_Manager_Edit|User Manager: Add/Edit User]]
* [[Help25:Users_Options|Users Configuration]]
 
 
* [[Help25:Users_Groups|User Manager: Users Groups]]
 
* [[Help25:Users_Groups|User Manager: Users Groups]]
 
* [[Help25:Users_Access_Levels|User Manager: Viewing Access Levels]]
 
* [[Help25:Users_Access_Levels|User Manager: Viewing Access Levels]]

Latest revision as of 16:02, 4 July 2013

Contents

How to access

To access this screen you can either:

  • Click the User Manager button in the Control Panel, or
  • Select Users → User Manager from the drop-down menus.

Description

In this screen you have the ability to look at a list of your users and sort them in different ways. You can also edit and create users.

Screenshot

Help25-Users User Manager-discover-screen.png

Column Headers

In the table containing the users from your Joomla! site, you will see different columns. Here you can read what they mean and what is displayed in that column.

  • Checkbox. Check this box to select one or more items. To select all items, check the box in the column heading. After one or more boxes are checked, click a toolbar button to take an action on the selected item or items. Many toolbar actions, such as Publish and Unpublish, can work with multiple items. Others, such as Edit, only work on one item at a time. If multiple items are checked and you press Edit, the first item will be opened for editing.
  • Name. The full name of the user.
  • User Name. 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 front end, 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 - Component Settings 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.
  • E-Mail. The e-mail 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 item assigned automatically by Joomla!. It is used to identify the item internally, and you cannot change this number. When creating a new item, this field displays 0 until you save the new entry, at which point a new ID is assigned to it.

List Filters

Filter by Partial User Name

  • Search Users. In the upper left is a Search field and two buttons, as shown below.

Help25-Users User Manager-Search-Filter-screen.png

Enter part of the user's name and press the Search to find matching names. Press Reset to clear the search field and restore the list of users.

Filter by User State, Activation, Group or Registration Date

In the upper right, above the column headings, are four drop-down list boxes as shown below.

Help25-Users User Manager-Other-Filter-screen.png

  • State. Select the desired state (Enabled or Disabled) to limit the list based on state. Select "- State -" to list Enabled and Disabled users.
  • Active. Select "Activated" to list only users that have been Activated. Select "Unactivated" to select only users who have not yet been activated. Select "- Active -" 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.
  • Registration Date. Allows the users to be filtered by those who registered within certain groups of time.
  • Page Controls. When the number of items is more than one page, you will see a page control bar as shown below.
    Help25-chunk-colheader-pagination.png
    • Display #: Select the number of items to show on one page.
    • 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 right you will see the toolbar:

Help25-Toolbar-New-Edit-Activate-Block-Unblock-Delete-Options-Help.png

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 Title or Name of the user.
  • Activate. Activates multiple users. Select all the users required using their check-boxes then click this button.
  • Block. Blocks one or more users. Select the users to be blocked using their check-boxes then click this button.
  • Unblock. Unblocks one or more users. Select the users to be unblocked using their check-boxes then click this button.
  • Delete. Deletes the selected users. Works with one or multiple users selected.
  • Options. Opens the Options window where settings such as default parameters or permissions can be edited.
  • Help. Opens this help screen.

Options

Click the Options button to open the User Manager Options window which lets you configure this component.

Help25-Users-User-Manager-Options-modal-window.png

Buttons Common to All Tabs

  • Save. Saves the user options and stays in the current screen.
  • Save & Close. Saves the user options and closes the current screen.
  • Cancel/Close. Closes the current screen and returns to the previous screen without saving any modifications you may have made.

Component

Help25-Users-User-Manager-Options-Component-screen.png

  • Allow User Registration. (Yes/No) If set Yes, users can register from the front end of the site using the Create an Account link provided on the Login module. If set to No, the "Create and Account" link will not show.
  • New User Registration Group. The group that users are assigned to by default when they register on the site. Defaults to Registered.
  • Guest User Group. The group that guests are assigned to. (Guests are visitors to the site who are not logged in.) This is set to Public by default. If you change this to a different group, it is possible to create content on the site that is visible to guests but not visible to logged in users. See Allowing Guest-Only Access to Menu Items and Modules.
  • Send Password. If set to yes the user will be emailed their password on the registration email. Note there are potential security issues if this is set to yes.
  • New User Account Activation.
    • None. User account will be active immediately with no action required.
    • Self. User will receive an email with an activation link. The account will be activated when the user clicks the activation link.
    • Admin. User will receive an email with an activation link. When the user clicks this link, the Site Admin will be notified via email and the Site Admin needs to activate the user's account.
  • Notification Mail to Administrators. (Yes/No) Send email notification to administrators with User Account Activation.
  • Captcha. Use Captcha for User Account Registration and Username or User Password reminders.
  • Frontend User Parameters. (Show/Hide) If set to Show, users will be able to modify their language, editor, and help site preferences from the front end of the site. If set to Hide, the user will not be able to change these settings.
  • Frontend Language. (Show/Hide) Show or hide the option for users to set their default site language.
  • Change Login Name. (Yes/No) Allow user to change Login Name.
  • Maximum Reset Count. (0-20) Maximum number of reset password attempts per Time in Hours. Zero means no limit on reset password attempts.
  • Time in Hours. (1-24) Time period in hours for the Maximum Reset Count.

Mass Mail

Help25-Users-User-Manager-Options-Mass-Mail-screen.png

  • Subject Prefix. Enter optional text to be inserted automatically before the subject of the mass email.
  • Mailbody Suffix. Enter optional text to be inserted automatically after the body of the email (for example, a signature).

Permissions

This screen allows you to set the component permissions in Joomla. This is important to consider if you have sites with many different user categories all of whom need to have different accessibilities to the component. The screenshot below describes what you should see and the text below that describes what each permission level gives the user access to:

Help25-Users-User-Manager-Options-permissions.png

You work on one Group at a time by opening the slider for that group. You change the permissions in the Select New Settings drop-down list boxes. The options for each value are Inherited, Allowed, or Denied. The Calculated Setting column shows you the setting in effect. It is either Not Allowed (the default), Allowed, or Denied. Note that the Calculated Setting column is not updated until you press the Save button in the toolbar. To check that the settings are what you want, press the Save button and check the Calculated Settings column.

The default values used here are the ones set in the Global Configuration Permissions Tab

Configure
Open the users component option screens (the modal window these options are in)
Access Administration Interface
Open the users component manger screens
Create 
Create new users in the component
Delete 
Delete existing users in the component
Edit 
Edit existing users in the component
Edit State 
Change an users state (Publish, Unpublish, Archive, and Trash) in the component.

There are two very important points to understand from this screen. The first is to see how the permissions can be inherited from the parent Group. The second is to see how you can control the default permissions by Group and by Action. This provides a lot of flexibility. For example, if you wanted Shop Suppliers to be able to have the ability to create an article about their product, you could just change their Create value to "Allowed". If you wanted to not allow members of Administrator group to delete objects or change their state, you would change their permissions in these columns to Inherited (or Denied). It is also important to understand that the ability to have child groups is completely optional. It allows you to save some time when setting up new groups. However, if you like, you can set up all groups to have Public as the parent and not inherit any permissions from a parent group.

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.

Related information