route( '/redirects', \WP_REST_Server::READABLE, array( $this, 'list_items' ), $cap ); $this->route( '/redirects', \WP_REST_Server::CREATABLE, array( $this, 'create_item' ), $cap ); $this->route( '/redirects/(?P\d+)', \WP_REST_Server::EDITABLE, array( $this, 'update_item' ), $cap ); $this->route( '/redirects/(?P\d+)', \WP_REST_Server::DELETABLE, array( $this, 'delete_item' ), $cap ); $this->route( '/redirects/test', \WP_REST_Server::CREATABLE, array( $this, 'test' ), $cap ); $this->route( '/redirects/check', \WP_REST_Server::READABLE, array( $this, 'check_chains' ), $cap ); } /** * Collect redirect fields from a request. * * @param \WP_REST_Request $request Request. * @return array */ private function fields( \WP_REST_Request $request ) { $fields = array(); foreach ( array( 'source', 'destination' ) as $key ) { if ( null !== $request->get_param( $key ) ) { $fields[ $key ] = Sanitizer::path_input( $request->get_param( $key ) ); } } if ( null !== $request->get_param( 'status_code' ) ) { $fields['status_code'] = absint( $request->get_param( 'status_code' ) ); } if ( null !== $request->get_param( 'match_mode' ) ) { $fields['match_mode'] = sanitize_key( $this->text_param( $request, 'match_mode' ) ); } if ( null !== $request->get_param( 'enabled' ) ) { $fields['enabled'] = rest_sanitize_boolean( $request->get_param( 'enabled' ) ); } return $fields; } /** * List redirects. * * @param \WP_REST_Request $request Request. * @return \WP_REST_Response */ public function list_items( \WP_REST_Request $request ) { return $this->respond( RedirectRepository::query( array( 'search' => Sanitizer::path_input( $request->get_param( 'search' ) ), 'enabled' => null === $request->get_param( 'enabled' ) ? '' : (string) absint( $request->get_param( 'enabled' ) ), 'origin' => sanitize_key( $this->text_param( $request, 'origin' ) ), 'per_page' => $request->get_param( 'per_page' ), 'page' => $request->get_param( 'page' ), ) ) ); } /** * Create a manual redirect. * * @param \WP_REST_Request $request Request. * @return \WP_REST_Response|\WP_Error */ public function create_item( \WP_REST_Request $request ) { $fields = $this->fields( $request ); $fields['origin'] = 'manual'; $fields['on_conflict'] = 'replace' === $request->get_param( 'on_conflict' ) ? 'replace' : 'error'; return $this->respond( RedirectRepository::create( $fields ) ); } /** * Edit, enable or disable a redirect. * * @param \WP_REST_Request $request Request. * @return \WP_REST_Response|\WP_Error */ public function update_item( \WP_REST_Request $request ) { $result = RedirectRepository::update( absint( $request['id'] ), $this->fields( $request ) ); return $this->respond( is_wp_error( $result ) ? $result : RedirectRepository::get( absint( $request['id'] ) ) ); } /** * Delete a redirect (explicit administrator action; logged). * * @param \WP_REST_Request $request Request. * @return \WP_REST_Response */ public function delete_item( \WP_REST_Request $request ) { return $this->respond( array( 'deleted' => RedirectRepository::delete( absint( $request['id'] ) ) ) ); } /** * Test a URL or a redirect row server-side (never followed in the browser). * * @param \WP_REST_Request $request Request. * @return \WP_REST_Response|\WP_Error */ public function test( \WP_REST_Request $request ) { $url = Sanitizer::path_input( $request->get_param( 'url' ) ); if ( $request->get_param( 'id' ) ) { $redirect = RedirectRepository::get( absint( $request->get_param( 'id' ) ) ); $url = $redirect ? $redirect->source_raw : ''; } if ( '' === $url ) { return new \WP_Error( 'missing_url', __( 'Enter a URL or path to test.', 'slugh' ), array( 'status' => 400 ) ); } return $this->respond( RedirectTester::test_url( $url ) ); } /** * "Check chains and loops" for existing data. * * @return \WP_REST_Response */ public function check_chains() { return $this->respond( LoopDetector::audit_existing() ); } }