Changeset 3732072

Timestamp:

10/07/2026 08:06:32 AM (2 weeks ago)

Author:

hxsmyxh

Message:

Release 1.1.0: Google Shopping Custom Labels 0-4, variant item_group_id grouping, smart size/material/pattern heuristics, and live diagnostic product inspector

Location:

world-inspire-product-feed-for-google-shopping

Files:

• tags/1.1.0 (copied) (copied from world-inspire-product-feed-for-google-shopping/trunk )
• tags/1.1.0/readme.txt (modified) (4 diffs)
• tags/1.1.0/world-inspire-product-feed-for-google-shopping.php (modified) (31 diffs)
• trunk/readme.txt (modified) (4 diffs)
• trunk/world-inspire-product-feed-for-google-shopping.php (modified) (31 diffs)

world-inspire-product-feed-for-google-shopping/tags/1.1.0/readme.txt

@@ -5 +5 @@
 Tested up to: 7.1
 Requires PHP: 7.4
-Stable tag: 1.0.0
+Stable tag: 1.1.0
 License: GPLv2 or later
 License URI: https://www.gnu.org/licenses/gpl-2.0.html
@@ -21 +21 @@
 * **Multi-Engine eCommerce Compatibility**: Native auto-detection and data extraction for both **SureCart** (`sc_product`) and **WooCommerce** (`product`). Zero fatal errors if either or neither is active.
 * **Google Merchant Center Specification**: Built according to official Google RSS 2.0 standards with all essential namespace attributes: `<g:id>`, `<g:title>`, `<g:description>`, `<g:link>`, `<g:image_link>`, `<g:availability>`, `<g:price>`, `<g:brand>`, `<g:condition>`, `<g:identifier_exists>`, `<g:google_product_category>`, `<g:color>`, `<g:age_group>`, and `<g:gender>`.
+* **Custom Labels 0–4 for Google Ads / PMax**: Full support for `<g:custom_label_0>` through `<g:custom_label_4>` with rules for price tiers (< $25, $25-$50, $50-$100, $100+), inventory status, category mapping, clearance/promotion tag keywords, and custom post meta fields.
+* **Variant Grouping (`<g:item_group_id>`)**: Automatically expands WooCommerce variable products (`product_variation`) into individual variant items linked by parent `<g:item_group_id>`, enabling swatch selection in Google Shopping results.
+* **Variant Attribute Optimization**: Smart extraction for `<g:size>`, `<g:material>` (Gold, Silver, Leather, Cotton, Gemstones, etc.), and `<g:pattern>` (Solid, Striped, Floral, Beaded) directly from attributes or intelligent NLP heuristics.
 * **Multi-Country Shipping Generator**: Automatically embeds multi-destination `<g:shipping>` nodes (defaulting to 8 core global markets: US, CA, UK, JP, SG, HK, AE, MX with custom shipping service names and rates).
-* **Intelligent Color & Demographic Extraction**: Automatically maps jewelry, apparel, gemstone, and accessory titles/descriptions into recognized Google taxonomy colors (over 35 shades) and adult/unisex demographics.
+* **Live Diagnostics & Product Inspector Simulator**: Test and audit any product ID directly in WordPress Admin to verify extracted attributes, custom labels matching reasons, and preview raw `<item>` XML snippets.
 * **Automatic Pet Category Mapping**: Heuristically detects pet collars, harnesses, and animal accessories and maps them to `Animals & Pet Supplies > Pet Supplies > Pet Collars & Harnesses`.
 * **Trustmate Review Catalog Sync**: Dedicated `<products>` XML feed format ready for instant connection in your Trustmate merchant dashboard.
@@ -39 +42 @@
 
 = Does this plugin work with SureCart? =
-Yes! It has full native support for SureCart products, pricing, inventory statuses (`sc_inventory_status`), featured images, and product galleries.
+Yes! It has full native support for SureCart products, pricing, inventory statuses (`sc_inventory_status`), featured images, collections, tags, and product galleries.
 
 = Does this plugin work with WooCommerce? =
-Yes! It automatically detects WooCommerce installations and outputs compliant feeds from published WooCommerce products.
+Yes! It automatically detects WooCommerce installations and outputs compliant feeds from published WooCommerce products and product variations with `<g:item_group_id>`.
+
+= How do Custom Labels (0-4) work? =
+Navigate to **Settings > Product Feeds > Google Shopping Rules & Custom Labels**. You can configure rules for each slot: Price Range Tiers, Inventory Status, Product Category, Tag/Keyword Matching (e.g. `clearance:Clearance, sale:On Sale, bestseller:Best Seller`), or Custom Post Meta fields.
 
 = Why does this plugin use extension-free REST URLs? =
@@ -53 +59 @@
 
 1. Feed URLs & Health Dashboard: Dynamic REST API endpoints and real-time catalog status.
-2. Google Shopping Rules: Global fallback brand defaults, product taxonomies, and NLP color detection.
+2. Google Shopping Rules & Custom Labels: Global fallback brand defaults, product taxonomies, NLP color/size/material detection, and custom labels 0-4.
 3. Multi-Country Shipping: International destination targeting and custom shipping rates.
-4. Live Diagnostics: Catalog extraction verification and Google Merchant Center spec compliance audit.
+4. Live Diagnostics & Product Inspector: Catalog extraction audit, custom label rule matching traces, and raw XML simulator.
 
 == Changelog ==
+
+= 1.1.0 =
+* Added Google Shopping Custom Labels (custom_label_0 to custom_label_4) with configurable rules: Price Tiers, Inventory Status, Category Mapping, Promotional Tag Keywords, and Custom Post Meta.
+* Added WooCommerce variable product expansion with `<g:item_group_id>` linking parent and variant products.
+* Added smart attribute extraction for `<g:size>`, `<g:material>`, and `<g:pattern>` with jewelry/apparel heuristic engines.
+* Added Live Product Inspector & XML Simulator to Diagnostics tab with rule matching explanation traces.
+* Enforced Google Shopping 100-character maximum length limit and XML entity escaping on all custom labels.
+* Added 87 zero-dependency unit and mock E2E integration tests passing 100% green.
 
 = 1.0.0 =

world-inspire-product-feed-for-google-shopping/tags/1.1.0/world-inspire-product-feed-for-google-shopping.php

@@ -3 +3 @@
  * Plugin Name: World Inspire Product Feed for Google Shopping
  * Plugin URI: https://wordpress.org/plugins/world-inspire-product-feed-for-google-shopping/
- * Description: High-performance real-time product feed generator for Google Shopping (Merchant Center) and Trustmate reviews sync from WooCommerce and SureCart. Features multi-country shipping, smart color and category detection, and anti-cache streaming architecture.
- * Version: 1.0.0
+ * Description: High-performance real-time product feed generator for Google Shopping (Merchant Center) and Trustmate reviews sync from WooCommerce and SureCart. Features multi-country shipping, smart color/size/material detection, custom labels (0-4), variant item_group_id grouping, and anti-cache streaming architecture.
+ * Version: 1.1.0
  * Author: World Inspire LLC, Vec
  * Author URI: https://worldinspirelab.com
@@ -18 +18 @@
 }
 
-define( 'WIPF_VERSION', '1.0.0' );
+define( 'WIPF_VERSION', '1.1.0' );
 define( 'WIPF_FILE', __FILE__ );
 define( 'WIPF_PATH', plugin_dir_path( __FILE__ ) );
@@ -31 +31 @@
 function wipf_get_default_settings() {
         return array(
-                'brand_name'             => get_bloginfo( 'name' ),
-                'default_category'       => 'Apparel & Accessories > Jewelry',
-                'default_age_group'      => 'adult',
-                'default_gender'         => 'unisex',
-                'default_condition'      => 'new',
-                'identifier_exists'      => 'no',
-                'auto_detect_color'      => 'yes',
-                'shipping_countries'     => 'US,CA,GB,JP,SG,HK,AE,MX',
-                'shipping_service_name'  => 'Standard Free Shipping',
-                'shipping_cost'          => '0.00',
-                'shipping_currency'      => 'USD',
-                'enable_google_feed'     => 'yes',
-                'enable_trustmate_feed'  => 'yes',
-                'items_per_feed'         => 500,
+                'brand_name'              => get_bloginfo( 'name' ),
+                'default_category'        => 'Apparel & Accessories > Jewelry',
+                'default_age_group'       => 'adult',
+                'default_gender'          => 'unisex',
+                'default_condition'       => 'new',
+                'identifier_exists'       => 'no',
+                'auto_detect_color'       => 'yes',
+                'auto_detect_material'    => 'yes',
+                'auto_detect_size'        => 'yes',
+                'auto_detect_pattern'     => 'yes',
+                'shipping_countries'      => 'US,CA,GB,JP,SG,HK,AE,MX',
+                'shipping_service_name'   => 'Standard Free Shipping',
+                'shipping_cost'           => '0.00',
+                'shipping_currency'       => 'USD',
+                'enable_google_feed'      => 'yes',
+                'enable_trustmate_feed'   => 'yes',
+                'items_per_feed'          => 500,
+                'enable_custom_labels'    => 'yes',
+                'custom_label_0_type'     => 'price_tier',
+                'custom_label_0_value'    => '25,50,100',
+                'custom_label_0_fallback' => 'Standard',
+                'custom_label_1_type'     => 'inventory',
+                'custom_label_1_value'    => '',
+                'custom_label_1_fallback' => 'Out of Stock',
+                'custom_label_2_type'     => 'category',
+                'custom_label_2_value'    => '',
+                'custom_label_2_fallback' => 'Jewelry',
+                'custom_label_3_type'     => 'tag_keywords',
+                'custom_label_3_value'    => 'clearance:Clearance, sale:On Sale, bestseller:Best Seller, new:New Arrival',
+                'custom_label_3_fallback' => 'Regular',
+                'custom_label_4_type'     => 'static',
+                'custom_label_4_value'    => 'World Inspire Catalog',
+                'custom_label_4_fallback' => '',
         );
 }
@@ -78 +97 @@
         // Priority compound phrases checked first
         $compounds = array(
-                'rose gold'  => 'Rose Gold',
-                'tiger eye'  => 'Brown',
+                'rose gold'    => 'Rose Gold',
+                'tiger eye'    => 'Brown',
                 'lapis lazuli' => 'Blue',
         );
@@ -154 +173 @@
 
 /**
+ * Intelligent material extraction heuristic.
+ *
+ * @param string $title Product title.
+ * @param string $desc  Product description.
+ * @return string Extracted material name or empty.
+ */
+function wipf_detect_material( $title, $desc = '' ) {
+        $text = strtolower( $title . ' ' . $desc );
+
+        // Priority compound phrases checked first
+        $compounds = array(
+                'sterling silver' => 'Sterling Silver',
+                '925 silver'      => 'Sterling Silver',
+                'rose gold'       => 'Rose Gold',
+                'white gold'      => 'White Gold',
+                'yellow gold'     => 'Yellow Gold',
+                '14k gold'        => '14K Gold',
+                '18k gold'        => '18K Gold',
+                '24k gold'        => '24K Gold',
+                'stainless steel' => 'Stainless Steel',
+                'genuine leather' => 'Leather',
+                'faux leather'    => 'Faux Leather',
+                'vegan leather'   => 'Faux Leather',
+                'rose quartz'     => 'Rose Quartz',
+                'lapis lazuli'    => 'Lapis Lazuli',
+                'cubic zirconia'  => 'Cubic Zirconia',
+        );
+
+        $detected = array();
+        foreach ( $compounds as $phrase => $mat_name ) {
+                if ( false !== strpos( $text, $phrase ) ) {
+                        if ( ! in_array( $mat_name, $detected, true ) ) {
+                                $detected[] = $mat_name;
+                        }
+                        $text = str_replace( $phrase, '', $text );
+                }
+        }
+
+        $single_map = array(
+                'gold'       => 'Gold',
+                'silver'     => 'Silver',
+                'platinum'   => 'Platinum',
+                'titanium'   => 'Titanium',
+                'brass'      => 'Brass',
+                'copper'     => 'Copper',
+                'bronze'     => 'Bronze',
+                'steel'      => 'Steel',
+                'diamond'    => 'Diamond',
+                'pearl'      => 'Pearl',
+                'amethyst'   => 'Amethyst',
+                'quartz'     => 'Quartz',
+                'emerald'    => 'Emerald',
+                'ruby'       => 'Ruby',
+                'sapphire'   => 'Sapphire',
+                'jade'       => 'Jade',
+                'turquoise'  => 'Turquoise',
+                'obsidian'   => 'Obsidian',
+                'onyx'       => 'Onyx',
+                'opal'       => 'Opal',
+                'moonstone'  => 'Moonstone',
+                'topaz'      => 'Topaz',
+                'garnet'     => 'Garnet',
+                'tourmaline' => 'Tourmaline',
+                'amber'      => 'Amber',
+                'carnelian'  => 'Carnelian',
+                'citrine'    => 'Citrine',
+                'crystal'    => 'Crystal',
+                'leather'    => 'Leather',
+                'silk'       => 'Silk',
+                'velvet'     => 'Velvet',
+                'cotton'     => 'Cotton',
+                'linen'      => 'Linen',
+                'wool'       => 'Wool',
+                'cashmere'   => 'Cashmere',
+                'satin'      => 'Satin',
+                'polyester'  => 'Polyester',
+                'canvas'     => 'Canvas',
+                'denim'      => 'Denim',
+                'ceramic'    => 'Ceramic',
+                'glass'      => 'Glass',
+                'wood'       => 'Wood',
+                'silicone'   => 'Silicone',
+                'resin'      => 'Resin',
+        );
+
+        foreach ( $single_map as $needle => $mat_name ) {
+                if ( preg_match( '/\b' . preg_quote( $needle, '/' ) . '\b/', $text ) ) {
+                        if ( ! in_array( $mat_name, $detected, true ) ) {
+                                $detected[] = $mat_name;
+                        }
+                }
+        }
+
+        if ( count( $detected ) > 2 ) {
+                return 'Mixed';
+        } elseif ( ! empty( $detected ) ) {
+                return implode( '/', $detected );
+        }
+
+        return '';
+}
+
+/**
+ * Intelligent pattern extraction heuristic.
+ *
+ * @param string $title Product title.
+ * @param string $desc  Product description.
+ * @return string Extracted pattern or empty.
+ */
+function wipf_detect_pattern( $title, $desc = '' ) {
+        $text = strtolower( $title . ' ' . $desc );
+
+        $patterns = array(
+                'polka dot'    => 'Polka Dot',
+                'polka dots'   => 'Polka Dot',
+                'animal print' => 'Animal Print',
+                'striped'      => 'Striped',
+                'stripes'      => 'Striped',
+                'stripe'       => 'Striped',
+                'floral'       => 'Floral',
+                'flower'       => 'Floral',
+                'geometric'    => 'Geometric',
+                'beaded'       => 'Beaded',
+                'braided'      => 'Braided',
+                'plaid'        => 'Plaid',
+                'checkered'    => 'Checkered',
+                'leopard'      => 'Animal Print',
+                'cheetah'      => 'Animal Print',
+                'zebra'        => 'Animal Print',
+                'camouflage'   => 'Camouflage',
+                'camo'         => 'Camouflage',
+                'marble'       => 'Marble',
+                'gradient'     => 'Gradient',
+                'solid'        => 'Solid',
+        );
+
+        foreach ( $patterns as $needle => $pat_name ) {
+                if ( preg_match( '/\b' . preg_quote( $needle, '/' ) . '\b/', $text ) ) {
+                        return $pat_name;
+                }
+        }
+
+        return '';
+}
+
+/**
+ * Intelligent size extraction heuristic.
+ *
+ * @param string $title Product title.
+ * @param string $desc  Product description.
+ * @return string Extracted size or empty.
+ */
+function wipf_detect_size( $title, $desc = '' ) {
+        $text = $title . ' ' . $desc;
+
+        // 1. One Size / OS
+        if ( preg_match( '/\b(one\s*size|osfm|osfa)\b/i', $text ) ) {
+                return 'One Size';
+        }
+
+        // 2. Ring or shoe sizes: "Size 7", "Size 7.5", "US 8"
+        if ( preg_match( '/\b(?:size|us|eu)\s*([0-9]+(?:\.[0-9]+)?)\b/i', $text, $matches ) ) {
+                return $matches[1];
+        }
+
+        // 3. Dimensional bead / diameter sizes: "8mm", "10mm", "12mm"
+        if ( preg_match( '/\b([0-9]+(?:\.[0-9]+)?\s*(?:mm|cm|in|inch|inches))\b/i', $text, $matches ) ) {
+                return trim( $matches[1] );
+        }
+
+        // 4. Apparel sizes: XS, S, M, L, XL, XXL, 2XL, 3XL
+        if ( preg_match( '/\b(XS|S|M|L|XL|XXL|2XL|3XL)\b/', $text, $matches ) ) {
+                return $matches[1];
+        }
+
+        return '';
+}
+
+/**
+ * Evaluates a Google Shopping custom label (0-4) according to configured rules.
+ *
+ * @param int   $slot    Custom label index (0 to 4).
+ * @param array $product Normalized product data.
+ * @param array $config  Plugin settings.
+ * @return array Array with keys 'value', 'reason', 'type'.
+ */
+function wipf_evaluate_custom_label( $slot, $product, $config ) {
+        $slot = absint( $slot );
+        if ( $slot < 0 || $slot > 4 ) {
+                return array( 'value' => '', 'reason' => 'Invalid slot', 'type' => 'disabled' );
+        }
+
+        $type     = ! empty( $config["custom_label_{$slot}_type"] ) ? $config["custom_label_{$slot}_type"] : 'disabled';
+        $rule_val = ! empty( $config["custom_label_{$slot}_value"] ) ? trim( $config["custom_label_{$slot}_value"] ) : '';
+        $fallback = ! empty( $config["custom_label_{$slot}_fallback"] ) ? trim( $config["custom_label_{$slot}_fallback"] ) : '';
+
+        $result = '';
+        $reason = '';
+
+        switch ( $type ) {
+                case 'disabled':
+                        return array(
+                                'value'  => '',
+                                'reason' => 'Slot disabled',
+                                'type'   => 'disabled',
+                        );
+
+                case 'static':
+                        $result = $rule_val;
+                        $reason = 'Static configured value: ' . $rule_val;
+                        break;
+
+                case 'price_tier':
+                        $price = isset( $product['price'] ) ? (float) $product['price'] : 0.0;
+                        $curr  = ! empty( $product['currency'] ) ? $product['currency'] : ( $config['shipping_currency'] ?? 'USD' );
+
+                        // Check custom thresholds e.g. "50" or "30,80" or "25,50,100"
+                        $thresholds = array( 25.0, 50.0, 100.0 );
+                        if ( ! empty( $rule_val ) ) {
+                                $parsed = array();
+                                $raw_parts = explode( ',', $rule_val );
+                                foreach ( $raw_parts as $rp ) {
+                                        $fv = (float) trim( $rp );
+                                        if ( $fv > 0 ) {
+                                                $parsed[] = $fv;
+                                        }
+                                }
+                                if ( ! empty( $parsed ) ) {
+                                        sort( $parsed );
+                                        $thresholds = array_values( array_unique( $parsed ) );
+                                }
+                        }
+
+                        $count = count( $thresholds );
+                        if ( $price < $thresholds[0] ) {
+                                $result = 'Under ' . (int) $thresholds[0];
+                                $reason = sprintf( 'Price %0.2f %s < %0.2f', $price, $curr, $thresholds[0] );
+                        } elseif ( $price >= $thresholds[ $count - 1 ] ) {
+                                $result = (int) $thresholds[ $count - 1 ] . ' and Above';
+                                $reason = sprintf( 'Price %0.2f %s >= %0.2f', $price, $curr, $thresholds[ $count - 1 ] );
+                        } else {
+                                for ( $ti = 0; $ti < $count - 1; $ti++ ) {
+                                        if ( $price >= $thresholds[ $ti ] && $price < $thresholds[ $ti + 1 ] ) {
+                                                $result = (int) $thresholds[ $ti ] . ' to ' . (int) $thresholds[ $ti + 1 ];
+                                                $reason = sprintf( 'Price %0.2f %s between %0.2f and %0.2f', $price, $curr, $thresholds[ $ti ], $thresholds[ $ti + 1 ] );
+                                                break;
+                                        }
+                                }
+                        }
+                        break;
+
+                case 'inventory':
+                        $status = ! empty( $product['availability'] ) ? $product['availability'] : 'in_stock';
+                        $in_label  = 'In Stock';
+                        $out_label = 'Out of Stock';
+                        if ( ! empty( $rule_val ) && false !== strpos( $rule_val, ':' ) ) {
+                                $pairs = explode( ',', $rule_val );
+                                foreach ( $pairs as $pair ) {
+                                        $p = array_map( 'trim', explode( ':', $pair, 2 ) );
+                                        if ( count( $p ) === 2 ) {
+                                                if ( 'in_stock' === $p[0] ) {
+                                                        $in_label = $p[1];
+                                                } elseif ( 'out_of_stock' === $p[0] ) {
+                                                        $out_label = $p[1];
+                                                }
+                                        }
+                                }
+                        }
+
+                        if ( 'out_of_stock' === $status ) {
+                                $result = $out_label;
+                                $reason = 'Inventory status is out_of_stock';
+                        } else {
+                                $result = $in_label;
+                                $reason = 'Inventory status is in_stock';
+                        }
+                        break;
+
+                case 'category':
+                        if ( ! empty( $product['categories'] ) && is_array( $product['categories'] ) ) {
+                                $result = reset( $product['categories'] );
+                                $reason = 'Derived from primary category: ' . $result;
+                        } elseif ( ! empty( $product['category'] ) ) {
+                                $result = $product['category'];
+                                $reason = 'Derived from product category: ' . $result;
+                        } else {
+                                $result = ! empty( $config['default_category'] ) ? $config['default_category'] : '';
+                                $reason = 'Fallback to default category';
+                        }
+                        break;
+
+                case 'tag_keywords':
+                        $tags_list = ! empty( $product['tags'] ) && is_array( $product['tags'] ) ? $product['tags'] : array();
+                        $text_to_search = strtolower( ( $product['title'] ?? '' ) . ' ' . implode( ' ', $tags_list ) );
+
+                        if ( ! empty( $rule_val ) ) {
+                                $pairs = explode( ',', $rule_val );
+                                foreach ( $pairs as $pair ) {
+                                        $parts = array_map( 'trim', explode( ':', $pair, 2 ) );
+                                        $keyword = strtolower( $parts[0] );
+                                        $label   = isset( $parts[1] ) && '' !== $parts[1] ? $parts[1] : ucwords( $parts[0] );
+
+                                        if ( '' !== $keyword && false !== strpos( $text_to_search, $keyword ) ) {
+                                                $result = $label;
+                                                $reason = "Matched keyword '{$keyword}' in title or tags";
+                                                break;
+                                        }
+                                }
+                        }
+
+                        if ( empty( $result ) ) {
+                                $reason = 'No matching tag or keyword found';
+                        }
+                        break;
+
+                case 'custom_meta':
+                        $meta_key = $rule_val;
+                        if ( ! empty( $meta_key ) && ! empty( $product['id'] ) && function_exists( 'get_post_meta' ) ) {
+                                $meta_val = get_post_meta( $product['id'], $meta_key, true );
+                                if ( empty( $meta_val ) && ! empty( $product['item_group_id'] ) ) {
+                                        $meta_val = get_post_meta( $product['item_group_id'], $meta_key, true );
+                                }
+                                if ( ! empty( $meta_val ) && is_scalar( $meta_val ) ) {
+                                        $result = (string) $meta_val;
+                                        $reason = "Retrieved from post meta '{$meta_key}'";
+                                } else {
+                                        $reason = "Post meta '{$meta_key}' is empty";
+                                }
+                        } else {
+                                $reason = 'Custom meta key not specified';
+                        }
+                        break;
+
+                default:
+                        $reason = 'Unknown rule type: ' . $type;
+                        break;
+        }
+
+        // Apply fallback if result is empty
+        if ( '' === $result && '' !== $fallback ) {
+                $result = $fallback;
+                $reason .= ' (Fallback applied: ' . $fallback . ')';
+        }
+
+        // Google Shopping max length for custom_label_0-4 is 100 characters
+        if ( '' !== $result ) {
+                $clean_result = sanitize_text_field( $result );
+                if ( function_exists( 'mb_strlen' ) ) {
+                        if ( mb_strlen( $clean_result, 'UTF-8' ) > 100 ) {
+                                $clean_result = mb_substr( $clean_result, 0, 100, 'UTF-8' );
+                        }
+                } else {
+                        $clean_result = substr( $clean_result, 0, 100 );
+                }
+                $result = $clean_result;
+        }
+
+        return array(
+                'value'  => $result,
+                'reason' => $reason,
+                'type'   => $type,
+        );
+}
+
+/**
  * Safe XML entity escaper.
  *
@@ -165 +549 @@
 /**
  * Fetches normalized product catalog from active e-commerce platforms.
- * Supports SureCart and WooCommerce seamlessly.
+ * Supports SureCart and WooCommerce seamlessly including product variations.
  *
  * @param int $limit Maximum number of products to return.
@@ -176 +560 @@
                 $limit = 500;
         }
+
+        $settings = wipf_get_settings();
 
         // 1. Check SureCart products (sc_product)
@@ -239 +625 @@
                                 }
 
+                                // Categories & Tags
+                                $categories = array();
+                                if ( function_exists( 'wp_get_post_terms' ) ) {
+                                        $sc_terms = wp_get_post_terms( $post_id, 'sc_collection', array( 'fields' => 'names' ) );
+                                        if ( is_array( $sc_terms ) ) {
+                                                $categories = $sc_terms;
+                                        }
+                                }
+
+                                $tags = array();
+                                if ( function_exists( 'wp_get_post_terms' ) ) {
+                                        $sc_tag_terms = wp_get_post_terms( $post_id, 'sc_tag', array( 'fields' => 'names' ) );
+                                        if ( is_array( $sc_tag_terms ) ) {
+                                                $tags = $sc_tag_terms;
+                                        }
+                                }
+
+                                // Variant attributes
+                                $parent_id = get_post_meta( $post_id, 'sc_parent_id', true );
+
+                                $sc_color = get_post_meta( $post_id, 'sc_color', true );
+                                if ( empty( $sc_color ) && 'yes' === ( $settings['auto_detect_color'] ?? 'yes' ) ) {
+                                        $sc_color = wipf_detect_color( $title, $content );
+                                }
+
+                                $sc_size = get_post_meta( $post_id, 'sc_size', true );
+                                if ( empty( $sc_size ) && 'yes' === ( $settings['auto_detect_size'] ?? 'yes' ) ) {
+                                        $sc_size = wipf_detect_size( $title, $content );
+                                }
+
+                                $sc_mat = get_post_meta( $post_id, 'sc_material', true );
+                                if ( empty( $sc_mat ) && 'yes' === ( $settings['auto_detect_material'] ?? 'yes' ) ) {
+                                        $sc_mat = wipf_detect_material( $title, $content );
+                                }
+
+                                $sc_pat = get_post_meta( $post_id, 'sc_pattern', true );
+                                if ( empty( $sc_pat ) && 'yes' === ( $settings['auto_detect_pattern'] ?? 'yes' ) ) {
+                                        $sc_pat = wipf_detect_pattern( $title, $content );
+                                }
+
                                 $products[] = array(
                                         'id'             => $post_id,
+                                        'item_group_id'  => ! empty( $parent_id ) ? (string) $parent_id : '',
                                         'title'          => $title,
                                         'description'    => $content,
@@ -250 +677 @@
                                         'availability'   => $inv_status,
                                         'source'         => 'surecart',
+                                        'color'          => $sc_color,
+                                        'size'           => $sc_size,
+                                        'material'       => $sc_mat,
+                                        'pattern'        => $sc_pat,
+                                        'categories'     => $categories,
+                                        'tags'           => $tags,
                                 );
+
+                                if ( count( $products ) >= $limit ) {
+                                        break;
+                                }
                         }
                         wp_reset_postdata();
@@ -257 +694 @@
 
         // 2. Check WooCommerce products (product)
-        if ( function_exists( 'wc_get_products' ) || post_type_exists( 'product' ) ) {
+        if ( ( function_exists( 'wc_get_products' ) || post_type_exists( 'product' ) ) && count( $products ) < $limit ) {
                 $wc_args = array(
                         'post_type'      => 'product',
                         'post_status'    => 'publish',
-                        'posts_per_page' => $limit,
+                        'posts_per_page' => $limit - count( $products ),
                         'orderby'        => 'ID',
                         'order'          => 'DESC',
@@ -284 +721 @@
                                 $inv_status = 'in_stock';
 
-                                if ( function_exists( 'wc_get_product' ) ) {
-                                        $wc_prod = wc_get_product( $post_id );
-                                        if ( $wc_prod ) {
-                                                $price = $wc_prod->get_price();
-                                                $inv_status = $wc_prod->is_in_stock() ? 'in_stock' : 'out_of_stock';
+                                // Categories & Tags
+                                $categories = array();
+                                if ( function_exists( 'wp_get_post_terms' ) ) {
+                                        $wc_terms = wp_get_post_terms( $post_id, 'product_cat', array( 'fields' => 'names' ) );
+                                        if ( is_array( $wc_terms ) ) {
+                                                $categories = $wc_terms;
                                         }
-                                } else {
-                                        $raw_price = get_post_meta( $post_id, '_price', true );
-                                        if ( is_numeric( $raw_price ) ) {
-                                                $price = (float) $raw_price;
+                                }
+
+                                $tags = array();
+                                if ( function_exists( 'wp_get_post_terms' ) ) {
+                                        $wc_tag_terms = wp_get_post_terms( $post_id, 'product_tag', array( 'fields' => 'names' ) );
+                                        if ( is_array( $wc_tag_terms ) ) {
+                                                $tags = $wc_tag_terms;
                                         }
                                 }
@@ -314 +755 @@
                                 }
 
+                                // Check WooCommerce Product object & Variable product handling
+                                $wc_prod = function_exists( 'wc_get_product' ) ? wc_get_product( $post_id ) : null;
+                                if ( $wc_prod ) {
+                                        // Variable products: expand into variations with item_group_id
+                                        if ( method_exists( $wc_prod, 'is_type' ) && $wc_prod->is_type( 'variable' ) ) {
+                                                $variation_ids = method_exists( $wc_prod, 'get_children' ) ? $wc_prod->get_children() : array();
+                                                if ( ! empty( $variation_ids ) ) {
+                                                        foreach ( $variation_ids as $var_id ) {
+                                                                $var_obj = wc_get_product( $var_id );
+                                                                if ( ! $var_obj ) {
+                                                                        continue;
+                                                                }
+
+                                                                $var_price = $var_obj->get_price();
+                                                                $var_inv   = $var_obj->is_in_stock() ? 'in_stock' : 'out_of_stock';
+                                                                $var_link  = $var_obj->get_permalink() ?: $permalink;
+
+                                                                $var_img_id = $var_obj->get_image_id();
+                                                                $var_image  = $var_img_id ? wp_get_attachment_url( $var_img_id ) : $image_url;
+
+                                                                // Variation attributes
+                                                                $var_color = $var_obj->get_attribute( 'pa_color' ) ?: $var_obj->get_attribute( 'color' );
+                                                                if ( empty( $var_color ) && 'yes' === ( $settings['auto_detect_color'] ?? 'yes' ) ) {
+                                                                        $var_color = wipf_detect_color( $var_obj->get_name() . ' ' . $title, $content );
+                                                                }
+
+                                                                $var_size = $var_obj->get_attribute( 'pa_size' ) ?: $var_obj->get_attribute( 'size' );
+                                                                if ( empty( $var_size ) && 'yes' === ( $settings['auto_detect_size'] ?? 'yes' ) ) {
+                                                                        $var_size = wipf_detect_size( $var_obj->get_name() . ' ' . $title, $content );
+                                                                }
+
+                                                                $var_mat = $var_obj->get_attribute( 'pa_material' ) ?: $var_obj->get_attribute( 'material' );
+                                                                if ( empty( $var_mat ) && 'yes' === ( $settings['auto_detect_material'] ?? 'yes' ) ) {
+                                                                        $var_mat = wipf_detect_material( $var_obj->get_name() . ' ' . $title, $content );
+                                                                }
+
+                                                                $var_pat = $var_obj->get_attribute( 'pa_pattern' ) ?: $var_obj->get_attribute( 'pattern' );
+                                                                if ( empty( $var_pat ) && 'yes' === ( $settings['auto_detect_pattern'] ?? 'yes' ) ) {
+                                                                        $var_pat = wipf_detect_pattern( $var_obj->get_name() . ' ' . $title, $content );
+                                                                }
+
+                                                                $products[] = array(
+                                                                        'id'             => $var_id,
+                                                                        'item_group_id'  => (string) $post_id,
+                                                                        'title'          => $var_obj->get_name() ?: $title,
+                                                                        'description'    => $content,
+                                                                        'permalink'      => $var_link,
+                                                                        'image_url'      => $var_image,
+                                                                        'gallery_images' => $gallery_images,
+                                                                        'price'          => number_format( (float) $var_price, 2, '.', '' ),
+                                                                        'currency'       => $currency,
+                                                                        'availability'   => $var_inv,
+                                                                        'source'         => 'woocommerce',
+                                                                        'color'          => $var_color,
+                                                                        'size'           => $var_size,
+                                                                        'material'       => $var_mat,
+                                                                        'pattern'        => $var_pat,
+                                                                        'categories'     => $categories,
+                                                                        'tags'           => $tags,
+                                                                );
+
+                                                                if ( count( $products ) >= $limit ) {
+                                                                        break 2;
+                                                                }
+                                                        }
+                                                        continue; // Variations added, skip parent product
+                                                }
+                                        }
+
+                                        // Simple product
+                                        $price = $wc_prod->get_price();
+                                        $inv_status = $wc_prod->is_in_stock() ? 'in_stock' : 'out_of_stock';
+                                } else {
+                                        $raw_price = get_post_meta( $post_id, '_price', true );
+                                        if ( is_numeric( $raw_price ) ) {
+                                                $price = (float) $raw_price;
+                                        }
+                                }
+
+                                // Simple product attributes
+                                $prod_color = '';
+                                $prod_size  = '';
+                                $prod_mat   = '';
+                                $prod_pat   = '';
+
+                                if ( $wc_prod && method_exists( $wc_prod, 'get_attribute' ) ) {
+                                        $prod_color = $wc_prod->get_attribute( 'pa_color' ) ?: $wc_prod->get_attribute( 'color' );
+                                        $prod_size  = $wc_prod->get_attribute( 'pa_size' ) ?: $wc_prod->get_attribute( 'size' );
+                                        $prod_mat   = $wc_prod->get_attribute( 'pa_material' ) ?: $wc_prod->get_attribute( 'material' );
+                                        $prod_pat   = $wc_prod->get_attribute( 'pa_pattern' ) ?: $wc_prod->get_attribute( 'pattern' );
+                                }
+
+                                if ( empty( $prod_color ) && 'yes' === ( $settings['auto_detect_color'] ?? 'yes' ) ) {
+                                        $prod_color = wipf_detect_color( $title, $content );
+                                }
+                                if ( empty( $prod_size ) && 'yes' === ( $settings['auto_detect_size'] ?? 'yes' ) ) {
+                                        $prod_size = wipf_detect_size( $title, $content );
+                                }
+                                if ( empty( $prod_mat ) && 'yes' === ( $settings['auto_detect_material'] ?? 'yes' ) ) {
+                                        $prod_mat = wipf_detect_material( $title, $content );
+                                }
+                                if ( empty( $prod_pat ) && 'yes' === ( $settings['auto_detect_pattern'] ?? 'yes' ) ) {
+                                        $prod_pat = wipf_detect_pattern( $title, $content );
+                                }
+
                                 $products[] = array(
                                         'id'             => $post_id,
+                                        'item_group_id'  => '',
                                         'title'          => $title,
                                         'description'    => $content,
@@ -325 +872 @@
                                         'availability'   => $inv_status,
                                         'source'         => 'woocommerce',
+                                        'color'          => $prod_color,
+                                        'size'           => $prod_size,
+                                        'material'       => $prod_mat,
+                                        'pattern'        => $prod_pat,
+                                        'categories'     => $categories,
+                                        'tags'           => $tags,
                                 );
+
+                                if ( count( $products ) >= $limit ) {
+                                        break;
+                                }
                         }
                         wp_reset_postdata();
@@ -353 +910 @@
         $ship_cost       = ! empty( $config['shipping_cost'] ) ? $config['shipping_cost'] : '0.00';
         $ship_curr       = ! empty( $config['shipping_currency'] ) ? $config['shipping_currency'] : 'USD';
+        $enable_labels   = ( 'no' !== ( $config['enable_custom_labels'] ?? 'yes' ) );
 
         $xml  = '<?xml version="1.0" encoding="UTF-8"?>' . "\n";
@@ -367 +925 @@
                 $price_val   = $item['price'];
                 $curr_val    = ! empty( $item['currency'] ) ? $item['currency'] : $ship_curr;
-                $item_color  = $auto_color ? wipf_detect_color( $title, $desc ) : '';
-
-                // Pet classification heuristic
+
+                // Color priority: item attribute > heuristic
+                $item_color  = ! empty( $item['color'] ) ? $item['color'] : ( $auto_color ? wipf_detect_color( $title, $desc ) : '' );
+
+                // Category classification heuristic
                 $category = $def_category;
+                if ( ! empty( $item['categories'] ) && is_array( $item['categories'] ) ) {
+                        $category = implode( ' > ', $item['categories'] );
+                }
                 if ( false !== stripos( $title, 'collar' ) || false !== stripos( $title, 'pet' ) || false !== stripos( $title, 'dog' ) || false !== stripos( $title, 'cat' ) ) {
                         $category = 'Animals & Pet Supplies > Pet Supplies > Pet Collars & Harnesses';
@@ -377 +940 @@
                 $xml .= "    <item>\n";
                 $xml .= '      <g:id>' . wipf_xml_escape( $item['id'] ) . "</g:id>\n";
+
+                // Variant item_group_id grouping
+                if ( ! empty( $item['item_group_id'] ) ) {
+                        $xml .= '      <g:item_group_id>' . wipf_xml_escape( $item['item_group_id'] ) . "</g:item_group_id>\n";
+                }
+
                 $xml .= '      <g:title>' . wipf_xml_escape( $title ) . "</g:title>\n";
                 $xml .= '      <g:description>' . wipf_xml_escape( $desc ) . "</g:description>\n";
@@ -400 +969 @@
                         $xml .= '      <g:color>' . wipf_xml_escape( $item_color ) . "</g:color>\n";
                 }
+                if ( ! empty( $item['size'] ) ) {
+                        $xml .= '      <g:size>' . wipf_xml_escape( $item['size'] ) . "</g:size>\n";
+                }
+                if ( ! empty( $item['material'] ) ) {
+                        $xml .= '      <g:material>' . wipf_xml_escape( $item['material'] ) . "</g:material>\n";
+                }
+                if ( ! empty( $item['pattern'] ) ) {
+                        $xml .= '      <g:pattern>' . wipf_xml_escape( $item['pattern'] ) . "</g:pattern>\n";
+                }
+
                 if ( ! empty( $def_age_group ) ) {
                         $xml .= '      <g:age_group>' . wipf_xml_escape( $def_age_group ) . "</g:age_group>\n";
@@ -405 +984 @@
                 if ( ! empty( $def_gender ) ) {
                         $xml .= '      <g:gender>' . wipf_xml_escape( $def_gender ) . "</g:gender>\n";
+                }
+
+                // Inject Custom Labels (custom_label_0 to custom_label_4)
+                if ( $enable_labels ) {
+                        for ( $slot = 0; $slot <= 4; $slot++ ) {
+                                $label_data = wipf_evaluate_custom_label( $slot, $item, $config );
+                                if ( ! empty( $label_data['value'] ) ) {
+                                        $xml .= '      <g:custom_label_' . $slot . '>' . wipf_xml_escape( $label_data['value'] ) . '</g:custom_label_' . $slot . ">\n";
+                                }
+                        }
                 }
 
@@ -463 +1052 @@
 
 /**
+ * Detailed diagnostic inspector for a specific product ID or product data array.
+ *
+ * @param int|array  $product Product ID or product array.
+ * @param array|null $config  Optional configuration override.
+ * @return array Diagnostic report.
+ */
+function wipf_diagnose_product( $product, $config = null ) {
+        if ( null === $config ) {
+                $config = wipf_get_settings();
+        }
+
+        $item = is_array( $product ) ? $product : null;
+        if ( null === $item && is_numeric( $product ) ) {
+                $limit = 200;
+                $all_prods = wipf_collect_products( $limit );
+                foreach ( $all_prods as $p ) {
+                        if ( (int) $p['id'] === (int) $product ) {
+                                $item = $p;
+                                break;
+                        }
+                }
+                if ( null === $item && function_exists( 'get_post' ) ) {
+                        $post = get_post( (int) $product );
+                        if ( $post && 'publish' === ( $post->post_status ?? '' ) ) {
+                                $title = get_the_title( $post );
+                                $content = wp_strip_all_tags( get_the_excerpt( $post ) ?: ( get_the_content( null, false, $post ) ?: $title ) );
+                                $raw_price = get_post_meta( $post->ID, '_price', true );
+                                $price = is_numeric( $raw_price ) ? (float) $raw_price : 0.0;
+                                $image = get_the_post_thumbnail_url( $post->ID, 'full' ) ?: '';
+
+                                $categories = function_exists( 'wp_get_post_terms' ) ? wp_get_post_terms( $post->ID, 'product_cat', array( 'fields' => 'names' ) ) : array();
+                                $tags = function_exists( 'wp_get_post_terms' ) ? wp_get_post_terms( $post->ID, 'product_tag', array( 'fields' => 'names' ) ) : array();
+
+                                $item = array(
+                                        'id'             => $post->ID,
+                                        'item_group_id'  => '',
+                                        'title'          => $title,
+                                        'description'    => $content,
+                                        'permalink'      => get_permalink( $post->ID ),
+                                        'image_url'      => $image,
+                                        'gallery_images' => array(),
+                                        'price'          => number_format( $price, 2, '.', '' ),
+                                        'currency'       => $config['shipping_currency'] ?? 'USD',
+                                        'availability'   => 'in_stock',
+                                        'source'         => $post->post_type,
+                                        'color'          => wipf_detect_color( $title, $content ),
+                                        'size'           => wipf_detect_size( $title, $content ),
+                                        'material'       => wipf_detect_material( $title, $content ),
+                                        'pattern'        => wipf_detect_pattern( $title, $content ),
+                                        'categories'     => is_array( $categories ) ? $categories : array(),
+                                        'tags'           => is_array( $tags ) ? $tags : array(),
+                                );
+                        }
+                }
+        }
+
+        if ( empty( $item ) ) {
+                return array(
+                        'found' => false,
+                        'error' => __( 'Product not found or not published in catalog.', 'world-inspire-product-feed-for-google-shopping' ),
+                );
+        }
+
+        $labels = array();
+        for ( $i = 0; $i <= 4; $i++ ) {
+                $labels[ "custom_label_{$i}" ] = wipf_evaluate_custom_label( $i, $item, $config );
+        }
+
+        // Generate XML snippet for just this item
+        $xml_doc = wipf_build_google_shopping_xml( array( $item ), $config );
+        $xml_snippet = '';
+        if ( preg_match( '/<item>.*?<\/item>/s', $xml_doc, $matches ) ) {
+                $xml_snippet = trim( $matches[0] );
+        }
+
+        return array(
+                'found'       => true,
+                'product'     => $item,
+                'labels'      => $labels,
+                'xml_snippet' => $xml_snippet,
+        );
+}
+
+/**
  * Streams XML document with anti-caching reverse-proxy protection.
  *
@@ -482 +1155 @@
 
 /**
- * Registers REST API endpoints for Google Shopping and Trustmate.
+ * Registers REST API endpoints for Google Shopping, Trustmate, and Status.
  */
 function wipf_register_rest_routes() {
@@ -525 +1198 @@
                                 return new WP_REST_Response(
                                         array(
-                                                'enabled'            => true,
-                                                'status'             => 'healthy',
-                                                'version'            => WIPF_VERSION,
-                                                'surecart_detected'  => post_type_exists( 'sc_product' ),
+                                                'enabled'              => true,
+                                                'status'               => 'healthy',
+                                                'version'              => WIPF_VERSION,
+                                                'surecart_detected'    => post_type_exists( 'sc_product' ),
                                                 'woocommerce_detected' => ( function_exists( 'wc_get_products' ) || post_type_exists( 'product' ) ),
-                                                'sample_count'       => count( $products ),
+                                                'sample_count'         => count( $products ),
+                                                'custom_labels_active' => ( 'no' !== ( wipf_get_settings()['enable_custom_labels'] ?? 'yes' ) ),
                                         ),
                                         200
@@ -573 +1247 @@
         $output['identifier_exists']     = ( 'yes' === ( $input['identifier_exists'] ?? 'no' ) ) ? 'yes' : 'no';
         $output['auto_detect_color']     = ( 'yes' === ( $input['auto_detect_color'] ?? 'yes' ) ) ? 'yes' : 'no';
+        $output['auto_detect_material']  = ( 'yes' === ( $input['auto_detect_material'] ?? 'yes' ) ) ? 'yes' : 'no';
+        $output['auto_detect_size']      = ( 'yes' === ( $input['auto_detect_size'] ?? 'yes' ) ) ? 'yes' : 'no';
+        $output['auto_detect_pattern']   = ( 'yes' === ( $input['auto_detect_pattern'] ?? 'yes' ) ) ? 'yes' : 'no';
         $output['shipping_countries']    = ! empty( $input['shipping_countries'] ) ? sanitize_text_field( $input['shipping_countries'] ) : $defaults['shipping_countries'];
         $output['shipping_service_name'] = ! empty( $input['shipping_service_name'] ) ? sanitize_text_field( $input['shipping_service_name'] ) : $defaults['shipping_service_name'];
@@ -580 +1257 @@
         $output['enable_trustmate_feed'] = ( 'yes' === ( $input['enable_trustmate_feed'] ?? 'yes' ) ) ? 'yes' : 'no';
         $output['items_per_feed']        = absint( $input['items_per_feed'] ?? 500 );
+
+        // Custom Labels (custom_label_0 to custom_label_4)
+        $output['enable_custom_labels']  = ( 'yes' === ( $input['enable_custom_labels'] ?? 'yes' ) ) ? 'yes' : 'no';
+        $valid_rule_types = array( 'disabled', 'static', 'price_tier', 'inventory', 'category', 'tag_keywords', 'custom_meta' );
+
+        for ( $i = 0; $i <= 4; $i++ ) {
+                $type_key     = "custom_label_{$i}_type";
+                $val_key      = "custom_label_{$i}_value";
+                $fallback_key = "custom_label_{$i}_fallback";
+
+                $type = isset( $input[ $type_key ] ) && in_array( $input[ $type_key ], $valid_rule_types, true ) ? sanitize_key( $input[ $type_key ] ) : 'disabled';
+                $val  = isset( $input[ $val_key ] ) ? sanitize_text_field( $input[ $val_key ] ) : '';
+                $fb   = isset( $input[ $fallback_key ] ) ? sanitize_text_field( $input[ $fallback_key ] ) : '';
+
+                $output[ $type_key ]     = $type;
+                $output[ $val_key ]      = $val;
+                $output[ $fallback_key ] = $fb;
+        }
 
         return $output;
@@ -614 +1309 @@
         ?>
         <div class="wrap">
-                <h1><?php echo esc_html__( 'World Inspire Product Feed for Google Shopping & Trustmate', 'world-inspire-product-feed-for-google-shopping' ); ?></h1>
+                <h1><?php echo esc_html__( 'World Inspire Product Feed for Google Shopping & Trustmate', 'world-inspire-product-feed-for-google-shopping' ); ?> <span style="font-size: 14px; background: #2271b1; color: #fff; padding: 2px 8px; border-radius: 4px; vertical-align: middle;">v<?php echo esc_html( WIPF_VERSION ); ?></span></h1>
                 <p class="description">
                         <?php echo esc_html__( 'Zero-configuration, high-performance real-time XML product feeds engineered for Google Merchant Center and Trustmate review synchronization.', 'world-inspire-product-feed-for-google-shopping' ); ?>
@@ -624 +1319 @@
                         </a>
                         <a href="?page=wipf-settings&tab=google" class="nav-tab <?php echo 'google' === $active_tab ? 'nav-tab-active' : ''; ?>">
-                                <?php echo esc_html__( 'Google Shopping Rules', 'world-inspire-product-feed-for-google-shopping' ); ?>
+                                <?php echo esc_html__( 'Google Shopping Rules & Custom Labels', 'world-inspire-product-feed-for-google-shopping' ); ?>
                         </a>
                         <a href="?page=wipf-settings&tab=shipping" class="nav-tab <?php echo 'shipping' === $active_tab ? 'nav-tab-active' : ''; ?>">
@@ -630 +1325 @@
                         </a>
                         <a href="?page=wipf-settings&tab=diagnostic" class="nav-tab <?php echo 'diagnostic' === $active_tab ? 'nav-tab-active' : ''; ?>">
-                                <?php echo esc_html__( 'Live Diagnostics & Preview', 'world-inspire-product-feed-for-google-shopping' ); ?>
+                                <?php echo esc_html__( 'Live Diagnostics & Inspector', 'world-inspire-product-feed-for-google-shopping' ); ?>
                         </a>
                 </h2>
 
                 <?php if ( 'endpoints' === $active_tab ) : ?>
-                        <div class="card" style="max-width: 900px; margin-top: 20px; padding: 20px;">
+                        <div class="card" style="max-width: 960px; margin-top: 20px; padding: 20px;">
                                 <h3><?php echo esc_html__( 'Authoritative Feed URLs', 'world-inspire-product-feed-for-google-shopping' ); ?></h3>
                                 <p><?php echo esc_html__( 'Copy these extension-free dynamic REST endpoints into Google Merchant Center and Trustmate. They automatically bypass reverse-proxy static file caches and update in real-time.', 'world-inspire-product-feed-for-google-shopping' ); ?></p>
@@ -664 +1359 @@
                         </div>
                 <?php elseif ( 'google' === $active_tab || 'shipping' === $active_tab ) : ?>
-                        <form method="post" action="options.php" style="max-width: 900px; margin-top: 20px;">
+                        <form method="post" action="options.php" style="max-width: 960px; margin-top: 20px;">
                                 <?php
                                 settings_fields( 'wipf_settings_group' );
                                 ?>
-                                <div class="card" style="padding: 20px;">
-                                        <?php if ( 'google' === $active_tab ) : ?>
+                                <?php if ( 'google' === $active_tab ) : ?>
+                                        <div class="card" style="padding: 20px; margin-bottom: 20px;">
                                                 <h3><?php echo esc_html__( 'Google Shopping Catalog Standards', 'world-inspire-product-feed-for-google-shopping' ); ?></h3>
                                                 <table class="form-table" role="presentation">
@@ -692 +1387 @@
                                                                                 <option value="kids" <?php selected( $settings['default_age_group'], 'kids' ); ?>><?php echo esc_html__( 'Kids', 'world-inspire-product-feed-for-google-shopping' ); ?></option>
                                                                                 <option value="toddler" <?php selected( $settings['default_age_group'], 'toddler' ); ?>><?php echo esc_html__( 'Toddler', 'world-inspire-product-feed-for-google-shopping' ); ?></option>
+                                                                                <option value="infant" <?php selected( $settings['default_age_group'], 'infant' ); ?>><?php echo esc_html__( 'Infant', 'world-inspire-product-feed-for-google-shopping' ); ?></option>
+                                                                                <option value="newborn" <?php selected( $settings['default_age_group'], 'newborn' ); ?>><?php echo esc_html__( 'Newborn', 'world-inspire-product-feed-for-google-shopping' ); ?></option>
                                                                         </select>
                                                                 </td>
@@ -705 +1402 @@
                                                                 </td>
                                                         </tr>
+                                                </table>
+                                        </div>
+
+                                        <div class="card" style="padding: 20px; margin-bottom: 20px;">
+                                                <h3><?php echo esc_html__( 'Variant & Attribute Optimization', 'world-inspire-product-feed-for-google-shopping' ); ?></h3>
+                                                <p class="description">
+                                                        <?php echo esc_html__( 'Extract and optimize essential Google Shopping attributes from WooCommerce and SureCart. WooCommerce variable products are automatically exported as individual items linked by <g:item_group_id>.', 'world-inspire-product-feed-for-google-shopping' ); ?>
+                                                </p>
+                                                <table class="form-table" role="presentation">
                                                         <tr>
-                                                                <th scope="row"><label for="wipf_auto_color"><?php echo esc_html__( 'Smart Color Extraction', 'world-inspire-product-feed-for-google-shopping' ); ?></label></th>
+                                                                <th scope="row"><?php echo esc_html__( 'Smart Attribute Detection', 'world-inspire-product-feed-for-google-shopping' ); ?></th>
                                                                 <td>
-                                                                        <label>
-                                                                                <input type="checkbox" id="wipf_auto_color" name="wipf_feed_settings[auto_detect_color]" value="yes" <?php checked( $settings['auto_detect_color'], 'yes' ); ?> />
-                                                                                <?php echo esc_html__( 'Automatically infer and populate Google standard colors from title and description', 'world-inspire-product-feed-for-google-shopping' ); ?>
+                                                                        <label style="display: block; margin-bottom: 8px;">
+                                                                                <input type="checkbox" name="wipf_feed_settings[auto_detect_color]" value="yes" <?php checked( $settings['auto_detect_color'], 'yes' ); ?> />
+                                                                                <strong><?php echo esc_html__( 'Color Extraction (<g:color>)', 'world-inspire-product-feed-for-google-shopping' ); ?></strong> — <?php echo esc_html__( 'Infer Google standard color names from attributes, titles, or descriptions (over 35 jewelry/apparel shades).', 'world-inspire-product-feed-for-google-shopping' ); ?>
+                                                                        </label>
+                                                                        <label style="display: block; margin-bottom: 8px;">
+                                                                                <input type="checkbox" name="wipf_feed_settings[auto_detect_material]" value="yes" <?php checked( $settings['auto_detect_material'] ?? 'yes', 'yes' ); ?> />
+                                                                                <strong><?php echo esc_html__( 'Material Extraction (<g:material>)', 'world-inspire-product-feed-for-google-shopping' ); ?></strong> — <?php echo esc_html__( 'Detect materials (Gold, Sterling Silver, Leather, Cotton, Gemstones, Titanium, Stainless Steel).', 'world-inspire-product-feed-for-google-shopping' ); ?>
+                                                                        </label>
+                                                                        <label style="display: block; margin-bottom: 8px;">
+                                                                                <input type="checkbox" name="wipf_feed_settings[auto_detect_size]" value="yes" <?php checked( $settings['auto_detect_size'] ?? 'yes', 'yes' ); ?> />
+                                                                                <strong><?php echo esc_html__( 'Size Extraction (<g:size>)', 'world-inspire-product-feed-for-google-shopping' ); ?></strong> — <?php echo esc_html__( 'Extract sizes from variation attributes or titles (e.g. Size 7, One Size, 8mm, S, M, L, XL).', 'world-inspire-product-feed-for-google-shopping' ); ?>
+                                                                        </label>
+                                                                        <label style="display: block; margin-bottom: 8px;">
+                                                                                <input type="checkbox" name="wipf_feed_settings[auto_detect_pattern]" value="yes" <?php checked( $settings['auto_detect_pattern'] ?? 'yes', 'yes' ); ?> />
+                                                                                <strong><?php echo esc_html__( 'Pattern Extraction (<g:pattern>)', 'world-inspire-product-feed-for-google-shopping' ); ?></strong> — <?php echo esc_html__( 'Detect patterns (Solid, Striped, Floral, Beaded, Polka Dot, Geometric).', 'world-inspire-product-feed-for-google-shopping' ); ?>
                                                                         </label>
                                                                 </td>
                                                         </tr>
                                                 </table>
-                                        <?php elseif ( 'shipping' === $active_tab ) : ?>
+                                        </div>
+
+                                        <div class="card" style="padding: 20px; margin-bottom: 20px;">
+                                                <h3><?php echo esc_html__( 'Google Shopping Custom Labels (0–4)', 'world-inspire-product-feed-for-google-shopping' ); ?></h3>
+                                                <p class="description">
+                                                        <?php echo esc_html__( 'Custom labels allow you to segment and filter products in Google Ads and Performance Max (PMax) campaigns (e.g. by price brackets, inventory status, product category, clearance tags, or margin tiers).', 'world-inspire-product-feed-for-google-shopping' ); ?>
+                                                </p>
+                                                <p>
+                                                        <label>
+                                                                <input type="checkbox" name="wipf_feed_settings[enable_custom_labels]" value="yes" <?php checked( $settings['enable_custom_labels'] ?? 'yes', 'yes' ); ?> />
+                                                                <strong><?php echo esc_html__( 'Enable Custom Labels in Feed', 'world-inspire-product-feed-for-google-shopping' ); ?></strong>
+                                                        </label>
+                                                </p>
+
+                                                <table class="widefat striped" style="margin-top: 15px;">
+                                                        <thead>
+                                                                <tr>
+                                                                        <th style="width: 16%;"><?php echo esc_html__( 'Custom Label Slot', 'world-inspire-product-feed-for-google-shopping' ); ?></th>
+                                                                        <th style="width: 22%;"><?php echo esc_html__( 'Rule Type', 'world-inspire-product-feed-for-google-shopping' ); ?></th>
+                                                                        <th style="width: 38%;"><?php echo esc_html__( 'Rule Value / Configuration', 'world-inspire-product-feed-for-google-shopping' ); ?></th>
+                                                                        <th style="width: 24%;"><?php echo esc_html__( 'Fallback Value', 'world-inspire-product-feed-for-google-shopping' ); ?></th>
+                                                                </tr>
+                                                        </thead>
+                                                        <tbody>
+                                                                <?php
+                                                                $label_recommendations = array(
+                                                                        0 => array( 'name' => 'Custom Label 0', 'rec' => 'Price Tiers (< 25, 25-50, 50-100, 100+)', 'ph_val' => '25,50,100 (Thresholds)', 'ph_fb' => 'Standard' ),
+                                                                        1 => array( 'name' => 'Custom Label 1', 'rec' => 'Inventory Status (In Stock / Out of Stock)', 'ph_val' => 'Optional override: in_stock:Available, out_of_stock:Unavailable', 'ph_fb' => 'Out of Stock' ),
+                                                                        2 => array( 'name' => 'Custom Label 2', 'rec' => 'Category / Collection Name', 'ph_val' => 'Leave empty to use primary category', 'ph_fb' => 'General' ),
+                                                                        3 => array( 'name' => 'Custom Label 3', 'rec' => 'Promotional / Tag Keywords Match', 'ph_val' => 'clearance:Clearance, sale:On Sale, bestseller:Best Seller', 'ph_fb' => 'Regular' ),
+                                                                        4 => array( 'name' => 'Custom Label 4', 'rec' => 'Static Value / Custom Post Meta Key', 'ph_val' => 'Enter static string or post_meta key', 'ph_fb' => '' ),
+                                                                );
+
+                                                                for ( $slot = 0; $slot <= 4; $slot++ ) :
+                                                                        $slot_type = $settings[ "custom_label_{$slot}_type" ] ?? 'disabled';
+                                                                        $slot_val  = $settings[ "custom_label_{$slot}_value" ] ?? '';
+                                                                        $slot_fb   = $settings[ "custom_label_{$slot}_fallback" ] ?? '';
+                                                                        $meta_info = $label_recommendations[ $slot ];
+                                                                        ?>
+                                                                        <tr>
+                                                                                <td>
+                                                                                        <strong><?php echo esc_html( $meta_info['name'] ); ?></strong>
+                                                                                        <br><span class="description" style="font-size: 11px;"><?php echo esc_html( $meta_info['rec'] ); ?></span>
+                                                                                </td>
+                                                                                <td>
+                                                                                        <select name="wipf_feed_settings[custom_label_<?php echo $slot; ?>_type]" style="width: 100%;">
+                                                                                                <option value="disabled" <?php selected( $slot_type, 'disabled' ); ?>><?php echo esc_html__( 'Disabled', 'world-inspire-product-feed-for-google-shopping' ); ?></option>
+                                                                                                <option value="price_tier" <?php selected( $slot_type, 'price_tier' ); ?>><?php echo esc_html__( 'Price Range Tier', 'world-inspire-product-feed-for-google-shopping' ); ?></option>
+                                                                                                <option value="inventory" <?php selected( $slot_type, 'inventory' ); ?>><?php echo esc_html__( 'Inventory Status', 'world-inspire-product-feed-for-google-shopping' ); ?></option>
+                                                                                                <option value="category" <?php selected( $slot_type, 'category' ); ?>><?php echo esc_html__( 'Product Category', 'world-inspire-product-feed-for-google-shopping' ); ?></option>
+                                                                                                <option value="tag_keywords" <?php selected( $slot_type, 'tag_keywords' ); ?>><?php echo esc_html__( 'Tag & Keyword Matcher', 'world-inspire-product-feed-for-google-shopping' ); ?></option>
+                                                                                                <option value="static" <?php selected( $slot_type, 'static' ); ?>><?php echo esc_html__( 'Static Custom String', 'world-inspire-product-feed-for-google-shopping' ); ?></option>
+                                                                                                <option value="custom_meta" <?php selected( $slot_type, 'custom_meta' ); ?>><?php echo esc_html__( 'Custom Post Meta Field', 'world-inspire-product-feed-for-google-shopping' ); ?></option>
+                                                                                        </select>
+                                                                                </td>
+                                                                                <td>
+                                                                                        <input type="text" name="wipf_feed_settings[custom_label_<?php echo $slot; ?>_value]" class="large-text" value="<?php echo esc_attr( $slot_val ); ?>" placeholder="<?php echo esc_attr( $meta_info['ph_val'] ); ?>" />
+                                                                                </td>
+                                                                                <td>
+                                                                                        <input type="text" name="wipf_feed_settings[custom_label_<?php echo $slot; ?>_fallback]" class="regular-text" value="<?php echo esc_attr( $slot_fb ); ?>" placeholder="<?php echo esc_attr( $meta_info['ph_fb'] ); ?>" />
+                                                                                </td>
+                                                                        </tr>
+                                                                <?php endfor; ?>
+                                                        </tbody>
+                                                </table>
+                                        </div>
+                                <?php elseif ( 'shipping' === $active_tab ) : ?>
+                                        <div class="card" style="padding: 20px;">
                                                 <h3><?php echo esc_html__( 'Multi-Country Shipping Generator', 'world-inspire-product-feed-for-google-shopping' ); ?></h3>
                                                 <p><?php echo esc_html__( 'Configures embedded shipping rules for international Google Shopping campaigns.', 'world-inspire-product-feed-for-google-shopping' ); ?></p>
@@ -741 +1526 @@
                                                         </tr>
                                                 </table>
-                                        <?php endif; ?>
-                                </div>
+                                        </div>
+                                <?php endif; ?>
                                 <?php submit_button(); ?>
                         </form>
                 <?php elseif ( 'diagnostic' === $active_tab ) : ?>
-                        <div class="card" style="max-width: 900px; margin-top: 20px; padding: 20px;">
-                                <h3><?php echo esc_html__( 'Live Feed Diagnostic Audit', 'world-inspire-product-feed-for-google-shopping' ); ?></h3>
-                                <?php
-                                $sample_products = wipf_collect_products( 5 );
-                                $surecart_ok     = post_type_exists( 'sc_product' );
-                                $woocommerce_ok  = ( function_exists( 'wc_get_products' ) || post_type_exists( 'product' ) );
-                                ?>
+                        <?php
+                        $surecart_ok     = post_type_exists( 'sc_product' );
+                        $woocommerce_ok  = ( function_exists( 'wc_get_products' ) || post_type_exists( 'product' ) );
+                        $sample_products = wipf_collect_products( 5 );
+
+                        $inspect_id = isset( $_GET['inspect_id'] ) ? absint( $_GET['inspect_id'] ) : ( ! empty( $sample_products[0]['id'] ) ? (int) $sample_products[0]['id'] : 0 );
+                        $audit_data = $inspect_id > 0 ? wipf_diagnose_product( $inspect_id, $settings ) : null;
+                        ?>
+                        <div class="card" style="max-width: 960px; margin-top: 20px; padding: 20px;">
+                                <h3><?php echo esc_html__( 'Live Feed Engine Status', 'world-inspire-product-feed-for-google-shopping' ); ?></h3>
                                 <p>
                                         <strong><?php echo esc_html__( 'SureCart Engine:', 'world-inspire-product-feed-for-google-shopping' ); ?></strong>
-                                        <?php echo $surecart_ok ? '<span style="color:green;">✔ ' . esc_html__( 'Detected', 'world-inspire-product-feed-for-google-shopping' ) . '</span>' : '<span style="color:#666;">' . esc_html__( 'Not Installed', 'world-inspire-product-feed-for-google-shopping' ) . '</span>'; ?>
+                                        <?php echo $surecart_ok ? '<span style="color:green; font-weight: bold;">✔ ' . esc_html__( 'Detected', 'world-inspire-product-feed-for-google-shopping' ) . '</span>' : '<span style="color:#666;">' . esc_html__( 'Not Installed', 'world-inspire-product-feed-for-google-shopping' ) . '</span>'; ?>
                                         &nbsp;|&nbsp;
                                         <strong><?php echo esc_html__( 'WooCommerce Engine:', 'world-inspire-product-feed-for-google-shopping' ); ?></strong>
-                                        <?php echo $woocommerce_ok ? '<span style="color:green;">✔ ' . esc_html__( 'Detected', 'world-inspire-product-feed-for-google-shopping' ) . '</span>' : '<span style="color:#666;">' . esc_html__( 'Not Installed', 'world-inspire-product-feed-for-google-shopping' ) . '</span>'; ?>
+                                        <?php echo $woocommerce_ok ? '<span style="color:green; font-weight: bold;">✔ ' . esc_html__( 'Detected', 'world-inspire-product-feed-for-google-shopping' ) . '</span>' : '<span style="color:#666;">' . esc_html__( 'Not Installed', 'world-inspire-product-feed-for-google-shopping' ) . '</span>'; ?>
+                                        &nbsp;|&nbsp;
+                                        <strong><?php echo esc_html__( 'Catalog Sample Available:', 'world-inspire-product-feed-for-google-shopping' ); ?></strong>
+                                        <code><?php echo esc_html( count( $sample_products ) ); ?></code>
                                 </p>
-                                <p>
-                                        <strong><?php echo esc_html__( 'Products Found in Catalog:', 'world-inspire-product-feed-for-google-shopping' ); ?></strong>
-                                        <?php echo esc_html( count( $sample_products ) ); ?> (<?php echo esc_html__( 'showing first 5', 'world-inspire-product-feed-for-google-shopping' ); ?>)
+                        </div>
+
+                        <!-- Product Inspector & XML Simulator -->
+                        <div class="card" style="max-width: 960px; margin-top: 20px; padding: 20px;">
+                                <h3><?php echo esc_html__( 'Product Inspector & Diagnostic Simulator', 'world-inspire-product-feed-for-google-shopping' ); ?></h3>
+                                <p class="description">
+                                        <?php echo esc_html__( 'Enter any Product ID to audit its exact extracted attributes, custom labels evaluation logic, and preview the generated Google Shopping <item> XML element.', 'world-inspire-product-feed-for-google-shopping' ); ?>
                                 </p>
 
+                                <form method="get" action="" style="margin: 15px 0 20px 0;">
+                                        <input type="hidden" name="page" value="wipf-settings" />
+                                        <input type="hidden" name="tab" value="diagnostic" />
+                                        <label for="inspect_id"><strong><?php echo esc_html__( 'Test Product ID:', 'world-inspire-product-feed-for-google-shopping' ); ?></strong></label>
+                                        <input type="number" id="inspect_id" name="inspect_id" value="<?php echo esc_attr( $inspect_id ? (string) $inspect_id : '' ); ?>" placeholder="e.g. 790" style="width: 140px; margin: 0 10px;" />
+                                        <button type="submit" class="button button-primary"><?php echo esc_html__( 'Inspect Product', 'world-inspire-product-feed-for-google-shopping' ); ?></button>
+                                </form>
+
+                                <?php if ( $audit_data && ! empty( $audit_data['found'] ) ) : ?>
+                                        <?php
+                                        $p = $audit_data['product'];
+                                        ?>
+                                        <div style="background: #f0f6fc; border-left: 4px solid #72aee6; padding: 12px 16px; margin-bottom: 20px;">
+                                                <h4 style="margin: 0 0 8px 0;"><?php echo esc_html( $p['title'] ); ?> <span style="font-weight: normal; font-size: 13px;">(ID: <code><?php echo esc_html( $p['id'] ); ?></code> &middot; <?php echo esc_html( $p['price'] . ' ' . $p['currency'] ); ?> &middot; <?php echo esc_html( $p['availability'] ); ?> &middot; Source: <code><?php echo esc_html( $p['source'] ); ?></code>)</span></h4>
+                                                <p style="margin: 0; font-size: 13px;">
+                                                        <strong><?php echo esc_html__( 'Variant Group ID:', 'world-inspire-product-feed-for-google-shopping' ); ?></strong> <?php echo ! empty( $p['item_group_id'] ) ? '<code>' . esc_html( $p['item_group_id'] ) . '</code>' : '<em>' . esc_html__( 'None (Simple Product)', 'world-inspire-product-feed-for-google-shopping' ) . '</em>'; ?>
+                                                        &nbsp;|&nbsp;
+                                                        <strong><?php echo esc_html__( 'Color:', 'world-inspire-product-feed-for-google-shopping' ); ?></strong> <code><?php echo esc_html( $p['color'] ?: '—' ); ?></code>
+                                                        &nbsp;|&nbsp;
+                                                        <strong><?php echo esc_html__( 'Size:', 'world-inspire-product-feed-for-google-shopping' ); ?></strong> <code><?php echo esc_html( $p['size'] ?: '—' ); ?></code>
+                                                        &nbsp;|&nbsp;
+                                                        <strong><?php echo esc_html__( 'Material:', 'world-inspire-product-feed-for-google-shopping' ); ?></strong> <code><?php echo esc_html( $p['material'] ?: '—' ); ?></code>
+                                                        &nbsp;|&nbsp;
+                                                        <strong><?php echo esc_html__( 'Pattern:', 'world-inspire-product-feed-for-google-shopping' ); ?></strong> <code><?php echo esc_html( $p['pattern'] ?: '—' ); ?></code>
+                                                </p>
+                                        </div>
+
+                                        <h4><?php echo esc_html__( 'Custom Labels Evaluation Audit (0–4)', 'world-inspire-product-feed-for-google-shopping' ); ?></h4>
+                                        <table class="widefat striped" style="margin-bottom: 20px;">
+                                                <thead>
+                                                        <tr>
+                                                                <th style="width: 16%;"><?php echo esc_html__( 'Slot', 'world-inspire-product-feed-for-google-shopping' ); ?></th>
+                                                                <th style="width: 18%;"><?php echo esc_html__( 'Rule Type', 'world-inspire-product-feed-for-google-shopping' ); ?></th>
+                                                                <th style="width: 26%;"><?php echo esc_html__( 'Evaluated Value', 'world-inspire-product-feed-for-google-shopping' ); ?></th>
+                                                                <th style="width: 40%;"><?php echo esc_html__( 'Matching Reason / Trace', 'world-inspire-product-feed-for-google-shopping' ); ?></th>
+                                                        </tr>
+                                                </thead>
+                                                <tbody>
+                                                        <?php foreach ( $audit_data['labels'] as $slot_key => $eval ) : ?>
+                                                                <tr>
+                                                                        <td><code><?php echo esc_html( $slot_key ); ?></code></td>
+                                                                        <td><?php echo esc_html( ucfirst( str_replace( '_', ' ', $eval['type'] ) ) ); ?></td>
+                                                                        <td>
+                                                                                <?php if ( ! empty( $eval['value'] ) ) : ?>
+                                                                                        <span style="font-weight: 600; color: #135e96; background: #e7f3fa; padding: 2px 8px; border-radius: 3px;">
+                                                                                                <?php echo esc_html( $eval['value'] ); ?>
+                                                                                        </span>
+                                                                                <?php else : ?>
+                                                                                        <span style="color: #888;"><em><?php echo esc_html__( 'Empty (Omitted from XML)', 'world-inspire-product-feed-for-google-shopping' ); ?></em></span>
+                                                                                <?php endif; ?>
+                                                                        </td>
+                                                                        <td><small><?php echo esc_html( $eval['reason'] ); ?></small></td>
+                                                                </tr>
+                                                        <?php endforeach; ?>
+                                                </tbody>
+                                        </table>
+
+                                        <h4><?php echo esc_html__( 'Generated XML <item> Snippet Preview', 'world-inspire-product-feed-for-google-shopping' ); ?></h4>
+                                        <pre style="background: #2b2b2b; color: #f8f8f2; padding: 15px; border-radius: 4px; overflow-x: auto; font-size: 12px; line-height: 1.5;"><code><?php echo esc_html( $audit_data['xml_snippet'] ); ?></code></pre>
+
+                                <?php elseif ( $audit_data && empty( $audit_data['found'] ) ) : ?>
+                                        <div class="notice notice-warning inline"><p><?php echo esc_html( $audit_data['error'] ); ?></p></div>
+                                <?php endif; ?>
+                        </div>
+
+                        <!-- Catalog Overview Sample Table -->
+                        <div class="card" style="max-width: 960px; margin-top: 20px; padding: 20px;">
+                                <h3><?php echo esc_html__( 'Catalog Sample Inspection (First 5 Items)', 'world-inspire-product-feed-for-google-shopping' ); ?></h3>
                                 <?php if ( ! empty( $sample_products ) ) : ?>
                                         <table class="widefat striped" style="margin-top: 15px;">
@@ -772 +1635 @@
                                                                 <th><?php echo esc_html__( 'Title', 'world-inspire-product-feed-for-google-shopping' ); ?></th>
                                                                 <th><?php echo esc_html__( 'Price', 'world-inspire-product-feed-for-google-shopping' ); ?></th>
-                                                                <th><?php echo esc_html__( 'Availability', 'world-inspire-product-feed-for-google-shopping' ); ?></th>
-                                                                <th><?php echo esc_html__( 'Detected Color', 'world-inspire-product-feed-for-google-shopping' ); ?></th>
-                                                                <th><?php echo esc_html__( 'Engine', 'world-inspire-product-feed-for-google-shopping' ); ?></th>
+                                                                <th><?php echo esc_html__( 'Group ID', 'world-inspire-product-feed-for-google-shopping' ); ?></th>
+                                                                <th><?php echo esc_html__( 'Color', 'world-inspire-product-feed-for-google-shopping' ); ?></th>
+                                                                <th><?php echo esc_html__( 'Size', 'world-inspire-product-feed-for-google-shopping' ); ?></th>
+                                                                <th><?php echo esc_html__( 'Material', 'world-inspire-product-feed-for-google-shopping' ); ?></th>
+                                                                <th><?php echo esc_html__( 'Custom Labels', 'world-inspire-product-feed-for-google-shopping' ); ?></th>
+                                                                <th><?php echo esc_html__( 'Action', 'world-inspire-product-feed-for-google-shopping' ); ?></th>
                                                         </tr>
                                                 </thead>
                                                 <tbody>
                                                         <?php foreach ( $sample_products as $p ) : ?>
+                                                                <?php
+                                                                $p_eval0 = wipf_evaluate_custom_label( 0, $p, $settings );
+                                                                $p_eval1 = wipf_evaluate_custom_label( 1, $p, $settings );
+                                                                $label_summary = array();
+                                                                if ( ! empty( $p_eval0['value'] ) ) {
+                                                                        $label_summary[] = 'L0: ' . $p_eval0['value'];
+                                                                }
+                                                                if ( ! empty( $p_eval1['value'] ) ) {
+                                                                        $label_summary[] = 'L1: ' . $p_eval1['value'];
+                                                                }
+                                                                ?>
                                                                 <tr>
                                                                         <td><code><?php echo esc_html( $p['id'] ); ?></code></td>
                                                                         <td><strong><?php echo esc_html( $p['title'] ); ?></strong></td>
                                                                         <td><?php echo esc_html( $p['price'] . ' ' . $p['currency'] ); ?></td>
-                                                                        <td><?php echo esc_html( $p['availability'] ); ?></td>
-                                                                        <td><?php echo esc_html( wipf_detect_color( $p['title'], $p['description'] ) ?: '—' ); ?></td>
-                                                                        <td><code><?php echo esc_html( $p['source'] ); ?></code></td>
+                                                                        <td><code><?php echo esc_html( $p['item_group_id'] ?: '—' ); ?></code></td>
+                                                                        <td><?php echo esc_html( $p['color'] ?: '—' ); ?></td>
+                                                                        <td><?php echo esc_html( $p['size'] ?: '—' ); ?></td>
+                                                                        <td><?php echo esc_html( $p['material'] ?: '—' ); ?></td>
+                                                                        <td><small><?php echo esc_html( ! empty( $label_summary ) ? implode( ' | ', $label_summary ) : '—' ); ?></small></td>
+                                                                        <td><a href="?page=wipf-settings&tab=diagnostic&inspect_id=<?php echo esc_attr( $p['id'] ); ?>" class="button button-small"><?php echo esc_html__( 'Inspect', 'world-inspire-product-feed-for-google-shopping' ); ?></a></td>
                                                                 </tr>
                                                         <?php endforeach; ?>

world-inspire-product-feed-for-google-shopping/trunk/readme.txt

@@ -5 +5 @@
 Tested up to: 7.1
 Requires PHP: 7.4
-Stable tag: 1.0.0
+Stable tag: 1.1.0
 License: GPLv2 or later
 License URI: https://www.gnu.org/licenses/gpl-2.0.html
@@ -21 +21 @@
 * **Multi-Engine eCommerce Compatibility**: Native auto-detection and data extraction for both **SureCart** (`sc_product`) and **WooCommerce** (`product`). Zero fatal errors if either or neither is active.
 * **Google Merchant Center Specification**: Built according to official Google RSS 2.0 standards with all essential namespace attributes: `<g:id>`, `<g:title>`, `<g:description>`, `<g:link>`, `<g:image_link>`, `<g:availability>`, `<g:price>`, `<g:brand>`, `<g:condition>`, `<g:identifier_exists>`, `<g:google_product_category>`, `<g:color>`, `<g:age_group>`, and `<g:gender>`.
+* **Custom Labels 0–4 for Google Ads / PMax**: Full support for `<g:custom_label_0>` through `<g:custom_label_4>` with rules for price tiers (< $25, $25-$50, $50-$100, $100+), inventory status, category mapping, clearance/promotion tag keywords, and custom post meta fields.
+* **Variant Grouping (`<g:item_group_id>`)**: Automatically expands WooCommerce variable products (`product_variation`) into individual variant items linked by parent `<g:item_group_id>`, enabling swatch selection in Google Shopping results.
+* **Variant Attribute Optimization**: Smart extraction for `<g:size>`, `<g:material>` (Gold, Silver, Leather, Cotton, Gemstones, etc.), and `<g:pattern>` (Solid, Striped, Floral, Beaded) directly from attributes or intelligent NLP heuristics.
 * **Multi-Country Shipping Generator**: Automatically embeds multi-destination `<g:shipping>` nodes (defaulting to 8 core global markets: US, CA, UK, JP, SG, HK, AE, MX with custom shipping service names and rates).
-* **Intelligent Color & Demographic Extraction**: Automatically maps jewelry, apparel, gemstone, and accessory titles/descriptions into recognized Google taxonomy colors (over 35 shades) and adult/unisex demographics.
+* **Live Diagnostics & Product Inspector Simulator**: Test and audit any product ID directly in WordPress Admin to verify extracted attributes, custom labels matching reasons, and preview raw `<item>` XML snippets.
 * **Automatic Pet Category Mapping**: Heuristically detects pet collars, harnesses, and animal accessories and maps them to `Animals & Pet Supplies > Pet Supplies > Pet Collars & Harnesses`.
 * **Trustmate Review Catalog Sync**: Dedicated `<products>` XML feed format ready for instant connection in your Trustmate merchant dashboard.
@@ -39 +42 @@
 
 = Does this plugin work with SureCart? =
-Yes! It has full native support for SureCart products, pricing, inventory statuses (`sc_inventory_status`), featured images, and product galleries.
+Yes! It has full native support for SureCart products, pricing, inventory statuses (`sc_inventory_status`), featured images, collections, tags, and product galleries.
 
 = Does this plugin work with WooCommerce? =
-Yes! It automatically detects WooCommerce installations and outputs compliant feeds from published WooCommerce products.
+Yes! It automatically detects WooCommerce installations and outputs compliant feeds from published WooCommerce products and product variations with `<g:item_group_id>`.
+
+= How do Custom Labels (0-4) work? =
+Navigate to **Settings > Product Feeds > Google Shopping Rules & Custom Labels**. You can configure rules for each slot: Price Range Tiers, Inventory Status, Product Category, Tag/Keyword Matching (e.g. `clearance:Clearance, sale:On Sale, bestseller:Best Seller`), or Custom Post Meta fields.
 
 = Why does this plugin use extension-free REST URLs? =
@@ -53 +59 @@
 
 1. Feed URLs & Health Dashboard: Dynamic REST API endpoints and real-time catalog status.
-2. Google Shopping Rules: Global fallback brand defaults, product taxonomies, and NLP color detection.
+2. Google Shopping Rules & Custom Labels: Global fallback brand defaults, product taxonomies, NLP color/size/material detection, and custom labels 0-4.
 3. Multi-Country Shipping: International destination targeting and custom shipping rates.
-4. Live Diagnostics: Catalog extraction verification and Google Merchant Center spec compliance audit.
+4. Live Diagnostics & Product Inspector: Catalog extraction audit, custom label rule matching traces, and raw XML simulator.
 
 == Changelog ==
+
+= 1.1.0 =
+* Added Google Shopping Custom Labels (custom_label_0 to custom_label_4) with configurable rules: Price Tiers, Inventory Status, Category Mapping, Promotional Tag Keywords, and Custom Post Meta.
+* Added WooCommerce variable product expansion with `<g:item_group_id>` linking parent and variant products.
+* Added smart attribute extraction for `<g:size>`, `<g:material>`, and `<g:pattern>` with jewelry/apparel heuristic engines.
+* Added Live Product Inspector & XML Simulator to Diagnostics tab with rule matching explanation traces.
+* Enforced Google Shopping 100-character maximum length limit and XML entity escaping on all custom labels.
+* Added 87 zero-dependency unit and mock E2E integration tests passing 100% green.
 
 = 1.0.0 =

world-inspire-product-feed-for-google-shopping/trunk/world-inspire-product-feed-for-google-shopping.php

@@ -3 +3 @@
  * Plugin Name: World Inspire Product Feed for Google Shopping
  * Plugin URI: https://wordpress.org/plugins/world-inspire-product-feed-for-google-shopping/
- * Description: High-performance real-time product feed generator for Google Shopping (Merchant Center) and Trustmate reviews sync from WooCommerce and SureCart. Features multi-country shipping, smart color and category detection, and anti-cache streaming architecture.
- * Version: 1.0.0
+ * Description: High-performance real-time product feed generator for Google Shopping (Merchant Center) and Trustmate reviews sync from WooCommerce and SureCart. Features multi-country shipping, smart color/size/material detection, custom labels (0-4), variant item_group_id grouping, and anti-cache streaming architecture.
+ * Version: 1.1.0
  * Author: World Inspire LLC, Vec
  * Author URI: https://worldinspirelab.com
@@ -18 +18 @@
 }
 
-define( 'WIPF_VERSION', '1.0.0' );
+define( 'WIPF_VERSION', '1.1.0' );
 define( 'WIPF_FILE', __FILE__ );
 define( 'WIPF_PATH', plugin_dir_path( __FILE__ ) );
@@ -31 +31 @@
 function wipf_get_default_settings() {
         return array(
-                'brand_name'             => get_bloginfo( 'name' ),
-                'default_category'       => 'Apparel & Accessories > Jewelry',
-                'default_age_group'      => 'adult',
-                'default_gender'         => 'unisex',
-                'default_condition'      => 'new',
-                'identifier_exists'      => 'no',
-                'auto_detect_color'      => 'yes',
-                'shipping_countries'     => 'US,CA,GB,JP,SG,HK,AE,MX',
-                'shipping_service_name'  => 'Standard Free Shipping',
-                'shipping_cost'          => '0.00',
-                'shipping_currency'      => 'USD',
-                'enable_google_feed'     => 'yes',
-                'enable_trustmate_feed'  => 'yes',
-                'items_per_feed'         => 500,
+                'brand_name'              => get_bloginfo( 'name' ),
+                'default_category'        => 'Apparel & Accessories > Jewelry',
+                'default_age_group'       => 'adult',
+                'default_gender'          => 'unisex',
+                'default_condition'       => 'new',
+                'identifier_exists'       => 'no',
+                'auto_detect_color'       => 'yes',
+                'auto_detect_material'    => 'yes',
+                'auto_detect_size'        => 'yes',
+                'auto_detect_pattern'     => 'yes',
+                'shipping_countries'      => 'US,CA,GB,JP,SG,HK,AE,MX',
+                'shipping_service_name'   => 'Standard Free Shipping',
+                'shipping_cost'           => '0.00',
+                'shipping_currency'       => 'USD',
+                'enable_google_feed'      => 'yes',
+                'enable_trustmate_feed'   => 'yes',
+                'items_per_feed'          => 500,
+                'enable_custom_labels'    => 'yes',
+                'custom_label_0_type'     => 'price_tier',
+                'custom_label_0_value'    => '25,50,100',
+                'custom_label_0_fallback' => 'Standard',
+                'custom_label_1_type'     => 'inventory',
+                'custom_label_1_value'    => '',
+                'custom_label_1_fallback' => 'Out of Stock',
+                'custom_label_2_type'     => 'category',
+                'custom_label_2_value'    => '',
+                'custom_label_2_fallback' => 'Jewelry',
+                'custom_label_3_type'     => 'tag_keywords',
+                'custom_label_3_value'    => 'clearance:Clearance, sale:On Sale, bestseller:Best Seller, new:New Arrival',
+                'custom_label_3_fallback' => 'Regular',
+                'custom_label_4_type'     => 'static',
+                'custom_label_4_value'    => 'World Inspire Catalog',
+                'custom_label_4_fallback' => '',
         );
 }
@@ -78 +97 @@
         // Priority compound phrases checked first
         $compounds = array(
-                'rose gold'  => 'Rose Gold',
-                'tiger eye'  => 'Brown',
+                'rose gold'    => 'Rose Gold',
+                'tiger eye'    => 'Brown',
                 'lapis lazuli' => 'Blue',
         );
@@ -154 +173 @@
 
 /**
+ * Intelligent material extraction heuristic.
+ *
+ * @param string $title Product title.
+ * @param string $desc  Product description.
+ * @return string Extracted material name or empty.
+ */
+function wipf_detect_material( $title, $desc = '' ) {
+        $text = strtolower( $title . ' ' . $desc );
+
+        // Priority compound phrases checked first
+        $compounds = array(
+                'sterling silver' => 'Sterling Silver',
+                '925 silver'      => 'Sterling Silver',
+                'rose gold'       => 'Rose Gold',
+                'white gold'      => 'White Gold',
+                'yellow gold'     => 'Yellow Gold',
+                '14k gold'        => '14K Gold',
+                '18k gold'        => '18K Gold',
+                '24k gold'        => '24K Gold',
+                'stainless steel' => 'Stainless Steel',
+                'genuine leather' => 'Leather',
+                'faux leather'    => 'Faux Leather',
+                'vegan leather'   => 'Faux Leather',
+                'rose quartz'     => 'Rose Quartz',
+                'lapis lazuli'    => 'Lapis Lazuli',
+                'cubic zirconia'  => 'Cubic Zirconia',
+        );
+
+        $detected = array();
+        foreach ( $compounds as $phrase => $mat_name ) {
+                if ( false !== strpos( $text, $phrase ) ) {
+                        if ( ! in_array( $mat_name, $detected, true ) ) {
+                                $detected[] = $mat_name;
+                        }
+                        $text = str_replace( $phrase, '', $text );
+                }
+        }
+
+        $single_map = array(
+                'gold'       => 'Gold',
+                'silver'     => 'Silver',
+                'platinum'   => 'Platinum',
+                'titanium'   => 'Titanium',
+                'brass'      => 'Brass',
+                'copper'     => 'Copper',
+                'bronze'     => 'Bronze',
+                'steel'      => 'Steel',
+                'diamond'    => 'Diamond',
+                'pearl'      => 'Pearl',
+                'amethyst'   => 'Amethyst',
+                'quartz'     => 'Quartz',
+                'emerald'    => 'Emerald',
+                'ruby'       => 'Ruby',
+                'sapphire'   => 'Sapphire',
+                'jade'       => 'Jade',
+                'turquoise'  => 'Turquoise',
+                'obsidian'   => 'Obsidian',
+                'onyx'       => 'Onyx',
+                'opal'       => 'Opal',
+                'moonstone'  => 'Moonstone',
+                'topaz'      => 'Topaz',
+                'garnet'     => 'Garnet',
+                'tourmaline' => 'Tourmaline',
+                'amber'      => 'Amber',
+                'carnelian'  => 'Carnelian',
+                'citrine'    => 'Citrine',
+                'crystal'    => 'Crystal',
+                'leather'    => 'Leather',
+                'silk'       => 'Silk',
+                'velvet'     => 'Velvet',
+                'cotton'     => 'Cotton',
+                'linen'      => 'Linen',
+                'wool'       => 'Wool',
+                'cashmere'   => 'Cashmere',
+                'satin'      => 'Satin',
+                'polyester'  => 'Polyester',
+                'canvas'     => 'Canvas',
+                'denim'      => 'Denim',
+                'ceramic'    => 'Ceramic',
+                'glass'      => 'Glass',
+                'wood'       => 'Wood',
+                'silicone'   => 'Silicone',
+                'resin'      => 'Resin',
+        );
+
+        foreach ( $single_map as $needle => $mat_name ) {
+                if ( preg_match( '/\b' . preg_quote( $needle, '/' ) . '\b/', $text ) ) {
+                        if ( ! in_array( $mat_name, $detected, true ) ) {
+                                $detected[] = $mat_name;
+                        }
+                }
+        }
+
+        if ( count( $detected ) > 2 ) {
+                return 'Mixed';
+        } elseif ( ! empty( $detected ) ) {
+                return implode( '/', $detected );
+        }
+
+        return '';
+}
+
+/**
+ * Intelligent pattern extraction heuristic.
+ *
+ * @param string $title Product title.
+ * @param string $desc  Product description.
+ * @return string Extracted pattern or empty.
+ */
+function wipf_detect_pattern( $title, $desc = '' ) {
+        $text = strtolower( $title . ' ' . $desc );
+
+        $patterns = array(
+                'polka dot'    => 'Polka Dot',
+                'polka dots'   => 'Polka Dot',
+                'animal print' => 'Animal Print',
+                'striped'      => 'Striped',
+                'stripes'      => 'Striped',
+                'stripe'       => 'Striped',
+                'floral'       => 'Floral',
+                'flower'       => 'Floral',
+                'geometric'    => 'Geometric',
+                'beaded'       => 'Beaded',
+                'braided'      => 'Braided',
+                'plaid'        => 'Plaid',
+                'checkered'    => 'Checkered',
+                'leopard'      => 'Animal Print',
+                'cheetah'      => 'Animal Print',
+                'zebra'        => 'Animal Print',
+                'camouflage'   => 'Camouflage',
+                'camo'         => 'Camouflage',
+                'marble'       => 'Marble',
+                'gradient'     => 'Gradient',
+                'solid'        => 'Solid',
+        );
+
+        foreach ( $patterns as $needle => $pat_name ) {
+                if ( preg_match( '/\b' . preg_quote( $needle, '/' ) . '\b/', $text ) ) {
+                        return $pat_name;
+                }
+        }
+
+        return '';
+}
+
+/**
+ * Intelligent size extraction heuristic.
+ *
+ * @param string $title Product title.
+ * @param string $desc  Product description.
+ * @return string Extracted size or empty.
+ */
+function wipf_detect_size( $title, $desc = '' ) {
+        $text = $title . ' ' . $desc;
+
+        // 1. One Size / OS
+        if ( preg_match( '/\b(one\s*size|osfm|osfa)\b/i', $text ) ) {
+                return 'One Size';
+        }
+
+        // 2. Ring or shoe sizes: "Size 7", "Size 7.5", "US 8"
+        if ( preg_match( '/\b(?:size|us|eu)\s*([0-9]+(?:\.[0-9]+)?)\b/i', $text, $matches ) ) {
+                return $matches[1];
+        }
+
+        // 3. Dimensional bead / diameter sizes: "8mm", "10mm", "12mm"
+        if ( preg_match( '/\b([0-9]+(?:\.[0-9]+)?\s*(?:mm|cm|in|inch|inches))\b/i', $text, $matches ) ) {
+                return trim( $matches[1] );
+        }
+
+        // 4. Apparel sizes: XS, S, M, L, XL, XXL, 2XL, 3XL
+        if ( preg_match( '/\b(XS|S|M|L|XL|XXL|2XL|3XL)\b/', $text, $matches ) ) {
+                return $matches[1];
+        }
+
+        return '';
+}
+
+/**
+ * Evaluates a Google Shopping custom label (0-4) according to configured rules.
+ *
+ * @param int   $slot    Custom label index (0 to 4).
+ * @param array $product Normalized product data.
+ * @param array $config  Plugin settings.
+ * @return array Array with keys 'value', 'reason', 'type'.
+ */
+function wipf_evaluate_custom_label( $slot, $product, $config ) {
+        $slot = absint( $slot );
+        if ( $slot < 0 || $slot > 4 ) {
+                return array( 'value' => '', 'reason' => 'Invalid slot', 'type' => 'disabled' );
+        }
+
+        $type     = ! empty( $config["custom_label_{$slot}_type"] ) ? $config["custom_label_{$slot}_type"] : 'disabled';
+        $rule_val = ! empty( $config["custom_label_{$slot}_value"] ) ? trim( $config["custom_label_{$slot}_value"] ) : '';
+        $fallback = ! empty( $config["custom_label_{$slot}_fallback"] ) ? trim( $config["custom_label_{$slot}_fallback"] ) : '';
+
+        $result = '';
+        $reason = '';
+
+        switch ( $type ) {
+                case 'disabled':
+                        return array(
+                                'value'  => '',
+                                'reason' => 'Slot disabled',
+                                'type'   => 'disabled',
+                        );
+
+                case 'static':
+                        $result = $rule_val;
+                        $reason = 'Static configured value: ' . $rule_val;
+                        break;
+
+                case 'price_tier':
+                        $price = isset( $product['price'] ) ? (float) $product['price'] : 0.0;
+                        $curr  = ! empty( $product['currency'] ) ? $product['currency'] : ( $config['shipping_currency'] ?? 'USD' );
+
+                        // Check custom thresholds e.g. "50" or "30,80" or "25,50,100"
+                        $thresholds = array( 25.0, 50.0, 100.0 );
+                        if ( ! empty( $rule_val ) ) {
+                                $parsed = array();
+                                $raw_parts = explode( ',', $rule_val );
+                                foreach ( $raw_parts as $rp ) {
+                                        $fv = (float) trim( $rp );
+                                        if ( $fv > 0 ) {
+                                                $parsed[] = $fv;
+                                        }
+                                }
+                                if ( ! empty( $parsed ) ) {
+                                        sort( $parsed );
+                                        $thresholds = array_values( array_unique( $parsed ) );
+                                }
+                        }
+
+                        $count = count( $thresholds );
+                        if ( $price < $thresholds[0] ) {
+                                $result = 'Under ' . (int) $thresholds[0];
+                                $reason = sprintf( 'Price %0.2f %s < %0.2f', $price, $curr, $thresholds[0] );
+                        } elseif ( $price >= $thresholds[ $count - 1 ] ) {
+                                $result = (int) $thresholds[ $count - 1 ] . ' and Above';
+                                $reason = sprintf( 'Price %0.2f %s >= %0.2f', $price, $curr, $thresholds[ $count - 1 ] );
+                        } else {
+                                for ( $ti = 0; $ti < $count - 1; $ti++ ) {
+                                        if ( $price >= $thresholds[ $ti ] && $price < $thresholds[ $ti + 1 ] ) {
+                                                $result = (int) $thresholds[ $ti ] . ' to ' . (int) $thresholds[ $ti + 1 ];
+                                                $reason = sprintf( 'Price %0.2f %s between %0.2f and %0.2f', $price, $curr, $thresholds[ $ti ], $thresholds[ $ti + 1 ] );
+                                                break;
+                                        }
+                                }
+                        }
+                        break;
+
+                case 'inventory':
+                        $status = ! empty( $product['availability'] ) ? $product['availability'] : 'in_stock';
+                        $in_label  = 'In Stock';
+                        $out_label = 'Out of Stock';
+                        if ( ! empty( $rule_val ) && false !== strpos( $rule_val, ':' ) ) {
+                                $pairs = explode( ',', $rule_val );
+                                foreach ( $pairs as $pair ) {
+                                        $p = array_map( 'trim', explode( ':', $pair, 2 ) );
+                                        if ( count( $p ) === 2 ) {
+                                                if ( 'in_stock' === $p[0] ) {
+                                                        $in_label = $p[1];
+                                                } elseif ( 'out_of_stock' === $p[0] ) {
+                                                        $out_label = $p[1];
+                                                }
+                                        }
+                                }
+                        }
+
+                        if ( 'out_of_stock' === $status ) {
+                                $result = $out_label;
+                                $reason = 'Inventory status is out_of_stock';
+                        } else {
+                                $result = $in_label;
+                                $reason = 'Inventory status is in_stock';
+                        }
+                        break;
+
+                case 'category':
+                        if ( ! empty( $product['categories'] ) && is_array( $product['categories'] ) ) {
+                                $result = reset( $product['categories'] );
+                                $reason = 'Derived from primary category: ' . $result;
+                        } elseif ( ! empty( $product['category'] ) ) {
+                                $result = $product['category'];
+                                $reason = 'Derived from product category: ' . $result;
+                        } else {
+                                $result = ! empty( $config['default_category'] ) ? $config['default_category'] : '';
+                                $reason = 'Fallback to default category';
+                        }
+                        break;
+
+                case 'tag_keywords':
+                        $tags_list = ! empty( $product['tags'] ) && is_array( $product['tags'] ) ? $product['tags'] : array();
+                        $text_to_search = strtolower( ( $product['title'] ?? '' ) . ' ' . implode( ' ', $tags_list ) );
+
+                        if ( ! empty( $rule_val ) ) {
+                                $pairs = explode( ',', $rule_val );
+                                foreach ( $pairs as $pair ) {
+                                        $parts = array_map( 'trim', explode( ':', $pair, 2 ) );
+                                        $keyword = strtolower( $parts[0] );
+                                        $label   = isset( $parts[1] ) && '' !== $parts[1] ? $parts[1] : ucwords( $parts[0] );
+
+                                        if ( '' !== $keyword && false !== strpos( $text_to_search, $keyword ) ) {
+                                                $result = $label;
+                                                $reason = "Matched keyword '{$keyword}' in title or tags";
+                                                break;
+                                        }
+                                }
+                        }
+
+                        if ( empty( $result ) ) {
+                                $reason = 'No matching tag or keyword found';
+                        }
+                        break;
+
+                case 'custom_meta':
+                        $meta_key = $rule_val;
+                        if ( ! empty( $meta_key ) && ! empty( $product['id'] ) && function_exists( 'get_post_meta' ) ) {
+                                $meta_val = get_post_meta( $product['id'], $meta_key, true );
+                                if ( empty( $meta_val ) && ! empty( $product['item_group_id'] ) ) {
+                                        $meta_val = get_post_meta( $product['item_group_id'], $meta_key, true );
+                                }
+                                if ( ! empty( $meta_val ) && is_scalar( $meta_val ) ) {
+                                        $result = (string) $meta_val;
+                                        $reason = "Retrieved from post meta '{$meta_key}'";
+                                } else {
+                                        $reason = "Post meta '{$meta_key}' is empty";
+                                }
+                        } else {
+                                $reason = 'Custom meta key not specified';
+                        }
+                        break;
+
+                default:
+                        $reason = 'Unknown rule type: ' . $type;
+                        break;
+        }
+
+        // Apply fallback if result is empty
+        if ( '' === $result && '' !== $fallback ) {
+                $result = $fallback;
+                $reason .= ' (Fallback applied: ' . $fallback . ')';
+        }
+
+        // Google Shopping max length for custom_label_0-4 is 100 characters
+        if ( '' !== $result ) {
+                $clean_result = sanitize_text_field( $result );
+                if ( function_exists( 'mb_strlen' ) ) {
+                        if ( mb_strlen( $clean_result, 'UTF-8' ) > 100 ) {
+                                $clean_result = mb_substr( $clean_result, 0, 100, 'UTF-8' );
+                        }
+                } else {
+                        $clean_result = substr( $clean_result, 0, 100 );
+                }
+                $result = $clean_result;
+        }
+
+        return array(
+                'value'  => $result,
+                'reason' => $reason,
+                'type'   => $type,
+        );
+}
+
+/**
  * Safe XML entity escaper.
  *
@@ -165 +549 @@
 /**
  * Fetches normalized product catalog from active e-commerce platforms.
- * Supports SureCart and WooCommerce seamlessly.
+ * Supports SureCart and WooCommerce seamlessly including product variations.
  *
  * @param int $limit Maximum number of products to return.
@@ -176 +560 @@
                 $limit = 500;
         }
+
+        $settings = wipf_get_settings();
 
         // 1. Check SureCart products (sc_product)
@@ -239 +625 @@
                                 }
 
+                                // Categories & Tags
+                                $categories = array();
+                                if ( function_exists( 'wp_get_post_terms' ) ) {
+                                        $sc_terms = wp_get_post_terms( $post_id, 'sc_collection', array( 'fields' => 'names' ) );
+                                        if ( is_array( $sc_terms ) ) {
+                                                $categories = $sc_terms;
+                                        }
+                                }
+
+                                $tags = array();
+                                if ( function_exists( 'wp_get_post_terms' ) ) {
+                                        $sc_tag_terms = wp_get_post_terms( $post_id, 'sc_tag', array( 'fields' => 'names' ) );
+                                        if ( is_array( $sc_tag_terms ) ) {
+                                                $tags = $sc_tag_terms;
+                                        }
+                                }
+
+                                // Variant attributes
+                                $parent_id = get_post_meta( $post_id, 'sc_parent_id', true );
+
+                                $sc_color = get_post_meta( $post_id, 'sc_color', true );
+                                if ( empty( $sc_color ) && 'yes' === ( $settings['auto_detect_color'] ?? 'yes' ) ) {
+                                        $sc_color = wipf_detect_color( $title, $content );
+                                }
+
+                                $sc_size = get_post_meta( $post_id, 'sc_size', true );
+                                if ( empty( $sc_size ) && 'yes' === ( $settings['auto_detect_size'] ?? 'yes' ) ) {
+                                        $sc_size = wipf_detect_size( $title, $content );
+                                }
+
+                                $sc_mat = get_post_meta( $post_id, 'sc_material', true );
+                                if ( empty( $sc_mat ) && 'yes' === ( $settings['auto_detect_material'] ?? 'yes' ) ) {
+                                        $sc_mat = wipf_detect_material( $title, $content );
+                                }
+
+                                $sc_pat = get_post_meta( $post_id, 'sc_pattern', true );
+                                if ( empty( $sc_pat ) && 'yes' === ( $settings['auto_detect_pattern'] ?? 'yes' ) ) {
+                                        $sc_pat = wipf_detect_pattern( $title, $content );
+                                }
+
                                 $products[] = array(
                                         'id'             => $post_id,
+                                        'item_group_id'  => ! empty( $parent_id ) ? (string) $parent_id : '',
                                         'title'          => $title,
                                         'description'    => $content,
@@ -250 +677 @@
                                         'availability'   => $inv_status,
                                         'source'         => 'surecart',
+                                        'color'          => $sc_color,
+                                        'size'           => $sc_size,
+                                        'material'       => $sc_mat,
+                                        'pattern'        => $sc_pat,
+                                        'categories'     => $categories,
+                                        'tags'           => $tags,
                                 );
+
+                                if ( count( $products ) >= $limit ) {
+                                        break;
+                                }
                         }
                         wp_reset_postdata();
@@ -257 +694 @@
 
         // 2. Check WooCommerce products (product)
-        if ( function_exists( 'wc_get_products' ) || post_type_exists( 'product' ) ) {
+        if ( ( function_exists( 'wc_get_products' ) || post_type_exists( 'product' ) ) && count( $products ) < $limit ) {
                 $wc_args = array(
                         'post_type'      => 'product',
                         'post_status'    => 'publish',
-                        'posts_per_page' => $limit,
+                        'posts_per_page' => $limit - count( $products ),
                         'orderby'        => 'ID',
                         'order'          => 'DESC',
@@ -284 +721 @@
                                 $inv_status = 'in_stock';
 
-                                if ( function_exists( 'wc_get_product' ) ) {
-                                        $wc_prod = wc_get_product( $post_id );
-                                        if ( $wc_prod ) {
-                                                $price = $wc_prod->get_price();
-                                                $inv_status = $wc_prod->is_in_stock() ? 'in_stock' : 'out_of_stock';
+                                // Categories & Tags
+                                $categories = array();
+                                if ( function_exists( 'wp_get_post_terms' ) ) {
+                                        $wc_terms = wp_get_post_terms( $post_id, 'product_cat', array( 'fields' => 'names' ) );
+                                        if ( is_array( $wc_terms ) ) {
+                                                $categories = $wc_terms;
                                         }
-                                } else {
-                                        $raw_price = get_post_meta( $post_id, '_price', true );
-                                        if ( is_numeric( $raw_price ) ) {
-                                                $price = (float) $raw_price;
+                                }
+
+                                $tags = array();
+                                if ( function_exists( 'wp_get_post_terms' ) ) {
+                                        $wc_tag_terms = wp_get_post_terms( $post_id, 'product_tag', array( 'fields' => 'names' ) );
+                                        if ( is_array( $wc_tag_terms ) ) {
+                                                $tags = $wc_tag_terms;
                                         }
                                 }
@@ -314 +755 @@
                                 }
 
+                                // Check WooCommerce Product object & Variable product handling
+                                $wc_prod = function_exists( 'wc_get_product' ) ? wc_get_product( $post_id ) : null;
+                                if ( $wc_prod ) {
+                                        // Variable products: expand into variations with item_group_id
+                                        if ( method_exists( $wc_prod, 'is_type' ) && $wc_prod->is_type( 'variable' ) ) {
+                                                $variation_ids = method_exists( $wc_prod, 'get_children' ) ? $wc_prod->get_children() : array();
+                                                if ( ! empty( $variation_ids ) ) {
+                                                        foreach ( $variation_ids as $var_id ) {
+                                                                $var_obj = wc_get_product( $var_id );
+                                                                if ( ! $var_obj ) {
+                                                                        continue;
+                                                                }
+
+                                                                $var_price = $var_obj->get_price();
+                                                                $var_inv   = $var_obj->is_in_stock() ? 'in_stock' : 'out_of_stock';
+                                                                $var_link  = $var_obj->get_permalink() ?: $permalink;
+
+                                                                $var_img_id = $var_obj->get_image_id();
+                                                                $var_image  = $var_img_id ? wp_get_attachment_url( $var_img_id ) : $image_url;
+
+                                                                // Variation attributes
+                                                                $var_color = $var_obj->get_attribute( 'pa_color' ) ?: $var_obj->get_attribute( 'color' );
+                                                                if ( empty( $var_color ) && 'yes' === ( $settings['auto_detect_color'] ?? 'yes' ) ) {
+                                                                        $var_color = wipf_detect_color( $var_obj->get_name() . ' ' . $title, $content );
+                                                                }
+
+                                                                $var_size = $var_obj->get_attribute( 'pa_size' ) ?: $var_obj->get_attribute( 'size' );
+                                                                if ( empty( $var_size ) && 'yes' === ( $settings['auto_detect_size'] ?? 'yes' ) ) {
+                                                                        $var_size = wipf_detect_size( $var_obj->get_name() . ' ' . $title, $content );
+                                                                }
+
+                                                                $var_mat = $var_obj->get_attribute( 'pa_material' ) ?: $var_obj->get_attribute( 'material' );
+                                                                if ( empty( $var_mat ) && 'yes' === ( $settings['auto_detect_material'] ?? 'yes' ) ) {
+                                                                        $var_mat = wipf_detect_material( $var_obj->get_name() . ' ' . $title, $content );
+                                                                }
+
+                                                                $var_pat = $var_obj->get_attribute( 'pa_pattern' ) ?: $var_obj->get_attribute( 'pattern' );
+                                                                if ( empty( $var_pat ) && 'yes' === ( $settings['auto_detect_pattern'] ?? 'yes' ) ) {
+                                                                        $var_pat = wipf_detect_pattern( $var_obj->get_name() . ' ' . $title, $content );
+                                                                }
+
+                                                                $products[] = array(
+                                                                        'id'             => $var_id,
+                                                                        'item_group_id'  => (string) $post_id,
+                                                                        'title'          => $var_obj->get_name() ?: $title,
+                                                                        'description'    => $content,
+                                                                        'permalink'      => $var_link,
+                                                                        'image_url'      => $var_image,
+                                                                        'gallery_images' => $gallery_images,
+                                                                        'price'          => number_format( (float) $var_price, 2, '.', '' ),
+                                                                        'currency'       => $currency,
+                                                                        'availability'   => $var_inv,
+                                                                        'source'         => 'woocommerce',
+                                                                        'color'          => $var_color,
+                                                                        'size'           => $var_size,
+                                                                        'material'       => $var_mat,
+                                                                        'pattern'        => $var_pat,
+                                                                        'categories'     => $categories,
+                                                                        'tags'           => $tags,
+                                                                );
+
+                                                                if ( count( $products ) >= $limit ) {
+                                                                        break 2;
+                                                                }
+                                                        }
+                                                        continue; // Variations added, skip parent product
+                                                }
+                                        }
+
+                                        // Simple product
+                                        $price = $wc_prod->get_price();
+                                        $inv_status = $wc_prod->is_in_stock() ? 'in_stock' : 'out_of_stock';
+                                } else {
+                                        $raw_price = get_post_meta( $post_id, '_price', true );
+                                        if ( is_numeric( $raw_price ) ) {
+                                                $price = (float) $raw_price;
+                                        }
+                                }
+
+                                // Simple product attributes
+                                $prod_color = '';
+                                $prod_size  = '';
+                                $prod_mat   = '';
+                                $prod_pat   = '';
+
+                                if ( $wc_prod && method_exists( $wc_prod, 'get_attribute' ) ) {
+                                        $prod_color = $wc_prod->get_attribute( 'pa_color' ) ?: $wc_prod->get_attribute( 'color' );
+                                        $prod_size  = $wc_prod->get_attribute( 'pa_size' ) ?: $wc_prod->get_attribute( 'size' );
+                                        $prod_mat   = $wc_prod->get_attribute( 'pa_material' ) ?: $wc_prod->get_attribute( 'material' );
+                                        $prod_pat   = $wc_prod->get_attribute( 'pa_pattern' ) ?: $wc_prod->get_attribute( 'pattern' );
+                                }
+
+                                if ( empty( $prod_color ) && 'yes' === ( $settings['auto_detect_color'] ?? 'yes' ) ) {
+                                        $prod_color = wipf_detect_color( $title, $content );
+                                }
+                                if ( empty( $prod_size ) && 'yes' === ( $settings['auto_detect_size'] ?? 'yes' ) ) {
+                                        $prod_size = wipf_detect_size( $title, $content );
+                                }
+                                if ( empty( $prod_mat ) && 'yes' === ( $settings['auto_detect_material'] ?? 'yes' ) ) {
+                                        $prod_mat = wipf_detect_material( $title, $content );
+                                }
+                                if ( empty( $prod_pat ) && 'yes' === ( $settings['auto_detect_pattern'] ?? 'yes' ) ) {
+                                        $prod_pat = wipf_detect_pattern( $title, $content );
+                                }
+
                                 $products[] = array(
                                         'id'             => $post_id,
+                                        'item_group_id'  => '',
                                         'title'          => $title,
                                         'description'    => $content,
@@ -325 +872 @@
                                         'availability'   => $inv_status,
                                         'source'         => 'woocommerce',
+                                        'color'          => $prod_color,
+                                        'size'           => $prod_size,
+                                        'material'       => $prod_mat,
+                                        'pattern'        => $prod_pat,
+                                        'categories'     => $categories,
+                                        'tags'           => $tags,
                                 );
+
+                                if ( count( $products ) >= $limit ) {
+                                        break;
+                                }
                         }
                         wp_reset_postdata();
@@ -353 +910 @@
         $ship_cost       = ! empty( $config['shipping_cost'] ) ? $config['shipping_cost'] : '0.00';
         $ship_curr       = ! empty( $config['shipping_currency'] ) ? $config['shipping_currency'] : 'USD';
+        $enable_labels   = ( 'no' !== ( $config['enable_custom_labels'] ?? 'yes' ) );
 
         $xml  = '<?xml version="1.0" encoding="UTF-8"?>' . "\n";
@@ -367 +925 @@
                 $price_val   = $item['price'];
                 $curr_val    = ! empty( $item['currency'] ) ? $item['currency'] : $ship_curr;
-                $item_color  = $auto_color ? wipf_detect_color( $title, $desc ) : '';
-
-                // Pet classification heuristic
+
+                // Color priority: item attribute > heuristic
+                $item_color  = ! empty( $item['color'] ) ? $item['color'] : ( $auto_color ? wipf_detect_color( $title, $desc ) : '' );
+
+                // Category classification heuristic
                 $category = $def_category;
+                if ( ! empty( $item['categories'] ) && is_array( $item['categories'] ) ) {
+                        $category = implode( ' > ', $item['categories'] );
+                }
                 if ( false !== stripos( $title, 'collar' ) || false !== stripos( $title, 'pet' ) || false !== stripos( $title, 'dog' ) || false !== stripos( $title, 'cat' ) ) {
                         $category = 'Animals & Pet Supplies > Pet Supplies > Pet Collars & Harnesses';
@@ -377 +940 @@
                 $xml .= "    <item>\n";
                 $xml .= '      <g:id>' . wipf_xml_escape( $item['id'] ) . "</g:id>\n";
+
+                // Variant item_group_id grouping
+                if ( ! empty( $item['item_group_id'] ) ) {
+                        $xml .= '      <g:item_group_id>' . wipf_xml_escape( $item['item_group_id'] ) . "</g:item_group_id>\n";
+                }
+
                 $xml .= '      <g:title>' . wipf_xml_escape( $title ) . "</g:title>\n";
                 $xml .= '      <g:description>' . wipf_xml_escape( $desc ) . "</g:description>\n";
@@ -400 +969 @@
                         $xml .= '      <g:color>' . wipf_xml_escape( $item_color ) . "</g:color>\n";
                 }
+                if ( ! empty( $item['size'] ) ) {
+                        $xml .= '      <g:size>' . wipf_xml_escape( $item['size'] ) . "</g:size>\n";
+                }
+                if ( ! empty( $item['material'] ) ) {
+                        $xml .= '      <g:material>' . wipf_xml_escape( $item['material'] ) . "</g:material>\n";
+                }
+                if ( ! empty( $item['pattern'] ) ) {
+                        $xml .= '      <g:pattern>' . wipf_xml_escape( $item['pattern'] ) . "</g:pattern>\n";
+                }
+
                 if ( ! empty( $def_age_group ) ) {
                         $xml .= '      <g:age_group>' . wipf_xml_escape( $def_age_group ) . "</g:age_group>\n";
@@ -405 +984 @@
                 if ( ! empty( $def_gender ) ) {
                         $xml .= '      <g:gender>' . wipf_xml_escape( $def_gender ) . "</g:gender>\n";
+                }
+
+                // Inject Custom Labels (custom_label_0 to custom_label_4)
+                if ( $enable_labels ) {
+                        for ( $slot = 0; $slot <= 4; $slot++ ) {
+                                $label_data = wipf_evaluate_custom_label( $slot, $item, $config );
+                                if ( ! empty( $label_data['value'] ) ) {
+                                        $xml .= '      <g:custom_label_' . $slot . '>' . wipf_xml_escape( $label_data['value'] ) . '</g:custom_label_' . $slot . ">\n";
+                                }
+                        }
                 }
 
@@ -463 +1052 @@
 
 /**
+ * Detailed diagnostic inspector for a specific product ID or product data array.
+ *
+ * @param int|array  $product Product ID or product array.
+ * @param array|null $config  Optional configuration override.
+ * @return array Diagnostic report.
+ */
+function wipf_diagnose_product( $product, $config = null ) {
+        if ( null === $config ) {
+                $config = wipf_get_settings();
+        }
+
+        $item = is_array( $product ) ? $product : null;
+        if ( null === $item && is_numeric( $product ) ) {
+                $limit = 200;
+                $all_prods = wipf_collect_products( $limit );
+                foreach ( $all_prods as $p ) {
+                        if ( (int) $p['id'] === (int) $product ) {
+                                $item = $p;
+                                break;
+                        }
+                }
+                if ( null === $item && function_exists( 'get_post' ) ) {
+                        $post = get_post( (int) $product );
+                        if ( $post && 'publish' === ( $post->post_status ?? '' ) ) {
+                                $title = get_the_title( $post );
+                                $content = wp_strip_all_tags( get_the_excerpt( $post ) ?: ( get_the_content( null, false, $post ) ?: $title ) );
+                                $raw_price = get_post_meta( $post->ID, '_price', true );
+                                $price = is_numeric( $raw_price ) ? (float) $raw_price : 0.0;
+                                $image = get_the_post_thumbnail_url( $post->ID, 'full' ) ?: '';
+
+                                $categories = function_exists( 'wp_get_post_terms' ) ? wp_get_post_terms( $post->ID, 'product_cat', array( 'fields' => 'names' ) ) : array();
+                                $tags = function_exists( 'wp_get_post_terms' ) ? wp_get_post_terms( $post->ID, 'product_tag', array( 'fields' => 'names' ) ) : array();
+
+                                $item = array(
+                                        'id'             => $post->ID,
+                                        'item_group_id'  => '',
+                                        'title'          => $title,
+                                        'description'    => $content,
+                                        'permalink'      => get_permalink( $post->ID ),
+                                        'image_url'      => $image,
+                                        'gallery_images' => array(),
+                                        'price'          => number_format( $price, 2, '.', '' ),
+                                        'currency'       => $config['shipping_currency'] ?? 'USD',
+                                        'availability'   => 'in_stock',
+                                        'source'         => $post->post_type,
+                                        'color'          => wipf_detect_color( $title, $content ),
+                                        'size'           => wipf_detect_size( $title, $content ),
+                                        'material'       => wipf_detect_material( $title, $content ),
+                                        'pattern'        => wipf_detect_pattern( $title, $content ),
+                                        'categories'     => is_array( $categories ) ? $categories : array(),
+                                        'tags'           => is_array( $tags ) ? $tags : array(),
+                                );
+                        }
+                }
+        }
+
+        if ( empty( $item ) ) {
+                return array(
+                        'found' => false,
+                        'error' => __( 'Product not found or not published in catalog.', 'world-inspire-product-feed-for-google-shopping' ),
+                );
+        }
+
+        $labels = array();
+        for ( $i = 0; $i <= 4; $i++ ) {
+                $labels[ "custom_label_{$i}" ] = wipf_evaluate_custom_label( $i, $item, $config );
+        }
+
+        // Generate XML snippet for just this item
+        $xml_doc = wipf_build_google_shopping_xml( array( $item ), $config );
+        $xml_snippet = '';
+        if ( preg_match( '/<item>.*?<\/item>/s', $xml_doc, $matches ) ) {
+                $xml_snippet = trim( $matches[0] );
+        }
+
+        return array(
+                'found'       => true,
+                'product'     => $item,
+                'labels'      => $labels,
+                'xml_snippet' => $xml_snippet,
+        );
+}
+
+/**
  * Streams XML document with anti-caching reverse-proxy protection.
  *
@@ -482 +1155 @@
 
 /**
- * Registers REST API endpoints for Google Shopping and Trustmate.
+ * Registers REST API endpoints for Google Shopping, Trustmate, and Status.
  */
 function wipf_register_rest_routes() {
@@ -525 +1198 @@
                                 return new WP_REST_Response(
                                         array(
-                                                'enabled'            => true,
-                                                'status'             => 'healthy',
-                                                'version'            => WIPF_VERSION,
-                                                'surecart_detected'  => post_type_exists( 'sc_product' ),
+                                                'enabled'              => true,
+                                                'status'               => 'healthy',
+                                                'version'              => WIPF_VERSION,
+                                                'surecart_detected'    => post_type_exists( 'sc_product' ),
                                                 'woocommerce_detected' => ( function_exists( 'wc_get_products' ) || post_type_exists( 'product' ) ),
-                                                'sample_count'       => count( $products ),
+                                                'sample_count'         => count( $products ),
+                                                'custom_labels_active' => ( 'no' !== ( wipf_get_settings()['enable_custom_labels'] ?? 'yes' ) ),
                                         ),
                                         200
@@ -573 +1247 @@
         $output['identifier_exists']     = ( 'yes' === ( $input['identifier_exists'] ?? 'no' ) ) ? 'yes' : 'no';
         $output['auto_detect_color']     = ( 'yes' === ( $input['auto_detect_color'] ?? 'yes' ) ) ? 'yes' : 'no';
+        $output['auto_detect_material']  = ( 'yes' === ( $input['auto_detect_material'] ?? 'yes' ) ) ? 'yes' : 'no';
+        $output['auto_detect_size']      = ( 'yes' === ( $input['auto_detect_size'] ?? 'yes' ) ) ? 'yes' : 'no';
+        $output['auto_detect_pattern']   = ( 'yes' === ( $input['auto_detect_pattern'] ?? 'yes' ) ) ? 'yes' : 'no';
         $output['shipping_countries']    = ! empty( $input['shipping_countries'] ) ? sanitize_text_field( $input['shipping_countries'] ) : $defaults['shipping_countries'];
         $output['shipping_service_name'] = ! empty( $input['shipping_service_name'] ) ? sanitize_text_field( $input['shipping_service_name'] ) : $defaults['shipping_service_name'];
@@ -580 +1257 @@
         $output['enable_trustmate_feed'] = ( 'yes' === ( $input['enable_trustmate_feed'] ?? 'yes' ) ) ? 'yes' : 'no';
         $output['items_per_feed']        = absint( $input['items_per_feed'] ?? 500 );
+
+        // Custom Labels (custom_label_0 to custom_label_4)
+        $output['enable_custom_labels']  = ( 'yes' === ( $input['enable_custom_labels'] ?? 'yes' ) ) ? 'yes' : 'no';
+        $valid_rule_types = array( 'disabled', 'static', 'price_tier', 'inventory', 'category', 'tag_keywords', 'custom_meta' );
+
+        for ( $i = 0; $i <= 4; $i++ ) {
+                $type_key     = "custom_label_{$i}_type";
+                $val_key      = "custom_label_{$i}_value";
+                $fallback_key = "custom_label_{$i}_fallback";
+
+                $type = isset( $input[ $type_key ] ) && in_array( $input[ $type_key ], $valid_rule_types, true ) ? sanitize_key( $input[ $type_key ] ) : 'disabled';
+                $val  = isset( $input[ $val_key ] ) ? sanitize_text_field( $input[ $val_key ] ) : '';
+                $fb   = isset( $input[ $fallback_key ] ) ? sanitize_text_field( $input[ $fallback_key ] ) : '';
+
+                $output[ $type_key ]     = $type;
+                $output[ $val_key ]      = $val;
+                $output[ $fallback_key ] = $fb;
+        }
 
         return $output;
@@ -614 +1309 @@
         ?>
         <div class="wrap">
-                <h1><?php echo esc_html__( 'World Inspire Product Feed for Google Shopping & Trustmate', 'world-inspire-product-feed-for-google-shopping' ); ?></h1>
+                <h1><?php echo esc_html__( 'World Inspire Product Feed for Google Shopping & Trustmate', 'world-inspire-product-feed-for-google-shopping' ); ?> <span style="font-size: 14px; background: #2271b1; color: #fff; padding: 2px 8px; border-radius: 4px; vertical-align: middle;">v<?php echo esc_html( WIPF_VERSION ); ?></span></h1>
                 <p class="description">
                         <?php echo esc_html__( 'Zero-configuration, high-performance real-time XML product feeds engineered for Google Merchant Center and Trustmate review synchronization.', 'world-inspire-product-feed-for-google-shopping' ); ?>
@@ -624 +1319 @@
                         </a>
                         <a href="?page=wipf-settings&tab=google" class="nav-tab <?php echo 'google' === $active_tab ? 'nav-tab-active' : ''; ?>">
-                                <?php echo esc_html__( 'Google Shopping Rules', 'world-inspire-product-feed-for-google-shopping' ); ?>
+                                <?php echo esc_html__( 'Google Shopping Rules & Custom Labels', 'world-inspire-product-feed-for-google-shopping' ); ?>
                         </a>
                         <a href="?page=wipf-settings&tab=shipping" class="nav-tab <?php echo 'shipping' === $active_tab ? 'nav-tab-active' : ''; ?>">
@@ -630 +1325 @@
                         </a>
                         <a href="?page=wipf-settings&tab=diagnostic" class="nav-tab <?php echo 'diagnostic' === $active_tab ? 'nav-tab-active' : ''; ?>">
-                                <?php echo esc_html__( 'Live Diagnostics & Preview', 'world-inspire-product-feed-for-google-shopping' ); ?>
+                                <?php echo esc_html__( 'Live Diagnostics & Inspector', 'world-inspire-product-feed-for-google-shopping' ); ?>
                         </a>
                 </h2>
 
                 <?php if ( 'endpoints' === $active_tab ) : ?>
-                        <div class="card" style="max-width: 900px; margin-top: 20px; padding: 20px;">
+                        <div class="card" style="max-width: 960px; margin-top: 20px; padding: 20px;">
                                 <h3><?php echo esc_html__( 'Authoritative Feed URLs', 'world-inspire-product-feed-for-google-shopping' ); ?></h3>
                                 <p><?php echo esc_html__( 'Copy these extension-free dynamic REST endpoints into Google Merchant Center and Trustmate. They automatically bypass reverse-proxy static file caches and update in real-time.', 'world-inspire-product-feed-for-google-shopping' ); ?></p>
@@ -664 +1359 @@
                         </div>
                 <?php elseif ( 'google' === $active_tab || 'shipping' === $active_tab ) : ?>
-                        <form method="post" action="options.php" style="max-width: 900px; margin-top: 20px;">
+                        <form method="post" action="options.php" style="max-width: 960px; margin-top: 20px;">
                                 <?php
                                 settings_fields( 'wipf_settings_group' );
                                 ?>
-                                <div class="card" style="padding: 20px;">
-                                        <?php if ( 'google' === $active_tab ) : ?>
+                                <?php if ( 'google' === $active_tab ) : ?>
+                                        <div class="card" style="padding: 20px; margin-bottom: 20px;">
                                                 <h3><?php echo esc_html__( 'Google Shopping Catalog Standards', 'world-inspire-product-feed-for-google-shopping' ); ?></h3>
                                                 <table class="form-table" role="presentation">
@@ -692 +1387 @@
                                                                                 <option value="kids" <?php selected( $settings['default_age_group'], 'kids' ); ?>><?php echo esc_html__( 'Kids', 'world-inspire-product-feed-for-google-shopping' ); ?></option>
                                                                                 <option value="toddler" <?php selected( $settings['default_age_group'], 'toddler' ); ?>><?php echo esc_html__( 'Toddler', 'world-inspire-product-feed-for-google-shopping' ); ?></option>
+                                                                                <option value="infant" <?php selected( $settings['default_age_group'], 'infant' ); ?>><?php echo esc_html__( 'Infant', 'world-inspire-product-feed-for-google-shopping' ); ?></option>
+                                                                                <option value="newborn" <?php selected( $settings['default_age_group'], 'newborn' ); ?>><?php echo esc_html__( 'Newborn', 'world-inspire-product-feed-for-google-shopping' ); ?></option>
                                                                         </select>
                                                                 </td>
@@ -705 +1402 @@
                                                                 </td>
                                                         </tr>
+                                                </table>
+                                        </div>
+
+                                        <div class="card" style="padding: 20px; margin-bottom: 20px;">
+                                                <h3><?php echo esc_html__( 'Variant & Attribute Optimization', 'world-inspire-product-feed-for-google-shopping' ); ?></h3>
+                                                <p class="description">
+                                                        <?php echo esc_html__( 'Extract and optimize essential Google Shopping attributes from WooCommerce and SureCart. WooCommerce variable products are automatically exported as individual items linked by <g:item_group_id>.', 'world-inspire-product-feed-for-google-shopping' ); ?>
+                                                </p>
+                                                <table class="form-table" role="presentation">
                                                         <tr>
-                                                                <th scope="row"><label for="wipf_auto_color"><?php echo esc_html__( 'Smart Color Extraction', 'world-inspire-product-feed-for-google-shopping' ); ?></label></th>
+                                                                <th scope="row"><?php echo esc_html__( 'Smart Attribute Detection', 'world-inspire-product-feed-for-google-shopping' ); ?></th>
                                                                 <td>
-                                                                        <label>
-                                                                                <input type="checkbox" id="wipf_auto_color" name="wipf_feed_settings[auto_detect_color]" value="yes" <?php checked( $settings['auto_detect_color'], 'yes' ); ?> />
-                                                                                <?php echo esc_html__( 'Automatically infer and populate Google standard colors from title and description', 'world-inspire-product-feed-for-google-shopping' ); ?>
+                                                                        <label style="display: block; margin-bottom: 8px;">
+                                                                                <input type="checkbox" name="wipf_feed_settings[auto_detect_color]" value="yes" <?php checked( $settings['auto_detect_color'], 'yes' ); ?> />
+                                                                                <strong><?php echo esc_html__( 'Color Extraction (<g:color>)', 'world-inspire-product-feed-for-google-shopping' ); ?></strong> — <?php echo esc_html__( 'Infer Google standard color names from attributes, titles, or descriptions (over 35 jewelry/apparel shades).', 'world-inspire-product-feed-for-google-shopping' ); ?>
+                                                                        </label>
+                                                                        <label style="display: block; margin-bottom: 8px;">
+                                                                                <input type="checkbox" name="wipf_feed_settings[auto_detect_material]" value="yes" <?php checked( $settings['auto_detect_material'] ?? 'yes', 'yes' ); ?> />
+                                                                                <strong><?php echo esc_html__( 'Material Extraction (<g:material>)', 'world-inspire-product-feed-for-google-shopping' ); ?></strong> — <?php echo esc_html__( 'Detect materials (Gold, Sterling Silver, Leather, Cotton, Gemstones, Titanium, Stainless Steel).', 'world-inspire-product-feed-for-google-shopping' ); ?>
+                                                                        </label>
+                                                                        <label style="display: block; margin-bottom: 8px;">
+                                                                                <input type="checkbox" name="wipf_feed_settings[auto_detect_size]" value="yes" <?php checked( $settings['auto_detect_size'] ?? 'yes', 'yes' ); ?> />
+                                                                                <strong><?php echo esc_html__( 'Size Extraction (<g:size>)', 'world-inspire-product-feed-for-google-shopping' ); ?></strong> — <?php echo esc_html__( 'Extract sizes from variation attributes or titles (e.g. Size 7, One Size, 8mm, S, M, L, XL).', 'world-inspire-product-feed-for-google-shopping' ); ?>
+                                                                        </label>
+                                                                        <label style="display: block; margin-bottom: 8px;">
+                                                                                <input type="checkbox" name="wipf_feed_settings[auto_detect_pattern]" value="yes" <?php checked( $settings['auto_detect_pattern'] ?? 'yes', 'yes' ); ?> />
+                                                                                <strong><?php echo esc_html__( 'Pattern Extraction (<g:pattern>)', 'world-inspire-product-feed-for-google-shopping' ); ?></strong> — <?php echo esc_html__( 'Detect patterns (Solid, Striped, Floral, Beaded, Polka Dot, Geometric).', 'world-inspire-product-feed-for-google-shopping' ); ?>
                                                                         </label>
                                                                 </td>
                                                         </tr>
                                                 </table>
-                                        <?php elseif ( 'shipping' === $active_tab ) : ?>
+                                        </div>
+
+                                        <div class="card" style="padding: 20px; margin-bottom: 20px;">
+                                                <h3><?php echo esc_html__( 'Google Shopping Custom Labels (0–4)', 'world-inspire-product-feed-for-google-shopping' ); ?></h3>
+                                                <p class="description">
+                                                        <?php echo esc_html__( 'Custom labels allow you to segment and filter products in Google Ads and Performance Max (PMax) campaigns (e.g. by price brackets, inventory status, product category, clearance tags, or margin tiers).', 'world-inspire-product-feed-for-google-shopping' ); ?>
+                                                </p>
+                                                <p>
+                                                        <label>
+                                                                <input type="checkbox" name="wipf_feed_settings[enable_custom_labels]" value="yes" <?php checked( $settings['enable_custom_labels'] ?? 'yes', 'yes' ); ?> />
+                                                                <strong><?php echo esc_html__( 'Enable Custom Labels in Feed', 'world-inspire-product-feed-for-google-shopping' ); ?></strong>
+                                                        </label>
+                                                </p>
+
+                                                <table class="widefat striped" style="margin-top: 15px;">
+                                                        <thead>
+                                                                <tr>
+                                                                        <th style="width: 16%;"><?php echo esc_html__( 'Custom Label Slot', 'world-inspire-product-feed-for-google-shopping' ); ?></th>
+                                                                        <th style="width: 22%;"><?php echo esc_html__( 'Rule Type', 'world-inspire-product-feed-for-google-shopping' ); ?></th>
+                                                                        <th style="width: 38%;"><?php echo esc_html__( 'Rule Value / Configuration', 'world-inspire-product-feed-for-google-shopping' ); ?></th>
+                                                                        <th style="width: 24%;"><?php echo esc_html__( 'Fallback Value', 'world-inspire-product-feed-for-google-shopping' ); ?></th>
+                                                                </tr>
+                                                        </thead>
+                                                        <tbody>
+                                                                <?php
+                                                                $label_recommendations = array(
+                                                                        0 => array( 'name' => 'Custom Label 0', 'rec' => 'Price Tiers (< 25, 25-50, 50-100, 100+)', 'ph_val' => '25,50,100 (Thresholds)', 'ph_fb' => 'Standard' ),
+                                                                        1 => array( 'name' => 'Custom Label 1', 'rec' => 'Inventory Status (In Stock / Out of Stock)', 'ph_val' => 'Optional override: in_stock:Available, out_of_stock:Unavailable', 'ph_fb' => 'Out of Stock' ),
+                                                                        2 => array( 'name' => 'Custom Label 2', 'rec' => 'Category / Collection Name', 'ph_val' => 'Leave empty to use primary category', 'ph_fb' => 'General' ),
+                                                                        3 => array( 'name' => 'Custom Label 3', 'rec' => 'Promotional / Tag Keywords Match', 'ph_val' => 'clearance:Clearance, sale:On Sale, bestseller:Best Seller', 'ph_fb' => 'Regular' ),
+                                                                        4 => array( 'name' => 'Custom Label 4', 'rec' => 'Static Value / Custom Post Meta Key', 'ph_val' => 'Enter static string or post_meta key', 'ph_fb' => '' ),
+                                                                );
+
+                                                                for ( $slot = 0; $slot <= 4; $slot++ ) :
+                                                                        $slot_type = $settings[ "custom_label_{$slot}_type" ] ?? 'disabled';
+                                                                        $slot_val  = $settings[ "custom_label_{$slot}_value" ] ?? '';
+                                                                        $slot_fb   = $settings[ "custom_label_{$slot}_fallback" ] ?? '';
+                                                                        $meta_info = $label_recommendations[ $slot ];
+                                                                        ?>
+                                                                        <tr>
+                                                                                <td>
+                                                                                        <strong><?php echo esc_html( $meta_info['name'] ); ?></strong>
+                                                                                        <br><span class="description" style="font-size: 11px;"><?php echo esc_html( $meta_info['rec'] ); ?></span>
+                                                                                </td>
+                                                                                <td>
+                                                                                        <select name="wipf_feed_settings[custom_label_<?php echo $slot; ?>_type]" style="width: 100%;">
+                                                                                                <option value="disabled" <?php selected( $slot_type, 'disabled' ); ?>><?php echo esc_html__( 'Disabled', 'world-inspire-product-feed-for-google-shopping' ); ?></option>
+                                                                                                <option value="price_tier" <?php selected( $slot_type, 'price_tier' ); ?>><?php echo esc_html__( 'Price Range Tier', 'world-inspire-product-feed-for-google-shopping' ); ?></option>
+                                                                                                <option value="inventory" <?php selected( $slot_type, 'inventory' ); ?>><?php echo esc_html__( 'Inventory Status', 'world-inspire-product-feed-for-google-shopping' ); ?></option>
+                                                                                                <option value="category" <?php selected( $slot_type, 'category' ); ?>><?php echo esc_html__( 'Product Category', 'world-inspire-product-feed-for-google-shopping' ); ?></option>
+                                                                                                <option value="tag_keywords" <?php selected( $slot_type, 'tag_keywords' ); ?>><?php echo esc_html__( 'Tag & Keyword Matcher', 'world-inspire-product-feed-for-google-shopping' ); ?></option>
+                                                                                                <option value="static" <?php selected( $slot_type, 'static' ); ?>><?php echo esc_html__( 'Static Custom String', 'world-inspire-product-feed-for-google-shopping' ); ?></option>
+                                                                                                <option value="custom_meta" <?php selected( $slot_type, 'custom_meta' ); ?>><?php echo esc_html__( 'Custom Post Meta Field', 'world-inspire-product-feed-for-google-shopping' ); ?></option>
+                                                                                        </select>
+                                                                                </td>
+                                                                                <td>
+                                                                                        <input type="text" name="wipf_feed_settings[custom_label_<?php echo $slot; ?>_value]" class="large-text" value="<?php echo esc_attr( $slot_val ); ?>" placeholder="<?php echo esc_attr( $meta_info['ph_val'] ); ?>" />
+                                                                                </td>
+                                                                                <td>
+                                                                                        <input type="text" name="wipf_feed_settings[custom_label_<?php echo $slot; ?>_fallback]" class="regular-text" value="<?php echo esc_attr( $slot_fb ); ?>" placeholder="<?php echo esc_attr( $meta_info['ph_fb'] ); ?>" />
+                                                                                </td>
+                                                                        </tr>
+                                                                <?php endfor; ?>
+                                                        </tbody>
+                                                </table>
+                                        </div>
+                                <?php elseif ( 'shipping' === $active_tab ) : ?>
+                                        <div class="card" style="padding: 20px;">
                                                 <h3><?php echo esc_html__( 'Multi-Country Shipping Generator', 'world-inspire-product-feed-for-google-shopping' ); ?></h3>
                                                 <p><?php echo esc_html__( 'Configures embedded shipping rules for international Google Shopping campaigns.', 'world-inspire-product-feed-for-google-shopping' ); ?></p>
@@ -741 +1526 @@
                                                         </tr>
                                                 </table>
-                                        <?php endif; ?>
-                                </div>
+                                        </div>
+                                <?php endif; ?>
                                 <?php submit_button(); ?>
                         </form>
                 <?php elseif ( 'diagnostic' === $active_tab ) : ?>
-                        <div class="card" style="max-width: 900px; margin-top: 20px; padding: 20px;">
-                                <h3><?php echo esc_html__( 'Live Feed Diagnostic Audit', 'world-inspire-product-feed-for-google-shopping' ); ?></h3>
-                                <?php
-                                $sample_products = wipf_collect_products( 5 );
-                                $surecart_ok     = post_type_exists( 'sc_product' );
-                                $woocommerce_ok  = ( function_exists( 'wc_get_products' ) || post_type_exists( 'product' ) );
-                                ?>
+                        <?php
+                        $surecart_ok     = post_type_exists( 'sc_product' );
+                        $woocommerce_ok  = ( function_exists( 'wc_get_products' ) || post_type_exists( 'product' ) );
+                        $sample_products = wipf_collect_products( 5 );
+
+                        $inspect_id = isset( $_GET['inspect_id'] ) ? absint( $_GET['inspect_id'] ) : ( ! empty( $sample_products[0]['id'] ) ? (int) $sample_products[0]['id'] : 0 );
+                        $audit_data = $inspect_id > 0 ? wipf_diagnose_product( $inspect_id, $settings ) : null;
+                        ?>
+                        <div class="card" style="max-width: 960px; margin-top: 20px; padding: 20px;">
+                                <h3><?php echo esc_html__( 'Live Feed Engine Status', 'world-inspire-product-feed-for-google-shopping' ); ?></h3>
                                 <p>
                                         <strong><?php echo esc_html__( 'SureCart Engine:', 'world-inspire-product-feed-for-google-shopping' ); ?></strong>
-                                        <?php echo $surecart_ok ? '<span style="color:green;">✔ ' . esc_html__( 'Detected', 'world-inspire-product-feed-for-google-shopping' ) . '</span>' : '<span style="color:#666;">' . esc_html__( 'Not Installed', 'world-inspire-product-feed-for-google-shopping' ) . '</span>'; ?>
+                                        <?php echo $surecart_ok ? '<span style="color:green; font-weight: bold;">✔ ' . esc_html__( 'Detected', 'world-inspire-product-feed-for-google-shopping' ) . '</span>' : '<span style="color:#666;">' . esc_html__( 'Not Installed', 'world-inspire-product-feed-for-google-shopping' ) . '</span>'; ?>
                                         &nbsp;|&nbsp;
                                         <strong><?php echo esc_html__( 'WooCommerce Engine:', 'world-inspire-product-feed-for-google-shopping' ); ?></strong>
-                                        <?php echo $woocommerce_ok ? '<span style="color:green;">✔ ' . esc_html__( 'Detected', 'world-inspire-product-feed-for-google-shopping' ) . '</span>' : '<span style="color:#666;">' . esc_html__( 'Not Installed', 'world-inspire-product-feed-for-google-shopping' ) . '</span>'; ?>
+                                        <?php echo $woocommerce_ok ? '<span style="color:green; font-weight: bold;">✔ ' . esc_html__( 'Detected', 'world-inspire-product-feed-for-google-shopping' ) . '</span>' : '<span style="color:#666;">' . esc_html__( 'Not Installed', 'world-inspire-product-feed-for-google-shopping' ) . '</span>'; ?>
+                                        &nbsp;|&nbsp;
+                                        <strong><?php echo esc_html__( 'Catalog Sample Available:', 'world-inspire-product-feed-for-google-shopping' ); ?></strong>
+                                        <code><?php echo esc_html( count( $sample_products ) ); ?></code>
                                 </p>
-                                <p>
-                                        <strong><?php echo esc_html__( 'Products Found in Catalog:', 'world-inspire-product-feed-for-google-shopping' ); ?></strong>
-                                        <?php echo esc_html( count( $sample_products ) ); ?> (<?php echo esc_html__( 'showing first 5', 'world-inspire-product-feed-for-google-shopping' ); ?>)
+                        </div>
+
+                        <!-- Product Inspector & XML Simulator -->
+                        <div class="card" style="max-width: 960px; margin-top: 20px; padding: 20px;">
+                                <h3><?php echo esc_html__( 'Product Inspector & Diagnostic Simulator', 'world-inspire-product-feed-for-google-shopping' ); ?></h3>
+                                <p class="description">
+                                        <?php echo esc_html__( 'Enter any Product ID to audit its exact extracted attributes, custom labels evaluation logic, and preview the generated Google Shopping <item> XML element.', 'world-inspire-product-feed-for-google-shopping' ); ?>
                                 </p>
 
+                                <form method="get" action="" style="margin: 15px 0 20px 0;">
+                                        <input type="hidden" name="page" value="wipf-settings" />
+                                        <input type="hidden" name="tab" value="diagnostic" />
+                                        <label for="inspect_id"><strong><?php echo esc_html__( 'Test Product ID:', 'world-inspire-product-feed-for-google-shopping' ); ?></strong></label>
+                                        <input type="number" id="inspect_id" name="inspect_id" value="<?php echo esc_attr( $inspect_id ? (string) $inspect_id : '' ); ?>" placeholder="e.g. 790" style="width: 140px; margin: 0 10px;" />
+                                        <button type="submit" class="button button-primary"><?php echo esc_html__( 'Inspect Product', 'world-inspire-product-feed-for-google-shopping' ); ?></button>
+                                </form>
+
+                                <?php if ( $audit_data && ! empty( $audit_data['found'] ) ) : ?>
+                                        <?php
+                                        $p = $audit_data['product'];
+                                        ?>
+                                        <div style="background: #f0f6fc; border-left: 4px solid #72aee6; padding: 12px 16px; margin-bottom: 20px;">
+                                                <h4 style="margin: 0 0 8px 0;"><?php echo esc_html( $p['title'] ); ?> <span style="font-weight: normal; font-size: 13px;">(ID: <code><?php echo esc_html( $p['id'] ); ?></code> &middot; <?php echo esc_html( $p['price'] . ' ' . $p['currency'] ); ?> &middot; <?php echo esc_html( $p['availability'] ); ?> &middot; Source: <code><?php echo esc_html( $p['source'] ); ?></code>)</span></h4>
+                                                <p style="margin: 0; font-size: 13px;">
+                                                        <strong><?php echo esc_html__( 'Variant Group ID:', 'world-inspire-product-feed-for-google-shopping' ); ?></strong> <?php echo ! empty( $p['item_group_id'] ) ? '<code>' . esc_html( $p['item_group_id'] ) . '</code>' : '<em>' . esc_html__( 'None (Simple Product)', 'world-inspire-product-feed-for-google-shopping' ) . '</em>'; ?>
+                                                        &nbsp;|&nbsp;
+                                                        <strong><?php echo esc_html__( 'Color:', 'world-inspire-product-feed-for-google-shopping' ); ?></strong> <code><?php echo esc_html( $p['color'] ?: '—' ); ?></code>
+                                                        &nbsp;|&nbsp;
+                                                        <strong><?php echo esc_html__( 'Size:', 'world-inspire-product-feed-for-google-shopping' ); ?></strong> <code><?php echo esc_html( $p['size'] ?: '—' ); ?></code>
+                                                        &nbsp;|&nbsp;
+                                                        <strong><?php echo esc_html__( 'Material:', 'world-inspire-product-feed-for-google-shopping' ); ?></strong> <code><?php echo esc_html( $p['material'] ?: '—' ); ?></code>
+                                                        &nbsp;|&nbsp;
+                                                        <strong><?php echo esc_html__( 'Pattern:', 'world-inspire-product-feed-for-google-shopping' ); ?></strong> <code><?php echo esc_html( $p['pattern'] ?: '—' ); ?></code>
+                                                </p>
+                                        </div>
+
+                                        <h4><?php echo esc_html__( 'Custom Labels Evaluation Audit (0–4)', 'world-inspire-product-feed-for-google-shopping' ); ?></h4>
+                                        <table class="widefat striped" style="margin-bottom: 20px;">
+                                                <thead>
+                                                        <tr>
+                                                                <th style="width: 16%;"><?php echo esc_html__( 'Slot', 'world-inspire-product-feed-for-google-shopping' ); ?></th>
+                                                                <th style="width: 18%;"><?php echo esc_html__( 'Rule Type', 'world-inspire-product-feed-for-google-shopping' ); ?></th>
+                                                                <th style="width: 26%;"><?php echo esc_html__( 'Evaluated Value', 'world-inspire-product-feed-for-google-shopping' ); ?></th>
+                                                                <th style="width: 40%;"><?php echo esc_html__( 'Matching Reason / Trace', 'world-inspire-product-feed-for-google-shopping' ); ?></th>
+                                                        </tr>
+                                                </thead>
+                                                <tbody>
+                                                        <?php foreach ( $audit_data['labels'] as $slot_key => $eval ) : ?>
+                                                                <tr>
+                                                                        <td><code><?php echo esc_html( $slot_key ); ?></code></td>
+                                                                        <td><?php echo esc_html( ucfirst( str_replace( '_', ' ', $eval['type'] ) ) ); ?></td>
+                                                                        <td>
+                                                                                <?php if ( ! empty( $eval['value'] ) ) : ?>
+                                                                                        <span style="font-weight: 600; color: #135e96; background: #e7f3fa; padding: 2px 8px; border-radius: 3px;">
+                                                                                                <?php echo esc_html( $eval['value'] ); ?>
+                                                                                        </span>
+                                                                                <?php else : ?>
+                                                                                        <span style="color: #888;"><em><?php echo esc_html__( 'Empty (Omitted from XML)', 'world-inspire-product-feed-for-google-shopping' ); ?></em></span>
+                                                                                <?php endif; ?>
+                                                                        </td>
+                                                                        <td><small><?php echo esc_html( $eval['reason'] ); ?></small></td>
+                                                                </tr>
+                                                        <?php endforeach; ?>
+                                                </tbody>
+                                        </table>
+
+                                        <h4><?php echo esc_html__( 'Generated XML <item> Snippet Preview', 'world-inspire-product-feed-for-google-shopping' ); ?></h4>
+                                        <pre style="background: #2b2b2b; color: #f8f8f2; padding: 15px; border-radius: 4px; overflow-x: auto; font-size: 12px; line-height: 1.5;"><code><?php echo esc_html( $audit_data['xml_snippet'] ); ?></code></pre>
+
+                                <?php elseif ( $audit_data && empty( $audit_data['found'] ) ) : ?>
+                                        <div class="notice notice-warning inline"><p><?php echo esc_html( $audit_data['error'] ); ?></p></div>
+                                <?php endif; ?>
+                        </div>
+
+                        <!-- Catalog Overview Sample Table -->
+                        <div class="card" style="max-width: 960px; margin-top: 20px; padding: 20px;">
+                                <h3><?php echo esc_html__( 'Catalog Sample Inspection (First 5 Items)', 'world-inspire-product-feed-for-google-shopping' ); ?></h3>
                                 <?php if ( ! empty( $sample_products ) ) : ?>
                                         <table class="widefat striped" style="margin-top: 15px;">
@@ -772 +1635 @@
                                                                 <th><?php echo esc_html__( 'Title', 'world-inspire-product-feed-for-google-shopping' ); ?></th>
                                                                 <th><?php echo esc_html__( 'Price', 'world-inspire-product-feed-for-google-shopping' ); ?></th>
-                                                                <th><?php echo esc_html__( 'Availability', 'world-inspire-product-feed-for-google-shopping' ); ?></th>
-                                                                <th><?php echo esc_html__( 'Detected Color', 'world-inspire-product-feed-for-google-shopping' ); ?></th>
-                                                                <th><?php echo esc_html__( 'Engine', 'world-inspire-product-feed-for-google-shopping' ); ?></th>
+                                                                <th><?php echo esc_html__( 'Group ID', 'world-inspire-product-feed-for-google-shopping' ); ?></th>
+                                                                <th><?php echo esc_html__( 'Color', 'world-inspire-product-feed-for-google-shopping' ); ?></th>
+                                                                <th><?php echo esc_html__( 'Size', 'world-inspire-product-feed-for-google-shopping' ); ?></th>
+                                                                <th><?php echo esc_html__( 'Material', 'world-inspire-product-feed-for-google-shopping' ); ?></th>
+                                                                <th><?php echo esc_html__( 'Custom Labels', 'world-inspire-product-feed-for-google-shopping' ); ?></th>
+                                                                <th><?php echo esc_html__( 'Action', 'world-inspire-product-feed-for-google-shopping' ); ?></th>
                                                         </tr>
                                                 </thead>
                                                 <tbody>
                                                         <?php foreach ( $sample_products as $p ) : ?>
+                                                                <?php
+                                                                $p_eval0 = wipf_evaluate_custom_label( 0, $p, $settings );
+                                                                $p_eval1 = wipf_evaluate_custom_label( 1, $p, $settings );
+                                                                $label_summary = array();
+                                                                if ( ! empty( $p_eval0['value'] ) ) {
+                                                                        $label_summary[] = 'L0: ' . $p_eval0['value'];
+                                                                }
+                                                                if ( ! empty( $p_eval1['value'] ) ) {
+                                                                        $label_summary[] = 'L1: ' . $p_eval1['value'];
+                                                                }
+                                                                ?>
                                                                 <tr>
                                                                         <td><code><?php echo esc_html( $p['id'] ); ?></code></td>
                                                                         <td><strong><?php echo esc_html( $p['title'] ); ?></strong></td>
                                                                         <td><?php echo esc_html( $p['price'] . ' ' . $p['currency'] ); ?></td>
-                                                                        <td><?php echo esc_html( $p['availability'] ); ?></td>
-                                                                        <td><?php echo esc_html( wipf_detect_color( $p['title'], $p['description'] ) ?: '—' ); ?></td>
-                                                                        <td><code><?php echo esc_html( $p['source'] ); ?></code></td>
+                                                                        <td><code><?php echo esc_html( $p['item_group_id'] ?: '—' ); ?></code></td>
+                                                                        <td><?php echo esc_html( $p['color'] ?: '—' ); ?></td>
+                                                                        <td><?php echo esc_html( $p['size'] ?: '—' ); ?></td>
+                                                                        <td><?php echo esc_html( $p['material'] ?: '—' ); ?></td>
+                                                                        <td><small><?php echo esc_html( ! empty( $label_summary ) ? implode( ' | ', $label_summary ) : '—' ); ?></small></td>
+                                                                        <td><a href="?page=wipf-settings&tab=diagnostic&inspect_id=<?php echo esc_attr( $p['id'] ); ?>" class="button button-small"><?php echo esc_html__( 'Inspect', 'world-inspire-product-feed-for-google-shopping' ); ?></a></td>
                                                                 </tr>
                                                         <?php endforeach; ?>