Summary

Usage

fetch( 'content', 'view_top_list',
       hash( [ 'section_id', section_id, ]
             [ 'class_id',   class_id,   ]
             [ 'offset',     offset,     ]
             [ 'limit',      limit       ] ) )

Parameters

Returns

An array of ezcontentobjecttreenode objects.

Description

This function fetches the most popular (most viewed) nodes. The function returns an array of ezcontentobjecttreenode objects. The "section_id" and "class_id" parameters can be used to filter out objects of certain type and/or objects that belong to a certain section. The "offset" and "limit" parameters can be used to limit the result.

In order to work, this function requires the use of the cronjob script. A part of this script will update the view counters of the nodes by analyzing the Apache log files. The "Scripts[]" array of a configuration override for "cronjob.ini" should include the "updateviewcount.php" script:

...
Scripts[]=updateviewcount.php
...

In addition, the logfile settings in "logfile.ini" should match the syntax of the Apache log files.

Examples

Example 1

{def $popular_nodes=fetch( 'content', 'view_top_list',
                           hash( 'class_id',  2,
                                 'limit',    10,
                                 'offset',    0 ) )}
 
{foreach $popular_nodes as $popular_node}
    {$popular_node.name|wash} <br />
{/foreach}

Outputs the names of the ten most popular nodes that encapsulate objects of class number 2.