table = Database::get_main_table(TABLE_MAIN_SKILL_PROFILE); $this->table_rel_profile = Database::get_main_table(TABLE_MAIN_SKILL_REL_PROFILE); } /** * @return array */ public function getProfiles() { $sql = "SELECT * FROM $this->table p INNER JOIN $this->table_rel_profile sp ON (p.id = sp.profile_id) "; $result = Database::query($sql); $profiles = Database::store_result($result, 'ASSOC'); return $profiles; } /** * This function is for editing profile info from profile_id. * * @param int $profileId * @param string $name * @param string $description * * @return bool */ public function updateProfileInfo($profileId, $name, $description) { $profileId = (int) $profileId; if (empty($profileId)) { return false; } $name = Database::escape_string($name); $description = Database::escape_string($description); $sql = "UPDATE $this->table SET name = '$name', description = '$description' WHERE id = $profileId "; Database::query($sql); return true; } /** * Call the save method of the parent class and the SkillRelProfile object. * * @param array $params * @param bool $show_query Whether to show the query in parent save() method * * @return mixed Profile ID or false if incomplete params */ public function save($params, $show_query = false) { if (!empty($params)) { $profile_id = parent::save($params, $show_query); if ($profile_id) { $skill_rel_profile = new SkillRelProfile(); if (isset($params['skills'])) { foreach ($params['skills'] as $skill_id) { $attributes = [ 'skill_id' => $skill_id, 'profile_id' => $profile_id, ]; $skill_rel_profile->save($attributes); } } return $profile_id; } } return false; } /** * Delete a skill profile. * * @param int $id The skill profile id * * @return bool Whether delete a skill profile */ public function delete($id) { Database::delete( $this->table_rel_profile, [ 'profile_id' => $id, ] ); return parent::delete($id); } } /** * Class SkillRelProfile. */ class SkillRelProfile extends Model { public $columns = ['id', 'skill_id', 'profile_id']; /** * Constructor. */ public function __construct() { $this->table = Database::get_main_table(TABLE_MAIN_SKILL_REL_PROFILE); $this->tableProfile = Database::get_main_table(TABLE_MAIN_SKILL_PROFILE); } /** * @param int $profileId * * @return array */ public function getSkillsByProfile($profileId) { $profileId = (int) $profileId; $skills = $this->get_all(['where' => ['profile_id = ? ' => $profileId]]); $return = []; if (!empty($skills)) { foreach ($skills as $skill_data) { $return[] = $skill_data['skill_id']; } } return $return; } /** * This function is for getting profile info from profile_id. * * @param int $profileId * * @return array */ public function getProfileInfo($profileId) { $profileId = (int) $profileId; $sql = "SELECT * FROM $this->table p INNER JOIN $this->tableProfile pr ON (pr.id = p.profile_id) WHERE p.profile_id = ".$profileId; $result = Database::query($sql); $profileData = Database::fetch_array($result, 'ASSOC'); return $profileData; } } /** * Class SkillRelSkill. */ class SkillRelSkill extends Model { public $columns = ['skill_id', 'parent_id', 'relation_type', 'level']; /** * Constructor. */ public function __construct() { $this->table = Database::get_main_table(TABLE_MAIN_SKILL_REL_SKILL); $this->tableSkill = Database::get_main_table(TABLE_MAIN_SKILL); } /** * Gets an element. * * @param int $id * * @return array */ public function getSkillInfo($id) { $id = (int) $id; if (empty($id)) { return []; } $result = Database::select( '*', $this->table, ['where' => ['skill_id = ?' => $id]], 'first' ); return $result; } /** * @param int $skillId * @param bool $add_child_info * * @return array */ public function getSkillParents($skillId, $add_child_info = true) { $skillId = (int) $skillId; $sql = 'SELECT child.* FROM '.$this->table.' child LEFT JOIN '.$this->table.' parent ON child.parent_id = parent.skill_id WHERE child.skill_id = '.$skillId.' '; $result = Database::query($sql); $skill = Database::store_result($result, 'ASSOC'); $skill = isset($skill[0]) ? $skill[0] : null; $parents = []; if (!empty($skill)) { if ($skill['parent_id'] != null) { $parents = self::getSkillParents($skill['parent_id']); } if ($add_child_info) { $parents[] = $skill; } } return $parents; } /** * @param int $skillId * * @return array */ public function getDirectParents($skillId) { $skillId = (int) $skillId; $sql = 'SELECT parent_id as skill_id FROM '.$this->table.' WHERE skill_id = '.$skillId; $result = Database::query($sql); $skill = Database::store_result($result, 'ASSOC'); $skill = isset($skill[0]) ? $skill[0] : null; $parents = []; if (!empty($skill)) { $parents[] = $skill; } return $parents; } /** * @param int $skill_id * @param bool $load_user_data * @param bool $user_id * * @return array */ public function getChildren( $skill_id, $load_user_data = false, $user_id = false, $order = '' ) { $skill_id = (int) $skill_id; $sql = 'SELECT parent.* FROM '.$this->tableSkill.' skill INNER JOIN '.$this->table.' parent ON parent.id = skill.id WHERE parent_id = '.$skill_id.' ORDER BY skill.name ASC'; $result = Database::query($sql); $skills = Database::store_result($result, 'ASSOC'); $skill_obj = new Skill(); $skill_rel_user = new SkillRelUser(); if ($load_user_data) { $passed_skills = $skill_rel_user->getUserSkills($user_id); $done_skills = []; foreach ($passed_skills as $done_skill) { $done_skills[] = $done_skill['skill_id']; } } if (!empty($skills)) { foreach ($skills as &$skill) { $skill['data'] = $skill_obj->get($skill['skill_id']); if (isset($skill['data']) && !empty($skill['data'])) { if (!empty($done_skills)) { $skill['data']['passed'] = 0; if (in_array($skill['skill_id'], $done_skills)) { $skill['data']['passed'] = 1; } } } else { $skill = null; } } } return $skills; } /** * @param array $params * * @return bool */ public function updateBySkill($params) { $result = Database::update( $this->table, $params, ['skill_id = ? ' => $params['skill_id']] ); if ($result) { return true; } return false; } /** * @param int $skill_id * @param int $parent_id * * @return bool */ public function relationExists($skill_id, $parent_id) { $result = $this->find( 'all', [ 'where' => [ 'skill_id = ? AND parent_id = ?' => [ $skill_id, $parent_id, ], ], ] ); if (!empty($result)) { return true; } return false; } } /** * Class SkillRelGradebook. */ class SkillRelGradebook extends Model { public $columns = ['id', 'gradebook_id', 'skill_id']; /** * SkillRelGradebook constructor. */ public function __construct() { $this->table = Database::get_main_table(TABLE_MAIN_SKILL_REL_GRADEBOOK); } /** * @param int $gradebookId * @param int $skillId * * @return bool */ public function existsGradeBookSkill($gradebookId, $skillId) { $result = $this->find( 'all', [ 'where' => [ 'gradebook_id = ? AND skill_id = ?' => [ $gradebookId, $skillId, ], ], ] ); if (!empty($result)) { return true; } return false; } /** * Gets an element. */ public function getSkillInfo($skill_id, $gradebookId) { if (empty($skill_id)) { return []; } $result = Database::select( '*', $this->table, [ 'where' => [ 'skill_id = ? AND gradebook_id = ? ' => [ $skill_id, $gradebookId, ], ], ], 'first' ); return $result; } /** * @param int $skill_id * @param array $gradebook_list */ public function updateGradeBookListBySkill($skill_id, $gradebook_list) { $original_gradebook_list = $this->find( 'all', ['where' => ['skill_id = ?' => [$skill_id]]] ); $gradebooks_to_remove = []; $gradebooks_to_add = []; $original_gradebook_list_ids = []; if (!empty($original_gradebook_list)) { foreach ($original_gradebook_list as $gradebook) { if (!in_array($gradebook['gradebook_id'], $gradebook_list)) { $gradebooks_to_remove[] = $gradebook['id']; } } foreach ($original_gradebook_list as $gradebook_item) { $original_gradebook_list_ids[] = $gradebook_item['gradebook_id']; } } if (!empty($gradebook_list)) { foreach ($gradebook_list as $gradebook_id) { if (!in_array($gradebook_id, $original_gradebook_list_ids)) { $gradebooks_to_add[] = $gradebook_id; } } } if (!empty($gradebooks_to_remove)) { foreach ($gradebooks_to_remove as $id) { $this->delete($id); } } if (!empty($gradebooks_to_add)) { foreach ($gradebooks_to_add as $gradebook_id) { $attributes = [ 'skill_id' => $skill_id, 'gradebook_id' => $gradebook_id, ]; $this->save($attributes); } } } /** * @param array $params * * @return bool|void */ public function updateBySkill($params) { $skillInfo = $this->existsGradeBookSkill( $params['gradebook_id'], $params['skill_id'] ); if ($skillInfo) { return; } else { $result = $this->save($params); } if ($result) { return true; } return false; } } /** * Class SkillRelUser. */ class SkillRelUser extends Model { public $columns = [ 'id', 'user_id', 'skill_id', 'acquired_skill_at', 'assigned_by', 'course_id', 'session_id', ]; /** * Constructor. */ public function __construct() { $this->table = Database::get_main_table(TABLE_MAIN_SKILL_REL_USER); } /** * @param array $skill_list * * @return array */ public function getUserBySkills($skill_list) { $users = []; if (!empty($skill_list)) { $skill_list = array_map('intval', $skill_list); $skill_list = implode("', '", $skill_list); $sql = "SELECT user_id FROM {$this->table} WHERE skill_id IN ('$skill_list') "; $result = Database::query($sql); $users = Database::store_result($result, 'ASSOC'); } return $users; } /** * Get the achieved skills for the user. * * @param int $userId * @param int $courseId Optional. The course id * @param int $sessionId Optional. The session id * * @return array The skill list. Otherwise return false */ public function getUserSkills($userId, $courseId = 0, $sessionId = 0) { if (empty($userId)) { return []; } $courseId = (int) $courseId; $sessionId = $sessionId ? (int) $sessionId : null; $whereConditions = [ 'user_id = ? ' => (int) $userId, ]; if ($courseId > 0) { $whereConditions['AND course_id = ? '] = $courseId; $whereConditions['AND session_id = ?'] = $sessionId; } $result = Database::select( 'skill_id', $this->table, [ 'where' => $whereConditions, ], 'all' ); return $result; } /** * Get the relation data between user and skill. * * @param int $userId The user id * @param int $skillId The skill id * @param int $courseId Optional. The course id * @param int $sessionId Optional. The session id * * @return array The relation data. Otherwise return false */ public function getByUserAndSkill($userId, $skillId, $courseId = 0, $sessionId = 0) { $sql = "SELECT * FROM {$this->table} WHERE user_id = %d AND skill_id = %d "; if ($courseId > 0) { $sql .= "AND course_id = %d ".api_get_session_condition($sessionId, true); } $sql = sprintf( $sql, $userId, $skillId, $courseId ); $result = Database::query($sql); return Database::fetch_assoc($result); } /** * Get the URL for the issue. * * @param SkillRelUserEntity $skillIssue * * @return string */ public static function getIssueUrl(SkillRelUserEntity $skillIssue) { return api_get_path(WEB_PATH)."badge/{$skillIssue->getId()}"; } /** * Get the URL for the All issues page. * * @param SkillRelUserEntity $skillIssue * * @return string */ public static function getIssueUrlAll(SkillRelUserEntity $skillIssue) { return api_get_path(WEB_PATH)."skill/{$skillIssue->getSkill()->getId()}/user/{$skillIssue->getUser()->getId()}"; } /** * Get the URL for the assertion. * * @param SkillRelUserEntity $skillIssue * * @return string */ public static function getAssertionUrl(SkillRelUserEntity $skillIssue) { $url = api_get_path(WEB_CODE_PATH).'badge/assertion.php?'; $url .= http_build_query([ 'user' => $skillIssue->getUser()->getId(), 'skill' => $skillIssue->getSkill()->getId(), 'course' => $skillIssue->getCourse() ? $skillIssue->getCourse()->getId() : 0, 'session' => $skillIssue->getSession() ? $skillIssue->getSession()->getId() : 0, ]); return $url; } } /** * Class Skill. */ class Skill extends Model { public $columns = [ 'id', 'name', 'description', 'access_url_id', 'short_code', 'icon', 'criteria', ]; public $required = ['name']; /** Array of colours by depth, for the coffee wheel. Each depth has 4 col */ /*var $colours = array( 0 => array('#f9f0ab', '#ecc099', '#e098b0', '#ebe378'), 1 => array('#d5dda1', '#4a5072', '#8dae43', '#72659d'), 2 => array('#b28647', '#2e6093', '#393e64', '#1e8323'), 3 => array('#9f6652', '#9f6652', '#9f6652', '#9f6652'), 4 => array('#af643c', '#af643c', '#af643c', '#af643c'), 5 => array('#72659d', '#72659d', '#72659d', '#72659d'), 6 => array('#8a6e9e', '#8a6e9e', '#8a6e9e', '#8a6e9e'), 7 => array('#92538c', '#92538c', '#92538c', '#92538c'), 8 => array('#2e6093', '#2e6093', '#2e6093', '#2e6093'), 9 => array('#3a5988', '#3a5988', '#3a5988', '#3a5988'), 10 => array('#393e64', '#393e64', '#393e64', '#393e64'), );*/ public function __construct() { $this->table = Database::get_main_table(TABLE_MAIN_SKILL); $this->table_user = Database::get_main_table(TABLE_MAIN_USER); $this->table_skill_rel_gradebook = Database::get_main_table(TABLE_MAIN_SKILL_REL_GRADEBOOK); $this->table_skill_rel_user = Database::get_main_table(TABLE_MAIN_SKILL_REL_USER); $this->table_course = Database::get_main_table(TABLE_MAIN_COURSE); $this->table_skill_rel_skill = Database::get_main_table(TABLE_MAIN_SKILL_REL_SKILL); $this->table_gradebook = Database::get_main_table(TABLE_MAIN_GRADEBOOK_CATEGORY); $this->sessionTable = Database::get_main_table(TABLE_MAIN_SESSION); } /** * Gets an element. * * @param int $id * * @return array|mixed */ public function get($id) { $result = parent::get($id); if (empty($result)) { return []; } $path = api_get_path(WEB_UPLOAD_PATH).'badges/'; if (!empty($result['icon'])) { $iconSmall = sprintf( '%s-small.png', sha1($result['name']) ); $iconBig = sprintf( '%s.png', sha1($result['name']) ); $iconMini = $path.$iconSmall; $iconSmall = $path.$iconSmall; $iconBig = $path.$iconBig; } else { $iconMini = Display::returnIconPath('badges-default.png', ICON_SIZE_MEDIUM); $iconSmall = Display::returnIconPath('badges-default.png', ICON_SIZE_BIG); $iconBig = Display::returnIconPath('badges-default.png', ICON_SIZE_HUGE); } $result['icon_mini'] = $iconMini; $result['icon_small'] = $iconSmall; $result['icon_big'] = $iconBig; $result['img_mini'] = Display::img($iconBig, $result['name'], ['width' => ICON_SIZE_MEDIUM]); $result['img_big'] = Display::img($iconBig, $result['name']); $result['img_small'] = Display::img($iconSmall, $result['name']); $result['name'] = self::translateName($result['name']); $result['short_code'] = self::translateCode($result['short_code']); return $result; } /** * @param array $skills * @param string $imageSize mini|small|big * @param bool $addDivWrapper * * @return string */ public function processSkillList($skills, $imageSize = '', $addDivWrapper = true) { if (empty($skills)) { return ''; } if (empty($imageSize)) { $imageSize = 'img_small'; } else { $imageSize = "img_$imageSize"; } $html = ''; if ($addDivWrapper) { $html = '
'; } $html .= ''; if ($addDivWrapper) { $html .= '
'; } return $html; } /** * @param $skills * @param string $imageSize mini|small|big * @param string $style * @param bool $showBadge * @param bool $showTitle * * @return string */ public function processSkillListSimple($skills, $imageSize = '', $style = '', $showBadge = true, $showTitle = true) { if (empty($skills)) { return ''; } $isHierarchicalTable = api_get_configuration_value('table_of_hierarchical_skill_presentation'); if (empty($imageSize)) { $imageSize = 'img_small'; } else { $imageSize = "img_$imageSize"; } $html = ''; foreach ($skills as $skill) { if (isset($skill['data'])) { $skill = $skill['data']; } $item = ''; if ($showBadge) { $item = '
'.$skill[$imageSize].'
'; } $name = '
'.$skill['name'].'
'; if (!empty($skill['short_code'])) { $name = $skill['short_code']; } if (!$isHierarchicalTable) { //$item .= '
'; } if ($showTitle) { $item .= $name; } if (isset($skill['url'])) { $html .= Display::url($item, $skill['url'], ['target' => '_blank', 'style' => $style]); } else { $html .= Display::url($item, '#', ['target' => '_blank', 'style' => $style]); } } return $html; } /** * @param int $id * * @return array */ public function getSkillInfo($id) { $skillRelSkill = new SkillRelSkill(); $skillInfo = $this->get($id); if (!empty($skillInfo)) { $skillInfo['extra'] = $skillRelSkill->getSkillInfo($id); $skillInfo['gradebooks'] = $this->getGradebooksBySkill($id); } return $skillInfo; } /** * @param array $skill_list * * @return array */ public function getSkillsInfo($skill_list) { $skill_list = array_map('intval', $skill_list); $skill_list = implode("', '", $skill_list); $sql = "SELECT * FROM {$this->table} WHERE id IN ('$skill_list') "; $result = Database::query($sql); $skills = Database::store_result($result, 'ASSOC'); foreach ($skills as &$skill) { if (!$skill['icon']) { continue; } $skill['icon_small'] = sprintf( 'badges/%s-small.png', sha1($skill['name']) ); $skill['name'] = self::translateName($skill['name']); $skill['short_code'] = self::translateCode($skill['short_code']); } return $skills; } /** * @param bool $load_user_data * @param bool $user_id * @param int $id * @param int $parent_id * * @return array */ public function get_all( $load_user_data = false, $user_id = false, $id = null, $parent_id = null ) { $id_condition = ''; if (!empty($id)) { $id = (int) $id; $id_condition = " WHERE s.id = $id"; } if (!empty($parent_id)) { $parent_id = (int) $parent_id; if (empty($id_condition)) { $id_condition = " WHERE ss.parent_id = $parent_id"; } else { $id_condition = " AND ss.parent_id = $parent_id"; } } $sql = "SELECT s.id, s.name, s.description, ss.parent_id, ss.relation_type, s.icon, s.short_code, s.status FROM {$this->table} s INNER JOIN {$this->table_skill_rel_skill} ss ON (s.id = ss.skill_id) $id_condition ORDER BY ss.id, ss.parent_id"; $result = Database::query($sql); $skills = []; $webPath = api_get_path(WEB_UPLOAD_PATH); if (Database::num_rows($result)) { while ($row = Database::fetch_array($result, 'ASSOC')) { $skillInfo = self::get($row['id']); $row['img_mini'] = $skillInfo['img_mini']; $row['img_big'] = $skillInfo['img_big']; $row['img_small'] = $skillInfo['img_small']; $row['name'] = self::translateName($row['name']); $row['short_code'] = self::translateCode($row['short_code']); $skillRelSkill = new SkillRelSkill(); $parents = $skillRelSkill->getSkillParents($row['id']); $row['level'] = count($parents) - 1; $row['gradebooks'] = $this->getGradebooksBySkill($row['id']); $skills[$row['id']] = $row; } } // Load all children of the parent_id if (!empty($skills) && !empty($parent_id)) { foreach ($skills as $skill) { $children = self::get_all($load_user_data, $user_id, $id, $skill['id']); if (!empty($children)) { //$skills = array_merge($skills, $children); $skills = $skills + $children; } } } return $skills; } /** * @param int $skill_id * * @return array|resource */ public function getGradebooksBySkill($skill_id) { $skill_id = (int) $skill_id; $sql = "SELECT g.* FROM {$this->table_gradebook} g INNER JOIN {$this->table_skill_rel_gradebook} sg ON g.id = sg.gradebook_id WHERE sg.skill_id = $skill_id"; $result = Database::query($sql); $result = Database::store_result($result, 'ASSOC'); return $result; } /** * Get one level children. * * @param int $skill_id * @param bool $load_user_data * * @return array */ public function getChildren($skill_id, $load_user_data = false) { $skillRelSkill = new SkillRelSkill(); if ($load_user_data) { $user_id = api_get_user_id(); $skills = $skillRelSkill->getChildren($skill_id, true, $user_id); } else { $skills = $skillRelSkill->getChildren($skill_id); } return $skills; } /** * Get all children of the current node (recursive). * * @param int $skillId * * @return array */ public function getAllChildren($skillId) { $skillRelSkill = new SkillRelSkill(); $children = $skillRelSkill->getChildren($skillId); foreach ($children as $child) { $subChildren = $this->getAllChildren($child['id']); } if (!empty($subChildren)) { $children = array_merge($children, $subChildren); } return $children; } /** * Gets all parents from from the wanted skill. */ public function get_parents($skillId) { $skillRelSkill = new SkillRelSkill(); $skills = $skillRelSkill->getSkillParents($skillId, true); foreach ($skills as &$skill) { $skill['data'] = $this->get($skill['skill_id']); } return $skills; } /** * All direct parents. * * @param int $skillId * * @return array */ public function getDirectParents($skillId) { $skillRelSkill = new SkillRelSkill(); $skills = $skillRelSkill->getDirectParents($skillId, true); if (!empty($skills)) { foreach ($skills as &$skill) { $skillData = $this->get($skill['skill_id']); if (empty($skillData)) { continue; } $skill['data'] = $skillData; $skill_info2 = $skillRelSkill->getSkillInfo($skill['skill_id']); $parentId = isset($skill_info2['parent_id']) ? isset($skill_info2['parent_id']) : 0; $skill['data']['parent_id'] = $parentId; } return $skills; } return []; } /** * Adds a new skill. * * @param array $params * * @return bool|null */ public function add($params) { if (!isset($params['parent_id'])) { $params['parent_id'] = 1; } if (!is_array($params['parent_id'])) { $params['parent_id'] = [$params['parent_id']]; } $skillRelSkill = new SkillRelSkill(); $skillRelGradebook = new SkillRelGradebook(); // Saving name, description $skill_id = $this->save($params); if ($skill_id) { // Saving skill_rel_skill (parent_id, relation_type) foreach ($params['parent_id'] as $parent_id) { $relation_exists = $skillRelSkill->relationExists($skill_id, $parent_id); if (!$relation_exists) { $attributes = [ 'skill_id' => $skill_id, 'parent_id' => $parent_id, 'relation_type' => isset($params['relation_type']) ? $params['relation_type'] : 0, //'level' => $params['level'], ]; $skillRelSkill->save($attributes); } } if (!empty($params['gradebook_id'])) { foreach ($params['gradebook_id'] as $gradebook_id) { $attributes = []; $attributes['gradebook_id'] = $gradebook_id; $attributes['skill_id'] = $skill_id; $skillRelGradebook->save($attributes); } } return $skill_id; } return null; } /** * @param int $userId * @param Category $category * @param int $courseId * @param int $sessionId * * @return bool */ public function addSkillToUser( $userId, $category, $courseId, $sessionId ) { $skill_gradebook = new SkillRelGradebook(); $skill_rel_user = new SkillRelUser(); if (empty($category)) { return false; } // Load subcategories if (empty($category->get_parent_id())) { $subCategories = $category->get_subcategories( $userId, $category->get_course_code(), $category->get_session_id() ); if (!empty($subCategories)) { /** @var Category $subCategory */ foreach ($subCategories as $subCategory) { $this->addSkillToUser($userId, $subCategory, $courseId, $sessionId); } } } $gradebookId = $category->get_id(); $skill_gradebooks = $skill_gradebook->get_all(['where' => ['gradebook_id = ?' => $gradebookId]]); if (!empty($skill_gradebooks)) { foreach ($skill_gradebooks as $skill_gradebook) { $hasSkill = $this->userHasSkill( $userId, $skill_gradebook['skill_id'], $courseId, $sessionId ); if (!$hasSkill) { $params = [ 'user_id' => $userId, 'skill_id' => $skill_gradebook['skill_id'], 'acquired_skill_at' => api_get_utc_datetime(), 'course_id' => (int) $courseId, 'session_id' => $sessionId ? (int) $sessionId : null, ]; $skill_rel_user->save($params); } } } return true; } /* Deletes a skill */ public function delete($skill_id) { /*$params = array('skill_id' => $skill_id); $skillRelSkill = new SkillRelSkill(); $skills = $skillRelSkill->get_all(array('where'=>array('skill_id = ?' =>$skill_id))); $skill_rel_profile = new SkillRelProfile(); $skillRelGradebook = new SkillRelGradebook(); $skill_rel_user = new SkillRelUser(); $this->delete($skill_id); $skillRelGradebook->delete($params);*/ } /** * @param array $params */ public function edit($params) { if (!isset($params['parent_id'])) { $params['parent_id'] = 1; } $params['gradebook_id'] = isset($params['gradebook_id']) ? $params['gradebook_id'] : []; $skillRelSkill = new SkillRelSkill(); $skillRelGradebook = new SkillRelGradebook(); // Saving name, description $this->update($params); $skillId = $params['id']; if ($skillId) { // Saving skill_rel_skill (parent_id, relation_type) if (!is_array($params['parent_id'])) { $params['parent_id'] = [$params['parent_id']]; } // Cannot change parent of root if ($skillId == 1) { $params['parent_id'] = 0; } foreach ($params['parent_id'] as $parent_id) { $relation_exists = $skillRelSkill->relationExists($skillId, $parent_id); if (!$relation_exists) { $attributes = [ 'skill_id' => $skillId, 'parent_id' => $parent_id, 'relation_type' => $params['relation_type'], //'level' => $params['level'], ]; $skillRelSkill->updateBySkill($attributes); } } $skillRelGradebook->updateGradeBookListBySkill( $skillId, $params['gradebook_id'] ); return $skillId; } return null; } /** * Get user's skills. * * @param int $userId * @param bool $getSkillData * @param int $courseId * @param int $sessionId * * @return array */ public function getUserSkills($userId, $getSkillData = false, $courseId = 0, $sessionId = 0) { $userId = (int) $userId; $courseId = (int) $courseId; $sessionId = (int) $sessionId; $courseCondition = ''; if (!empty($courseId)) { $courseCondition = " AND course_id = $courseId "; } $sessionCondition = ''; if (!empty($sessionId)) { $sessionCondition = " AND course_id = $sessionId "; } $sql = 'SELECT DISTINCT s.id, s.name, s.icon, u.id as issue, u.acquired_skill_at, u.course_id FROM '.$this->table_skill_rel_user.' u INNER JOIN '.$this->table.' s ON u.skill_id = s.id WHERE user_id = '.$userId.' '.$sessionCondition.' '.$courseCondition; $result = Database::query($sql); $skills = Database::store_result($result, 'ASSOC'); $skillList = []; if (!empty($skills)) { foreach ($skills as $skill) { if ($getSkillData) { $skillData = $this->get($skill['id']); $skillData['url'] = api_get_path(WEB_PATH).'badge/'.$skill['id'].'/user/'.$userId; $skillList[$skill['id']] = array_merge($skill, $skillData); } else { $skillList[$skill['id']] = $skill['id']; } } } return $skillList; } /** * @param Vertex $vertex * @param array $skills * @param int $level * * @return string */ public function processVertex(Vertex $vertex, $skills = [], $level = 0) { $isHierarchicalTable = api_get_configuration_value('table_of_hierarchical_skill_presentation'); $subTable = ''; if ($vertex->getVerticesEdgeTo()->count() > 0) { if ($isHierarchicalTable) { $subTable .= ''; } } return $subTable; } /** * @param int $userId * @param int $courseId * @param int $sessionId * @param bool $addTitle * * @return array */ public function getUserSkillsTable($userId, $courseId = 0, $sessionId = 0, $addTitle = true) { $skills = $this->getUserSkills($userId, true, $courseId, $sessionId); $courseTempList = []; $tableRows = []; $skillParents = []; foreach ($skills as $resultData) { $parents = $this->get_parents($resultData['id']); foreach ($parents as $parentData) { $parentData['passed'] = in_array($parentData['id'], array_keys($skills)); if ($parentData['passed'] && isset($skills[$parentData['id']]['url'])) { $parentData['data']['url'] = $skills[$parentData['id']]['url']; } $skillParents[$resultData['id']][$parentData['id']] = $parentData; } } foreach ($skills as $resultData) { $courseId = $resultData['course_id']; if (!empty($courseId)) { if (isset($courseTempList[$courseId])) { $courseInfo = $courseTempList[$courseId]; } else { $courseInfo = api_get_course_info_by_id($courseId); $courseTempList[$courseId] = $courseInfo; } } $tableRow = [ 'skill_badge' => $resultData['img_small'], 'skill_name' => self::translateName($resultData['name']), 'short_code' => $resultData['short_code'], 'skill_url' => $resultData['url'], 'achieved_at' => api_get_local_time($resultData['acquired_skill_at']), 'course_image' => '', 'course_name' => '', ]; if (!empty($courseInfo)) { $tableRow['course_image'] = $courseInfo['course_image']; $tableRow['course_name'] = $courseInfo['title']; } $tableRows[] = $tableRow; } $isHierarchicalTable = api_get_configuration_value('table_of_hierarchical_skill_presentation'); $allowLevels = api_get_configuration_value('skill_levels_names'); $tableResult = '
'; if ($isHierarchicalTable) { $tableResult = '
'; } if ($addTitle) { $tableResult .= '

'.get_lang('AchievedSkills').'

'; } if (!empty($skillParents)) { if (empty($allowLevels)) { $tableResult .= $this->processSkillListSimple($skills); } else { $graph = new Graph(); $graph->setAttribute('graphviz.graph.rankdir', 'LR'); foreach ($skillParents as $skillId => $parentList) { $old = null; foreach ($parentList as $parent) { if ($graph->hasVertex($parent['id'])) { $current = $graph->getVertex($parent['id']); } else { $current = $graph->createVertex($parent['id']); $current->setAttribute('graphviz.data', $parent['data']); } if (!empty($old)) { if ($graph->hasVertex($old['id'])) { $nextVertex = $graph->getVertex($old['id']); } else { $nextVertex = $graph->createVertex($old['id']); $nextVertex->setAttribute('graphviz.data', $old['data']); } if (!$nextVertex->hasEdgeTo($current)) { $nextVertex->createEdgeTo($current); } } $old = $parent; } } if ($isHierarchicalTable) { $table = ''; // Getting "root" vertex $root = $graph->getVertex(1); $table .= ''; /** @var Vertex $vertex */ foreach ($root->getVerticesEdgeTo() as $vertex) { $data = $vertex->getAttribute('graphviz.data'); $passed = in_array($data['id'], array_keys($skills)); $transparency = ''; if ($passed === false) { // @todo use a css class $transparency = 'opacity: 0.4; filter: alpha(opacity=40);'; } $label = $this->processSkillListSimple([$data], 'mini', $transparency); $table .= ''; } $table .= '
'; $table .= '
  • '.$label; $table .= $this->processVertex($vertex, $skills); $table .= '
'; $table .= '
'; } else { // Getting "root" vertex $root = $graph->getVertex(1); $table = ''; /** @var Vertex $vertex */ foreach ($root->getVerticesEdgeTo() as $vertex) { $data = $vertex->getAttribute('graphviz.data'); $passed = in_array($data['id'], array_keys($skills)); $transparency = ''; if ($passed === false) { // @todo use a css class $transparency = 'opacity: 0.4; filter: alpha(opacity=40);'; } $label = $this->processSkillListSimple([$data], 'mini', $transparency, false); $skillTable = $this->processVertex($vertex, $skills, 2); $table .= "

$label

"; if (!empty($skillTable)) { $table .= ''; $table .= ''; $table .= ''; $table .= '
'; $table .= '
'; $table .= $skillTable; $table .= '
'; $table .= '
'; } } } $tableResult .= $table; } } else { $tableResult .= get_lang('WithoutAchievedSkills'); } if ($addTitle) { $tableResult .= '
'; } $tableResult .= '
'; return [ 'skills' => $tableRows, 'table' => $tableResult, ]; } /** * @param int $user_id * @param int $skill_id * @param bool $return_flat_array * @param bool $add_root * * @return array|null */ public function getSkillsTree( $user_id = null, $skill_id = null, $return_flat_array = false, $add_root = false ) { if ($skill_id == 1) { $skill_id = 0; } if (isset($user_id) && !empty($user_id)) { $skills = $this->get_all(true, $user_id, null, $skill_id); } else { $skills = $this->get_all(false, false, null, $skill_id); } $original_skill = $this->list = $skills; // Show 1 item if (!empty($skill_id)) { if ($add_root) { if (!empty($skill_id)) { // Default root node $skills[1] = [ 'id' => '1', 'name' => get_lang('Root'), 'parent_id' => '0', 'status' => 1, ]; $skillInfo = $this->getSkillInfo($skill_id); // 2nd node $skills[$skill_id] = $skillInfo; // Uncomment code below to hide the searched skill $skills[$skill_id]['data']['parent_id'] = $skillInfo['extra']['parent_id']; $skills[$skill_id]['parent_id'] = 1; } } } $refs = []; $skills_tree = null; // Create references for all nodes $flat_array = []; $family = []; if (!empty($skills)) { foreach ($skills as &$skill) { if ($skill['parent_id'] == 0) { $skill['parent_id'] = 'root'; } // because except main keys (id, name, children) others keys // are not saved while in the space tree $skill['data'] = ['parent_id' => $skill['parent_id']]; // If a short code was defined, send the short code to replace // skill name (to shorten the text in the wheel) if (!empty($skill['short_code']) && api_get_setting('show_full_skill_name_on_skill_wheel') === 'false' ) { $skill['data']['short_code'] = $skill['short_code']; } $skill['data']['name'] = $skill['name']; $skill['data']['status'] = $skill['status']; // In order to paint all members of a family with the same color if (empty($skill_id)) { if ($skill['parent_id'] == 1) { $family[$skill['id']] = $this->getAllChildren($skill['id']); } } else { if ($skill['parent_id'] == $skill_id) { $family[$skill['id']] = $this->getAllChildren($skill['id']); } /*if ($skill_id == $skill['id']) { $skill['parent_id'] = 1; }*/ } if (!isset($skill['data']['real_parent_id'])) { $skill['data']['real_parent_id'] = $skill['parent_id']; } // User achieved the skill (depends in the gradebook with certification) $skill['data']['achieved'] = false; if ($user_id) { $skill['data']['achieved'] = $this->userHasSkill( $user_id, $skill['id'] ); } // Check if the skill has related gradebooks $skill['data']['skill_has_gradebook'] = false; if (isset($skill['gradebooks']) && !empty($skill['gradebooks'])) { $skill['data']['skill_has_gradebook'] = true; } $refs[$skill['id']] = &$skill; $flat_array[$skill['id']] = &$skill; } // Checking family value $family_id = 1; $new_family_array = []; foreach ($family as $main_family_id => $family_items) { if (!empty($family_items)) { foreach ($family_items as $item) { $new_family_array[$item['id']] = $family_id; } } $new_family_array[$main_family_id] = $family_id; $family_id++; } if (empty($original_skill)) { $refs['root']['children'][0] = $skills[1]; $skills[$skill_id]['data']['family_id'] = 1; $refs['root']['children'][0]['children'][0] = $skills[$skill_id]; $flat_array[$skill_id] = $skills[$skill_id]; } else { // Moving node to the children index of their parents foreach ($skills as $my_skill_id => &$skill) { if (isset($new_family_array[$skill['id']])) { $skill['data']['family_id'] = $new_family_array[$skill['id']]; } $refs[$skill['parent_id']]['children'][] = &$skill; $flat_array[$my_skill_id] = $skill; } } $skills_tree = [ 'name' => get_lang('SkillRootName'), 'id' => 'root', 'children' => $refs['root']['children'], 'data' => [], ]; } if ($return_flat_array) { return $flat_array; } unset($skills); return $skills_tree; } /** * Get skills tree as a simplified JSON structure. * * @param int user id * @param int skill id * @param bool return a flat array or not * @param int depth of the skills * * @return string json */ public function getSkillsTreeToJson( $user_id = null, $skill_id = null, $return_flat_array = false, $main_depth = 2 ) { $tree = $this->getSkillsTree( $user_id, $skill_id, $return_flat_array, true ); $simple_tree = []; if (!empty($tree['children'])) { foreach ($tree['children'] as $element) { $children = []; if (isset($element['children'])) { $children = $this->getSkillToJson($element['children'], 1, $main_depth); } $simple_tree[] = [ 'name' => $element['name'], 'children' => $children, ]; } } return json_encode($simple_tree[0]['children']); } /** * Get JSON element. * * @param array $subtree * @param int $depth * @param int $max_depth * * @return array|null */ public function getSkillToJson($subtree, $depth = 1, $max_depth = 2) { $simple_sub_tree = []; if (is_array($subtree)) { $counter = 1; foreach ($subtree as $elem) { $tmp = []; $tmp['name'] = $elem['name']; $tmp['id'] = $elem['id']; $tmp['isSearched'] = self::isSearched($elem['id']); if (isset($elem['children']) && is_array($elem['children'])) { $tmp['children'] = $this->getSkillToJson( $elem['children'], $depth + 1, $max_depth ); } if ($depth > $max_depth) { continue; } $tmp['depth'] = $depth; $tmp['counter'] = $counter; $counter++; if (isset($elem['data']) && is_array($elem['data'])) { foreach ($elem['data'] as $key => $item) { $tmp[$key] = $item; } } $simple_sub_tree[] = $tmp; } return $simple_sub_tree; } return null; } /** * @param int $user_id * * @return bool */ public function getUserSkillRanking($user_id) { $user_id = (int) $user_id; $sql = "SELECT count(skill_id) count FROM {$this->table} s INNER JOIN {$this->table_skill_rel_user} su ON (s.id = su.skill_id) WHERE user_id = $user_id"; $result = Database::query($sql); if (Database::num_rows($result)) { $result = Database::fetch_row($result); return $result[0]; } return false; } /** * @param $start * @param $limit * @param $sidx * @param $sord * @param $where_condition * * @return array */ public function getUserListSkillRanking( $start, $limit, $sidx, $sord, $where_condition ) { $start = (int) $start; $limit = (int) $limit; /* ORDER BY $sidx $sord */ $sql = "SELECT *, @rownum:=@rownum+1 rank FROM ( SELECT u.user_id, firstname, lastname, count(username) skills_acquired FROM {$this->table} s INNER JOIN {$this->table_skill_rel_user} su ON (s.id = su.skill_id) INNER JOIN {$this->table_user} u ON u.user_id = su.user_id, (SELECT @rownum:=0) r WHERE 1=1 $where_condition GROUP BY username ORDER BY skills_acquired desc LIMIT $start , $limit) AS T1, (SELECT @rownum:=0) r"; $result = Database::query($sql); if (Database::num_rows($result)) { return Database::store_result($result, 'ASSOC'); } return []; } /** * @return int */ public function getUserListSkillRankingCount() { $sql = "SELECT count(*) FROM ( SELECT count(distinct 1) FROM {$this->table} s INNER JOIN {$this->table_skill_rel_user} su ON (s.id = su.skill_id) INNER JOIN {$this->table_user} u ON u.user_id = su.user_id GROUP BY username ) as T1"; $result = Database::query($sql); if (Database::num_rows($result)) { $result = Database::fetch_row($result); return $result[0]; } return 0; } /** * @param string $courseCode * * @return int */ public function getCountSkillsByCourse($courseCode) { $courseCode = Database::escape_string($courseCode); $sql = "SELECT count(skill_id) as count FROM {$this->table_gradebook} g INNER JOIN {$this->table_skill_rel_gradebook} sg ON g.id = sg.gradebook_id WHERE course_code = '$courseCode'"; $result = Database::query($sql); if (Database::num_rows($result)) { $result = Database::fetch_row($result); return $result[0]; } return 0; } /** * @param int $skillId * * @return array */ public function getCoursesBySkill($skillId) { $skillId = (int) $skillId; $sql = "SELECT c.title, c.code FROM {$this->table_gradebook} g INNER JOIN {$this->table_skill_rel_gradebook} sg ON g.id = sg.gradebook_id INNER JOIN {$this->table_course} c ON c.code = g.course_code WHERE sg.skill_id = $skillId AND (g.session_id IS NULL OR g.session_id = 0)"; $result = Database::query($sql); return Database::store_result($result, 'ASSOC'); } /** * Check if the user has the skill. * * @param int $userId The user id * @param int $skillId The skill id * @param int $courseId Optional. The course id * @param int $sessionId Optional. The session id * * @return bool Whether the user has the skill return true. Otherwise return false */ public function userHasSkill($userId, $skillId, $courseId = 0, $sessionId = 0) { $courseId = (int) $courseId; $sessionId = (int) $sessionId; $whereConditions = [ 'user_id = ? ' => (int) $userId, 'AND skill_id = ? ' => (int) $skillId, ]; if ($courseId > 0) { $whereConditions['AND course_id = ? '] = $courseId; $whereConditions['AND session_id = ? '] = $sessionId ? $sessionId : null; } $result = Database::select( 'COUNT(1) AS qty', $this->table_skill_rel_user, [ 'where' => $whereConditions, ], 'first' ); if ($result != false) { if ($result['qty'] > 0) { return true; } } return false; } /** * Check if a skill is searched. * * @param int $id The skill id * * @return bool Whether el skill is searched return true. Otherwise return false */ public static function isSearched($id) { $id = (int) $id; if (empty($id)) { return false; } $skillRelProfileTable = Database::get_main_table(TABLE_MAIN_SKILL_REL_PROFILE); $result = Database::select( 'COUNT( DISTINCT `skill_id`) AS qty', $skillRelProfileTable, [ 'where' => [ 'skill_id = ?' => $id, ], ], 'first' ); if ($result === false) { return false; } if ($result['qty'] > 0) { return true; } return false; } /** * Get the achieved skills by course. * * @param int $courseId The course id * * @return array The skills list */ public function listAchievedByCourse($courseId) { $courseId = (int) $courseId; if ($courseId == 0) { return []; } $list = []; $sql = "SELECT course.id c_id, course.title c_name, course.directory c_directory, user.user_id, user.lastname, user.firstname, user.username, skill.id skill_id, skill.name skill_name, sru.acquired_skill_at FROM {$this->table_skill_rel_user} AS sru INNER JOIN {$this->table_course} ON sru.course_id = course.id INNER JOIN {$this->table_user} ON sru.user_id = user.user_id INNER JOIN {$this->table} ON sru.skill_id = skill.id WHERE course.id = $courseId"; $result = Database::query($sql); while ($row = Database::fetch_assoc($result)) { $row['skill_name'] = self::translateName($row['skill_name']); $list[] = $row; } return $list; } /** * Get the users list who achieved a skill. * * @param int $skillId The skill id * * @return array The users list */ public function listUsersWhoAchieved($skillId) { $skillId = (int) $skillId; if ($skillId == 0) { return []; } $list = []; $sql = "SELECT course.id c_id, course.title c_name, course.directory c_directory, user.user_id, user.lastname, user.firstname, user.username, skill.id skill_id, skill.name skill_name, sru.acquired_skill_at FROM {$this->table_skill_rel_user} AS sru INNER JOIN {$this->table_course} ON sru.course_id = course.id INNER JOIN {$this->table_user} ON sru.user_id = user.user_id INNER JOIN {$this->table} ON sru.skill_id = skill.id WHERE skill.id = $skillId "; $result = Database::query($sql); while ($row = Database::fetch_assoc($result)) { $row['skill_name'] = self::translateName($row['skill_name']); $list[] = $row; } return $list; } /** * Get the session list where the user can achieve a skill. * * @param int $skillId The skill id * * @return array */ public function getSessionsBySkill($skillId) { $skillId = (int) $skillId; $sql = "SELECT s.id, s.name FROM {$this->table_gradebook} g INNER JOIN {$this->table_skill_rel_gradebook} sg ON g.id = sg.gradebook_id INNER JOIN {$this->sessionTable} s ON g.session_id = s.id WHERE sg.skill_id = $skillId AND g.session_id > 0"; $result = Database::query($sql); return Database::store_result($result, 'ASSOC'); } /** * Check if the $fromUser can comment the $toUser skill issue. * * @param User $fromUser * @param User $toUser * * @return bool */ public static function userCanAddFeedbackToUser($fromUser, $toUser) { if (api_is_platform_admin()) { return true; } $userRepo = UserManager::getRepository(); $fromUserStatus = $fromUser->getStatus(); switch ($fromUserStatus) { case SESSIONADMIN: if (api_get_setting('allow_session_admins_to_manage_all_sessions') === 'true') { if ($toUser->getCreatorId() === $fromUser->getId()) { return true; } } $sessionAdmins = $userRepo->getSessionAdmins($toUser); foreach ($sessionAdmins as $sessionAdmin) { if ($sessionAdmin->getId() !== $fromUser->getId()) { continue; } return true; } break; case STUDENT_BOSS: $studentBosses = $userRepo->getStudentBosses($toUser); foreach ($studentBosses as $studentBoss) { if ($studentBoss->getId() !== $fromUser->getId()) { continue; } return true; } break; case DRH: return UserManager::is_user_followed_by_drh( $toUser->getId(), $fromUser->getId() ); } return false; } /** * If $studentId is set then check if current user has the right to see * the page. * * @param int $studentId check if current user has access to see $studentId * @param bool $blockPage raise a api_not_allowed() * * @return bool */ public static function isAllowed($studentId = 0, $blockPage = true) { $allowHR = api_get_setting('allow_hr_skills_management') === 'true'; if (self::isToolAvailable()) { if (api_is_platform_admin(false, $allowHR)) { return true; } if (!empty($studentId)) { $currentUserId = api_get_user_id(); if ((int) $currentUserId === (int) $studentId) { return true; } $haveAccess = self::hasAccessToUserSkill( $currentUserId, $studentId ); if ($haveAccess) { return true; } } } if ($blockPage) { api_not_allowed(true); } return false; } /** * @return bool */ public static function isToolAvailable() { $allowTool = api_get_setting('allow_skills_tool'); if ($allowTool === 'true') { return true; } return false; } /** * @param int $currentUserId * @param int $studentId * * @return bool */ public static function hasAccessToUserSkill($currentUserId, $studentId) { if (self::isToolAvailable()) { if (api_is_platform_admin()) { return true; } $currentUserId = (int) $currentUserId; $studentId = (int) $studentId; if ($currentUserId === $studentId) { return true; } if (api_is_student_boss()) { $isBoss = UserManager::userIsBossOfStudent($currentUserId, $studentId); if ($isBoss) { return true; } } $allow = api_get_configuration_value('allow_private_skills'); if ($allow === true) { if (api_is_teacher()) { return UserManager::isTeacherOfStudent( $currentUserId, $studentId ); } if (api_is_drh()) { return UserManager::is_user_followed_by_drh( $studentId, $currentUserId ); } } } return false; } /** * Get skills. * * @param int $userId * @param int level * * @return array */ public function getStudentSkills($userId, $level = 0) { $userId = (int) $userId; $sql = "SELECT s.id, s.name, sru.acquired_skill_at FROM {$this->table} s INNER JOIN {$this->table_skill_rel_user} sru ON s.id = sru.skill_id WHERE sru.user_id = $userId"; $result = Database::query($sql); $skills = []; foreach ($result as $item) { if (empty($level)) { $skills[] = [ 'name' => self::translateName($item['name']), 'acquired_skill_at' => $item['acquired_skill_at'], ]; } else { $parents = self::get_parents($item['id']); // +2 because it takes into account the root if (count($parents) == $level + 1) { $skills[] = [ 'name' => self::translateName($item['name']), 'acquired_skill_at' => $item['acquired_skill_at'], ]; } } } return $skills; } /** * @param string $name * * @return string */ public static function translateName($name) { $variable = ChamiloApi::getLanguageVar($name, 'Skill'); return isset($GLOBALS[$variable]) ? $GLOBALS[$variable] : $name; } /** * @param string $code * * @return mixed|string */ public static function translateCode($code) { if (empty($code)) { return ''; } $variable = ChamiloApi::getLanguageVar($code, 'SkillCode'); return isset($GLOBALS[$variable]) ? $GLOBALS[$variable] : $code; } /** * @param FormValidator $form * @param array $skillInfo * * @return array */ public function setForm(FormValidator &$form, $skillInfo = []) { $allSkills = $this->get_all(); $objGradebook = new Gradebook(); $isAlreadyRootSkill = false; foreach ($allSkills as $checkedSkill) { if (intval($checkedSkill['parent_id']) > 0) { $isAlreadyRootSkill = true; break; } } $skillList = $isAlreadyRootSkill ? [] : [0 => get_lang('None')]; foreach ($allSkills as $skill) { if (isset($skillInfo['id']) && $skill['id'] == $skillInfo['id']) { continue; } $skillList[$skill['id']] = $skill['name']; } $allGradeBooks = $objGradebook->find('all'); // This procedure is for check if there is already a Skill with no Parent (Root by default) $gradeBookList = []; foreach ($allGradeBooks as $gradebook) { $gradeBookList[$gradebook['id']] = $gradebook['name']; } $translateUrl = api_get_path(WEB_CODE_PATH).'admin/skill_translate.php?'; $translateNameButton = ''; $translateCodeButton = ''; $skillId = null; if (!empty($skillInfo)) { $skillId = $skillInfo['id']; $translateNameUrl = $translateUrl.http_build_query(['skill' => $skillId, 'action' => 'name']); $translateCodeUrl = $translateUrl.http_build_query(['skill' => $skillId, 'action' => 'code']); $translateNameButton = Display::toolbarButton( get_lang('TranslateThisTerm'), $translateNameUrl, 'language', 'link' ); $translateCodeButton = Display::toolbarButton( get_lang('TranslateThisTerm'), $translateCodeUrl, 'language', 'link' ); } $form->addText('name', [get_lang('Name'), $translateNameButton], true, ['id' => 'name']); $form->addText('short_code', [get_lang('ShortCode'), $translateCodeButton], false, ['id' => 'short_code']); // Cannot change parent of root if ($skillId != 1) { $form->addSelect('parent_id', get_lang('Parent'), $skillList, ['id' => 'parent_id']); } $form->addSelect( 'gradebook_id', [get_lang('Gradebook'), get_lang('WithCertificate')], $gradeBookList, ['id' => 'gradebook_id', 'multiple' => 'multiple', 'size' => 10] ); $form->addTextarea('description', get_lang('Description'), ['id' => 'description', 'rows' => 7]); $form->addTextarea('criteria', get_lang('CriteriaToEarnTheBadge'), ['id' => 'criteria', 'rows' => 7]); // EXTRA FIELDS $extraField = new ExtraField('skill'); $returnParams = $extraField->addElements($form, $skillId); if (empty($skillInfo)) { $form->addButtonCreate(get_lang('Add')); } else { $form->addButtonUpdate(get_lang('Update')); $form->addHidden('id', $skillInfo['id']); } return $returnParams; } /** * @return string */ public function getToolBar() { $toolbar = Display::url( Display::return_icon( 'back.png', get_lang('ManageSkills'), null, ICON_SIZE_MEDIUM ), api_get_path(WEB_CODE_PATH).'admin/skill_list.php' ); $actions = '
'.$toolbar.'
'; return $actions; } /** * @param \Chamilo\SkillBundle\Entity\SkillRelItem $skillRelItem * @param \Chamilo\SkillBundle\Entity\SkillRelItemRelUser $skillRelItemRelUser * @param bool $addHeader * * @return string */ public static function getUserSkillStatusLabel($skillRelItem, $skillRelItemRelUser, $addHeader = true) { if (empty($skillRelItem)) { return ''; } $type = 'success'; if (empty($skillRelItemRelUser)) { $type = 'danger'; } $label = ''; $skill = $skillRelItem->getSkill(); if ($addHeader) { $label .= ''; } $label .= Display::label($skill->getName(), $type); if ($addHeader) { $label .= ' '; } return $label; } /** * Assign a user with a SkilRelItem object. * * @param FormValidator $form * @param int $typeId see ITEM_TYPE_* constants * @param int $itemId * @param int $userId */ public static function addSkillsToUserForm(FormValidator $form, $typeId, $itemId, $userId, $resultId = 0, $addHeader = false) { $allowSkillInTools = api_get_configuration_value('allow_skill_rel_items'); if ($allowSkillInTools && !empty($typeId) && !empty($itemId) && !empty($userId)) { $em = Database::getManager(); $items = $em->getRepository('ChamiloSkillBundle:SkillRelItem')->findBy( ['itemId' => $itemId, 'itemType' => $typeId] ); $skillRelUser = new SkillRelUser(); $skillUserList = $skillRelUser->getUserSkills($userId); if (!empty($skillUserList)) { $skillUserList = array_column($skillUserList, 'skill_id'); } $skills = ''; /** @var SkillRelItem $skillRelItem */ foreach ($items as $skillRelItem) { $criteria = [ 'user' => $userId, 'skillRelItem' => $skillRelItem, ]; $skillRelItemRelUser = $em->getRepository('ChamiloSkillBundle:SkillRelItemRelUser')->findOneBy($criteria); $skills .= self::getUserSkillStatusLabel($skillRelItem, $skillRelItemRelUser); } if (!empty($skills)) { $url = api_get_path(WEB_AJAX_PATH).'skill.ajax.php?a=update_skill_rel_user&'.api_get_cidreq(); $params = [ 'item_id' => $itemId, 'type_id' => $typeId, 'user_id' => $userId, 'course_id' => api_get_course_int_id(), 'session_id' => api_get_session_id(), 'result_id' => $resultId, ]; $params = json_encode($params); if ($addHeader) { $form->addHtml(Display::page_subheader2(get_lang('Skills'))); } $html = ' '; $form->addHtml($html); $form->addLabel(get_lang('Skills'), $skills); if ($addHeader) { $form->addHtml('
'); } } } } /** * Add skills select ajax for an item (exercise, lp). * * @param FormValidator $form * @param int $typeId see ITEM_TYPE_* constants * @param int $itemId * * @throws Exception * * @return array */ public static function addSkillsToForm(FormValidator $form, $typeId, $itemId = 0) { $allowSkillInTools = api_get_configuration_value('allow_skill_rel_items'); if (!$allowSkillInTools) { return []; } $skillList = []; if (!empty($itemId)) { $em = Database::getManager(); $items = $em->getRepository('ChamiloSkillBundle:SkillRelItem')->findBy( ['itemId' => $itemId, 'itemType' => $typeId] ); /** @var SkillRelItem $skillRelItem */ foreach ($items as $skillRelItem) { $skillList[$skillRelItem->getSkill()->getId()] = $skillRelItem->getSkill()->getName(); } } $courseId = api_get_course_int_id(); $sessionId = api_get_session_id(); $url = api_get_path(WEB_AJAX_PATH). 'skill.ajax.php?a=search_skills_in_course&course_id='.$courseId.'&session_id='.$sessionId; $form->addSelectAjax( 'skills', get_lang('Skills'), $skillList, [ 'url' => $url, 'multiple' => 'multiple', ] ); return $skillList; } /** * @param int $courseId * @param int $sessionId * * @return array */ public static function getSkillRelItemsPerCourse($courseId, $sessionId = null) { $allowSkillInTools = api_get_configuration_value('allow_skill_rel_items'); $skills = []; if (empty($sessionId)) { $sessionId = null; } if ($allowSkillInTools) { $em = Database::getManager(); $skills = $em->getRepository('ChamiloSkillBundle:SkillRelItem')->findBy( ['courseId' => $courseId, 'sessionId' => $sessionId] ); } return $skills; } /** * @param int $itemId * @param int $itemType * * @return array */ public static function getItemInfo($itemId, $itemType) { $itemInfo = []; $itemId = (int) $itemId; $itemType = (int) $itemType; $em = Database::getManager(); switch ($itemType) { case ITEM_TYPE_EXERCISE: /** @var \Chamilo\CourseBundle\Entity\CQuiz $item */ $item = $em->getRepository('ChamiloCourseBundle:CQuiz')->find($itemId); if ($item) { $itemInfo['name'] = $item->getTitle(); } break; case ITEM_TYPE_HOTPOTATOES: break; case ITEM_TYPE_LINK: /** @var \Chamilo\CourseBundle\Entity\CLink $item */ $item = $em->getRepository('ChamiloCourseBundle:CLink')->find($itemId); if ($item) { $itemInfo['name'] = $item->getTitle(); } break; case ITEM_TYPE_LEARNPATH: /** @var \Chamilo\CourseBundle\Entity\CLp $item */ $item = $em->getRepository('ChamiloCourseBundle:CLp')->find($itemId); if ($item) { $itemInfo['name'] = $item->getName(); } break; case ITEM_TYPE_GRADEBOOK: break; case ITEM_TYPE_STUDENT_PUBLICATION: /** @var \Chamilo\CourseBundle\Entity\CStudentPublication $item */ $item = $em->getRepository('ChamiloCourseBundle:CStudentPublication')->find($itemId); if ($item) { $itemInfo['name'] = $item->getTitle(); } break; //ITEM_TYPE_FORUM', 7); case ITEM_TYPE_ATTENDANCE: /** @var \Chamilo\CourseBundle\Entity\CAttendance $item */ $item = $em->getRepository('ChamiloCourseBundle:CAttendance')->find($itemId); if ($item) { $itemInfo['name'] = $item->getName(); } break; case ITEM_TYPE_SURVEY: /** @var \Chamilo\CourseBundle\Entity\CSurvey $item */ $item = $em->getRepository('ChamiloCourseBundle:CSurvey')->find($itemId); if ($item) { $itemInfo['name'] = strip_tags($item->getTitle()); } break; case ITEM_TYPE_FORUM_THREAD: /** @var \Chamilo\CourseBundle\Entity\CForumThread $item */ $item = $em->getRepository('ChamiloCourseBundle:CForumThread')->find($itemId); if ($item) { $itemInfo['name'] = $item->getThreadTitle(); } break; } return $itemInfo; } /** * @param int $typeId * @param int $itemId * * @return array */ public static function getSkillRelItems($typeId, $itemId) { $allowSkillInTools = api_get_configuration_value('allow_skill_rel_items'); $skills = []; if ($allowSkillInTools) { $em = Database::getManager(); $skills = $em->getRepository('ChamiloSkillBundle:SkillRelItem')->findBy( ['itemId' => $itemId, 'itemType' => $typeId] ); } return $skills; } /** * @param int $typeId * @param int $itemId * * @return string */ public static function getSkillRelItemsToString($typeId, $itemId) { $skills = self::getSkillRelItems($typeId, $itemId); $skillToString = ''; if (!empty($skills)) { /** @var SkillRelItem $skillRelItem */ $skillList = []; foreach ($skills as $skillRelItem) { $skillList[] = Display::label($skillRelItem->getSkill()->getName(), 'success'); } $skillToString = ' '.implode(' ', $skillList); } return $skillToString; } /** * @param int $itemId * @param int $typeId */ public static function deleteSkillsFromItem($itemId, $typeId) { $allowSkillInTools = api_get_configuration_value('allow_skill_rel_items'); if ($allowSkillInTools) { $itemId = (int) $itemId; $typeId = (int) $typeId; $em = Database::getManager(); // Delete old ones $items = $em->getRepository('ChamiloSkillBundle:SkillRelItem')->findBy( ['itemId' => $itemId, 'itemType' => $typeId] ); /** @var SkillRelItem $skillRelItem */ foreach ($items as $skillRelItem) { $em->remove($skillRelItem); } $em->flush(); } } /** * Relate skill with an item (exercise, gradebook, lp, etc). * * @param FormValidator $form * @param int $typeId * @param int $itemId * * @throws \Doctrine\ORM\OptimisticLockException */ public static function saveSkills($form, $typeId, $itemId) { $allowSkillInTools = api_get_configuration_value('allow_skill_rel_items'); if ($allowSkillInTools) { $userId = api_get_user_id(); $courseId = api_get_course_int_id(); if (empty($courseId)) { $courseId = null; } $sessionId = api_get_session_id(); if (empty($sessionId)) { $sessionId = null; } $em = Database::getManager(); $skills = (array) $form->getSubmitValue('skills'); // Delete old ones $items = $em->getRepository('ChamiloSkillBundle:SkillRelItem')->findBy( ['itemId' => $itemId, 'itemType' => $typeId] ); if (!empty($items)) { /** @var SkillRelItem $skillRelItem */ foreach ($items as $skillRelItem) { if (!in_array($skillRelItem->getSkill()->getId(), $skills)) { $em->remove($skillRelItem); } } $em->flush(); } // Add new one if (!empty($skills)) { foreach ($skills as $skillId) { /** @var SkillEntity $skill */ $skill = $em->getRepository('ChamiloCoreBundle:Skill')->find($skillId); if ($skill) { if (!$skill->hasItem($typeId, $itemId)) { $skillRelItem = new SkillRelItem(); $skillRelItem ->setItemType($typeId) ->setItemId($itemId) ->setCourseId($courseId) ->setSessionId($sessionId) ->setCreatedBy($userId) ->setUpdatedBy($userId) ; $skill->addItem($skillRelItem); $em->persist($skill); $em->flush(); } } } } } } /** * Relate skill with an item (exercise, gradebook, lp, etc). * * @param FormValidator $form * * @return bool */ public static function saveSkillsToCourseFromForm(FormValidator $form) { $skills = (array) $form->getSubmitValue('skills'); $courseId = (int) $form->getSubmitValue('course_id'); $sessionId = $form->getSubmitValue('session_id'); return self::saveSkillsToCourse($skills, $courseId, $sessionId); } /** * @param array $skills * @param int $courseId * @param int $sessionId * * @throws \Doctrine\ORM\OptimisticLockException * * @return bool */ public static function saveSkillsToCourse($skills, $courseId, $sessionId) { $allowSkillInTools = api_get_configuration_value('allow_skill_rel_items'); if (!$allowSkillInTools) { return false; } $em = Database::getManager(); $sessionId = empty($sessionId) ? null : (int) $sessionId; $course = api_get_course_entity($courseId); if (empty($course)) { return false; } $session = null; if (!empty($sessionId)) { $session = api_get_session_entity($sessionId); $courseExistsInSession = SessionManager::sessionHasCourse($sessionId, $course->getCode()); if (!$courseExistsInSession) { return false; } } // Delete old ones $items = $em->getRepository('ChamiloSkillBundle:SkillRelCourse')->findBy( ['course' => $courseId, 'session' => $sessionId] ); if (!empty($items)) { /** @var SkillRelCourse $item */ foreach ($items as $item) { if (!in_array($item->getSkill()->getId(), $skills)) { $em->remove($item); } } $em->flush(); } // Add new one if (!empty($skills)) { foreach ($skills as $skillId) { $item = new SkillRelCourse(); $item->setCourse($course); $item->setSession($session); /** @var SkillEntity $skill */ $skill = $em->getRepository('ChamiloCoreBundle:Skill')->find($skillId); if ($skill) { if (!$skill->hasCourseAndSession($item)) { $skill->addToCourse($item); $em->persist($skill); } } } $em->flush(); } return true; } /** * Get the icon (badge image) URL. * * @param SkillEntity $skill * @param bool $getSmall Optional. Allow get the small image * * @return string */ public static function getWebIconPath(SkillEntity $skill, $getSmall = false) { if ($getSmall) { if (empty($skill->getIcon())) { return \Display::return_icon('badges-default.png', null, null, ICON_SIZE_BIG, null, true); } return api_get_path(WEB_UPLOAD_PATH).'badges/'.sha1($skill->getName()).'-small.png'; } if (empty($skill->getIcon())) { return \Display::return_icon('badges-default.png', null, null, ICON_SIZE_HUGE, null, true); } return api_get_path(WEB_UPLOAD_PATH)."badges/{$skill->getIcon()}"; } /** * @param User $user * @param \Chamilo\CoreBundle\Entity\Skill $skill * @param int $levelId * @param string $argumentation * @param int $authorId * * @throws \Doctrine\ORM\OptimisticLockException * * @return SkillRelUserEntity */ public function addSkillToUserBadge($user, $skill, $levelId, $argumentation, $authorId) { $showLevels = api_get_configuration_value('hide_skill_levels') === false; $entityManager = Database::getManager(); $skillUserRepo = $entityManager->getRepository('ChamiloCoreBundle:SkillRelUser'); $criteria = ['user' => $user, 'skill' => $skill]; $result = $skillUserRepo->findOneBy($criteria); if (!empty($result)) { return false; } $skillLevelRepo = $entityManager->getRepository('ChamiloSkillBundle:Level'); $skillUser = new \Chamilo\CoreBundle\Entity\SkillRelUser(); $skillUser->setUser($user); $skillUser->setSkill($skill); if ($showLevels && !empty($levelId)) { $level = $skillLevelRepo->find($levelId); $skillUser->setAcquiredLevel($level); } $skillUser->setArgumentation($argumentation); $skillUser->setArgumentationAuthorId($authorId); $skillUser->setAcquiredSkillAt(new DateTime()); $skillUser->setAssignedBy(0); $entityManager->persist($skillUser); $entityManager->flush(); return $skillUser; } }