Public Member Functions |
Static Public Member Functions |
Data Fields |
Protected Member Functions |
Protected Attributes
assSingleChoice Class Reference
Class for single choice questions. More...
Inheritance diagram for assSingleChoice:
Collaboration diagram for assSingleChoice:
Public Member Functions | |
| __construct ( $title="", $comment="", $author="", $owner=-1, $question="", $output_type=OUTPUT_ORDER) | |
| assSingleChoice constructor More... | |
| isComplete () | |
| Returns true, if a single choice question is complete for use. More... | |
| getThumbPrefix () | |
| loadFromDb ($question_id) | |
| Loads a assSingleChoice object from a database. More... | |
| duplicate ($for_test=true, $title="", $author="", $owner="", $testObjId=null) | |
| Duplicates an assSingleChoiceQuestion. More... | |
| copyObject ($target_questionpool_id, $title="") | |
| Copies an assSingleChoice object. More... | |
| createNewOriginalFromThisDuplicate ($targetParentId, $targetQuestionTitle="") | |
| getOutputType () | |
| Gets the single choice output type which is either OUTPUT_ORDER (=0) or OUTPUT_RANDOM (=1). More... | |
| setOutputType ($output_type=OUTPUT_ORDER) | |
| Sets the output type of the assSingleChoice object. More... | |
| addAnswer ( $answertext="", $points=0.0, $order=0, $answerimage="") | |
| Adds a possible answer for a single choice question. More... | |
| getAnswerCount () | |
| Returns the number of answers. More... | |
| getAnswer ($index=0) | |
| Returns an answer with a given index. More... | |
| deleteAnswer ($index=0) | |
| Deletes an answer with a given index. More... | |
| flushAnswers () | |
| Deletes all answers. More... | |
| getMaximumPoints () | |
| Returns the maximum points, a learner can reach answering the question. More... | |
| calculateReachedPoints ($active_id, $pass=NULL, $authorizedSolution=true, $returndetails=FALSE) | |
| Returns the points, a learner has reached answering the question. More... | |
| calculateReachedPointsFromPreviewSession (ilAssQuestionPreviewSession $previewSession) | |
| saveWorkingData ($active_id, $pass=NULL, $authorized=true) | |
| Saves the learners input of the question to the database. More... | |
| getQuestionType () | |
| Returns the question type of the question. More... | |
| getAdditionalTableName () | |
| Returns the name of the additional question data table in the database. More... | |
| getAnswerTableName () | |
| Returns the name of the answer table in the database. More... | |
| setImageFile ($image_filename, $image_tempfilename="") | |
| Sets the image file and uploads the image to the object's image directory. More... | |
| deleteImage ($image_filename) | |
| Deletes an image file. More... | |
| duplicateImages ($question_id, $objectId=null) | |
| getRTETextWithMediaObjects () | |
| Collects all text in the question which could contain media objects which were created with the Rich Text Editor. More... | |
| & | getAnswers () |
| Returns a reference to the answers array. More... | |
| setExportDetailsXLS (&$worksheet, $startrow, $active_id, $pass, &$format_title, &$format_bold) | |
| Creates an Excel worksheet for the detailed cumulated results of this question. More... | |
| getThumbSize () | |
| setThumbSize ($a_size) | |
| toJSON () | |
| Returns a JSON representation of the question. More... | |
| removeAnswerImage ($index) | |
| createRandomSolution ($active_id, $pass) | |
| getMultilineAnswerSetting () | |
| setMultilineAnswerSetting ($a_setting=0) | |
| setSpecificFeedbackSetting ($a_feedback_setting) | |
| Sets the feedback settings in effect for the question. More... | |
| getSpecificFeedbackSetting () | |
| Gets the current feedback settings in effect for the question. More... | |
| getSpecificFeedbackAllCorrectOptionLabel () | |
| isAnswered ($active_id, $pass=NULL) | |
| returns boolean wether the question is answered during test pass or not More... | |
| getOperators ($expression) | |
| Get all available operations for a specific question. More... | |
| getExpressionTypes () | |
| Get all available expression types for a specific question. 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... | |
| Public Member Functions inherited from assQuestion | |
| __construct ( $title="", $comment="", $author="", $owner=-1, $question="") | |
| assQuestion constructor More... | |
| getShuffler () | |
| setShuffler (ilArrayElementShuffler $shuffler) | |
| setProcessLocker ($processLocker) | |
| getProcessLocker () | |
| fromXML (&$item, &$questionpool_id, &$tst_id, &$tst_object, &$question_counter, &$import_mapping) | |
| Receives parameters from a QTI parser and creates a valid ILIAS question object. More... | |
| toXML ($a_include_header=true, $a_include_binary=true, $a_shuffle=false, $test_output=false, $force_image_references=false) | |
| Returns a QTI xml representation of the question. More... | |
| isComplete () | |
| Returns true, if a question is complete for use. More... | |
| questionTitleExists ($questionpool_id, $title) | |
| Returns TRUE if the question title exists in the database. More... | |
| setTitle ($title="") | |
| Sets the title string of the assQuestion object. More... | |
| setId ($id=-1) | |
| Sets the id of the assQuestion object. More... | |
| setTestId ($id=-1) | |
| Sets the test id of the assQuestion object. More... | |
| setComment ($comment="") | |
| Sets the comment string of the assQuestion object. More... | |
| setOutputType ($outputType=OUTPUT_HTML) | |
| Sets the output type. More... | |
| setShuffle ($shuffle=true) | |
| Sets the shuffle flag. More... | |
| setEstimatedWorkingTime ($hour=0, $min=0, $sec=0) | |
| Sets the estimated working time of a question from given hour, minute and second. More... | |
| setEstimatedWorkingTimeFromDurationString ($durationString) | |
| Sets the estimated working time of a question from a given datetime string. More... | |
| keyInArray ($searchkey, $array) | |
| returns TRUE if the key occurs in an array More... | |
| setAuthor ($author="") | |
| Sets the authors name of the assQuestion object. More... | |
| setOwner ($owner="") | |
| Sets the creator/owner ID of the assQuestion object. More... | |
| getTitle () | |
| Gets the title string of the assQuestion object. More... | |
| getId () | |
| Gets the id of the assQuestion object. More... | |
| getShuffle () | |
| Gets the shuffle flag. More... | |
| getTestId () | |
| Gets the test id of the assQuestion object. More... | |
| getComment () | |
| Gets the comment string of the assQuestion object. More... | |
| getOutputType () | |
| Gets the output type. More... | |
| supportsJavascriptOutput () | |
| Returns true if the question type supports JavaScript output. More... | |
| supportsNonJsOutput () | |
| requiresJsSwitch () | |
| getEstimatedWorkingTime () | |
| Gets the estimated working time of a question. More... | |
| getAuthor () | |
| Gets the authors name of the assQuestion object. More... | |
| getOwner () | |
| Gets the creator/owner ID of the assQuestion object. More... | |
| getObjId () | |
| Get the object id of the container object. More... | |
| setObjId ($obj_id=0) | |
| Set the object id of the container object. More... | |
| setExternalId ($external_id) | |
| getExternalId () | |
| _getMaximumPoints ($question_id) | |
| Returns the maximum points, a learner can reach answering the question. More... | |
| & | _getQuestionInfo ($question_id) |
| Returns question information from the database. More... | |
| getSuggestedSolutionOutput () | |
| & | _getSuggestedSolution ($question_id, $subquestion_index=0) |
| Returns a suggested solution for a given subquestion index. More... | |
| getSuggestedSolutions () | |
| Return the suggested solutions. More... | |
| _getReachedPoints ($active_id, $question_id, $pass=NULL) | |
| Returns the points, a learner has reached answering the question. More... | |
| getReachedPoints ($active_id, $pass=NULL) | |
| Returns the points, a learner has reached answering the question This is the fast way to get the points directly from the database. More... | |
| getMaximumPoints () | |
| Returns the maximum points, a learner can reach answering the question. More... | |
| getAdjustedReachedPoints ($active_id, $pass=NULL, $authorizedSolution=true) | |
| returns the reached points ... More... | |
| calculateResultsFromSolution ($active_id, $pass=NULL, $obligationsEnabled=false) | |
| Calculates the question results from a previously saved question solution. More... | |
| persistWorkingState ($active_id, $pass=NULL, $obligationsEnabled=false, $authorized=true) | |
| persists the working state for current testactive and testpass More... | |
| persistPreviewState (ilAssQuestionPreviewSession $previewSession) | |
| persists the preview state for current user and question More... | |
| saveWorkingData ($active_id, $pass=NULL, $authorized=true) | |
| Saves the learners input of the question to the database. More... | |
| _updateTestResultCache ($active_id, ilAssQuestionProcessLocker $processLocker=null) | |
| @TODO Move this to a proper place. More... | |
| logAction ($logtext="", $active_id="", $question_id="") | |
| Logs an action into the Test&Assessment log. More... | |
| _logAction ($logtext="", $active_id="", $question_id="") | |
| Logs an action into the Test&Assessment log. More... | |
| moveUploadedMediaFile ($file, $name) | |
| Move an uploaded media file to an public accessible temp dir to present it. More... | |
| getSuggestedSolutionPath () | |
| Returns the path for a suggested solution. More... | |
| getJavaPath () | |
| Returns the image path for web accessable images of a question. More... | |
| getImagePath ($question_id=null, $object_id=null) | |
| Returns the image path for web accessable images of a question. More... | |
| buildImagePath ($questionId, $parentObjectId) | |
| getFlashPath () | |
| Returns the image path for web accessable flash files of a question. More... | |
| getJavaPathWeb () | |
| Returns the web image path for web accessable java applets of a question. More... | |
| getSuggestedSolutionPathWeb () | |
| Returns the web path for a suggested solution. More... | |
| getImagePathWeb () | |
| Returns the web image path for web accessable images of a question. More... | |
| getFlashPathWeb () | |
| Returns the web image path for web accessable flash applications of a question. More... | |
| getUserSolutionPreferingIntermediate ($active_id, $pass=NULL) | |
| getSolutionValues ($active_id, $pass=NULL, $authorized=true) | |
| Loads solutions of a given user from the database an returns it. More... | |
| isInUse ($question_id="") | |
| Checks whether the question is in use or not. More... | |
| isClone ($question_id="") | |
| Checks whether the question is a clone of another question or not. More... | |
| pcArrayShuffle ($array) | |
| Shuffles the values of a given array. More... | |
| getQuestionTypeFromDb ($question_id) | |
| get question type for question id More... | |
| getAdditionalTableName () | |
| Returns the name of the additional question data table in the database. More... | |
| getAnswerTableName () | |
| Returns the name of the answer table in the database. More... | |
| deleteAnswers ($question_id) | |
| Deletes datasets from answers tables. More... | |
| deleteAdditionalTableData ($question_id) | |
| Deletes datasets from the additional question table in the database. More... | |
| delete ($question_id) | |
| Deletes a question and all materials from the database. More... | |
| getTotalAnswers () | |
| get total number of answers More... | |
| _getTotalAnswers ($a_q_id) | |
| get number of answers for question id (static) note: do not use $this inside this method More... | |
| _getTitle ($a_q_id) | |
| Returns the title of a question. More... | |
| _getQuestionText ($a_q_id) | |
| Returns question text. More... | |
| copyXHTMLMediaObjectsOfQuestion ($a_q_id) | |
| syncXHTMLMediaObjectsOfQuestion () | |
| createPageObject () | |
| create page object of question More... | |
| copyPageOfQuestion ($a_q_id) | |
| getPageOfQuestion () | |
| _getQuestionType ($question_id) | |
| Returns the question type of a question with a given id. More... | |
| _getQuestionTitle ($question_id) | |
| Returns the question title of a question with a given id. More... | |
| setOriginalId ($original_id) | |
| getOriginalId () | |
| fixSvgToPng ($imageFilenameContainingString) | |
| fixUnavailableSkinImageSources ($html) | |
| loadFromDb ($question_id) | |
| Loads the question from the database. More... | |
| createNewQuestion ($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 ($original_id="") | |
| saveToDb ($original_id="") | |
| Saves the question to the database. More... | |
| setNewOriginalId ($newId) | |
| deleteSuggestedSolutions () | |
| Deletes all suggestes solutions in the database. More... | |
| getSuggestedSolution ($subquestion_index=0) | |
| Returns a suggested solution for a given subquestion index. More... | |
| getSuggestedSolutionTitle ($subquestion_index=0) | |
| Returns the title of a suggested solution at a given subquestion_index. More... | |
| setSuggestedSolution ($solution_id="", $subquestion_index=0, $is_import=false) | |
| Sets a suggested solution for the question. More... | |
| _resolveInternalLink ($internal_link) | |
| _resolveIntLinks ($question_id) | |
| _getInternalLinkHref ($target="") | |
| syncWithOriginal () | |
| createRandomSolution ($test_id, $user_id) | |
| _questionExists ($question_id) | |
| Returns true if the question already exists in the database. More... | |
| _questionExistsInPool ($question_id) | |
| Returns true if the question already exists in the database and is assigned to a question pool. More... | |
| getPoints () | |
| Returns the maximum available points for the question. More... | |
| setPoints ($a_points) | |
| Sets the maximum available points for the question. More... | |
| getSolutionMaxPass ($active_id) | |
| Returns the maximum pass a users question solution. More... | |
| _getSolutionMaxPass ($question_id, $active_id) | |
| Returns the maximum pass a users question solution. More... | |
| _isWriteable ($question_id, $user_id) | |
| Returns true if the question is writeable by a certain user. More... | |
| _isUsedInRandomTest ($question_id="") | |
| Checks whether the question is used in a random test or not. More... | |
| calculateReachedPoints ($active_id, $pass=NULL, $authorizedSolution=true, $returndetails=FALSE) | |
| Returns the points, a learner has reached answering the question. More... | |
| calculateReachedPointsFromPreviewSession (ilAssQuestionPreviewSession $previewSession) | |
| isPreviewSolutionCorrect (ilAssQuestionPreviewSession $previewSession) | |
| adjustReachedPointsByScoringOptions ($points, $active_id, $pass=NULL) | |
| Adjust the given reached points by checks for all special scoring options in the test container. More... | |
| isHTML ($a_text) | |
| Checks if a given string contains HTML or not. More... | |
| prepareTextareaOutput ($txt_output, $prepare_for_latex_output=FALSE, $omitNl2BrWhenTextArea=false) | |
| Prepares a string for a text area output in tests. More... | |
| QTIMaterialToString ($a_material) | |
| Reads an QTI material tag an creates a text string. More... | |
| addQTIMaterial (&$a_xml_writer, $a_material, $close_material_tag=TRUE, $add_mobs=TRUE) | |
| Creates a QTI material tag from a plain text or xhtml text. More... | |
| createNewImageFileName ($image_filename, $unique=false) | |
| _setReachedPoints ($active_id, $question_id, $points, $maxpoints, $pass, $manualscoring, $obligationsEnabled) | |
| Sets the points, a learner has reached answering the question Additionally objective results are updated. More... | |
| getQuestion () | |
| Gets the question string of the question object. More... | |
| setQuestion ($question="") | |
| Sets the question string of the question object. More... | |
| getQuestionType () | |
| Returns the question type of the question. More... | |
| getQuestionTypeID () | |
| Returns the question type of the question. More... | |
| cleanupMediaObjectUsage () | |
| synchronises appearances of media objects in the question with media object usage table More... | |
| & | getInstances () |
| Gets all instances of the question. More... | |
| _needsManualScoring ($question_id) | |
| getActiveUserData ($active_id) | |
| Returns the user id and the test id for a given active id. More... | |
| setExportDetailsXLS (&$worksheet, $startrow, $active_id, $pass, &$format_title, &$format_bold) | |
| Creates an Excel worksheet for the detailed cumulated results of this question. More... | |
| __get ($value) | |
| Object getter. More... | |
| __set ($key, $value) | |
| Object setter. More... | |
| getNrOfTries () | |
| setNrOfTries ($a_nr_of_tries) | |
| setExportImagePath ($a_path) | |
| _questionExistsInTest ($question_id, $test_id) | |
| formatSAQuestion ($a_q) | |
| Format self assessment question. More... | |
| setPreventRteUsage ($a_val) | |
| Set prevent rte usage. More... | |
| getPreventRteUsage () | |
| Get prevent rte usage. More... | |
| migrateContentForLearningModule (ilAssSelfAssessmentMigrator $migrator) | |
| setSelfAssessmentEditingMode ($a_selfassessmenteditingmode) | |
| Set Self-Assessment Editing Mode. More... | |
| getSelfAssessmentEditingMode () | |
| Get Self-Assessment Editing Mode. More... | |
| setDefaultNrOfTries ($a_defaultnroftries) | |
| Set Default Nr of Tries. More... | |
| getDefaultNrOfTries () | |
| Get Default Nr of Tries. More... | |
| syncSkillAssignments ($srcParentId, $srcQuestionId, $trgParentId, $trgQuestionId) | |
| isAnswered ($active_id, $pass=null) | |
| returns boolean wether the question is answered during test pass or not More... | |
| isAutosaveable () | |
| getAdditionalContentEditingMode () | |
| getter for additional content editing mode for this question More... | |
| setAdditionalContentEditingMode ($additinalContentEditingMode) | |
| setter for additional content editing mode for this question More... | |
| isAdditionalContentEditingModePageObject () | |
| isser for additional "pageobject" content editing mode More... | |
| isValidAdditionalContentEditingMode ($additionalContentEditingMode) | |
| returns the fact wether the passed additional content mode is valid or not More... | |
| getValidAdditionalContentEditingModes () | |
| getter for valid additional content editing modes More... | |
| addQuestionChangeListener (ilQuestionChangeListener $listener) | |
| getQuestionChangeListeners () | |
| getHtmlUserSolutionPurifier () | |
| getHtmlQuestionContentPurifier () | |
| setLastChange ($lastChange) | |
| getLastChange () | |
| removeIntermediateSolution ($active_id, $pass) | |
| removeCurrentSolution ($active_id, $pass, $authorized=true, $ignoredSolutionIds=array()) | |
| saveCurrentSolution ($active_id, $pass, $value1, $value2, $authorized=true) | |
| updateCurrentSolution ($solutionId, $value1, $value2, $authorized=true) | |
| updateCurrentSolutionsAuthorization ($activeId, $pass, $authorized) | |
| setStep ($step) | |
| getStep () | |
| toJSON () | |
| duplicate ($for_test=true, $title="", $author="", $owner="", $testObjId=null) | |
| authorizedSolutionExists ($active_id, $pass) | |
| authorizedOrIntermediateSolutionExists ($active_id, $pass) | |
| lookupForExistingSolutions ($activeId, $pass) | |
| Lookup if an authorized or intermediate solution exists. More... | |
| removeExistingSolutions ($activeId, $pass) | |
| resetUsersAnswer ($activeId, $pass) | |
| removeResultRecord ($activeId, $pass) | |
| areObligationsToBeConsidered () | |
| setObligationsToBeConsidered ($obligationsToBeConsidered) | |
| validateSolutionSubmit () | |
| updateTimestamp () | |
| Public Member Functions inherited from ilObjQuestionScoringAdjustable | |
| saveAdditionalQuestionDataToDb () | |
| Saves a record to the question types additional data table. More... | |
| Public Member Functions inherited from ilObjAnswerScoringAdjustable | |
| saveAnswerSpecificDataToDb () | |
| Saves the answer specific records into a question types answer table. More... | |
| Public Member Functions inherited from iQuestionCondition | |
| getOperators ($expression) | |
| Get all available operations for a specific question. More... | |
| getExpressionTypes () | |
| Get all available expression types for a specific question. More... | |
| getUserQuestionResult ($active_id, $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... | |
| getSpecificFeedbackAllCorrectOptionLabel () | |
Static Public Member Functions | |
| static | isObligationPossible ($questionId) |
| returns boolean wether it is possible to set this question type as obligatory or not considering the current question configuration More... | |
| Static Public Member Functions inherited from assQuestion | |
| static | setForcePassResultUpdateEnabled ($forcePassResultsUpdateEnabled) |
| static | isForcePassResultUpdateEnabled () |
| static | isAllowedImageMimeType ($mimeType) |
| static | fetchMimeTypeIdentifier ($contentTypeString) |
| static | getAllowedFileExtensionsForMimeType ($mimeType) |
| static | isAllowedImageFileExtension ($mimeType, $fileExtension) |
| static | getAllowedImageFileExtensions () |
| static | _getSuggestedSolutionCount ($question_id) |
| Returns the number of suggested solutions associated with a question. More... | |
| static | _getSuggestedSolutionOutput ($question_id) |
| Returns the output of the suggested solution. More... | |
| static | _getTotalRightAnswers ($a_q_id) |
| get number of answers for question id (static) note: do not use $this inside this method More... | |
| static | isFileAvailable ($file) |
| static | _getOriginalId ($question_id) |
| Returns the original id of a question. More... | |
| static | originalQuestionExists ($questionId) |
| static | _instanciateQuestion ($question_id) |
| Creates an instance of a question with a given question id. More... | |
| static | _instantiateQuestion ($question_id) |
| static | _isWorkedThrough ($active_id, $question_id, $pass=NULL) |
| Returns true if the question was worked through in the given pass Worked through means that the user entered at least one value. More... | |
| static | _areAnswered ($a_user_id, $a_question_ids) |
| Checks if an array of question ids is answered by an user or not. More... | |
| static | _includeClass ($question_type, $gui=0) |
| Include the php class file for a given question type. More... | |
| static | getGuiClassNameByQuestionType ($questionType) |
| static | getObjectClassNameByQuestionType ($questionType) |
| static | getFeedbackClassNameByQuestionType ($questionType) |
| static | isCoreQuestionType ($questionType) |
| static | includeCoreClass ($questionType, $withGuiClass) |
| static | includePluginClass ($questionType, $withGuiClass) |
| static | _getQuestionTypeName ($type_tag) |
| Return the translation for a given question type tag. More... | |
| static & | _instanciateQuestionGUI ($question_id) |
| Creates an instance of a question gui with a given question id. More... | |
| static | instantiateQuestionGUI ($a_question_id) |
| Creates an instance of a question gui with a given question id. More... | |
| static | lookupParentObjId ($questionId) |
| @global ilDB $ilDB More... | |
| static | lookupOriginalParentObjId ($originalQuestionId) |
| returns the parent object id for given original question id (should be a qpl id, but theoretically it can be a tst id, too) More... | |
| static | isObligationPossible ($questionId) |
| returns boolean wether it is possible to set this question type as obligatory or not considering the current question configuration More... | |
| static | setResultGateway ($resultGateway) |
| static | getResultGateway () |
| static | sumTimesInISO8601FormatH_i_s_Extended ($time1, $time2) |
| static | convertISO8601FormatH_i_s_ExtendedToSeconds ($time) |
| static | missingResultRecordExists ($activeId, $pass, $questionIds) |
| static | lookupResultRecordExist ($activeId, $questionId, $pass) |
Data Fields | |
| $answers | |
| $output_type | |
| Data Fields inherited from assQuestion | |
| const | IMG_MIME_TYPE_JPG = 'image/jpeg' |
| const | IMG_MIME_TYPE_PNG = 'image/png' |
| const | IMG_MIME_TYPE_GIF = 'image/gif' |
| const | ADDITIONAL_CONTENT_EDITING_MODE_DEFAULT = 'default' |
| constant for additional content editing mode "default" More... | |
| const | ADDITIONAL_CONTENT_EDITING_MODE_PAGE_OBJECT = 'pageobject' |
| constant for additional content editing mode "pageobject" More... | |
| $feedbackOBJ = null | |
| $prevent_rte_usage = false | |
| $selfassessmenteditingmode = false | |
| $defaultnroftries = 0 | |
| $questionActionCmd = 'handleQuestionAction' | |
| 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 | |
| rebuildThumbnails () | |
| generateThumbForFile ($path, $file) | |
| savePreviewData (ilAssQuestionPreviewSession $previewSession) | |
| Reworks the allready saved working data if neccessary. More... | |
| reworkWorkingData ($active_id, $pass, $obligationsAnswered) | |
| Reworks the allready saved working data if neccessary. More... | |
| syncImages () | |
| Sync images of a MC question on synchronisation with the original question. More... | |
| lmMigrateQuestionTypeSpecificContent (ilAssSelfAssessmentMigrator $migrator) | |
| afterSyncWithOriginal ($origQuestionId, $dupQuestionId, $origParentObjId, $dupParentObjId) | |
| {} More... | |
| Protected Member Functions inherited from assQuestion | |
| savePreviewData (ilAssQuestionPreviewSession $previewSession) | |
| Reworks the allready saved working data if neccessary. More... | |
| deletePageOfQuestion ($question_id) | |
| Deletes the page object of a question with a given ID. More... | |
| onDuplicate ($originalParentId, $originalQuestionId, $duplicateParentId, $duplicateQuestionId) | |
| Will be called when a question is duplicated (inside a question pool or for insertion in a test) More... | |
| beforeSyncWithOriginal ($origQuestionId, $dupQuestionId, $origParentObjId, $dupParentObjId) | |
| afterSyncWithOriginal ($origQuestionId, $dupQuestionId, $origParentObjId, $dupParentObjId) | |
| onCopy ($sourceParentId, $sourceQuestionId, $targetParentId, $targetQuestionId) | |
| Will be called when a question is copied (into another question pool) More... | |
| duplicateSuggestedSolutionFiles ($parent_id, $question_id) | |
| Duplicates the files of a suggested solution if the question is duplicated. More... | |
| syncSuggestedSolutionFiles ($original_id) | |
| Syncs the files of a suggested solution if the question is synced. More... | |
| copySuggestedSolutionFiles ($source_questionpool_id, $source_question_id) | |
| getRTETextWithMediaObjects () | |
| Collects all text in the question which could contain media objects which were created with the Rich Text Editor. More... | |
| lmMigrateQuestionTypeGenericContent (ilAssSelfAssessmentMigrator $migrator) | |
| lmMigrateQuestionTypeSpecificContent (ilAssSelfAssessmentMigrator $migrator) | |
| duplicateQuestionHints ($originalQuestionId, $duplicateQuestionId) | |
| duplicateSkillAssignments ($srcParentId, $srcQuestionId, $trgParentId, $trgQuestionId) | |
| buildQuestionDataQuery () | |
| getCurrentSolutionResultSet ($active_id, $pass, $authorized=true) | |
| Get a restulset for the current user solution for a this question by active_id and pass. More... | |
| removeSolutionRecordById ($solutionId) | |
| getSelfAssessmentFormatter () | |
Protected Attributes | |
| $thumb_size | |
| $feedback_setting | |
| Protected Attributes inherited from assQuestion | |
| $id | |
| $title | |
| $comment | |
| $owner | |
| $author | |
| $question | |
| $points | |
| $est_working_time | |
| $shuffle | |
| $test_id | |
| $obj_id | |
| $ilias | |
| $tpl | |
| $lng | |
| $db | |
| $outputType | |
| $suggested_solutions | |
| $original_id | |
| $page | |
| $external_id = '' | |
| $questionChangeListeners = array() | |
| $processLocker | |
| $step = null | |
| $lastChange | |
| $shuffler | |
Additional Inherited Members | |
| Static Protected Member Functions inherited from assQuestion | |
| static | getNumExistingSolutionRecords ($activeId, $pass, $questionId) |
| returns the number of existing solution records for the given test active / pass and given question id More... | |
| Static Protected Attributes inherited from assQuestion | |
| static | $allowedFileExtensionsByMimeType |
| static | $allowedCharsetsByMimeType |
| static | $forcePassResultsUpdateEnabled = false |
| static | $imageSourceFixReplaceMap |
Detailed Description
Class for single choice questions.
assSingleChoice is a class for single choice questions.
- Version
- $Id$
Definition at line 25 of file class.assSingleChoice.php.
Constructor & Destructor Documentation
◆ __construct()
| assSingleChoice::__construct | ( | $title = "", |
|
$comment = "", |
|||
$author = "", |
|||
$owner = -1, |
|||
$question = "", |
|||
$output_type = OUTPUT_ORDER |
|||
| ) |
assSingleChoice constructor
The constructor takes possible arguments an creates an instance of the assSingleChoice object.
- Parameters
-
string $title A title string to describe the question string $comment A comment string to describe the question string $author A string containing the name of the questions author integer $owner A numerical ID to identify the owner/creator string $question The question string of the single choice question int | string $output_type The output order of the single choice answers
- See also
- assQuestion:assQuestion()
Definition at line 75 of file class.assSingleChoice.php.
83 {
85 $this->thumb_size = 150;
86 $this->output_type = $output_type;
87 $this->answers = array();
88 $this->shuffle = 1;
89 $this->feedback_setting = 2;
90 }
References assQuestion\$author, assQuestion\$comment, $output_type, assQuestion\$owner, assQuestion\$question, and assQuestion\$title.
Member Function Documentation
◆ addAnswer()
| assSingleChoice::addAnswer | ( | $answertext = "", |
|
$points = 0.0, |
|||
$order = 0, |
|||
$answerimage = "" |
|||
| ) |
Adds a possible answer for a single choice question.
A ASS_AnswerBinaryStateImage object will be created and assigned to the array $this->answers.
- Parameters
-
string $answertext The answer text double $points The points for selecting the answer (even negative points can be used) boolean $state Defines the answer as correct (TRUE) or incorrect (FALSE) integer $order A possible display order of the answer double $points The points for not selecting the answer (even negative points can be used) @access public
- See also
- $answers
- ASS_AnswerBinaryStateImage
Definition at line 439 of file class.assSingleChoice.php.
445 {
446 include_once "./Modules/TestQuestionPool/classes/class.assAnswerBinaryStateImage.php";
447 if (array_key_exists($order, $this->answers))
448 {
449 // insert answer
451 $newchoices = array();
452 for ($i = 0; $i < $order; $i++)
453 {
454 array_push($newchoices, $this->answers[$i]);
455 }
456 array_push($newchoices, $answer);
457 for ($i = $order; $i < count($this->answers); $i++)
458 {
459 $changed = $this->answers[$i];
460 $changed->setOrder($i+1);
461 array_push($newchoices, $changed);
462 }
463 $this->answers = $newchoices;
464 }
465 else
466 {
467 // add answer
468 $answer = new ASS_AnswerBinaryStateImage($answertext, $points, count($this->answers), 1, $answerimage);
469 array_push($this->answers, $answer);
470 }
471 }
Class for answers with a binary state indicator.
Definition: class.assAnswerBinaryStateImage.php:22
References $changed, and assQuestion\$points.
◆ afterSyncWithOriginal()
|
protected |
{}
Reimplemented from assQuestion.
Definition at line 1326 of file class.assSingleChoice.php.
1327 {
1328 parent::afterSyncWithOriginal($origQuestionId, $dupQuestionId, $origParentObjId, $dupParentObjId);
1329
1330 $origImagePath = $this->buildImagePath($origQuestionId, $origParentObjId);
1331 $dupImagePath = $this->buildImagePath($dupQuestionId, $dupParentObjId);
1332
1333 ilUtil::delDir($origImagePath);
1334 if(is_dir($dupImagePath))
1335 {
1336 ilUtil::makeDirParents($origImagePath);
1337 ilUtil::rCopy($dupImagePath, $origImagePath);
1338 }
1339 }
buildImagePath($questionId, $parentObjectId)
Definition: class.assQuestion.php:1581
static delDir($a_dir, $a_clean_only=false)
removes a dir and all its content (subdirs and files) recursively
Definition: class.ilUtil.php:2553
static rCopy($a_sdir, $a_tdir, $preserveTimeAttributes=false)
Copies content of a directory $a_sdir recursively to a directory $a_tdir.
Definition: class.ilUtil.php:1572
static makeDirParents($a_dir)
Create a new directory and all parent directories.
Definition: class.ilUtil.php:2482
References assQuestion\buildImagePath(), ilUtil\delDir(), ilUtil\makeDirParents(), and ilUtil\rCopy().
Here is the call graph for this function:
◆ calculateReachedPoints()
| assSingleChoice::calculateReachedPoints | ( | $active_id, | |
$pass = NULL, |
|||
$authorizedSolution = true, |
|||
$returndetails = FALSE |
|||
| ) |
Returns the points, a learner has reached answering the question.
The points are calculated from the given answers.
@access public
- Parameters
-
integer $active_id integer $pass boolean $returndetails (deprecated !!)
- Returns
- integer/array $points/$details (array $details is deprecated !!)
Reimplemented from assQuestion.
Definition at line 569 of file class.assSingleChoice.php.
570 {
571 if( $returndetails )
572 {
574 }
575
576 global $ilDB;
577
578 $found_values = array();
580 {
582 }
585 {
587 {
589 }
590 }
591 $points = 0;
592 foreach ($this->answers as $key => $answer)
593 {
594 if (count($found_values) > 0)
595 {
596 if (in_array($key, $found_values))
597 {
598 $points += $answer->getPoints();
599 }
600 }
601 }
602
604 }
getCurrentSolutionResultSet($active_id, $pass, $authorized=true)
Get a restulset for the current user solution for a this question by active_id and pass.
Definition: class.assQuestion.php:4675
getSolutionMaxPass($active_id)
Returns the maximum pass a users question solution.
Definition: class.assQuestion.php:3261
Base Exception for all Exceptions relating to Modules/Test.
Definition: class.ilTestException.php:15
References $data, $ilDB, $pass, assQuestion\$points, $result, assQuestion\getCurrentSolutionResultSet(), and assQuestion\getSolutionMaxPass().
Here is the call graph for this function:
◆ calculateReachedPointsFromPreviewSession()
| assSingleChoice::calculateReachedPointsFromPreviewSession | ( | ilAssQuestionPreviewSession | $previewSession | ) |
Reimplemented from assQuestion.
Definition at line 606 of file class.assSingleChoice.php.
607 {
608 $participantSolution = $previewSession->getParticipantsSolution();
609 foreach ($this->answers as $key => $answer)
610 {
611 if( is_numeric($participantSolution) && $key == $participantSolution )
612 {
613 return $answer->getPoints();
614 }
615 }
616
617 return 0;
618 }
getParticipantsSolution()
Definition: class.ilAssQuestionPreviewSession.php:74
References ilAssQuestionPreviewSession\getParticipantsSolution().
Here is the call graph for this function:
◆ copyObject()
| assSingleChoice::copyObject | ( | $target_questionpool_id, | |
$title = "" |
|||
| ) |
Copies an assSingleChoice object.
@access public
Definition at line 334 of file class.assSingleChoice.php.
335 {
336 if ($this->id <= 0)
337 {
338 // The question has not been saved. It cannot be duplicated
339 return;
340 }
341 // duplicate the question in database
342 $clone = $this;
343 include_once ("./Modules/TestQuestionPool/classes/class.assQuestion.php");
345 $clone->id = -1;
346 $source_questionpool_id = $this->getObjId();
347 $clone->setObjId($target_questionpool_id);
349 {
350 $clone->setTitle($title);
351 }
352 $clone->saveToDb();
353 // copy question page content
354 $clone->copyPageOfQuestion($original_id);
355 // copy XHTML media objects
356 $clone->copyXHTMLMediaObjectsOfQuestion($original_id);
357 // duplicate the image
358 $clone->copyImages($original_id, $source_questionpool_id);
359
360 $clone->onCopy($source_questionpool_id, $original_id, $clone->getObjId(), $clone->getId());
361
362 return $clone->id;
363 }
static _getOriginalId($question_id)
Returns the original id of a question.
Definition: class.assQuestion.php:3039
References assQuestion\$original_id, assQuestion\$title, assQuestion\_getOriginalId(), and assQuestion\getObjId().
Here is the call graph for this function:
◆ createNewOriginalFromThisDuplicate()
| assSingleChoice::createNewOriginalFromThisDuplicate | ( | $targetParentId, | |
$targetQuestionTitle = "" |
|||
| ) |
Definition at line 365 of file class.assSingleChoice.php.
366 {
367 if ($this->id <= 0)
368 {
369 // The question has not been saved. It cannot be duplicated
370 return;
371 }
372
373 include_once ("./Modules/TestQuestionPool/classes/class.assQuestion.php");
374
375 $sourceQuestionId = $this->id;
376 $sourceParentId = $this->getObjId();
377
378 // duplicate the question in database
379 $clone = $this;
380 $clone->id = -1;
381
382 $clone->setObjId($targetParentId);
383
384 if ($targetQuestionTitle)
385 {
386 $clone->setTitle($targetQuestionTitle);
387 }
388
389 $clone->saveToDb();
390 // copy question page content
391 $clone->copyPageOfQuestion($sourceQuestionId);
392 // copy XHTML media objects
393 $clone->copyXHTMLMediaObjectsOfQuestion($sourceQuestionId);
394 // duplicate the image
395 $clone->copyImages($sourceQuestionId, $sourceParentId);
396
397 $clone->onCopy($sourceParentId, $sourceQuestionId, $clone->getObjId(), $clone->getId());
398
399 return $clone->id;
400 }
References assQuestion\$id, and assQuestion\getObjId().
Here is the call graph for this function:
◆ createRandomSolution()
| assSingleChoice::createRandomSolution | ( | $active_id, | |
| $pass | |||
| ) |
Reimplemented from assQuestion.
Definition at line 1129 of file class.assSingleChoice.php.
1130 {
1131 $value = rand(0, count($this->answers)-1);
1135 }
calculateResultsFromSolution($active_id, $pass=NULL, $obligationsEnabled=false)
Calculates the question results from a previously saved question solution.
Definition: class.assQuestion.php:1069
saveWorkingData($active_id, $pass=NULL, $authorized=true)
Saves the learners input of the question to the database.
Definition: class.assSingleChoice.php:628
References $_POST, $pass, assQuestion\calculateResultsFromSolution(), and saveWorkingData().
Here is the call graph for this function:
◆ deleteAnswer()
| assSingleChoice::deleteAnswer | ( | $index = 0 | ) |
Deletes an answer with a given index.
The index of the first answer is 0, the index of the second answer is 1 and so on.
- Parameters
-
integer $index A nonnegative index of the n-th answer @access public
- See also
- $answers
Definition at line 511 of file class.assSingleChoice.php.
512 {
513 if ($index < 0) return;
514 if (count($this->answers) < 1) return;
515 if ($index >= count($this->answers)) return;
516 $answer = $this->answers[$index];
518 unset($this->answers[$index]);
519 $this->answers = array_values($this->answers);
520 for ($i = 0; $i < count($this->answers); $i++)
521 {
522 if ($this->answers[$i]->getOrder() > $index)
523 {
524 $this->answers[$i]->setOrder($i);
525 }
526 }
527 }
References deleteImage().
Here is the call graph for this function:
◆ deleteImage()
| assSingleChoice::deleteImage | ( | $image_filename | ) |
Deletes an image file.
- Parameters
-
string $image_filename Name of the image file to delete @access private
Definition at line 856 of file class.assSingleChoice.php.
857 {
858 $imagepath = $this->getImagePath();
859 @unlink($imagepath . $image_filename);
860 $thumbpath = $imagepath . $this->getThumbPrefix() . $image_filename;
861 @unlink($thumbpath);
862 }
getImagePath($question_id=null, $object_id=null)
Returns the image path for web accessable images of a question.
Definition: class.assQuestion.php:1566
References assQuestion\getImagePath(), and getThumbPrefix().
Referenced by deleteAnswer(), and removeAnswerImage().
Here is the call graph for this function:
Here is the caller graph for this function:
◆ duplicate()
| assSingleChoice::duplicate | ( | $for_test = true, |
|
$title = "", |
|||
$author = "", |
|||
$owner = "", |
|||
$testObjId = null |
|||
| ) |
Duplicates an assSingleChoiceQuestion.
@access public
Reimplemented from assQuestion.
Definition at line 273 of file class.assSingleChoice.php.
274 {
275 if ($this->id <= 0)
276 {
277 // The question has not been saved. It cannot be duplicated
278 return;
279 }
280 // duplicate the question in database
281 $this_id = $this->getId();
282 $thisObjId = $this->getObjId();
283
284 $clone = $this;
285 include_once ("./Modules/TestQuestionPool/classes/class.assQuestion.php");
287 $clone->id = -1;
288
289 if( (int)$testObjId > 0 )
290 {
291 $clone->setObjId($testObjId);
292 }
293
295 {
296 $clone->setTitle($title);
297 }
298
300 {
301 $clone->setAuthor($author);
302 }
304 {
305 $clone->setOwner($owner);
306 }
307 if ($for_test)
308 {
309 $clone->saveToDb($original_id);
310 }
311 else
312 {
313 $clone->saveToDb();
314 }
315
316 // copy question page content
317 $clone->copyPageOfQuestion($this_id);
318
319 // copy XHTML media objects
320 $clone->copyXHTMLMediaObjectsOfQuestion($this_id);
321 // duplicate the images
322 $clone->duplicateImages($this_id, $thisObjId);
323
324 $clone->onDuplicate($thisObjId, $this_id, $clone->getObjId(), $clone->getId());
325
326 return $clone->id;
327 }
References assQuestion\$author, assQuestion\$original_id, assQuestion\$owner, assQuestion\$title, assQuestion\_getOriginalId(), assQuestion\getId(), and assQuestion\getObjId().
Here is the call graph for this function:
◆ duplicateImages()
| assSingleChoice::duplicateImages | ( | $question_id, | |
$objectId = null |
|||
| ) |
Definition at line 864 of file class.assSingleChoice.php.
865 {
866 global $ilLog;
867 $imagepath = $this->getImagePath();
868 $imagepath_original = str_replace("/$this->id/images", "/$question_id/images", $imagepath);
869
870 if( (int)$objectId > 0 )
871 {
872 $imagepath_original = str_replace("/$this->obj_id/", "/$objectId/", $imagepath_original);
873 }
874
875 foreach ($this->answers as $answer)
876 {
877 $filename = $answer->getImage();
879 {
880 if (!file_exists($imagepath))
881 {
882 ilUtil::makeDirParents($imagepath);
883 }
885 {
888 }
890 {
891 if (!@copy($imagepath_original . $this->getThumbPrefix() . $filename, $imagepath . $this->getThumbPrefix() . $filename))
892 {
895 }
896 }
897 }
898 }
899 }
References $filename, $ilLog, assQuestion\getImagePath(), getThumbPrefix(), and ilUtil\makeDirParents().
Here is the call graph for this function:
◆ flushAnswers()
| assSingleChoice::flushAnswers | ( | ) |
Deletes all answers.
@access public
- See also
- $answers
Definition at line 535 of file class.assSingleChoice.php.
536 {
537 $this->answers = array();
538 }
◆ generateThumbForFile()
|
protected |
Definition at line 173 of file class.assSingleChoice.php.
174 {
177 {
179 $path_info = @pathinfo($filename);
180 $ext = "";
181 switch (strtoupper($path_info['extension']))
182 {
183 case 'PNG':
184 $ext = 'PNG';
185 break;
186 case 'GIF':
187 $ext = 'GIF';
188 break;
189 default:
190 $ext = 'JPEG';
191 break;
192 }
194 }
195 }
static convertImage($a_from, $a_to, $a_target_format="", $a_geometry="", $a_background_color="")
convert image
Definition: class.ilUtil.php:2029
References $file, $filename, $path, ilUtil\convertImage(), getThumbPrefix(), and getThumbSize().
Referenced by rebuildThumbnails(), and setImageFile().
Here is the call graph for this function:
Here is the caller graph for this function:
◆ getAdditionalTableName()
| assSingleChoice::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 788 of file class.assSingleChoice.php.
789 {
790 return "qpl_qst_sc";
791 }
Referenced by loadFromDb().
Here is the caller graph for this function:
◆ getAnswer()
| assSingleChoice::getAnswer | ( | $index = 0 | ) |
Returns an answer with a given index.
The index of the first answer is 0, the index of the second answer is 1 and so on.
- Parameters
-
integer $index A nonnegative index of the n-th answer
- Returns
- object ASS_AnswerBinaryStateImage-Object containing the answer @access public
- See also
- $answers
Definition at line 494 of file class.assSingleChoice.php.
495 {
496 if ($index < 0) return NULL;
497 if (count($this->answers) < 1) return NULL;
498 if ($index >= count($this->answers)) return NULL;
499
500 return $this->answers[$index];
501 }
Referenced by getAvailableAnswerOptions().
Here is the caller graph for this function:
◆ getAnswerCount()
| assSingleChoice::getAnswerCount | ( | ) |
Returns the number of answers.
- Returns
- integer The number of answers of the multiple choice question @access public
- See also
- $answers
Definition at line 480 of file class.assSingleChoice.php.
481 {
482 return count($this->answers);
483 }
◆ getAnswers()
| & assSingleChoice::getAnswers | ( | ) |
Returns a reference to the answers array.
Definition at line 1003 of file class.assSingleChoice.php.
1004 {
1006 }
References $answers.
Referenced by getAvailableAnswerOptions(), lmMigrateQuestionTypeSpecificContent(), rebuildThumbnails(), setExportDetailsXLS(), and toJSON().
Here is the caller graph for this function:
◆ getAnswerTableName()
| assSingleChoice::getAnswerTableName | ( | ) |
Returns the name of the answer table in the database.
- Returns
- string The answer table name @access public
Reimplemented from assQuestion.
Definition at line 799 of file class.assSingleChoice.php.
800 {
801 return "qpl_a_sc";
802 }
◆ getAvailableAnswerOptions()
| assSingleChoice::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
Implements iQuestionCondition.
Definition at line 1311 of file class.assSingleChoice.php.
1312 {
1313 if($index !== null)
1314 {
1316 }
1317 else
1318 {
1320 }
1321 }
References getAnswer(), and getAnswers().
Here is the call graph for this function:
◆ getExpressionTypes()
| assSingleChoice::getExpressionTypes | ( | ) |
Get all available expression types for a specific question.
- Returns
- array
Implements iQuestionCondition.
Definition at line 1245 of file class.assSingleChoice.php.
1246 {
1247 return array(
1251 );
1252 }
const PercentageResultExpression
Definition: interface.iQuestionCondition.php:12
const EmptyAnswerExpression
Definition: interface.iQuestionCondition.php:18
const NumberOfResultExpression
Definition: interface.iQuestionCondition.php:16
References iQuestionCondition\EmptyAnswerExpression, iQuestionCondition\NumberOfResultExpression, and iQuestionCondition\PercentageResultExpression.
◆ getMaximumPoints()
| assSingleChoice::getMaximumPoints | ( | ) |
Returns the maximum points, a learner can reach answering the question.
@access public
- See also
- $points
Reimplemented from assQuestion.
Definition at line 546 of file class.assSingleChoice.php.
547 {
548 $points = 0;
549 foreach ($this->answers as $key => $value)
550 {
552 {
553 $points = $value->getPoints();
554 }
555 }
557 }
References assQuestion\$points.
Referenced by isComplete().
Here is the caller graph for this function:
◆ getMultilineAnswerSetting()
| assSingleChoice::getMultilineAnswerSetting | ( | ) |
Definition at line 1137 of file class.assSingleChoice.php.
1138 {
1139 global $ilUser;
1140
1142 if ($multilineAnswerSetting != 1)
1143 {
1144 $multilineAnswerSetting = 0;
1145 }
1146 return $multilineAnswerSetting;
1147 }
References $ilUser.
◆ getOperators()
| assSingleChoice::getOperators | ( | $expression | ) |
Get all available operations for a specific question.
- Parameters
-
string $expression
Implements iQuestionCondition.
Definition at line 1235 of file class.assSingleChoice.php.
1236 {
1237 require_once "./Modules/TestQuestionPool/classes/class.ilOperatorsExpressionMapping.php";
1239 }
static getOperatorsByExpression($expression)
Definition: class.ilOperatorsExpressionMapping.php:33
References ilOperatorsExpressionMapping\getOperatorsByExpression().
Here is the call graph for this function:
◆ getOutputType()
| assSingleChoice::getOutputType | ( | ) |
Gets the single choice output type which is either OUTPUT_ORDER (=0) or OUTPUT_RANDOM (=1).
- Returns
- integer The output type of the assSingleChoice object @access public
- See also
- $output_type
Reimplemented from assQuestion.
Definition at line 409 of file class.assSingleChoice.php.
References $output_type.
◆ getQuestionType()
| assSingleChoice::getQuestionType | ( | ) |
Returns the question type of the question.
- Returns
- integer The question type of the question @access public
Reimplemented from assQuestion.
Definition at line 777 of file class.assSingleChoice.php.
778 {
779 return "assSingleChoice";
780 }
Referenced by toJSON().
Here is the caller graph for this function:
◆ getRTETextWithMediaObjects()
| assSingleChoice::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 988 of file class.assSingleChoice.php.
989 {
990 $text = parent::getRTETextWithMediaObjects();
991 foreach ($this->answers as $index => $answer)
992 {
994 $answer_obj = $this->answers[$index];
995 $text .= $answer_obj->getAnswertext();
996 }
998 }
References $text, and assQuestion\getId().
Here is the call graph for this function:
◆ getSpecificFeedbackAllCorrectOptionLabel()
| assSingleChoice::getSpecificFeedbackAllCorrectOptionLabel | ( | ) |
Implements ilAssSpecificFeedbackOptionLabelProvider.
Definition at line 1190 of file class.assSingleChoice.php.
1191 {
1192 return 'feedback_correct_sc_mc';
1193 }
◆ getSpecificFeedbackSetting()
| assSingleChoice::getSpecificFeedbackSetting | ( | ) |
Gets the current feedback settings in effect for the question.
Values are: 1 - Feedback is shown for all answer options. 2 - Feedback is shown for all checked/selected options. 3 - Feedback is shown for all correct options.
- Returns
- integer
Definition at line 1178 of file class.assSingleChoice.php.
1179 {
1180 if ($this->feedback_setting)
1181 {
1183 }
1184 else
1185 {
1186 return 1;
1187 }
1188 }
References $feedback_setting.
◆ getThumbPrefix()
| assSingleChoice::getThumbPrefix | ( | ) |
Definition at line 168 of file class.assSingleChoice.php.
169 {
170 return "thumb.";
171 }
Referenced by deleteImage(), duplicateImages(), generateThumbForFile(), and syncImages().
Here is the caller graph for this function:
◆ getThumbSize()
| assSingleChoice::getThumbSize | ( | ) |
Definition at line 1047 of file class.assSingleChoice.php.
1048 {
1050 }
References $thumb_size.
Referenced by generateThumbForFile(), rebuildThumbnails(), setImageFile(), and toJSON().
Here is the caller graph for this function:
◆ isAnswered()
| assSingleChoice::isAnswered | ( | $active_id, | |
$pass = NULL |
|||
| ) |
returns boolean wether the question is answered during test pass or not
(overwrites method in class assQuestion)
- Parameters
-
integer $active_id integer $pass
- Returns
- boolean $answered
Reimplemented from assQuestion.
Definition at line 1205 of file class.assSingleChoice.php.
1206 {
1207 $numExistingSolutionRecords = assQuestion::getNumExistingSolutionRecords($active_id, $pass, $this->getId());
1208
1209 return $numExistingSolutionRecords > 0;
1210 }
static getNumExistingSolutionRecords($activeId, $pass, $questionId)
returns the number of existing solution records for the given test active / pass and given question i...
Definition: class.assQuestion.php:4491
References $pass, assQuestion\getId(), and assQuestion\getNumExistingSolutionRecords().
Here is the call graph for this function:
◆ isComplete()
| assSingleChoice::isComplete | ( | ) |
Returns true, if a single choice question is complete for use.
- Returns
- boolean True, if the single choice question is complete for use, otherwise false @access public
Reimplemented from assQuestion.
Definition at line 98 of file class.assSingleChoice.php.
99 {
100 if (strlen($this->title) and ($this->author) and ($this->question) and (count($this->answers)) and ($this->getMaximumPoints() > 0))
101 {
102 foreach ($this->answers as $answer)
103 {
104 if ((strlen($answer->getAnswertext()) == 0) && (strlen($answer->getImage()) == 0)) return false;
105 }
106 return true;
107 }
108 else
109 {
110 return false;
111 }
112 }
getMaximumPoints()
Returns the maximum points, a learner can reach answering the question.
Definition: class.assSingleChoice.php:546
References getMaximumPoints().
Here is the call graph for this function:
◆ isObligationPossible()
|
static |
returns boolean wether it is possible to set this question type as obligatory or not considering the current question configuration
(overwrites method in class assQuestion)
- Parameters
-
integer $questionId
- Returns
- boolean $obligationPossible
Reimplemented from assQuestion.
Definition at line 1222 of file class.assSingleChoice.php.
1223 {
1224 return true;
1225 }
◆ lmMigrateQuestionTypeSpecificContent()
|
protected |
- Parameters
-
ilAssSelfAssessmentMigrator $migrator
Reimplemented from assQuestion.
Definition at line 1060 of file class.assSingleChoice.php.
1061 {
1063 {
1064 /* @var ASS_AnswerBinaryStateImage $answer */
1065 $answer->setAnswertext( $migrator->migrateToLmContent($answer->getAnswertext()) );
1066 }
1067 }
migrateToLmContent($content)
References getAnswers(), and ilAssSelfAssessmentMigrator\migrateToLmContent().
Here is the call graph for this function:
◆ loadFromDb()
| assSingleChoice::loadFromDb | ( | $question_id | ) |
Loads a assSingleChoice object from a database.
- Parameters
-
object $db A pear DB object integer $question_id A unique key which defines the multiple choice test in the database @access public
Reimplemented from assQuestion.
Definition at line 204 of file class.assSingleChoice.php.
205 {
206 global $ilDB;
207
208 $hasimages = 0;
209
210 $result = $ilDB->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",
211 array("integer"),
212 array($question_id)
213 );
215 {
217 $this->setId($question_id);
226 include_once("./Services/RTE/classes/class.ilRTE.php");
230 $this->setEstimatedWorkingTime(substr($data["working_time"], 0, 2), substr($data["working_time"], 3, 2), substr($data["working_time"], 6, 2));
235
236 try
237 {
239 }
241 {
242 }
243 }
244
246 array('integer'),
247 array($question_id)
248 );
249 include_once "./Modules/TestQuestionPool/classes/class.assAnswerBinaryStateImage.php";
251 {
253 {
255 if (!@file_exists($imagefilename))
256 {
258 }
259 include_once("./Services/RTE/classes/class.ilRTE.php");
261 array_push($this->answers, new ASS_AnswerBinaryStateImage($data["answertext"], $data["points"], $data["aorder"], 1, $data["imagefile"]));
262 }
263 }
264
265 parent::loadFromDb($question_id);
266 }
setTitle($title="")
Sets the title string of the assQuestion object.
Definition: class.assQuestion.php:485
setOwner($owner="")
Sets the creator/owner ID of the assQuestion object.
Definition: class.assQuestion.php:633
setEstimatedWorkingTime($hour=0, $min=0, $sec=0)
Sets the estimated working time of a question from given hour, minute and second.
Definition: class.assQuestion.php:568
setAuthor($author="")
Sets the authors name of the assQuestion object.
Definition: class.assQuestion.php:617
setPoints($a_points)
Sets the maximum available points for the question.
Definition: class.assQuestion.php:3250
setComment($comment="")
Sets the comment string of the assQuestion object.
Definition: class.assQuestion.php:521
setAdditionalContentEditingMode($additinalContentEditingMode)
setter for additional content editing mode for this question
Definition: class.assQuestion.php:4532
setQuestion($question="")
Sets the question string of the question object.
Definition: class.assQuestion.php:3685
getAdditionalTableName()
Returns the name of the additional question data table in the database.
Definition: class.assSingleChoice.php:788
static _replaceMediaObjectImageSrc($a_text, $a_direction=0, $nic=IL_INST_ID)
replaces image source from mob image urls with the mob id or replaces mob id with the correct image s...
Definition: class.ilRTE.php:236
References $data, $ilDB, $result, assQuestion\$shuffle, ilRTE\_replaceMediaObjectImageSrc(), getAdditionalTableName(), assQuestion\getImagePath(), assQuestion\setAdditionalContentEditingMode(), assQuestion\setAuthor(), assQuestion\setComment(), assQuestion\setEstimatedWorkingTime(), assQuestion\setId(), assQuestion\setNrOfTries(), assQuestion\setObjId(), assQuestion\setOriginalId(), assQuestion\setOwner(), assQuestion\setPoints(), assQuestion\setQuestion(), assQuestion\setShuffle(), setThumbSize(), and assQuestion\setTitle().
Here is the call graph for this function:
◆ rebuildThumbnails()
|
protected |
Definition at line 154 of file class.assSingleChoice.php.
155 {
157 {
159 {
160 if (strlen($answer->getImage()))
161 {
163 }
164 }
165 }
166 }
generateThumbForFile($path, $file)
Definition: class.assSingleChoice.php:173
References generateThumbForFile(), getAnswers(), assQuestion\getImagePath(), and getThumbSize().
Here is the call graph for this function:
◆ removeAnswerImage()
| assSingleChoice::removeAnswerImage | ( | $index | ) |
Definition at line 1119 of file class.assSingleChoice.php.
1120 {
1121 $answer = $this->answers[$index];
1122 if (is_object($answer))
1123 {
1124 $this->deleteImage($answer->getImage());
1125 $answer->setImage('');
1126 }
1127 }
References deleteImage().
Here is the call graph for this function:
◆ reworkWorkingData()
|
protected |
Reworks the allready saved working data if neccessary.
@access protected
- Parameters
-
integer $active_id integer $pass boolean $obligationsAnswered
Definition at line 766 of file class.assSingleChoice.php.
767 {
768 // nothing to rework!
769 }
◆ savePreviewData()
|
protected |
Reworks the allready saved working data if neccessary.
@abstract @access protected
- Parameters
-
integer $active_id integer $pass boolean $obligationsAnswered
Reimplemented from assQuestion.
Definition at line 689 of file class.assSingleChoice.php.
690 {
692 {
694 }
695 else
696 {
698 }
699 }
setParticipantsSolution($participantSolution)
Definition: class.ilAssQuestionPreviewSession.php:69
References $_POST, assQuestion\getId(), and ilAssQuestionPreviewSession\setParticipantsSolution().
Here is the call graph for this function:
◆ saveWorkingData()
| assSingleChoice::saveWorkingData | ( | $active_id, | |
$pass = NULL, |
|||
$authorized = true |
|||
| ) |
Saves the learners input of the question to the database.
@access public
- Parameters
-
integer $active_id Active id of the user integer $pass Test pass
- Returns
- boolean $status
Reimplemented from assQuestion.
Definition at line 628 of file class.assSingleChoice.php.
629 {
630 global $ilDB;
631 global $ilUser;
632
634 {
635 include_once "./Modules/Test/classes/class.ilObjTest.php";
637 }
638 $entered_values = 0;
639
640 $this->getProcessLocker()->requestUserSolutionUpdateLock();
641
645
646 if ($update)
647 {
649 {
651 $entered_values++;
652 }
653 else
654 {
655 $this->removeSolutionRecordById($update);
656 }
657 }
658 else
659 {
661 {
662 $this->saveCurrentSolution($active_id, $pass, $_POST['multiple_choice_result'], null, $authorized);
663 $entered_values++;
664 }
665 }
666
667 $this->getProcessLocker()->releaseUserSolutionUpdateLock();
668
669 if ($entered_values)
670 {
671 include_once ("./Modules/Test/classes/class.ilObjAssessmentFolder.php");
673 {
674 $this->logAction($this->lng->txtlng("assessment", "log_user_entered_values", ilObjAssessmentFolder::_getLogLanguage()), $active_id, $this->getId());
675 }
676 }
677 else
678 {
679 include_once ("./Modules/Test/classes/class.ilObjAssessmentFolder.php");
681 {
682 $this->logAction($this->lng->txtlng("assessment", "log_user_not_entered_values", ilObjAssessmentFolder::_getLogLanguage()), $active_id, $this->getId());
683 }
684 }
685
686 return true;
687 }
updateCurrentSolution($solutionId, $value1, $value2, $authorized=true)
Definition: class.assQuestion.php:4838
removeSolutionRecordById($solutionId)
Definition: class.assQuestion.php:4719
logAction($logtext="", $active_id="", $question_id="")
Logs an action into the Test&Assessment log.
Definition: class.assQuestion.php:1480
saveCurrentSolution($active_id, $pass, $value1, $value2, $authorized=true)
Definition: class.assQuestion.php:4803
_getLogLanguage()
retrieve the log language for assessment logging
Definition: class.ilObjAssessmentFolder.php:224
_enabledAssessmentLogging()
check wether assessment logging is enabled or not
Definition: class.ilObjAssessmentFolder.php:179
_getPass($active_id)
Retrieves the actual pass of a given user for a given test.
Definition: class.ilObjTest.php:8147
References $_POST, $ilDB, $ilUser, $pass, $result, $row, ilObjAssessmentFolder\_enabledAssessmentLogging(), ilObjAssessmentFolder\_getLogLanguage(), ilObjTest\_getPass(), assQuestion\getCurrentSolutionResultSet(), assQuestion\getProcessLocker(), assQuestion\logAction(), assQuestion\removeSolutionRecordById(), assQuestion\saveCurrentSolution(), and assQuestion\updateCurrentSolution().
Referenced by createRandomSolution().
Here is the call graph for this function:
Here is the caller graph for this function:
◆ setExportDetailsXLS()
| assSingleChoice::setExportDetailsXLS | ( | & | $worksheet, |
| $startrow, | |||
| $active_id, | |||
| $pass, | |||
| & | $format_title, | ||
| & | $format_bold | ||
| ) |
Creates an Excel worksheet for the detailed cumulated results of this question.
- Parameters
-
object $worksheet Reference to the parent excel worksheet object $startrow Startrow of the output in the excel worksheet object $active_id Active id of the participant object $pass Test pass object $format_title Excel title format object $format_bold Excel bold format array $eval_data Cumulated evaluation data @access public
Reimplemented from assQuestion.
Definition at line 1020 of file class.assSingleChoice.php.
1021 {
1022 include_once ("./Services/Excel/classes/class.ilExcelUtils.php");
1024 $worksheet->writeString($startrow, 0, ilExcelUtils::_convert_text($this->lng->txt($this->getQuestionType())), $format_title);
1025 $worksheet->writeString($startrow, 1, ilExcelUtils::_convert_text($this->getTitle()), $format_title);
1026 $i = 1;
1028 {
1029 $worksheet->writeString($startrow + $i, 0, ilExcelUtils::_convert_text($answer->getAnswertext()), $format_bold);
1030 if(
1031 count($solution) > 0 &&
1032 isset($solution[0]) &&
1033 is_array($solution[0]) &&
1035 {
1036 $worksheet->write($startrow + $i, 1, 1);
1037 }
1038 else
1039 {
1040 $worksheet->write($startrow + $i, 1, 0);
1041 }
1042 $i++;
1043 }
1044 return $startrow + $i + 1;
1045 }
getSolutionValues($active_id, $pass=NULL, $authorized=true)
Loads solutions of a given user from the database an returns it.
Definition: class.assQuestion.php:1670
_convert_text($a_text, $a_target="has been removed")
Definition: class.ilExcelUtils.php:14
References assQuestion\$id, $pass, ilExcelUtils\_convert_text(), getAnswers(), assQuestion\getSolutionValues(), and assQuestion\getTitle().
Here is the call graph for this function:
◆ setImageFile()
| assSingleChoice::setImageFile | ( | $image_filename, | |
$image_tempfilename = "" |
|||
| ) |
Sets the image file and uploads the image to the object's image directory.
- Parameters
-
string $image_filename Name of the original image file string $image_tempfilename Name of the temporary uploaded image file
- Returns
- integer An errorcode if the image upload fails, 0 otherwise @access public
Definition at line 812 of file class.assSingleChoice.php.
813 {
814 $result = 0;
815 if (!empty($image_tempfilename))
816 {
817 $image_filename = str_replace(" ", "_", $image_filename);
818 $imagepath = $this->getImagePath();
819 if (!file_exists($imagepath))
820 {
821 ilUtil::makeDirParents($imagepath);
822 }
823 //if (!move_uploaded_file($image_tempfilename, $imagepath . $image_filename))
824 if (!ilUtil::moveUploadedFile($image_tempfilename, $image_filename, $imagepath.$image_filename))
825 {
826 $result = 2;
827 }
828 else
829 {
830 include_once "./Services/MediaObjects/classes/class.ilObjMediaObject.php";
831 $mimetype = ilObjMediaObject::getMimeType($imagepath . $image_filename);
832 if (!preg_match("/^image/", $mimetype))
833 {
834 unlink($imagepath . $image_filename);
835 $result = 1;
836 }
837 else
838 {
839 // create thumbnail file
841 {
842 $this->generateThumbForFile($imagepath, $image_filename);
843 }
844 }
845 }
846 }
848 }
static getMimeType($a_file, $a_external=false)
get mime type for file
Definition: class.ilObjMediaObject.php:1483
static moveUploadedFile($a_file, $a_name, $a_target, $a_raise_errors=true, $a_mode="move_uploaded")
move uploaded file
Definition: class.ilUtil.php:4158
References $result, generateThumbForFile(), assQuestion\getImagePath(), ilObjMediaObject\getMimeType(), getThumbSize(), ilUtil\makeDirParents(), and ilUtil\moveUploadedFile().
Here is the call graph for this function:
◆ setMultilineAnswerSetting()
| assSingleChoice::setMultilineAnswerSetting | ( | $a_setting = 0 | ) |
Definition at line 1149 of file class.assSingleChoice.php.
References $ilUser.
◆ setOutputType()
| assSingleChoice::setOutputType | ( | $output_type = OUTPUT_ORDER | ) |
Sets the output type of the assSingleChoice object.
- Parameters
-
integer $output_type A nonnegative integer value specifying the output type. It is OUTPUT_ORDER (=0) or OUTPUT_RANDOM (=1). @access public
- See also
- $response
Reimplemented from assQuestion.
Definition at line 421 of file class.assSingleChoice.php.
References $output_type.
◆ setSpecificFeedbackSetting()
| assSingleChoice::setSpecificFeedbackSetting | ( | $a_feedback_setting | ) |
Sets the feedback settings in effect for the question.
Options are: 1 - Feedback is shown for all answer options. 2 - Feedback is shown for all checked/selected options. 3 - Feedback is shown for all correct options.
- Parameters
-
integer $a_feedback_setting
Definition at line 1164 of file class.assSingleChoice.php.
1165 {
1166 $this->feedback_setting = $a_feedback_setting;
1167 }
◆ setThumbSize()
| assSingleChoice::setThumbSize | ( | $a_size | ) |
Definition at line 1052 of file class.assSingleChoice.php.
1053 {
1054 $this->thumb_size = $a_size;
1055 }
Referenced by loadFromDb().
Here is the caller graph for this function:
◆ syncImages()
|
protected |
Sync images of a MC question on synchronisation with the original question.
Definition at line 944 of file class.assSingleChoice.php.
945 {
946 global $ilLog;
947 $question_id = $this->getOriginalId();
948 $imagepath = $this->getImagePath();
949 $imagepath_original = str_replace("/$this->id/images", "/$question_id/images", $imagepath);
950 ilUtil::delDir($imagepath_original);
951 foreach ($this->answers as $answer)
952 {
953 $filename = $answer->getImage();
955 {
957 {
958 if (!file_exists($imagepath))
959 {
960 ilUtil::makeDirParents($imagepath);
961 }
962 if (!file_exists($imagepath_original))
963 {
964 ilUtil::makeDirParents($imagepath_original);
965 }
967 {
970 }
971 }
973 {
974 if (!@copy($imagepath . $this->getThumbPrefix() . $filename, $imagepath_original . $this->getThumbPrefix() . $filename))
975 {
978 }
979 }
980 }
981 }
982 }
References $filename, $ilLog, ilUtil\delDir(), assQuestion\getImagePath(), assQuestion\getOriginalId(), getThumbPrefix(), and ilUtil\makeDirParents().
Here is the call graph for this function:
◆ toJSON()
| assSingleChoice::toJSON | ( | ) |
Returns a JSON representation of the question.
Reimplemented from assQuestion.
Definition at line 1072 of file class.assSingleChoice.php.
1073 {
1074 include_once("./Services/RTE/classes/class.ilRTE.php");
1075 $result = array();
1082
1084 'onenotcorrect' => $this->formatSAQuestion($this->feedbackOBJ->getGenericFeedbackTestPresentation($this->getId(), false)),
1085 'allcorrect' => $this->formatSAQuestion($this->feedbackOBJ->getGenericFeedbackTestPresentation($this->getId(), true))
1086 );
1087
1088 $answers = array();
1089 $has_image = false;
1091 {
1092 if((string) $answer_obj->getImage())
1093 {
1094 $has_image = true;
1095 }
1096 array_push($answers, array(
1098 "points" => (float)$answer_obj->getPoints(),
1099 "order" => (int)$answer_obj->getOrder(),
1100 "image" => (string) $answer_obj->getImage(),
1101 "feedback" => $this->formatSAQuestion(
1102 $this->feedbackOBJ->getSpecificAnswerFeedbackExportPresentation($this->getId(), $key)
1103 )
1104 ));
1105 }
1107 if($has_image)
1108 {
1111 }
1112
1115
1117 }
getImagePathWeb()
Returns the web image path for web accessable images of a question.
Definition: class.assQuestion.php:1628
getQuestionType()
Returns the question type of the question.
Definition: class.assSingleChoice.php:777
_getMobsOfObject($a_type, $a_id, $a_usage_hist_nr=0, $a_lang="-")
get mobs of object
Definition: class.ilObjMediaObject.php:1054
References $answers, $mobs, $result, ilObjMediaObject\_getMobsOfObject(), assQuestion\formatSAQuestion(), getAnswers(), assQuestion\getId(), assQuestion\getImagePathWeb(), assQuestion\getNrOfTries(), assQuestion\getQuestion(), getQuestionType(), assQuestion\getShuffle(), getThumbSize(), and assQuestion\getTitle().
Here is the call graph for this function:
Field Documentation
◆ $answers
| assSingleChoice::$answers |
Definition at line 34 of file class.assSingleChoice.php.
Referenced by getAnswers(), and toJSON().
◆ $feedback_setting
|
protected |
Definition at line 59 of file class.assSingleChoice.php.
Referenced by getSpecificFeedbackSetting().
◆ $output_type
| assSingleChoice::$output_type |
Definition at line 44 of file class.assSingleChoice.php.
Referenced by __construct(), getOutputType(), and setOutputType().
◆ $thumb_size
|
protected |
Definition at line 51 of file class.assSingleChoice.php.
Referenced by getThumbSize().
The documentation for this class was generated from the following file:
- Modules/TestQuestionPool/classes/class.assSingleChoice.php
