clearbold/craft-campaignmonitor-lists

View and manage your Campaign Monitor subscriber lists in your Craft CMS control panel, add a subscribe form to your website for new subscribers.

1.1.12 2021-06-17 14:35 UTC

Requires

• campaignmonitor/createsend-php: ^6.1.1
• clearbold/craft-campaignmonitor-service: ^1.0.12
• craftcms/cms: ^3.4.0-RC1

MIT

• Mark Reeves

• email
• cms
• campaignmonitor
• Campaign Monitor
• Craft
• craftcms

README

Note I'm happy to review and approve pull requests to update this plugin for Craft 4, but am not actively supporting it.

Campaign Monitor Lists

Campaign Monitor Lists allows you to view the latest stats and subscribers for your Campaign Monitor lists. More features to come, including list management features!

Installation

To install:

composer require clearbold/craft-campaignmonitor-lists

Usage

To use:

After installing and enabling the plugin, you'll need to enter your API Key and Client ID from your Campaign Monitor account under Settings > Campaign Monitor Service.

After doing so, you can navigate to Campaign Monitor Lists in your control panel's sidebar to view your stats. Note that data is fetched in real time; response time is based on Campaign Monitor's API.

Subscribe Form

You can implement a subscribe form in your templates using the following code. Note that Resubscribe will be set to true.

    <form method="post" action="" accept-charset="UTF-8">

      {{ csrfInput() }}
      <input type="hidden" name="action" value="cm-lists/subscribe" />
      <input type="hidden" name="redirect" value="{{ 'foo/bar'|hash }}" />
      <input type="hidden" name="listId" value="{{ 'aaaaallllliiiiissssstttttiiiiiddddd'|hash }}" />

      <label>Email Address</label>
      <input type="email" name="email" placeholder="[e-mail]" />

      {# Use firstname + lastname fields, or fullname #}
      <label>First Name</label>
      <input type="text" name="firstname" placeholder="Joe" />

      <label>Last Name</label>
      <input type="text" name="lastname" placeholder="Bloggs" />

      {# <label>Full Name</label>
      <input type="text" name="fullname" placeholder="Joe Bloggs" /> #}

      <label>Custom Field</label>
      <input type="text" name="fields[CustomFieldCampaignMonitor]" placeholder="Some Value" value="Some Value" />

      <input type="submit" value="Subscribe" />

    </form>

For an unsubscribe form, use:

    <form method="post" action="" accept-charset="UTF-8">

      {{ csrfInput() }}
      <input type="hidden" name="action" value="cm-lists/unsubscribe" />
      <input type="hidden" name="redirect" value="{{ 'foo/bar'|hash }}" />
      <input type="hidden" name="listId" value="{{ 'aaaaallllliiiiissssstttttiiiiiddddd'|hash }}" />

      <label>Email Address</label>
      <input type="email" name="email" placeholder="[e-mail]" />

      <input type="submit" value="Unsubscribe" />

    </form>

Roadmap

• Review and support additional Craft fieldtypes in the subscribe form.
• Review and support additional Campaign Monitor fieldtypes (Number, Radio (Multi-One), Checklist (Multi-Many), Date, Country, US States)
• Support an unsubscribe form
• Support a preference center form