Le filtre |parametre_url{nom de variable,valeur}, appliqué à une balise d’URL (par exemple : #SELF, #URL_ARTICLE, #URL_PAGE{sommaire}...), lui ajoute ou lui retire un paramètre. Employé avec un seul paramètre le filtre agit différemment :
#URL...|parametre_url{x} extrait le parametre ’x’ de l’url et en retourne la valeur.
Par exemple :[(#SELF|parametre_url{pays,france})] ajoutera à l’url de la page en cours soit :?pays=france s’il s’agit du premier paramètre passé à cette url,
soit :&pays=france si l’url possède déjà au moins un paramètre.
Typiquement, on placera la balise dans l’attribut href d’un lien :<a href="[(#SELF|parametre_url{pays,france})]">France</a>
Pour récupérer ensuite la valeur du paramètre passé dans l’url, on utilisera la balise #ENV (ainsi, dans l’exemple ci-dessus #ENV{pays} retournera france).
Passer plusieurs paramètres à l’URL
On peut enchaîner les filtres pour passer en url une suite de paramètres et leurs valeurs : [(#SELF|parametre_url{pays,france}|parametre_url{monnaie,euro})]
Si l’on désire passer une même valeur à plusieurs paramètres, on utilisera l’écriture :[(#SELF|parametre_url{pays|lieu|terrain,france})]
qui retournera l’url de la page en cours argumentée de :pays=france&lieu=france&terrain=france
Supprimer des paramètres existants
Pour faire disparaître un paramètre d’url existant, il faut le vider de sa valeur en le déclarant à nouveau, mais explicitement vide : [(#SELF|parametre_url{pays,''})]
On peut supprimer plusieurs paramètres à la fois avec l’écriture : [(#SELF|parametre_url{pays|lieu|terrain,''})]
Récupérer un paramètre passé dans une URL
Par exemple, le plugin "Calendrier_mini" récupère des informations dans le contexte d’affichage du mini calendrier comme suit [1] :
... #ENV{urljson}|parametre_url{id_rubrique} ...
Explication : la variable #ENV{urljson} contient une url et le code ci-dessus retourne la valeur de id_rubrique si ce paramètre est présent dans l’url en question.
Forcer le séparateur
Par défaut, les URLs sont encodés avec le séparateur & mais il est possible de forcer le séparateur en indiquant un 3ème argument
|parametre_url{nom de variable,valeur,separateur}
Exemple :[(#URL_PAGE|parametre_url{bloc,id_bloc=5}] retourne spip.php?page=bloc&id_bloc=5[(#URL_PAGE|parametre_url{bloc,id_bloc=5,&}] retourne spip.php?page=bloc&id_bloc=5
Voir aussi : |ancre_url