<?php
/**
 * Kit Form Builder Block class.
 *
 * @package ConvertKit
 * @author ConvertKit
 */

/**
 * Kit Form Builder Block for Gutenberg.
 *
 * @package ConvertKit
 * @author  ConvertKit
 */
class ConvertKit_Block_Form_Builder extends ConvertKit_Block {

	/**
	 * Holds the subscriber that was created
	 * when the form was submitted.
	 *
	 * @since   3.0.0
	 *
	 * @var     bool|int
	 */
	public $subscriber_id = false;

	/**
	 * Holds the WP_Error object if the form submission failed,
	 * to display on screen as a notice.
	 *
	 * @since   3.4.4
	 *
	 * @var     bool|WP_Error
	 */
	public $error = false;

	/**
	 * Holds the number of times this block has been rendered on the Post,
	 * used to identify each block on the page and ensure error notice IDs are unique.
	 *
	 * @since   3.4.4
	 *
	 * @var     int
	 */
	public $render_count = 0;

	/**
	 * Holds the index of the block that was submitted, so the error notice
	 * is only displayed on that block.
	 *
	 * @since   3.4.6
	 *
	 * @var     int
	 */
	public $submitted_block_index = 0;

	/**
	 * Constructor
	 *
	 * @since   3.0.0
	 */
	public function __construct() {

		// Subscribe if the form was submitted.
		add_action( 'init', array( $this, 'maybe_subscribe' ) );

		// Register this as a Gutenberg block in the Kit Plugin.
		add_filter( 'convertkit_blocks', array( $this, 'register' ) );

		// Enqueue styles for this Gutenberg Block in the editor view.
		add_action( 'convertkit_gutenberg_enqueue_styles', array( $this, 'enqueue_styles_editor' ) );

		// Enqueue scripts and styles for this Gutenberg Block in the editor and frontend views.
		add_action( 'convertkit_gutenberg_enqueue_styles_editor_and_frontend', array( $this, 'enqueue_styles' ) );

		// Replace <a> with <button type="submit"> for the core/button element within the form builder.
		add_filter( 'render_block_core/button', array( $this, 'render_form_button' ), 10, 2 );

	}

	/**
	 * Checks if the request is a Native Form subscribe request with an email address.
	 * If so, subscribes the email address to the Kit account.
	 *
	 * @since   3.0.0
	 */
	public function maybe_subscribe() {

		// Bail if no nonce was specified.
		if ( ! array_key_exists( '_wpnonce', $_REQUEST ) ) {
			return;
		}

		// Bail if the nonce failed validation.
		if ( ! wp_verify_nonce( sanitize_key( $_REQUEST['_wpnonce'] ), 'convertkit_block_form_builder' ) ) {
			return;
		}

		// Bail if the expected email, resource ID or Post ID are missing.
		if ( ! array_key_exists( 'convertkit', $_REQUEST ) ) {
			return;
		}
		if ( ! array_key_exists( 'email', $_REQUEST['convertkit'] ) ) {
			return;
		}
		if ( ! array_key_exists( 'post_id', $_REQUEST['convertkit'] ) ) {
			return;
		}

		// Store the submitted block's index, so any error is only displayed on that block.
		if ( array_key_exists( 'block_index', $_REQUEST['convertkit'] ) ) {
			$this->submitted_block_index = absint( $_REQUEST['convertkit']['block_index'] );
		}

		// Check spam protection.
		$spam_protection = new ConvertKit_Spam_Protection();

		// Bail if spam protection failed.
		$spam_protection_result = $spam_protection->verify( 'convertkit_form_builder' );
		if ( is_wp_error( $spam_protection_result ) ) {
			$this->error = $spam_protection_result;
			return;
		}

		// Sanitize form data.
		$form_data = map_deep( wp_unslash( $_REQUEST['convertkit'] ), 'sanitize_text_field' );

		// Bail if the email address is invalid. The entry isn't stored, as an invalid
		// email address is of no use to the creator.
		if ( ! is_email( $form_data['email'] ) ) {
			$this->error = new WP_Error(
				'convertkit_block_form_builder_invalid_email',
				__( 'Please enter a valid email address.', 'convertkit' )
			);
			return;
		}

		// Build custom fields, if any were specified.
		$custom_fields = array();
		if ( array_key_exists( 'custom_fields', $form_data ) ) {
			$custom_fields = $form_data['custom_fields'];
		}

		// Get First Name, if the Name field was included in the form.
		$first_name = array_key_exists( 'first_name', $form_data ) ? $form_data['first_name'] : '';

		// Get Form, Tag and Sequence IDs, if any were specified.
		$form_id     = array_key_exists( 'form_id', $form_data ) ? absint( $form_data['form_id'] ) : 0;
		$tag_id      = array_key_exists( 'tag_id', $form_data ) ? absint( $form_data['tag_id'] ) : 0;
		$sequence_id = array_key_exists( 'sequence_id', $form_data ) ? absint( $form_data['sequence_id'] ) : 0;

		// Initialize classes that will be used.
		$settings = new ConvertKit_Settings();
		$entries  = new ConvertKit_Form_Entries();

		// If the Plugin Access Token has not been configured, we can't add a subscriber.
		if ( ! $settings->has_access_and_refresh_token() ) {
			// Store entry and return.
			if ( $form_data['store_entries'] ) {
				$entries->upsert(
					array(
						'post_id'       => $form_data['post_id'],
						'email'         => $form_data['email'],
						'first_name'    => $first_name,
						'custom_fields' => $custom_fields,
						'form_id'       => $form_id,
						'tag_id'        => $tag_id,
						'sequence_id'   => $sequence_id,
						'api_result'    => 'error',
						'api_error'     => __( 'Plugin Access Token not configured', 'convertkit' ),
					)
				);
			}

			$this->error = new WP_Error(
				'convertkit_block_form_builder_no_access_token',
				__( 'Sorry, we were unable to subscribe you. Please try again later.', 'convertkit' )
			);
			return;
		}

		// Initialize the API.
		$api = new ConvertKit_API_V4(
			CONVERTKIT_OAUTH_CLIENT_ID,
			CONVERTKIT_OAUTH_CLIENT_REDIRECT_URI,
			$settings->get_access_token(),
			$settings->get_refresh_token(),
			$settings->debug_enabled(),
			'block_form_builder'
		);

		// Determine the subscriber state.
		// If a Form is specified, mark the subscriber as inactive, so the form's double optin is honored.
		// If a Tag or Sequence is specified, mark the subscriber as active, as there's no double optin for tags or sequences.
		$subscriber_state = $form_id ? 'inactive' : 'active';

		// Create subscriber.
		$result = $api->create_subscriber(
			sanitize_email( $form_data['email'] ),
			$first_name,
			$subscriber_state,
			$custom_fields
		);

		// Bail if an error occurred.
		if ( is_wp_error( $result ) ) {
			// Store entry and return.
			if ( $form_data['store_entries'] ) {
				$entries->upsert(
					array(
						'post_id'       => $form_data['post_id'],
						'email'         => $form_data['email'],
						'first_name'    => $first_name,
						'custom_fields' => $custom_fields,
						'form_id'       => $form_id,
						'tag_id'        => $tag_id,
						'sequence_id'   => $sequence_id,
						'api_result'    => 'error',
						'api_error'     => $result->get_error_message(),
					)
				);
			}

			$this->error = $result;
			return;
		}

		// Store entry.
		if ( $form_data['store_entries'] ) {
			$entries->upsert(
				array(
					'post_id'       => $form_data['post_id'],
					'email'         => $form_data['email'],
					'first_name'    => $first_name,
					'custom_fields' => $custom_fields,
					'form_id'       => $form_id,
					'tag_id'        => $tag_id,
					'sequence_id'   => $sequence_id,
					'api_result'    => 'success',
				)
			);
		}

		// Get the subscriber ID, as $result is overwritten by the form, tag and sequence requests below.
		$subscriber_id = $result['subscriber']['id'];

		// Store the subscriber ID in a cookie.
		$subscriber = new ConvertKit_Subscriber();
		$subscriber->set( $subscriber_id );

		// If a form was specified, add the subscriber to the form.
		if ( $form_id ) {
			// For Legacy Forms, a different endpoint is used.
			$forms = new ConvertKit_Resource_Forms();
			if ( $forms->is_legacy( $form_id ) ) {
				$result = $api->add_subscriber_to_legacy_form(
					$form_id,
					$subscriber_id
				);
			} else {
				$result = $api->add_subscriber_to_form(
					$form_id,
					$subscriber_id,
					get_permalink( absint( $form_data['post_id'] ) )
				);
			}

			if ( $form_data['store_entries'] ) {
				$entries->upsert(
					array(
						'post_id'       => $form_data['post_id'],
						'email'         => $form_data['email'],
						'first_name'    => $first_name,
						'custom_fields' => $custom_fields,
						'form_id'       => $form_id,
						'tag_id'        => $tag_id,
						'sequence_id'   => $sequence_id,
						'api_result'    => is_wp_error( $result ) ? 'error' : 'success',
						'api_error'     => is_wp_error( $result ) ? $result->get_error_message() : '',
					)
				);
			}
		}

		// If a tag was specified, add the subscriber to the tag.
		if ( $tag_id ) {
			$result = $api->tag_subscriber( $tag_id, $subscriber_id );

			if ( $form_data['store_entries'] ) {
				$entries->upsert(
					array(
						'post_id'       => $form_data['post_id'],
						'email'         => $form_data['email'],
						'first_name'    => $first_name,
						'custom_fields' => $custom_fields,
						'form_id'       => $form_id,
						'tag_id'        => $tag_id,
						'sequence_id'   => $sequence_id,
						'api_result'    => is_wp_error( $result ) ? 'error' : 'success',
						'api_error'     => is_wp_error( $result ) ? $result->get_error_message() : '',
					)
				);
			}
		}

		// If a sequence was specified, add the subscriber to the sequence.
		if ( $sequence_id ) {
			$result = $api->add_subscriber_to_sequence( $sequence_id, $subscriber_id );

			if ( $form_data['store_entries'] ) {
				$entries->upsert(
					array(
						'post_id'       => $form_data['post_id'],
						'email'         => $form_data['email'],
						'first_name'    => $first_name,
						'custom_fields' => $custom_fields,
						'form_id'       => $form_id,
						'tag_id'        => $tag_id,
						'sequence_id'   => $sequence_id,
						'api_result'    => is_wp_error( $result ) ? 'error' : 'success',
						'api_error'     => is_wp_error( $result ) ? $result->get_error_message() : '',
					)
				);
			}
		}

		// Get the redirect URL, based on whether the form is configured to redirect
		// or not.
		if ( array_key_exists( 'redirect', $form_data ) && wp_http_validate_url( sanitize_url( $form_data['redirect'] ) ) ) {
			// Redirect to the URL specified in the form.
			$redirect = sanitize_url( $form_data['redirect'] );
		} else {
			// Redirect to the page the form was displayed on, to show a success message.
			$redirect = $this->get_current_url( absint( $form_data['post_id'] ) );
		}

		// Redirect.
		wp_redirect( $redirect ); // phpcs:ignore WordPress.Security.SafeRedirect.wp_redirect_wp_redirect
		exit();

	}

	/**
	 * Enqueues styles for this Gutenberg Block in the editor view.
	 *
	 * @since   3.0.0
	 */
	public function enqueue_styles_editor() {

		wp_enqueue_style( 'convertkit-gutenberg', CONVERTKIT_PLUGIN_URL . 'resources/backend/css/gutenberg.css', array( 'wp-edit-blocks' ), CONVERTKIT_PLUGIN_VERSION );

	}

	/**
	 * Enqueues styles for this Gutenberg Block in the editor and frontend views.
	 *
	 * @since   2.3.3
	 */
	public function enqueue_styles() {

		convertkit_enqueue_frontend_css();

	}

	/**
	 * Returns this block's programmatic name, excluding the convertkit- prefix.
	 *
	 * @since   3.0.0
	 *
	 * @return  string
	 */
	public function get_name() {

		/**
		 * This will register as:
		 * - a Gutenberg block, with the name convertkit/form-builder.
		 */
		return 'form-builder';

	}

	/**
	 * Returns this block's title.
	 *
	 * @since   3.1.1
	 */
	public function get_title() {

		return __( 'Kit Form Builder', 'convertkit' );

	}

	/**
	 * Returns this block's icon.
	 *
	 * @since   3.1.1
	 */
	public function get_icon() {

		return 'resources/backend/images/block-icon-form-builder.svg';

	}

	/**
	 * Returns this block's Title, Icon, Categories, Keywords and properties.
	 *
	 * @since   3.0.0
	 *
	 * @return  array
	 */
	public function get_overview() {

		$convertkit_forms = new ConvertKit_Resource_Forms( 'block_edit' );
		$settings         = new ConvertKit_Settings();

		return array(
			'title'                   => $this->get_title(),
			'description'             => __( 'Build a subscription form with Kit.', 'convertkit' ),
			'icon'                    => $this->get_icon(),
			'category'                => 'convertkit',
			'keywords'                => array(
				__( 'ConvertKit', 'convertkit' ),
				__( 'Kit', 'convertkit' ),
				__( 'Form Builder', 'convertkit' ),
			),

			// Function to call when rendering.
			'render_callback'         => array( $this, 'render' ),

			// Gutenberg: Block Icon in Editor.
			'gutenberg_icon'          => convertkit_get_file_contents( CONVERTKIT_PLUGIN_PATH . '/resources/backend/images/block-icon-form-builder.svg' ),

			// Gutenberg: Example image showing how this block looks when choosing it in Gutenberg.
			'gutenberg_example_image' => CONVERTKIT_PLUGIN_URL . 'resources/backend/images/block-example-form-builder.png',

			// Gutenberg: Inner blocks to use as a starting template when creating a new block.
			'gutenberg_template'      => array(
				'convertkit/form-builder-field-name'  => array(
					'label' => 'First name',
				),
				'convertkit/form-builder-field-email' => array(
					'label' => 'Email address',
					'lock'  => array(
						'move'   => false,
						'remove' => true,
					),
				),
				'core/button'                         => array(
					'label'     => 'Submit button',
					'text'      => 'Subscribe',
					'variant'   => 'primary',
					'className' => 'convertkit-form-builder-submit-button',
					'lock'      => array(
						'move'   => true,
						'remove' => true,
					),
				),
			),

			// Help descriptions, displayed when no Access Token / resources exist and this block/shortcode is added.
			'no_access_token'         => array(
				'notice'           => __( 'Not connected to Kit.', 'convertkit' ),
				'link'             => convertkit_get_setup_wizard_plugin_link(),
				'link_text'        => __( 'Click here to connect your Kit account.', 'convertkit' ),
				'instruction_text' => __( 'Connect your Kit account at Settings > Kit, and then refresh this page to configure this block.', 'convertkit' ),
			),

			'has_access_token'        => $settings->has_access_and_refresh_token(),

			// This block works without resources, so we don't need to check if resources exist.
			'has_resources'           => true,
		);

	}

	/**
	 * Returns this block's Attributes
	 *
	 * @since   3.0.0
	 *
	 * @return  array
	 */
	public function get_attributes() {

		return array(
			// Block attributes.
			'redirect'                   => array(
				'type'    => 'string',
				'default' => $this->get_default_value( 'redirect' ),
			),
			'store_entries'              => array(
				'type'    => 'boolean',
				'default' => $this->get_default_value( 'store_entries' ),
			),
			'display_form_if_subscribed' => array(
				'type'    => 'boolean',
				'default' => $this->get_default_value( 'display_form_if_subscribed' ),
			),
			'text_if_subscribed'         => array(
				'type'    => 'string',
				'default' => $this->get_default_value( 'text_if_subscribed' ),
			),
			'form_id'                    => array(
				'type'    => 'string',
				'default' => $this->get_default_value( 'form_id' ),
			),
			'tag_id'                     => array(
				'type'    => 'string',
				'default' => $this->get_default_value( 'tag_id' ),
			),
			'sequence_id'                => array(
				'type'    => 'string',
				'default' => $this->get_default_value( 'sequence_id' ),
			),

			// get_supports() style, color and typography attributes.
			'align'                      => array(
				'type' => 'string',
			),
			'style'                      => array(
				'type' => 'object',
			),
			'backgroundColor'            => array(
				'type' => 'string',
			),
			'textColor'                  => array(
				'type' => 'string',
			),
			'fontSize'                   => array(
				'type' => 'string',
			),

			// Always required for Gutenberg.
			'is_gutenberg_example'       => array(
				'type'    => 'boolean',
				'default' => false,
			),
		);

	}

	/**
	 * Returns this block's supported built-in Attributes.
	 *
	 * @since   3.0.0
	 *
	 * @return  array   Supports
	 */
	public function get_supports() {

		return array(
			'align'      => true,
			'className'  => true,
			'color'      => array(
				'link'       => true,
				'background' => true,
				'text'       => true,
			),
			'typography' => array(
				'fontSize'   => true,
				'lineHeight' => true,
			),
			'spacing'    => array(
				'margin'  => true,
				'padding' => true,
			),
		);

	}

	/**
	 * Returns this block's Fields
	 *
	 * @since   3.0.0
	 *
	 * @return  bool|array
	 */
	public function get_fields() {

		// Get Kit Forms. Non-legacy forms populate the sidebar dropdown;
		// legacy forms are exposed separately as a fallback so the sidebar can
		// keep displaying a previously-saved legacy form as the current
		// selection without offering other legacy forms as new choices.
		$forms                = new ConvertKit_Resource_Forms( 'block_form_builder' );
		$forms_options        = array();
		$forms_legacy_options = array();
		if ( $forms->exist() ) {
			foreach ( $forms->get() as $form ) {
				$label = sprintf(
					'%s [%s]',
					sanitize_text_field( $form['name'] ),
					// Legacy forms don't include a `format` key, so define them as inline.
					( ! empty( $form['format'] ) ? sanitize_text_field( $form['format'] ) : 'inline' )
				);

				if ( ! empty( $form['format'] ) ) {
					$forms_options[ $form['id'] ] = $label;
				} else {
					$forms_legacy_options[ $form['id'] ] = $label;
				}
			}
		}

		// Get Kit Tags.
		$tags         = new ConvertKit_Resource_Tags( 'block_form_builder' );
		$tags_options = array();
		if ( $tags->exist() ) {
			foreach ( $tags->get() as $tag ) {
				$tags_options[ $tag['id'] ] = sanitize_text_field( $tag['name'] );
			}
		}

		// Get Kit Sequences.
		$sequences         = new ConvertKit_Resource_Sequences( 'block_form_builder' );
		$sequences_options = array();
		if ( $sequences->exist() ) {
			foreach ( $sequences->get() as $sequence ) {
				$sequences_options[ $sequence['id'] ] = sanitize_text_field( $sequence['name'] );
			}
		}

		return array(
			'redirect'                   => array(
				'label'       => __( 'Redirect', 'convertkit' ),
				'type'        => 'url',
				'description' => __( 'The URL to redirect to after the visitor subscribes. If not specified, the visitor will remain on the current page.', 'convertkit' ),
			),
			'store_entries'              => array(
				'label'       => __( 'Store form submissions', 'convertkit' ),
				'type'        => 'toggle',
				'description' => __( 'If enabled, stores copies of form submissions in the WordPress database. Submissions are always sent to Kit.', 'convertkit' ),
			),
			'display_form_if_subscribed' => array(
				'label'       => __( 'Display form', 'convertkit' ),
				'type'        => 'toggle',
				'description' => __( 'If enabled, displays the form if the visitor is already subscribed.', 'convertkit' ),
			),
			'text_if_subscribed'         => array(
				'label'       => __( 'Text', 'convertkit' ),
				'type'        => 'text',
				'description' => __( 'The text to display if the visitor is already subscribed.', 'convertkit' ),
				'display_if'  => array(
					'key'   => 'display_form_if_subscribed',
					'value' => 0,
				),
			),
			'form_id'                    => array(
				'label'         => __( 'Form', 'convertkit' ),
				'type'          => 'select',
				'description'   => __( 'The Kit form to add the subscriber to. Useful if you want to send an incentive email.', 'convertkit' ),
				'values'        => $forms_options,
				'legacy_values' => $forms_legacy_options,
			),
			'tag_id'                     => array(
				'label'       => __( 'Tag', 'convertkit' ),
				'type'        => 'select',
				'description' => __( 'The Kit tag to add the subscriber to.', 'convertkit' ),
				'values'      => $tags_options,
			),
			'sequence_id'                => array(
				'label'       => __( 'Sequence', 'convertkit' ),
				'type'        => 'select',
				'description' => __( 'The Kit sequence to add the subscriber to.', 'convertkit' ),
				'values'      => $sequences_options,
			),
		);

	}

	/**
	 * Returns this block's UI panels / sections.
	 *
	 * @since   3.0.0
	 *
	 * @return  bool|array
	 */
	public function get_panels() {

		return array(
			'general' => array(
				'label'  => __( 'General', 'convertkit' ),
				'fields' => array(
					'form_id',
					'tag_id',
					'sequence_id',
					'redirect',
					'store_entries',
					'display_form_if_subscribed',
					'text_if_subscribed',
				),
			),
		);

	}

	/**
	 * Returns this block's Default Values
	 *
	 * @since   3.0.0
	 *
	 * @return  array
	 */
	public function get_default_values() {

		return array(
			'form_id'                    => '',
			'tag_id'                     => '',
			'sequence_id'                => '',
			'redirect'                   => '',
			'store_entries'              => true,
			'display_form_if_subscribed' => true,
			'text_if_subscribed'         => __( 'Thanks for subscribing!', 'convertkit' ),

			// Built-in Gutenberg block attributes.
			'align'                      => 'center',
			'style'                      => '',
			'backgroundColor'            => '',
			'textColor'                  => '',
		);

	}

	/**
	 * Returns the block's output, based on the supplied configuration attributes.
	 *
	 * @since   3.0.0
	 *
	 * @param   array  $atts      Block Attributes.
	 * @param   string $content   Inner blocks content.
	 * @return  string
	 */
	public function render( $atts, $content ) {

		global $post;

		// Get Post ID.
		$post_id = is_a( $post, 'WP_Post' ) ? $post->ID : 0;

		// Increment the render count, used to identify this block on the page.
		++$this->render_count;

		// Parse attributes, defining fallback defaults if required
		// and moving some attributes (such as Gutenberg's styles), if defined.
		$atts = $this->sanitize_and_declare_atts( $atts );

		// Check if subscriber is already subscribed, and whether the form should be displayed.
		$subscriber          = new ConvertKit_Subscriber();
		$this->subscriber_id = $subscriber->get_subscriber_id();
		$display_form        = $this->subscriber_id && ! $atts['display_form_if_subscribed'] ? false : true;

		// If the form should not be displayed, return the subscribed text.
		if ( ! $display_form ) {
			$html  = '<div class="' . implode( ' ', map_deep( $this->get_css_classes(), 'sanitize_html_class' ) ) . '" style="' . implode( ';', map_deep( $this->get_css_styles( $atts ), 'esc_attr' ) ) . '">';
			$html .= esc_html( $atts['text_if_subscribed'] );
			$html .= '</div>';
			return $html;
		}

		// Add the <form> element and hidden fields immediate inside the block's container.
		$html = $this->add_form_to_block_content( $content, $atts, $post_id );

		/**
		 * Filter the block's content immediately before it is output.
		 *
		 * @since   3.0.0
		 *
		 * @param   string  $html   ConvertKit Native Form HTML.
		 * @param   array   $atts   Block Attributes.
		 */
		$html = apply_filters( 'convertkit_block_form_builder_render', $html, $atts );

		return $html;

	}

	/**
	 * Replace <a> with <button type="submit"> for the core/button element within the form builder
	 * that has the class convertkit-form-builder-submit-button, as the block editor doesn't
	 * have a core <button> element, and registering our own just for this block would be overkill.
	 *
	 * @since   3.0.0
	 *
	 * @param   string $block_content  Block content.
	 * @param   array  $block          Block attributes.
	 * @return  string
	 */
	public function render_form_button( $block_content, $block ) {

		if ( ! isset( $block['attrs']['className'] ) ) {
			return $block_content;
		}

		if ( strpos( $block['attrs']['className'], 'convertkit-form-builder-submit-button' ) === false ) {
			return $block_content;
		}

		// Change link to button.
		$block_content = preg_replace(
			'/<a([^>]*)>(.*?)<\/a>/',
			'<button type="submit"$1>$2</button>',
			$block_content
		);

		// Return the button if no spam protection provider is active.
		$spam_protection = new ConvertKit_Spam_Protection();
		$provider        = $spam_protection->get_active_provider();
		if ( ! $provider ) {
			return $block_content;
		}

		// Enqueue the spam protection provider's JS.
		$provider->enqueue_scripts();

		// Parse the button's DOM.
		$parser = new ConvertKit_HTML_Parser( $block_content );
		$button = $parser->xpath->query( '//button' )->item( 0 );

		// Attach the spam protection provider's attributes/elements to the form/button as necessary.
		// $button is narrowed from DOMNode to DOMElement by the //button xpath expression above.
		$provider->attach_to_form_button_dom( $parser, $button, 'convertkit_form_builder' ); // @phpstan-ignore-line

		// Return button HTML.
		return $parser->get_body_html();

	}

	/**
	 * Wraps the block's content within a <form> element, and adds hidden fields.
	 *
	 * @since   3.0.0
	 *
	 * @param   string $content     Block content.
	 * @param   array  $atts        Block attributes.
	 * @param   int    $post_id     Post ID.
	 * @return  string
	 */
	private function add_form_to_block_content( $content, $atts, $post_id ) {

		// Load the content into the parser.
		$parser = new ConvertKit_HTML_Parser( $content );

		// Get block container.
		$block_container = $parser->xpath->query( '//div[contains(@class, "wp-block-convertkit-form-builder")]' )->item( 0 );

		// If no block container was found, return the original content.
		// This shouldn't happen, as the block editor supplies the container, but it's a safeguard.
		if ( ! $block_container ) {
			return $content;
		}

		// Create form element.
		$form = $parser->html->createElement( 'form' );
		$form->setAttribute( 'action', esc_url( $this->get_current_url( $post_id ) ) );
		$form->setAttribute( 'method', 'post' );

		// Move form builder div contents into form.
		while ( $block_container->hasChildNodes() ) {
			$form->appendChild( $block_container->firstChild ); // phpcs:ignore WordPress.NamingConventions.ValidVariableName.UsedPropertyNotSnakeCase
		}

		// Suffix field IDs and labels with the block's index from the second block onwards,
		// so IDs are unique when multiple blocks are on the same page.
		if ( $this->render_count > 1 ) {
			foreach ( $parser->xpath->query( './/*[starts-with(@id, "kit-form-builder-")]', $form ) as $element ) {
				$id     = $element->getAttribute( 'id' ); // @phpstan-ignore-line
				$new_id = $id . '-' . $this->render_count;
				$element->setAttribute( 'id', $new_id ); // @phpstan-ignore-line

				foreach ( $parser->xpath->query( './/label[@for="' . $id . '"]', $form ) as $label ) {
					$label->setAttribute( 'for', $new_id ); // @phpstan-ignore-line
				}
			}
		}

		// Add subscribed message if required.
		if ( $this->subscriber_id ) {
			$subscribed_message = $parser->html->createElement( 'div' );
			$subscribed_message->setAttribute( 'class', 'convertkit-form-builder-subscribed-message' );
			$subscribed_message->appendChild( $parser->html->createTextNode( $atts['text_if_subscribed'] ) );
			$form->insertBefore( $subscribed_message, $form->firstChild ); // phpcs:ignore WordPress.NamingConventions.ValidVariableName.UsedPropertyNotSnakeCase
		}

		// Add error notice if the submission failed, and this is the submitted block.
		// If no block index was submitted (e.g. a cached page from an older version), display it on all blocks.
		if ( is_wp_error( $this->error ) && ( ! $this->submitted_block_index || $this->submitted_block_index === $this->render_count ) ) {
			$error_id = 'convertkit-form-builder-error-' . $this->render_count;

			$error_notice = $parser->html->createElement( 'div' );
			$error_notice->setAttribute( 'id', $error_id );
			$error_notice->setAttribute( 'class', 'convertkit-form-builder-notice convertkit-form-builder-notice-error' );
			$error_notice->setAttribute( 'role', 'alert' );
			$error_notice->setAttribute( 'tabindex', '-1' );
			$error_notice->appendChild( $parser->html->createTextNode( $this->error->get_error_message() ) );
			$form->insertBefore( $error_notice, $form->firstChild ); // phpcs:ignore WordPress.NamingConventions.ValidVariableName.UsedPropertyNotSnakeCase

			// Focus the email field if it caused the error, so screen readers and
			// browsers move to it. Otherwise focus the notice, as the error isn't
			// specific to a field.
			// Query within the form, as it's not yet appended to the document.
			$email_field = $parser->xpath->query( './/input[@name="convertkit[email]"]', $form )->item( 0 );
			if ( $email_field && $this->error->get_error_code() === 'convertkit_block_form_builder_invalid_email' ) {
				$email_field->setAttribute( 'aria-invalid', 'true' ); // @phpstan-ignore-line
				$email_field->setAttribute( 'aria-describedby', $error_id ); // @phpstan-ignore-line
				$email_field->setAttribute( 'autofocus', 'autofocus' ); // @phpstan-ignore-line
			} else {
				$error_notice->setAttribute( 'autofocus', 'autofocus' );
			}
		}

		// Add hidden fields.
		$fields = array(
			'convertkit[post_id]'       => absint( $post_id ),
			'convertkit[store_entries]' => $atts['store_entries'] ? '1' : '0',
			'convertkit[redirect]'      => esc_url( $atts['redirect'] ),
			'convertkit[form_id]'       => absint( $atts['form_id'] ),
			'convertkit[tag_id]'        => absint( $atts['tag_id'] ),
			'convertkit[sequence_id]'   => absint( $atts['sequence_id'] ),
			'convertkit[block_index]'   => absint( $this->render_count ),
			'_wpnonce'                  => wp_create_nonce( 'convertkit_block_form_builder' ),
		);
		foreach ( $fields as $name => $value ) {
			$hidden = $parser->html->createElement( 'input' );
			$hidden->setAttribute( 'type', 'hidden' );
			$hidden->setAttribute( 'name', $name );
			$hidden->setAttribute( 'value', $value );
			$form->appendChild( $hidden );
		}

		// Replace div contents with form.
		$block_container->appendChild( $form );

		// Return modified content.
		return $parser->get_body_html();

	}

	/**
	 * Returns the URL of the page the form is displayed on, so the form submits
	 * back to the same page, falling back to the Post's URL.
	 *
	 * @since   3.4.6
	 *
	 * @param   int $post_id    Post ID.
	 * @return  string
	 */
	private function get_current_url( $post_id ) {

		// Fallback to the Post's URL if the request URI isn't available.
		if ( ! isset( $_SERVER['REQUEST_URI'] ) ) {
			return get_permalink( $post_id );
		}

		// Remove the subscriber ID, which is only used when visiting a link from a Kit email.
		return remove_query_arg( 'ck_subscriber_id', esc_url_raw( wp_unslash( $_SERVER['REQUEST_URI'] ) ) );

	}

}