'POST', 'callback' => array( $this, 'send_test_email' ), 'permission_callback' => array( $this, 'check_send_test_email_permission' ), ) ); register_rest_route( self::NAMESPACE, '/onboarding/dismiss', array( 'methods' => 'POST', 'callback' => array( $this, 'dismiss_onboarding' ), 'permission_callback' => array( $this, 'check_write_permission' ), ) ); register_rest_route( self::NAMESPACE, '/onboarding/status', array( 'methods' => 'GET', 'callback' => array( $this, 'get_onboarding_status' ), 'permission_callback' => array( $this, 'check_read_permission' ), ) ); // Create wizard register_rest_route( self::NAMESPACE, '/create-wizard/dismiss', array( 'methods' => 'POST', 'callback' => array( $this, 'dismiss_create_wizard' ), 'permission_callback' => array( $this, 'check_write_permission' ), ) ); register_rest_route( self::NAMESPACE, '/create-wizard/status', array( 'methods' => 'GET', 'callback' => array( $this, 'get_create_wizard_status' ), 'permission_callback' => array( $this, 'check_read_permission' ), ) ); // More features card on the Dashboard (dismissed per user). register_rest_route( self::NAMESPACE, '/more-features/dismiss', array( 'methods' => 'POST', 'callback' => array( $this, 'dismiss_more_features' ), 'permission_callback' => array( $this, 'check_write_permission' ), ) ); // Cloudflare notice on Security & privacy (dismissed per user). register_rest_route( self::NAMESPACE, '/cloudflare-notice/dismiss', array( 'methods' => 'POST', 'callback' => array( $this, 'dismiss_cloudflare_notice' ), 'permission_callback' => array( $this, 'check_write_permission' ), ) ); // Builder tour register_rest_route( self::NAMESPACE, '/tour/complete', array( 'methods' => 'POST', 'callback' => array( $this, 'complete_tour' ), 'permission_callback' => array( $this, 'check_write_permission' ), ) ); register_rest_route( self::NAMESPACE, '/tour/status', array( 'methods' => 'GET', 'callback' => array( $this, 'get_tour_status' ), 'permission_callback' => array( $this, 'check_read_permission' ), ) ); } // ── More features card ────────────────────────────────────────────────── /** * Remember that this user dismissed the More features card. It does not * come back for them. * * @param WP_REST_Request $request Request. * @return WP_REST_Response */ public function dismiss_more_features( WP_REST_Request $request ): WP_REST_Response { $user_id = get_current_user_id(); if ( ! $user_id ) { return ApiResponse::unauthorized( __( 'User not authenticated', 'subtleforms' ) ); } update_user_meta( $user_id, \SubtleForms\Admin\AdminMenu::MORE_FEATURES_META, true ); return ApiResponse::success( array( 'dismissed' => true ) ); } /** * Remember that this user dismissed the Cloudflare notice. * * @param WP_REST_Request $request Request. * @return WP_REST_Response */ public function dismiss_cloudflare_notice( WP_REST_Request $request ): WP_REST_Response { $user_id = get_current_user_id(); if ( ! $user_id ) { return ApiResponse::unauthorized( __( 'User not authenticated', 'subtleforms' ) ); } update_user_meta( $user_id, \SubtleForms\Admin\AdminMenu::CLOUDFLARE_NOTICE_META, true ); return ApiResponse::success( array( 'dismissed' => true ) ); } // ── Onboarding ────────────────────────────────────────────────────────── public function dismiss_onboarding( WP_REST_Request $request ): WP_REST_Response { $user_id = get_current_user_id(); if ( ! $user_id ) { return ApiResponse::unauthorized( __( 'User not authenticated', 'subtleforms' ) ); } update_user_meta( $user_id, 'subtleforms_onboarding_dismissed', true ); return ApiResponse::success( array( 'success' => true, 'message' => __( 'Onboarding dismissed', 'subtleforms' ), ) ); } public function get_onboarding_status( WP_REST_Request $request ): WP_REST_Response { $user_id = get_current_user_id(); if ( ! $user_id ) { return ApiResponse::success( array( 'success' => false, 'dismissed' => false, ) ); } $dismissed = (bool) get_user_meta( $user_id, 'subtleforms_onboarding_dismissed', true ); return ApiResponse::success( array( 'success' => true, 'dismissed' => $dismissed, ) ); } public function send_test_email( WP_REST_Request $request ): WP_REST_Response { try { $settings = new \SubtleForms\Support\Settings(); $to = $settings->getAdminEmail(); $subject = __( 'SubtleForms: Test email', 'subtleforms' ); $message = __( 'This is a test email sent from SubtleForms to verify delivery to your admin email address.', 'subtleforms' ); $sent = \SubtleForms\Support\Mailer::send( $to, $subject, $message ); if ( $sent ) { return ApiResponse::success( array( 'success' => true ) ); } return ApiResponse::success( array( 'success' => false, 'message' => __( 'Failed to send test email', 'subtleforms' ), ) ); } catch ( \Exception $e ) { return ApiResponse::server_error( $e->getMessage() ); } } // ── Create wizard ─────────────────────────────────────────────────────── public function dismiss_create_wizard( WP_REST_Request $request ): WP_REST_Response { $user_id = get_current_user_id(); if ( ! $user_id ) { return ApiResponse::unauthorized( __( 'User not authenticated', 'subtleforms' ) ); } update_user_meta( $user_id, 'subtleforms_create_wizard_dismissed', true ); return ApiResponse::success( array( 'success' => true, 'message' => __( 'Create wizard dismissed', 'subtleforms' ), ) ); } public function get_create_wizard_status( WP_REST_Request $request ): WP_REST_Response { $user_id = get_current_user_id(); if ( ! $user_id ) { return ApiResponse::success( array( 'success' => false, 'dismissed' => false, ) ); } $dismissed = (bool) get_user_meta( $user_id, 'subtleforms_create_wizard_dismissed', true ); return ApiResponse::success( array( 'success' => true, 'dismissed' => $dismissed, ) ); } // ── Builder tour ──────────────────────────────────────────────────────── public function complete_tour( WP_REST_Request $request ): WP_REST_Response { $user_id = get_current_user_id(); if ( ! $user_id ) { return ApiResponse::unauthorized( __( 'User not authenticated', 'subtleforms' ) ); } update_user_meta( $user_id, 'subtleforms_tour_completed', true ); return ApiResponse::success( array( 'success' => true, 'message' => __( 'Tour completed', 'subtleforms' ), ) ); } public function get_tour_status( WP_REST_Request $request ): WP_REST_Response { $user_id = get_current_user_id(); if ( ! $user_id ) { return ApiResponse::success( array( 'success' => false, 'completed' => false, ) ); } $completed = (bool) get_user_meta( $user_id, 'subtleforms_tour_completed', true ); return ApiResponse::success( array( 'success' => true, 'completed' => $completed, ) ); } // ── Permissions ───────────────────────────────────────────────────────── public function check_read_permission( \WP_REST_Request $request ) { if ( ! current_user_can( 'manage_options' ) ) { return new \WP_Error( 'subtleforms_forbidden', __( 'You are not allowed to perform this action.', 'subtleforms' ), array( 'status' => 403 ) ); } $nonce = sanitize_text_field( wp_unslash( (string) $request->get_header( 'X-WP-Nonce' ) ) ); if ( empty( $nonce ) || ! wp_verify_nonce( $nonce, 'wp_rest' ) ) { return new \WP_Error( 'subtleforms_invalid_nonce', __( 'Security check failed. Please refresh and try again.', 'subtleforms' ), array( 'status' => 403 ) ); } return true; } /** * Administrator-only gate for the onboarding test email. * * Uses manage_options (same bar as FormsApi / ApiGuards). Other onboarding * write routes use the same bar, since every SubtleForms screen is admin-only. * * @param \WP_REST_Request $request Incoming request. * @return true|\WP_Error */ public function check_send_test_email_permission( \WP_REST_Request $request ) { if ( ! is_user_logged_in() || ! current_user_can( 'manage_options' ) ) { return new \WP_Error( 'subtleforms_forbidden', __( 'You are not allowed to perform this action.', 'subtleforms' ), array( 'status' => 403 ) ); } $nonce = sanitize_text_field( wp_unslash( (string) $request->get_header( 'X-WP-Nonce' ) ) ); if ( empty( $nonce ) || ! wp_verify_nonce( $nonce, 'wp_rest' ) ) { return new \WP_Error( 'subtleforms_invalid_nonce', __( 'Security check failed. Please refresh and try again.', 'subtleforms' ), array( 'status' => 403 ) ); } return true; } public function check_write_permission( \WP_REST_Request $request ) { if ( ! current_user_can( 'manage_options' ) ) { return new \WP_Error( 'subtleforms_forbidden', __( 'You are not allowed to perform this action.', 'subtleforms' ), array( 'status' => 403 ) ); } $nonce = sanitize_text_field( wp_unslash( (string) $request->get_header( 'X-WP-Nonce' ) ) ); if ( empty( $nonce ) || ! wp_verify_nonce( $nonce, 'wp_rest' ) ) { return new \WP_Error( 'subtleforms_invalid_nonce', __( 'Security check failed. Please refresh and try again.', 'subtleforms' ), array( 'status' => 403 ) ); } return true; } }