Postman Support Center theme support for Zendesk v2 API. The post-zen theme consists of a set of templates, styles, a Javascript file used mainly for interactions and an assets folder. The theme is managed by the Postman Marketing Engineering Team.
When importing a theme to Zendesk Guide it will mainly look for the following files and folders:
templates/- contains all markup.style.css- contains all CSS.script.js- main script file.assets/- assets such as scripts or fonts.manifest.json- project metadata and settings.settings/- files to be used in settings inmanifest.json.
The styles that the Postman Support Center use in the theme are in the style.css file in the root folder.
Add assets as images and files to the assets/ folder and use them in your CSS and templates.
The assets will be uploaded to Zendesk CDN (theme.zdassets.com). You can read more about assets here.
For markup Zendesk Guide uses Handlebars and each template is stored in the templates/ folder.
The manifest.json contains theme metadata and allows you to define a group of settings for your theme that can then be changed via the UI in theming center.
You can read more about the manifest file here.
If you have a type variable of file, you need to provide a default file for that variable in the settings/ folder. This file will be used on the settings panel by default and users can upload a different file if they like.
For example, if you'd like to have a variable for the background image of a section, the variable in your manifest file would look something like this:
{
...
"settings": [{
"label": "Images",
"variables": [{
"identifier": "background_image",
"type": "file",
"description": "background image description",
"label": "background image label",
}]
}]
}And this would look for a file inside the settings/ folder named background_image.
To deploy to production, we use the Zendesk GitHub integration.