Moodle APIs 3.9
Moodle 3.9.13+ (Build: 20220325)
Public Member Functions | Static Public Member Functions | Protected Attributes | List of all members
custom_menu Class Reference
Inheritance diagram for custom_menu:
custom_menu_item renderable templatable

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$definitionthe menu items definition in syntax required by convert_text_to_menu_nodes()
string$currentlanguagethe 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$textthe menu items definition
string$languagethe 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$outputUsed 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: