LobbySIO/README.md
2018-10-15 15:14:36 -04:00

2.9 KiB

LobbySIO

Concept

Touchscreen or tablet installed in a lobby or waiting room allows guest to self-register. A security desk operator has a secured interface to log in and manage the registration queue.

About

Josh North - josh.north@point808.com
Basic visitor sign-in/sign-out web application.
Hosted at https://git.point808.com and cloned to github. If you have questions email me or use my server board at https://git.point808.com/Point808/LobbySIO, github issues are not enabled.
GPLv3. Credit is appreciated.

Credits

Requirements

  • PHP 5, 7
  • MySQL
  • Web server (tested on Apache)

Setup

  1. MAKE SURE YOUR SERVER CLOCK IS CORRECT!!! This system relies on the server time, not the client machine time.

  2. Go to your webserver root as a user with write privileges (i.e. /var/www/html). Clone the repo to whatever sub dir, or use ./ to go to root. Set permissions and enter directory.

    cd /var/www/html  
    git clone https://git.point808.com/Point808/LobbySIO.git lobbysio  
    chown -R www-data:www-data lobbysio  
    cd lobbysio  
    
  3. Copy sample language files and settings file.

     cp src/Language/en.lang.ini.example src/Language/en.lang.ini  
     cp src/Language/es.lang.ini.example src/Language/es.lang.ini  
     cp src/Language/de.lang.ini.example src/Language/de.lang.ini  
     cp src/Language/fr.lang.ini.example src/Language/fr.lang.ini  
     cp src/Config/Registry.example.php src/Config/Registry.php  
    
  4. Set up a database. Example here uses MySQL - adapt for yours.

     mysql -u root -p  
     CREATE USER 'lsio_user'@'localhost' IDENTIFIED BY 'yoursecret';  
     CREATE DATABASE lsio;  
     GRANT ALL PRIVILEGES ON lsio. * TO 'lsio_user'@'localhost';  
     FLUSH PRIVILEGES;  
     exit;  
     mysql -u root -p lsio < assets/mysqlSchema.sql  
    
  5. Edit configuration file.

     nano src/Config/Registry.php  
    
  6. Run a tail to troubleshoot if needed...

     tail -f /var/log/apache2/error.log  
    
  7. Customize. Under the assets directory, you may create the following files that will automaticall be used if found:

     assets/logo-small.png  
     assets/logo-text.png  
     assets/Rules.pdf  
    
  8. Go to the URL. Default username/password "admin" and "admin1234".

Screenshots

Main Page Multi-language Multi-site Sign In Sign Out Approvals