/** * Log user competency viewed in plan event. * * @param user_competency|int $usercompetencyorid The user competency object or user competency id * @param int $planid The plan ID * @return bool */ public static function user_competency_viewed_in_plan($usercompetencyorid, $planid) { static::require_enabled(); $uc = $usercompetencyorid; if (!is_object($uc)) { $uc = new user_competency($uc); } if (!$uc || !$uc->can_read()) { throw new required_capability_exception($uc->get_context(), 'moodle/competency:usercompetencyview', 'nopermissions', ''); } $plan = new plan($planid); if ($plan->get_status() == plan::STATUS_COMPLETE) { throw new coding_exception('To log the user competency in completed plan use user_competency_plan_viewed method.'); } \core\event\competency_user_competency_viewed_in_plan::create_from_user_competency_viewed_in_plan($uc, $planid)->trigger(); return true; }
/** * Test the user competency viewed event in plan. * */ public function test_user_competency_viewed_in_plan() { $this->resetAfterTest(true); $this->setAdminUser(); $dg = $this->getDataGenerator(); $lpg = $this->getDataGenerator()->get_plugin_generator('core_competency'); $user = $dg->create_user(); $plan = $lpg->create_plan(array('userid' => $user->id)); $fr = $lpg->create_framework(); $c = $lpg->create_competency(array('competencyframeworkid' => $fr->get_id())); $pc = $lpg->create_plan_competency(array('planid' => $plan->get_id(), 'competencyid' => $c->get_id())); $uc = $lpg->create_user_competency(array('userid' => $user->id, 'competencyid' => $c->get_id())); // Can not log the event for user competency using completed plan. api::complete_plan($plan); try { api::user_competency_viewed_in_plan($uc, $plan->get_id()); $this->fail('To log the user competency in completed plan ' . 'use user_competency_plan_viewed method.'); } catch (coding_exception $e) { $this->assertRegExp('/To log the user competency in completed plan ' . 'use user_competency_plan_viewed method./', $e->getMessage()); } api::reopen_plan($plan); // Trigger and capture the event. $sink = $this->redirectEvents(); api::user_competency_viewed_in_plan($uc, $plan->get_id()); // Get our event event. $events = $sink->get_events(); $event = reset($events); // Check that the event data is valid. $this->assertInstanceOf('\\core\\event\\competency_user_competency_viewed_in_plan', $event); $this->assertEquals($uc->get_id(), $event->objectid); $this->assertEquals($uc->get_context()->id, $event->contextid); $this->assertEquals($uc->get_userid(), $event->relateduserid); $this->assertEquals($plan->get_id(), $event->other['planid']); $this->assertEquals($c->get_id(), $event->other['competencyid']); $this->assertEventContextNotUsed($event); $this->assertDebuggingNotCalled(); // Test validation. $params = array('objectid' => $uc->get_id(), 'contextid' => $uc->get_context()->id, 'other' => null); // Other value null. try { \core\event\competency_user_competency_viewed_in_plan::create($params)->trigger(); $this->fail('The \'competencyid\' and \'planid\' values must be set.'); } catch (coding_exception $e) { $this->assertRegExp("/The 'competencyid' and 'planid' values must be set./", $e->getMessage()); } $params['other']['anythingelse'] = ''; // Missing competencyid. try { \core\event\competency_user_competency_viewed_in_plan::create($params)->trigger(); $this->fail('The \'competencyid\' value must be set.'); } catch (coding_exception $e) { $this->assertRegExp("/The 'competencyid' value must be set./", $e->getMessage()); } $params['other']['competencyid'] = $c->get_id(); // Missing planid. try { \core\event\competency_user_competency_viewed_in_plan::create($params)->trigger(); $this->fail('The \'planid\' value must be set.'); } catch (coding_exception $e) { $this->assertRegExp("/The 'planid' value must be set./", $e->getMessage()); } }