Caution: This documentation is for eZ Publish legacy, from version 3.x to 6.x.
For 5.x documentation covering Platform see eZ Documentation Center, for difference between legacy and Platform see 5.x Architecture overview.

ezpagedata_append

Summary

Appends a new value into a persistent variable.

Usage

ezpagedata_append( key, value )

Parameters

NameTypeDescriptionRequired
key string The key from the persistent variable to append into. Yes.
value mixed The value to add into your persistent variable. Yes.

Description

The ezpagedata_append() operator appends a new value into a persistent variable into your page data. The new value will be added as a array entry.
If the target persistent variable is not a array, then an array will be created, replacing the existing value. Please note that this will destroy the previously stored data in your persistent variable.
If the target persistent variable doesn't exist, a new one will be created.

This operator has been introduced by eZ Website Interface, and it is required that the ezwebin extension is installed to use it.

Created/appended persistent variables can be accessed by using the ezpagedata() operator.

Examples

Example 1

{ezpagedata_set('my_new_persistent_variable', hash('my_value',918))}
{ezpagedata_append('my_new_persistent_variable', hash('my_second_value',64))}
 
{def $mypageData = ezpagedata()}
{$mypageData.persistent_variable|attribute(show)}

A new value should be appended into your 'my_new_persistent_variable' persistent variable.

When using the attribute(show) operator to output the content of your persistent_variable it should look like the following:

Attribute

Type

Value

js_files

array

Array(6)

>0

string

'ezjsc::yui3'

>1

string

'ezjsc::yui3io'

>2

string

'ezcontentstaging_yui3.js'

>3

string

'node_tabs.js'

>4

string

'ezjsc::yui2'

>5

string

'ezajaxsubitems_datatable.js'

my_new_persistent_variable

array

Array(2)

>my_value

integer

918

>my_second_value

integer

64

Example 2

{ezpagedata_set('my_second_persistent_variable','Some text')}
{ezpagedata_append('my_second_persistent_variable','Another text')}
 
{def $mypageData = ezpagedata()}
{$mypageData.persistent_variable|attribute(show)}

The 'my_second_persistent_variable' persistent variable should be replaced with an array.

The output created by the attribute(show) operator should look like the following:

Attribute

Type

Value

js_files

array

Array(6)

>0

string

'ezjsc::yui3'

>1

string

'ezjsc::yui3io'

>2

string

'ezcontentstaging_yui3.js'

>3

string

'node_tabs.js'

>4

string

'ezjsc::yui2'

>5

string

'ezajaxsubitems_datatable.js'

my_second_persistent_variable

array

Array(1)

>0

string

'Another text'

Example 3

{ezpagedata_append('my_third_persistent_variable',hash('value1','Hello world!'))}
 
{def $mypageData = ezpagedata()}
{$mypageData.persistent_variable|attribute(show)}

The 'my_third_persistent_variable' persistent variable will be created, since it doesn't exists.

The output created by the attribute(show) operator should look like the following:

Attribute

Type

Value

js_files

array

Array(6)

>0

string

'ezjsc::yui3'

>1

string

'ezjsc::yui3io'

>2

string

'ezcontentstaging_yui3.js'

>3

string

'node_tabs.js'

>4

string

'ezjsc::yui2'

>5

string

'ezajaxsubitems_datatable.js'

my_third_persistent_variable

array

Array(1)

>value1

string

'Hello world!'

Ricardo Correia (01/02/2013 11:40 am)

Ricardo Correia (01/02/2013 2:13 pm)


Comments

There are no comments.