Skip to content

Latest commit

 

History

History
83 lines (53 loc) · 5.73 KB

README.md

File metadata and controls

83 lines (53 loc) · 5.73 KB
Raw

Moderovaný online kvíz

Tento moderovaný online kvíz som vytvoril tak, aby nevyžadoval žiadny databázový server. Všetko je ukladané do textových súborov a hosting je tak možný aj na bezplatných platformách s podporou PHP. Tiež nie je potrebná žiadna registrácia alebo inštalácia aplikácie. Všetko funguje rovnako dobre cez web na mobile, tablete, notebooku alebo stolovom počítači.

Na server sú kladené minimálne nároky, pretože som sa kompletne vyhol takému niečomu ako jQuery. Miestami využívam iba veľmi jednoduchý JavaScript.

Vzhľad

Vzhľad je veľmi jednoduchý a je definovaný pre všetky stránky v style.css. Hlavným cieľom vzhľadu je šetrenie životného prostredia pomocou čierneho režimu pri dobrej čitateľnosti textu a dobrej pozerateľnosti obrázkov a videí.

Bodovanie

Za každú správnu odpoveď hráč získava 4 body. Za každú prvú správnu odpoveď hráč získava 1 bod. Na každú otázku je vždy práve jedna správna odpoveď (A, B, C alebo D). Ak sa po vyhodnotení stane, že niektorí hráči majú rovnaký počet bodov, je pripravená rozstrelová otázka. Kto na ňu odpovie správne prvý, ten vyhráva.

Takto to funguje

Závislosti na kóde tretích strán

  • obrázok s QR kódom (zobrazený v súbore index.php) vytvára PHP QR Code - súbor phpqrcode.php
  • zabezpečenie stránky heslom (súbory moderator.php a sprava.php) poskytuje Web Page Password Protect - súbor ochrana.php

Textové databázové súbory

  • otázky sú pripravené vo formáte TSV (tu v súbore otazky-demo.tsv) a vypísať ich je možné pomocou sprava.php
  • odpovede sa ukladajú vo formáte CSV (tu v súbore odpovede-demo.csv) a vypísať ich je možné pomocou sprava.php

Sada otázok (súbor s koncovkou tsv, čiže kvíz) je zapísaná v konfiguračnom súbore kviz.include, ktorý obsahuje iba názov kvízu. Tento názov je možné prepísať pomocou sprava.php. Podľa názvu sa vyberá sada otázok, čiže kvíz.

Otázky

Otázky spolu so 4 možnosťami odpovedí sú zapísané v súbore s koncovkou TSV (tab-separated values), pričom na konci riadku je písmeno správnej odpovede:

Znenie otázky(tabulátor)Odpoveď A(tabulátor)Odpoveď B(tabulátor)Odpoveď C(tabulátor)Odpoveď D(tabulátor)Písmeno správnej odpovede

Odpovede

Odpovede sa zapisujú do súboru s koncovkou CSV (comma-separated values) v tomto poradí:

  • rok, mesiac a deň (RRRRMMDD)
  • hodina, minúta, sekunda (HHMMSS)
  • názov kvízu (tu demo)
  • meno hráča (tu Tibor)
  • číslo otázky (napr. 1)
  • písmeno označenej odpovede (napr. A)
  • emailová adresa (tu [email protected])
RRRRMMDD,HHMMSS,demo,Tibor,1,A,[email protected]

Obslužná časť kvízu

  • hrac.php je pre hráča, využíva iba zapis_odpoved.php a ideálne je načítať ho cez mobil, preto obsahuje QR kód s URL generovaný pomocou phpqrcode.php. V prípade, že mobil nedokáže URL z QR kódu načítať, URL je pod QR kódom aj vypísaná. Pod URL je ešte v zátvorkách zapísaný názov kvízu (čiže sady otázok).
  • moderator.php je pre moderátora, obsahuje znenie otázok a možností odpovedí, využíva zablokuj_otazku.php, odblokuj_otazku.php, odblokuj_vsetky_otazky.php a ideálne je načítať ho na veľkom monitore (TV), aby hráči na obsah dobre videli. Online moderovanie je možné cez aplikácie ako napr. Zoom.
  • sprava.php je pre administrátora kvízov. Umožňuje nahrávať nové kvízy (text v tsv, obrázky v jpg a png, zvuk v mp3 a video v mp4) pomocou nahraj_subor.php, vybrať kvíz (použiť) pomocou zapis_nazov_kvizu.php, upravovať text nahraných kvízov pomocou uprav_subor.php a zapis_upravu_suboru.php, zobrazovať odpovede pomocou zobraz_odpovede.php a vymazať odpovede pomocou vymaz_subor.php.

Po ukončení kvízu

  • 1_stiahni_nazov_kvizu.bat - stiahne súbor kviz.include, ktorý je potrebný pre vytvorenie poradie.html pomocou vyhodnot.au3
  • 2_stiahni_odpovede.bat - po ukončení kvízu si moderátor stiahne odpovede (súbor s koncovkou TSV), aby ich mohol vyhodnotiť pomocou vyhodnot.au3 a výsledok zapísať do poradie.html
  • vyhodnot.au3 - teraz máme všetky potrebné údaje stiahnuté offline a môžeme tak vyhodnotiť zíksané odpovede, pričom výsledok sa zapíše do súboru poradie.html

Inštalácia

Jednoducho stiahnete najnovšiu verziu ako komprimovaný súbor formátu ZIP, súbory rozbalíte a nahráte na hosting do priečinku s názvom kviz-demo cez FTP. Potom už len do webového prehliadača zadáte jednu z adries z časti Takto to funguje, pričom doménu tiborepcek.com nahradíte vlastnou.

Ďalšia možnosť je stiahnuť potrebné súbory cez Git. Po pripojení na server cez SSH spustite tento príkaz a všetky potrebné súbory sa stiahnu do priečinka s názvom kviz:

git clone https://github.com/tiborepcek/kviz.git

Výhoda stiahnutia súborov cez Git je okrem rýchlosti aj následná jednoduchosť aktualizácie. Stačí, keď v priečinku kvíz spustíte tento príkaz a v prípade dostupnej aktualizácie sa jednotlivé súbory aktualizujú na najnovšiu verziu:

git pull