About this plugin
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:
-
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.
-
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
2026
medium
2026
long
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”]
2026
Date with time:
[luzid_cs slug=”event” date=”long” time=”auto”]
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=” “]
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=” – “]
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--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-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
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/).