=== CatalogFrame Image Studio ===
Contributors: theaistudio
Donate link: https://www.paypal.com/ncp/payment/RBBNGNS348UXQ
Tags: woocommerce, product images, ai, media library, csv
Requires at least: 7.0
Tested up to: 7.0
Requires PHP: 7.4
Stable tag: 1.0.3
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Generate catalog-ready product images from WooCommerce-style CSV files through the WordPress AI Client.

== Description ==

CatalogFrame Image Studio helps merchants turn product CSV files into generated product imagery without leaving WordPress admin.

Current workflow:

* Open the CatalogFrame screen from Products when WooCommerce products are available.
* Open the custom GPT helper to generate a mockup CSV from a product export file.
* Import a CSV with SKU, product name, and GPT image prompt columns.
* After validation, optionally choose a brand logo from the Media Library or upload one from your device to use as a reference for every generated image.
* Save generated images to the WordPress Media Library.
* Optionally append generated images to matching WooCommerce product galleries by SKU.
* Use whichever image-capable AI provider the site owner configures through WordPress.

CatalogFrame requires WordPress 7.0 or newer. It uses the provider-neutral AI Client included in WordPress core and does not collect or store AI provider credentials.

== Installation ==

1. Upload the `catalogframe-image-studio` folder to `/wp-content/plugins/`.
2. Activate CatalogFrame Image Studio from Plugins.
3. Open Products > CatalogFrame Images when WooCommerce is active, or CatalogFrame from the admin menu when WooCommerce is not active.
4. Open Settings > Connectors and install, activate, and configure a provider plugin that supports image generation. The official Google and OpenAI provider plugins support images; the Anthropic provider is text-only at the time of this release.
5. Return to CatalogFrame Settings and refresh the connection status.
6. Import and validate a CSV.
7. Optionally choose or upload a brand logo, then start generation.

== Frequently Asked Questions ==

= Does this plugin require WooCommerce? =

No. The plugin can save generated images to the Media Library without WooCommerce. Product gallery auto-mapping is available only when products/SKU lookup are available.

= Does CatalogFrame replace product images? =

No. CatalogFrame never overwrites existing product images. If auto-mapping is enabled, generated images are appended to the product gallery.

= Where are AI provider credentials stored? =

WordPress manages provider credentials centrally through Settings > Connectors. CatalogFrame does not collect, store, or return provider API keys.

= What is the support URL used for? =

The support URL gives customers a place to find documentation, report bugs, and contact the developer from the marketplace listing or plugin UI.

== External services ==

CatalogFrame uses the AI Client included in WordPress core. The AI Client sends each image request to an AI provider that the site owner has separately installed and configured in Settings > Connectors. CatalogFrame does not choose a provider and does not have access to the provider credential.

When an authorized user starts an image-generation job, the plugin sends the row's prompt text and, when supplied, the product reference image and selected brand logo or their URLs to the configured AI provider. The plugin identifies the selected logo to the provider as the brand logo for the generated image. Prompt text may contain product names, descriptions, brand details, or other information entered in the CSV. The data is sent only when the user starts generation. It is used to generate an image, and the returned image is saved in the WordPress Media Library. The configured provider determines processing, retention, billing, model choice, moderation, and other service conditions.

The initial official WordPress provider plugins that can handle image generation connect to these services:

* OpenAI API: [services agreement](https://openai.com/policies/services-agreement/), [privacy policy](https://openai.com/policies/privacy-policy/).
* Google Gemini and Imagen APIs: [Gemini API additional terms](https://ai.google.dev/gemini-api/terms), [Google privacy policy](https://policies.google.com/privacy).

Other compatible provider plugins may also be installed by the site owner. If another provider is configured, that provider plugin's documentation, terms, and privacy policy apply. Review them before starting generation.

CatalogFrame also includes an optional link to a custom GPT hosted by OpenAI's ChatGPT service to help prepare CSV files. CatalogFrame does not automatically send data to ChatGPT. If the user follows that link and manually uploads a WooCommerce export or enters product information, that data is sent directly by the user to ChatGPT under OpenAI's [terms of use](https://openai.com/policies/terms-of-use/) and [privacy policy](https://openai.com/policies/privacy-policy/).

== Changelog ==

= 1.0.3 =
* Redesigned the brand logo step with clear source cards, improved icon alignment, responsive stacking, and a separate generation action footer.

= 1.0.2 =
* Added a post-validation brand logo step using the native WordPress Media Library and device uploader.
* Added the selected brand logo to image-generation requests with explicit instructions to preserve it faithfully.
* Expanded the external-services disclosure to cover brand logo data.

= 1.0.1 =
* Migrated image generation from the direct OpenAI API to the provider-neutral WordPress 7.0 AI Client.
* Moved provider credentials and setup to WordPress Settings > Connectors.
* Added image-capability detection and actionable provider setup guidance.
* Removed the legacy CatalogFrame API key and provider-specific generation controls.
* Documented data sent to configured AI providers and the optional ChatGPT CSV helper.

= 1.0.0 =
* Prepared the first stable release for WordPress.org submission.
* Updated admin script loading to use WordPress script APIs.
* Use WooCommerce's product lookup API for efficient SKU mapping.
* Removed discouraged compatibility calls and resolved plugin metadata warnings.

= 0.1.0 =
* Initial marketplace-oriented scaffold.
* Added admin app under Products where available.
* Added CSV import, the original provider credential settings, browser-run queue, Media Library save, and optional SKU gallery append.
