=== SheetStamp Labels – Barcode & Price Labels for WooCommerce ===
Contributors: dodsondevelopment1
Tags: barcode labels, price labels, avery labels, product labels, zebra
Requires at least: 6.2
Tested up to: 7.1
Requires PHP: 7.4
Stable tag: 1.0.4
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Print barcode and price labels for WooCommerce products on Avery 5160 sheets or Zebra/thermal rolls from your browser. Free, no account needed.

== Description ==

SheetStamp Labels prints **barcode labels, price tags and SKU labels for WooCommerce** products and orders. Pick products, pick a label sheet, press Print. No account, no signup, no upsell to print.

It is built for shops that stock-label, re-price, or label incoming inventory: print one label per unit ordered straight from the Orders list, or a sheet of price labels from the Products list.

= What you can print =

* Barcodes from the SKU, the GTIN/UPC/EAN field, a custom field or the product ID
* Code 128, UPC-A, EAN-13, EAN-8, Code 39, ITF-14, QR code and Data Matrix
* Automatic barcode type: valid UPC and EAN numbers print as retail barcodes, everything else as Code 128
* Avery 5160, 5163, 5167, L7160 and L7163 sheets, common thermal roll sizes, or your own custom size
* Start part-way down a part-used sheet
* Product name, price and an extra line (SKU or product ID) on each label
* "Print barcode labels" bulk action on the Products list and the Orders list (one label per unit ordered)
* Works with variations and with High-Performance Order Storage

= Who it is for =

* Retail and pop-up shops that need UPC/EAN price labels on products
* Warehouses and small fulfilment teams labelling bins and incoming stock with SKU barcodes
* Shops with a Zebra, Rollo, DYMO or other thermal label printer, or a regular laser/inkjet printer with Avery sheets

= Optional SheetStamp account =

Connecting a SheetStamp account adds features that run on the SheetStamp service:

* Exact-size PDF label files that print the same from any device
* ZPL files for Zebra-compatible thermal printers
* Invoice and packing slip PDFs on each order

The free plan includes 100 units a month. Paid plans raise the limit. The same features are available as a JSON API for developers: see https://sheetstamp.com

== External services ==

This plugin can connect to the SheetStamp service to make PDF and ZPL files. Nothing is sent unless you use one of the features below.

* **Requesting an API key** (Settings, "Email me a key"): the email address you enter is sent so the service can email you a key.
* **Download PDF / Download ZPL**: for each label, the barcode value, product name, price text, extra line and quantity are sent, with the label size and your API key.
* **Invoice PDF / Packing slip PDF**: the order number and date, store name and address, the customer's billing and shipping address, line items, totals, payment and shipping method, the customer note and your API key are sent.
* **Plan and usage** (Settings tab, when a key is saved): your API key is sent to read your plan and usage.
* **Change plan**: you are redirected to Stripe to pay. See https://stripe.com/privacy

Service terms: https://api.sheetstamp.com/terms
Privacy policy: https://api.sheetstamp.com/privacy

== Installation ==

1. Install and activate the plugin. WooCommerce must be active.
2. Go to WooCommerce → Barcode labels.
3. Open Settings to choose where the barcode value comes from and your default label type.
4. Search for products, set quantities and press Print labels.

In the browser print dialog set Scale to 100%, Margins to None, and turn off headers and footers.

== Frequently Asked Questions ==

= Can I print Avery 5160 labels from WooCommerce? =

Yes. Avery 5160/8160 (30 per sheet), 5163/8163, 5167/8167, L7160 and L7163 are built in, and you can start part-way down a part-used sheet.

= Does it work with Zebra or other thermal label printers? =

Yes. Browser printing works with any thermal printer that has a driver (pick a roll size). With a free SheetStamp key you can also download ZPL files for Zebra-compatible printers at 203, 300 or 600 dpi.

= Can I print one label per item in an order? =

Yes. Select orders on the Orders list and choose "Print barcode labels". You get one label per unit ordered.

= Do I need an account? =

No. Browser printing is free and needs no account. An account is only needed for PDF and ZPL files, invoices and packing slips.

= The labels drift off the sheet =

Check that the print scale is 100% (not "Fit to page") and margins are None. If your printer still shifts the page, use a custom size in Settings and adjust the margins by a millimetre or two.

= My barcode will not print =

UPC-A needs 12 digits and EAN-13 needs 13, with a correct check digit. Leave the barcode type on Automatic and any other value prints as Code 128.

= Which characters are supported in PDFs? =

Latin, Greek and Cyrillic. Chinese, Japanese and Korean text is not supported in PDF and ZPL files yet. Browser printing uses your computer's fonts and supports any language.

== Source code ==

Barcodes are drawn by bwip-js (MIT licence). The bundled file assets/js/bwip-js-min.js is the minified build of https://github.com/metafloor/bwip-js version 4.11.4; the readable source is in that repository.

== Screenshots ==

1. Choose products and quantities, pick a label sheet and print from your browser.
2. Labels on an Avery 5160 sheet, with barcode, product name and price.
3. The "Print barcode labels" bulk action on the Products list. The Orders list has it too.
4. Settings: where the barcode value comes from, the barcode type and what goes on each label.
5. Invoice and packing slip PDFs on the order screen (needs a SheetStamp account).

== Changelog ==

= 1.0.4 =
* After checkout or the billing portal, a "Back to your store settings" button returns you to this plugin.
* Settings shows your plan status: renewal date, a pending cancellation's end date, or a failed payment.
* "Manage or cancel plan" is shown whenever you have a subscription, including unpaid ones.
* Limit errors now link straight to the plans.
* Settings always shows fresh plan and usage information.

= 1.0.3 =
* Tested with WordPress 7.1.
* Internal: renamed the custom field setting.

= 1.0.2 =
* Fixed: invoices and packing slips no longer show a lone state or country code when the shop address is not filled in.
* Fixed: error pages now return a 400 status so hosts do not replace them with a generic error page.

= 1.0.1 =
* Fixed: browser printing failed when "show barcode text" was on.
* Fixed: empty custom size fields were saved as zero.
* Fixed: template menu could overflow its box.

= 1.0.0 =
* First release.
