Admin Accounts
+On this page you may add, modify or remove admin accounts. Note that in order for you to see this page, you'll need to be logged in as the user root.
+Adding an account
+Privileges
+libreevent features a privilege system where you can choose to what group of users you want to add a user you are currently creating. Possible values are:
+| Group | +Allowed settings | +
|---|---|
| Root | +All pages. Can only be one account (the root account) | +
| Admin | +Can access all pages and settings except for Admin Accounts | +
| Event-Manager | +Access the events & pages page | +
| Event-Handler | +Can log into the apps to do entry control | +
An Email address is required for account activation and to recover a password in case it gets lost. The system will automatically send an activation email so the user can confirm that the email address is valid.
+2FA
+With this checkbox you can choose if this user needs to do two factor authentication, meaning, if the user needs to authorise the login using a link. In the Settings you may choose between the two different 2FA modes that libreevent offers.
+Modifying an account
+Removing an account
+Events
+This is the most feature rich admin page of libreevent. Here you can change everything regarding an event.
+Creating new events
+Creating new events is as simple as clicking the plus icon in the top right corner and following the prompts.
+Event name
+This is the name that is being displayed when users are browsing your events. Cannot be longer than 50 characters.
+Event description
+Describe what your event is about. It will be displayed underneath the event name when users are browsing your events. In the browsing view, the length of the description is limited to 150 characters, after which three dots will be added to the text and a 'continue reading' button will be added. Technically, there's no limit to the length of the event description, but don't overdo it with the length, as the user is unlikely to read more than a couple words anyway.
+Event location
+Choose a location where your event is going to take place. You can do so by selecting an existing location from the dropdown or by adding a new one. In the same step, you'll also need to choose between a seat plan and no seat plan, and if you choose a seat plan, you'll need to create one using out handy seatplan editor. See our seatplan editor guide here
+Admin panel
+The admin panel is where you can change basically everything about libreevent. Depending on your account's privileges, you may find more or less settings. Only the root account has access to the admin accounts page.
+Here's a list of the pages available when logged in as the root user. All other users have fewer pages enabled.
+-
+
- Admin Accounts +
- Pages +
- Events +
- Plugins +
- Settings +
Additionally, some settings might not be available to all admin accounts on all pages.
+As a general recommendation, we do not encourage logging in as the root user if not strictly necessary, as this can help protect the libreevent installation.
+Pages
+Plugins
+Seatplan editor
+The seatplan editor is a graphical editor where you can create and modify the seating plan of virtually any room. We recommend that you start in the top left corner of the seatplan and then move down diagonally, as it is the easiest to do. Each so-called component can be either a stand area, a stage area or a seating area, with each of them featuring different layouts. You can change everything in the properties pane.
+Adding more components
+You may add more components by simply clicking the plus icon in the toolbar of the editor. The component will spawn in the top left corner of the seatplan and the view will automatically be moved towards it.
+Removing components
+You may remove components by clicking the trash icon or by hitting 'delete' on your keyboard.
+Editing history
+The editor features undo and redo functions such that you can undo your mistakes and accidental undos can be reverted. Just hit the corresponding button in the toolbar.
+Saving
+The editor does auto-save a draft every minute. Pressing Ctrl + S or hitting the Save button in the toolbar will immediately save the seatplan as a draft. Click the deploy button to save the seatplan permanently, irreversibly overwriting any potentially existing old seatplan of that location, except you change the location name after the fact.
+Settings
+2FA
+libreevent offers two different 2fa modes:
+-
+
- Standard mode: The user has to click on a link that was sent to him via email. He'll automatically be logged in as soon as the page loads. +
- Enhanced mode: The user has to click on a link that was sent to him via email and then has to confirm it by entering the code that is shown to him on the 2FA page. After that he'll automatically be logged in. +
In both modes, the system informs the user about the IP address that tried to log into the account.
+This setting can be changed individually for admin and user accounts and 2FA can be disabled entirely. It is highly encouraged to enable this at least for the admin accounts and for user accounts set the requirement to 'User-defined' or 'Always required' instead of 'Disabled'.
+User account passwords
+Here you may set password requirements for the user accounts. The system will always be offering the users to generate a password that is strong for them to facilitate the process of setting a password.
+Guest purchase
+Choose if a user may purchase a ticket without creating an account. An email address is always required as the system sends the tickets via email to the customers for easier access.
+Allow overbooking
+Activate this and set a percentage of overbooking, if you want to enable overbooking of the event to ensure that every single spot is occupied even if somebody does not show up. Use is strongly discouraged and currently only works with events that have no seating plan.
+Special requirements
+Here you may set a special requirement that a person booking a ticket has to fulfill, like the email address has to be ending in @yourdomain.com or they need to live in a certain street / town / city / country in order for them to be allowed to buy a ticket. You may also require that they provide a certain number, code or similar. Finally, you may choose to limit the amount of tickets a single person may reserve.
+Change organisation name
+This should be self explanatory, but keep in mind that this change will only take effect after the next restart of the node app.
+Contributing
+You are interested in helping develop this project to make it even better? Then let's show you, how you may help and what you should keep in mind!
+Contributing Plugins
+Errors
+404
+A 404 error is returned if the page was not found on the server. This can be either due to a wrong link or a badly configured server, but is mostly user error, so a misspelled link.
+500
+An internal server error occurs when the server is unable to properly process a request, which in some cases might also return a 400 error, if the server first decides that the request is unacceptable.
+How it works
+This page gives you a somewhat detailed overview on how the system operates. Note that this page is not made with user-legibility in mind, as this page is oriented to give possible contributors an introduction to the project to help them getting started. Therefore we expect you to have quite decent understanding of the underlying programming languages and concepts.
+Programming languages
+This project is written in a variety of different programming languages. First of all, the backend is written in Node.js with express.js routing. It also uses nodemysql to interact with the MySQL database, if the user chose to use one. For authentication, it uses express-session, for which a new session secret is generated whenever the server restarts to increase security.
+Payments
+Including many payment methods can help the user choose the one that fits them best, but can also be overwhelming and a pain to set up. So please try to use as few different payment gateways as possible. Our recommendation is either Stripe or adyen as they are the most flexible.
+Advantages / Disadvantages of each payment gateway
+Stripe
+Stripe is one of the most well known payment gateways out there, but is also fairly expensive, but easy to set up. +See here for pricing information and sign up here
+adyen
+Adyen is used by small and huge businesses alike, but you have to email their support team for account creation, which is easy to do, but takes longer to complete. adyen is fairly cheap, "only" charging 0.10$ per transaction plus payment method costs. Detailed pricing information can be found here and you may sign up here
+payrexx
+https://www.payrexx.com/en/pricing/
+Plugins
+Setup
+In this tutorial, you are going to learn how to set up and configure libreevent.
+Installation
+Let's begin with setting up libreevent! If you are not technically savvy or want somebody else to set it up for you, please contact me here. If you want to set it up yourself, read on below!
+Selecting a webhosting company
+Choosing the right hosting provider is not easy, especially since libreevent requires node.js. Therefore, we've listed a few really good options. This website here is hosted by asurahosting. Note: I may receive a small commission when you buy webhosting using one of the links provided below. This won't affect the price you pay. +https://clients.asurahosting.com/aff.php?aff=1997 +https://www.novatrend.ch/en/ +https://www.hostinger.com/ +https://www.a2hosting.com/ +https://www.hetzner.com/ +https://www.digitalocean.com/
+Affiliate program +https://affiliates.hostinger.com/users/signup/ +https://www.a2hosting.com/about/affiliate-program/ +https://www.digitalocean.com/go/affiliates
+Database
+In the database, all the userdata is stored. libreevent currently supports two different databases, MySQL and a custom database based on JSON. Which one to choose?
+Generally MySQL, except:
+-
+
- If your organisation is small and does only sell a few tickets at a time, the JSON based database works perfectly fine. +
- Your web hosting plan does not includes MySQL and you've got no access to MySQL in any other way. NOTE: Free MySQL services should NEVER be used in such an application, as most hosting plans include MySQL which is much more reliable and if you lose access to the database, you can only access the root account and all other data (and therefore all user accounts) is lost. +
MySQL generally is more difficult to set up, but we'll run you through the process here to make the process easier for you. If you chose the JSON based database, skip ahead to the next chapter.
+Setup of libreevent
+At this point we assume you've completed the initial install of libreevent. If not, you may find a guide on how to do it here. Let's get started setting up your event management system!
+Connecting to the server
+As discussed in the previous part where we installed the system, you can connect to your server simply by opening a web browser and typing your domain name into the address field. After that you should be greeted by the libreevent post-install landing page. Once there, you'll need the setup key you defined during the installation. Type it into the field and hit "Start setup".
+Note: This is only available during the setup process of libreevent and will afterwards be deactivated to ensure safety of the system.
+Root account
+This is the most powerful account in this system. From it you can control EVERY aspect of your system.
+Remark: You may (and definitely should) add other accounts with less privileges after completing setup and only use the root account when it is actually necessary
+Please choose an email address to which you want to link the root account. Two-Factor-Authentication is ALWAYS required when logging into an account that has root privileges to ensure a higher degree of security, so please ensure you have access to that email address at all times.
+When choosing a password, please ensure it meets the minimum requirements of the system or let the system generate one for you by clicking the 'generate password' button, which will generate a password that fulfills all requirements and exceeds the minimum requirements for password length. In the table below, you may see all the password requirements:
+| Factor | +Requirement | +
|---|---|
| Length | +At least 15 characters | +
| Special characters | +At least 2 required | +
| Numbers | +At least 2 required | +
| Upper / Lower case | +At least 2 upper & 2 lower case letters required | +
Please avoid using easy to guess combinations like names & birth dates of you or your relatives, zip codes & cities and obvious words like 'password', 'libreevent', 'admin', 'root' and your organisation / event's name.
+After this, the system will email you an email confirmation link using the email you've previously configured in the config.json file during installation.
+Page setup
+After having set up the root account and confirmed the email address, it is now time to set the name of the webpage. For this, you'll need to enter your organisation's name and choose the offered languages. Note that for every language you select, you need to add a promotional text. Please select a homepage template from here. You also have to upload an/some image(s) at this stage, if the selected template requires (an) image(s).
+Payment methods
+Now it is time to set up some payment methods. You may find advantages / disadvantages of each payment gateway here. It is advised to only choose one payment gateway which provides lots of different payment options, but cost of usage can also be a factor to consider. You may add more payment options by downloading a plugin through the plugin installer in the admin panel. Note: You'll have to restart the node app whenever you install a new plugin!
+Event setup
+With payment methods sorted, you now have to add an event. For this, you'll need to create tickets by hitting the plus icon.
+TOS
+This is an optional step. Here you may add your own terms of services (TOS), next to the ones that are given by libreevent itself. Your TOS will be inserted at the top.
+Setup complete
+With this, you've completed the setup of the event. We now ask you to restart the node application. You may do this by stopping the process (if logged in via SSH, press Ctrl + C, if you've got a graphical user interface for setting up the node app, it should be self explanatory) and restarting it as described here.
+Congratulations! You've now successfully set up your event management solution. You may now log into the admin panel. You can find your admin panel at /admin (example: libreevent.janishutz.com/admin, replace libreevent.janishutz.com with your own domain).
+You may find documentation on the admin panel here
+Sponsor
+Systemrequirements
+libreevent's system requirements are low, you only need a PC or Server that can run node.js and is able to install npm packages. If the system you are trying to use is unable to download npm packages, you may download the packages on your own system and upload them together with the rest of the server files. How to do that is described in greater detail in the Getting Started guide.
+node.js
+Your system needs to be able to run node.js V > 12.0 and must have access to either npm or the downloaded npm packages.
+Hardware requirements
+Hardware requirements solely depend on the amount of usage it is going to get. An average hosting plan should be able to handle about 1000 people. In case the system is not able to uphold the traffic, it will activate a protection to try and stop overloading and crashing the system. Although using multiple checks, we cannot guarantee that the system will never crash due to being overloaded, so, if the website is important, please overspec the server.
+