Campaigner Effortlessly subscribe members of your site to Campaign Monitor mailing lists.

Requirements

Campaigner requires PHP 5, and ExpressionEngine version 1.6.

Campaigner also requires the “jQuery for the Control Panel” extension, which is installed (but disabled) by default on ExpressionEngine version 1.6.5 and up.

You can also download jQuery for the Control Panel directly from the ExpressionEngine website.

Installation

1. Extract the ZIP file.
2. Copy the system/extensions/ext.campaigner.php file to your /system/extensions/ directory.
3. Copy the system/extensions/campaigner folder to your /system/extensions/ directory.
4. Copy the language/english/lang.campaigner.php file to your /system/languages/english/ directory.
5. Copy the themes/cp_themes/default/campaigner folder to your /themes/cp_themes/default/ directory.
6. If you’re installing Campaigner for the first time, open the Extensions Manager, and enable the extension.

Upgrading from SL Freshview Subscribe

Campaigner is not compatible with SL Freshview Subscribe. Please disable the SL Freshview Subscribe extension in your Control Panel, before enabling Campaigner.

You may wish to make a note of your SL Freshview Subscribe settings prior to disabling it.

Configuration

Retrieving and configuring your Campaign Monitor mailing lists is a 3 step process:

1. Enter your Campaign Monitor API key, and click the “Get clients” link.
2. Select a client from the drop-down list, and click the “Get mailing lists” link.
3. Select the mailing lists you’d like newly-activated members to join, by ticking the checkbox next to the list name. If required, you can also select an “opt-in trigger” (see below), and associate custom mailing list fields with custom ExpressionEngine member profile fields.

Trigger fields

A “trigger” field is a custom ExpressionEngine member profile field that must contain a specified value in order for the mailing list subscription to be processed.

For example, you may have a “Special Offers” mailing list, which new members must opt-in to. Here’s how to implement this:

1. Create a new custom EE member profile field, and give it an appropriate field name (for example, “subscribe-offers”) and label (for example, “Receive our special offers newsletter?”). Specify Drop-down list as the field type, and add the options Yes and No.
2. Open the Campaigner extension settings page. Tick the checkbox for the “Special Offers” mailing list, select the member profile field you just created from the “Trigger field” drop-down, and set the “Trigger value” to Yes.

Usage

Once the extension is installed and configured, it will automatically subscribe newly registered and confirmed users to the specified Campaign Monitor mailing lists. The extension works best with “single opt-in” Campaign Monitor lists.

If you’re using the Solspace User module to manage your site members, Campaigner will also update a member’s mailing-list subscriptions whenever he updates his profile.

License

Campaigner is a commercially licensed product. Unless you have prior written consent from Experience Internet, you may not redistribute, duplicate, lease, or sell Campaigner. You know, all the usual stuff that you shouldn’t do with copyrighted material.