thumb_list

Generate a list of content based on the type specified

Example

[%thumb_list type:'products' template:'' filter_category:'' limit:'10'%]
    [%param *header%]
        All Products
    [%/param%]
    [%param *footer%]
    [%/param%]
    [%param *ifempty%]
        No Results Found
    [%/param%]
[%/thumb_list%]

Usage

A thumb_list tag is a versatile tag that will generate a list of content based on the parameters specified, from products to content. The wide variety of results and options are dictated by the parameters selected for the tag, see below for more samples of common thumb_list configurations or inspect the full list further down.

Splitting out parameters

What do you do if you want to do something fancy like use logic to determine a body template or a custom config to filter SKUs? Split out your parameter! This can be done on most Maropost Commerce Cloud tags and is something we already do for params like *header & *footer.

To do this, simply take the param you want to split out from the tag and format like in this example where we perform so logic to determine our if statement:

[%thumb_list type:'products' filter_category:'' limit:'10'%]
    [%param template%]
        [%if [@name@] eq 'Shirts'%]
            shirt_template
        [%else%]
            default
        [%/if%]
    [%/param%]
...

Template parameter

If you use the *body parameter to define what each product or page does in your list you won't need to use this, however best use is relying on a template file here so you can easily modify things like product and content site-wide.

There are two types of templates this loads based on content type. If the thumb_list calls product data via something like products, it will load the template.html default located via Skeletal/thumbs/product/template.html. Everything else is considered a content type, so will load Skeletal/thumbs/content/template.html.

If you want to use a custom template, you'll need to first name your template using our traditional convention, mycustomthumb.template.html then call it using just the name of your template in the template param, template:'mycustomthumb'.

Types & Content Types

What's the difference? Types specify an overall table in Maropost Commerce Cloud, such as products, orders or content. Content types specify the individual content type under the content specific. So just like our blog example, first you need to select the type:'content' then specifically the blogs, content_type:'blog' based on the ID.

Pagination

The pagination tag will automatically set a number of pages based on the total results of the thumb list divided by the limit parameter. The paging tag needs to either be placed in the *header or *footer parameters.

<ul>
    [%paging limit:'3'%]
        [%param *previous_page%]
            <li><a href="[@URL@]">Previous Page</a></li>
        [%/param%]
        [%param *goback_pages%]
            <li><a href="[@URL@]">[@page@]</a></li>
        [%/param%]
        [%param *current_page%]
            <li class="active"><a href="[@URL@]">[@page@]</a></li>
        [%/param%]
        [%param *gonext_pages%]
            <li><a href="[@URL@]">[@page@]</a></li>
        [%/param%]
        [%param *next_page%]
            <li><a href="[@URL@]">Next Page</a></li>
        [%/param%]
    [%/paging%]
</ul>

Frequent issues

Your list not displaying the results you anticipated? Here's a few little things you can double check:

• For some thumb_list types, having a limit is mandatory. Ensure there is a limit param.
• Even if you are printing a thumb_list that isn't for a specific content type or category, you may still need to include an empty version of this parameter such as limit_category:'' or content_type:''.
• Does the list you are requesting have content that's valid to show? You can always use the *ifempty param to print content is your list doesn't return results.

Common use scenarios

Order thumb list

The order thumb_list will list orders, but only in the context of a specific user session. So the user must be logged in before an order thumb list can be generated and is then generated based on specifically that user.

[%thumb_list type:'orders' limit:'10' /%]

Content thumb list

The content thumb_list typically needs a few specifications such as the type and content_type tags. This is commonly used for things like blog, article & basic content indexes and lists. The following will output all blog posts within the parent of Blog (default ID of 72).

[%thumb_list type:'content' content_type:'blog' filter_content:'' filter_category:'72' template:'' limit:'10' /%]

Related content

Remember that for content to be related, you need to link both pages together on the "related" section.

[%thumb_list type:'content' content_type:'' template:'' filter_category:'' filter_content:'[@content_id@]' limit:'10' /%]

Parameters

type:'' parameter options

Data Tags (header / footer)

Data Tags (body)

Click on the type:'' below to display the returned fields.

Note: This is a work in progress. Not all types are currently documented.