WP Quick Notifications

WP Quick Notifications adds an editor-friendly Notifications post type for scheduled notices and announcements.

It keeps the simple API from the original project while adding:

• optional start dates;
• required expiration dates;
• automatic expiration without a separate post-expirator plugin;
• exact start/expiration WP-Cron events plus an hourly cleanup fallback;
• SpinupWP page-cache purging when a notice starts, changes, or expires;
• browser-side expiration protection for already-cached HTML;
• notice types, priority ordering, optional links, and color overrides;
• [wp_quick_notifications] and [quick_notifications] shortcodes;
• a native Notifications & Announcements Breakdance element.

Requirements

• PHP 8.0+
• WordPress
• Advanced Custom Fields Pro
• Breakdance is optional and only required for the custom element.

Composer installation

Add the repository to the Bedrock project's composer.json:

{
  "repositories": {
    "wp-quick-notifications": {
      "type": "vcs",
      "url": "https://github.com/Nicscott01/wp-quick-notifications"
    }
  }
}

Then install the plugin:

composer require nicscott01/wp-quick-notifications

Activate WP Quick Notifications in WordPress.

Editor workflow

1. Open Notifications in WordPress.
2. Add a title and notice text in the Classic Editor.
3. Choose when it starts and expires.
4. Optionally choose a notice type, priority, link, or color overrides.
5. Publish it.

The notice is visible only while its dates are current. When its expiration time arrives it is hidden immediately, changed to Draft by WP-Cron, and the SpinupWP page cache is purged.

Shortcode

[wp_quick_notifications heading="Announcements" limit="5"]

Supported attributes:

• heading
• limit
• show_body
• show_cta
• hide_parent_when_empty

The legacy helper functions wp_quick_notification(), has_quick_notification(), and get_current_notification() remain available.

Breakdance

When Breakdance is active, insert Notifications & Announcements from the WP Quick Notifications element group. Editors can set the heading, maximum number of notices, body/link visibility, empty-section behavior, spacing, typography, card colors, text alignment, padding, and borders.

License

GPL-2.0-or-later.