mirror of
				https://github.com/smarty-php/smarty.git
				synced 2025-10-31 12:21:36 +01:00 
			
		
		
		
	
		
			
				
	
	
	
		
			3.6 KiB
		
	
	
	
	
	
	
	
			
		
		
	
	
			3.6 KiB
		
	
	
	
	
	
	
	
{if},{elseif},{else}
{if} statements in Smarty have much the same flexibility as PHP
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.
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
{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}