Evaluation

Complexity

Total Complexity

144

Size/Duplication

Total Lines	992
Duplicated Lines	0 %

Importance

Changes

0

58 Methods

Rating	Name	Duplication	Size	Complexity
A	get_category_id()	0	3	1
A	getCategory()	0	3	1
A	__construct()	0	2	1
A	get_id()	0	3	1
A	get_name()	0	3	1
A	get_description()	0	3	1
A	setSessionId()	0	3	1
A	setCategory()	0	3	1
A	getSessionId()	0	3	1
A	get_course_code()	0	3	1
A	get_user_id()	0	3	1
A	set_category_id()	0	5	2
A	delete_results()	0	6	1
A	has_results()	0	10	1
A	get_date()	0	3	1
A	get_weight()	0	3	1
A	get_max()	0	3	1
A	set_session_id()	0	3	1
A	set_user_id()	0	3	1
A	set_id()	0	3	1
A	get_type()	0	3	1
A	get_locked()	0	3	1
B	does_name_exist()	0	38	6
A	is_locked()	0	3	3
A	is_visible()	0	3	1
A	set_name()	0	3	1
A	set_description()	0	3	1
A	getCourseId()	0	3	1
A	get_evaluations_with_result_for_student()	0	22	3
A	set_weight()	0	3	1
A	get_icon_name()	0	3	2
A	set_visible()	0	3	1
F	load()	0	69	15
A	addEvaluationLog()	0	25	3
A	findEvaluations()	0	15	4
A	set_type()	0	3	1
A	setCourseId()	0	12	2
A	is_valid_score()	0	3	3
A	get_item_type()	0	3	1
A	move_to_cat()	0	8	2
A	delete()	0	6	1
A	set_locked()	0	3	1
A	set_date()	0	3	1
F	calc_score()	0	137	28
A	delete_linked_data()	0	2	1
A	addTargetSubcategories()	0	13	2
A	generateStats()	0	37	5
A	getStudentList()	0	3	1
A	lock()	0	7	1
A	get_target_categories()	0	31	5
B	add()	0	38	8
A	save()	0	33	4
A	check_lock_permissions()	0	7	3
A	setStudentList()	0	3	1
A	set_max()	0	3	1
A	delete_with_results()	0	4	1
A	get_not_subscribed_students()	0	19	1
A	create_evaluation_objects_from_sql_result()	0	35	5

<?php
/* For licensing terms, see /license.txt */

use Chamilo\CoreBundle\Entity\GradebookCategory;
use Chamilo\CoreBundle\Entity\GradebookEvaluation;
use ChamiloSession as Session;

/**
 * Class Evaluation.
 */
class Evaluation implements GradebookItem
{
    public $studentList;
    public GradebookEvaluation $entity;
    private int $id;
    private string $name;
    private string $description;
    private int $user_id;
    private ?string $course_code;
    private Category $category;
    private string $created_at;
    private $weight;
    private $eval_max;
    private int $visible;
    private ?int $courseId;
    private int $sessionId;
    protected string $type;
    protected int $locked;

    /**
     * Construct.
     */
    public function __construct()
    {
    }

    /**
     * @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]);
        }
    }

    /**
     * @return int
     */
    public function get_id()
    {
        return (int) $this->id;
    }

    /**
     * @return string
     */
    public function get_name()
    {
        return $this->name;
    }

    /**
     * @return string
     */
    public function get_description()
    {
        return $this->description;
    }

    public function get_user_id()
    {
        return $this->user_id;
    }

    public function get_course_code()
    {
        return $this->course_code;
    }

    /**
     * @return int
     */
    public function getSessionId()
    {
        return $this->sessionId;
    }

    /**
     * @param int $sessionId
     */
    public function setSessionId($sessionId)
    {
        $this->sessionId = (int) $sessionId;
    }

    public function set_session_id($sessionId)
    {
        $this->setSessionId($sessionId);
    }

    public function get_date()
    {
        return $this->created_at;
    }

    public function get_weight()
    {
        return $this->weight;
    }

    public function get_max()
    {
        return $this->eval_max;
    }

    public function get_type()
    {
        return $this->type;
    }

    public function is_visible()
    {
        return $this->visible;
    }

    public function get_locked()
    {
        return $this->locked;
    }

    public function is_locked()
    {
        return isset($this->locked) && 1 == $this->locked ? true : false;
    }

    public function set_id($id)
    {
        $this->id = (int) $id;
    }

    public function set_name($name)
    {
        $this->name = $name;
    }

    public function set_description($description)
    {
        $this->description = $description;
    }

    public function set_user_id($user_id)
    {
        $this->user_id = $user_id;
    }

    public function getCourseId()
    {
        return $this->courseId;
    }

    public function set_date($date)
    {
        $this->created_at = $date;
    }

    public function set_weight($weight)
    {
        $this->weight = $weight;
    }

    public function set_max($max)
    {
        $this->eval_max = $max;
    }

    public function set_visible($visible)
    {
        $this->visible = $visible;
    }

    public function set_type($type)
    {
        $this->type = $type;
    }

    public function set_locked($locked)
    {
        $this->locked = $locked;
    }

    /**
     * Retrieve evaluations and return them as an array of Evaluation objects.
     *
     * @param ?int $id evaluation id
     * @param ?int $userId user id (evaluation owner)
     * @param ?int $courseId course code
     * @param ?int  $categoryId parent category
     * @param ?int  $visible Whether it is visible or not
     * @param ?int  $locked  Whether it is locked or not
     *
     * @return array
     * @throws Exception
     */
    public static function load(
        ?int $id = 0,
        ?int $userId = 0,
        ?int $courseId = 0,
        ?int $categoryId = 0,
        ?int $visible = -1,
        ?int $locked = -1
    ) {
        $table = Database::get_main_table(TABLE_MAIN_GRADEBOOK_EVALUATION);
        $sql = 'SELECT * FROM '.$table;
        $parametersCount = 0;

        if (!empty($id)) {
            $sql .= ' WHERE id = '.$id;
            $parametersCount++;
        }

        if (!empty($userId)) {
            if (0 != $parametersCount) {
                $sql .= ' AND';
            } else {
                $sql .= ' WHERE';
            }
            $sql .= ' user_id = '.$userId;
            $parametersCount++;
        }

        if (!empty($courseId) && 0 < $courseId) {
            if (0 != $parametersCount) {
                $sql .= ' AND';
            } else {
                $sql .= ' WHERE';
            }
            $sql .= " c_id = $courseId";
            $parametersCount++;
        }

        if (!empty($categoryId)) {
            if (0 != $parametersCount) {
                $sql .= ' AND';
            } else {
                $sql .= ' WHERE';
            }
            $sql .= ' category_id = '.$categoryId;
            $parametersCount++;
        }

        if (isset($visible) && -1 < $visible) {
            if (0 != $parametersCount) {
                $sql .= ' AND';
            } else {
                $sql .= ' WHERE';
            }
            $sql .= ' visible = '.$visible;
            $parametersCount++;
        }

        if (isset($locked) && -1 < $locked) {
            if (0 != $parametersCount) {
                $sql .= ' AND';
            } else {
                $sql .= ' WHERE';
            }
            $sql .= ' locked = '.$locked;
        }

        $result = Database::query($sql);

        return self::create_evaluation_objects_from_sql_result($result);
    }

    /**
     * Insert this evaluation into the database.
     * @throws \Doctrine\ORM\Exception\ORMException
     */
    public function add()
    {
        if (isset($this->name) &&
            isset($this->user_id) &&
            isset($this->weight) &&
            isset($this->eval_max) &&
            isset($this->visible)
        ) {
            if (empty($this->type)) {
                $this->type = 'evaluation';
            }
            $em = Database::getManager();

            $category = null;
            if (!empty($this->get_category_id())) {
                $category = $em->getRepository(GradebookCategory::class)->find($this->get_category_id());
            }

            $courseId = $this->getCourseId();

            $evaluation = new GradebookEvaluation();
            $evaluation
                ->setDescription($this->description)
                ->setCourse(api_get_course_entity($courseId))
                ->setTitle($this->get_name())
                ->setCategory($category)
                ->setUser(api_get_user_entity($this->get_user_id()))
                ->setWeight(api_float_val($this->get_weight()))
                ->setMax(api_float_val($this->get_max()))
                ->setVisible($this->is_visible())
                ->setType($this->type)
            ;
            $em->persist($evaluation);
            $em->flush();
            $this->set_id($evaluation->getId());
        }

        return false;
    }

    /**
     * @param int $id
     */
    public function addEvaluationLog($id)
    {
        if (!empty($id)) {
            $tbl_grade_evaluations = Database::get_main_table(TABLE_MAIN_GRADEBOOK_EVALUATION);
            $tbl_grade_linkeval_log = Database::get_main_table(TABLE_MAIN_GRADEBOOK_LINKEVAL_LOG);
            $eval = new Evaluation();
            $dateobject = $eval->load($id, null, null, null, null);
            $arreval = get_object_vars($dateobject[0]);
            if (!empty($arreval['id'])) {
                $sql = 'SELECT weight from '.$tbl_grade_evaluations.'
                        WHERE id='.$arreval['id'];
                $rs = Database::query($sql);
                $row_old_weight = Database::fetch_array($rs, 'ASSOC');
                $current_date = api_get_utc_datetime();
                $params = [
                    'id_linkeval_log' => $arreval['id'],
                    'title' => $arreval['name'],
                    'description' => $arreval['description'],
                    'created_at' => $current_date,
                    'weight' => $row_old_weight['weight'],
                    'visible' => $arreval['visible'],
                    'type' => 'evaluation',
                    'user_id_log' => api_get_user_id(),
                ];
                Database::insert($tbl_grade_linkeval_log, $params);
            }
        }
    }

    /**
     * Update the properties of this evaluation in the database.
     * @throws Exception
     */
    public function save()
    {
        $tbl_grade_evaluations = Database::get_main_table(TABLE_MAIN_GRADEBOOK_EVALUATION);
        $sql = 'UPDATE '.$tbl_grade_evaluations
            ." SET title = '".Database::escape_string($this->get_name())."'"
            .', description = ';
        if (isset($this->description)) {
            $sql .= "'".Database::escape_string($this->get_description())."'";
        } else {
            $sql .= 'null';
        }
        $sql .= ', user_id = '.$this->get_user_id()
            .', c_id = ';
        if (isset($this->courseId)) {
            $sql .= $this->getCourseId();
        } else {
            $sql .= 'null';
        }
        $sql .= ', category_id = ';
        if (!empty($this->category)) {
            $sql .= $this->get_category_id();
        } else {
            $sql .= 'null';
        }
        $sql .= ', weight = "'.Database::escape_string($this->get_weight()).'" '
            .', max = '.intval($this->get_max())
            .', visible = '.intval($this->is_visible())
            .' WHERE id = '.intval($this->id);
        //recorded history

        $eval_log = new Evaluation();
        $eval_log->addEvaluationLog($this->id);
        Database::query($sql);
    }

    /**
     * Delete this evaluation from the database.
     * @throws Exception
     */
    public function delete(): void
    {
        $table = Database::get_main_table(TABLE_MAIN_GRADEBOOK_EVALUATION);
        $sql = 'DELETE FROM '.$table.'
                WHERE id = '.$this->get_id();
        Database::query($sql);
    }

    /**
     * Check if an evaluation name (with the same parent category) already exists.
     *
     * @param string $name to check (if not given, the name property of this object will be checked)
     * @param        $parent parent category
     *
     * @return bool
     * @throws Exception
     */
    public function does_name_exist($name, $parent)
    {
        if (!isset($name)) {
            $name = $this->name;
            $parent = $this->category;
        }
        $tbl_grade_evaluations = Database::get_main_table(TABLE_MAIN_GRADEBOOK_EVALUATION);
        $sql = "SELECT count(id) AS number
                FROM $tbl_grade_evaluations
                WHERE title = '".Database::escape_string($name)."'";

        if (api_is_allowed_to_edit()) {
            $parent = Category::load($parent);
            $courseId = $parent[0]->getCourseId();
            if (isset($courseId) && !empty($courseId)) {
                $table = Database :: get_main_table(TABLE_MAIN_COURSE_USER);
                $sql .= ' AND user_id IN (
					 SELECT user_id FROM '.$table.'
					 WHERE
						c_id = '.$courseId.' AND
						status = '.COURSEMANAGER.'
					)';
            } else {
                $sql .= ' AND user_id = '.api_get_user_id();
            }
        } else {
            $sql .= ' AND user_id = '.api_get_user_id();
        }

        if (!isset($parent)) {
            $sql .= ' AND category_id is null';
        } else {
            $sql .= ' AND category_id = '.intval($parent);
        }
        $result = Database::query($sql);
        $number = Database::fetch_row($result);

        return 0 != $number[0];
    }

    /**
     * Are there any results for this evaluation yet ?
     * The 'max' property should not be changed then.
     *
     * @return bool
     * @throws Exception
     */
    public function has_results(): bool
    {
        $table = Database::get_main_table(TABLE_MAIN_GRADEBOOK_RESULT);
        $sql = 'SELECT count(id) AS number
                FROM '.$table.'
                WHERE evaluation_id = '.$this->get_id().' AND score IS NOT NULL';
        $result = Database::query($sql);
        $number = Database::fetch_row($result);

        return 0 != $number[0];
    }

    /**
     * Delete all results for this evaluation.
     * @throws Exception
     */
    public function delete_results(): void
    {
        $table = Database::get_main_table(TABLE_MAIN_GRADEBOOK_RESULT);
        $sql = 'DELETE FROM '.$table.'
                WHERE evaluation_id = '.$this->get_id();
        Database::query($sql);
    }

    /**
     * Delete this evaluation and all underlying results.
     * @throws Exception
     */
    public function delete_with_results(): void
    {
        $this->delete_results();
        $this->delete();
    }

    /**
     * Check if the given score is possible for this evaluation.
     */
    public function is_valid_score(mixed $score): bool
    {
        return is_numeric($score) && $score >= 0 && $score <= $this->eval_max;
    }

    /**
     * Calculate the score of this evaluation.
     *
     * @param int    $studentId (default: all students who have results for this eval - then the average is returned)
     * @param string $type      (best, average, ranking)
     *
     * @return array (score, max) if student is given
     *               array (sum of scores, number of scores) otherwise
     *               or null if no scores available
     */
    public function calc_score($studentId = null, $type = null): array
    {
        $allowStats = ('true' === api_get_setting('gradebook.allow_gradebook_stats'));

        if ($allowStats) {
            $evaluation = $this->entity;
            if (!empty($evaluation)) {
                $weight = $evaluation->getMax();
                switch ($type) {
                    case 'best':
                        $bestResult = $evaluation->getBestScore();
                        $result = [$bestResult, $weight];

                        return $result;
                        //break;
                    case 'average':
                        $count = count($evaluation->getUserScoreList());
                        if (empty($count)) {
                            $result = [0, $weight];

                            return $result;
                        }

                        $sumResult = array_sum($evaluation->getUserScoreList());
                        $result = [$sumResult / $count, $weight];

                        return $result;
                        //break;
                    case 'ranking':
                        $ranking = AbstractLink::getCurrentUserRanking($studentId, $evaluation->getUserScoreList());

                        return $ranking;
                        //break;
                    default:
                        $weight = $evaluation->getMax();
                        if (!empty($studentId)) {
                            $scoreList = $evaluation->getUserScoreList();
                            $result = [0, $weight];
                            if (isset($scoreList[$studentId])) {
                                $result = [$scoreList[$studentId], $weight];
                            }

                            return $result;
                        } else {
                            $studentCount = count($evaluation->getUserScoreList());
                            $sumResult = array_sum($evaluation->getUserScoreList());
                            $result = [$sumResult, $studentCount];
                        }

                        return $result;
                        //break;
                }
            }
        }

        $useSession = true;
        if (isset($studentId) && empty($type)) {
            $key = 'result_score_student_list_'.api_get_course_int_id().'_'.api_get_session_id().'_'.$this->id.'_'.$studentId;
            $data = Session::read('calc_score');
            $results = isset($data[$key]) ? $data[$key] : null;

            if (false == $useSession) {

It seems like you are loosely comparing two booleans. Considering using the strict comparison === instead.

                $results = null;
            }
            $results = null;
            if (empty($results)) {
                $results = Result::load(null, $studentId, $this->id);
                Session::write('calc_score', [$key => $results]);
            }

            $score = null;
            if (!empty($results)) {
                /** @var Result $res */
                foreach ($results as $res) {
                    $score = $res->get_score();
                }
            }

            return [$score, $this->get_max()];
        } else {
            $count = 0;
            $sum = 0;
            $bestResult = 0;
            $weight = 0;
            $sumResult = 0;

            $key = 'result_score_student_list_'.api_get_course_int_id().'_'.api_get_session_id().'_'.$this->id;
            $data = Session::read('calc_score');
            $allResults = isset($data[$key]) ? $data[$key] : null;
            if (false == $useSession) {

It seems like you are loosely comparing two booleans. Considering using the strict comparison === instead.

                $allResults = null;
            }

            if (empty($allResults)) {
                $allResults = Result::load(null, null, $this->id);
                Session::write($key, $allResults);
            }

            $students = [];
            /** @var Result $res */
            foreach ($allResults as $res) {
                $score = $res->get_score();
                if (!empty($score) || '0' == $score) {
                    $count++;
                    $sum += $score / $this->get_max();
                    $sumResult += $score;
                    if ($score > $bestResult) {
                        $bestResult = $score;
                    }
                    $weight = $this->get_max();
                }
                $students[$res->get_user_id()] = $score;
            }

            if (empty($count)) {
                return [null, null];
            }

            switch ($type) {
                case 'best':
                    return [$bestResult, $weight];
                    //break;
                case 'average':
                    return [$sumResult / $count, $weight];
                    //break;
                case 'ranking':
                    $students = [];
                    /** @var Result $res */
                    foreach ($allResults as $res) {
                        $score = $res->get_score();
                        $students[$res->get_user_id()] = $score;
                    }

                    return AbstractLink::getCurrentUserRanking($studentId, $students);
                    //break;
                default:
                    return [$sum, $count];
                    //break;
            }
        }
    }

    /**
     * Generate an array of possible categories where this evaluation 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(): array
    {
        // - course independent evaluation
        //   -> movable to root or other course independent categories
        // - evaluation inside a course
        //   -> movable to root, independent categories or categories inside the course
        $user = api_is_platform_admin() ? null : api_get_user_id();
        $targets = [];
        $level = 0;
        $root = [0, get_lang('Main folder'), $level];
        $targets[] = $root;

        if (!empty($this->courseId)) {
            $crscats = Category::load(null, null, $this->courseId, 0);
            foreach ($crscats as $cat) {
                $targets[] = [$cat->get_id(), $cat->get_name(), $level + 1];
                $targets = $this->addTargetSubcategories($targets, $level + 1, $cat->get_id());
            }
        }

        $indcats = Category::load(null, $user, 0, 0);
        foreach ($indcats as $cat) {
            $targets[] = [$cat->get_id(), $cat->get_name(), $level + 1];
            $targets = $this->addTargetSubcategories(
                $targets,
                $level + 1,
                $cat->get_id()
            );
        }

        return $targets;
    }

    /**
     * Move this evaluation to the given category.
     * If this evaluation moves from inside a course to outside,
     * its course code is also changed.
     */
    public function move_to_cat(GradebookCategory $cat)
    {
        $this->set_category_id($cat->getId());
        $categoryCourseId = $cat->getCourse()->getId();
        if ($this->getCourseId() != $categoryCourseId) {
            $this->setCourseId($categoryCourseId);
        }
        $this->save();
    }

    /**
     * Retrieve evaluations where a student has results for
     * and return them as an array of Evaluation objects.
     *
     * @param int  $stud_id student id
     * @param ?int $cat_id parent category (use 'null' to retrieve them in all categories)
     *
     * @return array
     * @throws Exception
     */
    public static function get_evaluations_with_result_for_student(int $stud_id, ?int $cat_id = null): array
    {
        $tbl_grade_evaluations = Database::get_main_table(TABLE_MAIN_GRADEBOOK_EVALUATION);
        $tbl_grade_results = Database::get_main_table(TABLE_MAIN_GRADEBOOK_RESULT);

        $sql = 'SELECT * FROM '.$tbl_grade_evaluations.'
                WHERE id IN (
                    SELECT evaluation_id FROM '.$tbl_grade_results.'
                    WHERE user_id = '.$stud_id.' AND score IS NOT NULL
                )';
        if (!api_is_allowed_to_edit()) {
            $sql .= ' AND visible = 1';
        }
        if (isset($cat_id)) {
            $sql .= ' AND category_id = '.$cat_id;
        } else {
            $sql .= ' AND category_id >= 0';
        }

        $result = Database::query($sql);

        return self::create_evaluation_objects_from_sql_result($result);
    }

    /**
     * Get a list of students that do not have a result record for this evaluation.
     *
     * @param string $first_letter_user
     *
     * @return array
     */
    public function get_not_subscribed_students($first_letter_user = '')
    {
        $tbl_user = Database::get_main_table(TABLE_MAIN_USER);
        $table = Database::get_main_table(TABLE_MAIN_GRADEBOOK_RESULT);

        $sql = "SELECT user_id,lastname,firstname,username
                FROM $tbl_user
                WHERE
                    lastname LIKE '".Database::escape_string($first_letter_user)."%' AND
                    status = ".STUDENT." AND user_id NOT IN (
                        SELECT user_id FROM $table
                        WHERE evaluation_id = ".$this->get_id()."
                    )
                ORDER BY lastname";

        $result = Database::query($sql);
        $users = Database::store_result($result);

        return $users;
    }

    /**
     * Find evaluations by name.
     *
     * @param string $name_mask search string
     *
     * @return array evaluation objects matching the search criterium
     *
     * @todo can be written more efficiently using a new (but very complex) sql query
     */
    public static function findEvaluations($name_mask, $selectcat)
    {
        $rootcat = Category::load($selectcat);
        $evals = $rootcat[0]->get_evaluations(
            (api_is_allowed_to_create_course() ? null : api_get_user_id()),
            true
        );
        $foundevals = [];
        foreach ($evals as $eval) {
            if (!(false === api_strpos(api_strtolower($eval->get_name()), api_strtolower($name_mask)))) {
                $foundevals[] = $eval;
            }
        }

        return $foundevals;
    }

    public function get_item_type()
    {
        return 'E';
    }

    public function get_icon_name()
    {
        return $this->has_results() ? 'evalnotempty' : 'evalempty';
    }

    /**
     * Locks an evaluation, only one who can unlock it is the platform administrator.
     *
     * @param int locked 1 or unlocked 0
     */
    public function lock($locked)
    {
        $table_evaluation = Database::get_main_table(TABLE_MAIN_GRADEBOOK_EVALUATION);
        $sql = "UPDATE $table_evaluation
                SET locked = '".intval($locked)."'
                WHERE id='".$this->get_id()."'";
        Database::query($sql);
    }

    public function check_lock_permissions()
    {
        if (api_is_platform_admin()) {
            return true;
        } else {
            if ($this->is_locked()) {
                api_not_allowed();
            }
        }
    }

    public function delete_linked_data()
    {
    }

    /**
     * @return mixed
     */
    public function getStudentList()
    {
        return $this->studentList;
    }

    /**
     * @param $list
     */
    public function setStudentList($list)
    {
        $this->studentList = $list;
    }

    /**
     * @param int $evaluationId
     */
    public static function generateStats($evaluationId)
    {
        $allowStats = ('true' === api_get_setting('gradebook.allow_gradebook_stats'));
        if ($allowStats) {
            $evaluation = self::load($evaluationId);

            $results = Result::load(null, null, $evaluationId);
            $sumResult = 0;
            $bestResult = 0;
            $average = 0;
            $scoreList = [];

            if (!empty($results)) {
                /** @var Result $result */
                foreach ($results as $result) {
                    $score = $result->get_score();
                    $scoreList[$result->get_user_id()] = $score;
                    $sumResult += $score;
                    if ($score > $bestResult) {
                        $bestResult = $score;
                    }
                }
                $average = $sumResult / count($results);
            }

            /** @var Evaluation $evaluation */
            $evaluation = $evaluation[0];
            $evaluation = $evaluation->entity;
            $evaluation
                ->setBestScore($bestResult)
                ->setAverageScore($average)
                ->setUserScoreList($scoreList)
            ;

            $em = Database::getManager();
            $em->persist($evaluation);
            $em->flush();
        }
    }

    /**
     *
     * @param int $courseId
     *
     * @return Evaluation
     */
    public function setCourseId(?int $courseId = null): Evaluation
    {
        $courseInfo = api_get_course_info_by_id($courseId);
        if (!empty($courseInfo)) {
            $this->course_code = $courseInfo['code'];
            $this->courseId = $courseId;
        } else {
            $this->course_code = null;
            $this->courseId = null;
        }

        return $this;
    }

    /**
     * @param array $result
     *
     * @return array
     */
    private static function create_evaluation_objects_from_sql_result($result)
    {
        $alleval = [];
        $allow = ('true' === api_get_setting('gradebook.allow_gradebook_stats'));
        if ($allow) {
            $em = Database::getManager();
            $repo = $em->getRepository(GradebookEvaluation::class);
        }

        if (Database::num_rows($result)) {
            while ($data = Database::fetch_array($result)) {
                $eval = new Evaluation();
                $eval->set_id($data['id']);
                $eval->set_name($data['title']);
                $eval->set_description($data['description']);
                $eval->set_user_id($data['user_id']);
                $eval->setCourseId($data['c_id']);
                $eval->set_category_id($data['category_id']);
                $eval->set_date(api_get_local_time($data['created_at']));
                $eval->set_weight($data['weight']);
                $eval->set_max($data['max']);
                $eval->set_visible($data['visible']);
                $eval->set_type($data['type']);
                $eval->set_locked($data['locked']);
                $eval->setSessionId(api_get_session_id());

                if ($allow) {
                    $eval->entity = $repo->find($data['id']);

The variable $repo does not seem to be defined for all execution paths leading up to this point.

                }

                $alleval[] = $eval;
            }
        }

        return $alleval;
    }

    /**
     * Internal function used by get_target_categories().
     *
     * @param array $targets
     * @param int   $level
     * @param int   $categoryId
     *
     * @return array
     */
    private function addTargetSubcategories($targets, $level, $categoryId)
    {
        $subcats = Category::load(null, null, 0, $categoryId);
        foreach ($subcats as $cat) {
            $targets[] = [$cat->get_id(), $cat->get_name(), $level + 1];
            $targets = $this->addTargetSubcategories(
                $targets,
                $level + 1,
                $cat->get_id()
            );
        }

        return $targets;
    }
}