Collaboration diagram for ilPortfolioExerciseGUI:

Public Member Functions
	__construct ($a_user_id, $a_obj_id)

	executeCommand ()

	downloadExcAssFile ()

	downloadExcSubFile ()

	getSubmitButton (int $ass_id)
	Get submit link. More...

	getDownloadSubmissionButton (int $ass_id)
	Get download button. More...

	getActionButtons ()
	Get action buttons. More...

Static Public Member Functions
static	checkExercise ($a_user_id, $a_obj_id, $a_add_submit=false, $as_array=false)

Protected Member Functions
	finalize ()
	Finalize and submit portfolio to exercise. More...

Static Protected Member Functions
static	getExerciseInfo ($a_user_id, $a_assignment_id, $a_add_submit=false, $as_array=false)

Protected Attributes
	$ctrl

	$lng

	$user_id

	$obj_id

	$ass_id

	$file

	$pe

	$ui

Detailed Description

Class ilPortfolioExerciseGUI.

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

@ilCtrl_Calls ilPortfolioExerciseGUI:

Definition at line 12 of file class.ilPortfolioExerciseGUI.php.

Constructor & Destructor Documentation

◆ __construct()

ilPortfolioExerciseGUI::__construct	(	$a_user_id,
		$a_obj_id
	)

Definition at line 39 of file class.ilPortfolioExerciseGUI.php.

    {
        global $DIC;
 
        $this->ctrl = $DIC->ctrl();
        $this->lng = $DIC->language();
        $this->user_id = $a_user_id;
        $this->obj_id = $a_obj_id;
        $this->ass_id = (int) $_GET["ass"];
        $this->file = trim($_GET["file"]);
        $this->ui = $DIC->ui();
    }

References $_GET, $DIC, and ui().

Here is the call graph for this function:

Member Function Documentation

◆ checkExercise()

static ilPortfolioExerciseGUI::checkExercise	(	$a_user_id,
		$a_obj_id,
		$a_add_submit = `false`,
		$as_array = `false`
	)

static

Definition at line 73 of file class.ilPortfolioExerciseGUI.php.

    {
        $pe = new ilPortfolioExercise($a_user_id, $a_obj_id);
 
        $info = [];
        foreach ($pe->getAssignmentsOfPortfolio() as $exercise) {
            $part = self::getExerciseInfo($a_user_id, $exercise["ass_id"], $a_add_submit, $as_array);
            if ($part) {
                $info[] = $part;
            }
        }
        if (sizeof($info) && !$as_array) {
            return implode("<br />", $info);
        }
 
        if ($as_array) {
            return $info;
        }
    }

References $exercise, $pe, and getExerciseInfo().

Referenced by ilPortfolioRepositoryGUI\getPortfolioList().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ downloadExcAssFile()

ilPortfolioExerciseGUI::downloadExcAssFile ( )

Definition at line 227 of file class.ilPortfolioExerciseGUI.php.

    {
        if ($this->file) {
            $ass = new ilExAssignment($this->ass_id);
            $ass_files = $ass->getFiles();
            if (count($ass_files) > 0) {
                foreach ($ass_files as $file) {
                    if ($file["name"] == $this->file) {
                        ilUtil::deliverFile($file["fullpath"], $file["name"]);
                    }
                }
            }
        }
    }

References $file, and ilUtil\deliverFile().

Here is the call graph for this function:

◆ downloadExcSubFile()

ilPortfolioExerciseGUI::downloadExcSubFile ( )

Definition at line 242 of file class.ilPortfolioExerciseGUI.php.

    {
        $ass = new ilExAssignment($this->ass_id);
        $submission = new ilExSubmission($ass, $this->user_id);
        $submitted = $submission->getFiles();
        if (count($submitted) > 0) {
            $submitted = array_pop($submitted);
 
            $user_data = ilObjUser::_lookupName($submitted["user_id"]);
            $title = ilObject::_lookupTitle($submitted["obj_id"]) . " - " .
                $ass->getTitle() . " - " .
                $user_data["firstname"] . " " .
                $user_data["lastname"] . " (" .
                $user_data["login"] . ").zip";
 
            ilUtil::deliverFile($submitted["filename"], $title);
        }
    }

References ilObjUser\_lookupName(), ilObject\_lookupTitle(), and ilUtil\deliverFile().

Here is the call graph for this function:

◆ executeCommand()

ilPortfolioExerciseGUI::executeCommand ( )

Definition at line 52 of file class.ilPortfolioExerciseGUI.php.

    {
        $ilCtrl = $this->ctrl;
        
        if (!$this->ass_id ||
            !$this->user_id) {
            $this->ctrl->returnToParent($this);
        }
        
        $next_class = $ilCtrl->getNextClass($this);
        $cmd = $ilCtrl->getCmd();
    
        switch ($next_class) {
            default:
                $this->$cmd();
                break;
        }
        
        return true;
    }

References $ctrl, and $ilCtrl.

◆ finalize()

ilPortfolioExerciseGUI::finalize ( )

protected

Finalize and submit portfolio to exercise.

Definition at line 264 of file class.ilPortfolioExerciseGUI.php.

    {
        $lng = $this->lng;
        $ilCtrl = $this->ctrl;
        
        $exc_gui = ilExSubmissionObjectGUI::initGUIForSubmit($this->ass_id);
        $exc_gui->submitPortfolio($this->obj_id);
        
        ilUtil::sendSuccess($lng->txt("prtf_finalized"), true);
        $ilCtrl->returnToParent($this);
    }

References $ctrl, $ilCtrl, $lng, and ilExSubmissionObjectGUI\initGUIForSubmit().

Here is the call graph for this function:

◆ getActionButtons()

ilPortfolioExerciseGUI::getActionButtons ( )

Get action buttons.

Returns: array

Definition at line 334 of file class.ilPortfolioExerciseGUI.php.

    {
        $pe = new ilPortfolioExercise($this->user_id, $this->obj_id);
 
        $buttons = [];
        foreach ($pe->getAssignmentsOfPortfolio() as $exercise) {
            $ass_id = $exercise["ass_id"];
            $buttons[$ass_id] = [];
            $submit_button = $this->getSubmitButton($ass_id);
            if ($submit_button != null) {
                $buttons[$ass_id][] = $submit_button;
            }
            $download_button = $this->getDownloadSubmissionButton($ass_id);
            if ($download_button != null) {
                $buttons[$ass_id][] = $download_button;
            }
        }
 
        return $buttons;
    }

References $ass_id, $exercise, $pe, getDownloadSubmissionButton(), and getSubmitButton().

Here is the call graph for this function:

◆ getDownloadSubmissionButton()

ilPortfolioExerciseGUI::getDownloadSubmissionButton ( int $ass_id )

Get download button.

Parameters

return

Definition at line 306 of file class.ilPortfolioExerciseGUI.php.

    {
        $ilCtrl = $this->ctrl;
        $lng = $this->lng;
        $ui = $this->ui;
 
        // submitted files
        $submission = new ilExSubmission(new ilExAssignment($ass_id), $this->user_id);
        if ($submission->hasSubmitted()) {
            // #16888
            $submitted = $submission->getSelectedObject();
            if ($submitted["ts"] != "") {
                $ilCtrl->setParameterByClass("ilportfolioexercisegui", "ass", $ass_id);
                $dl_link = $ilCtrl->getLinkTargetByClass("ilportfolioexercisegui", "downloadExcSubFile");
                $ilCtrl->setParameterByClass("ilportfolioexercisegui", "ass", "");
                $button = $ui->factory()->button()->standard($lng->txt("prtf_download_submission"), $dl_link);
                return $button;
            }
        }
        return null;
    }

References $ass_id, $ctrl, $ilCtrl, $lng, and $ui.

Referenced by getActionButtons().

Here is the caller graph for this function:

◆ getExerciseInfo()

static ilPortfolioExerciseGUI::getExerciseInfo	(	$a_user_id,
		$a_assignment_id,
		$a_add_submit = `false`,
		$as_array = `false`
	)

staticprotected

Deprecated:

Parameters

	$a_user_id
	$a_assignment_id
bool	$a_add_submit
bool	$as_array

Returns: string

Definition at line 101 of file class.ilPortfolioExerciseGUI.php.

    {
        global $DIC;
 
        $ui = $DIC->ui();
 
        $links = [];
        $buttons = [];
        $elements = [];
 
        $lng = $DIC->language();
        $ilCtrl = $DIC->ctrl();
        
        $ass = new ilExAssignment($a_assignment_id);
        $exercise_id = $ass->getExerciseId();
        if (!$exercise_id) {
            return;
        }
        
        // is the assignment still open?
        $times_up = $ass->afterDeadlineStrict();
        
        // exercise goto
        $exc_ref_id = array_shift(ilObject::_getAllReferences($exercise_id));
        $exc_link = ilLink::_getStaticLink($exc_ref_id, "exc");
 
        $info_arr["ass_title"] = $ass->getTitle();
        $text = sprintf(
            $lng->txt("prtf_exercise_info"),
            $ass->getTitle(),
            ilObject::_lookupTitle($exercise_id)
        );
        $links[] = $ui->factory()->link()->standard(ilObject::_lookupTitle($exercise_id), $exc_link);
        $info_arr["exc_title"] = ilObject::_lookupTitle($exercise_id);
        
        // submit button
        if ($a_add_submit && !$times_up && !$as_array) {
            $ilCtrl->setParameterByClass("ilportfolioexercisegui", "ass", $a_assignment_id);
            $submit_link = $ilCtrl->getLinkTargetByClass("ilportfolioexercisegui", "finalize");
            $ilCtrl->setParameterByClass("ilportfolioexercisegui", "ass", "");
            
            $buttons[] = $ui->factory()->button()->primary($lng->txt("prtf_finalize_portfolio"), $submit_link);
        }
        
        // submitted files
        $submission = new ilExSubmission($ass, $a_user_id);
        $info_arr["submitted"] = false;
        if ($submission->hasSubmitted()) {
            // #16888
            $submitted = $submission->getSelectedObject();
 
            if (!$as_array) {
                $ilCtrl->setParameterByClass("ilportfolioexercisegui", "ass", $a_assignment_id);
                $dl_link = $ilCtrl->getLinkTargetByClass("ilportfolioexercisegui", "downloadExcSubFile");
                $ilCtrl->setParameterByClass("ilportfolioexercisegui", "ass", "");
 
                $rel = ilDatePresentation::useRelativeDates();
                ilDatePresentation::setUseRelativeDates(false);
 
                $text .= "<p>" . sprintf(
                    $lng->txt("prtf_exercise_submitted_info"),
                    ilDatePresentation::formatDate(new ilDateTime($submitted["ts"], IL_CAL_DATETIME)),
                    ""
                ) . "</p>";
                $buttons[] = $ui->factory()->button()->standard($lng->txt("prtf_download_submission"), $dl_link);
            }
            
            ilDatePresentation::setUseRelativeDates($rel);
            $info_arr["submitted_date"] = ilDatePresentation::formatDate(new ilDateTime($submitted["ts"], IL_CAL_DATETIME));
            $info_arr["submitted"] = true;
            if ($submitted["ts"] == "") {
                $info_arr["submitted"] = false;
            }
        }
 
        // work instructions incl. files
        
        $tooltip = "";
 
        $inst = $ass->getInstruction();
        if ($inst) {
            $tooltip .= nl2br($inst);
        }
 
        $ass_files = $ass->getFiles();
        if (!$as_array) {
            if (count($ass_files) > 0) {
                if ($tooltip) {
                    $tooltip .= "<br /><br />";
                }
 
                $items = [];
 
                foreach ($ass_files as $file) {
                    $ilCtrl->setParameterByClass("ilportfolioexercisegui", "ass", $a_assignment_id);
                    $ilCtrl->setParameterByClass("ilportfolioexercisegui", "file", urlencode($file["name"]));
                    $dl_link = $ilCtrl->getLinkTargetByClass("ilportfolioexercisegui", "downloadExcAssFile");
                    $ilCtrl->setParameterByClass("ilportfolioexercisegui", "file", "");
                    $ilCtrl->setParameterByClass("ilportfolioexercisegui", "ass", "");
 
                    $items[] = $ui->renderer()->render($ui->factory()->button()->shy($file["name"], $dl_link));
                }
                $list = $ui->factory()->listing()->unordered($items);
                $tooltip .= $ui->renderer()->render($list);
            }
        }
        
        if ($tooltip) {
            $modal = $ui->factory()->modal()->roundtrip($lng->txt("exc_instruction"), $ui->factory()->legacy($tooltip))
                ->withCancelButtonLabel("close");
            $elements[] = $modal;
            $buttons[] = $ui->factory()->button()->standard($lng->txt("exc_instruction"), '#')
                ->withOnClick($modal->getShowSignal());
        }
 
        if ($as_array) {
            return $info_arr;
        }
 
        $elements[] = $ui->factory()->messageBox()->info($text)
            ->withLinks($links)
            ->withButtons($buttons);
 
        return $ui->renderer()->render($elements);
    }

References $DIC, $file, $ilCtrl, $lng, $ui, ilObject\_getAllReferences(), ilLink\_getStaticLink(), ilObject\_lookupTitle(), ilDatePresentation\formatDate(), IL_CAL_DATETIME, ilDatePresentation\setUseRelativeDates(), and ilDatePresentation\useRelativeDates().

Referenced by checkExercise().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getSubmitButton()

ilPortfolioExerciseGUI::getSubmitButton ( int $ass_id )

Get submit link.

Parameters

int $ass_id

Returns: object

Definition at line 282 of file class.ilPortfolioExerciseGUI.php.

    {
        $ilCtrl = $this->ctrl;
        $ui = $this->ui;
        $lng = $this->lng;
 
        $state = ilExcAssMemberState::getInstanceByIds($ass_id, $this->user_id);
 
        if ($state->isSubmissionAllowed()) {
            $ilCtrl->setParameterByClass("ilportfolioexercisegui", "ass", $ass_id);
            $submit_link = $ilCtrl->getLinkTargetByClass("ilportfolioexercisegui", "finalize");
            $ilCtrl->setParameterByClass("ilportfolioexercisegui", "ass", "");
            $button = $ui->factory()->button()->primary($lng->txt("prtf_finalize_portfolio"), $submit_link);
            return $button;
        }
        return null;
    }