WebSVN – Moodle – Diff – /lib/badgeslib.php

 /* Include required award criteria library. */
 require_once($CFG->dirroot . '/badges/criteria/award_criteria.php');
 /* Include required user badge exporter */
+use core_badges\external\user_badge_exporter;
+/* Include required badge class exporter */
-use core_badges\external\user_badge_exporter;
+use core_badges\external\badgeclass_exporter;
 /*
  * Number of records per page.
  * URL of backpack. Custom ones can be added.
  */
 define('BADGRIO_BACKPACKAPIURL', 'https://api.badgr.io/v2');
 define('BADGRIO_BACKPACKWEBURL', 'https://badgr.io');
-/*
+/**
+ * @deprecated since Moodle 4.5.
- * @deprecated since 3.9 (MDL-66357).
+ * @todo Final deprecation in Moodle 6.0. See MDL-82332.
- */
-define('BADGE_BACKPACKAPIURL', 'https://backpack.openbadges.org');
+ */
-define('BADGE_BACKPACKWEBURL', 'https://backpack.openbadges.org');
+define('OPEN_BADGES_V1', 1);
 /*
- * Open Badges specifications.
- */
+ * Open Badges specifications.
-define('OPEN_BADGES_V1', 1);
+ */
 define('OPEN_BADGES_V2', 2);
 define('OPEN_BADGES_V2P1', 2.1);
 define('OPEN_BADGES_V2_CONTEXT', 'https://w3id.org/openbadges/v2');
 define('OPEN_BADGES_V2_TYPE_ASSERTION', 'Assertion');
 define('OPEN_BADGES_V2_TYPE_BADGE', 'BadgeClass');
 define('OPEN_BADGES_V2_TYPE_ISSUER', 'Issuer');
 define('OPEN_BADGES_V2_TYPE_ENDORSEMENT', 'Endorsement');
-define('OPEN_BADGES_V2_TYPE_AUTHOR', 'Author');
 define('BACKPACK_MOVE_UP', -1);
 define('BACKPACK_MOVE_DOWN', 1);
+// Global badge class has been moved to the component namespace.
+class_alias('\core_badges\badge', 'badge');
 // Global badge class has been moved to the component namespace.
-class_alias('\core_badges\badge', 'badge');
+use core_badges\png_metadata_handler;
 /**
  * Sends notifications to users about awarded badges.
  * @param stdClass $badge
  * @param stdClass $user
  * @return object
  */
 function badges_prepare_badge_for_external(stdClass $badge, stdClass $user): object {
-    global $PAGE, $USER;
+    global $PAGE, $SITE, $USER;
     if ($badge->type == BADGE_TYPE_SITE) {
         $context = context_system::instance();
     } else {
         $context = context_course::instance($badge->courseid);
+    }
             'uniquehash'    => $badge->uniquehash,
             'dateissued'    => $badge->dateissued,
             'dateexpire'    => $badge->dateexpire,
             'version'       => $badge->version,
             'language'      => $badge->language,
-            'imageauthorname'  => $badge->imageauthorname,
-            'imageauthoremail' => $badge->imageauthoremail,
-            'imageauthorurl'   => $badge->imageauthorurl,
             'imagecaption'     => $badge->imagecaption,
         ];
+    }
+    // Course.
+    if ($badge->type == BADGE_TYPE_COURSE) {
+        $course = get_course($context->instanceid);
+        $badge->coursefullname = \core_external\util::format_string($course->fullname, $context);
+    }
+    // Recipient (the badge was awarded to this person).
+    $badge->recipientid = $user->id;
+    if ($user->deleted) {
+        $strdata = new stdClass();
+        $strdata->user = fullname($user);
+        $strdata->site = format_string($SITE->fullname, true, ['context' => context_system::instance()]);
+        $badge->recipientfullname = get_string('error:userdeleted', 'badges', $strdata);
+    } else {
+        $badge->recipientfullname = fullname($user);
+    }
     // Create a badge instance to be able to get the endorsement and other info.
     $badgeinstance = new badge($badge->id);
-    $endorsement   = $badgeinstance->get_endorsement();
-    $alignments    = $badgeinstance->get_alignments();
+    $endorsement   = $badgeinstance->get_endorsement();
+    $relatedbadges = $badgeinstance->get_related_badges();
+    $alignments    = [];
+    foreach ($badgeinstance->get_alignments() as $alignment) {
+        $alignmentobj = (object) [
+            'id' => $alignment->id,
+            'badgeid' => $alignment->badgeid,
+            'targetName' => $alignment->targetname,
+            'targetUrl' => $alignment->targeturl,
+        ];
+        // Include only the properties visible by the user.
+        if ($canconfiguredetails) {
+            $alignmentobj->targetDescription = $alignment->targetdescription;
+            $alignmentobj->targetFramework = $alignment->targetframework;
+            $alignmentobj->targetCode = $alignment->targetcode;
+        }
+        $alignments[] = $alignmentobj;
     $relatedbadges = $badgeinstance->get_related_badges();
-    if (!$canconfiguredetails) {
-        // Return only the properties visible by the user.
-        if (!empty($alignments)) {
-            foreach ($alignments as $alignment) {
-                unset($alignment->targetdescription);
-                unset($alignment->targetframework);
-                unset($alignment->targetcode);
-            }
     if (!$canconfiguredetails) {
         // Return only the properties visible by the user.
         if (!empty($relatedbadges)) {
             foreach ($relatedbadges as $relatedbadge) {
                 unset($relatedbadge->version);
     $exporter = new user_badge_exporter($badge, $related);
     return $exporter->export($PAGE->get_renderer('core'));
+}
+/**
+ * Prepare badgeclass for external functions.
+ * @param core_badges\output\badgeclass $badgeclass
+ * @return stdClass
+ */
+function badges_prepare_badgeclass_for_external(core_badges\output\badgeclass $badgeclass): stdClass {
+    global $PAGE;
+    $context = $badgeclass->context;
+    $canconfiguredetails = has_capability('moodle/badges:configuredetails', $context);
+    $badgeurl = new \moodle_url('/badges/badgeclass.php', [
+        'id' => $badgeclass->badge->id,
+    ]);
+    $badgeurl = $badgeurl->out(false);
+    $file = \moodle_url::make_webservice_pluginfile_url(
+        $badgeclass->context->id,
+        'badges',
+        'badgeimage',
+        $badgeclass->badge->id,
+        '/',
+        'f3'
+    );
+    $image = $file->out(false);
+    $badge = (object) [
+        'id'            => $badgeurl,
+        'name'          => $badgeclass->badge->name,
+        'type'          => OPEN_BADGES_V2_TYPE_BADGE,
+        'description'   => $badgeclass->badge->description,
+        'issuer'        => $badgeclass->badge->issuername,
+        'hostedUrl'     => $badgeclass->badge->issuerurl,
+        'image'         => $image,
+    ];
+    // Course.
+    if ($badgeclass->badge->type == BADGE_TYPE_COURSE) {
+        $course = get_course($badgeclass->badge->courseid);
+        $badge->coursefullname = \core_external\util::format_string($course->fullname, $context);
+        if ($canconfiguredetails) {
+            $badge->courseid = $course->id;
+        }
+    }
+    // Create a badge instance to be able to get the endorsement and other info.
+    $badgeinstance = new badge($badgeclass->badge->id);
+    $endorsement   = $badgeinstance->get_endorsement();
+    $relatedbadges = $badgeinstance->get_related_badges();
+    $alignments = [];
+    foreach ($badgeinstance->get_alignments() as $alignment) {
+        $alignmentobj = (object) [
+            'id' => $alignment->id,
+            'badgeid' => $alignment->badgeid,
+            'targetName' => $alignment->targetname,
+            'targetUrl' => $alignment->targeturl,
+        ];
+        // Include only the properties visible by the user.
+        if ($canconfiguredetails) {
+            $alignmentobj->targetDescription = $alignment->targetdescription;
+            $alignmentobj->targetFramework = $alignment->targetframework;
+            $alignmentobj->targetCode = $alignment->targetcode;
+        }
+        $alignments[] = $alignmentobj;
+    }
+    if (!$canconfiguredetails) {
+        // Return only the properties visible by the user.
+        if (!empty($relatedbadges)) {
+            foreach ($relatedbadges as $relatedbadge) {
+                unset($relatedbadge->version);
+                unset($relatedbadge->language);
+                unset($relatedbadge->type);
+            }
+        }
+    }
+    $related = [
+        'context'       => $context,
+        'endorsement'   => $endorsement ? $endorsement : null,
+        'relatedbadges' => $relatedbadges,
+    ];
+    if (!empty($alignments)) {
+        $related['alignment'] = $alignments;
+    }
+    $exporter = new badgeclass_exporter($badge, $related);
+    return $exporter->export($PAGE->get_renderer('core', 'badges'));
+}
 /**
  * Extends the course administration navigation with the Badges page
+ *
  * @param navigation_node $coursenode
  * @param object $course
         $coursenode->get('coursebadges')->add(get_string('managebadges', 'badges'), $url,
             navigation_node::TYPE_SETTING, null, 'coursebadges');
         if (has_capability('moodle/badges:createbadge', $coursecontext)) {
-            $url = new moodle_url('/badges/newbadge.php', array('type' => BADGE_TYPE_COURSE, 'id' => $course->id));
+            $url = new moodle_url('/badges/edit.php', ['action' => 'new', 'courseid' => $course->id]);
             $coursenode->get('coursebadges')->add(get_string('newbadge', 'badges'), $url,
     require_once($CFG->libdir. '/gdlib.php');
     if (!empty($CFG->gdversion)) {
         process_new_icon($badge->get_context(), 'badges', 'badgeimage', $badge->id, $iconfile, true);
-        @unlink($iconfile);
-        // Clean up file draft area after badge image has been saved.
-        $context = context_user::instance($USER->id, MUST_EXIST);
-        $fs = get_file_storage();
-        $fs->delete_area_files($context->id, 'user', 'draft');
+        @unlink($iconfile);
+    }
+}
  * @param boolean $pathhash Return file pathhash instead of image url (optional).
  * @return string|moodle_url|null Returns either new file path hash or new file URL
  */
 function badges_bake($hash, $badgeid, $userid = 0, $pathhash = false) {
     global $CFG, $USER;
-    require_once(__DIR__ . '/../badges/lib/bakerlib.php');
     $badge = new badge($badgeid);
     $badge_context = $badge->get_context();
     $userid = ($userid) ? $userid : $USER->id;
     $fs = get_file_storage();
     if (!$fs->file_exists($user_context->id, 'badges', 'userbadge', $badge->id, '/', $hash . '.png')) {
         if ($file = $fs->get_file($badge_context->id, 'badges', 'badgeimage', $badge->id, '/', 'f3.png')) {
             $contents = $file->get_content();
-            $filehandler = new PNG_MetaDataHandler($contents);
+            $filehandler = new png_metadata_handler($contents);
             // For now, the site backpack OB version will be used as default.
             $obversion = badges_open_badges_backpack_api();
             $assertion = new core_badges_assertion($hash, $obversion);
             $assertionjson = json_encode($assertion->get_badge_assertion());
+ *
  * @return array(version)
  */
 function badges_get_badge_api_versions() {
     return [
-        (string)OPEN_BADGES_V1 => get_string('openbadgesv1', 'badges'),
         (string)OPEN_BADGES_V2 => get_string('openbadgesv2', 'badges'),
         (string)OPEN_BADGES_V2P1 => get_string('openbadgesv2p1', 'badges')
     ];
+}

Proyectos de Subversion Moodle

(root)/lib/badgeslib.php – Rev 1 → 1441