Grader
in package
Score a Quiz1 quiz from submitted student responses.
Matches Common Cartridge QTI 1.2.1 rules used by Qti12Exporter: multiple choice / true-false = one correct choice; multiple response = all-or-nothing; fill-in-the-blank = case-insensitive exact; pattern match = substring (optional case). Essays are not computer-scored.
Does not persist attempts.
Table of Contents
Constants
Methods
-
grade()
: array{earned: int, possible: int, essay_possible: int, items: array
>} - gradebookScore() : array{grade: float, earned: int, total: int, pending_manual: bool}|null
- Fraction to store on the result after a finished take.
- gradeQuestion() : array{status: string, earned: int, possible: int, submitted: mixed}
- plain() : mixed
- submittedFor() : mixed
- gradeFillBlank() : mixed
- gradeMultipleResponse() : mixed
- gradePatternMatch() : mixed
- gradeSingleChoice() : mixed
Constants
CORRECT
public
mixed
CORRECT
= 'correct'
INCORRECT
public
mixed
INCORRECT
= 'incorrect'
UNSCORED
public
mixed
UNSCORED
= 'unscored'
Methods
grade()
public
static grade(Quiz1 $quiz, array<string, mixed> $post) : array{earned: int, possible: int, essay_possible: int, items: array>}
Parameters
- $quiz : Quiz1
- $post : array<string, mixed>
-
Request POST (q{id} / q{id}[])
Return values
array{earned: int, possible: int, essay_possible: int, items: arraygradebookScore()
Fraction to store on the result after a finished take.
public
static gradebookScore(array{earned?: int, possible?: int, essay_possible?: int} $graded) : array{grade: float, earned: int, total: int, pending_manual: bool}|null
Auto-only quizzes can earn every point by machine, so the fraction is earned over those points. Essay points stay in the denominator and are not yet earned, so four auto points and one ungraded essay is 0.8.
Parameters
- $graded : array{earned?: int, possible?: int, essay_possible?: int}
Return values
array{grade: float, earned: int, total: int, pending_manual: bool}|nullgradeQuestion()
public
static gradeQuestion(Question $question, mixed $submitted) : array{status: string, earned: int, possible: int, submitted: mixed}
Parameters
- $question : Question
- $submitted : mixed
Return values
array{status: string, earned: int, possible: int, submitted: mixed}plain()
public
static plain(mixed $html) : mixed
Parameters
- $html : mixed
submittedFor()
public
static submittedFor(Question $question, array<string, mixed> $post) : mixed
Parameters
- $question : Question
- $post : array<string, mixed>
gradeFillBlank()
private
static gradeFillBlank(Question $question, mixed $submitted) : mixed
Parameters
- $question : Question
- $submitted : mixed
gradeMultipleResponse()
private
static gradeMultipleResponse(Question $question, mixed $submitted) : mixed
Parameters
- $question : Question
- $submitted : mixed
gradePatternMatch()
private
static gradePatternMatch(Question $question, mixed $submitted) : mixed
Parameters
- $question : Question
- $submitted : mixed
gradeSingleChoice()
private
static gradeSingleChoice(Question $question, mixed $submitted) : mixed
Parameters
- $question : Question
- $submitted : mixed