Public Member Functions |
Data Fields |
Protected Member Functions |
Protected Attributes |
Private Member Functions |
Private Attributes
assClozeTest Class Reference
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) | |
| MUST return an array of the question settings that can be stored in the log. More... | |
| solutionValuesToText (array $solution_values) | |
| MUST convert the given solution values into text. More... | |
| 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) | |
| 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 () | |
| 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 () | |
| 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 () | |
| 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) | |
| 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) | |
| validateSolutionSubmit () | |
| toLog (AdditionalInformationGenerator $additional_info) | |
| answerToParticipantInteraction (AdditionalInformationGenerator $additional_info, int $test_id, int $active_id, int $pass, string $source_ip, TestParticipantInteractionTypes $interaction_type) | |
| toQuestionAdministrationInteraction (AdditionalInformationGenerator $additional_info, int $test_id, TestQuestionAdministrationInteractionTypes $interaction_type) | |
| saveAdditionalQuestionDataToDb () | |
| Saves a record to the question types additional data table. More... | |
| saveAnswerSpecificDataToDb () | |
| Saves the answer specific records into a question types answer table. More... | |
| Public Member Functions inherited from iQuestionCondition | |
| 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 (?int $index=null) | |
| If index is null, the function returns an array with all anwser options else it returns the specific answer option. More... | |
| toJSON () | |
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) | |
| MUST convert the given solution values into an array or a string that can be stored in the log. More... | |
| 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) | |
| 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) | |
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 | 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
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.
88 {
89 global $DIC;
91 $this->setQuestion($question); // @TODO: Should this be $question?? See setter for why this is not trivial.
92 $this->randomGroup = $DIC->refinery()->random();
93 }
References assQuestion\$author, assQuestion\$comment, $DIC, assQuestion\$owner, assQuestion\$question, assQuestion\$title, ILIAS\GlobalScreen\Provider\__construct(), and assQuestion\setQuestion().
Here is the call graph for this function:
Member Function Documentation
◆ addAnswerOptionValue()
| assClozeTest::addAnswerOptionValue | ( | int | $qIndex, |
| string | $answerOptionValue, | ||
| float | $points | ||
| ) |
Reimplemented from assQuestion.
Definition at line 1614 of file class.assClozeTest.php.
1614 : void
1615 {
1617
1619 $item->setOrder($gap->getItemCount());
1620
1621 $gap->addItem($item);
1622 }
This file is part of ILIAS, a powerful learning management system published by ILIAS open source e-Le...
Definition: class.assAnswerCloze.php:36
References assClozeGap\addItem(), assClozeGap\getItemCount(), and ASS_AnswerSimple\setOrder().
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 @access public
- See also
- $gaps
Definition at line 626 of file class.assClozeTest.php.
626 : void
627 {
628 if (array_key_exists($gap_index, $this->gaps)) {
630 // only allow notation with "." for real numbers
631 $answer = str_replace(",", ".", $answer);
632 }
634 }
635 }
References assClozeGap\TYPE_NUMERIC.
◆ 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 @access public
- See also
- $gaps
Definition at line 697 of file class.assClozeTest.php.
697 : void
698 {
699 $this->gaps[$index] = $gap;
700 }
◆ 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 @access public
- See also
- $gaps
Definition at line 677 of file class.assClozeTest.php.
677 : void
678 {
679 if (array_key_exists($gap_index, $this->gaps)) {
681 "",
682 0,
683 $this->gaps[$gap_index]->getItemCount()
684 );
685 $this->gaps[$gap_index]->addItem($answer);
686 }
687 }
◆ calculateCombinationResult()
| assClozeTest::calculateCombinationResult | ( | $user_result | ) |
Definition at line 1399 of file class.assClozeTest.php.
1399 : array
1400 {
1401 $points = 0;
1402
1404 $gap_used_in_combination = [];
1405 if ($assClozeGapCombinationObj->combinationExistsForQid($this->getId())) {
1406 $combinations_for_question = $assClozeGapCombinationObj->getCleanCombinationArray($this->getId());
1407 $gap_answers = [];
1408
1409 foreach ($user_result as $user_result_build_list) {
1410 if (is_array($user_result_build_list)) {
1411 $gap_answers[$user_result_build_list['gap_id']] = $user_result_build_list['value'];
1412 }
1413 }
1414
1415 foreach ($combinations_for_question as $combination) {
1416 foreach ($combination as $row_key => $row_answers) {
1417 $combination_fulfilled = true;
1418 $points_for_combination = $row_answers['points'];
1419 foreach ($row_answers as $gap_key => $combination_gap_answer) {
1420 if ($gap_key !== 'points') {
1421 $gap_used_in_combination[$gap_key] = $gap_key;
1422 }
1423 if ($combination_fulfilled && array_key_exists($gap_key, $gap_answers)) {
1424 switch ($combination_gap_answer['type']) {
1426 $is_text_gap_correct = $this->getTextgapPoints($gap_answers[$gap_key], $combination_gap_answer['answer'], 1);
1427 if ($is_text_gap_correct != 1) {
1428 $combination_fulfilled = false;
1429 }
1430 break;
1432 $answer = $this->gaps[$gap_key]->getItem($gap_answers[$gap_key]);
1433 $answertext = $answer?->getAnswertext();
1434 if ($answertext != $combination_gap_answer['answer']) {
1435 $combination_fulfilled = false;
1436 }
1437 break;
1439 $answer = $this->gaps[$gap_key]->getItem(0);
1440 if ($combination_gap_answer['answer'] != 'out_of_bound') {
1441 $is_numeric_gap_correct = $this->getNumericgapPoints($answer->getAnswertext(), $gap_answers[$gap_key], 1, $answer->getLowerBound(), $answer->getUpperBound());
1442 if ($is_numeric_gap_correct != 1) {
1443 $combination_fulfilled = false;
1444 }
1445 } else {
1446 $wrong_is_the_new_right = $this->getNumericgapPoints($answer->getAnswertext(), $gap_answers[$gap_key], 1, $answer->getLowerBound(), $answer->getUpperBound());
1447 if ($wrong_is_the_new_right == 1) {
1448 $combination_fulfilled = false;
1449 }
1450 }
1451 break;
1452 }
1453 } else {
1454 if ($gap_key !== 'points') {
1455 $combination_fulfilled = false;
1456 }
1457 }
1458 }
1459 if ($combination_fulfilled) {
1460 $points += $points_for_combination;
1461 }
1462 }
1463 }
1464 }
1466 }
This file is part of ILIAS, a powerful learning management system published by ILIAS open source e-Le...
Definition: class.assClozeGapCombination.php:20
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...
Definition: class.assClozeTest.php:885
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...
Definition: class.assClozeTest.php:937
References ILIAS\Survey\Mode\getId(), assClozeGap\TYPE_NUMERIC, assClozeGap\TYPE_SELECT, and assClozeGap\TYPE_TEXT.
Here is the call graph for this function:
◆ calculateReachedPoints()
| assClozeTest::calculateReachedPoints | ( | int | $active_id, |
| ?int | $pass = null, |
||
| bool | $authorized_solution = true |
||
| ) |
Reimplemented from assQuestion.
Definition at line 968 of file class.assClozeTest.php.
972 : float {
973 $user_result = $this->fetchUserResult($active_id, $pass, $authorized_solution);
975 }
calculateReachedPointsForSolution(?array $user_result, array &$detailed=[])
Definition: class.assClozeTest.php:1471
fetchUserResult(int $active_id, ?int $pass)
Definition: class.assClozeTest.php:988
◆ calculateReachedPointsForSolution()
|
protected |
- Parameters
-
array $user_result array $detailed
Definition at line 1471 of file class.assClozeTest.php.
1471 : float
1472 {
1473 $points = 0.0;
1474
1476 $combinations[1] = [];
1477 if ($this->gap_combinations_exist) {
1478 $combinations = $this->calculateCombinationResult($user_result);
1479 $points = $combinations[0];
1480 }
1481
1482 $solution_values_text = []; // for identical scoring checks
1483 $solution_values_select = []; // for identical scoring checks
1484 $solution_values_numeric = []; // for identical scoring checks
1485 foreach ($user_result as $gap_id => $value) {
1486 if (is_string($value)) {
1487 $value = ["value" => $value];
1488 }
1489
1490 if (array_key_exists($gap_id, $this->gaps) && !array_key_exists($gap_id, $combinations[1])) {
1491 switch ($this->gaps[$gap_id]->getType()) {
1493 $gappoints = 0.0;
1494 for ($order = 0; $order < $this->gaps[$gap_id]->getItemCount(); $order++) {
1495 $answer = $this->gaps[$gap_id]->getItem($order);
1496 $gotpoints = $this->getTextgapPoints($answer->getAnswertext(), $value["value"], $answer->getPoints());
1497 if ($gotpoints > $gappoints) {
1498 $gappoints = $gotpoints;
1499 }
1500 }
1502 // check if the same solution text was already entered
1503 if ((in_array($value["value"], $solution_values_text)) && ($gappoints > 0.0)) {
1504 $gappoints = 0.0;
1505 }
1506 }
1507 $points += $gappoints;
1508 $detailed[$gap_id] = ["points" => $gappoints, "best" => ($this->getMaximumGapPoints($gap_id) == $gappoints) ? true : false, "positive" => ($gappoints > 0.0) ? true : false];
1509 array_push($solution_values_text, $value["value"]);
1510 break;
1512 $gappoints = 0.0;
1513 for ($order = 0; $order < $this->gaps[$gap_id]->getItemCount(); $order++) {
1514 $answer = $this->gaps[$gap_id]->getItem($order);
1515 $gotpoints = $this->getNumericgapPoints($answer->getAnswertext(), $value["value"], $answer->getPoints(), $answer->getLowerBound(), $answer->getUpperBound());
1516 if ($gotpoints > $gappoints) {
1517 $gappoints = $gotpoints;
1518 }
1519 }
1521 // check if the same solution value was already entered
1523 $eval->suppress_errors = true;
1524 $found_value = false;
1525 foreach ($solution_values_numeric as $solval) {
1526 if ($eval->e($solval) == $eval->e($value["value"])) {
1527 $found_value = true;
1528 }
1529 }
1530 if ($found_value && ($gappoints > 0.0)) {
1531 $gappoints = 0.0;
1532 }
1533 }
1534 $points += $gappoints;
1535 $detailed[$gap_id] = ["points" => $gappoints, "best" => ($this->getMaximumGapPoints($gap_id) == $gappoints) ? true : false, "positive" => ($gappoints > 0.0) ? true : false];
1536 array_push($solution_values_numeric, $value["value"]);
1537 break;
1539 if ($value["value"] >= 0.0) {
1540 for ($order = 0; $order < $this->gaps[$gap_id]->getItemCount(); $order++) {
1541 $answer = $this->gaps[$gap_id]->getItem($order);
1542 if ($value["value"] == $answer->getOrder()) {
1543 $answerpoints = $answer->getPoints();
1545 // check if the same solution value was already entered
1546 if ((in_array($answer->getAnswertext(), $solution_values_select)) && ($answerpoints > 0.0)) {
1547 $answerpoints = 0.0;
1548 }
1549 }
1550 $points += $answerpoints;
1551 $detailed[$gap_id] = ["points" => $answerpoints, "best" => ($this->getMaximumGapPoints($gap_id) == $answerpoints) ? true : false, "positive" => ($answerpoints > 0.0) ? true : false];
1552 array_push($solution_values_select, $answer->getAnswertext());
1553 }
1554 }
1555 }
1556 break;
1557 }
1558 }
1559 }
1560
1562 }
Definition: class.EvalMath.php:90
getMaximumGapPoints($gap_index)
Returns the maximum points for a gap.
Definition: class.assClozeTest.php:1211
calculateCombinationResult($user_result)
Definition: class.assClozeTest.php:1399
getIdenticalScoring()
Returns the identical scoring status of the question.
Definition: class.assClozeTest.php:1148
References true, assClozeGap\TYPE_NUMERIC, assClozeGap\TYPE_SELECT, and assClozeGap\TYPE_TEXT.
◆ calculateReachedPointsFromPreviewSession()
| assClozeTest::calculateReachedPointsFromPreviewSession | ( | ilAssQuestionPreviewSession | $preview_session | ) |
Reimplemented from assQuestion.
Definition at line 1564 of file class.assClozeTest.php.
1564 : float
1565 {
1566 $participant_session = $preview_session->getParticipantsSolution();
1567
1568 if (!is_array($participant_session)) {
1569 return 0.0;
1570 }
1571
1572 $user_solution = [];
1573
1574 foreach ($participant_session as $key => $val) {
1575 $user_solution[$key] = ['gap_id' => $key, 'value' => $val];
1576 }
1577
1578 $reached_points = $this->calculateReachedPointsForSolution($user_solution);
1579
1581 }
ensureNonNegativePoints(float $points)
Definition: class.assQuestion.php:1807
getParticipantsSolution()
Definition: class.ilAssQuestionPreviewSession.php:96
References ilAssQuestionPreviewSession\getParticipantsSolution().
Here is the call graph for this function:
◆ checkForValidFormula()
| assClozeTest::checkForValidFormula | ( | string | $value | ) |
Definition at line 963 of file class.assClozeTest.php.
963 : int
964 {
965 return preg_match("/^-?(\\d*)(,|\\.|\\/){0,1}(\\d*)$/", $value, $matches);
966 }
◆ 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.
119 : string
120 {
121 if ($text === null) {
122 return '';
123 }
124 // fau: fixGapReplace - mask dollars for replacement
125 $text = str_replace('$', 'GAPMASKEDDOLLAR', $text);
126 $text = preg_replace("/\[gap[^\]]*?\]/", "[gap]", $text);
127 $text = preg_replace("/<gap([^>]*?)>/", "[gap]", $text);
128 $text = str_replace("</gap>", "[/gap]", $text);
129 $text = str_replace('GAPMASKEDDOLLAR', '$', $text);
130 // fau.
131 return $text;
132 }
◆ clearGapAnswers()
| assClozeTest::clearGapAnswers | ( | ) |
Removes all answers from the gaps.
@access public
- See also
- $gaps
Definition at line 593 of file class.assClozeTest.php.
593 : void
594 {
595 foreach ($this->gaps as $gap_index => $gap) {
596 $this->gaps[$gap_index]->clearItems();
597 }
598 }
◆ cloneQuestionTypeSpecificProperties()
| assClozeTest::cloneQuestionTypeSpecificProperties | ( | \assQuestion | $target | ) |
Definition at line 784 of file class.assClozeTest.php.
786 : \assQuestion {
787 if ($this->gap_combinations_exist) {
789 $gap_combination->clearGapCombinationsFromDb($target->getId());
790 $gap_combination->importGapCombinationToDb(
791 $target->getId(),
792 $this->gap_combinations,
793 );
794 }
795 return $target;
796 }
Definition: class.assQuestion.php:53
References assQuestion\getId().
Here is the call graph for this function:
◆ createGapsFromQuestiontext()
| assClozeTest::createGapsFromQuestiontext | ( | ) |
Create gap entries by parsing the question text.
@access public
- See also
- $gaps
Definition at line 540 of file class.assClozeTest.php.
540 : void
541 {
542 $search_pattern = "|\[gap\](.*?)\[/gap\]|i";
543 preg_match_all($search_pattern, $this->getClozeText(), $found);
544 $this->gaps = [];
545 if (count($found[0])) {
546 foreach ($found[1] as $gap_index => $answers) {
547 // create text gaps by default
549 $textparams = preg_split("/(?<!\\\\),/", $answers);
550 foreach ($textparams as $key => $value) {
552 $gap->addItem($answer);
553 }
554 $this->gaps[$gap_index] = $gap;
555 }
556 }
557 }
References assClozeGap\addItem(), and assClozeGap\TYPE_TEXT.
Here is the call 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 @access public
- See also
- $gaps
Definition at line 828 of file class.assClozeTest.php.
828 : void
829 {
830 if (array_key_exists($gap_index, $this->gaps)) {
831 if ($this->gaps[$gap_index]->getItemCount() == 1) {
832 // this is the last answer text => remove the gap
833 $this->deleteGap($gap_index);
834 } else {
835 // remove the answer text
836 $this->gaps[$gap_index]->deleteItem($answer_index);
837 $this->updateClozeTextFromGaps();
838 }
839 }
840 }
updateClozeTextFromGaps()
Updates the gap parameters in the cloze text from the form input.
Definition: class.assClozeTest.php:803
◆ 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 @access public
- See also
- $gaps
Definition at line 850 of file class.assClozeTest.php.
850 : void
851 {
852 if (array_key_exists($gap_index, $this->gaps)) {
853 $output = $this->getClozeText();
855 $answers = [];
856 foreach ($gap->getItemsRaw() as $item) {
857 array_push($answers, str_replace(",", "\\,", $item->getAnswerText()));
858 }
859 if ($replace_gap_index == $gap_index) {
860 // fau: fixGapReplace - use replace function
862 // fau.
863 } else {
864 // fau: fixGapReplace - use replace function
866 // fau.
867 }
868 }
869 $output = str_replace("_gap]", "gap]", $output);
870 $this->cloze_text = $output;
871 unset($this->gaps[$gap_index]);
872 $this->gaps = array_values($this->gaps);
873 }
874 }
replaceFirstGap(string $gaptext, string $content)
Definition: class.assClozeTest.php:134
References assClozeGap\getItemsRaw().
Here is the call graph for this function:
◆ fetchAnswerValueForGap()
| assClozeTest::fetchAnswerValueForGap | ( | $userSolution, | |
| $gapIndex | |||
| ) |
Definition at line 1583 of file class.assClozeTest.php.
1583 : string
1584 {
1585 $answerValue = '';
1586
1587 foreach ($userSolution as $value1 => $value2) {
1588 if ($value1 == $gapIndex) {
1589 $answerValue = $value2;
1590 break;
1591 }
1592 }
1593
1594 return $answerValue;
1595 }
◆ fetchSolutionSubmit()
| assClozeTest::fetchSolutionSubmit | ( | ) |
Definition at line 1025 of file class.assClozeTest.php.
1025 : array
1026 {
1027 $solution_submit = [];
1028 $post_wrapper = $this->dic->http()->wrapper()->post();
1030 if (!$post_wrapper->has("gap_$index")) {
1031 continue;
1032 }
1033 $value = trim($post_wrapper->retrieve(
1034 "gap_$index",
1035 $this->dic->refinery()->kindlyTo()->string()
1036 ));
1037 if ($value === '') {
1038 continue;
1039 }
1040
1042 continue;
1043 }
1044
1046 $value = str_replace(',', '.', $value);
1047 if (!is_numeric($value)) {
1048 $value = null;
1049 }
1050 }
1051
1052 $solution_submit[$index] = $value;
1053 }
1054
1055 return $solution_submit;
1056 }
References assClozeGap\getType(), assClozeGap\TYPE_NUMERIC, and assClozeGap\TYPE_SELECT.
Here is the call graph for this function:
◆ fetchUserResult()
|
private |
Definition at line 988 of file class.assClozeTest.php.
991 : array {
992 if (is_null($pass)) {
993 $pass = $this->getSolutionMaxPass($active_id);
994 }
995
997 $user_result = [];
1000 continue;
1001 }
1005 ];
1006 }
1007
1008 ksort($user_result);
1009 return $user_result;
1010 }
getCurrentSolutionResultSet(int $active_id, int $pass, bool $authorized=true)
Definition: class.assQuestion.php:2357
getSolutionMaxPass(int $active_id)
Definition: class.assQuestion.php:1767
◆ flushGaps()
| assClozeTest::flushGaps | ( | ) |
Definition at line 413 of file class.assClozeTest.php.
413 : void
414 {
415 $this->gaps = [];
416 }
◆ getAdditionalTableName()
| assClozeTest::getAdditionalTableName | ( | ) |
Returns the name of the additional question data table in the database.
- Returns
- string The additional table name @access public
Reimplemented from assQuestion.
Definition at line 1171 of file class.assClozeTest.php.
1171 : string
1172 {
1173 return "qpl_qst_cloze";
1174 }
◆ getAnswerTableName()
| assClozeTest::getAnswerTableName | ( | ) |
Reimplemented from assQuestion.
Definition at line 1176 of file class.assClozeTest.php.
1176 : array
1177 {
1178 return ["qpl_a_cloze",'qpl_a_cloze_combi_res'];
1179 }
◆ 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.
◆ getClozeText()
| assClozeTest::getClozeText | ( | ) |
Returns the cloze text.
- Returns
- string The cloze text string @access public
- See also
- $cloze_text
Definition at line 437 of file class.assClozeTest.php.
437 : string
438 {
440 }
Referenced by isComplete().
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.
450 : string
451 {
452 $gaps = [];
455 $cleaned_text = $this->getHtmlQuestionContentPurifier()->purify(
456 $string_with_replaced_gaps
457 );
458 $cleaned_text_with_gaps = preg_replace_callback('/######GAP######/', function ($match) use (&$gaps) {
460 }, $cleaned_text);
461
463 || !(new ilSetting('advanced_editing'))->get('advanced_editing_javascript_editor') === 'tinymce') {
464 $cleaned_text_with_gaps = nl2br($cleaned_text_with_gaps);
465 }
466
468 }
getHtmlQuestionContentPurifier()
Definition: class.assQuestion.php:2330
isAdditionalContentEditingModePageObject()
Definition: class.assQuestion.php:2297
static prepareTextareaOutput(string $txt_output, bool $prepare_for_latex_output=false, bool $omitNl2BrWhenTextArea=false)
Prepares a string for a text area output where latex code may be in it If the text is HTML-free,...
Definition: class.ilLegacyFormElementsUtil.php:109
References ilLegacyFormElementsUtil\prepareTextareaOutput().
Here is the call graph for this function:
◆ getCorrectSolutionForTextOutput()
| assClozeTest::getCorrectSolutionForTextOutput | ( | int | $active_id, |
| int | $pass | ||
| ) |
Reimplemented from assQuestion.
Definition at line 1712 of file class.assClozeTest.php.
1712 : array
1713 {
1714 $answers = [];
1716 $correct_answers = array_map(
1717 fn(int $v): string => $gap->getItem($v)->getAnswertext(),
1718 $gap->getBestSolutionIndexes()
1719 );
1721 . implode(',', $correct_answers);
1722 }
1723 return $answers;
1724 }
References assClozeGap\getBestSolutionIndexes(), assClozeGap\getItem(), and ILIAS\Repository\lng().
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 @access public
- See also
- $end_tag
Definition at line 501 of file class.assClozeTest.php.
501 : string
502 {
504 }
◆ 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.
1323 : array
1324 {
1325 return [
1331 ];
1332 }
const PercentageResultExpression
Definition: interface.iQuestionCondition.php:28
const StringResultExpression
Definition: interface.iQuestionCondition.php:27
const NumericResultExpression
Definition: interface.iQuestionCondition.php:29
const EmptyAnswerExpression
Definition: interface.iQuestionCondition.php:34
const NumberOfResultExpression
Definition: interface.iQuestionCondition.php:32
References iQuestionCondition\EmptyAnswerExpression, iQuestionCondition\NumberOfResultExpression, iQuestionCondition\NumericResultExpression, iQuestionCondition\PercentageResultExpression, and iQuestionCondition\StringResultExpression.
◆ getFeedbackMode()
| assClozeTest::getFeedbackMode | ( | ) |
◆ getFixedTextLength()
| assClozeTest::getFixedTextLength | ( | ) |
Gets the fixed text length for all text fields in the cloze question.
- Returns
- integer The text field length @access public
Definition at line 1198 of file class.assClozeTest.php.
1198 : ?int
1199 {
1201 }
◆ getGap()
| assClozeTest::getGap | ( | int | $gap_index = 0 | ) |
Definition at line 637 of file class.assClozeTest.php.
637 : ?assClozeGap
638 {
639 if (array_key_exists($gap_index, $this->gaps)) {
640 return $this->gaps[$gap_index];
641 }
642 return null;
643 }
◆ getGapCombinations()
| assClozeTest::getGapCombinations | ( | ) |
Definition at line 1240 of file class.assClozeTest.php.
1240 : array
1241 {
1243 }
◆ getGapCombinationsExists()
| assClozeTest::getGapCombinationsExists | ( | ) |
Definition at line 1235 of file class.assClozeTest.php.
◆ getGapCount()
| assClozeTest::getGapCount | ( | ) |
Returns the number of gaps.
- Returns
- integer The number of gaps @access public
- See also
- $gaps
Definition at line 607 of file class.assClozeTest.php.
607 : int
608 {
609 if (is_array($this->gaps)) {
610 return count($this->gaps);
611 } else {
612 return 0;
613 }
614 }
◆ getGaps()
| assClozeTest::getGaps | ( | ) |
Definition at line 408 of file class.assClozeTest.php.
Referenced by isComplete().
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 @access public
Definition at line 1148 of file class.assClozeTest.php.
1148 : bool
1149 {
1151 }
bool $identical_scoring
Defines the scoring for "identical solutions".
Definition: class.assClozeTest.php:75
◆ 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 @access public
- See also
- $points
Definition at line 1211 of file class.assClozeTest.php.
1212 {
1213 $points = 0;
1214 $gap_max_points = 0;
1215 if (array_key_exists($gap_index, $this->gaps)) {
1216 $gap = &$this->gaps[$gap_index];
1217 foreach ($gap->getItems($this->getShuffler()) as $answer) {
1218 if ($answer->getPoints() > $gap_max_points) {
1219 $gap_max_points = $answer->getPoints();
1220 }
1221 }
1222 $points += $gap_max_points;
1223 }
1225 }
References assClozeGap\getItems().
Here is the call graph for this function:
◆ getMaximumPoints()
| assClozeTest::getMaximumPoints | ( | ) |
Returns the maximum points, a learner can reach answering the question.
@access public
- See also
- $points
Reimplemented from assQuestion.
Definition at line 742 of file class.assClozeTest.php.
742 : float
743 {
745 $points = 0;
746 $gaps_used_in_combination = [];
747 if ($this->gap_combinations_exist) {
749 $gaps_used_in_combination = $assClozeGapCombinationObj->getGapsWhichAreUsedInCombination($this->getId());
750 }
751 foreach ($this->gaps as $gap_index => $gap) {
752 if (!array_key_exists($gap_index, $gaps_used_in_combination)) {
754 $gap_max_points = 0;
755 foreach ($gap->getItems($this->getShuffler()) as $item) {
756 if ($item->getPoints() > $gap_max_points) {
757 $gap_max_points = $item->getPoints();
758 }
759 }
760 $points += $gap_max_points;
761 } elseif ($gap->getType() == assClozeGap::TYPE_SELECT) {
762 $srpoints = 0;
763 foreach ($gap->getItems($this->getShuffler()) as $item) {
764 if ($item->getPoints() > $srpoints) {
765 $srpoints = $item->getPoints();
766 }
767 }
768 $points += $srpoints;
769 } elseif ($gap->getType() == assClozeGap::TYPE_NUMERIC) {
770 $numpoints = 0;
771 foreach ($gap->getItems($this->getShuffler()) as $item) {
772 if ($item->getPoints() > $numpoints) {
773 $numpoints = $item->getPoints();
774 }
775 }
776 $points += $numpoints;
777 }
778 }
779 }
780
782 }
References ILIAS\Survey\Mode\getId(), assClozeGap\getItems(), assClozeGap\getType(), assClozeGap\TYPE_NUMERIC, assClozeGap\TYPE_SELECT, and assClozeGap\TYPE_TEXT.
Referenced by isComplete().
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 @access public
Definition at line 937 of file class.assClozeTest.php.
937 : float
938 {
940 $eval->suppress_errors = true;
941 $result = 0.0;
942
943 if ($eval->e($a_entered) === false) {
944 return 0.0;
945 } elseif (($eval->e($lowerBound) !== false) && ($eval->e($upperBound) !== false)) {
946 if (($eval->e($a_entered) >= $eval->e($lowerBound)) && ($eval->e($a_entered) <= $eval->e($upperBound))) {
947 $result = $max_points;
948 }
949 } elseif ($eval->e($lowerBound) !== false) {
950 if (($eval->e($a_entered) >= $eval->e($lowerBound)) && ($eval->e($a_entered) <= $eval->e($a_original))) {
951 $result = $max_points;
952 }
953 } elseif ($eval->e($upperBound) !== false) {
954 if (($eval->e($a_entered) >= $eval->e($a_original)) && ($eval->e($a_entered) <= $eval->e($upperBound))) {
955 $result = $max_points;
956 }
957 } elseif ($eval->e($a_entered) == $eval->e($a_original)) {
958 $result = $max_points;
959 }
960 return $result;
961 }
◆ 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.
1318 : array
1319 {
1321 }
static getOperatorsByExpression(string $expression)
Definition: class.ilOperatorsExpressionMapping.php:42
References ilOperatorsExpressionMapping\getOperatorsByExpression().
Here is the call graph for this function:
◆ getQuestionType()
| assClozeTest::getQuestionType | ( | ) |
Returns the question type of the question.
- Returns
- integer The question type of the question @access public
Reimplemented from assQuestion.
Definition at line 1099 of file class.assClozeTest.php.
1099 : string
1100 {
1101 return "assClozeTest";
1102 }
◆ getRTETextWithMediaObjects()
| assClozeTest::getRTETextWithMediaObjects | ( | ) |
Collects all text in the question which could contain media objects which were created with the Rich Text Editor.
Reimplemented from assQuestion.
Definition at line 1231 of file class.assClozeTest.php.
1231 : string
1232 {
1234 }
◆ getSolutionSubmit()
|
protected |
Definition at line 1058 of file class.assClozeTest.php.
1058 : array
1059 {
1061 }
◆ getStartTag()
| assClozeTest::getStartTag | ( | ) |
Returns the start tag of a cloze gap.
- Returns
- string The start tag of a cloze gap @access public
- See also
- $start_tag
Definition at line 477 of file class.assClozeTest.php.
477 : string
478 {
480 }
◆ 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 @access public
Definition at line 885 of file class.assClozeTest.php.
885 : float
886 {
887 global $DIC;
889 $result = 0;
890 $gaprating = $this->getTextgapRating();
891
892 switch ($gaprating) {
895 $result = $max_points;
896 }
897 break;
899 if (strcmp($a_original, $a_entered) == 0) {
900 $result = $max_points;
901 }
902 break;
904 $transformation = $refinery->string()->levenshtein()->standard($a_original, 1);
905 break;
907 $transformation = $refinery->string()->levenshtein()->standard($a_original, 2);
908 break;
910 $transformation = $refinery->string()->levenshtein()->standard($a_original, 3);
911 break;
913 $transformation = $refinery->string()->levenshtein()->standard($a_original, 4);
914 break;
916 $transformation = $refinery->string()->levenshtein()->standard($a_original, 5);
917 break;
918 }
919
920 // run answers against Levenshtein2 methods
921 if (isset($transformation) && $transformation->transform($a_entered) >= 0) {
922 $result = $max_points;
923 }
924 return $result;
925 }
const TEXTGAP_RATING_CASESENSITIVE
Definition: class.assClozeGap.php:40
const TEXTGAP_RATING_LEVENSHTEIN1
Definition: class.assClozeGap.php:41
const TEXTGAP_RATING_LEVENSHTEIN5
Definition: class.assClozeGap.php:45
const TEXTGAP_RATING_CASEINSENSITIVE
Definition: class.assClozeGap.php:39
const TEXTGAP_RATING_LEVENSHTEIN4
Definition: class.assClozeGap.php:44
const TEXTGAP_RATING_LEVENSHTEIN2
Definition: class.assClozeGap.php:42
const TEXTGAP_RATING_LEVENSHTEIN3
Definition: class.assClozeGap.php:43
References $DIC, ILIAS\UI\examples\Layout\Page\Standard\$refinery, 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.
Here is the call 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 @access public
Definition at line 1111 of file class.assClozeTest.php.
1111 : string
1112 {
1114 }
◆ 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.
1337 : ilUserQuestionResult {
1339
1340 $maxStep = $this->lookupMaxStep($active_id, $pass);
1341 if ($maxStep > 0) {
1342 $data = $this->db->queryF(
1343 "
1344 SELECT sol.value1+1 as val, sol.value2, cloze.cloze_type
1345 FROM tst_solutions sol
1346 INNER JOIN qpl_a_cloze cloze ON cloze.gap_id = value1 AND cloze.question_fi = sol.question_fi
1347 WHERE sol.active_fi = %s AND sol.pass = %s AND sol.question_fi = %s AND sol.step = %s
1348 GROUP BY sol.solution_id, sol.value1+1, sol.value2, cloze.cloze_type
1349 ",
1350 ["integer", "integer", "integer","integer"],
1351 [$active_id, $pass, $this->getId(), $maxStep]
1352 );
1353 } else {
1354 $data = $this->db->queryF(
1355 "
1356 SELECT sol.value1+1 as val, sol.value2, cloze.cloze_type
1357 FROM tst_solutions sol
1358 INNER JOIN qpl_a_cloze cloze ON cloze.gap_id = value1 AND cloze.question_fi = sol.question_fi
1359 WHERE sol.active_fi = %s AND sol.pass = %s AND sol.question_fi = %s
1360 GROUP BY sol.solution_id, sol.value1+1, sol.value2, cloze.cloze_type
1361 ",
1362 ["integer", "integer", "integer"],
1363 [$active_id, $pass, $this->getId()]
1364 );
1365 }
1366
1368 if ($row["cloze_type"] == 1) {
1369 $row["value2"]++;
1370 }
1371 $result->addKeyValue($row["val"], $row["value2"]);
1372 }
1373
1375 $max_points = $this->getMaximumPoints();
1376
1377 $result->setReachedPercentage(($points / $max_points) * 100);
1378
1379 return $result;
1380 }
calculateReachedPoints(int $active_id, ?int $pass=null, bool $authorized_solution=true)
Definition: class.assClozeTest.php:968
getMaximumPoints()
Returns the maximum points, a learner can reach answering the question.
Definition: class.assClozeTest.php:742
lookupMaxStep(int $active_id, int $pass)
Definition: class.assQuestion.php:2681
This file is part of ILIAS, a powerful learning management system published by ILIAS open source e-Le...
Definition: class.ilUserQuestionResult.php:27
◆ getUserResultDetails()
| assClozeTest::getUserResultDetails | ( | int | $active_id, |
| ?int | $pass = null, |
||
| bool | $authorized_solution = true |
||
| ) |
Definition at line 977 of file class.assClozeTest.php.
981 : array {
982 $user_result = $this->fetchUserResult($active_id, $pass, $authorized_solution);
983 $detailed = [];
984 $this->calculateReachedPointsForSolution($user_result, $detailed);
985 return $detailed;
986 }
◆ isAddableAnswerOptionValue()
| assClozeTest::isAddableAnswerOptionValue | ( | int | $qIndex, |
| string | $answerOptionValue | ||
| ) |
Reimplemented from assQuestion.
Definition at line 1597 of file class.assClozeTest.php.
1597 : bool
1598 {
1599 $gap = $this->getGap($qIndex);
1600
1602 return false;
1603 }
1604
1605 foreach ($gap->getItems($this->randomGroup->dontShuffle()) as $item) {
1606 if ($item->getAnswertext() === $answerOptionValue) {
1607 return false;
1608 }
1609 }
1610
1611 return true;
1612 }
References assClozeGap\getItems(), assClozeGap\getType(), and assClozeGap\TYPE_TEXT.
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
Reimplemented from assQuestion.
Definition at line 100 of file class.assClozeTest.php.
100 : bool
101 {
103 && $this->getAuthor()
104 && $this->getClozeText()
105 && count($this->getGaps())
106 && $this->getMaximumPoints() > 0) {
107 return true;
108 }
109 return false;
110 }
References assQuestion\getAuthor(), getClozeText(), getGaps(), getMaximumPoints(), and assQuestion\getTitle().
Here is the call graph for this function:
◆ isValidNumericSubmitValue()
|
protected |
Definition at line 1012 of file class.assClozeTest.php.
1012 : bool
1013 {
1014 if (is_numeric($submittedValue)) {
1015 return true;
1016 }
1017
1018 if (preg_match('/^[-+]{0,1}\d+\/\d+$/', $submittedValue)) {
1019 return true;
1020 }
1021
1022 return false;
1023 }
◆ lmMigrateQuestionTypeSpecificContent()
|
protected |
- Parameters
-
ilAssSelfAssessmentMigrator $migrator
Reimplemented from assQuestion.
Definition at line 1258 of file class.assClozeTest.php.
1258 : void
1259 {
1260 // DO NOT USE SETTER FOR CLOZE TEXT -> SETTER DOES RECREATE GAP OBJECTS without having gap type info ^^
1261 //$this->setClozeText( $migrator->migrateToLmContent($this->getClozeText()) );
1263 // DO NOT USE SETTER FOR CLOZE TEXT -> SETTER DOES RECREATE GAP OBJECTS without having gap type info ^^
1264 }
migrateToLmContent($content)
References ilAssSelfAssessmentMigrator\migrateToLmContent().
Here is the call graph for this function:
◆ loadFromDb()
| assClozeTest::loadFromDb | ( | int | $question_id | ) |
Reimplemented from assQuestion.
Definition at line 147 of file class.assClozeTest.php.
147 : void
148 {
149 $result = $this->db->queryF(
150 "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",
151 ["integer"],
152 [$question_id]
153 );
154 if ($result->numRows() == 1) {
155 $data = $this->db->fetchAssoc($result);
156 $this->setId($question_id);
169 $this->setFeedbackMode($data['feedback_mode'] === null ? ilAssClozeTestFeedback::FB_MODE_GAP_QUESTION : $data['feedback_mode']);
170
171 try {
175 }
176
177 $this->question = ilRTE::_replaceMediaObjectImageSrc($this->question, 1);
178 $this->cloze_text = ilRTE::_replaceMediaObjectImageSrc($this->cloze_text, 1);
180
181 try {
184 }
185
186 $result = $this->db->queryF(
187 "SELECT * FROM qpl_a_cloze WHERE question_fi = %s ORDER BY gap_id, aorder ASC",
188 ["integer"],
189 [$question_id]
190 );
191 if ($result->numRows() > 0) {
192 $this->gaps = [];
198 }
203 );
205
207 break;
212 }
217 );
219 break;
223 }
228 );
233 break;
234 }
235 }
236 }
237 }
238 $check_for_gap_combinations = (new assClozeGapCombination($this->db))->loadFromDb($question_id);
239 if (count($check_for_gap_combinations) != 0) {
241 $this->setGapCombinations($check_for_gap_combinations);
242 }
243 parent::loadFromDb($question_id);
244 }
setIdenticalScoring(bool $identical_scoring)
Sets the identical scoring option for cloze questions.
Definition: class.assClozeTest.php:1160
setFixedTextLength(?int $fixed_text_length)
Sets a fixed text length for all text fields in the cloze question.
Definition: class.assClozeTest.php:1187
setTextgapRating($a_textgap_rating)
Sets the rating option for text gaps.
Definition: class.assClozeTest.php:1123
getAdditionalTableName()
Returns the name of the additional question data table in the database.
Definition: class.assClozeTest.php:1171
setGapCombinationsExists($value)
Definition: class.assClozeTest.php:1245
cleanQuestiontext($text)
Cleans cloze question text to remove attributes or tags from older ILIAS versions.
Definition: class.assClozeTest.php:119
setAdditionalContentEditingMode(?string $additionalContentEditingMode)
Definition: class.assQuestion.php:2288
setLifecycle(ilAssQuestionLifecycle $lifecycle)
Definition: class.assQuestion.php:436
const FB_MODE_GAP_QUESTION
constants for different feedback modes (per gap or per gap-answers/options)
Definition: class.ilAssClozeTestFeedback.php:34
static getDraftInstance()
Definition: class.ilAssQuestionLifecycle.php:149
static getInstance($identifier)
Definition: class.ilAssQuestionLifecycle.php:140
static _replaceMediaObjectImageSrc(string $a_text, int $a_direction=0, string $nic='')
Replaces image source from mob image urls with the mob id or replaces mob id with the correct image s...
Definition: class.ilRTE.php:228
References $data, Vendor\Package\$e, ilRTE\_replaceMediaObjectImageSrc(), ilAssClozeTestFeedback\FB_MODE_GAP_QUESTION, ilAssQuestionLifecycle\getDraftInstance(), ilAssQuestionLifecycle\getInstance(), assClozeGap\TYPE_NUMERIC, assClozeGap\TYPE_SELECT, and assClozeGap\TYPE_TEXT.
Here is the call graph for this function:
◆ replaceFirstGap()
| assClozeTest::replaceFirstGap | ( | string | $gaptext, |
| string | $content | ||
| ) |
Definition at line 134 of file class.assClozeTest.php.
137 : string {
138 $output = preg_replace(
139 '/\[gap\].*?\[\/gap\]/',
140 str_replace('$', 'GAPMASKEDDOLLAR', $content),
141 $gaptext,
142 1
143 );
144 return str_replace('GAPMASKEDDOLLAR', '$', $output);
145 }
◆ 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.
268 : void
269 {
270 $this->db->manipulateF(
272 [ "integer" ],
273 [ $this->getId() ]
274 );
275
276 $this->db->insert($this->getAdditionalTableName(), [
280 'fixed_textlen' => ['integer', $this->getFixedTextLength() ? $this->getFixedTextLength() : null],
283 ]);
284 }
getFixedTextLength()
Gets the fixed text length for all text fields in the cloze question.
Definition: class.assClozeTest.php:1198
References ilRTE\_replaceMediaObjectImageSrc(), and ILIAS\Survey\Mode\getId().
Here is the call 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.
255 : void
256 {
257 $this->db->manipulateF(
258 "DELETE FROM qpl_a_cloze WHERE question_fi = %s",
259 [ "integer" ],
260 [ $this->getId() ]
261 );
262
263 foreach ($this->gaps as $key => $gap) {
264 $this->saveClozeGapItemsToDb($gap, $key);
265 }
266 }
saveClozeGapItemsToDb(assClozeGap $gap, int $key)
Definition: class.assClozeTest.php:285
References ILIAS\Survey\Mode\getId().
Here is the call graph for this function:
◆ saveClozeGapItemsToDb()
|
protected |
Definition at line 285 of file class.assClozeTest.php.
288 : void {
290 $next_id = $this->db->nextId('qpl_a_cloze');
293 $this->saveClozeTextGapRecordToDb($next_id, $key, $item, $gap);
294 break;
296 $this->saveClozeSelectGapRecordToDb($next_id, $key, $item, $gap);
297 break;
299 $this->saveClozeNumericGapRecordToDb($next_id, $key, $item, $gap);
300 break;
301 }
302 }
303 }
getItems(Transformation $shuffler, ?int $gap_index=null)
Definition: class.assClozeGap.php:120
saveClozeSelectGapRecordToDb(int $next_id, int $key, assAnswerCloze $item, assClozeGap $gap)
Definition: class.assClozeTest.php:336
saveClozeTextGapRecordToDb(int $next_id, int $key, assAnswerCloze $item, assClozeGap $gap)
Definition: class.assClozeTest.php:305
saveClozeNumericGapRecordToDb(int $next_id, int $key, assAnswerCloze $item, assClozeGap $gap)
Definition: class.assClozeTest.php:367
References assClozeGap\getType(), assClozeGap\TYPE_NUMERIC, assClozeGap\TYPE_SELECT, and assClozeGap\TYPE_TEXT.
Here is the call graph for this function:
◆ saveClozeNumericGapRecordToDb()
|
protected |
Definition at line 367 of file class.assClozeTest.php.
372 : void {
374 $eval->suppress_errors = true;
375 $this->db->manipulateF(
376 '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)',
377 [
378 'integer',
379 'integer',
380 'integer',
381 'text',
382 'float',
383 'integer',
384 'text',
385 'text',
386 'text',
387 'integer'
388 ],
389 [
390 $next_id,
391 $this->getId(),
392 $key,
394 $item->getPoints(),
395 $item->getOrder(),
396 $gap->getType(),
398 $item->getLowerBound()
401 $item->getUpperBound()
404 ]
405 );
406 }
◆ saveClozeSelectGapRecordToDb()
|
protected |
Definition at line 336 of file class.assClozeTest.php.
341 : void {
342 $this->db->manipulateF(
343 '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)',
344 [
345 'integer',
346 'integer',
347 'integer',
348 'text',
349 'float',
350 'integer',
351 'text',
352 'text'
353 ],
354 [
355 $next_id,
356 $this->getId(),
357 $key,
359 $item->getPoints(),
360 $item->getOrder(),
361 $gap->getType(),
363 ]
364 );
365 }
◆ saveClozeTextGapRecordToDb()
|
protected |
Definition at line 305 of file class.assClozeTest.php.
310 : void {
311 $this->db->manipulateF(
312 '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)',
313 [
314 'integer',
315 'integer',
316 'integer',
317 'text',
318 'float',
319 'integer',
320 'text',
321 'integer'
322 ],
323 [
324 $next_id,
325 $this->getId(),
326 $key,
328 $item->getPoints(),
329 $item->getOrder(),
330 $gap->getType(),
332 ]
333 );
334 }
◆ saveToDb()
| assClozeTest::saveToDb | ( | ?int | $original_id = null | ) |
Reimplemented from assQuestion.
Definition at line 246 of file class.assClozeTest.php.
246 : void
247 {
249 $this->saveAdditionalQuestionDataToDb();
250 $this->saveAnswerSpecificDataToDb();
251
252 parent::saveToDb();
253 }
saveAnswerSpecificDataToDb()
Saves the answer specific records into a question types answer table.
Definition: class.assClozeTest.php:255
saveAdditionalQuestionDataToDb()
Saves a record to the question types additional data table.
Definition: class.assClozeTest.php:268
saveQuestionDataToDb(?int $original_id=null)
Definition: class.assQuestion.php:1187
◆ saveWorkingData()
| assClozeTest::saveWorkingData | ( | int | $active_id, |
| ?int | $pass = null, |
||
| bool | $authorized = true |
||
| ) |
Reimplemented from assQuestion.
Definition at line 1063 of file class.assClozeTest.php.
1067 : bool {
1068 if (is_null($pass)) {
1069 $pass = ilObjTest::_getPass($active_id);
1070 }
1071
1072 $this->getProcessLocker()->executeUserSolutionUpdateLockOperation(
1073 function () use ($active_id, $pass, $authorized) {
1074 $this->removeCurrentSolution($active_id, $pass, $authorized);
1075
1077 if ($value === null || $value === '') {
1078 continue;
1079 }
1080 $gap = $this->getGap($key);
1081 if ($gap === null
1082 || $gap->getType() === assClozeGap::TYPE_SELECT && $value === -1) {
1083 continue;
1084 }
1085 $this->saveCurrentSolution($active_id, $pass, $key, $value, $authorized);
1086 }
1087 }
1088 );
1089
1090 return true;
1091 }
saveCurrentSolution(int $active_id, int $pass, $value1, $value2, bool $authorized=true, $tstamp=0)
Definition: class.assQuestion.php:2466
removeCurrentSolution(int $active_id, int $pass, bool $authorized=true)
Definition: class.assQuestion.php:2431
static _getPass($active_id)
Retrieves the actual pass of a given user for a given test.
Definition: class.ilObjTest.php:4676
References ilObjTest\_getPass().
Here is the call graph for this function:
◆ setClozeText()
| assClozeTest::setClozeText | ( | string | $cloze_text = '' | ) |
Definition at line 418 of file class.assClozeTest.php.
418 : void
419 {
420 $this->gaps = [];
422 $this->createGapsFromQuestiontext();
423 }
createGapsFromQuestiontext()
Create gap entries by parsing the question text.
Definition: class.assClozeTest.php:540
◆ setClozeTextValue()
| assClozeTest::setClozeTextValue | ( | $cloze_text = "" | ) |
Definition at line 425 of file class.assClozeTest.php.
◆ 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 @access public
- See also
- $end_tag
Definition at line 513 of file class.assClozeTest.php.
◆ setFeedbackMode()
| assClozeTest::setFeedbackMode | ( | $feedbackMode | ) |
- Parameters
-
string $feedbackMode
Definition at line 529 of file class.assClozeTest.php.
◆ 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 @access public
Definition at line 1187 of file class.assClozeTest.php.
◆ 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 @access public
- See also
- $gaps
Definition at line 712 of file class.assClozeTest.php.
712 : void
713 {
714 if (array_key_exists($gap_index, $this->gaps)) {
715 $this->gaps[$gap_index]->setItemLowerBound($order, $bound);
716 }
717 }
◆ 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 @access public
- See also
- $gaps
Definition at line 662 of file class.assClozeTest.php.
662 : void
663 {
664 if (array_key_exists($gap_index, $this->gaps)) {
665 $this->gaps[$gap_index]->setItemPoints($order, $points);
666 }
667 }
◆ 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 @access public
- See also
- $gaps
Definition at line 729 of file class.assClozeTest.php.
729 : void
730 {
731 if (array_key_exists($gap_index, $this->gaps)) {
732 $this->gaps[$gap_index]->setItemUpperBound($order, $bound);
733 }
734 }
◆ setGapCombinations()
| assClozeTest::setGapCombinations | ( | $value | ) |
Definition at line 1250 of file class.assClozeTest.php.
1250 : void
1251 {
1252 $this->gap_combinations = $value;
1253 }
◆ setGapCombinationsExists()
| assClozeTest::setGapCombinationsExists | ( | $value | ) |
Definition at line 1245 of file class.assClozeTest.php.
1245 : void
1246 {
1247 $this->gap_combinations_exist = $value;
1248 }
◆ 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) @access public
- See also
- $gaps
Definition at line 580 of file class.assClozeTest.php.
580 : void
581 {
582 if (array_key_exists($gap_index, $this->gaps)) {
583 $this->gaps[$gap_index]->setShuffle($shuffle);
584 }
585 }
◆ setGapSize()
| assClozeTest::setGapSize | ( | $gap_index, | |
| $size | |||
| ) |
Definition at line 645 of file class.assClozeTest.php.
645 : void
646 {
647 if (array_key_exists($gap_index, $this->gaps)) {
648 $this->gaps[$gap_index]->setGapSize((int) $size);
649 }
650 }
◆ setGapType()
| assClozeTest::setGapType | ( | $gap_index, | |
| $gap_type | |||
| ) |
Set the type of a gap with a given index.
@access private
Definition at line 564 of file class.assClozeTest.php.
564 : void
565 {
566 if (array_key_exists($gap_index, $this->gaps)) {
567 $this->gaps[$gap_index]->setType($gap_type);
568 }
569 }
◆ 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 @access public
Definition at line 1160 of file class.assClozeTest.php.
◆ 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 @access public
- See also
- $start_tag
Definition at line 489 of file class.assClozeTest.php.
◆ 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 @access public
Definition at line 1123 of file class.assClozeTest.php.
1123 : void
1124 {
1125 switch ($a_textgap_rating) {
1133 $this->textgap_rating = $a_textgap_rating;
1134 break;
1135 default:
1136 $this->textgap_rating = assClozeGap::TEXTGAP_RATING_CASEINSENSITIVE;
1137 break;
1138 }
1139 }
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.
◆ solutionValuesToLog()
|
protected |
MUST convert the given solution values into an array or a string that can be stored in the log.
Language variables must be generated through the corresponding functions in the AdditionalInformationGenerator. If an array is returned it will be rendered into a line per array entry in the format "key: value". If the key exists as a language variable, it will be translated.
Reimplemented from assQuestion.
Definition at line 1668 of file class.assClozeTest.php.
1671 : array {
1672 $parsed_solution = [];
1674 foreach ($solution_values as $solutionvalue) {
1675 if ($gap_index !== (int) $solutionvalue['value1']) {
1676 continue;
1677 }
1678
1680 $parsed_solution[$gap_index + 1] = $gap->getItem($solutionvalue['value2'])->getAnswertext();
1681 continue;
1682 }
1683
1684 $parsed_solution[$gap_index + 1] = $solutionvalue['value2'];
1685 }
1686 }
1687 return $parsed_solution;
1688 }
References assClozeGap\getItem(), assClozeGap\getType(), and assClozeGap\TYPE_SELECT.
Here is the call graph for this function:
◆ solutionValuesToText()
| assClozeTest::solutionValuesToText | ( | array | $solution_values | ) |
MUST convert the given solution values into text.
If the text has multiple lines each line MUST be placed as an entry in an array.
Reimplemented from assQuestion.
Definition at line 1690 of file class.assClozeTest.php.
1690 : array
1691 {
1692 $parsed_solution = [];
1694 foreach ($solution_values as $solutionvalue) {
1695 if ($gap_index !== (int) $solutionvalue['value1']) {
1696 continue;
1697 }
1698
1701 . $gap->getItem($solutionvalue['value2'])->getAnswertext();
1702 continue;
1703 }
1704
1706 . $solutionvalue['value2'];
1707 }
1708 }
1709 return $parsed_solution;
1710 }
References assClozeGap\getItem(), assClozeGap\getType(), ILIAS\Repository\lng(), and assClozeGap\TYPE_SELECT.
Here is the call graph for this function:
◆ toJSON()
| assClozeTest::toJSON | ( | ) |
Returns a JSON representation of the question.
Reimplemented from assQuestion.
Definition at line 1269 of file class.assClozeTest.php.
1269 : string
1270 {
1271 $result = [
1279 'feedback' => [
1280 'onenotcorrect' => $this->formatSAQuestion($this->feedbackOBJ->getGenericFeedbackTestPresentation($this->getId(), false)),
1281 'allcorrect' => $this->formatSAQuestion($this->feedbackOBJ->getGenericFeedbackTestPresentation($this->getId(), true))
1282 ]
1283 ];
1284
1285 $gaps = [];
1287 $items = [];
1288 foreach ($gap->getItems($this->getShuffler()) as $item) {
1289 $jitem = [];
1290 $jitem['points'] = $item->getPoints();
1292 $jitem['order'] = $item->getOrder();
1294 $jitem['lowerbound'] = $item->getLowerBound();
1295 $jitem['upperbound'] = $item->getUpperBound();
1296 } else {
1297 $jitem['value'] = trim($jitem['value']);
1298 }
1299 array_push($items, $jitem);
1300 }
1301
1302 if ($gap->getGapSize() && ($gap->getType() == assClozeGap::TYPE_TEXT || $gap->getType() == assClozeGap::TYPE_NUMERIC)) {
1303 $jgap['size'] = $gap->getGapSize();
1304 }
1305
1306 $jgap['shuffle'] = $gap->getShuffle();
1307 $jgap['type'] = $gap->getType();
1308 $jgap['item'] = $items;
1309
1310 array_push($gaps, $jgap);
1311 }
1314 $result['mobs'] = $mobs;
1315 return json_encode($result);
1316 }
static _getMobsOfObject(string $a_type, int $a_id, int $a_usage_hist_nr=0, string $a_lang="-")
Definition: class.ilObjMediaObject.php:810
References ilObjMediaObject\_getMobsOfObject(), assClozeGap\getGapSize(), ILIAS\Survey\Mode\getId(), assClozeGap\getItems(), assClozeGap\getShuffle(), assClozeGap\getType(), assClozeGap\TYPE_NUMERIC, and assClozeGap\TYPE_TEXT.
Here is the call graph for this function:
◆ toLog()
| assClozeTest::toLog | ( | AdditionalInformationGenerator | $additional_info | ) |
MUST return an array of the question settings that can be stored in the log.
Language variables must be generated through the corresponding functions in the AdditionalInformationGenerator. If an array is returned it will be rendered into a line per array entry in the format "key: value". If the key exists as a language variable, it will be translated.
Reimplemented from assQuestion.
Definition at line 1624 of file class.assClozeTest.php.
1624 : array
1625 {
1626 $result = [
1627 AdditionalInformationGenerator::KEY_QUESTION_TYPE => (string) $this->getQuestionType(),
1628 AdditionalInformationGenerator::KEY_QUESTION_TITLE => $this->getTitleForHTMLOutput(),
1629 AdditionalInformationGenerator::KEY_QUESTION_TEXT => $this->formatSAQuestion($this->getQuestion()),
1630 AdditionalInformationGenerator::KEY_QUESTION_CLOZE_CLOZETEXT => $this->formatSAQuestion($this->getClozeText()),
1631 AdditionalInformationGenerator::KEY_QUESTION_SHUFFLE_ANSWER_OPTIONS => $additional_info
1633 AdditionalInformationGenerator::KEY_FEEDBACK => [
1634 AdditionalInformationGenerator::KEY_QUESTION_FEEDBACK_ON_INCOMPLETE => $this->formatSAQuestion($this->feedbackOBJ->getGenericFeedbackTestPresentation($this->getId(), false)),
1635 AdditionalInformationGenerator::KEY_QUESTION_FEEDBACK_ON_COMPLETE => $this->formatSAQuestion($this->feedbackOBJ->getGenericFeedbackTestPresentation($this->getId(), true))
1636 ]
1637 ];
1638
1639 $gaps = [];
1641 $items = [];
1642 foreach ($gap->getItems($this->getShuffler()) as $item) {
1643 $item_array = [
1644 AdditionalInformationGenerator::KEY_QUESTION_REACHABLE_POINTS => $item->getPoints(),
1645 AdditionalInformationGenerator::KEY_QUESTION_ANSWER_OPTION => $this->formatSAQuestion($item->getAnswertext()),
1646 AdditionalInformationGenerator::KEY_QUESTION_ANSWER_OPTION_ORDER => $item->getOrder()
1647 ];
1649 $item_array[AdditionalInformationGenerator::KEY_QUESTION_LOWER_LIMIT] = $item->getLowerBound();
1650 $item_array[AdditionalInformationGenerator::KEY_QUESTION_UPPER_LIMIT] = $item->getUpperBound();
1651 }
1652 array_push($items, $item_array);
1653 }
1654
1655 $gap_array[AdditionalInformationGenerator::KEY_QUESTION_TEXTSIZE] = $gap->getGapSize();
1656 $gap_array[AdditionalInformationGenerator::KEY_QUESTION_SHUFFLE_ANSWER_OPTIONS] = $additional_info->getTrueFalseTagForBool(
1657 $gap->getShuffle()
1658 );
1659 $gap_array[AdditionalInformationGenerator::KEY_QUESTION_CLOZE_GAP_TYPE] = $gap->getType();
1660 $gap_array[AdditionalInformationGenerator::KEY_QUESTION_ANSWER_OPTIONS] = $items;
1661
1662 $gaps[$gap_index + 1] = $gap_array;
1663 }
1664 $result[AdditionalInformationGenerator::KEY_QUESTION_CLOZE_GAPS] = $gaps;
1665 return $result;
1666 }
getTrueFalseTagForBool(bool $bool)
Definition: AdditionalInformationGenerator.php:311
References assClozeGap\getGapSize(), assClozeGap\getItems(), assClozeGap\getShuffle(), ILIAS\Test\Logging\AdditionalInformationGenerator\getTrueFalseTagForBool(), assClozeGap\getType(), and assClozeGap\TYPE_NUMERIC.
Here is the call graph for this function:
◆ updateClozeTextFromGaps()
| assClozeTest::updateClozeTextFromGaps | ( | ) |
Updates the gap parameters in the cloze text from the form input.
@access private
Definition at line 803 of file class.assClozeTest.php.
803 : void
804 {
805 $output = $this->getClozeText();
807 $answers = [];
808 foreach ($gap->getItemsRaw() as $item) {
809 array_push($answers, str_replace([',', '['], ["\\,", '[ '], $item->getAnswerText()));
810 }
811 // fau: fixGapReplace - use replace function
812 $output = $this->replaceFirstGap($output, "[_gap]" . ilLegacyFormElementsUtil::prepareTextareaOutput(join(",", $answers), true) . "[/_gap]");
813 // fau.
814 }
815 $output = str_replace("_gap]", "gap]", $output);
816 $this->cloze_text = $output;
817 }
References assClozeGap\getItemsRaw(), and ilLegacyFormElementsUtil\prepareTextareaOutput().
Here is the call graph for this function:
Field Documentation
◆ $cloze_text
|
protected |
Definition at line 77 of file class.assClozeTest.php.
◆ $end_tag
|
private |
Definition at line 56 of file class.assClozeTest.php.
◆ $feedbackMode
|
protected |
Definition at line 79 of file class.assClozeTest.php.
◆ $feedbackOBJ
| ilAssQuestionFeedback assClozeTest::$feedbackOBJ |
Definition at line 78 of file class.assClozeTest.php.
◆ $fixed_text_length
|
protected |
Definition at line 76 of file class.assClozeTest.php.
◆ $gap_combinations
|
protected |
Definition at line 53 of file class.assClozeTest.php.
◆ $gap_combinations_exist
|
protected |
Definition at line 54 of file class.assClozeTest.php.
◆ $gaps
| array assClozeTest::$gaps = [] |
Definition at line 44 of file class.assClozeTest.php.
◆ $identical_scoring
|
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.
◆ $randomGroup
|
private |
Definition at line 80 of file class.assClozeTest.php.
◆ $start_tag
|
private |
Definition at line 55 of file class.assClozeTest.php.
◆ $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.
The documentation for this class was generated from the following file:
- components/ILIAS/TestQuestionPool/classes/class.assClozeTest.php
