Logiciel libre de gestion de contenus pour Internet

Accueil > Documentation > Maquetter les modèles de pages Agora > Principes généraux pour réaliser vos modèles de page > Le principe des boucles

Le principe des boucles

Les boucles permettent, en une commande simple, d’extraire une sélection de données issues de la base de données. Cela permet de s’affranchir des connaissances de PHP et de SQL habituellement nécessaires à ce type de travail.

La syntaxe générale est :

<BOUCLE_nom(TYPE) {critere1} ... {critereN}>
#BALISE et code HTML
</BOUCLE_nom>

La boucle prenant place dans une page HTML, sa séquence <BOUCLE>...</BOUCLE> est naturellement analogue aux balises HTML.

  • BOUCLE_nom est la déclaration initiale de boucle et le nom que vous lui donnez. La fin de boucle sera donc désignée par /BOUCLE_nom. BOUCLE est le mot réservé.
    _nom est le nom que vous attribuez librement à la boucle : ce peut être un nom alphabétique séparé de BOUCLE par un tiret bas « _ », ou un nombre (qui peut être accolé à BOUCLE).
  • TYPE indique la table de données sur laquelle vous allez réaliser l’extraction : ARTICLES, AUTEURS, RUBRIQUES, BREVES...
  • critere permet de filtrer les résultats, les ordonner et les trier. Les critères sont optionnels et cumulables.
  • BALISE est le nom d’un élément collecté dans la table de données.
    Ainsi #TITRE dans une boucle de type ARTICLES permettra d’afficher le titre d’un article donné.

En d’autres termes, nous affichons le contenu du champ #BALISE de la table (TYPE) filtré et trié selon les {criteres} de manière itérative en BOUCLE.

Plan du site  |  Aide  |  Mentions Légales  |  © République Française SIG 2004-2006