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.
/badges/ -> view.php (source)
<?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/>.

/**
 * Displays available badges to a user
 *
 * @package    core
 * @subpackage badges
 * @copyright  2012 onwards Totara Learning Solutions Ltd {@link http://www.totaralms.com/}
 * @license    http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
 * @author     Yuliya Bozhko <yuliya.bozhko@totaralms.com>
 */

require_once(__DIR__ . '/../config.php');
require_once($CFG->libdir . '/badgeslib.php');

$type       = required_param('type', PARAM_INT);
$courseid   = optional_param('id', 0, PARAM_INT);
$sortby     = optional_param('sort', 'name', PARAM_ALPHA);
$sorthow    = optional_param('dir', 'DESC', PARAM_ALPHA);
$page       = optional_param('page', 0, PARAM_INT);

require_login();

if (empty($CFG->enablebadges)) {
< print_error('badgesdisabled', 'badges');
> throw new \moodle_exception('badgesdisabled', 'badges');
} if (empty($CFG->badges_allowcoursebadges) && $courseid != 0) {
< print_error('coursebadgesdisabled', 'badges');
> throw new \moodle_exception('coursebadgesdisabled', 'badges');
} if (!in_array($sortby, array('name', 'dateissued'))) { $sortby = 'name'; } if ($sorthow != 'ASC' && $sorthow != 'DESC') { $sorthow = 'ASC'; } if ($page < 0) { $page = 0; } if ($course = $DB->get_record('course', array('id' => $courseid))) { $PAGE->set_url('/badges/view.php', array('type' => $type, 'id' => $course->id, 'sort' => $sortby, 'dir' => $sorthow)); } else { $PAGE->set_url('/badges/view.php', array('type' => $type, 'sort' => $sortby, 'dir' => $sorthow)); }
> $PAGE->add_body_class('limitedwidth'); if ($type == BADGE_TYPE_SITE) { >
$PAGE->set_context(context_system::instance()); $PAGE->set_pagelayout('admin');
< $PAGE->set_heading($SITE->fullname);
> $PAGE->set_heading(get_string('administrationsite'));
$title = get_string('sitebadges', 'badges'); $eventotherparams = array('badgetype' => BADGE_TYPE_SITE); } else { require_login($course); $coursename = format_string($course->fullname, true, array('context' => context_course::instance($course->id)));
< $title = $coursename . ': ' . get_string('coursebadges', 'badges');
> $title = get_string('coursebadges', 'badges');
$PAGE->set_context(context_course::instance($course->id)); $PAGE->set_pagelayout('incourse'); $PAGE->set_heading($coursename); $eventotherparams = array('badgetype' => BADGE_TYPE_COURSE, 'courseid' => $course->id); } require_capability('moodle/badges:viewbadges', $PAGE->context); $PAGE->set_title($title); $output = $PAGE->get_renderer('core', 'badges');
> // Display "Manage badges" button to users with proper capabilities. echo $output->header(); > $isfrontpage = (empty($courseid) || $courseid == $SITE->id); echo $OUTPUT->heading($title); > if ($isfrontpage) { > $context = context_system::instance(); $totalcount = count(badges_get_badges($type, $courseid, '', '', 0, 0, $USER->id)); > } else { $records = badges_get_badges($type, $courseid, $sortby, $sorthow, $page, BADGE_PERPAGE, $USER->id); > $context = context_course::instance($courseid); > } if ($totalcount) { > $canmanage = has_any_capability(array('moodle/badges:viewawarded', echo $output->heading(get_string('badgestoearn', 'badges', $totalcount), 4); > 'moodle/badges:createbadge', > 'moodle/badges:awardbadge', if ($course && $course->startdate > time()) { > 'moodle/badges:configurecriteria', echo $OUTPUT->box(get_string('error:notifycoursedate', 'badges'), 'generalbox notifyproblem'); > 'moodle/badges:configuremessages', } > 'moodle/badges:configuredetails', > 'moodle/badges:deletebadge'), $context); $badges = new \core_badges\output\badge_collection($records); > $badges->sort = $sortby; > if ($canmanage) { $badges->dir = $sorthow; > // Check there are non archived badges on the course. $badges->page = $page; > $allbadgescount = count(badges_get_badges($type, $courseid)); $badges->perpage = BADGE_PERPAGE; > $canmanage = ($allbadgescount > 0); $badges->totalcount = $totalcount; > } > $actionbar = new \core_badges\output\standard_action_bar($PAGE, $type, $canmanage);
echo $output->render($badges);
> echo $output->render_tertiary_navigation($actionbar);
< echo $output->heading(get_string('badgestoearn', 'badges', $totalcount), 4); <
< echo $output->notification(get_string('nobadges', 'badges'));
> echo $output->notification(get_string('nobadges', 'badges'), 'info');
< < // Display "Manage badges" button to users with proper capabilities. < $isfrontpage = (empty($courseid) || $courseid == $SITE->id); < if ($isfrontpage) { < $context = context_system::instance(); < } else { < $context = context_course::instance($courseid); < } < $canmanage = has_any_capability(array('moodle/badges:viewawarded', < 'moodle/badges:createbadge', < 'moodle/badges:awardbadge', < 'moodle/badges:configurecriteria', < 'moodle/badges:configuremessages', < 'moodle/badges:configuredetails', < 'moodle/badges:deletebadge'), $context); < if ($canmanage) { < echo $output->single_button(new moodle_url('/badges/index.php', array('type' => $type, 'id' => $courseid)), < get_string('managebadges', 'badges')); < } < < // Display "Add new badge" button to users with capability to create badges. < if (has_capability('moodle/badges:createbadge', $PAGE->context)) { < echo $output->single_button(new moodle_url('newbadge.php', array('type' => $type, 'id' => $courseid)), < get_string('newbadge', 'badges')); < } <
// Trigger event, badge listing viewed. $eventparams = array('context' => $PAGE->context, 'other' => $eventotherparams); $event = \core\event\badge_listing_viewed::create($eventparams); $event->trigger(); echo $output->footer();