आपकी वेबसाइट के लिए एक क्विज़

क्या आप अपनी वेबसाइट पर दर्ज करना चाहते हैं कि किसी ने क्विज़ पास कर लिया – जैसे किसी पाठ को पूरा मानने या पॉइंट देने के लिए? तब नतीजे की पुष्टि Qwissit से करवाएँ। इस तरह कोई इसे नकली नहीं बना सकता।

यह कैसे काम करता है

1. आपका पेज क्विज़ को एक बार इस्तेमाल होने वाला कोड देता है और उसे याद रखता है।
2. विज़िटर क्विज़ हल करता है। Qwissit हर उत्तर खुद जाँचता है; गलत उत्तर वाले प्रश्न तब तक दोबारा आते हैं जब तक सब सही न हों।
3. अंत में आपके पेज को एक प्रमाण मिलता है, जिसे सिर्फ़ Qwissit जारी कर सकता है, और पेज उसे आपके सर्वर को भेजता है।
4. आपका सर्वर Qwissit से पूछता है कि प्रमाण असली है और आपके कोड व क्विज़ से मेल खाता है या नहीं। तभी वह नतीजा सेव करता है।

आपको क्या जोड़ना है

दो जगहें, दोनों PHP में। आपके विज़िटर लॉग-इन होने चाहिए (सेशन), क्योंकि नतीजा किसी व्यक्ति का होना चाहिए।

A) क्विज़ वाले पेज पर: यह ब्लॉक सामान्य स्निपेट की जगह लेता है। data-set और data-course को अपने क्विज़ के अनुसार बदलें – मान ऊपर के कोड में हैं।

<?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) एक नई फ़ाइल quiz-complete.php उसी फ़ोल्डर में। QUIZZES में set और course के वही मान लिखें और चिह्नित जगह पर नतीजा उस तरह सेव करें जो आपकी वेबसाइट के लिए ठीक हो।

<?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]);

फ़ाइल तभी सेव करती है जब Qwissit प्रमाण की पुष्टि करे, वह आपके एक-बार वाले कोड से जुड़ा हो और सही क्विज़ का हो। उसके बाद कोड इस्तेमाल हो चुका होता है, इसलिए हर नतीजा सिर्फ़ एक बार गिना जाता है। अगर अभी Qwissit तक पहुँच न हो, तो कुछ सेव नहीं होता – विज़िटर को बाद में फिर कोशिश करने दें। प्रमाण एक घंटे तक मान्य है।

जानने लायक

• आपके सर्वर से होकर क्यों? विजेट क्विज़ के खत्म होने की सूचना सीधे ब्राउज़र में भी देता है (इवेंट qwissit:finish), लेकिन थोड़ी तकनीकी जानकारी वाला कोई भी इसे खुद चला सकता है। कुछ दिखाने के लिए यह काफ़ी है, पॉइंट, सर्टिफ़िकेट या अनलॉक के लिए नहीं।
• कोड वाला क्विज़ सिर्फ़ लॉग-इन विज़िटर को दिखाएँ और बाकी सबके लिए सेशन न बनाएँ – वरना हर बॉट एक सेशन बना देगा।
• quiz-complete.php को अपने दूसरे फ़ॉर्म की तरह सुरक्षित रखें: लॉगिन जाँचें, सिर्फ़ अपनी साइट से आए अनुरोध स्वीकार करें, अनुरोधों की संख्या सीमित करें।
• सफलता के बाद विज़िटर को अगली बार नया कोड मिलता है और वह क्विज़ दोहरा सकता है।
• जाँचने के लिए: गढ़ा हुआ प्रमाण, वही प्रमाण दूसरी बार और किसी दूसरे क्विज़ का प्रमाण – सब अस्वीकार होने चाहिए।