=== WoZoBridge ===
Contributors: wozobridge
Tags: woocommerce, zoho, crm, books, integration
Requires at least: 6.0
Tested up to: 7.1
Requires PHP: 7.4
Stable tag: 1.0.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html
Donate link: https://wozobridge.com/

Connect WooCommerce with Zoho CRM and Zoho Books. Sync orders, view CRM contacts, browse Books documents, and monitor sync activity in wp-admin.

== Description ==

WoZoBridge connects a WooCommerce store to Zoho CRM and Zoho Books. After you connect your Zoho account, the plugin can sync WooCommerce orders to Zoho Books, show CRM contacts, list Books sales orders, and record API and sync activity in wp-admin.

This release does **not** include Zoho Inventory sync or AI-powered reports.

**Features**

* Connect Zoho CRM and Zoho Books with one OAuth flow
* Sync WooCommerce orders to Zoho Books
* View CRM contacts in wp-admin
* Browse Zoho Books sales orders
* Review failed syncs and API logs

**Requirements**

* WordPress 6.0+
* PHP 7.4+
* WooCommerce (must be installed and active)
* A Zoho CRM / Zoho Books account

== Installation ==

1. Upload the `wozobridge` folder to `/wp-content/plugins/`
2. Activate WooCommerce, then activate WoZoBridge on the Plugins screen
3. Open **WoZoBridge → Integrations**
4. Click **Authorize Zoho** and approve access in Zoho
5. After the connection succeeds, open **CRM**, **Books**, and **Sync** to use the plugin

**How to use it**

* **Integrations** — connect or disconnect Zoho, and confirm the token is valid
* **CRM** — browse contacts from the connected Zoho CRM account
* **Books** — browse sales orders from the connected Zoho Books organization
* **Sync** — review failed order syncs and recent API activity

WooCommerce orders are sent to Zoho Books when the store is connected and order status get updated as complete.

== Frequently Asked Questions ==

= Does WoZoBridge work without WooCommerce? =

No. WooCommerce must be installed and active.

= Does this release include Zoho Inventory or AI reports? =

No. This release connects WooCommerce with Zoho CRM and Zoho Books only.

= Where are Zoho credentials stored? =

Encrypted in WordPress options. Advanced sites may also set credentials via wp-config constants when supported by the helper API.

= Does the plugin call external services? =

Yes:

* **Zoho** (`accounts.zoho.*`, `zohoapis.*`, `books.zoho.com`) for OAuth token exchange/refresh and CRM/Books API calls
* **WoZoBridge** (`https://wozobridge.com/auth/zoho.php`) as the OAuth redirect bridge used during the initial Zoho connection

This release does **not** call a remote license-validation API, and it does not enforce a monthly sync cap.

No JavaScript or CSS is loaded from third-party CDNs; Bootstrap, Bootstrap Icons, DataTables, and SweetAlert2 are bundled locally.

= How do I change the OAuth bridge URL for local development? =

Use the filter `wozobridge_zoho_oauth_bridge_url` (default: `https://wozobridge.com/auth/zoho.php`).

== Screenshots ==

1. Dashboard overview with Zoho connection status, WooCommerce order metrics, and sync status.
2. Integrations page for the connected Zoho account, data-center region, and token status.
3. Zoho CRM contacts from the connected account.
4. Zoho Books page with monthly sync totals and the sales orders list.
5. Sync management with failed sync records and API logs.

== Changelog ==

= 1.0.0 =
* Initial release: Zoho CRM and Zoho Books connection, WooCommerce order sync, and admin sync logs.

== Upgrade Notice ==

= 1.0.0 =
Initial release. Requires WooCommerce and a Zoho CRM or Zoho Books account.

== External Services ==

This plugin connects to the following external services:

= Zoho =
Used for OAuth authentication (authorize, token, refresh) and Zoho CRM / Zoho Books API calls. Data sent can include order details, customer names, and email addresses needed to sync WooCommerce orders and display CRM/Books records in wp-admin.

* Service home: https://www.zoho.com
* Privacy policy: https://www.zoho.com/privacy.html
* Terms of service: https://www.zoho.com/terms.html

= WoZoBridge OAuth bridge =
Used only as a redirect/relay during the initial Zoho OAuth authorization flow (`https://wozobridge.com/auth/zoho.php`). The bridge receives the OAuth authorization response and returns the site admin to the Integrations page; it is not used for ongoing CRM/Books API traffic. No WooCommerce order or customer catalog is synced to this endpoint.

* Service home: https://wozobridge.com
* Privacy policy: https://wozobridge.com/privacy
* Bridge URL (filterable): `wozobridge_zoho_oauth_bridge_url`
