Clarify global default Preference Center resolves live at unsubscribe time#787
Open
promptless-for-oss wants to merge 1 commit into
Open
Conversation
… time Update the Default Preference Center Landing Page setting and the preference_center fallback note to reflect mautic/mautic PR #16352: the global default is no longer copied onto Emails at creation, but resolved at unsubscribe time for any Email without its own Preference Center.
| * **Show Contact's preferred Channel option** - If you have multiple Channels available within your Mautic instance. For example; Email, ``SMS``, mobile push, web notifications, etc., Contacts can choose their preferred Channel. This can be useful if you are using the Marketing Messages feature of Mautic. More information about the Preference Center is available :doc:`here</contacts/preference_center>`. | ||
|
|
||
| * **Default Preference Center Landing Page** - Select a Landing Page to use as the Preference Center for new Emails. When creating a new Email, this Landing Page pre-populates the Preference Center field. Editing an existing Email or cloning an Email doesn't change that Email's Preference Center, even if the clone source has no Preference Center set. Read the :doc:`/contacts/preference_center` section for more information. | ||
| * **Default Preference Center Landing Page** - Select a Landing Page to use as the global default Preference Center. When a Contact unsubscribes, Mautic applies this default to any Email that doesn't have its own Preference Center, including Emails you created before setting the default and Emails you've already sent. Mautic resolves the default at unsubscribe time rather than copying it onto each Email when you create it, so changing this setting immediately updates the Preference Center for every Email without its own selection. Emails that have a Preference Center selected always use that Page. If the default Landing Page is missing, unpublished, or no longer marked as a Preference Center, Mautic falls back to its standard unsubscribe behavior. Read the :doc:`/contacts/preference_center` section for more information. |
Contributor
Author
There was a problem hiding this comment.
Rewrote the Default Preference Center Landing Page setting because PR #16352 changes EmailDefaultsHelper to stop copying the global default onto new Emails (applyPreferenceCenterDefault was removed from applyDefaults) and instead resolves it at unsubscribe time via the new resolvePreferenceCenter() called from PublicController::unsubscribeAction. The resolver returns null when the default Page is missing, not a Preference Center, or unpublished, which the new fallback wording reflects.
Source: mautic/mautic#16352
| | | ||
|
|
||
| If you don't select a Preference Center in an Email, Mautic uses the default Preference Center styled with the default Theme. | ||
| If you don't select a Preference Center in an Email, Mautic uses the global default Preference Center set in **Configuration > Email Settings**, resolved at the time a Contact unsubscribes. If you change the global default later, any Email without its own Preference Center, including Emails you've already sent, automatically uses the new default. If there's no valid global default, Mautic falls back to a default Preference Center styled with the default Theme. |
Contributor
Author
There was a problem hiding this comment.
Expanded the fallback note because PR #16352 makes the global default a live default: EmailType no longer pre-populates the Preference Center field (only UTM defaults are persisted), and unsubscribeAction resolves the current email_default_preference_center_id at unsubscribe time, so changing the global default applies to already-sent Emails without their own Preference Center.
Source: mautic/mautic#16352
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Open this suggestion in Promptless to view citations and reasoning process
Updates the Default Preference Center Landing Page setting description and the Preference Center fallback note to reflect mautic/mautic PR #16352. Mautic no longer copies the global default onto Emails at creation; it resolves the current global default at unsubscribe time for any Email without its own Preference Center, so changing the default now applies to existing unsent and already-sent Emails.
Trigger Events
Tip: Request one-off documentation tasks in the Dashboard under New Task 🚀