Programmer avec SPIP 3.0
Documentation technique sur SPIP 3.0

> > > > Syntaxe des boucles

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.

  1. <BOUCLE_nom(TABLE){critere}{critere}>
  2. ... pour chaque réponse...
  3. </BOUCLE_nom>

Télécharger

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.

  1. <BOUCLE_documents(DOCUMENTS){extension IN jpg,png,gif}>
  2. [(#FICHIER|image_reduire{300})]
  3. </BOUCLE_documents>

Télécharger

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