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

• WordPress 5.0+
• Forminator 1.15+
• Listmonk instance with API access

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.