Els bucles i etiquetes de cerca

El formulari de cerca

Per mostrar el formulari de cerca, n’hi ha prou en inserir l’etiqueta:

#FORMULAIRE_RECHERCHE

El formulari retorna, per defecte, cap a spip.php?page=recherche [1]; per tant, heu de fer un esquelet recherche.html que permeti mostrar els resultats.

Podeu decidir utilitzar una altra pàgina de publicació dels resultats. Per això hem de fer servir l’etiqueta de la manera següent:

[(#FORMULAIRE_RECHERCHE|spip.php?page=xxx)]

on spip.php?page=xxx és la pàgina cap a la que desitgeu enviar l’usuari, , i xxx.html és el seu esquelet.

Històric: En les versions anteriors a SPIP 1.9 hem d’escriure xxx.php3 i no spip.php?page=xxx

En general, fins a SPIP 1.9, els URLs de les pàgines generades per SPIP eren del tipus http://elmeulloc.net/xxx.php3 i no http://elmeulloc.net/spip.php?page=xxx.

L’esquelet dels resultats

Els bucles que permeten mostrar els resultats de la cerca són, en realitat, bucles que ja hem explicat a: ARTICLES, SECCIONS, BREUS i a partir de [SPIP 1.8.2] FORUMS. Per cert, podeu fer cerques no només en articles, sinó també a dins de les seccions, les breus i els fòrums.

-  La única diferència, respecte al que està documentat al manual de referència dels bucles, és l’elecció del criteri de selecció, que ha de ser {recherche}. Els altres criteris de visualització i les etiquetes d’aquests bucles resten aquí vàlides.

-  No obstant, per classificar els resultats per pertinença, utilitzarem preferentment aquest nou criteri de presentació: {par points}. Els resultats es mostren, en general, per ordre decreixent de score ({par points}{inverse}), és a dir de pertinença.

-  Finalment, podrem utilitzar l’etiqueta #POINTS, el qual mostra la pertinença dels resultats (atenció, en l’absolut aquest valor no és molt explícit, és sobretot útil per la classificació dels resultats).

-  Introduïda per [SPIP 1.5.1], l’etiqueta #RECHERCHE mostra la consulta formulada pel visitant.

Exemple de bucle complert:

Ressaltar la consulta a les altres pàgines

-  #DEBUT_SURLIGNE, #FIN_SURLIGNE són dues etiquetes que indiquen a SPIP a quina part de la pàgina ha d’acolorir les paraules cercades. Aquestes etiquetes pròpies del lloc es troben disponibles a qualsevol indret dels esquelets.

Quan l’internauta arriba a una pàgina a partir de la pàgina dels resultats de cerca, les paraules cercades són automàticament acolorides a la pàgina trobada. SPIP no distingeix, per exemple, entre un menú, de codi javascript o el text de l’article. Acoloreix les paraules arreu, cosa que pot ser molesta o provocar problemes als scripts. Es pot fer servir aquestes dues etiquetes per tal de limitar l’acoloriment a una part concreta de la pàgina. Per exemple:

-  La variable de personalització $nombre_surligne representa el nombre màxim de vegades que una paraula buscada serà ressaltada a dins del text. Per defecte, aquest valor està definit a 4.

-  L’aparença visual de com es ressalta es pot canviar modificant la definició d’estil de .spip_surligne (veure: «Modificar l’aparença gràfica»).