<?php
/**
 * Jetpack forms dashboard.
 *
 * @package automattic/jetpack-forms
 */

namespace Automattic\Jetpack\Forms\Dashboard;

use Automattic\Jetpack\Admin_UI\Admin_Menu;
use Automattic\Jetpack\Assets;
use Automattic\Jetpack\Connection\Initial_State as Connection_Initial_State;
use Automattic\Jetpack\Forms\ContactForm\Contact_Form;
use Automattic\Jetpack\Forms\ContactForm\Contact_Form_Plugin;
use Automattic\Jetpack\Tracking;
use Automattic\Jetpack\WP_Build_Polyfills\WP_Build_Polyfills;

if ( ! defined( 'ABSPATH' ) ) {
	exit( 0 );
}

/**
 * Handles the Jetpack Forms dashboard.
 */
class Dashboard {
	/**
	 * Load wp-build generated files if available.
	 * This is for the new DataViews-based responses list.
	 */
	public static function load_wp_build() {
		// Always load for the standalone Forms page.
		$should_load = self::get_admin_query_page() === self::FORMS_WPBUILD_ADMIN_SLUG;

		/**
		 * Filter whether to load the wp-build asset registrations.
		 * Host applications (e.g., CIAB) can return true to opt in.
		 *
		 * @param bool $should_load Whether build.php should be loaded.
		 */
		$should_load = apply_filters( 'jetpack_forms_load_wp_build', $should_load );

		if ( ! $should_load ) {
			return;
		}

		$wp_build_index = self::wp_build_index_path();

		if ( file_exists( $wp_build_index ) ) {
			require_once $wp_build_index;
		}

		// The remaining setup only applies to the standalone Forms page.
		if ( self::get_admin_query_page() !== self::FORMS_WPBUILD_ADMIN_SLUG ) {
			return;
		}

		// When no route path is specified, redirect to the default view
		// so the client-side router doesn't need a catch-all root route.
		// phpcs:ignore WordPress.Security.NonceVerification.Recommended
		if ( ! isset( $_GET['p'] ) ) {
			$default_tab = Contact_Form_Plugin::has_editor_feature_flag( 'central-form-management' )
				? 'forms'
				: 'inbox';

			wp_safe_redirect( self::get_forms_admin_url( $default_tab ) );

			exit;
		}

		// Register polyfills for WP < 7.0 (must run before enqueue).
		WP_Build_Polyfills::register(
			'jetpack-forms',
			array_merge(
				WP_Build_Polyfills::SCRIPT_HANDLES,
				WP_Build_Polyfills::MODULE_IDS
			)
		);
	}

	/**
	 * Overrides the generated entry point path. Test seam, null in production.
	 *
	 * Private with no setter: tests reach it by reflection, so nothing outside the
	 * package can point the dashboard at another file.
	 *
	 * @var string|null
	 */
	private static $wp_build_index = null;

	/**
	 * Absolute path to the entry point generated by the WP build script.
	 *
	 * @return string
	 */
	private static function wp_build_index_path() {
		return self::$wp_build_index ?? dirname( __DIR__, 2 ) . '/build/build.php';
	}

	/**
	 * Script handle for the JS file we enqueue in the Feedback admin page.
	 *
	 * @var string
	 */
	const SCRIPT_HANDLE = 'jp-forms-dashboard';

	const ADMIN_SLUG = 'jetpack-forms-admin';

	/**
	 * Slug for the wp-admin integrated Responses UI (wp-build page).
	 *
	 * Note: This must be a valid submenu slug (sanitize_key compatible), not a full URL.
	 *
	 * @var string
	 */
	const FORMS_WPBUILD_ADMIN_SLUG = 'jetpack-forms-responses-wp-admin';

	/**
	 * Priority for the dashboard menu.
	 * Needs to be high enough for us to be able to unregister the default edit.php menu item.
	 *
	 * @var int
	 */
	const MENU_PRIORITY = 999;

	/**
	 * Initialize the dashboard.
	 */
	public function init() {
		add_action( 'admin_menu', array( $this, 'add_admin_submenu' ), self::MENU_PRIORITY );
		add_action( 'admin_menu', array( __CLASS__, 'redirect_dashboard_url_cross_variant' ), 1 );

		/**
		 * Filter to enable or disable the wp-build-based Forms dashboard.
		 *
		 * Enabled by default since Central Forms Management is now available for all sites.
		 * Can be disabled by returning false from this filter.
		 *
		 * @since 7.18.0
		 *
		 * @param bool $enabled Whether the wp-build dashboard is enabled. Default true.
		 */
		$is_wp_build_enabled = apply_filters( 'jetpack_forms_alpha', true );

		if ( $is_wp_build_enabled ) {
			self::load_wp_build();
		}

		add_action( 'admin_enqueue_scripts', array( $this, 'load_admin_scripts' ) );

		// Removed all admin notices on the Jetpack Forms admin page.
		if ( self::get_admin_query_page() === self::ADMIN_SLUG ) {
			remove_all_actions( 'admin_notices' );
		}
	}

	/**
	 * Redirect dashboard URLs when the wp-build flag has changed since the link was generated.
	 *
	 * Email links may point to the legacy or wp-build dashboard. If the flag has toggled,
	 * the requested page may not exist. This redirects to the correct variant.
	 */
	public static function redirect_dashboard_url_cross_variant() {
		// phpcs:ignore WordPress.Security.NonceVerification.Recommended
		$page = isset( $_GET['page'] ) ? sanitize_text_field( wp_unslash( $_GET['page'] ) ) : '';

		if ( $page !== self::ADMIN_SLUG && $page !== self::FORMS_WPBUILD_ADMIN_SLUG ) {
			return;
		}

		/** This filter is documented in class-dashboard.php::init */
		$is_wp_build_enabled = apply_filters( 'jetpack_forms_alpha', true );

		// Legacy URL requested but wp-build is now active → redirect to wp-build.
		if ( $page === self::ADMIN_SLUG && $is_wp_build_enabled ) {
			// The hash is never sent to the server. "inbox" used as default tab so we end up specifically in the responses
			// route, where the client-side router will handle the redirect to the correct status in its beforeLoad hook.
			$redirect = self::get_forms_admin_url( 'inbox' );
			wp_safe_redirect( $redirect );
			exit;
		}

		// WP-Build URL requested but legacy is now active → redirect to legacy.
		if ( $page === self::FORMS_WPBUILD_ADMIN_SLUG && ! $is_wp_build_enabled ) {
			// phpcs:ignore WordPress.Security.NonceVerification.Recommended
			$p                = isset( $_GET['p'] ) ? rawurldecode( sanitize_text_field( wp_unslash( $_GET['p'] ) ) ) : '';
			$tab              = 'inbox';
			$post_id          = null;
			$has_mark_as_spam = false;

			// Check if mark_as_spam is a separate query parameter (old email format).
			// phpcs:ignore WordPress.Security.NonceVerification.Recommended
			if ( isset( $_GET['mark_as_spam'] ) ) {
				$has_mark_as_spam = true;
			}

			if ( $p !== '' ) {
				// Parse path like /responses/inbox?responseIds=["2879"] or /responses/inbox?responseIds=["2879"]&mark_as_spam or /forms.
				if ( preg_match( '#^/responses/(inbox|spam|trash)(?:\?responseIds=\["(\d+)"\])?(.*)$#', $p, $m ) ) {
					$tab     = $m[1];
					$post_id = ! empty( $m[2] ) ? absint( $m[2] ) : null;

					// Check if mark_as_spam parameter is present inside the path.
					if ( ! empty( $m[3] ) && strpos( $m[3], 'mark_as_spam' ) !== false ) {
						$has_mark_as_spam = true;
					}
				} elseif ( preg_match( '#^/response/(\d+)(?:\?(.*))?$#', $p, $m ) ) {
					// Standalone single response page (wp-build only) — the legacy
					// dashboard shows the response in the inbox list instead. The path
					// is matched whole so trailing junk isn't read as a response ID,
					// but it may legitimately carry the email's mark_as_spam trigger.
					$post_id = absint( $m[1] );

					if ( ! empty( $m[2] ) && strpos( $m[2], 'mark_as_spam' ) !== false ) {
						$has_mark_as_spam = true;
					}
				} elseif ( preg_match( '#^/forms#', $p ) ) {
					$tab = 'forms';
				}
			}

			$redirect = self::get_forms_admin_url( $tab, $post_id );

			// Add mark_as_spam parameter if it was present in the original URL (either format).
			if ( $has_mark_as_spam ) {
				$redirect .= '&mark_as_spam';
			}

			wp_safe_redirect( $redirect );
			exit;
		}
	}

	/**
	 * Get the current query 'page' parameter.
	 *
	 * @return string
	 */
	private static function get_admin_query_page() {
		// phpcs:ignore WordPress.Security.NonceVerification.Recommended
		return isset( $_GET['page'] ) ? sanitize_text_field( wp_unslash( $_GET['page'] ) ) : '';
	}

	/**
	 * Load JavaScript for the dashboard.
	 */
	public function load_admin_scripts() {
		if ( ! self::is_jetpack_forms_admin_page() ) {
			return;
		}

		// The wp-build (script-module) dashboard renders its own UI from build/pages/…,
		// so the legacy SPA bundle is dead weight there. Only enqueue it on the legacy
		// dashboard. The shared inline data below (connection initial state + REST
		// preload) is instead attached to the always-present wp-api-fetch handle so the
		// wp-build app still receives it.
		if ( self::is_wp_build_dashboard_page() ) {
			$inline_handle    = 'wp-api-fetch';
			$preload_position = 'after';

			// The i18n loader is registered on every admin page by jetpack-assets but
			// only enqueued when depended on; the esbuild bundles don't pull it in.
			// Enqueue it so the wp-build dashboard's init module can download its JS
			// translation catalogs.
			if ( wp_script_is( 'wp-jp-i18n-loader', 'registered' ) ) {
				wp_enqueue_script( 'wp-jp-i18n-loader' );
			}
		} else {
			$inline_handle    = self::SCRIPT_HANDLE;
			$preload_position = 'before';

			Assets::register_script(
				self::SCRIPT_HANDLE,
				'../../dist/dashboard/jetpack-forms-dashboard.js',
				__FILE__,
				array(
					'in_footer'  => true,
					'textdomain' => 'jetpack-forms',
					'enqueue'    => true,
				)
			);
		}

		if ( Contact_Form_Plugin::can_use_analytics() ) {
			Tracking::register_tracks_functions_scripts( true );
		}

		// Adds Connection package initial state.
		Connection_Initial_State::render_script( $inline_handle );

		// Preload Forms endpoints needed in dashboard context.
		// Pre-fetch the first inbox page so the UI renders instantly on first load.
		$preload_params = array(
			'context'       => 'edit',
			'fields_format' => 'collection',
			'order'         => 'desc',
			'orderby'       => 'date',
			'page'          => 1,
			'per_page'      => 20,
			'status'        => 'draft,publish',
		);
		\ksort( $preload_params );
		$initial_responses_path        = \add_query_arg( $preload_params, '/wp/v2/feedback' );
		$initial_responses_locale_path = \add_query_arg(
			\array_merge(
				$preload_params,
				array( '_locale' => 'user' )
			),
			'/wp/v2/feedback'
		);
		$filters_path                  = '/wp/v2/feedback/filters';
		$filters_locale_path           = \add_query_arg( array( '_locale' => 'user' ), $filters_path );
		$preload_paths                 = array(
			'/wp/v2/types?context=view',
			'/wp/v2/feedback/config',
			'/wp/v2/feedback/integrations-metadata',
			'/wp/v2/feedback/counts',
			$filters_path,
			$filters_locale_path,
			$initial_responses_path,
			$initial_responses_locale_path,
		);

		// Only preload the Forms list endpoint when centralized form management is enabled.
		if ( Contact_Form_Plugin::has_editor_feature_flag( 'central-form-management' ) ) {
			$forms_preload_params = array(
				'context'               => 'edit',
				'page'                  => 1,
				'jetpack_forms_context' => 'dashboard',
				'order'                 => 'desc',
				'orderby'               => 'modified',
				'per_page'              => 20,
				'status'                => 'publish,draft,pending,future,private',
			);
			ksort( $forms_preload_params );
			$preload_paths[] = add_query_arg( $forms_preload_params, '/wp/v2/jetpack-forms' );
			$preload_paths[] = add_query_arg(
				array_merge(
					$forms_preload_params,
					array( '_locale' => 'user' )
				),
				'/wp/v2/jetpack-forms'
			);
			$preload_paths[] = '/wp/v2/jetpack-forms/status-counts';
			$preload_paths[] = add_query_arg( array( '_locale' => 'user' ), '/wp/v2/jetpack-forms/status-counts' );
		}
		$preload_data_raw = array_reduce( $preload_paths, 'rest_preload_api_request', array() );

		// Normalize keys to match what apiFetch will request (without domain).
		$preload_data = array();
		foreach ( $preload_data_raw as $key => $value ) {
			$normalized_key                  = preg_replace( '#^https?://[^/]+/wp-json#', '', $key );
			$preload_data[ $normalized_key ] = $value;
		}

		wp_add_inline_script(
			$inline_handle,
			sprintf(
				'wp.apiFetch.use( wp.apiFetch.createPreloadingMiddleware( %s ) );',
				wp_json_encode( $preload_data, JSON_UNESCAPED_SLASHES | JSON_HEX_TAG | JSON_HEX_AMP )
			),
			$preload_position
		);
	}

	/**
	 * Whether the current request targets the wp-build (script-module) Forms dashboard,
	 * as opposed to the legacy SPA dashboard.
	 *
	 * When true, the legacy dashboard bundle should not be enqueued: the wp-build page
	 * (build/pages/jetpack-forms-responses/…) provides its own UI and asset loading.
	 *
	 * @return bool
	 */
	public static function is_wp_build_dashboard_page() {
		/** This filter is documented in class-dashboard.php::init */
		return apply_filters( 'jetpack_forms_alpha', true )
			&& self::get_admin_query_page() === self::FORMS_WPBUILD_ADMIN_SLUG;
	}

	/**
	 * Register the dashboard admin submenu Forms under Jetpack menu.
	 */
	public function add_admin_submenu() {

		/** This filter is documented in class-dashboard.php::init */
		if ( apply_filters( 'jetpack_forms_alpha', true ) ) {

			// Report a missing build here rather than only on the page itself, so a partial
			// deploy shows up on the first admin request instead of waiting for someone to
			// open Forms. Keyed on the file and not on the generated callback: load_wp_build()
			// only requires build.php on the Forms page, so the callback is legitimately
			// absent on every other admin screen, which runs this method too.
			if ( ! file_exists( self::wp_build_index_path() ) ) {
				_doing_it_wrong(
					__METHOD__,
					'The Jetpack Forms build output is missing: build/build.php is absent, so the dashboard has nothing to render. The package build did not run for this deploy.',
					''
				);
			}

			// `jetpack_forms_jetpack_forms_responses_wp_admin_render_page` is the callback generated
			// by the WP build script, named after the page slug. It only exists once `build/build.php`
			// is loaded. Without it the page has nothing to render, so show an explanation rather
			// than the legacy mount point, whose bundle load_admin_scripts() does not enqueue here.
			$callback = function_exists( 'jetpack_forms_jetpack_forms_responses_wp_admin_render_page' )
				? 'jetpack_forms_jetpack_forms_responses_wp_admin_render_page'
				: array( $this, 'render_wp_build_unavailable' );

			Admin_Menu::add_menu(
				/** "Jetpack Forms" and "Forms" are product names, do not translate. */
				'Jetpack Forms',
				'Forms',
				'edit_pages',
				self::FORMS_WPBUILD_ADMIN_SLUG,
				$callback
			);

			return;
		}

		Admin_Menu::add_menu(
			/** "Jetpack Forms" and "Forms" are Product names, do not translate. */
			'Jetpack Forms',
			'Forms',
			'edit_pages',
			self::ADMIN_SLUG,
			array( $this, 'render_dashboard' )
		);
	}

	/**
	 * Render the dashboard.
	 */
	public function render_dashboard() {
		?>
		<div id="jp-forms-dashboard"></div>
		<?php
	}

	/**
	 * Render an error notice when the wp-build dashboard cannot render.
	 *
	 * The wp-build dashboard renders through a callback generated into `build/build.php`.
	 * That file is missing when the package ships without a complete build, and it is
	 * never loaded when a host application filters `jetpack_forms_load_wp_build` to false.
	 * The legacy bundle is no fallback here: load_admin_scripts() skips it on this screen.
	 * So report the problem instead of rendering a blank page.
	 *
	 * @since 7.25.0
	 */
	public function render_wp_build_unavailable() {
		?>
		<div class="wrap">
			<?php /* "Jetpack Forms" is a product name, do not translate. */ ?>
			<h1>Jetpack Forms</h1>
			<div class="notice notice-error">
				<p><?php esc_html_e( 'The Forms dashboard is missing the files it needs to load.', 'jetpack-forms' ); ?></p>
				<p><?php esc_html_e( 'Reinstalling or updating the plugin usually fixes this. If this site is configured not to load the Forms dashboard, contact your site administrator or host.', 'jetpack-forms' ); ?></p>
			</div>
		</div>
		<?php
	}

	/**
	 * Returns true if there are any feedback posts on the site.
	 *
	 * @return boolean
	 */
	public function has_feedback() {
		$posts = new \WP_Query(
			array(
				'post_type'              => 'feedback',
				'post_status'            => array( 'publish', 'draft', 'spam', 'trash' ),
				'posts_per_page'         => 1,
				'fields'                 => 'ids',
				'no_found_rows'          => true,
				'update_post_meta_cache' => false,
				'update_post_term_cache' => false,
				'suppress_filters'       => true,
			)
		);
		return $posts->have_posts();
	}

	/**
	 * Option name for storing classic forms state.
	 */
	const CLASSIC_FORMS_OPTION = 'jetpack_forms_classic_state';

	/**
	 * Classic forms state: site has classic (non-synced) form submissions.
	 */
	const CLASSIC_FORMS_STATE_CLASSIC = 'classic';

	/**
	 * Classic forms state: no classic form submissions detected.
	 */
	const CLASSIC_FORMS_STATE_HIDDEN = 'hidden';

	/**
	 * Classic forms state: user dismissed the classic forms notice.
	 */
	const CLASSIC_FORMS_STATE_DISMISSED = 'dismissed';

	/**
	 * Returns the classic forms state for the current site.
	 *
	 * Returns 'classic' if the site has form submissions (feedback posts) that were not
	 * created by a synced/reusable jetpack_form, 'dismissed' if the user dismissed the
	 * classic forms notice, or 'hidden' otherwise.
	 *
	 * The result is persisted in a WP option so the detection query only runs once per site.
	 * After that, the cached value is returned on every subsequent call. The cache is also
	 * updated eagerly via mark_classic_form_detected() when new classic submissions arrive.
	 *
	 * @since 7.14.0
	 *
	 * @return string 'classic', 'hidden', or 'dismissed'.
	 */
	public function get_classic_forms_state() {
		$state = get_option( self::CLASSIC_FORMS_OPTION );

		if ( $state ) {
			return $state;
		}

		$state = $this->detect_classic_forms();
		update_option( self::CLASSIC_FORMS_OPTION, $state, false );

		return $state;
	}

	/**
	 * Detects whether any feedback posts exist that are not linked to a jetpack_form post,
	 * indicating the site has classic (inline, widget, or template) forms.
	 *
	 * A feedback post is considered "classic" if:
	 * - It has no parent (post_parent = 0), meaning it was created by a form embedded in a
	 *   widget, page template, or other non-post context.
	 * - Its parent exists but is not a jetpack_form post, meaning it was created by a form
	 *   block or shortcode placed directly in a post or page.
	 *
	 * The query uses a LEFT JOIN on the posts table to find feedback posts with no matching
	 * jetpack_form parent. This leverages the primary key index for the join and the
	 * type_status_date index for filtering by post_type, making it efficient even on large
	 * sites. The LIMIT 1 ensures early exit as soon as one classic form is found.
	 *
	 * Note: An alternative approach would be to search post_content for the form block markup
	 * (<!-- wp:jetpack/contact-form) or shortcode ([contact-form]). However, that requires a
	 * full-text scan of the posts table (LIKE '%...%' on a TEXT column) with no usable index,
	 * making it significantly more expensive. The feedback-based approach also better fits the
	 * use case: we only need to surface the "Not seeing all your forms?" prompt when there are
	 * actual submissions that won't appear under any synced form in the dashboard.
	 *
	 * @since 7.14.0
	 *
	 * @return string 'classic' or 'hidden'.
	 */
	private function detect_classic_forms() {
		global $wpdb;

		// phpcs:ignore WordPress.DB.DirectDatabaseQuery.DirectQuery,WordPress.DB.DirectDatabaseQuery.NoCaching
		$result = $wpdb->get_var(
			$wpdb->prepare(
				"SELECT 1 FROM {$wpdb->posts} AS f
				LEFT JOIN {$wpdb->posts} AS p
					ON p.ID = f.post_parent AND p.post_type = %s
				WHERE f.post_type = 'feedback'
				AND p.ID IS NULL
				LIMIT 1",
				Contact_Form::POST_TYPE
			)
		);

		return $result ? self::CLASSIC_FORMS_STATE_CLASSIC : self::CLASSIC_FORMS_STATE_HIDDEN;
	}

	/**
	 * Eagerly marks the site as having classic forms by setting the option to 'classic'.
	 *
	 * Called when a new form submission is saved that does not belong to a synced jetpack_form.
	 * This avoids re-running the detection query — once a classic submission is observed, the
	 * state is permanently set without needing to scan the database again.
	 *
	 * If the user has already dismissed the classic forms notice, the state is left as
	 * 'dismissed' so the notice does not reappear.
	 *
	 * @since 7.14.0
	 */
	public static function mark_classic_form_detected() {
		$current = get_option( self::CLASSIC_FORMS_OPTION );

		if ( self::CLASSIC_FORMS_STATE_DISMISSED === $current ) {
			return;
		}

		update_option( self::CLASSIC_FORMS_OPTION, self::CLASSIC_FORMS_STATE_CLASSIC, false );
	}

	/**
	 * Returns url of forms admin page.
	 *
	 * @param string|null $tab Tab to open in the forms admin page.
	 * @param int|null    $post_id Post ID of response to open in the forms responses page.
	 *
	 * @return string
	 */
	public static function get_forms_admin_url( $tab = null, $post_id = null ) {
		/** This filter is documented in class-dashboard.php::init */
		$is_wp_build_enabled = apply_filters( 'jetpack_forms_alpha', true );
		$url                 = admin_url( 'admin.php' );

		$url .= $is_wp_build_enabled
			? '?page=' . self::FORMS_WPBUILD_ADMIN_SLUG
			: '?page=' . self::ADMIN_SLUG;

		if ( $is_wp_build_enabled ) {
			$path = self::get_forms_admin_path_wp_build( $tab, $post_id );
			$url .= '&p=' . rawurlencode( $path );
		} else {
			$suffix = self::get_forms_admin_suffix_legacy( $tab, $post_id );

			if ( $suffix !== '' ) {
				$url .= $suffix;
			}
		}

		/**
		 * Filters the Forms admin page URL.
		 *
		 * @module contact-form
		 * @since 7.8.0
		 *
		 * @param string      $url The Forms admin page URL.
		 * @param string|null $tab Tab to open in the forms admin page.
		 * @param int|null $post_id Post ID of response to open in the forms responses page.
		 *
		 * @return string The filtered Forms admin page URL.
		 */
		return apply_filters( 'jetpack_forms_admin_url', $url, $tab, $post_id );
	}

	/**
	 * Returns the URL of the standalone single response page for a given response.
	 *
	 * The standalone page is a wp-build route (`/response/<id>`). The legacy
	 * dashboard has no equivalent, so it falls back to the responses list with the
	 * response selected — as does a missing/empty post ID.
	 *
	 * @since 7.25.0
	 *
	 * @param int|null $post_id Post ID of the response to open.
	 *
	 * @return string
	 */
	public static function get_single_response_admin_url( $post_id = null ) {
		$post_id = ! empty( $post_id ) ? absint( $post_id ) : null;

		// `get_forms_admin_url()` owns the URL scheme for both dashboards. The
		// 'response' tab resolves to the standalone page on wp-build, and falls
		// through to the responses list on legacy, which has no such route.
		return self::get_forms_admin_url( $post_id ? 'response' : 'inbox', $post_id );
	}

	/**
	 * WP-Build path for the forms admin URL.
	 *
	 * @param string|null $tab    Tab to open.
	 * @param int|null    $post_id Post ID of response.
	 * @return string URL path (e.g. '/', '/responses/inbox', '/forms').
	 */
	private static function get_forms_admin_path_wp_build( $tab, $post_id ) {
		$post_id      = ! empty( $post_id ) ? absint( $post_id ) : null;
		$response_ids = ! empty( $post_id ) ? '?responseIds=["' . $post_id . '"]' : '';

		// The standalone single response page, which addresses the response by path
		// rather than selecting it in a list.
		if ( $tab === 'response' && ! empty( $post_id ) ) {
			return '/response/' . $post_id;
		}

		$path_map = array(
			'inbox'           => '/responses/inbox',
			'spam'            => '/responses/spam',
			'trash'           => '/responses/trash',
			'forms'           => '/forms',
			'responses/inbox' => '/responses/inbox',
		);

		if ( $tab !== null && $tab !== '' && isset( $path_map[ $tab ] ) ) {
			return $path_map[ $tab ] . $response_ids;
		}

		if ( ! empty( $post_id ) ) {
			return '/responses/inbox?responseIds=["' . $post_id . '"]';
		}

		return '/responses/inbox';
	}

	/**
	 * Legacy (hash-based) URL suffix for the forms admin page.
	 *
	 * @param string|null $tab    Tab to open.
	 * @param int|null    $post_id Post ID of response.
	 * @return string URL suffix (e.g. '#/responses?status=inbox&r=123', or '#/forms').
	 */
	private static function get_forms_admin_suffix_legacy( $tab, $post_id ) {
		$post_id    = ! empty( $post_id ) ? absint( $post_id ) : null;
		$valid_tabs = array( 'spam', 'inbox', 'trash' );
		$r_param    = ! empty( $post_id ) ? '&r=' . $post_id : '';

		if ( in_array( $tab, $valid_tabs, true ) ) {
			return '#/responses?status=' . $tab . $r_param;
		}

		if ( $tab === 'forms' ) {
			return '#/forms';
		}

		if ( ! empty( $post_id ) ) {
			return '#/responses?status=inbox' . $r_param;
		}

		return '';
	}

	/**
	 * Returns true if the current screen is the Jetpack Forms admin page.
	 *
	 * @return boolean
	 */
	public static function is_jetpack_forms_admin_page() {
		if ( ! function_exists( 'get_current_screen' ) ) {
			return false;
		}

		$screen = get_current_screen();

		if ( ! $screen || ! isset( $screen->id ) ) {
			return false;
		}

		$forms_admin_screens = array(
			'jetpack_page_' . self::ADMIN_SLUG,
			'jetpack_page_' . self::FORMS_WPBUILD_ADMIN_SLUG,
		);

		return in_array( $screen->id, $forms_admin_screens, true );
	}

	/**
	 * Returns true if form notes feature is enabled.
	 *
	 * @return boolean
	 */
	public static function is_notes_enabled() {
		/**
		* Enable form notes feature in Jetpack Forms .
		*
		* @module contact-form
		* @since 7.3.0
		*
		* @param bool $enabled Should the form notes feature be enabled? Defaults to false.
		*/
		return apply_filters( 'jetpack_forms_notes_enable', false );
	}

	/**
	 * Get admin URL for given screen ID.
	 *
	 * @deprecated 7.9.0 Use Dashboard::get_forms_admin_url() instead.
	 *
	 * @param string $screen_id Screen ID.
	 * @return string Admin URL.
	 */
	public static function get_admin_url( $screen_id ) {
		_deprecated_function( __METHOD__, 'jetpack-7.9.0', 'Dashboard::get_forms_admin_url' );

		if ( 'edit-jetpack_form' === $screen_id ) {
			return self::get_forms_admin_url( 'forms' );
		}

		if ( 'edit-feedback' === $screen_id ) {
			return self::get_forms_admin_url( 'inbox' );
		}

		return self::get_forms_admin_url();
	}
}