https://github.com/ammoor/quizzes-light
You can view Quizzes Light documentation from this link:
https://github.com/ammoor/quizzes-light
fullstack-development laravel quiz-application
Last synced: about 1 year ago
JSON representation
You can view Quizzes Light documentation from this link:
- Host: GitHub
- URL: https://github.com/ammoor/quizzes-light
- Owner: Ammoor
- Created: 2024-09-22T12:00:58.000Z (almost 2 years ago)
- Default Branch: main
- Last Pushed: 2024-11-23T17:55:04.000Z (over 1 year ago)
- Last Synced: 2024-11-26T20:34:34.251Z (over 1 year ago)
- Topics: fullstack-development, laravel, quiz-application
- Language: Blade
- Homepage: https://docs.google.com/document/d/1DiLRE-qf7bv_lu-M25cl8ur0fW6MDoPIs3mEtzr0j5Q/edit?usp=sharing
- Size: 24 MB
- Stars: 1
- Watchers: 2
- Forks: 2
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
## 1. Introduction
The **Quizzes Light** Platform is a **Laravel-based** application designed using the **MVC architecture** that allows admins to create and manage quizzes, while students can participate in them. The platform is built with two distinct guards for authentication: admin and student. Each role has its own specific permissions and responsibilities within the system.
## 2. Used Technologies
### Front-End:
- HTML (Laravel Blade)
- CSS
- JavaScript
- Font Awesome Library
### Back-End:
- PHP
- MySQL/phpMyAdmin
- Laravel
## 3. Prerequisites
Before running the application, ensure you have the following installed:
- PHP 8.2 or higher
- PHP package manager (Composer)
- Laravel 12.x
- MySQL or phpMyAdmin DataBase
- Web Server (ex: Apache, Tomcat, Nginx)
- All in one solutions (ex: XAMPP, Laragon, Laravel Herd)
- Font Awesome Library
## 4. Installation and Set The Project Environment
To set up the project, follow these steps:
1- Clone the repository:
```Bash
git clone
cd Quizzes-Light
```
2- Install dependencies:
```Bash
composer install
```
3- Create a **.env** file:
Make sure you set the **.env** file in your project environment to make the necessary Configuration.
4- Run migrations and seed the database:
```Bash
php artisan migrate --seed
```
5- Start the development server: (If you do not make a [virtual host](https://httpd.apache.org/docs/2.4/vhosts/))
```Bash
php artisan serve
```
## 5- Configuration
The **.env** file should be configured with the following:
- **APP_URL:** The URL where your app will be hosted.
- **Database configuration:** DB_CONNECTION, DB_HOST, DB_PORT, DB_DATABASE, DB_USERNAME, DB_PASSWORD.
## 6- User Authentication
The app uses two authentication guards: **admin** and **student**. Each guard enters their credentials through a dedicated URL to prevent unauthorized access.
### Admin Guard:
- **Role:** Manages quizzes, and questions, and monitors student progress.
- **Access:** Admins can access the admin dashboard, where they can create, update, and delete quizzes.
- **Configuration:** The **config/auth.php** file is set up with an **admin** guard, using the **admin's** table for authentication.
### Student Guard:
- **Role:** Takes quizzes and views their scores.
- **Access:** Students can log in to access quizzes assigned to them and submit their answers.
- **Configuration:** The **config/auth.php** file includes a **student** guard, using the **student’s** table for authentication.
## 7- Features
### Admin Features:
- **Create, Read, Update, and Delete (CRUD) Operations:**
- **Manage quizzes:** Admins can add, edit, and remove quizzes.
- **Manage questions:** Admins can add questions to quizzes, set answer choices, and specify the correct answer.
- **View Student Results:** Monitor student scores and quiz completion statuses.
### Student Features:
- **Participate in Quizzes:** Students can take quizzes assigned to them.
- **View Scores:** Students can see their results for each quiz.
### Quiz Page:
The quiz page in **Quizzes Light** is designed to provide a seamless and engaging user experience while maintaining functionality and reliability. Key features include:
- **User-Friendly Interface:** The quiz page boasts a clean and intuitive layout that ensures ease of use. Each question is displayed prominently with clearly defined answer options, making it accessible to users of all levels.
- **Integrated Timer:** A dynamic timer is embedded on the quiz page to track the remaining time for the quiz. The timer ensures users stay aware of their time limits.
- **Time Warning Alert:** When the quiz timer reaches the last minute, it **changes color to red**, visually alerting the user that they are running out of time. This feature helps maintain focus and urgency.
- **Auto-Submit Functionality:** If the timer runs out, the quiz page automatically submits the user's answers. This ensures that all completed work is captured, even if the user is unable to submit manually.
- **Responsive Design:** The page is fully responsive, ensuring a consistent experience across devices of all sizes, from desktops to mobile phones.
### Auto correcting:
- **Quizzes Light** features a **secure auto-correcting system implemented in the back-end logic**, ensuring accurate result evaluation while adhering to security best practices by avoiding client-side processing.
## 8- Database Schema
The application uses two main tables for authentication: **Admins and Students Tables** and other tables for quiz management:
- **Admins Table:** Stores admin details for authentication.
- **Students Table:** Stores student details for authentication.
- **Quizzes Table:** Contains information about each quiz (e.g., name, time, questions).
- **Specializations Table:** Stores all the available specializations for quizzes.
## 9- Tutorial Video
Explore the seamless user experience of **Quizzes Light** in this tutorial video. It highlights the **application's clean and intuitive design**, showcasing its **responsive layout** that adapts flawlessly across devices. The video also demonstrates core functionalities, including **quiz creation, real-time auto-correction, and student performance tracking**. See how every detail is optimized for efficiency, usability, and a secure user environment.
### Quizzes Light on YouTube!
- [Quizzes Light Tutorial Video On YouTube](https://youtu.be/Fl7HAK1M_2Q)
## 10- Live Preview
Experience **Quizzes Light** in action with this live preview! This deployment showcases the platform’s streamlined quiz management and engaging user interface. You can navigate through the platform, test its features, and see how it handles quiz creation, participation, and results tracking.
### Important Notes:
- The application is hosted on [Laravel Cloud](https://cloud.laravel.com/) with **limited resources** for preview purposes.
- If the application has been inactive, it may just take a few seconds to respond due to **server hibernation**.
- Sometimes, styles may not appear as expected. This is usually due to **browser caching**. To fix it, try using a different browser or just press **`Ctrl + Shift + R`** to perform a hard refresh and clear the cache.
- To get started with [Laravel Cloud](https://cloud.laravel.com/) you can watch this [short video](https://www.youtube.com/watch?v=cXVVoaekqT8).
### Check it out live now!
- [Quizzes Light Live Preview](https://quizzes-light.laravel.cloud/home)
## 11- Bug Reports & Feedback Suggestions
At **Quizzes Light**, we value your feedback and believe that continuous improvement is the key to a better user experience. Whether you’ve found a bug or have an idea to enhance the platform, you are more than welcome and we’d love to hear from you!
### Bug Hunters:
We encourage bug hunters and enthusiasts to practice their skills by testing our platform. If you discover any issues, share them with us in the [Bug Reporting Form](https://forms.gle/sDtcL4o11ALppyEu9) so we can fix them and make **Quizzes Light** even better!
### Feedback & Improvement Suggestions:
If there’s a feature you’d like to see or to improve, share your insights with us in the [Feedback Form](https://forms.gle/C2fT2xnGcdVHyvLv7) and let us know! Your insights help us enhance the platform and create a smoother, more enjoyable experience for everyone.
### Important Notes:
- ### Bug Reports:
- Please ensure your submission focuses on a **single issue at a time**. This helps us investigate and resolve problems efficiently. If you encounter multiple bugs, kindly submit separate reports for each.
- Clearly describe the issue, provide steps to reproduce it, and include a video for more clarification.
- ### Feedback & Improvement Suggestions:
- If you have ideas for improvements, please provide **one suggestion per submission**. This ensures that each request is properly reviewed and considered.
- Share your ideas along with **examples or references** to help us understand how we can improve **Quizzes Light**.
## 12- Assets
- [Quizzes Light Presentation](https://www.canva.com/design/DAGTz0vzHB0/XhTkaWoBonUuTzqjxw2guA/edit?utm_content=DAGTz0vzHB0&utm_campaign=designshare&utm_medium=link2&utm_source=sharebutton)
- [Quizzes Light Presentation Template](https://www.canva.com/templates/EAFwaFanZ_U-blue-doodle-project-presentation/)
- [Quizzes Light Logo](https://www.canva.com/design/DAGTNervj3w/GQbVxCm35YZSiHZERe3pnw/edit)
- [Quizzes Light Logo Template](https://www.canva.com/templates/EAGRlLGQdHo-green-and-orange-owl-education-logo/)
- [Quizzes Light Thumbnail](https://www.canva.com/design/DAGcKZzQgCA/_Jdc2LlK8cmeCqCu1B6aZw/edit?utm_content=DAGcKZzQgCA&utm_campaign=designshare&utm_medium=link2&utm_source=sharebutton)
- [Quizzes Light Promotion Video](https://youtu.be/IMxJYg1Rl90)
- [Quizzes Light Promotion Video Template](https://www.flexclip.com/template/bd8e8758-blue-digital-website-new-features-announcement-tech-phone-computer-business-slideshow/?ratio=1.775)
- [Quizzes Light Design Inspired by (ClassMaker.com)](https://www.classmarker.com/)
- [Mobile Simulator & Responsive Mockup Testing Tool](https://chromewebstore.google.com/detail/mobile-simulator-responsi/ckejmhbmlajgoklhgbapkiccekfoccmk)
## 13- Copyrights
This project was proudly created by the **Quizzes Light** team, combining creativity, dedication, and expertise. Users are more than welcome to use and customize the code to suit their needs, but we kindly request proper attribution to honor the team’s efforts. Please do not claim ownership of the original work, as it reflects the hard work and collaboration of our talented developers.
© 2024 **Quizzes Light**. All rights reserved.