lots of progress on docs

This commit is contained in:
2023-09-30 16:56:42 +02:00
parent 5a3323a0ea
commit ee7b90cd93
21 changed files with 113 additions and 196 deletions

View File

@@ -31,9 +31,6 @@ body {
This is the title div with a screenshot of the admin portal
*/
.title-wrapper {
/*
TODO: Replace with image
*/
background-color: white;
display: flex;
text-align: center;

View File

@@ -1,62 +0,0 @@
<!DOCTYPE html>
<html lang="en">
<head>
<title>Admin Accounts :: docs - libreevent</title>
<link rel="stylesheet" href="/docs/css/style.css">
<meta http-equiv="X-UA-Compatible" content="IE=edge">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<meta charset="utf-8">
<meta name="description" content="Looking for a free and open source event management solution you can host yourself? libreevent is a project that does exactly that.">
<link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/11.7.0/styles/dark.min.css">
<script src="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/11.7.0/highlight.min.js"></script>
<script>hljs.highlightAll();</script>
</head>
<body>
<div id="nav"></div>
<div id="side-bar"></div>
<div id="backToTop" onclick="backToTop();"></div>
<div id="docPage">
<div id="doc-container">
<h1>Admin Accounts</h1>
<p>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.</p>
<h2>Adding an account</h2>
<h3>Privileges</h3>
<p>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:</p>
<table>
<thead>
<tr>
<th>Group</th>
<th>Allowed settings</th>
</tr>
</thead>
<tbody>
<tr>
<td>Root</td>
<td>All pages. Can only be one account (the root account)</td>
</tr>
<tr>
<td>Admin</td>
<td>Can access all pages and settings except for Admin Accounts</td>
</tr>
<tr>
<td>Event-Manager</td>
<td>Access the events &amp; pages page</td>
</tr>
<tr>
<td>Event-Handler</td>
<td>Can log into the apps to do entry control</td>
</tr>
</tbody>
</table>
<h3>Email</h3>
<p>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.</p>
<h3>2FA</h3>
<p>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 <a href="/docs/admin-panel/settings#2fa">Settings</a> you may choose between the two different 2FA modes that libreevent offers.</p>
<h2>Modifying an account</h2>
<h2>Removing an account</h2>
</div>
</div>
<script src="https://ajax.googleapis.com/ajax/libs/jquery/3.6.1/jquery.min.js"></script>
<script src="/docs/js/index.js"></script>
</body>
</html>

View File

@@ -19,8 +19,8 @@
<div id="doc-container">
<h1>Home</h1>
<p>The admin panel is where you can change basically everything about libreevent.
&lt;!-- In a future update, depending on your account's privileges, you may find more or less settings. Only the root account has access to the admin accounts page. Currently though, all pages are unlocked for all users. --&gt;</p>
<p>Here's a list of the pages available when logged in as the root user. &lt;!-- All other users have fewer pages enabled.--&gt;</p>
</p>
<p>Here's a list of the pages available when logged in as the root user. </p>
<ul>
<li><a href="/docs/admin-panel/events">Events</a></li>
<li><a href="/docs/admin-panel/locations">Locations</a></li>
@@ -29,8 +29,8 @@
<li><a href="/docs/admin-panel/seatplan-editor">Seatplan editor</a></li>
<li><a href="/docs/admin-panel/settings">Settings</a></li>
</ul>
<p>&lt;!-- Additionally, some settings might not be available to all admin accounts on all pages. --&gt;</p>
<p>&lt;!-- <em>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</em>. --&gt;</p>
<p></p>
<p></p>
</div>
</div>
<script src="https://ajax.googleapis.com/ajax/libs/jquery/3.6.1/jquery.min.js"></script>

View File

@@ -53,34 +53,9 @@ The following settings are available:</p>
<h3>Gateway settings</h3>
<p>Here you need to enter gateway specific settings to make them work. Do note, that some gateway plugins might crash libreevent on startup if these settings aren't entered, if you are using an unofficial plugin. All officially supported plugins will not crash it if the values entered are incorrect</p>
<h1>Admin Accounts</h1>
<p>On this page you may add, modify or remove admin accounts. &lt;!--Note that in order for you to see this page, you'll need to be logged in as the user root.--&gt;</p>
<p>On this page you may add, modify or remove admin accounts. </p>
<h2>Adding an account</h2>
<p>&lt;!-- ### Privileges
TODO: will be added in future version
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:</p>
<table>
<thead>
<tr>
<th>Group</th>
<th>Allowed settings</th>
</tr>
</thead>
<tbody>
<tr>
<td>Root</td>
<td>All pages. Can only be one account (the root account)</td>
</tr>
<tr>
<td>Admin</td>
<td>Can access all pages and settings except for Admin Accounts</td>
</tr>
<tr>
<td>Event-Manager</td>
<td>Access the events &amp; pages page</td>
</tr>
<tr>
<td>Event-Handler</td>
<td>Can log into the apps to do entry control --&gt;</td>
<p></td>
</tr>
</tbody>
</table>

View File

@@ -34,9 +34,6 @@ body {
}
.title-wrapper {
/*
TODO: Replace with image
*/
background-color: white;
display: flex;
text-align: center;

View File

@@ -1,28 +0,0 @@
<!DOCTYPE html>
<html lang="en">
<head>
<title>List of plugins :: docs - libreevent</title>
<link rel="stylesheet" href="/docs/css/style.css">
<meta http-equiv="X-UA-Compatible" content="IE=edge">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<meta charset="utf-8">
<meta name="description" content="Looking for a free and open source event management solution you can host yourself? libreevent is a project that does exactly that.">
<link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/11.7.0/styles/dark.min.css">
<script src="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/11.7.0/highlight.min.js"></script>
<script>hljs.highlightAll();</script>
</head>
<body>
<div id="nav"></div>
<div id="side-bar"></div>
<div id="backToTop" onclick="backToTop();"></div>
<div id="docPage">
<div id="doc-container">
<h1>List of plugins</h1>
<p>This list of plugins contains all official plugins of libreevent. For a more up-to-date version of this list, please check your</p>
<h2></h2>
</div>
</div>
<script src="https://ajax.googleapis.com/ajax/libs/jquery/3.6.1/jquery.min.js"></script>
<script src="/docs/js/index.js"></script>
</body>
</html>

View File

@@ -18,7 +18,7 @@
<div id="docPage">
<div id="doc-container">
<h1>Setup of libreevent</h1>
<p>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 <a href="/docs/setup/getting-started">here</a>. Let's get started setting up your event management system!</p>
<p>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 <a href="/docs/setup/installation">here</a>. Let's get started setting up your event management system!</p>
<h2>Connecting to the server</h2>
<p>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 (or copy) it into the field and hit &quot;Start setup&quot;. You will now land on the setup start page. You may hit &quot;Start setup&quot; below to start the setup.</p>
<p><em>Note: This is only available during the setup process of libreevent and will afterwards be deactivated to ensure safety of the system.</em></p>

View File

@@ -1,26 +0,0 @@
<!DOCTYPE html>
<html lang="en">
<head>
<title>Sponsor :: docs - libreevent</title>
<link rel="stylesheet" href="/docs/css/style.css">
<meta http-equiv="X-UA-Compatible" content="IE=edge">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<meta charset="utf-8">
<meta name="description" content="Looking for a free and open source event management solution you can host yourself? libreevent is a project that does exactly that.">
<link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/11.7.0/styles/dark.min.css">
<script src="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/11.7.0/highlight.min.js"></script>
<script>hljs.highlightAll();</script>
</head>
<body>
<div id="nav"></div>
<div id="side-bar"></div>
<div id="backToTop" onclick="backToTop();"></div>
<div id="docPage">
<div id="doc-container">
<h1>Sponsor</h1>
</div>
</div>
<script src="https://ajax.googleapis.com/ajax/libs/jquery/3.6.1/jquery.min.js"></script>
<script src="/docs/js/index.js"></script>
</body>
</html>

View File

@@ -19,7 +19,7 @@
<div id="doc-container">
<h1>Sponsoring</h1>
<p>As any project, libreevent also needs funding to keep development going. If you have used and liked libreevent and want to see it grow and become more feature rich, you might want to consider donating to the project. If you are a company and you want to become a sponsor of the project, please <a href="mailto:development@janishutz.com">contact me</a> for a sponsor deal.</p>
<p>&lt;!-- If you are an individual looking to support the development of libreevent, you may donate [here] TODO: Finish --&gt;</p>
<p></p>
</div>
</div>
<script src="https://ajax.googleapis.com/ajax/libs/jquery/3.6.1/jquery.min.js"></script>

View File

@@ -1,26 +0,0 @@
<!DOCTYPE html>
<html lang="en">
<head>
<title>Tutorial :: docs - libreevent</title>
<link rel="stylesheet" href="/docs/css/style.css">
<meta http-equiv="X-UA-Compatible" content="IE=edge">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<meta charset="utf-8">
<meta name="description" content="Looking for a free and open source event management solution you can host yourself? libreevent is a project that does exactly that.">
<link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/11.7.0/styles/dark.min.css">
<script src="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/11.7.0/highlight.min.js"></script>
<script>hljs.highlightAll();</script>
</head>
<body>
<div id="nav"></div>
<div id="side-bar"></div>
<div id="backToTop" onclick="backToTop();"></div>
<div id="docPage">
<div id="doc-container">
<h1>Tutorial</h1>
</div>
</div>
<script src="https://ajax.googleapis.com/ajax/libs/jquery/3.6.1/jquery.min.js"></script>
<script src="/docs/js/index.js"></script>
</body>
</html>

View File

@@ -7,18 +7,42 @@
<meta name="description" content="Download libreevent, the free and open source event management solution">
<title>Download - libreǝvent</title>
<link rel="stylesheet" href="/css/style.css">
<style>
.download-buttons {
width: 100%;
margin-top: 2%;
margin-bottom: 2%;
display: flex;
flex-wrap: wrap;
height: fit-content;
}
.button {
display: block;
margin: 0;
width: 40%;
margin-right: 1%;
margin-bottom: 0.5%;
}
</style>
</head>
<body>
<div id="nav"></div>
<div id="backToTop" onclick="backToTop();"></div>
<div class="title-wrapper">
<h1>Download libreǝvent</h1>
<footer>Ready to downlaod?</footer>
<h1>Download <i>libre</i>ǝvent</h1>
</div>
<div class="content">
<h3 class="dev">Website & project not completed yet!</h3>
<p>There are a couple of options to download libreǝvent. You may use npm or you may download it from the GitHub releases page. You may also clone the repository locally if you want to use upstream instead of a release</p>
<a href="https://github.com/simplePCBuilding/libreevent" class="button">GitHub</a>
<p>libreǝvent can be downloaded in two main ways, either by downloading the prebuilt zip / tar files or by downloading the entire GitHub repository and compiling it manually. We would highly suggest that you download the prebuilt version of libreǝvent to make things easier. After downloading, you can follow our guide <a href="/docs/setup/installation">here</a> to get libreǝvent installed on your server.</p>
<p>Depending on your webhosting company, you might also need to download the "node-modules" to deploy libreevent. If so, the installation guide will tell you to do it. </p>
<div class="download-buttons">
<!-- TODO: Add api routes for this! -->
<a href="https://api.janishutz.com/download/libreevent?v=latest&type=prebuilt" class="button">Direct download (recommended)</a>
<a href="https://api.janishutz.com/download/libreevent?v=latest&type=releases" class="button">GitHub releases</a>
<a href="https://api.janishutz.com/download/libreevent?v=all&type=releases" class="button">All releases</a>
<a href="https://github.com/simplePCBuilding/libreevent" class="button">Source code</a>
<a href="https://api.janishutz.com/download/libreevent?v=latest&type=npm" class="button">node-modules</a>
</div>
<p>You may download the iOS & Android apps from the AppStore / Google Play Store respectively.</p>
</div>
<div id="footer"></div>

View File

@@ -20,7 +20,6 @@
<footer>Free & Open Source self-hosted event management solution</footer>
</div>
<div class="content">
<!-- TODO: Redo look & feel of website -->
<h3 class="dev">Website & project not completed yet!</h3>
<h2>What is libreǝvent?</h2>
<p>libreǝvent is a free and fully open source self-hosted event management solution that you can use to sell tickets for your next event. It features both an iOS and Android App for entry control you can download and use entirely for free. If you like this project, please consider giving it a star on <a href="https://github.com/simplePCBuilding/libreevent">GitHub</a> and donating to help fund development of this project!</p>

View File

@@ -16,6 +16,7 @@
<a class="navitem inactive" id="docs" href="/docs">Documentation</a>
<a class="navitem inactive" id="download" href="/download">Download</a>
<a class="navitem inactive" id="about" href="/about">About</a>
<a class="navitem inactive" id="templates" href="/templates">Start page templates</a>
<a class="navitem inactive" id="gh" href="https://github.com/simplePCBuilding/libreevent" target="_blank" onclick="sessionStorage.setItem( 'menuOpen', String( false ) );">GitHub</a>
</div>
</div>

53
website/dist/templates/index.html vendored Normal file
View File

@@ -0,0 +1,53 @@
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8">
<meta http-equiv="X-UA-Compatible" content="IE=edge">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<meta name="description" content="Download libreevent, the free and open source event management solution">
<title>Start page templates - libreǝvent</title>
<link rel="stylesheet" href="/css/style.css">
</head>
<body>
<div id="nav"></div>
<div id="backToTop" onclick="backToTop();"></div>
<div class="title-wrapper">
<h1>Start page templates</h1>
</div>
<div class="content">
<p>libreǝvent uses plain HTML start pages, such that you can create your own start page or use one of the included start page templates. You may also upload new start page templates, as explained <a href="/docs/plugins/start-pages">here</a> or you may also create a complete custom one yourself, as explained <a href="/docs/plugins/create-start-pages">here</a></p>
<p>Currently, libreǝvent has the following start page templates included by default:</p>
<ul>
<li><a href="/templates/default">Default</a></li>
<li><a href="/templates/modern">Modern</a></li>
</ul>
<p>More templates will be available in the future and you will find download links to them here.</p>
</div>
<div id="footer"></div>
<script src="https://ajax.googleapis.com/ajax/libs/jquery/3.6.1/jquery.min.js"></script>
<script src="https://ajax.googleapis.com/ajax/libs/jqueryui/1.11.3/jquery-ui.min.js" crossorigin="anonymous" referrerpolicy="no-referrer"></script>
<script>
let btn = document.getElementById( 'backToTop' );
$( document ).ready( function () {
$( '#nav' ).load( '/nav.html' );
$( '#footer' ).load( '/footer.html' );
} );
function backToTop () {
if ( document.body.scrollTop > 500 || document.documentElement.scrollTop > 500 ) {
window.scrollTo( { top: 0, behavior: 'smooth' } );
}
}
window.onscroll = function () {
if ( document.body.scrollTop > 500 || document.documentElement.scrollTop > 500 ) {
btn.style.opacity = '1';
btn.style.cursor = 'pointer';
} else {
btn.style.opacity = '0';
btn.style.cursor = 'default';
}
};
</script>
</body>
</html>