double-opt-in / src / Integration / FieldTextProviderInterface.php

FieldTextProviderInterface.php in Double Opt-In for Contact Form 7 – Secure, GDPR-Compliant Email Verification 5.9.0, at src/Integration/FieldTextProviderInterface.php

36 lines 991 B

Raw Download Zip

1	<?php
2	/**
3	* Optional for form integrations: the text a visitor reads next to a field.
4	*
5	* The consent text stored with each opt-in is typed in by hand. When it no
6	* longer matches the wording next to the form's checkbox, the proof records
7	* a sentence the visitor never saw. With this text the form settings can
8	* say so and copy the real wording over.
9	*
10	* Optional on purpose: integrations that do not implement it lose nothing,
11	* and add-ons can also answer through the `f12_doi_form_field_texts` filter.
12	*
13	* @package Forge12\DoubleOptIn\Integration
14	* @since 5.9.0
15	*/
16
17	declare( strict_types=1 );
18
19	namespace Forge12\DoubleOptIn\Integration;
20
21	if ( ! defined( 'ABSPATH' ) ) {
22	exit;
23	}
24
25	interface FieldTextProviderInterface {
26
27	/**
28	* Visible text per field name, plain text. Fields without one are left out.
29	*
30	* @param int\|string $formId The form ID (composite for Elementor).
31	*
32	* @return array<string, string>
33	*/
34	public function getFieldTexts( $formId ): array;
35	}
36