See Release Notes
Long Term Support Release
<?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/>.< /** < * Unit tests for rating/lib.php < * < * @package core_ratings < * @category phpunit < * @copyright 2011 onwards Eloy Lafuente (stronk7) {@link http://stronk7.com} < * @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later < */> namespace core_rating; > > use rating_manager;defined('MOODLE_INTERNAL') || die(); // Include all the needed stuff. global $CFG; require_once($CFG->dirroot . '/rating/lib.php'); /** * Unit test case for all the rating/lib.php requiring DB mockup & manipulation> * */ > * @package core_rating class core_rating_testcase extends advanced_testcase { > * @category test > * @copyright 2011 onwards Eloy Lafuente (stronk7) {@link http://stronk7.com} protected $syscontext; > * @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later protected $neededcaps = array('view', 'viewall', 'viewany', 'rate'); > * @covers \rating< class core_rating_testcase extends advanced_testcase {> class rating_test extends \advanced_testcase {public function setUp(): void { global $CFG; parent::setUp(); $this->resetAfterTest(true); $CFG->defaultfrontpageroleid = null; } /** * Test the current get_ratings method main sql */ public function test_get_ratings_sql() { global $DB; // We load 3 items. Each is rated twice. For simplicity itemid == user id of the item owner.< $ctxid = context_system::instance()->id;> $ctxid = \context_system::instance()->id;$ratings = array( // User 1's items. Average == 2. array('contextid' => $ctxid, 'component' => 'mod_forum', 'ratingarea' => 'post', 'itemid' => 1, 'scaleid' => 10, 'rating' => 1, 'userid' => 2, 'timecreated' => 1, 'timemodified' => 1), array('contextid' => $ctxid, 'component' => 'mod_forum', 'ratingarea' => 'post', 'itemid' => 1, 'scaleid' => 10, 'rating' => 3, 'userid' => 3, 'timecreated' => 1, 'timemodified' => 1), // User 2's items. Average == 3. array('contextid' => $ctxid, 'component' => 'mod_forum', 'ratingarea' => 'post', 'itemid' => 2, 'scaleid' => 10, 'rating' => 1, 'userid' => 1, 'timecreated' => 1, 'timemodified' => 1), array('contextid' => $ctxid, 'component' => 'mod_forum', 'ratingarea' => 'post', 'itemid' => 2, 'scaleid' => 10,< 'rating' => 5,> 'rating' => 4,'userid' => 3, 'timecreated' => 1, 'timemodified' => 1), // User 3's items. Average == 4. array('contextid' => $ctxid, 'component' => 'mod_forum', 'ratingarea' => 'post', 'itemid' => 3, 'scaleid' => 10, 'rating' => 3, 'userid' => 1, 'timecreated' => 1, 'timemodified' => 1), array('contextid' => $ctxid, 'component' => 'mod_forum', 'ratingarea' => 'post', 'itemid' => 3, 'scaleid' => 10, 'rating' => 5, 'userid' => 2, 'timecreated' => 1, 'timemodified' => 1) ); foreach ($ratings as $rating) { $DB->insert_record('rating', $rating); } // A post (item) by user 1 (rated above by user 2 and 3 with average = 2). $user1posts = array( (object)array('id' => 1, 'userid' => 1, 'message' => 'hello')); // A post (item) by user 2 (rated above by user 1 and 3 with average = 3). $user2posts = array( (object)array('id' => 2, 'userid' => 2, 'message' => 'world')); // A post (item) by user 3 (rated above by user 1 and 2 with average = 4). $user3posts = array( (object)array('id' => 3, 'userid' => 3, 'message' => 'moodle')); // Prepare the default options. $defaultoptions = array (< 'context' => context_system::instance(),> 'context' => \context_system::instance(),'component' => 'mod_forum', 'ratingarea' => 'post', 'scaleid' => 10, 'aggregate' => RATING_AGGREGATE_AVERAGE); $rm = new mockup_rating_manager(); // STEP 1: Retreive ratings using the current user. // Get results for user 1's item (expected average 1 + 3 / 2 = 2). $toptions = (object)array_merge($defaultoptions, array('items' => $user1posts)); $result = $rm->get_ratings($toptions); $this->assertEquals(count($result), count($user1posts)); $this->assertEquals($result[0]->id, $user1posts[0]->id); $this->assertEquals($result[0]->userid, $user1posts[0]->userid); $this->assertEquals($result[0]->message, $user1posts[0]->message); $this->assertEquals($result[0]->rating->count, 2); $this->assertEquals($result[0]->rating->aggregate, 2); // Note that $result[0]->rating->rating is somewhat random. // We didn't supply a user ID so $USER was used which will vary depending on who runs the tests.< // Get results for items of user 2 (expected average 1 + 5 / 2 = 3).> // Get results for items of user 2 (expected average 1 + 4 / 2 = 2.5).$toptions = (object)array_merge($defaultoptions, array('items' => $user2posts)); $result = $rm->get_ratings($toptions); $this->assertEquals(count($result), count($user2posts)); $this->assertEquals($result[0]->id, $user2posts[0]->id); $this->assertEquals($result[0]->userid, $user2posts[0]->userid); $this->assertEquals($result[0]->message, $user2posts[0]->message); $this->assertEquals($result[0]->rating->count, 2);< $this->assertEquals($result[0]->rating->aggregate, 3);> $this->assertEquals($result[0]->rating->aggregate, 2.5);// Note that $result[0]->rating->rating is somewhat random. // We didn't supply a user ID so $USER was used which will vary depending on who runs the tests. // Get results for items of user 3 (expected average 3 + 5 / 2 = 4). $toptions = (object)array_merge($defaultoptions, array('items' => $user3posts)); $result = $rm->get_ratings($toptions); $this->assertEquals(count($result), count($user3posts)); $this->assertEquals($result[0]->id, $user3posts[0]->id); $this->assertEquals($result[0]->userid, $user3posts[0]->userid); $this->assertEquals($result[0]->message, $user3posts[0]->message); $this->assertEquals($result[0]->rating->count, 2); $this->assertEquals($result[0]->rating->aggregate, 4); // Note that $result[0]->rating->rating is somewhat random. // We didn't supply a user ID so $USER was used which will vary depending on who runs the tests.< // Get results for items of user 1 & 2 together (expected averages are 2 and 3, as tested above).> // Get results for items of user 1 & 2 together (expected averages are 2 and 2.5, as tested above).$posts = array_merge($user1posts, $user2posts); $toptions = (object)array_merge($defaultoptions, array('items' => $posts)); $result = $rm->get_ratings($toptions); $this->assertEquals(count($result), count($posts)); $this->assertEquals($result[0]->id, $posts[0]->id); $this->assertEquals($result[0]->userid, $posts[0]->userid); $this->assertEquals($result[0]->message, $posts[0]->message); $this->assertEquals($result[0]->rating->count, 2); $this->assertEquals($result[0]->rating->aggregate, 2); // Note that $result[0]->rating->rating is somewhat random. // We didn't supply a user ID so $USER was used which will vary depending on who runs the tests. $this->assertEquals($result[1]->id, $posts[1]->id); $this->assertEquals($result[1]->userid, $posts[1]->userid); $this->assertEquals($result[1]->message, $posts[1]->message); $this->assertEquals($result[1]->rating->count, 2);< $this->assertEquals($result[1]->rating->aggregate, 3);> $this->assertEquals($result[1]->rating->aggregate, 2.5);// Note that $result[0]->rating->rating is somewhat random. // We didn't supply a user ID so $USER was used which will vary depending on who runs the tests. // STEP 2: Retrieve ratings by a specified user. // We still expect complete aggregations and counts. // Get results for items of user 1 rated by user 2 (avg 2, rating 1). $toptions = (object)array_merge($defaultoptions, array('items' => $user1posts, 'userid' => 2)); $result = $rm->get_ratings($toptions); $this->assertEquals(count($result), count($user1posts)); $this->assertEquals($result[0]->id, $user1posts[0]->id); $this->assertEquals($result[0]->userid, $user1posts[0]->userid); $this->assertEquals($result[0]->message, $user1posts[0]->message); $this->assertEquals($result[0]->rating->count, 2); $this->assertEquals($result[0]->rating->aggregate, 2); $this->assertEquals($result[0]->rating->rating, 1); // User 2 rated user 1 "1". $this->assertEquals($result[0]->rating->userid, $toptions->userid); // Must be the passed userid. // Get results for items of user 1 rated by user 3. $toptions = (object)array_merge($defaultoptions, array('items' => $user1posts, 'userid' => 3)); $result = $rm->get_ratings($toptions); $this->assertEquals(count($result), count($user1posts)); $this->assertEquals($result[0]->id, $user1posts[0]->id); $this->assertEquals($result[0]->userid, $user1posts[0]->userid); $this->assertEquals($result[0]->message, $user1posts[0]->message); $this->assertEquals($result[0]->rating->count, 2); $this->assertEquals($result[0]->rating->aggregate, 2); $this->assertEquals($result[0]->rating->rating, 3); // User 3 rated user 1 "3". $this->assertEquals($result[0]->rating->userid, $toptions->userid); // Must be the passed userid. // Get results for items of user 1 & 2 together rated by user 3. $posts = array_merge($user1posts, $user2posts); $toptions = (object)array_merge($defaultoptions, array('items' => $posts, 'userid' => 3)); $result = $rm->get_ratings($toptions); $this->assertEquals(count($result), count($posts)); $this->assertEquals($result[0]->id, $posts[0]->id); $this->assertEquals($result[0]->userid, $posts[0]->userid); $this->assertEquals($result[0]->message, $posts[0]->message); $this->assertEquals($result[0]->rating->count, 2); $this->assertEquals($result[0]->rating->aggregate, 2); $this->assertEquals($result[0]->rating->rating, 3); // User 3 rated user 1 "3". $this->assertEquals($result[0]->rating->userid, $toptions->userid); // Must be the passed userid. $this->assertEquals($result[1]->id, $posts[1]->id); $this->assertEquals($result[1]->userid, $posts[1]->userid); $this->assertEquals($result[1]->message, $posts[1]->message); $this->assertEquals($result[1]->rating->count, 2);< $this->assertEquals($result[1]->rating->aggregate, 3);> $this->assertEquals($result[1]->rating->aggregate, 2.5);$this->assertEquals($result[0]->rating->rating, 3); // User 3 rated user 2 "5". $this->assertEquals($result[1]->rating->userid, $toptions->userid); // Must be the passed userid. // STEP 3: Some special cases. // Get results for user 1's items (expected average 1 + 3 / 2 = 2). // Supplying a non-existent user id so no rating from that user should be found. $toptions = (object)array_merge($defaultoptions, array('items' => $user1posts)); $toptions->userid = 123456; // Non-existent user. $result = $rm->get_ratings($toptions); $this->assertNull($result[0]->rating->userid); $this->assertNull($result[0]->rating->rating); $this->assertEquals($result[0]->rating->aggregate, 2); // Should still get the aggregate.< // Get results for items of user 2 (expected average 1 + 5 / 2 = 3).> // Get results for items of user 2 (expected average 1 + 4 / 2 = 2.5).// Supplying the user id of the user who owns the items so no rating should be found. $toptions = (object)array_merge($defaultoptions, array('items' => $user2posts)); $toptions->userid = 2; // User 2 viewing the ratings of their own item. $result = $rm->get_ratings($toptions); // These should be null as the user is viewing their own item and thus cannot rate. $this->assertNull($result[0]->rating->userid); $this->assertNull($result[0]->rating->rating);< $this->assertEquals($result[0]->rating->aggregate, 3); // Should still get the aggregate.> $this->assertEquals($result[0]->rating->aggregate, 2.5); // Should still get the aggregate.} /** * Data provider for get_aggregate_string tests. * * @return array */ public function get_aggregate_string_provider() { return [ 'Non-numeric aggregate produces empty string' => [ RATING_AGGREGATE_NONE, 'string', null, ['Foo', 'Bar'], '', ], 'Aggregate count produces empty string' => [ RATING_AGGREGATE_COUNT, 0, null, ['Foo', 'Bar'], '', ], 'Numeric SUM with non-numeric scale produces returns original value' => [ RATING_AGGREGATE_SUM, 10, false, ['Foo', 'Bar'], '10', ], 'Numeric SUM with non-numeric scale produces returns rounded value' => [ RATING_AGGREGATE_SUM, 10.45, false, ['Foo', 'Bar'], '10.5', ], 'Numeric SUM with numeric scale produces returns rounded value' => [ RATING_AGGREGATE_SUM, 10.45, true, ['Foo', 'Bar'], '10.5', ], 'Numeric AVERAGE with numeric scale produces returns rounded value' => [ RATING_AGGREGATE_AVERAGE, 10.45, true, ['Foo', 'Bar'], '10.5', ], 'Numeric AVERAGE with non-numeric scale produces returns indexed value (0)' => [ RATING_AGGREGATE_AVERAGE, 0, false, ['Foo', 'Bar'], 'Foo', ], 'Numeric AVERAGE with non-numeric scale produces returns indexed value (1)' => [ RATING_AGGREGATE_AVERAGE, 1, false, ['Foo', 'Bar'], 'Bar', ], ]; } /** * Test the value returned by get_aggregate_string(). * * @dataProvider get_aggregate_string_provider */ public function test_get_aggregate_string($method, $aggregate, $isnumeric, $scaleitems, $expectation) {< $options = new stdClass();> $options = new \stdClass();$options->aggregate = $aggregate; $options->context = null; $options->component = null; $options->ratingarea = null; $options->itemid = null; $options->scaleid = null; $options->userid = null;< $options->settings = new stdClass();> $options->settings = new \stdClass();$options->settings->aggregationmethod = $method;< $options->settings->scale = new stdClass();> $options->settings->scale = new \stdClass();$options->settings->scale->isnumeric = $isnumeric; $options->settings->scale->scaleitems = $scaleitems;< $rating = new rating($options);> $rating = new \rating($options);$this->assertEquals($expectation, $rating->get_aggregate_string()); } } /** * rating_manager subclass for unit testing without requiring capabilities to be loaded */ class mockup_rating_manager extends rating_manager { /** * Overwrite get_plugin_permissions_array() so it always return granted perms for unit testing */ public function get_plugin_permissions_array($contextid, $component, $ratingarea) { return array( 'rate' => true, 'view' => true, 'viewany' => true, 'viewall' => true); } }