Search moodle.org's
Developer Documentation
Developer Documentation
- Bug fixes for general core bugs in 3.11.x will end 14 Nov 2022 (12 months plus 6 months extension).
- Bug fixes for security issues in 3.11.x will end 13 Nov 2023 (18 months plus 12 months extension).
- PHP version: minimum PHP 7.3.0 Note: minimum PHP version has increased since Moodle 3.10. PHP 7.4.x is supported too.
/badges/ -> renderer.php (source)
Differences Between: [Versions 310 and 311] [Versions 311 and 400] [Versions 311 and 401] [Versions 311 and 402] [Versions 311 and 403] [Versions 39 and 311]
1 <?php 2 // This file is part of Moodle - http://moodle.org/ 3 // 4 // Moodle is free software: you can redistribute it and/or modify 5 // it under the terms of the GNU General Public License as published by 6 // the Free Software Foundation, either version 3 of the License, or 7 // (at your option) any later version. 8 // 9 // Moodle is distributed in the hope that it will be useful, 10 // but WITHOUT ANY WARRANTY; without even the implied warranty of 11 // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the 12 // GNU General Public License for more details. 13 // 14 // You should have received a copy of the GNU General Public License 15 // along with Moodle. If not, see <http://www.gnu.org/licenses/>. 16 17 /** 18 * Renderer for use with the badges output 19 * 20 * @package core 21 * @subpackage badges 22 * @copyright 2012 onwards Totara Learning Solutions Ltd {@link http://www.totaralms.com/} 23 * @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later 24 * @author Yuliya Bozhko <yuliya.bozhko@totaralms.com> 25 */ 26 27 defined('MOODLE_INTERNAL') || die(); 28 29 require_once($CFG->libdir . '/badgeslib.php'); 30 require_once($CFG->libdir . '/tablelib.php'); 31 32 /** 33 * Standard HTML output renderer for badges 34 */ 35 class core_badges_renderer extends plugin_renderer_base { 36 37 // Outputs badges list. 38 public function print_badges_list($badges, $userid, $profile = false, $external = false) { 39 global $USER, $CFG; 40 foreach ($badges as $badge) { 41 if (!$external) { 42 $context = ($badge->type == BADGE_TYPE_SITE) ? context_system::instance() : context_course::instance($badge->courseid); 43 $bname = $badge->name; 44 $imageurl = moodle_url::make_pluginfile_url($context->id, 'badges', 'badgeimage', $badge->id, '/', 'f3', false); 45 } else { 46 $bname = ''; 47 $imageurl = ''; 48 if (!empty($badge->name)) { 49 $bname = s($badge->name); 50 } 51 if (!empty($badge->image)) { 52 if (is_object($badge->image)) { 53 if (!empty($badge->image->caption)) { 54 $badge->imagecaption = $badge->image->caption; 55 } 56 $imageurl = $badge->image->id; 57 } else { 58 $imageurl = $badge->image; 59 } 60 } 61 if (isset($badge->assertion->badge->name)) { 62 $bname = s($badge->assertion->badge->name); 63 } 64 if (isset($badge->imageUrl)) { 65 $imageurl = $badge->imageUrl; 66 } 67 } 68 69 $name = html_writer::tag('span', $bname, array('class' => 'badge-name')); 70 71 $imagecaption = $badge->imagecaption ?? ''; 72 $image = html_writer::empty_tag('img', ['src' => $imageurl, 'class' => 'badge-image', 'alt' => $imagecaption]); 73 if (!empty($badge->dateexpire) && $badge->dateexpire < time()) { 74 $image .= $this->output->pix_icon('i/expired', 75 get_string('expireddate', 'badges', userdate($badge->dateexpire)), 76 'moodle', 77 array('class' => 'expireimage')); 78 $name .= '(' . get_string('expired', 'badges') . ')'; 79 } 80 81 $download = $status = $push = ''; 82 if (($userid == $USER->id) && !$profile) { 83 $params = array( 84 'download' => $badge->id, 85 'hash' => $badge->uniquehash, 86 'sesskey' => sesskey() 87 ); 88 $url = new moodle_url( 89 'mybadges.php', 90 $params 91 ); 92 $notexpiredbadge = (empty($badge->dateexpire) || $badge->dateexpire > time()); 93 $userbackpack = badges_get_user_backpack(); 94 if (!empty($CFG->badges_allowexternalbackpack) && $notexpiredbadge && $userbackpack) { 95 $assertion = new moodle_url('/badges/assertion.php', array('b' => $badge->uniquehash)); 96 $icon = new pix_icon('t/backpack', get_string('addtobackpack', 'badges')); 97 if (badges_open_badges_backpack_api($userbackpack->id) == OPEN_BADGES_V2) { 98 $addurl = new moodle_url('/badges/backpack-add.php', array('hash' => $badge->uniquehash)); 99 $push = $this->output->action_icon($addurl, $icon); 100 } else if (badges_open_badges_backpack_api($userbackpack->id) == OPEN_BADGES_V2P1) { 101 $addurl = new moodle_url('/badges/backpack-export.php', array('hash' => $badge->uniquehash)); 102 $push = $this->output->action_icon($addurl, $icon); 103 } 104 } 105 106 $download = $this->output->action_icon($url, new pix_icon('t/download', get_string('download'))); 107 if ($badge->visible) { 108 $url = new moodle_url('mybadges.php', array('hide' => $badge->issuedid, 'sesskey' => sesskey())); 109 $status = $this->output->action_icon($url, new pix_icon('t/hide', get_string('makeprivate', 'badges'))); 110 } else { 111 $url = new moodle_url('mybadges.php', array('show' => $badge->issuedid, 'sesskey' => sesskey())); 112 $status = $this->output->action_icon($url, new pix_icon('t/show', get_string('makepublic', 'badges'))); 113 } 114 } 115 116 if (!$profile) { 117 $url = new moodle_url('badge.php', array('hash' => $badge->uniquehash)); 118 } else { 119 if (!$external) { 120 $url = new moodle_url('/badges/badge.php', array('hash' => $badge->uniquehash)); 121 } else { 122 $hash = hash('md5', $badge->hostedUrl); 123 $url = new moodle_url('/badges/external.php', array('hash' => $hash, 'user' => $userid)); 124 } 125 } 126 $actions = html_writer::tag('div', $push . $download . $status, array('class' => 'badge-actions')); 127 $items[] = html_writer::link($url, $image . $actions . $name, array('title' => $bname)); 128 } 129 130 return html_writer::alist($items, array('class' => 'badges')); 131 } 132 133 // Recipients selection form. 134 public function recipients_selection_form(user_selector_base $existinguc, user_selector_base $potentialuc) { 135 $output = ''; 136 $formattributes = array(); 137 $formattributes['id'] = 'recipientform'; 138 $formattributes['action'] = $this->page->url; 139 $formattributes['method'] = 'post'; 140 $output .= html_writer::start_tag('form', $formattributes); 141 $output .= html_writer::empty_tag('input', array('type' => 'hidden', 'name' => 'sesskey', 'value' => sesskey())); 142 143 $existingcell = new html_table_cell(); 144 $existingcell->text = $existinguc->display(true); 145 $existingcell->attributes['class'] = 'existing'; 146 $actioncell = new html_table_cell(); 147 $actioncell->text = html_writer::start_tag('div', array()); 148 $actioncell->text .= html_writer::empty_tag('input', array( 149 'type' => 'submit', 150 'name' => 'award', 151 'value' => $this->output->larrow() . ' ' . get_string('award', 'badges'), 152 'class' => 'actionbutton btn btn-secondary') 153 ); 154 $actioncell->text .= html_writer::empty_tag('input', array( 155 'type' => 'submit', 156 'name' => 'revoke', 157 'value' => get_string('revoke', 'badges') . ' ' . $this->output->rarrow(), 158 'class' => 'actionbutton btn btn-secondary') 159 ); 160 $actioncell->text .= html_writer::end_tag('div', array()); 161 $actioncell->attributes['class'] = 'actions'; 162 $potentialcell = new html_table_cell(); 163 $potentialcell->text = $potentialuc->display(true); 164 $potentialcell->attributes['class'] = 'potential'; 165 166 $table = new html_table(); 167 $table->attributes['class'] = 'recipienttable boxaligncenter'; 168 $table->data = array(new html_table_row(array($existingcell, $actioncell, $potentialcell))); 169 $output .= html_writer::table($table); 170 171 $output .= html_writer::end_tag('form'); 172 return $output; 173 } 174 175 // Prints a badge overview infomation. 176 public function print_badge_overview($badge, $context) { 177 $display = ""; 178 $languages = get_string_manager()->get_list_of_languages(); 179 180 // Badge details. 181 $display .= $this->heading(get_string('badgedetails', 'badges'), 3); 182 $dl = array(); 183 $dl[get_string('name')] = $badge->name; 184 $dl[get_string('version', 'badges')] = $badge->version; 185 $dl[get_string('language')] = $languages[$badge->language]; 186 $dl[get_string('description', 'badges')] = $badge->description; 187 $dl[get_string('createdon', 'search')] = userdate($badge->timecreated); 188 $dl[get_string('badgeimage', 'badges')] = print_badge_image($badge, $context, 'large'); 189 $dl[get_string('imageauthorname', 'badges')] = $badge->imageauthorname; 190 $dl[get_string('imageauthoremail', 'badges')] = 191 html_writer::tag('a', $badge->imageauthoremail, array('href' => 'mailto:' . $badge->imageauthoremail)); 192 $dl[get_string('imageauthorurl', 'badges')] = 193 html_writer::link($badge->imageauthorurl, $badge->imageauthorurl, array('target' => '_blank')); 194 $dl[get_string('imagecaption', 'badges')] = $badge->imagecaption; 195 $display .= $this->definition_list($dl); 196 197 // Issuer details. 198 $display .= $this->heading(get_string('issuerdetails', 'badges'), 3); 199 $dl = array(); 200 $dl[get_string('issuername', 'badges')] = $badge->issuername; 201 $dl[get_string('contact', 'badges')] = html_writer::tag('a', $badge->issuercontact, array('href' => 'mailto:' . $badge->issuercontact)); 202 $display .= $this->definition_list($dl); 203 204 // Issuance details if any. 205 $display .= $this->heading(get_string('issuancedetails', 'badges'), 3); 206 if ($badge->can_expire()) { 207 if ($badge->expiredate) { 208 $display .= get_string('expiredate', 'badges', userdate($badge->expiredate)); 209 } else if ($badge->expireperiod) { 210 if ($badge->expireperiod < 60) { 211 $display .= get_string('expireperiods', 'badges', round($badge->expireperiod, 2)); 212 } else if ($badge->expireperiod < 60 * 60) { 213 $display .= get_string('expireperiodm', 'badges', round($badge->expireperiod / 60, 2)); 214 } else if ($badge->expireperiod < 60 * 60 * 24) { 215 $display .= get_string('expireperiodh', 'badges', round($badge->expireperiod / 60 / 60, 2)); 216 } else { 217 $display .= get_string('expireperiod', 'badges', round($badge->expireperiod / 60 / 60 / 24, 2)); 218 } 219 } 220 } else { 221 $display .= get_string('noexpiry', 'badges'); 222 } 223 224 // Criteria details if any. 225 $display .= $this->heading(get_string('bcriteria', 'badges'), 3); 226 if ($badge->has_criteria()) { 227 $display .= self::print_badge_criteria($badge); 228 } else { 229 $display .= get_string('nocriteria', 'badges'); 230 if (has_capability('moodle/badges:configurecriteria', $context)) { 231 $display .= $this->output->single_button( 232 new moodle_url('/badges/criteria.php', array('id' => $badge->id)), 233 get_string('addcriteria', 'badges'), 'POST', array('class' => 'activatebadge')); 234 } 235 } 236 237 // Awards details if any. 238 if (has_capability('moodle/badges:viewawarded', $context)) { 239 $display .= $this->heading(get_string('awards', 'badges'), 3); 240 if ($badge->has_awards()) { 241 $url = new moodle_url('/badges/recipients.php', array('id' => $badge->id)); 242 $a = new stdClass(); 243 $a->link = $url->out(); 244 $a->count = count($badge->get_awards()); 245 $display .= get_string('numawards', 'badges', $a); 246 } else { 247 $display .= get_string('noawards', 'badges'); 248 } 249 250 if (has_capability('moodle/badges:awardbadge', $context) && 251 $badge->has_manual_award_criteria() && 252 $badge->is_active()) { 253 $display .= $this->output->single_button( 254 new moodle_url('/badges/award.php', array('id' => $badge->id)), 255 get_string('award', 'badges'), 'POST', array('class' => 'activatebadge')); 256 } 257 } 258 259 $display .= self::print_badge_endorsement($badge); 260 $display .= self::print_badge_related($badge); 261 $display .= self::print_badge_alignments($badge); 262 263 return html_writer::div($display, null, array('id' => 'badge-overview')); 264 } 265 266 // Prints action icons for the badge. 267 public function print_badge_table_actions($badge, $context) { 268 $actions = ""; 269 270 if (has_capability('moodle/badges:configuredetails', $context) && $badge->has_criteria()) { 271 // Activate/deactivate badge. 272 if ($badge->status == BADGE_STATUS_INACTIVE || $badge->status == BADGE_STATUS_INACTIVE_LOCKED) { 273 // "Activate" will go to another page and ask for confirmation. 274 $url = new moodle_url('/badges/action.php'); 275 $url->param('id', $badge->id); 276 $url->param('activate', true); 277 $url->param('sesskey', sesskey()); 278 $return = new moodle_url(qualified_me()); 279 $url->param('return', $return->out_as_local_url(false)); 280 $actions .= $this->output->action_icon($url, new pix_icon('t/show', get_string('activate', 'badges'))) . " "; 281 } else { 282 $url = new moodle_url(qualified_me()); 283 $url->param('lock', $badge->id); 284 $url->param('sesskey', sesskey()); 285 $actions .= $this->output->action_icon($url, new pix_icon('t/hide', get_string('deactivate', 'badges'))) . " "; 286 } 287 } 288 289 // Award badge manually. 290 if ($badge->has_manual_award_criteria() && 291 has_capability('moodle/badges:awardbadge', $context) && 292 $badge->is_active()) { 293 $url = new moodle_url('/badges/award.php', array('id' => $badge->id)); 294 $actions .= $this->output->action_icon($url, new pix_icon('t/award', get_string('award', 'badges'))) . " "; 295 } 296 297 // Edit badge. 298 if (has_capability('moodle/badges:configuredetails', $context)) { 299 $url = new moodle_url('/badges/edit.php', array('id' => $badge->id, 'action' => 'badge')); 300 $actions .= $this->output->action_icon($url, new pix_icon('t/edit', get_string('edit'))) . " "; 301 } 302 303 // Duplicate badge. 304 if (has_capability('moodle/badges:createbadge', $context)) { 305 $url = new moodle_url('/badges/action.php', array('copy' => '1', 'id' => $badge->id, 'sesskey' => sesskey())); 306 $actions .= $this->output->action_icon($url, new pix_icon('t/copy', get_string('copy'))) . " "; 307 } 308 309 // Delete badge. 310 if (has_capability('moodle/badges:deletebadge', $context)) { 311 $url = new moodle_url(qualified_me()); 312 $url->param('delete', $badge->id); 313 $actions .= $this->output->action_icon($url, new pix_icon('t/delete', get_string('delete'))) . " "; 314 } 315 316 return $actions; 317 } 318 319 /** 320 * Render an issued badge. 321 * 322 * @param \core_badges\output\issued_badge $ibadge 323 * @return string 324 */ 325 protected function render_issued_badge(\core_badges\output\issued_badge $ibadge) { 326 $data = $ibadge->export_for_template($this); 327 return parent::render_from_template('core_badges/issued_badge', $data); 328 } 329 330 /** 331 * Render an issued badge. 332 * 333 * @param \core_badges\output\badgeclass $badge 334 * @return string 335 */ 336 protected function render_badgeclass(\core_badges\output\badgeclass $badge) { 337 $data = $badge->export_for_template($this); 338 return parent::render_from_template('core_badges/issued_badge', $data); 339 } 340 341 /** 342 * Render an external badge. 343 * 344 * @param \core_badges\output\external_badge $ibadge 345 * @return string 346 */ 347 protected function render_external_badge(\core_badges\output\external_badge $ibadge) { 348 $data = $ibadge->export_for_template($this); 349 return parent::render_from_template('core_badges/issued_badge', $data); 350 } 351 352 /** 353 * Render a collection of user badges. 354 * 355 * @param \core_badges\output\badge_user_collection $badges 356 * @return string 357 */ 358 protected function render_badge_user_collection(\core_badges\output\badge_user_collection $badges) { 359 global $CFG, $USER, $SITE; 360 $backpack = $badges->backpack; 361 $mybackpack = new moodle_url('/badges/mybackpack.php'); 362 363 $paging = new paging_bar($badges->totalcount, $badges->page, $badges->perpage, $this->page->url, 'page'); 364 $htmlpagingbar = $this->render($paging); 365 366 // Set backpack connection string. 367 $backpackconnect = ''; 368 if (!empty($CFG->badges_allowexternalbackpack) && is_null($backpack)) { 369 $backpackconnect = $this->output->box(get_string('localconnectto', 'badges', $mybackpack->out()), 'noticebox'); 370 } 371 // Search box. 372 $searchform = $this->output->box($this->helper_search_form($badges->search), 'boxwidthwide boxaligncenter'); 373 374 // Download all button. 375 $actionhtml = $this->output->single_button( 376 new moodle_url('/badges/mybadges.php', array('downloadall' => true, 'sesskey' => sesskey())), 377 get_string('downloadall'), 'POST', array('class' => 'activatebadge')); 378 $downloadall = $this->output->box('', 'col-md-3'); 379 $downloadall .= $this->output->box($actionhtml, 'col-md-9'); 380 $downloadall = $this->output->box($downloadall, 'row ml-5'); 381 382 // Local badges. 383 $localhtml = html_writer::start_tag('div', array('id' => 'issued-badge-table', 'class' => 'generalbox')); 384 $sitename = format_string($SITE->fullname, true, array('context' => context_system::instance())); 385 $heading = get_string('localbadges', 'badges', $sitename); 386 $localhtml .= $this->output->heading_with_help($heading, 'localbadgesh', 'badges'); 387 if ($badges->badges) { 388 $countmessage = $this->output->box(get_string('badgesearned', 'badges', $badges->totalcount)); 389 390 $htmllist = $this->print_badges_list($badges->badges, $USER->id); 391 $localhtml .= $backpackconnect . $countmessage . $searchform; 392 $localhtml .= $htmlpagingbar . $htmllist . $htmlpagingbar . $downloadall; 393 } else { 394 $localhtml .= $searchform . $this->output->notification(get_string('nobadges', 'badges')); 395 } 396 $localhtml .= html_writer::end_tag('div'); 397 398 // External badges. 399 $externalhtml = ""; 400 if (!empty($CFG->badges_allowexternalbackpack)) { 401 $externalhtml .= html_writer::start_tag('div', array('class' => 'generalbox')); 402 $externalhtml .= $this->output->heading_with_help(get_string('externalbadges', 'badges'), 'externalbadges', 'badges'); 403 if (!is_null($backpack)) { 404 if ($backpack->totalcollections == 0) { 405 $externalhtml .= get_string('nobackpackcollectionssummary', 'badges', $backpack); 406 } else { 407 if ($backpack->totalbadges == 0) { 408 $externalhtml .= get_string('nobackpackbadgessummary', 'badges', $backpack); 409 } else { 410 $externalhtml .= get_string('backpackbadgessummary', 'badges', $backpack); 411 $externalhtml .= '<br/><br/>' . $this->print_badges_list($backpack->badges, $USER->id, true, true); 412 } 413 } 414 } else { 415 $externalhtml .= get_string('externalconnectto', 'badges', $mybackpack->out()); 416 } 417 418 $externalhtml .= html_writer::end_tag('div'); 419 $attr = ['class' => 'btn btn-secondary']; 420 $label = get_string('backpackbadgessettings', 'badges'); 421 $backpacksettings = html_writer::link(new moodle_url('/badges/mybackpack.php'), $label, $attr); 422 $actionshtml = $this->output->box('', 'col-md-3'); 423 $actionshtml .= $this->output->box($backpacksettings, 'col-md-9'); 424 $actionshtml = $this->output->box($actionshtml, 'row ml-5'); 425 $externalhtml .= $actionshtml; 426 } 427 428 return $localhtml . $externalhtml; 429 } 430 431 /** 432 * Render a collection of badges. 433 * 434 * @param \core_badges\output\badge_collection $badges 435 * @return string 436 */ 437 protected function render_badge_collection(\core_badges\output\badge_collection $badges) { 438 $paging = new paging_bar($badges->totalcount, $badges->page, $badges->perpage, $this->page->url, 'page'); 439 $htmlpagingbar = $this->render($paging); 440 $table = new html_table(); 441 $table->attributes['class'] = 'table table-bordered table-striped'; 442 443 $sortbyname = $this->helper_sortable_heading(get_string('name'), 444 'name', $badges->sort, $badges->dir); 445 $sortbyawarded = $this->helper_sortable_heading(get_string('awardedtoyou', 'badges'), 446 'dateissued', $badges->sort, $badges->dir); 447 $table->head = array( 448 get_string('badgeimage', 'badges'), 449 $sortbyname, 450 get_string('description', 'badges'), 451 get_string('bcriteria', 'badges'), 452 $sortbyawarded 453 ); 454 $table->colclasses = array('badgeimage', 'name', 'description', 'criteria', 'awards'); 455 456 foreach ($badges->badges as $badge) { 457 $badgeimage = print_badge_image($badge, $this->page->context, 'large'); 458 $name = $badge->name; 459 $description = $badge->description; 460 $criteria = self::print_badge_criteria($badge); 461 if ($badge->dateissued) { 462 $icon = new pix_icon('i/valid', 463 get_string('dateearned', 'badges', 464 userdate($badge->dateissued, get_string('strftimedatefullshort', 'core_langconfig')))); 465 $badgeurl = new moodle_url('/badges/badge.php', array('hash' => $badge->uniquehash)); 466 $awarded = $this->output->action_icon($badgeurl, $icon, null, null, true); 467 } else { 468 $awarded = ""; 469 } 470 $row = array($badgeimage, $name, $description, $criteria, $awarded); 471 $table->data[] = $row; 472 } 473 474 $htmltable = html_writer::table($table); 475 476 return $htmlpagingbar . $htmltable . $htmlpagingbar; 477 } 478 479 /** 480 * Render a table of badges. 481 * 482 * @param \core_badges\output\badge_management $badges 483 * @return string 484 */ 485 protected function render_badge_management(\core_badges\output\badge_management $badges) { 486 $paging = new paging_bar($badges->totalcount, $badges->page, $badges->perpage, $this->page->url, 'page'); 487 488 // New badge button. 489 $htmlnew = ''; 490 if (has_capability('moodle/badges:createbadge', $this->page->context)) { 491 $n['type'] = $this->page->url->get_param('type'); 492 $n['id'] = $this->page->url->get_param('id'); 493 $btn = $this->output->single_button(new moodle_url('newbadge.php', $n), get_string('newbadge', 'badges')); 494 $htmlnew = $this->output->box($btn); 495 } 496 497 $htmlpagingbar = $this->render($paging); 498 $table = new html_table(); 499 $table->attributes['class'] = 'table table-bordered table-striped'; 500 501 $sortbyname = $this->helper_sortable_heading(get_string('name'), 502 'name', $badges->sort, $badges->dir); 503 $sortbystatus = $this->helper_sortable_heading(get_string('status', 'badges'), 504 'status', $badges->sort, $badges->dir); 505 $table->head = array( 506 $sortbyname, 507 $sortbystatus, 508 get_string('bcriteria', 'badges'), 509 get_string('awards', 'badges'), 510 get_string('actions') 511 ); 512 $table->colclasses = array('name', 'status', 'criteria', 'awards', 'actions'); 513 514 foreach ($badges->badges as $b) { 515 $style = !$b->is_active() ? array('class' => 'dimmed') : array(); 516 $forlink = print_badge_image($b, $this->page->context) . ' ' . 517 html_writer::start_tag('span') . $b->name . html_writer::end_tag('span'); 518 $name = html_writer::link(new moodle_url('/badges/overview.php', array('id' => $b->id)), $forlink, $style); 519 $status = $b->statstring; 520 $criteria = self::print_badge_criteria($b, 'short'); 521 522 if (has_capability('moodle/badges:viewawarded', $this->page->context)) { 523 $awards = html_writer::link(new moodle_url('/badges/recipients.php', array('id' => $b->id)), $b->awards); 524 } else { 525 $awards = $b->awards; 526 } 527 528 $actions = self::print_badge_table_actions($b, $this->page->context); 529 530 $row = array($name, $status, $criteria, $awards, $actions); 531 $table->data[] = $row; 532 } 533 $htmltable = html_writer::table($table); 534 535 return $htmlnew . $htmlpagingbar . $htmltable . $htmlpagingbar; 536 } 537 538 /** 539 * Prints tabs for badge editing. 540 * 541 * @param integer $badgeid The badgeid to edit. 542 * @param context $context The current context. 543 * @param string $current The currently selected tab. 544 * @return string 545 */ 546 public function print_badge_tabs($badgeid, $context, $current = 'overview') { 547 global $DB; 548 549 $badge = new badge($badgeid); 550 $row = array(); 551 552 $row[] = new tabobject('overview', 553 new moodle_url('/badges/overview.php', array('id' => $badgeid)), 554 get_string('boverview', 'badges') 555 ); 556 557 if (has_capability('moodle/badges:configuredetails', $context)) { 558 $row[] = new tabobject('badge', 559 new moodle_url('/badges/edit.php', array('id' => $badgeid, 'action' => 'badge')), 560 get_string('bdetails', 'badges') 561 ); 562 } 563 564 if (has_capability('moodle/badges:configurecriteria', $context)) { 565 $row[] = new tabobject('criteria', 566 new moodle_url('/badges/criteria.php', array('id' => $badgeid)), 567 get_string('bcriteria', 'badges') 568 ); 569 } 570 571 if (has_capability('moodle/badges:configuremessages', $context)) { 572 $row[] = new tabobject('message', 573 new moodle_url('/badges/edit.php', array('id' => $badgeid, 'action' => 'message')), 574 get_string('bmessage', 'badges') 575 ); 576 } 577 578 if (has_capability('moodle/badges:viewawarded', $context)) { 579 $awarded = $DB->count_records_sql('SELECT COUNT(b.userid) 580 FROM {badge_issued} b INNER JOIN {user} u ON b.userid = u.id 581 WHERE b.badgeid = :badgeid AND u.deleted = 0', array('badgeid' => $badgeid)); 582 $row[] = new tabobject('awards', 583 new moodle_url('/badges/recipients.php', array('id' => $badgeid)), 584 get_string('bawards', 'badges', $awarded) 585 ); 586 } 587 588 if (has_capability('moodle/badges:configuredetails', $context)) { 589 $row[] = new tabobject('bendorsement', 590 new moodle_url('/badges/endorsement.php', array('id' => $badgeid)), 591 get_string('bendorsement', 'badges') 592 ); 593 } 594 595 if (has_capability('moodle/badges:configuredetails', $context)) { 596 $sql = "SELECT COUNT(br.badgeid) 597 FROM {badge_related} br 598 WHERE (br.badgeid = :badgeid OR br.relatedbadgeid = :badgeid2)"; 599 $related = $DB->count_records_sql($sql, ['badgeid' => $badgeid, 'badgeid2' => $badgeid]); 600 $row[] = new tabobject('brelated', 601 new moodle_url('/badges/related.php', array('id' => $badgeid)), 602 get_string('brelated', 'badges', $related) 603 ); 604 } 605 606 if (has_capability('moodle/badges:configuredetails', $context)) { 607 $alignments = $DB->count_records_sql("SELECT COUNT(bc.id) 608 FROM {badge_alignment} bc WHERE bc.badgeid = :badgeid", array('badgeid' => $badgeid)); 609 $row[] = new tabobject('alignment', 610 new moodle_url('/badges/alignment.php', array('id' => $badgeid)), 611 get_string('balignment', 'badges', $alignments) 612 ); 613 } 614 615 echo $this->tabtree($row, $current); 616 } 617 618 /** 619 * Prints badge status box. 620 * 621 * @param badge $badge 622 * @return Either the status box html as a string or null 623 */ 624 public function print_badge_status_box(badge $badge) { 625 if (has_capability('moodle/badges:configurecriteria', $badge->get_context())) { 626 627 if (!$badge->has_criteria()) { 628 $criteriaurl = new moodle_url('/badges/criteria.php', array('id' => $badge->id)); 629 $status = get_string('nocriteria', 'badges'); 630 if ($this->page->url != $criteriaurl) { 631 $action = $this->output->single_button( 632 $criteriaurl, 633 get_string('addcriteria', 'badges'), 'POST', array('class' => 'activatebadge')); 634 } else { 635 $action = ''; 636 } 637 638 $message = $status . $action; 639 } else { 640 $status = get_string('statusmessage_' . $badge->status, 'badges'); 641 if ($badge->is_active()) { 642 $action = $this->output->single_button(new moodle_url('/badges/action.php', 643 array('id' => $badge->id, 'lock' => 1, 'sesskey' => sesskey(), 644 'return' => $this->page->url->out_as_local_url(false))), 645 get_string('deactivate', 'badges'), 'POST', array('class' => 'activatebadge')); 646 } else { 647 $action = $this->output->single_button(new moodle_url('/badges/action.php', 648 array('id' => $badge->id, 'activate' => 1, 'sesskey' => sesskey(), 649 'return' => $this->page->url->out_as_local_url(false))), 650 get_string('activate', 'badges'), 'POST', array('class' => 'activatebadge')); 651 } 652 653 $message = $status . $this->output->help_icon('status', 'badges') . $action; 654 655 } 656 657 $style = $badge->is_active() ? 'generalbox statusbox active' : 'generalbox statusbox inactive'; 658 return $this->output->box($message, $style); 659 } 660 661 return null; 662 } 663 664 /** 665 * Returns information about badge criteria in a list form. 666 * 667 * @param badge $badge Badge objects 668 * @param string $short Indicates whether to print full info about this badge 669 * @return string $output HTML string to output 670 */ 671 public function print_badge_criteria(badge $badge, $short = '') { 672 $agg = $badge->get_aggregation_methods(); 673 if (empty($badge->criteria)) { 674 return get_string('nocriteria', 'badges'); 675 } 676 677 $overalldescr = ''; 678 $overall = $badge->criteria[BADGE_CRITERIA_TYPE_OVERALL]; 679 if (!$short && !empty($overall->description)) { 680 $overalldescr = $this->output->box( 681 format_text($overall->description, $overall->descriptionformat, array('context' => $badge->get_context())), 682 'criteria-description' 683 ); 684 } 685 686 // Get the condition string. 687 $condition = ''; 688 if (count($badge->criteria) != 2) { 689 $condition = get_string('criteria_descr_' . $short . BADGE_CRITERIA_TYPE_OVERALL, 'badges', 690 core_text::strtoupper($agg[$badge->get_aggregation_method()])); 691 } 692 693 unset($badge->criteria[BADGE_CRITERIA_TYPE_OVERALL]); 694 695 $items = array(); 696 // If only one criterion left, make sure its description goe to the top. 697 if (count($badge->criteria) == 1) { 698 $c = reset($badge->criteria); 699 if (!$short && !empty($c->description)) { 700 $overalldescr = $this->output->box( 701 format_text($c->description, $c->descriptionformat, array('context' => $badge->get_context())), 702 'criteria-description' 703 ); 704 } 705 if (count($c->params) == 1) { 706 $items[] = get_string('criteria_descr_single_' . $short . $c->criteriatype , 'badges') . 707 $c->get_details($short); 708 } else { 709 $items[] = get_string('criteria_descr_' . $short . $c->criteriatype, 'badges', 710 core_text::strtoupper($agg[$badge->get_aggregation_method($c->criteriatype)])) . 711 $c->get_details($short); 712 } 713 } else { 714 foreach ($badge->criteria as $type => $c) { 715 $criteriadescr = ''; 716 if (!$short && !empty($c->description)) { 717 $criteriadescr = $this->output->box( 718 format_text($c->description, $c->descriptionformat, array('context' => $badge->get_context())), 719 'criteria-description' 720 ); 721 } 722 if (count($c->params) == 1) { 723 $items[] = get_string('criteria_descr_single_' . $short . $type , 'badges') . 724 $c->get_details($short) . $criteriadescr; 725 } else { 726 $items[] = get_string('criteria_descr_' . $short . $type , 'badges', 727 core_text::strtoupper($agg[$badge->get_aggregation_method($type)])) . 728 $c->get_details($short) . 729 $criteriadescr; 730 } 731 } 732 } 733 734 return $overalldescr . $condition . html_writer::alist($items, array(), 'ul');; 735 } 736 737 /** 738 * Prints criteria actions for badge editing. 739 * 740 * @param badge $badge 741 * @return string 742 */ 743 public function print_criteria_actions(badge $badge) { 744 $output = ''; 745 if (!$badge->is_active() && !$badge->is_locked()) { 746 $accepted = $badge->get_accepted_criteria(); 747 $potential = array_diff($accepted, array_keys($badge->criteria)); 748 749 if (!empty($potential)) { 750 foreach ($potential as $p) { 751 if ($p != 0) { 752 $select[$p] = get_string('criteria_' . $p, 'badges'); 753 } 754 } 755 $output .= $this->output->single_select( 756 new moodle_url('/badges/criteria_settings.php', array('badgeid' => $badge->id, 'add' => true)), 757 'type', 758 $select, 759 '', 760 array('' => 'choosedots'), 761 null, 762 array('label' => get_string('addbadgecriteria', 'badges')) 763 ); 764 } else { 765 $output .= $this->output->box(get_string('nothingtoadd', 'badges'), 'clearfix'); 766 } 767 } 768 769 return $output; 770 } 771 772 /** 773 * Renders a table with users who have earned the badge. 774 * Based on stamps collection plugin. 775 * 776 * @param \core_badges\output\badge_recipients $recipients 777 * @return string 778 */ 779 protected function render_badge_recipients(\core_badges\output\badge_recipients $recipients) { 780 $paging = new paging_bar($recipients->totalcount, $recipients->page, $recipients->perpage, $this->page->url, 'page'); 781 $htmlpagingbar = $this->render($paging); 782 $table = new html_table(); 783 $table->attributes['class'] = 'generaltable boxaligncenter boxwidthwide'; 784 785 $sortbyfirstname = $this->helper_sortable_heading(get_string('firstname'), 786 'firstname', $recipients->sort, $recipients->dir); 787 $sortbylastname = $this->helper_sortable_heading(get_string('lastname'), 788 'lastname', $recipients->sort, $recipients->dir); 789 if ($this->helper_fullname_format() == 'lf') { 790 $sortbyname = $sortbylastname . ' / ' . $sortbyfirstname; 791 } else { 792 $sortbyname = $sortbyfirstname . ' / ' . $sortbylastname; 793 } 794 795 $sortbydate = $this->helper_sortable_heading(get_string('dateawarded', 'badges'), 796 'dateissued', $recipients->sort, $recipients->dir); 797 798 $table->head = array($sortbyname, $sortbydate, ''); 799 800 foreach ($recipients->userids as $holder) { 801 $fullname = fullname($holder); 802 $fullname = html_writer::link( 803 new moodle_url('/user/profile.php', array('id' => $holder->userid)), 804 $fullname 805 ); 806 $awarded = userdate($holder->dateissued); 807 $badgeurl = html_writer::link( 808 new moodle_url('/badges/badge.php', array('hash' => $holder->uniquehash)), 809 get_string('viewbadge', 'badges') 810 ); 811 812 $row = array($fullname, $awarded, $badgeurl); 813 $table->data[] = $row; 814 } 815 816 $htmltable = html_writer::table($table); 817 818 return $htmlpagingbar . $htmltable . $htmlpagingbar; 819 } 820 821 //////////////////////////////////////////////////////////////////////////// 822 // Helper methods 823 // Reused from stamps collection plugin 824 //////////////////////////////////////////////////////////////////////////// 825 826 /** 827 * Renders a text with icons to sort by the given column 828 * 829 * This is intended for table headings. 830 * 831 * @param string $text The heading text 832 * @param string $sortid The column id used for sorting 833 * @param string $sortby Currently sorted by (column id) 834 * @param string $sorthow Currently sorted how (ASC|DESC) 835 * 836 * @return string 837 */ 838 protected function helper_sortable_heading($text, $sortid = null, $sortby = null, $sorthow = null) { 839 $out = html_writer::tag('span', $text, array('class' => 'text')); 840 841 if (!is_null($sortid)) { 842 if ($sortby !== $sortid || $sorthow !== 'ASC') { 843 $url = new moodle_url($this->page->url); 844 $url->params(array('sort' => $sortid, 'dir' => 'ASC')); 845 $out .= $this->output->action_icon($url, 846 new pix_icon('t/sort_asc', get_string('sortbyx', 'core', s($text)), null, array('class' => 'iconsort'))); 847 } 848 if ($sortby !== $sortid || $sorthow !== 'DESC') { 849 $url = new moodle_url($this->page->url); 850 $url->params(array('sort' => $sortid, 'dir' => 'DESC')); 851 $out .= $this->output->action_icon($url, 852 new pix_icon('t/sort_desc', get_string('sortbyxreverse', 'core', s($text)), null, array('class' => 'iconsort'))); 853 } 854 } 855 return $out; 856 } 857 /** 858 * Tries to guess the fullname format set at the site 859 * 860 * @return string fl|lf 861 */ 862 protected function helper_fullname_format() { 863 $fake = new stdClass(); 864 $fake->lastname = 'LLLL'; 865 $fake->firstname = 'FFFF'; 866 $fullname = get_string('fullnamedisplay', '', $fake); 867 if (strpos($fullname, 'LLLL') < strpos($fullname, 'FFFF')) { 868 return 'lf'; 869 } else { 870 return 'fl'; 871 } 872 } 873 /** 874 * Renders a search form 875 * 876 * @param string $search Search string 877 * @return string HTML 878 */ 879 protected function helper_search_form($search) { 880 global $CFG; 881 require_once($CFG->libdir . '/formslib.php'); 882 883 $mform = new MoodleQuickForm('searchform', 'POST', $this->page->url); 884 885 $mform->addElement('hidden', 'sesskey', sesskey()); 886 887 $el[] = $mform->createElement('text', 'search', get_string('search'), array('size' => 20)); 888 $mform->setDefault('search', $search); 889 $el[] = $mform->createElement('submit', 'submitsearch', get_string('search')); 890 $el[] = $mform->createElement('submit', 'clearsearch', get_string('clear')); 891 $mform->addGroup($el, 'searchgroup', get_string('searchname', 'badges'), ' ', false); 892 893 ob_start(); 894 $mform->display(); 895 $out = ob_get_clean(); 896 897 return $out; 898 } 899 900 /** 901 * Renders a definition list 902 * 903 * @param array $items the list of items to define 904 * @param array 905 */ 906 protected function definition_list(array $items, array $attributes = array()) { 907 $output = html_writer::start_tag('dl', $attributes); 908 foreach ($items as $label => $value) { 909 $output .= html_writer::tag('dt', $label); 910 $output .= html_writer::tag('dd', $value); 911 } 912 $output .= html_writer::end_tag('dl'); 913 return $output; 914 } 915 916 /** 917 * Outputs list en badges. 918 * 919 * @param badge $badge Badge object. 920 * @return string $output content endorsement to output. 921 */ 922 protected function print_badge_endorsement(badge $badge) { 923 $output = ''; 924 $endorsement = $badge->get_endorsement(); 925 $dl = array(); 926 $output .= $this->heading(get_string('endorsement', 'badges'), 3); 927 if (!empty($endorsement)) { 928 $dl[get_string('issuername', 'badges')] = $endorsement->issuername; 929 $dl[get_string('issueremail', 'badges')] = 930 html_writer::tag('a', $endorsement->issueremail, array('href' => 'mailto:' . $endorsement->issueremail)); 931 $dl[get_string('issuerurl', 'badges')] = html_writer::link($endorsement->issuerurl, $endorsement->issuerurl, 932 array('target' => '_blank')); 933 $dl[get_string('dateawarded', 'badges')] = userdate($endorsement->dateissued); 934 $dl[get_string('claimid', 'badges')] = html_writer::link($endorsement->claimid, $endorsement->claimid, 935 array('target' => '_blank')); 936 $dl[get_string('claimcomment', 'badges')] = $endorsement->claimcomment; 937 $output .= $this->definition_list($dl); 938 } else { 939 $output .= get_string('noendorsement', 'badges'); 940 } 941 return $output; 942 } 943 944 /** 945 * Print list badges related. 946 * 947 * @param badge $badge Badge objects. 948 * @return string $output List related badges to output. 949 */ 950 protected function print_badge_related(badge $badge) { 951 $output = ''; 952 $relatedbadges = $badge->get_related_badges(); 953 $output .= $this->heading(get_string('relatedbages', 'badges'), 3); 954 if (!empty($relatedbadges)) { 955 $items = array(); 956 foreach ($relatedbadges as $related) { 957 $relatedurl = new moodle_url('/badges/overview.php', array('id' => $related->id)); 958 $items[] = html_writer::link($relatedurl->out(), $related->name, array('target' => '_blank')); 959 } 960 $output .= html_writer::alist($items, array(), 'ul'); 961 } else { 962 $output .= get_string('norelated', 'badges'); 963 } 964 return $output; 965 } 966 967 /** 968 * Print list badge alignments. 969 * 970 * @param badge $badge Badge objects. 971 * @return string $output List alignments to output. 972 */ 973 protected function print_badge_alignments(badge $badge) { 974 $output = ''; 975 $output .= $this->heading(get_string('alignment', 'badges'), 3); 976 $alignments = $badge->get_alignments(); 977 if (!empty($alignments)) { 978 $items = array(); 979 foreach ($alignments as $alignment) { 980 $urlaligment = new moodle_url('alignment.php', 981 array('id' => $badge->id, 'alignmentid' => $alignment->id) 982 ); 983 $items[] = html_writer::link($urlaligment, $alignment->targetname, array('target' => '_blank')); 984 } 985 $output .= html_writer::alist($items, array(), 'ul'); 986 } else { 987 $output .= get_string('noalignment', 'badges'); 988 } 989 return $output; 990 } 991 992 /** 993 * Renders a table for related badges. 994 * 995 * @param \core_badges\output\badge_related $related list related badges. 996 * @return string list related badges to output. 997 */ 998 protected function render_badge_related(\core_badges\output\badge_related $related) { 999 $currentbadge = new badge($related->currentbadgeid); 1000 $languages = get_string_manager()->get_list_of_languages(); 1001 $paging = new paging_bar($related->totalcount, $related->page, $related->perpage, $this->page->url, 'page'); 1002 $htmlpagingbar = $this->render($paging); 1003 $table = new html_table(); 1004 $table->attributes['class'] = 'generaltable boxaligncenter boxwidthwide'; 1005 $table->head = array( 1006 get_string('name'), 1007 get_string('version', 'badges'), 1008 get_string('language', 'badges'), 1009 get_string('type', 'badges') 1010 ); 1011 if (!$currentbadge->is_active() && !$currentbadge->is_locked()) { 1012 array_push($table->head, ''); 1013 } 1014 1015 foreach ($related->badges as $badge) { 1016 $badgeobject = new badge($badge->id); 1017 $style = array('title' => $badgeobject->name); 1018 if (!$badgeobject->is_active()) { 1019 $style['class'] = 'dimmed'; 1020 } 1021 $context = ($badgeobject->type == BADGE_TYPE_SITE) ? 1022 context_system::instance() : context_course::instance($badgeobject->courseid); 1023 $forlink = print_badge_image($badgeobject, $context) . ' ' . 1024 html_writer::start_tag('span') . $badgeobject->name . html_writer::end_tag('span'); 1025 $name = html_writer::link(new moodle_url('/badges/overview.php', array('id' => $badgeobject->id)), $forlink, $style); 1026 1027 $row = array( 1028 $name, 1029 $badge->version, 1030 $badge->language ? $languages[$badge->language] : '', 1031 $badge->type == BADGE_TYPE_COURSE ? get_string('badgesview', 'badges') : get_string('sitebadges', 'badges') 1032 ); 1033 if (!$currentbadge->is_active() && !$currentbadge->is_locked()) { 1034 $action = $this->output->action_icon( 1035 new moodle_url('/badges/related_action.php', [ 1036 'badgeid' => $related->currentbadgeid, 1037 'relatedid' => $badge->id, 1038 'sesskey' => sesskey(), 1039 'action' => 'remove' 1040 ]), 1041 new pix_icon('t/delete', get_string('delete'))); 1042 $actions = html_writer::tag('div', $action, array('class' => 'badge-actions')); 1043 array_push($row, $actions); 1044 } 1045 $table->data[] = $row; 1046 } 1047 $htmltable = html_writer::table($table); 1048 1049 return $htmlpagingbar . $htmltable . $htmlpagingbar; 1050 } 1051 1052 /** 1053 * Renders a table with alignment. 1054 * 1055 * @param core_badges\output\badge_alignments $alignments List alignments. 1056 * @return string List alignment to output. 1057 */ 1058 protected function render_badge_alignments(\core_badges\output\badge_alignments $alignments) { 1059 $currentbadge = new badge($alignments->currentbadgeid); 1060 $paging = new paging_bar($alignments->totalcount, $alignments->page, $alignments->perpage, $this->page->url, 'page'); 1061 $htmlpagingbar = $this->render($paging); 1062 $table = new html_table(); 1063 $table->attributes['class'] = 'generaltable boxaligncenter boxwidthwide'; 1064 $table->head = array('Name', 'URL', ''); 1065 1066 foreach ($alignments->alignments as $item) { 1067 $urlaligment = new moodle_url('alignment.php', 1068 array( 1069 'id' => $currentbadge->id, 1070 'alignmentid' => $item->id, 1071 ) 1072 ); 1073 $row = array( 1074 html_writer::link($urlaligment, $item->targetname), 1075 html_writer::link($item->targeturl, $item->targeturl, array('target' => '_blank')) 1076 ); 1077 if (!$currentbadge->is_active() && !$currentbadge->is_locked()) { 1078 $delete = $this->output->action_icon( 1079 new moodle_url('/badges/alignment_action.php', [ 1080 'id' => $currentbadge->id, 1081 'alignmentid' => $item->id, 1082 'sesskey' => sesskey(), 1083 'action' => 'remove' 1084 ]), 1085 new pix_icon('t/delete', get_string('delete')) 1086 ); 1087 $edit = $this->output->action_icon( 1088 new moodle_url('alignment.php', 1089 array( 1090 'id' => $currentbadge->id, 1091 'alignmentid' => $item->id, 1092 'action' => 'edit' 1093 ) 1094 ), new pix_icon('t/edit', get_string('edit'))); 1095 $actions = html_writer::tag('div', $edit . $delete, array('class' => 'badge-actions')); 1096 array_push($row, $actions); 1097 } 1098 $table->data[] = $row; 1099 } 1100 $htmltable = html_writer::table($table); 1101 1102 return $htmlpagingbar . $htmltable . $htmlpagingbar; 1103 } 1104 1105 /** 1106 * Defer to template. 1107 * 1108 * @param \core_badges\output\external_backpacks_page $page 1109 * @return bool|string 1110 */ 1111 public function render_external_backpacks_page(\core_badges\output\external_backpacks_page $page) { 1112 $data = $page->export_for_template($this); 1113 return parent::render_from_template('core_badges/external_backpacks_page', $data); 1114 } 1115 1116 /** 1117 * Get the result of a backpack validation with its settings. It returns: 1118 * - A informative message if the backpack version is different from OBv2. 1119 * - A warning with the error if it's not possible to connect to this backpack. 1120 * - A successful message if the connection has worked. 1121 * 1122 * @param int $backpackid The backpack identifier. 1123 * @return string A message with the validation result. 1124 */ 1125 public function render_test_backpack_result(int $backpackid): string { 1126 // Get the backpack. 1127 $backpack = badges_get_site_backpack($backpackid); 1128 1129 // Add the header to the result. 1130 $result = $this->heading(get_string('testbackpack', 'badges', $backpack->backpackweburl)); 1131 1132 if ($backpack->apiversion != OPEN_BADGES_V2) { 1133 // Only OBv2 supports this validation. 1134 $result .= get_string('backpackconnectionnottested', 'badges'); 1135 } else { 1136 $message = badges_verify_backpack($backpackid); 1137 if (empty($message)) { 1138 $result .= get_string('backpackconnectionok', 'badges'); 1139 } else { 1140 $result .= $message; 1141 } 1142 } 1143 1144 return $result; 1145 } 1146 }
title
Description
Body
title
Description
Body
title
Description
Body
title
Body
