WP_Block_Templates_Registry

14final class WP_Block_Templates_Registry {15	/**16	 * Registered templates, as `$name => $instance` pairs.17	 *18	 * @since 6.7.019	 * @var WP_Block_Template[] $registered_block_templates Registered templates.20	 */21	private $registered_templates = array();22 23	/**24	 * Container for the main instance of the class.25	 *26	 * @since 6.7.027	 * @var WP_Block_Templates_Registry|null28	 */29	private static $instance = null;30 31	/**32	 * Registers a template.33	 *34	 * @since 6.7.035	 *36	 * @param string $template_name Template name including namespace.37	 * @param array  $args          Optional. Array of template arguments.38	 * @return WP_Block_Template|WP_Error The registered template on success, or WP_Error on failure.39	 */40	public function register( $template_name, $args = array() ) {41 42		$template = null;43 44		$error_message = '';45		$error_code    = '';46 47		if ( ! is_string( $template_name ) ) {48			$error_message = __( 'Template names must be strings.' );49			$error_code    = 'template_name_no_string';50		} elseif ( preg_match( '/[A-Z]+/', $template_name ) ) {51			$error_message = __( 'Template names must not contain uppercase characters.' );52			$error_code    = 'template_name_no_uppercase';53		} elseif ( ! preg_match( '/^[a-z0-9_\-]+\/\/[a-z0-9_\-]+$/', $template_name ) ) {54			$error_message = __( 'Template names must contain a namespace prefix. Example: my-plugin//my-custom-template' );55			$error_code    = 'template_no_prefix';56		} elseif ( $this->is_registered( $template_name ) ) {57			/* translators: %s: Template name. */58			$error_message = sprintf( __( 'Template "%s" is already registered.' ), $template_name );59			$error_code    = 'template_already_registered';60		}61 62		if ( $error_message ) {63			_doing_it_wrong( __METHOD__, $error_message, '6.7.0' );64 65			return new WP_Error( $error_code, $error_message );66		}67 68		if ( ! $template ) {69			$theme_name             = get_stylesheet();70			list( $plugin, $slug )  = explode( '//', $template_name );71			$default_template_types = get_default_block_template_types();72 73			$template              = new WP_Block_Template();74			$template->id          = $theme_name . '//' . $slug;75			$template->theme       = $theme_name;76			$template->plugin      = $plugin;77			$template->author      = null;78			$template->content     = $args['content'] ?? '';79			$template->source      = 'plugin';80			$template->slug        = $slug;81			$template->type        = 'wp_template';82			$template->title       = $args['title'] ?? $template_name;83			$template->description = $args['description'] ?? '';84			$template->status      = 'publish';85			$template->origin      = 'plugin';86			$template->is_custom   = ! isset( $default_template_types[ $template_name ] );87			$template->post_types  = $args['post_types'] ?? array();88		}89 90		$this->registered_templates[ $template_name ] = $template;91 92		return $template;93	}