Anleitung und technische Dokumentation

Auf dieser Seiten werden die Pflege der Blau-Gold-Webseite und die technischen Zusammenhänge erklärt. Jeder Admin dieser WordPress-Seite kann dieses gerne ergänzen/erweitert.

Technische Basis:

Die Hauptseite des BGC basiert auf WordPress (aktuell Verion 6.x).
Hierauf sind einige wesentliche Plugins installiert.

  • Als erstes ist hier ein speziell für den BGC angepasstes Theme auf Basis von Bootstrap installiert.
    Dieses ist in einem spearaten Repository gespeichert:
    https://gitlab.com/bgc-admins/wp-bgc-theme
    Von dort ist eine CI/CD-Pipeline eingerichtet, d.h. Änderungen im git werden automatisch auf den Server gespielt. D.h. sämtliche lokale Änderungen (in WordPress) werden dabei wieder verworfen! (Nur Theme-PHP-Dateien, nicht die Konfig)
  • Ein Slides-Plugin für die Diashow auf der Startseite:
    MetaSlider
  • Ein Menu-Plugin:
    Max Mega Menu
  • Sowie zwei vom BGC selbst erstellte Plugins:
    MGVO WordPress https://gitlab.com/mgvo-public/mgvo-wordpress
    – Für alle Listen /Details aus MGVO
    MGVO fullcal https://gitlab.com/bgc-admins/mgvo-fullcal
    – Für alle Kalenderdarstellungen aus MGVO

MGVO WordPress / MGVO fullcal beruht wiederum auf der MGVO API (https://gitlab.com/mgvo-public/mgvo-api)

Die Webseite füllt sich auf Basis folgender Daten in MGVO:

  • Orte:
    Die in MGVO hinterlegen Orte bestimmen, welche Ortsspalten in MGVO angezeigt werden
  • Gruppen
    Für die Anzeige der Gruppen werden die Gruppen aus MGVO herangezogen.

    • Grundvoraussetzung ist, dass der Gruppe ein Terminslot aus der Gruppenseite eingetragen ist. Sonst wird die Gruppe nicht über API exportiert und somit nicht angezeigt.
    • Wenn nur der genereller Wochen-Slot eingetragen ist, wieder dieser für die Kalenderdarstellung verwendet.
    • Wenn in der Gruppe ein Gruppenkalender eingetragen ist, wird der Gruppenslot ignoriert und die Termine aus dem Kalender geladen.
  • Die Gruppen-Kalender bilden die Basis für die meisten Einträge in den Kalendern.
  • Veranstaltungen
    Die Veranstaltungen in MGVO bilden die Basis für die Veranstaltungslisten auf der Homepage. Wenn spezielle Seite auf der Homepage angelegt werden (z.B. für eine DM oder die Blau-Gold-Tanzparty) sollte der Link hierzu auch im Veranstaltungscockpit hinterlegt werdne, sind sind diese auf den Listen nicht erreichbar.
  • Der Punkt “Traningsausfälle” in MGVO wird aktuell nicht genutzt, die Anzeige auf der Webseite ist deaktiviert.

Manuell auf dem Server gepflegte Themen:

  • Artikel
  • Inhalte/Grafiken der Slider/Diashow
  • Sonderseiten für Veranstaltungen (Turniere, etc.)
  • Allgemeine Vereinsinformationen

Monitor im Foyer

Der Monitor im Eingangsbereich speist sich ebenfalls aus diesem WordPress-Server.

Der Monitor wird durch einen Raspberry Mini-Computer angesteuert. Das Betriebssystem wird ohen große Anpassungen hierfür verwendet. Details dazu finden sich hier: https://gitlab.com/bgc-admins/bgc-monitor/-/wikis/Einrichtung

Danach wir ein Browser im sogenannten Kiosk-Mode geöffnet (Vollbild, ohne Bedienelemente) und die URL https://blau-gold-darmstadt.de/monitor1 geladen. Diese Seite liegt auf dem normalen Blau-Gold-Webserver und ist öffentlich für jederman abrufbar. (Diese ist aber nicht im Menu aufgeführt) Zum testen kann diese URL von jedem PC geöffnet werden. Evtl. muss die Größe des Browserfensters angepasst werden, weil die Inhalte an die größe des Monitors (FullHD, 1920×1080) angepasst sind.

Alle weitere Logik liegt in einem Script welches direkt auf dem Websever (im Plugin Java & CSS Toolbox) hinterlegt ist. Dort muss die Liste der Seiten, die auf dem Monitor rotiert werden, eingetragen werden. Außerdme muss dieses Script auch allen diesen Seiten zugewiesen werden (rechte Box, “Page” auswählen und tief scrollen.)

Das Script lädt einfach nach einer gewissen Zeit (aktuell 10sec) die nächste URL aus der Liste (monitor1, monitor2, etc). Eine Kopie des Scriptes ist Manuell hier hinterlegt. Achtung: die Seiten sollten immer ohne Menu, etc. Angezeigt werden. Dies läßt sich mit dem template “blank_slate” (Auswahl in der rechten Leiste) erreichen. Inhalte und Grafiken, etc. sollten immer auf die Auflösung des Monitors (FullHD) abgestimmt sein.

Zur Stromeinsparung wurde ein Bewegungsmelder angebracht, der (via Raspberry) den Monitor nach 30min ausschaltet und nach erkannter Bewegung wieder Einschaltet.

Die Tastatur ist aktuell noch ohne Funktion!