In this section

Supported Smarty Functions and Modifiers

array_diff

Computes the difference of arrays.

array_diff($array1, $array2)

Type: Function

Example:

{$array1 = ['green', 'red', 'blue']}
{$array2 = ['green', 'yellow', 'red']}
{$diff = array_diff($array1, $array2)}
<pre>{json_encode($diff, 128)}</pre>
{
  "2": "blue"
}

array_flip

Exchanges all keys with their associated values in an array.

array_flip($array)

Type: Function

Example:

{$fruits = ['d'=>'lemon','a'=>'orange','b'=>'banana','c'=>'apple']}
{$tmp = array_flip($fruits)}
<pre>{json_encode($fruits, 128)}</pre>
{
  "lemon": "d",
  "orange": "a",
  "banana": "b",
  "apple": "c"
}

array_intersect

Computes the intersection of arrays.

array_intersect($array1, $array2)

Type: Function

Example:

{$array1 = ["green", "red", "blue"]}
{$array2 = ["green", "yellow", "red"]}
{$intersect = array_intersect($array1, $array2)}
<pre>{json_encode($intersect, 128)}</pre>
[
  "green",
  "red"
]

array_keys

Return all the keys or a subset of the keys of an array.

array_keys($array)

Type: Function

Example:

{$fruits = ["d"=>"lemon","a"=>"orange","b"=>"banana","c"=>"apple"]}
{$keys = array_keys($fruits)}
<pre>{json_encode($keys, 128)}</pre>
{
  "d",
  "a",
  "b",
  "c"
}

array_pop

Pop the element off the end of array.

array_pop($array)

Type: Function

Example:

{$colors = ['red','blue','green','purple']}
{$color = array_pop($colors)}
<pre>{json_encode($colors, 128)}</pre>
<pre>{$color}</pre>
[
  "red",
  "blue",
  "green"
]
purple

array_push

Inserts one or more elements to the end of an array.

array_push($array,"value1","value2")

Type: Function

Example:

{$colors = ['red','blue','green','purple']}
{$tmp = array_push($colors,"orange","yellow")}
<pre>{json_encode($colors, 128)}</pre>
[
  "red",
  "blue",
  "green",
  "purple",
  "orange",
  "yellow"
]

array_reverse

Return an array with elements in reverse order.

array_reverse($array)

Type: Function

Example:

{$fruits = ["d"=>"lemon","a"=>"orange","b"=>"banana","c"=>"apple"]}
{$fruits_reversed = array_reverse($fruits)}
{$utils->jsonPrettyPrint($fruits_reversed)}
{
  "c": "apple",
  "b": "banana", 
  "a": "orange",
  "d": "lemon"
}

Searches the array for a given value and returns the first corresponding key if successful.

array_search('needle', $array)

Type: Function

Example:

{$colors = ['red','blue','green','purple']}
{$position = array_search('blue', $colors)}
<pre>{json_encode($colors, 128)}</pre>
<pre>{$position}</pre>
[
    "red",
    "blue",
    "green",
    "purple"
]
1

array_shift

Shift an element off the beginning of array.

array_shift($array)

Type: Function

Example:

{$colors = ['red','blue','green','purple']}
{$color = array_shift($colors)}
<pre>{json_encode($colors, 128)}</pre>
<pre>{$color}</pre>
[
    "blue",
    "green",
    "purple"
]
red

array_splice

Remove a portion of the array and replace it with something else.

array_splice($array, offset)

Type: Function

Example:

{$colors = ['red','blue','green']}
{$color = array_splice($colors, 2)}
<pre>{json_encode($colors, 128)}</pre>
<pre>{$color}</pre>
[
  "blue",
  "green"
]
red

array_slice

Returns selected parts of an array.

array_slice($array,start,length,preserve)

Type: Function

Example:

{$colors = ['red','blue','green','purple']}
{$working_colors = array_slice($colors,1,2)}
<pre>{json_encode($working_colors, 128)}</pre>
[
  "blue",
  "green"
]

array_unshift

Prepend one or more elements to the beginning of an array.

array_unshift($array)

Type: Function

Example:

{$colors = ['red','blue','green','purple']}
{array_unshift($colors, "yellow")}
<pre>{json_encode($colors, 128)}</pre>
[
  "yellow",
  "red",
  "blue",
  "green",
  "purple"
]

array_unique

Removes duplicate values from an array.

array_unique($array)

Type: Function

Example:

{$colors = ["d"=>"green","a"=>"green","b"=>"yellow","c"=>"blue"]}
{$tmp = array_unique($colors)}
<pre>{json_encode($colors, 128)}</pre>
{
  "d": "green",
  "b": "yellow",
  "c": "blue"
}

array_values

Return all the values of an array.

array_values($array)

Type: Function

Example:

{$fruits = ["d"=>"lemon","a"=>"orange","b"=>"banana","c"=>"apple"]}
{$fruits = array_values($fruits)}
<pre>{json_encode($fruits, 128)}</pre>
{
  "lemon",
  "orange",
  "banana",
  "apple"
}

asort

Sort an array and maintain index association.

asort($array)

Type: Function

Example:

{$colors = ['red','blue','green','purple']}
{$tmp = asort($colors)}
{$colors = array_values($colors)}
<pre>{json_encode($colors, 128)}</pre>
{
  "blue",
  "green",
  "purple",
  "red"
}

arsort

Sort an array in reverse order and maintain index association.

arsort($array)

Type: Function

Example:

{$colors = ['red','blue','green','purple']}
{$tmp = arsort($colors)}
{$colors = array_values($colors)}
<pre>{json_encode($colors, 128)}</pre>
{
  "red",
  "purple",
  "green",
  "blue"
}

base64_encode

Encodes data with MIME base64.

Type: Modifier

Example:

{"foo"|base64_encode}
Zm9v

count

Counts the number of items in an array.

count($variable)

Type: Function or Modifier

Example:

{$colors = ['red','blue','green','purple']}
Function Syntax:<br>
The colors array contains {count($colors)} items.<br><br>
Modifier Syntax:<br>
The colors array contains {$colors|count} items.
Function Syntax:
The colors array contains 4 items.

Modifier Syntax:
The colors array contains 4 items.

count_characters

Counts the number of characters in a variable or text string. Use boolean parameter "true" to include whitespaces into the total count.

{$variableTitle|count_characters:true}

Type: Modifier

Example:

{$message.subject='Welcome! Here is Your Special Offer!'}
{$message.subject|count_characters}<br>
{$message.subject|count_characters:true}
31
36

current

Return the current element in an array.

current($array)

Type: Function

Example:

{$colors = ['red','blue','green','purple']}
{$working = current($colors)}
<pre>{json_encode($colors, 128)}</pre>
<pre>{$working}</pre>
[
  "red",
  "blue",
  "green",
  "purple"
]
red

date_format

Converts the date to a specified format.
http://php.net/manual/en/function.date.php

Type: Modifier

Example:

{$smarty.now|date_format}<br>
{$smarty.now|date_format:'%D'}<br>
{$smarty.now|date_format:'%A, %B %e, %Y'}<br>
{$smarty.now|date_format:'%Y-%m-%dT%H:%M:%S'}<br>
{$smarty.now|date_format:'Y-m-d\TH:i:sO'}
Oct 9, 2017
10/09/17
Monday, October 9, 2017
2017-10-09T18:55:57
2017-10-09T18:55:57+0000

More date_format info and examples.

default

When smarty variable equals false (e.g. is an empty string) or has no value (i.e. null), allows you the opportunity to show default text.

Type: Modifier

Example:

{$coupon.code|default:'welcome10'}<br>
{$coupon.code='abc'}<br>
{$coupon.code|default:'welcome10'}<br>
welcome10
abc

emailObfuscate

Used to obfuscate an email address.

Type: Modifier

Example:

{$contact.channels.email.address|emailObfuscate}
j***n@g***m

empty

Checks to see if a value is empty.

empty($variable)

Type: Function

Example:

{$foo = 0}
{if empty($foo)}
Foo is empty
{else}
Value of foo is: {$foo}
{/if}
Foo is empty

end

Return the end element in an array.

end($array)

Type: Function

Example:

{$colors = ['red','blue','green','purple']}
{$working = end($colors)}
<pre>{json_encode($colors, 128)}</pre>
<pre>{$working}</pre>
[
  "red",
  "blue",
  "green",
  "purple"
]
purple

escape

Encodes or escapes a string or variable. Possible values are html, htmlall,url, urlpathinfo, quotes, hex, hexentity, javascript, mail. Default is html.

More escape info and examples.

Type: Modifier

Example:

{"http://example.com test"|escape:'url'}
http%3A%2F%2Fexample.com%20test

explode

Converts a string to an array based on a specified delimiter.

Type: Modifier

Example:

{$test = ","|explode:"a,b,c"}
{$test|print_r}
Array
(
[0] => a
[1] => b
[2] => c
)
1

in_array

Checks to see if an item exists in an array

in_array($needle, $haystack)

Type: Function

Example:

{$colors = ['red','blue','green','purple']}
{if in_array('red', $colors)}
Red is in the colors array.
{else}
Red is not in the colors array.
{/if}
Red is in the colors array.

More in_array info and examples.

intval

Get the integer value of a variable. Note, this will not round a number.

intval("value")

Type: Function

Example:

{intval("102.33")}<br>
{intval("102.63")}
102
102

is_array

Checks to see if an array exists.

is_array($variable)

Type: Function

Example:

{$colors = ['red','blue','green','purple']}
{if is_array($colors)}
Colors is an array.
{else}
Colors is not an array.
{/if}
Colors is an array.

isset

Checks to see if a value exists.

isset($variable)

Type: Function

Example:

{if isset($contact.first_name)}
First name exists.
{else}
First name does not exist.
{/if}
"first_name": "Fred"
First name exists.

json_decode

Takes a JSON encoded string and converts it into a PHP variable.

json_decode($variable)

More info about json_decode.

Type: Function

Example:

{$enc = json_encode(["First"=>$contact.first_name,"Last"=>$contact.last_name,"Email"=>$contact.channels.email.address])}
enc: {$enc}
{$dec = json_decode($enc, true)}<br><br>
{foreach $dec as $key => $value}
{$key}: {$value}<br>
{/foreach}
enc: {"First":"Fred","Last":"Garvin","Email":"fredgarvin@example.com"} 

First: Fred
Last: Garvin
Email: fredgarvin@example.com

json_encode

Returns a string containing the JSON representation of the supplied value.

json_encode(["key"=>value,"key"=>value])

More info about json_encode.

Type: Function

Example:

{$enc = json_encode(["First"=>$contact.first_name,"Last"=>$contact.last_name,"Email"=>$contact.channels.email.address])}

enc: {$enc}
enc: {"First":"Fred","Last":"Garvin","Email":"fredgarvin@example.com"} 

jsonPrettyPrint

Prints data from a data collection in JSON format.

Type: Function

Example:

<H1>Debug contact</H1>
{$utils->jsonPrettyPrint($contact)}

Debug contact

{
  "_id": "58d2fc99ac0c8117814d4e78",
  "channels": {
    "email": {
      "address": "fredgarvin@example.com",
      "subscribeStatus": "subscribed",
      "unsubscribedAt": ""
    }
  },
  "last_name": "Fred",
  "lastModified": "2017-10-03T00:11:14+0000",
  "lists": [],
  "createdAt": "2017-03-22T22:37:13+0000",
  "lj": [],
  "first_name": "Garvin",
  "id": "58d2fc99ac0c8117814d4e78"
}

key_exists

Checks if the given key or index exists in the array.

key_exists('needle', $array)

Type: Function

Example:

{$fruits = ["d"=>"lemon","a"=>"orange","b"=>"banana","c"=>"apple"]}
{$check = key_exists('a', $fruits)}
<pre>{$check}</pre>
true

hash

Encode a string with a hashing algorithm.

Type: Modifier

Example:

{"test"|hash:"md5"}
098f6bcd4621d373cade4e832627b4f6

More info on hashing modifiers.

next

Return the next element in an array.

next($array)

Type: Function

Example:

{$colors = ['red','blue','green','purple']}
{$working = next($colors)}
<pre>{json_encode($colors, 128)}</pre>
<pre>{$working}</pre>
[
  "red",
  "blue",
  "green",
  "purple"
]
blue

nl2br

Converts "\n" line breaks to html <br /> tags in the given variable.

Type: Modifier

Example:

{$articleTitle = "Sun or rain expected\ntoday, dark tonight"}

{nl2br($articleTitle)}

Sun or rain expected<br>
today, dark tonight

prev

Return the prev element in an array.

prev($array)

Type: Function

Example:

{$colors = ['red','blue','green','purple']}
{$working = next($colors)}
{$working = prev($colors)}
<pre>{json_encode($colors, 128)}</pre>
<pre>{$working}</pre>
[
  "red",
  "blue",
  "green",
  "purple"
]
red

Prints the contents of a data feed in a message.

Type: Modifier

Example:

rand

A math equation that generates a random number between 2 specified numbers.

Type: function

Example:

{math equation='rand(1,1000)'}
127

Using the function to randomize content in a message.

replace

Replaces a character in a string with a specified character.

Type: Modifier

Example:

{$test = "hi there"}
{$test|replace:' ':'_'}
hi_there 

regex_replace

Regular expression search and replace.

Type: Modifier

Example:

{$url_missing_http = 'website.com/path'}
{$new_url = $url_missing_http|regex_replace:"/^(website.com)/":"https://website.com"}
{$utils->jsonPrettyPrint($new_url)}
"https://website.com/path"

round

Rounds a number up or down.

Type: Modifier

Example:

{23.95|round}<br>
{23.23|round}
24
23

sha1

Encode a string with the sha1 hashing algorithm.

Type: Modifier

Example:

{"test"|hash:"sha1"}
a94a8fe5ccb19ba61c4c0873d391e987982fbbd3

More info on hashing modifiers.

sizeof

Counts the number of items in an array.

sizeof($variable)

Type: Function

Example:

{$colors = ['red','blue','green','purple']}
The colors array contains {sizeof($colors)} items.<br><br>
The colors array contains 4 items.

stopMessage

Stops a message from sending.

Example:

{if 'condition'}
{stopMessage}
{/if}

string_format

Formats a string. Use the syntax for sprintf() for the formatting.

Type: Modifier

Example:

{$number = 23.5787446}

{$number}<br>
{$number|string_format:'%.2f'}<br>
{$number|string_format:'%d'}
23.5787446
23.58
23

str_replace

Replaces a character in a string with a specified character.

Type: Function

Example:

{$test = 'hi there'}
{str_replace(' ', '_', $test)}
hi_there 

strtotime

Converts a date to a Unix timestamp, which is the number of seconds that have passed since 1970.

Type: Modifier

Example:

{'Oct 3, 2017'|strtotime}
1506988800

Example:

Rendering content based if today's date is between 2 dates.

{$jan01 = '2017-01-01 00:00:00'|strtotime}
{$dec31 = '2017-12-31 23:59:59'|strtotime}
{if $smarty.now >= $jan01 && $smarty.now <= $dec31}
Today is between Jan 01, 2017 and Dec 31, 2017
{else}
Today is NOT between Jan 01, 2017 and Dec 31, 2017
{/if}

substr

Returns a part of a string.

More info from W3schools

Type: Modifier

Example:

{'Hello world'|substr:0:1}
<br>
{'Hello world'|substr:6:5}
<br>
{'Hello world'|substr:3}
H
world
lo world

time

Returns the current time in the number of seconds since the Unix Epoch (January 1 1970 00:00:00 GMT).

Type: Modifier

Example:

{time()}<br>
{time()|date_format}
1507139097
Oct 4, 2017

trim

Removes whitespace and other predefined characters from both sides of a string.

More info from W3schools

Type: Modifier

Example:

{$foo = "Hello World"}
{$foo|trim:"Hed"}
llo Worl

truncate

This truncates a variable to a character length, the default is 80. As an optional second parameter, you can specify a string of text to display at the end if the variable was truncated. The characters in the string are included with the original truncation length. By default, truncate will attempt to cut off at a word boundary. If you want to cut off at the exact character length, pass the optional third parameter of TRUE.

More info on truncate from smarty.net.

Type: Modifier

Example:

{$articleTitle ='Two Sisters Reunite after Eighteen Years at Checkout Counter'}
{$articleTitle|truncate:30}<br>
{$articleTitle|truncate:30:"...":true}<br>
{$articleTitle|truncate:30:'...':true:true}<br>
Two Sisters Reunite after...
Two Sisters Reunite after E...
Two Sisters R...ckout Counter

urldecode

Decodes url encoding in the given string. Plus symbols ('+') are decoded to a space character.

Type: Function

Example:

{$lnk = 'http%3A%2F%2Fwww.cordial.com%2Fproduct'}

{urldecode($lnk)}
http://www.cordial.com/product

urlencode

Encodes a URL string.  Spaces are encoded as plus (+) signs.

Type: Function

Example:

{$lnk = 'http://www.cordial.com/product'}

{urlencode($lnk)}
http%3A%2F%2Fwww.cordial.com%2Fproduct

Related articles

Comments

0 comments

Please sign in to leave a comment.