remove_query

Syntaxe

Paramètres

Description

Ce filtre permet de retirer un paramètre (ou plusieurs) de la chaîne de requête d'une URL.

Remarques

• Supprime proprement un ou plusieurs paramètres d'URL : Le filtre remove_query est conçu pour retirer un ou plusieurs paramètres de la query string d'une URL, sans altérer le reste de l'adresse. Il est très utile pour nettoyer dynamiquement une URL avant redirection ou affichage, en supprimant les variables devenues inutiles ou sensibles.
• Ne modifie pas les autres parties de l'URL : Ce filtre agit uniquement sur la chaîne de requête (query string). Le protocole (https), l'hôte (example.com) et le chemin (/page) ne sont jamais affectés, ce qui garantit une modification ciblée et non destructive.
• Permet la gestion dynamique de l'état dans les portails : Dans Power Pages, remove_query est souvent utilisé pour nettoyer l'URL d'un état temporaire, comme un filtre de recherche ou une alerte. Cela permet d'éviter que des paramètres de contrôle s'accumulent inutilement au fil des actions de l'utilisateur.
• Peut être combiné avec add_query pour reformuler des URL : On peut facilement enchaîner remove_query suivi de add_query pour remplacer la valeur d'un paramètre, au lieu de simplement le supprimer. Cela évite d'avoir à manipuler l'URL manuellement, et rend le code plus lisible et maintenable.
• Sensible à la syntaxe exacte du nom du paramètre : Le filtre ne supprimera que les paramètres exactement nommés comme indiqué. Par exemple, remove_query: 'id' ne retirera pas userId ou Id (avec une majuscule). Cela impose une rigueur dans la gestion des noms de paramètres.
• Ne laisse pas de résidus de délimiteurs (&, ?) : Lorsqu'un paramètre est supprimé, le filtre réajuste automatiquement les séparateurs. Il évite les erreurs fréquentes comme un & isolé ou un ? vide à la fin de l'URL, ce qui est essentiel pour produire des URL valides et esthétiques.
• Utile pour sécuriser les URL affichées à l'utilisateur : Dans certains cas, on veut empêcher qu'un paramètre sensible (exemple : token, debug, admin) reste visible dans l'URL. remove_query permet de masquer ou nettoyer ces valeurs avant de les rendre publiques ou de les consigner dans des liens visibles.
• Fonctionne aussi avec des URL stockées dans des variables Liquid : Le filtre n'est pas limité à des URL en dur : il peut être appliqué à n'importe quelle variable contenant une URL, y compris celles construites dynamiquement. Cela le rend compatible avec des scénarios complexes comme les redirections ou les filtres paginés dans des vues.