=== TikTok Shop Sync for WooCommerce by Volade ===
Contributors: volade
Tags: tiktok, tiktok shop, woocommerce, ecommerce, sync
Requires at least: 6.0
Tested up to: 6.7
Requires PHP: 7.4
Requires Plugins: woocommerce
Stable tag: 1.0.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Sync WooCommerce products and orders with TikTok Shop. Alternative to the discontinued official TikTok plugin.

== Description ==

**TikTok Shop Sync for WooCommerce by Volade** keeps your WooCommerce store connected to TikTok Shop after the official WordPress plugin was discontinued.

Sync your product catalog, inventory, and TikTok Shop orders into WooCommerce — with the same Volade freemium model as our other extensions.

**Key features:**

* Connect TikTok Seller Center (OAuth via REST callback)
* Push WooCommerce products and variations to TikTok Shop
* Health score and validation before sync (SKU, image, weight, dimensions)
* Import TikTok Shop orders into WooCommerce
* Inventory sync with retry queue
* SKU mapping for existing TikTok listings
* Status and tracking push back to TikTok
* Guided onboarding with wait-time explanations
* Diagnostics tab (OAuth conflicts, prerequisites)
* Connection wizard with App Key / App Secret setup
* Real OAuth only — no simulated demo mode
* Connection test suite (API token, WooCommerce, catalog)
* TikTok Open API v2: HMAC signing, shop_cipher, token refresh
* Real-time webhooks (orders, inventory, returns)
* Category mapping UI with TikTok category tree
* Product create or update when TikTok listing ID is mapped
* Order import with shipping, tax and totals from detail API

= No account (guest) =

* View the sync dashboard and health score
* Connection wizard walkthrough (credentials setup preview)

= Free Volade account =

* Connect TikTok Shop
* Full product catalog sync (create + update)
* Order import with shipping, tax and totals
* Inventory webhooks, category mapping and SKU mapping

= V+ Premium =

* Scheduled auto sync
* Multi-shop support
* Sync log export

= Requires WooCommerce =

This plugin extends **WooCommerce** — not a generic “WC” abbreviation in the product name. WooCommerce must be installed and active.

== Installation ==

1. Install and activate **WooCommerce**
2. Upload the `tiktok-shop-sync-for-woocommerce-by-volade` folder (with `volade-sdk/` included) to `/wp-content/plugins/`
3. Activate the plugin
4. Open **WooCommerce → TikTok Shop** (or **Volade → TikTok Shop** when the SDK menu is active)
5. Enter your TikTok Shop App Key and App Secret in the connection wizard
6. Complete OAuth and run the connection test
7. Start syncing products and orders

== Frequently Asked Questions ==

= Does this replace the official TikTok plugin? =

Yes — that is the goal. The official TikTok Shop WordPress integration was discontinued; Volade provides a WooCommerce-native alternative.

= Do I need a Volade account? =

No for browsing the dashboard and setup wizard. A free Volade account is required to connect TikTok Shop and run full sync. V+ Premium unlocks auto sync and multi-shop.

= Does sync run on my server? =

Product and order data are exchanged between your WooCommerce store and TikTok Shop APIs. Volade account features use the Volade API only when you sign in.

== External services ==

This plugin connects to:

* **TikTok Shop Open API** — product, inventory, and order sync when you connect a seller account
* **Volade API** (optional) — account, premium features, and ecosystem when you sign in at volade.com

== Privacy ==

Sync data stays between your WordPress site, WooCommerce, and TikTok Shop. Optional Volade account usage is governed by the Volade privacy policy at https://volade.com/privacy

== Screenshots ==

1. Dashboard with health score, stats and admin tabs
2. Store readiness ring and merchant benefits
3. Guided onboarding with wait-time hints
4. Product catalog with sync actions
5. Diagnostics and REST OAuth callback URL

== Changelog ==

= 1.0.0 =
* First public release — full WooCommerce ↔ TikTok Shop sync alternative
* Connection wizard: App Key, OAuth REST callback, connection test suite
* TikTok Open API v2: HMAC signing, shop_cipher, token refresh
* Webhooks: ORDER_STATUS_CHANGE, PRODUCT_STATUS_CHANGE, INVENTORY_UPDATE, REVERSE_ORDER
* Category mapping UI with TikTok category tree from API
* Product create or update when TikTok listing ID is mapped
* Order import with detail API (shipping, tax, totals)
* Health score, validation, variation SKU sync, SKU mapping
* Inventory hooks, retry queue, optional pull inventory from TikTok
* Diagnostics: OAuth + webhook URLs, WooCommerce pre-flight checks
* Six admin tabs, translated admin UI (6 languages), Volade SDK integration
