Skip to content

SmartyInterface

This is the main Smarty class

  • Full name: \Zotlabs\Render\SmartyInterface
  • Parent class: \Smarty

Properties

filename

public $filename

Methods

__construct

Initialize new Smarty object

public __construct(): mixed

parsed

public parsed(mixed $template = ''): mixed

Parameters:

Parameter Type Description
$template mixed

Inherited methods

__construct

Initialize new Smarty object

public __construct(): mixed

assign

assigns a Smarty variable

public assign(array|string $tpl_var, mixed $value = null, bool $nocache = false): \Smarty_Internal_Data

Parameters:

Parameter Type Description
$tpl_var array|string the template variable name(s)
$value mixed the value to assign
$nocache bool if true any output of this variable will be not cached

Return Value:

current Smarty_Internal_Data (or Smarty or Smarty_Internal_Template) instance for chaining

append

appends values to template variables

public append(array|string $tpl_var, mixed $value = null, bool $merge = false, bool $nocache = false): \Smarty_Internal_Data|\Smarty_Internal_Template|\Smarty

Parameters:

Parameter Type Description
$tpl_var array|string the template variable name(s)
$value mixed the value to append
$merge bool flag if array elements shall be merged
$nocache bool if true any output of this variable will
be not cached

See Also:

  • https://www.smarty.net/docs/en/api.append.tpl -

assignGlobal

assigns a global Smarty variable

public assignGlobal(string $varName, mixed $value = null, bool $nocache = false): \Smarty_Internal_Data|\Smarty_Internal_Template|\Smarty

Parameters:

Parameter Type Description
$varName string the global variable name
$value mixed the value to assign
$nocache bool if true any output of this variable will be not cached

appendByRef

appends values to template variables by reference

public appendByRef(string $tpl_var, mixed& $value, bool $merge = false): \Smarty_Internal_Data|\Smarty_Internal_Template|\Smarty

Parameters:

Parameter Type Description
$tpl_var string the template variable name
$value mixed the referenced value to append
$merge bool flag if array elements shall be merged

assignByRef

assigns values to template variables by reference

public assignByRef(string $tpl_var, mixed& $value, bool $nocache = false): \Smarty_Internal_Data|\Smarty_Internal_Template|\Smarty

Parameters:

Parameter Type Description
$tpl_var string the template variable name
$value mixed
$nocache bool if true any output of this variable will be not cached

getTemplateVars

Returns a single or all template variables

public getTemplateVars(string $varName = null, \Smarty_Internal_Data|\Smarty_Internal_Template|\Smarty $_ptr = null, bool $searchParents = true): mixed

Parameters:

Parameter Type Description
$varName string variable name or null
$_ptr \Smarty_Internal_Data|\Smarty_Internal_Template|\Smarty optional pointer to data object
$searchParents bool include parent templates?

Return Value:

variable value or or array of variables

See Also:

  • https://www.smarty.net/docs/en/api.get.template.vars.tpl -

_mergeVars

Follow the parent chain an merge template and config variables

public _mergeVars(\Smarty_Internal_Data|null $data = null): mixed

Parameters:

Parameter Type Description
$data \Smarty_Internal_Data|null

_isDataObj

Return true if this instance is a Data obj

public _isDataObj(): bool

_isTplObj

Return true if this instance is a template obj

public _isTplObj(): bool

_isSmartyObj

Return true if this instance is a Smarty obj

public _isSmartyObj(): bool

_getSmartyObj

Get Smarty object

public _getSmartyObj(): \Smarty

__call

Handle unknown class methods

public __call(string $name, array $args): mixed

Parameters:

Parameter Type Description
$name string unknown method-name
$args array argument array

fetch

fetches a rendered Smarty template

public fetch(string $template = null, mixed $cache_id = null, mixed $compile_id = null, object $parent = null): string

Parameters:

Parameter Type Description
$template string the resource handle of the template file or template object
$cache_id mixed cache id to be used with this template
$compile_id mixed compile id to be used with this template
$parent object next higher level of Smarty variables

Return Value:

rendered template output

Throws:

display

displays a Smarty template

public display(string $template = null, mixed $cache_id = null, mixed $compile_id = null, object $parent = null): mixed

Parameters:

Parameter Type Description
$template string the resource handle of the template file or template object
$cache_id mixed cache id to be used with this template
$compile_id mixed compile id to be used with this template
$parent object next higher level of Smarty variables

Throws:

isCached

test if cache is valid

public isCached(null|string|\Smarty_Internal_Template $template = null, mixed $cache_id = null, mixed $compile_id = null, object $parent = null): bool

Parameters:

Parameter Type Description
$template null|string|\Smarty_Internal_Template the resource handle of the template file or template
object
$cache_id mixed cache id to be used with this template
$compile_id mixed compile id to be used with this template
$parent object next higher level of Smarty variables

Return Value:

cache status

Throws:

See Also:

  • https://www.smarty.net/docs/en/api.is.cached.tpl -

_execute

fetches a rendered Smarty template

private _execute(string $template, mixed $cache_id, mixed $compile_id, object $parent, string $function): mixed

Parameters:

Parameter Type Description
$template string the resource handle of the template file or template object
$cache_id mixed cache id to be used with this template
$compile_id mixed compile id to be used with this template
$parent object next higher level of Smarty variables
$function string function type 0 = fetch, 1 = display, 2 = isCache

Throws:

registerPlugin

Registers plugin to be used in templates

public registerPlugin(string $type, string $name, callable $callback, bool $cacheable = true, mixed $cache_attr = null): \Smarty|\Smarty_Internal_Template

Parameters:

Parameter Type Description
$type string plugin type
$name string name of template tag
$callback callable PHP callback to register
$cacheable bool if true (default) this function is cache able
$cache_attr mixed caching attributes if any

Throws:

See Also:

  • https://www.smarty.net/docs/en/api.register.plugin.tpl -

loadFilter

load a filter of specified type and name

public loadFilter(string $type, string $name): bool

Parameters:

Parameter Type Description
$type string filter type
$name string filter name

Throws:

See Also:

  • https://www.smarty.net/docs/en/api.load.filter.tpl -

registerFilter

Registers a filter function

public registerFilter(string $type, callable $callback, string|null $name = null): \Smarty|\Smarty_Internal_Template

Parameters:

Parameter Type Description
$type string filter type
$callback callable
$name string|null optional filter name

Throws:

See Also:

  • https://www.smarty.net/docs/en/api.register.filter.tpl -

registerObject

Registers object to be used in templates

public registerObject(string $object_name, object $object, array $allowed_methods_properties = array(), bool $format = true, array $block_methods = array()): \Smarty|\Smarty_Internal_Template

Parameters:

Parameter Type Description
$object_name string
$object object the referenced PHP object to register
$allowed_methods_properties array list of allowed methods (empty = all)
$format bool smarty argument format, else traditional
$block_methods array list of block-methods

Throws:

See Also:

  • https://www.smarty.net/docs/en/api.register.object.tpl -

setCompileCheck

public setCompileCheck(int $compile_check): mixed

Parameters:

Parameter Type Description
$compile_check int

setCaching

public setCaching(int $caching): mixed

Parameters:

Parameter Type Description
$caching int

setCacheLifetime

public setCacheLifetime(int $cache_lifetime): mixed

Parameters:

Parameter Type Description
$cache_lifetime int

setCompileId

public setCompileId(string $compile_id): mixed

Parameters:

Parameter Type Description
$compile_id string

setCacheId

public setCacheId(string $cache_id): mixed

Parameters:

Parameter Type Description
$cache_id string

templateExists

Check if a template resource exists

public templateExists(string $resource_name): bool

Parameters:

Parameter Type Description
$resource_name string template name

Return Value:

status

Throws:

enableSecurity

Loads security class and enables security

public enableSecurity(string|\Smarty_Security $security_class = null): \Smarty

Parameters:

Parameter Type Description
$security_class string|\Smarty_Security if a string is used, it must be class-name

Return Value:

current Smarty instance for chaining

Throws:

disableSecurity

Disable security

public disableSecurity(): \Smarty

Return Value:

current Smarty instance for chaining

addTemplateDir

Add template directory(s)

public addTemplateDir(string|array $template_dir, string $key = null, bool $isConfig = false): \Smarty

Parameters:

Parameter Type Description
$template_dir string|array directory(s) of template sources
$key string of the array element to assign the template dir to
$isConfig bool true for config_dir

Return Value:

current Smarty instance for chaining

getTemplateDir

Get template directories

public getTemplateDir(mixed $index = null, bool $isConfig = false): array|string

Parameters:

Parameter Type Description
$index mixed index of directory to get, null to get all
$isConfig bool true for config_dir

Return Value:

list of template directories, or directory of $index

setTemplateDir

Set template directory

public setTemplateDir(string|array $template_dir, bool $isConfig = false): \Smarty

Parameters:

Parameter Type Description
$template_dir string|array directory(s) of template sources
$isConfig bool true for config_dir

Return Value:

current Smarty instance for chaining

addConfigDir

Add config directory(s)

public addConfigDir(string|array $config_dir, mixed $key = null): \Smarty

Parameters:

Parameter Type Description
$config_dir string|array directory(s) of config sources
$key mixed key of the array element to assign the config dir to

Return Value:

current Smarty instance for chaining

getConfigDir

Get config directory

public getConfigDir(mixed $index = null): array

Parameters:

Parameter Type Description
$index mixed index of directory to get, null to get all

Return Value:

configuration directory

setConfigDir

Set config directory

public setConfigDir(mixed $config_dir): \Smarty

Parameters:

Parameter Type Description
$config_dir mixed

Return Value:

current Smarty instance for chaining

addPluginsDir

Adds directory of plugin files

public addPluginsDir(null|array|string $plugins_dir): \Smarty

Parameters:

Parameter Type Description
$plugins_dir null|array|string

Return Value:

current Smarty instance for chaining

getPluginsDir

Get plugin directories

public getPluginsDir(): array

Return Value:

list of plugin directories

setPluginsDir

Set plugins directory

public setPluginsDir(string|array $plugins_dir): \Smarty

Parameters:

Parameter Type Description
$plugins_dir string|array directory(s) of plugins

Return Value:

current Smarty instance for chaining

getCompileDir

Get compiled directory

public getCompileDir(): string

Return Value:

path to compiled templates

setCompileDir

public setCompileDir(string $compile_dir): \Smarty

Parameters:

Parameter Type Description
$compile_dir string directory to store compiled templates in

Return Value:

current Smarty instance for chaining

getCacheDir

Get cache directory

public getCacheDir(): string

Return Value:

path of cache directory

setCacheDir

Set cache directory

public setCacheDir(string $cache_dir): \Smarty

Parameters:

Parameter Type Description
$cache_dir string directory to store cached templates in

Return Value:

current Smarty instance for chaining

createTemplate

creates a template object

public createTemplate(string $template, mixed $cache_id = null, mixed $compile_id = null, object $parent = null, bool $do_clone = true): \Smarty_Internal_Template

Parameters:

Parameter Type Description
$template string the resource handle of the template file
$cache_id mixed cache id to be used with this template
$compile_id mixed compile id to be used with this template
$parent object next higher level of Smarty variables
$do_clone bool flag is Smarty object shall be cloned

Return Value:

template object

Throws:

loadPlugin

Takes unknown classes and loads plugin files for them class name format: Smarty_PluginType_PluginName plugin filename format: plugintype.pluginname.php

public loadPlugin(string $plugin_name, bool $check = true): string|bool

Parameters:

Parameter Type Description
$plugin_name string class plugin name to load
$check bool check if already loaded

Return Value:

filepath of loaded file or false

Throws:

_getTemplateId

Get unique template id

public _getTemplateId(string $template_name, null|mixed $cache_id = null, null|mixed $compile_id = null, null $caching = null, \Smarty_Internal_Template $template = null): string

Parameters:

Parameter Type Description
$template_name string
$cache_id null|mixed
$compile_id null|mixed
$caching null
$template \Smarty_Internal_Template

Throws:

_realpath

Normalize path - remove /./ and /../ - make it absolute if required

public _realpath(string $path, bool $realpath = null): string

Parameters:

Parameter Type Description
$path string file path
$realpath bool if true - convert to absolute
false - convert to relative
null - keep as it is but
remove /./ /../

_clearTemplateCache

Empty template objects cache

public _clearTemplateCache(): mixed

setUseSubDirs

public setUseSubDirs(bool $use_sub_dirs): mixed

Parameters:

Parameter Type Description
$use_sub_dirs bool

setErrorReporting

public setErrorReporting(int $error_reporting): mixed

Parameters:

Parameter Type Description
$error_reporting int

setEscapeHtml

public setEscapeHtml(bool $escape_html): mixed

Parameters:

Parameter Type Description
$escape_html bool

getAutoLiteral

Return auto_literal flag

public getAutoLiteral(): bool

setAutoLiteral

Set auto_literal flag

public setAutoLiteral(bool $auto_literal = true): mixed

Parameters:

Parameter Type Description
$auto_literal bool

setForceCompile

public setForceCompile(bool $force_compile): mixed

Parameters:

Parameter Type Description
$force_compile bool

setMergeCompiledIncludes

public setMergeCompiledIncludes(bool $merge_compiled_includes): mixed

Parameters:

Parameter Type Description
$merge_compiled_includes bool

getLeftDelimiter

Get left delimiter

public getLeftDelimiter(): string

setLeftDelimiter

Set left delimiter

public setLeftDelimiter(string $left_delimiter): mixed

Parameters:

Parameter Type Description
$left_delimiter string

getRightDelimiter

Get right delimiter

public getRightDelimiter(): string

Return Value:

$right_delimiter

setRightDelimiter

Set right delimiter

public setRightDelimiter(mixed $right_delimiter): mixed

Parameters:

Parameter Type Description
$right_delimiter mixed

setDebugging

public setDebugging(bool $debugging): mixed

Parameters:

Parameter Type Description
$debugging bool

setConfigOverwrite

public setConfigOverwrite(bool $config_overwrite): mixed

Parameters:

Parameter Type Description
$config_overwrite bool

setConfigBooleanize

public setConfigBooleanize(bool $config_booleanize): mixed

Parameters:

Parameter Type Description
$config_booleanize bool

setConfigReadHidden

public setConfigReadHidden(bool $config_read_hidden): mixed

Parameters:

Parameter Type Description
$config_read_hidden bool

setCompileLocking

public setCompileLocking(bool $compile_locking): mixed

Parameters:

Parameter Type Description
$compile_locking bool

setDefaultResourceType

public setDefaultResourceType(string $default_resource_type): mixed

Parameters:

Parameter Type Description
$default_resource_type string

setCachingType

public setCachingType(string $caching_type): mixed

Parameters:

Parameter Type Description
$caching_type string

testInstall

Test install

public testInstall(null& $errors = null): mixed

Parameters:

Parameter Type Description
$errors null

__get

<> Generic getter.

public __get(string $name): mixed

Calls the appropriate getter function. Issues an E_USER_NOTICE if no valid getter is found.

Parameters:

Parameter Type Description
$name string property name

__set

<> Generic setter.

public __set(string $name, mixed $value): mixed

Calls the appropriate setter function. Issues an E_USER_NOTICE if no valid setter is found.

Parameters:

Parameter Type Description
$name string property name
$value mixed parameter passed to setter

_normalizeDir

Normalize and set directory string

private _normalizeDir(string $dirName, string $dir): mixed

Parameters:

Parameter Type Description
$dirName string cache_dir or compile_dir
$dir string filepath of folder

_normalizeTemplateConfig

Normalize template_dir or config_dir

private _normalizeTemplateConfig(bool $isConfig): mixed

Parameters:

Parameter Type Description
$isConfig bool true for config_dir

muteUndefinedOrNullWarnings

Mutes errors for "undefined index", "undefined array key" and "trying to read property of null".

public muteUndefinedOrNullWarnings(): void

isMutingUndefinedOrNullWarnings

Indicates if Smarty will mute errors for "undefined index", "undefined array key" and "trying to read property of null".

public isMutingUndefinedOrNullWarnings(): bool

Automatically generated on 2025-03-18