Documentation Support > Extensions > Grade
| Format: | (:zap grade_<field>="":) |
Requirements to Use: ZAP | ZAP Toolbox
Explanation: Suppose you want to produce a form which calculated a grade for a quiz. You would add a field named "grade_quiz". When ZAP encountered this it would:
1) Look for all input fields of the format "quiz_*" and sum the total points of their values. Negative values can be assigned to penalize wrong answers. Use multiple checkboxes in the form of an array, and all checked values are automatically added together.
2) ZAP next uses the value of field "quiz_total" to create a percentage. This percentage is then inserted into "grade_quiz", where it can be save and retrieved as a normal text variable.
3) Next, ZAP looks for a field of the name "quiz_fmt", to determine how to format the percentage (usually a letter grade). The format of this field should be an ascending CSV list of points and formats. For example, assuming a score of 75%, this would produce a letter grade of "C":
grade_quizfmt="0=F,60=D,70=C,80=B,90=A"
The new value is substituted into "grade_quizfmt". See the grades snippet for an example of how to use this feature, to avoid problems with processing order, and preserve default fmt values.
Use of the grade command is not limited to quizzes. The word quiz can be substituted with any other word. You could just as easily calculate a grade for an entire course, retrieving grades from various quizzes into one course grade page, and calculate a percentage based on the total course points possible.
As a security feature, this command can ONLY be set using the (:zap field="value":) format.
Note: I just added a new syntax to store user submitted answers as well. To use it, you might set field "quiz_1" equal to "10|My Answer". The 10 would be figured into the grade, and quiz_1 would be set to "My Answer" where it can be saved and retrieved for display in their quiz results page. This feature is not available for an array of answers, though it can used in a bunch of individually named checkboxes.