Une boucle déclare donc – en général – une table SQL, sur laquelle extraire les informations, ainsi que des
critères
de sélection.
<BOUCLE_nom(TABLE){critere}{critere}>
... pour chaque réponse...
</BOUCLE_nom>
Une boucle possède obligatoirement un nom (identifiant unique à l’intérieur d’un même squelette), ce nom est accolé au mot
BOUCLE
. Ici donc, le nom de la boucle est « _nom ».
La table est définie soit par un alias (alors écrit en majuscules), soit par le nom réel de la table dans sa véritable casse, par exemple « spip_articles ».
Les critères sont écrits ensuite, entre accolades, par exemple
{par nom}
pour trier les résultats dans l’ordre alphabétique selon le champ « nom » de la table SQL en question.
Exemple
Cette boucle liste toutes les images publiées du site. Le critère
{extension IN jpg,png,gif}
permet de sélectionner les fichiers possédant une extension parmi les trois listées.
<BOUCLE_documents(DOCUMENTS){extension IN jpg,png,gif}>
[(#FICHIER|image_reduire{300})]
</BOUCLE_documents>
La balise
#FICHIER
contient l’adresse du document, auquel on applique un
filtre
nommé « image_reduire » qui redimensionne l’image automatiquement à 300 pixels si sa taille est plus grande et retourne une balise HTML permettant d’afficher l’image (balise
<img>
)