=== WPSSO Google Merchant Feed XML ===
Plugin Name: WPSSO Google Merchant Feed XML
Plugin Slug: wpsso-google-merchant-feed
Text Domain: wpsso-google-merchant-feed
Domain Path: /languages
License: GPLv3
License URI: https://www.gnu.org/licenses/gpl.txt
Assets URI: https://surniaulula.github.io/wpsso-google-merchant-feed/assets/
Tags: google shopping, merchant center, woocommerce, wpml, polylang
Contributors: jsmoriss
Requires Plugins: wpsso
Requires PHP: 7.4.33
Requires At Least: 5.9
Tested Up To: 6.8.2
WC Tested Up To: 10.1.2
Stable Tag: 9.14.0

Google Merchant product and inventory feed XML for WooCommerce and custom product pages, including multilingual support.

== Description ==

<!-- about -->

**Google Merchant product and inventory feed XML for WooCommerce and custom product pages, including multilingual support.**

**E-Commerce Plugin Optional:**

WooCommerce is suggested but not required - the WPSSO Google Merchant Feed XML add-on can also use product information from custom product pages.

**Complete WooCommerce Support:**

WooCommerce simple products, product variations, product attributes, product meta data, and custom fields are all fully supported.

<!-- /about -->

**Automatic Multilingual Support:**

The Google merchant product feed XMLs are automatically created in your site's language(s) from Polylang, qTranslate-XT, WPML, or the installed WordPress languages.

After activating the WPSSO Google Merchant Feed XML add-on, see the SSO &gt; Google Merchant settings page for your feed URLs.

**Google Merchant Feed XML Attributes:**

* Additional image link <code>&#91;additional_image_link&#93;</code>
* Adult oriented <code>&#91;adult&#93;</code>
* Age group <code>&#91;age_group&#93;</code>
* Availability <code>&#91;availability&#93;</code>
* Brand <code>&#91;brand&#93;</code>
* Condition <code>&#91;condition&#93;</code>
* Color <code>&#91;color&#93;</code>
* Description <code>&#91;description&#93;</code>
* Energy efficiency class <code>&#91;energy_efficiency_class&#93;</code>
* Gender <code>&#91;gender&#93;</code>
* Google product category <code>&#91;google_product_category&#93;</code>
* Google search index <code>&#91;canonical_link&#93;</code>
* GTIN <code>&#91;gtin&#93;</code> (inluding UPC, EAN, and ISBN)
* Image link <code>&#91;image_link&#93;</code>
* Item group ID <code>&#91;item_group_id&#93;</code>
* Link <code>&#91;link&#93;</code>
* Material <code>&#91;material&#93;</code>
* Maximum energy efficiency class <code>&#91;max_energy_efficiency_class&#93;</code>
* Minimum energy efficiency class <code>&#91;min_energy_efficiency_class&#93;</code>
* MPN <code>&#91;mpn&#93;</code>
* Pattern <code>&#91;pattern&#93;</code>
* Price <code>&#91;price&#93;</code>
* Product ID <code>&#91;id&#93;</code>
* Product length <code>&#91;product_length&#93;</code>
* Product height <code>&#91;product_height&#93;</code>
* Product type <code>&#91;product_type&#93;</code>
* Product weight <code>&#91;product_weight&#93;</code>
* Product width <code>&#91;product_width&#93;</code>
* Sale price <code>&#91;sale_price&#93;</code>
* Sale price effective date <code>&#91;sale_price_effective_date&#93;</code>
* Shipping <code>&#91;shipping&#93;</code>
	* Country <code>&#91;country&#93;</code>
	* Location group name <code>&#91;location_group_name&#93;</code>
	* Postal code <code>&#91;postal_code&#93;</code>
	* Price <code>&#91;price&#93;</code>
	* Region <code>&#91;region&#93;</code>
	* Service <code>&#91;service&#93;</code>
	* [WPSSO Schema Shipping Delivery Time for WooCommerce](https://wordpress.org/plugins/wpsso-wc-shipping-delivery-time/) add-on required for handling and transit times:
		* Maximum handling time <code>&#91;max_handling_time&#93;</code>
		* Minimum handling time <code>&#91;min_handling_time&#93;</code>
		* Maximum transit time <code>&#91;max_transit_time&#93;</code>
		* Minimum transit time <code>&#91;min_transit_time&#93;</code>
* Shipping length <code>&#91;shipping_length&#93;</code>
* Shipping height <code>&#91;shipping_height&#93;</code>
* Shipping weight <code>&#91;shipping_weight&#93;</code>
* Shipping width <code>&#91;shipping_width&#93;</code>
* Size <code>&#91;size&#93;</code>
* Size system <code>&#91;size_system&#93;</code>
* Size type <code>&#91;size_type&#93;</code>
* Title <code>&#91;title&#93;</code>

**Google Merchant Inventory XML Attributes:**

* GTIN <code>&#91;gtin&#93;</code>
* Merchant ID <code>&#91;target_customer_id&#93;</code>
* Price <code>&#91;price&#93;</code>
* Product ID <code>&#91;id&#93;</code>
* Quantity <code>&#91;quantity&#93;</code>
* Store code <code>&#91;store_code&#93;</code>
* Timestamp <code>&#91;timestamp&#93;</code>

<h3>WPSSO Core Required</h3>

WPSSO Google Merchant Feed XML is an add-on for the [WPSSO Core plugin](https://wordpress.org/plugins/wpsso/), which creates extensive and complete structured data to present your content at its best for social sites and search results – no matter how URLs are shared, reshared, messaged, posted, embedded, or crawled.

== Installation ==

<h3 class="top">Install and Uninstall</h3>

* [Install the WPSSO Google Merchant Feed XML add-on](https://wpsso.com/docs/plugins/wpsso-google-merchant-feed/installation/install-the-plugin/).
* [Uninstall the WPSSO Google Merchant Feed XML add-on](https://wpsso.com/docs/plugins/wpsso-google-merchant-feed/installation/uninstall-the-plugin/).

== Frequently Asked Questions ==

== Screenshots ==

01. The WPSSO GMF settings page shows a complete list of available XML feed URLs.

== Changelog ==

<h3 class="top">Version Numbering</h3>

Version components: `{major}.{minor}.{bugfix}[-{stage}.{level}]`

* {major} = Major structural code changes and/or incompatible API changes (ie. breaking changes).
* {minor} = New functionality was added or improved in a backwards-compatible manner.
* {bugfix} = Backwards-compatible bug fixes or small improvements.
* {stage}.{level} = Pre-production release: dev &lt; a (alpha) &lt; b (beta) &lt; rc (release candidate).

<h3>Standard Edition Repositories</h3>

* [GitHub](https://surniaulula.github.io/wpsso-google-merchant-feed/)
* [WordPress.org](https://plugins.trac.wordpress.org/browser/wpsso-google-merchant-feed/)

<h3>Development Version Updates</h3>

<p><strong>WPSSO Core Premium edition customers have access to development, alpha, beta, and release candidate version updates:</strong></p>

<p>Under the SSO &gt; Update Manager settings page, select the "Development and Up" (for example) version filter for the WPSSO Core plugin and/or its add-ons. When new development versions are available, they will automatically appear under your WordPress Dashboard &gt; Updates page. You can reselect the "Stable / Production" version filter at any time to reinstall the latest stable version.</p>

<p><strong>WPSSO Core Standard edition users (ie. the plugin hosted on WordPress.org) have access to <a href="https://wordpress.org/plugins/wpsso-google-merchant-feed/advanced/">the latest development version under the Advanced Options section</a>.</strong></p>

<h3>Changelog / Release Notes</h3>

**Version 9.14.0 (2025/08/03)**

* **New Features**
	* None.
* **Improvements**
	* Added information about the WPSSOGMF_ADMIN_FEED_XML_STATS constant the SSO &gt; Google Merchant settings page.
* **Bugfixes**
	* None.
* **Developer Notes**
	* None.
* **Requires At Least**
	* PHP v7.4.33.
	* WordPress v5.9.
	* WPSSO Core v21.4.1.

**Version 9.13.0 (2025/06/22)**

* **New Features**
	* None.
* **Improvements**
	* Added information about product inclusion criteria in the SSO &gt; Google Merchant settings page.
* **Bugfixes**
	* None.
* **Developer Notes**
	* None.
* **Requires At Least**
	* PHP v7.4.33.
	* WordPress v5.9.
	* WPSSO Core v21.0.0.

**Version 9.12.0 (2025/04/09)**

* **New Features**
	* None.
* **Improvements**
	* None.
* **Bugfixes**
	* None.
* **Developer Notes**
	* Added a new `WPSSOGMF_ADMIN_FEED_XML_STATS` constant (false by default).
	* Removed the `WPSSOGMF_XML_INFO_DISABLE` constant.
* **Requires At Least**
	* PHP v7.4.33.
	* WordPress v5.9.
	* WPSSO Core v18.20.0.

**Version 9.11.0 (2024/12/11)**

* **New Features**
	* None.
* **Improvements**
	* None.
* **Bugfixes**
	* None.
* **Developer Notes**
	* Updated vendor/sabre/uri v2.3.4 to v3.0.2.
	* Updated vendor/sabre/xml v2.2.11 to v4.0.6.
* **Requires At Least**
	* PHP v7.4.33.
	* WordPress v5.9.
	* WPSSO Core v18.18.2.

**Version 9.10.0 (2024/12/01)**

* **New Features**
	* None.
* **Improvements**
	* Added a check for the required PHP XMLReader and XMLWriter extensions.
* **Bugfixes**
	* None.
* **Developer Notes**
	* Updated vendor/sabre/uri v2.3.3 to v2.3.4.
	* Updated vendor/sabre/xml v2.2.6 to v2.2.11.
* **Requires At Least**
	* PHP v7.4.33.
	* WordPress v5.9.
	* WPSSO Core v18.18.2.

**Version 9.9.0 (2024/11/06)**

* **New Features**
	* None.
* **Improvements**
	* None.
* **Bugfixes**
	* None.
* **Developer Notes**
	* Added support for a new `WPSSOGMF_CACHE_REFRESH_MAX_TIME` constant.
* **Requires At Least**
	* PHP v7.4.33.
	* WordPress v5.9.
	* WPSSO Core v18.17.0.

**Version 9.8.0 (2024/11/01)**

* **New Features**
	* None.
* **Improvements**
	* Added progress information to the notification message when refreshing the cache.
* **Bugfixes**
	* Fixed missing image size option under the SSO &gt; Advanced &gt; Plugin Settings metabox &gt; Image Sizes tab.
* **Developer Notes**
	* Added a new 'wpsso_gmf_add_shipping' filter.
	* Added a new `WPSSOGMF_XML_INFO_DISABLE` constant.
	* Moved the cache clearing process from 'wpsso_refresh_post_cache' to 'wpsso_clear_post_cache'.
	* Updated `WpssoGmfXml::cache_refreshed_notice()` to save progress information for each locale processed.
* **Requires At Least**
	* PHP v7.4.33.
	* WordPress v5.9.
	* WPSSO Core v18.16.0.

**Version 9.7.0 (2024/08/25)**

* **New Features**
	* None.
* **Improvements**
	* None.
* **Bugfixes**
	* None.
* **Developer Notes**
	* Changed the main instantiation action hook from 'init_objects' to 'init_objects_preloader'.
* **Requires At Least**
	* PHP v7.4.33.
	* WordPress v5.9.
	* WPSSO Core v18.10.0.

== Upgrade Notice ==

= 9.14.0 =

(2025/08/03) Added information about the WPSSOGMF_ADMIN_FEED_XML_STATS constant the SSO &gt; Google Merchant settings page.

= 9.13.0 =

(2025/06/22) Added information about product inclusion criteria in the SSO &gt; Google Merchant settings page.

= 9.12.0 =

(2025/04/09) Added a new `WPSSOGMF_ADMIN_FEED_XML_STATS` constant (false by default).

= 9.11.0 =

(2024/12/11) Updated vendor/sabre/uri and vendor/sabre/xml.

= 9.10.0 =

(2024/12/01) Added a check for the required PHP XMLReader and XMLWriter extensions.

= 9.9.0 =

(2024/11/06) Added support for a new `WPSSOGMF_CACHE_REFRESH_MAX_TIME` constant.

= 9.8.0 =

(2024/11/01) Added progress information to the notification message when refreshing the cache.

= 9.7.0 =

(2024/08/25) Changed the main instantiation action hook from 'init_objects' to 'init_objects_preloader'.

