path_and_query |
Chemin et requête |
| Liquid (Microsoft) |
Syntaxe
|
{{ url | path_and_query }}
|
Paramètres
| Nom |
Description |
| url |
Ce paramètre permet de fournir l'URL complète dont on souhaite extraire le chemin et la requête. |
Description
Ce filtre permet d'extraire le chemin et la chaîne de requête (query) d'une URL.
Remarques
- Combine à la fois le chemin et la chaîne de requête : Contrairement au filtre path extrayant uniquement le chemin d'une URL, path_and_query
inclut également les paramètres de requête (?param=valeur). Cela permet de récupérer une portion plus complète de l'URL, sans toutefois inclure le nom d'hôte.
- Utile pour le suivi de navigation avec des paramètres : Ce filtre est pratique lorsqu'on souhaite préserver les informations de requête pour des
opérations comme la redirection, l'analyse des comportements utilisateurs ou la personnalisation du contenu en fonction d'un paramètre.
- Ne retourne pas l'hôte ni le protocole de l'URL : Même si une URL complète est fournie (exemple : https://exemple.com/page?id=10), le filtre retourne
uniquement /page?id=10. Cela permet de focaliser l'analyse ou les comparaisons sur la partie utile au niveau du site, sans tenir compte du domaine.
- Particulièrement utile pour créer des liens dynamiques : Si l'on souhaite construire un lien vers une page similaire, ou reproduire une URL sans répéter
manuellement les paramètres, path_and_query automatise cette reconstitution de l'URL utile pour la navigation interne.
- Permet une analyse conditionnelle basée sur des paramètres : On peut utiliser ce filtre dans une instruction if pour déclencher certains comportements
selon la présence d'un paramètre, par exemple ?source=email dans la requête. Cela est courant dans le marketing, le suivi d'origine ou la gestion d'états d'affichage.
- La syntaxe est simple et directe : Le filtre s'applique de façon classique, par exemple {{ request.url | path_and_query }}, ce qui le rend facile à intégrer
dans des modèles, sans besoin de transformation ou de manipulation supplémentaire.
- Supporte les requêtes complexes avec plusieurs paramètres : Même si la chaîne de requête contient plusieurs couples clef/valeur (?cat=livres&tri=date&ordre=desc),
le filtre les conserve intégralement dans le résultat, garantissant que les informations transmises dans l'URL soient préservées.
- Peut être combiné avec d'autres filtres pour un contrôle plus fin : Après extraction via path_and_query, on peut utiliser split: '?' pour séparer le chemin
de la requête, ou contains pour tester la présence d'un paramètre spécifique, offrant ainsi une plus grande souplesse dans la logique métier des pages.
Dernière mise à jour : Jeudi, le 24 Juillet 2025