This reference gives you a quick guide to all the code you can use with the Blog, but some features are available to all Modules, see more:
The Blog uses standard module fields as well as it's own core fields:
As always, to use filtering on an included module layout, add the use_adv_search
parameter. To allow searching, add use_search
. These settings instruct this component to watch the URL for changes in URL parameters and will adjust results accordingly when the URL changes; forms, anchors or JS (for example, the SiteBuilder Live Updates API) can be used to change the URL and apply these.
(Requires use_adv_search
)
Include the Archive Layout (included in the default layout, or make your own) to list all available years or months containing blog posts.
Inside an archive layout, you have access to the following variables which can be looped over to find the months in which at least one blog post was published: blog_archive_years
and months_by_year
To apply filters, the URL must be given the following parameters:
A combination of range_gt
, range_gte
, range_lt
, range_lte
to set the date range to "range greater than", "range greater than or equal to" etc., in the format: %Y-%m-%d.
range_type
- an optional convention, you can set this to e.g. "between" or "month" so that you can interpret the URL accordingly when you arrive.
range_field
- is used in Events module, but not needed here. Default is to use release date for range field
(Requires use_adv_search
)
Include the following liquid to dynamically get a list of available Blog Categories for the User to select:
To apply filters, the URL must be given the following parameters:
category - to be given the value of one or more category IDs to filter by, comma separated.
(Requires use_adv_search
)
To apply filters, the URL must be given the following parameters:
module_field_3_4
- set to a valid Author's module item ID
author_name
- an optional convention making it easier to display this when arriving at the list.
Link to the page with a keyword
parameter in the URL to perform a search. (Requires use_search
)
Authors uses standard module fields as well as it's own core fields:
Field Name
Liquid Tag
Description
Title
{{ this['Title'] }}
name of the Author
Subtitle
{{ this['Subtitle'] }}
Job title or other short text about the Author
Description
{{ this['Description'] }}
Description of the Author
Image
{{ this['Image'] | asset_url }}
Image of the Author
Image Alt
{{ this['Image Alt'] }}
Image alt of the Author image
Linkedin URL
{{ this['LinkedIn URL'] }}
Linkedin profile URL of the Author
Facebook URL
{{ this['Facebook URL'] }}
Facebook profile URL of the Author
Twitter URL
{{ this['Twitter URL'] }}
Twitter profile URL of the Author
Instagram URL
{{ this['Instagram URL'] }}
Instagram profile URL of the Author
Pinterest URL
{{ this['Pinterest URL'] }}
Pinterest profile URL of the Author
Field Name
Liquid Tag
Description
Title
{{ this['Title'] }}
title of the Blog Post
Subtitle
{{ this['Subtitle'] }}
subtitle of the Blog Post
Description
{{ this['Description'] }}
list description of the Blog Post
Author - Syntax type 1 (Requires Authors Module)
data source of author. Parameters: author_layout: path to the folder containing author layouts. author_layout_type: name of author layout folder (containing wrapper and item files). author_id: Unique ID of the author for this item- can be dynamically passed in with this['Author']
.
Author - Syntax type 2 (Requires Authors Module) - The benefit of this syntax is that it should be more consistent with how other Modules are outputted on the Page
data source of author. Parameters: layout path to the folder containing author layouts within the blog module. type- name of the layout folder containing wrapper and item Liquid layout files. datasource - should be set to true to indicate that this module is a sub-module placed inside another module Layout. item_ids - indicates the unique ids of the Author items you want to display- can be dynamically passed in with this['Author']
Main Image
{{ this['Main Image'] }}
main image of the Blog Post
Main Image Alt
{{ this['Main Image Alt'] }}
main image alt tag of the Blog Post
List Image
{{ this['List Image'] }}
list image of the Blog Post
List Image Alt
{{ this['List Image Alt'] }}
list image alt tag of the Blog Post
Content
{{ this['Content'] }}
main content of the Blog Post
Category Array
{{ this.category_array }}
outputs comma-separated list of IDs for Categories this item belongs to.