Gatemi Announcement Bar Settings Reference

Settings are on WooCommerce → Announcement Bar (capability manage_woocommerce). Both editions use two options: gmab_settings for the switches and gmab_bars for the bars, in the same shape. Upgrading keeps every bar.

The settings screen
The free edition’s settings screen.

General

Show the announcement bar

  • Key: gmab_settings[enabled] · Default: on (yes)
  • The master switch. Off, no bar is shown anywhere. The full edition labels it Show announcement bars.

At most this many on one page — Full edition

  • Key: gmab_settings[max_bars] · Default: 2 · Range: 1–5
  • How many bars one page may carry. The first ones that apply, in the order you listed them, are shown. Free edition: one.

Each bar

The free edition edits the first bar. If the full edition wrote more, they are kept exactly as they are and a note on the screen says so.

Label Key Default What it does
Message message — The text. Links and basic formatting allowed; scripts are removed, at save and again when shown. Emptying the message deletes the bar.
Button button empty The button's label.
Goes to url empty The button's address. A javascript: address is removed. The button only shows with both a label and an address.
Position — Full edition position top Top (after <body>) or Bottom (in the footer). The free edition always draws its bar at the top.
Background background #1e1e1e A hex colour. Anything that is not a colour falls back to the default.
Text text #ffffff A hex colour, as above.
Starts starts empty First day shown, in your site's timezone. Empty means from now.
Ends ends empty Last day shown — inclusive. Empty means no end.
Stays put as they scroll — Full edition sticky off Keeps the bar fixed while the page scrolls.
Can be closed dismissible on Shows the × control.
Stays closed for (days) dismiss_days 7 0–365. 0 means until the visitor closes their browser.
Switched on enabled on A bar can be kept but not shown.

A date that cannot be read is stored as "no date" rather than a date in 1970.

Unticking Switched on keeps the bar but stops showing it; unticking Can be closed removes the × control. Each checkbox posts a hidden 0 before it, so an unticked box is saved as off.

Conditions — Full edition

Each bar can carry conditions. Every condition on a bar must be true for it to show; adding one only ever narrows who sees the bar. A condition the plugin does not understand counts as false.

Condition Key Value
Only on these pages page Comma-separated: shop, category, product, cart, checkout, account, home
Everywhere except these pages not_page Same list — checkout is the usual answer
The cart is worth at least min_total An amount, compared with the cart subtotal (before tax and discounts); 1.250,00 is read as 1250
The cart is worth at most max_total An amount — "spend £50 for free shipping" is a max of 49.99
The cart is empty cart_empty —
The cart holds something from these categories has_category Category IDs
The visitor's role is one of user_role Role keys; guest means not signed in
It is before this time today before_time A time such as 15:00, on the store's clock

Free edition: conditions are kept on a bar but not evaluated. A bar that carries any condition is not shown in the free edition, because showing it without its targeting could show it to the very visitors it was meant to exclude. The screen says so on that bar.

License & updates — Full edition

Enter the GM-XXXXX-… key from your gatemi.com account and press Activate. A failed check never changes the licence state.

For developers — Full edition

The screen lists the filters it applies; see the developer reference.

Shopping Cart
Scroll to Top