smarty/docs/designers/language-builtin-functions/language-function-if.md

{if},{elseif},{else} {#language.function.if}
====================

`{if}` statements in Smarty have much the same flexibility as PHP
[if](&url.php-manual;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.

       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              modulous                         \%
   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


    {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}