WP_REST_Menu_Locations_Controller

17class WP_REST_Menu_Locations_Controller extends WP_REST_Controller {18 19	/**20	 * Menu Locations Constructor.21	 *22	 * @since 5.9.023	 */24	public function __construct() {25		$this->namespace = 'wp/v2';26		$this->rest_base = 'menu-locations';27	}28 29	/**30	 * Registers the routes for the objects of the controller.31	 *32	 * @since 5.9.033	 *34	 * @see register_rest_route()35	 */36	public function register_routes() {37		register_rest_route(38			$this->namespace,39			'/' . $this->rest_base,40			array(41				array(42					'methods'             => WP_REST_Server::READABLE,43					'callback'            => array( $this, 'get_items' ),44					'permission_callback' => array( $this, 'get_items_permissions_check' ),45					'args'                => $this->get_collection_params(),46				),47				'schema' => array( $this, 'get_public_item_schema' ),48			)49		);50 51		register_rest_route(52			$this->namespace,53			'/' . $this->rest_base . '/(?P<location>[\w-]+)',54			array(55				'args'   => array(56					'location' => array(57						'description' => __( 'An alphanumeric identifier for the menu location.' ),58						'type'        => 'string',59					),60				),61				array(62					'methods'             => WP_REST_Server::READABLE,63					'callback'            => array( $this, 'get_item' ),64					'permission_callback' => array( $this, 'get_item_permissions_check' ),65					'args'                => array(66						'context' => $this->get_context_param( array( 'default' => 'view' ) ),67					),68				),69				'schema' => array( $this, 'get_public_item_schema' ),70			)71		);72	}73 74	/**75	 * Checks whether a given request has permission to read menu locations.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, WP_Error object otherwise.81	 */82	public function get_items_permissions_check( $request ) {83		return $this->check_has_read_only_access( $request );84	}85 86	/**87	 * Retrieves all menu locations, depending on user context.88	 *89	 * @since 5.9.090	 *91	 * @param WP_REST_Request $request Full details about the request.92	 * @return WP_REST_Response|WP_Error Response object on success, or WP_Error object on failure.93	 */94	public function get_items( $request ) {95		$data = array();96