Wo WooCommerce Beginner

Notification Center — Complete Guide

Install and run the WooCommerce notification center 2.0: bell placement, design, announcements with live preview, targeting and scheduling, automations, order updates, My Account, blocks, REST API and troubleshooting.

Updated Module version 2.0.0

Overview

DataFirefly Notification Center adds a bell with an unread badge to your WooCommerce store. It opens a clean panel with your announcements, offers with a copy button, new products with their price, blog posts and, for customers with an account, the progress of their own orders.

Version 2.0 is a complete redesign: dashboard, composer with a live preview, audience targeting, scheduling, automatic notifications, personal order updates, a Notifications tab in My Account, two Gutenberg blocks and eight languages. It is accessible, page-cache friendly and compatible with HPOS and block themes.

DataFirefly Notification Center – Notification panel on the store for a customer: offers, order update, back in stock, promo codes
Notification panel on the store for a customer: offers, order update, back in stock, promo codes

In short: install, open Notifications > Dashboard and follow the four-step guide. With a block theme such as Twenty Twenty-Five, the bell is already in your header.

Installation and update

  1. In Plugins > Add New > Upload Plugin, choose df-notification-center-2.0.0.zip, then activate DataFirefly Notification Center.
  2. Open Notifications > Dashboard.

Requirements: WordPress 6.4 or later, PHP 7.4 to 8.5. WooCommerce 8.2 or later is needed for products, offers, order updates and the My Account tab; announcements and blog posts work without it.

Updating from 1.x

Upload the new zip and choose Replace current with uploaded. Your notifications, click counts, settings and the read states of your customers are kept; a backup of the 1.x settings is stored. Texts of product, coupon and post notifications are now written when they are displayed, so old prices with HTML entities are fixed by themselves. The new personal notifications (orders, notes, welcome) stay off until you turn them on in Notifications > Automations.

Dashboard and setup guide

The dashboard shows a four-step guide (where the bell appears, automations, first announcement, check on your store), five figures (active, scheduled, personal updates over 30 days, clicks, reads), the latest notifications with their status, a status of the installation and a preview of what a visitor who is not logged in sees right now.

DataFirefly Notification Center – Notification center dashboard: setup guide, figures, latest notifications and what visitors see
Notification center dashboard: setup guide, figures, latest notifications and what visitors see

Where the bell appears

Choose the placement in Notifications > Bell & panel. The live preview on the right shows the result.

  • Automatic (recommended): with a block theme, the “Notification bell” block is added to the header after the navigation, before the account and mini-cart icons; you can move or remove it in Appearance > Editor. With a classic theme, the bell goes at the end of the main menu; if no menu is assigned, a floating button is shown instead.
  • In a menu: at the end of the classic menu location you choose.
  • Next to an element: before or after an element of your theme, given by a CSS selector (for example the cart icon). If the element is missing on a page, a floating bell is shown instead.
  • Floating button: a round button in the bottom left or right corner.
  • Manual: only where you add the block or the [df_notification_center] shortcode.
DataFirefly Notification Center – Bell and panel settings: placement, icon, colours, badge and theme with a live preview
Bell and panel settings: placement, icon, colours, badge and theme with a live preview

The header pill of the plugin screens and the Tools > Site Health test tell you whether the bell is visible with your theme and settings.

Bell and panel design

Choose the bell icon (bell, solid bell, megaphone), the accent colour (eight suggestions; the text on it switches to black or white for contrast), the badge colour, a number or a dot, the panel theme (light, dark or the visitor’s device setting), the “Notifications” label, a single ring when something new arrives (never for visitors who reduce motion), the pop-up for pinned and personal notifications and the display on phones.

DataFirefly Notification Center – Notification panel in dark theme with a custom accent colour
Notification panel in dark theme with a custom accent colour

Creating an announcement

Open Notifications > Add new. Start from one of the eight templates (flash sale, free shipping, new collection, gift with purchase, event, delivery delay, opening hours, thank you) or from scratch, then:

  1. choose a style (information, promotion, gift, delivery, news, event, good news, important);
  2. write the title and the message (counters show the length);
  3. add a link and a button text, a promo code (shown with a copy button) and an image;
  4. choose the audience: everyone, logged-in users, visitors who are not logged in, users with a role, specific users (search by name or email) or customers who have ordered; with Polylang or WPML, a language;
  5. set the schedule: show from, hide after (site time zone), pin to the top;
  6. click Publish (or Schedule when the start date is in the future) or Save draft.
DataFirefly Notification Center – Announcement composer with templates, styles, promo code and a live preview of the panel
Announcement composer with templates, styles, promo code and a live preview of the panel

The preview shows the panel exactly as visitors will see it, on desktop or mobile, in light or dark theme. The page warns you before you leave with unsaved changes.

Managing notifications

Notifications > All notifications lists every notification with its type, audience, status (active, scheduled, expired, draft, hidden, not shown), clicks and reads. Use the views, the type filter and the search; edit, duplicate, hide, show or delete from each row, or several at once with the bulk actions. Automatic notifications link to their product, coupon or post; the Personal view lists order updates and welcome messages.

DataFirefly Notification Center – List of notifications with statuses, audience, clicks and reads
List of notifications with statuses, audience, clicks and reads

Automations

Notifications > Automations shows each automatic notification as a card with a switch and an example. Their texts are written when they are displayed, in the language of the visitor, with the current price, and they disappear when their product, offer, post or order is no longer available.

  • New products: announced when they are published, never when hidden from the catalogue. By default only products published from the dashboard or on schedule (not imports, the REST API or other plugins). Beyond the daily limit (5 by default), the new products of the day are grouped in one notification. The product screen has an Announce in the notification center box.
  • Back in stock and On sale: announced when a product comes back in stock or when its sale starts (including scheduled sales).
  • Offers (coupons): a box on each coupon. The offer is shown while the code is valid (published, not expired, usage limit not reached); a code restricted to some email addresses is only shown to those customers, once logged in.
  • Blog posts: a box in the post editor; scheduled posts are announced when they go live. Option: tick the box by default for new posts.
  • Order updates, notes to the customer and welcome message: see the next section.
DataFirefly Notification Center – Automations: new products, back in stock, on sale, coupons, blog posts, order updates, welcome
Automations: new products, back in stock, on sale, coupons, blog posts, order updates, welcome
DataFirefly Notification Center – WooCommerce coupon screen with the box to announce the code in the notification center
WooCommerce coupon screen with the box to announce the code in the notification center

Personal notifications and My Account

Customers with an account receive personal notifications that nobody else sees:

  • Order updates for the statuses you choose (processing, completed, refunded, cancelled… on hold if you add it), with a View order button;
  • notes to the customer added to an order;
  • a welcome message for each new customer account, with an optional welcome code.

The Notifications tab of WooCommerce My Account lists all their notifications, with mark as read or unread, remove and mark all as read.

DataFirefly Notification Center – Notifications tab in WooCommerce My Account with read, unread and remove buttons
Notifications tab in WooCommerce My Account with read, unread and remove buttons

What visitors see

The badge counts what arrived since the visitor last opened the panel. In the panel, new notifications stay highlighted until they are clicked or marked as read. Visitors can filter all or unread notifications, mark all as read, mark one as read or unread, remove one (with Undo), show more and copy a promo code in one click. On phones the panel opens as a sheet from the bottom of the screen.

DataFirefly Notification Center – Notification panel on a phone, opened as a sheet from the bottom of the screen
Notification panel on a phone, opened as a sheet from the bottom of the screen

When the bell is at the bottom of the screen, the panel opens above it. With the pop-up option, a pinned or personal notification also appears once as a small card in a bottom corner.

DataFirefly Notification Center – Floating notification bell and pop-up of a pinned announcement on the shop page
Floating notification bell and pop-up of a pinned announcement on the shop page

Accessibility: the panel title receives the focus when it opens, Escape closes it and returns the focus to the bell, the number of new notifications is part of the bell’s name, actions are announced to screen readers, and animations are turned off for visitors who ask their device to reduce motion.

Blocks and shortcodes

  • Notification bell block or [df_notification_center]: the bell (option or attribute label="yes" to show the label).
  • Notification feed block or [df_notifications count="5" type=""]: an inline list of the latest notifications on any page (type: custom, coupon, product, post).
DataFirefly Notification Center – Notification feed and Notification bell blocks in the block editor
Notification feed and Notification bell blocks in the block editor

To change the HTML of the inline list, copy templates/feed.php to yourtheme/df-notification-center/feed.php.

Settings, privacy and data

  • Panel: notifications per page (a “Show more” button loads the next ones), how often to check for new notifications (1 to 60 minutes).
  • Customers: Notifications tab in My Account; multilingual filter (each notification only in its language with Polylang or WPML).
  • Data: delete expired or hidden notifications after N days, personal notifications after N days (180 by default), delete all data when the plugin is deleted.
  • Tools: clear caches, run the cleanup now.

No cookie is set and nothing is sent to third parties. Read states of logged-in users are stored on your site; visitors keep theirs in their browser. A text is suggested in Settings > Privacy, and the WordPress tools export and erase the personal notifications and read states of a user.

Performance and caching

The bell is printed by the page with no database query. The browser loads the list once from the REST API and keeps it for the refresh interval, so the following pages make no request; opening the panel checks for news if the list is older than a minute. For visitors the list is identical for everyone and can be cached one minute by a CDN; for logged-in users, an expired nonce on an old cached page is renewed automatically. Scripts have no dependency and load with defer.

Developers

REST API, namespace df-nc/v1:

GET  /wp-json/df-nc/v1/feed            what the current visitor or user can see (lang, locale)
POST /wp-json/df-nc/v1/read            ids[] or all (logged-in users, X-WP-Nonce)
POST /wp-json/df-nc/v1/unread | /dismiss | /restore | /seen
POST /wp-json/df-nc/v1/notifications/{id}/click
GET  /wp-json/df-nc/v1/notifications   1.x format (notifications, read_ids)

WP-CLI: wp df-nc status, wp df-nc list --view=active, wp df-nc create --title="…" --audience=customers --code=SPRING10, wp df-nc cleanup.

Filters: df_nc_capability (default manage_woocommerce), df_nc_show_bell, df_nc_present_item, df_nc_feed_limit, df_nc_post_types, df_nc_announce_product, df_nc_notify_order_status. Actions: df_nc_notification_created, df_nc_settings_updated.

Troubleshooting

The bell does not appear

Look at the pill at the top of the plugin screens or at the Site Health test. With “In a menu”, a menu must be assigned to the chosen location; with a block theme, choose “Automatic” or add the Notification bell block to your header. “Show on phones” may be turned off.

A notification is listed as “Not shown”

Its product is unpublished, hidden or out of stock (when your shop hides out-of-stock products), or its coupon expired, reached its usage limit or was unpublished. It will reappear by itself if the product or coupon becomes available again.

A new announcement does not show up straight away

Visitors keep the list for the refresh interval (5 minutes by default) unless they open the panel. Use Settings > Tools > Clear caches to make every visitor reload it on the next page.

Customers do not receive order updates

Turn on Order updates in Automations (it is off after an update from 1.x) and check the chosen statuses. Orders placed without an account do not create personal notifications.

Was this page helpful?

Still stuck? Contact support