WP_Block_Pattern_Categories_Registry

13#[AllowDynamicProperties]14final class WP_Block_Pattern_Categories_Registry {15	/**16	 * Registered block pattern categories array.17	 *18	 * @since 5.5.019	 * @var array[]20	 */21	private $registered_categories = array();22 23	/**24	 * Pattern categories registered outside the `init` action.25	 *26	 * @since 6.0.027	 * @var array[]28	 */29	private $registered_categories_outside_init = array();30 31	/**32	 * Container for the main instance of the class.33	 *34	 * @since 5.5.035	 * @var WP_Block_Pattern_Categories_Registry|null36	 */37	private static $instance = null;38 39	/**40	 * Registers a pattern category.41	 *42	 * @since 5.5.043	 *44	 * @param string $category_name       Pattern category name including namespace.45	 * @param array  $category_properties {46	 *     List of properties for the block pattern category.47	 *48	 *     @type string $label Required. A human-readable label for the pattern category.49	 * }50	 * @return bool True if the pattern was registered with success and false otherwise.51	 */52	public function register( $category_name, $category_properties ) {53		if ( ! isset( $category_name ) || ! is_string( $category_name ) ) {54			_doing_it_wrong(55				__METHOD__,56				__( 'Block pattern category name must be a string.' ),57				'5.5.0'58			);59			return false;60		}61 62		$category = array_merge(63			array( 'name' => $category_name ),64			$category_properties65		);66 67		$this->registered_categories[ $category_name ] = $category;68 69		// If the category is registered inside an action other than `init`, store it70		// also to a dedicated array. Used to detect deprecated registrations inside71		// `admin_init` or `current_screen`.72		if ( current_action() && 'init' !== current_action() ) {73			$this->registered_categories_outside_init[ $category_name ] = $category;74		}75 76		return true;77	}78 79	/**80	 * Unregisters a pattern category.81	 *82	 * @since 5.5.083	 *84	 * @param string $category_name Pattern category name including namespace.85	 * @return bool True if the pattern was unregistered with success and false otherwise.86	 */87	public function unregister( $category_name ) {88		if ( ! $this->is_registered( $category_name ) ) {89			_doing_it_wrong(90				__METHOD__,91				/* translators: %s: Block pattern name. */92				sprintf( __( 'Block pattern category "%s" not found.' ), $category_name ),