Search moodle.org's
Developer Documentation

See Release Notes

  • Bug fixes for general core bugs in 4.2.x will end 22 April 2024 (12 months).
  • Bug fixes for security issues in 4.2.x will end 7 October 2024 (18 months).
  • PHP version: minimum PHP 8.0.0 Note: minimum PHP version has increased since Moodle 4.1. PHP 8.1.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/>.

/**
 * Contains class \core\output\language_menu
 *
 * @package    core
 * @category   output
 * @copyright  2021 Adrian Greeve <adrian@moodle.com>
 * @license    http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
 */

namespace core\output;

/**
 * Class for creating the language menu
 *
 * @package    core
 * @category   output
 * @copyright  2021 Adrian Greeve <adrian@moodle.com>
 * @license    http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
 */
class language_menu implements \renderable, \templatable {

< /** @var moodle_page $page the moodle page that the languague menu belongs to */
> /** @var \moodle_page $page the moodle page that the languague menu belongs to */
protected $page; /** @var string current language code */ protected $currentlang; /** @var array localised list of installed translations */ protected $langs; /** * Language menu constructor. *
< * @param moodle_page $page the moodle page that the languague menu belongs to.
> * @param \moodle_page $page the moodle page that the languague menu belongs to.
*/ public function __construct($page) { $this->page = $page; $this->currentlang = \current_language(); $this->langs = \get_string_manager()->get_list_of_translations(); } /** * Determine if the language menu should be shown. * * @return bool true if the language menu should be shown. */ protected function show_language_menu(): bool { global $CFG; if (empty($CFG->langmenu)) { return false; } if ($this->page->course != SITEID and !empty($this->page->course->lang)) { // Do not show lang menu if language forced. return false; } if (count($this->langs) < 2) { return false; } return true; } /** * Export the data. * * @param \renderer_base $output * @return array with the title for the menu and an array of items. */ public function export_for_template(\renderer_base $output): array { // Early return if a lang menu does not exists. if (!$this->show_language_menu()) { return []; } $nodes = []; $activelanguage = ''; // Add the lang picker if needed. foreach ($this->langs as $langtype => $langname) { $isactive = $langtype == $this->currentlang; $attributes = []; if (!$isactive) { // Set the lang attribute for languages different from the page's current language. $attributes[] = [ 'key' => 'lang',
< 'value' => str_replace('_', '-', $langtype),
> 'value' => get_html_lang_attribute_value($langtype),
]; } $node = [ 'title' => $langname, 'text' => $langname, 'link' => true, 'isactive' => $isactive, 'url' => $isactive ? new \moodle_url('#') : new \moodle_url($this->page->url, ['lang' => $langtype]), ]; if (!empty($attributes)) { $node['attributes'] = $attributes; } $nodes[] = $node; if ($isactive) { $activelanguage = $langname; } } return [ 'title' => $activelanguage, 'items' => $nodes, ]; } /** * Export the data providing a structure for the core/action_menu template. * * @param \renderer_base $output * @return \stdClass action_menu data export. */ public function export_for_action_menu(\renderer_base $output): ?\stdClass { $languagedata = $this->export_for_template($output); if (empty($languagedata)) { return null; } $langmenu = new \action_menu(); $menuname = \get_string('language'); if (!empty($languagedata['title'])) { $menuname = $languagedata['title']; } $langmenu->set_menu_trigger($menuname); foreach ($languagedata['items'] as $node) { $langparam = $node['url']->get_param('lang'); $attributes = []; if ($langparam) { $attributes = [ 'data-lang' => $langparam,
< 'lang' => $langparam,
> 'lang' => get_html_lang_attribute_value($langparam),
]; } $lang = new \action_menu_link_secondary($node['url'], null, $node['title'], $attributes); $langmenu->add($lang); } return $langmenu->export_for_template($output); } /** * Export the data providing a structure for the core/single_select template. * * @param \renderer_base $output * @return \stdClass single_select data export. */ public function export_for_single_select(\renderer_base $output): ?\stdClass { if (!$this->show_language_menu()) { return null; } $singleselect = new \single_select($this->page->url, 'lang', $this->langs, $this->currentlang, null); $singleselect->label = get_accesshide(\get_string('language')); $singleselect->class = 'langmenu'; return $singleselect->export_for_template($output); } }