Elgg  Version 1.11
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...
 
 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

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

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 80 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 575 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 451 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 439 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 394 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. data => ARR Custom attributes stored in the menu item.

Returns
ElggMenuItem or null on error

Definition at line 117 of file ElggMenuItem.php.

ElggMenuItem::getChildren ( )

Get the children menu items.

This is reserved for the .

Returns
array private

Definition at line 600 of file ElggMenuItem.php.

ElggMenuItem::getConfirmText ( )

Get the confirm text.

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

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

ElggMenuItem::getContext ( )

Get an array of context strings.

Returns
array

Definition at line 280 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 196 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 258 of file ElggMenuItem.php.

ElggMenuItem::getItemClass ( )

Get the li classes as text.

Returns
string

Definition at line 417 of file ElggMenuItem.php.

ElggMenuItem::getLinkClass ( )

Get the anchor classes as text.

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

Definition at line 384 of file ElggMenuItem.php.

ElggMenuItem::getName ( )

Get the identifier of the menu item.

Returns
string

Definition at line 219 of file ElggMenuItem.php.

ElggMenuItem::getParent ( )

Get the parent menu item.

This is reserved for the .

Returns
or null private

Definition at line 562 of file ElggMenuItem.php.

ElggMenuItem::getParentName ( )

Get the parent identifier.

Returns
string

Definition at line 537 of file ElggMenuItem.php.

ElggMenuItem::getPriority ( )

Get the priority of the menu item.

Returns
int

Definition at line 499 of file ElggMenuItem.php.

ElggMenuItem::getSection ( )

Get the section identifier.

Returns
string

Definition at line 518 of file ElggMenuItem.php.

ElggMenuItem::getSelected ( )

Get selected state.

Returns
bool

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

ElggMenuItem::getTooltip ( )

Get the tool tip text.

Returns
string

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

ElggMenuItem::getWeight ( )

Get the priority of the menu item.

Returns
int

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

ElggMenuItem::setChildren (   $children)

Set the menu item's children.

This is reserved for the .

Parameters
array$childrenArray of
Returns
void private

Definition at line 588 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 352 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 268 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 182 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 249 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 404 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 371 of file ElggMenuItem.php.

ElggMenuItem::setName (   $name)

Set the identifier of the menu item.

Parameters
string$nameUnique identifier
Returns
void

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

ElggMenuItem::setParentName (   $name)

Set the parent identifier.

Parameters
string$nameThe identifier of the parent
Returns
void

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

ElggMenuItem::setSection (   $section)

Set the section identifier.

Parameters
string$sectionThe identifier of the section
Returns
void

Definition at line 509 of file ElggMenuItem.php.

ElggMenuItem::setSelected (   $state = true)

Set the selected flag.

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

Definition at line 314 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 229 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 333 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 468 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 613 of file ElggMenuItem.php.

Member Data Documentation

ElggMenuItem::$confirm = ''
protected

Definition at line 70 of file ElggMenuItem.php.

ElggMenuItem::$data
protected

Definition at line 20 of file ElggMenuItem.php.

ElggMenuItem::$href = null
protected

Definition at line 60 of file ElggMenuItem.php.

ElggMenuItem::$text
protected

Definition at line 55 of file ElggMenuItem.php.

ElggMenuItem::$title = false
protected

Definition at line 65 of file ElggMenuItem.php.

The documentation for this class was generated from the following file:
Generated on Sat Dec 21 2024 00:00:52 for Elgg by   doxygen 1.8.11