WP Manifestindependent plugin directory
manifest / events / event-pulse

Event Pulse

Display a customizable countdown to the next one-time or recurring event.

by Shadrach Odekhiran · github.com/shadrachodek/event-pulse · website

★ 0stars
0forks

Install

No release zip yet. The repository archive installs, but the folder name will carry the branch suffix and updates will not flow:

wp plugin install https://github.com/shadrachodek/event-pulse/archive/refs/heads/main.zip
Readme github.com/shadrachodek/event-pulse ↗

Event Pulse is an open-source WordPress plugin for displaying a live countdown to the next upcoming event. It supports one-time events, weekly recurring events, shortcode output, and a native Gutenberg block.

Author

Current Features

  • Custom Event post type.
  • One-time, weekly recurring, and monthly recurring events.
  • Automatic next-event resolution.
  • Automatic frontend refresh after the displayed event ends.
  • Shortcodes for broad editor compatibility.
  • Dynamic Gutenberg block.
  • Native Elementor widget when Elementor is active.
  • Theme-based display system.
  • CSS variables for customization.
  • Translation-ready strings.

Usage

Create an event from Events > Add New Event, set the start/end times, recurrence, and theme, then add the countdown to a page.

Shortcode:

[event_pulse]

Specific event:

[event_pulse id="123"]

Theme override:

[event_pulse theme="minimal-light"]

Built-In Themes

  • purple-church
  • minimal-light
  • minimal-dark

Architecture

The plugin separates responsibilities into small classes:

  • Admin: WordPress admin UI and persistence.
  • Domain: event data, repositories, and occurrence resolution.
  • Frontend: rendering.
  • Integrations: shortcode and editor integrations.
  • Themes: theme registration.
  • Assets: frontend asset enqueueing.

See docs/ARCHITECTURE.md for contributor guidance.

Roadmap

  • Custom recurrence rules.
  • Theme editor UI.
  • Event categories/calendars.
  • Import/export tools.
  • PHPUnit coverage for recurrence logic.

License

GPL-2.0-or-later.