Plugin Configuration

Accessing Settings

To configure WC Price History settings:

1. Navigate to Settings:
   • Go to WooCommerce → Price History in your WordPress admin
   • Or click the “Settings” link on the plugins page
2. Settings Overview:
   • The settings page contains all configuration options
   • Changes are saved immediately when you click “Save Changes”
   • Settings are organized into logical sections

Where to Display Lowest Price

Configure where the lowest price information appears:

Display Locations:

• Single Product Page: Show on individual product pages
• Related Products: Include on related/upsell products on product pages
• Main Shop Page: Display on the main shop/archive page
• Product Category Page: Show on category archive pages
• Product Tag Page: Display on tag archive pages

Shortcode Alternative:

• Use [wc_price_history] shortcode anywhere in content
• Provides maximum flexibility for custom placement
• When “Do not display the lowest price on variable product before choosing a variation” is enabled, the shortcode also shows the placeholder text until a variant is selected (same behaviour as the default price block)

When to Display Lowest Price

Control when the lowest price information is shown:

Display Options:

• Always: Show on all products regardless of sale status
• Only When Product is On Sale: Display only when product has a sale price

EU Compliance Note:

• The Omnibus Directive requires showing lowest price when announcing price reductions
• “Only When Product is On Sale” setting helps ensure compliance

How to Calculate Lowest Price

Configure the calculation method for lowest price:

Calculation Methods:

• Current Day: Count 30 days back from today
• Day Before Sale Started: Count 30 days before sale start date (excludes promotional price)
• Day When Sale Started: Count 30 days from sale start date (includes promotional price)

Sale Date Requirements:

• For sale-based calculations, products must have “Sale price dates” set
• If no sale start date is set, falls back to “Current Day” method
• Products without sale dates are logged for review

Customizing Display Text

Personalize how the lowest price is displayed:

Text Template:

• Default: “30-day low: {price}”
• Use placeholders: {price} for price, {days} for number of days
• Customize to match your store’s tone and language

Styling Options:

• Line-through: Apply strikethrough to the price
• CSS Classes: Use .wc-price-history and .prior-price for custom styling
• Price Format: Follows WooCommerce price formatting settings

Old History Handling: When price history is older than the set period:

• Hide: Don’t display anything
• Current Price: Show current price instead
• Custom Text: Display custom message with placeholders