=== Liftly Product Badges & Labels for WooCommerce ===
Contributors: taylerz
Tags: product badges, product labels, sale badge, badges, woocommerce labels
Requires at least: 6.5
Tested up to: 7.1
Requires PHP: 7.4
Stable tag: 1.0.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Show sale, new, low stock, bestseller and free shipping badges on every product card. They update themselves as prices and stock change.

== Description ==

**Shoppers decide at a glance. Give every product card a reason to click.**

Liftly Product Badges puts clear, good-looking badges on your product images: sale, new, low stock, sold out, bestseller, staff pick and free shipping. Install it and your products start wearing the right badge, with no rules to build. When a price drops, stock runs low or a product becomes a top seller, its badge appears by itself, and it goes away when the moment passes.

A $18 tote on sale for $12 shows "−33%". The coffee beans everyone keeps buying show "Bestseller". The last three cotton tees show "Only 3 left". A $89 grinder shows "Free shipping" because it clears your $50 minimum. Shoppers see why a product is worth a click before they click.

= Why store owners choose it =

* **Never two sale badges.** The Sale badge takes the place of WooCommerce's own "Sale!", in classic themes and in product blocks, so a product wears one clean badge. Turn it off and WooCommerce's badge comes back.
* **Real savings, not just "Sale".** It shows "−33%" or "Save $6". Variable products show their biggest saving, like "Up to −30%".
* **Works on its own.** Sale, New, Low stock, Sold out, Bestseller, Staff pick and Free shipping switch on and off as your prices, stock, dates and sales change. Nothing to update by hand.
* **Sell the last units faster.** "Only 3 left" shows when stock runs low, and sold-out products say "Sold out" (or "Back soon") before the shopper clicks.
* **Let your hits sell themselves.** Your top sellers get a Bestseller badge, recounted every day. Products you star in WooCommerce get "Staff pick".
* **Turn free shipping into a reason to buy.** Products whose price alone reaches your free shipping minimum get a "Free shipping" badge.
* **Tell each product's story.** Give any product its own badge, like "Handmade", "Gift idea" or "Fair trade", with optional start and end dates.
* **Match your brand in minutes.** Six styles, three sizes, four corners, your own texts and colours, and a priority order, with a live preview as you edit. Badges take your theme's font and their text stays readable on any colour.
* **See which badges sell.** The Results tab shows orders, units and revenue from badged products over the last 30 days, with sales for each badge.

= How it works =

1. Install and activate. Your products get their badges right away.
2. Open WooCommerce → Product Badges. Switch badges on or off, change the texts and colours, and pick a style. The live preview shows every change.
3. Watch the badges come and go as your store changes, and check the Results tab to see what they sell.

= Works with =

* Classic and block themes, such as Storefront and Twenty Twenty-Five.
* Shop, category, tag and search pages, related products and upsells, the product page gallery, and WooCommerce product blocks such as Product Collection.
* Classic and block checkout, and High-Performance Order Storage (HPOS).
* Phones and tablets, and right-to-left languages with mirrored badges.
* Translation: every text is translatable, and every badge text can be changed in the settings.
* The `[liftly_badges]` shortcode, to show a product's badges anywhere.

= Privacy and speed =

Badges are plain HTML and CSS: one small stylesheet that loads only on pages with products, and no script on your storefront. Badges sit on top of the image, so nothing jumps while the page loads. No account, no external service, no tracking.

= More from Liftly =

* Liftly Free Shipping Bar & Cart Goals: show how close each cart is to free shipping.
* Liftly Back in Stock Notifications & Waitlist: turn "Sold out" into a waitlist that buys when the product is back.
* Liftly Tiered Pricing & Quantity Discounts: a clear price table that sells the bigger pack.

== Installation ==

1. Install and activate WooCommerce.
2. Install Liftly Product Badges from Plugins → Add New, or upload the plugin folder to `/wp-content/plugins/`.
3. Activate it. Your products get their badges right away.
4. Open WooCommerce → Product Badges to choose the badges, texts, colours and look.

== Frequently Asked Questions ==

= Will a product ever show two sale badges? =

No. Wherever the Sale badge shows, it takes the place of WooCommerce's own "Sale!", in classic themes and in product blocks alike. Turn the Sale badge off and WooCommerce's badge comes back.

= Does it work with block themes and the block checkout? =

Yes. Badges appear in block themes such as Twenty Twenty-Five and in classic themes such as Storefront, and sales are counted from both the block checkout and the classic checkout.

= Where do the badges appear? =

On product images on shop, category, tag and search pages, in related products and upsells, in the product page gallery and in WooCommerce product blocks such as Product Collection. Choose the places in WooCommerce → Product Badges → Design, and use `[liftly_badges product_id="123"]` to show a product's badges anywhere else.

= Can I change the texts, colours and style? =

Yes. Every badge has its own text and colour, and you can choose from six styles (pill, rounded tag, corner ribbon, circle, flag and text only), three sizes and four image corners. A live preview updates as you edit.

= Can I give one product its own badge? =

Yes. Open the product, choose the Badge tab in Product data, and type any text, like "Handmade" or "Gift idea". Pick a colour, and set a start and end date if you want it to appear for a limited time.

= How is a bestseller chosen? =

By total sales. Out of the box, the top 5 products with at least 3 sales get the badge. You can change both numbers, and the list is recounted once a day.

= How does the Free shipping badge know my minimum? =

It uses the minimum order amount of the Free shipping methods you have enabled in WooCommerce → Settings → Shipping, for the shopper's shipping zone. Shoppers who have not entered an address see the zone of your store's country.

= What if a product earns more badges than it can show? =

It wears the ones highest in your priority list, up to the number you choose (1 to 3, two by default). Drag the badges into the order you like.

= How are the Results counted? =

When a shopper adds a product to the cart, the badges it wears at that moment are saved with the order. Results count paid and on-hold orders from the last 30 days.

= Will it slow down my store? =

No. Badges are plain HTML with one small stylesheet that loads only on pages that show products. There is no script on your storefront, and badges sit on top of the image, so nothing jumps while the page loads.

= Can I translate it? =

Yes. All texts are translatable, every badge text can be changed in the settings, and right-to-left stores get mirrored badges.

= What happens to my data if I delete the plugin? =

Nothing, unless you ask for it. Your settings and the products' own badges stay in place if you deactivate or delete the plugin. Turn on "Remove data when the plugin is deleted" in the settings if you want a clean sweep. Past orders keep their badge history either way.

= Do I need an account or an external service? =

No. Everything runs inside your site: no sign-up, no outside requests, no tracking.

== Screenshots ==

1. Give every product a reason to click: sale, bestseller, new, low stock, staff pick and free shipping badges on the shop page.
2. The same badges in any theme, on the product page too, with the real saving shown on the Sale badge.
3. Badges stay sharp on desktop and phone, and sit on the image so nothing jumps while the page loads.
4. Six styles to match your brand: pill, tag, ribbon, circle, flag or plain text, in your theme's own font.
5. Edit a badge and watch it update: texts, colours and rules for each badge, with a live preview beside them.
6. Pick the look, size and corner: six styles, three sizes, four corners and a priority order you drag into place.
7. Give any product its own badge, like "Handmade", "Gift idea" or "Fair trade", with start and end dates if you like.
8. See which badges really sell: orders, units and revenue from badged products, with sales for each badge.

== Changelog ==

= 1.0.0 =
* First release.
