Moodle APIs 4.3
Moodle 4.3.6 (Build: 20240812)
|
Class secondary_navigation_view. More...
Public Member Functions | |
__wakeup () | |
Resets the page specific information on this node if it is being unserialised. | |
action () | |
Get the action url for this navigation node. | |
action_link_actions () | |
Return an array consisting of the actions for the action link. | |
actionattributes () | |
Return an array consisting of the additional attributes for the action url. | |
add ($text, $action=null, $type=self::TYPE_CUSTOM, $shorttext=null, $key=null, pix_icon $icon=null) | |
Adds a navigation node as a child of this node. | |
add_class ($class) | |
Adds a CSS class to this node. | |
add_node (navigation_node $childnode, $beforekey=null) | |
Adds a navigation node as a child of this one, given a $node object created using the create function. | |
build_flat_navigation_list (flat_navigation $nodes, $showdivider=false, $label='') | |
Walk the tree building up a list of all the flat navigation nodes. | |
check_if_active ($strength=URL_MATCH_EXACT) | |
Checks if this node is the active node. | |
contains_active_node () | |
Checks if this node or any of its children contain the active node. | |
find ($key, $type) | |
Searches for a node of the given type with the given key. | |
find_active_node () | |
Finds the active node. | |
find_all_of_type ($type) | |
Finds all nodes of a given type (recursive) | |
find_expandable (array &$expandable) | |
Finds all nodes that are expandable by AJAX. | |
force_open () | |
Forces this node to be open and at the same time forces open all parents until the root node. | |
get ($key, $type=null) | |
Get the child of this node that has the given key + (optional) type. | |
get_children_key_list () | |
Return a list of all the keys of all the child nodes. | |
get_content ($shorttext=false) | |
Gets the content for this node. | |
get_css_type () | |
Gets the CSS class to add to this node to describe its type. | |
get_overflow_menu_data () | |
Returns a url_select object with overflow navigation nodes. | |
get_siblings () | |
Get a list of sibling navigation nodes at the same level as this one. | |
get_tabs_array (array $inactive=array(), $return=false) | |
Creates a tab representation of this nodes children that can be used with print_tabs to produce the tabs on a page. | |
get_title () | |
Gets the title to use for this node. | |
has_action () | |
Used to easily determine if this link in the breadcrumbs has a valid action/url. | |
has_children () | |
Checks if this node has or could have any children. | |
has_internal_action () | |
Used to easily determine if the action is an internal link. | |
has_siblings () | |
True if this nav node has siblings in the tree. | |
hide (array $typestohide=null) | |
Hides the node and any children it has. | |
initialise () | |
Initialise the view based navigation based on the current context. | |
is_action_link () | |
Check whether the node's action is of type action_link. | |
is_hidden () | |
Used to easily determine if this link in the breadcrumbs is hidden. | |
is_short_branch () | |
To better balance the admin tree, we want to group all the short top branches together. | |
make_active () | |
Marks this node as active and forces it open. | |
make_inactive () | |
Marks a node as inactive and recusised back to the base of the tree doing the same to all parents. | |
remove () | |
Removes this node. | |
remove_class ($class) | |
Removes a CSS class from this node. | |
search_for_active_node ($strength=URL_MATCH_BASE) | |
Searches all children for the best matching active node. | |
set_force_into_more_menu (bool $forceintomoremenu=false) | |
Sets whether the node and its children should be added into a "more" menu whenever possible. | |
set_overflow_selected_node (string $nodekey) | |
Force a specific node in the 'coursereuse' course overflow to be selected, based on the provided node key. | |
set_parent (navigation_node $parent) | |
Sets the parent for this node and if this node is active ensures that the tree is properly adjusted as well. | |
set_show_in_secondary_navigation (bool $show=true) | |
Sets whether the node and its children should be displayed in the "secondary" navigation when applicable. | |
title (?string $title=null) | |
Sets the title for this node and forces Moodle to utilise it. | |
trim_if_empty () | |
Removes this node if it is empty. | |
Static Public Member Functions | |
static | create ($text, $action=null, $type=self::TYPE_CUSTOM, $shorttext=null, $key=null, pix_icon $icon=null) |
Creates a navigation node, ready to add it as a child using add_node function. | |
static | create_menu_element (array $navigationnodes, bool $forceheadings=false) |
Takes the given navigation nodes and searches for children and formats it all into an array in a format to be used by a url_select element. | |
static | override_active_url (moodle_url $url, $loadadmintree=false) |
This sets the URL that the URL of new nodes get compared to when locating the active node. | |
static | require_admin_tree () |
Use when page is linked from the admin tree, if not used navigation could not find the page using current URL because the tree is not fully loaded. | |
Public Attributes | |
moodle_url action_link null | $action = null |
An action for the node (link) | |
navigation_node | $activenode |
$activenode A string identifier for the active node | |
navigation_node_collection | $children = array() |
An array of child nodes. | |
array | $classes = array() |
An array of CSS classes for the node. | |
bool | $collapse = false |
If set to true the node will be collapsed by default. | |
bool | $display = true |
If set to false the node will not be displayed. | |
bool | $forceintomoremenu = false |
If set to true this node will be forced into a "more" menu whenever possible. | |
bool | $forceopen = false |
If set to true the node will be expanded by default. | |
bool | $forcetitle = false |
If set to true a title will be added to the action no matter what. | |
bool | $haschildren |
node that have children. | |
string | $headertitle |
$headertitle The header for this particular menu | |
string | $helpbutton = null |
A string that can be used to build a help button. | |
bool | $hidden = false |
If set to true the node will be dimmed. | |
bool | $hideicon = false |
Override to not display the icon even if one is provided. | |
pix_icon | $icon = null |
The path to an icon to use for this node. | |
int | $id = null |
Parameter to aid the coder in tracking [optional]. | |
mixed | $includesectionnum = false |
If set to an int, that section will be included even if it has no activities. | |
bool | $isactive = false |
If set to true the node will be recognised as active. | |
bool | $isexpandable = false |
Set to true if we KNOW that this node can be expanded. | |
string int | $key = null |
The identifier for the node, used to retrieve the node. | |
bool | $mainnavonly = false |
If set to true the the navigation bar should ignore this node. | |
string | $moremenuid |
unique identifier. | |
int | $nodetype = self::NODETYPE_LEAF |
See NODETYPE_* constants defined for this class. | |
navigation_node | $parent = null |
A reference to the node parent, you should never set this directly you should always call set_parent. | |
bool | $preceedwithhr = false |
If set to true then an HR will be printed before the node. | |
bool | $requiresajaxloading = false |
does the node need to be loaded via ajax | |
string | $shorttext = null |
Short text to use if requested [optional]. | |
bool | $showchildreninsubmenu = false |
If set to true the children of this node will be displayed within a submenu when applicable. | |
bool | $showinflatnavigation = false |
If set to true this node will be added to the "flat" navigation. | |
bool | $showinsecondarynavigation = true |
If set to true this node will be displayed in the "secondary" navigation when applicable. | |
string | $tab |
tab element ID. | |
string lang_string | $text = null |
The text to use for the node. | |
string | $title = null |
The title attribute for an action if one is defined. | |
int | $type = self::TYPE_UNKNOWN |
See TYPE_* constants defined for this class. | |
const | COURSE_CURRENT = 2 |
var int Course the current user is currently viewing | |
const | COURSE_INDEX_PAGE = 'courseindexpage' |
var string The course index page navigation node | |
const | COURSE_MY = 1 |
var int Course the current user is enrolled in but not viewing | |
const | COURSE_OTHER = 0 |
var int Course the current user is not enrolled in | |
int const | MAX_DISPLAYED_NAV_NODES = 5 |
The maximum limit of navigation nodes displayed in the secondary navigation. | |
int const | NODETYPE_BRANCH = 1 |
Used to identify this node a branch, happens with children 1. | |
int const | NODETYPE_LEAF = 0 |
Used to identify this node a leaf (default) 0. | |
int const | TYPE_ACTIVITY = 40 |
Activity node type, e.g. | |
int const | TYPE_CATEGORY = 10 |
Category node type 10. | |
int const | TYPE_CONTAINER = 90 |
Setting node type, used for containers of no importance 90. | |
int const | TYPE_COURSE = 20 |
Course node type 20. | |
int const | TYPE_CUSTOM = 60 |
A custom node type, default when adding without specifing type 60. | |
const | TYPE_MY_CATEGORY = 11 |
var int Category displayed in MyHome navigation node | |
int const | TYPE_RESOURCE = 50 |
Resource node type, e.g. | |
int const | TYPE_ROOTNODE = 0 |
System node type 0. | |
int const | TYPE_SECTION = 30 |
Course Structure node type 30. | |
int const | TYPE_SETTING = 70 |
Setting node type, used only within settings nav 70. | |
int const | TYPE_SITE_ADMIN = 71 |
site admin branch node type, used only within settings nav 71 | |
int const | TYPE_SYSTEM = 1 |
System node type 1. | |
null const | TYPE_UNKNOWN = null |
Unknown node type null. | |
int const | TYPE_USER = 80 |
Setting node type, used only within settings nav 80. | |
Static Public Attributes | |
static bool | $autofindactive = true |
toogles auto matching of active node | |
Protected Member Functions | |
active_node_scan (navigation_node $node, int $strictness=URL_MATCH_EXACT) | |
This function recursively scans nodes until it finds the active node or there are no more nodes. | |
add_context_locking_node (\navigation_node $node, context $context) | |
Add the menu item to handle locking and unlocking of a conext. | |
add_external_nodes_to_secondary (navigation_node $node, navigation_node $basenode, ?navigation_node $root=null, bool $forceadd=false) | |
Recursive call to add all custom navigation nodes to secondary. | |
add_ordered_nodes (array $nodes, ?navigation_node $rootnode=null) | |
Adds the indexed nodes to the current view or a given node. | |
force_nodes_into_more_menu (array $defaultmoremenunodes=[], ?int $maxdisplayednodes=null) | |
Force certain secondary navigation nodes to be displayed in the "more" menu. | |
get_course_overflow_nodes (?navigation_node $rootnode=null) | |
Gets the overflow navigation nodes for the course administration category. | |
get_default_admin_more_menu_nodes () | |
Define the keys of the admin secondary nav nodes that should be forced into the "more" menu by default. | |
get_default_category_mapping () | |
Defines the default structure for the secondary nav in a category context. | |
get_default_category_more_menu_nodes () | |
Define the keys of the course secondary nav nodes that should be forced into the "more" menu by default. | |
get_default_course_mapping () | |
Defines the default structure for the secondary nav in a course context. | |
get_default_course_more_menu_nodes () | |
Define the keys of the course secondary nav nodes that should be forced into the "more" menu by default. | |
get_default_module_mapping () | |
Defines the default structure for the secondary nav in a module context. | |
get_default_module_more_menu_nodes () | |
Define the keys of the module secondary nav nodes that should be forced into the "more" menu by default. | |
get_expected_course_admin_nodes () | |
Returns a list of all expected nodes in the course administration. | |
get_first_action_for_node (navigation_node $node) | |
Some nodes are containers only with no action. | |
get_leaf_nodes (navigation_node $source, array $nodes) | |
Get the leaf nodes for the nav view. | |
get_node_with_first_action (navigation_node $node, navigation_node $basenode) | |
Returns a node with the action being from the first found child node that has an action (Recursive). | |
get_other_overflow_menu_data (navigation_node $activenode) | |
Gets overflow menu data for third party plugin settings. | |
load_admin_navigation () | |
Load the site admin navigation. | |
load_category_navigation () | |
Load the course category navigation. | |
load_course_navigation (?navigation_node $rootnode=null) | |
Load the course secondary navigation. | |
load_module_navigation (settings_navigation $settingsnav, ?navigation_node $rootnode=null) | |
Custom module construct for label. | |
load_remaining_nodes (navigation_node $completenode, array $nodesmap, ?navigation_node $rootnode=null) | |
Find the remaining nodes that need to be loaded into secondary based on the current context or a given node. | |
load_single_activity_course_navigation () | |
Load the single activity course secondary navigation. | |
node_matches_key_string (navigation_node $node, string $key) | |
Recursively search a node and its children for a node matching the key string $key. | |
nodes_match_current_url (navigation_node $node) | |
Recursively looks for a match to the current page url. | |
remove_unwanted_nodes (navigation_node $node) | |
Recursively remove navigation nodes that should not be displayed in the secondary navigation. | |
scan_for_active_node (navigation_node $node) | |
Scan the given node for the active node. | |
Static Protected Member Functions | |
static | does_menu_need_headings (navigation_node $navigationnode) |
Checks to see if the provided navigation node has children and determines if we want headings for a url select element. | |
static | format_node_text (navigation_node $navigationnode) |
Returns the navigation node text in a string. | |
static | get_flat_nav_array (navigation_node $navigationnode) |
Takes the navigation node and returns it in a flat fashion. | |
static | get_headings_nav_array (navigation_node $navigationnode) |
For any navigation node that we have determined needs headings we return a more tree like array structure. | |
static | get_more_child_nodes (navigation_node $node, array &$menublock) |
Recursively goes and gets all children nodes. | |
static | get_whole_tree_flat (navigation_node $navigationnode) |
Recursively goes through the provided navigation node and returns a flat version. | |
Protected Attributes | |
stdClass | $context |
$context the current context | |
navigation_node | $courseoverflownode = null |
The course overflow node. | |
bool | $initialised = false |
$initialised A switch to see if the navigation node is initialised | |
array | $namedtypes |
string | $overflowselected = null |
The key of the node to set as selected in the course overflow menu, if explicitly set by a page. | |
moodle_page | $page |
$page the moodle page that the navigation belongs to | |
Static Protected Attributes | |
static moodle_url | $fullmeurl = null |
static bool | $loadadmintree = false |
should we load full admin tree or rely on AJAX for performance reasons | |
Class secondary_navigation_view.
Custom implementation for a plugin.
|
inherited |
Get the action url for this navigation node.
Called from templates.
|
inherited |
Return an array consisting of the actions for the action link.
array | Formatted array to parse in a template |
|
inherited |
Return an array consisting of the additional attributes for the action url.
array | Formatted array to parse in a template |
|
protectedinherited |
This function recursively scans nodes until it finds the active node or there are no more nodes.
We are using a custom implementation here to adjust the strictness and also because we need the parent node and not the specific child node in the new views. e.g. Structure for site admin, SecondaryNav
navigation_node | $node | |
int | $strictness | How stict to be with the scan for the active node. |
navigation_node|null |
|
inherited |
Adds a navigation node as a child of this node.
string | $text | |
moodle_url | action_link | string | $action | |
int | $type | |
string | $shorttext | |
string | int | $key | |
pix_icon | $icon |
navigation_node |
Reimplemented in navbar, and settings_navigation.
|
inherited |
Adds a CSS class to this node.
string | $class |
bool |
|
protectedinherited |
Add the menu item to handle locking and unlocking of a conext.
navigation_node | $node | Node to add |
context | $context | The context to be locked |
|
protectedinherited |
Recursive call to add all custom navigation nodes to secondary.
navigation_node | $node | The node which should be added to secondary |
navigation_node | $basenode | The original parent node |
navigation_node | null | $root | The parent node nodes are to be added/removed to. |
bool | $forceadd | Whether or not to bypass the external action check and force add all nodes |
|
inherited |
Adds a navigation node as a child of this one, given a $node object created using the create function.
navigation_node | $childnode | Node to add |
string | $beforekey |
navigation_node | The added node |
|
protectedinherited |
Adds the indexed nodes to the current view or a given node.
The key should indicate it's position in the tree. Any sub nodes needs to be numbered appropriately, e.g. 3.1 would make the identified node be listed under #3 node.
array | $nodes | An array of navigation nodes to be added. |
navigation_node | null | $rootnode | The node where the nodes should be added into as children. If not explicitly defined, the nodes will be added to the secondary root node by default. |
|
inherited |
Walk the tree building up a list of all the flat navigation nodes.
flat_navigation | $nodes | List of the found flat navigation nodes. |
boolean | $showdivider | Show a divider before the first node. |
string | $label | A label for the collection of navigation links. |
|
inherited |
Checks if this node is the active node.
This is determined by comparing the action for the node against the defined URL for the page. A match will see this node marked as active.
int | $strength | One of URL_MATCH_EXACT, URL_MATCH_PARAMS, or URL_MATCH_BASE |
bool |
|
inherited |
Checks if this node or any of its children contain the active node.
Recursive.
bool |
|
staticinherited |
Creates a navigation node, ready to add it as a child using add_node function.
(The created node needs to be added before you can use it.)
string | $text | |
moodle_url | action_link | $action | |
int | $type | |
string | $shorttext | |
string | int | $key | |
pix_icon | $icon |
navigation_node |
|
staticinherited |
Takes the given navigation nodes and searches for children and formats it all into an array in a format to be used by a url_select element.
navigation_node[] | $navigationnodes | Navigation nodes to format into a menu. |
bool | $forceheadings | Whether the returned array should be forced to use headings. |
array|null | A url select element for navigating through the navigation nodes. |
|
staticprotectedinherited |
Checks to see if the provided navigation node has children and determines if we want headings for a url select element.
navigation_node | $navigationnode | The navigation node we are checking. |
bool | Whether we want headings or not. |
|
inherited |
Searches for a node of the given type with the given key.
This searches this node plus all of its children, and their children.... If you know the node you are looking for is a child of this node then please use the get method instead.
int | string | $key | The key of the node we are looking for |
int | $type | One of navigation_node\TYPE_* |
navigation_node|false |
Reimplemented in global_navigation.
|
inherited |
Finds the active node.
Searches this nodes children plus all of the children for the active node and returns it if found.
Recursive.
navigation_node|false |
|
inherited |
Finds all nodes of a given type (recursive)
int | $type | One of navigation_node\TYPE_* |
array |
|
inherited |
Finds all nodes that are expandable by AJAX.
array | $expandable | An array by reference to populate with expandable nodes. |
|
protectedinherited |
Force certain secondary navigation nodes to be displayed in the "more" menu.
array | $defaultmoremenunodes | Array with navigation node keys of the pre-defined nodes that should be added into the "more" menu by default |
int | null | $maxdisplayednodes | The maximum limit of navigation nodes displayed in the secondary navigation |
|
inherited |
Forces this node to be open and at the same time forces open all parents until the root node.
Recursive.
|
staticprotectedinherited |
Returns the navigation node text in a string.
navigation_node | $navigationnode | The navigationnode to return the text string of. |
string | The navigation node text string. |
|
inherited |
Get the child of this node that has the given key + (optional) type.
If you are looking for a node and want to search all children + their children then please use the find method instead.
int | string | $key | The key of the node we are looking for |
int | $type | One of navigation_node\TYPE_* |
navigation_node|false |
Reimplemented in global_navigation, and navbar.
|
inherited |
Return a list of all the keys of all the child nodes.
array | the keys. |
|
inherited |
Gets the content for this node.
bool | $shorttext | If true shorttext is used rather than the normal text |
string |
|
protectedinherited |
Gets the overflow navigation nodes for the course administration category.
navigation_node | null | $rootnode | The node from where the course overflow nodes should be obtained. If not explicitly defined, the nodes will be obtained from the secondary root node by default. |
navigation_node | The course overflow nodes. |
|
inherited |
Gets the CSS class to add to this node to describe its type.
string |
|
protectedinherited |
Define the keys of the admin secondary nav nodes that should be forced into the "more" menu by default.
array |
|
protectedinherited |
Defines the default structure for the secondary nav in a category context.
In a category context, we are curating nodes from the settingsnav object. The following mapping construct specifies the type of the node, the key and in what order we want the node - defined as per the mockups.
array |
|
protectedinherited |
Define the keys of the course secondary nav nodes that should be forced into the "more" menu by default.
array |
|
protectedinherited |
Defines the default structure for the secondary nav in a course context.
In a course context, we are curating nodes from the settingsnav and navigation objects. The following mapping construct specifies which object we are fetching it from, the type of the node, the key and in what order we want the node - defined as per the mockups.
array |
|
protectedinherited |
Define the keys of the course secondary nav nodes that should be forced into the "more" menu by default.
array |
|
protectedinherited |
Defines the default structure for the secondary nav in a module context.
In a module context, we are curating nodes from the settingsnav object. The following mapping construct specifies the type of the node, the key and in what order we want the node - defined as per the mockups.
array |
Reimplemented in mod_assign\navigation\views\secondary, mod_feedback\navigation\views\secondary, mod_glossary\navigation\views\secondary, and mod_quiz\navigation\views\secondary.
|
protectedinherited |
Define the keys of the module secondary nav nodes that should be forced into the "more" menu by default.
array |
|
protectedinherited |
Returns a list of all expected nodes in the course administration.
array | An array of keys for navigation nodes in the course administration. |
|
protectedinherited |
Some nodes are containers only with no action.
If this container has an action then nothing is done. If it does not have an action then a search is done through the children looking for the first node that has an action. This action is then given to the parent node that is initially provided as a parameter.
navigation_node | $node | The navigation node that we want to ensure has an action tied to it. |
navigation_node | The node intact with an action to use. |
|
staticprotectedinherited |
Takes the navigation node and returns it in a flat fashion.
This is not recursive.
navigation_node | $navigationnode | The navigation node that we want to format into an array in a flat structure. |
array | The flat navigation array. |
|
staticprotectedinherited |
For any navigation node that we have determined needs headings we return a more tree like array structure.
navigation_node | $navigationnode | The navigation node to use for the formatted array structure. |
array | The headings navigation array structure. |
|
protectedinherited |
Get the leaf nodes for the nav view.
navigation_node | $source | The settingsnav OR navigation object |
array | $nodes | An array of nodes to fetch from the source which specifies the node type and final order |
array\$nodesordered | The fetched nodes ordered based on final specification. |
|
staticprotectedinherited |
Recursively goes and gets all children nodes.
navigation_node | $node | The node to get the children of. |
array | $menublock | Used to put all child nodes in its own container. |
array | The additional child nodes. |
|
protectedinherited |
Returns a node with the action being from the first found child node that has an action (Recursive).
navigation_node | $node | The part of the node tree we are checking. |
navigation_node | $basenode | The very first node to be used for the return. |
navigation_node|null |
|
protectedinherited |
Gets overflow menu data for third party plugin settings.
navigation_node | $activenode | The node to gather the children for to put into the overflow menu. |
url_select|null | The overflow menu in a url_select object. |
|
inherited |
Returns a url_select object with overflow navigation nodes.
This looks to see if the current page is within the course administration, or some other page that requires an overflow select object.
url_select|null | The overflow menu data. |
|
inherited |
Get a list of sibling navigation nodes at the same level as this one.
bool|array | of navigation_node |
|
inherited |
Creates a tab representation of this nodes children that can be used with print_tabs to produce the tabs on a page.
call_user_func_array('print_tabs', $node->get_tabs_array());
array | $inactive | |
bool | $return |
array | Array (tabs, selected, inactive, activated, return) |
|
inherited |
Gets the title to use for this node.
string |
|
staticprotectedinherited |
Recursively goes through the provided navigation node and returns a flat version.
navigation_node | $navigationnode | The navigationnode. |
array | The whole tree flat. |
|
inherited |
Used to easily determine if this link in the breadcrumbs has a valid action/url.
boolean |
|
inherited |
Checks if this node has or could have any children.
bool | Returns true if it has children or could have (by AJAX expansion) |
|
inherited |
Used to easily determine if the action is an internal link.
bool |
|
inherited |
True if this nav node has siblings in the tree.
bool |
|
inherited |
Hides the node and any children it has.
array | $typestohide | Optional. An array of node types that should be hidden. If null all nodes will be hidden. If an array is given then nodes will only be hidden if their type mtatches an element in the array. e.g. array(navigation_node\TYPE_COURSE) would hide only course nodes. |
|
inherited |
Initialise the view based navigation based on the current context.
As part of the initial restructure, the secondary nav is only considered for the following pages: 1 - Site admin settings 2 - Course page - Does not include front_page which has the same context. 3 - Module page
Reimplemented from core\navigation\views\view.
Reimplemented in core_block\navigation\views\secondary.
|
inherited |
Check whether the node's action is of type action_link.
bool |
|
inherited |
Used to easily determine if this link in the breadcrumbs is hidden.
boolean |
|
inherited |
To better balance the admin tree, we want to group all the short top branches together.
This means < 8 nodes and no subtrees.
bool |
|
protectedinherited |
Load the course secondary navigation.
Since we are sourcing all the info from existing objects that already do the relevant checks, we don't do it again here.
navigation_node | null | $rootnode | The node where the course navigation nodes should be added into as children. If not explicitly defined, the nodes will be added to the secondary root node by default. |
|
protected |
Custom module construct for label.
settings_navigation | $settingsnav | The settings navigation object related to the module page |
navigation_node | null | $rootnode | The node where the module navigation nodes should be added into as children. If not explicitly defined, the nodes will be added to the secondary root node by default. |
Reimplemented from core\navigation\views\secondary.
|
protectedinherited |
Find the remaining nodes that need to be loaded into secondary based on the current context or a given node.
navigation_node | $completenode | The original node that we are sourcing information from |
array | $nodesmap | The map used to populate secondary nav in the given context |
navigation_node | null | $rootnode | The node where the remaining nodes should be added into as children. If not explicitly defined, the nodes will be added to the secondary root node by default. |
|
inherited |
Marks this node as active and forces it open.
Important: If you are here because you need to mark a node active to get the navigation to do what you want have you looked at navigation_node::override_active_url()? You can use it to specify a different URL to match the active navigation node on rather than having to locate and manually mark a node active.
|
protectedinherited |
Recursively search a node and its children for a node matching the key string $key.
navigation_node | $node | the navigation node to check. |
string | $key | the key of the node to match. |
navigation_node|null | node if found, otherwise null. |
|
protectedinherited |
Recursively looks for a match to the current page url.
navigation_node | $node | The node to look through. |
navigation_node|null | The node that matches this page's url. |
|
staticinherited |
This sets the URL that the URL of new nodes get compared to when locating the active node.
The active node is the node that matches the URL set here. By default this is either $PAGE->url or if that hasn't been set $FULLME.
moodle_url | $url | The url to use for the fullmeurl. |
bool | $loadadmintree | use true if the URL point to administration tree |
|
inherited |
Removes this node.
bool |
|
inherited |
Removes a CSS class from this node.
string | $class |
bool | True if the class was successfully removed. |
|
protectedinherited |
Recursively remove navigation nodes that should not be displayed in the secondary navigation.
navigation_node | $node | The starting navigation node. |
|
protectedinherited |
Scan the given node for the active node.
It starts first with a strict search and then switches to a base search if required.
navigation_node | $node | The node to scan. |
navigation_node|null | The active node or null. |
|
inherited |
Searches all children for the best matching active node.
int | $strength | The url match to be made. |
navigation_node|false |
|
inherited |
Sets whether the node and its children should be added into a "more" menu whenever possible.
bool | $forceintomoremenu |
|
inherited |
Force a specific node in the 'coursereuse' course overflow to be selected, based on the provided node key.
Normally, the selected node is determined by matching the page URL to the node URL. E.g. The page 'backup/restorefile.php' will match the "Restore" node which has a registered URL of 'backup/restorefile.php' because the URLs match.
This method allows a page to choose a specific node to match, which is useful in cases where the page knows its URL won't match the node it needs to reside under. I.e. this permits several pages to 'share' the same overflow node. When the page knows the PAGE->url won't match the node URL, the page can simply say "I want to match the 'XXX' node".
E.g.
string | $nodekey | The string key of the overflow node to match. |
|
inherited |
Sets the parent for this node and if this node is active ensures that the tree is properly adjusted as well.
navigation_node | $parent |
|
inherited |
Sets whether the node and its children should be displayed in the "secondary" navigation when applicable.
bool | $show |
|
inherited |
Sets the title for this node and forces Moodle to utilise it.
Note that this method is named identically to the public "title" property of the class, which unfortunately confuses our Mustache renderer, because it will see the method and try and call it without any arguments (hence must be nullable) before trying to access the public property
string | null | $title |
string |
|
inherited |
Set to true if we KNOW that this node can be expanded.
|
protectedinherited |
|
inherited |
Activity node type, e.g.
Forum, Quiz 40
|
inherited |
Resource node type, e.g.
Link to a file, or label 50