WordPress.org

Plugin Directory

WPTypia Email Service Provider Connector for Newspack Newsletters with Listmonk

WPTypia Email Service Provider Connector for Newspack Newsletters with Listmonk

Description

WPTypia Email Service Provider Connector for Newspack Newsletters with Listmonk is a companion plugin for Newspack Newsletters that adds a Listmonk ESP provider.
It turns Newspack newsletter editor output into raw HTML Listmonk campaigns, then
supports draft sync, test sends, immediate sends, and scheduled sends.

Subscriber sync and campaign analytics are included. The connector does not
expose a WordPress webhook receiver; configure bounce and complaint processing
in Listmonk.

This plugin requires a Listmonk server configured by the site administrator. It
sends newsletter HTML, campaign metadata, subscriber email addresses, list
membership changes, subscriber attributes, and analytics lookup requests to the
configured Listmonk API URL. Listmonk may be self-hosted or operated by another
party depending on the URL you configure. Review your Listmonk deployment’s own
privacy policy, terms, and data retention settings before connecting it.

Listmonk project documentation is available at https://listmonk.app/docs/.

Built with WPTypia

This plugin was scaffolded as a WPTypia workspace and continues to use
WPTypia packages and synchronization tooling for typed REST contracts,
generated schemas, and build consistency. WPTypia is maintained by this
plugin’s author at https://github.com/imjlk/wp-typia.

The plugin also builds on the WordPress Block Editor and Interactivity API,
Newspack Newsletters provider APIs, and the Listmonk REST API.

Newspack and Listmonk are trademarks or project names of their respective
owners. This plugin is not affiliated with or endorsed by Newspack, Automattic,
or the Listmonk project.

Requirements

  • WordPress 6.7 or later.
  • PHP 8.0 or later.
  • Newspack Newsletters installed and active.
  • Newspack platform plugin is optional; Newspack Newsletters is the required dependency for this connector.
  • A reachable Listmonk server over HTTPS. Plain HTTP is allowed only when WordPress runs in a local or development environment.
  • A Listmonk API user with lists:get_all, campaigns:manage, campaigns:send, campaigns:get_analytics, subscribers:get, subscribers:manage, and bounces:get.

Privacy and Uninstall

The Listmonk API URL, API user, API token, default From email, template ID, and
default list IDs are stored in the WordPress options table. When the plugin is
uninstalled, those local settings and connector sync-error transients are
deleted.

Uninstalling this plugin does not delete remote Listmonk campaigns,
subscribers, lists, bounces, or analytics data. It also preserves connector post
meta on newsletter posts so campaign history remains auditable if the plugin is
reinstalled. Remove remote data from the Listmonk admin if your retention policy
requires it.

Suggested privacy-policy text is available at
https://github.com/imjlk/wp-typia-newsletter-connector/blob/main/docs/PRIVACY.md.

Screenshots

Installation

  1. Install and activate Newspack Newsletters.
  2. Upload and activate wp-typia-newsletter-connector.zip.
  3. Open Settings > Newsletter Connector.
  4. Enter the Listmonk API URL, API user, API token, default From email, template ID, and list IDs.
  5. Use Save and test connection.
  6. Select listmonk as the active Newspack Newsletters service provider.
  7. Create a Newspack newsletter and verify the Listmonk editor panel can preview, sync, and send a test.

Detailed setup and validation documentation is available at https://github.com/imjlk/wp-typia-newsletter-connector/blob/main/docs/SETUP.md.

Reviews

There are no reviews for this plugin.

Contributors & Developers

“WPTypia Email Service Provider Connector for Newspack Newsletters with Listmonk” is open source software. The following people have contributed to this plugin.

Contributors

“WPTypia Email Service Provider Connector for Newspack Newsletters with Listmonk” has been translated into 1 locale. Thank you to the translators for their contributions.

Translate “WPTypia Email Service Provider Connector for Newspack Newsletters with Listmonk” into your language.

Interested in development?

Browse the code, check out the SVN repository, or subscribe to the development log by RSS.

Changelog

1.0.0

  • Changed: 5fd2f76 Promote the connector to its first stable WordPress.org release with WordPress 7.1 compatibility, verified Newspack Newsletters and Listmonk workflows, and complete directory artwork. — Thanks imjlk!

0.1.2

  • Changed: e0f7b9d Rename the plugin for trademark-safe WordPress.org review and verify compatibility with WordPress 7.1, including its enforced iframed editor and updated form controls. — Thanks @imjlk!

0.1.1

  • Fixed: Replace dynamic PHP include paths with explicit local resource loading, remove development documentation from the WordPress.org package, and update the WPTypia tooling used to validate generated contracts.
  • Changed: 3ed995c Add changeset-driven versioning and verified WordPress plugin release automation. — Thanks @imjlk!
  • Changed: c35932f Align the plugin slug, text domain, REST namespace, and release artifacts for WordPress.org review while keeping the directory-facing display name distinct. — Thanks @imjlk!

0.1.0

  • Initial WordPress.org release for the Newspack Newsletters and Listmonk integration.
  • Declares Newspack Newsletters as the required companion dependency and adds Listmonk provider registration, settings, campaign sync, test send, send/schedule transitions, editor panel, subscriber sync, analytics, and compatibility fallbacks.
  • Documents that bounce and complaint webhooks should terminate at Listmonk, not WordPress.