Product list
This article is machine translated.
The module Produktliste is responsible for the output of products. It offers a variety of settings which are described below.
Module configuration
| Setting | Default setting | Description |
|---|---|---|
| Total number of posts | 3 | If you enter a number greater than 0, a maximum of this number of products will be listed. This can be useful, for example, to show the latest 4 products on the home page. |
| Items per page | 0 | If you don't change anything here, all found products will be displayed on the page without pagination. Otherwise a page break will take place after the entered number of products. |
| Category application area | Active category | Every single option is described in the Contao internal Helpwizard ( ). |
| Condition | - | Here you can enter your own SQL conditions, which will be attached to the corresponding query and executed. |
| Filtering for new products | Show all products | This setting refers to the optional setting for new products in the shop configuration. For example, if you have set 30 days, you can select "Show only new products" here. If you do this, only products created within the last 30 days will be listed. The option "Show old products" logically refers to the opposite. |
| Filter modules | - | Since you are potentially using multiple filter modules and product lists on a page, you can select here which filter modules the product list should respond to. |
| Initial sort field | - | Here you can set by which product attribute the product list should be sorted on the first page load. Your shop visitor can change the sorting later on his own by the filter module.
If you have manually sorted the products for a page (category), you may not make a selection here! |
| Initial sort direction | Downwards | If you have selected a sort field, you can determine here whether it should be sorted upwards or downwards. Selection options: - Downwards - Upwards |
Sorting by Preis is an extremely time-consuming process. Isotope eCommerce knows the possibility to adjust the price based on rules and it is therefore not possible to pre-filter the products already on the database. Therefore, in such a case, Isotope eCommerce must first load all the products from the database and then sort them at PHP level! See also chapter Performance.
Forwarding
| Setting | Default setting | Description |
|---|---|---|
| "Add to cart forwarding page. | - | If the "Add to Cart" button is enabled in the product list and a page is selected here, the visitor will be redirected to the corresponding page after clicking the button. |
| Forward to first product | - | If this option has been activated, the first product is automatically loaded when the page is called up. This makes it possible to place the product list and the product reader on the same page and to display the first product of the list directly in the product reader when the page is called up. |
Reference page
| Setting | Default setting | Description |
|---|---|---|
| Set a reference page | - | When you specify a reference page, the "Category Application Area" in the module configuration refers to the selected reference page rather than the current page. An example could be a "Highlights" page to which certain products are assigned. If you now want to display these on the start page, you select the "Active category" for the "Category application area" and select the "Highlights" page for the reference page. |
Template settings
| Setting | Default setting | Description |
|---|---|---|
| Individual template | - | Here you can overwrite the default template. |
| Product list template | iso\_list\_default | Here you can select a list template and change the view as you like. If you do not select anything here, the template of the respective product type will be selected (recommended). Selection options: - iso\_list\_default - iso\_list\_variants |
| Gallery | - | Here you can select the gallery with which the product images of the product list will be processed. If you don't select anything here, the template of the respective product type will be chosen (recommended). |
| Columns | 1 | This option allows you to customize the generation of the CSS classes. Depending on the setting, the classes 'row\_', 'col\_' or 'odd' and 'even' will be adjusted and allow you individual styling. |
| Enable set | - | By default, no quantity can be specified when adding to cart. If this option is activated, the visitor can specify a quantity. |
| Hide on product view | - | This option hides the product list if a product alias is found in the URL. |
| Include messages | - | If this option is enabled, the errors and notices will be displayed directly in the module and not as a JavaScript overlay. |
| Specify empty message | - | If no products were found (either because there are none or because the filter does not apply) the default message can be conveniently overridden here. |
| Define a message if no filter is set | - | If no filter is set yet, a message can be entered here by default. This makes it possible not to display all products at once when the page is loaded for the first time, but to first display the message entered here before the visitor then activates a filter. This can be particularly useful if a large number of products are assigned to a page/category and it does not make sense to display all products without a filter restriction. |
| Buttons | Add to shopping cart | Here you can determine which buttons should be displayed in the list. For example, if you only want to allow adding to the shopping cart in the product reader, you do not activate the "Add to cart" button here. You can also determine the order in which the buttons are displayed. Selection options: - Add to cart
- Update
Add to - favorites |