With this plugin you will be able to create custom subscribing forms for RSMail!.
Tutorial - Using RSForm!Pro - RSMail! plugin
The RSForm!Pro - RSMail! integration consists out of a system plugin that once installed and enabled will allow you to add custom subscribing forms for your RSMail! newsletters. In this tutorial, you will learn how to install the plugin and apply the integration.
In order to make the plugin work, you need:
- Joomla! 1.5, 2.5 or 3.x
- Latest revision of RSForm! Pro
- Latest revision of RSMail!
Getting the RSForm!Pro - RSMail! plugin
In order to download the RSForm!Pro - RSMail! plugin you must have at least one active subscription of RSForm!Pro. Simply go to the My Downloads section of our website (You must be logged-in in order to see the My Downloads section).
In the list of downloads go to the RSForm!Pro section, and download the RSMail! Plugin.
Installing the plugin
Once you have downloaded the RSForm!Pro - RSMail! plugin, you can install it using the default Joomla! installer (Extensions > Extension Manager).
The RSForm!Pro - RSMail! plugin should auto-publish itself, but if that doesn't happen, you can go to Extensions / Plugin Manager and enable it. The plugin is located in the System group and you can identify it by the name of System - RSForm! Pro - RSmail!
Enabling the RSMail! integration on your form.
Once the plugin has been installed and published, within the Components > RSform!Pro > Manage Forms > edit a form > Properties area, you will notice a new Extra option, for RSMail!.
Clicking on the RSMail! extra option will open up the following configuration options.
- Use RSMail! integration: allows you to enable or disable the RSMail! integration for your current form.
- Action: submitting the form will perform the selected action. You can choose one of the three options: Subscribe, Unsubscribe or Let the user decide. If the Let the user decide option is selected, you will have to assign a form field that will decide the action. 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. If these values are not found, the user will be subscribed by default.
- List ID: allows you to specify to which RSMail! list you will add the subscriber to. This is automatically populated, with all your published lists.
- Only After Email Confirmation: Yes / No - if you are using submission confirmation, set this to Yes in order to only add the subscriber to the list once the submission is confirmed.
- The next step is to actually specify which RSform!Pro field goes into what list column. On the left side you will find the fields from RSMail! list. You can map them to RSForm! Pro fields, so that they will automatically be populated with user-supplied data.
After mapping the list fields to the RSForm!Pro components, users will be able to fill in the custom form in front-end and subscribe to newsletter.
RSMail! Subscribers list
After subscribing to newsletter, users will be saved in the RSMail! newsletter list.
e.g.: In our example, the subscribers will be saved in the "My subscribers" list.
To view the subscribers list, in the Joomla! back-end panel, head to Components >> RSMail! >> Subscribers and select the newsletter list.