SPIP 1.9.2
Els criteris de selecció
Utilitzarem un o altre dels criteris següents per indicar com seleccionar els elements.
- {tout} (tot): Els articles són seleccionats en la totalitat del lloc (totes les seccions). És útil, sobretot, per mostrar els articles més recents (de tot el lloc) a la pàgina d’inici. [En realitat, el criteri «tot» no es tracta de manera informàtica: és com un quadern de notes pel webmestre; s’obté el mateix resultat si no s’indica cap dels criteris següents.]
- {id_article} selecciona l’article que té com a identificador id_article. Com que l’identificador de cada article és únic, aquest criteri ens retorna una o cap resposta.
- {id_rubrique} selecciona els articles que hi ha a la secció que té com a identificador id_rubrique.
- {id_secteur} selecciona els articles en aquest sector (un sector és una secció que no depèn de cap altre secció, és a dir, que es troba situada a l’arrel del lloc).
- {branche} (a partir d’SPIP 1.4 ) selecciona el conjunt d’articles de la secció I de les seves subseccions. (És una mena d’extensió del criteri {id_secteur}. No obstant, al contrari de {id_secteur=2}, no és possible cridar directament una branca fent, per exemple, {branche=2}: tècnicament parlant, es necessita que la secció en qüestió figuri en el context actual. Aquest criteri s’ha d’utilitzar amb moderació: si el vostre lloc està ben estructurat, no n’hauríeu de tenir necessitat, excepte en casos molt particulars.)
- {id_auteur} selecciona els articles que corresponen a l’identificador d’autor (útil per indicar la llista d’articles escrits per un autor).
- {id_mot} selecciona els articles que corresponen a l’identificador paraules clau (útil per indicar la llista d’articles que tracten una mateixa temàtica).
- {titre_mot=xxxx}, o {type_mot=yyyy} (a partir d’SPIP 1.3) selecciona respectivament els articles lligats a la paraula clau el nom de la qual és «xxxx», o lligats a paraules clau del grup de paraules clau «yyyy». Si es donen diversos criteris {titre_mot=xxxx} (o diversos {type_mot=yyyy}), es seleccionarà aquells que tindran totes aquestes paraules clau a la vegada (novetat d’SPIP 1.9).
- {id_groupe=zzzz} (a partir d’SPIP 1.4 ) permet seleccionar els articles lligats a un grup de paraules clau; principi idèntic al {type_mot} precedent, però donat que es treballa amb un identificador (número del grup), la sintaxi serà més «neta». [Nota : Aquest criteri no és (en l’estat actual de desenvolupament d’SPIP) acumulable amb l’anterior {type_mot=yyyy}]
- {lang} (depuis SPIP
1.7.1) selecciona els articles de la llengua demanada a l’adreça de la pàgina.
- {traduction} (a partir d’SPIP
1.7.1) selecciona les traduccions de l’article en curs en diverses llengües.
- {origine_traduction} (a partir d’SPIP
1.7.1) selecciona l’article de referència del que l’article corrent n’és una traducció,
- Els criteris {date} (ou {date=...} ou {date==...}) permeten seleccionar un article en funció de la data passada en l’URL (a partir d’SPIP
1.7.2).
- {recherche} selecciona els articles corresponents a les paraules indicades a la interfície de cerca (motor de cerca incorporat a l’SPIP). Veure la pàgina que tracta el tema del motor de cerca.
L’estat de l’article
Com tots els bucles d’SPIP, un bucle ARTICLES només ens torna articles publicats; quan el lloc Web està estructurat per a no publicar els articles «amb data posterior», s’efectua un altre test amb la data de l’article. Fins a SPIP 1.8.2 no hi havia cap mitjà d’alliberar-se d’aquest sistema i mostrar els articles que es troben «en curs de redacció», «proposats per a ser publicats» o «refusats». A partir d’ara és possible gràcies al criteri {statut}:
-
{statut=prop|prepa|publie|refuse|poubelle}(a partir d’SPIP 1.8.2) selecciona els articles en funció del seu estat de publicació: -
{statut=prepa}selecciona els articles en procés de redacció a l’espai privat; -
{statut=prop}selecciona els articles proposats per publicar; -
{statut=publie}selecciona els articles publicats al lloc Web; -
{statut=refuse}selecciona els articles que han estat refusats per a ser publicats; -
{statut=poubelle}selecciona els articles que s’han posat a la paperera.
Els criteris de visualització
Una vegada fixat un dels criteris anteriors, podrem afegir els criteris següents per restringir el número d’elements a mostrar.
S’apliquen, evidentment, els criteris comuns a tots els bucles.
Les etiquetes d’aquest bucle
Les etiquetes recuperades de la base de dades
Les etiquetes següents corresponen als elements recuperats directament de la base de dades. Podeu utilitzar-les igualment com a criteri de classificació (per exemple : {par date} o {par titre}).
- #ID_ARTICLE mostra l’identificador únic de l’article. És útil per crear enllaços hipertex no previstos (per exemple cap a una pàgina «Mostrar en format per imprimir»).
- #SURTITRE retorna l’avantítol.
- #TITRE retorna el títol de l’article.
- #SOUSTITRE retorna el subtítol.
- #DESCRIPTIF retorna la descripció.
- #CHAPO retorna el text d’introducció (capçalera).
- #TEXTE retorna el text principal de l’article.
- #PS retorna el post scriptum.
- Les etiquetes de dates: #DATE, #DATE_REDAC, #DATE_MODIF s’expliquen més àmpliament a la documentació sobre «La gestió de les dates».
- #ID_RUBRIQUE mostra l’identificador de la secció de la que depèn l’article.
- #ID_SECTEUR mostra l’identificador del sector del que depèn l’article (essent el sector la secció situada a l’arrel del lloc).
- #NOM_SITE i #URL_SITE mostren el nom i l’url de «l’enllaç» de l’article (si heu activat aquesta opció).
- #VISITES mostra el número de visites d’aquest article.
- #POPULARITE mostra el percentatge de popularitat d’aquest article; veure la documentació: La «popularitat» dels articles.
- #LANG mostra a llengua d’aquest article.
Les etiquetes calculades per l’SPIP
Els elements següents són calculats per SPIP. (No poden ser utilitzats com criteris de classificació).
- #URL_ARTICLE mostra l’URL de la pàgina de l’article.
- #NOTES mostra les notes de peu de pàgina (calculades a partir de l’anàlisi del text).
- #INTRODUCTION: (a partir d’SPIP 1.4 ) mostra la descripció de l’article, sinó mostra els 600 primers caràcters del començament de l’article (capçalera i després el text). En les versions anteriors a SPIP 1.3, són sistemàticament els primers caràcters de l’article (capçalera i després el text) els que es tenen en compte (la descripció no s’utilitza).
- #LESAUTEURS mostra els autors d’aquest article, amb enllaç cap a la seva pròpia pàgina pública (per tal de poder escriure’ls directament o consultar la llista d’articles que han publicat). Això evita crear un bucle AUTEURS per obtenir el mateix resultat. A les versions anteriors a SPIP 1.9, aquesta etiqueta mostra els autors de l’article amb l’enllaç cap a la seva adreça de correu electrònic.
- #PETITION mostra el text de la petició si aquesta existeix.
Si existeix però el text és buit, retorna un espai (una cadena no buida sense incidència en una pàgina html).
- #FORMULAIRE_SIGNATURE confecciona i mostra el formulari que permet de signar la petició associada a aquest article.
- #FORMULAIRE_FORUM confecciona i mostra el formulari que permet enviar un missatge responent a aquest article. Si en voleu saber més, vegeu també «Els formularis».
- #PARAMETRES_FORUM confecciona i mostra la llista de variable explotades pel formulari que permet respondre a aquest article. Per exemple:
A partir d’SPIP 1.8.2 se li pot passar un paràmetre especificant l’adreça de retorn desprès d’haver enviat el missatge. Per exemple: <a href="spip.php?page=forum&(#PARAMETRES_FORUM{#SELF})">Respondre a aquest article</a> tornarà el visitant a la pàgina actual un cop el missatge hagi estat validat.
Històric: En versions anteriors a SPIP 1.9 hauria fet falta escriure
forum.php3?i nospip.php?page=forum&
En general, fins a SPIP 1.9, els urls de les pàgines generades per SPIP eren del tipushttp://elmeulloc.net/xxx.php3i nohttp://elmeulloc.net/spip.php?page=xxx.
Els logotips
- #LOGO_ARTICLE mostra el logotip de l’article, eventualment amb la gestió d’imatge canviant.
- #LOGO_RUBRIQUE mostra el logotip de la secció de l’article.
- #LOGO_ARTICLE_RUBRIQUE mostra el logotip de l’article, eventualment substituït pel logotip de la secció si no existeix cap logotip específic de l’article.
Els logotips s’instal·len de la següent manera: [(#LOGO_ARTICLE|alignement|adresse)]
L’alineació pot ser left o right. L’adreça és el URL de destñi de l’enllaç d’aquest logotip (per exemple #URL_ARTICLE). Si no se li indica cap adreça, el botó no es clicable.
Si es vol recuperar directament el nom del fitxer del logotip (quan les etiquetes anteriors confeccionen el codi HTML complet per inserir la imatge a la pàgina), per exemple per mostrar una imatge com a fons d’una taula, utilitzarem el filtre |fichier tal i com segueix: [(#LOGO_ARTICLE|fichier)]
Per altra banda dues etiquetes permeten recuperar només un dels dos logotips:
- #LOGO_ARTICLE_NORMAL mostra el logotip sense imatge canviant;
- #LOGO_ARTICLE_SURVOL mostra el logotip d’imatge canviant.