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
	$lng
	$user
	$ctrl
	$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 34 of file class.ilExAssignmentGUI.php.

References $DIC, and user().

    {
        global $DIC;

        $this->lng = $DIC->language();
        $this->user = $DIC->user();
        $this->ctrl = $DIC->ctrl();
        $this->exc = $a_exc;
    }

Here is the call graph for this function:

Member Function Documentation

addFiles()

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

protected

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

References $ctrl, $DIC, $file, $files, $format, $ilCtrl, $lng, $type, ilInfoScreenGUI\addProperty(), ilInfoScreenGUI\addSection(), array, ilExAssignment\getFiles(), ilExAssignment\getId(), ilUtil\getImagePath(), ilModalGUI\getInstance(), ilObjMediaObject\getMimeType(), getSubmissionLink(), and ilModalGUI\TYPE_LARGE.

Referenced by getOverviewBody().

    {
        $lng = $this->lng;
        $ilCtrl = $this->ctrl;
        
        $files = $a_ass->getFiles();

        if (count($files) > 0) {
            $a_info->addSection($lng->txt("exc_files"));

            global $DIC;

            //file has -> name,fullpath,size,ctime
            include_once("./Services/MediaObjects/classes/class.ilObjMediaObject.php");
            include_once("./Services/MediaObjects/classes/class.ilMediaPlayerGUI.php");
            include_once "./Services/UIComponent/Modal/classes/class.ilModalGUI.php";

            $cnt = 0;
            foreach ($files as $file) {
                $cnt++;
                // get mime type
                $mime = ilObjMediaObject::getMimeType($file['fullpath']);

                list($format, $type) = explode("/", $mime);

                $ui_factory = $DIC->ui()->factory();
                $ui_renderer = $DIC->ui()->renderer();

                if (in_array($mime, array("image/jpeg", "image/svg+xml", "image/gif", "image/png"))) {
                    $item_id = "il-ex-modal-img-" . $a_ass->getId() . "-" . $cnt;


                    $image = $ui_renderer->render($ui_factory->image()->responsive($file['fullpath'], $file['name']));
                    $image_lens = ilUtil::getImagePath("enlarge.svg");

                    $modal = ilModalGUI::getInstance();
                    $modal->setId($item_id);
                    $modal->setType(ilModalGUI::TYPE_LARGE);
                    $modal->setBody($image);
                    $modal->setHeading($file["name"]);
                    $modal = $modal->getHTML();

                    $img_tpl = new ilTemplate("tpl.image_file.html", true, true, "Modules/Exercise");
                    $img_tpl->setCurrentBlock("image_content");
                    $img_tpl->setVariable("MODAL", $modal);
                    $img_tpl->setVariable("ITEM_ID", $item_id);
                    $img_tpl->setVariable("IMAGE", $image);
                    $img_tpl->setvariable("IMAGE_LENS", $image_lens);
                    $img_tpl->parseCurrentBlock();

                    $a_info->addProperty($file["name"], $img_tpl->get());
                } elseif (in_array($mime, array("audio/mpeg", "audio/ogg", "video/mp4", "video/x-flv", "video/webm"))) {
                    $media_tpl = new ilTemplate("tpl.media_file.html", true, true, "Modules/Exercise");
                    $mp = new ilMediaPlayerGUI();
                    $mp->setFile($file['fullpath']);
                    $media_tpl->setVariable("MEDIA", $mp->getMediaPlayerHtml());

                    $but = $ui_factory->button()->shy(
                        $lng->txt("download"),
                        $this->getSubmissionLink("downloadFile", array("file"=>urlencode($file["name"])))
                    );
                    $media_tpl->setVariable("DOWNLOAD_BUTTON", $ui_renderer->render($but));
                    $a_info->addProperty($file["name"], $media_tpl->get());
                } else {
                    $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 167 of file class.ilExAssignmentGUI.php.

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

Referenced by getOverviewBody().

    {
        $lng = $this->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 243 of file class.ilExAssignmentGUI.php.

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

Referenced by addSubmission().

    {
        $lng = $this->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 185 of file class.ilExAssignmentGUI.php.

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

Referenced by getOverviewBody().

    {
        $lng = $this->lng;
        $ilUser = $this->user;
        
        $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 331 of file class.ilExAssignmentGUI.php.

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

Referenced by getOverviewBody().

    {
        $lng = $this->lng;
        $ilCtrl = $this->ctrl;
        $ilUser = $this->user;

        $a_info->addSection($lng->txt("exc_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);
            }
        }

        if ($this->exc->getShowSubmissions()) {
            $this->addPublicSubmissions($a_info, $a_ass);
        }

        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 371 of file class.ilExAssignmentGUI.php.

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

Referenced by addSubmission().

    {
        $lng = $this->lng;

        include_once("./Modules/Exercise/classes/class.ilFSStorageExercise.php");

        $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"));
            } elseif ($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 137 of file class.ilExAssignmentGUI.php.

References $info, $tpl, addFiles(), addInstructions(), 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);

        if (!$a_ass->notStartedYet()) {
            $this->addFiles($info, $a_ass);
        }

        $this->addSchedule($info, $a_ass);
        
        if (!$a_ass->notStartedYet()) {
            $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 47 of file class.ilExAssignmentGUI.php.

References $ilUser, $lng, $tpl, $user, 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.

    {
        $lng = $this->lng;
        $ilUser = $this->user;
        
        $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();
            }
        } elseif ($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 465 of file class.ilExAssignmentGUI.php.

References $ctrl, $ilCtrl, $name, and $url.

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

    {
        $ilCtrl = $this->ctrl;
        
        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 448 of file class.ilExAssignmentGUI.php.

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

Referenced by addSchedule(), and getOverviewHeader().

    {
        $lng = $this->lng;
        
        if ($a_deadline == 0) {
            return $lng->txt("exc_submit_convenience_no_deadline");
        }
        
        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

$ctrl

ilExAssignmentGUI::$ctrl

protected

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

Referenced by addFiles(), addSubmission(), and getSubmissionLink().

$current_ass_id

ilExAssignmentGUI::$current_ass_id

protected

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

$exc

ilExAssignmentGUI::$exc

protected

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

$lng

ilExAssignmentGUI::$lng

protected

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

Referenced by addFiles(), addInstructions(), addPublicSubmissions(), addSchedule(), addSubmission(), addSubmissionFeedback(), getOverviewHeader(), and getTimeString().

$user

ilExAssignmentGUI::$user

protected

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

Referenced by addSchedule(), addSubmission(), and getOverviewHeader().

---

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

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