';
if ($isHierarchicalTable) {
$tableResult = '
';
}
if ($addTitle) {
$tableResult .= Display::page_subheader(get_lang('Achieved skills'));
$tableResult .= '
';
}
if (!empty($skillParents)) {
if (empty($allowLevels)) {
$tableResult .= $this->processSkillListSimple($skills);
} else {
$graph = new Graph();
$graph->setAttribute('graphviz.graph.rankdir', 'LR');
foreach ($skillParents as $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 (false === $passed) {
// @todo use a css class
$transparency = 'opacity: 0.4; filter: alpha(opacity=40);';
}
$label = $this->processSkillListSimple([$data], 'mini', $transparency);
$table .= '';
$table .= ' - '.$label;
$table .= $this->processVertex($vertex, $skills);
$table .= '
';
$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 (false === $passed) {
// @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 .= $skillTable;
$table .= ' ';
$table .= ' | ';
$table .= '
';
}
}
}
$tableResult .= $table;
}
} else {
$tableResult .= get_lang('Without achieved skills');
}
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 (1 == $skill_id) {
$skill_id = 0;
}
if (isset($user_id) && !empty($user_id)) {
$skills = $this->getAllSkills(true, $user_id, null, $skill_id);
} else {
$skills = $this->getAllSkills(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',
'title' => 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 (0 == $skill['parent_id']) {
$skill['parent_id'] = '-1';
}
// because except main keys (id, title, 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 title (to shorten the text in the wheel)
if (!empty($skill['short_code']) &&
'false' === api_get_setting('show_full_skill_name_on_skill_wheel')
) {
$skill['data']['short_code'] = $skill['short_code'];
}
$skill['data']['title'] = $skill['title'];
$skill['data']['status'] = $skill['status'];
// In order to paint all members of a family with the same color
if (empty($skill_id)) {
if (1 == $skill['parent_id']) {
$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 (!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[1]['children'][0] = $skills[1];
$skills[$skill_id]['data']['family_id'] = 1;
$refs[1]['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 = [
'title' => get_lang('Absolute skill'),
'id' => 1,
'children' => $refs[1]['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[] = [
'title' => $element['title'],
'children' => $children,
];
}
}
return json_encode($simple_tree);
}
/**
* 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['title'] = $elem['title'];
$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.id as 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.id = su.user_id, (SELECT @rownum:=0) r
WHERE 1=1 AND u.active <> ".USER_SOFT_DELETED." $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.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)
{
$cid = api_get_course_int_id($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 c_id = '$cid'";
$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 (false != $result) {
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 (empty($result)) {
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 (0 == $courseId) {
return [];
}
$em = Database::getManager();
$list = [];
$sql = "SELECT
course.id c_id,
course.title c_name,
course.directory c_directory,
user.id as user_id,
user.lastname,
user.firstname,
user.username,
skill.id skill_id,
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.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)) {
$skill = $em->find(Skill::class, $row['skill_id']);
$row['skill_title'] = $skill->getTitle();
$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 (0 == $skillId) {
return [];
}
$em = Database::getManager();
$list = [];
$sql = "SELECT
course.id c_id,
course.title c_name,
course.directory c_directory,
user.id as user_id,
user.lastname,
user.firstname,
user.username,
skill.id skill_id,
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.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)) {
$skill = $em->find(Skill::class, $row['skill_id']);
$row['skill_title'] = $skill->getTitle();
$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.title
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 ('true' === api_get_setting('allow_session_admins_to_manage_all_sessions')) {
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 = $toUser->getFriendsByRelationType(UserRelUser::USER_RELATION_TYPE_BOSS);
//$studentBosses = $userRepo->getStudentBosses($toUser);
foreach ($studentBosses as $studentBoss) {
if ($studentBoss->getFriend()->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 = 'true' === api_get_setting('allow_hr_skills_management');
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 ('true' === $allowTool) {
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 = ('true' === api_get_setting('skill.allow_private_skills'));
if (true === $allow) {
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)
{
$achievedSkills = api_get_user_entity($userId)->getAchievedSkills();
$skills = [];
foreach ($achievedSkills as $achievedSkill) {
$skill = $achievedSkill->getSkill();
if (empty($level)) {
$skills[] = [
'title' => $skill->getTitle(),
'acquired_skill_at' => $achievedSkill->getAcquiredSkillAt()->format('Y-m-d H:i:s'),
];
} else {
$parents = self::get_parents($skill->getId());
// +2 because it takes into account the root
if (count($parents) == $level + 1) {
$skills[] = [
'title' => $skill->getTitle(),
'acquired_skill_at' => $achievedSkill->getAcquiredSkillAt()->format('Y-m-d H:i:s'),
];
}
}
}
return $skills;
}
/**
* @param array $skillInfo
*
* @return array
*/
public function setForm(FormValidator &$form, $skillInfo = [])
{
$allSkills = $this->getAllSkills();
$objGradebook = new Gradebook();
$skillList = [0 => get_lang('None')];
foreach ($allSkills as $skill) {
if (isset($skillInfo['id']) && $skill['id'] == $skillInfo['id']) {
continue;
}
$skillList[$skill['id']] = $skill['title'];
}
$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['title'];
}
$translateUrl = api_get_path(WEB_CODE_PATH).'skills/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('Translate this term'),
$translateNameUrl,
'language',
'link'
);
$translateCodeButton = Display::toolbarButton(
get_lang('Translate this term'),
$translateCodeUrl,
'language',
'link'
);
}
$form->addText('title', [get_lang('Name'), $translateNameButton], true, ['id' => 'title']);
$form->addText('short_code', [get_lang('Short code'), $translateCodeButton], false, ['id' => 'short_code']);
// Cannot change parent of root
if (1 != $skillId) {
$form->addSelect('parent_id', get_lang('Parent'), $skillList, ['id' => 'parent_id']);
}
$form->addSelect(
'gradebook_id',
[get_lang('Assessments'), get_lang('With Certificate')],
$gradeBookList,
['id' => 'gradebook_id', 'multiple' => 'multiple', 'size' => 10]
);
$form->addTextarea('description', get_lang('Description'), ['id' => 'description', 'rows' => 7]);
$form->addTextarea('criteria', get_lang('Criteria to earn the badge'), ['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::getMdiIcon(ActionIcon::BACK, 'ch-tool-icon', null, ICON_SIZE_MEDIUM, get_lang('Manage skills')),
api_get_path(WEB_CODE_PATH).'skills/skill_list.php'
);
return Display::toolbarAction('skills_toolbar', [$toolbar]);
}
/**
* @param SkillRelItem $skillRelItem
* @param 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->getTitle(), $type);
if ($addHeader) {
$label .= ' ';
}
return $label;
}
/**
* Assign a user with a SkilRelItem object.
*
* @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 = ('true' === api_get_setting('skill.allow_skill_rel_items'));
if ($allowSkillInTools && !empty($typeId) && !empty($itemId) && !empty($userId)) {
$em = Database::getManager();
$items = $em->getRepository(SkillRelItem::class)->findBy(
['itemId' => $itemId, 'itemType' => $typeId]
);
$skillRelUser = new SkillRelUserModel();
$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(SkillRelItemRelUser::class)->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 int $typeId see ITEM_TYPE_* constants
* @param int $itemId
*
* @throws Exception
*
* @return array
*/
public static function addSkillsToForm(FormValidator $form, $typeId, $itemId = 0)
{
$allowSkillInTools = ('true' === api_get_setting('skill.allow_skill_rel_items'));
if (!$allowSkillInTools) {
return [];
}
$skillList = [];
if (!empty($itemId)) {
$em = Database::getManager();
$items = $em->getRepository(SkillRelItem::class)->findBy(
['itemId' => $itemId, 'itemType' => $typeId]
);
/** @var SkillRelItem $skillRelItem */
foreach ($items as $skillRelItem) {
$skillList[$skillRelItem->getSkill()->getId()] = $skillRelItem->getSkill()->getTitle();
}
}
$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 = ('true' === api_get_setting('skill.allow_skill_rel_items'));
$skills = [];
if (empty($sessionId)) {
$sessionId = null;
}
if ($allowSkillInTools) {
$em = Database::getManager();
$skills = $em->getRepository(SkillRelItem::class)->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 CQuiz $item */
$item = $em->getRepository(CQuiz::class)->find($itemId);
if ($item) {
$itemInfo['name'] = $item->getTitle();
}
break;
case ITEM_TYPE_HOTPOTATOES:
break;
case ITEM_TYPE_LINK:
/** @var CLink $item */
$item = $em->getRepository(CLink::class)->find($itemId);
if ($item) {
$itemInfo['name'] = $item->getTitle();
}
break;
case ITEM_TYPE_LEARNPATH:
/** @var CLp $item */
$item = $em->getRepository(CLp::class)->find($itemId);
if ($item) {
$itemInfo['name'] = $item->getTitle();
}
break;
case ITEM_TYPE_GRADEBOOK:
break;
case ITEM_TYPE_STUDENT_PUBLICATION:
/** @var CStudentPublication $item */
$item = $em->getRepository(CStudentPublication::class)->find($itemId);
if ($item) {
$itemInfo['name'] = $item->getTitle();
}
break;
//ITEM_TYPE_FORUM', 7);
case ITEM_TYPE_ATTENDANCE:
/** @var CAttendance $item */
$item = $em->getRepository(CAttendance::class)->find($itemId);
if ($item) {
$itemInfo['name'] = $item->getTitle();
}
break;
case ITEM_TYPE_SURVEY:
/** @var CSurvey $item */
$item = $em->getRepository(CSurvey::class)->find($itemId);
if ($item) {
$itemInfo['name'] = strip_tags($item->getTitle());
}
break;
case ITEM_TYPE_FORUM_THREAD:
/** @var CForumThread $item */
$item = $em->getRepository(CForumThread::class)->find($itemId);
if ($item) {
$itemInfo['name'] = $item->getTitle();
}
break;
}
return $itemInfo;
}
/**
* @param int $typeId
* @param int $itemId
*
* @return array
*/
public static function getSkillRelItems($typeId, $itemId)
{
$allowSkillInTools = ('true' === api_get_setting('skill.allow_skill_rel_items'));
$skills = [];
if ($allowSkillInTools) {
$em = Database::getManager();
$skills = $em->getRepository(SkillRelItem::class)->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()->getTitle(), 'success');
}
$skillToString = ' '.implode(' ', $skillList);
}
return $skillToString;
}
/**
* @param int $itemId
* @param int $typeId
*/
public static function deleteSkillsFromItem($itemId, $typeId)
{
$allowSkillInTools = ('true' === api_get_setting('skill.allow_skill_rel_items'));
if ($allowSkillInTools) {
$itemId = (int) $itemId;
$typeId = (int) $typeId;
$em = Database::getManager();
// Delete old ones
$items = $em->getRepository(SkillRelItem::class)->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 = ('true' === api_get_setting('skill.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(SkillRelItem::class)->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 Skill $skill */
$skill = $em->getRepository(Skill::class)->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).
*
* @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 = ('true' === api_get_setting('skill.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(SkillRelCourse::class)->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 Skill $skill */
$skill = $em->getRepository(Skill::class)->find($skillId);
if ($skill) {
if (!$skill->hasCourseAndSession($item)) {
$skill->addToCourse($item);
$em->persist($skill);
}
}
}
$em->flush();
}
return true;
}
/**
* Get the icon (badge image) URL.
*/
public static function getWebIconPath(?Skill $skill): string
{
$default = \Display::return_icon('badges-default.png', null, null, ICON_SIZE_HUGE, null, true);
if (null === $skill) {
return $default;
}
if (!$skill->hasAsset()) {
return $default;
}
return Container::getAssetRepository()->getAssetUrl($skill->getAsset());
}
/**
* @throws \Doctrine\ORM\ORMException
* @throws \Doctrine\ORM\OptimisticLockException
*/
public function addSkillToUserBadge(
User $user,
Skill $skill,
int $levelId,
string $argumentation,
int $authorId
): ?SkillRelUser {
$showLevels = ('false' === api_get_setting('skill.hide_skill_levels'));
$entityManager = Database::getManager();
$skillUserRepo = $entityManager->getRepository(SkillRelUser::class);
$criteria = ['user' => $user, 'skill' => $skill];
$result = $skillUserRepo->findOneBy($criteria);
if (null !== $result) {
return null;
}
$skillLevelRepo = $entityManager->getRepository(Level::class);
$skillUser = (new SkillRelUser())
->setUser($user)
->setSkill($skill)
->setArgumentation($argumentation)
->setArgumentationAuthorId($authorId)
->setAssignedBy(0)
;
if ($showLevels && !empty($levelId)) {
$level = $skillLevelRepo->find($levelId);
$skillUser->setAcquiredLevel($level);
}
$entityManager->persist($skillUser);
$entityManager->flush();
return $skillUser;
}
public static function setBackPackJs(&$htmlHeadXtra)
{
$backpack = 'https://backpack.openbadges.org/';
$configBackpack = api_get_setting('openbadges_backpack');
if (0 !== strcmp($backpack, $configBackpack)) {
$backpack = $configBackpack;
if ('/' !== substr($backpack, -1)) {
$backpack .= '/';
}
}
$htmlHeadXtra[] = '';
}
public static function exportBadge(Skill $skill, SkillRelUser $skillRelUser, string $urlToRedirect)
{
if ($skill->hasAsset()) {
$assetRepo = Container::getAssetRepository();
$imageContent = $assetRepo->getAssetContent($skill->getAsset());
} else {
$defaultBadge = api_get_path(SYS_PUBLIC_PATH).'img/icons/128/badges-default.png';
$imageContent = file_get_contents($defaultBadge);
}
$png = new PNGImageBaker($imageContent);
if ($png->checkChunks('tEXt', 'openbadges')) {
$result = $png->addChunk('tEXt', 'openbadges', SkillRelUserModel::getAssertionUrl($skillRelUser));
$verifyBadge = $png->extractBadgeInfo($result);
$error = true;
if (is_array($verifyBadge)) {
$error = false;
}
if (!$error) {
//header('Content-type: image/png');
header('Content-type: application/octet-stream');
header('Content-Type: application/force-download');
header('Content-Disposition: attachment; filename= '.api_get_unique_id());
echo $result;
exit;
}
}
Display::addFlash(
Display::return_message(
get_lang(
'There was a problem embedding the badge assertion info into the badge image, but you can still use this page as a valid proof.'
),
'warning'
)
);
api_location($urlToRedirect);
}
}