Addons

Shipping Cutoff Clock

Displays a live countdown telling shoppers how long they have left to qualify for today’s dispatch. Works on product, cart, and checkout pages.

How the clock works

  • ShippingCutoffClockAddon registers on kitbix_commerce_after_product, kitbix_commerce_cart_before_table, and kitbix_commerce_checkout_after_payment_methods.
  • The PHP layer calculates the next cutoff using DateTimeImmutable and local timezone from wp_timezone_string().
  • Messages are built from the configured templates, replacing {countdown} and {cutoff} tokens.
  • Frontend assets (shipping-cutoff-clock.css/js) animate the timer and swap messaging once the countdown hits zero.

Settings reference

Field Key Description
Daily Cutoff Time cutoff_time 24-hour format string (e.g., 16:00). Defaults to 4:00 PM. Sanitized per request.
Message (Before Cutoff) message_before Supports {countdown} token to show the formatted duration (e.g., “Order in {countdown} for dispatch today”).
Message (After Cutoff) message_after Supports {cutoff} token to show the next dispatch label.
Show on product pages show_on_product Checkbox. Uses shortcode detection to decide if the block renders.
Show on checkout page show_on_checkout Checkbox. Requires the checkout page or shortcode.
Show on cart page show_on_cart Checkbox. Renders before the cart table.

Implementation checklist

  1. Enable the addon and set the cutoff time to match your fulfillment SLA.
  2. Customize pre/post messages, keeping placeholders intact.
  3. Toggle the visibility checkboxes for the contexts you want (product, cart, checkout).
  4. Visit each page type to confirm the clock renders and the timezone is correct.
Tip: Translate the messages via standard WordPress translation files—the addon wraps strings in __().

Common pitfalls

  • Leaving cutoff blank—addon falls back to 16:00 but document the actual SLA for ops.
  • Expecting the timer on landing pages without Kitbix shortcodes; the addon only runs when cart/checkout/product contexts are detected.
  • Using 12-hour times ("4pm"). Stick to HH:MM to avoid parsing fallback.
Reminder: The countdown resets at midnight based on the site timezone. If you batch orders in a different timezone, adjust WordPress settings first.