Syntaxe des boucles

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>)

Auteur Matthieu Marcillaud Publié le : Mis à jour : 12/03/23

Traductions : English, Español, français, Nederlands