Zum Inhalt springen
Start » JTL Plugin: Events Plugin für JTL-Shop 5

JTL Plugin: Events Plugin für JTL-Shop 5

JTL-Shop 5 · Plugin

Events & Veranstaltungskalender – modern, flexibel, im Handumdrehen platziert

Zeige deine Termine, Events und Veranstaltungen als eleganten Monatskalender, als Liste oder als Kachel-Grid – frei platzierbar per OnPage Composer (OPC) auf jeder Seite. Mit Kategorien & Farben, sprechenden URLs, Karten-Einbettung, iCal-Export und einem vollständig editierbaren Styling (Farben, Buttonform, Schrift & mehr) – komplett ohne Programmierung.

Perfekt für: Konzerte & Messen, Webinare & Workshops, Sale-Aktionen, Tastings, Vereins- und Community-Termine.

Drei Ansichten in einem Portlet

  • Monatskalender – klassische Kalender-Matrix mit Monatsnavigation & „Heute“.
  • Liste – kompakte, chronologische Übersicht mit Datums-Badge.
  • Kacheln – visuelles Grid mit Titelbild pro Event.
  • Umschalter im Frontend – Besucher wechseln die Ansicht per Klick.

Styling-Editor Highlight

  • Akzentfarben & Verlauf – passe das Design an dein Shop-CI an.
  • Buttonform wählbar – eckig, abgerundet oder Pill.
  • Eckenradius, Schriftart, Schatten – frei einstellbar.
  • Live-Vorschau – Ergebnis sofort sichtbar, ohne Code.

Event-Verwaltung

  • Alle Felder – Titel, Start/Ende, ganztägig, Ort, Adresse, Bild, Beschreibung.
  • Externer Link – z.B. zur Ticket- oder Anmeldeseite, optional im neuen Fenster.
  • Eigene CSS-Klasse – für individuelle Feinheiten pro Event.
  • Aktiv/Inaktiv & Sortierung – volle Kontrolle über die Ausgabe.

Kategorien mit Farben

  • Farb-Zuordnung – jede Kategorie mit eigener Farbe (Colorpicker).
  • Filter-Chips im Frontend – Besucher filtern Events nach Kategorie.
  • Farbige Badges – Kategorie sofort erkennbar in allen Ansichten.
  • Sortierbar – Reihenfolge frei bestimmen.

Detail-Popup & SEO-Seiten

  • Schickes Detail-Popup – Bild, Datum, Ort, Beschreibung im animierten Modal.
  • Sprechende URLs – jede Veranstaltung unter /paw-events/<slug>.
  • SEO-optimiert – eigener Title, Meta-Description, Open-Graph-Tags.
  • Direkt verlinkbar – ideal für Newsletter & Social Media.

Karte & Kalender-Export

  • Karten-Einbettung – Veranstaltungsort direkt als Karte (OpenStreetMap oder Google Maps, kein API-Key nötig).
  • iCal-Export (.ics) – „Zum Kalender hinzufügen“ für Outlook, Apple & Google Kalender.
  • Archiv-Ansicht – vergangene Events separat abrufbar.
  • Wochenstart wählbar – Montag oder Sonntag.

OPC-Portlet – frei platzierbar OnPage Composer

  • Per Drag & Drop – auf jeder OPC-Seite einfügen.
  • Pro Portlet konfigurierbar – Ansicht, Kategorie-Filter, max. Anzahl.
  • Mehrfach nutzbar – z.B. Startseite „Kacheln“, Event-Seite „Kalender“.
  • OPC-Styles & Animationen – zusätzlich zu den Plugin-Stilen nutzbar.

Technische Details

  • JTL-Shop 5.5.1+, PHP 7.4+, NOVA-Template, OPC.
  • 3 Datenbanktabellen – Events, Kategorien, Konfiguration/Styling.
  • JSON-Endpoint/paw-events/data für die Frontend-Ausgabe.
  • Mehrsprachig – Sprachvariablen für Deutsch & Englisch.

Screenshots

Screenshot
Kurz gesagt Verwandle deine Termine in ein echtes Erlebnis: moderner Kalender, Listen- und Kachelansicht, farbige Kategorien, Detail-Popups mit Karte, iCal-Export und sprechende URLs – frei platzierbar per OPC und optisch komplett an dein Shop-Design anpassbar. Ohne Programmierung, ohne laufende Kosten.


Events & Veranstaltungskalender – Dokumentation

Moderner Veranstaltungskalender für JTL-Shop 5: Events als Monats-, Listen- oder Kachelansicht per OPC-Portlet anzeigen – mit farbigen Kategorien, Detail-Popup, sprechenden URLs, Karten-Einbettung, iCal-Export und vollständig editierbarem Styling.

Installation & Einrichtung

Plugin installieren & aktivieren

ZIP hochladen unter Plugins → Pluginverwaltung. Die Datenbanktabellen werden automatisch angelegt.

Kategorien anlegen

Im Backend-Menü „Events Plugin für JTL-Shop 5“ → Tab „Kategorien“ die gewünschten Kategorien mit Farbe erstellen (optional).

Veranstaltungen erstellen

Im Tab „Events“ Termine anlegen: Titel, Start/Ende, Ort, Bild, Beschreibung und ggf. externen Link.

Portlet platzieren

Im OnPage Composer (OPC) das Portlet „Events (Kalender)“ auf die gewünschte Seite ziehen, Ansicht wählen und veröffentlichen.

TippNach dem Anpassen von Styling oder Assets im Frontend ggf. einen Hard-Reload (Strg+F5) durchführen.

Portlet einbinden (OnPage Composer)

Die Anzeige der Events erfolgt über das OPC-Portlet „Events (Kalender)“ in der Gruppe Inhalt. Ziehe es per Drag & Drop auf eine beliebige OPC-Seite.

EinstellungBeschreibung
ÜberschriftOptionaler Titel über dem Kalender.
Standard-AnsichtMonat (Kalender), Liste oder Kacheln – die anfänglich gezeigte Ansicht.
Nur Kategorie-IDZeigt ausschließlich Events dieser Kategorie. 0 = alle Kategorien.
Max. Anzahl EventsBegrenzt die geladenen Events. 0 = unbegrenzt.
Kategorie-Filter anzeigenBlendet die Filter-Chips im Frontend ein/aus.
Mehrfach nutzbarDu kannst das Portlet beliebig oft einsetzen – z.B. auf der Startseite als „Kacheln“ (Limit 3) und auf einer eigenen Termin-Seite als voller „Kalender“.

Events verwalten

Im Tab „Events“ kannst du Veranstaltungen anlegen, bearbeiten, aktivieren/deaktivieren und löschen.

FeldBeschreibung
TitelName der Veranstaltung (Pflichtfeld). Aus dem Titel wird automatisch die sprechende URL erzeugt.
KategorieOrdnet das Event einer farbigen Kategorie zu (optional).
GanztägigBlendet Uhrzeiten aus; Start = 00:00, Ende = 23:59.
Start / EndeDatum und Uhrzeit. Nur der Start ist Pflicht. Endet ein Event vor dem Start, wird das Ende ignoriert.
Ort (Anzeigename)Wird im Detail unter „Wo“ angezeigt (z.B. „Stadthalle Musterstadt“).
AdresseWird für die eingebettete Karte im Detail-Popup verwendet.
Bild-URLTitelbild für Kachel- und Detailansicht (mit Live-Vorschau im Backend).
BeschreibungFreitext, einfaches HTML erlaubt (z.B. <br>, <strong>).
Externer LinkOptionaler Link (z.B. zu Tickets/Anmeldung), auf Wunsch im neuen Fenster.
CSS-KlasseOptionale eigene Klasse am Event-Element für individuelles Styling.
Sortierung / AktivReihenfolge und Sichtbarkeit im Frontend.

Kategorien

Im Tab „Kategorien“ legst du farbige Kategorien an. Jede Kategorie erhält eine Farbe (Colorpicker), die als Badge in allen Ansichten und im Kalender-Pill erscheint.

  • Name – Anzeigename der Kategorie.
  • Farbe – per Farbwähler oder als HEX-Wert.
  • Sortierung – Reihenfolge der Filter-Chips.
  • Aktiv – nur aktive Kategorien erscheinen im Filter.
Löschen ohne DatenverlustWird eine Kategorie gelöscht, bleiben die zugehörigen Events erhalten – sie verlieren lediglich die Kategorie-Zuordnung.

Ansichten im Frontend

AnsichtBeschreibung
MonatKlassischer Kalender mit Monatsnavigation (« / ») und „Heute“-Button. Events erscheinen als farbige Pills am jeweiligen Tag.
ListeChronologische Liste mit Datums-Badge, Uhrzeit, Ort und Kurztext.
KachelnGrid mit Titelbild, Kategorie-Badge und Kurzbeschreibung pro Event.

Besucher wechseln die Ansicht über den Umschalter, filtern nach Kategorie und können – sofern aktiviert – zwischen Kommende und Vergangene Events wechseln.

Detail-Popup & sprechende URLs

Ein Klick auf ein Event öffnet ein animiertes Detail-Popup mit Titelbild, Datum/Zeit, Ort, Beschreibung, Karte, iCal-Button und optionalem externen Link.

Zusätzlich ist jedes Event unter einer sprechenden URL direkt erreichbar:

/paw-events/<slug>

Diese SEO-Seite enthält eigenen Title, Meta-Description, canonical und Open-Graph-Tags – ideal zum Verlinken in Newslettern und sozialen Netzwerken.

Automatischer SlugDer Slug wird aus dem Titel erzeugt (inkl. Umlaut-Umwandlung) und bei Namensgleichheit automatisch eindeutig gemacht (z.B. sommerfest, sommerfest-2).

Karte & Kalender-Export

Karten-Einbettung

Ist eine Adresse hinterlegt und die Karte aktiviert, wird der Ort im Detail als eingebettete Karte angezeigt. Wählbar zwischen OpenStreetMap und Google Maps – jeweils ohne API-Key.

iCal-Export (.ics)

Der Button „Zum Kalender hinzufügen“ liefert eine .ics-Datei über /paw-events/ics?id=<ID>, die sich in Outlook, Apple- und Google-Kalender importieren lässt.

Archiv

Ist der Archiv-Umschalter aktiviert, können Besucher vergangene Veranstaltungen separat aufrufen.

Styling-Editor

Im Tab „Styling“ passt du das Erscheinungsbild komplett ohne Code an. Alle Werte werden als CSS-Variablen ins Frontend ausgegeben und wirken sofort. Eine Live-Vorschau zeigt das Ergebnis direkt neben den Einstellungen.

OptionBeschreibung
Akzentfarbe & Akzentfarbe 2Primärfarbe und Verlaufsfarbe für Buttons, Badges und Datumsboxen.
Button-TextfarbeTextfarbe auf farbigen Buttons.
Karten-HintergrundHintergrundfarbe der Karten/Container.
Text- & Überschrift-FarbeFarben für Fließtext und Titel.
ButtonformEckig, Abgerundet oder Pill (voll rund).
EckenradiusRadius der Karten (0–40 px); bei „Abgerundet“ auch der Buttons.
SchriftartEigene CSS font-family (z.B. Poppins, sans-serif) oder Shop-Standard.
SchattenWeicher Schlagschatten an Karten an/aus.

Einstellungen

EinstellungBeschreibung
Plugin aktivierenSchaltet die Frontend-Ausgabe global an/aus.
Standard-AnsichtVoreingestellte Ansicht (Monat / Liste / Kacheln), wenn das Portlet keine eigene vorgibt.
WochenstartMontag oder Sonntag als erster Tag der Kalenderwoche.
Archiv-UmschalterBlendet die Umschaltung „Kommende / Vergangene“ ein.
Karten-AnbieterOpenStreetMap oder Google Maps (beide ohne API-Key, per iframe).
Karte im Detail anzeigenAktiviert die eingebettete Karte im Detail-Popup.
iCal-Export anzeigenZeigt den Button „Zum Kalender hinzufügen“.

Screenshots

Alle Screenshots findest du auf der Produktseite – dort kannst du sie anklicken und vergrößern.

FAQ

Wo werden die Events angezeigt?

Über das OPC-Portlet „Events (Kalender)“, das du auf jeder OnPage-Composer-Seite frei platzieren kannst. Zusätzlich ist jedes Event unter /paw-events/<slug> als eigene Seite erreichbar.

Benötige ich einen Google-Maps-API-Key?

Nein. Sowohl OpenStreetMap als auch Google Maps werden per iframe eingebettet – ganz ohne API-Key.

Kann ich das Aussehen an mein Shop-Design anpassen?

Ja – im Tab „Styling“ stellst du Farben, Buttonform, Radius, Schriftart und Schatten mit Live-Vorschau ein. Zusätzlich kannst du pro Event eine eigene CSS-Klasse vergeben.

Unterstützt das Plugin ganztägige und mehrtägige Events?

Ja. Aktiviere „Ganztägig“ für Termine ohne Uhrzeit. Für mehrtägige Events gibst du einfach ein Enddatum an.

Wie funktioniert der Kalender-Export?

Jedes Event bietet einen „Zum Kalender hinzufügen“-Button, der eine standardkonforme .ics-Datei liefert (importierbar in Outlook, Apple- und Google-Kalender).

Kann ich mehrere Kalender auf verschiedenen Seiten zeigen?

Ja – das Portlet ist beliebig oft einsetzbar und pro Instanz konfigurierbar (Ansicht, Kategorie-Filter, Limit).

Was passiert mit vergangenen Events?

Standardmäßig werden nur kommende/laufende Events gezeigt. Über den Archiv-Umschalter können Besucher vergangene Veranstaltungen aufrufen.

Ist das Plugin mehrsprachig?

Ja – die Frontend-Beschriftungen werden über Sprachvariablen für Deutsch und Englisch ausgeliefert.