Free 0.1.2 and Pro 0.1.2 documentation.
Sale End Date shows shoppers the real date already saved in a native WooCommerce sale schedule. It is a read-only sentence, not a countdown, promotion engine, or price editor.
Requirements
| Component | Requirement |
|---|---|
| WordPress | 6.2 or newer |
| PHP | 7.4 or newer |
| WooCommerce | 8.9 or newer, active |
| Supported product | One native simple product with an active sale and future end date |
| Pro plan | One site, $59/year after a 14-day trial |
Enable the Free sale-end sentence
- Install and activate WooCommerce.
- Install Sale End Date for WooCommerce from WordPress.org after its listing is approved, or upload the supplied Free 0.1.2 ZIP.
- Open WooCommerce > Sale End Date.
- Enable Show the scheduled sale end date.
- Select Save.
Next, edit a native simple product. Set a regular price and sale price, use WooCommerce's Schedule control, and save a future end date. StoreFixKit never creates or repairs that schedule.
Verify the product page
- Open the exact published product while signed out.
- Confirm WooCommerce says the product is currently on sale.
- Confirm one localized sentence shows its future end date.
- Open a product with no end date and confirm StoreFixKit prints nothing.
- Test an expired or future-not-started sale and confirm StoreFixKit does not invent an active deadline.
What Free changes
Free stores one local option, sfk_sed_settings, containing the enabled switch. On the exact queried simple-product page, it checks whether the product is currently on sale and reads WooCommerce's native end date once. A valid future date is formatted with the WordPress site locale and timezone and printed as one escaped paragraph.
Free does not create, edit, extend, expire, repair, or synchronize regular prices, sale prices, start dates, end dates, timezones, stock, coupons, products, carts, checkouts, or orders. It does not render a countdown, popup, badge, shortcode, block, script, or stylesheet.
What Pro adds
Pro adds three bounded display choices:
- one plain-text prefix of at most 60 characters;
- After price, Default, or After purchase area in WooCommerce's native product summary;
- the WordPress site date format, or its date-and-time formats together.
If Pro, Stripe, the network, or the StoreFixKit license API is unavailable, the valid Free date-only sentence continues at its default native position.
Start the 14-day Pro trial
- Open the Sale End Date product page.
- Select Start 14-day trial. No card is required to begin.
- Stripe returns to StoreFixKit after checkout; a signed webhook creates a product-bound license.
- Copy the license key and download the Pro 0.1.2 ZIP.
- Keep Free active, upload and activate Pro, then activate its license.
- Add a payment method before day 14 only if you want the $59/year subscription to continue. Without one, Stripe cancels it at trial end.
Compatibility boundary
This release supports the exact queried native simple-product page and WooCommerce's native woocommerce_single_product_summary hook. It deliberately does not guess a variation sale date.
A builder, quick-view panel, custom product template, product block, bundle, composite, subscription, or other product type can own a different output surface. StoreFixKit does not inject selectors, copy templates, add shortcodes, or clear caches to force the sentence into unsupported layouts.
Privacy, security, and resource use
- Settings writes require
manage_woocommerceand WordPress's settings nonce. - Prefix, position, and format values are allowlisted or length-capped before storage and revalidated at runtime.
- The product identity must match the exact queried product before any sentence can render.
- Output is plain text and escaped; there is no customer-supplied HTML or dynamic countdown script.
- The storefront performs no StoreFixKit or third-party HTTP request and stores no personal data.
- There is no product scan, custom table, cron, Action Scheduler job, queue, telemetry, JavaScript, stylesheet, or runtime write.
Troubleshooting
No date appears
Confirm the Free switch is enabled, the product is a native simple product, the sale is active now, and WooCommerce has a valid future end date. A sale price without an end date intentionally produces no StoreFixKit sentence.
The displayed date is one day or hour off
Check Settings > General > Timezone, date format, and time format. StoreFixKit uses the WordPress site timezone rather than the visitor's browser clock. Also confirm the product's saved schedule is correct in WooCommerce.
The sentence appears on a default product page but not a builder template
Ask whether that template executes WooCommerce's native single-product summary hook. StoreFixKit does not use a shortcode or JavaScript injection as a fallback.
A variable product has several variation dates
This release renders nothing rather than choosing a date that may not match the shopper's variation. Do not use it to promise a variable-product deadline.
Pro formatting does not apply
Confirm Free and Pro are active, the license belongs to Sale End Date Pro, and the chosen prefix, position, and format were saved. When licensing is unavailable, Free intentionally falls back to its local date-only output.
Rollback and uninstall
- Back up the database and keep the 0.1.2 and previous deterministic ZIPs.
- Deactivate Pro and confirm the Free sentence remains.
- Deactivate Free and confirm the sentence disappears while WooCommerce's sale and prices remain unchanged.
- Install the previous Free ZIP, then the matching Pro ZIP if needed.
- Test one active future-dated sale and one product without a date before restoring 0.1.2.
The verified release drill installed a synthetic 0.0.1 baseline, updated to 0.1.2, downgraded, rolled forward, deactivated, and exercised both uninstall modes while preserving WooCommerce product and order data.
Normal uninstall preserves Free settings, Pro settings, and the license for accidental recovery. Define STOREFIXKIT_DELETE_DATA as true before deletion only when you deliberately want Free to remove sfk_sed_settings and Pro to remove sfk_sed_pro_settings plus its license option. Prices, sale schedules, products, carts, customers, orders, and third-party data are never deleted.
StoreFixKit Support
Use StoreFixKit Support and include the affected product URL and ID, product type, regular and sale state without sensitive order data, scheduled start and end values, expected and actual sentence, site timezone, Free and Pro versions, WordPress and WooCommerce versions, theme or builder, cache/CDN status, and redacted desktop/mobile screenshots. Never send credentials, customer or order data, API keys, payment details, or a complete license key.
For feedback, describe the shortest repeatable setup and whether the default WooCommerce product template shows the date. After resolution, support will provide the correct WordPress.org review link once the official listing exists.