Luzid Content Scheduler

Beskrivelse

Luzid Content Scheduler controls when a specific frontend block is visible — and can also output the next scheduled date(s) via shortcode.

This gives you two complementary ways to use a scheduler:

1. Show / hide a block (banner, alert, section, popup wrapper, …)
   Add the generated CSS class luzid-cs-<slug> to the element. The plugin adds body classes and a tiny frontend helper so the block is only displayed while the schedule is active.

2. Display dates in the frontend
   Use the shortcode to print the next event (or a list of upcoming events) anywhere in your content.

Typical Use Cases

• Maintenance banners: Show a “We’re updating our systems” notice only during scheduled maintenance windows.
• Seasonal content: Display holiday greetings, special offers, or seasonal menus during specific date ranges.
• Event announcements: Print “Next event: Saturday, March 15th at 7 PM” dynamically on any page.
• Recurring schedules: Show “Happy Hour specials” every Friday from 5 PM to 8 PM.
• Multi-stage visibility: Use Event Classes to show a popup 4 days before an event, the full content 2 weeks before, and a menu item 11 days before — all independently controlled.
• Event calendars: Generate a table of all upcoming events across multiple schedulers.

Core Concepts

• A scheduler becomes active when at least one rule matches (single dates/ranges or recurring rules).
• Exceptions override everything: if “now” is inside an exception range, the block is hidden even if other rules match.
• Event Classes (new in 1.4) allow multiple independent visibility windows with different offsets — each generating its own CSS class.
• The shortcode reads the same event logic and outputs formatted dates with full control over separators and formatting.

Features

Scheduling

• Single dates & date ranges: Define specific days or periods when content should be visible.
• Recurring rules: Weekly (every Monday), Monthly (every 15th), Weekday in month (2nd Thursday), Yearly (February 14th).
• Exceptions: Override all rules — content stays hidden during exception periods.
• Event Classes: Create multiple CSS classes per scheduler, each with independent visibility offsets.

Shortcode Output

• Flexible date/time formatting: Choose from short, medium, long, or full date formats.
• Separators: Control exactly what appears between date, time, and text parts.
• Lists: Output multiple upcoming events with customizable separators.
• Event Table: Generate a sortable table of all upcoming events from multiple schedulers.
• Time offset: Shift the displayed time (e.g., “doors open 30 minutes before”).

Administration

• Card-based UI: Clean, modern interface for managing rules.
• Live preview: See upcoming events and visibility windows instantly.
• Bilingual: Full German and English support with one-click language switching.

Usage

Adding CSS Classes to Blocks

• Gutenberg: Select block → “Advanced” → “Additional CSS class(es)” → luzid-cs-<slug>
• Elementor: Widget → “Advanced” → “CSS Classes” → luzid-cs-<slug>
• Divi/others: Module settings → “CSS Class” → luzid-cs-<slug>

Basic Shortcode

[luzid_cs slug="your-scheduler"]

Outputs: The next event date in the default format.

Shortcode Parameters

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

Date Formats

Value
Output Example

short
14.02.2026

medium
Sat, 14.02.2026

long
Saturday, 14.02.2026

full
Saturday, 14 February 2026

Time Formats

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 Examples

Simple date output:
[luzid_cs slug=”maintenance” date=”long”]
→ Saturday, 15.03.2026

Date with time:
[luzid_cs slug=”event” date=”long” time=”auto”]
→ Saturday, 15.03.2026 from 18:00 to 20:00

Only time output:
[luzid_cs slug=”event” time=”raw”]
→ 18:00

Multi-line output:
[luzid_cs slug=”event” date=”long” time=”auto” text=”true” sep1=”
” sep2=”
“]
→ Saturday, 15.03.2026
from 18:00 to 20:00
Valentine’s Dinner

List of next 5 events:
[luzid_cs slug=”concert” date=”long” text=”true” list=”true” count=”5″ sep2=”
” sep3=”

“]

With custom separators:
[luzid_cs slug=”event” date=”long” time=”raw” text=”true” sep1=” | ” sep2=” – “]
→ Saturday, 15.03.2026 | 18:00 – Valentine’s Dinner

Event Table Shortcode

[luzid_cs_eventtable]

Outputs a table of all upcoming events from schedulers with “Include in Event Table” enabled.

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

Available columns:
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

Example with custom columns:
[luzid_cs_eventtable cols=”weekday_short,date_short,time_range,text” count=”10″ headers=”Day,Date,Time,Event”]

Event Classes (New in 1.4)

Event Classes allow you to create multiple independent visibility windows for a single scheduler. Each class has its own CSS class and offset settings.

Example setup:

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

This allows you to control when different elements appear, all based on the same event schedule.

CSS Hooks

Shortcode output:
* .luzid-cs — Wrapper (plus .luzid-cs--single / .luzid-cs--list)
* .luzid-cs-item — Single event in list
* .luzid-cs-date — Date part
* .luzid-cs-time — Time part
* .luzid-cs-text — Event text
* .luzid-cs-sep / .luzid-cs-sep1 / .luzid-cs-sep2 — Separators

Event table:
* .luzid-cs-eventtable — Table wrapper
* .luzid-cs-eventtable__head / __body / __row / __cell

Body classes (for conditional CSS):
* .luzid-cs-active-<slug> — Added when scheduler is active
* .luzid-cs-active-<slug>-<classname> — Added when specific event class is active

License

This plugin is licensed under the GNU General Public License v2.0 or later.

All code in this plugin is GPLv2-or-later compatible.

Assets:
* Luzid Logo and Flag icons are SVG assets shipped with the plugin (assets/img/).