custom_menu Class Reference

Inheritance diagram for custom_menu:

Public Member Functions
	__construct ($definition='', $currentlanguage=null)
	Creates the custom menu. More...
	add ($text, moodle_url $url=null, $title=null, $sort=null)
	Adds a custom menu item as a child of this node given its properties. More...
	export_for_template (renderer_base $output)
	Export this data so it can be used as the context for a mustache template. More...
	get_children ()
	Sorts and returns the children for this item. More...
	get_parent ()
	Gets the parent this child belong to. More...
	get_sort_order ()
	Gets the sort order for this child. More...
	get_text ()
	Returns the text for this item. More...
	get_title ()
	Returns the title for this item. More...
	get_url ()
	Returns the url for this item. More...
	has_children ()
	Returns true if this item has any children. More...
	override_children (array $children)
	Overrides the children of this custom menu. More...
	remove_child (custom_menu_item $menuitem)
	Removes a custom menu item that is a child or descendant to the current menu. More...
	set_text ($text)
	Sets the text for the node. More...
	set_title ($title)
	Sets the title for the node. More...
	set_url (moodle_url $url)
	Sets the url for the node. More...
	sort ()
	Sorts the children this item has.

Static Public Member Functions
static	convert_text_to_menu_nodes ($text, $language=null)
	Converts a string into a structured array of custom_menu_items which can then be added to a custom menu. More...
static	sort_custom_menu_items (custom_menu_item $itema, custom_menu_item $itemb)
	Sorts two custom menu items. More...

Protected Attributes
array	$children = array()
	A array in which to store children this item has.
string	$currentlanguage = null
	The language we should render for, null disables multilang support.
int	$lastsort = 0
	A reference to the sort var of the last child that was added.
custom_menu_item	$parent
	A reference to the parent for this item or NULL if it is a top level item.
int	$sort
	A sort order for the item, not necessary if you order things in the CFG var.
string	$text
	The text to show for the item.
string	$title
	A title to apply to the item. More...
moodle_url	$url
	The link to give the icon if it has no children.

Constructor & Destructor Documentation

__construct()

custom_menu::__construct	(		$definition = '',
			$currentlanguage = null
	)

Creates the custom menu.

Parameters

string	$definition	the menu items definition in syntax required by convert_text_to_menu_nodes()
string	$currentlanguage	the current language code, null disables multilang support

Member Function Documentation

add()

custom_menu_item::add (   $text, moodle_url  $url = null,   $title = null,   $sort = null  )

inherited

Adds a custom menu item as a child of this node given its properties.

Parameters

string	$text
moodle_url	$url
string	$title
int	$sort

Return values

custom_menu_item

convert_text_to_menu_nodes()

static custom_menu::convert_text_to_menu_nodes (   $text,   $language = null  )

static

Converts a string into a structured array of custom_menu_items which can then be added to a custom menu.

Structure: text|url|title|langs The number of hyphens at the start determines the depth of the item. The languages are optional, comma separated list of languages the line is for.

Example structure: First level first item|http://www.moodle.com/ -Second level first item|http://www.moodle.com/partners/ -Second level second item|http://www.moodle.com/hq/ –Third level first item|http://www.moodle.com/jobs/ -Second level third item|http://www.moodle.com/development/ First level second item|http://www.moodle.com/feedback/ First level third item English only|http://moodle.com|English only item|en German only|http://moodle.de|Deutsch|de,de_du,de_kids

Parameters

string	$text	the menu items definition
string	$language	the language code, null disables multilang support

Return values

array

export_for_template()

custom_menu_item::export_for_template ( renderer_base  $output )

inherited

Export this data so it can be used as the context for a mustache template.

Parameters

renderer_base

$output

Used to do a final render of any components that need to be rendered for export.

Return values

array

Implements templatable.

get_children()

custom_menu_item::get_children ( )

inherited

Sorts and returns the children for this item.

Return values

array

get_parent()

custom_menu_item::get_parent ( )

inherited

Gets the parent this child belong to.

Return values

custom_menu_item

get_sort_order()

custom_menu_item::get_sort_order ( )

inherited

Gets the sort order for this child.

Return values

int

get_text()

custom_menu_item::get_text ( )

inherited

Returns the text for this item.

Return values

string

get_title()

custom_menu_item::get_title ( )

inherited

Returns the title for this item.

Return values

string

get_url()

custom_menu_item::get_url ( )

inherited

Returns the url for this item.

Return values

moodle_url

has_children()

custom_menu_item::has_children ( )

inherited

Returns true if this item has any children.

Return values

bool

override_children()

custom_menu::override_children

(

array

$children

)

Overrides the children of this custom menu.

Useful when getting children from $CFG->custommenuitems

Parameters

array

$children

remove_child()

custom_menu_item::remove_child ( custom_menu_item  $menuitem )

inherited

Removes a custom menu item that is a child or descendant to the current menu.

Returns true if child was found and removed.

Parameters

custom_menu_item

$menuitem

Return values

bool

set_text()

custom_menu_item::set_text (   $text )

inherited

Sets the text for the node.

Parameters

string

$text

set_title()

custom_menu_item::set_title (   $title )

inherited

Sets the title for the node.

Parameters

string

$title

set_url()

custom_menu_item::set_url ( moodle_url  $url )

inherited

Sets the url for the node.

Parameters

moodle_url

$url

sort_custom_menu_items()

static custom_menu::sort_custom_menu_items ( custom_menu_item  $itema, custom_menu_item  $itemb  )

static

Sorts two custom menu items.

This function is designed to be used with the usort method usort($this->children, array('custom_menu','sort_custom_menu_items'));

Parameters

custom_menu_item	$itema
custom_menu_item	$itemb

Return values

int

Member Data Documentation

$title

string custom_menu_item::$title

protectedinherited

A title to apply to the item.

By default the text

---

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

• lib/outputcomponents.php