=== Idesoftbcn AI Product Customizer for WooCommerce ===
Contributors: idesoftbcn
Tags: woocommerce, product customizer, personalization, ai, design
Requires at least: 6.5
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
Requires Plugins: woocommerce

Allow customers to personalize WooCommerce products with text, images, stickers, graphics, paint, and optional AI-generated designs.

== Description ==

Idesoftbcn AI Product Customizer for WooCommerce adds a visual product designer to your store. Customers can customize products in real time with text, uploaded images, stickers, graphic elements, freehand paint, and multiple product views (front, back, and more).

**Core features (free)**

* Visual editor embedded in product pages or via shortcode `[iapc_designer]`
* Text, image, sticker, graphic, and paint tools
* Independent designs per product view
* Customization surcharges per product
* Cart, checkout, and order integration
* Admin guide and product-level configuration

**AI Premium (optional, requires license from aiproductcustomizer.com)**

* AI image generation from customer prompts
* Guided AI wizard
* Per-product AI rules and limitations
* 14-day free trial available at [aiproductcustomizer.com](https://aiproductcustomizer.com/)

= External services =

This plugin connects to **aiproductcustomizer.com** when you activate an AI Premium license or when a customer generates an AI image.

**License activation** (`POST https://aiproductcustomizer.com/api/v1/license/activate`)

Data sent: license key, site domain, installation UUID, plugin version, WordPress version, PHP version, site URL, home URL, and locale.

**AI image generation** (`POST https://aiproductcustomizer.com/api/v1/ai/image`)

Data sent: license key, site domain, installation UUID, plugin version, WordPress version, PHP version, site URL, home URL, locale, customer prompt text, and optional per-product AI rules configured by the store admin.

Generated images are returned to your site and displayed in the product designer. Prompts are processed by the Idesoftbcn AI Product Customizer service to generate images. **Prompts are not used to train public AI models.**

= Legal documents (AI Premium) =

The optional AI Premium service is governed by the legal documents published on aiproductcustomizer.com:

* [Terms of Service](https://aiproductcustomizer.com/legal/terms-of-service)
* [Privacy Policy](https://aiproductcustomizer.com/legal/privacy-policy)
* [AI Content Policy](https://aiproductcustomizer.com/legal/ai-content-policy)
* [License Agreement](https://aiproductcustomizer.com/legal/license-agreement)
* [Acceptable Use Policy](https://aiproductcustomizer.com/legal/acceptable-use-policy)

Additional legal pages (cookie policy, refund policy, legal notice) apply to the aiproductcustomizer.com website and billing, not to the free plugin code running on your store.

**Bundled libraries (optional, car products with 3D preview only)**

When a product uses a 3D GLB preview, the plugin loads a bundled copy of Three.js r185 (MIT license) with GLTFLoader from `public/js/vendor/three/three.bundle.min.js`. No external CDN requests are made for the 3D viewer.

= Privacy =

* Customer-uploaded images and generated designs are stored in your WordPress uploads directory (`wp-content/uploads/iapc-designs/`).
* AI prompts are sent to aiproductcustomizer.com only when AI Premium is active and a customer or admin triggers image generation.
* The plugin stores a unique installation UUID in your database to validate licenses.
* No automatic telemetry or analytics are collected.
* See the plugin admin guide (WooCommerce → Idesoftbcn AI Product Customizer) for full details.

= Plugin structure =

For developers and contributors, the plugin is organized as follows:

* `includes/` — bootstrap, hooks, core logic, and template loader
* `admin/` — WordPress admin assets (`css/`, `js/`, `views/`)
* `public/` — storefront assets (`css/`, `js/`, `templates/`)
* `assets/` — shared images, stickers, and graphics

== Installation ==

1. Upload the plugin folder to `/wp-content/plugins/idesoftbcn-ai-product-customizer/` or install via the WordPress Plugins screen.
2. Activate the plugin through the **Plugins** menu.
3. Ensure **WooCommerce** is installed and active.
4. Open a WooCommerce product, enable **Customizer**, configure images and print areas.
5. Display the designer using **Product page** integration or the `[iapc_designer]` shortcode.
6. (Optional) Activate **AI Premium** with a license key from [aiproductcustomizer.com](https://aiproductcustomizer.com/).

== Frequently Asked Questions ==

= Does this plugin work without WooCommerce? =

No. WooCommerce is required. If WooCommerce is missing, the plugin shows an admin notice and does not load storefront features.

= How do I show the customizer on a page? =

Use the shortcode `[iapc_designer]` on a product page, or `[iapc_designer product_id="123"]` on any page.

= Where are customer designs stored? =

Final PNG previews and uploads are stored in `wp-content/uploads/iapc-designs/`. Order data is saved with WooCommerce orders.

= What happens when I uninstall the plugin? =

Plugin options and product customizer settings (`_iapc_*` post meta) are removed. WooCommerce order history is preserved. Uploaded design files in `iapc-designs/` are kept unless you delete them manually.

= Is AI image generation included for free? =

The designer works without AI. AI image generation requires an active AI Premium license from aiproductcustomizer.com.

= Is the plugin translated? =

The WordPress.org plugin page (`readme.txt`) is in English, as required by the plugin directory.

The plugin interface is translation-ready (i18n) with text domain `idesoftbcn-ai-product-customizer`. Locale files are **not** bundled in the plugin ZIP; after publication, community translations are managed and delivered via [translate.wordpress.org](https://translate.wordpress.org/).

== Screenshots ==

1. Product customizer on the storefront
2. Admin product configuration panel
3. AI image generation panel
4. Guided AI wizard
5. Cart with customization details
6. Order admin with production files

== Upgrade Notice ==

= 1.0.0 =
Initial release. Visual product customization for WooCommerce with optional AI Premium.

== Changelog ==

= 1.0.0 =
* Initial release
