Zum Inhalt springen
WooCommerce & WordPress Plugin Docs

Getting started

Dieser Inhalt ist noch nicht in deiner Sprache verfügbar.

Notice ships disabled. You write a message, set colours, then flip the master switch, nothing renders on the storefront until you do. Most shops are done in a couple of minutes.

Before you start

Section titled “Before you start”
  • WordPress 6.5 or newer
  • WooCommerce 8.0 or newer (HPOS and Cart/Checkout Blocks are declared compatible)
  • PHP 8.1 or newer

WooCommerce must be active. If it is missing, Notice stays inactive and shows an admin notice instead of booting.

Install

Section titled “Install”
  1. Install WooCommerce and make sure it is active.
  2. Install Notice from the plugin directory (when live on WordPress.org), or upload the notice folder to /wp-content/plugins/.
  3. Activate the plugin. No tables are created and no wizard runs, Notice stores everything in one option.

Write your announcement

Section titled “Write your announcement”

Open WooCommerce → Announcement Bar. The screen is one form with a sticky live preview on the right:

  • Announcement text, your message. A small safe-HTML allow-list is supported: <strong>, <em>, <a href>, <span> and <br>. Everything else is stripped on save.
  • Call to action (optional), a button label and URL, plus an open-in-new-tab checkbox. Leave the label blank for a message-only bar.
  • Appearance, background, text and accent colours. The defaults (near-black #1e1e1e, white text, amber #ffd166) read cleanly on any theme, so you only need to touch them to match your brand.
  • Dismiss behaviour, whether shoppers can close the bar, and for how many days the dismissal sticks (0 = forever).

Enable the bar

Section titled “Enable the bar”

Tick Show the announcement bar on the storefront and Save changes. The bar renders only when it is enabled and the message is non-empty, an empty message keeps the bar (and its CSS) off even when enabled.

Verify on the storefront

Section titled “Verify on the storefront”
  1. Open any front-end page, the bar should appear at the very top, above the header.
  2. If a CTA is set, click it and confirm the URL and new-tab behaviour.
  3. If Dismissible is on, close the bar and reload, it should stay hidden for the configured number of days.
  4. Edit the message text and save, the bar re-shows for everyone, including shoppers who closed the old one.

If the bar does not appear, your theme may not fire wp_body_open; see the FAQ.

Editions

Section titled “Editions”

The free edition is the complete product: one store-wide bar with message, CTA, colours and dismissal. Developers can also register additional bars and gate visibility through filters, see Using the announcement bar. There is no paid edition required for any of this.

Need help?

Section titled “Need help?”