add_query

Syntaxe

Paramètres

Description

Ce filtre permet d'ajouter ou de modifier un paramètre de requête (query string) à une URL.

Remarques

• Permet de manipuler dynamiquement les URL dans une page Liquid : Le filtre add_query est essentiel lorsqu'on souhaite modifier des liens ou rediriger un utilisateur vers une URL contenant des paramètres spécifiques. Il permet de garder une URL d'origine intacte tout en y injectant des données selon le contexte.
• Peut être utilisé pour personnaliser les liens dans des boucles ou des formulaires : Dans un scénario où on génère plusieurs liens (exemple : vers un formulaire, une page d'état, un document), add_query permet d'ajouter dynamiquement un identifiant, un type ou une langue selon l'élément traité dans la boucle.
• Remplace la valeur si le paramètre existe déjà dans l'URL : Ce filtre ne se contente pas d'ajouter un nouveau paramètre : il remplace aussi la valeur d'un paramètre existant si celui-ci est déjà défini dans l'URL. Cela permet d'actualiser une requête sans construire l'URL à la main.
• Utile pour la pagination, le filtrage ou le suivi utilisateur : Le filtre est souvent utilisé pour modifier des paramètres comme page, category, lang ou user, ce qui est très pratique dans des composants comme les listes dynamiques, les résultats de recherche ou les rapports.
• Favorise la construction propre et sécurisée des URLs : Plutôt que de concaténer des chaînes à la main avec ? et &, ce qui peut provoquer des erreurs ou des doublons, add_query prend en charge la gestion du séparateur et des encodages, produisant une URL propre et valide.
• Compatible avec les variables dynamiques dans les paramètres : Les deux paramètres, le nom du paramètre et sa valeur, peuvent être des chaînes statiques ou des variables. Cela permet une grande flexibilité pour adapter une URL selon les données de l'utilisateur ou les résultats d'une requête.
• Peut être enchaîné avec d'autres filtres Liquid : Ce filtre peut être combiné à d'autres filtres comme escape, downcase, url_encode ou replace, permettant une manipulation encore plus fine et contrôlée des URLs générées ou modifiées dans une page Liquid.
• Essentiel pour le suivi des événements ou le passage de contexte entre pages : En ajoutant des paramètres tels que source=landingpage ou campaign=été2025, add_query devient un outil puissant pour le suivi des campagnes marketing, des conversions, ou pour propager des identifiants techniques dans des redirections.