Public Member Functions
	__construct ($name, $text, $href)
	constructor More...

	setData ($key, $value=null)
	Set a data key/value pair or a set of key/value pairs. More...

	getData ($key)
	Get stored data. More...

	setName ($name)
	Set the identifier of the menu item. More...

	getName ()
	Get the identifier of the menu item. More...

	setText ($text)
	Set the display text of the menu item. More...

	getText ()
	Get the display text of the menu item. More...

	setHref ($href)
	Set the URL of the menu item. More...

	getHref ()
	Get the URL of the menu item. More...

	setContext ($contexts)
	Set the contexts that this menu item is available for. More...

	getContext ()
	Get an array of context strings. More...

	inContext ($context= '')
	Should this menu item be used given the current context. More...

	setSelected ($state=true)
	Set the selected flag. More...

	getSelected ()
	Get selected state. More...

	setTooltip ($text)
	Set the tool tip text. More...

	getTooltip ()
	Get the tool tip text. More...

	setConfirmText ($text)
	Set the confirm text shown when link is clicked. More...

	getConfirmText ()
	Get the confirm text. More...

	setLinkClass ($class)
	Set the anchor class. More...

	getLinkClass ()
	Get the anchor classes as text. More...

	addLinkClass ($class)
	Add a link class. More...

	setDeps ($modules)
	Set required AMD modules. More...

	getDeps ()
	Get required AMD modules. More...

	addDeps ($modules)
	Add required AMD modules. More...

	setItemClass ($class)
	Set the li classes. More...

	getItemClass ()
	Get the li classes as text. More...

	addItemClass ($class)
	Add a li class. More...

	setWeight ($priority)
	Set the priority of the menu item. More...

	getWeight ()
	Get the priority of the menu item. More...

	setPriority ($priority)
	Set the priority of the menu item. More...

	getPriority ()
	Get the priority of the menu item. More...

	setSection ($section)
	Set the section identifier. More...

	getSection ()
	Get the section identifier. More...

	setParentName ($name)
	Set the parent identifier. More...

	getParentName ()
	Get the parent identifier. More...

	setParent ($parent)
	Set the parent menu item. More...

	getParent ()
	Get the parent menu item. More...

	addChild ($item)
	Add a child menu item. More...

	setChildren ($children)
	Set the menu item's children. More...

	getChildren ()
	Get the children menu items. More...

	sortChildren ($sortFunction)
	Sort the children. More...

	getValues ()
	Get all the values for this menu item. More...

	getContent (array $vars=array())
	Get the menu item content (usually a link) More...

Static Public Member Functions
static	factory ($options)
	Create an ElggMenuItem from an associative array. More...

Protected Member Functions
	addClass (array &$current, $additional)
	Add additional classes. More...

Protected Attributes
	$data

	$text

	$href = null

	$title = false

	$confirm = ''

Detailed Description

Definition at line 15 of file ElggMenuItem.php.

Constructor & Destructor Documentation

ElggMenuItem::__construct	(	$name,
		$text,
		$href
	)

constructor

Parameters

string	$name	Identifier of the menu item
string	$text	Display text of the menu item (HTML)
string	$href	URL of the menu item (false if not a link)

Definition at line 83 of file ElggMenuItem.php.

Member Function Documentation

ElggMenuItem::addChild ( $item )

Add a child menu item.

This is reserved for the .

Parameters

\ElggMenuItem $item A child menu item

Returns: void private

Definition at line 617 of file ElggMenuItem.php.

ElggMenuItem::addClass	(	array &	$current,
			$additional
	)

protected

Add additional classes.

Parameters

array	$current	The current array of classes
mixed	$additional	Additional classes (either array of string)

Returns: void

Definition at line 493 of file ElggMenuItem.php.

ElggMenuItem::addDeps ( $modules )

Add required AMD modules.

Parameters

string[]|string $modules One or more required AMD modules

Returns: void

Definition at line 435 of file ElggMenuItem.php.

ElggMenuItem::addItemClass ( $class )

Add a li class.

Parameters

mixed $class An array of class names, or a single string class name.

Returns: void

Since: 1.9.0

Definition at line 481 of file ElggMenuItem.php.

ElggMenuItem::addLinkClass ( $class )

Add a link class.

Parameters

mixed $class An array of class names, or a single string class name.

Returns: void

Definition at line 403 of file ElggMenuItem.php.

static ElggMenuItem::factory ( $options )

static

Create an ElggMenuItem from an associative array.

Required keys are name, text, and href.

Parameters

array $options Option array of key value pairs

name => STR Menu item identifier (required) text => STR Menu item display text as HTML (required) href => STR Menu item URL (required) false = do not create a link. null = current URL. "" = current URL. "/" = site home page.

Warning: If href is false, the tag will not appear, so the link_class will not apply. If you put tags in manually through the 'text' option the default CSS selector .elgg-menu-$menu > li > a may affect formatting. Wrap in a if it does.)

section => STR Menu section identifier link_class => STR A class or classes for the tag item_class => STR A class or classes for the tag parent_name => STR Identifier of the parent menu item contexts => ARR Page context strings title => STR Menu item tooltip selected => BOOL Is this menu item currently selected? confirm => STR If set, the link will be drawn with the output/confirmlink view instead of output/url. deps => ARR AMD modules required by this menu item data => ARR Custom attributes stored in the menu item.

Returns: ElggMenuItem or null on error

Definition at line 125 of file ElggMenuItem.php.

ElggMenuItem::getChildren ( )

Get the children menu items.

This is reserved for the .

Returns: ElggMenuItem[] private

Definition at line 642 of file ElggMenuItem.php.

ElggMenuItem::getConfirmText ( )

Get the confirm text.

Returns: string

Examples:: /root/Elgg/engine/lib/views.php.

Definition at line 370 of file ElggMenuItem.php.

ElggMenuItem::getContent ( array $vars = array() )

Get the menu item content (usually a link)

Parameters

array $vars Options to pass to output/url if a link

Returns: string

Definition at line 682 of file ElggMenuItem.php.

ElggMenuItem::getContext ( )

Get an array of context strings.

Returns: array

Definition at line 289 of file ElggMenuItem.php.

ElggMenuItem::getData ( $key )

Get stored data.

Parameters

string $key The key for the requested key/value pair

Returns: mixed

Definition at line 205 of file ElggMenuItem.php.

ElggMenuItem::getDeps ( )

Get required AMD modules.

Returns: string[]

Definition at line 422 of file ElggMenuItem.php.

ElggMenuItem::getHref ( )

Get the URL of the menu item.

Returns: string

Examples:: /root/Elgg/engine/lib/views.php.

Definition at line 267 of file ElggMenuItem.php.

ElggMenuItem::getItemClass ( )

Get the li classes as text.

Returns: string

Definition at line 459 of file ElggMenuItem.php.

ElggMenuItem::getLinkClass ( )

Get the anchor classes as text.

Returns: string

Examples:: /root/Elgg/engine/lib/views.php.

Definition at line 393 of file ElggMenuItem.php.

ElggMenuItem::getName ( )

Get the identifier of the menu item.

Returns: string

Definition at line 228 of file ElggMenuItem.php.

ElggMenuItem::getParent ( )

Get the parent menu item.

This is reserved for the .

Returns: or null private

Definition at line 604 of file ElggMenuItem.php.

ElggMenuItem::getParentName ( )

Get the parent identifier.

Returns: string

Definition at line 579 of file ElggMenuItem.php.

ElggMenuItem::getPriority ( )

Get the priority of the menu item.

Returns: int

Definition at line 541 of file ElggMenuItem.php.

ElggMenuItem::getSection ( )

Get the section identifier.

Returns: string

Definition at line 560 of file ElggMenuItem.php.

ElggMenuItem::getSelected ( )

Get selected state.

Returns: bool

Definition at line 332 of file ElggMenuItem.php.

ElggMenuItem::getText ( )

Get the display text of the menu item.

Returns: string The display text as HTML

Examples:: /root/Elgg/engine/lib/views.php.

Definition at line 247 of file ElggMenuItem.php.

ElggMenuItem::getTooltip ( )

Get the tool tip text.

Returns: string

Definition at line 351 of file ElggMenuItem.php.

ElggMenuItem::getValues ( )

Get all the values for this menu item.

Useful for rendering.

Returns: array

Since: 1.9.0

Examples:: /root/Elgg/engine/lib/views.php.

Definition at line 668 of file ElggMenuItem.php.

ElggMenuItem::getWeight ( )

Get the priority of the menu item.

Returns: int

Definition at line 521 of file ElggMenuItem.php.

ElggMenuItem::inContext ( $context = '' )

Should this menu item be used given the current context.

Parameters

string $context A context string (default is empty string for current context stack).

Returns: bool

Definition at line 300 of file ElggMenuItem.php.

ElggMenuItem::setChildren ( $children )

Set the menu item's children.

This is reserved for the .

Parameters

ElggMenuItem[] $children Array of items

Returns: void private

Definition at line 630 of file ElggMenuItem.php.

ElggMenuItem::setConfirmText ( $text )

Set the confirm text shown when link is clicked.

Parameters

string $text The text to show

Returns: void

Definition at line 361 of file ElggMenuItem.php.

ElggMenuItem::setContext ( $contexts )

Set the contexts that this menu item is available for.

Parameters

array $contexts An array of context strings. Use 'all' to match all contexts.

Returns: void

Definition at line 277 of file ElggMenuItem.php.

ElggMenuItem::setData	(	$key,
		$value = `null`
	)

Set a data key/value pair or a set of key/value pairs.

This method allows storage of arbitrary data with this menu item. The data can be used for sorting, custom rendering, or any other use.

Parameters

mixed	$key	String key or an associative array of key/value pairs
mixed	$value	The value if $key is a string

Returns: void

Definition at line 191 of file ElggMenuItem.php.

ElggMenuItem::setDeps ( $modules )

Set required AMD modules.

Parameters

string[]|string $modules One or more required AMD modules

Returns: void

Definition at line 413 of file ElggMenuItem.php.

ElggMenuItem::setHref ( $href )

Set the URL of the menu item.

Parameters

string $href URL or false if not a link

Returns: void

Definition at line 258 of file ElggMenuItem.php.

ElggMenuItem::setItemClass ( $class )

Set the li classes.

Parameters

mixed $class An array of class names, or a single string class name.

Returns: void

Definition at line 446 of file ElggMenuItem.php.

ElggMenuItem::setLinkClass ( $class )

Set the anchor class.

Parameters

mixed $class An array of class names, or a single string class name.

Returns: void

Definition at line 380 of file ElggMenuItem.php.

ElggMenuItem::setName ( $name )

Set the identifier of the menu item.

Parameters

string $name Unique identifier

Returns: void

Definition at line 219 of file ElggMenuItem.php.

ElggMenuItem::setParent ( $parent )

Set the parent menu item.

This is reserved for the .

Parameters

\ElggMenuItem $parent The parent of this menu item

Returns: void private

Definition at line 592 of file ElggMenuItem.php.

ElggMenuItem::setParentName ( $name )

Set the parent identifier.

Parameters

string $name The identifier of the parent

Returns: void

Definition at line 570 of file ElggMenuItem.php.

ElggMenuItem::setPriority ( $priority )

Set the priority of the menu item.

Parameters

int $priority The smaller numbers mean higher priority (1 before 100)

Returns: void

Definition at line 532 of file ElggMenuItem.php.

ElggMenuItem::setSection ( $section )

Set the section identifier.

Parameters

string $section The identifier of the section

Returns: void

Definition at line 551 of file ElggMenuItem.php.

ElggMenuItem::setSelected ( $state = true )

Set the selected flag.

Parameters

bool $state Selected state (default is true)

Returns: void

Definition at line 323 of file ElggMenuItem.php.

ElggMenuItem::setText ( $text )

Set the display text of the menu item.

Parameters

string $text The display text as HTML

Returns: void

Definition at line 238 of file ElggMenuItem.php.

ElggMenuItem::setTooltip ( $text )

Set the tool tip text.

Parameters

string $text The text of the tool tip

Returns: void

Definition at line 342 of file ElggMenuItem.php.

ElggMenuItem::setWeight ( $priority )

Set the priority of the menu item.

Parameters

int $priority The smaller numbers mean higher priority (1 before 100)

Returns: void

Definition at line 510 of file ElggMenuItem.php.

ElggMenuItem::sortChildren ( $sortFunction )

Sort the children.

This is reserved for the .

Parameters

string $sortFunction A function that is passed to usort()

Returns: void private

Definition at line 655 of file ElggMenuItem.php.

Member Data Documentation

ElggMenuItem::$confirm = ''

protected

Definition at line 73 of file ElggMenuItem.php.

ElggMenuItem::$data

protected

Definition at line 20 of file ElggMenuItem.php.

ElggMenuItem::$href = null

protected

Definition at line 63 of file ElggMenuItem.php.

ElggMenuItem::$text

protected

Definition at line 58 of file ElggMenuItem.php.

ElggMenuItem::$title = false

protected

Definition at line 68 of file ElggMenuItem.php.

The documentation for this class was generated from the following file:

engine/classes/ElggMenuItem.php

Public Member Functions

Static Public Member Functions

Protected Member Functions

Protected Attributes

Detailed Description

Constructor & Destructor Documentation

Member Function Documentation

Member Data Documentation