product_filter

On category pages, generates a filter based on product results.

Example

[%product_filter type:'category' limit:'100' autohide:'0' filter_parent_content:'1'%]
    [%param header%]
        Filter By Category
    [%/param%]
    [%param *body%]
        [%if [@selected@]%]
            <a href="[@remove_url@]" rel="nofollow">[@name@] [@total@]</a>
        [%else%]
            <a href="[@url@]">[@name@] [@total@]</a>
        [%/if%]
    [%/param%]
[%/product_filter%]

Please Note: If the limit is not set it will default to 100.

Usage

Maropost Commerce Cloud supports a number of different product filter types, and placing the product_filter tag on a category page in Maropost Commerce Cloud will display a filter list based on both the type of product filter you define, and the products that belong to that category / page. The system allows for filters to stack, so when a user applies a filter, the filter will be default refresh and show refined options based on the new product list. Filters can also be cleared in the same way, so by default our system uses logic in the body to determine whether [@selected@] is true to show either the url to apply the filter or remove this filter.

Specifics / Variations Filter

The variations filter looks at the specifics on an item and generates the filter based on that, so this is the primary tool for creating custom filters.

[%product_filter type:'variations' autohide:'0'%]
    [%param *header%]
        [%IF [@activecount@] > 0%]
            <a href="[@remove_url@]">Clear</a>
        [%/if%]
        Filter By [@filter_name@]
    [%/param%]
    [%param *body%]
        [%if [@selected@]%]
            <a href="[@remove_single_url@]" rel="nofollow">[@name@] [@total@]</a>
        [%else%]
            <a href="[@url@]">[@name@] [@total@]</a>
        [%/if%]
    [%/PARAM%]
[%/product_filter%]

Brands filter

The brands filter will generate a list of brands for the products available on the selected category.

[%product_filter type:'brand' limit:'50' autohide:'0'%]
    [%param header%]
        Filter By Brand
    [%/param%]
    [%param *body%]
        [%if [@selected@]%]
            <a href="[@remove_url@]" rel="nofollow">[@brand@] [@total@]</a>
        [%else%]
            <a href="[@url@]">[@brand@] [@total@]</a>
        [%/if%]
    [%/param%]
    [%param more%]
        <a href="[%url type:'page' id:'brands'/%]">Show all brands</a>
    [%/param%]
[%/product_filter%]

Product category filter

The category filter will show a list a filter based on categories the products are assigned to. Note that in Maropost Commerce Cloud, products can be assigned to multiple categories - and doing so means they will appear in this list, even if the categories are not descendants of the category currently selected. If you require a list of sub categories directly related to the category you are on instead, use a content menu.

[%product_filter type:'category' autohide:'0' filter_parent_content:'1'%]
    [%param header%]
        Filter By Category
    [%/param%]
    [%param *body%]
        [%if [@selected@]%]
            <a href="[@remove_url@]" rel="nofollow">[@name@] [@total@]</a>
        [%else%]
            <a href="[@url@]">[@name@] [@total@]</a>
        [%/if%]
    [%/param%]
[%/product_filter%]

Price filter

Just as with the other categories, the price filter will look at the products called to determine the price range, then divide break points based on the limit parameter. A popular use of this filter is to introduce a slider plugin, we have our own sample for you over at the tips & tricks or you can build your own with the below code.

[%product_filter type:'price' limit:'6'%]
    [%param header%]
        Filter By Price Range
    [%/param%]
    [%param *body%]
        [%if [@selected@]%]
            <a href="[@remove_url@]" rel="nofollow">[@name@] [@total@]</a>
        [%else%]
            [%if [@min@] == 0 and [@max@] > 0%]
                <a href="[@url@]">[%format type:'currency' dp:'0'%][@max@][%/format%] or below</a>
            [%elseif [@min@] > 0 and [@max@] > 0%]
                <a href="[@url@]">[%format type:'currency' dp:'0'%][@min@][%/format%] to [%format type:'currency' dp:'0'%][@max@][%/format%]</a>
            [%elseif [@max@] == 0%]
                <a href="[@url@]">[%format type:'currency' dp:'0'%][@min@][%/format%] or above</a>
            [%/if%]
        [%/if%]
    [%/param%]
[%/product_filter%]

A2Z filter

The A2Z filter will automatically index the results to produce an alphabetical filter.

[%product_filter type:'a2z' autohide:'0' ignorefilter:'1'%]
    [%param header%]
        Filter by A to Z
    [%/param%]
    [%param *body%]
        [%if [@selected@]%]
            <a href="[@remove_url@]">[@id@]</a>
        [%else%]
            <a href="[@url@]">[@id@]</a>
        [%/if%]
    [%/param%]
[%/product_filter%]

product_filter Parameters

product_filter data tags