A role in X-Cart is a set of permissions providing access to certain features and areas of the store Admin area. X-Cart roles enable a root admin to configure different access levels to the Admin area for other administrator users. This feature may be helpful if you have staff you want to delegate some work on the store maintenance but don't want to give this staff full access to the store's Admin area.

Roles are added to the X-Cart core via the User Permissions add-on.

Roles Listing Page

Typically, the User Permissions add-on is preinstalled and enabled, and your X-Cart store already has some roles configured. You can view them in the Roles section of the Admin area (Users > Roles).

The administrator is the role with the root access permissions to the store Admin area, which means that a user with this role has full access to all the features (no restrictions at all). It is the only role in X-Cart that can't be edited or deleted.

The rest of the roles provide limited access to a store Admin area so that a user could work with just some of the features (sections).

Roles Configuration

Roles are configurable and consist of a set of access permissions. You can create new roles or edit existing ones and assign as many access permissions to one role as you find necessary. You can also delete the roles you do not need.

Access Permissions

A complete list of access permissions available in a default X-Cart store is as follows:

  • Root access: Gives full access to the store Admin area (with no limitations).

  • Manage catalog: Gives access to several pages of the Catalog section of the store's Admin area, where this user can manage all products, including product categories, tags, classes, and attributes. Also, this user gets access to the Content -> Featured products section of the Admin area to manage featured products.

  • Manage reviews: Gives access to the Catalog -> Reviews page of the store Admin area where this user can manage existing and create new product reviews.

  • Manage users: Gives access to the Users -> User list page of the Admin area, where this user can manage existing and create new customer accounts.

  • Manage administrators: Extends the "Manage users" access permission to manage existing, and create new admin and vendor accounts (including root admins). However, the "Manage administrators" access permission doesn't allow assigning new or changing existing roles assigned to different admin accounts.

  • Manage orders: Gives access to several pages of the Orders section of the store Admin area, where this user can process orders in full, including working with order statuses, payment transactions, order statistics, and messages.

  • Manage import: Gives access to several pages of the Catalog section of the store Admin area, where this user can import data and update products quantity.

  • Manage export: Gives access to the Catalog -> Export page of the store Admin area, where this user can export all product-related info, including categories, classes, and attributes and their values and product tabs, as well as product reviews, customers, and orders data.

  • Manage banners: Gives access to the Сontent -> Front page -> Banner rotation page of the store Admin area, where this user can manage the (sub) categories' banners and the way they display in the storefront.

  • Allow unfiltered HTML: Gives a user a possibility to add unfiltered HTML code to any text area (e.g., product description, category description, news, static page content, etc.) in the store's Admin area. You can use this access permission only in bundle with other access permissions that give access to different text areas of the store Admin area (e.g., Manage catalog, Manage reviews, etc.).

  • Manage custom pages: Gives access to the Сontent -> Pages page of the Admin area, where this user can create new and manage existing store HTML pages.

  • Manage menus: Gives access to the Сontent -> Menus page of the Admin area, where this user can create new and manage existing store header and footer menus.

  • Manage news: Gives access to the Сontent -> News messages page of the Admin area, where this user can create new and manage existing news messages.

  • Manage coupons: Gives access to the Discounts -> Coupons page of the Admin area, where this user can create new and manage existing discount coupons.

  • Manage volume discounts: Gives access to the Discounts -> Volume discounts page of the Admin area, where this user can create new and manage existing volume discounts.

  • Manage conversations: Gives access to the Orders -> Messages page of the store Admin area, where this user can work with customers' messages on their orders.

Adding New Roles

To add a new role:

  1. Click the New role button.

  2. In the form that opens, specify the details of the role you want to create:

    • Name: The name to identify the role.

    • Enabled: Whether the role is active. When a role is inactive (disabled), users can log in to the store's Admin area, but they cannot access any of the features/areas that the role entitles them to access.

    • Permissions: The set of access permissions the user with this role should have. Click in the field, and select permissions from the drop-down list.

  3. Click Create.

Managing Roles

To manage roles, open the Roles page of the store Admin area (Users -> Roles) and use the tools on the page to apply the necessary changes.

Role Changes

  • To edit a role, click on its name in the Roles table, edit the role details and click Update to save the changes. The changes applied will affect all the admins with this role assigned.

Role Deactivation

  • It is possible to deactivate a role directly on the role listing page to disable the permissions granted by this role to the admins who hold it. To do so, click on the ON/OFF icon in front of the role name, and save the changes.

Role Deletion

  • To delete a role, click on the Trash icon opposite the role name at the far right and save the changes.

Assigning Roles to Admin Accounts

To set a role to an admin account:

  1. Locate the required admin account on the Users list page and click on the email to open the Account details page.

  2. On the Account details page, locate the Access information section:

  3. Click on the Roles field and choose the role from the drop-down. You can add more than one role to each user.

  4. Click Update to save the changes.

Related pages:

Did this answer your question?