Timed Event Block

Description

Timed Event Block adds a server-rendered parent block for scheduling event content by date/time, plus dedicated child blocks for dynamic date, time, and countdown output.

Ideal for event listings such as movie showtimes, class schedules, workshops, conferences, livestreams, and similar use cases. It requires no global configuration: install the plugin and start using the block directly in FSE workflows.

This plugin is designed for full site editing workflows where content creators need:

• A single event container that can hold any core block (text, media, embeds, columns, groups, etc.).
• Automatic status handling based on current server time:
• Scheduled
• Active
• Ended
• Optional automatic hiding of ended events (Hide when ended).
• Child blocks that can be used only inside the Timed Event parent:
• Event Date
• Event Time
• Event Countdown
• Dynamic frontend updates for status/time/countdown without page refresh.
• Native Gutenberg style controls (spacing, color, typography, border, dimensions) on parent and child blocks.

How it works:

1. Add a Timed Event block.
2. Set start date/time and duration.
3. Insert any content you want.
4. Optionally insert child blocks:

* Event Date for date display with site/custom format.
* Event Time for scheduled time and active/ended label transitions.
* Event Countdown for countdown to start/end and status transitions.
5. Publish. Frontend output is resolved server-side, and dynamic text updates via lightweight view scripts.

Blocks

Timed Event

Parent container block that controls event lifecycle and visibility.

Features:
* Start date and time.
* Duration in minutes.
* Hide when ended toggle.
* Full inner content flexibility.

Event Date

Child block (ancestor-restricted to Timed Event) that reads parent context and renders formatted date.

Features:
* Site default format or custom format string.
* Uses WordPress timezone and date settings by default.

Event Time

Child block that reads parent context and renders:
* Scheduled state: formatted time.
* Active state: configurable active label.
* Ended state: configurable ended label.

Features:
* Site/custom time format.
* Editable active/ended labels.
* Editable active/ended colors.
* Dynamic frontend state update.

Event Countdown

Child block that reads parent context and renders:
* Countdown to start or countdown to end.
* Active/ended label after countdown completion.

Features:
* Target mode: to_start or to_end.
* Day visibility toggle.
* Custom separator.
* Editable active/ended labels.
* Editable active/ended colors.
* Dynamic frontend state update.