Search moodle.org's
Developer Documentation

See Release Notes
Long Term Support Release

  • Bug fixes for general core bugs in 4.1.x will end 13 November 2023 (12 months).
  • Bug fixes for security issues in 4.1.x will end 10 November 2025 (36 months).
  • PHP version: minimum PHP 7.4.0 Note: minimum PHP version has increased since Moodle 4.0. PHP 8.0.x is supported too.
<?php
// This file is part of Moodle - http://moodle.org/
//
// Moodle is free software: you can redistribute it and/or modify
// it under the terms of the GNU General Public License as published by
// the Free Software Foundation, either version 3 of the License, or
// (at your option) any later version.
//
// Moodle is distributed in the hope that it will be useful,
// but WITHOUT ANY WARRANTY; without even the implied warranty of
// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
// GNU General Public License for more details.
//
// You should have received a copy of the GNU General Public License
// along with Moodle.  If not, see <http://www.gnu.org/licenses/>.

namespace core\navigation\output;

use renderable;
use renderer_base;
use templatable;
use custom_menu;

/**
 * Primary navigation renderable
 *
 * This file combines primary nav, custom menu, lang menu and
 * usermenu into a standardized format for the frontend
 *
 * @package     core
 * @category    navigation
 * @copyright   2021 onwards Peter Dias
 * @license     http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
 */
class primary implements renderable, templatable {
< /** @var moodle_page $page the moodle page that the navigation belongs to */
> /** @var \moodle_page $page the moodle page that the navigation belongs to */
private $page = null; /** * primary constructor. * @param \moodle_page $page */ public function __construct($page) { $this->page = $page; } /** * Combine the various menus into a standardized output. * * @param renderer_base|null $output * @return array */ public function export_for_template(?renderer_base $output = null): array { if (!$output) { $output = $this->page->get_renderer('core'); } $menudata = (object) array_merge($this->get_primary_nav(), $this->get_custom_menu($output)); $moremenu = new \core\navigation\output\more_menu($menudata, 'navbar-nav', false); $mobileprimarynav = array_merge($this->get_primary_nav(), $this->get_custom_menu($output)); $languagemenu = new \core\output\language_menu($this->page); return [ 'mobileprimarynav' => $mobileprimarynav, 'moremenu' => $moremenu->export_for_template($output), 'lang' => !isloggedin() || isguestuser() ? $languagemenu->export_for_template($output) : [], 'user' => $this->get_user_menu($output), ]; } /** * Get the primary nav object and standardize the output * * @return array */ protected function get_primary_nav(): array { $nodes = []; foreach ($this->page->primarynav->children as $node) { $nodes[] = [ 'title' => $node->get_title(), 'url' => $node->action(), 'text' => $node->text, 'icon' => $node->icon, 'isactive' => $node->isactive, 'key' => $node->key, ]; } return $nodes; } /** * Custom menu items reside on the same level as the original nodes. * Fetch and convert the nodes to a standardised array. * * @param renderer_base $output * @return array */ protected function get_custom_menu(renderer_base $output): array { global $CFG; // Early return if a custom menu does not exists. if (empty($CFG->custommenuitems)) { return []; } $custommenuitems = $CFG->custommenuitems; $currentlang = current_language(); $custommenunodes = custom_menu::convert_text_to_menu_nodes($custommenuitems, $currentlang); $nodes = []; foreach ($custommenunodes as $node) { $nodes[] = $node->export_for_template($output); } return $nodes; } /** * Get/Generate the user menu. * * This is leveraging the data from user_get_user_navigation_info and the logic in $OUTPUT->user_menu() * * @param renderer_base $output * @return array */ public function get_user_menu(renderer_base $output): array { global $CFG, $USER, $PAGE; require_once($CFG->dirroot . '/user/lib.php'); $usermenudata = []; $submenusdata = []; $info = user_get_user_navigation_info($USER, $PAGE); if (isset($info->unauthenticateduser)) { $info->unauthenticateduser['content'] = get_string($info->unauthenticateduser['content']); $info->unauthenticateduser['url'] = get_login_url(); return (array) $info; } // Gather all the avatar data to be displayed in the user menu. $usermenudata['avatardata'][] = [ 'content' => $info->metadata['useravatar'], 'classes' => 'current' ]; $usermenudata['userfullname'] = $info->metadata['realuserfullname'] ?? $info->metadata['userfullname']; // Logged in as someone else. if ($info->metadata['asotheruser']) { $usermenudata['avatardata'][] = [ 'content' => $info->metadata['realuseravatar'], 'classes' => 'realuser' ]; $usermenudata['metadata'][] = [ 'content' => get_string('loggedinas', 'moodle', $info->metadata['userfullname']), 'classes' => 'viewingas' ]; } // Gather all the meta data to be displayed in the user menu. $metadata = [ 'asotherrole' => [ 'value' => 'rolename', 'class' => 'role role-##GENERATEDCLASS##', ], 'userloginfail' => [ 'value' => 'userloginfail', 'class' => 'loginfailures', ], 'asmnetuser' => [ 'value' => 'mnetidprovidername', 'class' => 'mnet mnet-##GENERATEDCLASS##', ], ]; foreach ($metadata as $key => $value) { if (!empty($info->metadata[$key])) { $content = $info->metadata[$value['value']] ?? ''; $generatedclass = strtolower(preg_replace('#[ ]+#', '-', trim($content))); $customclass = str_replace('##GENERATEDCLASS##', $generatedclass, ($value['class'] ?? '')); $usermenudata['metadata'][] = [ 'content' => $content, 'classes' => $customclass ]; } } $modifiedarray = array_map(function($value) { $value->divider = $value->itemtype == 'divider'; $value->link = $value->itemtype == 'link'; if (isset($value->pix) && !empty($value->pix)) { $value->pixicon = $value->pix; unset($value->pix); } return $value; }, $info->navitems); // Include the language menu as a submenu within the user menu. $languagemenu = new \core\output\language_menu($this->page); $langmenu = $languagemenu->export_for_template($output); if (!empty($langmenu)) { $languageitems = $langmenu['items']; // If there are available languages, generate the data for the the language selector submenu. if (!empty($languageitems)) { $langsubmenuid = uniqid(); // Generate the data for the link to language selector submenu. $language = (object) [ 'itemtype' => 'submenu-link', 'submenuid' => $langsubmenuid, 'title' => get_string('language'), 'divider' => false, 'submenulink' => true, ]; // Place the link before the 'Log out' menu item which is either the last item in the menu or // second to last when 'Switch roles' is available. $menuposition = count($modifiedarray) - 1; if (has_capability('moodle/role:switchroles', $PAGE->context)) { $menuposition = count($modifiedarray) - 2; } array_splice($modifiedarray, $menuposition, 0, [$language]); // Generate the data for the language selector submenu. $submenusdata[] = (object)[ 'id' => $langsubmenuid, 'title' => get_string('languageselector'), 'items' => $languageitems, ]; } } // Add divider before the last item. $modifiedarray[count($modifiedarray) - 2]->divider = true; $usermenudata['items'] = $modifiedarray; $usermenudata['submenus'] = array_values($submenusdata); return $usermenudata; } }