This file is part of ILIAS, a powerful learning management system published by ILIAS open source e-Learning e.V. More...

Inheritance diagram for ilExSubmissionTextGUI:

Collaboration diagram for ilExSubmissionTextGUI:

Public Member Functions
	__construct (ilObjExercise $a_exercise, ilExSubmission $a_submission)

	executeCommand ()

	editAssignmentTextObject (ilPropertyFormGUI $a_form=null)

	updateAssignmentTextAndReturnObject ()

	updateAssignmentTextObject (bool $a_return=false)

	showAssignmentTextObject ()

Public Member Functions inherited from ilExSubmissionBaseGUI
	__construct (ilObjExercise $a_exercise, ilExSubmission $a_submission)

	returnToParentObject ()

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

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

Protected Member Functions
	initAssignmentTextForm (bool $a_read_only=false)

Protected Member Functions inherited from ilExSubmissionBaseGUI
	handleTabs ()

	handleNewUpload (bool $a_no_notifications=false)

	handleRemovedUpload ()

	triggerAssignmentTool ()

Protected Attributes
ilObjUser	$user

ilHelpGUI	$help

Protected Attributes inherited from ilExSubmissionBaseGUI
ILIAS Exercise Notification NotificationManager	$notification

ILIAS Exercise InternalDomainService	$domain

ILIAS Exercise InternalGUIService	$gui

ilCtrl	$ctrl

ilTabsGUI	$tabs_gui

ilLanguage	$lng

ilGlobalTemplateInterface	$tpl

ilObjExercise	$exercise

ilExSubmission	$submission

ilExAssignment	$assignment

MandatoryAssignmentsManager	$mandatory_manager

ContextServices	$tool_context

ilExAssignmentTypesGUI	$type_guis

int	$requested_ref_id

GUIRequest	$request

Detailed Description

This file is part of ILIAS, a powerful learning management system published by ILIAS open source e-Learning e.V.

ILIAS is licensed with the GPL-3.0, see https://www.gnu.org/licenses/gpl-3.0.en.html You should have received a copy of said license along with the source code, too.

If this is not the case or you just want to try ILIAS, you'll find us at: https://www.ilias.de https://github.com/ILIAS-eLearning Object-based submissions (ends up as static file)

Author: Jörg Lützenkirchen luetz.nosp@m.enki.nosp@m.rchen.nosp@m.@lei.nosp@m.fos.c.nosp@m.om; Alexander Killing killi.nosp@m.ng@l.nosp@m.eifos.nosp@m..de

ilExSubmissionTextGUI:

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

Constructor & Destructor Documentation

◆ __construct()

ilExSubmissionTextGUI::__construct	(	ilObjExercise	$a_exercise,
		ilExSubmission	$a_submission
	)

Definition at line 32 of file class.ilExSubmissionTextGUI.php.

References $DIC, ILIAS\MetaData\Repository\Validation\Data\__construct(), ILIAS\Repository\help(), and ILIAS\Repository\user().

       {
         global $DIC;
 
         parent::__construct($a_exercise, $a_submission);
         $this->user = $DIC->user();
         $this->help = $DIC["ilHelp"];
     }

Here is the call graph for this function:

Member Function Documentation

◆ editAssignmentTextObject()

ilExSubmissionTextGUI::editAssignmentTextObject ( ilPropertyFormGUI $a_form = null )

Definition at line 163 of file class.ilExSubmissionTextGUI.php.

References ilExSubmissionBaseGUI\$ctrl, $help, ilRTE\_replaceMediaObjectImageSrc(), ilExSubmissionBaseGUI\handleTabs(), initAssignmentTextForm(), ILIAS\Repository\lng(), ilCtrl\redirect(), ilHelpGUI\setScreenIdComponent(), and ilExSubmissionBaseGUI\triggerAssignmentTool().

Referenced by updateAssignmentTextObject().

      : void {
         $ilCtrl = $this->ctrl;
 
         if (!$this->submission->canSubmit()) {
             $this->tpl->setOnScreenMessage('failure', $this->lng->txt("exercise_time_over"), true);
             $ilCtrl->redirect($this, "returnToParent");
         }
 
         $this->triggerAssignmentTool();
 
         $this->handleTabs();
 
         $ilHelp = $this->help;
         $ilHelp->setScreenIdComponent("exc");
         $ilHelp->setScreenId("text_submission");
 
         if ($a_form === null) {
             $a_form = $this->initAssignmentTextForm();
 
             $files = $this->submission->getFiles();
             if ($files !== []) {
                 $files = array_shift($files);
                 if (trim($files["atext"]) !== '' && trim($files["atext"]) !== '0') {
                     $text = $a_form->getItemByPostVar("atxt");
                     // mob id to mob src
                     $text->setValue(ilRTE::_replaceMediaObjectImageSrc($files["atext"], 1));
                 }
             }
         }
 
         $this->tpl->setContent($a_form->getHTML());
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ executeCommand()

ilExSubmissionTextGUI::executeCommand ( )

Definition at line 43 of file class.ilExSubmissionTextGUI.php.

References ilExSubmissionBaseGUI\$ctrl, ilCtrl\getNextClass(), and ilExAssignment\TYPE_TEXT.

                                     : void
     {
         $ilCtrl = $this->ctrl;
 
         if (!$this->assignment ||
             $this->assignment->getType() != ilExAssignment::TYPE_TEXT ||
             !$this->submission->canView()) {
             return;
         }
 
         $class = $ilCtrl->getNextClass($this);
         $cmd = $ilCtrl->getCmd("showassignmenttext");
 
         switch ($class) {
             default:
                 $this->{$cmd . "Object"}();
                 break;
         }
     }

Here is the call graph for this function:

◆ getOverviewContent()

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

static

Definition at line 63 of file class.ilExSubmissionTextGUI.php.

References $DIC, ilExSubmissionBaseGUI\$gui, ilExSubmissionBaseGUI\$lng, ilInfoScreenGUI\addProperty(), ilExSubmission\canSubmit(), and ilLanguage\txt().

      : void {
         global $DIC;
 
         $lng = $DIC->language();
         $ilCtrl = $DIC->ctrl();
         $gui = $DIC->exercise()->internal()->gui();
 
         if ($a_submission->canSubmit()) {
             $link = $gui->link(
                 $lng->txt("exc_text_assignment_edit"),
                 $ilCtrl->getLinkTargetByClass(array(ilAssignmentPresentationGUI::class, "ilExSubmissionGUI", "ilExSubmissionTextGUI"), "editAssignmentText")
             )->primary();
         } else {
             $link = $gui->link(
                 $lng->txt("exc_text_assignment_show"),
                 $ilCtrl->getLinkTargetByClass(array(ilAssignmentPresentationGUI::class, "ilExSubmissionGUI", "ilExSubmissionTextGUI"), "showAssignmentText")
             )->emphasised();
         }
         $files_str = $link->render();
 
         $a_info->addProperty($lng->txt("exc_files_returned_text"), $files_str);
     }

Here is the call graph for this function:

◆ initAssignmentTextForm()

ilExSubmissionTextGUI::initAssignmentTextForm ( bool $a_read_only = false )

protected

Definition at line 94 of file class.ilExSubmissionTextGUI.php.

References ilExSubmissionBaseGUI\$ctrl, ilExSubmissionBaseGUI\$lng, ilObjAdvancedEditing\_getRichTextEditor(), ILIAS\Repository\lng(), ilFormPropertyGUI\setRequired(), ilLanguage\txt(), and ILIAS\Repository\user().

Referenced by editAssignmentTextObject(), showAssignmentTextObject(), and updateAssignmentTextObject().

      : ilPropertyFormGUI {
         $ilCtrl = $this->ctrl;
         $lng = $this->lng;
 
         $form = new ilPropertyFormGUI();
         $form->setTitle($this->lng->txt("exc_assignment") . " \"" . $this->assignment->getTitle() . "\"");
 
         if (!$a_read_only) {
             $text = new ilTextAreaInputGUI($this->lng->txt("exc_your_text"), "atxt");
             $text->setRequired(
                 $this->mandatory_manager->isMandatoryForUser($this->submission->getAssignment()->getId(), $this->user->getId())
             );
             $text->setRows(15);
             $text->setMaxNumOfChars($this->assignment->getMaxCharLimit());
             $text->setMinNumOfChars($this->assignment->getMinCharLimit());
 
             if ($text->isCharLimited()) {
                 $char_msg = "";
                 if ($this->assignment->getMinCharLimit() !== 0) {
                     $char_msg .= $lng->txt("exc_min_char_limit") . ": " . $this->assignment->getMinCharLimit();
                 }
                 if ($this->assignment->getMaxCharLimit() !== 0) {
                     $char_msg .= " " . $lng->txt("exc_max_char_limit") . ": " . $this->assignment->getMaxCharLimit();
                 }
                 $text->setInfo($char_msg);
             }
 
             $form->addItem($text);
 
             if (ilObjAdvancedEditing::_getRichTextEditor() === "tinymce") {
                 // custom rte tags
                 $text->setUseRte(true);
                 $text->setRTESupport($this->submission->getUserId(), "exca~", "exc_ass");
 
                 // see ilObjForumGUI
                 $text->disableButtons(array(
                     'charmap',
                     'undo',
                     'redo',
                     'alignleft',
                     'aligncenter',
                     'alignright',
                     'alignjustify',
                     'anchor',
                     'fullscreen',
                     'cut',
                     'copy',
                     'paste',
                     'pastetext',
                     'code',
                     // 'formatselect' #13234
                 ));
             }
 
             $form->setFormAction($ilCtrl->getFormAction($this, "updateAssignmentText"));
             $form->addCommandButton("updateAssignmentTextAndReturn", $this->lng->txt("save_return"));
             $form->addCommandButton("updateAssignmentText", $this->lng->txt("save"));
             $form->addCommandButton("returnToParent", $this->lng->txt("cancel"));
         } else {
             $form->setFormAction($ilCtrl->getFormAction($this, "returnToParent"));
             $text = new ilNonEditableValueGUI($this->lng->txt("exc_files_returned_text"), "atxt", true);
             $form->addItem($text);
         }
 
         return $form;
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ showAssignmentTextObject()

ilExSubmissionTextGUI::showAssignmentTextObject ( )

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

References ilRTE\_replaceMediaObjectImageSrc(), ilExSubmissionBaseGUI\handleTabs(), initAssignmentTextForm(), and ILIAS\Repository\lng().

                                               : void
     {
         if (!$this->submission->isTutor()) {
             $this->handleTabs();
         }
 
         $a_form = $this->initAssignmentTextForm(true);
 
         $files = $this->submission->getFiles();
         if ($files !== []) {
             $files = array_shift($files);
             if (trim($files["atext"]) !== '' && trim($files["atext"]) !== '0') {
                 if ($files["late"] &&
                     !$this->submission->hasPeerReviewAccess()) {
                     $this->tpl->setOnScreenMessage('failure', $this->lng->txt("exc_late_submission"));
                 }
 
                 $text = $a_form->getItemByPostVar("atxt");
                 // mob id to mob src
                 $text->setValue(nl2br(ilRTE::_replaceMediaObjectImageSrc($files["atext"], 1)));
             }
         }
         $this->tpl->setContent($a_form->getHTML());
     }

Here is the call graph for this function:

◆ updateAssignmentTextAndReturnObject()

ilExSubmissionTextGUI::updateAssignmentTextAndReturnObject ( )

Definition at line 198 of file class.ilExSubmissionTextGUI.php.

References updateAssignmentTextObject().

                                                          : void
     {
         $this->updateAssignmentTextObject(true);
     }

Here is the call graph for this function:

◆ updateAssignmentTextObject()

ilExSubmissionTextGUI::updateAssignmentTextObject ( bool $a_return = false )

Exceptions

ilExcUnknownAssignmentTypeException
ilExerciseException

Definition at line 207 of file class.ilExSubmissionTextGUI.php.

References ilExSubmissionBaseGUI\$ctrl, ilObjMediaObject\_exists(), ilRTE\_getMediaObjects(), ilObjAdvancedEditing\_getUsedHTMLTags(), ilObjMediaObject\_removeUsage(), ilRTE\_replaceMediaObjectImageSrc(), ilObjMediaObject\_saveUsage(), editAssignmentTextObject(), ilExSubmissionBaseGUI\handleNewUpload(), ilExSubmissionBaseGUI\handleRemovedUpload(), initAssignmentTextForm(), ILIAS\Repository\lng(), and ilCtrl\redirect().

Referenced by updateAssignmentTextAndReturnObject().

      : void {
         $ilCtrl = $this->ctrl;
 
         if (!$this->submission->canSubmit()) {
             $this->tpl->setOnScreenMessage('failure', $this->lng->txt("exercise_time_over"), true);
             $ilCtrl->redirect($this, "returnToParent");
         }
 
         $form = $this->initAssignmentTextForm();
 
         // we are not using a purifier, so we have to set the valid RTE tags
         // :TODO:
         $rte = $form->getItemByPostVar("atxt");
         $rte->setRteTags(ilObjAdvancedEditing::_getUsedHTMLTags("exc_ass"));
 
         if ($form->checkInput()) {
             $text = trim($form->getInput("atxt"));
 
             $returned_id = $this->submission->updateTextSubmission(
                 // mob src to mob id
                 ilRTE::_replaceMediaObjectImageSrc($text, 0)
             );
 
             // no empty text
             if ($returned_id) {
                 // #16532 - always send notifications
                 $this->handleNewUpload();
 
                 // mob usage
                 $mobs = ilRTE::_getMediaObjects($text, 0);
                 foreach ($mobs as $mob) {
                     if (ilObjMediaObject::_exists($mob)) {
                         ilObjMediaObject::_removeUsage($mob, 'exca~:html', $this->submission->getUserId());
                         ilObjMediaObject::_saveUsage($mob, 'exca:html', $returned_id);
                     }
                 }
             } else {
                 $this->handleRemovedUpload();
             }
 
             $this->tpl->setOnScreenMessage('success', $this->lng->txt("exc_text_saved"), true);
             if ($a_return) {
                 $ilCtrl->redirect($this, "returnToParent");
             } else {
                 $ilCtrl->redirect($this, "editAssignmentText");
             }
         }
 
         $form->setValuesByPost();
         $this->editAssignmentTextObject($form);
     }