=== Apslo Board ===
Contributors: apslo
Tags: woocommerce, orders, tracking, board, production
Requires at least: 5.0
Tested up to: 6.9
Requires PHP: 8.0
Stable tag: 2.0.0
License: GPL2
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Integrate WooCommerce orders with the Apslo Board production management system.

== Description ==

Apslo Board is a WooCommerce plugin that automatically sends orders from your shop to the [Apslo Board](https://apslo.com/landing/board-ecommerce/) production management system.

**Features:**

* Automatically send orders to Apslo Board on payment or processing status, or add them manually
* Configurable order trigger (payment success, order processing, or manually)
* Order tracking URL stored and displayed on the orders list and single order pages
* Tracking link included in WooCommerce customer emails (processing, on-hold, completed, invoice)
* Send tracking link email to customers manually from the order page
* Manual "Send order to Board" action from the order actions dropdown
* Default lead time setting for delivery date calculation
* Compatible with WooCommerce HPOS (High-Performance Order Storage)

**Requirements:**

* WordPress 5.0 or higher
* WooCommerce 6.0 or higher
* PHP 8.0 or higher
* Apslo Board account and API key

== Installation ==

1. Upload the `ApsloBoard` folder to the `/wp-content/plugins/` directory.
2. Activate the plugin through the "Plugins" menu in WordPress.
3. Go to **Settings > Apslo Board** to configure your API key and preferences.
4. Obtain your API key from [Apslo Board Settings](https://board.apslo.com/settings/api-keys).

== Configuration ==

* **API Key** — Your Apslo Board API key. Required for sending orders.
* **Default Lead Time** — Number of days to add to the order date as the delivery date.
* **Pass Order to Board** — Choose when orders are sent: on payment success, on order processing, or manually via order actions.

== Frequently Asked Questions ==

= Where do I get my API key? =

Log in to your Apslo Board account at [board.apslo.com](https://board.apslo.com) and navigate to Settings > API Keys.

= Can I resend an order to Board? =

Yes. Open the order in WooCommerce and select "Send order to Board" from the order actions dropdown.

= How does the tracking URL work? =

When an order is sent to Board, the API returns a tracking URL that is automatically saved to the order. It appears in the orders list, on the single order page, and in customer emails.

== External Services ==

This plugin connects to the **Apslo Board** external service ([https://board.apslo.com](https://board.apslo.com)) to send order data and retrieve tracking information.

= What data is sent and when =

* **Test Connection** — When the store administrator clicks "Test Connection" on the plugin settings page, a GET request is sent to `https://board.apslo.com/api/test-connection` containing only the API key. No customer or order data is transmitted.
* **Order submission** — When an order is placed (or manually triggered by the administrator), the plugin sends a POST request to `https://board.apslo.com/api/orders` containing: order reference number, customer name, company, email, phone, billing and shipping addresses, order date, delivery date, and line items (product name, SKU, quantity, price, image URL, and board template name). The API key is included as a query parameter.
* **Tracking URL** — The Apslo Board API may return a tracking URL in the response, which is stored as order meta and displayed to the customer in emails and on the order page.

No data is sent to any other third-party service.


== Screenshots ==

1. Board integration setup
2. Assigning a Board template to a WooCommerce product
3. WooCommerce orders view with the Board tracking button
4. Order tracking link added to the WooCommerce order page



= Service links =

* Apslo Board website: [https://apslo.com/board](https://apslo.com/board)
* Terms of Service: [https://apslo.com/terms-of-service](https://apslo.com/terms-of-service)
* Privacy Policy: [https://apslo.com/privacy-policy](https://apslo.com/privacy-policy)

== Changelog ==

= 1.0.0 =
* Initial release.