chamilo-lms/public/main/gradebook/lib/be/evallink.class.php

<?php

/* For licensing terms, see /license.txt */

/**
 * Class to be used as basis for links referring to Evaluation objects.
 *
 * @author Bert Steppé
 */
abstract class EvalLink extends AbstractLink
{
    protected $evaluation;

    /**
     * @return bool
     */
    public function has_results()
    {
        $eval = $this->get_evaluation();

        return $eval->has_results();
    }

    /**
     * @param int    $userId
     * @param string $type
     *
     * @return array
     */
    public function calc_score($studentId = null, $type = null)
    {
        $eval = $this->get_evaluation();

        return $eval->calc_score($studentId, $type);
    }

    public function get_link()
    {
        $eval = $this->get_evaluation();
        // course/platform admin can go to the view_results page
        if (api_is_allowed_to_edit()) {
            return 'gradebook_view_result.php?'.api_get_cidreq().'&selecteval='.$eval->get_id();
        } elseif (ScoreDisplay::instance()->is_custom()) {
            // students can go to the statistics page (if custom display enabled)

            return 'gradebook_statistics.php?'.api_get_cidreq().'&selecteval='.$eval->get_id();
        }

        return null;
    }

    public function get_name()
    {
        $eval = $this->get_evaluation();

        return $eval->get_name();
    }

    public function get_description()
    {
        $eval = $this->get_evaluation();

        return $eval->get_description();
    }

    public function get_max()
    {
        $eval = $this->get_evaluation();

        return $eval->get_max();
    }

    public function is_valid_link()
    {
        $eval = $this->get_evaluation();

        return isset($eval);
    }

    public function needs_name_and_description()
    {
        return true;
    }

    public function needs_max()
    {
        return true;
    }

    public function needs_results()
    {
        return true;
    }

    public function add_linked_data()
    {
        if ($this->is_valid_link()) {
            $this->evaluation->add();
            $this->set_ref_id($this->evaluation->get_id());
        }
    }

    public function save_linked_data()
    {
        if ($this->is_valid_link()) {
            $this->evaluation->save();
        }
    }

    public function delete_linked_data()
    {
        if ($this->is_valid_link()) {
            $this->evaluation->delete_with_results();
        }
    }

    public function set_name($name)
    {
        if ($this->is_valid_link()) {
            $this->evaluation->set_name($name);
        }
    }

    public function set_description($description)
    {
        if ($this->is_valid_link()) {
            $this->evaluation->set_description($description);
        }
    }

    public function set_max($max)
    {
        if ($this->is_valid_link()) {
            $this->evaluation->set_max($max);
        }
    }

    // Functions overriding non-trivial implementations from AbstractLink
    public function set_date($date)
    {
        $this->created_at = $date;
        if ($this->is_valid_link()) {
            $this->evaluation->set_date($date);
        }
    }

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

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

    /**
     * Lazy load function to get the linked evaluation.
     */
    protected function get_evaluation()
    {
        if (!isset($this->evaluation)) {
            if (isset($this->ref_id)) {
                $evalarray = Evaluation::load($this->get_ref_id());
                $this->evaluation = $evalarray[0];
            } else {
                $eval = new Evaluation();
                $eval->set_category_id(-1);
                $eval->set_date(api_get_utc_datetime()); // these values will be changed
                $eval->set_weight(0); //   when the link setter
                $eval->set_visible(0); //     is called
                $eval->set_id(-1); // a 'real' id will be set when eval is added to db
                $eval->set_user_id($this->get_user_id());
                $eval->set_course_code($this->get_course_code());
                $this->evaluation = $eval;
                $this->set_ref_id($eval->get_id());
            }
        }

        return $this->evaluation;
    }
}