gaurav-borah / quizller

Quizller is a php based open source web application to create and manage online quiz, test, exam.

Quizller - Quiz System

Quizller is a php based open source web application to create and manage online quiz, test, exam.

Table of contents

• Features
• ScreenShots
  • User Side
  • Admin Side
• Steps to install
• Project Overview
• Technology Stack
• Collaborate with us
• Bug / Feature Request

Features

• Fully Functional Admin Panel
• Quiz Website with awesome UI
• Admin (teacher) can add class and students from admin panel
• Admin can create new quiz tests and add quiz questions in the test
• Option to add the Quiz questions from a spreadsheet (.xls, .xslx, .ods)
• Admin can view the statistics of the tests such as score of the students and quiz questions tests
• Generate run-time random passwords for users to give test
• Generate pdf option so that admin can directly print the student login credentials for the test

ScreenShots

User Side

Login Page The Login Page of the website for student	Dashboard Page List of tests for student
Quiz Here student have to select the one option from the four options of the Quiz question	Quiz Done Logout message page displayed when the user finished with the quiz test

Admin Side

Login Page The Login Page of the website for Admin (Teachers)	Dashboard Page List of pending tests created by the admin
Create New Test Admin can create new quiz test	Test Details Here admin can change the test details
Add Question Admin can add new question to the test	Add Question Admin can add the question into quiz from a spreadsheet
Add Class / Add Students Admin can add new class and new students to the existing class	View Class Data Admin can see the list of students present in the class
Test Questions Admin can add see the quiz test questions	Students test data Admin can print the student roll number and random password list

Steps

1. Copy the whole project into your WAMP/LAMP/XAMPP folder.
2. Now create the database and import the script.sql file present in the database folder.
   1. If you want some sample data run the import the sampleData.sql file instead.
   2. Sample admin username:password for sampleData is admin:nimda
3. Modify the database credentials config.php file present in the database folder.
4. Now run the project to enjoy the Awesome Quiz System.

Project Overview

The website generates random passwords for students for each test.

1. Dashboard
   1. Create new tests
   2. See previously created tests
2. New Test ( Needs class data first )
   1. Create new test for a class
   2. Test status: 2.1 Pending - test won't be shown to students 2.2 Running - test will be shown and students can give test
3. Add class / student
   1. Add a new class
   2. Add a new student to the class
4. View Data
   1. Shows student user id / roll numbers given a class
5. Test Details ( on clicking a previously created test from dashboard )
   1. Change status of Quiz ( PENDING / RUNNING )
   2. Complete / delete test
   3. Add new student explicitly for the test
   4. Add questions to the test

Technology Stack

• HTML, CSS, BOOTSTRAP (Front-end)
• PHP (Backend)
• MYSQL Database

Collaborate with us!

Want to contribute? Great!

To fix a bug or enhance an existing module, follow these steps:

• Fork the repo
• Create a new branch (git checkout -b improve-feature)
• Make the appropriate changes in the files
• Add changes to reflect the changes made
• Commit your changes (git commit -am 'Improve feature')
• Push to the branch (git push origin improve-feature)
• Create a Pull Request

Bug / Feature Request

If you find a bug (the website couldn't handle the query and / or gave undesired results), kindly open an issue here.

If you'd like to request a new function, feel free to do so by opening an issue here.