View Source

Overview

With the MailUp plugin you can easily add a newsletter sign-up form to your Web site or blog, and then send and track email and sms with MailUp

What it does

Visitors to your WordPress-powered blog or Web site will be able to subscribe to your newsletter using a configurable sign-up form. Their information will be saved in your MailUp account.
You will use your MailUp admin console to manage those subscribers, create and send messages to them, view statistics on sent messages, and more.
The MailUp plugin supports the recommended 'confirmed opt-in' subscription method (i.e. subscriber receives an email with a confirmation link that has to be clicked to confirm the subscription). This method ensures that spam traps or wrong email addresses are never added to your list.
The unsubscription process will be managed automatically by MailUp (e.g. unsubscribe link in the footer of your messages).
MailUp supports SMS (text messaging) too, so you can choose to collect a mobile phone number as well.
It also supports sign-up via a social networking account (additional fees apply: see the MailUp web site for details).

How to use it

Signup for a free trial (no credit card required): English / Italiano
Create one or more Lists (e.g. two WordPress sites: you will create two Lists in MailUp).
Install the plugin in your WordPress admin area, as described below
Configure settings such as the header, footer, message templates, confirmation request email, welcome message, etc.
Visitors to your Web site will start signing up, and you will be able to track the subscription trend over time in your MailUp admin console.
Create and send email and/or text (SMS) messages to your subscribers.
Use the NEW MESSAGE FROM RSS feature to create a newsletter from RSS feeds (a list of recent articles from your WordPress-powered blog). Just select the posts and choose a template and priority. You will be able to edit the newsletter after it has been automatically created, before you send it, without any copying and pasting.
MailUp automatically manages the unsubscribe process and gives you access to statistics down to the individual recipient level (opens, clicks, social sharing, etc.)

Installing the MailUp plugin for WordPress

Download plugin from WordPress Directory
Copy it to /wp-content/plugins/ folder
Activate the plugin through the Plugins page (wp-admin/plugins.php)
Add the widget to your sidebar on the Widgets page (wp-admin/widgets.php)
Configure "WP MailUp" plugin through admin page. Please use "?" buttoms to obtain help when something is not clear. No file editing required.
Open MailUp console and register IP address of your server (go to "Manage->Web service" and then select "frontend" in the dropdown menu to insert IP address of your server. More than one address could be registered)

Configuring the plugin

After installing the plugin as described above, access the WordPress administration panel and selectSettings > WP MailUp in the left-side navigation menu.

MailUp Integrations > WordPress > wp_settings_menu.png

The setup page will be displayed.

MailUp Integrations > WordPress > wp_settings_general.png

Configure the settings in each section as described below. Please note that all the data required to configure the plugin is available in your MailUp console under "Settings > Codes Table".

General Data

Use this section to configure general properties, including the MailUp account URL, form title, etc.

Feature	Description	Default Value	Example
Console host	MailUp console URL		abcd.sp09.it
Subscribe path	Subscription page name and path (do not modify this entry)	/frontend/xmlSubscribe.aspx
Plugin Title	Subscription form title shown where the widget is placed		"Sign up for our newsletter!"
Description	Text shown under the title		“Enter your information and press SEND”
Select preloaded CSS for widget	Menu a tendina per scegliere lo stile da applicare. Si può scegliere tra i quattro file CSS disponibili [1]
Submit Button	Text used for the submit button		“SIGN UP”
Request confirmation by email	Check this option to require that new subscribers confirm their subscription (recommended)	Checked

[1] You can change the style of the sign up form as shown here.

List

This section refers to which List the new subscriber will be added to. MailUp accounts support multiple lists.

Field	Description
List ID (REQUIRED)	Numeric list identifier. You can locate the ID in your MailUp console under "Settings > Codes Table".
List displayed name (NOT REQUIRED)	Not currently in use
Group ID (NOT REQUIRED)	Numeric group identifier within the list. You can locate the IDs in your MailUp console under "Settings > Codes Table". You can add the same person to multiple groups by entering multiple IDs separated with a ";"

Personal Data Fields

The subscription form can pass up to four separate pieces of information to MailUp. Either the email or the mobile phone number must be sent to MailUp for the user to be added to the system, so you must make at least one of those two fields required. The other two fields can be associated with any of the additional fields used in your MailUp console under "Manage > Personal Data Fields".

Check "Show" to show the field in the widget
Check "Req." to make the field required
The field code must match a valid field code in your MailUp console. "Email" and "sms" should not be altered. The other field codes can be any of the field codes available in your MailUp console, and they can be located under "Settings > Codes Table". For example, you could ask for First and Last Name.
You can use as few as 1 field and as many as 4 fields. In the example below, 3 fields are used.

MailUp Integrations > WordPress > wp_settings_fields.png

Here is how the plugin looks by default on customer-facing pages:

MailUp Integrations > WordPress > wp_form.png

Error Messages

Here you can edit the error messages that are shown when the submit button is pressed, if there is an issue.

Error type	Example
Success	“Thank you for subscribing to our newsletter. Check your email to confirm your subscription.”
Generic error	“There was an issue. Please try again.”
Invalid address	“The email address is not valid”
Already present	“It looks like you're already a subscriber!”

Terms and conditions

You can display terms and conditions of the subscription so that the new subscriber can have the opportunity to review them and agree to them.

Field	Description
Include acceptance of terms and conditions	If active, a checkbox is shown and is required.
Terms and conditions	Enter the terms and conditions.
Acceptance	Enter the statement that will be shown next to the checkbox (e.g. "I agree to these terms"

Styling the plugin

You can customize the look of the MailUp plugin for WordPress as described below.

First, select the Plugins Editor in the WordPress administration area...
Select “WP-MailUp” from the drop-down menu
A list of files will be displayed, including 4 CSS documents: “style1.css”, “style2.css”, “style3.css”, “style4.css”.
Select a file to modify it.
Click on "Update File" to save your modifications. We recommend that you backup the code before making any changes. If you don't see the "Update File" button, you probably don't have sufficient permissions in your WordPress installation. Contact your WordPress site administrator.
The form is identified by the selector “#subscribeForm” in the CSS document
Make sure that any style you add or modify uses the “#subscribeForm” selector to avoid conflicting with other styles, which could negatively affect the rest of your Web site

FAQs and Troubleshooting

Do I have to be a MailUp customer to use it?

You must have activated a MailUp console (a regular one or a 30 days trial) and then specify console URL in plugin settings. On MailUp you must enable requests coming from the server that hosts your WordPress site (go to "Manage->Web service" and then select "frontend" in the dropdown menu to insert IP address of your server. More than one address could be registered).

How can I configure my plugin?

Go to admin panel, press "Settings" and then select "WP MailUp". Fill in or check all the fields using help buttons if something is not clear

How can I check if my plugin is working?

Just fill in required fields and press SEND button to subscribe. Specified contact will be added in the MailUp distribution list specified in system settings

How often do I have to change configuration?

In most of cases configuration is set once and no more changes are required.

I would change plugin appearance: how can I do?

You can select between four available styles (CSS), if no one matches with your need you can edit one of existing CSS files (style1.css, ..., style4.css). Please note that editing is allowed only for users who have read/write access to those files.

May I have a one-click sign-up using a social account (ie Facebook) ?

Yes, MailUp provides a simple integration with all the most used social networks. You could insert into your web site a simple banner "Click here to subscribe to our newsletter using your Facebook account". This features is a standard one and you don't need to install any plugin, just activate a MailUp account.

Is it possible to translate this plugin?

Yes, just edit each string within the settings panel. No need to edit any file. MailUp supports all the charsets.

Why using this plugin and not other services, like feedburner?

MailUp allows you to take control on subscribers (view, import, edit, delete, export) and on messages (define scheduling, content and recipients).

Can I disable the plugin?

Yes, just delete reference to console host.

Configuration seems to be correct, but plugin always return a "generic error" message

Starting from v.7.4, MailUp introduces a security restriction that allows only calls from servers whose IP address is registered on MailUp console (go to "Manage->Web service" and then select "frontend" in the dropdown menu to start registering IP). More than one address could be registered. Even if it is not recommended, you can disable this restriction by deselecting "IP address check enabled" option