WP_Navigation_Fallback

17class WP_Navigation_Fallback {18 19	/**20	 * Updates the wp_navigation custom post type schema, in order to expose21	 * additional fields in the embeddable links of WP_REST_Navigation_Fallback_Controller.22	 *23	 * The Navigation Fallback endpoint may embed the full Navigation Menu object24	 * into the response as the `self` link. By default, the Posts Controller25	 * will only expose a limited subset of fields but the editor requires26	 * additional fields to be available in order to utilize the menu.27	 *28	 * Used with the `rest_wp_navigation_item_schema` hook.29	 *30	 * @since 6.4.031	 *32	 * @param array $schema The schema for the `wp_navigation` post.33	 * @return array The modified schema.34	 */35	public static function update_wp_navigation_post_schema( $schema ) {36		// Expose top level fields.37		$schema['properties']['status']['context']  = array_merge( $schema['properties']['status']['context'], array( 'embed' ) );38		$schema['properties']['content']['context'] = array_merge( $schema['properties']['content']['context'], array( 'embed' ) );39 40		/*41		 * Exposes sub properties of content field.42		 * These sub properties aren't exposed by the posts controller by default,43		 * for requests where context is `embed`.44		 *45		 * @see WP_REST_Posts_Controller::get_item_schema()46		 */47		$schema['properties']['content']['properties']['raw']['context']           = array_merge( $schema['properties']['content']['properties']['raw']['context'], array( 'embed' ) );48		$schema['properties']['content']['properties']['rendered']['context']      = array_merge( $schema['properties']['content']['properties']['rendered']['context'], array( 'embed' ) );49		$schema['properties']['content']['properties']['block_version']['context'] = array_merge( $schema['properties']['content']['properties']['block_version']['context'], array( 'embed' ) );50 51		/*52		 * Exposes sub properties of title field.53		 * These sub properties aren't exposed by the posts controller by default,54		 * for requests where context is `embed`.55		 *56		 * @see WP_REST_Posts_Controller::get_item_schema()57		 */58		$schema['properties']['title']['properties']['raw']['context'] = array_merge( $schema['properties']['title']['properties']['raw']['context'], array( 'embed' ) );59 60		return $schema;61	}62 63	/**64	 * Gets (and/or creates) an appropriate fallback Navigation Menu.65	 *66	 * @since 6.3.067	 *68	 * @return WP_Post|null the fallback Navigation Post or null.69	 */70	public static function get_fallback() {71		/**72		 * Filters whether or not a fallback should be created.73		 *74		 * @since 6.3.075		 *76		 * @param bool $create Whether to create a fallback navigation menu. Default true.77		 */78		$should_create_fallback = apply_filters( 'wp_navigation_should_create_fallback', true );79 80		$fallback = static::get_most_recently_published_navigation();81 82		if ( $fallback || ! $should_create_fallback ) {83			return $fallback;84		}85 86		$fallback = static::create_classic_menu_fallback();87 88		if ( $fallback && ! is_wp_error( $fallback ) ) {89			// Return the newly created fallback post object which will now be the most recently created navigation menu.90			return $fallback instanceof WP_Post ? $fallback : static::get_most_recently_published_navigation();91		}92 93		$fallback = static::create_default_fallback();94 95		if ( $fallback && ! is_wp_error( $fallback ) ) {96			// Return the newly created fallback post object which will now be the most recently created navigation menu.