| @@ -332,8 +332,9 @@ | ||
| 332 | 332 | | `f12_cf7_doubleoptin_error_message` | `$message` (string), `$error` (OptInError), `$formId` (int) | `string` | Customize the error message per error code (since 4.2.0) | |
| 333 | 333 | | `f12_cf7_doubleoptin_validate_recipient` | `$valid` (bool), `$recipient`, `$formData` | `bool\|string` | Validate recipient email; return error string to reject | |
| 334 | 334 | | `f12_cf7_doubleoptin_send_default_mail` | `$send` (bool), `$formId` | `bool` | Whether to send the original form mail after confirmation | |
| 335 | 335 | | `f12_doi_submit_notice_data` | `$notice` (array: `masked`, `lines`, `inbox`, `actions`), `$context` (array: `form_id`, `optin_id`, `integration`) | `array` | The hint shown after a CF7 double opt-in submission. Add `lines`, or `actions`: links (`type` `link`, `url` must be https) or buttons (`id`, `label`, optional `wait` in seconds and scalar `data`). A button fires the DOM event `f12-doi-notice-action` on the form with `{ id, data, button, form }`. `$context` stays on the server; sign your own token into `data` if your script needs to refer back to the opt-in (since 5.8.0) | |
| 336 | +| `f12_doi_form_field_texts` | `$texts` (array: field name => plain text), `$formId` (int\|string), `$integration` (string) | `array` | The text a visitor reads next to a field, typically a consent checkbox. The form settings compare it with the stored consent text and offer to take it over. Contact Form 7 fills it from `[acceptance]…[/acceptance]`; a form integration can implement `FieldTextProviderInterface` instead of using the filter (since 5.9.0) | | |
| 336 | 337 | | `f12_doi_enforce_consent_gate` | `$enforce` (bool), `$formId` (int), `$integration` (string) | `bool` | Return `false` to accept a submission whose configured acceptance field was not confirmed. The opt-in is then stored with a consent text nobody agreed to, so this is an escape hatch for an unforeseen edge case, not a setting (since 5.4.0) | |
| 337 | 338 | |
| 338 | 339 | ### Mail Filters |
| 339 | 340 | |
| @@ -351,9 +352,8 @@ | ||
| 351 | 352 | | Filter | Parameters | Return | Description | |
| 352 | 353 | |--------|-----------|--------|-------------| |
| 353 | 354 | | `f12_cf7_doubleoptin_save_form` | `$data` (array) | `array` | Modify form settings before saving | |
| 354 | 355 | | `f12_cf7_doubleoptin_metadata_cf7` | `$metadata` (array) | `array` | Modify CF7 form metadata | |
| 355 | -| `f12_cf7_doubleoptin_metadata_avada` | `$metadata` (array) | `array` | Modify Avada form metadata | | |
| 356 | 356 | | `f12_doi_form_settings_data` | `$formData`, `$formId` | `array` | Modify form settings data before sending to frontend | |
| 357 | 357 | | `f12_doi_form_settings_before_save` | `$settings`, `$storageId`, `$settingsData` | `FormSettingsDTO` | Modify FormSettingsDTO before saving | |
| 358 | 358 | | `f12_doi_settings_dto_from_array` | `$dto`, `$data` | `FormSettingsDTO` | Modify DTO when creating from array | |
| 359 | 359 | | `f12_doi_settings_dto_to_array` | `$array`, `$dto` | `array` | Modify array representation of DTO | |
| @@ -358,8 +358,9 @@ | ||
| 358 | 358 | | `f12_doi_settings_dto_from_array` | `$dto`, `$data` | `FormSettingsDTO` | Modify DTO when creating from array | |
| 359 | 359 | | `f12_doi_settings_dto_to_array` | `$array`, `$dto` | `array` | Modify array representation of DTO | |
| 360 | 360 | | `f12_doi_is_pro_active` | `$isActive` (bool) | `bool` | Whether the Pro version is active | |
| 361 | 361 | | `f12_cf7_doubleoptin_use_new_integration_system` | `$use` (bool) | `bool` | Enable/disable the new integration system | |
| 362 | +| `f12_doi_help_sources` | `$sources` (HelpSource[]) | `HelpSource[]` | Add or replace the sources of the in-plugin help articles (an add-on whose `help/` folder is not next to its `src/`) | | |
| 362 | 363 | |
| 363 | 364 | ### Filter Examples |
| 364 | 365 | |
| 365 | 366 | ```php |