π»Reference
Global List of Categories
Outputting the Categories Data Variable as JSON
The following Liquid outputs a JSON object containing the details of all Categories:
{{context.exports.categories.data}}
This object stores every category in key-value pairs where the key is the ID of the Category and the value is an object containing all other available fields.
Accessing a specific Category via ID
As the Categories data Object is a key map, you can access any specific category by accessing the object and then passing in the Category's ID in square brackets:
{{context.exports.categories.data['1234']}}
Accessing a Category's Fields
Once you've accessed the value of that Category via it's ID, you can access that Category's Fields using dot notation. For example, here we'll access its name:
{{context.exports.categories.data['1234']}}.name}}
Other available fields are:
id
- the ID of the Categoryname
- the name of the Categoryparent
- the ID of the Parent Category if there is oneslug
- the end of the URL for the Category Detail Page which is unique to this Itemmeta_title
- the meta-title of the Categorymeta_desc
- the meta-description of the Categoryog_title
- the open graph title of the Categoryog_desc
- the open graph description of the Categoryog_type
- the open graph type of the Categorytwitter_type
- the twitter type of the Categoryfull_slug
- the full (relative) URL for the Category Detail Page
Looping over all Categories on the Site
If you wish to display all the Categories on the Site, you can loop over them all. Inside the For Loop you can display any HTML or Category fields you like.
If you want to skip any Categories, you can use Liquid if statements and the continue
tag to do this:
Filtering WebApps and Modules
See more here:
Category Detail Pages
Default Fields
The following tags are available within the Category Detail Layout:
You can use any of the Liquid which you can use on Pages in the Category Detail Layout:
Category Detail Pages give you additional features including Breadcrumbs, Parent Category Lists, Child Category Lists and more.
Breadcrumbs
Output breadcrumb of Categories to the current Category page using the defined layout:
Parent Category List
Output parent Categories using the defined layout:
Child Category List
Output child Categories using the defined layout:
Items in this Category
Output all items categorised to the current Category Page using the defined layout:
Note that this will only output items in this specific Category. To output all items that belong to sub-Categories, then add another parameter of show_all_sub_items: 'true'
.
Output Filtered WebApp, Module and Product Items in this Category
You can use the Category ID {{this.id}}
to filter WebApp, Module or Product Lists and display the Items with this Category assigned (and those belonging to Categories which are children of this Category).
We'll include some examples here of how the {{this.id}}
variable can be used specifically on the Category Detail Page to filter by that Detail Page's Category dynamically: Learn more about filtering WebApps and Modules by Category
Products
For example, the following code will output Products on the Category Detail Page, filtered by that Category:
WebApps
Change the ID to fetch different WebApps.
Modules
Module 3 refers to the Blog; you can change the ID to fetch different Modules.
WebApp and Module Layouts
To access the category which belongs to the item currently being outputted in a WebApp layout or a Module layout's item.liquid layout, access the category_array field in:
See more:
Last updated