Luzid Content Scheduler

Description

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