The @config
property provides access to global data properties, which are available anywhere in your theme.
Specifically @config
will pass through the special theme config that is added in the theme’s package.json
so that it can be used anywhere in handlebars.
At the moment, there is only one property which will be passed through:
{{@config.posts_per_page}}
– the number of posts per page
Example Code
Standard usage:
<a href="{{page_url "next"}}">Show next {{@config.posts_per_page}} posts</a>
In the get helper limit field:
{{#get "posts" filter="featured:true" limit=@config.posts_per_page}}
{{#foreach posts}}
<h1>{{title}}</h1>
{{/foreach}}
{{/get}}
Providing config
Config values can be provided by adding a config
block to package.json
{
"name": "my-theme",
"version": 1.0.0,
"author": {
"email": "my@address.here"
}
"config": {
}
}
Inside of the config block, there is currently a single supported property - posts_per_page
.
{
"name": "my-theme",
"version": 1.0.0,
"author": {
"email": "my@address.here"
}
"config": {
"posts_per_page": 10
}
}