abstract class base implements template

Properties

protected context $context

Template context.

protected array $filenames

Array of filenames assigned to set_filenames

Methods

set_filenames(array $filename_array)

Sets the template filenames for handles.

string
get_filename_from_handle(string $handle)

Get a filename from the handle

destroy()

Clears all variables and blocks assigned to this template.

destroy_block_vars(string $blockname)

Reset/empty complete block

assign_vars(array $vararray)

Assign key variable pairs from an array

assign_var(string $varname, string $varval)

Assign a single scalar value to a single key.

append_var(string $varname, string $varval)

Append text to the string value stored in a key.

array
retrieve_vars(array $vararray)

Retrieve multiple template values

mixed
retrieve_var(string $varname)

Retrieve a single scalar value from a single key.

assign_block_vars(string $blockname, array $vararray)

Assign key variable pairs from an array to a specified block

assign_block_vars_array(string $blockname, array $block_vars_array)

Assign key variable pairs from an array to a whole specified block loop

array
retrieve_block_vars(string $blockname, array $vararray)

Retrieve variable values from an specified block

bool
alter_block_array(string $blockname, array $vararray, mixed $key = false, string $mode = 'insert')

Change already assigned key variable pair (one-dimensional - single loop entry)

mixed
find_key_index(string $blockname, mixed $key)

Find the index for a specified key in the innermost specified block

call_hook(string $handle, string $method)

Calls hook if any is defined.

Details

at line 36
template set_filenames(array $filename_array)

Sets the template filenames for handles.

Parameters

array $filename_array

Should be a hash of handle => filename pairs.

Return Value

template $this

at line 49
protected string get_filename_from_handle(string $handle)

Get a filename from the handle

Parameters

string $handle

Return Value

string

at line 57
template destroy()

Clears all variables and blocks assigned to this template.

Return Value

template $this

at line 67
template destroy_block_vars(string $blockname)

Reset/empty complete block

Parameters

string $blockname

Name of block to destroy

Return Value

template $this

at line 77
template assign_vars(array $vararray)

Assign key variable pairs from an array

Parameters

array $vararray

A hash of variable name => value pairs

Return Value

template $this

at line 90
template assign_var(string $varname, string $varval)

Assign a single scalar value to a single key.

Value can be a string, an integer or a boolean.

Parameters

string $varname

Variable name

string $varval

Value to assign to variable

Return Value

template $this

at line 100
template append_var(string $varname, string $varval)

Append text to the string value stored in a key.

Text is appended using the string concatenation operator (.).

Parameters

string $varname

Variable name

string $varval

Value to append to variable

Return Value

template $this

at line 110
array retrieve_vars(array $vararray)

Retrieve multiple template values

Parameters

array $vararray

An array with variable names

Return Value

array

A hash of variable name => value pairs (value is null if not set)

at line 123
mixed retrieve_var(string $varname)

Retrieve a single scalar value from a single key.

Parameters

string $varname

Variable name

Return Value

mixed

Variable value, or null if not set

at line 131
template assign_block_vars(string $blockname, array $vararray)

Assign key variable pairs from an array to a specified block

Parameters

string $blockname

Name of block to assign $vararray to

array $vararray

A hash of variable name => value pairs

Return Value

template $this

at line 141
template assign_block_vars_array(string $blockname, array $block_vars_array)

Assign key variable pairs from an array to a whole specified block loop

Parameters

string $blockname

Name of block to assign $block_vars_array to

array $block_vars_array

An array of hashes of variable name => value pairs

Return Value

template $this

at line 151
array retrieve_block_vars(string $blockname, array $vararray)

Retrieve variable values from an specified block

Parameters

string $blockname

Name of block to retrieve $vararray from

array $vararray

An array with variable names, empty array gets all vars

Return Value

array

A hash of variable name => value pairs (value is null if not set)

at line 159
bool alter_block_array(string $blockname, array $vararray, mixed $key = false, string $mode = 'insert')

Change already assigned key variable pair (one-dimensional - single loop entry)

An example of how to use this function: {@example alter_block_array.php}

Parameters

string $blockname

the blockname, for example 'loop'

array $vararray

the var array to insert/add or merge

mixed $key

Key to search for

array: KEY => VALUE [the key/value pair to search for within the loop to determine the correct position]

int: Position [the position to change or insert at directly given]

If key is false the position is set to 0 If key is true the position is set to the last entry

string $mode

Mode to execute (valid modes are 'insert', 'change' and 'delete')

If insert, the vararray is inserted at the given position (position counting from zero). If change, the current block gets merged with the vararray (resulting in new \key/value pairs be added and existing keys be replaced by the new \value). If delete, the vararray is ignored, and the block at the given position (counting from zero) is removed.

Since counting begins by zero, inserting at the last position will result in this array: array(vararray, last positioned array) and inserting at position 1 will result in this array: array(first positioned array, vararray, following vars)

Return Value

bool

false on error, true on success

at line 167
mixed find_key_index(string $blockname, mixed $key)

Find the index for a specified key in the innermost specified block

Parameters

string $blockname

the blockname, for example 'loop'

mixed $key

Key to search for

array: KEY => VALUE [the key/value pair to search for within the loop to determine the correct position]

int: Position [the position to search for]

If key is false the position is set to 0 If key is true the position is set to the last entry

Return Value

mixed

false if not found, index position otherwise; be sure to test with ===

at line 178
protected call_hook(string $handle, string $method)

Calls hook if any is defined.

Parameters

string $handle

Template handle being displayed.

string $method

Method name of the caller.