Skip to content

A Content Management System designed especially for the needs of LAN-Parties

Notifications You must be signed in to change notification settings

mbraun81/lansuite

 
 

Repository files navigation

LANSuite - Web based LAN-Party Management System

Build Status

LANSuite is a administration system for LAN-Parties based.

German version of this README: Can be found at README-DE.md.

Features

  • Organisation of tournaments
  • Registration for parties
  • News- and messaging system
  • Projector support
  • Cash / Money management
  • Foodcenter
  • Hardware / Server inventory
  • Picture gallery
  • Seat plans
  • and many more ...

Requirements

  • = PHP 7 (with mysqli, snmp and gd extensions)

  • = MySQL 5.6.3

Installation

Docker

We assume that you have a running Docker Community Edition installed.

$ git clone https://github.com/lansuite/lansuite.git
$ cd lansuite
$ touch ./inc/base/config.php
$ # Add the content of the example configuration file below into ./inc/base/config.php 
$ chmod 0777 ./inc/base/config.php
$ chmod -R 0777 ./ext_inc/
$ docker-compose up

This will start a Nginx webserver with a php-fpm configuration and a MySQL database for you. After everything started you should be able to visit http://:8080/ and see a running LanSuite-System.

Attention: This docker setup is not suggested for production.

Configuration file

An example configuration file looks like:

[lansuite]
version=Nightly
default_design=simple
chmod_dir=777
chmod_file=666
debugmode=0

[database]
server=mysql
user=root
passwd=
database=lansuite
prefix=ls_
charset=utf8

Warning: Setting directories to 0777 is not suggested for production. Only your webserver user should be able to write into this directory.

Development

Contribution Guide

Checkout how to contribute in our Contribution Guide.

Language

Main language of this project is english. We also support issues and pull requests in german. The reason is that LANSuite is a quite old system and a massive userbase only speaks german. To not loose them, we will support both languages. See Switch language of documentation, development, communication to english #2 for more details.

Coding style guide

This project follows the coding guideline standards:

Generating API docs

Former versions of LANSuite bundled an API documentation in the docs/ folder. To generate an API documentation in a HTML-Version you can use phpDocumentor:

$ composer install
$ bin/phpdoc run --progressbar -t ./docs/

About

A Content Management System designed especially for the needs of LAN-Parties

Resources

Stars

Watchers

Forks

Packages

No packages published

Languages

  • PHP 51.2%
  • JavaScript 35.6%
  • HTML 6.9%
  • ColdFusion 2.0%
  • CSS 2.0%
  • Classic ASP 0.7%
  • Other 1.6%