Vitrin's Jinja Extensions
Our theme templating is based on Jinja with a small set of platform tags, filters, and macros layered on top to make theme development fast, safe, and consistent.
Overview#
Base layout: all templates must extend layout.jinja (provided by the system).
Defaults: any missing template/section falls back to Zid’s default theme.
Settings: never hardcode styles or copy; read from settings (JSON Schema).
Components: use platform macros (primitive UI) instead of custom markup.
Versioning: features are versioned; no breaking changes within a major version.
Errors: server errors are handled by the SDK, not by themes.
Quick helpers available in templates.| Tag | Purpose Status | Type |
|---|
url_for | Build a canonical URL for a route | Macro |
asset_url | Resolve a theme asset CDN URL | filter |
image_url | Resolve and resize images CDN URL | Macro |
using url_for#
Build URLs without hardcoding paths; instead using an operation name. this respects locale and routing rules.existing Operation names#
the required path variables can be found with the endpints documentation| Constant | Value |
|---|
| CHANGE_LOCALE | change_locale |
| LIST_PRODUCTS | list_products |
| PRODUCT_REVIEWS | product_reviews |
| ADD_PRODUCT_REVIEW | add_product_review |
| PRODUCT_QUESTIONS | product_questions |
| ADD_QUESTION | add_question |
| PRODUCT_DETAILS | product_details |
| LIST_CATEGORIES | list_categories |
| CATEGORY_DETAILS | category_details |
| PROFILE | profile |
| UPDATE_PROFILE_PAGE | update_profile_page |
| ORDERS | orders |
| ADDRESSES | addresses |
| WISHLIST | wishlist |
| LOYALTY_PROGRAM | loyalty_program |
| ADD_ADDRESS | add_address |
| EDIT_ADDRESS | edit_address |
| UPDATE_EMAIL_PAGE | update_email_page |
| REGISTER_PAGE | register_page |
| LOGIN_PAGE | login_page |
| VERIFICATION_PAGE | verification_page |
| CART_PAGE | cart_page |
| SINGLE_PAGE_CHECKOUT | single_page_checkout |
| CHOOSE_SHIPPING | choose_shipping |
| CHOOSE_PAYMENT | choose_payment |
| ORDER_INVOICE | order_invoice |
| ORDER_COMPLETED | order_completed |
| TRANSACTION_SLIP_UPLOAD | transaction_slip_upload |
| HOME | home |
| PAGES | pages |
| BLOGS | blogs |
| FAQS | faqs |
| SHIPPING_PAYMENT | shipping_payment |
| LANDING_PAGE | landing_page |
| AFFILIATE_REPORTS | affiliate_reports |
| SITEMAP_XML | sitemap_xml |
| PRODUCTS_FEED | products_feed |
| PRODUCTS_REVIEWS_FEED | products_reviews_feed |
asset_url#
Return a versioned CDN URL for an asset.Modified at 2026-02-17 07:02:10
