MailChimp Integration -- Shortcode: Subscription Form
Overview
Popup Maker registers a 'Subscription Form' shortcode with WordPress ( tag: [pum_sub_form] ) that is available to all plugin users. The MailChimp Integration plugin extension adds features to this shortcode specific to the use of MailChimp.
Shortcode Features Added in the 'Subscription Form' Box
'General' ( tab )
Service Provider ( menu-option ) -- Plugin default: Default. Adds a menu option to set the newsletter service provider to MailChimp. To link the subscription form to a MailChimp account, change the value from 'Default' to 'MailChimp'.
Shortcode attributes (visible from the editor 'Text' tab):
<!--The shortcode attribute for the newsletter service provider.--> <!--The plugin default option is 'Default' which does not display <!--the attribute (attribute is set to NULL).--> [pum_sub_form provider="no attribute | mailchimp | none" ]
'MailChimp' ( tab ) >> 'General' ( category )
List ( menu-option ) -- Link the subscription form to a specific MailChimp list.
Shortcode attributes (visible from the editor 'Text' tab):
<!--The shortcode attribute for the newsletter list ID-->
<!--The list ID attribute is passed from the MailChimp API key.-->
[pum_sub_form list_id="{alpha_numeric_string}"]
Update if Exists (checkbox) -- Plugin default: unchecked. When checked, allow existing members to update their list information via the popup subscription form.
Shortcode attributes (visible from the editor 'Text' tab):
<!--The shortcode attribute to update the name and interests for--> <!--for a list member. <!-- value = 'unchecked' (plugin default)--> no attribute displayed [pum_sub_form update_if_exists]
Enable Double Opt-in ( menu-option ) -- Plugin default: 'disable' (off). Set or disable double opt-in for new list subscribers.
Shortcode attributes (visible from the editor 'Text' tab):
<!--The shortcode attribute to set double opt-in for new list--> <!--subscribers. The plugin default is the first value shown below.--> [pum_sub_form double_opt_in="disable | enable" ]
'MailChimp' ( tab ) >> 'Interest Groups' ( category )
Display interest groups from a MailChimp list to add to a Popup Maker subscription form.
Shortcode attributes (visible from the editor 'Text' tab):
<!--The shortcode attribute for MailChimp list interest groups.-->
<!--The plugin default value is the first value shown below.-->
<!--If the list contains no interest groups, or no interest-->
<!--groups are selected:-->
no attribute displayed
<!--Each group number is an alphanumeric string of characters.-->
[pum_sub_form interests="{group_1}, {group_2}, ..{group_n}" ]<br>
Related article: Manage Groups in Advanced Forms ( MailChimp documentation ).
'MailChimp' ( tab ) >> 'Merge Fields' ( category )
Select the MailChimp list merge fields to display within the popup form.
Related article: Getting Started with Merge Tags for Email ( MailChimp documentation ).
Shortcode attributes (visible from the editor 'Text' tab):
<!--The shortcode attribute for each MailChimp merge field ID.-->
<!--If the list contains no merge tags, or no merge fields are-->
<!--selected:-->
no attribute displayed
<!--Each merge_id is an alphanumeric string of characters.-->
[pum_sub_form fields="{merge_id_1}, {merge_id_2}, ..{merge_id_n}" ]
'Actions' ( tab ) >> 'MailChimp' ( category )
Adds a ‘MailChimp’ option category to the 'Actions' option tab. Select the MailChimp automation events to trigger when the form popup is submitted.
Related article: About Automation ( MailChimp documentation ).
Shortcode attributes (visible from the editor 'Text' tab):
<!--The shortcode attributes for the MailChimp automation trigger.--> <!--If no automations are set for this list, or no--> <!--automations are selected:--> no attribute displayed [pum_sub_form automations automation_emails ]
Refer to the documentation article 'Shortcode: Subscription Form' for each of the shortcode's remaining option tab settings:
- Form,
- Privacy, and
- Actions