Search moodle.org's
Developer Documentation

See Release Notes

  • Bug fixes for general core bugs in 4.2.x will end 22 April 2024 (12 months).
  • Bug fixes for security issues in 4.2.x will end 7 October 2024 (18 months).
  • PHP version: minimum PHP 8.0.0 Note: minimum PHP version has increased since Moodle 4.1. PHP 8.1.x is supported too.
<?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/>.

declare(strict_types=1);

namespace core_badges\reportbuilder\datasource;

use core_badges_generator;
use core_reportbuilder_generator;
use core_reportbuilder_testcase;
< use core_reportbuilder\local\filters\{boolean_select, date, select, text};
> use core_reportbuilder\local\filters\{boolean_select, date, select, tags, text};
defined('MOODLE_INTERNAL') || die(); global $CFG; require_once("{$CFG->dirroot}/reportbuilder/tests/helpers.php"); require_once("{$CFG->libdir}/badgeslib.php"); /** * Unit tests for user badges datasource * * @package core_badges * @covers \core_badges\reportbuilder\datasource\users * @copyright 2023 Paul Holden <paulh@moodle.com> * @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later */ class users_test extends core_reportbuilder_testcase { /** * Test default datasource */ public function test_datasource_default(): void { $this->resetAfterTest(); $user = $this->getDataGenerator()->create_user(['firstname' => 'Zoe', 'lastname' => 'Zebra']); /** @var core_badges_generator $generator */ $generator = $this->getDataGenerator()->get_plugin_generator('core_badges'); ($badgeone = $generator->create_badge(['name' => 'Badge 1', 'description' => 'My first badge'])) ->issue($user->id, true); ($badgetwo = $generator->create_badge(['name' => 'Badge 2', 'description' => 'My second badge'])) ->issue($user->id, true); /** @var core_reportbuilder_generator $generator */ $generator = $this->getDataGenerator()->get_plugin_generator('core_reportbuilder'); $report = $generator->create_report(['name' => 'Badges', 'source' => users::class, 'default' => 1]); $content = $this->get_custom_report_content($report->get('id')); $this->assertCount(3, $content); // Default columns are user, badge, description, issued time. Sorted by user, badge, issued time. [$userfullname, $badgename, $badgedescription, $badgeissued] = array_values($content[0]); $this->assertEquals('Admin User', $userfullname); $this->assertEmpty($badgename); $this->assertEmpty($badgedescription); $this->assertEmpty($badgeissued); [$userfullname, $badgename, $badgedescription, $badgeissued] = array_values($content[1]); $this->assertEquals(fullname($user), $userfullname); $this->assertEquals($badgeone->name, $badgename); $this->assertEquals($badgeone->description, $badgedescription); $this->assertNotEmpty($badgeissued); [$userfullname, $badgename, $badgedescription, $badgeissued] = array_values($content[2]); $this->assertEquals(fullname($user), $userfullname); $this->assertEquals($badgetwo->name, $badgename); $this->assertEquals($badgetwo->description, $badgedescription); $this->assertNotEmpty($badgeissued); } /** * Test datasource columns that aren't added by default */ public function test_datasource_non_default_columns(): void { global $DB; $this->resetAfterTest(); $course = $this->getDataGenerator()->create_course(); $user = $this->getDataGenerator()->create_and_enrol($course, 'student', ['firstname' => 'Zoe', 'lastname' => 'Zebra']); /** @var core_badges_generator $generator */ $generator = $this->getDataGenerator()->get_plugin_generator('core_badges');
< ($badgesite = $generator->create_badge(['name' => 'Badge 1', 'language' => 'de', 'expireperiod' => HOURSECS])) < ->issue($user->id, true); < ($badgecourse = $generator->create_badge(['name' => 'Badge 2', 'type' => BADGE_TYPE_COURSE, 'courseid' => $course->id])) < ->issue($user->id, true);
> > $badgesite = $generator->create_badge([ > 'name' => 'Badge 1', > 'language' => 'de', > 'expireperiod' => HOURSECS, > 'tags' => ['cool'], > ]); > $badgecourse = $generator->create_badge([ > 'name' => 'Badge 2', > 'type' => BADGE_TYPE_COURSE, > 'courseid' => $course->id, > ]); > > $badgesite->issue($user->id, true); > $badgecourse->issue($user->id, true);
// Create criteria for manually awarding by role. $managerrole = $DB->get_field('role', 'id', ['shortname' => 'manager']); $generator->create_criteria(['badgeid' => $badgesite->id, 'roleid' => $managerrole]); /** @var core_reportbuilder_generator $generator */ $generator = $this->getDataGenerator()->get_plugin_generator('core_reportbuilder'); $report = $generator->create_report(['name' => 'Badges', 'source' => users::class, 'default' => 0]); // These two columns have been asserted previously, we're only adding them for consistent sorting. $generator->create_column(['reportid' => $report->get('id'), 'uniqueidentifier' => 'user:fullname', 'sortenabled' => 1]); $generator->create_column(['reportid' => $report->get('id'), 'uniqueidentifier' => 'badge:name', 'sortenabled' => 1]);
> $generator->create_column(['reportid' => $report->get('id'), 'uniqueidentifier' => 'badge:namewithlink']);
$generator->create_column(['reportid' => $report->get('id'), 'uniqueidentifier' => 'badge:criteria']); $generator->create_column(['reportid' => $report->get('id'), 'uniqueidentifier' => 'badge:image']); $generator->create_column(['reportid' => $report->get('id'), 'uniqueidentifier' => 'badge:language']); $generator->create_column(['reportid' => $report->get('id'), 'uniqueidentifier' => 'badge:version']); $generator->create_column(['reportid' => $report->get('id'), 'uniqueidentifier' => 'badge:status']); $generator->create_column(['reportid' => $report->get('id'), 'uniqueidentifier' => 'badge:expiry']);
> $generator->create_column(['reportid' => $report->get('id'), 'uniqueidentifier' => 'tag:name']); $generator->create_column(['reportid' => $report->get('id'), 'uniqueidentifier' => 'badge_issued:expire']); >
$generator->create_column(['reportid' => $report->get('id'), 'uniqueidentifier' => 'badge_issued:visible']); $generator->create_column(['reportid' => $report->get('id'), 'uniqueidentifier' => 'course:fullname']); $content = $this->get_custom_report_content($report->get('id')); $this->assertCount(3, $content); // Admin user, no badge issued.
< [, , $criteria, $image, $language, $version, $status, $expiry, $expires, $visible, $coursename] = array_values($content[0]);
> [$fullname, $badgename, $criteria, $image, $language, $version, $status, $expiry, $tag, $expires, $visible, $coursename] > = array_values($content[0]); > $this->assertEquals('Admin User', $fullname); > $this->assertEmpty($badgename);
$this->assertEmpty($criteria); $this->assertEmpty($image); $this->assertEmpty($language); $this->assertEmpty($version); $this->assertEmpty($status); $this->assertEmpty($expiry);
> $this->assertEmpty($tag);
$this->assertEmpty($expires); $this->assertEmpty($visible); $this->assertEmpty($coursename);
< // Site badge issued. < [, , $criteria, $image, $language, $version, $status, $expiry, $expires, $visible, $coursename] = array_values($content[1]);
> $expectedbadgesitelink = \html_writer::link(new \moodle_url('/badges/overview.php', > ['id' => $badgesite->id]), ($badgesite->name)); > > // User issued site badge. > [$fullname, $badgename, $namewithlink, $criteria, $image, $language, $version, $status, $expiry, $tag, $expires, > $visible, $coursename] = array_values($content[1]); > $this->assertEquals(fullname($user), $fullname); > $this->assertEquals($badgesite->name, $badgename); > $this->assertEquals($expectedbadgesitelink, $namewithlink);
$this->assertStringContainsString('Awarded by: Manager', $criteria); $this->assertStringContainsString('Image caption', $image); $this->assertEquals('German', $language); $this->assertEquals(2, $version); $this->assertEquals('Available (criteria locked)', $status); $this->assertEquals('1 hour', $expiry);
> $this->assertEquals('cool', $tag);
$this->assertNotEmpty($expires); $this->assertEquals('Yes', $visible); $this->assertEquals('PHPUnit test site', $coursename);
< // Course badge issued. < [, , $criteria, $image, $language, $version, $status, $expiry, $expires, $visible, $coursename] = array_values($content[2]);
> $expectedbadgecourselink = \html_writer::link(new \moodle_url('/badges/overview.php', > ['id' => $badgecourse->id]), ($badgecourse->name)); > > // User issued course badge. > [$fullname, $badgename, $namewithlink, $criteria, $image, $language, $version, $status, $expiry, $tag, $expires, > $visible, $coursename] = array_values($content[2]); > $this->assertEquals(fullname($user), $fullname); > $this->assertEquals($badgecourse->name, $badgename); > $this->assertEquals($expectedbadgecourselink, $namewithlink);
$this->assertEquals('Criteria for this badge have not been set up yet.', $criteria); $this->assertStringContainsString('Image caption', $image); $this->assertEquals('English', $language); $this->assertEquals(2, $version); $this->assertEquals('Available (criteria locked)', $status); $this->assertEquals('Never', $expiry);
> $this->assertEmpty($tag);
$this->assertEmpty($expires); $this->assertEquals('Yes', $visible); $this->assertEquals($course->fullname, $coursename); } /** * Data provider for {@see test_datasource_filters} * * @return array[] */ public function datasource_filters_provider(): array { return [
> // User. // Badge. > 'Filter user fullname' => ['user:fullname', [ 'Filter badge name' => ['badge:name', [ > 'user:fullname_operator' => text::IS_EQUAL_TO, 'badge:name_operator' => text::IS_EQUAL_TO, > 'user:fullname_value' => 'Zoe Zebra', 'badge:name_value' => 'Course badge', > ], true], ], true], > 'Filter user fullname (no match)' => ['user:fullname', [ 'Filter badge name (no match)' => ['badge:name', [ > 'user:fullname_operator' => text::IS_EQUAL_TO, 'badge:name_operator' => text::IS_EQUAL_TO, > 'user:fullname_value' => 'Alice Aardvark', 'badge:name_value' => 'Other badge', > ], false], ], false], >
'Filter badge status' => ['badge:status', [ 'badge:status_operator' => select::EQUAL_TO, 'badge:status_value' => BADGE_STATUS_ACTIVE_LOCKED, ], true], 'Filter badge status (no match)' => ['badge:status', [ 'badge:status_operator' => select::EQUAL_TO, 'badge:status_value' => BADGE_STATUS_ACTIVE, ], false], 'Filter badge type' => ['badge:type', [ 'badge:type_operator' => select::EQUAL_TO, 'badge:type_value' => BADGE_TYPE_COURSE, ], true], 'Filter badge type (no match)' => ['badge:type', [ 'badge:type_operator' => select::EQUAL_TO, 'badge:type_value' => BADGE_TYPE_SITE, ], false],
> // Badge tag. // Badge issued. > 'Filter tag name' => ['tag:name', [ 'Filter badge issued date' => ['badge_issued:issued', [ > 'tag:name_operator' => tags::NOT_EMPTY, 'badge_issued:issued_operator' => date::DATE_RANGE, > ], true], 'badge_issued:issued_from' => 1622502000, > 'Filter tag name (no match)' => ['tag:name', [ ], true], > 'tag:name_operator' => tags::EQUAL_TO, 'Filter badge issued date (no match)' => ['badge_issued:issued', [ > 'tag:name_value' => [-1], 'badge_issued:issued_operator' => date::DATE_RANGE, > ], false], 'badge_issued:issued_to' => 1622502000, >
], false], 'Filter badge issued expires' => ['badge_issued:expires', [ 'badge_issued:expires_operator' => date::DATE_RANGE, 'badge_issued:expires_from' => 1622502000, ], true], 'Filter badge issued expires (no match)' => ['badge_issued:expires', [ 'badge_issued:expires_operator' => date::DATE_RANGE, 'badge_issued:expires_to' => 1622502000, ], false], 'Filter badge issued visible' => ['badge_issued:visible', [ 'badge_issued:visible_operator' => boolean_select::CHECKED, ], true], 'Filter badge issued visible (no match)' => ['badge_issued:visible', [ 'badge_issued:visible_operator' => boolean_select::NOT_CHECKED, ], false], // Course. 'Filter course fullname' => ['course:fullname', [ 'course:fullname_operator' => text::IS_EQUAL_TO, 'course:fullname_value' => 'Course 1', ], true], 'Filter course fullname (no match)' => ['course:fullname', [ 'course:fullname_operator' => text::IS_EQUAL_TO, 'course:fullname_value' => 'Course 2', ], false], ]; } /** * Test datasource filters * * @param string $filtername * @param array $filtervalues * @param bool $expectmatch * * @dataProvider datasource_filters_provider */ public function test_datasource_filters(string $filtername, array $filtervalues, bool $expectmatch): void { $this->resetAfterTest(); $course = $this->getDataGenerator()->create_course(['fullname' => 'Course 1']);
< $user = $this->getDataGenerator()->create_and_enrol($course);
> $user = $this->getDataGenerator()->create_and_enrol($course, 'student', ['firstname' => 'Zoe', 'lastname' => 'Zebra']);
/** @var core_badges_generator $generator */ $generator = $this->getDataGenerator()->get_plugin_generator('core_badges');
< $generator->create_badge([
> $badge = $generator->create_badge([
'name' => 'Course badge', 'type' => BADGE_TYPE_COURSE, 'courseid' => $course->id, 'expireperiod' => HOURSECS,
< ])->issue($user->id, true);
> 'tags' => ['cool'], > ]); > $badge->issue($user->id, true);
/** @var core_reportbuilder_generator $generator */ $generator = $this->getDataGenerator()->get_plugin_generator('core_reportbuilder'); // Create report containing single username column, and given filter. $report = $generator->create_report(['name' => 'My report', 'source' => users::class, 'default' => 0]); $generator->create_column(['reportid' => $report->get('id'), 'uniqueidentifier' => 'user:username']); // Add filter, set it's values. $generator->create_filter(['reportid' => $report->get('id'), 'uniqueidentifier' => $filtername]); $content = $this->get_custom_report_content($report->get('id'), 0, $filtervalues); if ($expectmatch) { $this->assertCount(1, $content); $this->assertEquals($user->username, reset($content[0])); } else { $this->assertEmpty($content); } } /** * Stress test datasource * * In order to execute this test PHPUNIT_LONGTEST should be defined as true in phpunit.xml or directly in config.php */ public function test_stress_datasource(): void { if (!PHPUNIT_LONGTEST) { $this->markTestSkipped('PHPUNIT_LONGTEST is not defined'); } $this->resetAfterTest(); $course = $this->getDataGenerator()->create_course(); $user = $this->getDataGenerator()->create_and_enrol($course); /** @var core_badges_generator $generator */ $generator = $this->getDataGenerator()->get_plugin_generator('core_badges');
< $generator->create_badge([ < 'name' => 'Course badge', < 'type' => BADGE_TYPE_COURSE, < 'courseid' => $course->id, < ])->issue($user->id, true);
> $badge = $generator->create_badge(['name' => 'Course badge', 'type' => BADGE_TYPE_COURSE, 'courseid' => $course->id]); > $badge->issue($user->id, true);
$this->datasource_stress_test_columns(users::class); $this->datasource_stress_test_columns_aggregation(users::class); $this->datasource_stress_test_conditions(users::class, 'user:username'); } }