Cart Rules' Administration
The following specifications are about the Cart Rules administration page. To see the page in the software, go to Catalog > Discounts.
Description
Cart Rules are discount rules findable in multiple places across the back office and the front office of any PrestaShop website. As merchants, we can administrate and apply those on orders from the back office.
From the front office, customers can use cart rules by applying them to their cart if they are not already automatically applied according to their parameters.
Merchants need to be able to create and edit discounts for their customers based on specific conditions, such as product quantity or category, combinations, brands, and more (specific conditions are detailed further on this page).
They also need to enable and disable those rules when needed, as they have to be able to delete them. The administration page allows merchants to do every one of those actions.
Components description
Back office header (Digits 1, 2 and 4 are in the header)
Description | Value |
---|---|
Mandatory | - |
Allowed/Forbidden values | - |
Default value | - |
Help text | - |
Tool tips | - |
Behavior | Clicking on this button opens the cart rule's creation form, on the information tab. |
5 – “Cart Rules” Tab
Description | Value |
---|---|
Mandatory | - |
Allowed/Forbidden values | - |
Default value | - |
Help text | - |
Tool tips | - |
Behavior | It's the tab selected by default when clicking on “Discounts” in the menu. On click, it opens the Cart Rules' Administration page, or reload it because even if already on this page, the tab stays clickable. |
Description | Value |
---|---|
Mandatory | — |
Allowed/Forbidden values | - |
Default value | - |
Help text | - |
Tool tips | - |
Behavior |
7 – Table
a - Header
b - Add Icon
Description | Value |
---|---|
Mandatory | - |
Allowed/Forbidden values | - |
Default value | - |
Help text | - |
Tool tips | Add New |
Behavior | Clicking on this button opens the cart rule's creation form, on the information tab. |
c - Refresh Icon
Description | Value |
---|---|
Mandatory | - |
Allowed/Forbidden values | - |
Default value | - |
Help text | - |
Tool tips | Refresh list |
Behavior | Clicking on this button reloads the entire page. |
d—SQL request Icon
Description | Value |
---|---|
Mandatory | - |
Allowed/Forbidden values | - |
Default value | - |
Help text | - |
Tool tips | Show SQL query |
Behavior | Clicking on this button triggers a JavaScript function, but nothing happens visually |
e - SQL export Icon
Description | Value |
---|---|
Mandatory | - |
Allowed/Forbidden values | - |
Default value | - |
Help text | - |
Tool tips | Export to SQL Manager |
Behavior | Clicking on this button sends to the SQL Manager's page (Advanced Parameters > Database > SQL Manager), displaying the SQL query corresponding to the list of Cart Rules. |
f - Search by ID field
Description | Value |
---|---|
Mandatory | No |
Allowed/Forbidden values | Allowed : Letters, numbers, special characters / Forbidden : - |
Default value | - |
Help text | - |
Tool tips | - |
Behavior | - |
g - Search by name
Description | Value |
---|---|
Mandatory | No |
Allowed/Forbidden values | Letters, numbers, special characters / Forbidden : - |
Default value | - |
Help text | - |
Tool tips | - |
Behavior | - |
h - Search by priority
Description | Value |
---|---|
Mandatory | No |
Allowed/Forbidden values | Letters, numbers, special characters / Forbidden : - |
Default value | - |
Help text | - |
Tool tips | - |
Behavior | - |
i - Search by code
Description | Value |
---|---|
Mandatory | No |
Allowed/Forbidden values | Letters, numbers, special characters / Forbidden : - |
Default value | - |
Help text | - |
Tool tips | - |
Behavior | - |
j - Search by quantity
Description | Value |
---|---|
Mandatory | No |
Allowed/Forbidden values | Letters, numbers, special characters / Forbidden : - |
Default value | - |
Help text | - |
Tool tips | - |
Behavior | - |
k - Search by expiration dates
Description | Value |
---|---|
Mandatory | No |
Allowed/Forbidden values | Allowed : Date |
Default value | - |
Help text | - |
Tool tips | - |
Behavior | Clicking on this field opens a date picker. The “From” date can be set on a later date than the “To” date, there is no limitation. |
l - Search by status
Description | Value |
---|---|
Mandatory | No |
Allowed/Forbidden values | Boolean or empty |
Default value | Empty |
Help text | - |
Tool tips | - |
Behavior | Clicking on this field opens the list of available options. |
m - Search Button
Description | Value |
---|---|
Mandatory | - |
Allowed/Forbidden values | - |
Default value | - |
Help text | - |
Tool tips | - |
Behavior | Clicking on this button triggers a filtering request based on the search field's value. If nothing has been entered in those fields, the table is just refreshed. If some cart rules match, the button search stays clickable and the Reset Button appears. |
Description | Value |
---|---|
Mandatory | - |
Allowed/Forbidden values | - |
Default value | - |
Help text | - |
Tool tips | - |
Behavior | Clicking on this button refresh the table to display all cart rules. |
n - Table item
Description | Value |
---|---|
Mandatory | - |
Allowed/Forbidden values | - |
Default value | - |
Help text | - |
Tool tips | - |
Behavior | Clicking on a table item open the related cart rule's edition page. |
o - Checkbox
Description | Value |
---|---|
Mandatory | NO |
Default value | Unchecked |
Help text | - |
Tool tips | - |
Behavior | Clicking on a checkbox changes the selection status. When selected, bulk actions affect the item. |
p - Status Icon
Description | Value |
---|---|
Mandatory | YES |
Default value | Enabled |
Help text | - |
Tool tips | Status : Enabled / Disabled |
Behavior | Clicking on the status icon changes the item status, between enabled (default) |
q - Edit Dropdown
Description Value Mandatory
-
Allowed/Forbidden values
-
Default value
-
Help text
-
Tool tips
-
Behavior
Edit Dropdown has 2 options:
Edit – When clicking on that option, the related Cart Rule’s edition form opens. Delete – When clicking on that option, a popup opens with the text: Delete selected item? Name: Name of the cart rule Yes – finishes the action, No – closes the pop-up without deletion.
Description Value Mandatory
-
Allowed/Forbidden values
-
Default value
-
Help text
-
Tool tips
-
Behavior
Bulk action has 5 options: Select all - select every item from the table. When clicking on that option, the bulk action menu is closed and all checkboxes are selected. Unselect all - unselect every item from the table. When clicking on that option, the bulk action menu is closed and all checkboxes are unselected. Enable selection - enables the selected Cart Rules. After the action finishes, success notification is shown in the interface - The status has been successfully updated. It comes from the Alerts Basics UI Kit. Disable selection - disables the selected Cart Rules. After the action finishes, success notification is shown in the interface - The status has been successfully updated. It comes from the Alerts Basics UI Kit. Delete selected - deletes the selected Cart Rules. After the action initiates, there will be a navigator pop-up with the text: Delete selected item? Cancel - closes the pop-up, OK - finishes the action.
Error messages
“You must select at least one item to perform a bulk action.” - When clicking on “Enable selection” / “Disable selection” or “Deleted selected” in the Bulk actions' menu, if nothing has been selected, this error message is displayed. The error message UI comes from the Alerts Basics UI Kit.
Last updated