Plugin - Campaign Monitor (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 > My Downloads > RSForm!Pro - view all plugins and modules > RSForm!Pro Files > Plugins > "Campaign Monitor Plugin form Joomla! 3.x".

Install

In the backend of your Joomla! installation go to the Extensions > Install/Uninstall page, and install the plugin. Next thing is to publish the plugin, to do this go to Extensions > Plug-in Manager, search for the "RSForm! Pro - Campaign Monitor" plugin and publish it.

Configuring the plugin

Configuring Campaign Monitor can be done from Components >> RSForm!Pro >> Configuration >> Campaign Monitor tab:

• API Key: The API Key associated with your Campaign Monitor Account
• Client ID: The Client ID code associated with your Campaign Monitor Account

Enable Campaign Monitor Integration

• Head to Components > RSForm!Pro > Manage Forms > Select your form > Properties
• Click on the "Campaign Monitor" tab from the left sidebar
• Set to "Yes" the "Enable Campaign Monitor Integration" option
• The "Action" can be set to either "Subscribe" the user upon submission or based on their choice (by setting it to "Let the user decide"). If you allow the user to select their own subscribe option, make sure the field you use has the precise subscribe value (any other provided value will ignore the subscription process). Example, using a checkbox with the following item:



subscribe|I want to subscribe to your newsletter campaign.

• The "Allow users to provide permission for their email opens and clicks to be tracked" option is optional and upon enabling, a new property "Consent Track Field" will be provided which can be mapped to one of your fields that should always return 1 as its value, implying the user has given their consent (e.g. you can use a checkbox that has only one Item: 1|I agree).
• Click on "Create Default List" button in order to automatically crete a subscriber list or you can manually crete a subscriber list by following these indications.
• Select your Campaign Monitor subscriber list using the "Select a list" option


Note: If "Update contact if exists" option is enabled, when the form is submitted the already existing user information from Campaign Monitor will be updated instead of creating a new entry.
• The next step is to map the information submitted in the form to Campaign Monitor fields. This can be easily done by selecting the RSForm!Pro field that will be used for a particular Campaign Monitor field using the dropdown located next to the field name.
  
  
Note: In order to properly record a new entry in your Campaign Monitor contact list you will need to have at least the following fields available in your form:
• Name - a textbox field for the user to fill in his name
• Email - a textbox field for the user's email address
Also, note that your custom fields(Ex: Phone Number) can be added directly from your Campaign Monitor account. More informations are provided in Campaign Monitor help section.
• Save
• Head over to frontend area and submit the newly configured RSForm!Pro form
• Check your selected Campaign Monitor subscriber list for new entries

Tutorial: How to create a signup form for Campaign Monitor

Generate your Campaign Monitor API key

• Head to Campaign Monitor website and create an account
• Activate the account using the link sent to the email address used in the registration process

• Login into your Campaign Monitor account

• Head to My Account > Account Settings > API keys

• Click on "Show API Key" link