Die MOTS-Schleife gibt eine Liste von Schlagwörtern zurück.
<BOUCLEn(MOTS){Kriterien...}>Die Auswahl-Kriterien
Man kann das eine oder andere der folgenden Kriterien verwenden, um anzugeben, wie die Elemente ausgewählt werden sollen.
- {tout} Die Wörter werden aus der gesamten Site ausgewählt.
- {id_mot} gibt das
Schlagwort zurück, dessen Identifizierer id_mot ist.
- {id_groupe} gibt die
Schlagwörter zurück, die zu einer Gruppe von Wörtern gehören, deren Nummer id_groupe ist [SPIP 1.4].
- {id_article} gibt die Schlagwörter zurück, die mit dem betreffenden Artikel verbunden sind (das ist die häufigste Verwendung dieser Art Schleife).
- {id_rubrique} gibt die Schlagwörter zurück, die mit einer Rubrik verbunden sind [SPIP 1.4].
- {id_breve} gibt die Schlagwörter zurück, die mit einer Meldung verbunden sind [SPIP 1.4].
- {id_syndic} gibt die Schlagwörter zurück, die mit einer verlinkten Site verbunden sind [SPIP 1.4].
- {id_forum} gibt die Schlagwörter zurück, die mit einer Nachricht aus einem Forum verbunden sind [SPIP 1.4] (Vorsicht, sehr spezielle Verwendung).
- {titre=frankreich} gibt das Schlagwort zurück, das (zum Beispiel) den Titel frankreich trägt.
- {type=land} gibt die
Schlagwörter aus einer Schlagwörter-Gruppe zurück, die (zum Beispiel) den Titel land trägt.
Die Anzeige-Kriterien
Es können die allen Schleifentypen gemeinsamen Kriterien angewandt werden.
Die Tags dieser Schleife
- Die aus der Datenbank entnommenen Tags
Die folgenden Tags korrespondieren mit Elementen, die direkt aus der Datenbank entnommen werden. Sie können sie auch als Sortier-Kriterien verwenden (für gewöhnlich: {par titre}).
- #ID_MOT zeigt den unverwechselbaren Identifizierer des Worts an.
- #TITRE zeigt den Titel an (das Schlagwort selbst).
- #DESCRIPTIF ist die Beschreibung des Worts.
- #TEXTE ist der mit dem Wort verbundene Text.
- #TYPE ist die Kategorie, in der das betreffende Schlagwort installiert ist (beispielsweise könnte das Schlagwort «Frankreich» mit der Kategorie «Land» verbunden sein).
- #LOGO_MOT [SPIP 1.4] zeigt das mit dem Schlagwort verbundene Logo an.
- #URL_MOT gibt die Adresse (URL) des Worts an.
Die (GROUPES_MOTS)-Schleife
Obwohl sie selten verwendet wird, verdient die GROUPES_MOTS-Schleife [SPIP 1.5] eine Erwähnung: wenn Sie mehrere Gruppen von Schlagwörtern haben, erlaubt sie Ihnen eine Auswahl dieser Gruppen, wodurch Sie beispielsweise eine zusammenfassende Seite aller Schlagworte in Gruppen eingeteilt aufstellen können, innerhalb der einzelnen Gruppen in alphabetischer Reihenfolge; beispielsweise mit dem folgenden Code:
<BOUCLE_groupes(GROUPES_MOTS){par titre}>
<h1>#TITRE</H1>
<BOUCLE_mots(MOTS){id_groupe}{par titre}{" - "}>
#TITRE
</BOUCLE_mots>
</BOUCLE_groupes>
Die mit dieser Schleife verbundenen Tags und Kriterien sind:
- #ID_GROUPE, der Identifizierer der Schlagwort-Gruppe [ebenso in der (MOTS)-Schleife verfügbar];
- #TITRE, der Titel der
Gruppe [innerhalb der (MOTS)-Schleife können Sie #TYPE benutzen, um diesen Wert zu erhalten].