Yii2 Quiz iSPRING

---

This program uses QuizResults by ISpringSolution.

This project provides an intuitive platform for students and instructors to keep track of schedules, assessments, and exam results. It is designed for both students and instructors, ensuring ease of use and accessibility. With this approach, you may extend your own tracking system on your server.

Yii2 Quiz iSpring enhances LMS capabilities, specifically focusing on integrating iSpring QuizMaker, a robust tool designed to create interactive quizzes and assessments. iSpring QuizMaker is widely used for creating various types of quizzes (e.g., multiple-choice, drag-and-drop, true/false). By incorporating Yii2 Quiz iSpring, the platform provides advanced visual analytics that can help instructors and students visualize learning trends and target areas for improvement.

---

📧 Contact

• Nanta Es (programmer) – ombakrinai@gmail.com
• Saroel (contributor, QC) – syahrul.hamdi@smanmba.sch.id

---

📸 Screenshots

See the Screenshots Folder

---

✅ Requirements

• A copy of iSpring QuizMaker
• XAMPP 8.x.x
• Composer v2.x.x
• (Optional) Server-side application programming skills (PHP, SQL, Javascript)

---

⚙️ Installation

Follow these steps to set up the project on your local environment:

1. Clone or Create Project

   composer create-project esnanta/yii2-quiz-ispring

2. Initialize Environment

   php init

   Select either development or production.

3. Install Dependencies Choose based on your environment.

   • For development:

     composer update

   • For production:

     composer update --no-dev

4. Database Configuration

   • Configure your database connection according to your database credentials

     common/config/main.php
     

     or environment-specific:

     common/config/main-local.php
     

5. Create Database

   • Create a MySQL database

        php yii db/create

   • Run Migrations. This will create all required tables and apply initial schema.

        php yii migrate

6. Run the Application

   • For the backend: Open in browser:

     http://localhost/yii2-quiz-ispring/admin/
     

   • For the frontend: Open in browser:

     http://localhost/yii2-quiz-ispring
     

7. Admin

   • User : admin
   • Pass : admin123

8. For full installation steps, see this Step-by-Step Guide

---

📁 Directory Structure

assets
    sql/                 sql for database
backend
    assets/              contains application assets such as JavaScript and CSS
    config/              contains backend configurations
    controllers/         contains Web controller classes
    models/              contains backend-specific model classes
    runtime/             contains files generated during runtime
    views/               contains view files for the Web application
    web/                 contains the entry script and Web resources
common
    config/              contains shared configurations
    config/main.php      app and database configuration
    mail/                contains view files for e-mails
    models/              contains model classes used in both backend and frontend
    widgets/             contains app widgets   
frontend
    assets/              contains application assets such as JavaScript and CSS
    config/              contains frontend configurations
    controllers/         contains Web controller classes
    models/              contains frontend-specific model classes
    runtime/             contains files generated during runtime
    views/               contains view files for the Web application
    web/                 contains the entry script and Web resources
environments/            contains environment-based overrides
vendor/                  contains dependent 3rd-party packages

---

🧪 How To Use

• Quiz iSpring Admin (Indonesia)
• Quiz iSpring Peserta Ujian (Indonesia)

---

🛠️ ISPRING Configuration

You must add custom variables that will be used to collect data schedule.

Field Name	Condition	Field Type	Variable	Remark
Name	Don't Ask	Text	USER_NAME
Email	Don't Ask	Text	Email
Schedule	Don't Ask	Text	SCD	Add manually

• Finish Action URL (Quiz message):

  http://{YOUR_HOST}/{YOUR_APP_NAME}/assessment/index
  

  Example: http://localhost/yii2-quiz-ispring/assessment/index

• Send quiz results to server:

  http://{YOUR_HOST}/{YOUR_APP_NAME}/assessment/submit
  

  Example: http://localhost/yii2-quiz-ispring/assessment/submit

---

🤝 Contribution Guidelines

Contributions are welcome!

1. Fork the repository.
2. Create a new branch for your feature or bugfix.
3. Submit a pull request with detailed information about your changes.

---

☕ Support

If you find value in this application, feel free to:

• Share it with friends, colleagues, or your community
• Buy me a coffee

---