View Categories

Display Settings

2 min read

Display Settings control the global Smart Cycle Discounts badge system introduced in v1.7.23. This tab now manages badge visibility, template fallback, overlap behavior with native WooCommerce sale badges, time-phase text, and badge HTML caching.

Accessing Display Settings #

  1. Go to SC Discounts → Settings
  2. Open the Display tab

Display & Badges Settings #

Badge Display Section #

Setting Purpose Default
Enable Badges Master switch for campaign badge output Enabled
Show on Shop/Archive Allows badge rendering on product loops Enabled
Show on Product Page Allows badge rendering on single product gallery/images Enabled
Show in Cart/Checkout Controls cart/checkout badge visibility signals used by badge UI/contexts (not the core cart price discount calculation itself) Enabled
Default Template Global badge template fallback when a campaign template is not set default

Behavior Section #

Setting Purpose Default
Campaign Priority Mode How winning campaigns are resolved (manual or smart) manual
Enable Time-Phase Badge Text Allows auto text overrides near campaign start/end Enabled
Phase Window Hours used for phase text logic (1–168) 24 hours
Native Sale Badge Strategy hide_native or offset_badge handling for WooCommerce/theme sale badges hide_native
Force Hide Native Sale Badges Hard toggle for hiding native sale badge output Enabled
Enable Badge HTML Cache Caches rendered badge markup for faster repeated loads Enabled

Important: If Native Sale Badge Strategy is set to offset_badge, native sale badges are kept and the force-hide toggle is effectively disabled.

Template System #

Supported Templates #

Smart Cycle Discounts currently supports:

  • default
  • pill
  • ribbon
  • outline
  • square
  • circle
  • tag
  • dashed

Global vs Campaign Template Resolution #

  1. If a campaign has a valid badge_template, that template is used.
  2. If campaign template is empty/invalid, Display Settings Default Template is used.
  3. If global default is invalid, fallback is default.

Outline and Dashed Color Behavior #

outline and dashed use outline-style rendering:

  • Transparent background
  • Badge border/text use the configured badge background color

Context Rules by Discount Type #

Context visibility is controlled by both global Display toggles and discount-type rules:

  • Shop/Archive: BOGO and Spend Threshold badges are suppressed.
  • Product Images: Spend Threshold badges are suppressed.
  • Gallery Thumbnails: Compact badge text is used (for example -20%, BOGO, DEAL).

This is why a badge can be enabled at campaign level but still be hidden in certain frontend contexts.

Badge Text Generation #

Order of Text Resolution #

  1. Campaign custom text (if not auto)
  2. Phase text (Starts Soon or Ends Soon) when enabled and within phase window
  3. Auto-generated text from discount type

Auto Text Examples #

  • Percentage: Save 20%
  • Fixed: Save $10.00 (currency aware)
  • BOGO: Buy 1 Get 1 Free (or quantity variant)
  • Tiered: Volume Discounts

WooCommerce/Theme Overlap Handling #

The plugin integrates through WooCommerce display hooks and can hide or coexist with native sale badges depending on your overlap strategy.

  • Hide mode: Native sale badges are suppressed for products with active SCD badge output.
  • Offset mode: Native badges remain visible and SCD badges use offset styling (.wsscd-badge-with-sale).

If your theme injects custom sale labels, test both strategies and clear all caches after saving changes.

Caching and Performance #

Badge HTML Cache #

When enabled, rendered badge HTML is cached with a settings-aware fingerprint to reduce repeated rendering cost. Cache entries are short-lived and keyed by product, context, badge payload, and display settings.

When to Clear Cache #

  • After changing Display Settings
  • After changing badge template/color settings in campaigns
  • After deploying theme CSS that affects badge classes

Frontend CSS Classes #

Use these classes for theme-level styling:

  • .wsscd-discount-badge (base badge)
  • .wsscd-badge-position-top-left, .wsscd-badge-position-top-right, .wsscd-badge-position-bottom-left, .wsscd-badge-position-bottom-right
  • .wsscd-badge-style-pill, .wsscd-badge-style-ribbon, .wsscd-badge-style-outline, .wsscd-badge-style-square, .wsscd-badge-style-circle, .wsscd-badge-style-tag, .wsscd-badge-style-dashed
  • .wsscd-badge-with-sale (offset mode)
  • .wsscd-badge-compact (gallery thumbnails)
  • .wsscd-has-discount (body/product class when native hide mode is active)

Troubleshooting Checklist #

  1. Confirm campaign badge is enabled in Wizard Step 3.
  2. Confirm global Enable Badges is on.
  3. Check context toggles (Shop/Product/Cart).
  4. Check discount type context limits (for example Spend Threshold is cart-focused).
  5. Test overlap strategy (hide_native vs offset_badge).
  6. Clear plugin/object/page cache and browser cache.
Updated on February 17, 2026

What are your Feelings

  • Happy
  • Normal
  • Sad