object_list_count

Summary

Fetches the number of objects that belong to certain section.

Usage

fetch( 'section', 'object_list_count',
        hash( 'section_id', section_id,
            [ 'status',     status     ] ) )

Parameters

Returns

The number of objects (as an integer) that belong to the section.

Description

This function counts the number of objects that belong to a section specified by the "section_id" parameter. The optional "status" parameter works in the same way as in the "object_list" fetch function.

The function returns the count as an integer.

Examples

Example 1

{def $count=fetch( 'section', 'object_list_count',
                   hash( 'section_id', 13 ) )}

There are {$count} number of  objects in section number 13.

Outputs the number of published objects that belong to section number 13.

Example 2

{def $count=fetch( 'section', 'object_list_count',
                   hash( 'section_id', 5,
                         'status', 'archived' ) )}

There are {$count} number of archived objects in section number 5.

Outputs the number of objects that belong to section number 5 and are moved to the trash.