Requirements

• Ajax Framework must be included in your layout/page in order to handle form requests.

Optional

• Translate plugin, if you want to include multilingual contents.
• If you want to enable auto-reply option, configure your mail settings to make sure your server can send emails.
• If you are using ContactMe plugin, you can enable automatic or optional subscription on sent inquiry.

Settings

This plugin creates a Settings menu item, found by navigating to Settings > Marketing > Local Maillist. This page allows the setting of maillist title, confirmation message, input labels, button text or enabling auto-reply.

If Translate is enabled, auto-reply email, button text and labels are translatable.

Usage

You can put the subscription form on any front-end page. Add the subscribeForm component to a page or layout.

The simplest way to add the contact 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 'subscribeForm' %}

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

<div class="confirm-subscribe-container">
</div>
<form data-request="{{ __SELF__ }}::onSubscribe"
      data-request-update="'{{ __SELF__   }}::confirm': '.confirm-subscribe-container'"
      class="subscription-form"
      >
  <div class="input-group">
    <input type="email" class="form-control" placeholder="{{localmaillist.placeholder_text}}" id="subscribe_email" name="email">
    <span class="input-group-btn">
      <button type="submit" class="btn btn-primary">{{localmaillist.button_text}}</button>
    </span>
  </div>
</form>

The example uses standard partial {{ __SELF__ }}::confirm for displaying the subscription confirmation message. Confirmation message will be displayed in .confirm-subscribe-container. The default partial located in plugins/grofgraf/localmaillist/components/subscribeform/confirm.htm.

Email templates auto-reply can be customized under Settings > Mail > Mail Templates