Zum Inhalt springen
WooCommerce & WordPress Plugin Docs

Getting started

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

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. The plugin seeds sensible defaults on first activation, so badges already work before you open the settings screen.

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

Marks declares WooCommerce as a required plugin and shows an admin notice if WooCommerce is inactive; it registers no hooks until WooCommerce loads.

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 render from packaged CSS, there is no build step and no front-end JavaScript to enqueue.

First configuration

Section titled “First configuration”

Open Marks in wp-admin (it sits as its own top-level menu). The screen is grouped into cards:

  • Display, the master Enable badges switch, plus where badges may render (single product page, shop/category/tag listings).
  • Automatic badges, tick Sale, New, Low stock, Bestseller, and optionally Discount percent, Free shipping and Out of stock; type a custom label or leave it blank for the default.
  • Thresholds, newness days, low-stock quantity, bestseller sales, and the comma-separated free-shipping class slugs.
  • Appearance, pill or square shape, optional uppercase, and the per-context badge caps.
  • Manual badge, one store-wide label and colour.

Click the ? button on any row for help written for merchants. The live preview on the right updates as you change settings.

Verify on the storefront

Section titled “Verify on the storefront”
  1. Open a product on sale, confirm a Sale badge sits over the image without shifting the layout.
  2. Open Shop, badges should appear on loop cards, respecting the listings cap.
  3. Temporarily raise the low-stock threshold on a stock-managed product and confirm Low stock appears at the expected quantity.
  4. If you enabled Hide theme “Sale!” flash, confirm the theme’s default corner flash is gone while the Marks Sale badge remains. (It is only hidden when the Sale badge is also enabled.)

Add a manual badge

Section titled “Add a manual badge”
  1. Under Marks → Manual badge, set a label (e.g. “Staff pick”) and a colour.
  2. Edit a product and add the custom field _marks_manual_text with the text you want that product to show (it can differ per product). Optionally add _marks_manual_style with accent, success, warning, danger or neutral to recolour it.
  3. View the product, the manual badge appears first, ahead of the automatic badges, until the cap is reached.

Free vs Pro

Section titled “Free vs Pro”

The free edition covers the seven automatic badges, the manual badge, thresholds, CSS-only rendering, sale-flash hiding and the [marks_badges] shortcode, the full GPL product.

Marks Pro (planned) adds scheduled campaign badges, conditional display rules, image badges and A/B label tests, not the basic automatic badges, which are free.

Need help?

Section titled “Need help?”