Summary

Usage

fetch_alias( alias_name, hash( [ parameter1, value1, ]
                               [ parameter2, value2  ] ) )

Parameters

Description

This function can be thought of as a configuration-file based version of the "fetch" operator. It makes it possible to move data fetching blocks from template code to a configuration file and thus gather all fetches at one place. The advantage of such a scenario is that it allows quick modifications without the need of having to locate and modify different templates. The fetch aliases must be defined in a configuration override for "fetchalias.ini". Each fetch has to be defined within its own block with a unique name. The following code shows the basic syntax/structure of a fetch block.

[fetch_alias_name]
Module=module_name
FunctionName=function_name
Parameter[parameter1]=fetch_alias_name1
Parameter[parameter2]=fetch_alias_name2
...
Constant[parameter3]=<any value>
Constant[parameter4]=<any value>
...

Examples

Example 1

Configuration block:

[object]
Module=content
FunctionName=object
Parameter[object_id]=id

Template code:

{def $object=fetch_alias( 'object', hash( 'id', 1 ) )}

This example demonstrates how to fetch an object.

Example 2

Configuration block:

[comments]
Module=content
FunctionName=list
Constant[sort_by]=published;0
Parameter[parent_node_id]=parent_node_id
Constant[class_filter_type]=include
Constant[class_filter_array]=comment

Template code:

{def $comments=fetch_alias( 'comments', hash( 'parent_node_id', 42 ) )}

This example demonstrates how to fetch comments.

Example 3

Configuration block:

[news_list]
Module=content
FunctionName=tree
Constant[sort_by]=published;0
Constant[class_id]=2
Constant[parent_node_id]=2
Constant[class_filter_type]=include
Constant[limit]=10
Constant[class_filter_array]=2

Template code:

{foreach fetch_alias( 'news_list' ) as $article}
    {node_view_gui node=$article}
{/foreach}

This example demonstrates how to fetch and display the 10 latest news articles using full view.