aplikacja Aplikacja Astro-Quiz

[.przemas.]

Dzień dobry,

chciałem się podzielić z Wami aplikacją, którą napisałem kilka miesięcy temu na potrzeby otwartych drzwi na Wydziale Fizyki i Astronomii Uniwersytetu Wrocławskiego. Jest to quiz, ale o nieco rozbudowanych możliwościach. Motywacją do jego stworzenia był fakt, że ciężko było znaleźć coś darmowego o podobnych możliwościach.

Astro-Quiz na GitHubie

Zareklamuję produkt w postaci FAQ:

1. Kto może skorzystać z aplikacji?

Każdy, jest ona w pełni darmowa i wydana na wolnej licencji MIT. W szczególności jest rekomendowana dla nauczycieli, którzy chcą sprawdzić wiedzę uczniów lub dla astro-amatorów podczas deszczowego zlotu.

2. Jak działa aplikacja?

Aplikację należy pobrać na swój dysk i zainstalować zgodnie z plikiem README. Program wymaga zainstalowania dodatkowych, darmowych komponentów. Astro-Quiz wykorzystuje przeglądarkę internetową jako interfejs pomiędzy użytkownikiem a aplikacją uruchomioną na jego własnym komputerze.

3.  Czym się wyróżnia Astro-Quiz od innych aplikacji tego typu?

Program posiada kilka ciekawych cech:

• możliwość stworzenia nieograniczonej liczby własnych zestawów pytań
• brak limitu na liczbę pytań dla każdego zestawu
• możliwość opcjonalnego dodania obrazka do każdego pytania
• każde pytanie może mieć przypisaną różną liczbę punktów za poprawną odpowiedź (wagowanie)
• z każdym kolejnym cyklem quizu wyświetlane odpowiedzi losowo zmieniają kolejność
• jako administrator można podejrzeć zbiorcze wyniki, w tym:
  • posortowaną wg punktów tabelę użytkowników
  • tabelę wskazującą, które pytania zostały błędnie ocenione przez danego użytkownika
  • tabelę prezentującą, ile procent wszystkich użytkowników odpowiedziało poprawnie na dane pytanie
• dedykowany astronomiczny design

4. Zainstalowałem aplikację i po jej uruchomieniu widzę tylko jeden zestaw pytań.

Zgadza się, ten zestaw to pliki demonstracyjne. Aby stworzyć własny zestaw pytań, należy zajrzeć do folderu files, który znajduje się w głównym folderze projektu, i na jego wzór stworzyć własny plik tekstowy (o innej nazwie), w którym kolejne linie mają następującą strukturę:

1. Treść pytania
2. Pierwsza możliwa odpowiedź
3. Druga możliwa odpowiedź
4. Trzecia możliwa odpowiedź
5. Czwarta możliwa odpowiedź
6. Numer pytania wskazujący poprawną odpowiedź (od 1 do 4)
7. Liczba punktów za udzielenie poprawnej odpowiedzi
8. Nazwa obrazka wraz z rozszerzeniem, w przypadku jego braku wpisać None

W kolejnych liniach sekwencję należy powtórzyć. Jeśli do pytania przygotowano obrazek, to musi on być umieszczony również w folderze files.

5. Stworzyłem nowy zestaw pytań z obrazkami, a nadal wyświetlają się pliki demonstracyjne po uruchomieniu Astro-Quizu.

Dzieje się tak, ponieważ plik konfiguracyjny linkuje do poprzedniego zestawu. Aby to zmienić należy edytować plik tekstowy astroquiz.cfg, który znajduje się w głównym folderze z projektem (poziom wyżej niż folder files). W linii rozpoczynającej się od question-file: trzeba wstawić nazwę nowo utworzonego pliku. Linijkę niżej istnieje możliwość ustawienia jednakowej szerokości (wysokość będzie przeskalowana) dla każdego z obrazków, co jest przydatne w zależności od rozmiaru monitora i dostępnych obrazów. Ustawienie dla tej linii opcji auto spowoduje, że obrazy przyjmą swoją własną szerokość.

6. Do czego służy hasło administratora, które znajduje się w pliku konfiguracyjnym?

Hasło umożliwia właścicielowi komputera wejście do panelu administratora, który może podejrzeć statystyki dotyczące wyników (zobacz punkt 3), a także wyczyścić bazę danych, jeśli rozpoczyna on zabawę z nową grupą użytkowników. Oczywiście hasło to może zostać zmienione w każdej chwili przez administratora. W praktyce użytkownicy zasiadający przed komputerem powinni widzieć tylko okno przeglądarki z uruchomioną aplikacją Astro-Quiz.

7. Nadal nie wiem jak uruchomić Astro-Quiz.

Opis instalacji i uruchomienia dla systemu Windows (konkretnie 7) oraz Linux został umieszczony w pliku README. Dodatkowy opis znajduje się na prywatnej stronie internetowej autora pod zakładką Astro Quiz. Bieżący link do tej strony znajduje się na GitHub. W przypadku pojawienia się jakichkolwiek problemów zawsze można napisać w tym wątku.

8. W czym jest napisany Astro-Quiz?

Oprogramowanie zostało napisane z wykorzystaniem PHP, TWIG, HTML, CSS.

9. Jestem programistą i dziwię się, że nie użyto frameworka. Czy to się zmieni w przyszłości?

Aplikacja nie jest doskonała, autor pisał ją po to, by podszkolić się w OOP, dlatego nie zastosowano gotowego rozwiązania. W szczególności może razić brak sensownego routingu, co skutkuje chaotyczną strukturą projektu. W chwili obecnej autor bardziej jest zainteresowany Pythonem, toteż Astro-Quiz nie będzie raczej rozwijany. Niemniej jest to wersja stabilna, z której można korzystać.

 

Pozdrawiam,
Przemek

Edytowane 26 Września 2017 przez .przemas.