WP Subscription Forms PRO - Documentation

Installing Instructions

  1. Unzip the file downloaded plugin from codecanyon.  You can download all your purchased files from https://codecanyon.net/downloads
  2. Upload all the files to the /wp-content/plugins/wp-subscription-forms-pro
  3. Activate the plugin through the ‘Plugins’ menu in WordPress.
  4. For customizing the plugin’s settings, click on WP Subscription Forms PRO option menu in WordPress left admin menu.

OR

  1. Open your Dashboard-> Plugins-> Add New
  2. Click on Upload Plugin
  3. Click on Choose File
  4. Select the file codecanyon-ESwvLHUm-wp-subscription-forms-pro.zip file and click Install Now
  5. Once the plugin is installed click on Activate Plugin
  6. You are done, to customize the plugin’s settings, click on WP Subscription Forms PRO option menu in WordPress left admin menu.

How to update your plugin?

As soon as you receive the update notification email from the codecanyon for our product "WP Subscription Forms PRO", you can then go to your codecanyon account's download page and then download the latest update. You can view your downloads page from below link.

https://codecanyon.net/downloads

Once you download the latest version, please deactivate and delete the existing version plugin from your site and install and activate the latest downloaded version. And yes, all your settings and forms will remain as is even after you deactivate and delete and install the new version.

If you have any confusion regarding installing the plugin then you can check the above instructions.

Basic Setup

As soon as the plugin is installed and activated, you will be able to view the WP Subscription Forms PRO menu in the left admin menu. And you can then click on that menu to see the list of subscription forms.

In this section you can view the list of all the subscriptions forms that have been created.

 

To add a form, you can click on Add Subscription Form sub menu inside the WP Subscription Forms PRO  menu and then configure the form as per your need.

There are 5 different settings section needed to configured while creating a form as below:

  1. General Settings
  2. Form Settings
  3. Layout Settings
  4. Email Settings
  5. Custom

 

General Settings

In general settings, you can configure all the basic settings for the form such as Form Title, Form Alias, Download File etc.

Here are the description of individual options available in the general settings.

  1. Form Status - This will enable and disable the form in the frontend.
  2. Form Title - This is the main title of the form for the recognition of the form everywhere.
  3. Form Alias - This is the nickname of the form which will be used in the shortcode. This shouldn't contain any special characters and space. You can use underscore(_) instead of space while entering the alias and should be unique i.e the same alias shouldn't be repeated in multiple forms.
  4. Double Opt - In - This is the new option which we had added in our Plugin Version 1.0.5. With the use of this option, you can enable the double opt in feature in form which means the entered email address won't get stored in the Site's Database and won' t receive the download link until they confirm their subscription through email.
    After enabling this option, the confirmation link will be sent to the subscribers as soon as they subscribe in the site.
  5. Opt - In Confirmation Message - This is the message which will shown to users in your site as soon as they click the confirmation link that is sent in the email. You can configure the confirmation email message in the Email settings which we will describe later within this documentation.
  6. Form Success Message - This is the message shown to the users when subscription is successful.
  7. Form Required Error Message - This is the message shown to the users if users don't fill all the necessary required fields.
  8. Form Error Message - This is the message shown to the users if the email couldn't be sent to users due to invalid email or any other server related reason.
  9. Unallowed Email Domains - This is also a new option which we had added in our Plugin Version 1.0.5. With this option, you can enter the email domains which you don't want users to enter in the subscription forms which will then prevent the subscribers from entering fake email domains for receiving the download file.
  10. Unallowed Email Error Message - This is the message that will be shown to the users when they try to subscribe through any of the unallowed email domains that you have entered in the backend settings.
  11. Mailchimp Lists / Constant Contact List - Please note that these option will only show if you have configured the necessary credentials in the "Settings" section of our plugin which will explain later within this documentation. If you have configured the necessary credentials and fetched the list of Both Mailchimp and Constant Contact then those list will show in end of the General settings panel like in the below screenshot through which you can choose the required list in which the subscriber will be automatically subscribed.

Form Settings

In this section you can configure all the form components that are available in the subscription forms. You can enable/disable and configure labels for each field.

Below are the available form components.

  1. Heading
  2. Sub Heading
  3. Name
  4. Email
  5. Terms and Agreement
  6. Subscribe Button
  7. Footer Text

Layout Settings

In this section, you can configure necessary settings related with the layout of the form. You can choose any one templates from our 30+ beautiful pre-designed templates.

Here are the options available in this section:

  1. Form Layout - This option includes the dropdown of all the available pre designed templates from which you can choose one. There are 30+ template available currently which can be checked through selecting each template.
  2. Form Width - By default each template has been provided certain specific width for each template but in case you want to customize the width then you can enter your desired width in px or in % as per your requirement.
  3. Display Type - There are two display types currently. One is Direct Display and Another one is Popup Display Type. So if you want to display the form directly when the page is loaded then you can choose the Direct Display and if you want the users to display the form in Popup through Popup Trigger then you can choose Popup Display.
  4. Popup Trigger Text - This option will only show when you will choose the Popup Display as the Display Type.

Email Settings

In this section, you can configure all the necessary email related configurations such as "From Name", "From Email" etc.

Here are the available options inside this section.

  1. From Email - In this field you can enter the email that will be used as the from email while sending any email through our plugin such as confirmation email, download link email. While entering the From Email, please make sure you don't enter the email that resembles the real person email which might land the email into the spam or junk. You can enter email such as noreply@yourdomainname which won't resemble any real person email.
  2. From Name: "From Name" is also used as while sending any email through our plugin. As similar with "From Email", you should enter the value that won't resemble any real person's name such as "No Reply".
  3. Confirmation Email Subject - This field's value will be used as the subject while sending the Confirmation Email and please note that this option will only show if you have enabled Double Opt-In option in the general settings.
  4. Confirmation Email Message - In this field, you can enter the email message that you want to send for the subscription confirmation. Please note that this option will only show if you have enabled Double Opt-In option in the general settings.

Custom

In this section you can customize the form layout through our inbuilt form layout customization options. The options available in the section comes handy when the pre designed template doesn't fulfill your needs and you want to style the form as per your need.

Here are the available customization options for the custom form styling.

  1. Text color - For customizing the overall text color of the form
  2. Button Background Color - For customizing the subscribe button background color
  3. Button Text Color - For customizing the subscribe button text color
  4. Button Hover Color - For customizing the subscribe button background color on hover
  5. Button Hover Text Color - For customizing the subscribe button text color on hover
  6. Loader Color - For customizing the loader color
  7. Background Type - For customizing the background of the form
  8. Popup Button Text Color - For customizing the text color of the popup button
  9. Popup Button Background Color - For customizing the background color of popup button
  10. Popup Button Hover Color - For customizing the popup button text color on hover
  11. Popup Button Hover Background Color - For customizing the popup button background color on hover
  12. Custom CSS - If you need to enter any custom CSS to override the existing styling of our form then you can enter in this field.

 

Delayed Popup & Floating Forms

To enable the delayed popup or floating forms for specific page, there is an option box available in the page edit section from which you can enable the popup for that specific page.

Subscribers List

In this section, you can view all the subscribers that have subscribed through the different subscription forms and also filter the subscribers as per the different subscription forms and also export them to CSV for further external use.

Settings

In this section you can configure the Mailchimp Settings, Constant Contact Settings and some global settings.

Mailchimp Settings

To integrate the Mailchimp in any subscription forms, Mailchimp shall be configured here. To configure Mailchimp, it will need an API key which can be generated from here.

After adding an API key, you will need to connect by clicking on connect button.

After clicking on connect, if the API key is correct then it shall fetch all the list from your Mailchimp account and show like in the below screenshot.

The Last Log field will also show the API log of the last subscription if the subscriber is sent to the Mailchimp selected list or not.

Constant Contact Settings

To integrate Constant Contact in the subscription forms, you will need to configure the Constant Contact necessary details in settings. For configuring the Constant Contact, it requires Constant Contact API key and Access Token.

Please go here to generate your api keys and access tokens and please go here to know how to generate necessary keys

Before connecting it shall show like below screenshot.

After connection, if both the keys are correct then it will fetch all the list available in your Constant Contact account and will show like in below screenshot.

Developer Documentation

In case you want to extend or modify any functionality in the plugin from outside the plugin using hooks and filters then we have added some necessary hooks and filters in the plugin which we have listed in detail inside the Help section of our plugin.

So if required then you can check all the available hooks and filter inside the help section of our plugin.