=== VividCart – AI Product Images for WooCommerce ===
Contributors: techartdev
Tags: woocommerce, ai, product images, image generation, product photography
Requires at least: 6.4
Tested up to: 7.0
Requires PHP: 7.4
Stable tag: 1.0.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Generate and edit WooCommerce product images with AI using your own OpenAI or Google Gemini API key. No credits, no markup, no watermarks.

== Description ==

**VividCart turns your WooCommerce product editor into an AI photo studio.** Generate brand-new product images or restage your existing photos into beautiful scenes — directly from the product edit screen, using **your own AI provider API key**.

Unlike credit-based services, VividCart never resells AI usage. You connect your own OpenAI or Google Gemini key and pay your provider directly — typically just a few cents per image, at wholesale token prices. We provide the workflow; you keep the savings.

= Free features =

* **Generate product images** from the product editor — product name and category are woven into the prompt automatically
* **Edit existing photos**: replace backgrounds and restage your real product shots with AI reference-image editing
* **14 scene presets**: Studio White, Marble Counter, Rustic Wood, Bright Kitchen, Outdoor, Flat-lay, Gradient, Botanical, Urban Loft, Beach, Holiday, Luxury Dark, Soft Pastel, Custom
* **One-click apply** as the product image or gallery image — every result is saved to the Media Library, your originals are never touched
* **Brand style notes** appended to every prompt for a consistent catalog look
* **Automatic SEO alt text** on generated images
* **History** of your latest generations with one-click re-apply
* Works with **OpenAI (gpt-image)** and **Google Gemini** image models, with live model discovery
* Your keys are stored **encrypted** in your own database; your prompts and images travel only between your server and your chosen AI provider

= VividCart Pro =

Need catalog-scale workflows? [VividCart Pro](https://vividcart.techart.bg) adds: Bulk Studio with review-before-apply, Fidelity Mode (pixel-exact product preservation — AI builds the scene, your product pixels stay untouched), Brand Kit templates, 4 variants per run, upscaling, bulk alt text, auto-pilot for new products, badge composer and more providers (Stability AI, Flux, fal.ai).

= Why store owners pick VividCart =

* **No subscriptions for tokens** — your own key means provider wholesale pricing and no middleman markup
* **No watermarks, no expiring credits, no trial traps** — the free plugin is free, forever
* **Product-first design** — built for WooCommerce product photography, not a generic image toy

== External services ==

This plugin connects to the AI provider **you choose and configure**. No data is sent anywhere until you enter an API key and start a generation.

**OpenAI (api.openai.com)** — used to generate or edit images when you select OpenAI as provider. Sent: your prompt, product name/category (for context), the source image you chose to edit, and your own API key for authentication. Sent only when you click Generate or Test. [Terms of use](https://openai.com/policies/terms-of-use) · [Privacy policy](https://openai.com/policies/privacy-policy)

**Google Gemini API (generativelanguage.googleapis.com)** — used to generate or edit images and to list available models when you select Google Gemini as provider. Sent: your prompt, product name/category, the source image you chose to edit, and your own API key for authentication. Sent only when you click Generate or Test (model listing runs after you save a key). [Terms of service](https://ai.google.dev/gemini-api/terms) · [Privacy policy](https://policies.google.com/privacy)

The plugin sends **no** data to Tech Art EOOD and contains no tracking or telemetry.

== Installation ==

1. Install and activate the plugin (WooCommerce must be active).
2. Go to **VividCart AI** in your admin menu.
3. Paste your Google Gemini API key (free to obtain at aistudio.google.com/apikey) and/or your OpenAI key, then press **Test**.
4. Open any product — the **VividCart AI Studio** box is below the editor. Pick a scene, click Generate, apply. Done.

== Frequently Asked Questions ==

= Do I need to pay for AI usage? =

You pay your AI provider directly through your own account — typically $0.01–$0.07 per image depending on model and quality. Note: Google's image models require a billing-enabled account (the free tier does not include image generation). VividCart adds no markup.

= Is my API key safe? =

Keys are stored encrypted (libsodium, keyed off your site's salts) in your own database and are only ever sent to the provider you configured, over HTTPS.

= Will it overwrite my product photos? =

Never. Every generation is a new Media Library attachment. Applying an image just changes which attachment the product points to; originals stay in your library.

= Which models are supported? =

OpenAI gpt-image-2, gpt-image-1.5 and gpt-image-1-mini; Google Gemini image models are discovered live from your account, so new models appear automatically.

= Does it work with my theme / page builder? =

Yes. VividCart works at the WooCommerce data level (product image and gallery), so whatever renders your store renders VividCart's images.

== Screenshots ==

1. AI Studio in the product editor — scene presets, prompt and one-click apply
2. Edit an existing product photo into a new scene
3. Settings — connect your own provider keys
4. Generation history with re-apply

== Changelog ==

= 1.0.0 =
* Initial release: generate + edit modes, 14 scene presets, OpenAI & Gemini providers, encrypted key storage, history, alt text, apply-to-product workflow.
