View/Helper/Navigation/Breadcrumbs.php

Show: inherited
Table of Contents

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 [email protected] so we can send you a copy immediately.

Category
Zend  
Copyright
Copyright (c) 2005-2012 Zend Technologies USA Inc. (http://www.zend.com)  
License
New BSD License  
Package
Zend_View  
Subpackage
Helper  
Version
$Id: Breadcrumbs.php 24593 2012-01-05 20:35:02Z matthew $  

\Zend_View_Helper_Navigation_Breadcrumbs

Package: Zend\View\Helper

Helper for printing breadcrumbs

Parent(s)
\Zend_View_Helper_Navigation_HelperAbstract < \Zend_View_Helper_HtmlElement < \Zend_View_Helper_Abstract
Category
Zend  
Copyright
Copyright (c) 2005-2012 Zend Technologies USA Inc. (http://www.zend.com)  
License
New BSD License  

Constants

Properties

Propertyprotected\Zend_Acl $_acl =
inherited

ACL to use when iterating pages

Inherited from: \Zend_View_Helper_Navigation_HelperAbstract::$$_acl
Propertyprotectedstring $_closingBracket = null
Default valuenullDetails
Type
string
Inherited_from
\Zend_View_Helper_HtmlElement::$$_closingBracket  
Inherited_from
\Zend_View_Helper_Navigation_HelperAbstract::$$_closingBracket  
Propertyprotected\Zend_Navigation_Container $_container =
inherited

Container to operate on by default

Inherited from: \Zend_View_Helper_Navigation_HelperAbstract::$$_container
Propertyprotected\Zend_Acl $_defaultAcl =
staticinherited

Default ACL to use when iterating pages if not explicitly set in the instance by calling {@link setAcl()}

Inherited from: \Zend_View_Helper_Navigation_HelperAbstract::$$_defaultAcl
Propertyprotectedstring|\Zend_Acl_Role_Interface $_defaultRole =
staticinherited

Default ACL role to use when iterating pages if not explicitly set in the instance by calling {@link setRole()}

Inherited from: \Zend_View_Helper_Navigation_HelperAbstract::$$_defaultRole
Propertyprotectedbool $_formatOutput = true
inherited

Whether HTML/XML output should be formatted

Inherited from: \Zend_View_Helper_Navigation_HelperAbstract::$$_formatOutput
Default valuetrueDetails
Type
bool
Inherited_from
\Zend_View_Helper_Navigation_HelperAbstract::$$_formatOutput  
Propertyprotectedstring $_indent = ''
inherited

Indentation string

Inherited from: \Zend_View_Helper_Navigation_HelperAbstract::$$_indent
Default value''Details
Type
string
Inherited_from
\Zend_View_Helper_Navigation_HelperAbstract::$$_indent  
Propertyprotectedbool $_linkLast = false

Whether last page in breadcrumb should be hyperlinked

Default valuefalseDetails
Type
bool
Propertyprotectedint $_maxDepth =
inherited

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

Inherited from: \Zend_View_Helper_Navigation_HelperAbstract::$$_maxDepth
Propertyprotectedint $_minDepth = 1

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

Default value1Details
Type
int
Propertyprotectedstring|array $_partial =

Partial view script to use for rendering menu

Details
Type
string | array
Propertyprotectedstring|null $_prefixForId = null
inherited

Prefix for IDs when they are normalized

Inherited from: \Zend_View_Helper_Navigation_HelperAbstract::$$_prefixForId
Default valuenullDetails
Type
string | null
Inherited_from
\Zend_View_Helper_Navigation_HelperAbstract::$$_prefixForId  
Propertyprotectedbool $_renderInvisible = false
inherited

Wheter invisible items should be rendered by this helper

Inherited from: \Zend_View_Helper_Navigation_HelperAbstract::$$_renderInvisible
Default valuefalseDetails
Type
bool
Inherited_from
\Zend_View_Helper_Navigation_HelperAbstract::$$_renderInvisible  
Propertyprotectedstring|\Zend_Acl_Role_Interface $_role =
inherited

ACL role to use when iterating pages

Inherited from: \Zend_View_Helper_Navigation_HelperAbstract::$$_role
Propertyprotectedstring $_separator = ' &gt; '

Breadcrumbs separator string

Default value' &gt; 'Details
Type
string
Propertyprotectedbool $_skipPrefixForId = false
inherited

Skip current prefix for IDs when they are normalized (flag)

Inherited from: \Zend_View_Helper_Navigation_HelperAbstract::$$_skipPrefixForId
Default valuefalseDetails
Type
bool
Inherited_from
\Zend_View_Helper_Navigation_HelperAbstract::$$_skipPrefixForId  
Propertyprotected\Zend_Translate_Adapter $_translator =
Propertyprotectedbool $_useAcl = true
inherited

Whether ACL should be used for filtering out pages

Inherited from: \Zend_View_Helper_Navigation_HelperAbstract::$$_useAcl
Default valuetrueDetails
Type
bool
Inherited_from
\Zend_View_Helper_Navigation_HelperAbstract::$$_useAcl  
Propertyprotectedbool $_useTranslator = true
inherited

Whether translator should be used for page labels and titles

Inherited from: \Zend_View_Helper_Navigation_HelperAbstract::$$_useTranslator
Default valuetrueDetails
Type
bool
Inherited_from
\Zend_View_Helper_Navigation_HelperAbstract::$$_useTranslator  

Methods

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

Magic overload: Proxy calls to the navigation container

Inherited from: \Zend_View_Helper_Navigation_HelperAbstract::__call()
Parameters
Name Type Description
$method string

method name in container

$arguments array

[optional] arguments to pass

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
inherited

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 Zend_View_Helper_Navigation_Helper::__toString().

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

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_getWhitespace(int | string $indent) : string
inherited

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
inherited

Converts an associative array to a string of tag attributes.

Inherited from: \Zend_View_Helper_Navigation_HelperAbstract::_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
Returns
Type Description
boolean
methodprotected_isXhtml() : boolean
Returns
Type Description
boolean
methodprotected_normalizeId(string $value) : string
inherited

Normalize an ID

Inherited from: \Zend_View_Helper_Navigation_HelperAbstract::_normalizeId()
Parameters
Name Type Description
$value string

ID

Returns
Type Description
string Normalized ID
methodpublicaccept(\Zend_Navigation_Page $page, bool $recursive = true) : bool
inherited

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
methodpublicbreadcrumbs(\Zend_Navigation_Container $container = null) : \Zend_View_Helper_Navigation_Breadcrumbs

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_Breadcrumbs fluent interface, returns self
methodpublicfindActive(\Zend_Navigation_Container $container, int | null | int | null $minDepth = null,  $maxDepth = -1) : array
inherited

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
methodpublicgetAcl() : \Zend_Acl | null
inherited

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

Inherited from: \Zend_View_Helper_Navigation_HelperAbstract::getAcl()
Returns
Type Description
\Zend_Acl | null ACL object or null
methodpublicgetClosingBracket() : string
Returns
Type Description
string
methodpublicgetContainer() : \Zend_Navigation_Container
inherited

Returns the navigation container helper operates on by default

Inherited from: \Zend_View_Helper_Navigation_HelperAbstract::getContainer()

Implements Zend_View_Helper_Navigation_Interface::getContainer().

If a helper is not explicitly set in this helper instance by calling setContainer() or by passing it through the helper entry point, this method will look in 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
methodpublicgetEOL() : string
inherited

Returns the EOL character (format output is respected)

Inherited from: \Zend_View_Helper_Navigation_HelperAbstract::getEOL()
Returns
Type Description
string standard EOL charater or an empty string
Details
See
\global\self::EOL  
See
\global\getFormatOutput()  
methodpublicgetFormatOutput() : bool
inherited

Returns whether HTML/XML output should be formatted

Inherited from: \Zend_View_Helper_Navigation_HelperAbstract::getFormatOutput()
Returns
Type Description
bool whether HTML/XML output should be formatted
methodpublicgetIndent() : string
inherited

Returns indentation (format output is respected)

Inherited from: \Zend_View_Helper_Navigation_HelperAbstract::getIndent()
Returns
Type Description
string indentation string or an empty string
methodpublicgetLinkLast() : bool

Returns whether last page in breadcrumbs should be hyperlinked

Returns
Type Description
bool whether last page in breadcrumbs should be hyperlinked
methodpublicgetMaxDepth() : int | null
inherited

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

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

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

Inherited from: \Zend_View_Helper_Navigation_HelperAbstract::getMinDepth()
Returns
Type Description
int | null minimum depth or null
methodpublicgetPartial() : string | array | null

Returns partial view script to use for rendering menu

Returns
Type Description
string | array | null
methodpublicgetPrefixForId() : string
inherited

Returns prefix for IDs when they are normalized

Inherited from: \Zend_View_Helper_Navigation_HelperAbstract::getPrefixForId()
Returns
Type Description
string Prefix for
methodpublicgetRenderInvisible() : bool
inherited

Return renderInvisible flag

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

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()
Returns
Type Description
string | \Zend_Acl_Role_Interface | null role or null
methodpublicgetSeparator() : string

Returns breadcrumb separator

Returns
Type Description
string breadcrumb separator
methodpublicgetTranslator() : \Zend_Translate_Adapter | null
inherited

Returns translator used in helper

Inherited from: \Zend_View_Helper_Navigation_HelperAbstract::getTranslator()
Returns
Type Description
\Zend_Translate_Adapter | null translator or null
methodpublicgetUseAcl() : bool
inherited

Returns whether ACL should be used

Inherited from: \Zend_View_Helper_Navigation_HelperAbstract::getUseAcl()
Returns
Type Description
bool whether ACL should be used
methodpublicgetUseTranslator() : bool
inherited

Returns whether translator should be used

Inherited from: \Zend_View_Helper_Navigation_HelperAbstract::getUseTranslator()
Returns
Type Description
bool whether translator should be used
methodpublichasAcl() : bool
inherited

Checks if the helper has an ACL instance

Inherited from: \Zend_View_Helper_Navigation_HelperAbstract::hasAcl()
Returns
Type Description
bool whether the helper has a an ACL instance or not
methodpublichasContainer() : bool
inherited

Checks if the helper has a container

Inherited from: \Zend_View_Helper_Navigation_HelperAbstract::hasContainer()
Returns
Type Description
bool whether the helper has a container or not
methodpublichasRole() : bool
inherited

Checks if the helper has an ACL role

Inherited from: \Zend_View_Helper_Navigation_HelperAbstract::hasRole()
Returns
Type Description
bool whether the helper has a an ACL role or not
methodpublichasTranslator() : bool
inherited

Checks if the helper has a translator

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

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
methodpublicrender(\Zend_Navigation_Container $container = null) : string

Renders helper

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
methodpublicrenderPartial(\Zend_Navigation_Container $container = null, string | array $partial = null) : string

Renders the given $container by invoking the partial view helper

The container will simply be passed on as a model to the view script, so in the script it will be available in

$this->container

.

Parameters
Name Type Description
$container \Zend_Navigation_Container

[optional] container to pass to view script. Default is to use the container registered in the helper.

$partial string | array

[optional] partial view script to use. Default is to use the partial registered in the helper. If an array is given, it is expected to contain two values; the partial view script to use, and the module where the script can be found.

Returns
Type Description
string helper output
methodpublicrenderStraight(\Zend_Navigation_Container $container = null) : string

Renders breadcrumbs by chaining 'a' elements with the separator registered in the helper

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
methodpublicsetAcl(\Zend_Acl $acl = null) : \Zend_View_Helper_Navigation_HelperAbstract
inherited

Sets ACL to use when iterating pages

Inherited from: \Zend_View_Helper_Navigation_HelperAbstract::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
inherited

Sets navigation container the helper operates on by default

Inherited from: \Zend_View_Helper_Navigation_HelperAbstract::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
staticinherited

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
staticinherited

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
methodpublicsetFormatOutput(bool $formatOutput = true) : \Zend_View_Helper_Navigation_Sitemap
inherited

Sets whether HTML/XML output should be formatted

Inherited from: \Zend_View_Helper_Navigation_HelperAbstract::setFormatOutput()
Parameters
Name Type Description
$formatOutput bool

[optional] whether output should be formatted. Default is true.

Returns
Type Description
\Zend_View_Helper_Navigation_Sitemap fluent interface, returns self
methodpublicsetIndent(string | int $indent) : \Zend_View_Helper_Navigation_HelperAbstract
inherited

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
methodpublicsetLinkLast(bool $linkLast) : \Zend_View_Helper_Navigation_Breadcrumbs

Sets whether last page in breadcrumbs should be hyperlinked

Parameters
Name Type Description
$linkLast bool

whether last page should be hyperlinked

Returns
Type Description
\Zend_View_Helper_Navigation_Breadcrumbs fluent interface, returns self
methodpublicsetMaxDepth(int $maxDepth = null) : \Zend_View_Helper_Navigation_HelperAbstract
inherited

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
inherited

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
methodpublicsetPartial(string | array $partial) : \Zend_View_Helper_Navigation_Breadcrumbs

Sets which partial view script to use for rendering menu

Parameters
Name Type Description
$partial string | array

partial view script or null. If an array is given, it is expected to contain two values; the partial view script to use, and the module where the script can be found.

Returns
Type Description
\Zend_View_Helper_Navigation_Breadcrumbs fluent interface, returns self
methodpublicsetPrefixForId(string $prefix) : \Zend_View_Helper_Navigation_HelperAbstract
inherited

Sets prefix for IDs when they are normalized

Inherited from: \Zend_View_Helper_Navigation_HelperAbstract::setPrefixForId()
Parameters
Name Type Description
$prefix string

Prefix for IDs

Returns
Type Description
\Zend_View_Helper_Navigation_HelperAbstract fluent interface, returns self
methodpublicsetRenderInvisible(bool $renderInvisible = true) : \Zend_View_Helper_Navigation_HelperAbstract
inherited

Render invisible items?

Inherited from: \Zend_View_Helper_Navigation_HelperAbstract::setRenderInvisible()
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
inherited

Sets ACL role(s) to use when iterating pages

Inherited from: \Zend_View_Helper_Navigation_HelperAbstract::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
methodpublicsetSeparator(string $separator) : \Zend_View_Helper_Navigation_Breadcrumbs

Sets breadcrumb separator

Parameters
Name Type Description
$separator string

separator string

Returns
Type Description
\Zend_View_Helper_Navigation_Breadcrumbs fluent interface, returns self
methodpublicsetTranslator(mixed $translator = null) : \Zend_View_Helper_Navigation_HelperAbstract
inherited

Sets translator to use in helper

Inherited from: \Zend_View_Helper_Navigation_HelperAbstract::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
inherited

Sets whether ACL should be used

Inherited from: \Zend_View_Helper_Navigation_HelperAbstract::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
inherited

Sets whether translator should be used

Inherited from: \Zend_View_Helper_Navigation_HelperAbstract::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
methodpublicskipPrefixForId(bool $flag = true) : \Zend_View_Helper_Navigation_HelperAbstract
inherited

Skip the current prefix for IDs when they are normalized

Inherited from: \Zend_View_Helper_Navigation_HelperAbstract::skipPrefixForId()
Parameters
Name Type Description
$flag bool
Returns
Type Description
\Zend_View_Helper_Navigation_HelperAbstract fluent interface, returns self
Documentation was generated by phpDocumentor 2.0.0a8.