Inheritance diagram for ilAssQuestionHintGUI:

Collaboration diagram for ilAssQuestionHintGUI:

Public Member Functions
	__construct (assQuestionGUI $questionGUI)

	executeCommand ()
	Execute Command. More...

Public Member Functions inherited from ilAssQuestionHintAbstractGUI
	__construct (assQuestionGUI $questionGUI)
	Constructor. More...

Data Fields
const	CMD_SHOW_FORM = 'showForm'
	command constants More...

const	CMD_SAVE_FORM = 'saveForm'

const	CMD_CANCEL_FORM = 'cancelForm'

const	CMD_CONFIRM_FORM = 'confirmForm'

Private Member Functions
	showFormCmd (ilPropertyFormGUI $form=null)
	shows the form for managing a new/existing hint More...

	saveFormCmd ()
	saves the form on successfull validation and redirects to showForm command More...

	cancelFormCmd ()
	gateway command method to jump back to question hints overview More...

	buildForm (ilAssQuestionHint $questionHint=null)
	builds the questions hints form More...

Private Attributes
ilGlobalTemplateInterface	$main_tpl

Additional Inherited Members
Protected Attributes inherited from ilAssQuestionHintAbstractGUI
ILIAS TestQuestionPool InternalRequestService	$request

assQuestionGUI	$questionGUI = null

assQuestion	$questionOBJ = null

ilTabsGUI	$tabs

Detailed Description

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

Constructor & Destructor Documentation

◆ __construct()

ilAssQuestionHintGUI::__construct ( assQuestionGUI $questionGUI )

Definition at line 42 of file class.ilAssQuestionHintGUI.php.

References $DIC, and ILIAS\GlobalScreen\Provider\__construct().

     {
         parent::__construct($questionGUI);
         global $DIC;
         $this->main_tpl = $DIC->ui()->mainTemplate();
     }

Here is the call graph for this function:

Member Function Documentation

◆ buildForm()

ilAssQuestionHintGUI::buildForm ( ilAssQuestionHint $questionHint = null )

private

builds the questions hints form

private ilCtrl $ilCtrl ilLanguage $lng

Returns: ilPropertyFormGUI $form

Definition at line 202 of file class.ilAssQuestionHintGUI.php.

References $DIC, $lng, ilObjAdvancedEditing\_getUsedHTMLTags(), ilNumberInputGUI\allowDecimals(), and ilFormPropertyGUI\setRequired().

Referenced by saveFormCmd(), and showFormCmd().

                                                                       : ilPropertyFormGUI
     {
         global $DIC;
         $ilCtrl = $DIC['ilCtrl'];
         $lng = $DIC['lng'];
 
         require_once 'Services/Form/classes/class.ilPropertyFormGUI.php';
         require_once 'Services/Form/classes/class.ilTextAreaInputGUI.php';
         require_once 'Services/Form/classes/class.ilNumberInputGUI.php';
         require_once 'Services/Form/classes/class.ilHiddenInputGUI.php';
 
         $form = new ilPropertyFormGUI();
         $form->setTableWidth('100%');
 
         if (!$this->questionOBJ->isAdditionalContentEditingModePageObject()) {
             // form input: hint text
 
             $areaInp = new ilTextAreaInputGUI($lng->txt('tst_question_hints_form_label_hint_text'), 'hint_text');
             $areaInp->setRequired(true);
             $areaInp->setRows(10);
             $areaInp->setCols(80);
 
             if (!$this->questionOBJ->getPreventRteUsage()) {
                 $areaInp->setUseRte(true);
             }
 
             include_once "./Services/AdvancedEditing/classes/class.ilObjAdvancedEditing.php";
             $areaInp->setRteTags(ilObjAdvancedEditing::_getUsedHTMLTags("assessment"));
 
             $areaInp->setRTESupport($this->questionOBJ->getId(), 'qpl', 'assessment');
 
             $areaInp->addPlugin("latex");
             $areaInp->addButton("latex");
             $areaInp->addButton("pastelatex");
 
             $form->addItem($areaInp);
         }
 
         // form input: hint points
 
         $numInp = new ilNumberInputGUI($lng->txt('tst_question_hints_form_label_hint_points'), 'hint_points');
         $numInp->allowDecimals(true);
         $numInp->setRequired(true);
         $numInp->setSize(3);
 
         $form->addItem($numInp);
 
         if ($questionHint instanceof ilAssQuestionHint) {
             // build form title for an existing hint
 
             $form->setTitle(sprintf(
                 $lng->txt('tst_question_hints_form_header_edit'),
                 $questionHint->getIndex(),
                 $this->questionOBJ->getTitleForHTMLOutput()
             ));
 
             // hidden input: hint id
 
             $hiddenInp = new ilHiddenInputGUI('hint_id');
             $form->addItem($hiddenInp);
 
             // init values
 
             require_once 'Services/Utilities/classes/class.ilUtil.php';
 
             if (!$this->questionOBJ->isAdditionalContentEditingModePageObject()) {
                 $areaInp->setValue($questionHint->getText());
             }
 
             $numInp->setValue($questionHint->getPoints());
 
             $hiddenInp->setValue($questionHint->getId());
         } else {
             // build form title for a new hint
             $form->setTitle(sprintf(
                 $lng->txt('tst_question_hints_form_header_create'),
                 $this->questionOBJ->getTitleForHTMLOutput()
             ));
         }
 
         if ($this->questionOBJ->isAdditionalContentEditingModePageObject()) {
             if ($questionHint instanceof ilAssQuestionHint) {
                 $saveCmdLabel = $lng->txt('tst_question_hints_form_cmd_save_points');
             } else {
                 $saveCmdLabel = $lng->txt('tst_question_hints_form_cmd_save_points_and_edit_page');
             }
         } else {
             $saveCmdLabel = $lng->txt('tst_question_hints_form_cmd_save');
         }
 
         $form->setFormAction($ilCtrl->getFormAction($this));
 
         $form->addCommandButton(self::CMD_SAVE_FORM, $saveCmdLabel);
         $form->addCommandButton(self::CMD_CANCEL_FORM, $lng->txt('cancel'));
 
         return $form;
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ cancelFormCmd()

ilAssQuestionHintGUI::cancelFormCmd ( )

private

gateway command method to jump back to question hints overview

private ilCtrl $ilCtrl

Definition at line 186 of file class.ilAssQuestionHintGUI.php.

References $DIC.

                                     : void
     {
         global $DIC;
         $ilCtrl = $DIC['ilCtrl'];
 
         $ilCtrl->redirectByClass('ilAssQuestionHintsGUI');
     }

◆ executeCommand()

ilAssQuestionHintGUI::executeCommand ( )

Execute Command.

public ilCtrl $ilCtrl

Returns: mixed

Definition at line 56 of file class.ilAssQuestionHintGUI.php.

References $DIC, $lng, $tpl, ilAssQuestionHintPageObjectCommandForwarder\PRESENTATION_MODE_AUTHOR, and ILIAS\Repository\tabs().

     {
         global $DIC;
         $ilCtrl = $DIC['ilCtrl'];
         $ilTabs = $DIC['ilTabs'];
         $lng = $DIC['lng'];
         $tpl = $DIC['tpl'];
 
         $cmd = $ilCtrl->getCmd(self::CMD_SHOW_FORM);
         $nextClass = $ilCtrl->getNextClass($this);
 
         switch ($nextClass) {
             case 'ilasshintpagegui':
                 require_once 'Modules/TestQuestionPool/classes/class.ilAssQuestionHintPageObjectCommandForwarder.php';
                 $forwarder = new ilAssQuestionHintPageObjectCommandForwarder($this->questionOBJ, $ilCtrl, $ilTabs, $lng);
                 $forwarder->setPresentationMode(ilAssQuestionHintPageObjectCommandForwarder::PRESENTATION_MODE_AUTHOR);
                 $forwarder->forward();
                 break;
 
             default:
                 $this->tabs->setTabActive('tst_question_hints_tab');
                 $cmd .= 'Cmd';
                 $this->$cmd();
                 break;
         }
 
         return true;
     }

Here is the call graph for this function:

◆ saveFormCmd()

ilAssQuestionHintGUI::saveFormCmd ( )

private

saves the form on successfull validation and redirects to showForm command

private ilCtrl $ilCtrl ilLanguage $lng

Definition at line 126 of file class.ilAssQuestionHintGUI.php.

References $DIC, $ilUser, $lng, assQuestion\_isWriteable(), buildForm(), ilAssQuestionHintsGUI\CMD_CONFIRM_SYNC, ilAssQuestionHintsGUI\CMD_SHOW_LIST, ilAssQuestionHintList\getNextIndexByQuestionId(), and showFormCmd().

                                   : void
     {
         global $DIC;
         $ilCtrl = $DIC['ilCtrl'];
         $lng = $DIC['lng'];
         $ilUser = $DIC['ilUser'];
 
         $questionHint = new ilAssQuestionHint();
         if ($this->request->isset('hint_id')) {
             $questionHint->load((int) $this->request->int('hint_id'));
 
             $hintJustCreated = false;
             $form = $this->buildForm($questionHint);
         } else {
             $questionHint->setQuestionId($this->questionOBJ->getId());
 
             $questionHint->setIndex(
                 ilAssQuestionHintList::getNextIndexByQuestionId($this->questionOBJ->getId())
             );
 
             $hintJustCreated = true;
             $form = $this->buildForm();
         }
 
         if ($form->checkInput()) {
             $questionHint->setText($form->getInput('hint_text'));
             $questionHint->setPoints($form->getInput('hint_points'));
 
             $questionHint->save();
             $this->main_tpl->setOnScreenMessage('success', $lng->txt('tst_question_hints_form_saved_msg'), true);
 
             if (!$this->questionOBJ->isAdditionalContentEditingModePageObject()) {
                 $this->questionOBJ->updateTimestamp();
             }
 
             $originalexists = $this->questionOBJ->_questionExistsInPool((int) $this->questionOBJ->getOriginalId());
             include_once "./Modules/TestQuestionPool/classes/class.assQuestion.php";
             if ($this->request->raw('calling_test') && $originalexists && assQuestion::_isWriteable($this->questionOBJ->getOriginalId(), $ilUser->getId())) {
                 $ilCtrl->redirectByClass('ilAssQuestionHintsGUI', ilAssQuestionHintsGUI::CMD_CONFIRM_SYNC);
             }
 
 
             if ($hintJustCreated && $this->questionOBJ->isAdditionalContentEditingModePageObject()) {
                 $ilCtrl->setParameterByClass('ilasshintpagegui', 'hint_id', $questionHint->getId());
                 $ilCtrl->redirectByClass('ilasshintpagegui', 'edit');
             } else {
                 $ilCtrl->redirectByClass('ilAssQuestionHintsGUI', ilAssQuestionHintsGUI::CMD_SHOW_LIST);
             }
         }
 
         $this->main_tpl->setOnScreenMessage('failure', $lng->txt('tst_question_hints_form_invalid_msg'));
         $this->showFormCmd($form);
     }

Here is the call graph for this function:

◆ showFormCmd()

ilAssQuestionHintGUI::showFormCmd ( ilPropertyFormGUI $form = null )

private

shows the form for managing a new/existing hint

private ilCtrl $ilCtrl ilTemplate $tpl

Definition at line 92 of file class.ilAssQuestionHintGUI.php.

References $DIC, $lng, $tpl, buildForm(), ilAssQuestionHintsGUI\CMD_SHOW_LIST, and ILIAS\Repository\int().

Referenced by saveFormCmd().

                                                                 : void
     {
         global $DIC;
         $ilCtrl = $DIC['ilCtrl'];
         $tpl = $DIC['tpl'];
         $ilToolbar = $DIC['ilToolbar'];
         $lng = $DIC['lng'];
         $ilCtrl = $DIC['ilCtrl'];
 
         if ($form instanceof ilPropertyFormGUI) {
             $form->setValuesByPost();
         } elseif ($this->request->isset('hint_id') && (int) $this->request->raw('hint_id')) {
             $questionHint = new ilAssQuestionHint();
 
             if (!$questionHint->load((int) $this->request->raw('hint_id'))) {
                 $this->main_tpl->setOnScreenMessage('failure', 'invalid hint id given: ' . (int) $this->request->raw('hint_id'), true);
                 $ilCtrl->redirectByClass('ilAssQuestionHintsGUI', ilAssQuestionHintsGUI::CMD_SHOW_LIST);
             }
 
             $form = $this->buildForm($questionHint);
         } else {
             $form = $this->buildForm();
         }
 
         $tpl->setContent($form->getHTML());
     }