Inheritance diagram for ilAssQuestionHintsGUI:

Collaboration diagram for ilAssQuestionHintsGUI:

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

	isEditingEnabled ()

	setEditingEnabled (bool $editingEnabled)

	executeCommand ()
	Execute Command. More...

	confirmSyncCmd ()

	getHintPresentationLinkTarget ($hintId, $xmlStyle=true)
	returns the link target for hint request presentation More...

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

Data Fields
const	CMD_SHOW_LIST = 'showList'
	command constants More...

const	CMD_SHOW_HINT = 'showHint'

const	CMD_CONFIRM_DELETE = 'confirmDelete'

const	CMD_PERFORM_DELETE = 'performDelete'

const	CMD_SAVE_LIST_ORDER = 'saveListOrder'

const	CMD_CUT_TO_ORDERING_CLIPBOARD = 'cutToOrderingClipboard'

const	CMD_PASTE_FROM_ORDERING_CLIPBOARD_BEFORE = 'pasteFromOrderingClipboardBefore'

const	CMD_PASTE_FROM_ORDERING_CLIPBOARD_AFTER = 'pasteFromOrderingClipboardAfter'

const	CMD_RESET_ORDERING_CLIPBOARD = 'resetOrderingClipboard'

const	CMD_CONFIRM_SYNC = 'confirmSync'

Protected Attributes
	$editingEnabled = false

Protected Attributes inherited from ilAssQuestionHintAbstractGUI
	$questionGUI = null

	$questionOBJ = null

Private Member Functions
	showListCmd ()
	shows a table with existing hints More...

	confirmDeleteCmd ()
	shows a confirmation screen with selected hints for deletion More...

	performDeleteCmd ()
	performs confirmed deletion for selected hints More...

	saveListOrderCmd ()
	saves the order based on index values passed from table's form (the table must not be paginated, because ALL hints index values are required) More...

	cutToOrderingClipboardCmd ()
	cuts a hint from question hint list and stores it to ordering clipboard More...

	pasteFromOrderingClipboardBeforeCmd ()
	pastes a hint from ordering clipboard before the selected one More...

	pasteFromOrderingClipboardAfterCmd ()
	pastes a hint from ordering clipboard after the selected one More...

	resetOrderingClipboardCmd ()
	resets the ordering clipboard More...

	initHintOrderingClipboardNotification ()
	inits the notification telling the user, that a hint is stored to hint ordering clipboard More...

	checkForExistingHintRelatingToCurrentQuestionAndRedirectOnFailure ($hintId)
	checks for an existing hint relating to current question and redirects with corresponding failure message on failure More...

	getQuestionHintListWithoutHintStoredInOrderingClipboard (ilAssQuestionHintList $questionHintList)
	returns a new quastion hint list that contains all question hints from the passed list except for the hint that is stored to ordering clipboard More...

	checkForSingleHintIdAndRedirectOnFailure ($hintIds)
	checks for a hint id in the passed array and redirects with corresponding failure message if not exactly one id is given More...

	showHintCmd ()
	shows an allready requested hint More...

Static Private Member Functions
static	fetchHintIdsParameter ()
	fetches either an array of hint ids from POST or a single hint id from GET and returns an array of (a single) hint id(s) casted to integer in both cases More...

static	fetchHintIndexesParameter ()
	fetches an array of hint index values from POST More...

static	orderHintIndexes ($hintIndexes)
	sorts the array of indexes by index value so keys (hint ids) get into new order submitted by user More...

Private Attributes
	$hintOrderingClipboard = null

Detailed Description

Definition at line 22 of file class.ilAssQuestionHintsGUI.php.

Constructor & Destructor Documentation

◆ __construct()

ilAssQuestionHintsGUI::__construct ( assQuestionGUI $questionGUI )

Constructor.

public

Parameters

assQuestionGUI $questionGUI

Definition at line 57 of file class.ilAssQuestionHintsGUI.php.

         {
                 parent::__construct($questionGUI);
                 
                 $this->hintOrderingClipboard = new ilAssQuestionHintsOrderingClipboard($questionGUI->object);
         }

Member Function Documentation

◆ checkForExistingHintRelatingToCurrentQuestionAndRedirectOnFailure()

ilAssQuestionHintsGUI::checkForExistingHintRelatingToCurrentQuestionAndRedirectOnFailure ( $hintId )

private

checks for an existing hint relating to current question and redirects with corresponding failure message on failure

private

Parameters

integer $hintId

Definition at line 551 of file class.ilAssQuestionHintsGUI.php.

References $ilCtrl, $lng, ilAssQuestionHintList\getListByQuestionId(), and ilUtil\sendFailure().

Referenced by cutToOrderingClipboardCmd(), pasteFromOrderingClipboardAfterCmd(), and pasteFromOrderingClipboardBeforeCmd().

         {
                 $questionHintList = ilAssQuestionHintList::getListByQuestionId( $this->questionOBJ->getId() );
                 
                 if( !$questionHintList->hintExists($hintId) )
                 {
                         ilUtil::sendFailure($lng->txt('tst_question_hints_invalid_hint_id'), true);
                         $ilCtrl->redirect($this, self::CMD_SHOW_LIST);
                 }
         }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ checkForSingleHintIdAndRedirectOnFailure()

ilAssQuestionHintsGUI::checkForSingleHintIdAndRedirectOnFailure ( $hintIds )

private

checks for a hint id in the passed array and redirects with corresponding failure message if not exactly one id is given

private ilCtrl $ilCtrl ilLanguage $lng

Parameters

array $hintIds

Definition at line 596 of file class.ilAssQuestionHintsGUI.php.

References $ilCtrl, $lng, and ilUtil\sendFailure().

Referenced by cutToOrderingClipboardCmd(), pasteFromOrderingClipboardAfterCmd(), and pasteFromOrderingClipboardBeforeCmd().

         {
                 global $ilCtrl, $lng;
                 
                 if( !count($hintIds) )
                 {
                         ilUtil::sendFailure($lng->txt('tst_question_hints_cut_hints_missing_selection_msg'), true);
                         $ilCtrl->redirect($this, self::CMD_SHOW_LIST);
                 }
                 elseif( count($hintIds) > 1 )
                 {
                         ilUtil::sendFailure($lng->txt('tst_question_hints_cut_hints_single_selection_msg'), true);
                         $ilCtrl->redirect($this, self::CMD_SHOW_LIST);
                 }
         }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ confirmDeleteCmd()

ilAssQuestionHintsGUI::confirmDeleteCmd ( )

private

shows a confirmation screen with selected hints for deletion

private ilCtrl $ilCtrl ilTemplate $tpl ilLanguage $lng

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

References $ilCtrl, $lng, $tpl, ilAssQuestionHintList\getListByQuestionId(), and ilUtil\sendFailure().

         {
                 global $ilCtrl, $tpl, $lng;
                 
                 $hintIds = self::fetchHintIdsParameter();
 
                 if( !count($hintIds) )
                 {
                         ilUtil::sendFailure($lng->txt('tst_question_hints_delete_hints_missing_selection_msg'), true);
                         $ilCtrl->redirect($this);
                 }
                 
                 require_once 'Services/Utilities/classes/class.ilConfirmationGUI.php';
                 $confirmation = new ilConfirmationGUI();
                 
                 $confirmation->setHeaderText($lng->txt('tst_question_hints_delete_hints_confirm_header'));
                 $confirmation->setFormAction($ilCtrl->getFormAction($this));
                 $confirmation->setConfirm($lng->txt('tst_question_hints_delete_hints_confirm_cmd'), self::CMD_PERFORM_DELETE);
                 $confirmation->setCancel($lng->txt('cancel'), self::CMD_SHOW_LIST);
 
                 $questionHintList = ilAssQuestionHintList::getListByQuestionId($this->questionOBJ->getId());
                 
                 foreach($questionHintList as $questionHint)
                 {
                         /* @var $questionHint ilAssQuestionHint */
                         
                         if( in_array($questionHint->getId(), $hintIds) )
                         {
                                 $confirmation->addItem('hint_ids[]', $questionHint->getId(), sprintf(
                                                 $lng->txt('tst_question_hints_delete_hints_confirm_item'), $questionHint->getIndex(), $questionHint->getText()
                                 ));
                         }
                 }
                 
                 $tpl->setContent( $ilCtrl->getHtml($confirmation) );
         }

Here is the call graph for this function:

◆ confirmSyncCmd()

ilAssQuestionHintsGUI::confirmSyncCmd ( )

Definition at line 676 of file class.ilAssQuestionHintsGUI.php.

         {
                 $this->questionGUI->originalSyncForm('showHints');
         }

◆ cutToOrderingClipboardCmd()

ilAssQuestionHintsGUI::cutToOrderingClipboardCmd ( )

private

cuts a hint from question hint list and stores it to ordering clipboard

private ilCtrl $ilCtrl

Definition at line 361 of file class.ilAssQuestionHintsGUI.php.

References $ilCtrl, checkForExistingHintRelatingToCurrentQuestionAndRedirectOnFailure(), checkForSingleHintIdAndRedirectOnFailure(), and isEditingEnabled().

         {
                 if( !$this->isEditingEnabled() )
                 {
                         return;
                 }
                 
                 global $ilCtrl;
                 
                 $moveHintIds = self::fetchHintIdsParameter();
                 $this->checkForSingleHintIdAndRedirectOnFailure($moveHintIds);
                 
                 $moveHintId = current($moveHintIds);
                 
                 $this->checkForExistingHintRelatingToCurrentQuestionAndRedirectOnFailure($moveHintId);
                 
                 $this->hintOrderingClipboard->setStored($moveHintId);
                 
                 $ilCtrl->redirect($this, self::CMD_SHOW_LIST);
         }

Here is the call graph for this function:

◆ executeCommand()

ilAssQuestionHintsGUI::executeCommand ( )

Execute Command.

public ilCtrl $ilCtrl

Returns: mixed

Definition at line 87 of file class.ilAssQuestionHintsGUI.php.

References $cmd, $DIC, $ilCtrl, $lng, $tpl, ilObjStyleSheet\getContentStylePath(), isEditingEnabled(), ilAssQuestionHintPageObjectCommandForwarder\PRESENTATION_MODE_AUTHOR, and ilAssQuestionHintPageObjectCommandForwarder\PRESENTATION_MODE_PREVIEW.

         {
                 global $ilCtrl, $ilTabs, $lng, $tpl;
                 global $DIC; /* @var \ILIAS\DI\Container $DIC */
                 $ilHelp = $DIC['ilHelp']; /* @var ilHelpGUI $ilHelp */
                 $ilHelp->setScreenIdComponent('qpl');
 
                 require_once "./Services/Style/Content/classes/class.ilObjStyleSheet.php";
                 $tpl->setCurrentBlock("ContentStyle");
                 $tpl->setVariable("LOCATION_CONTENT_STYLESHEET", ilObjStyleSheet::getContentStylePath(0));
                 $tpl->parseCurrentBlock();
                 
                 $cmd = $ilCtrl->getCmd(self::CMD_SHOW_LIST);
                 $nextClass = $ilCtrl->getNextClass($this);
 
                 switch($nextClass)
                 {
                         case 'ilassquestionhintgui':
 
                                 if( !$this->isEditingEnabled() )
                                 {
                                         return;
                                 }
                                 
                                 require_once 'Modules/TestQuestionPool/classes/class.ilAssQuestionHintGUI.php';
                                 $gui = new ilAssQuestionHintGUI($this->questionGUI);
                                 $ilCtrl->forwardCommand($gui);
                                 break;
                                 
                         case 'ilasshintpagegui':
                                 
                                 if( $this->isEditingEnabled() )
                                 {
                                         $presentationMode = ilAssQuestionHintPageObjectCommandForwarder::PRESENTATION_MODE_AUTHOR;
                                 }
                                 else
                                 {
                                         $presentationMode = ilAssQuestionHintPageObjectCommandForwarder::PRESENTATION_MODE_PREVIEW;
                                 }
                                 
                                 require_once 'Modules/TestQuestionPool/classes/class.ilAssQuestionHintPageObjectCommandForwarder.php';
                                 $forwarder = new ilAssQuestionHintPageObjectCommandForwarder($this->questionOBJ, $ilCtrl, $ilTabs, $lng);
                                 $forwarder->setPresentationMode($presentationMode);
                                 $forwarder->forward();
                                 break;
 
                         default:
                                 
                                 $cmd .= 'Cmd';
                                 $this->$cmd();
                                 break;
                 }
         }

Here is the call graph for this function:

◆ fetchHintIdsParameter()

static ilAssQuestionHintsGUI::fetchHintIdsParameter ( )

staticprivate

fetches either an array of hint ids from POST or a single hint id from GET and returns an array of (a single) hint id(s) casted to integer in both cases

private

Returns: array $hintIds

Definition at line 620 of file class.ilAssQuestionHintsGUI.php.

References $_GET, $_POST, and array.

         {
                 $hintIds = array();
                 
                 if( isset($_POST['hint_ids']) && is_array($_POST['hint_ids']) )
                 {
                         foreach($_POST['hint_ids'] as $hintId)
                         {
                                 if( (int)$hintId ) $hintIds[] = (int)$hintId;
                         }
                 }
                 elseif( isset($_GET['hint_id']) && (int)$_GET['hint_id'] )
                 {
                         $hintIds[] = (int)$_GET['hint_id'];
                 }
                 
                 return $hintIds;
         }

◆ fetchHintIndexesParameter()

static ilAssQuestionHintsGUI::fetchHintIndexesParameter ( )

staticprivate

fetches an array of hint index values from POST

private

Returns: array $hintIndexes

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

References $_POST, and array.

         {
                 $hintIndexes = array();
                 
                 if( isset($_POST['hint_indexes']) && is_array($_POST['hint_indexes']) )
                 {
                         foreach($_POST['hint_indexes'] as $hintId => $hintIndex)
                         {
                                 if( (int)$hintId ) $hintIndexes[(int)$hintId] = $hintIndex;
                         }
                 }
 
                 return $hintIndexes;
         }

◆ getHintPresentationLinkTarget()

ilAssQuestionHintsGUI::getHintPresentationLinkTarget	(	$hintId,
		$xmlStyle = `true`
	)

returns the link target for hint request presentation

Parameters

integer	$hintId
boolean	$xmlStyle

Returns: string $linkTarget

Definition at line 688 of file class.ilAssQuestionHintsGUI.php.

References $DIC, and $ilCtrl.

         {
                 global $DIC;
                 $ilCtrl = $DIC['ilCtrl'];
                 
                 if( $this->questionOBJ->isAdditionalContentEditingModePageObject() )
                 {
                         $ilCtrl->setParameterByClass('ilasshintpagegui', 'hint_id', $hintId);
                         $linkTarget = $ilCtrl->getLinkTargetByClass('ilAssHintPageGUI', '', '', false, $xmlStyle);
                 }
                 else
                 {
                         $ilCtrl->setParameter($this, 'hintId', $hintId);
                         $linkTarget = $ilCtrl->getLinkTarget($this, self::CMD_SHOW_HINT, '', false, $xmlStyle);
                 }
                 
                 return $linkTarget;
         }

◆ getQuestionHintListWithoutHintStoredInOrderingClipboard()

ilAssQuestionHintsGUI::getQuestionHintListWithoutHintStoredInOrderingClipboard ( ilAssQuestionHintList $questionHintList )

private

returns a new quastion hint list that contains all question hints from the passed list except for the hint that is stored to ordering clipboard

private

Parameters

ilAssQuestionHintList $questionHintList

Returns: ilAssQuestionHintList $filteredQuestionHintList

Definition at line 570 of file class.ilAssQuestionHintsGUI.php.

Referenced by showListCmd().

         {
                 $filteredQuestionHintList = new ilAssQuestionHintList();
                 
                 foreach($questionHintList as $questionHint)
                 {
                         /* @var $questionHint ilAssQuestionHint */
 
                         if( $questionHint->getId() != $this->hintOrderingClipboard->getStored() )
                         {
                                 $filteredQuestionHintList->addHint($questionHint);
                         }
                 }
                 
                 return $filteredQuestionHintList;
         }

Here is the caller graph for this function:

◆ initHintOrderingClipboardNotification()

ilAssQuestionHintsGUI::initHintOrderingClipboardNotification ( )

private

inits the notification telling the user, that a hint is stored to hint ordering clipboard

private ilLanguage $lng

Definition at line 528 of file class.ilAssQuestionHintsGUI.php.

References $lng, ilAssQuestionHint\getInstanceById(), and ilUtil\sendInfo().

Referenced by showListCmd().

         {
                 global $lng;
                 
                 if( !$this->hintOrderingClipboard->hasStored() )
                 {
                         return;
                 }
 
                 $questionHint = ilAssQuestionHint::getInstanceById( $this->hintOrderingClipboard->getStored() );
 
                 ilUtil::sendInfo(sprintf(
                                 $lng->txt('tst_question_hints_item_stored_in_ordering_clipboard'), $questionHint->getIndex()
                 ));
         }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ isEditingEnabled()

ilAssQuestionHintsGUI::isEditingEnabled ( )

Returns: bool

Definition at line 67 of file class.ilAssQuestionHintsGUI.php.

References $editingEnabled.

Referenced by cutToOrderingClipboardCmd(), executeCommand(), pasteFromOrderingClipboardAfterCmd(), pasteFromOrderingClipboardBeforeCmd(), performDeleteCmd(), saveListOrderCmd(), and showListCmd().

         {
                 return $this->editingEnabled;
         }

Here is the caller graph for this function:

◆ orderHintIndexes()

static ilAssQuestionHintsGUI::orderHintIndexes ( $hintIndexes )

staticprivate

sorts the array of indexes by index value so keys (hint ids) get into new order submitted by user

private

Returns: array $hintIndexes

Definition at line 669 of file class.ilAssQuestionHintsGUI.php.

         {
                 asort($hintIndexes);
 
                 return $hintIndexes;
         }

◆ pasteFromOrderingClipboardAfterCmd()

ilAssQuestionHintsGUI::pasteFromOrderingClipboardAfterCmd ( )

private

pastes a hint from ordering clipboard after the selected one

private ilCtrl $ilCtrl ilLanguage $lng

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

References $ilCtrl, $lng, ilAssQuestionHintList\addHint(), checkForExistingHintRelatingToCurrentQuestionAndRedirectOnFailure(), checkForSingleHintIdAndRedirectOnFailure(), ilAssQuestionHint\getInstanceById(), ilAssQuestionHintList\getListByQuestionId(), isEditingEnabled(), and ilUtil\sendSuccess().

         {
                 if( !$this->isEditingEnabled() )
                 {
                         return;
                 }
                 
                 global $ilCtrl, $lng;
 
                 $targetHintIds = self::fetchHintIdsParameter();
                 $this->checkForSingleHintIdAndRedirectOnFailure($targetHintIds);
                 
                 $targetHintId = current($targetHintIds);
                 
                 $this->checkForExistingHintRelatingToCurrentQuestionAndRedirectOnFailure($targetHintId);
                 
                 $curQuestionHintList = ilAssQuestionHintList::getListByQuestionId( $this->questionOBJ->getId() );
                 $newQuestionHintList = new ilAssQuestionHintList( $this->questionOBJ->getId() );
                 
                 foreach($curQuestionHintList as $questionHint)
                 {
                         /* @var $questionHint ilAssQuestionHint */
 
                         if( $questionHint->getId() == $this->hintOrderingClipboard->getStored() )
                         {
                                 continue;
                         }
                         
                         $newQuestionHintList->addHint($questionHint);
                         
                         if( $questionHint->getId() == $targetHintId )
                         {
                                 $targetQuestionHint = $questionHint;
                                 
                                 $pasteQuestionHint = ilAssQuestionHint::getInstanceById( $this->hintOrderingClipboard->getStored() );
                                 
                                 $newQuestionHintList->addHint($pasteQuestionHint);
                         }
                 }
                 
                 $successMsg = sprintf(
                         $lng->txt('tst_question_hints_paste_after_success_msg'),
                         $pasteQuestionHint->getIndex(), $targetQuestionHint->getIndex()
                 );
                 
                 $newQuestionHintList->reIndex();
 
                 $this->hintOrderingClipboard->resetStored();
 
                 ilUtil::sendSuccess($successMsg, true);
                 
                 $ilCtrl->redirect($this, self::CMD_SHOW_LIST);
         }

Here is the call graph for this function:

◆ pasteFromOrderingClipboardBeforeCmd()

ilAssQuestionHintsGUI::pasteFromOrderingClipboardBeforeCmd ( )

private

pastes a hint from ordering clipboard before the selected one

private ilCtrl $ilCtrl ilLanguage $lng

Definition at line 389 of file class.ilAssQuestionHintsGUI.php.

References $ilCtrl, $lng, checkForExistingHintRelatingToCurrentQuestionAndRedirectOnFailure(), checkForSingleHintIdAndRedirectOnFailure(), ilAssQuestionHint\getInstanceById(), ilAssQuestionHintList\getListByQuestionId(), isEditingEnabled(), and ilUtil\sendSuccess().

         {
                 if( !$this->isEditingEnabled() )
                 {
                         return;
                 }
                 
                 global $ilCtrl, $lng;
 
                 $targetHintIds = self::fetchHintIdsParameter();
                 $this->checkForSingleHintIdAndRedirectOnFailure($targetHintIds);
                 
                 $targetHintId = current($targetHintIds);
                 
                 $this->checkForExistingHintRelatingToCurrentQuestionAndRedirectOnFailure($targetHintId);
                 
                 $curQuestionHintList = ilAssQuestionHintList::getListByQuestionId( $this->questionOBJ->getId() );
                 $newQuestionHintList = new ilAssQuestionHintList( $this->questionOBJ->getId() );
                 
                 foreach($curQuestionHintList as $questionHint)
                 {
                         /* @var $questionHint ilAssQuestionHint */
 
                         if( $questionHint->getId() == $this->hintOrderingClipboard->getStored() )
                         {
                                 continue;
                         }
                         
                         if( $questionHint->getId() == $targetHintId )
                         {
                                 $targetQuestionHint = $questionHint;
 
                                 $pasteQuestionHint = ilAssQuestionHint::getInstanceById( $this->hintOrderingClipboard->getStored() );
                                 
                                 $newQuestionHintList->addHint($pasteQuestionHint);
                         }
                         
                         $newQuestionHintList->addHint($questionHint);
                 }
                 
                 $successMsg = sprintf(
                         $lng->txt('tst_question_hints_paste_before_success_msg'),
                         $pasteQuestionHint->getIndex(), $targetQuestionHint->getIndex()
                 );
                 
                 $newQuestionHintList->reIndex();
                 
                 $this->hintOrderingClipboard->resetStored();
                 
                 ilUtil::sendSuccess($successMsg, true);
 
                 $ilCtrl->redirect($this, self::CMD_SHOW_LIST);
         }

Here is the call graph for this function:

◆ performDeleteCmd()

ilAssQuestionHintsGUI::performDeleteCmd ( )

private

performs confirmed deletion for selected hints

private ilCtrl $ilCtrl ilLanguage $lng

Definition at line 246 of file class.ilAssQuestionHintsGUI.php.

References $_GET, $ilCtrl, $ilUser, $lng, $tpl, assQuestion\_isWriteable(), CMD_CONFIRM_SYNC, ilAssQuestionHintList\getListByQuestionId(), isEditingEnabled(), ilUtil\sendFailure(), and ilUtil\sendSuccess().

         {
                 if( !$this->isEditingEnabled() )
                 {
                         return;
                 }
                 
                 global $ilCtrl, $tpl, $lng;
                 
                 $hintIds = self::fetchHintIdsParameter();
                 
                 if( !count($hintIds) )
                 {
                         ilUtil::sendFailure($lng->txt('tst_question_hints_delete_hints_missing_selection_msg'), true);
                         $ilCtrl->redirect($this);
                 }
                 
                 $questionCompleteHintList = ilAssQuestionHintList::getListByQuestionId($this->questionOBJ->getId());
                 
                 $questionRemainingHintList = new ilAssQuestionHintList();
                 
                 foreach($questionCompleteHintList as $listKey => $questionHint)
                 {
                         /* @var $questionHint ilAssQuestionHint */
                         
                         if( in_array($questionHint->getId(), $hintIds) )
                         {
                                 $questionHint->delete();
                         }
                         else
                         {
                                 $questionRemainingHintList->addHint($questionHint);
                         }
                 }
                 
                 $questionRemainingHintList->reIndex();
                 
                 ilUtil::sendSuccess($lng->txt('tst_question_hints_delete_success_msg'), true);
 
                 $originalexists = $this->questionOBJ->_questionExistsInPool($this->questionOBJ->original_id);
                 include_once "./Modules/TestQuestionPool/classes/class.assQuestion.php";
                 global $ilUser;
                 if ($_GET["calling_test"] && $originalexists && assQuestion::_isWriteable($this->questionOBJ->original_id, $ilUser->getId()))
                 {
                         $ilCtrl->redirectByClass('ilAssQuestionHintsGUI', ilAssQuestionHintsGUI::CMD_CONFIRM_SYNC);
                 }
                 
                 $ilCtrl->redirect($this);
         }

Here is the call graph for this function:

◆ resetOrderingClipboardCmd()

ilAssQuestionHintsGUI::resetOrderingClipboardCmd ( )

private

resets the ordering clipboard

private ilCtrl $ilCtrl ilLanguage $lng

Definition at line 511 of file class.ilAssQuestionHintsGUI.php.

References $ilCtrl, $lng, and ilUtil\sendInfo().

         {
                 global $ilCtrl, $lng;
                 
                 $this->hintOrderingClipboard->resetStored();
                 
                 ilUtil::sendInfo($lng->txt('tst_question_hints_ordering_clipboard_resetted'), true);
                 $ilCtrl->redirect($this, self::CMD_SHOW_LIST);
         }

Here is the call graph for this function:

◆ saveListOrderCmd()

ilAssQuestionHintsGUI::saveListOrderCmd ( )

private

saves the order based on index values passed from table's form (the table must not be paginated, because ALL hints index values are required)

private ilCtrl $ilCtrl ilLanguage $lng

Definition at line 304 of file class.ilAssQuestionHintsGUI.php.

References $_GET, $ilCtrl, $ilUser, $lng, assQuestion\_isWriteable(), CMD_CONFIRM_SYNC, ilAssQuestionHintList\getListByQuestionId(), isEditingEnabled(), ilUtil\sendFailure(), and ilUtil\sendSuccess().

         {
                 if( !$this->isEditingEnabled() )
                 {
                         return;
                 }
                 
                 global $ilCtrl, $lng;
                 
                 $hintIndexes = self::orderHintIndexes(
                         self::fetchHintIndexesParameter()
                 );
                 
                 if( !count($hintIndexes) )
                 {
                         ilUtil::sendFailure($lng->txt('tst_question_hints_save_order_unkown_failure_msg'), true);
                         $ilCtrl->redirect($this);
                 }
                 
                 $curQuestionHintList = ilAssQuestionHintList::getListByQuestionId( $this->questionOBJ->getId() );
                 
                 $newQuestionHintList = new ilAssQuestionHintList();
                 
                 foreach($hintIndexes as $hintId => $hintIndex)
                 {
                         if( !$curQuestionHintList->hintExists($hintId) )
                         {
                                 ilUtil::sendFailure($lng->txt('tst_question_hints_save_order_unkown_failure_msg'), true);
                                 $ilCtrl->redirect($this);
                         }
                         
                         $questionHint = $curQuestionHintList->getHint($hintId);
                         
                         $newQuestionHintList->addHint($questionHint);
                 }
                 
                 $newQuestionHintList->reIndex();
                 
                 ilUtil::sendSuccess($lng->txt('tst_question_hints_save_order_success_msg'), true);
 
                 $originalexists = $this->questionOBJ->_questionExistsInPool($this->questionOBJ->original_id);
                 include_once "./Modules/TestQuestionPool/classes/class.assQuestion.php";
                 global $ilUser;
                 if ($_GET["calling_test"] && $originalexists && assQuestion::_isWriteable($this->questionOBJ->original_id, $ilUser->getId()))
                 {
                         $ilCtrl->redirectByClass('ilAssQuestionHintsGUI', ilAssQuestionHintsGUI::CMD_CONFIRM_SYNC);
                 }
                 
                 $ilCtrl->redirect($this);
         }

Here is the call graph for this function:

◆ setEditingEnabled()

ilAssQuestionHintsGUI::setEditingEnabled ( bool $editingEnabled )

Parameters

bool $editingEnabled

Definition at line 75 of file class.ilAssQuestionHintsGUI.php.

References $editingEnabled.

         {
                 $this->editingEnabled = $editingEnabled;
         }

◆ showHintCmd()

ilAssQuestionHintsGUI::showHintCmd ( )

private

shows an allready requested hint

private ilCtrl $ilCtrl ilTemplate $tpl ilLanguage $lng

Definition at line 715 of file class.ilAssQuestionHintsGUI.php.

References $_GET, $DIC, $ilCtrl, $lng, $tpl, ilAssQuestionHint\getInstanceById(), ilUtil\prepareTextareaOutput(), and ilNonEditableValueGUI\setValue().

         {
                 global $DIC;
                 $ilCtrl = $DIC['ilCtrl'];
                 $tpl = $DIC['tpl'];
                 $lng = $DIC['lng'];
                 
                 if( !isset($_GET['hintId']) || !(int)$_GET['hintId'] )
                 {
                         throw new ilTestException('no hint id given');
                 }
                 
                 $DIC->tabs()->clearTargets();
                 $DIC->tabs()->clearSubTabs();
                 
                 $DIC->tabs()->setBackTarget(
                         $DIC->language()->txt('tst_question_hints_back_to_hint_list'), $DIC->ctrl()->getLinkTarget($this, self::CMD_SHOW_LIST)
                 );
                 
                 $questionHint = ilAssQuestionHint::getInstanceById((int)$_GET['hintId']);
                 
                 // build form
                 
                 $form = new ilPropertyFormGUI();
                 
                 $form->setFormAction($ilCtrl->getFormAction($this));
                 
                 $form->setTableWidth('100%');
                 
                 $form->setTitle(sprintf(
                         $lng->txt('tst_question_hints_form_header_edit'),
                         $questionHint->getIndex(),
                         $this->questionOBJ->getTitle()
                 ));
 
                 // form input: hint text
                 
                 $nonEditableHintText = new ilNonEditableValueGUI($lng->txt('tst_question_hints_form_label_hint_text'), 'hint_text', true);
                 $nonEditableHintText->setValue( ilUtil::prepareTextareaOutput($questionHint->getText(), true) );
                 $form->addItem($nonEditableHintText);
                 
                 // form input: hint points
                 
                 $nonEditableHintPoints = new ilNonEditableValueGUI($lng->txt('tst_question_hints_form_label_hint_points'), 'hint_points');
                 $nonEditableHintPoints->setValue($questionHint->getPoints());
                 $form->addItem($nonEditableHintPoints);
                 
                 $tpl->setContent( $form->getHTML() );
         }

Here is the call graph for this function:

◆ showListCmd()

ilAssQuestionHintsGUI::showListCmd ( )

private

shows a table with existing hints

private ilTemplate $tpl

Definition at line 147 of file class.ilAssQuestionHintsGUI.php.

References $ilCtrl, $lng, $tpl, ilAssQuestionHintGUI\CMD_SHOW_FORM, ilAssQuestionHintList\getListByQuestionId(), getQuestionHintListWithoutHintStoredInOrderingClipboard(), initHintOrderingClipboardNotification(), isEditingEnabled(), ilAssQuestionHintsTableGUI\TBL_MODE_ADMINISTRATION, and ilAssQuestionHintsTableGUI\TBL_MODE_TESTOUTPUT.

         {
                 global $ilCtrl, $tpl, $lng;
                 
                 $this->initHintOrderingClipboardNotification();
                 
                 require_once 'Services/UIComponent/Toolbar/classes/class.ilToolbarGUI.php';
                 require_once 'Modules/TestQuestionPool/classes/class.ilAssQuestionHintsTableGUI.php';
 
                 $toolbar = new ilToolbarGUI();
 
                 $questionHintList = ilAssQuestionHintList::getListByQuestionId( $this->questionOBJ->getId() );
 
                 if( $this->isEditingEnabled() )
                 {
                         if( $this->hintOrderingClipboard->hasStored() )
                         {
                                 $questionHintList = $this->getQuestionHintListWithoutHintStoredInOrderingClipboard($questionHintList);
                                 
                                 $toolbar->addButton(
                                         $lng->txt('tst_questions_hints_toolbar_cmd_reset_ordering_clipboard'),
                                         $ilCtrl->getLinkTarget($this, self::CMD_RESET_ORDERING_CLIPBOARD)
                                 );
                         }
                         else
                         {
                                 $toolbar->addButton(
                                         $lng->txt('tst_questions_hints_toolbar_cmd_add_hint'),
                                         $ilCtrl->getLinkTargetByClass('ilAssQuestionHintGUI', ilAssQuestionHintGUI::CMD_SHOW_FORM)
                                 );
                         }
                         
                         $tableMode = ilAssQuestionHintsTableGUI::TBL_MODE_ADMINISTRATION;
                 }
                 else
                 {
                         $tableMode = ilAssQuestionHintsTableGUI::TBL_MODE_TESTOUTPUT;
                 }
                 
                 $table = new ilAssQuestionHintsTableGUI(
                                 $this->questionOBJ, $questionHintList, $this, self::CMD_SHOW_LIST,
                                 $tableMode, $this->hintOrderingClipboard
                 );
 
                 $tpl->setContent( $ilCtrl->getHtml($toolbar) . $ilCtrl->getHtml($table) );
         }