Description
Connector for bluefox.email links your WordPress site and WooCommerce store to your bluefox.email account. Every feature is a module you can switch on or off, so the plugin only loads what you use. No coding, API or MCP knowledge needed.
Full documentation: beamkiller.github.io/connector-for-bluefox-email · Source code: GitHub
Ready-made emails
- One click creates mobile-friendly emails in bluefox.email for everything the plugin sends – double opt-in confirmation, welcome coupon, coupon expiry reminder, first order thank-you, review request, abandoned cart reminder – and wires them up. They match your WooCommerce email design (logo, colours, font, footer) or your signup form colours. Edit the texts in WordPress, update them later, or keep designing them in bluefox.
Signup forms
- Gutenberg block,
[cfbe_form]shortcode and a configurable popup (scroll, delay, exit intent, page views, page targeting, device, frequency). - Promo bar and promo boxes (
[cfbe_promo]): “Subscribe and get 10% off” with a button that opens the signup form in a dialog; the discount comes from your coupon settings. - Double opt-in handled by bluefox.email: the confirmation email is sent by your bluefox list, then the subscriber lands on your own thank-you page (
[cfbe_thankyou]). - Redirect link check: if a bluefox list sends confirmed subscribers to another site’s thank-you page (an old test site, a staging copy), the plugin warns you and fixes it with one click.
- Choose the list per form, add tags, optional name and “interests” field (each interest becomes a tag); automatic source and placement tags.
- Texts, benefits list, colours and corner radius are all editable, with a live preview.
- Accessible markup (labels, focus trap in the popup, ESC to close, reduced-motion support) and page-cache friendly (no nonces in public forms; honeypot, time trap and rate limiting instead).
WooCommerce (optional)
- Newsletter opt-in checkbox on the checkout – classic and block checkout – and optionally on My Account. Unticked by default; the subscription runs in the background and never holds up the order.
- Welcome coupon: a single-use coupon locked to the subscriber’s email address, created only after they confirm their subscription. One per email address, and by default one per mailbox (
name+tag@aliases and Gmail dots count as one). Discount, minimum order, expiry, sale items and free shipping are configurable. - Coupon expiry reminder: subscribers who have not used their welcome coupon get one reminder email a few days before it expires.
- Excluded user roles: wholesale customers, resellers or any other role can subscribe without getting the welcome coupon, and the cart rejects it for them.
- Order emails: send your own bluefox transactional or triggered emails on order status changes, first purchase, customer notes and review requests (with a “Write a review” button per product), after a delay in minutes, hours or days. Choose per email whether only subscribers get it (marketing, with unsubscribe link) or every customer. Each email goes out at most once per rule and order. WooCommerce keeps sending its own order emails – these come on top.
- Abandoned cart emails: remind shoppers of carts they left, with the cart contents, a one-click restore link and an optional single-use recovery coupon (with a cooldown per email address). By default only carts of subscribers are tracked, and a cart that was bought – even from another browser – is never reminded.
- Compatible with High-Performance Order Storage (HPOS).
Contact sync
- Keep bluefox contacts enriched with user and customer data (name, order count, total spent, last order date, purchased categories, …) for segmentation.
- Bulk backfill and WP-CLI command.
Send WordPress emails through bluefox.email
- Route
wp_mail()– WordPress and WooCommerce system emails – through the bluefox transactional API. Off by default, with a test-send button and fallback to the default mailer.
Form plugin integrations
- Subscribe people from Contact Form 7, WPForms, Fluent Forms, Gravity Forms and Elementor Pro forms, with consent checks and field mapping.
Subscription preferences page
- Your own, translatable unsubscribe / pause page on your site instead of the bluefox hosted page.
Inbound webhooks
- Receive bluefox events (subscription changes, bounces, complaints, opens, clicks …), store the status on the WordPress user and react with developer hooks.
AI agent access (experimental, off by default)
- On WordPress 6.9 and later the settings can be registered as abilities: an AI agent connected through the MCP Adapter plugin can read and change them in plain language (“show the popup after 15 seconds”, “switch on the checkout opt-in”). Only administrators can use them, every value goes through the same validation as the settings screens, and the API key and webhook secret are never shown or changed.
Privacy and security
- Consent text, time and IP address stored with every signup; IP address full, anonymized (default) or off, with automatic deletion after a set number of months. Cloudflare / proxy aware.
- WordPress personal data exporters and erasers, including issued coupons and the checkout consent.
- The thank-you page opened with bluefox’s subscriber token is never cached or indexed, and its address is not passed on to other sites.
- The API key can be set in
wp-config.phpand is never shown on the public site; email addresses in logs are masked.
Translations
- English and a complete Hungarian (magyar) translation are included: set the site language to Magyar and the admin screens, forms, popup and ready-made emails are in Hungarian.
- Hungarian product guide (magyar leírás): Bluefox.email – Plugin leírás
This plugin is not developed by or affiliated with bluefox.email.
External services
This plugin connects to the bluefox.email API (https://api.bluefox.email), an email marketing and delivery service. It is required for every feature of the plugin and is only contacted after you enter your bluefox.email project ID and API key.
What is sent and when:
- When someone submits a signup form, ticks the checkout opt-in or submits a connected third-party form: their email address, name (if given), tags and the list they subscribe to, plus the values of any form fields you map to bluefox contact fields in the form integration settings.
- When the Welcome coupon module confirms a signup: the subscription status is read and the coupon email is sent with the coupon code, value and expiry date.
- When a welcome coupon is about to expire unused (and a reminder email is set): the reminder email is sent to that subscriber with the same coupon details.
- When the Contact sync module is on: the user and customer fields you enable (for example name, order count, total spent, last order date).
- When the Email delivery module is on: every email sent with
wp_mail()(recipients, subject, body, attachments) is sent to bluefox.email for delivery. - When order or abandoned cart emails are on: order or cart details used in the email (order number, items, totals, customer name and address).
- On the preferences page: the visitor’s own subscription token, to read and change their subscription.
- In the admin: your lists, emails, sender identities and webhook settings when you load or change them. Registering the webhook sends your site’s webhook URL and uses your API key as its secret; the redirect link check reads your lists’ double opt-in settings and, when you click its fix button, updates their redirect link.
- bluefox.email sends webhook events (subscription changes, bounces, complaints, opens, clicks) to your site only if you register the webhook.
bluefox.email terms of service: https://bluefox.email/terms-of-use
bluefox.email privacy policy: https://bluefox.email/privacy-policy
Screenshots





Blocks
This plugin provides 1 block.
- bluefox.email signup form Newsletter signup form that subscribes visitors to a bluefox.email list (double opt-in by bluefox).
Installation
- Install and activate the plugin.
- Go to bluefox.email General, enter your project ID and API key (or define
CFBE_BLUEFOX_API_KEYinwp-config.php), click Test connection and Load lists, then choose your default list. - Switch on the features you need under Features.
- On the Email templates tab, create the double opt-in confirmation email with one click: the plugin turns on double opt-in for your list and sets the email and your thank-you page as the redirect link. Create the other emails (welcome coupon, reminders, order emails) the same way.
- Create the thank-you page with
[cfbe_thankyou](default URL/newsletter-confirmed/) and add a signup form: block,[cfbe_form], popup or promo bar.
Step-by-step guide: Getting started.
FAQ
-
Do I need WooCommerce?
-
No. Signup forms, contact sync, email delivery, form integrations, the preferences page and webhooks work on any WordPress site. The checkout opt-in, welcome coupon, order emails and abandoned cart emails need WooCommerce 9.0 or newer.
-
Who sends the confirmation (double opt-in) email?
-
bluefox.email, using the confirmation email set on your list. The plugin never subscribes anyone without their consent.
-
When is the welcome coupon created?
-
Only after the subscriber confirms the double opt-in email, once per email address, and only for people who signed up through this plugin.
-
Does it work with page caching?
-
Yes. Public forms contain no nonces and do not depend on the visitor; spam is blocked with a honeypot, a time trap and rate limiting.
-
Can an AI agent change the settings?
-
Yes, on WordPress 6.9 or later, once you switch on the experimental AI agent access feature on the General tab (it is off by default). The plugin then registers the abilities
cfbe/get-settings,cfbe/update-settings,cfbe/set-modules,cfbe/list-bluefox-lists,cfbe/list-bluefox-emails,cfbe/list-email-templates,cfbe/create-email-template,cfbe/update-email-template,cfbe/send-test-emailandcfbe/set-email-design. With the MCP Adapter plugin they are available to MCP clients such as Claude, signed in as an administrator (for example with an application password). The API key and webhook secret can only be set in wp-admin. -
Is it available in Hungarian?
-
Yes. The complete Hungarian translation ships with the plugin. Set Settings General Site Language to Magyar; texts you have already saved on the settings tabs stay as you saved them.
-
Do I need a paid bluefox.email plan?
-
The plugin does not require one. New bluefox.email projects start in a sandbox with a small daily sending limit; request production access in bluefox.email before you go live.
-
Does the plugin need webhooks?
-
No, but they make it instant. Without the bluefox webhook the plugin checks pending signups every 15 minutes. With it, the welcome coupon goes out within seconds of the confirmation. The site must be reachable from the internet to receive webhooks.
-
Does the plugin track me or phone home?
-
No. It only talks to the bluefox.email API with the project ID and API key you entered (see External services). There is no tracking, no upsell and no locked feature.
-
Can I use my own email templates?
-
Yes. All emails are designed in bluefox.email; the plugin passes data (for example
{{couponCode}}or{{orderNumber}}) that you can use in your templates. Example templates are included in the plugin’stemplates/emailsfolder.
Reviews
There are no reviews for this plugin.
Contributors & Developers
“Connector for bluefox.email – Newsletter, Store Marketing and Transactional Emails” is open source software. The following people have contributed to this plugin.
ContributorsInterested in development?
Browse the code, check out the SVN repository, or subscribe to the development log by RSS.
Changelog
1.0.0
- First public release.
