Kairii Sale Calendar

Plan the sale. Set the dates. Let Kairii handle the prices.

Stop changing WooCommerce sale prices by hand. Kairii puts your promotions on a visual calendar, applies discounts automatically when a sale begins, and restores normal pricing when it ends. Choose the products, set the offer, preview the results, and protect your minimum profit — all from one workspace.

Schedule sales without the last-minute rush

• Plan promotions on a month-by-month calendar, with a sale editor directly beneath it.
• Set start and end dates, choose products or categories, and discount from selling price or margin.
• Preview sale prices, earnings and exclusions before a promotion goes live.
• Fine-tune individual products with their own discount, fixed price or exclusion.
• Display a sale badge and price message on eligible shop products.
• Kairii applies prices dynamically rather than overwriting your products’ stored prices.

Protect your margins automatically

• Set minimum profit safeguards so discounts are capped before they fall below known cost plus your required profit.
• Use WooCommerce product costs or manage category-based costs and margins.
• Keep existing WooCommerce sale prices in control: promotions do not stack.
• Exclude products with unknown costs from Kairii discounts.
• Review the live pricing table to see exactly which products qualify.

Make every occasion an opportunity

• Start with ten familiar retail occasions, including Valentine’s Day, Black Friday and Christmas.
• Add your own occasions, anniversaries and birthdays.
• See upcoming occasions and running promotions from the WordPress dashboard.
• Get optional email reminders and a practical promotional checklist.
• Review sales performance using paid WooCommerce orders.

Free and Pro

Kairii Free includes calendar-based sale planning, automatic sale start and end, margin protection, product selection, previews, and the starter occasions.

Kairii Pro extends your planning with the full library of 1,500+ international and specialist occasions, annual repeating sales, additional fulfilment providers, and advanced price-list features.

Less manual price editing. More time to plan the next promotion.

Uninstall

Deactivating Kairii stops its sales at once and removes nothing.

Deleting Kairii keeps your data by default, so reinstalling picks up where you left off. To remove everything, switch on Settings → Data → “Remove all Kairii data when the plugin is deleted” before you delete the plugin. Kairii then removes its occasions and sales, all of its settings (including the price list and its rules), the reminder settings kept for each user, the price-list links on products, and the sale notes it adds to order lines.

Your products and prices are never changed by Kairii, so there is nothing to undo. Costs in WooCommerce’s own Cost field stay, as they are your WooCommerce data, and your orders and their totals are untouched.

External services

Occasion date updates (optional). Festivals that follow the moon ship with checked dates for a few years at a time. When you press “Check for updates” in Kairii → Settings, or switch on the monthly check, Kairii downloads one signed file of occasion dates from robart-illustration.eu (https://robart-illustration.eu/wp-json/wprobarts/v1/kairii-occasions). Nothing about your site or shop is sent — it is a plain download. Kairii never contacts the server unless you press the button or switch on the monthly check. Privacy policy: https://robart-illustration.eu/privacy-policy-rob-art-illustration/

Support

Questions, bug reports and feature requests are welcome on the plugin’s support forum: https://wordpress.org/support/plugin/kairii-sale-calendar/

1. Install and activate WooCommerce.
2. Upload the kairii-sale-calendar folder to /wp-content/plugins/, or install it from the Plugins screen, and activate it.
3. Open Kairii → Margins and set what you make per product category (or switch on WooCommerce’s cost of goods).
4. Open Kairii → Occasions and add the occasions you sell around, then plan your first sale from Kairii → Calendar.

1. 

   The Calendar — occasions and your planned sales, month by month. Click a day to plan a sale under the calendar.

2. 

   The sale panel — pick the products, set a discount off the price or off your margin, and choose the dates with one-click shortcuts.

3. 

   Occasions — starter retail dates and your own occasions and birthdays; the expanded occasion library is available in Pro.

4. 

   Margins — set category margins, manage costs and fulfilment providers, and review the cost price list.

5. 

   The Dashboard — what each sale sold, and the occasions coming up.

6. 

   The sale price bar on the shop — a line under the price saying why a product is on sale and when it ends.

7. 
8. 

0.2.2

• Changed: the Upgrade to Pro buttons now go straight to checkout.
• New readme: rewritten description and feature list.

0.2.1

• Security: internal hardening.

0.2.0

• New: provider boxes continue along the row and fill the width before wrapping; with Kairii Pro a fresh box appears as you fill the last one, so you can list as many providers as you run. Without Pro you get four and a note about adding more.
• Changed: the “Weekend around it” date shortcut is now “Days Either Side” and sets one day before and one day after, whatever the weekday.
• Changed: when a sale is set to repeat every year, the “Remember these products” tick is replaced by a note — a repeating sale already keeps its products.
• Fixed: dropdowns and text boxes on the Margins and Settings screens were hard to read under a dark admin colour scheme; they now stay readable whatever the scheme.
• Fixed: the “saved” confirmation messages now fade away after a few seconds instead of staying on screen.

0.1.5

• Fixed: products whose size attribute had a different name, such as “Size” on a print made by Printful beside “Size (inches)” on one made by hand, were kept apart in the cost list, so the new product’s sizes never showed under the size you picked. Size, Sizes and Size (inches) now form one list, and every rule reaches them all.
• Fixed: sizes written with inch marks, such as 16″×24″, did not match the same size written 16×24. Inch marks are now ignored when sizes are compared. Rules you already saved keep working.
• Improved: the Dashboard’s Sales list shows 15 sales a page, in the order they will happen: running now, then the next one coming up, with finished one-off sales last. A sale that repeats every year shows its next dates, and a one-off sale that is over says Ended.
• Improved: on the Catalogue, “By product” now shows only the product view; the list of all occasions belongs to “By occasion”.

0.1.4

• New: linking products or categories to an occasion in the Catalogue also adds them to that occasion’s existing sales, and Save says which sales changed. Kairii only adds, never removes, and a sale for all products is left as it is.
• New: the Dashboard’s Sales list has a Products column showing what each sale covers: all products, its categories, or how many single products.
• Improved: Kairii’s own icons in the header bar, the Settings cards and the Licence card.
• Improved: the manual covers editing an occasion’s date, sales linked from the Catalogue and the new Products column.

0.1.3

• Changed: Kairii now comes with ten days every shop knows: New Year’s Day, Valentine’s Day, International Women’s Day, Easter Sunday, Halloween, Singles’ Day, Black Friday, Cyber Monday, Christmas Day and Boxing Day. The full library of more than 1,500 awareness days, national days, festivals and birthdays, with its date updates, is part of Kairii Pro.
• Changed: a sale runs once, on the dates you set. Repeating a sale every year is part of Kairii Pro, and the sale panel says so where the option sits.
• New: change an occasion’s date and how it repeats from its Edit form on the Occasions screen.
• New: mark a new occasion as someone’s birthday straight from the calendar, as well as on the Occasions screen.
• New: a bar under the product price says why it is on sale, for example “World Animal Day sale · up to 20% off · ends Monday 5 October”. Switch it off in Settings.
• New: a ✕ on the calendar’s day panel removes an occasion added by mistake.
• Changed: a new occasion starts with no sale. Sales show as amber lines on the calendar, and as a white line on today’s square.
• Changed: one row of the cost list or price list can match several values, for example ePub, PDF and MOBI together.
• Improved: the Upgrade page shows the dashboard and the calendar, the upgrade window shows its whole picture, and Kairii has its own menu icon and logos.
• Fixed: the “Add your own occasion” form filled in today’s date, so an occasion saved without picking one landed on today. The date now starts empty.
• Fixed: occasions whose sale covers all products showed “Nothing linked” on the Occasions and Catalogue screens, and were flagged as gaps. They now say “All products”.
• Fixed: the calendar’s weekday headings could start on the wrong day.
• Fixed: occasion names with an apostrophe could show as ’.

0.1.2

• New: cost price list — one row per size with the provider, the categories that sell it and what it costs; written into WooCommerce’s own Cost field and kept in step whenever a product is saved.
• New: one row can cover several categories, or every product in a category (“Any product”), such as ePubs.
• New: one switch per product, “Kairii list” or “Set by hand”, above the variations list, with a note under each size.
• New: price list in Kairii Pro — standard selling prices per size, fixed or worked out from cost, written into the Regular price.
• New: WordPress Dashboard card showing what is celebrated today, sales running now and what is next on your calendar.
• New: User Manual, Read Me and Licence viewer, plus fuller sidebars with how-to text and running totals on every screen.
• New: Upgrade page and pop-up overview of Kairii Pro.
• New: Data card in Settings, and a clean uninstall that removes Kairii’s data only when you ask it to.
• New: Support and Debug Information sections in the Settings sidebar.
• Improved: the “Coming up” notice can be snoozed per occasion or as a whole, coming back after half the time left.
• Fixed: the calendar no longer suggests a sale for an occasion that already has one.
• Fixed: “Copied!” showed before anything was copied.
• Fixed: running sales and results now refresh straight after a sale is saved or deleted.
• Security: every request handler checks its nonce and permission itself, and all input is sanitised and output escaped.

0.1.1

• New: sale calendar with a planning workbench under it — dates, discount off price or off margin, products and categories, price endings, sale badge, live price table and per-product tweaks.
• New: occasion library of about 1,500 dated days in sections (International, Europe, Americas, Asia, Africa, Oceania, Birthdays, Retail), plus your own occasions; add any to your calendar with one click.
• New: Catalogue screen to link products to occasions, by occasion or by product, with name-based suggestions and copying.
• New: money safeguards — minimum profit always wins, no discount without a known cost, coupons skip sale items, and a warning when sizes share one cost.
• New: Margins screen with category margins, sale defaults and fulfilment providers.
• New: “Coming up” reminders on the Dashboard and an optional email digest.
• New: optional signed occasion-date updates.
• New: Dashboard with live sale status and what each sale sold.
• New: Settings screen with system status.