Templates

Templates in Bitcart are powered by the Jinja2 templating engine. It means that you have the full flexibility of the templating engine.
There are currently 3 different templates you able to customize in Bitcart: notification, product and shop. Plus you are able to create custom-named templates for use with our future scripting language.
Check the example templates here​
For each of the objects, you are able to select a custom template.
The templates for an object are selected as per template selection rules​
Store default templates
HTML templates
In some places of Bitcart, it is possible to render templates as html files instead of plain text.
For example, in emails sent to customer on successful checkout, you could use default templates (or customized a bit) which are plain text, or instead, you could enable html template rendering and send your customers a beautiful email.
Currently html template rendering is available only in store emails sent to customer​
Note: if you enable html template rendering, default templates or any plain text templates will now render incorrectly, without new lines. So ensure to check that template rendering templates match the templates themselves.
You can check html templates examples here.
Available templates
Notification
Notification template is used when building the message to be sent via all configured notification providers to the merchant notifying of successful order (to start shipping, for example).
The are two variables passed:
store, containing the store this notification belongs to
invoice, containing the invoice that has been paid
You can use those two variables to build whatever message that fits the best for you.
The default template is the following:
New order from {{ invoice.buyer_email }}
An up-to-date version can always be found at this link​
Shop
Shop template is used when building the base message for a successful payment associated with a store. It may optionally include paid invoice products' templates.
The are two variables passed:
store is the store the invoice is associated with
products is a list of already rendered individual product's templates
You can use this template to provide some design for the order confirmation message sent to the buyer.
The default template is the following:
Welcome to our shop!
Thank you so much for your purchase!
Your summary is below:
{% for product in products %}
{{product}}
{% endfor %}
​
If you've got any questions, email us at {{store.email}}.
Best wishes, your {{store.name}}.
An up-to-date version can always be found at this link​
Product
Product template is used when building the message for each individual product. Normally it is included as part of the main store message sent to the customer upon successful payment.
There are 3 variables passed:
store is the store the product is associated with
product is the current product being processed
quantity is the quantity the customer has selected to buy
Note that, you can configure different templates for each product, or use the same template for all products.
The default template is the following:
Thanks for buying {{product.name}} x {{quantity|int}}!
{% if product.download_url %}
Your download link: {{product.download_url}}
{% else %}
It'll ship shortly!
{% endif %}
An up-to-date version can always be found at this link​
Last modified 1mo ago