Les variables globales de PrestaShop et Smarty

Si vous êtes développeur de thèmes PrestaShop, ou que vous souhaitez simplement modifier le thème par défaut, vous pourriez avoir besoin, par exemple, de variables qui contiennent les urls vers les dossiers de votre thème. Les développeurs de PrestaShop ont prévus le coup, car PrestaShop défini une liste assez longues de variables que vous pourrez utiliser en Smarty dans vos fichiers .tpl de vos thèmes !

Toutes ces variables sont définies, et donc disponibles, dans le fichier FrontController.php qui se trouve dans le dossier /classes/controller/FrontController.php.

PrestaShop 1.7

Voici la liste des variables disponibles dans vos fichiers .tpl :

{$currency.name} : Nom de la devise active
{$currency.iso_code} : code ISO de la devise (EUR pour Euro, USD pour Dollard…)
{$currency.sign} : symbole de la devise (€ pour Euro, $ pour Dollar…)
{$currency.iso_code_num} : numéro du code ISO de la devise

{$shop.name} : nom de la boutique
{$shop.email} : email de la boutique
{$shop.logo} : url du logo de la boutique
{$shop.favicon} : url du favicon de la boutique
{$shop.address.address1} : ligne 1 de l’adresse de la boutique
{$shop.address.address2} : ligne 2 de l’adresse de la boutique
{$shop.address.postcode} : code postal de l’adresse de la boutique
{$shop.address.city} : ville de l’adresse de la boutique
{$shop.address.state} : état de l’adresse de la boutique
{$shop..address.country} : pays de l’adresse de la boutique
{$shop.phone} : téléphone de la boutique
{$shop.fax} : fax de la boutique

{$language.name} : nom de la langue active
{$language.iso_code} : code ISO de la langue (fr pour Français, en pour Anglais, de pour Allemand…)
{$language.language_code} : code de la langue (fr pour Français, en pour Anglais, de pour Allemand…)
{$language.is_rtl} : sens de lecture de la langue. Si le sens « droite à gauche » est actif, alors la valeur vaut 1, sinon 0.
{$language.format_lite} and {$ language.format_full} : format de date court et long de la langue (d/m/Y et d/m/Y H:i:s pour Français)
{$language.id} : ID de la langue

{$customer.lastname} : nom du client actif
{$customer.firstname} : prénom du client
{$customer.email} : email du client
{$customer.birthday} : date de naissance du client
{$customer.newsletter} : indique si le client est inscrit à la newsletter. La valeur vaut 1 si oui, 0 si non.
{$customer.newsletter_date_add} : date d’inscription à la newsletter
{$customer.ip_registration_newsletter} : adresse IP du client lors de sa souscription à la newsletter
{$customer.optin} : indique si le client souhaite recevoir les offres des partenaires. La valeur vaut 1 si oui, 0 si non.
{$customer.date_add} : date d’ajout du client
{$customer.date_upd} : date de dernière mise à jour du client
{$customer.id} : ID du client
{$customer.id_default_group} : ID du groupe par défaut du client auquel il est associé
{$customer.is_logged} : indique si le client est connecté. La valeur vaut 1 si oui, 0 si non.
{$customer.gender.name[$customer.gender.id]} : civilité du client
{$customer.addresses[Address ID].city} : ville du client de son adresse X
{$customer.addresses[Address ID].alias} : alias de l’adresse X du client
{$customer.addresses[Address ID].firstname} : prénom du client de son adresse X
{$customer.addresses[Address ID].lastname} : nom du client enregistré son adresse X
{$customer.addresses[Address ID].company} : nom de société du client de son adresse X
{$customer.addresses[Address ID].address1} : ligne 1 de l’adresse X du client
{$customer.addresses[Address ID].address2} : ligne 2 de l’adresse X du client
{$customer.addresses[Address ID].postcode} : code postal de l’adresse X du client
{$customer.addresses[Address ID].id_state} : ID de l’état de l’adresse X du client
{$customer.addresses[Address ID].state} : nom de l’état de l’adresse X du client
{$customer.addresses[Address ID].state_iso} : code ISO de l’état de l’adresse X du client
{$customer.addresses[Address ID].id_country} : ID du pays de l’adresse X du client
{$customer.addresses[Address ID].country} : nom du pays de l’adresse X du client
{$customer.addresses[Address ID].country_iso} : code ISO du pays de l’adresse X du client
{$customer.addresses[Address ID].phone} : téléphone de l’adresse X du client
{$customer.addresses[Address ID].phone_mobile} : téléphone mobile de l’adresse X du client
{$customer.addresses[ID Address].dni} : ID de l’adresse X du client
{$customer.addresses[Address ID].vat_number} : numéro de TVA de l’adresse X du client
{$customer.addresses[Address ID].formatted} : adresse formaté du client

{$urls.base_url} : url de votre boutique PrestaShop, racine de votre site.
{$urls.current_url} : url de la page où vous vous trouvez sur votre boutique.
{$urls.shop_domain_url} : nom de domaine de votre boutique
{$urls.img_ps_url} : url vers le dossier des images situé à la racine de votre installation PrestaShop : /img.
{$urls.img_cat_url} : Url vers le dossier des images des catégories de votre installation PrestaShop : /img/c.
{$urls.img_lang_url} : Url vers le dossier des images des langues de votre installation PrestaShop : /img/l.
{$urls.img_prod_url} : Url vers le dossier des images des produits de votre installation PrestaShop : /img/p.
{$urls.img_manu_url} : Url vers le dossier des images des marques de votre installation PrestaShop : /img/m.
{$urls.img_sup_url} : Url vers le dossier des images des fournisseurs de votre installation PrestaShop : /img/su.
{$urls.img_ship_url} : Url vers le dossier des images des transporteurs de votre installation PrestaShop : /img/s.
{$urls.img_store_url} : Url vers le dossier des images des boutiques de votre installation PrestaShop : /img/st.
{$urls.img_url} : Url vers le dossier images situé dans votre thème actif : /themes/votretheme/assets/img.
{$urls.css_url} : Url vers le dossier des fichiers CSS situé dans votre thème actif : /themes/votretheme/assets/css.
{$urls.js_url} : Url vers le dossier des fichiers JS situé dans votre thème actif : /themes/votretheme/assets/js.
{$urls.pic_url} : Url vers le dossier des fichiers uploadé
{$urls.pages.address} : Url de la page Adresse (tel que défini dans les réglages SEO de votre installation PrestaShop)
{$urls.pages.addresses} : Url de la page Mes adresses
{$urls.pages.authentication} : Url de la page Connexion
{$urls.pages.cart} : Url de la page Panier
{$urls.pages.category} : Url des Catégories
{$urls.pages.cms} : Url des pages CMS
{$urls.pages.contact} : Url de la page Contact
{$urls.pages.discount} : Url de la page Remise
{$urls.pages.guest_tracking} : Url de la page Suivi de commande invité
{$urls.pages.history} : Url de la page Historique de vos commandes
{$urls.pages.identity} : Url de la page Identité (données personnelles du client)
{$urls.pages.index} : Url de la page d’accueil
{$urls.pages.my_account} : Url de la page Mon compte
{$urls.pages.order_confirmation} : Url de la page Confirmation de commande
{$urls.pages.order_follow} : Url de la page Suivi de commande
{$urls.pages.order} : Url de la page Commande
{$urls.pages.order_return} : Url de la page Retour de commande
{$urls.pages.order_slip} : Url de la page Avoir
{$urls.pages.pagenotfound} : Url de la page Page non trouvée (404)
{$urls.pages.password} : Url de la page Mot de passe oublié
{$urls.pages.pdf_invoice} : Url du pdf Facture
{$urls.pages.pdf_order_return} : Url du pdf Retour de commande
{$urls.pages.pdf_order_slip} : Url du pdf Avoir
{$urls.pages.prices_drop} : Url de la page Promotions
{$urls.pages.product} : Url de la page Produit
{$urls.pages.search} : Url de la page Rechercher
{$urls.pages.sitemap} : Url de la page Plan du site
{$urls.pages.stores} : Url de la page Magasins
{$urls.pages.supplier} : Url de la page Fournisseurs
{$urls.pages.register} : Url de la page Inscription
{$urls.theme_assets} : Url vers le dossier assets situé dans votre thème actif : /themes/votretheme/assets/.
{$urls.actions.logout} : Url de déconnexion

PrestaShop 1.6

Voici la liste des variables relatives aux urls et dossier de thème :

{$base_dir}
Url de votre boutique PrestaShop, racine de votre site. Cette variable se révèle très utile pour insérer des liens, car il est fortement déconseillé de mettre des liens absolus dans votre code, car si un jour vous devez changer d’hébergement ou de nom de domaine, vous n’aurez pas besoin de retoucher tous vos liens si vous avez utilisé cette variable ! Indispensable donc !

{$base_dir_ssl}
Identique à la variable précédente via le protocol https.

{$content_dir}
Url vers le dossier racine de votre boutique PrestaShop, elle peut changer selon les paramètres SSL. Elle est différente de {$base_dir}, car elle donne l’url complète jusqu’au dossier racine de votre site.

{$base_uri}
Identique à {$base_dir} sauf que si vous n’avez pas activer les urls simplifiés dans l’administration de PrestaShop, cette variable ajoute /index.php à la fin de l’url.

{$tpl_dir}
Chemin vers le dossier de votre thème actif de votre boutique PrestaShop.

{$img_dir}
Url vers le dossier images situé dans votre thème actif : /themes/votretheme/img.

{$css_dir}
Url vers le dossier des fichiers css de votre thème actif : /themes/votretheme/css.

{$js_dir}
Url vers le dossier des fichiers javascript de votre thème actif : /themes/votretheme/js.

{$img_ps_dir}
Url vers le dossier des images situé à la racine de votre installation PrestaShop : /img.

{$modules_dir}
Url vers le dossier des modules de votre installation PrestaShop : /modules. Cette variable est principalement utile pour le développement de module PrestaShop.

{$mail_dir}
Url vers le dossier des mails à la racine de votre site PrestaShop, /mails.

Les variables suivantes contiennent diverses informations utiles sur votre boutique PrestaShop :

{$shop_name}
Nom de votre boutique PrestaShop.

{$page_name}
Nom de la page actuelle, utilisé comme id sur la balise body de votre site PrestaShop. Exemple: « index » pour la page d’accueil.

{$lang_iso}
Code ISO du language actif actuel. Exemple : « fr ».

{$cart_qties}
Nombre total de produits présents dans votre panier actuel.

{$id_currency_cookie}
Numéro identifiant de la devise actuelle.

{$logged}
Booléen déterminant si le client actuel est connecté ou non. Cette variable est utile si vous souhaitez afficher des informations uniquement si le visiteur est enregistré et connecté. Exemple : {if $logged}Vous êtes connecté{/if}.

{$customerName}
Nom et prénom du client actuellement connecté. Cette variable peut être utile en collaboration avec la précédente pour afficher, par exemple, un message de bienvenue lorsque le client est connecté. Exemple : {if $logged}Bienvenue {$customerName}{/if}.

{$PS_CATALOG_MODE}
Booléen indiquant si, oui ou non, votre boutique PrestaShop est en mode catalogue. Lorsque le mode catalogue est activé, toutes les fonctionnalités de vente de la boutique sont désactivées.

{$priceDisplay}
Paramètre actuel de l’affichage des prix.

{$hide_left_column} et {$hide_right_column}
Booléens indiquant si la barre latérale gauche/droite est affichée ou non.

{$come_from}
Url de la page précédente.

Les variables ci-dessous sont des variables de type objet :

{$cart}
Objet « panier » créer par Prestashop. Cet objet contient tous les attributs de votre panier. Vous pouvez également exécuter des fonctions avec ce dernier.

{$link}
Objet permettant de gérer les liens de votre boutique PrestaShop. Exemple : {$link->getCategoryLink(3)} retournera l’url de la catégorie ayant comme identifiant la valeur 3.

{$cookie}
Objet « cookie » défini par PrestaShop. Il permet d’accéder à l’ensemble des valeurs qui sont stockés en cookies.

{$currency}
Objet des devises disponibles dans votre installation PrestaShop.

Voici les variables qui sont sous forme de tableau :

{$currencies}
Cette variable est un tableau contenant la liste des devises disponibles.

{$languages}
Cette variable est un tableau contenant la liste des langages disponibles dans votre boutique PrestaShop.