<?php
/**
 * A form plugin whose sign-ups can be passed on to 404 Emails (Contact
 * Form 7, WPForms, Elementor forms) - see Form_Connections.
 *
 * Each source describes its forms in one shape:
 *
 *     array(
 *         'id'     => '12',                 // the form's id in that plugin
 *         'title'  => 'Contact form',
 *         'fields' => array(
 *             array( 'key' => 'your-email', 'label' => 'Email', 'kind' => 'email' ),
 *             array( 'key' => 'news', 'label' => 'Send me news', 'kind' => 'consent', 'invert' => false ),
 *         ),
 *     )
 *
 * `kind` is one of the Form_Connections::KIND_* constants. `key` is how the
 * field's value is found in a submission's values.
 *
 * @package Emails404
 */

namespace Emails404;

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

interface Form_Source_Interface extends Integration_Provider_Interface {

	/** Every form on the site, in the shape described above. */
	public function list_forms();

	/**
	 * One form, or null when it no longer exists.
	 *
	 * @param string $form_id
	 * @return array|null
	 */
	public function describe_form( $form_id );
}