ilExAssignmentGUI Class Reference

GUI class for exercise assignments. More...

Collaboration diagram for ilExAssignmentGUI:

Public Member Functions
	__construct (ilObjExercise $a_exc)
	Constructor. More...
	getOverviewHeader (ilExAssignment $a_ass)
	Get assignment header for overview. More...
	getOverviewBody (ilExAssignment $a_ass)
	Get assignment body for overview. More...
	getTimeString ($a_deadline)
	Get time string for deadline. More...

Protected Member Functions
	addInstructions (ilInfoScreenGUI $a_info, ilExAssignment $a_ass)
	addSchedule (ilInfoScreenGUI $a_info, ilExAssignment $a_ass)
	addPublicSubmissions (ilInfoScreenGUI $a_info, ilExAssignment $a_ass)
	addFiles (ilInfoScreenGUI $a_info, ilExAssignment $a_ass)
	addSubmission (ilInfoScreenGUI $a_info, ilExAssignment $a_ass)
	addSubmissionFeedback (ilInfoScreenGUI $a_info, ilExAssignment $a_ass, $a_feedback_id, $a_show_global_feedback)
	getSubmissionLink ($a_cmd, array $a_params=null)

Protected Attributes
	$exc
	$current_ass_id

Detailed Description

GUI class for exercise assignments.

This is not a real GUI class, could be moved to ilObjExerciseGUI

Author

Alex Killing alex..nosp@m.kill.nosp@m.ing@g.nosp@m.mx.d.nosp@m.e

Version

$Id$

Definition at line 11 of file class.ilExAssignmentGUI.php.

Constructor & Destructor Documentation

__construct()

ilExAssignmentGUI::__construct

(

ilObjExercise

$a_exc

)

Constructor.

Definition at line 19 of file class.ilExAssignmentGUI.php.

        {
                $this->exc = $a_exc;
        }       

Member Function Documentation

addFiles()

ilExAssignmentGUI::addFiles ( ilInfoScreenGUI  $a_info, ilExAssignment  $a_ass  )

protected

Definition at line 247 of file class.ilExAssignmentGUI.php.

References $file, $files, $ilCtrl, $lng, ilInfoScreenGUI\addProperty(), ilInfoScreenGUI\addSection(), array, ilExAssignment\getFiles(), and getSubmissionLink().

Referenced by getOverviewBody().

        {               
                global $lng, $ilCtrl;
                
                $files = $a_ass->getFiles();
                if (count($files) > 0)
                {
                        $a_info->addSection($lng->txt("exc_files"));
                        foreach($files as $file)
                        {
                                $a_info->addProperty($file["name"], $lng->txt("download"), $this->getSubmissionLink("downloadFile", array("file"=>urlencode($file["name"]))));
                        }
                }                       
        }

Here is the call graph for this function:

Here is the caller graph for this function:

addInstructions()

ilExAssignmentGUI::addInstructions ( ilInfoScreenGUI  $a_info, ilExAssignment  $a_ass  )

protected

Definition at line 147 of file class.ilExAssignmentGUI.php.

References $lng, ilInfoScreenGUI\addProperty(), ilInfoScreenGUI\addSection(), ilExAssignment\getInstruction(), ilUtil\makeClickable(), and ilExAssignment\notStartedYet().

Referenced by getOverviewBody().

        {               
                global $lng;
                
                if (!$a_ass->notStartedYet())
                {                       
                        $inst = $a_ass->getInstruction();       
                        if(trim($inst))
                        {                               
                                $a_info->addSection($lng->txt("exc_instruction"));

                                $is_html = (strlen($inst) != strlen(strip_tags($inst)));
                                if(!$is_html)
                                {
                                        $inst = nl2br(ilUtil::makeClickable($inst, true));
                                }                                               
                                $a_info->addProperty("", $inst);
                        }
                }
        }

Here is the call graph for this function:

Here is the caller graph for this function:

addPublicSubmissions()

ilExAssignmentGUI::addPublicSubmissions ( ilInfoScreenGUI  $a_info, ilExAssignment  $a_ass  )

protected

Definition at line 228 of file class.ilExAssignmentGUI.php.

References $lng, ilInfoScreenGUI\addProperty(), ilExAssignment\afterDeadline(), ilLinkButton\getInstance(), and getSubmissionLink().

Referenced by getOverviewBody().

        {               
                global $lng;
                
                if ($a_ass->afterDeadline())
                {                               
                        $button = ilLinkButton::getInstance();                          
                        $button->setCaption("exc_list_submission");
                        $button->setUrl($this->getSubmissionLink("listPublicSubmissions"));                                                     

                        $a_info->addProperty($lng->txt("exc_public_submission"), $button->render());
                }
                else
                {
                        $a_info->addProperty($lng->txt("exc_public_submission"),
                                $lng->txt("exc_msg_public_submission"));
                }               
        }

Here is the call graph for this function:

Here is the caller graph for this function:

addSchedule()

ilExAssignmentGUI::addSchedule ( ilInfoScreenGUI  $a_info, ilExAssignment  $a_ass  )

protected

Definition at line 168 of file class.ilExAssignmentGUI.php.

References $ilUser, $lng, ilInfoScreenGUI\addProperty(), ilInfoScreenGUI\addSection(), ilExAssignment\beforeDeadline(), ilDatePresentation\formatDate(), ilExAssignment\getDeadline(), ilExAssignment\getPersonalDeadline(), ilExAssignment\getStartTime(), IL_CAL_UNIX, ilExAssignment\notStartedYet(), and time.

Referenced by getOverviewBody().

        {               
                global $lng, $ilUser;
                
                $idl = $a_ass->getPersonalDeadline($ilUser->getId());           
                
                $a_info->addSection($lng->txt("exc_schedule"));
                if ($a_ass->getStartTime() > 0)
                {
                        $a_info->addProperty($lng->txt("exc_start_time"),
                                ilDatePresentation::formatDate(new ilDateTime($a_ass->getStartTime(),IL_CAL_UNIX)));
                }
                
                // extended deadline info/warning                                               
                $late_dl = "";
                if ($idl &&
                        $idl < time() &&                                
                        $a_ass->beforeDeadline()) // ext dl is last deadline
                {                               
                        // extended deadline date should not be presented anywhere
                        $late_dl = ilDatePresentation::formatDate(new ilDateTime($idl, IL_CAL_UNIX));
                        $late_dl = "<br />".sprintf($lng->txt("exc_late_submission_warning"), $late_dl);                                                                
                        $late_dl = '<span class="warning">'.$late_dl.'</span>';                                                                 
                }                       
                
                if ($a_ass->getDeadline())
                {
                        $until = ilDatePresentation::formatDate(new ilDateTime($a_ass->getDeadline(),IL_CAL_UNIX));
                        
                        // add late info if no idl
                        if ($late_dl &&
                                $idl == $a_ass->getDeadline())
                        {
                                $until .= $late_dl;
                        }
                        
                        $a_info->addProperty($lng->txt("exc_edit_until"), $until);                      
                }
                
                if ($idl && 
                        $idl != $a_ass->getDeadline())
                {
                        $until = ilDatePresentation::formatDate(new ilDateTime($idl,IL_CAL_UNIX));
                        
                        // add late info?
                        if ($late_dl)
                        {
                                $until .= $late_dl;
                        }
                        
                        $a_info->addProperty($lng->txt("exc_individual_deadline"), $until);     
                }
                                
                if (!$a_ass->notStartedYet())
                {
                        $a_info->addProperty($lng->txt("exc_time_to_send"),
                                "<b>".$this->getTimeString($idl)."</b>");
                }
        }

Here is the call graph for this function:

Here is the caller graph for this function:

addSubmission()

ilExAssignmentGUI::addSubmission ( ilInfoScreenGUI  $a_info, ilExAssignment  $a_ass  )

protected

Definition at line 262 of file class.ilExAssignmentGUI.php.

References $ilCtrl, $ilUser, $lng, ilInfoScreenGUI\addProperty(), ilInfoScreenGUI\addSection(), addSubmissionFeedback(), ilExAssignment\afterDeadlineStrict(), ilExAssignment\FEEDBACK_DATE_DEADLINE, ilDatePresentation\formatDate(), ilExAssignment\getFeedbackDate(), ilExAssignment\getFeedbackFile(), ilExAssignment\getId(), ilExSubmissionGUI\getOverviewContent(), ilExPeerReviewGUI\getOverviewContent(), and IL_CAL_DATETIME.

Referenced by getOverviewBody().

        {               
                global $lng, $ilCtrl, $ilUser;

                $a_info->addSection($lng->txt("exc_your_submission"));

                include_once "Modules/Exercise/classes/class.ilExSubmission.php";
                $submission = new ilExSubmission($a_ass, $ilUser->getId());

                include_once "Modules/Exercise/classes/class.ilExSubmissionGUI.php";
                ilExSubmissionGUI::getOverviewContent($a_info, $submission);

                $last_sub = null;
                if($submission->hasSubmitted())
                {
                        $last_sub = $submission->getLastSubmission();
                        if($last_sub)
                        {
                                $last_sub = ilDatePresentation::formatDate(new ilDateTime($last_sub,IL_CAL_DATETIME));
                                $a_info->addProperty($lng->txt("exc_last_submission"), $last_sub);
                        }
                }

                include_once "Modules/Exercise/classes/class.ilExPeerReviewGUI.php";
                ilExPeerReviewGUI::getOverviewContent($a_info, $submission);

                // global feedback / sample solution
                if($a_ass->getFeedbackDate() == ilExAssignment::FEEDBACK_DATE_DEADLINE)
                {
                        $show_global_feedback = ($a_ass->afterDeadlineStrict() && $a_ass->getFeedbackFile());
                }
                else
                {
                        $show_global_feedback = ($last_sub && $a_ass->getFeedbackFile());
                }

                $this->addSubmissionFeedback($a_info, $a_ass, $submission->getFeedbackId(), $show_global_feedback);
        }

Here is the call graph for this function:

Here is the caller graph for this function:

addSubmissionFeedback()

ilExAssignmentGUI::addSubmissionFeedback ( ilInfoScreenGUI  $a_info, ilExAssignment  $a_ass,   $a_feedback_id,   $a_show_global_feedback  )

protected

Definition at line 301 of file class.ilExAssignmentGUI.php.

References $file, $files, $img, $lng, ilInfoScreenGUI\addProperty(), ilInfoScreenGUI\addSection(), array, ilFSStorageExercise\countFeedbackFiles(), ilExAssignment\getExerciseId(), ilExAssignment\getFeedbackFile(), ilExAssignment\getId(), ilExAssignment\getMemberStatus(), and getSubmissionLink().

Referenced by addSubmission().

        {
                global $lng;
                
                $storage = new ilFSStorageExercise($a_ass->getExerciseId(), $a_ass->getId());                                   
                $cnt_files = $storage->countFeedbackFiles($a_feedback_id);
                
                $lpcomment = $a_ass->getMemberStatus()->getComment();
                $mark = $a_ass->getMemberStatus()->getMark();
                $status = $a_ass->getMemberStatus()->getStatus();       
                
                if ($lpcomment != "" || 
                        $mark != "" || 
                        $status != "notgraded" || 
                        $cnt_files > 0 || 
                        $a_show_global_feedback)
                {
                        $a_info->addSection($lng->txt("exc_feedback_from_tutor"));
                        if ($lpcomment != "")
                        {
                                $a_info->addProperty($lng->txt("exc_comment"),
                                        nl2br($lpcomment));
                        }
                        if ($mark != "")
                        {
                                $a_info->addProperty($lng->txt("exc_mark"),
                                        $mark);
                        }

                        if ($status == "") 
                        {
//                                $a_info->addProperty($lng->txt("status"),
//                                              $lng->txt("message_no_delivered_files"));                               
                        }
                        else if ($status != "notgraded")
                        {
                                $img = '<img src="'.ilUtil::getImagePath("scorm/".$status.".svg").'" '.
                                        ' alt="'.$lng->txt("exc_".$status).'" title="'.$lng->txt("exc_".$status).
                                        '" />';
                                $a_info->addProperty($lng->txt("status"),
                                        $img." ".$lng->txt("exc_".$status));
                        }

                        if ($cnt_files > 0)
                        {
                                $a_info->addSection($lng->txt("exc_fb_files").
                                        '<a name="fb'.$a_ass->getId().'"></a>');

                                if($cnt_files > 0)
                                {
                                        $files = $storage->getFeedbackFiles($a_feedback_id);
                                        foreach($files as $file)
                                        {                                                               
                                                $a_info->addProperty($file,
                                                        $lng->txt("download"),
                                                        $this->getSubmissionLink("downloadFeedbackFile", array("file"=>urlencode($file))));                                                             
                                        }
                                }                                                                                               
                        }       

                        // #15002 - global feedback                                                                                                                                     
                        if($a_show_global_feedback)
                        {
                                $a_info->addSection($lng->txt("exc_global_feedback_file"));

                                $a_info->addProperty($a_ass->getFeedbackFile(),
                                        $lng->txt("download"),
                                        $this->getSubmissionLink("downloadGlobalFeedbackFile"));                                                                
                        }
                }                       
        }

Here is the call graph for this function:

Here is the caller graph for this function:

getOverviewBody()

ilExAssignmentGUI::getOverviewBody

(

ilExAssignment

$a_ass

)

Get assignment body for overview.

Definition at line 115 of file class.ilExAssignmentGUI.php.

References $info, $tpl, addFiles(), addInstructions(), addPublicSubmissions(), addSchedule(), addSubmission(), ilExAssignment\getId(), and ilExAssignment\notStartedYet().

        {               
                $this->current_ass_id = $a_ass->getId();
                
                $tpl = new ilTemplate("tpl.assignment_body.html", true, true, "Modules/Exercise");

                include_once("./Services/InfoScreen/classes/class.ilInfoScreenGUI.php");
                include_once("./Services/UIComponent/Button/classes/class.ilLinkButton.php");

                $info = new ilInfoScreenGUI(null);
                $info->setTableClass("");
                
                $this->addInstructions($info, $a_ass);
                $this->addSchedule($info, $a_ass);
                
                if ($this->exc->getShowSubmissions())
                {
                        $this->addPublicSubmissions($info, $a_ass);
                }
                
                if (!$a_ass->notStartedYet())
                {
                        $this->addFiles($info, $a_ass);
                        $this->addSubmission($info, $a_ass);                    
                }

                $tpl->setVariable("CONTENT", $info->getHTML());
                
                return $tpl->get();
        }

Here is the call graph for this function:

getOverviewHeader()

ilExAssignmentGUI::getOverviewHeader

(

ilExAssignment

$a_ass

)

Get assignment header for overview.

Definition at line 27 of file class.ilExAssignmentGUI.php.

References $ilUser, $lng, $tpl, ilDatePresentation\formatDate(), ilExAssignment\getDeadline(), ilUtil\getImagePath(), ilExAssignment\getMandatory(), ilExAssignment\getMemberStatus(), ilExAssignment\getPeerReview(), ilExAssignment\getPeerReviewDeadline(), ilExAssignment\getPersonalDeadline(), ilExAssignment\getStartTime(), getTimeString(), ilExAssignment\getTitle(), IL_CAL_UNIX, ilExAssignment\notStartedYet(), and time.

        {
                global $lng, $ilUser;
                
                $lng->loadLanguageModule("exc");
                
                $tpl = new ilTemplate("tpl.assignment_head.html", true, true, "Modules/Exercise");
                
                // we are completely ignoring the extended deadline here
                
                $idl = $a_ass->getPersonalDeadline($ilUser->getId());
                
                // :TODO: meaning of "ended on"
                $dl = max($a_ass->getDeadline(), $idl);         
                if ($dl &&
                        $dl < time())
                {
                        $tpl->setCurrentBlock("prop");
                        $tpl->setVariable("PROP", $lng->txt("exc_ended_on"));
                        $tpl->setVariable("PROP_VAL",
                                ilDatePresentation::formatDate(new ilDateTime($a_ass->getDeadline(),IL_CAL_UNIX)));
                        $tpl->parseCurrentBlock();
                        
                        // #14077
                        if($a_ass->getPeerReview() &&
                                $a_ass->getPeerReviewDeadline())
                        {                                                               
                                $tpl->setCurrentBlock("prop");
                                $tpl->setVariable("PROP", $lng->txt("exc_peer_review_deadline"));
                                $tpl->setVariable("PROP_VAL",
                                        ilDatePresentation::formatDate(new ilDateTime($a_ass->getPeerReviewDeadline(),IL_CAL_UNIX)));
                                $tpl->parseCurrentBlock();
                        }               
                }
                else if ($a_ass->notStartedYet())
                {
                        $tpl->setCurrentBlock("prop");
                        $tpl->setVariable("PROP", $lng->txt("exc_starting_on"));
                        $tpl->setVariable("PROP_VAL",
                                ilDatePresentation::formatDate(new ilDateTime($a_ass->getStartTime(),IL_CAL_UNIX)));
                        $tpl->parseCurrentBlock();
                }
                else
                {                                       
                        $time_str = $this->getTimeString($idl);
                        $tpl->setCurrentBlock("prop");
                        $tpl->setVariable("PROP", $lng->txt("exc_time_to_send"));
                        $tpl->setVariable("PROP_VAL", $time_str);
                        $tpl->parseCurrentBlock();
        
                        if ($a_ass->getDeadline())
                        {
                                $tpl->setCurrentBlock("prop");
                                $tpl->setVariable("PROP", $lng->txt("exc_edit_until"));
                                $tpl->setVariable("PROP_VAL",
                                        ilDatePresentation::formatDate(new ilDateTime($a_ass->getDeadline(),IL_CAL_UNIX)));
                                $tpl->parseCurrentBlock();
                        }
                        
                        if ($idl && $idl != $a_ass->getDeadline())
                        {
                                $tpl->setCurrentBlock("prop");
                                $tpl->setVariable("PROP", $lng->txt("exc_individual_deadline"));
                                $tpl->setVariable("PROP_VAL",
                                        ilDatePresentation::formatDate(new ilDateTime($idl,IL_CAL_UNIX)));
                                $tpl->parseCurrentBlock();
                        }               
                }

                $mand = "";
                if ($a_ass->getMandatory())
                {
                        $mand = " (".$lng->txt("exc_mandatory").")";
                }
                $tpl->setVariable("TITLE", $a_ass->getTitle().$mand);

                // status icon
                $stat = $a_ass->getMemberStatus()->getStatus();
                $pic = $a_ass->getMemberStatus()->getStatusIcon();      
                $tpl->setVariable("IMG_STATUS", ilUtil::getImagePath($pic));
                $tpl->setVariable("ALT_STATUS", $lng->txt("exc_".$stat));

                return $tpl->get();
        }

Here is the call graph for this function:

getSubmissionLink()

ilExAssignmentGUI::getSubmissionLink (   $a_cmd, array  $a_params = null  )

protected

Definition at line 397 of file class.ilExAssignmentGUI.php.

References $ilCtrl, and $url.

Referenced by addFiles(), addPublicSubmissions(), and addSubmissionFeedback().

        {
                global $ilCtrl;
                
                if(is_array($a_params))
                {
                        foreach($a_params as $name => $value)
                        {
                                $ilCtrl->setParameterByClass("ilexsubmissiongui", $name, $value);
                        }
                }
                
                $ilCtrl->setParameterByClass("ilexsubmissiongui", "ass_id", $this->current_ass_id);
                $url = $ilCtrl->getLinkTargetByClass("ilexsubmissiongui", $a_cmd);
                $ilCtrl->setParameterByClass("ilexsubmissiongui", "ass_id", "");
                
                if(is_array($a_params))
                {
                        foreach($a_params as $name => $value)
                        {
                                $ilCtrl->setParameterByClass("ilexsubmissiongui", $name, "");
                        }
                }
                
                return $url;
        }

Here is the caller graph for this function:

getTimeString()

ilExAssignmentGUI::getTimeString

(

$a_deadline

)

Get time string for deadline.

Definition at line 376 of file class.ilExAssignmentGUI.php.

References $lng, IL_CAL_UNIX, ilUtil\period2String(), and time.

Referenced by getOverviewHeader().

        {
                global $lng;
                
                if ($a_deadline == 0)
                {
                        return $lng->txt("exc_no_deadline_specified");
                }
                
                if ($a_deadline - time() <= 0)
                {
                        $time_str = $lng->txt("exc_time_over_short");
                }
                else
                {                       
                        $time_str = ilUtil::period2String(new ilDateTime($a_deadline, IL_CAL_UNIX));
                }

                return $time_str;
        }

Here is the call graph for this function:

Here is the caller graph for this function:

Field Documentation

$current_ass_id

ilExAssignmentGUI::$current_ass_id

protected

Definition at line 14 of file class.ilExAssignmentGUI.php.

$exc

ilExAssignmentGUI::$exc

protected

Definition at line 13 of file class.ilExAssignmentGUI.php.

---

The documentation for this class was generated from the following file:

• Modules/Exercise/classes/class.ilExAssignmentGUI.php