WP_Classic_To_Block_Menu_Converter

15class WP_Classic_To_Block_Menu_Converter {16 17	/**18	 * Converts a Classic Menu to blocks.19	 *20	 * @since 6.3.021	 *22	 * @param WP_Term $menu The Menu term object of the menu to convert.23	 * @return string|WP_Error The serialized and normalized parsed blocks on success,24	 *                         an empty string when there are no menus to convert,25	 *                         or WP_Error on invalid menu.26	 */27	public static function convert( $menu ) {28 29		if ( ! is_nav_menu( $menu ) ) {30			return new WP_Error(31				'invalid_menu',32				__( 'The menu provided is not a valid menu.' )33			);34		}35 36		$menu_items = wp_get_nav_menu_items( $menu->term_id, array( 'update_post_term_cache' => false ) );37 38		if ( empty( $menu_items ) ) {39			return '';40		}41 42		// Set up the $menu_item variables.43		// Adds the class property classes for the current context, if applicable.44		_wp_menu_item_classes_by_context( $menu_items );45 46		$menu_items_by_parent_id = static::group_by_parent_id( $menu_items );47 48		$first_menu_item = isset( $menu_items_by_parent_id[0] )49			? $menu_items_by_parent_id[0]50			: array();51 52		$inner_blocks = static::to_blocks(53			$first_menu_item,54			$menu_items_by_parent_id55		);56 57		return serialize_blocks( $inner_blocks );58	}59 60	/**61	 * Returns an array of menu items grouped by the id of the parent menu item.62	 *63	 * @since 6.3.064	 *65	 * @param array $menu_items An array of menu items.66	 * @return array67	 */68	private static function group_by_parent_id( $menu_items ) {69		$menu_items_by_parent_id = array();70 71		foreach ( $menu_items as $menu_item ) {72			$menu_items_by_parent_id[ $menu_item->menu_item_parent ][] = $menu_item;73		}74 75		return $menu_items_by_parent_id;76	}77 78	/**79	 * Turns menu item data into a nested array of parsed blocks80	 *81	 * @since 6.3.082	 *83	 * @param array $menu_items              An array of menu items that represent84	 *                                       an individual level of a menu.85	 * @param array $menu_items_by_parent_id An array keyed by the id of the86	 *                                       parent menu where each element is an87	 *                                       array of menu items that belong to88	 *                                       that parent.89	 * @return array An array of parsed block data.90	 */91	private static function to_blocks( $menu_items, $menu_items_by_parent_id ) {92 93		if ( empty( $menu_items ) ) {94			return array();