Elgg  Version 2.2
 All Classes Namespaces Files Functions Variables Pages
Public Member Functions | Static Public Member Functions | Protected Member Functions | Protected Attributes | List of all members
ElggMenuItem Class Reference

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$nameIdentifier of the menu item
string$textDisplay text of the menu item (HTML)
string$hrefURL 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$itemA child menu item
Returns
void private

Definition at line 612 of file ElggMenuItem.php.

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

Add additional classes.

Parameters
array$currentThe current array of classes
mixed$additionalAdditional classes (either array of string)
Returns
void

Definition at line 488 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 430 of file ElggMenuItem.php.

ElggMenuItem::addItemClass (   $class)

Add a li class.

Parameters
mixed$classAn array of class names, or a single string class name.
Returns
void
Since
1.9.0

Definition at line 476 of file ElggMenuItem.php.

ElggMenuItem::addLinkClass (   $class)

Add a link class.

Parameters
mixed$classAn array of class names, or a single string class name.
Returns
void

Definition at line 398 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$optionsOption 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 for non-links.

Warning
If you disable the href 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 121 of file ElggMenuItem.php.

ElggMenuItem::getChildren ( )

Get the children menu items.

This is reserved for the .

Returns
ElggMenuItem[] private

Definition at line 637 of file ElggMenuItem.php.

ElggMenuItem::getConfirmText ( )

Get the confirm text.

Returns
string

Definition at line 365 of file ElggMenuItem.php.

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

Get the menu item content (usually a link)

Parameters
array$varsOptions to pass to output/url if a link
Returns
string

Definition at line 677 of file ElggMenuItem.php.

ElggMenuItem::getContext ( )

Get an array of context strings.

Returns
array

Definition at line 284 of file ElggMenuItem.php.

ElggMenuItem::getData (   $key)

Get stored data.

Parameters
string$keyThe key for the requested key/value pair
Returns
mixed

Definition at line 200 of file ElggMenuItem.php.

ElggMenuItem::getDeps ( )

Get required AMD modules.

Returns
string[]

Definition at line 417 of file ElggMenuItem.php.

ElggMenuItem::getHref ( )

Get the URL of the menu item.

Returns
string

Definition at line 262 of file ElggMenuItem.php.

ElggMenuItem::getItemClass ( )

Get the li classes as text.

Returns
string

Definition at line 454 of file ElggMenuItem.php.

ElggMenuItem::getLinkClass ( )

Get the anchor classes as text.

Returns
string

Definition at line 388 of file ElggMenuItem.php.

ElggMenuItem::getName ( )

Get the identifier of the menu item.

Returns
string

Definition at line 223 of file ElggMenuItem.php.

ElggMenuItem::getParent ( )

Get the parent menu item.

This is reserved for the .

Returns
or null private

Definition at line 599 of file ElggMenuItem.php.

ElggMenuItem::getParentName ( )

Get the parent identifier.

Returns
string

Definition at line 574 of file ElggMenuItem.php.

ElggMenuItem::getPriority ( )

Get the priority of the menu item.

Returns
int

Definition at line 536 of file ElggMenuItem.php.

ElggMenuItem::getSection ( )

Get the section identifier.

Returns
string

Definition at line 555 of file ElggMenuItem.php.

ElggMenuItem::getSelected ( )

Get selected state.

Returns
bool

Definition at line 327 of file ElggMenuItem.php.

ElggMenuItem::getText ( )

Get the display text of the menu item.

Returns
string The display text as HTML

Definition at line 242 of file ElggMenuItem.php.

ElggMenuItem::getTooltip ( )

Get the tool tip text.

Returns
string

Definition at line 346 of file ElggMenuItem.php.

ElggMenuItem::getValues ( )

Get all the values for this menu item.

Useful for rendering.

Returns
array
Since
1.9.0

Definition at line 663 of file ElggMenuItem.php.

ElggMenuItem::getWeight ( )

Get the priority of the menu item.

Returns
int

Definition at line 516 of file ElggMenuItem.php.

ElggMenuItem::inContext (   $context = '')

Should this menu item be used given the current context.

Parameters
string$contextA context string (default is empty string for current context stack).
Returns
bool

Definition at line 295 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 625 of file ElggMenuItem.php.

ElggMenuItem::setConfirmText (   $text)

Set the confirm text shown when link is clicked.

Parameters
string$textThe text to show
Returns
void

Definition at line 356 of file ElggMenuItem.php.

ElggMenuItem::setContext (   $contexts)

Set the contexts that this menu item is available for.

Parameters
array$contextsAn array of context strings. Use 'all' to match all contexts.
Returns
void

Definition at line 272 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$keyString key or an associative array of key/value pairs
mixed$valueThe value if $key is a string
Returns
void

Definition at line 186 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 408 of file ElggMenuItem.php.

ElggMenuItem::setHref (   $href)

Set the URL of the menu item.

Parameters
string$hrefURL or false if not a link
Returns
void

Definition at line 253 of file ElggMenuItem.php.

ElggMenuItem::setItemClass (   $class)

Set the li classes.

Parameters
mixed$classAn array of class names, or a single string class name.
Returns
void

Definition at line 441 of file ElggMenuItem.php.

ElggMenuItem::setLinkClass (   $class)

Set the anchor class.

Parameters
mixed$classAn array of class names, or a single string class name.
Returns
void

Definition at line 375 of file ElggMenuItem.php.

ElggMenuItem::setName (   $name)

Set the identifier of the menu item.

Parameters
string$nameUnique identifier
Returns
void

Definition at line 214 of file ElggMenuItem.php.

ElggMenuItem::setParent (   $parent)

Set the parent menu item.

This is reserved for the .

Parameters
\ElggMenuItem$parentThe parent of this menu item
Returns
void private

Definition at line 587 of file ElggMenuItem.php.

ElggMenuItem::setParentName (   $name)

Set the parent identifier.

Parameters
string$nameThe identifier of the parent
Returns
void

Definition at line 565 of file ElggMenuItem.php.

ElggMenuItem::setPriority (   $priority)

Set the priority of the menu item.

Parameters
int$priorityThe smaller numbers mean higher priority (1 before 100)
Returns
void

Definition at line 527 of file ElggMenuItem.php.

ElggMenuItem::setSection (   $section)

Set the section identifier.

Parameters
string$sectionThe identifier of the section
Returns
void

Definition at line 546 of file ElggMenuItem.php.

ElggMenuItem::setSelected (   $state = true)

Set the selected flag.

Parameters
bool$stateSelected state (default is true)
Returns
void

Definition at line 318 of file ElggMenuItem.php.

ElggMenuItem::setText (   $text)

Set the display text of the menu item.

Parameters
string$textThe display text as HTML
Returns
void

Definition at line 233 of file ElggMenuItem.php.

ElggMenuItem::setTooltip (   $text)

Set the tool tip text.

Parameters
string$textThe text of the tool tip
Returns
void

Definition at line 337 of file ElggMenuItem.php.

ElggMenuItem::setWeight (   $priority)

Set the priority of the menu item.

Parameters
int$priorityThe smaller numbers mean higher priority (1 before 100)
Returns
void

Definition at line 505 of file ElggMenuItem.php.

ElggMenuItem::sortChildren (   $sortFunction)

Sort the children.

This is reserved for the .

Parameters
string$sortFunctionA function that is passed to usort()
Returns
void private

Definition at line 650 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: