<?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/>.
/**
* External badge renderable.
*
* @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>
*/
namespace core_badges\output;
defined('MOODLE_INTERNAL') || die();
require_once($CFG->libdir . '/badgeslib.php');
use renderable;
> use renderer_base;
> use stdClass;
/**
* An external badges for external.php page
*
* @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
*/
class external_badge implements renderable {
< /** @var issued badge */
> /** @var stdClass Issued badge */
public $issued;
< /** @var User ID */
> /** @var int User ID */
public $recipient;
< /** @var validation of external badge */
> /** @var bool Validation of external badge */
public $valid = true;
/**
* Initializes the badge to display
*
< * @param object $badge External badge information.
> * @param stdClass $badge External badge information.
* @param int $recipient User id.
*/
public function __construct($badge, $recipient) {
global $DB;
// At this point a user has connected a backpack. So, we are going to get
// their backpack email rather than their account email.
< $namefields = get_all_user_name_fields(true, 'u');
> $userfieldsapi = \core_user\fields::for_name();
> $namefields = $userfieldsapi->get_sql('u', false, '', '', false)->selects;
$user = $DB->get_record_sql("SELECT {$namefields}, b.email
FROM {user} u INNER JOIN {badge_backpack} b ON u.id = b.userid
WHERE b.userid = :userid", array('userid' => $recipient), IGNORE_MISSING);
$this->issued = $badge;
$this->recipient = $user;
// Check if recipient is valid.
// There is no way to be 100% sure that a badge belongs to a user.
// Backpack does not return any recipient information.
// All we can do is compare that backpack email hashed using salt
// provided in the assertion matches a badge recipient from the assertion.
if ($user) {
if (isset($badge->assertion->recipient->identity)) {
$badge->assertion->salt = $badge->assertion->recipient->salt;
$badge->assertion->recipient = $badge->assertion->recipient->identity;
}
// Open Badges V2 does not even include a recipient.
if (!isset($badge->assertion->recipient)) {
$this->valid = false;
} else if (validate_email($badge->assertion->recipient) && $badge->assertion->recipient == $user->email) {
// If we have email, compare emails.
$this->valid = true;
} else if ($badge->assertion->recipient == 'sha256$' . hash('sha256', $user->email)) {
// If recipient is hashed, but no salt, compare hashes without salt.
$this->valid = true;
} else if ($badge->assertion->recipient == 'sha256$' . hash('sha256', $user->email . $badge->assertion->salt)) {
// If recipient is hashed, compare hashes.
$this->valid = true;
} else {
// Otherwise, we cannot be sure that this user is a recipient.
$this->valid = false;
}
} else {
$this->valid = false;
}
}
>
}
> /**
> * Export this data so it can be used as the context for a mustache template.
> *
> * @param renderer_base $output Renderer base.
> * @return stdClass
> */
> public function export_for_template(renderer_base $output): stdClass {
> $data = new stdClass();
>
> $now = time();
> if (isset($this->issued->assertion->expires)) {
> if (!is_numeric($this->issued->assertion->expires)) {
> $this->issued->assertion->expires = strtotime($this->issued->assertion->expires);
> }
> $expiration = $this->issued->assertion->expires;
> } else {
> $expiration = $now + 86400;
> // Field: Image.
> if (isset($this->issued->imageUrl)) {
> $this->issued->image = $this->issued->imageUrl;
> }
> $data->badgeimage = $this->issued->image;
> if (is_object($data->badgeimage)) {
> if (!empty($data->badgeimage->author)) {
> $data->hasotherfields = true;
> $data->imageauthorname = $data->badgeimage->author;
> }
> if (!empty($data->badgeimage->caption)) {
> $data->hasotherfields = true;
> $data->imagecaption = $data->badgeimage->caption;
> }
> $data->badgeimage = $data->badgeimage->id;
> }
>
> // Field: Expiration date.
> if (isset($this->issued->assertion->expires)) {
> if ($expiration < $now) {
> $data->expireddate = $this->issued->assertion->expires;
> $data->expireddateformatted = userdate(
> $this->issued->assertion->expires,
> get_string('strftimedatetime', 'langconfig')
> );
> } else {
> $data->expiredate = $this->issued->assertion->expires;
> }
> }
>
> // Fields: Name, description, issuedOn.
> $data->badgename = $this->issued->assertion->badge->name;
> $data->badgedescription = $this->issued->assertion->badge->description;
> if (isset($this->issued->assertion->issued_on)) {
> if (!is_numeric($this->issued->assertion->issued_on)) {
> $this->issued->assertion->issued_on = strtotime($this->issued->assertion->issued_on);
> }
> $data->badgeissuedon = $this->issued->assertion->issued_on;
> }
>
> // Field: Recipient (the badge was awarded to this person).
> $data->recipientname = fullname($this->recipient);
> if (!$this->valid) {
> $data->recipientnotification = new stdClass();
> $data->recipientnotification->message = get_string('recipientvalidationproblem', 'badges');
> }
>
> // Field: Criteria.
> if (isset($this->issued->assertion->badgeclass->criteria->narrative)) {
> $data->criteria = $this->issued->assertion->badgeclass->criteria->narrative;
> }
>
> // Field: Issuer.
> $data->issuedby = $this->issued->issuer->name;
> if (isset($this->issued->issuer->contact) && !empty($this->issued->issuer->contact)) {
> $data->issuedbyemailobfuscated = obfuscate_mailto($this->issued->issuer->contact, $data->issuedby);
> }
>
> // Field: Hosted URL.
> if (isset($this->issued->hostedUrl) && !empty($this->issued->hostedUrl)) {
> $data->hostedurl = $this->issued->hostedUrl;
> }
>
> return $data;
> }
> }