We have done our best in Thelia 2.1 to provide backward compatibility with Thelia 2.0. However, you’ll have to make minor changes to your templates to make use of new features.



the smarty function token_url was introduced in Thelia 2.0 but since Thelia 2.1 it is mandatory to use it when you want to submit data with a GET method, either with an URL or with a form that uses the GET method. This function add a single token at the end of your url preventing CSRF attack.

Here is the list of templates you have to modify :

  • cart.html :
    • form action for quantity update <form action="{token_url path="/cart/update"}"
    • link for removing a cart item : ` <a href=”{token_url path=”/cart/delete/$ITEM_ID”}”>`
  • mini-cart.html
    • link for removing a cart item : <a href="{token_url path="/cart/delete/$ITEM_ID"}">


set_previous_url is a new smarty function and allow to not save the current Url in the navigation history with the ignore_current parameter set to 1.

It is useful for template page like register, password or even login because you can return on this page is the form contains error and this url will be save in the history and use for the success_url.

exemple :

{set_previous_url ignore_current="1"}

new template pages

  • error.html : display an error message instead of a blank page if an error occurred. set error_message.show config value to 1 if you want to use this feature.
  • account-order.html : display an order details. Of course you have to create a link to this page. You can see the account.html template in the default template for an exemple.


Hooks are new features in Thelia 2.1. It is not mandatory to use them, you can still use your current template without hooks. But if you don’t use them, maybe some modules developed for Thelia 2.1 will not work with your template because they use Hooks.

The documenation explain how hooks work and contains the official list of all hooks : Hook documentation