Notice: You are browsing the documentation for PrestaShop 9, which is currently in development.
You might want to read the documentation for the current version, PrestaShop 8. Read the current version of this page
PrestaShop provides several smarty helper functions and modifiers.
The {form_field}
function will help you build forms while keeping the form markup consistent. It can be compared to the back office helpers introduced in PrestaShop 1.5.
As a template designer you will find the markup of each elements in _partials/form-fields.tpl
.
{form_field field=$field}
…where $field
is an array, like this example:
<?php
$field = [
'name' => 'user_email',
'type' => 'email',
'required' => 1,
'label' => 'Email',
'value' => null,
'availableValues' => [],
'errors' => [],
];
The {hook}
function invokes a given named hook and displays its content (if any is returned).
{hook h="displayBeforeSomething"}
Although not recommended, you can execute a hook for a specific module as well:
{hook h="displayBeforeSomething" mod="mysupermodule"}
You can choose to exclude some modules, which won’t be notified of the hook:
{hook h="displayBeforeSomething" excl="foreveralone,derpmodule"}
The {l}
function allows you to insert translated text in your template using the Translation system.
This function takes the following of arguments:
Name | Required | Type | Example | Description |
---|---|---|---|---|
s |
Yes | String | "Some text" |
Message to translate. |
d |
String | "Modules.Mymodule.Shop" |
Translation domain (when using the new translation system). | |
mod |
String | "mymodule" |
Module name (when using the legacy translation system). | |
sprintf |
Array | ['replacement1', ...] |
Values to replace in the translated message. | |
js |
Bool | true | [Deprecated] If true, slashes are added to escape quotes. Doesn’t work when d is present. |
Here are some examples:
{l s="This is a text" d="Admin.Shipping.Feature"}
{l s="This is a text with a %s" d="Admin.Shipping.Feature" sprintf=[$replacement]}
{l s="This is a legacy text" mod="somemodule"}
If you need to escape quotes in the translated text, do it like this:
<script type="text/javascript">
var thisIsAString = '{l|escape:"javascript" s="Don't do this at home" d="Modules.Mymodule"}';
</script>
This function renders the specified template. Some variables coming from the controller might need to be passed to this function.
So far, it is only used for forms (customer information and checkout).
{render file="customer/_partials/login-form.tpl" ui=$login_form}
This helper is used to generate URLs.
This will take care of the HTTP scheme (http
or https
), domain name, virtual and physical base URI, parameters concatenation, and URL rewriting.
{url}
uses the Link
component.
$urls
dataset to find already regenerated urls (such as home, cart, login and so on).{url}
instead.Entity | Required parameters | Optional parameters |
---|---|---|
supplier | [‘id’ => int] | |
language | [‘id’ => int] | |
product | [‘id’ => int] | [‘category’ => int, ’ean13’ => string, ‘ipa’ => int] |
category | [‘id’ => int] | [‘selected_filters’ => array] |
categoryImage | [‘id’ => int] | [‘selected_filters’ => array, ’type’ => int] |
manufacturer | [‘id’ => int] | |
manufacturerImage | [‘id’ => int] | |
supplierImage | [‘id’ => int] | |
cms | [‘id’ => int] | |
module | [‘id’ => int, ’name’ => string] | [‘controller’ => string, ‘params’ => array] |
sf | [‘route’ => string] | [‘sf-params’ => array] |
and all other ObjectModel
based entities (address
, …).
id
is almost always required to generate URLs, except for the sf
helper, where route
is the required parameter.
Other parameters have default values and can be overridden, e.g.:
$default = [
'id_lang' => $context->language->id,
'id_shop' => null,
'alias' => null,
'ssl' => null,
'relative_protocol' => true,
'with_id_in_anchor' => false,
'extra_params' => [],
'add_anchor' => true,
];
Examples:
{url entity=address id=$id_address}
{url entity=address params=['id_address' => $id_address]}
{url entity=address id=$id_address params=['delete' => 1]}
{url entity='sf' route='admin_module_manage' sf-params=['foo' => 'bar']}
Will respectively output:
http://prestashop.ps/it/address?id_address=3
http://prestashop.ps/it/address?id_address=3
http://prestashop.ps/it/address?id_address=3&delete=1
http://prestashop.ps/it/admin/module/manage
PrestaShop 1.7 introduced a new way to display modules in a theme, called Widgets. Instead of using a hook and hooking your module to it, the widget functions allow you explicitly manipulate your module from a template.
Avoid using this feature if you can.
While this can be useful in some situations, it effectively couples your template to a module, which is not a good practice. Use it with care.
This function lets you display content from the module in your template.
Here is an example from classic theme, it displays the shop contact details wherever you want.
<div id="sidebar">
{widget name="ps_contactinfo"}
</div>
Since the module may have a different behavior depending on which hook they are hooked on, you can pass the hook name.
<div id="footer">
{widget name="ps_contactinfo" hook="displayFooter"}
</div>
Even better, you can rewrite the template on the go. The module will use your Smarty code instead of loading the template file.
Taking the Link list module as an example.
Instead of redefining ps_linklist/views/templates/hook/linkblock.tpl
(source), you can override it this way:
{widget_block name="ps_linklist"}
{foreach $linkBlocks as $linkBlock}
<ul>
{foreach $linkBlock.links as $link}
<li>
<h4><a href="{$link.url}">{$link.title}</a></h4>
<p>{$link.description}</p>
</li>
{/foreach}
</ul>
{/foreach}
{/widget_block}
In order to use the data from controller to generate class names, we added 2 modifiers: classname
and classnames
.
The classname
data modifier will ensure that your string is a valid class name.
It will:
{assign var=attr value='Hérè-Is_a-Clà ssnåme--@#$$ˆ*(&-----'}
{$attr|classname}
…will output:
here-is_a-classname
This data modifier takes an array, where the key is the class name and the value is a boolean indicating if it should be outputted or not.
Note that each class name is passed through the classname
modifier.
<?php
$body_classes = [
"lang-fr" => true,
"rtl" => false,
"country-FR" => true,
"currency-EUR" => true,
"layout-full-width" => true,
"page-index" => true,
];
This way, this Smarty code:
<body class="{$page.body_classes|classnames}">
…will generate:
<body class="lang-fr country-fr currency-eur layout-full-width page-index">