feat(templates): popup template library with block patterns and editor picker

classes/Controllers/Assets.php

@@ -90,20 +90,29 @@ public function get_packages() {
 				'styles'   => true,
 				'deps'     => [],
 				'varsName' => 'popupMakerBlockEditor',
-				'vars'     => [
-					'cta_types'                  => $this->container->get( 'cta_types' )->get_as_array(),
-					'popups'                     => pum_get_all_popups(),
-					'homeUrl'                    => home_url(),
-					'previewNonce'               => wp_create_nonce( 'popup-preview' ),
-					'popupTriggerExcludedBlocks' => apply_filters(
-						'pum_block_editor_popup_trigger_excluded_blocks',
-						[
-							'core/nextpage',
-							'popup-maker/call-to-action',
-							'popup-maker/call-to-actions',
-						]
-					),
-				],
+				'vars'     => function () {
+					$vars = [
+						'cta_types'                  => $this->container->get( 'cta_types' )->get_as_array(),
+						'popups'                     => pum_get_all_popups(),
+						'homeUrl'                    => home_url(),
+						'previewNonce'               => wp_create_nonce( 'popup-preview' ),
+						'popupTriggerExcludedBlocks' => apply_filters(
+							'pum_block_editor_popup_trigger_excluded_blocks',
+							[
+								'core/nextpage',
+								'popup-maker/call-to-action',
+								'popup-maker/call-to-actions',
+							]
+						),
+					];
+
+					// Template picker data is only needed in the popup editor itself.
+					if ( pum_is_popup_editor() ) {
+						$vars['templateLibrary'] = $this->container->get( 'template_library' )->get_editor_data();
+					}
+
+					return $vars;
+				},
 			],
 			'block-library'       => [
 				'bundled'      => false,
@@ -405,9 +414,9 @@ private function get_layout_vars() {
 		$vars = apply_filters(
 			'popup_maker/layout_vars',
 			[
-				'navTabs'            => [],
-				'supportMenuItems'   => [],
-				'showSupport'        => true,
+				'navTabs'          => [],
+				'supportMenuItems' => [],
+				'showSupport'      => true,
 			]
 		);
 

classes/Controllers/TemplateLibrary.php

@@ -0,0 +1,78 @@
+<?php
+/**
+ * TemplateLibrary controller.
+ *
+ * @package   PopupMaker
+ * @copyright Copyright (c) 2026, Code Atlantic LLC
+ */
+
+namespace PopupMaker\Controllers;
+
+use PopupMaker\Plugin\Controller;
+
+defined( 'ABSPATH' ) || exit;
+
+/**
+ * Registers popup templates as block patterns.
+ *
+ * Templates are collected by the `template_library` service and exposed
+ * two ways: as post-type-scoped block patterns for the native inserter,
+ * and as picker data for the popup editor template modal (localized via
+ * the Assets controller).
+ *
+ * @since X.X.X
+ */
+class TemplateLibrary extends Controller {
+
+	/**
+	 * Initialize the controller.
+	 *
+	 * @return void
+	 */
+	public function init() {
+		// Late enough for Pro (plugins_loaded@12) & addons (@13) to hook the filter.
+		add_action( 'init', [ $this, 'register_block_patterns' ], 15 );
+	}
+
+	/**
+	 * Register pattern categories & popup template patterns.
+	 *
+	 * @return void
+	 */
+	public function register_block_patterns() {
+		if ( ! function_exists( 'register_block_pattern' ) || ! function_exists( 'register_block_pattern_category' ) ) {
+			return;
+		}
+
+		$service = $this->container->get( 'template_library' );
+
+		register_block_pattern_category( 'popup-maker-templates', [
+			'label'       => __( 'Popup Templates', 'popup-maker' ),
+			'description' => __( 'Ready-made popup layouts from Popup Maker.', 'popup-maker' ),
+		] );
+
+		foreach ( $service->get_categories() as $slug => $label ) {
+			register_block_pattern_category( 'popup-maker-' . $slug, [
+				/* translators: %s: Template category label. */
+				'label' => sprintf( _x( 'Popup: %s', 'Block pattern category label', 'popup-maker' ), $label ),
+			] );
+		}
+
+		foreach ( $service->get_templates() as $template ) {
+			if ( ! $service->is_insertable( $template ) ) {
+				continue;
+			}
+
+			register_block_pattern( 'popup-maker/' . $template['slug'], [
+				'title'         => $template['name'],
+				'description'   => $template['description'],
+				'content'       => $template['content'],
+				'categories'    => [ 'popup-maker-templates', 'popup-maker-' . $template['category'] ],
+				'keywords'      => $template['keywords'],
+				'postTypes'     => [ 'popup' ],
+				'viewportWidth' => $template['viewport_width'],
+				'inserter'      => true,
+			] );
+		}
+	}
+}

classes/Plugin/Core.php

@@ -40,16 +40,17 @@ public function __construct( $config ) {
 	 */
 	protected function registered_controllers() {
 		return [
-			'Admin'         => new \PopupMaker\Controllers\Admin( $this ),
-			'Assets'        => new \PopupMaker\Controllers\Assets( $this ),
-			'CallToActions' => new \PopupMaker\Controllers\CallToActions( $this ),
-			'Compatibility' => new \PopupMaker\Controllers\Compatibility( $this ),
-			'Debug'         => new \PopupMaker\Controllers\Debug( $this ),
-			'PostTypes'     => new \PopupMaker\Controllers\PostTypes( $this ),
-			'RestAPI'       => new \PopupMaker\Controllers\RestAPI( $this ),
-			'Upgrades'      => new \PopupMaker\Controllers\Upgrades( $this ),
-			'WP'            => new \PopupMaker\Controllers\WP( $this ),
-			'Frontend'      => new \PopupMaker\Controllers\Frontend( $this ),
+			'Admin'           => new \PopupMaker\Controllers\Admin( $this ),
+			'Assets'          => new \PopupMaker\Controllers\Assets( $this ),
+			'CallToActions'   => new \PopupMaker\Controllers\CallToActions( $this ),
+			'Compatibility'   => new \PopupMaker\Controllers\Compatibility( $this ),
+			'Debug'           => new \PopupMaker\Controllers\Debug( $this ),
+			'PostTypes'       => new \PopupMaker\Controllers\PostTypes( $this ),
+			'RestAPI'         => new \PopupMaker\Controllers\RestAPI( $this ),
+			'TemplateLibrary' => new \PopupMaker\Controllers\TemplateLibrary( $this ),
+			'Upgrades'        => new \PopupMaker\Controllers\Upgrades( $this ),
+			'WP'              => new \PopupMaker\Controllers\WP( $this ),
+			'Frontend'        => new \PopupMaker\Controllers\Frontend( $this ),
 			// 'BlockEditor'            => new \PopupMaker\Controllers\BlockEditor( $this ),
 			// 'Frontend'               => new \PopupMaker\Controllers\Frontend( $this ),
 			// 'Shortcodes'             => new \PopupMaker\Controllers\Shortcodes( $this ),
@@ -280,6 +281,18 @@ function ( $container ) {
 			// }
 		// );
 
+		$this->set(
+			'template_library',
+			/**
+			 * Get popup template library.
+			 *
+			 * @return \PopupMaker\Services\TemplateLibrary
+			 */
+			function ( $container ) {
+				return new \PopupMaker\Services\TemplateLibrary( $container );
+			}
+		);
+
 		$this->set(
 			'globals',
 			/**