WP_REST_Menu_Items_Controller

17class WP_REST_Menu_Items_Controller extends WP_REST_Posts_Controller {18 19	/**20	 * Gets the nav menu item, if the ID is valid.21	 *22	 * @since 5.9.023	 *24	 * @param int $id Supplied ID.25	 * @return object|WP_Error Post object if ID is valid, WP_Error otherwise.26	 */27	protected function get_nav_menu_item( $id ) {28		$post = $this->get_post( $id );29		if ( is_wp_error( $post ) ) {30			return $post;31		}32 33		return wp_setup_nav_menu_item( $post );34	}35 36	/**37	 * Checks if a given request has access to read menu items.38	 *39	 * @since 5.9.040	 *41	 * @param WP_REST_Request $request Full details about the request.42	 * @return true|WP_Error True if the request has read access, WP_Error object otherwise.43	 */44	public function get_items_permissions_check( $request ) {45		$has_permission = parent::get_items_permissions_check( $request );46 47		if ( true !== $has_permission ) {48			return $has_permission;49		}50 51		return $this->check_has_read_only_access( $request );52	}53 54	/**55	 * Checks if a given request has access to read a menu item if they have access to edit them.56	 *57	 * @since 5.9.058	 *59	 * @param WP_REST_Request $request Full details about the request.60	 * @return bool|WP_Error True if the request has read access for the item, WP_Error object or false otherwise.61	 */62	public function get_item_permissions_check( $request ) {63		$permission_check = parent::get_item_permissions_check( $request );64 65		if ( true !== $permission_check ) {66			return $permission_check;67		}68 69		return $this->check_has_read_only_access( $request );70	}71 72	/**73	 * Checks whether the current user has read permission for the endpoint.74	 *75	 * This allows for any user that can `edit_theme_options` or edit any REST API available post type.76	 *77	 * @since 5.9.078	 *79	 * @param WP_REST_Request $request Full details about the request.80	 * @return true|WP_Error True if the request has read access for the item, WP_Error object otherwise.81	 */82	protected function check_has_read_only_access( $request ) {83		/**84		 * Filters whether the current user has read access to menu items via the REST API.85		 *86		 * @since 6.8.087		 *88		 * @param bool               $read_only_access Whether the current user has read access to menu items89		 *                                             via the REST API.90		 * @param WP_REST_Request    $request          Full details about the request.91		 * @param WP_REST_Controller $this             The current instance of the controller.92		 */93		$read_only_access = apply_filters( 'rest_menu_read_access', false, $request, $this );94		if ( $read_only_access ) {95			return true;96		}