Prints a list of product bundles that have been set as visible in the product category.

Kuvaus

Product bundles are set to be visible in a product category on the product card'sProduct bundles tab in the Publish menu of a product bundle.

You can also print a list of product bundles in a product category by using the {Bundles} tag's category attribute.

Explore the product bundles also in the merchant's guide.

See also detailed instructions for implementing the product bundle feature in the online store theme.

Syntaksi

{CategoryBundles( classes: string, filters: string, helper: string, limit: int, product: int, sort: string, type: string )}

Näkyvyys

Toimii näkyvyydessä: tuoteryhmä

Näkyvyyshelper-attribuutissa: tuotepaketti

The required scope is always set in the following templates:

Templates
Product list
Display window
Front page

Attribuutit

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.

filters:

Sets filters for displaying on the list only those product bundles that meet certain criteria.

Allowed values: 'featured' (fetches only the product bundles that were marked as featured)

E.g. filters:'featured'

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.

limit:

Sets the maximum length of the output list.

Allowed values: integers.

E.g. limit:3

product:

Fetches only those product bundles that contain the product with the indicated ID number.

Allowed values: integers.

E.g. product:1

sort:

Defines the sorting criteria for the list.

Allowed values:

  • 'name_asc': in alphabetical order based on names (A-Z)
  • 'name_desc': in reverse alphabetical order based on names (Z-A)
  • 'released_asc': date added (oldest first)
  • 'released_desc': date added (newest first)
  • 'random': random order
  • 'sales_asc': least often sold items first
  • 'sales_desc': best-selling items first
type:

Defines the list's output format.

The attribute is used only if the helper attribute hasn't been set. In this case, the type attribute does not need to be set separately, as it is automatically applied.

Allowed values: 'normal':

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.'