Added functionality and framework to allow block patterns to be registered within a theme and initial content provided. This will ensure that patterns referenced by slug in template files will be replicated on all environments.

Author: ben-leonard

includes/class-helpers.php

@@ -106,4 +106,34 @@ public static function get_all_theme_names(): array {
 
 		return $names;
 	}
+
+	/**
+	 * Creates a block pattern if it doesn't already exist.
+	 *
+	 * @param string $slug    The slug for the block pattern.
+	 * @param string $name    The name/title for the block pattern.
+	 * @param string $content The HTML content for the block pattern.
+	 *
+	 * @return void
+	 */
+	public static function make_pattern( string $slug, string $name, string $content ): void {
+		// Check if a block pattern with this slug already exists.
+		$existing_pattern = get_page_by_path( $slug, OBJECT, 'wp_block' );
+
+		// If pattern exists, exit early.
+		if ( $existing_pattern ) {
+			return;
+		}
+
+		// Create the new block pattern.
+		wp_insert_post(
+			array(
+				'post_title'   => $name,
+				'post_name'    => $slug,
+				'post_content' => $content,
+				'post_status'  => 'publish',
+				'post_type'    => 'wp_block',
+			)
+		);
+	}
 }

theme-template/functions.php

@@ -26,6 +26,9 @@
 // Load and initialize blocks.
 require_once __DIR__ . '/blocks/all.php';
 
+// Register any patterns that are referenced by slug in template files.
+require_once __DIR__ . '/includes/register-patterns.php';
+
 // Register any scripts needed.
 require_once __DIR__ . '/includes/register-scripts.php';
 

theme-template/includes/register-patterns.php

@@ -0,0 +1,14 @@
+<?php
+/**
+ * File for registering any patterns that are referenced by slug in template files.
+ *
+ * @package :THEME_LABEL
+ * @creode-wordpress-theme-version :THEME_PLUGIN_VERSION
+ */
+
+use Creode_Theme\Helpers;
+
+/**
+ * Example: Create a pattern by calling Helpers::make_pattern() with slug, name, and content.
+ * Helpers::make_pattern( 'teaser', 'Teaser', '<!-- wp:acf/teaser {"name":"acf/teaser","data":[],"mode":"preview"} --><!-- /wp:acf/teaser -->' );
+ */