You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
804 lines
20 KiB
804 lines
20 KiB
<?php
|
|
/* For licensing terms, see /license.txt */
|
|
|
|
use Chamilo\CoreBundle\Entity\GradebookLink;
|
|
|
|
/**
|
|
* Class AbstractLink
|
|
* Defines a gradebook AbstractLink object.
|
|
* To implement specific links,
|
|
* extend this class and define a type in LinkFactory.
|
|
* Use the methods in LinkFactory to create link objects.
|
|
*
|
|
* @author Bert Steppé
|
|
* @author Julio Montoya <gugli100@gmail.com> security improvements
|
|
*/
|
|
abstract class AbstractLink implements GradebookItem
|
|
{
|
|
public $course_id;
|
|
public $studentList;
|
|
/** @var GradebookLink */
|
|
public $entity;
|
|
protected $id;
|
|
protected $type;
|
|
protected $ref_id;
|
|
protected $user_id;
|
|
protected $course_code;
|
|
/** @var Category */
|
|
protected $category;
|
|
protected $created_at;
|
|
protected $weight;
|
|
protected $visible;
|
|
protected $session_id;
|
|
|
|
/**
|
|
* Constructor.
|
|
*/
|
|
public function __construct()
|
|
{
|
|
$this->course_id = api_get_course_int_id();
|
|
}
|
|
|
|
/**
|
|
* @return bool
|
|
*/
|
|
abstract public function has_results();
|
|
|
|
/**
|
|
* @return string
|
|
*/
|
|
abstract public function get_link();
|
|
|
|
/**
|
|
* @return bool
|
|
*/
|
|
abstract public function is_valid_link();
|
|
|
|
/**
|
|
* @return string
|
|
*/
|
|
abstract public function get_type_name();
|
|
|
|
/**
|
|
* @return bool
|
|
*/
|
|
abstract public function needs_name_and_description();
|
|
|
|
/**
|
|
* @return bool
|
|
*/
|
|
abstract public function needs_max();
|
|
|
|
/**
|
|
* @return bool
|
|
*/
|
|
abstract public function needs_results();
|
|
|
|
/**
|
|
* @return bool
|
|
*/
|
|
abstract public function is_allowed_to_change_name();
|
|
|
|
/**
|
|
* @return int
|
|
*/
|
|
public function get_id()
|
|
{
|
|
return $this->id;
|
|
}
|
|
|
|
/**
|
|
* @return string
|
|
*/
|
|
public function get_type()
|
|
{
|
|
return $this->type;
|
|
}
|
|
|
|
/**
|
|
* @return int
|
|
*/
|
|
public function get_ref_id()
|
|
{
|
|
return (int) $this->ref_id;
|
|
}
|
|
|
|
/**
|
|
* @return int
|
|
*/
|
|
public function get_session_id()
|
|
{
|
|
return (int) $this->session_id;
|
|
}
|
|
|
|
/**
|
|
* @return int
|
|
*/
|
|
public function get_user_id()
|
|
{
|
|
return $this->user_id;
|
|
}
|
|
|
|
/**
|
|
* @return string
|
|
*/
|
|
public function get_course_code()
|
|
{
|
|
return $this->course_code;
|
|
}
|
|
|
|
/**
|
|
* @return Category
|
|
*/
|
|
public function getCategory()
|
|
{
|
|
return $this->category;
|
|
}
|
|
|
|
/**
|
|
* @param Category $category
|
|
*/
|
|
public function setCategory($category)
|
|
{
|
|
$this->category = $category;
|
|
}
|
|
|
|
/**
|
|
* @return int
|
|
*/
|
|
public function get_category_id()
|
|
{
|
|
return $this->category->get_id();
|
|
}
|
|
|
|
/**
|
|
* @param int $category_id
|
|
*/
|
|
public function set_category_id($category_id)
|
|
{
|
|
$categories = Category::load($category_id);
|
|
if (isset($categories[0])) {
|
|
$this->setCategory($categories[0]);
|
|
}
|
|
}
|
|
|
|
public function get_date()
|
|
{
|
|
return $this->created_at;
|
|
}
|
|
|
|
public function get_weight()
|
|
{
|
|
return $this->weight;
|
|
}
|
|
|
|
public function is_locked()
|
|
{
|
|
return isset($this->locked) && 1 == $this->locked ? true : false;
|
|
}
|
|
|
|
public function is_visible()
|
|
{
|
|
return $this->visible;
|
|
}
|
|
|
|
public function set_id($id)
|
|
{
|
|
$this->id = $id;
|
|
}
|
|
|
|
public function set_type($type)
|
|
{
|
|
$this->type = $type;
|
|
}
|
|
|
|
public function set_ref_id($ref_id)
|
|
{
|
|
$this->ref_id = $ref_id;
|
|
}
|
|
|
|
public function set_user_id($user_id)
|
|
{
|
|
$this->user_id = $user_id;
|
|
}
|
|
|
|
/**
|
|
* @param string $course_code
|
|
*/
|
|
public function set_course_code($course_code)
|
|
{
|
|
$courseInfo = api_get_course_info($course_code);
|
|
if ($courseInfo) {
|
|
$this->course_code = $course_code;
|
|
$this->course_id = $courseInfo['real_id'];
|
|
}
|
|
}
|
|
|
|
/**
|
|
* @return array
|
|
*/
|
|
public function getStudentList()
|
|
{
|
|
if (empty($this->studentList)) {
|
|
return [];
|
|
}
|
|
|
|
return $this->studentList;
|
|
}
|
|
|
|
/**
|
|
* @param array $list
|
|
*/
|
|
public function setStudentList($list)
|
|
{
|
|
$this->studentList = $list;
|
|
}
|
|
|
|
public function set_date($date)
|
|
{
|
|
$this->created_at = $date;
|
|
}
|
|
|
|
public function set_weight($weight)
|
|
{
|
|
$this->weight = $weight;
|
|
}
|
|
|
|
public function set_visible($visible)
|
|
{
|
|
$this->visible = $visible;
|
|
}
|
|
|
|
/**
|
|
* @param int $id
|
|
*/
|
|
public function set_session_id($id)
|
|
{
|
|
$this->session_id = $id;
|
|
}
|
|
|
|
/**
|
|
* @param $locked
|
|
*/
|
|
public function set_locked($locked)
|
|
{
|
|
$this->locked = $locked;
|
|
}
|
|
|
|
/**
|
|
* @return int
|
|
*/
|
|
public function getCourseId()
|
|
{
|
|
return (int) $this->course_id;
|
|
}
|
|
|
|
/**
|
|
* Retrieve links and return them as an array of extensions of AbstractLink.
|
|
* To keep consistency, do not call this method but LinkFactory::load instead.
|
|
*
|
|
* @param int $id
|
|
* @param int $type
|
|
* @param int $ref_id
|
|
* @param int $user_id
|
|
* @param string $course_code
|
|
* @param int $category_id
|
|
* @param int $visible
|
|
*
|
|
* @return array
|
|
*/
|
|
public static function load(
|
|
$id = null,
|
|
$type = null,
|
|
$ref_id = null,
|
|
$user_id = null,
|
|
$course_code = null,
|
|
$category_id = null,
|
|
$visible = null
|
|
) {
|
|
$tbl_grade_links = Database::get_main_table(TABLE_MAIN_GRADEBOOK_LINK);
|
|
$sql = 'SELECT * FROM '.$tbl_grade_links;
|
|
$paramcount = 0;
|
|
if (isset($id)) {
|
|
$sql .= ' WHERE id = '.intval($id);
|
|
$paramcount++;
|
|
}
|
|
if (isset($type)) {
|
|
if (0 != $paramcount) {
|
|
$sql .= ' AND';
|
|
} else {
|
|
$sql .= ' WHERE';
|
|
}
|
|
$sql .= ' type = '.intval($type);
|
|
$paramcount++;
|
|
}
|
|
if (isset($ref_id)) {
|
|
if (0 != $paramcount) {
|
|
$sql .= ' AND';
|
|
} else {
|
|
$sql .= ' WHERE';
|
|
}
|
|
$sql .= ' ref_id = '.intval($ref_id);
|
|
$paramcount++;
|
|
}
|
|
if (isset($user_id)) {
|
|
if (0 != $paramcount) {
|
|
$sql .= ' AND';
|
|
} else {
|
|
$sql .= ' WHERE';
|
|
}
|
|
$sql .= ' user_id = '.intval($user_id);
|
|
$paramcount++;
|
|
}
|
|
if (isset($course_code)) {
|
|
if (0 != $paramcount) {
|
|
$sql .= ' AND';
|
|
} else {
|
|
$sql .= ' WHERE';
|
|
}
|
|
$courseInfo = api_get_course_info($course_code);
|
|
if ($courseInfo) {
|
|
$sql .= " c_id = '".$courseInfo['real_id']."'";
|
|
$paramcount++;
|
|
}
|
|
}
|
|
if (isset($category_id)) {
|
|
if (0 != $paramcount) {
|
|
$sql .= ' AND';
|
|
} else {
|
|
$sql .= ' WHERE';
|
|
}
|
|
$sql .= ' category_id = '.intval($category_id);
|
|
$paramcount++;
|
|
}
|
|
if (isset($visible)) {
|
|
if (0 != $paramcount) {
|
|
$sql .= ' AND';
|
|
} else {
|
|
$sql .= ' WHERE';
|
|
}
|
|
$sql .= ' visible = '.intval($visible);
|
|
}
|
|
|
|
$result = Database::query($sql);
|
|
$links = self::create_objects_from_sql_result($result);
|
|
|
|
return $links;
|
|
}
|
|
|
|
/**
|
|
* Insert this link into the database.
|
|
*/
|
|
public function add()
|
|
{
|
|
$this->add_linked_data();
|
|
if (isset($this->type) &&
|
|
isset($this->ref_id) &&
|
|
isset($this->user_id) &&
|
|
isset($this->course_code) &&
|
|
isset($this->category) &&
|
|
isset($this->weight) &&
|
|
isset($this->visible)
|
|
) {
|
|
$table = Database::get_main_table(TABLE_MAIN_GRADEBOOK_LINK);
|
|
$sql = "SELECT count(*) count FROM $table
|
|
WHERE
|
|
ref_id = ".$this->get_ref_id()." AND
|
|
category_id = ".$this->category->get_id()." AND
|
|
c_id = '".$this->course_id."' AND
|
|
type = ".$this->type." ";
|
|
|
|
$result = Database::query($sql);
|
|
$row = Database::fetch_array($result, 'ASSOC');
|
|
|
|
if (0 == $row['count']) {
|
|
$em = Database::getManager();
|
|
$link = new GradebookLink();
|
|
$link
|
|
->setType($this->get_type())
|
|
->setVisible($this->is_visible())
|
|
->setWeight(api_float_val($this->get_weight()))
|
|
->setUserId($this->get_user_id())
|
|
->setRefId($this->get_ref_id())
|
|
->setCategoryId($this->get_category_id())
|
|
->setCourse(api_get_course_entity())
|
|
->setCategoryId($this->get_category_id());
|
|
$em->persist($link);
|
|
$em->flush();
|
|
|
|
$this->set_id($link->getId());
|
|
|
|
return $link->getId();
|
|
}
|
|
}
|
|
|
|
return false;
|
|
}
|
|
|
|
/**
|
|
* Update the properties of this link in the database.
|
|
*/
|
|
public function save()
|
|
{
|
|
$em = Database::getManager();
|
|
$link = $em->find(GradebookLink::class, $this->id);
|
|
|
|
if (!$link) {
|
|
return;
|
|
}
|
|
|
|
self::add_link_log($this->id);
|
|
$this->save_linked_data();
|
|
$course = api_get_course_entity($this->getCourseId());
|
|
$link
|
|
->setType($this->get_type())
|
|
->setRefId($this->get_ref_id())
|
|
->setUserId($this->get_user_id())
|
|
->setCourse($course)
|
|
->setCategoryId($this->get_category_id())
|
|
->setWeight($this->get_weight())
|
|
->setVisible($this->is_visible());
|
|
|
|
$em->persist($link);
|
|
$em->flush();
|
|
}
|
|
|
|
/**
|
|
* @param int $evaluationId
|
|
*/
|
|
public static function add_link_log($evaluationId, $nameLog = null)
|
|
{
|
|
$table = Database::get_main_table(TABLE_MAIN_GRADEBOOK_LINKEVAL_LOG);
|
|
$dateobject = self::load($evaluationId, null, null, null, null);
|
|
$now = api_get_utc_datetime();
|
|
$arreval = get_object_vars($dateobject[0]);
|
|
$description_log = isset($arreval['description']) ? $arreval['description'] : '';
|
|
if (empty($nameLog)) {
|
|
if (isset($_POST['name_link'])) {
|
|
$name_log = isset($_POST['name_link']) ? $_POST['name_link'] : $arreval['course_code'];
|
|
} elseif (isset($_POST['link_'.$evaluationId]) && $_POST['link_'.$evaluationId]) {
|
|
$name_log = $_POST['link_'.$evaluationId];
|
|
} else {
|
|
$name_log = $arreval['course_code'];
|
|
}
|
|
} else {
|
|
$name_log = $nameLog;
|
|
}
|
|
|
|
$params = [
|
|
'id_linkeval_log' => $arreval['id'],
|
|
'name' => $name_log,
|
|
'description' => $description_log,
|
|
'created_at' => $now,
|
|
'weight' => $arreval['weight'],
|
|
'visible' => $arreval['visible'],
|
|
'type' => 'Link',
|
|
'user_id_log' => api_get_user_id(),
|
|
];
|
|
Database::insert($table, $params);
|
|
}
|
|
|
|
/**
|
|
* Delete this link from the database.
|
|
*/
|
|
public function delete()
|
|
{
|
|
$this->delete_linked_data();
|
|
$table = Database::get_main_table(TABLE_MAIN_GRADEBOOK_LINK);
|
|
$sql = 'DELETE FROM '.$table.'
|
|
WHERE id = '.intval($this->id);
|
|
Database::query($sql);
|
|
}
|
|
|
|
/**
|
|
* Generate an array of possible categories where this link can be moved to.
|
|
* Notice: its own parent will be included in the list: it's up to the frontend
|
|
* to disable this element.
|
|
*
|
|
* @return array 2-dimensional array - every element contains 3 subelements (id, name, level)
|
|
*/
|
|
public function get_target_categories()
|
|
{
|
|
// links can only be moved to categories inside this course
|
|
$targets = [];
|
|
$level = 0;
|
|
$categories = Category::load(null, null, $this->get_course_code(), 0);
|
|
foreach ($categories as $cat) {
|
|
$targets[] = [$cat->get_id(), $cat->get_name(), $level + 1];
|
|
$targets = $this->addTargetSubcategories(
|
|
$targets,
|
|
$level + 1,
|
|
$cat->get_id()
|
|
);
|
|
}
|
|
|
|
return $targets;
|
|
}
|
|
|
|
/**
|
|
* Move this link to the given category.
|
|
* If this link moves to outside a course, delete it.
|
|
*/
|
|
public function move_to_cat($cat)
|
|
{
|
|
if ($this->get_course_code() != $cat->get_course_code()) {
|
|
$this->delete();
|
|
} else {
|
|
$this->set_category_id($cat->get_id());
|
|
$this->save();
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Find links by name
|
|
* To keep consistency, do not call this method but LinkFactory::find_links instead.
|
|
*
|
|
* @todo can be written more efficiently using a new (but very complex) sql query
|
|
*
|
|
* @param string $name_mask
|
|
*
|
|
* @return array
|
|
*/
|
|
public static function find_links($name_mask, $selectcat)
|
|
{
|
|
$rootcat = Category::load($selectcat);
|
|
$links = $rootcat[0]->get_links((api_is_allowed_to_edit() ? null : api_get_user_id()), true);
|
|
$foundlinks = [];
|
|
foreach ($links as $link) {
|
|
if (!(false === api_strpos(api_strtolower($link->get_name()), api_strtolower($name_mask)))) {
|
|
$foundlinks[] = $link;
|
|
}
|
|
}
|
|
|
|
return $foundlinks;
|
|
}
|
|
|
|
/**
|
|
* @return string
|
|
*/
|
|
public function get_item_type()
|
|
{
|
|
return 'L';
|
|
}
|
|
|
|
/**
|
|
* @return string
|
|
*/
|
|
public function get_icon_name()
|
|
{
|
|
return 'link';
|
|
}
|
|
|
|
public function get_all_links()
|
|
{
|
|
return [];
|
|
}
|
|
|
|
public function add_linked_data()
|
|
{
|
|
}
|
|
|
|
public function save_linked_data()
|
|
{
|
|
}
|
|
|
|
public function delete_linked_data()
|
|
{
|
|
}
|
|
|
|
/**
|
|
* @param string $name
|
|
*/
|
|
public function set_name($name)
|
|
{
|
|
}
|
|
|
|
/**
|
|
* @param string $description
|
|
*/
|
|
public function set_description($description)
|
|
{
|
|
}
|
|
|
|
/**
|
|
* @param int $max
|
|
*/
|
|
public function set_max($max)
|
|
{
|
|
}
|
|
|
|
public function get_view_url($stud_id)
|
|
{
|
|
return null;
|
|
}
|
|
|
|
/**
|
|
* Locks a link.
|
|
*
|
|
* @param int $locked 1 or unlocked 0
|
|
*
|
|
* */
|
|
public function lock($locked)
|
|
{
|
|
$table = Database::get_main_table(TABLE_MAIN_GRADEBOOK_LINK);
|
|
$sql = "UPDATE $table SET locked = '".intval($locked)."'
|
|
WHERE id='".$this->id."'";
|
|
Database::query($sql);
|
|
}
|
|
|
|
/**
|
|
* Get current user ranking.
|
|
*
|
|
* @param int $userId
|
|
* @param array $studentList Array with user id and scores
|
|
* Example: [1 => 5.00, 2 => 8.00]
|
|
*
|
|
* @return array
|
|
*/
|
|
public static function getCurrentUserRanking($userId, $studentList)
|
|
{
|
|
$ranking = null;
|
|
$currentUserId = $userId;
|
|
if (!empty($studentList) && !empty($currentUserId)) {
|
|
$studentList = array_map('floatval', $studentList);
|
|
asort($studentList);
|
|
$ranking = $count = count($studentList);
|
|
|
|
foreach ($studentList as $userId => $position) {
|
|
if ($currentUserId == $userId) {
|
|
break;
|
|
}
|
|
$ranking--;
|
|
}
|
|
|
|
// If no ranking was detected.
|
|
if (0 == $ranking) {
|
|
return [];
|
|
}
|
|
|
|
return [$ranking, $count];
|
|
}
|
|
|
|
return [];
|
|
}
|
|
|
|
/**
|
|
* @return string
|
|
*/
|
|
public function getSkillsFromItem()
|
|
{
|
|
$toolType = '';
|
|
switch ($this->type) {
|
|
case LINK_ATTENDANCE:
|
|
$toolType = ITEM_TYPE_ATTENDANCE;
|
|
break;
|
|
case LINK_EXERCISE:
|
|
$toolType = ITEM_TYPE_EXERCISE;
|
|
break;
|
|
case LINK_FORUM_THREAD:
|
|
$toolType = ITEM_TYPE_FORUM_THREAD;
|
|
break;
|
|
case LINK_LEARNPATH:
|
|
$toolType = ITEM_TYPE_LEARNPATH;
|
|
break;
|
|
case LINK_HOTPOTATOES:
|
|
$toolType = ITEM_TYPE_HOTPOTATOES;
|
|
break;
|
|
case LINK_STUDENTPUBLICATION:
|
|
$toolType = ITEM_TYPE_STUDENT_PUBLICATION;
|
|
break;
|
|
case LINK_SURVEY:
|
|
$toolType = ITEM_TYPE_SURVEY;
|
|
break;
|
|
}
|
|
|
|
$skillToString = Skill::getSkillRelItemsToString($toolType, $this->get_ref_id());
|
|
|
|
return $skillToString;
|
|
}
|
|
|
|
/**
|
|
* @param int $itemId
|
|
* @param int $linkType
|
|
* @param string $courseCode
|
|
* @param int $sessionId
|
|
*
|
|
* @return array|bool|\Doctrine\DBAL\Driver\Statement
|
|
*/
|
|
public static function getGradebookLinksFromItem($itemId, $linkType, $courseCode, $sessionId = 0)
|
|
{
|
|
if (empty($courseCode) || empty($itemId) || empty($linkType)) {
|
|
return false;
|
|
}
|
|
$table = Database::get_main_table(TABLE_MAIN_GRADEBOOK_LINK);
|
|
$tableCategory = Database::get_main_table(TABLE_MAIN_GRADEBOOK_CATEGORY);
|
|
$itemId = (int) $itemId;
|
|
$linkType = (int) $linkType;
|
|
$sessionId = (int) $sessionId;
|
|
|
|
$sessionCondition = api_get_session_condition($sessionId, true, false, 'c.session_id');
|
|
$courseCode = Database::escape_string($courseCode);
|
|
|
|
$sql = "SELECT DISTINCT l.*
|
|
FROM $table l INNER JOIN $tableCategory c
|
|
ON (c.course_code = l.course_code AND c.id = l.category_id)
|
|
WHERE
|
|
ref_id = $itemId AND
|
|
type = $linkType AND
|
|
l.course_code = '$courseCode'
|
|
$sessionCondition ";
|
|
|
|
$result = Database::query($sql);
|
|
if (Database::num_rows($result)) {
|
|
$result = Database::store_result($result);
|
|
|
|
return $result;
|
|
}
|
|
|
|
return false;
|
|
}
|
|
|
|
/**
|
|
* @param Doctrine\DBAL\Driver\Statement|null $result
|
|
*
|
|
* @return array
|
|
*/
|
|
private static function create_objects_from_sql_result($result)
|
|
{
|
|
$links = [];
|
|
$allow = api_get_configuration_value('allow_gradebook_stats');
|
|
if ($allow) {
|
|
$em = Database::getManager();
|
|
$repo = $em->getRepository(GradebookLink::class);
|
|
}
|
|
|
|
while ($data = Database::fetch_array($result)) {
|
|
$link = LinkFactory::create($data['type']);
|
|
$link->set_id($data['id']);
|
|
$link->set_type($data['type']);
|
|
$link->set_ref_id($data['ref_id']);
|
|
$link->set_user_id($data['user_id']);
|
|
$link->set_course_code(api_get_course_id());
|
|
$link->set_category_id($data['category_id']);
|
|
$link->set_date($data['created_at']);
|
|
$link->set_weight($data['weight']);
|
|
$link->set_visible($data['visible']);
|
|
$link->set_locked($data['locked']);
|
|
|
|
//session id should depend of the category --> $data['category_id']
|
|
$session_id = api_get_session_id();
|
|
$link->set_session_id($session_id);
|
|
|
|
if ($allow) {
|
|
$link->entity = $repo->find($data['id']);
|
|
}
|
|
$links[] = $link;
|
|
}
|
|
|
|
return $links;
|
|
}
|
|
|
|
/**
|
|
* Internal function used by get_target_categories().
|
|
*
|
|
* @param array $targets
|
|
* @param int $level
|
|
* @param int $catid
|
|
*
|
|
* @return array
|
|
*/
|
|
private function addTargetSubcategories($targets, $level, $catid)
|
|
{
|
|
$subcats = Category::load(null, null, null, $catid);
|
|
foreach ($subcats as $cat) {
|
|
$targets[] = [$cat->get_id(), $cat->get_name(), $level + 1];
|
|
$targets = $this->addTargetSubcategories(
|
|
$targets,
|
|
$level + 1,
|
|
$cat->get_id()
|
|
);
|
|
}
|
|
|
|
return $targets;
|
|
}
|
|
}
|
|
|