*/
const BUILDER_GUIDE_URLS = [
'elementor' => 'https://wppopupmaker.com/page-builder-integrations/elementor/',
'bricks' => 'https://wppopupmaker.com/page-builder-integrations/bricks/',
'divi' => 'https://wppopupmaker.com/page-builder-integrations/divi/',
'beaver-builder' => 'https://wppopupmaker.com/page-builder-integrations/beaver-builder/',
'siteorigin' => 'https://wppopupmaker.com/page-builder-integrations/siteorigin/',
'brizy' => 'https://wppopupmaker.com/page-builder-integrations/brizy/',
'visual-composer' => 'https://wppopupmaker.com/page-builder-integrations/visual-composer/',
'etch' => 'https://wppopupmaker.com/page-builder-integrations/etch/',
];
/**
* 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 );
$url = self::GUIDE_URL;
$utm_content = 'multiple-builders';
if ( 1 === count( $builders ) ) {
$slug = $slugs[0];
$url = self::BUILDER_GUIDE_URLS[ $slug ] ?? self::GUIDE_URL;
$utm_content = $slug;
/* 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 %s 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: %s. 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',
'utm_content' => $utm_content,
],
$url
),
'primary' => true,
'external' => true,
],
[
'text' => __( 'Dismiss', 'popup-maker' ),
'type' => 'action',
'action' => 'dismiss',
],
],
];
return $alerts;
}
/**
* Get display details for available builder adapters.
*
* @return array
*/
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;
}
}