Dieser Eintrag ist Teil der Anleitung zur Chaotikum Website

Um Events auf der Website darstellen zu können werden Events aktuell im Repository der Website angelegt. Dazu soll es auch noch ein Skript geben.

Ein Event kommt in den _events Ordner die Struktur einer Datei welche mit dem Datum und einem titel des events benannt ist. Das Datum hat die Form 20190510- anders als z.B. Blogposts. Das ist wichtig.

---
layout: [eventcal]
title:  "Freitalk: Feinstaubsensoren"
image: "/assets/wall.png"
eventdate:   2019-05-10 20:00:00 +0200
eventend:   2019-05-10 23:00:00 +0200
#https://www.uuidgenerator.net/
uid: 05f0bcf2-05b3-47ae-95b7-ed7927207bab
contact: vorstand@chaotikum.org
poster: https://wiki.chaotikum.org/_media/hackerspace:openspace.jpg
recording: true
locations:
 - Augenprüfraum
short: "Freitalk N8: Freitalk Nacht - Freitag nach Acht."
---

• layout: dies muss eventcal in eckigen klammern sein
• image: kann man weglassen. Wird aktuell nicht verwendet. Idee ist, sollte es Seiten für Events geben, dort ein Header zu haben. Lieber einfach wall.png setzen.
• eventdate: Startzeit des Events. ACHTUNG. im Winter mit +0100 und im Sommer mit +0200
• eventend: Endzeit des Events. ACHTUNG. im Winter mit +0100 und im Sommer mit +0200
• uid: Muss eine eindeutige ID haben, dies wird genutzt um verknüpfungen zu bloposts und videos zu machen und IDS für verschiedene exporte (ICAL u.ä) zu generieren. Also bitte immer eine ID generieren und niemals kopieren.
• contact: Kontaktdaten des Veranstallters. Wenn du selbst nicht drin stehen möchtest trag den vorstand ein.
• poster: Kann man weglassen. Sonst ist ein Posterlink im RSS, den z.B. Dashboards nutzen können.
• recording: true oder false.
• nofrontpage: true oder false. Bei false auch gerne weglassen. Damit wird vermieden, dass das Events 3 Tage vor dem Event auf der Frontpage angezeigt wird.
• fotopolicy: Hier kann der String open oder restrictive angegeben werden. Man kann es auch freilassen. Dann greift ein Default. Bei Events mit recording true ist der default open, bei recording false ist der default für die fotopolicy restrictive. Entsprechend wird ein text in der Eventbox angezeigt.
  • Bei restrictive: „Das Fotografieren und Filmen auf dieser Veranstaltung ist lediglich mit explizieter Erlaubnis aller fotografierten oder gefilmten Personen gestattet.“
  • Bei open: „Unsere Events werden fotografisch und filmisch dokumentiert. Durch Teilnahme an den Veranstalltungen gilt eine Einwilligung zur Verarbeitung des entstandenen Matrials als erteilt. Die Aufnahmen verwenden wir für die Öffentlichkeitsarbeit (z.B. Social Media) und der Dokumentation der Vereinsarbeit (Art. 6 Ab. 1 f DSGVO). Weitere Informationen und Kontaktdaten finden sich in unseren Datenschutzhinweisen.“
• locations: eine Liste von Orten an denen das Event stattfindet als Freitext. Feature: wenn man eine Liste aus „Augenprüfraum“, „Wartezimmer“ und „Lager“ macht, steht im Event nachher „Nobreakspace“. Man sollte nicht „Nobreakspace“ angeben, da es RSS und ICAL Dateien für die jeweiligen Räume gibt, damit man die Raumbelegung in dem kalender sehen kann. Dieses Feld ist dafür der Selector. Daher: Idealerweise die konkreten Räume angeben, in denen ein Event stattfindet!
• short: Enthält eine kurze Beschreibung. Kurz ist erst gemeint. Mache einen sehr kurzen Satz, keine Zeilenumbrüche sonst geht das ICAL kaputt.

Aus den Eventdaten werden insbesondere 3 Artefakte generiert

• ICS (iCal) Dateien die Menschen in ihre Kalender integrieren können
  • events.ics für alles, was der Verein so im Kalender hat
  • eventsinternal.ics beinhaltet z.B. auch Reinigungstermine, Heizungsableser und andere Interne Termine
  • augenpruefraum.ics für alles was im Augenprüfraum stattfindet
  • wartezimmer.ics für alles was im Wartezimmer stattfindet
  • lager.ics für alles was im lager stattfindet
• RSS-Dateien mit allen anstehenden Events
  • events.xml Diese wird z.B. für den Bot, der den Event-RSS Feed im Riot-Chat postet, genutzt oder auch für das Dashboard
• Die Event-Seite, welche die Events als HTML darstellt

Mithilfe gleicher uuids kann ein Blogpost das Event finden zu dem er gehört und dann einen Kasten mit den Daten zum Event unten im Blogpost anzeiegn. Wichtig: Dies geschieht nur, wenn der Blogpost das „tag“ „event“ hat.