Openworld FlashPresenter - Quiz Results Processing

How to process quiz results using server-side scripting language:

It is pretty obvious, that you might wish to process testing results in your learning management system (LMS). You can do it with ease, as quiz results can be sent to your server-side script in standard form, containing all significant result data, and can be stored in a database. The server-side script interface is described below.

1. INPUT DATA:

The next variables are sent to the server-side script in the submit request, which is sent by POST method:

General quiz data:

is_submit The flag, which server-side script should return = 1 if the results are submitted correctly or = 0 if some error is found and results must be submitted once again. Initial value is 0.

quiz_id: The quiz ID is used in LMS to identify quiz.

user_id: the user ID is filled by the user and identifies him/her in the LMS.

total_points: The total points value in the quiz.

passing_points: Passing score level, set for the quiz.

correct_points: User score.

q_count: Questions count in the quiz.

Question data for each question N from 0 to q_count - 1

q_N_passed: Results of question passing. May be true or false.

q_N_timeused: Time, used for question answering. Zero if timer was inactive for this question.

Answer data for each answer M, that user has made for this question, including both correct and incorrect answers. M is within the interval from 0 up to the maximal answer number, available for user's input for the question N minus one.

q_N_answer_M: Answer value for each answer. Some question types may have multiple answers. "True/false", "Multiple Choices" and "Multiple Response" question types have answers as integer ordering number of the answer variant, specified for the question. "Free Text" and "Fill in the Blank" types have answers, as strings in UTF-8 encoding.

2. OUTPUT DATA:

The next variables should be sent back from the script:

is_submit: The flag, which server-side script should return = 1 if the results are submitted correctly or = 0 if some error is found and results must be submitted once again.

submit_msg: The string, formatted as WWW-URL-encoded UTF-8 string, containing any message, which will be displayed in the quiz result dialog. It may contain as success message as error message, if the is_submit variable is returned with 0 value. The default message (is embedded into quiz code) will be used if the submit_msg value returned is empty.

Output data must be sent to the client-side application through the standard output in usual WWW-URL-Encoded form like this:

is_submit=1&submit_msg=This%20is%20submit%20message

3. PHP SCRIPT SAMPLE:

A simple PHP script is shown below. It does nothing but collect input variables, write them to a log file, set the meaningful variable is_submit to 1 and report the client's IP address to the client as the submit results message.

The script is compatible with PHP of version 5 and above, installed as module of the Apache webserver.

<?php
  $p = $_POST;
  $f = fopen("log.txt","a");
  foreach($p as $k => $v) {
    fwrite($f, $k . "=" . $v . " ");
  }
  fwrite($f, "\n");
  fclose($f);
  $addr=$_SERVER["REMOTE_ADDR"];
  $msg="This%20is%20a%20message%20from%20my%20PHP%20script.";
  $msg .= "\n";
  $msg .= "Your%20IP%20is%20$addr";
  $msg .= "\n\n";
  $msg .= "Press%20\"Continue\"%20to%20exit.";
  echo "is_submit=1&submit_msg=$msg";
?>