Introducing dynamic URL tags
Check out our new extensive tutorial on how to pre-filter Listing Builder listing queries with dynamic URL tags. “Dynamic URL tags” are a very powerful feature of the Listing Builder. They exist since FacetWP v.3.6.0 but were previously undocumented.
Dynamic URL tags can be used in a listing’s query filter rule, or in Dev mode, to dynamically pre-filter the listing’s “base” query (the query before any facet filtering), based on the page URL. They pull query filter values from the page URL that the listing is located on, and pass them to the listing’s query parameters. Any facets on the pages can be used on top of this dynamic “base” query.
There are two types of URL tags:
The http:uri URL tag
The http:uri tag resolves to one or more segments of the page URI, for example: guides/amsterdam.
This tag makes it possible to use the same listing on different pages, with its query adapting itself automatically to the page URI.
For example, you can use the http:uri:-1 URL tag to match a custom city field to the last segment of the URI, which in this case is the city name:
http:uri:-1 dynamic URL tag in a custom-field-based listing query filter.So with this URL tag in place, the same listing will show posts in Amsterdam on the /guides/amsterdam/ page, and posts in Utrecht on the /guides/utrecht/ page, etc.
The http:get URL tag
The http:get URL tag resolves to one or more of the GET variables in the URL, for example: /?city=amsterdam.
This tag can automatically pre-filter the base query of the listing on a page based on the GET variables added to the (incoming) URL.
For example, you can use the http:get:city URL tag to match a custom city field to the /?city=amsterdam GET variable in the URL:
http:get dynamic URL tag in a custom-field-based listing query filter.So with this URL tag in place, the listing on the /guides/ page will show posts in Amsterdam when a clicked front-page button linked to /guides/?city=amsterdam, and posts in Utrecht when a clicked button linked to /guides/?city=utrecht, etc.
The tutorial explains what is possible, with many examples, how to use custom-field and taxonomy-based query filter rules, how to use serialized fields, multiple tags, and how to use dynamic URL tags in Dev mode and on archive templates.