L4N

The Readme is work in progress, please contact the maintainers if you should have any questions

L4N is a CMS for managing LAN parties, featuring a ticketing system, seatmaps, timetables, a tournament system, a shop, newsposts, recurring events and more!

Features

• Ticketing System with QR Code Scanner for checking in at the event
• General Purpose Sop to sell tickets, merchandise, food, etc.
• Tournament System which can be used independently from a LAN party
• Newspost / Blogging system with markdown
• Side-Events with multiple dates
• Dynamic content pages & URL redirects
• Fully customizable Topnav menu
• Achievements
• File uploads
• Customizable CSS in admin panel
• Dynamic homepage with customizable content blocks & startpage banners
• Sidebar with customizable infoboxes
• Featureflags to disable not needed features
• JSON API for fetching data from the CMS
• OAuth2 provider

Requirements

• Docker Compose

Installation

We recommend using the included docker-compose.yml file to deploy the app with docker compose. Below are the steps needed to deploy the app in such a way:

Install docker

First, you should install docker and docker-compose on your server. Follow the official installation guides for your system to do this.

Setup traefik

The provided docker compose setup uses traefik as a reverse proxy and to automatically configure your SSL certificates. We suggest to use this setup on your server. Deploy the traefik setup in a seperate folder on your server, following the instructions outlined in its repo.

Setup L4N

First, create a new folder for the L4N setup on your server. Create a file .env, and add the required env variables and their values into the file. See the file DEVELOPMENT.md for a complete list of all env variables. Which variables are needed might differ based on your configuration and needs.

After that, copy the file docker-compose.yml to your server. By default, it will use the main tag of the image, which is the edge variant with the newest commits to the main branch. We recommend using a tagged version, and as such you should replace main with the tag of the latest release.

After that, you can start L4N using docker compose up -d. This will pull the image, create the database, run the migrations and prepare other required settings for L4N.

Creating the first user

L4N contains a helpful script to create the first user from the CLI. This user has permission to edit users, and as such you can then use this user to log-in to the admin panel, grant that user the other required permissions and change settings in L4N.

To run this script, simply execute the rake setup:user task from the command line, or if you're using the docker image, run the following:

docker exec -it <container_name> rake setup:user

where <container_name> is the name of the container, usually l4n-web-1.

Custom installations

L4N can also be used in a custom setup, with your own docker compose setup. Please note however, that L4N requires Postgresql as the application database server. Currently it is not possible to use SQLite, mySQL or any other database as the application database server. Also, please note that in development mode, SSL is required by the application, as only connections over SSL are accepted, Strict-Transport-Security is enabled and cookies are marked as secure.

Useful commands

Sometimes, if might be useful to have to have some CLI commands at hand. While most of the settings in L4N can be configured in the admin panel or the .env File (or env variables, if you're not using the docker-compose file), sometimes you might need to access the logfiles, rails console or something else, so here are some useful commands:

Task	Command in the L4N container	Command from the host
Restart the webserver (puma)	touch /app/tmp/restart.txt	docker exec <container_name> touch /app/tmp/restart.txt
Access the Rails console	rails c	docker exec -it <container_name> rails c
Read the logfiles as they come in	tail -f /app/log/production.log	docker exec -it <container_name> tail -f /app/log/production.log

Development

Setup

To develop features for L4N locally, we recommend to install Ruby as well as Postgres locally:

1. Install Ruby on your machine (we recommend using RVM to manage your ruby installations). Check the .ruby-version file for the exact ruby version (RVM should inform you if you are missing the required ruby version).
2. Install Postgres on your machine, and create an user with username rails and a database l4n for the application to connect to. Check config/database.yml for more information.
3. Install yarn on your machine (https://yarnpkg.com/getting-started/install)
4. Clone the L4N repo onto your machine and cd to this directory.
5. Install all the dependencies:

   # Install Ruby gems
   bundle install
   
   # Install yarn packages
   yarn

6. Create the file config/application.yml with the required env variables as follows. You can set dummy values if you don't want to use the Paypal payment gateway or recaptcha locally, replacing the placeholders in brackets with some random values:

   paypal_id: <your-paypal-id>
   paypal_secret: <your-paypal-secret>
   recaptcha_site_key: <your-recaptcha-site-key>
   recaptcha_site_secret: <your-recaptcha-site-key>

7. To start the server locally, use the command bin/dev, which will launch the Rails server as well as a JS and CSS compilation process

Code style

To ensure a consistent code style, we use the following code analyzers / linters:

• rubocop for the Ruby source files
• haml-lint for the haml view files
• eslint for the Javascript source files

When you want to contribute to this project, please ensure that none of these 3 tools find any issues with your code (and if they do, follow the outlined suggestions to resolve the problems).

Users

• VSETH GECo

Do you use L4N? Let us know and we'll put you on this list!