Skip to content
WPPoland Documentation

Getting started

Marks is ready as soon as WooCommerce is active. Enable the badges you need, set thresholds once, and check a shop listing — usually under five minutes.

Before you start

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

Install

Section titled “Install”
  1. Install WooCommerce and make sure it is active.
  2. Install Marks from the plugin directory (when live on WordPress.org) or upload the marks folder to /wp-content/plugins/.
  3. Activate the plugin.

Badges use packaged CSS — no build step and no front-end script to enqueue.

First configuration

Section titled “First configuration”

Open Marks in wp-admin:

  • Enable badges — master switch for the whole plugin.
  • Show on single / loop — where badge groups may render.
  • Automatic badges — tick Sale, New, Low stock, Bestseller, etc.; customise labels or leave blank for defaults.
  • Thresholds — newness days, low-stock count, bestseller sales, free-shipping class slugs (comma-separated).
  • Shape and caps — pill or square, optional uppercase, max badges on single vs loop cards.
  • Hide theme “Sale!” flash — recommended when the Marks Sale badge is enabled so shoppers see one clear promo label.

Hover ? on any row when the effect is unclear — help text is written for merchants, not developers.

Verify on the storefront

Section titled “Verify on the storefront”
  1. Open a product on sale — confirm a Sale badge appears on the image without shifting the layout.
  2. Open Shop — badges should sit on loop cards with the loop badge cap respected.
  3. Temporarily set low-stock threshold high on a stock-managed product and confirm Low stock appears at the right quantity.
  4. If you enabled Hide theme sale flash, confirm WooCommerce’s default corner flash is gone while Marks Sale remains.

Add a manual badge

Section titled “Add a manual badge”
  1. Under Marks → Manual badge, set a label (e.g. “Staff pick”) and colour.
  2. Edit a product in WooCommerce and add custom field/meta _marks_manual_text with that label (and optionally _marks_manual_style).
  3. View the product — the manual badge should appear alongside automatic badges until caps are reached.

Shortcode

Section titled “Shortcode”

Show badges outside the default templates:

[marks_badges]
[marks_badges id="123" context="loop"]

The shortcode enqueues badge CSS on that page when badges are present.

Free vs PRO

Section titled “Free vs PRO”

The free edition covers automatic and manual badges, thresholds, CSS-only render, sale-flash hiding and the shortcode.

Marks PRO (planned) adds scheduled campaign badges, conditional display rules, image badges and A/B label tests — not basic automatic badges.

Need help?

Section titled “Need help?”