Zum Inhalt springen
WooCommerce & WordPress Plugin Docs

Getting started

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

Most shops can show a countdown in a few minutes: install, tick Enable countdown, then set a sale end date on a product.

Before you start

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

If WooCommerce is not active, Ticker stays quiet and shows an admin notice instead of booting.

Install

Section titled “Install”
  1. Install WooCommerce and make sure it is active.
  2. Install Ticker from the plugin directory (when live on WordPress.org), or upload the ticker folder to /wp-content/plugins/.
  3. Activate the plugin through the Plugins screen. No setup wizard runs.

The countdown is on by default (enabled is true), but it only renders once a product actually has an end time to count down to.

Give it an end time

Section titled “Give it an end time”

The timer needs a deadline. Choose one of two sources on WooCommerce → Ticker:

  • WooCommerce sale end date (the default). On a product, set Product data → General → Sale price dates → To. The countdown then appears on that product, with no per-product Ticker setup.
  • Fixed campaign end date. Enter a single date under WooCommerce → Ticker → Campaign end date to count the whole store down to the same moment.

With the source left on the sale date, the campaign date you enter also acts as a fallback: products with their own sale end use that, and products without one fall back to the campaign date.

The campaign date is a datetime-local field interpreted in your site timezone (Settings → General). Ticker converts it to a fixed UTC timestamp at render time.

Verify on the storefront

Section titled “Verify on the storefront”
  1. Open a product with a sale end date in the future, the live countdown should tick down once per second.
  2. Watch the seconds dial: its ring drains over each minute, and the digit snaps on every tick.
  3. Set a sale end date in the past (or wait for one to lapse), the clock should be replaced by the expired message, not a frozen 00:00:00.
  4. Confirm there is no layout shift: the digit boxes are sized before the script fills in the numbers.

Choose where it appears

Section titled “Choose where it appears”

The default placement is the product summary, below the price. Switch it under WooCommerce → Ticker → Placement to before or after the add-to-cart form, or to the product meta area, pick the spot that fits your theme’s layout.

Free vs Pro

Section titled “Free vs Pro”

The free edition covers everything above: sale-date and campaign countdowns, four placements, three formats, an optional heading and a custom expired message.

Ticker Pro (planned) uses the ticker/end_timestamp filter to add per-product or scheduled campaign windows. The filter is already present in the free edition for developers who want to wire their own end time (see Configuration).

Need help?

Section titled “Need help?”