The |parametre_url{variable name, value} filter, applied to a URL type tag (e.g. #SELF, #URL_ARTICLE, #URL_PAGE{sommaire}...), will add or remove a parameter to that URL.

For example:
[(#SELF|parametre_url{country, France})] will add to the current page’s URL either ?country=France if it is the first parameter passed in the URL or &country=France if the URL already has at least one other parameter.

Such tags are typically included in the href part of a link definition: <a href="[(#SELF|parametre_url{country,France})]">France</a>

To then later retrieve the value of the parameter passed in the URL, we would use the #ENV tag.
In the example above, #ENV{var1} would return France.

Passing several parameters with the URL

We can chain filters for passing a series of parameters and their values to a URL: [(#SELF|parametre_url{country,France}|parametre_url{currency,euro})].

If we want to pass the same value to several parameters, we would use this syntax: [(#SELF|parametre_url{country|location|territory, France})] which will return the current page’s URL suffixed with: country=France&location=France&territory=France.

Deleting existing parameters

To make an existing URL parameter disappear, you need to empty it’s value by declaring a new one that is explicitly empty: [(#SELF|parametre_url{country, ''})].

We can delete several parameters at one with: [(#SELF|parametre_url{country|location|territory, ''})].

Author Mark Published : Updated : 26/10/12

Translations : català, English, Español, français, Nederlands