=== FeedCraft Product Feed ===
Contributors: ahme1016
Tags: woocommerce, google merchant center, product feed, shopping feed, xml feed
Requires at least: 6.2
Tested up to: 6.9
Requires PHP: 7.4
Stable tag: 2.0.2
License: GPLv3
License URI: https://www.gnu.org/licenses/gpl-3.0.html

Powerful Google Merchant Center feed generator for WooCommerce. Adds GTIN, MPN, and Brand fields with high-performance XML/JSON REST API feeds.

== Description ==

FeedCraft is a high-performance solution for generating standards-compliant product feeds (XML & JSON) via the WordPress REST API. Designed specifically for Google Merchant Center, marketplaces, and advanced analytics, it bridges the gap between your WooCommerce catalog and global shopping engines.

**Key Features:**

*   **⚡ Performance-First Architecture:** Built to handle large catalogs with a configurable memory-limit warning and real-time REST API delivery—no more broken static files.
*   **🛠 Advanced Product Mapping:** Adds dedicated fields for GTIN (EAN/UPC), MPN, Brand, Color, and Google Product Category.
*   **👗 Apparel Ready:** Full support for Age Group and Gender, configurable at both the product and individual variation level.
*   **🔄 Smart Variable Support:** Automatically links variations using `item_group_id` and inherits parent data where appropriate to save you time.
*   **🎨 Dynamic Attribute Mapping:** Map your existing WooCommerce attributes (like 'Color' or 'Size') to standard feed fields in seconds.
*   **🌍 Two Essential Formats:** 
    *   **XML:** Fully optimized for Google Merchant Center and major marketplaces.
    *   **JSON:** Perfect for custom integrations, mobile apps, and third-party tools.
*   **🔍 Intelligent Logic:** Automatic generation of full category paths (`product_type`) and an optional filter to exclude products missing images.

== Installation ==

1.  **Upload** the plugin folder to your `/wp-content/plugins/` directory, or install via the WordPress plugin installer.
2.  **Activate** the plugin through the **Plugins** menu in WordPress.
3.  **Ensure WooCommerce is active** and that your **Settings > Permalinks** are NOT set to "Plain" (REST API requires pretty permalinks).
4.  **Navigate to WooCommerce > Product Feeds** to configure default settings, map your attributes, and find your unique feed URLs.
5.  **Edit your products:** You will find the new fields (GTIN, MPN, Brand, etc.) under the **General** tab for simple products and within the **Variation** editor for variable products.
6.  **Access your feed:** Copy the URLs from the settings page to see your live data:
    *   XML Feed: `.../wp-json/feedcraft-product-feed/v1/xml`
    *   JSON Feed: `.../wp-json/feedcraft-product-feed/v1/json`
7.  **Connect to Google:** Submit the XML feed URL in your **Google Merchant Center** (under Feeds > Add Primary Feed) to start syncing your products.

== Frequently Asked Questions ==

= Where do I configure the plugin? =
The settings page is located under **WooCommerce > Product Feeds**. Here you can set global defaults, map color/size attributes, and copy your live feed URLs.

= Do I need to set Age Group and Gender for every product? =
No. FeedCraft uses the smart defaults you configure on the settings page. You only need to edit individual products if they differ from your store-wide settings.

= What if a product has no image? =
Google requires images for most products. By default, the plugin skips products without images to keep your Merchant Center healthy. You can disable this check in the settings if needed.

= How are variation colors and sizes handled? =
The plugin first checks the dedicated "Color" field. If empty, it automatically pulls from the attributes you've mapped (e.g., `pa_color` or `pa_size`).

= Is the feed updated automatically? =
Yes. Because it uses the REST API, the feed is always live. When you update a product in WooCommerce, the change is reflected in the feed immediately.

= Why is my feed URL showing a 404 error? =
This usually happens if your WordPress Permalinks are set to "Plain". Please go to **Settings > Permalinks** and select "Post name" or any other option besides Plain.

== Screenshots ==

1. The dedicated plugin settings page under WooCommerce.
2. Custom fields in the WooCommerce Simple product editor.
3. Age Group & Gender dropdowns in product variations.
4. Live XML output (Google Merchant Center compliant).

== Changelog ==

= 2.0.2 =
* Initial public release with REST API architecture and multi-attribute mapping.

== License ==

This plugin is licensed under the GPLv3.