Skip to content

Latest commit

 

History

History
97 lines (64 loc) · 4.74 KB

README.md

File metadata and controls

97 lines (64 loc) · 4.74 KB
Raw

Veranstaltungskalender, Terminbuchung, Terminanfragen, Anmeldungen und Teilnehmerlisten für REDAXO ^5.17 und YForm ^4

web_banner_redaxo_addon_events

Mit diesem Addon können Termine anhand von YForm und YOrm im Backend verwaltet und im Frontend ausgegeben werden. Auf Wunsch auch mehrsprachig.

Features

  • Vollständig mit YForm umgesetzt: Alle Features und Anpassungsmöglichkeiten von YForm verfügbar
  • Einfach: Die Ausgabe erfolgt über rex_sql oder objektorientiert über YOrm
  • Flexibel: Zugriff über die YForm Rest-API
  • Sinnvoll: Nur ausgewählte Rollen/Redakteure haben Zugriff
  • Bereit für mehrsprachige Websites: Reiter für Sprachen auf Wunsch anzeigen oder ausblenden
  • Bereit für mehr: Vorbereitet für das JSON+LD-Format, ICS-Format
  • Bereit für viel mehr: Kompatibel zum URL2-Addon
  • Mächtig: Datenbank-Struktur für Anmeldeformulare und einfache Teilnehmerlisten vorbereitet
  • Umfangreich dokumentiert und in aktiver Weiterentwicklung

Tipp: Events arbeitet hervorragend zusammen mit den Addons yform_usability und yform_geo_osm

Steuere eigene Verbesserungen dem GitHub-Repository von events bei. Oder unterstütze dieses Addon: Mit einer Spende oder Beauftragung unterstützt du die Weiterentwicklung dieses AddOns

Neu in Events 6

  • Nutzung des Namespace ALexplusde\Events\ und damit Anpassung aller Klassen
  • Neue Methoden an den jeweiligen Objekten für die Ausgabe von Events
  • Vorgefertigtes Modul mit anpassbaren Fragmenten für die Ausgabe von Veranstaltungen, Kategorien, Terminen usw.
  • Datensätze im Table Manager zeigen jetzt auf eine URL, falls online
  • Verschiedene Bugfixes und Verbesserungen
  • Zusätzliche Dokumentation und Beispiele

Hinweis: Die Version 6 ist nicht abwärtskompatibel zu Version 5. Bitte prüfe vor dem Update die Änderungen und passe ggf. deine Anpassungen an.

Vom Entwickler notwendige Anpassungen für Version ^5 -> ^6

  • Die Klassen Event, Category, Date, Registration, RegistrationPerson und RegistrationPersonFill benötigen einen Namespace zur Verwendung. Die Klassen event_date, event_category, ... sind nicht mehr vorhanden.
  • Die Tabellen rex_event_category, rex_event_date, ... haben Änderungen erfahren:
    • rex_event_date.event_category_id heißt jetzt rex_event_date.category_id. Diese vor dem Update anpassen.
    • Die meisten Tabellen haben jetzt ein Feld uuid. Felder, die bisher uid hießen, wurden in uuid umbenannt.
  • Felder vom Typ event_media wurde durch den Typ be_media_preview (🧩 YForm Field) ersetzt.

Installation

Im REDAXO-Installer das Addon events herunterladen und installieren. Anschließend erscheint ein neuer Menüpunkt Veranstaltungen sichtbar.

Nutzung im Frontend

Neu in Version 6: Erstelle ein Modul mit folgendem Inhalt.

<?php
use FriendsOfRedaxo\Neues\Neues;

$fragment = new rex_fragment();
$fragment->setVar('slice_id', 'REX_SLICE_ID');

echo $fragment->parse('bs5/events/index.php')

?>

Die Fragmente sind für eine Nutzung mit Bootstrap 5 ausgelegt und können bei Bedarf angepasst werden, zum Beispiel über das Project-Addon.

Formulare

Die YForm-Action event_date_registration_person_fill

Nutze diese Action, wenn in einer Anmeldung sogleich Teilnehmende in einer Tabelle "Teilnehmende" erfolgen soll:

    $yform->setActionField('event_date_registration_person_fill', array(""));

Dabei wird die Tabelle rex_event_date_registration_person automatisch mit der Anzahl der anzumeldenden Teilnehmenden befüllt.

Lizenz

MIT Lizenz, siehe LICENSE.md

Autoren

Alexander Walther
http://www.alexplus.de
https://github.com/alexplusde

Michael Schuler https://github.com/191977

Projekt-Lead
Alexander Walther

Credits

events basiert auf: YForm
Danke an Gregor Harlan für die Unterstützung Danke an den Kulturkeller e.V. für die Beauftragung für die Weiterentwicklung