{Products}

Prints a product list whose contents and markup can be modified almost completely freely.

Kuvaus

By default, the following information is printed about every product:

When the {Products} tag is used on the page of a product category, brand or campaign, the tag prints by default all belonging products.

Most product lists are aliases of the {Products} tag. So, you can print the contents of most lists by using this tag.

When the <ProductListFilters supported = "true" /> option is enabled in the theme's settings, the {Products} tag will function in a slightly different way.

Syntaksi

{Products(
    category: int,
        subcategories: boolean,
    brand: int,
    campaign: int,
    id: int,
    keyword: string,
    filters: string,
    timelimit: string,
    similar_to: int,
    compatible_to: int,
    add_on_to: int,
    spare_part_to: int,
    crosssales_for: int,
        fallback: boolean,
    limit: int,
    prelimit: int,
    sort: string,
    pagination: boolean,
    type: string,
        list_type: string,
        list_classes: string,
    classes: string,
    helper: string
)}

Näkyvyys

Toimii näkyvyydessä: globaali

Näkyvyyshelper-attribuutissa: tuote

Tags with global scope can be used on any template and in any tag.

Printing promoted products from hidden product categories

You can print promoted products from hidden product categories by using the {Products} tag. It's especially handy if the products you'd like to present in your store belong to different product categories or brands.

Create a new product category and hide it by unselecting all versions in the product category form's Show in version item.
Add the promoted products to the hidden product category and note down its ID, which is visible in the browser address bar.
Place the {Products} tag at the desired location in your theme, and give it the ID in the category attribute.
You can also define the list's content by using other criteria. The example below shows how to include on a list only the products that are in stock.
```
{Products(
    category: 2,
    filters: 'discounted|in_stock'
)}
```

You can also use the featured products to implement promoted products.

Attribuutit

When product filters are enabled in an online store, a number of attributes used for managing the list contents cannot be applied to the {Products} tag anymore.

When product filters are enabled, only the following formatting attributes can be applied to the {Products} tag:

type
list_type
list_classes
classes
helper

The {Products} tag's aliases (e.g. {CategoryProducts}, {DiscountProducts} etc.) work as usual. These tags cannot be used with product filters.

Learn more about the impact of product filters on product lists.

category:

Defines the product categories from which products should be retrieved.

Allowed values: product category ID numbers separated by pipes. To retrieve products from all product categories, use the value 'ALL'.

E.g. category:'2|34|5'

subcategories:

Defines whether products should be retrieved also from subcategories of the product categories defined in the category attribute.

The attribute is used only if a value has been assigned to the category attribute.

Allowed values:true/false. The default value is true.

brand:

Defines the brands whose products should be retrieved.

Allowed values: brand ID numbers separated by pipes. To retrieve products from all brands, use the value 'ALL'.

E.g. brand:'2|34|5'

campaign:

Defines the campaigns whose products should be retrieved.

Allowed values: campaign ID numbers separated by pipe characters. To retrieve products from all campaigns, use the value 'ALL'.

E.g. campaign:'2|34|5'

id:

Defines the products that should be included on the list based on their ID numbers.

Allowed values: pipe-separated product ID numbers

keyword:

Search terms that define which products should be displayed on the list.

To learn more about how the search works, see our user guide.

Allowed values: space-separated search terms.

E.g. keyword:'paidat housut Jamppa'

filters:

Sets ready filters to the list to be printed for selecting products that should be included on that list.

Allowed values:

'discounted': discounted products (i.e. products that belong to any active discount campaign)
'regularly_priced': regularly priced products
'featured': featured products
Products can be marked as featured in the product form's item Visibility settings > Featured product.
'has_images': only products with product images
'preorder': products that can be preordered (their limited availability period hasn't started yet)
'released': all products that cannot be preordered and have been released within the last year
You can set the filter to retrieve products from a specific timespan by using the timelimit attribute.
'in_stock': products that are in stock
'out_of_stock': products that are out of stock
'available': products that are available
'unavailable': products that are out of stock and are no longer being sold
'navigable': the product is navigable
This means that the product belongs to a product category and no level in its category hierarchy has been excluded from the active store version.
'not_in_cart': products that aren't in the shopping cart

If you want to use multiple filters, separate the values with pipe characters.

E.g. filters:'discounted|released'

timelimit:

Sets the time span from which products are retrieved on the list.

Allowed values:

Days: '-n days'
Weeks: '-n weeks'
Months: '-n months'

E.g. timelimit:'-3 months'

You can switch off the time limit altogether by setting the value to 0.

similar_to:

Defines the products for which products marked as similar should be printed on a list.