Chunk Documentation

=== User-Defined filters - exec an "x" template ===

Starting in 2.0.1, simple macros can be defined and executed via the <code>|filter(#x_template)</code> tag modifier.  The value is bound to <code>{$x}</code> and the template gets executed in-place along the filter chain.

For example, let's say you don't want to go to the trouble of implementing rtrim in java, or you have a format string you use over and over:
 <span style="color:green">{#my_template}</span>
 My dog's name is <span style="color:blue">{% $dog_name|default(Ralph    )|filter(#rtrim) %}</span>!
 His new collar cost <span style="color:blue">{% $price:4003.2|filter(#currency_us) %}</span> dollars.
 <span style="color:green">{#}</span>
 
 <span style="color:red">{!-- little macro-filter for eating trailing whitespace, using a regular expr --}</span>
 <span style="color:green">{#rtrim}</span><span style="color:blue">{% $x:|s/\s*$// %}</span><span style="color:green">{#}</span>
 
 <span style="color:red">{!-- little macro-filter for formatting currency --}</span>
 <span style="color:green">{#currency_us}</span><span style="color:slateblue">{% if ($x) %}</span>$ <span style="color:blue">{% $x|sprintf(%,.02f) %}</span><span style="color:slateblue">{% endif %}</span><span style="color:green">{#}</span>

Output:
 My dog's name is Ralph!
 His new collar cost $ 4,003.20 dollars.

''Important:'' If the input is null/undefined, the template will still be executed, so be sure to account for that possibility in your #x_template definition.