Die FORUMS-Schleife gibt eine Liste der Nachrichten in den Foren zurück.
<BOUCLEn(FORUMS){Kriterien...}>
Die Auswahl-Kriterien
Man kann das eine oder andere der folgenden Kriterien verwenden, um anzugeben, wie die Elemente ausgewählt werden sollen.
- {id_forum} Die durch
id_forum identifizierte Nachricht wird zurückgegeben. Da die Identifizierer der Nachrichten unverwechselbar eindeutig sind, kann dieses Kriterium nur ein Resultat von einer oder keiner Nachricht zurückgeben.
- {id_article} gibt die Nachrichten zurück, die mit dem betreffenden Artikel korrespondieren.
- {id_rubrique} gibt die Nachrichten zurück, die mit der betreffenden Rubrik korrespondieren.
- {id_breve} gibt die Nachrichten zurück, die mit der betreffenden Meldung korrespondieren.
- {id_parent} gibt die Nachrichten zurück, die von einer anderen Nachricht abhängen. Unerläßlich für die Verwaltung von Threads in den Foren.
- {id_enfant} gibt die Nachricht zurück, von der die aktuelle Nachricht abhängt (erlaubt das «Hinaufsteigen» in der Hierarchie der Threads). (SPIP 1.3)
- {meme_parent} gibt die anderen Nachrichten zurück, die auf dieselbe Nachricht antworten wie die aktuelle Nachricht. (SPIP 1.3)
- {plat}: per Voreinstellung werden nur die Nachrichten angezeigt, die keine Eltern-Nachricht haben (das heißt, diejenigen an der Wurzel eines Threads). Wenn Sie dieses Kriterium angeben, können Sie sämtliche Nachrichten auswählen, egal an welcher Stelle sie in einem Thread stehen (selbstverständlich innerhalb der durch die anderen Kriterien gesetzten Grenzen). Dies erlaubt beispielsweise, die Nachrichten in einer streng chronologischen Reihenfolge oder die Gesamtzahl der Beiträge in einem Forum anzuzeigen.
- {id_secteur} gibt die Nachrichten zurück, die mit einem Sektor korrespondieren. Wird a priori nur wenig verwendet; dies erlaubt aber beispielsweise einem großen Forum, alle Nachrichten eines Sektors thematisch zusammenzufassen, egal an welchem Ort sie sich befinden.
- Seit Version SPIP 1.4 können die Nachrichten der Foren mit Schlagwörtern verbunden werden. Folgende Schlagwörter-Kriterien können seither in den (FORUMS)-Schleifen benutzt werden:
-
{id_mot},{titre_mot=xxx}Es werden die Nachrichten zurückgegeben, die mit dem Schlagwort verbunden sind, dessen Nummer id_mot oder dessen Titel titre_mot ist; -
{id_groupe},{type_mot=yyyy}Es werden die Nachrichten zurückgegeben, die mit Schlagwörtern aus der Gruppe id_groupe oder aus der Gruppe, deren Titel type_mot ist, verbunden sind.
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_FORUM zeigt den unverwechselbaren Identifizierer der Nachricht an.
- #ID_BREVE zeigt den Identifizierer der Meldung an, zu der die betreffende Nachricht gehört. Vorsicht, dies funktioniert nicht rekursiv: eine Nachricht, die auf eine Nachricht antwortet, die zu einer Meldung gehört, enthält die Nummer der Meldung selber nicht.
- #ID_ARTICLE ist der Identifizierer des Artikels, auf den die Nachricht antwortet.
- #ID_RUBRIQUE ist der Identifizierer der Rubrik, auf die die Nachricht antwortet.
- #DATE ist das Datum der Veröffentlichung.
- #TITRE ist der Titel.
- #TEXTE ist der Text der Nachricht.
- #NOM_SITE ist der Name der Website, die der Autor angegeben hat.
- #URL_SITE ist die Adresse (URL) dieser Website.
- #NOM ist der Name des Autors der Nachricht.
- #EMAIL ist die E-Mail-Adresse des Autors.
- #IP ist die IP-Adresse des Autors in dem Moment, in dem er seinen Beitrag abgesetzt hat.
- Die von SPIP berechneten Tags
- #FORMULAIRE_FORUM fabriziert die Schnittstelle, die das Posten einer Antwort-Nachricht erlaubt.
- #PARAMETRES_FORUM fabriziert die Liste der Variablen, die von der Formular-Schnittstelle ausgewertet werden, mittels derer man auf die Nachricht antworten kann. Ein Beispiel:
[<a href="forum.php3?(#PARAMETRES_FORUM)">Auf diese Nachricht antworten</a>]