Luzid Content Scheduler

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

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

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/).