lib.php

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

/**
 * Plugin callbacks for tool_exelearning.
 *
 * @package    tool_exelearning
 * @copyright  2026 The Moodle Project
 * @license    http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
 */

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

/**
 * Adds an entry to the category settings menu so that managers can launch the
 * eXeLearning import wizard with the category preselected.
 *
 * @param navigation_node $navigation The category settings navigation node.
 * @param context $coursecategorycontext The context of the current category.
 */
function tool_exelearning_extend_navigation_category_settings(
    navigation_node $navigation,
    context $coursecategorycontext,
): void {
    if (!has_capability('tool/exelearning:use', $coursecategorycontext)) {
        return;
    }
    $title = get_string('pluginname', 'tool_exelearning');
    $url = new moodle_url('/admin/tool/exelearning/index.php', [
        'categoryid' => $coursecategorycontext->instanceid,
    ]);
    $node = navigation_node::create(
        $title,
        $url,
        navigation_node::TYPE_SETTING,
        null,
        'tool_exelearning_category',
        new pix_icon('i/course', '')
    );
    $navigation->add_node($node);
}