Prints a list of the online store's brands.

Description

By default, brands are printed in the form of a <ul> list that includes each brand's name and logo (if set), as well as a link to the brand page.

You can easily define whether the brand's logo should be included on the list by using the showlogo attribute.

If you use image size attributes such as width, height or imagesize, the image will appear in the size specified by the attributes.

Syntax

{Brands(
    category: int / string,
    filters: string,
    showlogo: boolean,
    imagesize: string,
    width: int,
    height: int,
    helper: string
)}

Scope

Required scope: globaali

Scope in helper attribute: tuotemerkki

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

Attribuutit

category:

Selects for the list only those brands whose products appear in the selected product categories.

Allowed values: pipe-separated product categories' ID numbers or 'CURRENT' to use the product category set in the scope.

E.g. category: '1|5|45' or category: 'CURRENT'

filters:

Specifies filters used for determining which brands to include on the list of brands to be printed.

Allowed values:
  • visible_products: includes on the list only the brands that have visible products in the version browsed by the visitor.

Defines whether to print the brand's logo on the list.

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

imagesize:

Defines printed image's dimensions.

The used values are determined by the values of the ImageSizes element of the theme settings.

Allowed values: names of image sizes defined in the theme.xml file's ImageSizes element.

E.g. imagesize:'Large'

width:

Defines image width given in pixels.

Allowed values:integers

height:

Defines image height given in pixels.

Allowed values:integers

helper:

Defines the content and output format of a single list element.

Allowed values: the Interface and HTML markup that define the output's markup and content.

The helper attribute can be used in two ways:

  1. you can indicate the desired markup directly as the attribute's value, or
  2. you can indicate a reference to a file with the desired markup as the attribute's value.

    The reference should be indicated in relation to the theme's root directory.

See also detailed instructions on using the helper attribute.

after/before:

By using the after and before attributes you can define content that is output either after or before the tag's output.

Allowed values:The HTML and Interface markup

E.g.

  • before: '<p>Tämä merkkaus näkyy ennen tagin omaa sisältöä.</p>'
  • after: '<p>Tämä taas näkyy tagin oman sisällön jälkeen.</p>'

If the tag does not produce any content, neither the content of the after and before attributes will be output.

escape:

Adds an escape character before quotation marks in the output.

The attribute makes it easier to process the tag-produced content when using JavaScript.

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

or:

Defines alternative content that is displayed if the tag itself does not produce any content.

Allowed values:The HTML and Interface markup

E.g. or:'Sisältöä ei löytynyt.'