Ottawa West Four Rivers Ontario Health Team

Newsletter Subscribe

Communications team guide for the newsletter subscription button and Cyberimpact workflow

📦 Plugin: owfr-newsletter-subscribe 🏷 Version: 1.0.3 🖥 Type: Public + Admin
← Back to Documentation Index

Table of Contents

  1. What This Plugin Does
  2. How It Works
  3. Admin Settings
  4. Shortcode Reference
  5. Email Notification
  6. Adding Subscribers to Cyberimpact
  7. Where to Place the Button
  8. Troubleshooting
1

What This Plugin Does

The Newsletter Subscribe plugin adds a green "Subscribe to Our Newsletter" button to any page. When a visitor clicks it, a modal popup appears with a single email address field. After submitting, a notification email is sent to staff at info@owfr.ca with the subscriber's address.

Staff then manually add the email address to the correct group in Cyberimpact, the OWFR newsletter platform.

This plugin does not connect directly to Cyberimpact. It captures the email and notifies staff, who add subscribers manually. This ensures you maintain control over who receives each newsletter list.
2

How It Works

Visitor experience

  1. 1
    Visitor sees the buttonA green pill-shaped button labelled "Subscribe to Our Newsletter" appears on the page.
  2. 2
    Visitor clicks the buttonA popup modal appears with a single Email Address field and a Subscribe button.
  3. 3
    Visitor enters their email and submitsThe form validates the email format and sends the request to the server.
  4. 4
    Success confirmationThe form is replaced by a green checkmark and "You're on the list! Thanks for subscribing."

Staff experience

  1. 1
    Email arrivesA notification email arrives at info@owfr.ca (or your configured address) with the subscriber's email and a timestamp.
  2. 2
    Log in to CyberimpactGo to app.cyberimpact.com and navigate to the appropriate contact group.
  3. 3
    Add the subscriberAdd the email address to the group manually. Cyberimpact will send a confirmation (double opt-in) email to the subscriber if your account is configured for it.
3

Admin Settings

In the WordPress admin dashboard, go to Settings → Newsletter Subscribe to configure the plugin.

Settings → Newsletter Subscribe
Notification Email
info@owfr.ca
New subscriber emails will be forwarded here for manual addition to Cyberimpact.

Changing the notification email

  1. Go to Settings → Newsletter Subscribe in the WordPress admin.
  2. Update the Notification Email field to the desired address.
  3. Click Save Settings.
If the Notification Email field is left blank, the plugin defaults to info@owfr.ca.
4

Shortcode Reference

Add the shortcode to any Divi Code Module, page, or text widget.

ShortcodeResult
[owfr_newsletter_subscribe] Default green button - "Subscribe to Our Newsletter"
[owfr_newsletter_subscribe label="Stay Connected"] Button with custom label text
[owfr_newsletter_subscribe label="Join Our Mailing List"] Another custom label example
Always place the shortcode in a Code Module in the Divi Builder - not a Text Module. Text Modules may add extra formatting that breaks the button.
5

Email Notification

Each new subscription triggers a plain-text email to your configured notification address. The Reply-To is set to the subscriber's address.

6

Adding Subscribers to Cyberimpact

When you receive a notification email, follow these steps to add the subscriber in Cyberimpact:

  1. 1
    Log in to CyberimpactGo to app.cyberimpact.com and sign in with your OWFR account credentials.
  2. 2
    Navigate to ContactsClick Contacts in the top navigation, then choose the appropriate group (e.g. "General Newsletter", "Partner Updates").
  3. 3
    Add the contactClick Add a Contact and enter the email address from the notification email. Fill in any other details if available.
  4. 4
    SaveClick Save. If double opt-in is enabled on your Cyberimpact account, the subscriber will receive a confirmation email automatically.
Consider checking your notification inbox at a regular cadence (e.g. every Monday) to batch-add new subscribers to Cyberimpact rather than adding one at a time.

Future: direct API integration

The plugin is designed to support direct Cyberimpact API integration in a future update. When OWFR obtains a Cyberimpact API token, subscribers can be added automatically without the manual step. Contact the development team to enable this.

7

Where to Place the Button

Recommended placements across the OWFR website:

Adding to a Divi Code Module

  1. In the Divi Builder, add or edit a Code Module.
  2. Paste: [owfr_newsletter_subscribe]
  3. Save the module and publish/update the page.
8

Troubleshooting

ProblemLikely CauseFix
Button is unstyled (plain browser button) CSS not loading - possibly a theme conflict Clear the site cache. The styles are enqueued via wp_enqueue_scripts and should appear in <head>. Check for a caching plugin that may need to be purged.
Modal doesn't open on click JavaScript conflict or shortcode in wrong module type Ensure the shortcode is in a Code Module, not a Text Module. Check the browser console for JS errors.
No notification email received after submission WordPress mail not configured, or email going to spam Check spam/junk folder. Ensure an SMTP plugin is active. Test email delivery via the SMTP plugin's test feature.
Divi editor fails to save with plugin active PHP file has UTF-8 BOM (invisible characters at start of file) Re-upload the plugin ZIP file. Ensure the PHP file is encoded as UTF-8 without BOM. Contact the development team if the issue persists.
"Security check failed" on form submit Page was open for a long time before submitting (nonce expired after 12 hours) Ask the visitor to refresh the page and try again.
OWFR Newsletter Subscribe - Plugin Guide  |  Ottawa West Four Rivers Ontario Health Team  |  May 2026