e544ed6d9a
Comparing changes: https://github.com/smarty-php/smarty/compare/v4.3.1...v4.4.1 It is noticeable that Smarty 4.3.1 does not officially support PHP 8.3. Is only supported with 4.4.0. Remark: During tests with Smarty 4.5.1, it was noticed that the following warning occurs: Deprecated: Using the unregistered function "function_exists" in a template is deprecated and will be removed in a future version. Use Smarty::registerPlugin to explicitly register a custom modifier. As of Smarty 5.X.X, templates must be revised again. The Smarty release 5.0.2 is already officially available. However, integration into FlatPress is not entirely trivial.
121 lines
3.8 KiB
Markdown
121 lines
3.8 KiB
Markdown
# {if},{elseif},{else}
|
|
|
|
`{if}` statements in Smarty have much the same flexibility as PHP
|
|
[if](https://www.php.net/if) statements, with a few added features for the
|
|
template engine. Every `{if}` must be paired with a matching `{/if}`.
|
|
`{else}` and `{elseif}` are also permitted. All PHP conditionals and
|
|
functions are recognized, such as *\|\|*, *or*, *&&*, *and*,
|
|
*is_array()*, etc.
|
|
|
|
If security is enabled, only PHP functions from `$php_functions` property
|
|
of the security policy are allowed. See the
|
|
[Security](../../programmers/advanced-features/advanced-features-security.md) section for details.
|
|
|
|
The following is a list of recognized qualifiers, which must be
|
|
separated from surrounding elements by spaces. Note that items listed in
|
|
\[brackets\] are optional. PHP equivalents are shown where applicable.
|
|
|
|
## Qualifiers
|
|
|
|
| Qualifier | Alternates | Syntax Example | Meaning | PHP Equivalent |
|
|
|--------------------|------------|----------------------|--------------------------------|--------------------|
|
|
| == | eq | $a eq $b | equals | == |
|
|
| != | ne, neq | $a neq $b | not equals | != |
|
|
| > | gt | $a gt $b | greater than | > |
|
|
| < | lt | $a lt $b | less than | < |
|
|
| >= | gte, ge | $a ge $b | greater than or equal | >= |
|
|
| <= | lte, le | $a le $b | less than or equal | <= |
|
|
| === | | $a === 0 | check for identity | === |
|
|
| ! | not | not $a | negation (unary) | ! |
|
|
| % | mod | $a mod $b | modulo | % |
|
|
| is \[not\] div by | | $a is not div by 4 | divisible by | $a % $b == 0 |
|
|
| is \[not\] even | | $a is not even | \[not\] an even number (unary) | $a % 2 == 0 |
|
|
| is \[not\] even by | | $a is not even by $b | grouping level \[not\] even | ($a / $b) % 2 == 0 |
|
|
| is \[not\] odd | | $a is not odd | \[not\] an odd number (unary) | $a % 2 != 0 |
|
|
| is \[not\] odd by | | $a is not odd by $b | \[not\] an odd grouping | ($a / $b) % 2 != 0 |
|
|
|
|
## Examples
|
|
```smarty
|
|
{if $name eq 'Fred'}
|
|
Welcome Sir.
|
|
{elseif $name eq 'Wilma'}
|
|
Welcome Ma'am.
|
|
{else}
|
|
Welcome, whatever you are.
|
|
{/if}
|
|
|
|
{* an example with "or" logic *}
|
|
{if $name eq 'Fred' or $name eq 'Wilma'}
|
|
...
|
|
{/if}
|
|
|
|
{* same as above *}
|
|
{if $name == 'Fred' || $name == 'Wilma'}
|
|
...
|
|
{/if}
|
|
|
|
|
|
{* parenthesis are allowed *}
|
|
{if ( $amount < 0 or $amount > 1000 ) and $volume >= #minVolAmt#}
|
|
...
|
|
{/if}
|
|
|
|
|
|
{* you can also embed php function calls *}
|
|
{if count($var) gt 0}
|
|
...
|
|
{/if}
|
|
|
|
{* check for array. *}
|
|
{if is_array($foo) }
|
|
.....
|
|
{/if}
|
|
|
|
{* check for not null. *}
|
|
{if isset($foo) }
|
|
.....
|
|
{/if}
|
|
|
|
|
|
{* test if values are even or odd *}
|
|
{if $var is even}
|
|
...
|
|
{/if}
|
|
{if $var is odd}
|
|
...
|
|
{/if}
|
|
{if $var is not odd}
|
|
...
|
|
{/if}
|
|
|
|
|
|
{* test if var is divisible by 4 *}
|
|
{if $var is div by 4}
|
|
...
|
|
{/if}
|
|
|
|
|
|
{*
|
|
test if var is even, grouped by two. i.e.,
|
|
0=even, 1=even, 2=odd, 3=odd, 4=even, 5=even, etc.
|
|
*}
|
|
{if $var is even by 2}
|
|
...
|
|
{/if}
|
|
|
|
{* 0=even, 1=even, 2=even, 3=odd, 4=odd, 5=odd, etc. *}
|
|
{if $var is even by 3}
|
|
...
|
|
{/if}
|
|
|
|
{if isset($name) && $name == 'Blog'}
|
|
{* do something *}
|
|
{elseif $name == $foo}
|
|
{* do something *}
|
|
{/if}
|
|
|
|
{if is_array($foo) && count($foo) > 0}
|
|
{* do a foreach loop *}
|
|
{/if}
|
|
```
|