MailerLite integration plugin

This plugin implements the MailerLite subscription form functionality for OctoberCMS.

Configuring

In order to use the plugin you need to get the API key from your MailerLite account.

1. In the OctoberCMS back-end go to the System / Settings page and click the MailerLite link.
2. Paste the API key in the MailerLite API key field.

Creating the Signup form

You can put the MailerLite signup form on any front-end page. Add the MailerLite Signup Form component to a page or layout. Click the added component and paste your MailerLite list identifier in the MailerLite List ID field. Close the Inspector and save the page.

The simplest way to add the signup form is to use the component's default partial and the {% component %} tag. Add it to a page or layout where you want to display the form:

{% component 'mailerliteSignup' %}

If the default partial is not suitable for your website, replace the component tag with custom code, for example:

<form
    id="subscribe-form"
    data-request="mailerliteSignup::onSignup"
    data-request-update="'mailerliteSignup::result': '#subscribe-form'"
>
    <input type="text" name="email" placeholder="Newsletter subscription">
    <input type="submit" class="btn btn-default" value="Subscribe"/>
</form>

The example uses the standard partial mailerliteSignup::result for displaying the subscription confirmation message. If you don't like the standard message you can create your own partial in your theme and specify its name in the data-request-update attribute. The default partial is located in plugins/rainlab/mailerLite/components/signup/result.htm.

More fields can be included in the subscription request:

<input type="text" name="merge[FNAME]" placeholder="First Name" />
<input type="text" name="merge[LNAME]" placeholder="Last Name" />

That's it!