Il ciclo FORUMS

I criteri di selezione

Per indicare come selezionare gli elementi si può utilizzare uno o l’altro dei criteri seguenti

-  {id_forum} restituisce il messaggio il cui identificativo è id_forum. Poiché l’identificativo di ogni messaggio è univoco, questo criterio ottiene o una o zero risposte.

-  {id_article} restituisce i messaggi corrispondenti ad un articolo.

-  {id_rubrique} restituisce i messaggi corrispondenti alla presente rubrica. Attenzione: non sono i messaggi degli articoli di questa rubrica, ma dei messaggi di questa rubrica. Infatti, nell’area riservata è possibile attivare dei forum per ogni rubrica.

-  {id_breve} restituisce i messaggi corrispondenti a una breve.

-  {id_syndic} restituisce i messaggi corrispondenti a questo sito.

-  {id_thread} introdotto nella versione [SPIP 1.8], restituisce i messaggi che appartengono a questo thread.
Nota: id_thread non è altro che l’identificativo id_forum del messaggio che inizia l’argomento del thread (chiamato anche "piede" della discussione).

-  {id_parent} restituisce i messaggi che dipendono da un altro messaggio. Indispensabile per gestire i thread nei vari forum.

-  {id_enfant} restituisce il messaggio da cui dipende il messaggio attuale (permette di « risalire » nella gerarchia dei thread). (SPIP 1.3)

-  {meme_parent} restituisce gli altri messaggi in risposta a uno stesso messaggio. (SPIP 1.3)

-  {plat} oppure {tout}: visualizza tutti i messaggi del forum senza tener conto della loro gerarchia: con questo criterio è possibile selezionare tutti i messaggi indipendentemente dalla loro posizione nel thread (ovviamente nel limite degli altri criteri). Ciò permette, per esempio, di visualizzare i messaggi in ordine cronologico o di contare il numero totale di contributi in un forum.

N.B. In mancanza del criterio {id_forum} o {id_parent}, quando il criterio {plat} non viene specificato vengono visualizzati solo i messaggi che non hanno "parent" (cioè, quelli alla radice di un thread).

-  {id_secteur} restituisce i messaggi che corrispondono alla sezione. A priori è poco utile, ma permette, per esempio, di creare un grande forum tematico che raggruppo tutti i messaggi di una sezione, indipendentemente dal luogo in cui questi si trovino.

-  Dalla versione SPIP 1.4, i messaggi dei forum possono essere collegati a parole chiave. I criteri di parole chiave, quindi, possono essere utilizzati nei cicli (FORUMS):

• {id_mot}, {titre_mot=xxx} restituiscono i messaggi collegati alla parola il cui numero è id_mot o il cui titolo è titre_mot;
• {id_groupe}, {type_mot=yyyy} restituiscono i messaggi collegati a parole del gruppo id_groupe, o del gruppo intitolato type_mot.

I criteri di visualizzazione

Si possono applicare i criteri comuni a tutti i cicli.

I segnaposti di questo ciclo

-  I segnaposti estratti dal database

I segnaposti seguenti corrispondono agli elementi estratti direttamente dal database. È anche possibile utilizzarli come criterio di ordinamento (generalmente: {par titre}).

-  #ID_FORUM visualizza l’identificativo univoco del messaggio.

-  #ID_THREAD introdotto nella versione [SPIP 1.8], visualizza l’identificativo del thread al quale questo messaggio appartiene. (Si tratta dell’id_forum del piede della discussione.)

-  #URL_FORUM dalla versione [SPIP 1.8], dà l’indirizzo canonico della pagina che mostra il messaggio del forum (per esempio, con i normali URL di SPIP, article.php3?id_article=8#forum15 per il messaggio 15 associato all’articolo 8).

-  #ID_BREVE visualizza l’identificativo della breve al quale è allegato il messaggio attuale. Attenzione, esso non è ricorsivo: un messaggio che risponde a un messaggio allegato a una breve non contiene in sé il numero della breve.

-  #ID_ARTICLE è l’identificativo dell’articolo al quale risponde il messaggio.

-  #ID_RUBRIQUE l’identificativo della rubrica al quale risponde il messaggio.

-  #ID_SYNDIC è l’identificativo del sito al quale risponde il messaggio.

-  #DATE à la data di pubblicazione.

-  #TITRE è il titolo.

-  #TEXTE è il titolo del messaggio.

-  #NOM_SITE il nome del sito Web indicato dall’autore.

-  #URL_SITE l’indirizzo (URL) del sito Web.

-  #NOM è il nome dell’autore del messaggio.

-  #EMAIL è l’indirizzo email dell’autore.

-  #IP è l’indirizzo IP dell’autore del messaggio al momento dell’invio del suo contributo.

-  I segnaposti elaborati da SPIP

-  #FORMULAIRE_FORUM crea l’interfaccia che permette di inviare un messaggio di risposta. Per ulteriori spiegazioni leggere anche «I form».

-  #PARAMETRES_FORUM crea l’elenco delle variabili usate dall’interfaccia del form che permette di rispondere al messaggio attuale. Per esempio:

[<a href="spip.php?page=forum&(#PARAMETRES_FORUM)">Rispondi a questo messaggio</a>]

Da [SPIP 1.8.2] è possibile passargli un parametro che specifica l’indirizzo di ritorno dopo aver inviato il messaggio. Per esempio: <a href=“spip.php?page=forum&(#PARAMETRES_FORUM{#SELF})”>Rispondi a questo messaggio</a> rimanderà il visitatore sulla pagina attuale dopo che il messaggio è stato inviato.

Un po’ di storia: Per le versioni precedenti a [SPIP 1.9] si sarebbe dovuto scrivere forum.php3? e non spip.php?page=forum&

In genere, fino alla versione [SPIP 1.9], gli URL delle pagine generate da SPIP avevano la forma http://miosito.net/xxx.php3 e non http://miosito.net/spip.php?page=xxx.