Query_param

Query_param_link

{% query_param_link %}

Builds a link by combining the query parameters from the current request with the query parameters provided to this method as key:value pairs.

{% query_param_link output_to_template? [var, set, or assign]? variable? output_to_template? = attributes %}

{% query_param_link

output_to_template

If included the query_param_link will be output directly to the template.

var, set, or assign

Optional. Specify either "var", "set" or "assign" to change which scope this query_param_link is stored on. "var" is the default behavior.

variable

output_to_template

If included the query_param_link will be output directly to the template.

attributes

Key:value pairs with unique keys. May use the variable arguments syntax. The query parameters to set or unset in the resulting link. Attributes with a value of null will be unset

Any query parameters from the current request that are not explicitly unset will be included in the resulting link, including "utm" parameters. Be sure to unset all parameters that you may reasonably expect to be present on the page but do not want to include in the resulting link.

Examples

Original URL: "http://www.domain.com/path/to/page?flat=true"
Template: {% var oldvarname = 'flat' %}
{% var newvarname = 'round' %}
<a href="{% query_param_link = &oldvarname:false &newvarname:'true' %}">
Output: <a href="http://www.domain.com/path/to/page?round=true">

Original URL: "http://www.domain.com/path/to/page?page=2"
Template: {% var numLinks = 3 %}
{% query_param_link mylink = page:1 limit:numLinks topic:'Patriotism' %}
<a href="{{ mylink | Append:"#articletop" }}">Top {{ numLinks }} Patriotic Articles<a>
Output: <a href="http://www.domain.com/path/to/page?page=1&limit=3&topic=Patriotism#articletop">Top 3 Patriotic Articles<a>

Original URL: "http://www.domain.com/path/to/page"
Template: <a href="{% query_param_link = page:2 %}">Page 2<a>
Output: <a href="http://www.domain.com/path/to/page?page=2">Page 2<a>