Plugin - Mailchimp (Create custom newsletter subscription forms)

Downloading and Installing the plugin

Download

You can download the plugin by logging with your purchase user, then head to Downloads > Paid Downloads > RSForm!Pro > Modules & Plugins > "Mailchimp xx".

Install

In the backend of your Joomla! installation go to Extensions > Manage > Install, and upload and install the plugin. Next thing would be to check if the plugin is published, and to do so, navigate to Extensions > Plugins, search for the "System - RSForm! Pro Mailchimp" plugin and ensure it is published.

Enabling the integration

In order for the plugin to work you will have to enable it from Extensions > Plugin Manager, enter your Mailchimp API Key in Components > RSForm!Pro > Configuration > Mailchimp and then set the plugin parameters.

Your mailchimp API Key can be found here.

In case you have connection related issues the Maximum number of records to retrieve can be decreased and or the Connection Timeout can be increased (these will eventually depend on your Mailchimp data and hosting server capabilities).

Once you have added the API Key, go to RSForm!Pro » Manage Forms and edit the form where you want to use the RSForm!Pro - Mailchimp Plugin. You will notice that one more tab has appeared.

This tab will allow you to setup the integration:

• first you will need to enable the integration
• select the action:
  • subscribe - users will be subscribed automatically
  • unsubscribe - users will be unsubscribed automatically
  • let the user decide - If you allow the user to select his own subscribe option, make sure the field you use has the following values set: subscribe and unsubscribe. Any other value provided and the subscription will be ignored.
• choose the list you will be working with (defined in your Mailchimp account)
• select the email type: HTML, text or mobile
• map the form components to your desired list fields for the "Merge Vars","Interest groups" sections.

The integration also offers the possibility to set up some additional parameters regarding the Subscribe and Unsubscribe processes:

Subscribe

• Double Opt-In: No/Yes - Set to Yes in order to send a confirmation message when the user subscribes
• Trigger tags automations: No/Yes - This option will let the tags automations to be trigger when the tag is added/updated. If any available.
• Update if email already exists?: No/Yes - Set to Yes in order to have subscribers updated (if they already exist). Otherwise, an error will be thrown
• Append Tags if email already exists: No/Yes - Activating this option will not update current tags for the existing email address, it will append the new ones to the old ones if they are different.
• Replace Interests ?: No/Yes - Set to Yes in order to replace the existing interests with the provided ones. Otherwise, both the old and new interests will be kept
• Language Code: Supply a valid language code (eg. en for English, de for German etc) or use a placeholder that returns a language code (eg. {global:language})

Unsubscribe

• Delete Member ?: Set to Yes to have the member deleted when he unsubscribes

Merge Vars

On the left side you will find the fields of your Mailchimp list. You can map them to RSForm! Pro fields, so that they will automatically be populated with user-supplied data. Please map all required fields.

Interest Groups

Using the option from this section, you will be able to assign Interest groups to your subscribers.

The existing interest groups will be automatically retrieved from your Mailchimp account and listed below. In case you are creating a selection field, in order the user to select his interest group, you will have to use the exact values listed in this section.

Tags

You can add your desired tags or you can choose from the tags that you already defined. Please do not forget to separate them by a comma if you want to use multiple tags.

The existing tags will be automatically retrieved from your Mailchimp account and listed below.