I criteri di selezione
Per indicare come selezionare gli elementi si può utilizzare uno o l’altro dei criteri seguenti
- {tout} le parole chiave vengono selezionate in tutto il sito.
- {id_mot} restituisce la parola chiave il cui identificativo è id_mot.
- {id_groupe} restituisce le parole chiave associate al gruppo di parole il cui numero è id_groupe SPIP 1.4.
- {id_article} restituisce le parole chiave associate all’articolo attuale (è l’uso più frequente di questo ciclo).
- {id_rubrique} restituisce le parole chiave associate a una rubrica SPIP 1.4.
- {id_breve} restituisce le parole chiave associate a una breve SPIP 1.4.
- {id_syndic} restituisce le parole chiave associate a un sito in repertorio SPIP 1.4.
- {id_forum} restituisce le parole chiave associate a un messaggio di forum SPIP 1.4 (attenzione, utilizzo molto specifico).
- {titre=italia} restituisce la parola chiave intitolata, per esempio, italia.
- {type=paese} restituisce le parole chiave del gruppo di parole chiave intitolato, per esempio, paese.
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. È possibile utilizzarli anche come criterio di ordinamento (di solito: {par titre}).
- #ID_MOT visualizza l’identificativo univoco della parola chiave.
- #TITRE è il titolo (la parola chiave stessa).
- #DESCRIPTIF mostra la descrizione della parola chiave.
- #TEXTE mostra il testo associato alla parola chiave.
- #TYPE è la categoria nella quale è inserita questa parola chiave (per esempio, la parola chiave "Italia" potrebbe essere associata alla categoria "Paesi").
- #LOGO_MOT SPIP 1.4 visualizza il logo associato alla parola chiave.
- #URL_MOT visualizza l’indirizzo dell’attuale parola chiave.
Il ciclo (GROUPES_MOTS)
Benché abbia un utilizzo marginale, il ciclo GROUPES_MOTS, introdotto con SPIP 1.5, merita di essere citato in questa sede: esso permette, se si hanno più gruppi di parole chiave, di selezionare tali gruppi e di organizzare per esempio una pagina di riepilogo di tutte le parole chiave ordinate per gruppo, poi in ordine alfabetico all’interno di ogni gruppo, per esempio usando il codice seguente:
<BOUCLE_gruppi(GROUPES_MOTS){par titre}>
<h1>#TITRE</h1>
<BOUCLE_parolechiave(MOTS){id_groupe}{par titre}{" - "}>
#TITRE
</BOUCLE_parolechiave>
</BOUCLE_gruppi>
I segnaposti e i criteri associati a questo ciclo sono:
- #ID_GROUPE, l’identificativo del gruppo delle parole chiave [disponibile anche nel ciclo (MOTS)];
- #TITRE, il titolo del gruppo [per mostrare questo valore all’interno del ciclo (MOTS) è possibile utilizzare #TYPE].