Conditions
Conditions allow you filter the results of your content tags (e.g. Collections, Taxonomies) with the data inside them, much like WHERE clauses do with SQL.
Looking to use regular “if / else” conditions? You’re probably going to want Conditional Logic in Antlers Templates
Usage
The syntax is for all the available conditions is field:condition="value".
For conditions where you may specify the comparison value, like is or starts_with, you’d do:
my_field:starts_with="something"
For boolean conditions, like exists or null, you should simply specify a value of true, to trigger the condition:
my_field:exists="true"
For negative boolean conditions, don’t use ="false". Instead, pick the opposite condition.
For example, :exists vs. :doesnt_exists.
<!-- Don't do this: -->
my_field:exists="false"
<!-- Do this: -->
my_field:doesnt_exist="true"
Example
Let’s say we have a collection of beverages:
- Amaretto
- Bourbon Whiskey
- Gin
- Irish Whiskey
- Scotch Whisky
- Rye Whiskey
- Rum
- Vodka
But we only want to show whiskeys, because they are delicious.
{{ collection:drinks title:contains="whiskey" }}
{{ title }}
{{ /collection:drinks }}
That would filter down to this:
- Bourbon Whiskey
- Irish Whiskey
- Rye Whiskey
We can’t forget about Scotch, but since its spelled whisky, our condition filters it out.
Let’s use a regular expression to make that e optional.
{{ collection:drinks title:match="/whiske?y/" }}
{{ title }}
{{ /collection:drinks }}
Now Scotch will be in the list, and we can sleep soundly knowing that no whiskey was forgotten.
If you want narrow your results further you can repeat conditions as many times as needed.
{{ collection:drinks title:is="whiskey" country:is="scotland" }}
{{ title }}
{{ /collection:drinks }}
Boolean Modifiers
In addition to the list of conditions below, you are free to use any modifiers that return booleans (for example, is_past or is_future).
Similar to the native boolean conditions, you can use these modifiers as conditions by passing in a value of true.
{{ collection:events event_date:is_future="true" }}
Conditions List
|
is|equals
mixed |
Checks if a field is equal to a value. Appending |
|---|---|
|
not|isnt|aint
mixed |
Checks if a field is not equal to a value. Appending |
|
exists|isset
bool |
Checks if a field exists (or is not |
|
doesnt_exist|not_set|isnt_set|null
bool |
Checks if a field doesn't exist (or is |
|
contains
string|array |
Check if a field contains a given string or if a value is within an array. |
|
doesnt_contain
string|array |
The inverse of |
|
starts_with|begins_with
string |
Checks if a field starts with a given string. |
|
doesnt_start_with|doesnt_begin_with
string |
Checks if a field doesn't start with a given string. |
|
ends_with
string |
Checks if a field ends with a given string. |
|
doesnt_end_with
string |
Checks if a field doesn't end with a given string. |
|
greater_than|gt
mixed |
Checks if a field is greater than a value. |
|
less_than|lt
mixed |
Checks if a field is less than a value. |
|
greater_than_or_equal_to|gte
mixed |
Checks if a field is greater than or equal to a value. |
|
less_than_or_equal_to|lte
mixed |
Checks if a field is less than or equal to a value. |
|
matches|match|regex
regex |
Checks if a field matches a given regular expression. |
|
boolean modifiers
string |
Any modifiers that return booleans may be used (eg. |