Spip : Les boucles

Un langage particulier est utilisé dans les squelettes afin de communiquer avec la base de données.

Ce système permet de manipuler chaque élément d'une rubrique ou d'un article (le logo de la rubrique ou de l'article, le titre, le sur titre, le sous titre, la description, le contenu, etc…).

Voici un exemple d'utilisation des boucles :

Exemple

<ul>
<BOUCLE_bouclelistelesarticles(ARTICLES) {id_rubrique} {par date}>
    <li>
        <h3 class="titre"><a href="#URL_ARTICLE">#TITRE</a></h3>
    </li>
</BOUCLE_bouclelistelesarticles >
</ul>

L'exemple ci-dessus permet d'afficher le titre de l'article avec un lien vers la page. Les boucles prennent en paramètres plusieurs critères :

• bouclelistelesarticles: Nom de la boucle
• ARTICLES : Indique que l'on va boucler sur des articles. Il existe aussi la boucle RUBRIQUES, MOTS, etc…
• {id_rubrique} : Indique que l'on veut les articles d'une rubrique particulière (cette boucle doit être placé dans une boucle RUBRIQUES afin de sélectionner la rubrique).
• {par date} : Signifie que les résultats doivent être triés par date.

La plupart des champs d'une table peut être affiché par le biais de la syntaxe #NOM_DU_CHAMP. (Il existe beaucoup de critères pour les boucles.)

De plus il est possible de faire des tests "si alors sinon" avec les boucles:/p>

<B_test>
    // Traitement effectué avant la boucle si elle renvoie des résultats (si des articles sont trouvés)
    <BOUCLE_test(ARTICLES) {id_rubrique}>
        // Traitement de cette partie effectué si des articles sont trouvés dans cette rubrique.
    </BOUCLE_test>

// Traitement effectué après la boucle si des articles ont été trouvés.
</B_test>
// Traitement effectué si il n'y a pas eu de résultat.
<//B_test>