Subscribe Form for Listmonk

Description

Subscribe Form for Listmonk connects WordPress to a self-hosted Listmonk instance. Enter the address of your Listmonk installation, and the plugin loads its public lists. Place the “Newsletter signup (Listmonk)” block on any page, choose a list and optionally override heading and description.

No API credentials are required: the plugin only uses Listmonk’s public endpoints.

Privacy by design

  • Consent checkbox that is never preselected, names the newsletter, links to your privacy policy and mentions the right to withdraw.
  • Double opt-in is handled by Listmonk. The plugin never creates preconfirmed subscriptions.
  • Only the email address and the selected list are sent to Listmonk. WordPress does not store any addresses.
  • Rate limiting uses HMAC values only – no plain addresses or IP addresses are stored.
  • No external fonts, CAPTCHA services, tracking or telemetry. All assets are served locally.
  • Without a privacy policy page, no form is shown.
  • Adds a suggested text to the WordPress privacy policy guide.

Safe operation

  • A list only accepts subscriptions after you enabled subscriptions globally and confirmed that the list uses double opt-in in Listmonk. Listmonk does not publish the opt-in type, so this is a deliberate manual check.
  • Lists that are removed from Listmonk or made private disappear from the website automatically.
  • Each page only accepts lists that are actually offered by a block on that page.
  • Local and development environments never send subscriptions (see the sffl_suppress_delivery filter).
  • Repeated submissions within five minutes are answered like the first one, without triggering a second confirmation email.
  • Clear success message, protection against double submission and full keyboard and screen reader support.

External services

This plugin connects to a Listmonk server whose address you enter in the plugin settings. Listmonk is self-hosted software; the server is operated by you or on your behalf, not by the plugin author.

  • Loading lists: When you save the settings, click “Reload lists” or open the block editor (at most every 12 hours), the plugin requests /api/public/lists from your Listmonk server. No personal data is sent.
  • Subscriptions: When a visitor submits a form, the plugin sends the email address and the UUID of the selected list to /api/public/subscription on your Listmonk server. Listmonk then sends the confirmation email.

Visitors’ browsers never connect to Listmonk directly through this plugin. The terms and privacy policy that apply are those of the operator of the Listmonk server. Listmonk project: https://listmonk.app/ – source code and license: https://github.com/knadh/listmonk

Screenshots

Blocks

This plugin provides 1 block.

  • Newsletter signup (Listmonk)

Installation

  1. Install and activate the plugin.
  2. Go to Settings Listmonk, enter the HTTPS address of your Listmonk instance and save. The public lists are loaded automatically.
  3. In Listmonk, make sure every list you want to offer is public and uses double opt-in. Then tick “confirmed” for these lists in WordPress.
  4. Assign a privacy policy page under Settings Privacy and describe the newsletter processing there.
  5. Enable “Accept subscriptions”.
  6. Add the “Newsletter signup (Listmonk)” block to a page and select a list.

Recommended Listmonk settings: record the opt-in IP address (proof of consent), keep individual tracking disabled, allow subscribers to unsubscribe, export and wipe their data, and keep the unsubscribe link in all templates.

FAQ

Do I need a Listmonk API user?

No. The plugin uses the public list and subscription endpoints of Listmonk.

Why do I have to confirm double opt-in manually?

Listmonk’s public API does not reveal whether a list uses single or double opt-in. To prevent subscriptions without confirmation, each list must be confirmed once in the plugin settings.

Can I use several lists on one page?

Yes. Add one block per list. Each block has its own form.

Why does my local test site not subscribe anyone?

To protect real addresses, subscriptions are suppressed when wp_get_environment_type() returns local or development. The forms are still shown for previews. Developers can change this with the sffl_suppress_delivery filter.

How can my theme change the colours?

Set the CSS custom properties --sffl-accent, --sffl-error, --sffl-surface, --sffl-surface-muted and --sffl-text. Without them, the plugin falls back to your theme’s colour presets.

Reviews

There are no reviews for this plugin.

Contributors & Developers

“Subscribe Form for Listmonk” is open source software. The following people have contributed to this plugin.

Contributors

Changelog

1.0.2

  • Let WordPress load translations, so they can be provided through translate.wordpress.org.

1.0.1

  • The subscribe button uses the theme’s button style (wp-element-button).

1.0.0

  • First public release.