Announce complete page builder support in admin

classes/Base/PageBuilder.php

@@ -20,6 +20,20 @@
  */
 abstract class PageBuilder {
 
+	/**
+	 * Stable builder identifier.
+	 *
+	 * @var string
+	 */
+	public $key = '';
+
+	/**
+	 * Builder display label.
+	 *
+	 * @var string
+	 */
+	protected $label = '';
+
 	/**
 	 * Plugin container.
 	 *
@@ -36,6 +50,15 @@ public function __construct( $container ) {
 		$this->container = $container;
 	}
 
+	/**
+	 * Builder display label.
+	 *
+	 * @return string
+	 */
+	public function label() {
+		return $this->label;
+	}
+
 	/**
 	 * Whether the third-party APIs used by this integration exist.
 	 *

classes/Builders/BeaverBuilder.php

@@ -26,6 +26,12 @@
  */
 class BeaverBuilder extends PageBuilder {
 
+	/** @var string */
+	public $key = 'beaver-builder';
+
+	/** @var string */
+	protected $label = 'Beaver Builder';
+
 	/**
 	 * Whether Beaver's native Popup Maker integration is active.
 	 *

classes/Builders/Bricks.php

@@ -35,6 +35,12 @@
  */
 class Bricks extends PageBuilder {
 
+	/** @var string */
+	public $key = 'bricks';
+
+	/** @var string */
+	protected $label = 'Bricks';
+
 	/**
 	 * CSS generated for popup documents and awaiting emission.
 	 *

classes/Builders/Brizy.php

@@ -19,6 +19,12 @@
  */
 class Brizy extends PageBuilder {
 
+	/** @var string */
+	public $key = 'brizy';
+
+	/** @var string */
+	protected $label = 'Brizy';
+
 	/**
 	 * Popup documents already given to Brizy's asset manager.
 	 *

classes/Builders/Divi.php

@@ -26,6 +26,12 @@
  */
 class Divi extends PageBuilder {
 
+	/** @var string */
+	public $key = 'divi';
+
+	/** @var string */
+	protected $label = 'Divi';
+
 	/**
 	 * Whether Divi is active as either a theme or a plugin.
 	 *

classes/Builders/Elementor.php

@@ -20,6 +20,12 @@
  */
 class Elementor extends PageBuilder {
 
+	/** @var string */
+	public $key = 'elementor';
+
+	/** @var string */
+	protected $label = 'Elementor';
+
 	/**
 	 * Whether Elementor's document and rendering APIs are usable.
 	 *

classes/Builders/Etch.php

@@ -22,6 +22,12 @@
  */
 class Etch extends PageBuilder {
 
+	/** @var string */
+	public $key = 'etch';
+
+	/** @var string */
+	protected $label = 'Etch';
+
 	/**
 	 * Marker confirming that Etch successfully saved this document.
 	 *

classes/Builders/SiteOrigin.php

@@ -23,6 +23,12 @@
  */
 class SiteOrigin extends PageBuilder {
 
+	/** @var string */
+	public $key = 'siteorigin';
+
+	/** @var string */
+	protected $label = 'SiteOrigin Page Builder';
+
 	/**
 	 * Whether popup support existed before this provider injected it.
 	 *

classes/Builders/VisualComposer.php

@@ -19,6 +19,12 @@
  */
 class VisualComposer extends PageBuilder {
 
+	/** @var string */
+	public $key = 'visual-composer';
+
+	/** @var string */
+	protected $label = 'Visual Composer';
+
 	/**
 	 * Popup documents already given to Visual Composer's asset queue.
 	 *

classes/Controllers/Builders.php

@@ -183,6 +183,18 @@ public function boot_builders() {
 		}
 	}
 
+	/**
+	 * Get the available builder adapters.
+	 *
+	 * Only builders that passed runtime detection and their adapter's
+	 * availability check are returned. Inactive adapters are not autoloaded.
+	 *
+	 * @return PageBuilder[]
+	 */
+	public function get_available_builders() {
+		return array_values( $this->builders );
+	}
+
 	/**
 	 * Register the shared pipeline once a builder is available.
 	 *

classes/Services/Notifications/Manager.php

@@ -2,8 +2,8 @@
 /**
  * Notifications service — parent orchestrator.
  *
- * Owns the core notification providers (WhatsNew, FeatureAnnouncements)
- * and exposes a filter that lets addons (Pro, Pro+, integrations) plug
+ * Owns the core notification providers and exposes a filter that lets addons
+ * (Pro, Pro+, integrations) plug
  * in their own providers without touching core code.
  *
  * @package   PopupMaker
@@ -167,6 +167,7 @@ public function get_providers() {
 	protected function resolve_providers() {
 		$core = [
 			new WhatsNew( $this->container ),
+			new PageBuilderAnnouncements( $this->container ),
 			new FeatureAnnouncements( $this->container ),
 		];
 

classes/Services/Notifications/PageBuilderAnnouncements.php

@@ -0,0 +1,152 @@
+<?php
+/**
+ * Page builder support announcements.
+ *
+ * @package   PopupMaker
+ * @copyright Copyright (c) 2026, Code Atlantic LLC
+ */
+
+namespace PopupMaker\Services\Notifications;
+
+use PopupMaker\Base\Service;
+use PopupMaker\Base\PageBuilder;
+use PopupMaker\Controllers\Builders;
+
+defined( 'ABSPATH' ) || exit;
+
+/**
+ * Announces complete support for page builders active on the site.
+ *
+ * @since 1.25.0
+ */
+class PageBuilderAnnouncements extends Service implements Provider {
+
+	/**
+	 * Page builder integrations hub.
+	 *
+	 * @var string
+	 */
+	const GUIDE_URL = 'https://wppopupmaker.com/integrations/page-builder-integrations/';
+
+	/**
+	 * Hook into the alert list.
+	 *
+	 * @return void
+	 */
+	public function init() {
+		add_filter( 'pum_alert_list', [ $this, 'register_announcement' ], 14 );
+	}
+
+	/**
+	 * Register one announcement for all supported builders active on the site.
+	 *
+	 * @param mixed $alerts Existing alerts.
+	 *
+	 * @return mixed
+	 */
+	public function register_announcement( $alerts ) {
+		if (
+			! is_array( $alerts ) ||
+			! current_user_can( $this->container->get_permission( 'edit_popups' ) )
+		) {
+			return $alerts;
+		}
+
+		$builders = $this->get_available_builders();
+
+		if ( ! $builders ) {
+			return $alerts;
+		}
+
+		$labels = wp_list_pluck( $builders, 'label' );
+		$slugs  = wp_list_pluck( $builders, 'slug' );
+		$names  = wp_sprintf_l( '%l', $labels );
+
+		if ( 1 === count( $builders ) ) {
+			/* translators: %s: page builder name. */
+			$title   = sprintf( __( 'Full Popup Maker support for %s is here', 'popup-maker' ), $names );
+			$message = sprintf(
+				/* translators: %s: page builder name. */
+				__( 'Design popup content directly in <strong>%s</strong> while Popup Maker handles the popup theme, triggers, targeting, and analytics. Builder styles and interactive elements work in the editor and on your site.', 'popup-maker' ),
+				esc_html( $names )
+			);
+		} else {
+			$title   = __( 'Full Popup Maker support for your page builders is here', 'popup-maker' );
+			$message = sprintf(
+				/* translators: %s: comma-separated list of page builder names. */
+				__( 'Popup Maker now fully supports the builders active on this site: <strong>%s</strong>. Design popup content in each builder while Popup Maker handles the popup theme, triggers, targeting, and analytics.', 'popup-maker' ),
+				esc_html( $names )
+			);
+		}
+
+		$alerts[] = [
+			'code'        => 'pm_feat_page_builder_support_2026_' . implode( '_', $slugs ),
+			'type'        => 'info',
+			'category'    => 'feature',
+			'priority'    => 88,
+			'title'       => $title,
+			'message'     => $message,
+			'subtitle'    => __( 'new in Popup Maker', 'popup-maker' ),
+			'icon'        => 'layout',
+			'dismissible' => true,
+			'actions'     => [
+				[
+					'text'     => __( 'See how it works', 'popup-maker' ),
+					'type'     => 'link',
+					'action'   => '',
+					'href'     => add_query_arg(
+						[
+							'utm_source'   => 'plugin',
+							'utm_medium'   => 'notification',
+							'utm_campaign' => 'page-builder-support',
+						],
+						self::GUIDE_URL
+					),
+					'primary'  => true,
+					'external' => true,
+				],
+				[
+					'text'   => __( 'Dismiss', 'popup-maker' ),
+					'type'   => 'action',
+					'action' => 'dismiss',
+				],
+			],
+		];
+
+		return $alerts;
+	}
+
+	/**
+	 * Get display details for available builder adapters.
+	 *
+	 * @return array<int,array{slug:string,label:string}>
+	 */
+	protected function get_available_builders() {
+		$controller = $this->container->get_controller( 'Builders' );
+
+		if ( ! $controller instanceof Builders ) {
+			return [];
+		}
+
+		$available = [];
+
+		foreach ( $controller->get_available_builders() as $builder ) {
+			if ( ! $builder instanceof PageBuilder || ! is_string( $builder->key ) || '' === $builder->key ) {
+				continue;
+			}
+
+			$label = $builder->label();
+
+			if ( ! is_string( $label ) || '' === $label ) {
+				continue;
+			}
+
+			$available[] = [
+				'slug'  => sanitize_key( $builder->key ),
+				'label' => $label,
+			];
+		}
+
+		return $available;
+	}
+}

docs/notifications-registry.md

@@ -75,6 +75,12 @@ Shared helpers (in `FeatureAnnouncements`):
 - `feature_url( $slug, $campaign )` — `wppopupmaker.com/features/<slug>/` with UTM. Supports nested slugs (`popup-triggers/exit-intent-triggers`).
 - `upgrade_url( $campaign )` — wraps `\PopupMaker\get_upgrade_link()` → `wppopupmaker.com/pricing/` with UTM. Kept for future pricing-direct CTAs; current upsells route to feature pages instead.
 
+#### PageBuilderAnnouncements provider (`classes/Services/Notifications/PageBuilderAnnouncements.php`)
+
+| Code | Category | Condition | Destination | Notes |
+|---|---|---|---|---|
+| `pm_feat_page_builder_support_2026_<builder-slugs>` | `feature` | At least one bundled page builder adapter passed runtime detection and its availability check | `/integrations/page-builder-integrations/` | Consolidates every active supported builder into one announcement with permanent per-user dismissal. The stable builder slug suffix scopes dismissal to the detected set, so installing another supported builder can surface the new capability without loading inactive adapters. |
+
 ### Pro / Pro+ / extensions
 
 | Plugin | Registered alerts | Notes |