=== ProductSync Merchant for Importify ===
Contributors: y0b65
Tags: woocommerce, dropshipping, automation, b2b, merchant
Requires at least: 5.8
Tested up to: 7.1
Requires PHP: 7.4
WC requires at least: 5.0
WC tested up to: 8.0
Stable tag: 2.0.1
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Import unlimited products from B2B suppliers, compare catalog changes, track price and stock updates, and sync WooCommerce inventory.

== Description ==

**Don't let limits cap your business growth. Scale your WooCommerce store beyond boundaries.**

![Importify Merchant](https://content.importify.co.za/importifycustomfiles/images/bdd378a9a5de881de8428c661b/20260527_155954_merchant_banner-1640x924.png.png)

**ProductSync Merchant for Importify** bridges the gap between your WooCommerce store and supplier networks. Connect directly to supplier catalogs, browse marketplace listings, and import newly published products on demand—without handling cumbersome spreadsheets.

### Key Features at a Glance:
* **Unlimited Product Imports & Suppliers:** Scale without catalog boundaries across both WooCommerce and Shopify supplier sources.
* **Supplier Catalog Reference:** Easily compare imported WooCommerce products against refreshed supplier feeds to spot stock and price changes before syncing.
* **Automated Pricing Rules & Markups:** Apply global or category markup rules instantly upon import to safeguard profit margins.
* **Free Image CDN Offloading:** Speed up store performance by offloading product image delivery to a dedicated, high-speed CDN.
* **Built-in SEO Generation:** Create optimized product titles, descriptions, and metadata directly from raw supplier product payloads.
* **Auto-Draft Out-of-Stock Items:** Automatically set WooCommerce items to draft state when supplier inventory empties to preserve store reputation.
* **Bulk Editing & Duplicate Detection:** Manage backend clutter with bulk editing tools and automated duplicate product finders.
* **Optional Bring-Your-Own-Key AI:** Connect your own OpenAI, Claude, DeepSeek, Mistral, or Gemini keys for AI-assisted listing enhancements.

### The Pain Points We Solve:
* **Eliminate Spreadsheet Errors:** Stop manually formatting and uploading daily CSV stock sheets. Search, review, and import products straight from your admin dashboard.
* **Prevent Overselling & Stock Disputes:** Compare live supplier stock against active WooCommerce inventory to catch adjustments before orders are placed.
* **Remove Scaling Bottlenecks:** Process high-resolution images, format SEO titles, apply price margins, and publish products in seconds.

### How Catalog Distribution Works
Automated scheduled catalog updates are driven on the supplier side. Suppliers use the companion **[Importify B2B Supplier Sync](https://wordpress.org/plugins/importify-b2b-supplier-sync/)** plugin and Importify web services to publish selected categories, brands, and tags. 

* **20-Hour Refresh Cycle:** Supplier catalogs refresh automatically every 20 hours to detect new items, stock changes, and price adjustments.
* **Merchant Workflow:** The merchant plugin retrieves refreshed supplier feeds, allowing store owners to browse new releases in **Products**, review active items in **Imported Products**, and reconcile stock/pricing in **Supplier Catalog Reference**.

---

== Installation ==

### Minimum Requirements
* **PHP:** 7.4 or greater (8.0+ recommended)
* **Database:** MySQL 5.5.5 or MariaDB 10.1 or greater
* **WordPress:** 5.8 or higher
* **WooCommerce:** 5.0 or higher

### Step-by-Step Installation
1. Log into your WordPress admin dashboard and navigate to **Plugins > Add New**.
2. Search for `ProductSync Merchant for Importify`.
3. Click **Install Now** and then **Activate** the plugin.
4. Navigate to the **ProductSync Merchant** menu tab to link your Importify merchant account and start connecting suppliers.

---

== External Services ==

This plugin relies on external HTTP endpoints to import products, process images, validate account status, and optionally provide AI SEO enhancements.

**Important Note on AI:** Built-in SEO metadata is generated entirely on your server from local product data. The plugin includes an *optional, opt-in* AI enhancement feature. No data is sent to AI providers unless you explicitly enter and test your own API key. Keys are stored locally in your WordPress database.

=== Service 1: Importify Core API ===
* **Service Domain:** `https://importify.co.za/api/`
* **Provider:** Importify
* **Purpose:** Validates merchant tokens, fetches marketplace catalogs, manages supplier approvals, and processes import sync requests.
* **Data Sent:** Account API keys, supplier IDs, product identifiers, price/stock update payloads, and authorization headers.
* **Trigger Event:** Account authentication, browsing marketplace items, updating product mappings, and executing stock/price syncs.

=== Service 2: Importify Marketplace & Catalog Delivery ===
* **Service Domain:** `https://items.importify.co.za/`
* **Provider:** Importify
* **Purpose:** Fetches public supplier `products.json` feeds for search and catalog browsing.
* **Data Sent:** Supplier ID path parameters and catalog search query parameters.
* **Trigger Event:** Browsing or searching supplier catalogs in the merchant interface.

=== Service 3: Importify Image CDN / S3 ===
* **Service Domain:** `https://content.importify.co.za/`
* **Provider:** Importify / Amazon Web Services
* **Purpose:** Serves and proxies high-resolution product images to offload local server bandwidth.
* **Data Sent:** Image URLs and standard HTTPS request headers.
* **Trigger Event:** Downloading or attaching supplier product media to WooCommerce.

=== Service 4: Optional AI Providers (Bring-Your-Own-Key) ===
* **Supported Providers:** 
  * **OpenAI:** `https://api.openai.com/v1/`
  * **Anthropic (Claude):** `https://api.anthropic.com/v1/`
  * **DeepSeek:** `https://api.deepseek.com/v1/`
  * **Mistral AI:** `https://api.mistral.ai/v1/`
  * **Google Gemini:** `https://generativelanguage.googleapis.com/v1/`
* **Purpose:** Allows merchants to optionally use their own API credentials for AI-assisted SEO content generation.
* **Data Sent:** Merchant-provided API keys (for validation) and text generation prompts based on product details.
* **Trigger Event:** Only when a merchant explicitly saves an API key and triggers AI optimization.

=== Service 5: Google Fonts ===
* **Service Domain:** `https://fonts.gstatic.com/`
* **Provider:** Google LLC
* **Purpose:** Renders the Inter font family on plugin admin pages.
* **Data Sent:** Standard browser GET requests (IP address and browser user-agent).
* **Trigger Event:** Loading designated plugin admin screens.

=== Bundled Libraries & Resources ===
* **Tailwind CSS (v2.2.19):** Bundled locally within the plugin directory.
* **Font Awesome Free (v6.4.0):** Bundled locally within the plugin directory.

=== Privacy Statements & Terms ===
* [Importify Terms of Service](https://legal.importify.co.za/terms.html)
* [Importify Privacy Policy](https://legal.importify.co.za/privacy.html)
* [Google Privacy Policy](https://policies.google.com/privacy)

*Account Requirement:* A free or paid Importify Merchant account is required. You can register at [importify.co.za/register](https://importify.co.za/register).

---

== Screenshots ==

1. **Merchant Dashboard** - Overview of imported products, connection status, and quick-action metrics.
2. **Product Catalog Importer** - Search and import products directly from approved supplier feeds.
3. **Supplier Catalog Reference** - Review and compare supplier price and stock updates against active WooCommerce listings.
4. **Automation & Pricing Settings** - Set markup rules, automated draft triggers, and AI configuration options.

---

== FAQ ==

= Does this plugin require WooCommerce? =
Yes. ProductSync Merchant for Importify is explicitly built for WooCommerce stores.

= Are there limits on product imports? =
No. The plugin supports unlimited product imports, unlimited suppliers, and unlimited sync operations.

= Can I import products from Shopify suppliers? =
Yes. Importify supports cross-platform sync, allowing you to import products from suppliers operating on either Shopify or WooCommerce.

= Is my store data sent to third-party AI services? =
No. Default SEO titles and metadata are generated locally on your server. Third-party AI providers (like OpenAI or Claude) are only contacted if you explicitly opt-in by entering your own API key in the settings screen.

---

== Changelog ==

= 2.0.1 =
* Optimized merchant description and restructured feature highlights for improved directory clarity.
* Integrated dedicated Image CDN capabilities for faster media attachments.
* Clarified 20-hour supplier sync mechanics and Supplier Catalog Reference workflow.

= 1.0.0 =
* Initial public release.

---

== Upgrade Notice ==

= 2.0.1 =
This update includes performance enhancements, dedicated Image CDN support, and improved catalog comparison workflows. Upgrading is recommended for all merchants.