=== 3DL Product Feed for Google Merchant Center ===
Contributors: halogen11
Tags: woocommerce, google merchant, product feed, gmc, ecommerce
Requires at least: 5.8
Tested up to: 6.9
Requires PHP: 7.4
Stable tag: 1.1.7
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Generate reliable XML product feeds for Google Merchant Center from WooCommerce. Free LITE; optional PRO upgrade.

== Description ==
This LITE plugin outputs a valid Google Merchant XML feed from WooCommerce products and variations.

**LITE includes**
* Pretty URL: `/3dl-gmc-feed.xml` (and legacy `?zd_gmc=1`)
* Correct base attributes (title, description, price, image, availability)
* Variant URLs built from selected attributes
* EU Unit Pricing tags (unit_pricing_measure/base_measure) when weight is present
* Coffee/Tea auto Google category helper
* GTIN/EAN detection from common meta keys (incl. Woodmart) + custom keys in settings
* Additional images from product gallery
* Capability-based admin (default `manage_woocommerce`)

**PRO (optional) adds**
* Multiple feed profiles (currency/UTM/conversion)
* Custom labels (custom_label_0–4), shipping, sale_price with effective_date
* Static feed builds via WP-Cron
* Diagnostics and export/import tools
* License screen and priority support

== Installation ==
1. Upload the folder `3dl-product-feed-for-google` to `/wp-content/plugins/`.
2. Activate the plugin via **Plugins → Installed Plugins**.
3. Open **3DL GMC** in the left menu → configure custom GTIN keys if needed.
4. Feed URL: `https://example.com/3dl-gmc-feed.xml`

== Frequently Asked Questions ==

= Why doesn't the plugin send google_product_category by default? =
Because it's optional and not required for a valid Google Merchant feed. Leaving it empty is safer for a broad audience: Google can infer a category automatically, and advanced users can still provide an explicit category via the `tdl_gmc_google_category` filter.

= How do I add a Google Product Category? =
By default, LITE does not send `<g:google_product_category>`. If you really need it, add this filter in a small mu-plugin or your theme:
```
add_filter('tdl_gmc_google_category', function($cat, $product){
    // Example: Tea & Infusions
    return 'Food, Beverages & Tobacco > Beverages > Tea & Infusions';
}, 10, 2);
```

= Where is my feed URL? =
Use `/3dl-gmc-feed.xml` (or legacy `?zd_gmc=1`).

= How do I include GTIN/EAN? =
Add your meta keys in **3DL GMC → Settings** or use standard keys from common plugins/themes (already detected).

= Is PRO required? =
No. LITE is fully usable. PRO only unlocks advanced features.

== Screenshots ==
1. Settings page with custom meta keys for GTIN/EAN.
2. Feed URL shown in the plugin (XML endpoint and the `?zd_gmc=1` debug switch).
3. Example of the generated XML feed with a single item.
4. Example filter `tdl_gmc_google_category` mapping to a Google Product Category (GPC) ID.

== Changelog ==
= 1.1.7 =
* Remove automatic google_product_category mapping; by default LITE does not send GPC.
* Docs: add FAQ showing how to provide GPC via the `tdl_gmc_google_category` filter.

= 1.1.5 =
* Rename slug and text domain to match WP.org rules.
* Escape all dynamic XML values (PHPCS).
* Avoid WooCommerce internal meta notices for `_global_unique_id`.
* Use `THREEDL_GMC_CAP` (default `manage_woocommerce`) for admin access.

== Upgrade Notice ==
= 1.1.5 =
Compliant text-domain, escaping fixes and safer GTIN detection.

* Omit <g:item_group_id> for simple products.
* Fallback description to product title when empty.