function QuizController::resume in Quiz 6.x

Same name and namespace in other branches

1. 8.6 src/Controller/QuizController.php \Drupal\quiz\Controller\QuizController::resume()
2. 8.5 src/Controller/QuizController.php \Drupal\quiz\Controller\QuizController::resume()

Resume a quiz.

Search the database for an in progress attempt, and put it back into the session if allowed.

Return value

QuizResult

1 call to QuizController::resume()

QuizController::take in src/Controller/QuizController.php

Take the quiz.

File

src/Controller/QuizController.php, line 173

Class

QuizController

Namespace

Drupal\quiz\Controller

Code

function resume($quiz) {
  $user = \Drupal::currentUser();

  /* @var $quiz_session \Drupal\quiz\Services\QuizSessionInterface */
  $quiz_session = \Drupal::service('quiz.session');

  // Make sure we use the same revision of the quiz throughout the quiz taking
  // session.
  $quiz_result = $quiz_session
    ->getResult($quiz);
  if ($quiz_result) {
    return $quiz_result;
  }
  else {

    // User doesn't have attempt in session. If we allow resuming we can load it
    // from the database.
    if ($quiz
      ->get('allow_resume')
      ->getString() && $user
      ->isAuthenticated()) {
      if ($quiz_result = $quiz
        ->getResumeableResult($user)) {

        // Put the result in the user's session.
        $quiz_session
          ->startQuiz($quiz_result);

        // Now advance the user to after the last answered question.
        $prev = NULL;
        foreach ($quiz_result
          ->getLayout() as $qra) {
          if ($prev) {
            if ($qra
              ->get('answer_timestamp')
              ->isEmpty() && !$prev
              ->get('answer_timestamp')
              ->isEmpty()) {

              // This question has not been answered, but the previous
              // question has.
              $quiz_session
                ->setCurrentQuestion($quiz, $qra
                ->get('number')
                ->getString());
            }
          }
          $prev = clone $qra;
        }

        // Mark this quiz as being resumed from the database.
        $quiz_result->resume = TRUE;
        return $quiz_result;
      }
    }
  }
  return FALSE;
}