A propos des templates : Différence entre versions

Version actuelle en date du 8 février 2013 à 19:39

Vous découvriez dans cette section le fonctionnement des templates Thelia.

Les templates, qu'est ce que c'est ?

Les templates sont des fichiers, le plus souvent HTML, qui constituent le front-office (ou F.O. ou front) présentés aux visiteurs de votre boutique.

En plus du code spécifique (HTML, XML, CSV, ou ce que vous voudrez), un template comporte les éléments qui permettent de mettre en œuvre les fonctions proposées par Thelia : boucles, filtres, substitutions, etc.

Thelia vous propose un jeu de template de base qui comporte tous les templates nécessaires au fonctionnement de votre boutique.

Comment ça marche ?

A partir de Thelia 1.5, les fichiers templates sont rangés dans le répertoire 'template', qui figure à la racine de votre installation Thelia. Toujours à la racine, se trouve le fichier index.php, qui a pour rôle de charger un template HTML et de le soumettre au moteur de Thelia. Le moteur se charge de fabriquer le fichier HTML qui sera envoyé au navigateur des visiteurs de vos boutiques.

Le moteur traite vos templates dans l'ordre suivant :

1) Traitement des actions: une action est déclenchée par vos visiteurs. L'action est un paramètre de l'URL, ou d'un formulaire. Mis à part naviguer d'une page à l'autre, Thelia propose les actions suivantes :

• ajouter : ajouter un article au panier
• supprimer : supprimer un article du panier
• modifier : modifier la quantité commandée d'un article présent dans le panier
• connexion : connexion du client à son compte, avec son email et son mot de passe
• deconnexion : déconnexion du client.
• paiement : choix du moyen de paiement, et déclenchement du paiement d'une commande.
• transport : choix du mode de transport
• creercompte : création d'un nouveau compte client
• modifiercompte : modification des informations liées au compte client.
• creerlivraison : création d'une nouvelle adresse de livraison
• supprimerlivraison : suppression d'une adresse de livraison.
• modifierlivraison : modification d'une adresse de livraison existante.
• modadresse : sélection de l'adresse de livraison à utiliser pour une commande
• codepromo : utilisation d'un code promotion sur une commande
• chmdp : demande d'un nouveau mot de passe.
• modifiermotdepasse : modification du mot de passe (depuis Thelia 1.5.2)

2) Inclusions des templates (traitement de #INCLURE).

3) Traitement des substitutions simples.

4) Traitement des balises.

5) Traitement des boucles simples et conditionelles.

6) Traitement des filtres.

A l'issue de ces étapes, tous les éléments Thelia ont été traités, et le template maintenant uniquement constitué de HTML (ou XML, ou ce que vous voudrez) est envoyé au navigateur.

Ajouter un template

Pour ajouter un template, il suffit de créer un fichier dans le répertoire 'template', et d'y placer ce que vous voulez. Vous pouvez créer un lien vers votre template à l'aide de la substitution #URLFOND(). Par exemple, si vous créez le template informations.html, vous pourrez créer n'importe où dans votre boutique un lien vers ce template comme ceci :

  <a href="#URLFOND(informations)">Les informations</a>

Autre possibilité (obligatoire en 1.5.0) :

  <a href="#VARIABLE(urlsite)/?fond=informations">Les informations</a>

En procédant ce cette manière, votre template sera soumis au moteur Thelia: vous pouvez donc y placer des boucles et tous les autres éléments du méta-langage Thelia.

Attention : Si vous créez un lien direct vers le template, comme ci-dessous, il ne sera pas interprété par le moteur Thelia :

 <a href="template/informations.html">Les informations</a>

Pour continuer, voyez Les paramètres optionnels que vous pouvez indiquer dans un template.

Retour à l'Accueil.