=== Fortuna AI Customer Service ===
Contributors: hirefortuna
Tags: woocommerce, customer-support, automation, helpdesk, refunds
Requires at least: 5.8
Tested up to: 6.9
Requires PHP: 7.4
Stable tag: 1.0.1
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html
Requires Plugins: woocommerce

Connect WooCommerce to Fortuna to sync support data, recover onboarding, and run approval-aware support workflows.

== Description ==

Fortuna AI Customer Service connects your WooCommerce store to the hosted Fortuna service.

Use this plugin to:

* connect a WooCommerce store to your Fortuna account
* sync store, product, and order data into Fortuna
* keep order and product changes up to date
* support approval-aware actions such as refunds through Fortuna

This plugin is a connector for the hosted Fortuna customer service platform. A Fortuna account is required.

Fortuna is operated by Fortune Global Ltd, 24 Athol Street, Douglas, IM1 1JA, Isle of Man.

Service and legal links:

* Website: https://hirefortuna.com
* Terms of Service: https://hirefortuna.com/terms
* Privacy Policy: https://hirefortuna.com/privacy
* Contact: https://hirefortuna.com/contact

== Installation ==

= Install from Fortuna plugin ZIP =

1. In Fortuna Connections, choose WooCommerce and download the Fortuna plugin ZIP.
2. In WordPress admin for the live WooCommerce store, go to `Plugins -> Add New -> Upload Plugin`.
3. Upload the `fortuna-cs` zip package.
4. Activate the plugin.
5. Open `Fortuna AI Customer Service`.
6. If setup is not already loaded, copy the recovery setup link from Fortuna, paste it into `Recovery setup link`, and click `Use setup link`.
7. Click `Connect with Fortuna`.
8. Keep the original WordPress tab open while Fortuna finishes the first sync.
9. Use the activation key shown on your Fortuna onboarding page only if Fortuna support instructs you to use the manual fallback.

= WordPress.org directory hold =

Do not use the WordPress.org directory listing as the current merchant setup path until Fortuna confirms the listing callback is fixed and verified. The supported merchant path is the Fortuna plugin ZIP upload sequence above.

== Frequently Asked Questions ==

= Do I need a Fortuna account? =

Yes. The plugin connects a WooCommerce store to the hosted Fortuna service.

= Does the plugin work without WooCommerce? =

No. WooCommerce must be installed and active before you activate the plugin.

= How does store connection work? =

The normal path starts in Fortuna Connections. Download the plugin ZIP, upload and activate it in WordPress, open `Fortuna AI Customer Service`, then click `Connect with Fortuna`. If setup is not already loaded, copy the recovery setup link from Fortuna, paste it into `Recovery setup link`, and click `Use setup link`. Activation key entry remains available only as a support-assisted fallback.

= Can support help me point the plugin at a different Fortuna backend for verification? =

Yes. `Fortuna AI -> Settings` includes an optional `Backend API Base` field for support-assisted verification or controlled local testing. Leave it blank for the normal hosted Fortuna service. Use a fully qualified backend such as `http://127.0.0.1:8790/api/v1` only when you intentionally need a WordPress test store to connect against a non-production Fortuna environment.

= What does the plugin sync? =

The plugin syncs store metadata, products, categories, orders, policies, shipping methods, and payment gateway context used by Fortuna.

= Does the plugin connect to an external service? =

Yes. When you use the connect flow, load a Fortuna setup link, or run the connector after activation, the plugin exchanges setup and connector requests with the hosted Fortuna service at `app.hirefortuna.com` and `api.hirefortuna.com`. After you connect your store, the plugin sends the store data needed for support automation, including store metadata, products, categories, orders, policy content, shipping methods, and payment gateway context. The plugin settings also include an advanced backend override for support-assisted verification or controlled local testing. The service terms are at https://hirefortuna.com/terms and the privacy policy is at https://hirefortuna.com/privacy.

== Screenshots ==

1. The WordPress plugin page before a recovery link is loaded.
2. The WordPress plugin page after a setup link has been loaded and is ready to connect.
3. The connected plugin state after the first sync completes.
4. The Fortuna onboarding screen that guides the WooCommerce plugin-first setup sequence.

== Changelog ==

= 1.0.0 =

* Initial public connector release for WooCommerce stores using Fortuna.
