From 1ca69ac0a63bfa5f068689889a86f3cfb2ea3cc8 Mon Sep 17 00:00:00 2001 From: Rahul Shinde Date: Wed, 1 Jan 2025 10:24:18 +0530 Subject: [PATCH 1/3] Updated user documentation for the Readonly behaviour --- docs/components/forms.rst | 1 + 1 file changed, 1 insertion(+) diff --git a/docs/components/forms.rst b/docs/components/forms.rst index 9678abe9..d3da8986 100644 --- a/docs/components/forms.rst +++ b/docs/components/forms.rst @@ -259,6 +259,7 @@ The Behavior tab helps marketers to improve the experience for the visitor compl - **Show when value exists**: if Mautic knows the Contact and they're tracked, when a value exists for a field Mautic hides the field when this setting is No. This prevents the Contact answering the same question multiple times. You may want to display the field even if it's already known when you want to ensure you have the most up to date information about the Contact. - **Show after X submissions**: this allows the marketer to show certain fields only when the Contact has submitted the Form a specified number of times. Enter a value between ``1`` and ``200``. When left undefined, the field shows every time the Contact views the Form. The goal is to minimize the number of fields shown to the Contact, so it's recommended to hide fields if it's not necessary to verify the values. - **Auto-fill data**: this allows you to pre-populate Contact data with known Contacts where the information exists in the Contact profile. Auto-fill works with Mautic Landing Pages, and data won't pre-populate when placing the Form anywhere else. Even if you're hiding this field, you may wish to turn on auto-fill to ensure saving of the information with the Form submission. +- **Read only**: When enabled, auto-filled fields containing pre-existing contact information will be locked and cannot be edited. This permits the data to be submitted with the Form while guaranteeing the accuracy and consistency of important data, including email addresses. When Auto-fill data is enabled, this setting becomes accessible. When you want to make sure that the Contact doesn't change any important information when submitting the form, use this option. Field order ----------- From ec26ed13b722baffba9d682a775314ab8b610fb3 Mon Sep 17 00:00:00 2001 From: Rahul Shinde Date: Wed, 1 Jan 2025 10:38:42 +0530 Subject: [PATCH 2/3] Updated user wordings --- docs/components/forms.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/components/forms.rst b/docs/components/forms.rst index d3da8986..a8d5abc8 100644 --- a/docs/components/forms.rst +++ b/docs/components/forms.rst @@ -259,7 +259,7 @@ The Behavior tab helps marketers to improve the experience for the visitor compl - **Show when value exists**: if Mautic knows the Contact and they're tracked, when a value exists for a field Mautic hides the field when this setting is No. This prevents the Contact answering the same question multiple times. You may want to display the field even if it's already known when you want to ensure you have the most up to date information about the Contact. - **Show after X submissions**: this allows the marketer to show certain fields only when the Contact has submitted the Form a specified number of times. Enter a value between ``1`` and ``200``. When left undefined, the field shows every time the Contact views the Form. The goal is to minimize the number of fields shown to the Contact, so it's recommended to hide fields if it's not necessary to verify the values. - **Auto-fill data**: this allows you to pre-populate Contact data with known Contacts where the information exists in the Contact profile. Auto-fill works with Mautic Landing Pages, and data won't pre-populate when placing the Form anywhere else. Even if you're hiding this field, you may wish to turn on auto-fill to ensure saving of the information with the Form submission. -- **Read only**: When enabled, auto-filled fields containing pre-existing contact information will be locked and cannot be edited. This permits the data to be submitted with the Form while guaranteeing the accuracy and consistency of important data, including email addresses. When Auto-fill data is enabled, this setting becomes accessible. When you want to make sure that the Contact doesn't change any important information when submitting the form, use this option. +- **Read only**: activate this setting to lock auto-filled fields with existing contact information, preventing any edits by Contacts. This ensures that the data submitted with the Form remains accurate and consistent, especially for critical details like Email addresses. Enable this option together with Auto-fill data to stop Contacts from changing essential information during Form submission. Field order ----------- From 112abe16f8a5e7e5148da3305c136a2462e5a6b5 Mon Sep 17 00:00:00 2001 From: Rahul Shinde Date: Wed, 1 Jan 2025 10:43:17 +0530 Subject: [PATCH 3/3] Apply suggestions from code review --- docs/components/forms.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/components/forms.rst b/docs/components/forms.rst index a8d5abc8..9eca46ef 100644 --- a/docs/components/forms.rst +++ b/docs/components/forms.rst @@ -259,7 +259,7 @@ The Behavior tab helps marketers to improve the experience for the visitor compl - **Show when value exists**: if Mautic knows the Contact and they're tracked, when a value exists for a field Mautic hides the field when this setting is No. This prevents the Contact answering the same question multiple times. You may want to display the field even if it's already known when you want to ensure you have the most up to date information about the Contact. - **Show after X submissions**: this allows the marketer to show certain fields only when the Contact has submitted the Form a specified number of times. Enter a value between ``1`` and ``200``. When left undefined, the field shows every time the Contact views the Form. The goal is to minimize the number of fields shown to the Contact, so it's recommended to hide fields if it's not necessary to verify the values. - **Auto-fill data**: this allows you to pre-populate Contact data with known Contacts where the information exists in the Contact profile. Auto-fill works with Mautic Landing Pages, and data won't pre-populate when placing the Form anywhere else. Even if you're hiding this field, you may wish to turn on auto-fill to ensure saving of the information with the Form submission. -- **Read only**: activate this setting to lock auto-filled fields with existing contact information, preventing any edits by Contacts. This ensures that the data submitted with the Form remains accurate and consistent, especially for critical details like Email addresses. Enable this option together with Auto-fill data to stop Contacts from changing essential information during Form submission. +- **Read only**: activate this setting to lock auto-filled fields with existing Contact information, preventing any edits by Contacts. This ensures that the data submitted with the Form remains accurate and consistent, especially for critical details like Email addresses. Enable this option together with Auto-fill data to stop Contacts from changing essential information during Form submission. Field order -----------