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(64				__METHOD__,65				$error_message,66				'6.7.0'67			);68			return new WP_Error( $error_code, $error_message );69		}70 71		if ( ! $template ) {72			$theme_name             = get_stylesheet();73			list( $plugin, $slug )  = explode( '//', $template_name );74			$default_template_types = get_default_block_template_types();75 76			$template              = new WP_Block_Template();77			$template->id          = $theme_name . '//' . $slug;78			$template->theme       = $theme_name;79			$template->plugin      = $plugin;80			$template->author      = null;81			$template->content     = isset( $args['content'] ) ? $args['content'] : '';82			$template->source      = 'plugin';83			$template->slug        = $slug;84			$template->type        = 'wp_template';85			$template->title       = isset( $args['title'] ) ? $args['title'] : $template_name;86			$template->description = isset( $args['description'] ) ? $args['description'] : '';87			$template->status      = 'publish';88			$template->origin      = 'plugin';89			$template->is_custom   = ! isset( $default_template_types[ $template_name ] );90			$template->post_types  = isset( $args['post_types'] ) ? $args['post_types'] : array();91		}92 93		$this->registered_templates[ $template_name ] = $template;