LANager

LANager is a web application designed to make LAN Parties more enjoyable for attendees and organisers alike.

Features

Enhance Participation

• Games in progress, updated every minute from Steam
• Timetable of events, optionally allowing users to sign up to events
• Achievements, created by admins, and awardable to attendees

Boost Social Interaction

• Attendee profiles with links to add or message on Steam
• Attendee list with their current status

Broadcast Useful Information

• Info pages for attendees to find out about the venue, rules etc, editable by admins
• Links to other sites e.g. game stats, organiser's website
• Shouts allowing attendees and admins to broadcast short messages
• Live Dashboard showing current and next events, games in progress and shouts, for big screen display

Open for Integration

• RESTful API with open read access and API key guarded write access to all resources
• Events dispatcher allowing for hooking in of extra operations
• Comprehensive logging of events allowing for debugging and auditing

And much more planned - check the issue tracker for future enhancements

Requirements

• Web server - Apache 2.4.x recommended
• Database server - MySQL 5.5.x recommended
• Git 1.9.x
• PHP 5.5.x
• Composer 1.x
• A Steam Account
• An Internet connection
• Shell access to the server - basic web hosting alone will not work!

Installation

The installation guide is now split into several sections

1. The Base OS
2. Webserver Configuration
3. Lanager Configuration

Base OS Installation

Advanced users will be able to deploy LANager to Windows and OS X, though LANager has not been fully tested on these OSes.

Installation on Debian 8

1. Install the project's packaged dependencies: a) For apache: sudo apt-get install git php5-common php5-cli php5-mcrypt php5-curl php5-mysql libapache2-mod-php5 mysql-server apache2 curl b) For nginx: sudo apt-get install git php5-common php5-cli php5-mcrypt php5-curl php5-mysql php5-fpm mysql-server nginx curl

Installation on Ubuntu Server 14.04

1. Install the project's packaged dependencies: a) For apache: sudo apt-get install git php5-common php5-cli php5-mcrypt php5-curl php5-mysql libapache2-mod-php5 mysql-server apache2

Webserver Configuration

Apache

1. Enable Apache and PHP modules:

   sudo a2enmod rewrite

   sudo php5enmod mcrypt curl

2. Install Composer:

   sudo curl -sS https://getcomposer.org/installer | php

   sudo mv composer.phar /usr/bin/composer

3. Clone the project:

   sudo git clone https://github.com/zeropingheroes/lanager.git

4. Move the project to Apache's web root directory:

   sudo mv lanager /var/www/lanager

5. Install the project's dependencies:

   cd /var/www/lanager

   sudo composer update

6. Configure Apache to use the LANager's public directory as the web root:

   1. Edit the default site configuration:

      sudo nano /etc/apache2/sites-enabled/000-default.conf

   2. Change the DocumentRoot line to:

      DocumentRoot /var/www/lanager/public

   3. Add the following lines to allow .htaccess files to set options in this directory (for pretty URLs):

      <Directory /var/www/lanager/public>
      	AllowOverride All
      </Directory>
      

7. Allow full read and write access on the app's storage directory:

   sudo chmod -R 777 /var/www/lanager/app/storage

Nginx

1. Enable PHP modules:

   sudo php5enmod mcrypt curl

2. Install Composer:

   sudo curl -sS https://getcomposer.org/installer | php

   sudo mv composer.phar /usr/bin/composer

3. Clone the project:

   git clone https://github.com/zeropingheroes/lanager.git

4. Move the project to Nginx's web root directory:

   sudo mv lanager /var/www/lanager

5. Configure Nginx to use the LANager's public directory as the web root:

   1. Edit the default site configuration:

      sudo nano /etc/nginx/sites-available/default

   2. Change the root line to:

      root /var/www/lanager/public

   3. Add index.php to the default file types

      index index.html index.htm index.nginx-debian.html index.php;

   4. Enable larger file upload support (default is 1m) client_max_body_size 10m;

   5. Nginx doesn't support .htaccess files so we shall enable pretty URLs here instead

      location / {
      	try_files $uri $uri/ /index.php?$query_string;
      }
      

   6. Enable php script processing

      # pass the PHP scripts to FastCGI server listening on 127.0.0.1:9000 
      #                                                                    
      location ~ \.php$ {                                                  
      	include snippets/fastcgi-php.conf;                                 
      #                                                                    
      # # With php5-cgi alone:                                             
      # fastcgi_pass 127.0.0.1:9000;                                       
      # # With php5-fpm:                                                   
      	fastcgi_pass unix:/var/run/php5-fpm.sock;                          
      }
      

   7. Lanagers document root is an apache folder, we should deny access to .htaccess files

      location ~ /\.ht {
      	deny all;
      }
      

6. Reload the nginx config engine

   sudo systemctl reload nginx

7. Allow full read and write access on the app's storage directory:

   sudo chmod -R 777 /var/www/lanager/app/storage

Lanager Install

1. Install the project's dependencies

   cd /var/www/lanager

   sudo composer update

2. Create a MySQL user and database and grant the required privileges:

   1. Run mysql -u root -p
   2. Type your MySQL root user password you chose during MySQL package installation
   3. Once you are at the mysql> prompt, run each of the following in turn:
      1. CREATE DATABASE lanager;
      2. CREATE USER 'lanager'@'localhost' IDENTIFIED BY 'type a password here';
      3. GRANT ALL PRIVILEGES ON lanager.* TO 'lanager'@'localhost';
      4. FLUSH PRIVILEGES;
      5. quit;

3. Set the database password in the database config file:

   1. sudo nano /var/www/lanager/app/config/database.php
   2. Change the password line to your chosen password in the previous step

4. Set your Steam Web API key in the steam config file:

   sudo nano /var/www/lanager/app/config/lanager/steam.php

5. Setup your app config file:

   1. sudo nano /var/www/lanager/app/config/app.php
   2. Change the timezone value to a valid PHP timezone

6. Change the key value to a random 32 character string

7. Run the LANager installation command:

   cd /var/www/lanager

   sudo php artisan lanager:install

8. Schedule the LANager Steam state import command to run at 1 minute intervals:

   1. Make the script file executable

      sudo chmod +x /var/www/lanager/SteamImportUserStates.sh

   2. Add the script as a cron job

      1. Run crontab -e
      2. Add the following to the end of the file: */1 * * * * /var/www/lanager/SteamImportUserStates.sh >> /dev/null 2>&1

Usage

Once you have completed the installation, you can sign in via Steam. The first user to sign in will be granted the "Super Admin" role, allowing you to assign roles to other users who sign in.

Look through the configuration files inside /var/www/lanager/app/config/lanager/ which will allow you to tailor your installation to your event.

This section will be expanded upon as features are solidified.

Updating

To update to the latest version, directory simply run the following commands:

1. Back up your config files:

   sudo cp -R /var/www/lanager/app/config ~/lanager-config-backup

2. Back up your database data:

   mysqldump lanager -u lanager -p --result-file=lanager.sql

3. Move to the root of the project directory:

   cd /var/www/lanager

4. Reset all project files to their defaults:

   sudo git reset --hard

5. Empty the database data and structure:

   1. mysql -u root -p
   2. DROP DATABASE lanager;
   3. CREATE DATABASE lanager;
   4. quit;

6. Get the latest version from the project repository:

   sudo git pull origin

7. Install / update dependencies:

   sudo composer update

8. Manually set your config options from the backed up files (see steps 10 and 11 from the Install guide)

9. Re-allow full read and write access on the app's storage directory:

   sudo chmod -R 777 /var/www/lanager/app/storage

10. Re-run the installation command:

    sudo php artisan lanager:install

Be warned that config file and database structure may have changed between versions so pay attention when copying data from backups from old versions.

Feedback & Contributions

• Found a bug? Got a great feature idea? Post it to the issue tracker!
• Want to contribute?
  • Fork the project and add the features you want to see
  • Work on new features / bug fixes in the issue tracker
  • Or if you're really hardcore, request commit access

If you want to support the project in a non-technical way, we'd love it if you donated to us: