Skip to content

Duedot43/VirtualPass

Repository files navigation


Welcome to VirtualPass, a simple yet effective Virtual Hall Pass manager


What is VirtualPass?

VirtualPass is a simple website for checking in or out students from a classroom with a scan and go system based off of QR codes.

VirtualPass is very easy to set up and requires no third party dependencies, it supplies easy to visualize graphs and system configuration right from the web page.

User data is stored outside the readable web scope so only the API with an API key can access this data.


Installation

  • Download the latest release.

  • Unzip the file and move it to /var/www. This is assuming you are using an Apache server.

  • Install php composer npm php-apache

  • Install the composer dependinces by running composer install

  • Configure your server to run PHP code and tell it the website DIR is at /var/www/VirtualPass/src/.


Setup

  • go into your config file located at /var/www/VirtualPass/config/config.ini.
  • Specify settings you want. Descriptions of the settings can be found here.
  • Next go to the VirtualPass website you just set up with your Apache server and log into the teacher portal using the username and password you made in the configuration file.
  • Now click the Make Your Room button and type the number of the room you are in.
  • It will generate a QR code that you can download, print, then integrate in the classroom.
  • You must do this for every classroom.