WP Manifestindependent plugin directory
manifest / email / forminator-listmonk-addon

Forminator Listmonk Addon

WordPress plugin to integrate Forminator forms with Listmonk newsletter platform

by Cristian Tala · github.com/ctala/forminator-listmonk-addon · website

★ 0stars

Install

Download source zip No release zip yet

This is the repository archive. It installs, but the folder name will carry the branch suffix and updates will not flow.

Install straight from GitHub with WP-CLI:

wp plugin install https://github.com/ctala/forminator-listmonk-addon/archive/refs/heads/main.zip
No built-in updater. New versions won't appear under Dashboard → Updates. Install new releases yourself, or let Git Updater track the repository.
Readme github.com/ctala/forminator-listmonk-addon ↗

A WordPress plugin that integrates Forminator forms with Listmonk, the open-source newsletter and mailing list manager.

Features

  • ✅ Native Forminator integration (appears in Integrations list)
  • ✅ Global configuration (Listmonk URL, API credentials)
  • ✅ Per-form settings (select list, map email/name fields)
  • ✅ Automatic subscriber creation on form submission
  • ✅ Handles existing subscribers (adds them to new lists)
  • ✅ Clean isotipo icon

Requirements

Installation

  1. Download or clone this repository
  2. Upload the forminator-listmonk-addon folder to /wp-content/plugins/
  3. Activate the plugin in WordPress
  4. Go to Forminator → Integrations → Listmonk
  5. Enter your Listmonk URL and API credentials

Configuration

Global Settings

  1. Navigate to Forminator → Integrations
  2. Click the + button next to Listmonk
  3. Enter:
    • Listmonk URL: Your Listmonk installation URL (e.g., https://listmonk.example.com)
    • API Username: Your Listmonk API username
    • API Token: Your Listmonk API token
  4. Click Connect

Per-Form Settings

  1. Edit any Forminator form
  2. Go to the Integrations tab
  3. Click on Listmonk
  4. Select:
    • Listmonk List: The list to add subscribers to
    • Email Field: The form field containing the email
    • Name Field (optional): The form field containing the name
  5. Click Save

Creating API Credentials in Listmonk

  1. Log in to your Listmonk admin panel
  2. Go to Settings → Users
  3. Create a new user with type API
  4. Assign appropriate permissions (at minimum: subscribers:manage, lists:get_all)
  5. Save and copy the generated API token

File Structure

forminator-listmonk-addon/
├── forminator-listmonk.php                    # Main plugin file
├── class-forminator-integration-listmonk.php  # Main integration class
├── class-forminator-listmonk-form-settings.php # Form settings class
├── class-forminator-listmonk-form-hooks.php   # Form submission hooks
├── assets/
│   ├── icon.png                               # Plugin icon
│   └── icon@2x.png                            # Retina icon
├── README.md
├── CHANGELOG.md
└── LICENSE

Changelog

See CHANGELOG.md for version history.

License

This project is licensed under the MIT License - see the LICENSE file for details.

Author

Cristian Tala - cristiantala.com

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

Support

If you encounter any issues or have questions, please open an issue on GitHub.