=== BinHQ for WooCommerce ===
Contributors: mindwerks
Tags: woocommerce, pick pack, fulfillment, warehouse management, bin locations, inventory, orders, barcode, shipping
Requires at least: 6.0
Tested up to: 6.5
Requires PHP: 7.4
Stable tag: 0.1.0
License: GPL-2.0-or-later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Warehouse pick-pack and bin management for WooCommerce merchants who ship in-house.

== Description ==

**BinHQ** gives WooCommerce merchants a proper pick-pack workflow without the complexity of a full warehouse management system.

If you ship orders yourself (not using a 3PL), BinHQ helps you:

* Organize products into physical bins with searchable locations
* Generate optimized pick lists that group orders by bin location
* Pack orders faster with barcode scanning
* Mark multiple orders fulfilled in one click
* See real-time inventory levels across bins
* Track who picked and packed each order

This plugin connects your WooCommerce store to [binhq.io](https://binhq.io) — a cloud-based dashboard where you manage bins, pick lists, and fulfillment. The plugin keeps WooCommerce in sync: new orders flow into BinHQ automatically, and completed fulfillments sync back to WooCommerce so customers get shipping notifications.

**Key features:**

* One-click install + OAuth-style connection (no API keys to copy/paste)
* Real-time order sync via WooCommerce action hooks
* Fallback sync if plugin push fails (uses WC REST API)
* Products + variations synced automatically
* Fulfillment write-back marks orders completed and triggers WC customer email hooks
* Inventory adjustments sync back from BinHQ
* Diagnostic panel shows connection status, request log, and version info

**Who this is for:**

* WooCommerce merchants doing $4k–$250k/month in sales who ship in-house
* Teams of 1–20 people picking and packing orders themselves
* Brands who need warehouse organization but don't want the complexity of Skubana / Cin7 / Netsuite

**Who this is NOT for:**

* Merchants already using a 3PL (ShipBob, Deliverr, ShipMonk, etc.) — your fulfillment is already outsourced
* Enterprise stores with 100k+ SKUs — BinHQ is tuned for SMB operations

== Installation ==

1. Upload the plugin files to `/wp-content/plugins/binhq-for-woocommerce/`, or install via the WordPress plugins screen
2. Activate the plugin through the Plugins screen
3. Click the new **BinHQ** menu item in your WP admin sidebar
4. Click **Connect to BinHQ** — a new tab opens to binhq.io
5. Sign up (or log in) and approve the connection
6. Return to WordPress — your store is now connected

Your existing products and recent orders will sync to BinHQ automatically.

== Frequently Asked Questions ==

= Do I need a BinHQ account before installing? =

No — the plugin will walk you through sign-up during the connection flow. Free tier available, paid plans available via Stripe billing once connected.

= What data does BinHQ access? =

Orders (for pick lists and fulfillment), products + variations (for displaying SKUs/images in picks), and inventory levels (for stock sync). The plugin uses WooCommerce's standard REST API as a fallback path and WC action hooks for realtime push.

= Is my WooCommerce data stored on BinHQ servers? =

Product metadata is cached for fast display. Order details are fetched on-demand and not stored permanently (beyond the pick batch history). See the [BinHQ privacy policy](https://binhq.io/privacy) for specifics.

= What happens if I deactivate the plugin? =

Deactivation preserves your connection. Reactivating restores it. If you fully delete the plugin (uninstall), all local settings are removed — you can disconnect server-side from your BinHQ dashboard.

= Does this work with Shopify stores too? =

BinHQ works with both Shopify and WooCommerce, but this plugin is for WooCommerce only. Shopify merchants should install BinHQ from the [Shopify App Store](https://apps.shopify.com/binhq).

= What WooCommerce versions are supported? =

WooCommerce 7.0 and newer. We test against the latest stable WooCommerce release regularly.

= Does this support HPOS (High-Performance Order Storage)? =

Yes. The plugin declares HPOS compatibility and uses the modern WC order APIs.

== Screenshots ==

1. Settings page showing the "Connect to BinHQ" button
2. Connected state with account info + diagnostics
3. BinHQ dashboard showing pick list with bin locations (on binhq.io)
4. Pick list optimization grouping orders by bin for faster picking
5. Fulfillment screen marking orders complete in bulk

== Changelog ==

= 0.1.0 =
* Initial release
* WordPress OAuth-style connection flow
* WC REST API key generation during install
* Order + product sync via action hooks
* Fulfillment write-back + inventory adjustment endpoints
* HPOS compatibility

== Upgrade Notice ==

= 0.1.0 =
First release. Welcome!
