File Source for evallink.class.php

<?php
/**
* Class to be used as basis for links referring to Evaluation objects.
* @author Bert Steppé
* @package dokeos.gradebook
*/
abstract class EvalLink extends AbstractLink
{
protected $evaluation = null;
/**
* Constructor
*/
function EvalLink()
{
}
// Functions implementing AbstractLink
public function has_results()
{
$eval = $this->get_evaluation();
return $eval->has_results();
}
public function calc_score($stud_id = null)
{
$eval = $this->get_evaluation();
return $eval->calc_score($stud_id);
}
public function get_link()
{
$eval = $this->get_evaluation();
// course/platform admin can go to the view_results page
if (api_is_allowed_to_create_course())
return 'gradebook_view_result.php?selecteval=' . $eval->get_id();
// students can go to the statistics page (if custom display enabled)
elseif (ScoreDisplay :: instance()->is_custom())
return 'gradebook_statistics.php?selecteval=' . $eval->get_id();
else
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->link_date = $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);
}
// INTERNAL FUNCTIONS
/**
* 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(time()); // 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;
}
}
?>

Source for file evallink.class.php