Prints a list of the product's product categories.

Kuvaus

The content printed by the tag corresponds to the {Categories} tag's output, but the list includes only the product categories that the product belongs to.

Syntaksi

{ProductCategories( brand: int, helper: string, levels: int, first: string, start: int, sort: string, classes: string )}

Näkyvyys

Toimii näkyvyydessä: tuote

Näkyvyyshelper-attribuutissa: tuoteryhmä

The required scope is always set in the following templates:

Templates
Single product template
Product images

Attribuutit

brand:

Defines the brands whose products must appear in the product categories to be printed.

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

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

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:

  • you can indicate the desired markup directly as the attribute's value, or
  • 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.

levels:

Defines the number of product category levels to be printed. The value 1 prints only the product categories that the product belongs to, without their subcategories.

Allowed values: integers. Default value: 1.

first:

When necessary, sets a class name in the navigation list. The class name makes it clear that the list is the navigation's or navigation element's first element.

Allowed values: string

start:

Defines the product category's hierarchy level from which printing starts.

Allowed values: integers.

E.g. with the value start:2 prints product categories starting from level 2 onwards.

sort:

Sorts the product category list in a desired manner.

Allowed values:

  • 'manual': uses the order defined in the admin panel (default value)
  • 'name_asc': alphabetical order based on product categories' names
  • 'name_desc': reversed alphabetical order
classes:

Class names that are given to every list element.

Allowed values: class names as strings.

Use space characters to separate the classes that are to be given to the same element. Use pipes to separate the classes that are to be given to different list elements.

E.g. classes:'firstClass secondClass | everyOthersClass everyOthersSecondClass'

See also detailed instructions on how to define list class names.

before/after:

With the before and after attributes, you can define content that is output before or after the content produced by the tag.

Allowed values: text that may contain HTML and Interface markup.

E.g.

  • before: '<p>This markup appears before the tag's own content.</p>'.
  • after: '<p>This appears after the tag's own content.</p>'

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

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: text that may contain HTML and Interface markup.

E.g. or:'Content not found.'