Skip to content

Releases: ehstbr/Wordpress-Custom-Popup-Alert

Release list

v1.5.1

v1.5.1 Latest
Latest

Choose a tag to compare

View all tags
@ehstbr ehstbr released this 20 Sep 13:39
v1.5.1
70cd001
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.

WordPress Custom Popup Alert v1.5.1

🎉 First public release of WordPress Custom Popup Alert!

WordPress Custom Popup Alert (WCCPA) is a lightweight and flexible WordPress plugin for displaying context-aware notices, messages and alerts based on configurable rules.

Instead of showing the same popup everywhere, WCCPA lets you decide what to show, where to show it and how often it should appear.

WooCommerce integration is included, but remains completely optional.

✨ Highlights

  • Advanced AND / OR display rules, including nested groups

  • WordPress and WooCommerce conditions

  • Specific posts, pages and products

  • Categories and tags

  • WooCommerce shipping classes

  • Product stock, sale status, type and SKU

  • Cart and Checkout page conditions

  • Priority-based alert queue

  • Exclusive alerts that can suppress lower-priority messages

  • Display frequency controls:

    • Always
    • Once per session
    • Every X days
    • Never show again

  • Optional scheduling and validity periods

  • Automatic closing

  • Optional pause while hovering over the popup

  • Five countdown presentation modes

  • Configurable overlay, dimensions, borders, shadows and header

  • Entry and exit animations

  • Optional action buttons

  • Responsive and keyboard-accessible modal

  • Live previews in the WordPress administration

  • Traditional WordPress Visual/Text editor with Media Library support

  • Brazilian Portuguese translation included

  • Translation-ready architecture

  • WooCommerce remains an optional integration

⏱️ Countdown modes

Automatic closing can optionally be represented using:

  1. No visible countdown
  2. Discreet footer text
  3. Bottom progress bar
  4. Circular progress around the close button
  5. Remaining seconds displayed inside close-action buttons

The timer can also pause while the mouse pointer is over the popup and resume from the exact remaining time.

🛒 WooCommerce

When WooCommerce is active, additional contextual rules become available for products and store pages.

For example:

Product category = Batteries
AND
Shipping class = Local

This can be used to display a delivery restriction only for products where that information is actually relevant.

If WooCommerce is disabled, WordPress-only alerts continue to work normally.

⚡ Performance and privacy

WCCPA was designed to remain lightweight.

Popup assets are only loaded when an alert may actually be displayed, and visitor frequency control is handled using browser storage instead of PHP sessions or visitor databases.

The plugin does not send visitor information to external services.

♿ Accessibility

The frontend modal includes:

  • proper dialog semantics
  • keyboard navigation
  • focus trapping
  • focus restoration
  • optional ESC closing
  • page scroll locking
  • support for prefers-reduced-motion

🛠️ What's new in v1.5.1

This release also fixes a fatal error that could occur when opening the Add New Alert or Edit Alert screen due to an unavailable conditional-attribute helper.

📋 Requirements

  • WordPress 6.2 or newer
  • PHP 7.4 or newer
  • WooCommerce is optional

📦 Installation

Download the release ZIP and install it through:

WordPress → Plugins → Add New Plugin → Upload Plugin

After activation, open Popup Alerts → Add New to create your first contextual alert.

This is the first public GitHub release of the project. Feedback, bug reports, feature suggestions and pull requests are welcome! 🚀

Assets 3
Loading