Restrictive filter

This article is machine translated.

The einschränkende Filter generates a navigation from the selected filter attributes, with which a product list can be restricted.


As an example we use a music store that sells guitars online. The guitars in this case differ by the following attributes with their respective options:

  • Type
    • acoustic
    • electronic
  • Manufacturer
    • Alhambra
    • Cort
    • Fender
    • Gibson
    • Taylor

With einschränkenden Filter you can now generate a navigation menu with the tree structure just shown. Here all options (i.e. level 2) are clickable.

Starting with Isotope eCommerce 2.3 only those options are displayed which have a product assigned to them. In addition, the number of hits will be displayed in parentheses. Example: “Taylor (42)”

The visitor can now, by clicking on “acoustic”, display a list of all acoustic guitars. If he then clicks on “Cort”, the result is further restricted (therefore einschränkender Filter) and now only shows all acoustic guitars from Cort.

You can now configure for each attribute whether a multiple selection of the field should lead to an AND or OR search. You can now configure whether and how a number display should be shown: " Show difference**"** shows the difference of how many products are added to the list when the option is clicked. This display primarily makes sense with an OR filter, since an AND filter would lead to a negative number. “Show**total”** shows how many products will appear in total in the list after clicking the option. Do not show"**corresponds to** the previous behavior and does not show a number.

The settings for the attributes

Module configuration

Setting Default setting Description
Category Application Area Active category since 2.3 Each individual option is described in Contao's internal helpwizard (!\[Helpwizard Icon">).
Condition - since 2.3 Here you can enter your own SQL conditions, which will be appended to the corresponding query and executed.
Filtering for new products Show all products If you have configured the ability in your store to mark products as "new", you can either filter for old, new or all products.
Choice options:
  • Show all products
  • Show only the new products
  • Show old products
Filter configuration - Here you can configure the fields of the restricting filter.
Attributes -
Query Type "AND" or "OR"
Number of Results "Don't Show", "Show all" or "Show differences"
Hide individual selections - Hide fields for the filter when there is only one selection.

Template settings

Setting Standard setting Description
Individual template -. Here you can have the default template overridden.
Navigationstemplate nav\_default Here you can select a template for the filter and change the output that way. As explained in the example, this filter generates a navigation, so all navigation templates are available for selection here.
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 - since 2.3 This option hides the product filter if a product alias is found in the URL.


Setting Standard setting Description
Redirect-Page - since 2.3 If you select a page here, the visitor will be redirected to that page when the filter is submitted.

Since the filter settings are cached, the placement of the filter is irrelevant. But that changes as soon as you enable search fields. Search queries are not cached and it is therefore necessary that the product filter is included before the product list on the same page!

Reference Page

Setting Standard Setting Description
Setting a Reference Page -. since 2.3 When you specify a reference page, the "category application area" in the module configuration will refer 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 home page, you select "Active Category" for "Category Application Area" and select the "Highlights" page for the reference page.