=== A2DB Supplier Import for WooCommerce ===
Contributors: microcitylabs
Tags: import, products, csv, supplier, price list
Requires at least: 6.0
Tested up to: 7.0
Requires PHP: 7.4
Stable tag: 0.3.1
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Turn supplier price lists and catalogs — PDF, Excel, scans, photos — into WooCommerce products.

== Description ==

Suppliers send price lists as 100-page PDFs, spreadsheets with merged cells, sometimes photos
of printed pages. This plugin sends that file to the MicroCity engine, which reads it and
returns store-ready product data: names, SKUs, categories, prices, variants. You review the
result inside wp-admin, then the plugin creates the products in WooCommerce as drafts.

* Variable products with linked variations, built automatically from variant rows.
* Anything the engine cannot read properly is flagged, not guessed.
* Products are created locally through WooCommerce functions — your WooCommerce keys never
  leave your site.

== External services ==

This plugin connects to the A2DB service at microcitylabs.com, operated by MicroCity
Solutions Ltd (UK). When you upload a supplier file, the file and your A2DB API key are sent
to the service so the engine can read the file and return structured product data. No other
data from your site is sent. An account (free tier available) is required.

Service terms: https://microcitylabs.com/legal/terms/
Privacy policy: https://microcitylabs.com/legal/privacy/

== Installation ==

1. Install and activate the plugin (WooCommerce must be active).
2. Create a free account at microcitylabs.com and copy your API key from the account page.
3. In wp-admin go to WooCommerce → A2DB Supplier Import, paste the key, press "Test connection".
4. Upload a supplier file and review the result before creating products.

== Frequently Asked Questions ==

= Does it change my live products? =

No. New products are created as drafts for you to review. Nothing is published without you.

= What file types work? =

PDF, Excel (xlsx/xls), CSV, and images (scans or photos of printed pages).

= My upload never finishes =

Some hosting firewalls silently stall uploads whose file names contain unusual characters
(spaces, "@" and similar). Rename the file to plain letters and numbers — e.g.
supplier-list-august.xlsx — and try again.

== Screenshots ==

1. Settings and connection check — paste the API key from your microcitylabs.com account.
2. A supplier file read into rows, with the column mapping the engine guessed (correct it before creating).
3. The products created in WooCommerce as drafts, including variable products with variations.

== Changelog ==

= 0.3.1 =
* Declared WooCommerce as a required plugin (Requires Plugins header).
* Confirmed compatibility with WordPress 7.0.

= 0.3.0 =
* Column mapping panel: correct which column is the name, SKU, price, description, brand or quantity before creating products.
* Multi-page PDFs: read page by page ("Read page 2 of N"), rows merge into one list; a failed later page no longer loses the pages already read.



= 0.2.0 =
* Upload a supplier file from wp-admin, review the rows, create the products as WooCommerce drafts (simple + variable with variations). PDF/photo pages are read by the engine with a progress check.

= 0.1.0 =
* First version: settings, connection test, service disclosure.
