Luzid Content Scheduler

Luzid Content Scheduler steuert, wann ein bestimmter Frontend-Block sichtbar ist – und kann auch das/die nächste(n) geplante(n) Datum/Daten per Shortcode ausgeben.

Das gibt dir zwei sich ergänzende Möglichkeiten, einen Scheduler zu nutzen:

1. Block ein-/ausblenden (Banner, Alert, Abschnitt, Popup-Wrapper, …) Füge die generierte CSS-Klasse luzid-cs-<slug> zum Element hinzu. Das Plugin fügt Body-Klassen und einen kleinen Frontend-Helper hinzu, sodass der Block nur angezeigt wird, solange der Zeitplan aktiv ist.

2. Datum im Frontend anzeigen Verwende den Shortcode, um das nächste Event (oder eine Liste kommender Events) überall in deinem Content auszugeben.

Typische Anwendungsfälle

• Wartungs-Banner: Zeige einen „Wir aktualisieren unsere Systeme“-Hinweis nur während geplanter Wartungsfenster.
• Saisonaler Content: Zeige Feiertagsgrüße, Sonderangebote oder saisonale Menüs während bestimmter Zeiträume.
• Event-Ankündigungen: Gib „Nächstes Event: Samstag, 15. März um 19:00 Uhr“ dynamisch auf jeder Seite aus.
• Wiederkehrende Zeitpläne: Zeige „Happy Hour Angebote“ jeden Freitag von 17:00 bis 20:00 Uhr.
• Mehrstufige Sichtbarkeit: Nutze Event-Klassen, um ein Popup 4 Tage vor einem Event, den vollständigen Content 2 Wochen vorher und einen Menüeintrag 11 Tage vorher anzuzeigen – alle unabhängig voneinander gesteuert.
• Event-Kalender: Erzeuge eine Tabelle aller kommenden Events aus mehreren Schedulern.

Kernkonzepte

• Ein Scheduler wird aktiv, wenn mindestens eine Regel zutrifft (einzelne Termine/Zeiträume oder Wiederholungsregeln).
• Ausnahmen überschreiben alles: Wenn „jetzt“ in einem Ausnahme-Zeitraum liegt, wird der Block versteckt, auch wenn andere Regeln zutreffen.
• Event-Klassen (neu in 1.4) ermöglichen mehrere unabhängige Sichtbarkeitsfenster mit unterschiedlichen Offsets – jedes erzeugt seine eigene CSS-Klasse.
• Der Shortcode nutzt dieselbe Event-Logik und gibt formatierte Daten mit voller Kontrolle über Trennzeichen und Formatierung aus.

Funktionen

Zeitplanung

• Einzelne Termine & Zeiträume: Definiere bestimmte Tage oder Zeiträume, an denen Content sichtbar sein soll.
• Wiederholungsregeln: Wöchentlich (jeden Montag), Monatlich (jeden 15.), Wochentag im Monat (2. Donnerstag), Jährlich (14. Februar).
• Ausnahmen: Überschreiben alle Regeln – Content bleibt während Ausnahme-Zeiträumen versteckt.
• Event-Klassen: Erstelle mehrere CSS-Klassen pro Scheduler, jede mit unabhängigen Sichtbarkeits-Offsets.

Shortcode-Ausgabe

• Flexible Datum/Uhrzeit-Formatierung: Wähle zwischen kurzen, mittleren, langen oder vollständigen Datumsformaten.
• Trennzeichen: Steuere genau, was zwischen Datum, Uhrzeit und Text erscheint.
• Listen: Gib mehrere kommende Events mit anpassbaren Trennzeichen aus.
• Event-Tabelle: Erzeuge eine sortierbare Tabelle aller kommenden Events aus mehreren Schedulern.
• Zeitverschiebung: Verschiebe die angezeigte Uhrzeit (z.B. „Einlass 30 Minuten vorher“).

Administration

• Karten-basierte UI: Saubere, moderne Oberfläche zur Regelverwaltung.
• Live-Vorschau: Sieh kommende Events und Sichtbarkeitsfenster sofort.
• Zweisprachig: Volle deutsche und englische Unterstützung mit Ein-Klick-Sprachwechsel.

Nutzung

CSS-Klassen zu Blöcken hinzufügen

• Gutenberg: Block auswählen → „Erweitert“ → „Zusätzliche CSS-Klasse(n)“ → luzid-cs-<slug>
• Elementor: Widget → „Erweitert“ → „CSS-Klassen“ → luzid-cs-<slug>
• Divi/andere: Modul-Einstellungen → „CSS-Klasse“ → luzid-cs-<slug>

Basis-Shortcode

Ausgabe: Das nächste Event-Datum im Standard-Format.

Shortcode-Parameter

Parameter Default Description

slug (required) Scheduler slug

date (empty) Date format: short, medium, long, full

time (empty) Time format: auto, raw, prefix, range, range_long

list false Output as list: true or false

count 10 Number of events for lists (max 200)

text false Include event text: true or false

sep1 (space) Separator between date and time

sep2 (space) Separator between time and text

sep3 (empty) Separator between list items

timeoffset 0 Time offset in minutes (can be negative)

lang (current) Force language: de or en

Datums-Formate

Value Output Example

short 14.02.2026

medium Sat, 14.02.2026

long Saturday, 14.02.2026

full Saturday, 14 February 2026

Zeit-Formate

Value Output Example

(empty) No time output

raw 18:00

prefix from 18:00

range 18:00 to 20:00

range_long from 18:00 to 20:00

auto Intelligent format based on data

Shortcode-Beispiele

Einfache Datums-Ausgabe: [luzid_cs slug=“wartung“ date=“long“] → Samstag, 15.03.2026

Datum mit Uhrzeit: [luzid_cs slug=“event“ date=“long“ time=“auto“] → Samstag, 15.03.2026 von 18:00 bis 20:00 Uhr

Nur Uhrzeit-Ausgabe: [luzid_cs slug=“event“ time=“raw“] → 18:00

Mehrzeilige Ausgabe: [luzid_cs slug=“event“ date=“long“ time=“auto“ text=“true“ sep1=““ sep2=“„] → Samstag, 15.03.2026 von 18:00 bis 20:00 Uhr Valentins-Dinner

Liste der nächsten 5 Events: [luzid_cs slug=“konzert“ date=“long“ text=“true“ list=“true“ count=“5″ sep2=““ sep3=“

„]

Mit eigenen Trennzeichen: [luzid_cs slug=“event“ date=“long“ time=“raw“ text=“true“ sep1=“ | “ sep2=“ – „] → Samstag, 15.03.2026 | 18:00 – Valentins-Dinner

Event-Tabellen-Shortcode

Gibt eine Tabelle aller kommenden Events aus Schedulern mit aktiviertem „In Event-Tabelle einbeziehen“ aus.

Parameter Default Description

cols date_medium,time_auto,text Columns (comma-separated)

count 30 Maximum number of events

headers (automatic) Custom column headers

noheaders false Hide table headers

class (empty) Additional CSS class

empty „No events“ Text when no events found

order asc Sort order: asc or desc

Verfügbare Spalten: date_short, date_medium, date_long, date_full, weekday_short, weekday_long, time_raw, time_auto, time_prefix, time_range, time_range_long, text, scheduler

Beispiel mit eigenen Spalten: [luzid_cs_eventtable cols=“weekday_short,date_short,time_range,text“ count=“10″ headers=“Tag,Datum,Uhrzeit,Event“]

Event-Klassen (Neu in 1.4)

Event-Klassen ermöglichen dir, mehrere unabhängige Sichtbarkeitsfenster für einen einzelnen Scheduler zu erstellen. Jede Klasse hat ihre eigene CSS-Klasse und Offset-Einstellungen.

Beispiel-Konfiguration:

Class CSS Class Days Before Use Case

Standard .luzid-cs-dinner 14 Main content

popup .luzid-cs-dinner-popup 4 Announcement popup

menu .luzid-cs-dinner-menu 11 Navigation menu item

So kannst du steuern, wann verschiedene Elemente erscheinen – alle basierend auf demselben Event-Zeitplan.

CSS-Hooks

Shortcode-Ausgabe: * .luzid-cs — Wrapper (plus .luzid-cs--single / .luzid-cs--list) * .luzid-cs-item — Einzelnes Event in Liste * .luzid-cs-date — Datums-Teil * .luzid-cs-time — Zeit-Teil * .luzid-cs-text — Event-Text * .luzid-cs-sep / .luzid-cs-sep1 / .luzid-cs-sep2 — Trennzeichen

Event-Tabelle: * .luzid-cs-eventtable — Tabellen-Wrapper * .luzid-cs-eventtable__head / __body / __row / __cell

Body-Klassen (für bedingtes CSS): * .luzid-cs-active-<slug> — Hinzugefügt wenn Scheduler aktiv ist * .luzid-cs-active-<slug>-<classname> — Hinzugefügt wenn bestimmte Event-Klasse aktiv ist

Lizenz

Dieses Plugin ist lizenziert unter der GNU General Public License v2.0 oder später.

Der gesamte Code in diesem Plugin ist GPLv2-or-later kompatibel.

Assets: * Luzid Logo und Flaggen-Icons sind SVG-Assets, die mit dem Plugin ausgeliefert werden (assets/img/).