marionnewlevant / twig-perversion
Making twig do things it really shouldn't
Installs: 60 991
Dependents: 1
Suggesters: 0
Security: 0
Stars: 52
Watchers: 3
Forks: 5
Open Issues: 3
Type:craft-plugin
Requires
- php: >=8.2
- craftcms/cms: ^5.0
Requires (Dev)
- craftcms/phpstan: dev-main
README
Making twig do things it really shouldn't. Twig is not intended to be a general purpose programming language, and there are some things that really don't belong in the language. This plugin adds a few of those things anyway.
{% while %}
,{% break %}
,{% continue %}
, and{% return %}
tags===
,!==
, and<=>
operatorsis numeric
,is string
, andis array
testsarray_splice
,string
,float
,int
, andbool
filters
Requirements
This plugin requires Craft CMS 4.12 or later.
Installation
- Install with Composer via
composer require marionnewlevant/twig-perversion
from your project directory - Install plugin in the Craft Control Panel under Settings > Plugins
or
- Install via the Plugin Store
Using Twig Perversion
Tags
-
{% while %}
loop:{% set x = 0 %} {% while x < 5 %} {# do whatever... #} {% set x = x + 1 %} {% endwhile %}
Note that twig's loop variables (except for
revindex
,revindex0
,last
, andlength
) are available inside of a while loop, as are the{% break %}
and{% continue %}
tags. -
{% break %}
to exit a for loop or while loop:{% for straw in haystack %} {% if straw == needle %} {% break %} {% endif %} {% endfor %} {% while true %} {# do whatever... #} {% if someCondition %} {% break %} {% endif %} {% endwhile %}
-
{% continue %}
to continue to next iteration:{% for straw in haystack %} {% if not isInteresting(straw) %} {% continue %} {% endif %} {# do whatever... #} {% endfor %}
-
{% return value %}
to return a value from a macro:{% macro foo() %} {# ... calculate someValue ... #} {% return someValue %} {% endmacro %}
-
{% return %}
to return the empty string from a macro:{% macro foo() %} {# ... do stuff %} {% return %} {% endmacro %}
A macro with a
{% return %}
tag will return whatever the return value is (which can be a complex expression). Any other output generated by the macro will be discarded.
Operators
-
=== and !==
Compares two values for equivalence, using php's
===
and!==
operators. -
<=>
Compares two values using php's
<=>
(spaceship) operator. Returns-1
,0
, or1
when the first argument is respectively less than, equal to, or greater than the second.
Tests
-
Numeric
Test whether given value is numeric (behaviour like PHP 7
is_numeric
). (Note that as of PHP 7, hexadecimal strings are not considered numeric)
{{ 12 is numeric ? 'Yes' : 'No' }} {# Yes #} {{ '-1.3' is numeric ? 'Yes' : 'No' }} {# Yes #} {{ '0x539' is numeric ? 'Yes' : 'No'}} {# No #}
-
String
Test whether given value is a string.
{{ '12' is string ? 'Yes' : 'No' }} {# Yes #} {{ 12 is string ? 'Yes' : 'No' }} {# No #}
-
Array
Test whether given value is an array.
{ [] is array ? 'Yes' : 'No' }} {# Yes #} {{ '12' is array ? 'Yes' : 'No' }} {# No #}
Filters
-
array_splice
Remove a portion of an array and replace it with something else. Uses the PHP array_splice function. Note that unlike the php function, this filter returns the modified array rather than the extracted elements. The original array is unchanged. Since the implementation requires copying the array, this will be less efficient than the raw php function. The array_splice filter is passed an
offset
, an optionallength
, and an optionalreplacement
. -
string
Typecast variable as a string.
-
float
Typecast variable as a float.
-
int
Typecast variable as an integer.
-
bool
Typecast variable as a boolean.
Brought to you by Marion Newlevant