ilExPeerReviewGUI Class Reference

Class ilExPeerReviewGUI. More...

Collaboration diagram for ilExPeerReviewGUI:

Public Member Functions
	__construct (ilExAssignment $a_ass, ilExSubmission $a_submission=null)
	Constructor. More...
	executeCommand ()
	returnToParentObject ()
	showGivenPeerReviewObject ()
	showReceivedPeerReviewObject ()
	editPeerReviewObject ()
	editPeerReviewItemObject (ilPropertyFormGUI $a_form=null)
	updateCritAjaxObject ()
	updatePeerReviewObject ()
	downloadPeerReviewObject ()
	showPeerReviewOverviewObject ()
	confirmResetPeerReviewObject ()
	resetPeerReviewObject ()

Static Public Member Functions
static	getOverviewContent (ilInfoScreenGUI $a_info, ilExSubmission $a_submission)

Protected Member Functions
	canGive ()
	canView ()
	renderInfoWidget (ilInfoScreenGUI $a_info_widget, array $a_peer_items, $a_by_peer=false)
	getLateSubmissionInfo (ilExSubmission $a_submission)
	isValidPeer ($a_peer_id)
	getSubmissionContent (ilExSubmission $a_submission)
	initPeerReviewItemForm ($a_peer_id)
	handlePeerReviewChange ()

Protected Attributes
	$ctrl
	$tabs_gui
	$lng
	$tpl
	$user
	$ass
	$submission

Detailed Description

Class ilExPeerReviewGUI.

Author

Jörg Lützenkirchen luetz.nosp@m.enki.nosp@m.rchen.nosp@m.@lei.nosp@m.fos.c.nosp@m.om

ilExPeerReviewGUI: ilFileSystemGUI, ilRatingGUI, ilExSubmissionTextGUI, ilInfoScreenGUI

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

Constructor & Destructor Documentation

__construct()

ilExPeerReviewGUI::__construct	(	ilExAssignment	$a_ass,
		ilExSubmission	$a_submission = null
	)

Constructor.

Parameters

ilExAssignment	$a_ass
ilExSubmission	$a_sub

Returns

object

Definition at line 50 of file class.ilExPeerReviewGUI.php.

References $DIC, $ilCtrl, $lng, $tpl, and user().

    {
        global $DIC;

        $this->user = $DIC->user();
        $ilCtrl = $DIC->ctrl();
        $ilTabs = $DIC->tabs();
        $lng = $DIC->language();
        $tpl = $DIC["tpl"];
        
        $this->ass = $a_ass;
        $this->submission = $a_submission;
        
        // :TODO:
        $this->ctrl = $ilCtrl;
        $this->tabs_gui = $ilTabs;
        $this->lng = $lng;
        $this->tpl = $tpl;
    }

Here is the call graph for this function:

Member Function Documentation

canGive()

ilExPeerReviewGUI::canGive ( )

protected

Definition at line 257 of file class.ilExPeerReviewGUI.php.

References time.

Referenced by downloadPeerReviewObject(), editPeerReviewItemObject(), editPeerReviewObject(), executeCommand(), updateCritAjaxObject(), and updatePeerReviewObject().

    {
        return ($this->submission->isOwner() &&
            $this->ass->afterDeadlineStrict() &&
            (!$this->ass->getPeerReviewDeadline() ||
                $this->ass->getPeerReviewDeadline() > time()));
    }

Here is the caller graph for this function:

canView()

ilExPeerReviewGUI::canView ( )

protected

Definition at line 265 of file class.ilExPeerReviewGUI.php.

References time.

Referenced by downloadPeerReviewObject(), showGivenPeerReviewObject(), and showReceivedPeerReviewObject().

    {
        return ($this->submission->isTutor() ||
            ($this->submission->isOwner() &&
            $this->ass->afterDeadlineStrict() &&
            (!$this->ass->getPeerReviewDeadline() ||
                $this->ass->getPeerReviewDeadline() < time())));
    }

Here is the caller graph for this function:

confirmResetPeerReviewObject()

ilExPeerReviewGUI::confirmResetPeerReviewObject

(

)

Definition at line 788 of file class.ilExPeerReviewGUI.php.

References $ctrl, $ilCtrl, $tabs_gui, $tpl, and returnToParentObject().

    {
        $ilCtrl = $this->ctrl;
        $tpl = $this->tpl;
        $ilTabs = $this->tabs_gui;
        
        if (!$this->ass ||
            !$this->ass->getPeerReview()) {
            $this->returnToParentObject();
        }
        
        $ilTabs->clearTargets();
        
        include_once("./Services/Utilities/classes/class.ilConfirmationGUI.php");
        $cgui = new ilConfirmationGUI();
        $cgui->setFormAction($ilCtrl->getFormAction($this));
        $cgui->setHeaderText(sprintf($this->lng->txt("exc_peer_review_reset_sure"), $this->ass->getTitle()));
        $cgui->setCancel($this->lng->txt("cancel"), "showPeerReviewOverview");
        $cgui->setConfirm($this->lng->txt("delete"), "resetPeerReview");

        $tpl->setContent($cgui->getHTML());
    }

Here is the call graph for this function:

downloadPeerReviewObject()

ilExPeerReviewGUI::downloadPeerReviewObject

(

)

Definition at line 710 of file class.ilExPeerReviewGUI.php.

References $_GET, $ctrl, $file, $ilCtrl, canGive(), canView(), ilUtil\deliverFile(), ilExcCriteria\getInstanceById(), ilExcCriteria\getInstanceByType(), and returnToParentObject().

    {
        $ilCtrl = $this->ctrl;
        
        if (!$this->canView() &&
            !$this->canGive()) {
            $this->returnToParentObject();
        }
        
        $parts = explode("__", $_GET["fu"]);
        $giver_id = $parts[0];
        $peer_id = $parts[1];
        $crit_id = $parts[2];
        
        include_once "Modules/Exercise/classes/class.ilExcCriteria.php";
        if (!is_numeric($crit_id)) {
            $crit = ilExcCriteria::getInstanceByType($crit_id);
        } else {
            $crit = ilExcCriteria::getInstanceById($crit_id);
        }
        
        $crit->setPeerReviewContext($this->ass, $giver_id, $peer_id);
        $file = $crit->getFileByHash();
        if ($file) {
            ilUtil::deliverFile($file, basename($file));
        }
        
        $ilCtrl->redirect($this, "returnToParent");
    }

Here is the call graph for this function:

editPeerReviewItemObject()

ilExPeerReviewGUI::editPeerReviewItemObject

(

ilPropertyFormGUI

$a_form = null

)

Definition at line 487 of file class.ilExPeerReviewGUI.php.

References $_GET, $tpl, canGive(), initPeerReviewItemForm(), isValidPeer(), and returnToParentObject().

Referenced by updatePeerReviewObject().

    {
        $tpl = $this->tpl;
        
        if (!$this->canGive() ||
            !$this->isValidPeer($_GET["peer_id"])) {
            $this->returnToParentObject();
        }
        
        if (!$a_form) {
            $a_form = $this->initPeerReviewItemForm($_GET["peer_id"]);
        }
        
        $tpl->setContent($a_form->getHTML());
    }

Here is the call graph for this function:

Here is the caller graph for this function:

editPeerReviewObject()

ilExPeerReviewGUI::editPeerReviewObject

(

)

Definition at line 447 of file class.ilExPeerReviewGUI.php.

References $tbl, $tpl, canGive(), ilDatePresentation\formatDate(), IL_CAL_UNIX, returnToParentObject(), ilUtil\sendFailure(), ilUtil\sendInfo(), and time.

    {
        $tpl = $this->tpl;
        
        if (!$this->canGive()) {
            $this->returnToParentObject();
        }
        
        $peer_items = $this->submission->getPeerReview()->getPeerReviewsByGiver($this->submission->getUserId());
        if (!sizeof($peer_items)) {
            ilUtil::sendFailure($this->lng->txt("exc_peer_review_no_peers"), true);
            $this->returnToParentObject();
        }
                        
        $missing = $this->submission->getPeerReview()->getNumberOfMissingFeedbacksForReceived();
        if ($missing) {
            $dl = $this->ass->getPeerReviewDeadline();
            if (!$dl || $dl < time()) {
                ilUtil::sendInfo(sprintf($this->lng->txt("exc_peer_review_missing_info"), $missing));
            } else {
                ilUtil::sendInfo(sprintf(
                    $this->lng->txt("exc_peer_review_missing_info_deadline"),
                    $missing,
                    ilDatePresentation::formatDate(new ilDateTime($dl, IL_CAL_UNIX))
                ));
            }
        }
        
        include_once "Modules/Exercise/classes/class.ilExAssignmentPeerReviewTableGUI.php";
        $tbl = new ilExAssignmentPeerReviewTableGUI(
            $this,
            "editPeerReview",
            $this->ass,
            $this->submission->getUserId(),
            $peer_items,
            "returnToParent"
        );
        $tpl->setContent($tbl->getHTML());
    }

Here is the call graph for this function:

executeCommand()

ilExPeerReviewGUI::executeCommand

(

)

Definition at line 70 of file class.ilExPeerReviewGUI.php.

References $_GET, $ctrl, $ilCtrl, $ilUser, $lng, $ret, $tabs_gui, $user, $valid, array, canGive(), ilFSStorageExercise\create(), returnToParentObject(), and ilFileSystemGUI\setTableId().

    {
        $ilCtrl = $this->ctrl;
        $lng = $this->lng;
        $ilTabs = $this->tabs_gui;
        $ilUser = $this->user;
        
        if (!$this->ass->getPeerReview()) {
            $this->returnToParentObject();
        }
        
        $class = $ilCtrl->getNextClass($this);
        $cmd = $ilCtrl->getCmd("showpeerreviewoverview");
        
        switch ($class) {
            case "ilfilesystemgui":
                $ilCtrl->saveParameter($this, array("fu"));

                // see self::downloadPeerReview()
                $parts = explode("__", $_GET["fu"]);
                $giver_id = $parts[0];
                $peer_id = $parts[1];

                if (!$this->canGive()) {
                    $this->returnToParentObject();
                }

                $valid = false;
                $peer_items = $this->submission->getPeerReview()->getPeerReviewsByPeerId($peer_id, true);
                if (sizeof($peer_items)) {
                    foreach ($peer_items as $item) {
                        if ($item["giver_id"] == $giver_id) {
                            $valid = true;
                        }
                    }
                }
                if (!$valid) {
                    $ilCtrl->redirect($this, "editPeerReview");
                }

                $ilTabs->clearTargets();
                $ilTabs->setBackTarget(
                    $lng->txt("back"),
                    $ilCtrl->getLinkTarget($this, "editPeerReview")
                );

                include_once("./Modules/Exercise/classes/class.ilFSStorageExercise.php");
                $fstorage = new ilFSStorageExercise($this->ass->getExerciseId(), $this->ass->getId());
                $fstorage->create();

                include_once("./Services/FileSystem/classes/class.ilFileSystemGUI.php");
                $fs_gui = new ilFileSystemGUI($fstorage->getPeerReviewUploadPath($peer_id, $giver_id));
                $fs_gui->setTableId("excfbpeer");
                $fs_gui->setAllowDirectories(false);
                $fs_gui->setTitle($this->ass->getTitle() . ": " .
                    $lng->txt("exc_peer_review") . " - " .
                    $lng->txt("exc_peer_review_give"));
                $ret = $this->ctrl->forwardCommand($fs_gui);
                break;
                                
            case "ilratinggui":
                $this->ass->updatePeerReviewTimestamp((int) $_REQUEST["peer_id"]);
                
                include_once("./Services/Rating/classes/class.ilRatingGUI.php");
                $rating_gui = new ilRatingGUI();
                $rating_gui->setObject(
                    $this->ass->getId(),
                    "ass",
                    (int) $_REQUEST["peer_id"],
                    "peer"
                );
                $this->ctrl->forwardCommand($rating_gui);
                $ilCtrl->redirect($this, "editPeerReview");
                break;
            
            case "ilexsubmissiontextgui":
                if (!$this->submission->isTutor()) {
                    $ilTabs->clearTargets();
                    $ilTabs->setBackTarget(
                        $lng->txt("back"),
                        $ilCtrl->getLinkTarget($this, "editPeerReview")
                    );
                    $this->ctrl->setReturn($this, "editPeerReview");
                } else {
                    $ilTabs->clearTargets();
                    $ilTabs->setBackTarget(
                        $lng->txt("back"),
                        $ilCtrl->getLinkTarget($this, "showGivenPeerReview")
                    );
                    $this->ctrl->setReturn($this, "showGivenPeerReview");
                }
                include_once "Modules/Exercise/classes/class.ilExSubmissionTextGUI.php";
                $gui = new ilExSubmissionTextGUI(new ilObjExercise($this->ass->getExerciseId(), false), $this->submission);
                $ilCtrl->forwardCommand($gui);
                break;
                        
            default:
                $this->{$cmd . "Object"}();
                break;
        }
    }

Here is the call graph for this function:

getLateSubmissionInfo()

ilExPeerReviewGUI::getLateSubmissionInfo ( ilExSubmission  $a_submission )

protected

Definition at line 435 of file class.ilExPeerReviewGUI.php.

References $file, $lng, and ilExSubmission\getFiles().

Referenced by initPeerReviewItemForm(), and renderInfoWidget().

    {
        $lng = $this->lng;
        
        // #18966 - late files info
        foreach ($a_submission->getFiles() as $file) {
            if ($file["late"]) {
                return '<div class="warning">' . $lng->txt("exc_late_submission") . '</div>';
            }
        }
    }

Here is the call graph for this function:

Here is the caller graph for this function:

getOverviewContent()

static ilExPeerReviewGUI::getOverviewContent ( ilInfoScreenGUI  $a_info, ilExSubmission  $a_submission  )

static

Definition at line 177 of file class.ilExPeerReviewGUI.php.

References $ass, $DIC, $ilCtrl, $lng, ilInfoScreenGUI\addProperty(), array, ilDatePresentation\formatDate(), ilExSubmission\getAssignment(), ilLinkButton\getInstance(), ilExSubmission\getPeerReview(), ilExSubmission\getUserId(), IL_CAL_UNIX, and time.

Referenced by ilExAssignmentGUI\addSubmission().

    {
        global $DIC;

        $lng = $DIC->language();
        $ilCtrl = $DIC->ctrl();
        
        $ass = $a_submission->getAssignment();
        
        if ($ass->afterDeadlineStrict() &&
            $ass->getPeerReview()) {
            $ilCtrl->setParameterByClass("ilExPeerReviewGUI", "ass_id", $a_submission->getAssignment()->getId());
            
            $nr_missing_fb = $a_submission->getPeerReview()->getNumberOfMissingFeedbacksForReceived($ass->getId(), $ass->getPeerReviewMin());
            
            // before deadline (if any)
            if (!$ass->getPeerReviewDeadline() ||
                $ass->getPeerReviewDeadline() > time()) {
                $dl_info = "";
                if ($ass->getPeerReviewDeadline()) {
                    $dl_info = " (" . sprintf(
                        $lng->txt("exc_peer_review_deadline_info_button"),
                        ilDatePresentation::formatDate(new ilDateTime($ass->getPeerReviewDeadline(), IL_CAL_UNIX))
                    ) . ")";
                }

                $button = ilLinkButton::getInstance();
                $button->setPrimary($nr_missing_fb);
                $button->setCaption($lng->txt("exc_peer_review_give") . $dl_info, false);
                $button->setUrl($ilCtrl->getLinkTargetByClass(array("ilExSubmissionGUI", "ilExPeerReviewGUI"), "editPeerReview"));
                $edit_pc = $button->render();
            } elseif ($ass->getPeerReviewDeadline()) {
                $edit_pc = $lng->txt("exc_peer_review_deadline_reached");
            }
            
            // after deadline (if any)
            if ((!$ass->getPeerReviewDeadline() ||
                $ass->getPeerReviewDeadline() < time())) {
                // given peer review should be accessible at all times (read-only when not editable - see above)
                if ($ass->getPeerReviewDeadline() &&
                    $a_submission->getPeerReview()->countGivenFeedback(false)) {
                    $button = ilLinkButton::getInstance();
                    $button->setCaption("exc_peer_review_given");
                    $button->setUrl($ilCtrl->getLinkTargetByClass(array("ilExSubmissionGUI", "ilExPeerReviewGUI"), "showGivenPeerReview"));
                    $view_pc = $button->render() . " ";
                }
                
                // did give enough feedback
                if (!$nr_missing_fb) {
                    // received any?
                    $received = (bool) sizeof($a_submission->getPeerReview()->getPeerReviewsByPeerId($a_submission->getUserId(), true));
                    if ($received) {
                        $button = ilLinkButton::getInstance();
                        $button->setCaption("exc_peer_review_show");
                        $button->setUrl($ilCtrl->getLinkTargetByClass(array("ilExSubmissionGUI", "ilExPeerReviewGUI"), "showReceivedPeerReview"));
                        $view_pc .= $button->render();
                    }
                    // received none
                    else {
                        $view_pc .= $lng->txt("exc_peer_review_show_received_none");
                    }
                }
                // did not give enough
                else {
                    $view_pc .= $lng->txt("exc_peer_review_show_missing");
                }
            }
            /* must give before showing received
            else
            {
                $view_pc = $lng->txt("exc_peer_review_show_not_rated_yet");
            }
            */

            $a_info->addProperty($lng->txt("exc_peer_review"), $edit_pc . " " . $view_pc);
            
            $ilCtrl->setParameterByClass("ilExPeerReviewGUI", "ass_id", "");
        }
    }

Here is the call graph for this function:

Here is the caller graph for this function:

getSubmissionContent()

ilExPeerReviewGUI::getSubmissionContent ( ilExSubmission  $a_submission )

protected

Definition at line 514 of file class.ilExPeerReviewGUI.php.

References $text, ilRTE\_replaceMediaObjectImageSrc(), ilExSubmission\getFiles(), and ilExAssignment\TYPE_TEXT.

Referenced by initPeerReviewItemForm(), and renderInfoWidget().

    {
        if ($this->ass->getType() != ilExAssignment::TYPE_TEXT) {
            return;
        }
        
        $text = $a_submission->getFiles();
        if ($text) {
            $text = array_shift($text);
            if (trim($text["atext"])) {
                // mob id to mob src
                include_once "Services/RTE/classes/class.ilRTE.php";
                return nl2br(ilRTE::_replaceMediaObjectImageSrc($text["atext"], 1));
            }
        }
    }

Here is the call graph for this function:

Here is the caller graph for this function:

handlePeerReviewChange()

ilExPeerReviewGUI::handlePeerReviewChange ( )

protected

Definition at line 698 of file class.ilExPeerReviewGUI.php.

References ilObjExercise\processExerciseStatus().

Referenced by updateCritAjaxObject(), and updatePeerReviewObject().

    {
        // (in)valid peer reviews could change assignment status
        $exercise = new ilObjExercise($this->ass->getExerciseId(), false);
        $exercise->processExerciseStatus(
            $this->ass,
            $this->submission->getUserIds(),
            $this->submission->hasSubmitted(),
            $this->submission->validatePeerReviews()
        );
    }

Here is the call graph for this function:

Here is the caller graph for this function:

initPeerReviewItemForm()

ilExPeerReviewGUI::initPeerReviewItemForm (   $a_peer_id )

protected

Definition at line 531 of file class.ilExPeerReviewGUI.php.

References $ctrl, $form, $id, $ilCtrl, $lng, $submission, getLateSubmissionInfo(), ilUserUtil\getNamePresentation(), getSubmissionContent(), and ilNonEditableValueGUI\setValue().

Referenced by editPeerReviewItemObject(), and updatePeerReviewObject().

    {
        $ilCtrl = $this->ctrl;
        $lng = $this->lng;
        
        // get peer data
        $peer_items = $this->submission->getPeerReview()->getPeerReviewsByGiver($this->submission->getUserId());
        foreach ($peer_items as $item) {
            if ($item["peer_id"] == $a_peer_id) {
                $peer = $item;
                break;
            }
        }
        
        $ilCtrl->saveParameter($this, "peer_id");
        
        include_once "Services/Form/classes/class.ilPropertyFormGUI.php";
        $form = new ilPropertyFormGUI();
        $form->setFormAction($ilCtrl->getFormAction($this, "updatePeerReview"));
        
        $form->setTitle($this->ass->getTitle() . ": " . $lng->txt("exc_peer_review_give"));
                        
        // peer info
        if (!$this->ass->hasPeerReviewPersonalized()) {
            $id_title = $lng->txt("id");
            $id_value = $peer["seq"];
        } else {
            include_once "Services/User/classes/class.ilUserUtil.php";
            $id_title = $lng->txt("exc_peer_review_recipient");
            $id_value = ilUserUtil::getNamePresentation($peer["peer_id"]);
        }
        $id = new ilNonEditableValueGUI($id_title);
        $id->setValue($id_value);
        $form->addItem($id);
        
        // submission info
        
        $submission = new ilExSubmission($this->ass, $peer["peer_id"]);
        $file_info = $submission->getDownloadedFilesInfoForTableGUIS($this, "editPeerReviewItem");
        
        $last_sub = new ilNonEditableValueGUI($file_info["last_submission"]["txt"], "", true);
        $last_sub->setValue($file_info["last_submission"]["value"] .
            $this->getLateSubmissionInfo($submission));
        $form->addItem($last_sub);
            
        $sub_data = $this->getSubmissionContent($submission);
        if (!$sub_data) {
            $sub_data = '<a href="' . $file_info["files"]["download_url"] . '">' . $lng->txt("download") . '</a>';
        }
        
        $sub = new ilNonEditableValueGUI($lng->txt("exc_submission"), "", true);
        $sub->setValue($sub_data);
        $form->addItem($sub);
                
        // peer review items
        
        $input = new ilFormSectionHeaderGUI();
        $input->setTitle($lng->txt("exc_peer_review"));
        $form->addItem($input);
        
        $values = $this->submission->getPeerReview()->getPeerReviewValues($this->submission->getUserId(), $a_peer_id);
        
        foreach ($this->ass->getPeerReviewCriteriaCatalogueItems() as $item) {
            $crit_id = $item->getId()
                ? $item->getId()
                : $item->getType();
            
            $item->setPeerReviewContext(
                $this->ass,
                $this->submission->getUserId(),
                $peer["peer_id"],
                $form
            );
            $item->addToPeerReviewForm($values[$crit_id]);
        }
        
        $form->addCommandButton("updatePeerReview", $lng->txt("save"));
        $form->addCommandButton("editPeerReview", $lng->txt("cancel"));
        
        return $form;
    }

Here is the call graph for this function:

Here is the caller graph for this function:

isValidPeer()

ilExPeerReviewGUI::isValidPeer (   $a_peer_id )

protected

Definition at line 503 of file class.ilExPeerReviewGUI.php.

Referenced by editPeerReviewItemObject(), and updatePeerReviewObject().

    {
        $peer_items = $this->submission->getPeerReview()->getPeerReviewsByGiver($this->submission->getUserId());
        foreach ($peer_items as $item) {
            if ($item["peer_id"] == $a_peer_id) {
                return true;
            }
        }
        return false;
    }

Here is the caller graph for this function:

renderInfoWidget()

ilExPeerReviewGUI::renderInfoWidget ( ilInfoScreenGUI  $a_info_widget, array  $a_peer_items,   $a_by_peer = false  )

protected

Definition at line 331 of file class.ilExPeerReviewGUI.php.

References $html, $lng, $submission, $title, ilInfoScreenGUI\addProperty(), ilInfoScreenGUI\addSection(), getLateSubmissionInfo(), ilUserUtil\getNamePresentation(), and getSubmissionContent().

Referenced by showGivenPeerReviewObject(), and showReceivedPeerReviewObject().

    {
        $lng = $this->lng;
        
        include_once "Services/User/classes/class.ilUserUtil.php";
            
        if ($this->submission->isTutor()) {
            $user_title = $a_by_peer
                ? $lng->txt("exc_peer_review_recipient")
                : $lng->txt("exc_peer_review_giver");
            $a_info_widget->addSection($user_title);
            $a_info_widget->addProperty(
                $lng->txt("name"),
                ilUserUtil::getNamePresentation($this->submission->getUserId(), false, false, "", true)
            );
        }
        
        if ($a_by_peer) {
            // submission

            $a_info_widget->addSection($lng->txt("exc_submission"));

            $submission = new ilExSubmission($this->ass, $this->submission->getUserId());
            $file_info = $submission->getDownloadedFilesInfoForTableGUIS($this, "showReceivedPeerReview");
            
            $a_info_widget->addProperty(
                $file_info["last_submission"]["txt"],
                $file_info["last_submission"]["value"] .
                $this->getLateSubmissionInfo($submission)
            );

            $sub_data = $this->getSubmissionContent($submission);
            if (!$sub_data) {
                $sub_data = '<a href="' . $file_info["files"]["download_url"] . '">' . $lng->txt("download") . '</a>';
            }
            $a_info_widget->addProperty($lng->txt("exc_submission"), $sub_data);
        }
        
        foreach ($a_peer_items as $peer) {
            if (!$a_by_peer) {
                $giver_id = $this->submission->getUserId();
                $peer_id = $peer["peer_id"];
                $id_title = $lng->txt("exc_peer_review_recipient");
                $user_id = $peer_id;
            } else {
                $giver_id = $peer["giver_id"];
                $peer_id = $this->submission->getUserId();
                $id_title = $lng->txt("exc_peer_review_giver");
                $user_id = $giver_id;
            }
            
            // peer info
            if ($this->submission->isTutor()) {
                $id_value = ilUserUtil::getNamePresentation($user_id, "", "", false, true);
            } elseif (!$this->ass->hasPeerReviewPersonalized()) {
                $id_value = $peer["seq"];
            } else {
                $id_value = ilUserUtil::getNamePresentation($user_id);
            }
            $a_info_widget->addSection($id_title . ": " . $id_value);

            
            // submission info

            if (!$a_by_peer) {
                $submission = new ilExSubmission($this->ass, $peer_id);
                $file_info = $submission->getDownloadedFilesInfoForTableGUIS($this, "editPeerReviewItem");

                $a_info_widget->addProperty(
                    $file_info["last_submission"]["txt"],
                    $file_info["last_submission"]["value"] .
                    $this->getLateSubmissionInfo($submission)
                );

                $sub_data = $this->getSubmissionContent($submission);
                if (!$sub_data) {
                    $sub_data = '<a href="' . $file_info["files"]["download_url"] . '">' . $lng->txt("download") . '</a>';
                }
                $a_info_widget->addProperty($lng->txt("exc_submission"), $sub_data);
            }
            
            
            // peer review items
            
            $values = $this->submission->getPeerReview()->getPeerReviewValues($giver_id, $peer_id);

            foreach ($this->ass->getPeerReviewCriteriaCatalogueItems() as $item) {
                $crit_id = $item->getId()
                    ? $item->getId()
                    : $item->getType();

                $item->setPeerReviewContext(
                    $this->ass,
                    $giver_id,
                    $peer_id
                );
                
                $title = $item->getTitle();
                $html = $item->getHTML($values[$crit_id]);
                $a_info_widget->addProperty($title ? $title : "&nbsp;", $html ? $html : "&nbsp;");
            }
        }
    }

Here is the call graph for this function:

Here is the caller graph for this function:

resetPeerReviewObject()

ilExPeerReviewGUI::resetPeerReviewObject

(

)

Definition at line 811 of file class.ilExPeerReviewGUI.php.

References $ass, $ctrl, $ilCtrl, $submission, ilExAssignment\PEER_REVIEW_VALID_NONE, returnToParentObject(), and ilUtil\sendSuccess().

    {
        $ilCtrl = $this->ctrl;
        
        if (!$this->ass ||
            !$this->ass->getPeerReview()) {
            $this->returnToParentObject();
        }
        
        include_once "Modules/Exercise/classes/class.ilExPeerReview.php";
        $peer_review = new ilExPeerReview($this->ass);
        $all_giver_ids = $peer_review->resetPeerReviews();
        
        if (is_array($all_giver_ids)) {
            // if peer review is valid for completion, we have to re-calculate all assignment members
            $exercise = new ilObjExercise($this->ass->getExerciseId(), false);
            if ($exercise->isCompletionBySubmissionEnabled() &&
                $this->ass->getPeerReviewValid() != ilExAssignment::PEER_REVIEW_VALID_NONE) {
                include_once "Modules/Exercise/classes/class.ilExSubmission.php";
                foreach ($all_giver_ids as $user_id) {
                    $submission = new ilExSubmission($this->ass, $user_id);
                    $pgui = new self($this->ass, $submission);
                    $pgui->handlePeerReviewChange();
                }
            }
        }

        ilUtil::sendSuccess($this->lng->txt("exc_peer_review_reset_done"), true);
        $ilCtrl->redirect($this, "showPeerReviewOverview");
    }

Here is the call graph for this function:

returnToParentObject()

ilExPeerReviewGUI::returnToParentObject

(

)

Definition at line 172 of file class.ilExPeerReviewGUI.php.

Referenced by confirmResetPeerReviewObject(), downloadPeerReviewObject(), editPeerReviewItemObject(), editPeerReviewObject(), executeCommand(), resetPeerReviewObject(), showGivenPeerReviewObject(), showPeerReviewOverviewObject(), showReceivedPeerReviewObject(), and updatePeerReviewObject().

    {
        $this->ctrl->returnToParent($this);
    }

Here is the caller graph for this function:

showGivenPeerReviewObject()

ilExPeerReviewGUI::showGivenPeerReviewObject

(

)

Definition at line 274 of file class.ilExPeerReviewGUI.php.

References $lng, $tpl, canView(), renderInfoWidget(), returnToParentObject(), and ilUtil\sendFailure().

    {
        $tpl = $this->tpl;
        $lng = $this->lng;
        
        if (!$this->canView()) {
            $this->returnToParentObject();
        }
        
        $peer_items = $this->submission->getPeerReview()->getPeerReviewsByGiver($this->submission->getUserId());
        if (!sizeof($peer_items)) {
            ilUtil::sendFailure($this->lng->txt("exc_peer_review_no_peers"), true);
            $this->returnToParentObject();
        }
                
        $tpl->setTitle($this->ass->getTitle() . ": " . $lng->txt("exc_peer_review_given"));
        
        include_once "Services/InfoScreen/classes/class.ilInfoScreenGUI.php";
        $info_widget = new ilInfoScreenGUI($this);
        
        $this->renderInfoWidget($info_widget, $peer_items);
        
        $tpl->setContent($info_widget->getHTML());
    }

Here is the call graph for this function:

showPeerReviewOverviewObject()

ilExPeerReviewGUI::showPeerReviewOverviewObject

(

)

Definition at line 746 of file class.ilExPeerReviewGUI.php.

References $tbl, $tpl, $user, ilPanelGUI\getInstance(), and returnToParentObject().

    {
        $tpl = $this->tpl;
        
        if (!$this->ass ||
            !$this->ass->getPeerReview()) {
            $this->returnToParentObject();
        }
    
        include_once "Modules/Exercise/classes/class.ilExAssignmentPeerReviewOverviewTableGUI.php";
        $tbl = new ilExAssignmentPeerReviewOverviewTableGUI(
            $this,
            "showPeerReviewOverview",
            $this->ass
        );
        
        $panel = "";
        $panel_data = $tbl->getPanelInfo();
        if (sizeof($panel_data)) {
            $ptpl = new ilTemplate("tpl.exc_peer_review_overview_panel.html", true, true, "Modules/Exercise");
            foreach ($panel_data as $item) {
                $ptpl->setCurrentBlock("user_bl");
                foreach ($item["value"] as $user) {
                    $ptpl->setVariable("USER", $user);
                    $ptpl->parseCurrentBlock();
                }
                
                $ptpl->setCurrentBlock("item_bl");
                $ptpl->setVariable("TITLE", $item["title"]);
                $ptpl->parseCurrentBlock();
            }
        
            include_once "Services/UIComponent/Panel/classes/class.ilPanelGUI.php";
            $panel = ilPanelGUI::getInstance();
            $panel->setHeading($this->lng->txt("exc_peer_review_overview_invalid_users"));
            $panel->setBody($ptpl->get());
            $panel = $panel->getHTML();
        }
        
        $tpl->setContent($tbl->getHTML() . $panel);
    }

Here is the call graph for this function:

showReceivedPeerReviewObject()

ilExPeerReviewGUI::showReceivedPeerReviewObject

(

)

Definition at line 299 of file class.ilExPeerReviewGUI.php.

References $ctrl, $ilCtrl, $lng, $tpl, canView(), renderInfoWidget(), returnToParentObject(), and ilUtil\sendFailure().

    {
        $ilCtrl = $this->ctrl;
        $tpl = $this->tpl;
        $lng = $this->lng;
        
        if (!$this->canView() ||
            (!$this->submission->isTutor() &&
            $this->submission->getPeerReview()->getNumberOfMissingFeedbacksForReceived())) {
            $this->returnToParentObject();
        }
    
        $this->tabs_gui->clearTargets();
        $this->tabs_gui->setBackTarget($this->lng->txt("back"), $this->ctrl->getLinkTarget($this, "returnToParent"));
        
        $peer_items = $this->submission->getPeerReview()->getPeerReviewsByPeerId($this->submission->getUserId(), !$this->submission->isTutor());
        if (!sizeof($peer_items)) {
            // #11373
            ilUtil::sendFailure($this->lng->txt("exc_peer_review_no_peers_reviewed_yet"), true);
            $ilCtrl->redirect($this, "returnToParent");
        }
        
        $tpl->setTitle($this->ass->getTitle() . ": " . $lng->txt("exc_peer_review_show"));
        
        include_once "Services/InfoScreen/classes/class.ilInfoScreenGUI.php";
        $info_widget = new ilInfoScreenGUI($this);
            
        $this->renderInfoWidget($info_widget, $peer_items, true);
        
        $tpl->setContent($info_widget->getHTML());
    }

Here is the call graph for this function:

updateCritAjaxObject()

ilExPeerReviewGUI::updateCritAjaxObject

(

)

Definition at line 613 of file class.ilExPeerReviewGUI.php.

References $_POST, $ctrl, $html, $ilCtrl, $ilUser, $tpl, $user, canGive(), exit, ilExcCriteria\getInstanceById(), ilExcCriteria\getInstanceByType(), and handlePeerReviewChange().

    {
        $ilCtrl = $this->ctrl;
        $ilUser = $this->user;
        $tpl = $this->tpl;
        
        if (!$this->canGive() ||
            !$_POST["peer_id"] ||
            !$_POST["crit_id"] ||
            !$ilCtrl->isAsynch()) {
            exit();
        }
        
        $peer_id = (int) $_POST["peer_id"];
        $crit_id = $_POST["crit_id"];
        $giver_id = $ilUser->getId();
        
        include_once "Modules/Exercise/classes/class.ilExcCriteria.php";
        if (!is_numeric($crit_id)) {
            $crit = ilExcCriteria::getInstanceByType($crit_id);
        } else {
            $crit = ilExcCriteria::getInstanceById($crit_id);
        }
        $crit->setPeerReviewContext($this->ass, $giver_id, $peer_id);
        $html = $crit->updateFromAjax();
                        
        $this->handlePeerReviewChange();
        
        echo $html;
        echo $tpl->getOnLoadCodeForAsynch();
        exit();
    }

Here is the call graph for this function:

updatePeerReviewObject()

ilExPeerReviewGUI::updatePeerReviewObject

(

)

Definition at line 646 of file class.ilExPeerReviewGUI.php.

References $ctrl, $form, $ilCtrl, $lng, $valid, array, canGive(), editPeerReviewItemObject(), handlePeerReviewChange(), initPeerReviewItemForm(), isValidPeer(), returnToParentObject(), ilUtil\sendFailure(), and ilUtil\sendSuccess().

    {
        $lng = $this->lng;
        $ilCtrl = $this->ctrl;
        
        if (!$this->canGive() ||
            !$this->isValidPeer($_REQUEST["peer_id"])) {
            $this->returnToParentObject();
        }
                        
        $peer_id = $_REQUEST["peer_id"];
        
        $form = $this->initPeerReviewItemForm($peer_id);
        if ($form->checkInput()) {
            $valid = true;
            
            $values = array();
            foreach ($this->ass->getPeerReviewCriteriaCatalogueItems() as $item) {
                $item->setPeerReviewContext(
                    $this->ass,
                    $this->submission->getUserId(),
                    $peer_id,
                    $form
                );
                $value = $item->importFromPeerReviewForm();
                if ($value !== null) {
                    $crit_id = $item->getId()
                        ? $item->getId()
                        : $item->getType();
                    $values[$crit_id] = $value;
                }
                if (!$item->validate($value)) {
                    $valid = false;
                }
            }
            
            if ($valid) {
                $this->submission->getPeerReview()->updatePeerReview($peer_id, $values);

                $this->handlePeerReviewChange();

                ilUtil::sendSuccess($this->lng->txt("exc_peer_review_updated"), true);
                $ilCtrl->redirect($this, "editPeerReview");
            } else {
                ilUtil::sendFailure($lng->txt("form_input_not_valid"));
            }
        }
        
        $form->setValuesByPost();
        $this->editPeerReviewItemObject($form);
    }

Here is the call graph for this function:

Field Documentation

$ass

ilExPeerReviewGUI::$ass

protected

Definition at line 40 of file class.ilExPeerReviewGUI.php.

Referenced by getOverviewContent(), and resetPeerReviewObject().

$ctrl

ilExPeerReviewGUI::$ctrl

protected

Definition at line 18 of file class.ilExPeerReviewGUI.php.

Referenced by confirmResetPeerReviewObject(), downloadPeerReviewObject(), executeCommand(), initPeerReviewItemForm(), resetPeerReviewObject(), showReceivedPeerReviewObject(), updateCritAjaxObject(), and updatePeerReviewObject().

$lng

ilExPeerReviewGUI::$lng

protected

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

Referenced by __construct(), executeCommand(), getLateSubmissionInfo(), getOverviewContent(), initPeerReviewItemForm(), renderInfoWidget(), showGivenPeerReviewObject(), showReceivedPeerReviewObject(), and updatePeerReviewObject().

$submission

ilExPeerReviewGUI::$submission

protected

Definition at line 41 of file class.ilExPeerReviewGUI.php.

Referenced by initPeerReviewItemForm(), renderInfoWidget(), and resetPeerReviewObject().

$tabs_gui

ilExPeerReviewGUI::$tabs_gui

protected

Definition at line 23 of file class.ilExPeerReviewGUI.php.

Referenced by confirmResetPeerReviewObject(), and executeCommand().

$tpl

ilExPeerReviewGUI::$tpl

protected

Definition at line 33 of file class.ilExPeerReviewGUI.php.

Referenced by __construct(), confirmResetPeerReviewObject(), editPeerReviewItemObject(), editPeerReviewObject(), showGivenPeerReviewObject(), showPeerReviewOverviewObject(), showReceivedPeerReviewObject(), and updateCritAjaxObject().

$user

ilExPeerReviewGUI::$user

protected

Definition at line 38 of file class.ilExPeerReviewGUI.php.

Referenced by executeCommand(), showPeerReviewOverviewObject(), and updateCritAjaxObject().

---

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

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