Un quiz para tu web

¿Quieres registrar en tu web que alguien ha superado el quiz, por ejemplo para marcar una lección o dar puntos? Entonces deja que Qwissit confirme el resultado. Así nadie puede falsearlo.

Cómo funciona

1. Tu página da al quiz un código de un solo uso y lo recuerda.
2. El visitante resuelve el quiz. Qwissit comprueba cada respuesta; las preguntas falladas vuelven hasta que todas estén bien.
3. Al final, tu página recibe un justificante que solo Qwissit puede emitir y lo envía a tu servidor.
4. Tu servidor pregunta a Qwissit si el justificante es auténtico y corresponde a tu código y a tu quiz. Solo entonces guarda el resultado.

Qué tienes que añadir

Dos sitios, ambos en PHP. Tus visitantes deben haber iniciado sesión, porque el resultado tiene que pertenecer a alguien.

A) En la página del quiz: Este bloque sustituye al fragmento normal. Ajusta data-set y data-course a tu quiz; los valores están en el código de arriba.

<?php
session_start();   // your visitors are signed in
$nonce = $_SESSION['quiz_nonce']['http'] ??= rtrim(strtr(base64_encode(random_bytes(16)), '+/', '-_'), '=');
?>
<div id="quiz" data-qwissit-widget data-set="12" data-course="13" data-lang="de"
     data-verify="<?= $nonce ?>"></div>
<script src="https://www.qwissit.com/widget/v1/qwissit-widget.js" async></script>
<script>
document.getElementById('quiz').addEventListener('qwissit:finish', function (e) {
  if (!e.detail.passed || !e.detail.token) return;
  fetch('quiz-complete.php', {
    method: 'POST',
    credentials: 'same-origin',
    headers: { 'Content-Type': 'application/x-www-form-urlencoded' },
    body: 'lesson=http&token=' + encodeURIComponent(e.detail.token)
  }).then(function (r) {
    if (r.ok) { /* done: e.g. show a tick */ }
  });
});
</script>

B) Un archivo nuevo quiz-complete.php en la misma carpeta. Pon en QUIZZES los mismos valores de set y course y guarda el resultado en la línea marcada como convenga a tu web.

<?php
// quiz-complete.php – checks the result with Qwissit and saves it only if everything matches
session_start();
const QUIZZES = ['http' => ['set' => 12, 'course' => 13]];   // same values as data-set / data-course

$lesson = (string)($_POST['lesson'] ?? '');
$token = (string)($_POST['token'] ?? '');
$quiz = QUIZZES[$lesson] ?? null;
$nonce = (string)($_SESSION['quiz_nonce'][$lesson] ?? '');
if (!$quiz || $nonce === '' || $token === '') { http_response_code(400); exit; }

$ch = curl_init('https://www.qwissit.com/widget/v1/verify');
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_POSTFIELDS => http_build_query(['token' => $token]),
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT => 4,
]);
$r = json_decode((string)curl_exec($ch), true);
curl_close($ch);

if (!is_array($r)) { http_response_code(503); exit; }   // Qwissit not reachable: save nothing
if (($r['valid'] ?? false) !== true
    || !hash_equals($nonce, (string)($r['nonce'] ?? ''))
    || (int)$r['set'] !== $quiz['set'] || (int)$r['course'] !== $quiz['course']) {
    http_response_code(403); exit;                       // forged, already used, expired or another quiz
}
unset($_SESSION['quiz_nonce'][$lesson]);                 // the code counts only once

// ▶ save the result here, e.g. user + $lesson + date (+ $r['wrong'] = failed attempts)

header('Content-Type: application/json');
echo json_encode(['ok' => true]);

El archivo solo guarda si Qwissit confirma el justificante, este pertenece a tu código de un solo uso y procede del quiz correcto. Después el código queda gastado, así que cada resultado cuenta una sola vez. Si ahora no se puede contactar con Qwissit, no se guarda nada: deja que el visitante lo intente más tarde. El justificante vale una hora.

Conviene saber

• ¿Por qué el rodeo por tu servidor? El widget también comunica el final del quiz directamente en el navegador (evento qwissit:finish), pero cualquiera con algo de conocimientos técnicos puede lanzarlo por su cuenta. Basta para mostrar algo, no para puntos, certificados o desbloqueos.
• Muestra el quiz con código solo a visitantes con sesión iniciada y no crees sesiones para los demás; si no, cada bot crea una.
• Protege quiz-complete.php como tus otros formularios: comprueba el inicio de sesión, acepta solo solicitudes de tu propio sitio y limita el número de solicitudes.
• Tras un éxito, el visitante recibe un código nuevo en la siguiente visita y puede repetir el quiz.
• Para probar: un justificante inventado, el mismo justificante por segunda vez y el de otro quiz deben rechazarse.