Depuis la version 1.8 de SPIP, la balise #SELF permet de récupérer l’URL de la page appelée, nettoyée — nous dit la doc — des variables propres à l’exécution de SPIP. Par exemple, pour une page avec l’url : article.php3?id_article=25&var_mode=recalcul la balise #SELF retournera : article.php3?id_article=25.
Très pratique donc (elle nous évite de devoir appeler une variable d’environnement en php), la balise #SELF renvoie néanmoins un résultat qui n’est pas facilement manipulable. En particulier, il n’est pas aisé de modifier un paramètre de la chaîne sans devoir tout décomposer.
Le filtre présenté ici — qui a été récupéré du projet Sedna sur SPIP Zone —, répond simplement à ce problème.
Commencez par copier le bout de code suivant dans votre fichier mes_fonctions.php3, à créer, le cas échéant, à la racine de votre site spip :
Il ne vous reste plus qu’à appeler ce filtre dans vos squelettes selon le schéma suivant :
Par exemple, si #SELF renvoie page.php3?tri=date&ordre=inverse&debut_page=100&mode=large&lang=fr et que vous voulez changer la valeur du paramètre tri (actuellement à la valeur « date ») par « titre », sans toucher au reste de la chaîne, il vous suffit d’écrire ceci :
À noter
Vous pouvez, bien sûr, appliquer ce filtre à une autre url spip (#URL_ARTICLE, #URL_SITE_SPIP, etc) ;
Si le paramètre n’est pas présent dans la chaîne, il est simplement ajouté à la suite de la chaîne existante ;
Si la valeur est omise, c’est la valeur « globale » qui sera ajoutée(i.e. [(#SELF|parametre_url{id_document})]) ;
Si la valeur est une chaîne vide ou vaut 0, le paramètre est retiré de l’url ;
Vous pouvez utiliser des objets SPIP (et pas uniquement des chaînes statiques) comme variables du filtre. Par exemple, à l’intérieur d’une boucle dont la langue est différente de la langue globale :
Exemple d’utilisation
L’article Donner la possibilité aux visiteurs de choisir le critère de tri d’une liste est un bon exemple de l’utilisation de ce filtre.
RSS 2.0