-
Notifications
You must be signed in to change notification settings - Fork 1
Page Theme Settings
Fraser Harris edited this page Nov 8, 2015
·
10 revisions
Page theme_settings
are a JSON object constructed from the following. Everything is optional.
The "home" category is the category that is loaded by default.
"home": {
"category": string, // must match category-name in `categories`
"hero": tile ID // over-rules the home categories hero
},
Used if the category doesn't provide hero data
"defaults": {
"heroImage": image url, // optional
"mobileHeroImage": image url, // optional, over-rules heroImage on mobile
"heroTitle": string or HTML // optional, lower priority than HeroImages, a string of text
},
Categories and mobile categories are both display instructions for the category area as well as display instructions about the categories themselves. If not provided, the category area is not displayed.
"categories":{
... // category data
},
"mobileCategories":{
... // optional, over-rules categories on mobile
},
Category object format:
{
"name": string, // required, the DB name of the category
"tileSet": "products" or "content", // optional, filter on category
"displayName": string, // required, text to display in category list
"thumbnail": image url, // optional
"heroImage": image url, // optional
"mobileHeroImage": image url, // optional, mobile over-ride
"title": string or HTML, // optional, text to display in hero if no hero image
"subCategories":[
{
"label": string or HTML // helper label
},
{
... // sub-categories follow same format as a category
}
],
},
Categories or sub-categories can also be links:
{
"url": link, // required, takes priority over `name` if that is also provided
"name": string, // required for sub-categories, must be unique within this category
"displayName": string, // required, text to display in category list
"thumbnail": image url, // optional
},
Categories or sub-categories can also be containers for sub-categories:
{
"displayName": string, // required, text to display in category list
"thumbnail": image url, // optional
"subCategories":[
{
"label": string or HTML // helper label
},
{
... // sub-categories follow same format as a category
}
]
},
Control the feed display
"masonry":{
"forceGrid": boolean // Enables grid pattern. default: true
"tileAspectRatio": int, // Expected base tile aspect ratio. default: 0.7
"heightRange": int // Allowed variability around tileAspectRatio = +/- heightRange/2. default: 0.6
},
"tiles":{
"wideableTemplates":{
// format is "template": boolean
// default is false except "image": true
"image":true,
"product":true
},
"wideProbability": integer // default is 0.5
"openTileInHero": boolean // default: False
"openProductTileInPDP": boolean // default: False
},
"gaAccountNumber":"UA-23764505-25", // Google Analytics id for this store
"social_buttons":null,
"useAffiliateLinks":true, // toggle whether to use `affiliateLink` for click-outs, if available
"column_width":341,
"categoryHome":false,
"minImageWidth":400, // restriction on Image object (does not apply to specified urls)
"stickyCategories":true, // categories stick to top of page