API Documentation

View/Helper/Navigation/Links.php

Zend Framework

LICENSE

This source file is subject to the new BSD license that is bundled with this package in the file LICENSE.txt. It is also available through the world-wide-web at this URL: http://framework.zend.com/license/new-bsd If you did not receive a copy of the license and are unable to obtain it through the world-wide-web, please send an email to license@zend.com so we can send you a copy immediately.

category
Zend  
copyright
Copyright (c) 2005-2011 Zend Technologies USA Inc. (http://www.zend.com)  
license
New BSD License  
package
Zend_View  
subpackage
Helper  
version
$Id: Links.php 23775 2011-03-01 17:25:24Z ralph $  

\Zend_View_Helper_Navigation_Links

Helper for printing <link> elements

Extends from
\Zend_View_Helper_Navigation_HelperAbstract
category
Zend  
copyright
Copyright (c) 2005-2011 Zend Technologies USA Inc. (http://www.zend.com)  
license
New BSD License  
package
Zend_View  
subpackage
Helper  

Constants

Constant  RENDER_ALTERNATE = '0x0001'
Constant  RENDER_STYLESHEET = '0x0002'
Constant  RENDER_START = '0x0004'
Constant  RENDER_NEXT = '0x0008'
Constant  RENDER_PREV = '0x0010'
Constant  RENDER_CONTENTS = '0x0020'
Constant  RENDER_INDEX = '0x0040'
Constant  RENDER_GLOSSARY = '0x0080'
Constant  RENDER_COPYRIGHT = '0x0100'
Constant  RENDER_CHAPTER = '0x0200'
Constant  RENDER_SECTION = '0x0400'
Constant  RENDER_SUBSECTION = '0x0800'
Constant  RENDER_APPENDIX = '0x1000'
Constant  RENDER_HELP = '0x2000'
Constant  RENDER_BOOKMARK = '0x4000'
Constant  RENDER_CUSTOM = '0x8000'
Constant  RENDER_ALL = '0xffff'

Properties

Propertyprotectedarray  $_RELATIONS= 'array'
static

Maps render constants to W3C link types

Default valuearrayDetails
Type
array
Propertyprotectedint  $_renderFlag= 'self'

The helper's render flag

Default valueselfDetails
Type
int
see
\render()  
see
\setRenderFlag()  
Propertyprotected\Zend_Navigation_Container  $_root= ''

Root container

Used for preventing methods to traverse above the container given to the {@link render()} method.

Details
Type
\Zend_Navigation_Container
see
\_findRoot()  

Methods

methodpublic__call( string $method, array $arguments = array ) : mixed

Magic overload: Proxy calls to {@link findRelation()} or container

Examples of finder calls:

// METHOD                  // SAME AS
$h->findRelNext($page);    // $h->findRelation($page, 'rel', 'next')
$h->findRevSection($page); // $h->findRelation($page, 'rev', 'section');
$h->findRelFoo($page);     // $h->findRelation($page, 'rel', 'foo');
Parameters
Name Type Description
$method string method name
$arguments array method arguments
Returns
Type Description
mixed returns what the container returns
Throws
Exception Description
\Zend_Navigation_Exception if method does not exist in container
methodpublic__toString( ) : string

Magic overload: Proxy to {@link render()}.

Inherited from: \Zend_View_Helper_Navigation_HelperAbstract::__toString()

This method will trigger an E_USER_ERROR if rendering the helper causes an exception to be thrown.

Implements {@link Zend_View_Helper_Navigation_Helper::__toString()}.

Returns
Type Description
string
methodprotected_acceptAcl( \Zend_Navigation_Page $page ) : bool

Determines whether a page should be accepted by ACL when iterating

Inherited from: \Zend_View_Helper_Navigation_HelperAbstract::_acceptAcl()

Rules: - If helper has no ACL, page is accepted - If page has a resource or privilege defined, page is accepted if the ACL allows access to it using the helper's role - If page has no resource or privilege, page is accepted

Parameters
Name Type Description
$page \Zend_Navigation_Page page to check
Returns
Type Description
bool whether page is accepted by ACL
methodprotected_convertToPages( mixed $mixed, bool $recursive = true ) : \Zend_Navigation_Page|array|null

Converts a $mixed value to an array of pages

Parameters
Name Type Description
$mixed mixed

mixed value to get page(s) from

$recursive bool

whether $value should be looped if it is an array or a config

Returns
Type Description
\Zend_Navigation_Pagearraynull empty if unable to convert
methodprotected_findFromProperty( \Zend_Navigation_Page $page, string $rel, string $type ) : \Zend_Navigation_Page|array|null

Finds relations of given $type for $page by checking if the relation is specified as a property of $page

Parameters
Name Type Description
$page \Zend_Navigation_Page page to find relations for
$rel string

relation, 'rel' or 'rev'

$type string

link type, e.g. 'start', 'next'

Returns
Type Description
\Zend_Navigation_Pagearraynull page(s), or null if not found
methodprotected_findFromSearch( \Zend_Navigation_Page $page, string $rel, string $type ) : array|null

Finds relations of given $rel=$type for $page by using the helper to search for the relation in the root container

Parameters
Name Type Description
$page \Zend_Navigation_Page page to find relations for
$rel string

relation, 'rel' or 'rev'

$type string

link type, e.g. 'start', 'next', etc

Returns
Type Description
arraynull array of pages, or null if not found
methodprotected_findRoot( \Zend_Navigaiton_Page $page ) : \Zend_Navigation_Container

Returns the root container of the given page

When rendering a container, the render method still store the given container as the root container, and unset it when done rendering. This makes sure finder methods will not traverse above the container given to the render method.

Parameters
Name Type Description
$page \Zend_Navigaiton_Page page to find root for
Returns
Type Description
\Zend_Navigation_Container the root container of the given page
methodprotected_getWhitespace( int|string $indent ) : string

Retrieve whitespace representation of $indent

Inherited from: \Zend_View_Helper_Navigation_HelperAbstract::_getWhitespace()
Parameters
Name Type Description
$indent int|string
Returns
Type Description
string
methodprotected_htmlAttribs( array $attribs ) : string

Converts an associative array to a string of tag attributes.

Inherited from: \Zend_View_Helper_Navigation_HelperAbstract::_htmlAttribs()

Overloads {@link Zend_View_Helper_HtmlElement::_htmlAttribs()}.

Parameters
Name Type Description
$attribs array

an array where each key-value pair is converted to an attribute name and value

Returns
Type Description
string an attribute string
methodprotected_isStrictDoctype( ) : boolean

Is doctype strict?

Inherited from: \Zend_View_Helper_HtmlElement::_isStrictDoctype()
Returns
Type Description
boolean
methodprotected_isXhtml( ) : boolean

Is doctype XHTML?

Inherited from: \Zend_View_Helper_HtmlElement::_isXhtml()
Returns
Type Description
boolean
methodprotected_normalizeId( string $value ) : string

Overrides {@link Zend_View_Helper_HtmlElement::_normalizeId()}.

Parameters
Name Type Description
$value string
Returns
Type Description
string
methodpublicaccept( \Zend_Navigation_Page $page, bool $recursive = true ) : bool

Determines whether a page should be accepted when iterating

Inherited from: \Zend_View_Helper_Navigation_HelperAbstract::accept()

Rules: - If a page is not visible it is not accepted, unless RenderInvisible has been set to true. - If helper has no ACL, page is accepted - If helper has ACL, but no role, page is not accepted - If helper has ACL and role: - Page is accepted if it has no resource or privilege - Page is accepted if ACL allows page's resource or privilege - If page is accepted by the rules above and $recursive is true, the page will not be accepted if it is the descendant of a non-accepted page.

Parameters
Name Type Description
$page \Zend_Navigation_Page page to check
$recursive bool

[optional] if true, page will not be accepted if it is the descendant of a page that is not accepted. Default is true.

Returns
Type Description
bool whether page should be accepted
methodpublicdirect( ) : void

Strategy pattern: currently unutilized

Inherited from: \Zend_View_Helper_Abstract::direct()
methodpublicfindActive( \Zend_Navigation_Container $container, int|null|int|null $minDepth = null,  $maxDepth ) : array

Finds the deepest active page in the given container

Inherited from: \Zend_View_Helper_Navigation_HelperAbstract::findActive()
Parameters
Name Type Description
$container \Zend_Navigation_Container container to search
$minDepth int|null|int|null

[optional] minimum depth required for page to be valid. Default is to use {@link getMinDepth()}. A null value means no minimum depth required.

$maxDepth
Returns
Type Description
array an associative array with the values 'depth' and 'page', or an empty array if not found
methodpublicfindAllRelations( \Zend_Navigation_Page $page,  $flag = null ) : array

Finds all relations (forward and reverse) for the given $page

The form of the returned array:

// $page denotes an instance of Zend_Navigation_Page
$returned = array(
    'rel' => array(
        'alternate' => array($page, $page, $page),
        'start'     => array($page),
        'next'      => array($page),
        'prev'      => array($page),
        'canonical' => array($page)
    ),
    'rev' => array(
        'section'   => array($page)
    )
);
Parameters
Name Type Description
$page \Zend_Navigation_Page page to find links for
$flag
Returns
Type Description
array related pages
methodpublicfindRelation( \Zend_Navigation_Page $page, string $rel, string $type ) : \Zend_Navigaiton_Page|array|null

Finds relations of the given $rel=$type from $page

This method will first look for relations in the page instance, then by searching the root container if nothing was found in the page.

Parameters
Name Type Description
$page \Zend_Navigation_Page page to find relations for
$rel string

relation, "rel" or "rev"

$type string

link type, e.g. 'start', 'next'

Returns
Type Description
\Zend_Navigaiton_Pagearraynull page(s), or null if not found
Throws
Exception Description
\Zend_View_Exception if $rel is not "rel" or "rev"
methodpublicgetAcl( ) : \Zend_Acl|null

Returns ACL or null if it isn't set using {@link setAcl()} or {@link setDefaultAcl()}

Inherited from: \Zend_View_Helper_Navigation_HelperAbstract::getAcl()

Implements {@link Zend_View_Helper_Navigation_Helper::getAcl()}.

Returns
Type Description
\Zend_Aclnull ACL object or null
methodpublicgetClosingBracket( ) : string

Get the tag closing bracket

Inherited from: \Zend_View_Helper_HtmlElement::getClosingBracket()
Returns
Type Description
string
methodpublicgetContainer( ) : \Zend_Navigation_Container

Returns the navigation container helper operates on by default

Inherited from: \Zend_View_Helper_Navigation_HelperAbstract::getContainer()

Implements {@link Zend_View_Helper_Navigation_Interface::getContainer()}.

If a helper is not explicitly set in this helper instance by calling {@link setContainer()} or by passing it through the helper entry point, this method will look in {@link Zend_Registry} for a container by using the key 'Zend_Navigation'.

If no container is set, and nothing is found in Zend_Registry, a new container will be instantiated and stored in the helper.

Returns
Type Description
\Zend_Navigation_Container navigation container
methodpublicgetIndent( ) : string

Returns indentation

Inherited from: \Zend_View_Helper_Navigation_HelperAbstract::getIndent()
Returns
Type Description
string
methodpublicgetMaxDepth( ) : int|null

Returns maximum depth a page can have to be included when rendering

Inherited from: \Zend_View_Helper_Navigation_HelperAbstract::getMaxDepth()
Returns
Type Description
intnull maximum depth or null
methodpublicgetMinDepth( ) : int|null

Returns minimum depth a page must have to be included when rendering

Inherited from: \Zend_View_Helper_Navigation_HelperAbstract::getMinDepth()
Returns
Type Description
intnull minimum depth or null
methodpublicgetRenderFlag( ) : int

Returns the helper's render flag

Returns
Type Description
int render flag
methodpublicgetRenderInvisible( ) : bool

Return renderInvisible flag

Inherited from: \Zend_View_Helper_Navigation_HelperAbstract::getRenderInvisible()
Returns
Type Description
bool
methodpublicgetRole( ) : string|\Zend_Acl_Role_Interface|null

Returns ACL role to use when iterating pages, or null if it isn't set using {@link setRole()} or {@link setDefaultRole()}

Inherited from: \Zend_View_Helper_Navigation_HelperAbstract::getRole()

Implements {@link Zend_View_Helper_Navigation_Helper::getRole()}.

Returns
Type Description
string\Zend_Acl_Role_Interfacenull role or null
methodpublicgetTranslator( ) : \Zend_Translate_Adapter|null

Returns translator used in helper

Inherited from: \Zend_View_Helper_Navigation_HelperAbstract::getTranslator()

Implements {@link Zend_View_Helper_Navigation_Helper::getTranslator()}.

Returns
Type Description
\Zend_Translate_Adapternull translator or null
methodpublicgetUseAcl( ) : bool

Returns whether ACL should be used

Inherited from: \Zend_View_Helper_Navigation_HelperAbstract::getUseAcl()

Implements {@link Zend_View_Helper_Navigation_Helper::getUseAcl()}.

Returns
Type Description
bool whether ACL should be used
methodpublicgetUseTranslator( ) : bool

Returns whether translator should be used

Inherited from: \Zend_View_Helper_Navigation_HelperAbstract::getUseTranslator()

Implements {@link Zend_View_Helper_Navigation_Helper::getUseTranslator()}.

Returns
Type Description
bool whether translator should be used
methodpublichasAcl( ) : bool

Checks if the helper has an ACL instance

Inherited from: \Zend_View_Helper_Navigation_HelperAbstract::hasAcl()

Implements {@link Zend_View_Helper_Navigation_Helper::hasAcl()}.

Returns
Type Description
bool whether the helper has a an ACL instance or not
methodpublichasContainer( ) : bool

Checks if the helper has a container

Inherited from: \Zend_View_Helper_Navigation_HelperAbstract::hasContainer()

Implements {@link Zend_View_Helper_Navigation_Helper::hasContainer()}.

Returns
Type Description
bool whether the helper has a container or not
methodpublichasRole( ) : bool

Checks if the helper has an ACL role

Inherited from: \Zend_View_Helper_Navigation_HelperAbstract::hasRole()

Implements {@link Zend_View_Helper_Navigation_Helper::hasRole()}.

Returns
Type Description
bool whether the helper has a an ACL role or not
methodpublichasTranslator( ) : bool

Checks if the helper has a translator

Inherited from: \Zend_View_Helper_Navigation_HelperAbstract::hasTranslator()

Implements {@link Zend_View_Helper_Navigation_Helper::hasTranslator()}.

Returns
Type Description
bool whether the helper has a translator or not
methodpublichtmlify( \Zend_Navigation_Page $page ) : string

Returns an HTML string containing an 'a' element for the given page

Inherited from: \Zend_View_Helper_Navigation_HelperAbstract::htmlify()
Parameters
Name Type Description
$page \Zend_Navigation_Page page to generate HTML for
Returns
Type Description
string HTML string for the given page
methodpubliclinks( \Zend_Navigation_Container $container = null ) : \Zend_View_Helper_Navigation_Links

View helper entry point: Retrieves helper and optionally sets container to operate on

Parameters
Name Type Description
$container \Zend_Navigation_Container

[optional] container to operate on

Returns
Type Description
\Zend_View_Helper_Navigation_Links fluent interface, returns self
methodpublicrender( \Zend_Navigation_Container $container = null ) : string

Renders helper

Implements {@link Zend_View_Helper_Navigation_Helper::render()}.

Parameters
Name Type Description
$container \Zend_Navigation_Container

[optional] container to render. Default is to render the container registered in the helper.

Returns
Type Description
string helper output
Throws
Exception Description
\Zend_View_Exception if unable to render
methodpublicrenderLink( \Zend_Navigation_Page $page, string $attrib, string $relation ) : string

Renders the given $page as a link element, with $attrib = $relation

Parameters
Name Type Description
$page \Zend_Navigation_Page the page to render the link for
$attrib string

the attribute to use for $type, either 'rel' or 'rev'

$relation string relation type, muse be one of; alternate, appendix, bookmark, chapter, contents, copyright, glossary, help, home, index, next, prev, section, start, stylesheet, subsection
Returns
Type Description
string rendered link element
Throws
Exception Description
\Zend_View_Exception if $attrib is invalid
methodpublicsearchRelChapter( \Zend_Navigation_Page $page ) : \Zend_Navigation_Page|array|null

Searches the root container for forward 'chapter' relations of the given $page

From {@link http://www.w3.org/TR/html4/types.html#type-links}: Refers to a document serving as a chapter in a collection of documents.

Parameters
Name Type Description
$page \Zend_Navigation_Page page to find relation for
Returns
Type Description
\Zend_Navigation_Pagearraynull page(s) or null
methodpublicsearchRelNext( \Zend_Navigation_Page $page ) : \Zend_Navigation_Page|null

Searches the root container for the forward 'next' relation of the given $page

From {@link http://www.w3.org/TR/html4/types.html#type-links}: Refers to the next document in a linear sequence of documents. User agents may choose to preload the "next" document, to reduce the perceived load time.

Parameters
Name Type Description
$page \Zend_Navigation_Page page to find relation for
Returns
Type Description
\Zend_Navigation_Pagenull page(s) or null
methodpublicsearchRelPrev( \Zend_Navigation_Page $page ) : \Zend_Navigation_Page|null

Searches the root container for the forward 'prev' relation of the given $page

From {@link http://www.w3.org/TR/html4/types.html#type-links}: Refers to the previous document in an ordered series of documents. Some user agents also support the synonym "Previous".

Parameters
Name Type Description
$page \Zend_Navigation_Page page to find relation for
Returns
Type Description
\Zend_Navigation_Pagenull page or null
methodpublicsearchRelSection( \Zend_Navigation_Page $page ) : \Zend_Navigation_Page|array|null

Searches the root container for forward 'section' relations of the given $page

From {@link http://www.w3.org/TR/html4/types.html#type-links}: Refers to a document serving as a section in a collection of documents.

Parameters
Name Type Description
$page \Zend_Navigation_Page page to find relation for
Returns
Type Description
\Zend_Navigation_Pagearraynull page(s) or null
methodpublicsearchRelStart( \Zend_Navigation_Page $page ) : \Zend_Navigation_Page|null

Searches the root container for the forward 'start' relation of the given $page

From {@link http://www.w3.org/TR/html4/types.html#type-links}: Refers to the first document in a collection of documents. This link type tells search engines which document is considered by the author to be the starting point of the collection.

Parameters
Name Type Description
$page \Zend_Navigation_Page page to find relation for
Returns
Type Description
\Zend_Navigation_Pagenull page or null
methodpublicsearchRelSubsection( \Zend_Navigation_Page $page ) : \Zend_Navigation_Page|array|null

Searches the root container for forward 'subsection' relations of the given $page

From {@link http://www.w3.org/TR/html4/types.html#type-links}: Refers to a document serving as a subsection in a collection of documents.

Parameters
Name Type Description
$page \Zend_Navigation_Page page to find relation for
Returns
Type Description
\Zend_Navigation_Pagearraynull page(s) or null
methodpublicsearchRevSection( \Zend_Navigation_Page $page ) : \Zend_Navigation_Page|null

Searches the root container for the reverse 'section' relation of the given $page

From {@link http://www.w3.org/TR/html4/types.html#type-links}: Refers to a document serving as a section in a collection of documents.

Parameters
Name Type Description
$page \Zend_Navigation_Page page to find relation for
Returns
Type Description
\Zend_Navigation_Pagenull page(s) or null
methodpublicsearchRevSubsection( \Zend_Navigation_Page $page ) : \Zend_Navigation_Page|null

Searches the root container for the reverse 'section' relation of the given $page

From {@link http://www.w3.org/TR/html4/types.html#type-links}: Refers to a document serving as a subsection in a collection of documents.

Parameters
Name Type Description
$page \Zend_Navigation_Page page to find relation for
Returns
Type Description
\Zend_Navigation_Pagenull page(s) or null
methodpublicsetAcl( \Zend_Acl $acl = null ) : \Zend_View_Helper_Navigation_HelperAbstract

Sets ACL to use when iterating pages

Inherited from: \Zend_View_Helper_Navigation_HelperAbstract::setAcl()

Implements {@link Zend_View_Helper_Navigation_Helper::setAcl()}.

Parameters
Name Type Description
$acl \Zend_Acl

[optional] ACL object. Default is null.

Returns
Type Description
\Zend_View_Helper_Navigation_HelperAbstract fluent interface, returns self
methodpublicsetContainer( \Zend_Navigation_Container $container = null ) : \Zend_View_Helper_Navigation_HelperAbstract

Sets navigation container the helper operates on by default

Inherited from: \Zend_View_Helper_Navigation_HelperAbstract::setContainer()

Implements {@link Zend_View_Helper_Navigation_Interface::setContainer()}.

Parameters
Name Type Description
$container \Zend_Navigation_Container

[optional] container to operate on. Default is null, meaning container will be reset.

Returns
Type Description
\Zend_View_Helper_Navigation_HelperAbstract fluent interface, returns self
methodpublicsetDefaultAcl( \Zend_Acl $acl = null ) : void
static

Sets default ACL to use if another ACL is not explicitly set

Inherited from: \Zend_View_Helper_Navigation_HelperAbstract::setDefaultAcl()
Parameters
Name Type Description
$acl \Zend_Acl

[optional] ACL object. Default is null, which sets no ACL object.

methodpublicsetDefaultRole( \midex $role = null ) : void
static

Sets default ACL role(s) to use when iterating pages if not explicitly set later with {@link setRole()}

Inherited from: \Zend_View_Helper_Navigation_HelperAbstract::setDefaultRole()
Parameters
Name Type Description
$role \midex

[optional] role to set. Expects null, string, or an instance of {@link Zend_Acl_Role_Interface}. Default is null, which sets no default role.

Throws
Exception Description
\Zend_View_Exception if role is invalid
methodpublicsetIndent( string|int $indent ) : \Zend_View_Helper_Navigation_HelperAbstract

Set the indentation string for using in {@link render()}, optionally a number of spaces to indent with

Inherited from: \Zend_View_Helper_Navigation_HelperAbstract::setIndent()
Parameters
Name Type Description
$indent string|int indentation string or number of spaces
Returns
Type Description
\Zend_View_Helper_Navigation_HelperAbstract fluent interface, returns self
methodpublicsetMaxDepth( int $maxDepth = null ) : \Zend_View_Helper_Navigation_HelperAbstract

Sets the maximum depth a page can have to be included when rendering

Inherited from: \Zend_View_Helper_Navigation_HelperAbstract::setMaxDepth()
Parameters
Name Type Description
$maxDepth int

[optional] maximum depth. Default is null, which sets no maximum depth.

Returns
Type Description
\Zend_View_Helper_Navigation_HelperAbstract fluent interface, returns self
methodpublicsetMinDepth( int $minDepth = null ) : \Zend_View_Helper_Navigation_HelperAbstract

Sets the minimum depth a page must have to be included when rendering

Inherited from: \Zend_View_Helper_Navigation_HelperAbstract::setMinDepth()
Parameters
Name Type Description
$minDepth int

[optional] minimum depth. Default is null, which sets no minimum depth.

Returns
Type Description
\Zend_View_Helper_Navigation_HelperAbstract fluent interface, returns self
methodpublicsetRenderFlag( int $renderFlag ) : \Zend_View_Helper_Navigation_Links

Sets the helper's render flag

The helper uses the bitwise '&' operator against the hex values of the render constants. This means that the flag can is "bitwised" value of the render constants. Examples:

// render all links except glossary
$flag = Zend_View_Helper_Navigation_Links:RENDER_ALL ^
        Zend_View_Helper_Navigation_Links:RENDER_GLOSSARY;
$helper->setRenderFlag($flag);

// render only chapters and sections
$flag = Zend_View_Helper_Navigation_Links:RENDER_CHAPTER |
        Zend_View_Helper_Navigation_Links:RENDER_SECTION;
$helper->setRenderFlag($flag);

// render only relations that are not native W3C relations
$helper->setRenderFlag(Zend_View_Helper_Navigation_Links:RENDER_CUSTOM);

// render all relations (default)
$helper->setRenderFlag(Zend_View_Helper_Navigation_Links:RENDER_ALL);

Note that custom relations can also be rendered directly using the {@link renderLink()} method.

Parameters
Name Type Description
$renderFlag int render flag
Returns
Type Description
\Zend_View_Helper_Navigation_Links fluent interface, returns self
methodpublicsetRenderInvisible( bool $renderInvisible = true ) : \Zend_View_Helper_Navigation_HelperAbstract
Parameters
Name Type Description
$renderInvisible bool

[optional] boolean flag

Returns
Type Description
\Zend_View_Helper_Navigation_HelperAbstract fluent interface returns self
methodpublicsetRole( mixed $role = null ) : \Zend_View_Helper_Navigation_HelperAbstract

Sets ACL role(s) to use when iterating pages

Inherited from: \Zend_View_Helper_Navigation_HelperAbstract::setRole()

Implements {@link Zend_View_Helper_Navigation_Helper::setRole()}.

Parameters
Name Type Description
$role mixed

[optional] role to set. Expects a string, an instance of type {@link Zend_Acl_Role_Interface}, or null. Default is null, which will set no role.

Returns
Type Description
\Zend_View_Helper_Navigation_HelperAbstract fluent interface, returns self
Throws
Exception Description
\Zend_View_Exception if $role is invalid
methodpublicsetTranslator( mixed $translator = null ) : \Zend_View_Helper_Navigation_HelperAbstract

Sets translator to use in helper

Inherited from: \Zend_View_Helper_Navigation_HelperAbstract::setTranslator()

Implements {@link Zend_View_Helper_Navigation_Helper::setTranslator()}.

Parameters
Name Type Description
$translator mixed

[optional] translator. Expects an object of type {@link Zend_Translate_Adapter} or {@link Zend_Translate}, or null. Default is null, which sets no translator.

Returns
Type Description
\Zend_View_Helper_Navigation_HelperAbstract fluent interface, returns self
methodpublicsetUseAcl( bool $useAcl = true ) : \Zend_View_Helper_Navigation_HelperAbstract

Sets whether ACL should be used

Inherited from: \Zend_View_Helper_Navigation_HelperAbstract::setUseAcl()

Implements {@link Zend_View_Helper_Navigation_Helper::setUseAcl()}.

Parameters
Name Type Description
$useAcl bool

[optional] whether ACL should be used. Default is true.

Returns
Type Description
\Zend_View_Helper_Navigation_HelperAbstract fluent interface, returns self
methodpublicsetUseTranslator( bool $useTranslator = true ) : \Zend_View_Helper_Navigation_HelperAbstract

Sets whether translator should be used

Inherited from: \Zend_View_Helper_Navigation_HelperAbstract::setUseTranslator()

Implements {@link Zend_View_Helper_Navigation_Helper::setUseTranslator()}.

Parameters
Name Type Description
$useTranslator bool

[optional] whether translator should be used. Default is true.

Returns
Type Description
\Zend_View_Helper_Navigation_HelperAbstract fluent interface, returns self
methodpublicsetView( \Zend_View_Interface $view ) : \Zend_View_Helper_Abstract

Set the View object

Inherited from: \Zend_View_Helper_Abstract::setView()
Parameters
Name Type Description
$view \Zend_View_Interface
Returns
Type Description
\Zend_View_Helper_Abstract
Documentation was generated by DocBlox 0.13.3.