=== Listbright – Product Data Fixes for Google Merchant Center ===
Contributors: metaflare
Tags: google merchant center, product feed, google shopping, woocommerce, gtin
Requires at least: 6.4
Tested up to: 7.1
Requires PHP: 7.4
Requires Plugins: woocommerce
Stable tag: 1.0.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Fix Google Merchant Center errors and disapproved products in WooCommerce. AI fills in missing color, size, gender, age group and category.

== Description ==

Google Merchant Center rejects products that are missing required data. For clothing and shoes that means color, size, gender and age group. It also turns down colors like "Multicolor", shop wording like "Men's", and barcodes with a wrong check digit. Rejected products don't show in Google Shopping, and products with gaps show less often.

Listbright checks every product in your store against those rules and shows you exactly what is wrong. Then, if you want, it uses AI to suggest the missing values from each product's title, description and photo. Nothing is saved until you approve it.

= What it fixes =

* Missing color, size, gender and age group on apparel and shoes
* Colors Google refuses, like "Multicolor", "Various" or "N/A"
* Shop wording Google can't read, like "Men's" instead of "male"
* Missing or too broad Google product category, matched to Google's official list
* Missing brand, when the brand is named in your product text
* Handmade, custom and vintage items wrongly flagged for a missing GTIN

Listbright also flags invalid GTINs (wrong length, wrong check digit, store-only codes) and missing titles, descriptions and images. It never makes up a barcode: those you fix with the real number.

= How it works =

1. **Scan for free.** Listbright reads your published products and shows which ones Google will reject and why. Scanning changes nothing.
2. **Fix with AI.** Select products and Listbright suggests the missing values in the format Google expects.
3. **Approve.** Every suggested change has its own switch. Turn off anything you don't want, then apply.

= Works with your feed =

Listbright writes approved values to the same product fields that **Google for WooCommerce** reads, and adds the Google product category and "no GTIN" flag to that plugin's sync. It only fills empty fields or replaces a value Google already rejected; anything else you entered stays as it is.

Every fix is also stored in its own product field (`_listbright_color`, `_listbright_size`, `_listbright_gender`, `_listbright_ageGroup`, `_listbright_brand`, `_listbright_google_category`), so feed plugins such as CTX Feed or Product Feed PRO can map them.

= Pricing =

Scanning is always free. AI fixes use credits: one credit per product that gets at least one suggested fix, however many fields it fills in. If no fix is found, no credit is used. Every new store gets 25 free credits. More credits are sold in one-time packs from inside the plugin (no subscription, credits don't expire): 1,000 for $9, 5,000 for $29, 20,000 for $79.

Listbright is an independent product by Metaflare Interactive LLP. It is not affiliated with, endorsed by or sponsored by Google or WooCommerce. Google Merchant Center is a trademark of Google LLC; WooCommerce is a trademark of Automattic Inc.

== External services ==

Listbright needs an online service to check products and suggest fixes. This section explains what is sent, when, and where.

= Listbright API =

Run by Metaflare Interactive LLP, the developer of this plugin, at `https://us-central1-curbtone-app.cloudfunctions.net/feedfixApi`.

* **When you first open the Listbright screen:** your store's web address is sent to create an account for your store. The service returns a key that is saved in your WordPress options.
* **When you click Scan, Fix with AI, or Apply:** for each product being checked, the plugin sends its ID, title, description, price, link, image link, brand, GTIN, MPN, category and attributes such as color and size. Nothing is sent until you take one of these actions.
* **When you open the screen:** the plugin asks for your credit balance.
* **When you buy credits:** the plugin asks the service for a checkout link.

No orders, customers or other personal data from your store are sent. Product data is used only to return the check and the suggestions; it is not stored afterwards. To suggest fixes, the service passes product text and image links to an AI model (Google Gemini, run through Replicate).

Terms of Service: https://listbright.web.app/terms/
Privacy Policy: https://listbright.web.app/privacy/

= Dodo Payments =

When you buy a credit pack, your browser opens a checkout page at `checkout.dodopayments.com`. Dodo Payments is the reseller and merchant of record for these orders: it takes the payment, handles tax and sends the receipt. The plugin never sees your card details. Dodo Payments tells the Listbright service which pack was paid for so the credits can be added.

Dodo Payments Buyer Terms: https://dodopayments.com/legal/buyer-terms
Dodo Payments Privacy Policy: https://dodopayments.com/legal/privacy-policy

== Installation ==

1. Install and activate WooCommerce.
2. Install Listbright from Plugins → Add New, or upload the plugin folder to `/wp-content/plugins/`, then activate it.
3. Go to **WooCommerce → Listbright** and click **Scan products**.

Listbright checks products against the rules for your store's base country (WooCommerce → Settings → General).

== Frequently Asked Questions ==

= Does Listbright change my products without asking? =

No. Scanning only reads. AI suggestions are shown first, each with its own switch, and nothing is saved until you click Apply.

= Will it overwrite values I entered myself? =

No. It only fills empty fields, or replaces a value Google has already rejected, such as "Multicolor". Anything else you typed stays as it is.

= Do I need Google for WooCommerce? =

No, but it is the easiest way to get the fixes to Google. With another feed plugin, map the `_listbright_*` product fields in its settings.

= Am I charged if the AI can't fix a product? =

No. A credit is used only when a product gets at least one suggested fix. If the request fails, the credits are returned.

= Can the AI make up a barcode? =

No. GTINs have to come from the manufacturer or GS1. Listbright only checks them, and for handmade or custom items it can mark the product as having no GTIN, which is what Google asks for.

= Which countries' rules does it use? =

Your store's base country. In the United States, United Kingdom, Germany, France, Japan and Brazil, Google rejects apparel without color, size, gender and age group. Elsewhere those gaps reduce how often products show.

= Can I get a refund? =

Unused credits can be refunded within 14 days of purchase. See https://listbright.web.app/refunds/

== Screenshots ==

1. The scan shows how many products Google would reject, and why.
2. AI suggestions shown as before and after, each with its own switch.
3. Credit packs, bought securely through Dodo Payments.

== Changelog ==

= 1.0.0 =
* First release: free scan against Google Merchant Center rules, AI fixes with per-change approval, Google for WooCommerce integration, credit packs.

== Upgrade Notice ==

= 1.0.0 =
First release.
