Class for cloze tests. More...

Inheritance diagram for assClozeTest:

Collaboration diagram for assClozeTest:

Public Member Functions
	__construct (string $title="", string $comment="", string $author="", int $owner=-1, string $question="")

	isComplete ()
	Returns TRUE, if a cloze test is complete for use. More...

	cleanQuestiontext ($text)
	Cleans cloze question text to remove attributes or tags from older ILIAS versions. More...

	replaceFirstGap (string $gaptext, string $content)

	loadFromDb (int $question_id)

	saveToDb (?int $original_id=null)

	saveAnswerSpecificDataToDb ()
	Saves the answer specific records into a question types answer table. More...

	saveAdditionalQuestionDataToDb ()
	Saves a record to the question types additional data table. More...

	getGaps ()

	flushGaps ()

	setClozeText (string $cloze_text='')

	setClozeTextValue ($cloze_text="")

	getClozeText ()
	Returns the cloze text. More...

	getClozeTextForHTMLOutput ()
	Returns the cloze text as HTML (with optional nl2br) Fix for Mantis 29987: We assume Tiny embeds any text in tags, so if no tags are present, we derive it's non-HTML content and apply nl2br. More...

	getStartTag ()
	Returns the start tag of a cloze gap. More...

	setStartTag ($start_tag="[gap]")
	Sets the start tag of a cloze gap. More...

	getEndTag ()
	Returns the end tag of a cloze gap. More...

	setEndTag ($end_tag="[/gap]")
	Sets the end tag of a cloze gap. More...

	getFeedbackMode ()

	setFeedbackMode ($feedbackMode)

	createGapsFromQuestiontext ()
	Create gap entries by parsing the question text. More...

	setGapType ($gap_index, $gap_type)
	Set the type of a gap with a given index. More...

	setGapShuffle ($gap_index=0, $shuffle=1)
	Sets the shuffle state of a gap with a given index. More...

	clearGapAnswers ()
	Removes all answers from the gaps. More...

	getGapCount ()
	Returns the number of gaps. More...

	addGapAnswer ($gap_index, $order, $answer)
	Sets the answer text of a gap with a given index. More...

	getGap (int $gap_index=0)

	setGapSize ($gap_index, $size)

	setGapAnswerPoints ($gap_index, $order, $points)
	Sets the points of a gap with a given index and an answer with a given order. More...

	addGapText ($gap_index)
	Adds a new answer text value to a text gap with a given index. More...

	addGapAtIndex ($gap, $index)
	Adds a ClozeGap object at a given index. More...

	setGapAnswerLowerBound ($gap_index, $order, $bound)
	Sets the lower bound of a gap with a given index and an answer with a given order. More...

	setGapAnswerUpperBound ($gap_index, $order, $bound)
	Sets the upper bound of a gap with a given index and an answer with a given order. More...

	getMaximumPoints ()
	Returns the maximum points, a learner can reach answering the question. More...

	cloneQuestionTypeSpecificProperties (\assQuestion $target)

	updateClozeTextFromGaps ()
	Updates the gap parameters in the cloze text from the form input. More...

	deleteAnswerText ($gap_index, $answer_index)
	Deletes the answer text of a gap with a given index and an answer with a given order. More...

	deleteGap ($gap_index)
	Deletes a gap with a given index. More...

	getTextgapPoints ($a_original, $a_entered, $max_points)
	Returns the points for a text gap and compares the given solution with the entered solution using the text gap rating options. More...

	getNumericgapPoints ($a_original, $a_entered, $max_points, $lowerBound, $upperBound)
	Returns the points for a text gap and compares the given solution with the entered solution using the text gap rating options. More...

	checkForValidFormula (string $value)

	calculateReachedPoints (int $active_id, ?int $pass=null, bool $authorized_solution=true)

	getUserResultDetails (int $active_id, ?int $pass=null, bool $authorized_solution=true)

	fetchSolutionSubmit ()

	saveWorkingData (int $active_id, ?int $pass=null, bool $authorized=true)

	getQuestionType ()
	Returns the question type of the question. More...

	getTextgapRating ()
	Returns the rating option for text gaps. More...

	setTextgapRating ($a_textgap_rating)
	Sets the rating option for text gaps. More...

	getIdenticalScoring ()
	Returns the identical scoring status of the question. More...

	setIdenticalScoring (bool $identical_scoring)
	Sets the identical scoring option for cloze questions. More...

	getAdditionalTableName ()
	Returns the name of the additional question data table in the database. More...

	getAnswerTableName ()

	setFixedTextLength (?int $fixed_text_length)
	Sets a fixed text length for all text fields in the cloze question. More...

	getFixedTextLength ()
	Gets the fixed text length for all text fields in the cloze question. More...

	getMaximumGapPoints ($gap_index)
	Returns the maximum points for a gap. More...

	getRTETextWithMediaObjects ()
	Collects all text in the question which could contain media objects which were created with the Rich Text Editor. More...

	getGapCombinationsExists ()

	getGapCombinations ()

	setGapCombinationsExists ($value)

	setGapCombinations ($value)

	toJSON ()
	Returns a JSON representation of the question. More...

	getOperators (string $expression)
	Get all available operations for a specific question. More...

	getExpressionTypes ()
	Get all available expression types for a specific question. More...

	getUserQuestionResult (int $active_id, int $pass)
	Get the user solution for a question by active_id and the test pass. More...

	getAvailableAnswerOptions ($index=null)
	If index is null, the function returns an array with all anwser options Else it returns the specific answer option. More...

	calculateCombinationResult ($user_result)

	calculateReachedPointsFromPreviewSession (ilAssQuestionPreviewSession $preview_session)

	fetchAnswerValueForGap ($userSolution, $gapIndex)

	isAddableAnswerOptionValue (int $qIndex, string $answerOptionValue)

	addAnswerOptionValue (int $qIndex, string $answerOptionValue, float $points)

	toLog (AdditionalInformationGenerator $additional_info)

	solutionValuesToText (array $solution_values)

	getCorrectSolutionForTextOutput (int $active_id, int $pass)

Public Member Functions inherited from assQuestion
	getQuestionType ()

	isComplete ()

	saveWorkingData (int $active_id, ?int $pass=null, bool $authorized=true)

	calculateReachedPoints (int $active_id, ?int $pass=null, bool $authorized_solution=true)

	getAdditionalTableName ()

	getAnswerTableName ()

	toLog (AdditionalInformationGenerator $additional_info)
	MUST return an array of the question settings that can be stored in the log. More...

	getCurrentUser ()

	getShuffler ()

	setShuffler (Transformation $shuffler)

	setProcessLocker (ilAssQuestionProcessLocker $processLocker)

	getProcessLocker ()

	fromXML (string $importdirectory, int $user_id, ilQTIItem $item, int $questionpool_id, ?int $tst_id, ?ilObject &$tst_object, int &$question_counter, array $import_mapping, array $solutionhints=[])

	toXML (bool $a_include_header=true, bool $a_include_binary=true, bool $a_shuffle=false, bool $test_output=false, bool $force_image_references=false)
	Returns a QTI xml representation of the question. More...

	setTitle (string $title="")

	setId (int $id=-1)

	setTestId (int $id=-1)

	setComment (string $comment="")

	setShuffle (?bool $shuffle=true)

	setAuthor (string $author="")

	setOwner (int $owner=-1)

	getTitle ()

	getTitleForHTMLOutput ()

	getTitleFilenameCompliant ()

	getId ()

	getShuffle ()

	getTestId ()

	getComment ()

	getDescriptionForHTMLOutput ()

	getThumbSize ()

	setThumbSize (int $a_size)

	getMinimumThumbSize ()

	getMaximumThumbSize ()

	getAuthor ()

	getAuthorForHTMLOutput ()

	getOwner ()

	getObjId ()

	setObjId (int $obj_id=0)

	getLifecycle ()

	setLifecycle (ilAssQuestionLifecycle $lifecycle)

	setExternalId (?string $external_id)

	getExternalId ()

	getSuggestedSolutionOutput ()

	getSuggestedSolutions ()

	getReachedPoints (int $active_id, int $pass)

	getMaximumPoints ()

	getAdjustedReachedPoints (int $active_id, int $pass, bool $authorized_solution=true)

	calculateResultsFromSolution (int $active_id, int $pass)
	Calculates the question results from a previously saved question solution. More...

	persistWorkingState (int $active_id, $pass, bool $authorized=true)
	persists the working state for current testactive and testpass More...

	persistPreviewState (ilAssQuestionPreviewSession $preview_session)
	persists the preview state for current user and question More...

	validateSolutionSubmit ()

	getSuggestedSolutionPath ()

	getImagePath ($question_id=null, $object_id=null)
	Returns the image path for web accessable images of a question. More...

	getSuggestedSolutionPathWeb ()

	getImagePathWeb ()
	Returns the web image path for web accessable images of a question. More...

	getTestOutputSolutions (int $activeId, int $pass)

	getUserSolutionPreferingIntermediate (int $active_id, ?int $pass=null)

	getSolutionValues (int $active_id, ?int $pass=null, bool $authorized=true)
	Loads solutions of a given user from the database an returns it. More...

	deleteAnswers (int $question_id)

	deleteAdditionalTableData (int $question_id)

	delete (int $question_id)

	getTotalAnswers ()

	cloneXHTMLMediaObjectsOfQuestion (int $source_question_id)

	createPageObject ()

	clonePageOfQuestion (int $a_q_id)

	getPageOfQuestion ()

	setOriginalId (?int $original_id)

	getOriginalId ()

static	fixSvgToPng (string $imageFilenameContainingString)

	fixUnavailableSkinImageSources (string $html)

	loadFromDb (int $question_id)

	createNewQuestion (bool $a_create_page=true)
	Creates a new question without an owner when a new question is created This assures that an ID is given to the question if a file upload or something else occurs. More...

	saveQuestionDataToDb (?int $original_id=null)

	duplicate (bool $for_test=true, string $title='', string $author='', int $owner=-1, $test_obj_id=null)

	copyObject (int $target_parent_id, string $title='')

	createNewOriginalFromThisDuplicate (int $target_parent_id, string $target_question_title='')

	saveToDb (?int $original_id=null)

	deleteSuggestedSolutions ()

	getSuggestedSolution (int $subquestion_index=0)

	resolveInternalLink (string $internal_link)

	resolveSuggestedSolutionLinks ()

	getInternalLinkHref (string $target)

	syncWithOriginal ()

	getPoints ()

	setPoints (float $points)

	getSolutionMaxPass (int $active_id)

	isWriteable ()

	deductHintPointsFromReachedPoints (ilAssQuestionPreviewSession $preview_session, $reached_points)

	calculateReachedPointsFromPreviewSession (ilAssQuestionPreviewSession $preview_session)

	isPreviewSolutionCorrect (ilAssQuestionPreviewSession $preview_session)

	adjustReachedPointsByScoringOptions (float $points, int $active_id)
	Adjust the given reached points by checks for all special scoring options in the test container. More...

	buildHashedImageFilename (string $plain_image_filename, bool $unique=false)

	getQuestion ()

	getQuestionForHTMLOutput ()

	setQuestion (string $question="")

	getQuestionTypeID ()

	cloneHints (int $source_question_id, int $target_question_id)

	cleanupMediaObjectUsage ()

	getInstances ()

	getActiveUserData (int $active_id)
	Returns the user id and the test id for a given active id. More...

	hasSpecificFeedback ()

	getNrOfTries ()

	setNrOfTries (int $a_nr_of_tries)

	setExportImagePath (string $path)

	formatSAQuestion ($a_q)

	setPreventRteUsage (bool $prevent_rte_usage)

	getPreventRteUsage ()

	migrateContentForLearningModule (ilAssSelfAssessmentMigrator $migrator)

	setSelfAssessmentEditingMode (bool $selfassessmenteditingmode)

	getSelfAssessmentEditingMode ()

	setDefaultNrOfTries (int $defaultnroftries)

	getDefaultNrOfTries ()

	syncSkillAssignments (int $srcParentId, int $srcQuestionId, int $trgParentId, int $trgQuestionId)

	ensureHintPageObjectExists ($pageObjectId)

	isAnswered (int $active_id, int $pass)

	getAdditionalContentEditingMode ()

	setAdditionalContentEditingMode (?string $additionalContentEditingMode)

	isAdditionalContentEditingModePageObject ()

	isValidAdditionalContentEditingMode (string $additionalContentEditingMode)

	getValidAdditionalContentEditingModes ()

	getHtmlUserSolutionPurifier ()

	getHtmlQuestionContentPurifier ()

	setLastChange (int $lastChange)

	getLastChange ()

	removeIntermediateSolution (int $active_id, int $pass)

	removeCurrentSolution (int $active_id, int $pass, bool $authorized=true)

	saveCurrentSolution (int $active_id, int $pass, $value1, $value2, bool $authorized=true, $tstamp=0)

	updateCurrentSolution (int $solutionId, $value1, $value2, bool $authorized=true)

	updateCurrentSolutionsAuthorization (int $activeId, int $pass, bool $authorized, bool $keepTime=false)

	setStep ($step)

	getStep ()

	toJSON ()

	intermediateSolutionExists (int $active_id, int $pass)

	authorizedSolutionExists (int $active_id, ?int $pass)

	authorizedOrIntermediateSolutionExists (int $active_id, int $pass)

	lookupForExistingSolutions (int $activeId, int $pass)
	Lookup if an authorized or intermediate solution exists. More...

	isAddableAnswerOptionValue (int $qIndex, string $answerOptionValue)

	addAnswerOptionValue (int $qIndex, string $answerOptionValue, float $points)

	removeAllExistingSolutions ()

	removeExistingSolutions (int $activeId, int $pass)

	resetUsersAnswer (int $activeId, int $pass)

	removeResultRecord (int $activeId, int $pass)

	fetchValuePairsFromIndexedValues (array $indexedValues)

	fetchIndexedValuesFromValuePairs (array $value_pairs)

	updateTimestamp ()

	getTestPresentationConfig ()

	hasWritableOriginalInQuestionPool ()

	answerToParticipantInteraction (AdditionalInformationGenerator $additional_info, int $test_ref_id, int $active_id, int $pass, string $source_ip, TestParticipantInteractionTypes $interaction_type)

	toQuestionAdministrationInteraction (AdditionalInformationGenerator $additional_info, int $test_ref_id, TestQuestionAdministrationInteractionTypes $interaction_type)

	getSolutionForTextOutput (int $active_id, int $pass)

	getCorrectSolutionForTextOutput (int $active_id, int $pass)

	getVariablesAsTextArray (int $active_id, int $pass)

Public Member Functions inherited from iQuestionCondition
	getAvailableAnswerOptions (?int $index=null)
	If index is null, the function returns an array with all anwser options else it returns the specific answer option. More...

Data Fields
array	$gaps = []

string	$textgap_rating = assClozeGap::TEXTGAP_RATING_CASEINSENSITIVE
	The rating option for text gaps. More...

ilAssQuestionFeedback	$feedbackOBJ

Data Fields inherited from assQuestion
const	ADDITIONAL_CONTENT_EDITING_MODE_RTE = 'default'

const	ADDITIONAL_CONTENT_EDITING_MODE_IPE = 'pageobject'

const	TRIM_PATTERN = '/^[\p{C}\p{Z}]+\|[\p{C}\p{Z}]+$/u'

ilAssQuestionFeedback	$feedbackOBJ

bool	$prevent_rte_usage = false

bool	$selfassessmenteditingmode = false

int	$defaultnroftries = 0

string	$questionActionCmd = 'handleQuestionAction'

const	KEY_VALUES_IMPLOSION_SEPARATOR = ':'

Data Fields inherited from iQuestionCondition
const	StringResultExpression = '~TEXT~'

const	PercentageResultExpression = '%n%'

const	NumericResultExpression = '#n#'

const	MatchingResultExpression = ';n:m;'

const	OrderingResultExpression = '$n,m,o,p$'

const	NumberOfResultExpression = '+n+'

const	ExclusiveResultExpression = 'n,m,o,p'

const	EmptyAnswerExpression = "?"

Protected Member Functions
	saveClozeGapItemsToDb (assClozeGap $gap, int $key)

	saveClozeTextGapRecordToDb (int $next_id, int $key, assAnswerCloze $item, assClozeGap $gap)

	saveClozeSelectGapRecordToDb (int $next_id, int $key, assAnswerCloze $item, assClozeGap $gap)

	saveClozeNumericGapRecordToDb (int $next_id, int $key, assAnswerCloze $item, assClozeGap $gap)

	isValidNumericSubmitValue ($submittedValue)

	getSolutionSubmit ()

	lmMigrateQuestionTypeSpecificContent (ilAssSelfAssessmentMigrator $migrator)

	calculateReachedPointsForSolution (?array $user_result, array &$detailed=[])

	solutionValuesToLog (AdditionalInformationGenerator $additional_info, array $solution_values)

Protected Member Functions inherited from assQuestion
	solutionValuesToLog (AdditionalInformationGenerator $additional_info, array $solution_values)
	MUST convert the given solution values into an array or a string that can be stored in the log. More...

	solutionValuesToText (array $solution_values)
	MUST convert the given solution values into text. More...

	getQuestionAction ()

	isNonEmptyItemListPostSubmission (string $post_submission_field_name)

	savePreviewData (ilAssQuestionPreviewSession $preview_session)

	deletePageOfQuestion (int $question_id)

	cloneQuestionTypeSpecificProperties (self $target)

	removeAllImageFiles (string $image_target_path)

	onDuplicate (int $original_parent_id, int $original_question_id, int $duplicate_parent_id, int $duplicate_question_id)

	afterSyncWithOriginal (int $original_question_id, int $clone_question_id, int $original_parent_id, int $clone_parent_id)

	onCopy (int $sourceParentId, int $sourceQuestionId, int $targetParentId, int $targetQuestionId)

	duplicateComments (int $parent_source_id, int $source_id, int $parent_target_id, int $target_id)

	deleteComments ()

	getNotesManager ()

	getNotesDataService ()

	getNotesRepo ()

	cloneSuggestedSolutions (int $source_question_id, int $target_question_id)

	duplicateSuggestedSolutionFiles (int $parent_id, int $question_id)
	Duplicates the files of a suggested solution if the question is duplicated. More...

	cloneSuggestedSolutionFiles (int $source_question_id, int $target_question_id)

	copySuggestedSolutions (int $target_question_id)

	ensureNonNegativePoints (float $points)

	purifyAndPrepareTextAreaOutput (string $content)

	getRTETextWithMediaObjects ()

	getSelfAssessmentFormatter ()

	lmMigrateQuestionTypeGenericContent (ilAssSelfAssessmentMigrator $migrator)

	lmMigrateQuestionTypeSpecificContent (ilAssSelfAssessmentMigrator $migrator)

	duplicateQuestionHints (int $original_question_id, int $duplicate_question_id)

	duplicateSkillAssignments (int $srcParentId, int $srcQuestionId, int $trgParentId, int $trgQuestionId)

	buildQuestionDataQuery ()

	getCurrentSolutionResultSet (int $active_id, int $pass, bool $authorized=true)

	removeSolutionRecordById (int $solutionId)

	getSolutionRecordById (int $solutionId)

	deleteDummySolutionRecord (int $activeId, int $passIndex)

	isDummySolutionRecord (array $solutionRecord)

	deleteSolutionRecordByValues (int $activeId, int $passIndex, bool $authorized, array $matchValues)

	duplicateIntermediateSolutionAuthorized (int $activeId, int $passIndex)

	forceExistingIntermediateSolution (int $activeId, int $passIndex, bool $considerDummyRecordCreation)

	lookupMaxStep (int $active_id, int $pass)

	buildTestPresentationConfig ()

	getSuggestedSolutionsRepo ()

	loadSuggestedSolutions ()

	answerToLog (AdditionalInformationGenerator $additional_info, int $active_id, int $pass)

Protected Attributes
	$gap_combinations = []

bool	$gap_combinations_exist = false

bool	$identical_scoring = true
	Defines the scoring for "identical solutions". More...

int	$fixed_text_length = null

string	$cloze_text = ''

	$feedbackMode = ilAssClozeTestFeedback::FB_MODE_GAP_QUESTION

Protected Attributes inherited from assQuestion
const	HAS_SPECIFIC_FEEDBACK = true

GeneralQuestionPropertiesRepository	$questionrepository

RequestDataCollector	$questionpool_request

QuestionFiles	$question_files

ilAssQuestionProcessLocker	$processLocker

ilTestQuestionConfig	$testQuestionConfig

SuggestedSolutionsDatabaseRepository	$suggestedsolution_repo

ILIAS	$ilias

ilGlobalPageTemplate	$tpl

ilLanguage	$lng

ilDBInterface	$db

ilObjUser	$current_user

SkillUsageService	$skillUsageService

HTTPServices	$http

Refinery	$refinery

Transformation	$shuffler

LoggingServices	$log

Container	$dic

ilAssQuestionLifecycle	$lifecycle

ilAssQuestionPage	$page

int	$id

string	$title

string	$comment

int	$owner

string	$author

int	$thumb_size

string	$question

float	$points = 0.0

bool	$shuffle = true

int	$test_id

int	$obj_id = 0

int	$original_id = null

int	$lastChange = null

string	$external_id = null

int	$step = null

array	$suggested_solutions

Private Member Functions
	fetchUserResult (int $active_id, ?int $pass)

Private Attributes
string	$start_tag = '[gap]'

string	$end_tag = '[/gap]'

RandomGroup	$randomGroup

Additional Inherited Members
Static Public Member Functions inherited from assQuestion
static	setForcePassResultUpdateEnabled (bool $force_pass_results_update_enabled)

static	isForcePassResultUpdateEnabled ()

static	_getSuggestedSolutionOutput (int $question_id)

static	_getReachedPoints (int $active_id, int $question_id, int $pass)

static	isFileAvailable (string $file)

static	saveOriginalId (int $questionId, int $originalId)

static	resetOriginalId (int $questionId)

static	instantiateQuestion (int $question_id)

static	_getSolutionMaxPass (int $question_id, int $active_id)
	Returns the maximum pass a users question solution. More...

static	_setReachedPoints (int $active_id, int $question_id, float $points, float $maxpoints, int $pass, bool $manualscoring)
	Sets the points, a learner has reached answering the question Additionally objective results are updated. More...

static	getFeedbackClassNameByQuestionType (string $questionType)

static	_questionExistsInTest (int $question_id, int $test_id)

static	lookupParentObjId (int $question_id)

static	implodeKeyValues (array $keyValues)

static	explodeKeyValues (string $keyValues)

static	convertISO8601FormatH_i_s_ExtendedToSeconds (string $time)

static	extendedTrim (string $value)
	Trim non-printable characters from the beginning and end of a string. More...

Static Protected Member Functions inherited from assQuestion
static	getNumExistingSolutionRecords (int $activeId, int $pass, int $questionId)

Static Protected Attributes inherited from assQuestion
static	$force_pass_results_update_enabled = false

static	$imageSourceFixReplaceMap

Detailed Description

Class for cloze tests.

Author: Helmut Schottmüller helmu.nosp@m.t.sc.nosp@m.hottm.nosp@m.uell.nosp@m.er@ma.nosp@m.c.co.nosp@m.m; Björn Heyser bheys.nosp@m.er@d.nosp@m.ataba.nosp@m.y.de; Maximilian Becker mbeck.nosp@m.er@d.nosp@m.ataba.nosp@m.y.de

Version: $Id$

Definition at line 38 of file class.assClozeTest.php.

Constructor & Destructor Documentation

◆ __construct()

assClozeTest::__construct	(	string	$title = `""`,
		string	$comment = `""`,
		string	$author = `""`,
		int	$owner = `-1`,
		string	$question = `""`
	)

Definition at line 82 of file class.assClozeTest.php.

References assQuestion\$author, assQuestion\$comment, $DIC, assQuestion\$owner, assQuestion\$question, assQuestion\$title, ILIAS\GlobalScreen\Provider\__construct(), and assQuestion\setQuestion().

       {
         global $DIC;
         parent::__construct($title, $comment, $author, $owner, $question);
         $this->setQuestion($question); // @TODO: Should this be $question?? See setter for why this is not trivial.
         $this->randomGroup = $DIC->refinery()->random();
     }

Here is the call graph for this function:

Member Function Documentation

◆ addAnswerOptionValue()

assClozeTest::addAnswerOptionValue	(	int	$qIndex,
		string	$answerOptionValue,
		float	$points
	)

Definition at line 1615 of file class.assClozeTest.php.

References getGap().

                                                                                                : void
     {
         $gap = $this->getGap($qIndex); /* @var assClozeGap $gap */
 
         $item = new assAnswerCloze($answerOptionValue, $points);
         $item->setOrder($gap->getItemCount());
 
         $gap->addItem($item);
     }

Here is the call graph for this function:

◆ addGapAnswer()

assClozeTest::addGapAnswer	(	$gap_index,
		$order,
		$answer
	)

Sets the answer text of a gap with a given index.

The index of the first gap is 0, the index of the second gap is 1 and so on.

Parameters

integer	$gap_index	A nonnegative index of the n-th gap
integer	$order	The order of the answer text
string	$answer	The answer text public

See also: $gaps

Definition at line 626 of file class.assClozeTest.php.

References assClozeGap\TYPE_NUMERIC.

                                                              : void
     {
         if (array_key_exists($gap_index, $this->gaps)) {
             if ($this->gaps[$gap_index]->getType() == assClozeGap::TYPE_NUMERIC) {
                 // only allow notation with "." for real numbers
                 $answer = str_replace(",", ".", $answer);
             }
             $this->gaps[$gap_index]->addItem(new assAnswerCloze(trim($answer), 0, $order));
         }
     }

◆ addGapAtIndex()

assClozeTest::addGapAtIndex	(	$gap,
		$index
	)

Adds a ClozeGap object at a given index.

Parameters

object	$gap	The gap object
integer	$index	A nonnegative index of the n-th gap public

See also: $gaps

Definition at line 697 of file class.assClozeTest.php.

                                                : void
     {
         $this->gaps[$index] = $gap;
     }

◆ addGapText()

assClozeTest::addGapText ( $gap_index )

Adds a new answer text value to a text gap with a given index.

The index of the first gap is 0, the index of the second gap is 1 and so on.

Parameters

integer $gap_index A nonnegative index of the n-th gap public

See also: $gaps

Definition at line 677 of file class.assClozeTest.php.

                                           : void
     {
         if (array_key_exists($gap_index, $this->gaps)) {
             $answer = new assAnswerCloze(
                 "",
                 0,
                 $this->gaps[$gap_index]->getItemCount()
             );
             $this->gaps[$gap_index]->addItem($answer);
         }
     }

◆ calculateCombinationResult()

assClozeTest::calculateCombinationResult ( $user_result )

Definition at line 1399 of file class.assClozeTest.php.

References assQuestion\$points, assQuestion\getId(), getNumericgapPoints(), getTextgapPoints(), assClozeGap\TYPE_NUMERIC, assClozeGap\TYPE_SELECT, and assClozeGap\TYPE_TEXT.

Referenced by calculateReachedPointsForSolution().

                                                             : array
     {
         $points = 0;
 
         $assClozeGapCombinationObj = new assClozeGapCombination($this->db);
         $gap_used_in_combination = [];
         if ($assClozeGapCombinationObj->combinationExistsForQid($this->getId())) {
             $combinations_for_question = $assClozeGapCombinationObj->getCleanCombinationArray($this->getId());
             $gap_answers = [];
 
             foreach ($user_result as $user_result_build_list) {
                 if (is_array($user_result_build_list)) {
                     $gap_answers[$user_result_build_list['gap_id']] = $user_result_build_list['value'];
                 }
             }
 
             foreach ($combinations_for_question as $combination) {
                 foreach ($combination as $row_key => $row_answers) {
                     $combination_fulfilled = true;
                     $points_for_combination = $row_answers['points'];
                     foreach ($row_answers as $gap_key => $combination_gap_answer) {
                         if ($gap_key !== 'points') {
                             $gap_used_in_combination[$gap_key] = $gap_key;
                         }
                         if ($combination_fulfilled && array_key_exists($gap_key, $gap_answers)) {
                             switch ($combination_gap_answer['type']) {
                                 case assClozeGap::TYPE_TEXT:
                                     $is_text_gap_correct = $this->getTextgapPoints($gap_answers[$gap_key], $combination_gap_answer['answer'], 1);
                                     if ($is_text_gap_correct != 1) {
                                         $combination_fulfilled = false;
                                     }
                                     break;
                                 case assClozeGap::TYPE_SELECT:
                                     $answer = $this->gaps[$gap_key]->getItem($gap_answers[$gap_key]);
                                     $answertext = $answer?->getAnswertext();
                                     if ($answertext != $combination_gap_answer['answer']) {
                                         $combination_fulfilled = false;
                                     }
                                     break;
                                 case assClozeGap::TYPE_NUMERIC:
                                     $answer = $this->gaps[$gap_key]->getItem(0);
                                     if ($combination_gap_answer['answer'] != 'out_of_bound') {
                                         $is_numeric_gap_correct = $this->getNumericgapPoints($answer->getAnswertext(), $gap_answers[$gap_key], 1, $answer->getLowerBound(), $answer->getUpperBound());
                                         if ($is_numeric_gap_correct != 1) {
                                             $combination_fulfilled = false;
                                         }
                                     } else {
                                         $wrong_is_the_new_right = $this->getNumericgapPoints($answer->getAnswertext(), $gap_answers[$gap_key], 1, $answer->getLowerBound(), $answer->getUpperBound());
                                         if ($wrong_is_the_new_right == 1) {
                                             $combination_fulfilled = false;
                                         }
                                     }
                                     break;
                             }
                         } else {
                             if ($gap_key !== 'points') {
                                 $combination_fulfilled = false;
                             }
                         }
                     }
                     if ($combination_fulfilled) {
                         $points += $points_for_combination;
                     }
                 }
             }
         }
         return [$points, $gap_used_in_combination];
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ calculateReachedPoints()

assClozeTest::calculateReachedPoints	(	int	$active_id,
		?int	$pass = `null`,
		bool	$authorized_solution = `true`
	)

Definition at line 968 of file class.assClozeTest.php.

References calculateReachedPointsForSolution(), and fetchUserResult().

Referenced by getUserQuestionResult().

      : float {
         $user_result = $this->fetchUserResult($active_id, $pass, $authorized_solution);
         return $this->calculateReachedPointsForSolution($user_result);
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ calculateReachedPointsForSolution()

assClozeTest::calculateReachedPointsForSolution	(	?array	$user_result,
		array &	$detailed = `[]`
	)

protected

Parameters

array	$user_result
array	$detailed

Definition at line 1471 of file class.assClozeTest.php.

References assQuestion\$points, calculateCombinationResult(), getIdenticalScoring(), getMaximumGapPoints(), getNumericgapPoints(), getTextgapPoints(), assClozeGap\TYPE_NUMERIC, assClozeGap\TYPE_SELECT, and assClozeGap\TYPE_TEXT.

Referenced by calculateReachedPoints(), calculateReachedPointsFromPreviewSession(), and getUserResultDetails().

                                                                                                     : float
     {
         $points = 0.0;
 
         $assClozeGapCombinationObj = new assClozeGapCombination($this->db);
         $combinations[1] = [];
         if ($this->gap_combinations_exist) {
             $combinations = $this->calculateCombinationResult($user_result);
             $points = $combinations[0];
         }
 
         $solution_values_text = []; // for identical scoring checks
         $solution_values_select = []; // for identical scoring checks
         $solution_values_numeric = []; // for identical scoring checks
         foreach ($user_result as $gap_id => $value) {
             if (is_string($value)) {
                 $value = ["value" => $value];
             }
 
             if (array_key_exists($gap_id, $this->gaps) && !array_key_exists($gap_id, $combinations[1])) {
                 switch ($this->gaps[$gap_id]->getType()) {
                     case assClozeGap::TYPE_TEXT:
                         $gappoints = 0.0;
                         for ($order = 0; $order < $this->gaps[$gap_id]->getItemCount(); $order++) {
                             $answer = $this->gaps[$gap_id]->getItem($order);
                             $gotpoints = $this->getTextgapPoints($answer->getAnswertext(), $value["value"], $answer->getPoints());
                             if ($gotpoints > $gappoints) {
                                 $gappoints = $gotpoints;
                             }
                         }
                         if (!$this->getIdenticalScoring()) {
                             // check if the same solution text was already entered
                             if ((in_array($value["value"], $solution_values_text)) && ($gappoints > 0.0)) {
                                 $gappoints = 0.0;
                             }
                         }
                         $points += $gappoints;
                         $detailed[$gap_id] = ["points" => $gappoints, "best" => ($this->getMaximumGapPoints($gap_id) == $gappoints) ? true : false, "positive" => ($gappoints > 0.0) ? true : false];
                         array_push($solution_values_text, $value["value"]);
                         break;
                     case assClozeGap::TYPE_NUMERIC:
                         $gappoints = 0.0;
                         for ($order = 0; $order < $this->gaps[$gap_id]->getItemCount(); $order++) {
                             $answer = $this->gaps[$gap_id]->getItem($order);
                             $gotpoints = $this->getNumericgapPoints($answer->getAnswertext(), $value["value"], $answer->getPoints(), $answer->getLowerBound(), $answer->getUpperBound());
                             if ($gotpoints > $gappoints) {
                                 $gappoints = $gotpoints;
                             }
                         }
                         if (!$this->getIdenticalScoring()) {
                             // check if the same solution value was already entered
                             $eval = new EvalMath();
                             $eval->suppress_errors = true;
                             $found_value = false;
                             foreach ($solution_values_numeric as $solval) {
                                 if ($eval->e($solval) == $eval->e($value["value"])) {
                                     $found_value = true;
                                 }
                             }
                             if ($found_value && ($gappoints > 0.0)) {
                                 $gappoints = 0.0;
                             }
                         }
                         $points += $gappoints;
                         $detailed[$gap_id] = ["points" => $gappoints, "best" => ($this->getMaximumGapPoints($gap_id) == $gappoints) ? true : false, "positive" => ($gappoints > 0.0) ? true : false];
                         array_push($solution_values_numeric, $value["value"]);
                         break;
                     case assClozeGap::TYPE_SELECT:
                         if ($value["value"] >= 0.0) {
                             for ($order = 0; $order < $this->gaps[$gap_id]->getItemCount(); $order++) {
                                 $answer = $this->gaps[$gap_id]->getItem($order);
                                 if ($value["value"] == $answer->getOrder()) {
                                     $answerpoints = $answer->getPoints();
                                     if (!$this->getIdenticalScoring()) {
                                         // check if the same solution value was already entered
                                         if ((in_array($answer->getAnswertext(), $solution_values_select)) && ($answerpoints > 0.0)) {
                                             $answerpoints = 0.0;
                                         }
                                     }
                                     $points += $answerpoints;
                                     $detailed[$gap_id] = ["points" => $answerpoints, "best" => ($this->getMaximumGapPoints($gap_id) == $answerpoints) ? true : false, "positive" => ($answerpoints > 0.0) ? true : false];
                                     array_push($solution_values_select, $answer->getAnswertext());
                                 }
                             }
                         }
                         break;
                 }
             }
         }
 
         return $points;
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ calculateReachedPointsFromPreviewSession()

assClozeTest::calculateReachedPointsFromPreviewSession ( ilAssQuestionPreviewSession $preview_session )

Definition at line 1564 of file class.assClozeTest.php.

References calculateReachedPointsForSolution(), assQuestion\deductHintPointsFromReachedPoints(), assQuestion\ensureNonNegativePoints(), and ilAssQuestionPreviewSession\getParticipantsSolution().

                                                                                                           : float
     {
         $participant_session = $preview_session->getParticipantsSolution();
 
         if (!is_array($participant_session)) {
             return 0.0;
         }
 
         $user_solution = [];
 
         foreach ($participant_session as $key => $val) {
             $user_solution[$key] = ['gap_id' => $key, 'value' => $val];
         }
 
         $reached_points = $this->calculateReachedPointsForSolution($user_solution);
         $reached_points = $this->deductHintPointsFromReachedPoints($preview_session, $reached_points);
 
         return $this->ensureNonNegativePoints($reached_points);
     }

Here is the call graph for this function:

◆ checkForValidFormula()

assClozeTest::checkForValidFormula ( string $value )

Definition at line 963 of file class.assClozeTest.php.

                                                        : int
     {
         return preg_match("/^-?(\\d*)(,|\\.|\\/){0,1}(\\d*)$/", $value, $matches);
     }

◆ cleanQuestiontext()

assClozeTest::cleanQuestiontext ( $text )

Cleans cloze question text to remove attributes or tags from older ILIAS versions.

Parameters

string $text The cloze question text

Returns: string The cleaned cloze question text

Definition at line 119 of file class.assClozeTest.php.

References null.

Referenced by loadFromDb(), and setClozeText().

                                             : string
     {
         if ($text === null) {
             return '';
         }
         // fau: fixGapReplace - mask dollars for replacement
         $text = str_replace('$', 'GAPMASKEDDOLLAR', $text);
         $text = preg_replace("/\[gap[^\]]*?\]/", "[gap]", $text);
         $text = preg_replace("/<gap([^>]*?)>/", "[gap]", $text);
         $text = str_replace("</gap>", "[/gap]", $text);
         $text = str_replace('GAPMASKEDDOLLAR', '$', $text);
         // fau.
         return $text;
     }

Here is the caller graph for this function:

◆ clearGapAnswers()

assClozeTest::clearGapAnswers ( )

Removes all answers from the gaps.

public

See also: $gaps

Definition at line 593 of file class.assClozeTest.php.

                                      : void
     {
         foreach ($this->gaps as $gap_index => $gap) {
             $this->gaps[$gap_index]->clearItems();
         }
     }

◆ cloneQuestionTypeSpecificProperties()

assClozeTest::cloneQuestionTypeSpecificProperties ( \assQuestion $target )

Definition at line 784 of file class.assClozeTest.php.

References $gap_combinations, and assQuestion\getId().

      : \assQuestion {
         if ($this->gap_combinations_exist) {
             $gap_combination = new assClozeGapCombination($this->db);
             $gap_combination->clearGapCombinationsFromDb($target->getId());
             $gap_combination->importGapCombinationToDb(
                 $target->getId(),
                 $this->gap_combinations,
             );
         }
         return $target;
     }

Here is the call graph for this function:

◆ createGapsFromQuestiontext()

assClozeTest::createGapsFromQuestiontext ( )

Create gap entries by parsing the question text.

public

See also: $gaps

Definition at line 540 of file class.assClozeTest.php.

References getClozeText(), and assClozeGap\TYPE_TEXT.

Referenced by setClozeText().

                                                 : void
     {
         $search_pattern = "|\[gap\](.*?)\[/gap\]|i";
         preg_match_all($search_pattern, $this->getClozeText(), $found);
         $this->gaps = [];
         if (count($found[0])) {
             foreach ($found[1] as $gap_index => $answers) {
                 // create text gaps by default
                 $gap = new assClozeGap(assClozeGap::TYPE_TEXT);
                 $textparams = preg_split("/(?<!\\\\),/", $answers);
                 foreach ($textparams as $key => $value) {
                     $answer = new assAnswerCloze($value, 0, $key);
                     $gap->addItem($answer);
                 }
                 $this->gaps[$gap_index] = $gap;
             }
         }
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ deleteAnswerText()

assClozeTest::deleteAnswerText	(	$gap_index,
		$answer_index
	)

Deletes the answer text of a gap with a given index and an answer with a given order.

The index of the first gap is 0, the index of the second gap is 1 and so on.

Parameters

integer	$gap_index	A nonnegative index of the n-th gap
integer	$answer_index	The order of the answer text public

See also: $gaps

Definition at line 828 of file class.assClozeTest.php.

References deleteGap(), and updateClozeTextFromGaps().

                                                                : void
     {
         if (array_key_exists($gap_index, $this->gaps)) {
             if ($this->gaps[$gap_index]->getItemCount() == 1) {
                 // this is the last answer text => remove the gap
                 $this->deleteGap($gap_index);
             } else {
                 // remove the answer text
                 $this->gaps[$gap_index]->deleteItem($answer_index);
                 $this->updateClozeTextFromGaps();
             }
         }
     }

Here is the call graph for this function:

◆ deleteGap()

assClozeTest::deleteGap ( $gap_index )

Deletes a gap with a given index.

The index of the first gap is 0, the index of the second gap is 1 and so on.

Parameters

integer $gap_index A nonnegative index of the n-th gap public

See also: $gaps

Definition at line 850 of file class.assClozeTest.php.

References getClozeText(), getGaps(), and replaceFirstGap().

Referenced by deleteAnswerText().

                                          : void
     {
         if (array_key_exists($gap_index, $this->gaps)) {
             $output = $this->getClozeText();
             foreach ($this->getGaps() as $replace_gap_index => $gap) {
                 $answers = [];
                 foreach ($gap->getItemsRaw() as $item) {
                     array_push($answers, str_replace(",", "\\,", $item->getAnswerText()));
                 }
                 if ($replace_gap_index == $gap_index) {
                     // fau: fixGapReplace - use replace function
                     $output = $this->replaceFirstGap($output, '');
                     // fau.
                 } else {
                     // fau: fixGapReplace - use replace function
                     $output = $this->replaceFirstGap($output, "[_gap]" . join(",", $answers) . "[/_gap]");
                     // fau.
                 }
             }
             $output = str_replace("_gap]", "gap]", $output);
             $this->cloze_text = $output;
             unset($this->gaps[$gap_index]);
             $this->gaps = array_values($this->gaps);
         }
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ fetchAnswerValueForGap()

assClozeTest::fetchAnswerValueForGap	(	$userSolution,
		$gapIndex
	)

Definition at line 1584 of file class.assClozeTest.php.

                                                                     : string
     {
         $answerValue = '';
 
         foreach ($userSolution as $value1 => $value2) {
             if ($value1 == $gapIndex) {
                 $answerValue = $value2;
                 break;
             }
         }
 
         return $answerValue;
     }

◆ fetchSolutionSubmit()

assClozeTest::fetchSolutionSubmit ( )

Definition at line 1025 of file class.assClozeTest.php.

References getGaps(), null, assClozeGap\TYPE_NUMERIC, and assClozeGap\TYPE_SELECT.

Referenced by getSolutionSubmit(), and saveWorkingData().

                                          : array
     {
         $solution_submit = [];
         $post_wrapper = $this->dic->http()->wrapper()->post();
         foreach ($this->getGaps() as $index => $gap) {
             if (!$post_wrapper->has("gap_$index")) {
                 continue;
             }
             $value = trim($post_wrapper->retrieve(
                 "gap_$index",
                 $this->dic->refinery()->kindlyTo()->string()
             ));
             if ($value === '') {
                 continue;
             }
 
             if ($gap->getType() === assClozeGap::TYPE_SELECT && $value === '-1') {
                 continue;
             }
 
             if ($gap->getType() === assClozeGap::TYPE_NUMERIC) {
                 $value = str_replace(',', '.', $value);
                 if (!is_numeric($value)) {
                     $value = null;
                 }
             }
 
             $solution_submit[$index] = $value;
         }
 
         return $solution_submit;
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ fetchUserResult()

assClozeTest::fetchUserResult	(	int	$active_id,
		?int	$pass
	)

private

Definition at line 988 of file class.assClozeTest.php.

References $data, assQuestion\getCurrentSolutionResultSet(), and assQuestion\getSolutionMaxPass().

Referenced by calculateReachedPoints(), and getUserResultDetails().

      : array {
         if (is_null($pass)) {
             $pass = $this->getSolutionMaxPass($active_id);
         }
 
         $result = $this->getCurrentSolutionResultSet($active_id, $pass, true);
         $user_result = [];
         while ($data = $this->db->fetchAssoc($result)) {
             if ($data['value2'] === '') {
                 continue;
             }
             $user_result[$data['value1']] = [
                 'gap_id' => $data['value1'],
                 'value' => $data['value2']
             ];
         }
 
         ksort($user_result);
         return $user_result;
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ flushGaps()

assClozeTest::flushGaps ( )

Definition at line 413 of file class.assClozeTest.php.

                                : void
     {
         $this->gaps = [];
     }

◆ getAdditionalTableName()

assClozeTest::getAdditionalTableName ( )

Returns the name of the additional question data table in the database.

Returns: string The additional table name public

Definition at line 1171 of file class.assClozeTest.php.

Referenced by loadFromDb(), and saveAdditionalQuestionDataToDb().

                                             : string
     {
         return "qpl_qst_cloze";
     }

Here is the caller graph for this function:

◆ getAnswerTableName()

assClozeTest::getAnswerTableName ( )

Definition at line 1176 of file class.assClozeTest.php.

                                         : array
     {
         return ["qpl_a_cloze",'qpl_a_cloze_combi_res'];
     }

◆ getAvailableAnswerOptions()

assClozeTest::getAvailableAnswerOptions ( $index = null )

If index is null, the function returns an array with all anwser options Else it returns the specific answer option.

Parameters

null | int $index

Returns: array|ASS_AnswerSimple

Definition at line 1390 of file class.assClozeTest.php.

References getGap(), getGaps(), and null.

     {
         if ($index !== null) {
             return $this->getGap($index);
         } else {
             return $this->getGaps();
         }
     }

Here is the call graph for this function:

◆ getClozeText()

assClozeTest::getClozeText ( )

Returns the cloze text.

Returns: string The cloze text string public

See also: $cloze_text

Definition at line 437 of file class.assClozeTest.php.

References $cloze_text.

Referenced by createGapsFromQuestiontext(), deleteGap(), getClozeTextForHTMLOutput(), getRTETextWithMediaObjects(), isComplete(), lmMigrateQuestionTypeSpecificContent(), saveAdditionalQuestionDataToDb(), toJSON(), toLog(), and updateClozeTextFromGaps().

                                   : string
     {
         return $this->cloze_text;
     }

Here is the caller graph for this function:

◆ getClozeTextForHTMLOutput()

assClozeTest::getClozeTextForHTMLOutput ( )

Returns the cloze text as HTML (with optional nl2br) Fix for Mantis 29987: We assume Tiny embeds any text in tags, so if no tags are present, we derive it's non-HTML content and apply nl2br.

Returns: string The cloze text string as HTML

See also: $cloze_text

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

References getClozeText(), assQuestion\getHtmlQuestionContentPurifier(), assQuestion\isAdditionalContentEditingModePageObject(), and ilLegacyFormElementsUtil\prepareTextareaOutput().

                                                : string
     {
         $gaps = [];
         preg_match_all('/\[gap\].*?\[\/gap\]/', $this->getClozeText(), $gaps);
         $string_with_replaced_gaps = str_replace($gaps[0], '######GAP######', $this->getClozeText());
         $cleaned_text = $this->getHtmlQuestionContentPurifier()->purify(
             $string_with_replaced_gaps
         );
         $cleaned_text_with_gaps = preg_replace_callback('/######GAP######/', function ($match) use (&$gaps) {
             return array_shift($gaps[0]);
         }, $cleaned_text);
 
         if ($this->isAdditionalContentEditingModePageObject()
             || !(new ilSetting('advanced_editing'))->get('advanced_editing_javascript_editor') === 'tinymce') {
             $cleaned_text_with_gaps = nl2br($cleaned_text_with_gaps);
         }
 
         return ilLegacyFormElementsUtil::prepareTextareaOutput($cleaned_text_with_gaps, true);
     }

Here is the call graph for this function:

◆ getCorrectSolutionForTextOutput()

assClozeTest::getCorrectSolutionForTextOutput	(	int	$active_id,
		int	$pass
	)

Definition at line 1713 of file class.assClozeTest.php.

References getGaps(), and ILIAS\Repository\lng().

                                                                               : array
     {
         $answers = [];
         foreach ($this->getGaps() as $gap_index => $gap) {
             $correct_answers = array_map(
                 fn(int $v): string => $gap->getItem($v)->getAnswertext(),
                 $gap->getBestSolutionIndexes()
             );
             $answers[] = $this->lng->txt('gap') . ' ' . $gap_index + 1 . ': '
                 . implode(',', $correct_answers);
         }
         return $answers;
     }

Here is the call graph for this function:

◆ getEndTag()

assClozeTest::getEndTag ( )

Returns the end tag of a cloze gap.

Returns: string The end tag of a cloze gap public

See also: $end_tag

Definition at line 501 of file class.assClozeTest.php.

References $end_tag.

                                : string
     {
         return $this->end_tag;
     }

◆ getExpressionTypes()

assClozeTest::getExpressionTypes ( )

Get all available expression types for a specific question.

Returns: array

Implements iQuestionCondition.

Definition at line 1323 of file class.assClozeTest.php.

References iQuestionCondition\EmptyAnswerExpression, iQuestionCondition\NumberOfResultExpression, iQuestionCondition\NumericResultExpression, iQuestionCondition\PercentageResultExpression, and iQuestionCondition\StringResultExpression.

                                         : array
     {
         return [
             iQuestionCondition::PercentageResultExpression,
             iQuestionCondition::NumericResultExpression,
             iQuestionCondition::NumberOfResultExpression,
             iQuestionCondition::StringResultExpression,
             iQuestionCondition::EmptyAnswerExpression,
         ];
     }

◆ getFeedbackMode()

assClozeTest::getFeedbackMode ( )

Returns: string

Definition at line 521 of file class.assClozeTest.php.

References $feedbackMode.

Referenced by saveAdditionalQuestionDataToDb().

                                      : string
     {
         return $this->feedbackMode;
     }

Here is the caller graph for this function:

◆ getFixedTextLength()

assClozeTest::getFixedTextLength ( )

Gets the fixed text length for all text fields in the cloze question.

Returns: integer The text field length public

Definition at line 1198 of file class.assClozeTest.php.

References $fixed_text_length.

Referenced by saveAdditionalQuestionDataToDb().

                                         : ?int
     {
         return $this->fixed_text_length;
     }

Here is the caller graph for this function:

◆ getGap()

assClozeTest::getGap ( int $gap_index = 0 )

Definition at line 637 of file class.assClozeTest.php.

References null.

Referenced by addAnswerOptionValue(), getAvailableAnswerOptions(), isAddableAnswerOptionValue(), and saveWorkingData().

                                               : ?assClozeGap
     {
         if (array_key_exists($gap_index, $this->gaps)) {
             return $this->gaps[$gap_index];
         }
         return null;
     }

Here is the caller graph for this function:

◆ getGapCombinations()

assClozeTest::getGapCombinations ( )

Definition at line 1240 of file class.assClozeTest.php.

References $gap_combinations.

                                         : array
     {
         return $this->gap_combinations;
     }

◆ getGapCombinationsExists()

assClozeTest::getGapCombinationsExists ( )

Definition at line 1235 of file class.assClozeTest.php.

References $gap_combinations_exist.

                                               : bool
     {
         return $this->gap_combinations_exist;
     }

◆ getGapCount()

assClozeTest::getGapCount ( )

Returns the number of gaps.

Returns: integer The number of gaps public

See also: $gaps

Definition at line 607 of file class.assClozeTest.php.

                                  : int
     {
         if (is_array($this->gaps)) {
             return count($this->gaps);
         } else {
             return 0;
         }
     }

◆ getGaps()

assClozeTest::getGaps ( )

Definition at line 408 of file class.assClozeTest.php.

References $gaps.

Referenced by deleteGap(), fetchSolutionSubmit(), getAvailableAnswerOptions(), getCorrectSolutionForTextOutput(), isComplete(), solutionValuesToLog(), solutionValuesToText(), toJSON(), toLog(), and updateClozeTextFromGaps().

                              : array
     {
         return $this->gaps;
     }

Here is the caller graph for this function:

◆ getIdenticalScoring()

assClozeTest::getIdenticalScoring ( )

Returns the identical scoring status of the question.

Returns: boolean The identical scoring status

See also: $identical_scoring public

Definition at line 1148 of file class.assClozeTest.php.

References $identical_scoring.

Referenced by calculateReachedPointsForSolution(), and saveAdditionalQuestionDataToDb().

                                          : bool
     {
         return $this->identical_scoring;
     }

Here is the caller graph for this function:

◆ getMaximumGapPoints()

assClozeTest::getMaximumGapPoints ( $gap_index )

Returns the maximum points for a gap.

Parameters

integer $gap_index The index of the gap

Returns: double The maximum points for the gap public

See also: $points

Definition at line 1211 of file class.assClozeTest.php.

References assQuestion\$points.

Referenced by calculateReachedPointsForSolution().

     {
         $points = 0;
         $gap_max_points = 0;
         if (array_key_exists($gap_index, $this->gaps)) {
             $gap = &$this->gaps[$gap_index];
             foreach ($gap->getItems($this->getShuffler()) as $answer) {
                 if ($answer->getPoints() > $gap_max_points) {
                     $gap_max_points = $answer->getPoints();
                 }
             }
             $points += $gap_max_points;
         }
         return $points;
     }

Here is the caller graph for this function:

◆ getMaximumPoints()

assClozeTest::getMaximumPoints ( )

Returns the maximum points, a learner can reach answering the question.

public

See also: $points

Definition at line 742 of file class.assClozeTest.php.

References assQuestion\$points, assQuestion\getId(), assClozeGap\TYPE_NUMERIC, assClozeGap\TYPE_SELECT, and assClozeGap\TYPE_TEXT.

Referenced by getUserQuestionResult(), and isComplete().

                                       : float
     {
         $assClozeGapCombinationObj = new assClozeGapCombination($this->db);
         $points = 0;
         $gaps_used_in_combination = [];
         if ($this->gap_combinations_exist) {
             $points = $assClozeGapCombinationObj->getMaxPointsForCombination($this->getId());
             $gaps_used_in_combination = $assClozeGapCombinationObj->getGapsWhichAreUsedInCombination($this->getId());
         }
         foreach ($this->gaps as $gap_index => $gap) {
             if (!array_key_exists($gap_index, $gaps_used_in_combination)) {
                 if ($gap->getType() == assClozeGap::TYPE_TEXT) {
                     $gap_max_points = 0;
                     foreach ($gap->getItems($this->getShuffler()) as $item) {
                         if ($item->getPoints() > $gap_max_points) {
                             $gap_max_points = $item->getPoints();
                         }
                     }
                     $points += $gap_max_points;
                 } elseif ($gap->getType() == assClozeGap::TYPE_SELECT) {
                     $srpoints = 0;
                     foreach ($gap->getItems($this->getShuffler()) as $item) {
                         if ($item->getPoints() > $srpoints) {
                             $srpoints = $item->getPoints();
                         }
                     }
                     $points += $srpoints;
                 } elseif ($gap->getType() == assClozeGap::TYPE_NUMERIC) {
                     $numpoints = 0;
                     foreach ($gap->getItems($this->getShuffler()) as $item) {
                         if ($item->getPoints() > $numpoints) {
                             $numpoints = $item->getPoints();
                         }
                     }
                     $points += $numpoints;
                 }
             }
         }
 
         return $points;
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getNumericgapPoints()

assClozeTest::getNumericgapPoints	(	$a_original,
		$a_entered,
		$max_points,
		$lowerBound,
		$upperBound
	)

Returns the points for a text gap and compares the given solution with the entered solution using the text gap rating options.

Parameters

string	$a_original	The original (correct) text
string	$a_entered	The text entered by the user
float	$max_points	The maximum number of points for the solution public

Definition at line 937 of file class.assClozeTest.php.

Referenced by calculateCombinationResult(), and calculateReachedPointsForSolution().

                                                                                                        : float
     {
         $eval = new EvalMath();
         $eval->suppress_errors = true;
         $result = 0.0;
 
         if ($eval->e($a_entered) === false) {
             return 0.0;
         } elseif (($eval->e($lowerBound) !== false) && ($eval->e($upperBound) !== false)) {
             if (($eval->e($a_entered) >= $eval->e($lowerBound)) && ($eval->e($a_entered) <= $eval->e($upperBound))) {
                 $result = $max_points;
             }
         } elseif ($eval->e($lowerBound) !== false) {
             if (($eval->e($a_entered) >= $eval->e($lowerBound)) && ($eval->e($a_entered) <= $eval->e($a_original))) {
                 $result = $max_points;
             }
         } elseif ($eval->e($upperBound) !== false) {
             if (($eval->e($a_entered) >= $eval->e($a_original)) && ($eval->e($a_entered) <= $eval->e($upperBound))) {
                 $result = $max_points;
             }
         } elseif ($eval->e($a_entered) == $eval->e($a_original)) {
             $result = $max_points;
         }
         return $result;
     }

Here is the caller graph for this function:

◆ getOperators()

assClozeTest::getOperators ( string $expression )

Get all available operations for a specific question.

Parameters

$expression

Implements iQuestionCondition.

Definition at line 1318 of file class.assClozeTest.php.

                                                     : array
     {
         return ilOperatorsExpressionMapping::getOperatorsByExpression($expression);
     }

◆ getQuestionType()

assClozeTest::getQuestionType ( )

Returns the question type of the question.

Returns: integer The question type of the question public

Definition at line 1099 of file class.assClozeTest.php.

Referenced by toJSON(), and toLog().

                                      : string
     {
         return "assClozeTest";
     }

Here is the caller graph for this function:

◆ getRTETextWithMediaObjects()

assClozeTest::getRTETextWithMediaObjects ( )

Collects all text in the question which could contain media objects which were created with the Rich Text Editor.

Definition at line 1231 of file class.assClozeTest.php.

References getClozeText().

                                                 : string
     {
         return parent::getRTETextWithMediaObjects() . $this->getClozeText();
     }

Here is the call graph for this function:

◆ getSolutionSubmit()

assClozeTest::getSolutionSubmit ( )

protected

Definition at line 1058 of file class.assClozeTest.php.

References fetchSolutionSubmit().

                                           : array
     {
         return $this->fetchSolutionSubmit();
     }

Here is the call graph for this function:

◆ getStartTag()

assClozeTest::getStartTag ( )

Returns the start tag of a cloze gap.

Returns: string The start tag of a cloze gap public

See also: $start_tag

Definition at line 477 of file class.assClozeTest.php.

References $start_tag.

                                  : string
     {
         return $this->start_tag;
     }

◆ getTextgapPoints()

assClozeTest::getTextgapPoints	(	$a_original,
		$a_entered,
		$max_points
	)

Returns the points for a text gap and compares the given solution with the entered solution using the text gap rating options.

Parameters

string	$a_original	The original (correct) text
string	$a_entered	The text entered by the user
integer	$max_points	The maximum number of points for the solution public

Definition at line 885 of file class.assClozeTest.php.

References $DIC, assQuestion\$refinery, getTextgapRating(), ilStr\strToLower(), assClozeGap\TEXTGAP_RATING_CASEINSENSITIVE, assClozeGap\TEXTGAP_RATING_CASESENSITIVE, assClozeGap\TEXTGAP_RATING_LEVENSHTEIN1, assClozeGap\TEXTGAP_RATING_LEVENSHTEIN2, assClozeGap\TEXTGAP_RATING_LEVENSHTEIN3, assClozeGap\TEXTGAP_RATING_LEVENSHTEIN4, and assClozeGap\TEXTGAP_RATING_LEVENSHTEIN5.

Referenced by calculateCombinationResult(), and calculateReachedPointsForSolution().

                                                                           : float
     {
         global $DIC;
         $refinery = $DIC->refinery();
         $result = 0;
         $gaprating = $this->getTextgapRating();
 
         switch ($gaprating) {
             case assClozeGap::TEXTGAP_RATING_CASEINSENSITIVE:
                 if (strcmp(ilStr::strToLower($a_original), ilStr::strToLower($a_entered)) == 0) {
                     $result = $max_points;
                 }
                 break;
             case assClozeGap::TEXTGAP_RATING_CASESENSITIVE:
                 if (strcmp($a_original, $a_entered) == 0) {
                     $result = $max_points;
                 }
                 break;
             case assClozeGap::TEXTGAP_RATING_LEVENSHTEIN1:
                 $transformation = $refinery->string()->levenshtein()->standard($a_original, 1);
                 break;
             case assClozeGap::TEXTGAP_RATING_LEVENSHTEIN2:
                 $transformation = $refinery->string()->levenshtein()->standard($a_original, 2);
                 break;
             case assClozeGap::TEXTGAP_RATING_LEVENSHTEIN3:
                 $transformation = $refinery->string()->levenshtein()->standard($a_original, 3);
                 break;
             case assClozeGap::TEXTGAP_RATING_LEVENSHTEIN4:
                 $transformation = $refinery->string()->levenshtein()->standard($a_original, 4);
                 break;
             case assClozeGap::TEXTGAP_RATING_LEVENSHTEIN5:
                 $transformation = $refinery->string()->levenshtein()->standard($a_original, 5);
                 break;
         }
 
         // run answers against Levenshtein2 methods
         if (isset($transformation) && $transformation->transform($a_entered) >= 0) {
             $result = $max_points;
         }
         return $result;
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getTextgapRating()

assClozeTest::getTextgapRating ( )

Returns the rating option for text gaps.

Returns: string The rating option for text gaps

See also: $textgap_rating public

Definition at line 1111 of file class.assClozeTest.php.

References $textgap_rating.

Referenced by getTextgapPoints(), and saveAdditionalQuestionDataToDb().

                                       : string
     {
         return $this->textgap_rating;
     }

Here is the caller graph for this function:

◆ getUserQuestionResult()

assClozeTest::getUserQuestionResult	(	int	$active_id,
		int	$pass
	)

Get the user solution for a question by active_id and the test pass.

Implements iQuestionCondition.

Definition at line 1334 of file class.assClozeTest.php.

References $data, assQuestion\$points, calculateReachedPoints(), assQuestion\getId(), getMaximumPoints(), and assQuestion\lookupMaxStep().

      : ilUserQuestionResult {
         $result = new ilUserQuestionResult($this, $active_id, $pass);
 
         $maxStep = $this->lookupMaxStep($active_id, $pass);
         if ($maxStep > 0) {
             $data = $this->db->queryF(
                 "
                                 SELECT sol.value1+1 as val, sol.value2, cloze.cloze_type
                                 FROM tst_solutions sol
                                 INNER JOIN qpl_a_cloze cloze ON cloze.gap_id = value1 AND cloze.question_fi = sol.question_fi
                                 WHERE sol.active_fi = %s AND sol.pass = %s AND sol.question_fi = %s AND sol.step = %s
                                 GROUP BY sol.solution_id, sol.value1+1, sol.value2, cloze.cloze_type
                                 ",
                 ["integer", "integer", "integer","integer"],
                 [$active_id, $pass, $this->getId(), $maxStep]
             );
         } else {
             $data = $this->db->queryF(
                 "
                                 SELECT sol.value1+1 as val, sol.value2, cloze.cloze_type
                                 FROM tst_solutions sol
                                 INNER JOIN qpl_a_cloze cloze ON cloze.gap_id = value1 AND cloze.question_fi = sol.question_fi
                                 WHERE sol.active_fi = %s AND sol.pass = %s AND sol.question_fi = %s
                                 GROUP BY sol.solution_id, sol.value1+1, sol.value2, cloze.cloze_type
                                 ",
                 ["integer", "integer", "integer"],
                 [$active_id, $pass, $this->getId()]
             );
         }
 
         while ($row = $this->db->fetchAssoc($data)) {
             if ($row["cloze_type"] == 1) {
                 $row["value2"]++;
             }
             $result->addKeyValue($row["val"], $row["value2"]);
         }
 
         $points = $this->calculateReachedPoints($active_id, $pass);
         $max_points = $this->getMaximumPoints();
 
         $result->setReachedPercentage(($points / $max_points) * 100);
 
         return $result;
     }

Here is the call graph for this function:

◆ getUserResultDetails()

assClozeTest::getUserResultDetails	(	int	$active_id,
		?int	$pass = `null`,
		bool	$authorized_solution = `true`
	)

Definition at line 977 of file class.assClozeTest.php.

References calculateReachedPointsForSolution(), and fetchUserResult().

      : array {
         $user_result = $this->fetchUserResult($active_id, $pass, $authorized_solution);
         $detailed = [];
         $this->calculateReachedPointsForSolution($user_result, $detailed);
         return $detailed;
     }

Here is the call graph for this function:

◆ isAddableAnswerOptionValue()

assClozeTest::isAddableAnswerOptionValue	(	int	$qIndex,
		string	$answerOptionValue
	)

Definition at line 1598 of file class.assClozeTest.php.

References getGap(), and assClozeGap\TYPE_TEXT.

                                                                                       : bool
     {
         $gap = $this->getGap($qIndex);
 
         if ($gap->getType() != assClozeGap::TYPE_TEXT) {
             return false;
         }
 
         foreach ($gap->getItems($this->randomGroup->dontShuffle()) as $item) {
             if ($item->getAnswertext() === $answerOptionValue) {
                 return false;
             }
         }
 
         return true;
     }

Here is the call graph for this function:

◆ isComplete()

assClozeTest::isComplete ( )

Returns TRUE, if a cloze test is complete for use.

Returns: boolean TRUE, if the cloze test is complete for use, otherwise FALSE

Definition at line 100 of file class.assClozeTest.php.

References assQuestion\getAuthor(), getClozeText(), getGaps(), getMaximumPoints(), and assQuestion\getTitle().

                                 : bool
     {
         if ($this->getTitle() !== ''
             && $this->getAuthor()
             && $this->getClozeText()
             && count($this->getGaps())
             && $this->getMaximumPoints() > 0) {
             return true;
         }
         return false;
     }

Here is the call graph for this function:

◆ isValidNumericSubmitValue()

assClozeTest::isValidNumericSubmitValue ( $submittedValue )

protected

Definition at line 1012 of file class.assClozeTest.php.

                                                                  : bool
     {
         if (is_numeric($submittedValue)) {
             return true;
         }
 
         if (preg_match('/^[-+]{0,1}\d+\/\d+$/', $submittedValue)) {
             return true;
         }
 
         return false;
     }

◆ lmMigrateQuestionTypeSpecificContent()

assClozeTest::lmMigrateQuestionTypeSpecificContent ( ilAssSelfAssessmentMigrator $migrator )

protected

Parameters

ilAssSelfAssessmentMigrator $migrator

Definition at line 1258 of file class.assClozeTest.php.

References getClozeText(), and ilAssSelfAssessmentMigrator\migrateToLmContent().

                                                                                                   : void
     {
         // DO NOT USE SETTER FOR CLOZE TEXT -> SETTER DOES RECREATE GAP OBJECTS without having gap type info ^^
         //$this->setClozeText( $migrator->migrateToLmContent($this->getClozeText()) );
         $this->cloze_text = $migrator->migrateToLmContent($this->getClozeText());
         // DO NOT USE SETTER FOR CLOZE TEXT -> SETTER DOES RECREATE GAP OBJECTS without having gap type info ^^
     }

Here is the call graph for this function:

◆ loadFromDb()

assClozeTest::loadFromDb ( int $question_id )

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

References $data, Vendor\Package\$e, ilRTE\_replaceMediaObjectImageSrc(), cleanQuestiontext(), ilAssClozeTestFeedback\FB_MODE_GAP_QUESTION, getAdditionalTableName(), ilAssQuestionLifecycle\getDraftInstance(), ilAssQuestionLifecycle\getInstance(), null, assQuestion\setAdditionalContentEditingMode(), assQuestion\setAuthor(), setClozeText(), assQuestion\setComment(), setFeedbackMode(), setFixedTextLength(), setGapCombinations(), setGapCombinationsExists(), assQuestion\setId(), setIdenticalScoring(), assQuestion\setLifecycle(), assQuestion\setNrOfTries(), assQuestion\setObjId(), assQuestion\setOriginalId(), assQuestion\setOwner(), assQuestion\setPoints(), assQuestion\setQuestion(), setTextgapRating(), assQuestion\setTitle(), assClozeGap\TYPE_NUMERIC, assClozeGap\TYPE_SELECT, and assClozeGap\TYPE_TEXT.

                                                 : void
     {
         $result = $this->db->queryF(
             "SELECT qpl_questions.*, " . $this->getAdditionalTableName() . ".* FROM qpl_questions LEFT JOIN " . $this->getAdditionalTableName() . " ON " . $this->getAdditionalTableName() . ".question_fi = qpl_questions.question_id WHERE qpl_questions.question_id = %s",
             ["integer"],
             [$question_id]
         );
         if ($result->numRows() == 1) {
             $data = $this->db->fetchAssoc($result);
             $this->setId($question_id);
             $this->setNrOfTries($data['nr_of_tries']);
             $this->setObjId($data["obj_fi"]);
             $this->setTitle((string) $data["title"]);
             $this->setComment((string) $data["description"]);
             $this->setOriginalId($data["original_id"]);
             $this->setAuthor($data["author"]);
             $this->setPoints($data["points"]);
             $this->setOwner($data["owner"]);
             $this->setQuestion($this->cleanQuestiontext($data["question_text"]));
             $this->setClozeText($data['cloze_text'] ?? '');
             $this->setFixedTextLength($data["fixed_textlen"]);
             $this->setIdenticalScoring(($data['tstamp'] === 0) ? true : (bool) $data['identical_scoring']);
             $this->setFeedbackMode($data['feedback_mode'] === null ? ilAssClozeTestFeedback::FB_MODE_GAP_QUESTION : $data['feedback_mode']);
 
             try {
                 $this->setLifecycle(ilAssQuestionLifecycle::getInstance($data['lifecycle']));
             } catch (ilTestQuestionPoolInvalidArgumentException $e) {
                 $this->setLifecycle(ilAssQuestionLifecycle::getDraftInstance());
             }
 
             $this->question = ilRTE::_replaceMediaObjectImageSrc($this->question, 1);
             $this->cloze_text = ilRTE::_replaceMediaObjectImageSrc($this->cloze_text, 1);
             $this->setTextgapRating($data["textgap_rating"]);
 
             try {
                 $this->setAdditionalContentEditingMode($data['add_cont_edit_mode']);
             } catch (ilTestQuestionPoolException $e) {
             }
 
             $result = $this->db->queryF(
                 "SELECT * FROM qpl_a_cloze WHERE question_fi = %s ORDER BY gap_id, aorder ASC",
                 ["integer"],
                 [$question_id]
             );
             if ($result->numRows() > 0) {
                 $this->gaps = [];
                 while ($data = $this->db->fetchAssoc($result)) {
                     switch ($data["cloze_type"]) {
                         case assClozeGap::TYPE_TEXT:
                             if (!array_key_exists($data["gap_id"], $this->gaps)) {
                                 $this->gaps[$data["gap_id"]] = new assClozeGap(assClozeGap::TYPE_TEXT);
                             }
                             $answer = new assAnswerCloze(
                                 $data["answertext"],
                                 $data["points"],
                                 $data["aorder"]
                             );
                             $this->gaps[$data["gap_id"]]->setGapSize((int) $data['gap_size']);
 
                             $this->gaps[$data["gap_id"]]->addItem($answer);
                             break;
                         case assClozeGap::TYPE_SELECT:
                             if (!array_key_exists($data["gap_id"], $this->gaps)) {
                                 $this->gaps[$data["gap_id"]] = new assClozeGap(assClozeGap::TYPE_SELECT);
                                 $this->gaps[$data["gap_id"]]->setShuffle($data["shuffle"]);
                             }
                             $answer = new assAnswerCloze(
                                 $data["answertext"],
                                 $data["points"],
                                 $data["aorder"]
                             );
                             $this->gaps[$data["gap_id"]]->addItem($answer);
                             break;
                         case assClozeGap::TYPE_NUMERIC:
                             if (!array_key_exists($data["gap_id"], $this->gaps)) {
                                 $this->gaps[$data["gap_id"]] = new assClozeGap(assClozeGap::TYPE_NUMERIC);
                             }
                             $answer = new assAnswerCloze(
                                 $data["answertext"],
                                 $data["points"],
                                 $data["aorder"]
                             );
                             $this->gaps[$data["gap_id"]]->setGapSize((int) $data['gap_size']);
                             $answer->setLowerBound($data["lowerlimit"]);
                             $answer->setUpperBound($data["upperlimit"]);
                             $this->gaps[$data["gap_id"]]->addItem($answer);
                             break;
                     }
                 }
             }
         }
         $check_for_gap_combinations = (new assClozeGapCombination($this->db))->loadFromDb($question_id);
         if (count($check_for_gap_combinations) != 0) {
             $this->setGapCombinationsExists(true);
             $this->setGapCombinations($check_for_gap_combinations);
         }
         parent::loadFromDb($question_id);
     }

Here is the call graph for this function:

◆ replaceFirstGap()

assClozeTest::replaceFirstGap	(	string	$gaptext,
		string	$content
	)

Definition at line 134 of file class.assClozeTest.php.

Referenced by deleteGap(), and updateClozeTextFromGaps().

      : string {
         $output = preg_replace(
             '/\[gap\].*?\[\/gap\]/',
             str_replace('$', 'GAPMASKEDDOLLAR', $content),
             $gaptext,
             1
         );
         return str_replace('GAPMASKEDDOLLAR', '$', $output);
     }

Here is the caller graph for this function:

◆ saveAdditionalQuestionDataToDb()

assClozeTest::saveAdditionalQuestionDataToDb ( )

Saves a record to the question types additional data table.

Returns: mixed

Implements ilObjQuestionScoringAdjustable.

Definition at line 268 of file class.assClozeTest.php.

References ilRTE\_replaceMediaObjectImageSrc(), getAdditionalTableName(), getClozeText(), getFeedbackMode(), getFixedTextLength(), assQuestion\getId(), getIdenticalScoring(), getTextgapRating(), and null.

Referenced by saveToDb().

                                                     : void
     {
         $this->db->manipulateF(
             "DELETE FROM " . $this->getAdditionalTableName() . " WHERE question_fi = %s",
             [ "integer" ],
             [ $this->getId() ]
         );
 
         $this->db->insert($this->getAdditionalTableName(), [
             'question_fi' => ['integer', $this->getId()],
             'textgap_rating' => ['text', $this->getTextgapRating()],
             'identical_scoring' => ['text', $this->getIdenticalScoring()],
             'fixed_textlen' => ['integer', $this->getFixedTextLength() ? $this->getFixedTextLength() : null],
             'cloze_text' => ['text', ilRTE::_replaceMediaObjectImageSrc($this->getClozeText(), 0)],
             'feedback_mode' => ['text', $this->getFeedbackMode()]
         ]);
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ saveAnswerSpecificDataToDb()

assClozeTest::saveAnswerSpecificDataToDb ( )

Saves the answer specific records into a question types answer table.

Returns: mixed

Implements ilObjAnswerScoringAdjustable.

Definition at line 255 of file class.assClozeTest.php.

References assQuestion\getId(), and saveClozeGapItemsToDb().

Referenced by saveToDb().

                                                 : void
     {
         $this->db->manipulateF(
             "DELETE FROM qpl_a_cloze WHERE question_fi = %s",
             [ "integer" ],
             [ $this->getId() ]
         );
 
         foreach ($this->gaps as $key => $gap) {
             $this->saveClozeGapItemsToDb($gap, $key);
         }
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ saveClozeGapItemsToDb()

assClozeTest::saveClozeGapItemsToDb	(	assClozeGap	$gap,
		int	$key
	)

protected

Definition at line 285 of file class.assClozeTest.php.

References assClozeGap\getItems(), assClozeGap\getType(), saveClozeNumericGapRecordToDb(), saveClozeSelectGapRecordToDb(), saveClozeTextGapRecordToDb(), assClozeGap\TYPE_NUMERIC, assClozeGap\TYPE_SELECT, and assClozeGap\TYPE_TEXT.

Referenced by saveAnswerSpecificDataToDb().

      : void {
         foreach ($gap->getItems($this->getShuffler()) as $item) {
             $next_id = $this->db->nextId('qpl_a_cloze');
             switch ($gap->getType()) {
                 case assClozeGap::TYPE_TEXT:
                     $this->saveClozeTextGapRecordToDb($next_id, $key, $item, $gap);
                     break;
                 case assClozeGap::TYPE_SELECT:
                     $this->saveClozeSelectGapRecordToDb($next_id, $key, $item, $gap);
                     break;
                 case assClozeGap::TYPE_NUMERIC:
                     $this->saveClozeNumericGapRecordToDb($next_id, $key, $item, $gap);
                     break;
             }
         }
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ saveClozeNumericGapRecordToDb()

assClozeTest::saveClozeNumericGapRecordToDb	(	int	$next_id,
		int	$key,
		assAnswerCloze	$item,
		assClozeGap	$gap
	)

protected

Definition at line 367 of file class.assClozeTest.php.

References ASS_AnswerSimple\getAnswertext(), assClozeGap\getGapSize(), assQuestion\getId(), assAnswerCloze\getLowerBound(), ASS_AnswerSimple\getOrder(), ASS_AnswerSimple\getPoints(), assClozeGap\getType(), assAnswerCloze\getUpperBound(), and ILIAS\Repository\int().

Referenced by saveClozeGapItemsToDb().

      : void {
         $eval = new EvalMath();
         $eval->suppress_errors = true;
         $this->db->manipulateF(
             'INSERT INTO qpl_a_cloze (answer_id, question_fi, gap_id, answertext, points, aorder, cloze_type, lowerlimit, upperlimit, gap_size) VALUES (%s, %s, %s, %s, %s, %s, %s, %s, %s, %s)',
             [
                 'integer',
                 'integer',
                 'integer',
                 'text',
                 'float',
                 'integer',
                 'text',
                 'text',
                 'text',
                 'integer'
             ],
             [
                 $next_id,
                 $this->getId(),
                 $key,
                 strlen($item->getAnswertext()) ? $item->getAnswertext() : '',
                 $item->getPoints(),
                 $item->getOrder(),
                 $gap->getType(),
                 ($eval->e($item->getLowerBound()) !== false && strlen(
                     $item->getLowerBound()
                 ) > 0) ? $item->getLowerBound() : $item->getAnswertext(),
                 ($eval->e($item->getUpperBound()) !== false && strlen(
                     $item->getUpperBound()
                 ) > 0) ? $item->getUpperBound() : $item->getAnswertext(),
                 (int) $gap->getGapSize()
             ]
         );
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ saveClozeSelectGapRecordToDb()

assClozeTest::saveClozeSelectGapRecordToDb	(	int	$next_id,
		int	$key,
		assAnswerCloze	$item,
		assClozeGap	$gap
	)

protected

Definition at line 336 of file class.assClozeTest.php.

References ASS_AnswerSimple\getAnswertext(), assQuestion\getId(), ASS_AnswerSimple\getOrder(), ASS_AnswerSimple\getPoints(), assClozeGap\getShuffle(), and assClozeGap\getType().

Referenced by saveClozeGapItemsToDb().

      : void {
         $this->db->manipulateF(
             'INSERT INTO qpl_a_cloze (answer_id, question_fi, gap_id, answertext, points, aorder, cloze_type, shuffle) VALUES (%s, %s, %s, %s, %s, %s, %s, %s)',
             [
                 'integer',
                 'integer',
                 'integer',
                 'text',
                 'float',
                 'integer',
                 'text',
                 'text'
             ],
             [
                 $next_id,
                 $this->getId(),
                 $key,
                 strlen($item->getAnswertext()) ? $item->getAnswertext() : '',
                 $item->getPoints(),
                 $item->getOrder(),
                 $gap->getType(),
                 ($gap->getShuffle()) ? '1' : '0'
             ]
         );
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ saveClozeTextGapRecordToDb()

assClozeTest::saveClozeTextGapRecordToDb	(	int	$next_id,
		int	$key,
		assAnswerCloze	$item,
		assClozeGap	$gap
	)

protected

Definition at line 305 of file class.assClozeTest.php.

References ASS_AnswerSimple\getAnswertext(), assClozeGap\getGapSize(), assQuestion\getId(), ASS_AnswerSimple\getOrder(), ASS_AnswerSimple\getPoints(), assClozeGap\getType(), and ILIAS\Repository\int().

Referenced by saveClozeGapItemsToDb().

      : void {
         $this->db->manipulateF(
             'INSERT INTO qpl_a_cloze (answer_id, question_fi, gap_id, answertext, points, aorder, cloze_type, gap_size) VALUES (%s, %s, %s, %s, %s, %s, %s, %s)',
             [
                 'integer',
                 'integer',
                 'integer',
                 'text',
                 'float',
                 'integer',
                 'text',
                 'integer'
             ],
             [
                 $next_id,
                 $this->getId(),
                 $key,
                 strlen($item->getAnswertext()) ? $item->getAnswertext() : '',
                 $item->getPoints(),
                 $item->getOrder(),
                 $gap->getType(),
                 (int) $gap->getGapSize()
             ]
         );
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ saveToDb()

assClozeTest::saveToDb ( ?int $original_id = null )

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

References assQuestion\$original_id, saveAdditionalQuestionDataToDb(), saveAnswerSpecificDataToDb(), and assQuestion\saveQuestionDataToDb().

                                                       : void
     {
         $this->saveQuestionDataToDb($original_id);
         $this->saveAdditionalQuestionDataToDb();
         $this->saveAnswerSpecificDataToDb();
 
         parent::saveToDb();
     }

Here is the call graph for this function:

◆ saveWorkingData()

assClozeTest::saveWorkingData	(	int	$active_id,
		?int	$pass = `null`,
		bool	$authorized = `true`
	)

Definition at line 1063 of file class.assClozeTest.php.

References ilObjTest\_getPass(), fetchSolutionSubmit(), getGap(), assQuestion\getProcessLocker(), null, assQuestion\removeCurrentSolution(), assQuestion\saveCurrentSolution(), and assClozeGap\TYPE_SELECT.

      : bool {
         if (is_null($pass)) {
             $pass = ilObjTest::_getPass($active_id);
         }
 
         $this->getProcessLocker()->executeUserSolutionUpdateLockOperation(
             function () use ($active_id, $pass, $authorized) {
                 $this->removeCurrentSolution($active_id, $pass, $authorized);
 
                 foreach ($this->fetchSolutionSubmit() as $key => $value) {
                     if ($value === null || $value === '') {
                         continue;
                     }
                     $gap = $this->getGap($key);
                     if ($gap === null
                         || $gap->getType() === assClozeGap::TYPE_SELECT && $value === -1) {
                         continue;
                     }
                     $this->saveCurrentSolution($active_id, $pass, $key, $value, $authorized);
                 }
             }
         );
 
         return true;
     }

Here is the call graph for this function:

◆ setClozeText()

assClozeTest::setClozeText ( string $cloze_text = '' )

Definition at line 418 of file class.assClozeTest.php.

References cleanQuestiontext(), and createGapsFromQuestiontext().

Referenced by loadFromDb().

                                                          : void
     {
         $this->gaps = [];
         $this->cloze_text = $this->cleanQuestiontext($cloze_text);
         $this->createGapsFromQuestiontext();
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ setClozeTextValue()

assClozeTest::setClozeTextValue ( $cloze_text = "" )

Definition at line 425 of file class.assClozeTest.php.

References $cloze_text.

                                                        : void
     {
         $this->cloze_text = $cloze_text;
     }

◆ setEndTag()

assClozeTest::setEndTag ( $end_tag = "[/gap]" )

Sets the end tag of a cloze gap.

Parameters

string $end_tag The end tag for a cloze gap public

See also: $end_tag

Definition at line 513 of file class.assClozeTest.php.

References $end_tag.

                                                   : void
     {
         $this->end_tag = $end_tag;
     }

◆ setFeedbackMode()

assClozeTest::setFeedbackMode ( $feedbackMode )

Parameters

string $feedbackMode

Definition at line 529 of file class.assClozeTest.php.

References $feedbackMode.

Referenced by loadFromDb().

                                                   : void
     {
         $this->feedbackMode = $feedbackMode;
     }

Here is the caller graph for this function:

◆ setFixedTextLength()

assClozeTest::setFixedTextLength ( ?int $fixed_text_length )

Sets a fixed text length for all text fields in the cloze question.

Parameters

integer $a_text_len The text field length public

Definition at line 1187 of file class.assClozeTest.php.

References $fixed_text_length.

Referenced by loadFromDb().

                                                                : void
     {
         $this->fixed_text_length = $fixed_text_length;
     }

Here is the caller graph for this function:

◆ setGapAnswerLowerBound()

assClozeTest::setGapAnswerLowerBound	(	$gap_index,
		$order,
		$bound
	)

Sets the lower bound of a gap with a given index and an answer with a given order.

The index of the first gap is 0, the index of the second gap is 1 and so on.

Parameters

integer	$gap_index	A nonnegative index of the n-th gap
integer	$order	The order of the answer text
string	$answer	The lower bound of the answer public

See also: $gaps

Definition at line 712 of file class.assClozeTest.php.

                                                                       : void
     {
         if (array_key_exists($gap_index, $this->gaps)) {
             $this->gaps[$gap_index]->setItemLowerBound($order, $bound);
         }
     }

◆ setGapAnswerPoints()

assClozeTest::setGapAnswerPoints	(	$gap_index,
		$order,
		$points
	)

Sets the points of a gap with a given index and an answer with a given order.

The index of the first gap is 0, the index of the second gap is 1 and so on.

Parameters

integer	$gap_index	A nonnegative index of the n-th gap
integer	$order	The order of the answer text
string	$answer	The points of the answer public

See also: $gaps

Definition at line 662 of file class.assClozeTest.php.

References assQuestion\$points.

                                                                    : void
     {
         if (array_key_exists($gap_index, $this->gaps)) {
             $this->gaps[$gap_index]->setItemPoints($order, $points);
         }
     }

◆ setGapAnswerUpperBound()

assClozeTest::setGapAnswerUpperBound	(	$gap_index,
		$order,
		$bound
	)

Sets the upper bound of a gap with a given index and an answer with a given order.

The index of the first gap is 0, the index of the second gap is 1 and so on.

Parameters

integer	$gap_index	A nonnegative index of the n-th gap
integer	$order	The order of the answer text
string	$answer	The upper bound of the answer public

See also: $gaps

Definition at line 729 of file class.assClozeTest.php.

                                                                       : void
     {
         if (array_key_exists($gap_index, $this->gaps)) {
             $this->gaps[$gap_index]->setItemUpperBound($order, $bound);
         }
     }

◆ setGapCombinations()

assClozeTest::setGapCombinations ( $value )

Definition at line 1250 of file class.assClozeTest.php.

Referenced by loadFromDb().

                                               : void
     {
         $this->gap_combinations = $value;
     }

Here is the caller graph for this function:

◆ setGapCombinationsExists()

assClozeTest::setGapCombinationsExists ( $value )

Definition at line 1245 of file class.assClozeTest.php.

Referenced by loadFromDb().

                                                     : void
     {
         $this->gap_combinations_exist = $value;
     }

Here is the caller graph for this function:

◆ setGapShuffle()

assClozeTest::setGapShuffle	(	$gap_index = `0`,
		$shuffle = `1`
	)

Sets the shuffle state of a gap with a given index.

The index of the first gap is 0, the index of the second gap is 1 and so on.

Parameters

integer	$index	A nonnegative index of the n-th gap
integer	$shuffle	Turn shuffle on (=1) or off (=0) public

See also: $gaps

Definition at line 580 of file class.assClozeTest.php.

References assQuestion\$shuffle.

                                                                : void
     {
         if (array_key_exists($gap_index, $this->gaps)) {
             $this->gaps[$gap_index]->setShuffle($shuffle);
         }
     }

◆ setGapSize()

assClozeTest::setGapSize	(	$gap_index,
		$size
	)

Definition at line 645 of file class.assClozeTest.php.

                                                  : void
     {
         if (array_key_exists($gap_index, $this->gaps)) {
             $this->gaps[$gap_index]->setGapSize((int) $size);
         }
     }

◆ setGapType()

assClozeTest::setGapType	(	$gap_index,
		$gap_type
	)

Set the type of a gap with a given index.

private

Definition at line 564 of file class.assClozeTest.php.

                                                      : void
     {
         if (array_key_exists($gap_index, $this->gaps)) {
             $this->gaps[$gap_index]->setType($gap_type);
         }
     }

◆ setIdenticalScoring()

assClozeTest::setIdenticalScoring ( bool $identical_scoring )

Sets the identical scoring option for cloze questions.

Parameters

boolean $a_identical_scoring The identical scoring option for cloze questions

See also: $identical_scoring public

Definition at line 1160 of file class.assClozeTest.php.

References $identical_scoring.

Referenced by loadFromDb().

                                                                 : void
     {
         $this->identical_scoring = $identical_scoring;
     }

Here is the caller graph for this function:

◆ setStartTag()

assClozeTest::setStartTag ( $start_tag = "[gap]" )

Sets the start tag of a cloze gap.

Parameters

string $start_tag The start tag for a cloze gap public

See also: $start_tag

Definition at line 489 of file class.assClozeTest.php.

References $start_tag.

                                                      : void
     {
         $this->start_tag = $start_tag;
     }

◆ setTextgapRating()

assClozeTest::setTextgapRating ( $a_textgap_rating )

Sets the rating option for text gaps.

Parameters

string $a_textgap_rating The rating option for text gaps

See also: $textgap_rating public

Definition at line 1123 of file class.assClozeTest.php.

References assClozeGap\TEXTGAP_RATING_CASEINSENSITIVE, assClozeGap\TEXTGAP_RATING_CASESENSITIVE, assClozeGap\TEXTGAP_RATING_LEVENSHTEIN1, assClozeGap\TEXTGAP_RATING_LEVENSHTEIN2, assClozeGap\TEXTGAP_RATING_LEVENSHTEIN3, assClozeGap\TEXTGAP_RATING_LEVENSHTEIN4, and assClozeGap\TEXTGAP_RATING_LEVENSHTEIN5.

Referenced by loadFromDb().

                                                        : void
     {
         switch ($a_textgap_rating) {
             case assClozeGap::TEXTGAP_RATING_CASEINSENSITIVE:
             case assClozeGap::TEXTGAP_RATING_CASESENSITIVE:
             case assClozeGap::TEXTGAP_RATING_LEVENSHTEIN1:
             case assClozeGap::TEXTGAP_RATING_LEVENSHTEIN2:
             case assClozeGap::TEXTGAP_RATING_LEVENSHTEIN3:
             case assClozeGap::TEXTGAP_RATING_LEVENSHTEIN4:
             case assClozeGap::TEXTGAP_RATING_LEVENSHTEIN5:
                 $this->textgap_rating = $a_textgap_rating;
                 break;
             default:
                 $this->textgap_rating = assClozeGap::TEXTGAP_RATING_CASEINSENSITIVE;
                 break;
         }
     }

Here is the caller graph for this function:

◆ solutionValuesToLog()

assClozeTest::solutionValuesToLog	(	AdditionalInformationGenerator	$additional_info,
		array	$solution_values
	)

protected

Definition at line 1669 of file class.assClozeTest.php.

References getGaps(), and assClozeGap\TYPE_SELECT.

      : array {
         $parsed_solution = [];
         foreach ($this->getGaps() as $gap_index => $gap) {
             foreach ($solution_values as $solutionvalue) {
                 if ($gap_index !== (int) $solutionvalue['value1']) {
                     continue;
                 }
 
                 if ($gap->getType() === assClozeGap::TYPE_SELECT) {
                     $parsed_solution[$gap_index + 1] = $gap->getItem($solutionvalue['value2'])->getAnswertext();
                     continue;
                 }
 
                 $parsed_solution[$gap_index + 1] = $solutionvalue['value2'];
             }
         }
         return $parsed_solution;
     }

Here is the call graph for this function:

◆ solutionValuesToText()

assClozeTest::solutionValuesToText ( array $solution_values )

Definition at line 1691 of file class.assClozeTest.php.

References getGaps(), ILIAS\Repository\lng(), and assClozeGap\TYPE_SELECT.

                                                                 : array
     {
         $parsed_solution = [];
         foreach ($this->getGaps() as $gap_index => $gap) {
             foreach ($solution_values as $solutionvalue) {
                 if ($gap_index !== (int) $solutionvalue['value1']) {
                     continue;
                 }
 
                 if ($gap->getType() === assClozeGap::TYPE_SELECT) {
                     $parsed_solution[] = $this->lng->txt('gap') . ' ' . $gap_index + 1 . ': '
                         . $gap->getItem($solutionvalue['value2'])->getAnswertext();
                     continue;
                 }
 
                 $parsed_solution[] = $this->lng->txt('gap') . ' ' . $gap_index + 1 . ': '
                     . $solutionvalue['value2'];
             }
         }
         return $parsed_solution;
     }

Here is the call graph for this function:

◆ toJSON()

assClozeTest::toJSON ( )

Returns a JSON representation of the question.

Implements ILIAS\TestQuestionPool\Questions\QuestionLMExportable.

Definition at line 1269 of file class.assClozeTest.php.

References $gaps, ilObjMediaObject\_getMobsOfObject(), assQuestion\formatSAQuestion(), getClozeText(), getGaps(), assQuestion\getId(), assQuestion\getNrOfTries(), assQuestion\getQuestion(), getQuestionType(), assQuestion\getShuffle(), assQuestion\getTitleForHTMLOutput(), assClozeGap\TYPE_NUMERIC, and assClozeGap\TYPE_TEXT.

                             : string
     {
         $result = [
             'id' => $this->getId(),
             'type' => (string) $this->getQuestionType(),
             'title' => $this->getTitleForHTMLOutput(),
             'question' => $this->formatSAQuestion($this->getQuestion()),
             'clozetext' => $this->formatSAQuestion($this->getClozeText()),
             'nr_of_tries' => $this->getNrOfTries(),
             'shuffle' => $this->getShuffle(),
             'feedback' => [
                 'onenotcorrect' => $this->formatSAQuestion($this->feedbackOBJ->getGenericFeedbackTestPresentation($this->getId(), false)),
                 'allcorrect' => $this->formatSAQuestion($this->feedbackOBJ->getGenericFeedbackTestPresentation($this->getId(), true))
             ]
         ];
 
         $gaps = [];
         foreach ($this->getGaps() as $key => $gap) {
             $items = [];
             foreach ($gap->getItems($this->getShuffler()) as $item) {
                 $jitem = [];
                 $jitem['points'] = $item->getPoints();
                 $jitem['value'] = $this->formatSAQuestion($item->getAnswertext());
                 $jitem['order'] = $item->getOrder();
                 if ($gap->getType() == assClozeGap::TYPE_NUMERIC) {
                     $jitem['lowerbound'] = $item->getLowerBound();
                     $jitem['upperbound'] = $item->getUpperBound();
                 } else {
                     $jitem['value'] = trim($jitem['value']);
                 }
                 array_push($items, $jitem);
             }
 
             if ($gap->getGapSize() && ($gap->getType() == assClozeGap::TYPE_TEXT || $gap->getType() == assClozeGap::TYPE_NUMERIC)) {
                 $jgap['size'] = $gap->getGapSize();
             }
 
             $jgap['shuffle'] = $gap->getShuffle();
             $jgap['type'] = $gap->getType();
             $jgap['item'] = $items;
 
             array_push($gaps, $jgap);
         }
         $result['gaps'] = $gaps;
         $mobs = ilObjMediaObject::_getMobsOfObject("qpl:html", $this->getId());
         $result['mobs'] = $mobs;
         return json_encode($result);
     }

Here is the call graph for this function:

◆ toLog()

assClozeTest::toLog ( AdditionalInformationGenerator $additional_info )

Implements ILIAS\TestQuestionPool\Questions\Question.

Definition at line 1625 of file class.assClozeTest.php.

References $gaps, assQuestion\formatSAQuestion(), getClozeText(), getGaps(), assQuestion\getQuestion(), getQuestionType(), assQuestion\getShuffle(), assQuestion\getTitleForHTMLOutput(), ILIAS\Test\Logging\AdditionalInformationGenerator\getTrueFalseTagForBool(), and assClozeGap\TYPE_NUMERIC.

                                                                           : array
     {
         $result = [
             AdditionalInformationGenerator::KEY_QUESTION_TYPE => (string) $this->getQuestionType(),
             AdditionalInformationGenerator::KEY_QUESTION_TITLE => $this->getTitleForHTMLOutput(),
             AdditionalInformationGenerator::KEY_QUESTION_TEXT => $this->formatSAQuestion($this->getQuestion()),
             AdditionalInformationGenerator::KEY_QUESTION_CLOZE_CLOZETEXT => $this->formatSAQuestion($this->getClozeText()),
             AdditionalInformationGenerator::KEY_QUESTION_SHUFFLE_ANSWER_OPTIONS => $additional_info
                 ->getTrueFalseTagForBool($this->getShuffle()),
             AdditionalInformationGenerator::KEY_FEEDBACK => [
                 AdditionalInformationGenerator::KEY_QUESTION_FEEDBACK_ON_INCOMPLETE => $this->formatSAQuestion($this->feedbackOBJ->getGenericFeedbackTestPresentation($this->getId(), false)),
                 AdditionalInformationGenerator::KEY_QUESTION_FEEDBACK_ON_COMPLETE => $this->formatSAQuestion($this->feedbackOBJ->getGenericFeedbackTestPresentation($this->getId(), true))
             ]
         ];
 
         $gaps = [];
         foreach ($this->getGaps() as $gap_index => $gap) {
             $items = [];
             foreach ($gap->getItems($this->getShuffler()) as $item) {
                 $item_array = [
                     AdditionalInformationGenerator::KEY_QUESTION_REACHABLE_POINTS => $item->getPoints(),
                     AdditionalInformationGenerator::KEY_QUESTION_ANSWER_OPTION => $this->formatSAQuestion($item->getAnswertext()),
                     AdditionalInformationGenerator::KEY_QUESTION_ANSWER_OPTION_ORDER => $item->getOrder()
                 ];
                 if ($gap->getType() === assClozeGap::TYPE_NUMERIC) {
                     $item_array[AdditionalInformationGenerator::KEY_QUESTION_LOWER_LIMIT] = $item->getLowerBound();
                     $item_array[AdditionalInformationGenerator::KEY_QUESTION_UPPER_LIMIT] = $item->getUpperBound();
                 }
                 array_push($items, $item_array);
             }
 
             $gap_array[AdditionalInformationGenerator::KEY_QUESTION_TEXTSIZE] = $gap->getGapSize();
             $gap_array[AdditionalInformationGenerator::KEY_QUESTION_SHUFFLE_ANSWER_OPTIONS] = $additional_info->getTrueFalseTagForBool(
                 $gap->getShuffle()
             );
             $gap_array[AdditionalInformationGenerator::KEY_QUESTION_CLOZE_GAP_TYPE] = $gap->getType();
             $gap_array[AdditionalInformationGenerator::KEY_QUESTION_ANSWER_OPTIONS] = $items;
 
             $gaps[$gap_index + 1] = $gap_array;
         }
         $result[AdditionalInformationGenerator::KEY_QUESTION_CLOZE_GAPS] = $gaps;
         return $result;
     }

Here is the call graph for this function:

◆ updateClozeTextFromGaps()

assClozeTest::updateClozeTextFromGaps ( )

Updates the gap parameters in the cloze text from the form input.

private

Definition at line 803 of file class.assClozeTest.php.

References getClozeText(), getGaps(), ilLegacyFormElementsUtil\prepareTextareaOutput(), and replaceFirstGap().

Referenced by deleteAnswerText().

                                              : void
     {
         $output = $this->getClozeText();
         foreach ($this->getGaps() as $gap_index => $gap) {
             $answers = [];
             foreach ($gap->getItemsRaw() as $item) {
                 array_push($answers, str_replace([',', '['], ["\\,", '[&hairsp;'], $item->getAnswerText()));
             }
             // fau: fixGapReplace - use replace function
             $output = $this->replaceFirstGap($output, "[_gap]" . ilLegacyFormElementsUtil::prepareTextareaOutput(join(",", $answers), true) . "[/_gap]");
             // fau.
         }
         $output = str_replace("_gap]", "gap]", $output);
         $this->cloze_text = $output;
     }

Here is the call graph for this function:

Here is the caller graph for this function:

Field Documentation

◆ $cloze_text

string assClozeTest::$cloze_text = ''

protected

Definition at line 77 of file class.assClozeTest.php.

Referenced by getClozeText(), and setClozeTextValue().

◆ $end_tag

string assClozeTest::$end_tag = '[/gap]'

private

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

Referenced by getEndTag(), and setEndTag().

◆ $feedbackMode

assClozeTest::$feedbackMode = ilAssClozeTestFeedback::FB_MODE_GAP_QUESTION

protected

Definition at line 79 of file class.assClozeTest.php.

Referenced by getFeedbackMode(), and setFeedbackMode().

◆ $feedbackOBJ

ilAssQuestionFeedback assClozeTest::$feedbackOBJ

Definition at line 78 of file class.assClozeTest.php.

◆ $fixed_text_length

int assClozeTest::$fixed_text_length = null

protected

Definition at line 76 of file class.assClozeTest.php.

Referenced by getFixedTextLength(), and setFixedTextLength().

◆ $gap_combinations

assClozeTest::$gap_combinations = []

protected

Definition at line 53 of file class.assClozeTest.php.

Referenced by cloneQuestionTypeSpecificProperties(), and getGapCombinations().

◆ $gap_combinations_exist

bool assClozeTest::$gap_combinations_exist = false

protected

Definition at line 54 of file class.assClozeTest.php.

Referenced by getGapCombinationsExists().

◆ $gaps

array assClozeTest::$gaps = []

Definition at line 44 of file class.assClozeTest.php.

Referenced by getGaps(), toJSON(), and toLog().

◆ $identical_scoring

bool assClozeTest::$identical_scoring = true

protected

Defines the scoring for "identical solutions".

If the learner selects the same solution twice or more in different gaps, only the first choice will be scored if identical_scoring is 0.

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

Referenced by getIdenticalScoring(), and setIdenticalScoring().

◆ $randomGroup

RandomGroup assClozeTest::$randomGroup

private

Definition at line 80 of file class.assClozeTest.php.

◆ $start_tag

string assClozeTest::$start_tag = '[gap]'

private

Definition at line 55 of file class.assClozeTest.php.

Referenced by getStartTag(), and setStartTag().

◆ $textgap_rating

string assClozeTest::$textgap_rating = assClozeGap::TEXTGAP_RATING_CASEINSENSITIVE

The rating option for text gaps.

This could contain one of the following options:

case insensitive text gaps
case sensitive text gaps
various levenshtein distances

Definition at line 66 of file class.assClozeTest.php.

Referenced by getTextgapRating().

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

components/ILIAS/TestQuestionPool/classes/class.assClozeTest.php

Public Member Functions

Data Fields

Protected Member Functions

Protected Attributes

Private Member Functions

Private Attributes

Additional Inherited Members

Detailed Description

Constructor & Destructor Documentation

◆ __construct()

Member Function Documentation

◆ addAnswerOptionValue()

◆ addGapAnswer()

◆ addGapAtIndex()

◆ addGapText()

◆ calculateCombinationResult()

◆ calculateReachedPoints()

◆ calculateReachedPointsForSolution()

◆ calculateReachedPointsFromPreviewSession()

◆ checkForValidFormula()

◆ cleanQuestiontext()

◆ clearGapAnswers()

◆ cloneQuestionTypeSpecificProperties()

◆ createGapsFromQuestiontext()

◆ deleteAnswerText()

◆ deleteGap()

◆ fetchAnswerValueForGap()

◆ fetchSolutionSubmit()

◆ fetchUserResult()

◆ flushGaps()

◆ getAdditionalTableName()

◆ getAnswerTableName()

◆ getAvailableAnswerOptions()

◆ getClozeText()

◆ getClozeTextForHTMLOutput()

◆ getCorrectSolutionForTextOutput()

◆ getEndTag()

◆ getExpressionTypes()

◆ getFeedbackMode()

◆ getFixedTextLength()

◆ getGap()

◆ getGapCombinations()

◆ getGapCombinationsExists()

◆ getGapCount()

◆ getGaps()

◆ getIdenticalScoring()

◆ getMaximumGapPoints()

◆ getMaximumPoints()

◆ getNumericgapPoints()

◆ getOperators()

◆ getQuestionType()

◆ getRTETextWithMediaObjects()

◆ getSolutionSubmit()

◆ getStartTag()

◆ getTextgapPoints()

◆ getTextgapRating()

◆ getUserQuestionResult()

◆ getUserResultDetails()

◆ isAddableAnswerOptionValue()

◆ isComplete()

◆ isValidNumericSubmitValue()

◆ lmMigrateQuestionTypeSpecificContent()

◆ loadFromDb()

◆ replaceFirstGap()

◆ saveAdditionalQuestionDataToDb()

◆ saveAnswerSpecificDataToDb()

◆ saveClozeGapItemsToDb()

◆ saveClozeNumericGapRecordToDb()

◆ saveClozeSelectGapRecordToDb()

◆ saveClozeTextGapRecordToDb()

◆ saveToDb()

◆ saveWorkingData()

◆ setClozeText()

◆ setClozeTextValue()

◆ setEndTag()

◆ setFeedbackMode()

◆ setFixedTextLength()

◆ setGapAnswerLowerBound()

◆ setGapAnswerPoints()

◆ setGapAnswerUpperBound()