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/>.

/**
 * Typical crappy helper class with tiny functions.
 *
 * @package   tool_analytics
 * @copyright 2017 David Monllao {@link http://www.davidmonllao.com}
 * @license   http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
 */

namespace tool_analytics\output;

defined('MOODLE_INTERNAL') || die();

/**
 * Helper class with general purpose tiny functions.
 *
 * @package   tool_analytics
 * @copyright 2017 David Monllao {@link http://www.davidmonllao.com}
 * @license   http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
 */
class helper {

    /**
     * Converts a class full name to a select option key
     *
     * @param string $class
     * @return string
     */
    public static function class_to_option($class) {
        // Form field is PARAM_ALPHANUMEXT and we are sending fully qualified class names
        // as option names, but replacing the backslash for a string that is really unlikely
        // to ever be part of a class name.
< return str_replace('\\', '__', $class);
> return str_replace('\\', '__', $class ?? '');
} /** * option_to_class * * @param string $option * @return string */ public static function option_to_class($option) { // Really unlikely but yeah, I'm a bad booyyy. return str_replace('__', '\\', $option); } /** * Sets an analytics > analytics models > $title breadcrumb. * * @param string $title * @param \moodle_url $url * @param \context|null $context Defaults to context_system * @return null */ public static function set_navbar(string $title, \moodle_url $url, ?\context $context = null) { global $PAGE; if (!$context) { $context = \context_system::instance(); } $PAGE->set_context($context); $PAGE->set_url($url);
> $PAGE->set_secondary_active_tab('siteadminnode'); > $PAGE->set_primary_active_tab('siteadminnode');
if ($siteadmin = $PAGE->settingsnav->find('root', \navigation_node::TYPE_SITE_ADMIN)) {
< $PAGE->navbar->add($siteadmin->get_content(), $siteadmin->action());
> $PAGE->navbar->add($siteadmin->get_content(), $siteadmin->action(), > \breadcrumb_navigation_node::TYPE_SITE_ADMIN, null, 'root');
}
>
if ($analytics = $PAGE->settingsnav->find('analytics', \navigation_node::TYPE_SETTING)) { $PAGE->navbar->add($analytics->get_content(), $analytics->action()); } if ($analyticmodels = $PAGE->settingsnav->find('analyticmodels', \navigation_node::TYPE_SETTING)) { $PAGE->navbar->add($analyticmodels->get_content(), $analyticmodels->action()); } $PAGE->navbar->add($title); $PAGE->set_pagelayout('report'); $PAGE->set_title($title); $PAGE->set_heading($title); } /** * Resets the current page. * * Note that this function can only be used by analytics pages that work at the system context. * * @return null */ public static function reset_page() { global $PAGE; $PAGE->reset_theme_and_output(); $PAGE->set_context(\context_system::instance()); } /** * Convert a list of contexts to an associative array where the value is the context name. * * @param array $contexts * @param \moodle_url $url * @param \renderer_base $output * @param int|null $selected * @param bool $includeall * @param bool $shortentext * @return \stdClass */ public static function prediction_context_selector(array $contexts, \moodle_url $url, \renderer_base $output, ?int $selected = null, ?bool $includeall = false, ?bool $shortentext = true): \stdClass { foreach ($contexts as $contextid => $unused) { // We prepare this to be used as single_select template options. $context = \context::instance_by_id($contextid); // Special name for system level predictions as showing "System is not visually nice". if ($contextid == SYSCONTEXTID) { $contextname = get_string('allpredictions', 'tool_analytics'); } else { if ($shortentext) { $contextname = shorten_text($context->get_context_name(false, true), 40); } else { $contextname = $context->get_context_name(false, true); } } $contexts[$contextid] = $contextname; } if ($includeall) { $contexts[0] = get_string('all'); $nothing = ''; } else { $nothing = array('' => 'choosedots'); } \core_collator::asort($contexts); if (!$selected) { $selected = ''; } $singleselect = new \single_select($url, 'contextid', $contexts, $selected, $nothing); return $singleselect->export_for_template($output); } }