Syntaxe
Les boucles s'inscrivent directement dans les pages HTML (template)
La syntaxe simplifiée d’une boucle est la suivante :
<THELIA_nomboucle type=”TYPE_DE_BOUCLE“ arg1=“val1“ arg2=“val2“ arg3=“val3“> Code HTML + Paramètres sortants de THELIA </THELIA_nomboucle>
nomboucle correspond au nom de votre boucle. Il est judicieux de le déterminer en fonction de l'utilisation de cette boucle.
Attention : chaque boucle doit avoir un nom unique et chaque boucle ouverte doit obligatoirement être fermée </THELIA_nomboucle>.
TYPE_DE_BOUCLE correspond au type de boucle que nous voulons utiliser.
Par exemple : les produits, les rubriques, les contenus.
Attention à la casse de THELIA qui doit être en lettre capitale.
Les boucles acceptent des arguments en entrée qui permettront de filtrer les résultats. Ils correspondent à arg1, arg2, arg3 ci-dessus.
Chaque boucle propose des informations sortantes provenant de la base de données ou d'un traitement particulier.
Découvrez un exemple concret de boucles : Afficher un produit
Voici une vidéo pour illustrer ces propos http://vimeo.com/24778541
Si vous désirez proposer une alternative dans le cas où une boucle ne retourne aucun résultat, veuillez étudier Les boucles conditionnelles.
Besoin d'un compteur dans vos boucles ?
Depuis Thelia 1.5, chacune des boucles propose la variable #__COMPTEUR__, qui retourne le numéro d'itération courante de la boucle, en partant de 1.
Combien de résultats ont été remontés ? Depuis Thelia 1.5.2, #__NOMBRE__ renvoie le nombre total de résultats retournés par la boucle.