WP Manifestindependent plugin directory
manifest / email / zen-mailpoet-helper

zen-mailpoet-helper

gives you power to create your own popup design.

by Antigravity · github.com/developervinit/zen-mailpoet-helper · 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/developervinit/zen-mailpoet-helper/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/developervinit/zen-mailpoet-helper ↗

Zen MailPoet Helper - Administration & Usage Guide

Welcome to the Zen MailPoet Helper plugin. Below are step-by-step instructions on how to set up, configure, and troubleshoot your custom newsletter popups.

🛠️ Step-by-Step Setup Guide

To display a custom newsletter popup on your website, follow these steps:

1. Create a New Popup

  1. Go to your WordPress Admin dashboard.
  2. In the left-hand sidebar menu, locate and click Newsletter Popup -> Popups -> Add New.
  3. Enter an administrative title for your popup (e.g. Summer 10% Discount Coupon).

2. Configure Popup Content & Styling

Under the Popup Settings & Content Builder metabox:

  • General Tab: Check the Enable Popup toggle. (Note: Only one popup can be active globally on the site. Enabling this popup will automatically disable other configured popups).
  • Content Tab: Fill in the Headline Title, Description, Email field placeholder, and CTA button text.
  • Subscription Tab: Map the popup to one or more of your MailPoet subscriber list checkmarks.
  • Display Tab: Choose where you want the popup to show:
    • Entire Website: Displays globally across all public pages.
    • Selected Pages: Restricts visibility to checked pages only.
    • Exclude Selected Pages: Excludes Checked pages (e.g. cart, checkout, or privacy policy) from global loading.
  • Behavior Tab: Specify the load delay (in milliseconds, e.g. 2500 for 2.5 seconds) and the number of days the popup stays hidden if a user closes or dismisses it.

3. Publish the Popup (CRITICAL)

  • Important: Your popup will not display on the front-end if it is saved as a Draft.
  • You must click the blue Publish (or Update) button in the upper-right corner of the editor to change the post status to publish.

⚠️ Troubleshooting: Why isn't my popup showing?

If you have completed the steps above and still do not see the popup on your website, check the following:

Reason A: It has been saved as a Draft

Go to Newsletter Popup -> Popups and verify the popup's status is listed as Enabled (green badge). If it shows a draft status, edit the popup and click Publish.

Reason B: The popup is marked as "Dismissed" in your browser cache

To prevent annoying visitors, closing the popup sets a flag in your browser's local storage:

  • Storage Key: zen_mp_dismissed_* (where * is the configured list IDs).
  • How to test again:
    • Open a new Incognito / Private Window in your browser.
    • Or, open your browser Console (F12 -> Application -> Local Storage) and click Clear Storage or clear keys starting with zen_mp_.

Reason C: Logged-in user exclusion is active

  • Go to Newsletter Popup -> Settings.
  • If the option Hide popups for logged-in users is checked, log out of WordPress (or test in Incognito) to see the popup.