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)
	isValidPeer ($a_peer_id)
	getSubmissionContent (ilExSubmission $a_submission)
	initPeerReviewItemForm ($a_peer_id)
	handlePeerReviewChange ()

Protected Attributes
	$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 25 of file class.ilExPeerReviewGUI.php.

References $ilCtrl, $lng, and $tpl.

        {
                global $ilCtrl, $ilTabs, $lng, $tpl;
                
                $this->ass = $a_ass;
                $this->submission = $a_submission;
                
                // :TODO:
                $this->ctrl = $ilCtrl;
                $this->tabs_gui = $ilTabs;
                $this->lng = $lng;
                $this->tpl = $tpl;      
        }

Member Function Documentation

canGive()

ilExPeerReviewGUI::canGive ( )

protected

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

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 237 of file class.ilExPeerReviewGUI.php.

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 778 of file class.ilExPeerReviewGUI.php.

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

        {
                global $ilCtrl, $tpl, $ilTabs;
                
                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 693 of file class.ilExPeerReviewGUI.php.

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

        {
                global $ilCtrl;
                
                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));
                        break(2);               
                }                               
                
                $ilCtrl->redirect($this, "returnToParent");             
        }

Here is the call graph for this function:

editPeerReviewItemObject()

ilExPeerReviewGUI::editPeerReviewItemObject

(

ilPropertyFormGUI

$a_form = null

)

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

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

Referenced by updatePeerReviewObject().

        {               
                global $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 413 of file class.ilExPeerReviewGUI.php.

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

        {
                global $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 39 of file class.ilExPeerReviewGUI.php.

References $_GET, $_REQUEST, $cmd, $ilCtrl, $ilUser, $lng, $ret, $valid, canGive(), ilFSStorageExercise\create(), returnToParentObject(), and ilFileSystemGUI\setTableId().

        {
                global $ilCtrl, $lng, $ilTabs, $ilUser;
                
                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:

getOverviewContent()

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

static

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

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

Referenced by ilExAssignmentGUI\addSubmission().

        {
                global $lng, $ilCtrl;
                
                $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();                                                                                                   
                        }
                        else if($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 481 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 682 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 501 of file class.ilExPeerReviewGUI.php.

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

Referenced by editPeerReviewItemObject(), and updatePeerReviewObject().

        {
                global $ilCtrl, $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"]);
                $last_sub->setValue($file_info["last_submission"]["value"]);
                $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 468 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 304 of file class.ilExPeerReviewGUI.php.

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

Referenced by showGivenPeerReviewObject(), and showReceivedPeerReviewObject().

        {               
                global $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"]);

                        $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);     
                        }
                        else if(!$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"]);

                                $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 800 of file class.ilExPeerReviewGUI.php.

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

        {
                global $ilCtrl;
                
                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 138 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 246 of file class.ilExPeerReviewGUI.php.

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

        {               
                global $tpl, $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 735 of file class.ilExPeerReviewGUI.php.

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

        {
                global $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 272 of file class.ilExPeerReviewGUI.php.

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

        {
                global $ilCtrl, $tpl, $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 588 of file class.ilExPeerReviewGUI.php.

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

        {
                global $ilCtrl, $ilUser, $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 623 of file class.ilExPeerReviewGUI.php.

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

        {
                global $lng, $ilCtrl;
                
                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 15 of file class.ilExPeerReviewGUI.php.

Referenced by getOverviewContent(), and resetPeerReviewObject().

$submission

ilExPeerReviewGUI::$submission

protected

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

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

---

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

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