Product filter

This article is machine translated.

The module Produktfilter is responsible for the output of filter settings. These are subsequently applied to the modules Produktliste, provided they have been activated there (see corresponding documentationfor more information).

Module configuration

Setting Default setting Description
Category Application Area Active category Each individual 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 If you have configured the possibility to mark products as "new" in your shop, you can filter either for old, new or for all products. Options: - Show all products Show - only new products Show - old


Activate “per page” limit - If you check this box, you can give the visitor a dropdown with “per page” options. He can decide how many products he wants to see at once.
“Per page” options 8,12,32,64 If you have set the checkbox for “Per page” limit, you can enter a comma-separated list of possible options here. A dropdown will then be generated from these.
Activated filters - Here you determine which product attributes the visitor can filter by. Only those that have been activated for “Frontend filtering” are available. Please refer <docrobot_route name=“attributes”>to the chapter on product attributes</docrobot_route>.
Hide single selections - If you check this box, filters will be hidden if there is only one possible option.
Enabled search fields - Here you determine which product attributes the visitor can search for. Only those that have been marked as searchable in the frontend are available. Please refer <docrobot_route name=“attributes”>to the chapter on product attributes</docrobot_route> for more information. Selection options: - Item number

  • Name
  • Teaser
  • Description
Redirect exact match - since 2.6 The customer will be redirected to the product details if the keyword search in one of these fields is an exact match (e.g. search by item number).
Search field with autocomplete - If you activate this function, the search field will be autocompleted with the product attribute selected here. For example, if you select "Name" and have two products whose names begin with "Guitar", typing "Git" into the search field will display a selection of the two products.

Use this function with caution. Autocomplete is not a high-performance operation, so you should never enable it for filters that search a large number of products.

Selection options: - Item - name - Teaser - Description
Enabled sort fields - Here you determine by which product attributes the visitor can sort. Only those are available which have been activated for the "Frontend sorting". Please refer to the chapter on product attributes. Selection options: - Added on - Item number - Name - Price
Initial sort field - This setting determines which of the activated sort fields should be preselected when the product filter is first loaded. Sensibly, this coincides with the product list settings. However, since a product filter can apply to multiple product lists, you will need to choose the correct setting for you. Selection options: - Added on - Item number - Name - Price
Initial sort direction Downwards This setting determines the initial sort direction for the selected "Initial Sort Field". Choices: - Downwards
  • Upwards

Template Settings

Setting Default Setting Description
Custom Template - Here you can override the default template.
Filter template iso\_filter\_default Here you can select a template for the filter and change the output.
Include messages - If this option is enabled, the errors and notices will be output directly in the module and not as a JavaScript overlay.
Hide on product view - This option hides the product filter if a product alias is found in the URL.


Setting Default setting Description
Forwarding Page - If you select a page here, the visitor will be redirected to this page when submitting the filter.

Since the filter settings are cached, the placement of the filter is irrelevant. However, this changes as soon as you activate search fields. Search queries are not cached and it is therefore necessary to include the product filter before the product list on the same page!

Link to primary URL - since 2.6 Link the product details to the primary URL (canonical) instead of the current category.

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.