sessions = $sessions; $this->candidates = $candidates; $this->service = $service; $this->queue = $queue; $this->reminders = $reminders; $this->importer = $importer; } /** * {@inheritdoc} */ public function register_routes(): void { $permission = Permissions::manage(); $ids = array( 'id' => $this->id_arg(), 'candidate_id' => $this->id_arg(), ); $base = '/admin/sessions/(?P\d+)/candidates'; register_rest_route( $this->namespace, $base, array( array( 'methods' => WP_REST_Server::READABLE, 'callback' => array( $this, 'index' ), 'permission_callback' => $permission, 'args' => array_merge( array( 'id' => $this->id_arg() ), $this->list_params( array( 'queue_order', 'id' ), 'queue_order' ), array( 'status' => array( 'type' => 'string', 'enum' => Rules::candidate_statuses(), 'validate_callback' => 'rest_validate_request_arg', ), ) ), ), array( 'methods' => WP_REST_Server::CREATABLE, 'callback' => array( $this, 'create' ), 'permission_callback' => $permission, 'args' => array_merge( array( 'id' => $this->id_arg() ), $this->candidate_args() ), ), ) ); register_rest_route( $this->namespace, $base . '/(?P\d+)', array( array( 'methods' => WP_REST_Server::READABLE, 'callback' => array( $this, 'show' ), 'permission_callback' => $permission, 'args' => $ids, ), array( 'methods' => WP_REST_Server::EDITABLE, 'callback' => array( $this, 'update' ), 'permission_callback' => $permission, 'args' => array_merge( $ids, $this->candidate_args() ), ), array( 'methods' => WP_REST_Server::DELETABLE, 'callback' => array( $this, 'delete' ), 'permission_callback' => $permission, 'args' => $ids, ), ) ); register_rest_route( $this->namespace, $base . '/(?P\d+)/action', array( 'methods' => WP_REST_Server::CREATABLE, 'callback' => array( $this, 'action' ), 'permission_callback' => $permission, 'args' => array_merge( $ids, array( 'action' => array( 'type' => 'string', 'required' => true, 'enum' => Rules::candidate_actions(), 'validate_callback' => 'rest_validate_request_arg', ), ) ), ) ); register_rest_route( $this->namespace, $base . '/(?P\d+)/resend-join', array( 'methods' => WP_REST_Server::CREATABLE, 'callback' => array( $this, 'resend_join' ), 'permission_callback' => $permission, 'args' => $ids, ) ); register_rest_route( $this->namespace, '/admin/sessions/(?P\d+)/import', array( 'methods' => WP_REST_Server::CREATABLE, 'callback' => array( $this, 'import' ), 'permission_callback' => $permission, 'args' => array( 'id' => $this->id_arg() ), ) ); } /** * Request arguments of a candidate body. Types are strict so an array can never reach a string field. * * @return array> */ private function candidate_args(): array { $string = static function ( int $max ): array { return array( 'type' => 'string', 'maxLength' => $max, 'validate_callback' => 'rest_validate_request_arg', ); }; return array( 'name' => $string( 190 ), 'email' => $string( 190 ), 'phone' => $string( 30 ), 'report_time' => $string( 8 ), ); } /** * Loads the session of the URL. * * @param WP_REST_Request $request Request. * @return object|\WP_Error */ private function session( WP_REST_Request $request ) { $session = $this->sessions->find( $this->path_id( $request ) ); return $session ? $session : $this->error( 'session_missing', __( 'Session not found.', 'interviewnea' ), 404 ); } /** * Loads a candidate and checks it belongs to the session of the URL. * * @param WP_REST_Request $request Request. * @param object $session Session. * @return object|\WP_Error */ private function candidate( WP_REST_Request $request, $session ) { $candidate = $this->candidates->find( $this->path_id( $request, 'candidate_id' ) ); if ( ! $candidate || (int) $candidate->session_id !== (int) $session->id ) { return $this->error( 'candidate_missing', __( 'Candidate not found in this session.', 'interviewnea' ), 404 ); } return $candidate; } /** * GET /admin/sessions/{id}/candidates * * @since 0.1.0 * * @param WP_REST_Request $request Request. * @return \WP_REST_Response|\WP_Error */ public function index( WP_REST_Request $request ) { $session = $this->session( $request ); if ( is_wp_error( $session ) ) { return $session; } $page = $this->candidates->query( (int) $session->id, array( 'page' => $request->get_param( 'page' ), 'per_page' => $request->get_param( 'per_page' ), 'search' => $request->get_param( 'search' ), 'status' => $request->get_param( 'status' ), ) ); $rows = array(); $counts = $this->candidates->status_counts( (int) $session->id ); foreach ( $page['items'] as $candidate ) { $rows[] = $this->service->present( $candidate, $session ); } $response = $this->collection_response( $rows, $page['total'], $request ); $response->header( 'X-InterviewNea-Status-Counts', wp_json_encode( $counts ) ); return $response; } /** * GET /admin/sessions/{id}/candidates/{candidate_id} * * @since 0.1.0 * * @param WP_REST_Request $request Request. * @return \WP_REST_Response|\WP_Error */ public function show( WP_REST_Request $request ) { $session = $this->session( $request ); if ( is_wp_error( $session ) ) { return $session; } $candidate = $this->candidate( $request, $session ); return is_wp_error( $candidate ) ? $candidate : rest_ensure_response( $this->service->present( $candidate, $session ) ); } /** * POST /admin/sessions/{id}/candidates * * @since 0.1.0 * * @param WP_REST_Request $request Request. * @return \WP_REST_Response|\WP_Error */ public function create( WP_REST_Request $request ) { $result = $this->service->save( $this->path_id( $request ), $this->request_body( $request ) ); return is_wp_error( $result ) ? $result : new \WP_REST_Response( $result, 201 ); } /** * POST|PUT|PATCH /admin/sessions/{id}/candidates/{candidate_id} * * @since 0.1.0 * * @param WP_REST_Request $request Request. * @return \WP_REST_Response|\WP_Error */ public function update( WP_REST_Request $request ) { $session = $this->session( $request ); if ( is_wp_error( $session ) ) { return $session; } return $this->respond( $this->service->save( (int) $session->id, $this->request_body( $request ), $this->path_id( $request, 'candidate_id' ) ) ); } /** * DELETE /admin/sessions/{id}/candidates/{candidate_id} * * @since 0.1.0 * * @param WP_REST_Request $request Request. * @return \WP_REST_Response|\WP_Error */ public function delete( WP_REST_Request $request ) { return $this->respond( $this->service->delete( $this->path_id( $request ), $this->path_id( $request, 'candidate_id' ) ) ); } /** * POST /admin/sessions/{id}/candidates/{candidate_id}/action * * @since 0.1.0 * * @param WP_REST_Request $request Request. * @return \WP_REST_Response|\WP_Error */ public function action( WP_REST_Request $request ) { return $this->respond( $this->queue->candidate_action( $this->path_id( $request ), $this->path_id( $request, 'candidate_id' ), (string) $request->get_param( 'action' ) ) ); } /** * POST /admin/sessions/{id}/candidates/{candidate_id}/resend-join * * @since 0.1.0 * * @param WP_REST_Request $request Request. * @return \WP_REST_Response|\WP_Error */ public function resend_join( WP_REST_Request $request ) { return $this->resend( $request ); } /** * POST /admin/sessions/{id}/import * * @since 0.1.0 * * @param WP_REST_Request $request Request. * @return \WP_REST_Response|\WP_Error */ public function import( WP_REST_Request $request ) { $files = $request->get_file_params(); return $this->respond( $this->importer->import_upload( $this->path_id( $request ), isset( $files['csv'] ) ? $files['csv'] : null ) ); } /** * Manual resend of the check-in e-mail. * * @param WP_REST_Request $request Request. * @return \WP_REST_Response|\WP_Error */ private function resend( WP_REST_Request $request ) { $session = $this->session( $request ); if ( is_wp_error( $session ) ) { return $session; } $candidate = $this->candidate( $request, $session ); if ( is_wp_error( $candidate ) ) { return $candidate; } return $this->respond( $this->reminders->send_join_email_manual( $session, $candidate ) ); } }