=== WPSSO Core - The Complete Structured Data Plugin ===
Plugin Name: WPSSO Core
Plugin Slug: wpsso
Text Domain: wpsso
Domain Path: /languages
License: GPLv3
License URI: https://www.gnu.org/licenses/gpl.txt
Assets URI: https://surniaulula.github.io/wpsso/assets/
Tags: schema, seo, woocommerce, meta tags, google search console, google merchant, open graph, rich results, knowledge graph, xml sitemap, structured data
Contributors: jsmoriss
Requires PHP: 7.2
Requires At Least: 5.4
Tested Up To: 6.1.1
WC Tested Up To: 7.3.0
Stable Tag: 15.1.1

Present your content at its best on social sites and in search results - no matter how URLs are shared, reshared, messaged, posted, embedded, or crawled.

== Description ==

<h3 class="top">The Complete Structured Data Plugin for WordPress</h3>

<p><strong>Present your content at its best on social sites and in search results - no matter how URLs are shared, reshared, messaged, posted, embedded, or crawled.</strong></p>

<!-- about -->

<p><strong>Provides structured data markup for:</strong></p>

<ul>
	<li>Facebook / Open Graph</li>
	<li>Google Knowledge Graph</li>
	<li>Google Merchant Feed XML</li>
	<li>Google Rich Results / Rich Snippets</li>
	<li>Image and Video SEO</li>
	<li>Mobile Web Browsers</li>
	<li>oEmbed for LinkedIn, Discord, and Drupal</li>
	<li>Pinterest Rich Pins</li>
	<li>Twitter Cards</li>
	<li>Schema JSON-LD Markup</li>
	<li>Slack</li>
	<li>WhatsApp and Messaging Apps</li>
	<li>WordPress REST API</li>
	<li>WordPress Sitemaps XML</li>
</ul>

<!-- /about -->

<p><strong>Optimized image sizes for social sites and search engines:</strong></p>

* Google Merchant Feed XML
* Open Graph (Facebook and oEmbed)
* Pinterest Pin It
* Schema 1:1 (Google Rich Results)
* Schema 4:3 (Google Rich Results)
* Schema 16:9 (Google Rich Results)
* Schema Thumbnail
* Twitter Summary Card
* Twitter Summary Card Large Image
* Video Preview Images

<p><strong>Supports over 500 different Schema types and sub-types.</strong></p>

<p><strong>Fixes All Google Search / Rich Results / Merchant Listings and Schema Markup Validator errors:</strong></p>

* *A value for the headline field is required*
* *A value for the image field is required*
* *A value for the logo field is required*
* *A value for the publisher field is required*
* *Invalid value in field "priceSpecification"*
* *The aggregateRating field is recommended*
* *The brand field is recommended*
* *The headline field is recommended*
* *The image field is recommended*
* *The review field is recommended*
* *Missing field "image"*
* *Missing field "address"*
* *Missing field "telephone"*
* *Missing field "priceRange"*
* *Missing field "brand"*
* *Missing field "aggregateRating"*
* *Missing field "review"*
* *No global identifier provided (e.g. gtin mpn isbn)*
* *Not a known valid target type for the itemReviewed property*
* And many more...

<p><strong>Reads settings and data from active plugins, including:</strong></p>

* All in One SEO Pack
* Co-Authors Plus
* Easy Digital Downloads
* Elementor Website Builder
* Gravity Forms + GravityView
* Perfect Images
* Perfect WooCommerce Brands
* Polylang
* Product GTIN (EAN, UPC, ISBN) for WooCommerce
* Rank Math SEO
* Rate my Post
* SEOPress
* Simple Job Board
* The Events Calendar
* The SEO Framework
* Ultimate Member
* WooCommerce
* WooCommerce Brands
* WooCommerce Currency Switcher
* WooCommerce UPC, EAN, and ISBN
* WooCommerce Show Single Variations
* WP Job Manager
* WP Meta SEO
* WP-PostRatings
* WP Product Review
* WP Recipe Maker
* WPML
* YITH WooCommerce Brands Add-on
* Yoast SEO
* Yotpo Social Reviews for WooCommerce

<h3>Users Love the WPSSO Core Plugin</h3>

&#x2605;&#x2605;&#x2605;&#x2605;&#x2605; - "Unlike competitors, you can literally customize just about every aspect of SEO and Social SEO if you desire to. &#91;...&#93; This plugin has the most complete JSON-LD markup out of any of them, so you won’t have any errors and warnings in search console for WordPress or WooCommerce sites. You can go crazy customizing everything, or you can just set and forget. There aren’t many plugins that allow the best of both worlds." - [kw11](https://wordpress.org/support/topic/most-responsive-developer-ive-ever-seen/)

&#x2605;&#x2605;&#x2605;&#x2605;&#x2605; - "This plugin makes getting sites structured data ready extremely easy, and it works flawlessly without any issues. It shows messages on the top bar every step of the way to alert you of any issues until everything is set up correctly. It made all my ecommerce products pass Google's validation tests. Great work." - [marguy1](https://wordpress.org/support/topic/excellent-plugin-6825/)

&#x2605;&#x2605;&#x2605;&#x2605;&#x2605; - "This plugin saves me so much time, and it has really lifted my SERP rankings. Most of my keywords I now rank 1-3 position. I also noticed after about a week that my impressions have gone up at least 75%. I upgraded to the pro version which gave me even more options." - [playnstocks](https://wordpress.org/support/topic/excellent-plugin-and-support-200/)

<h3>Premium Edition Features</h3>

**Reads data from remote service APIs, including:**

* Get Bitly Short URL
* Get DLMY.App Short URL
* Get Facebook Video Data
* Get Gravatar Image Data
* Get Ow.ly Short URL
* Get Shopper Approved Review Data
* Get Slideshare Presentation Data
* Get Soundcloud Track Data
* Get Stamped.io Review Data
* Get TinyURL Short URL
* Get Vimeo Video Data
* Get Wistia Video Data
* Get WordPress Video Data
* Get Your Own URL Shortener (YOURLS) Short URL
* Get YouTube Video and Playlist Data

**Additional customization options in the SSO &gt; Advanced Settings page and Document SSO metabox.**

== Installation ==

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

* [Install the WPSSO Core Plugin](https://wpsso.com/docs/plugins/wpsso/installation/install-the-plugin/)
* [Uninstall the WPSSO Core Plugin](https://wpsso.com/docs/plugins/wpsso/installation/uninstall-the-plugin/)

<h3>Plugin Setup</h3>

* [Setup Guide](https://wpsso.com/docs/plugins/wpsso/installation/setup-guide/)
* [Developer Special: Buy one, Get one Free](https://wpsso.com/docs/plugins/wpsso/installation/developer-special-buy-one-get-one-free/)
* [Better Schema Markup for WooCommerce](https://wpsso.com/docs/plugins/wpsso/installation/better-schema-for-woocommerce/)
* [Troubleshooting Guide](https://wpsso.com/docs/plugins/wpsso/installation/troubleshooting-guide/)

== Frequently Asked Questions ==

<h3 class="top">Frequently Asked Questions</h3>

* [Does LinkedIn read Facebook / Open Graph meta tags?](https://wpsso.com/docs/plugins/wpsso/faqs/does-linkedin-read-the-open-graph-meta-tags/)
* [How can I fix a ERR_TOO_MANY_REDIRECTS error?](https://wpsso.com/docs/plugins/wpsso/faqs/how-can-i-fix-a-err_too_many_redirects-error/)
* [How can I fix a generic HTTP 500 error?](https://wpsso.com/docs/plugins/wpsso/faqs/how-can-i-fix-a-generic-http-500-error/)
* [How can I fix a PHP fatal "out of memory" error?](https://wpsso.com/docs/plugins/wpsso/faqs/how-can-i-fix-a-php-fatal-out-of-memory-error/)
* [How can I fix an HTTP error when uploading images?](https://wpsso.com/docs/plugins/wpsso/faqs/how-can-i-fix-an-http-error-when-uploading-images/)
* [How can I have smaller dimensions for the default image?](https://wpsso.com/docs/plugins/wpsso/faqs/how-can-i-have-smaller-dimensions-for-the-default-image/)
* [How can I see what the Facebook crawler sees?](https://wpsso.com/docs/plugins/wpsso/faqs/how-can-i-see-what-the-facebook-crawler-sees/)
* [How do I create a Schema FAQPage?](https://wpsso.com/docs/plugins/wpsso/faqs/how-do-i-create-a-schema-faqpage/)
* [How do I enable WordPress WP_DEBUG?](https://wpsso.com/docs/plugins/wpsso/faqs/how-do-i-enable-wordpress-wp_debug/)
* [How do I fix Google Structured Data &gt; hatom errors?](https://wpsso.com/docs/plugins/wpsso/faqs/how-do-i-fix-google-structured-data-hatom-errors/)
* [How do I remove duplicate meta tags?](https://wpsso.com/docs/plugins/wpsso/faqs/how-do-i-remove-duplicate-meta-tags/)
* [How does WPSSO Core find and select images?](https://wpsso.com/docs/plugins/wpsso/faqs/how-does-wpsso-find-detect-select-images/)
* [How does WPSSO Core find and select videos?](https://wpsso.com/docs/plugins/wpsso/faqs/how-does-wpsso-find-detect-select-videos/)
* [W3C says "there is no attribute 'property'"](https://wpsso.com/docs/plugins/wpsso/faqs/w3c-says-there-is-no-attribute-property/)
* [Why are some HTML elements missing or misaligned?](https://wpsso.com/docs/plugins/wpsso/faqs/why-are-some-html-elements-missing-misaligned-different/)
* [Why does Facebook show the wrong image / text?](https://wpsso.com/docs/plugins/wpsso/faqs/why-does-facebook-show-the-wrong-image-text/)
* [Why does the Schema Markup Validator show errors?](https://wpsso.com/docs/plugins/wpsso/faqs/why-does-google-structured-data-testing-tool-show-errors/)
* [Why shouldn't I upload small images to the media library?](https://wpsso.com/docs/plugins/wpsso/faqs/why-shouldnt-i-upload-small-images-to-the-media-library/)

<h3>Notes and Documentation</h3>

* [Developer Resources](https://wpsso.com/docs/plugins/wpsso/notes/developer/)
	* [Actions](https://wpsso.com/docs/plugins/wpsso/notes/developer/actions/)
	* [Constants](https://wpsso.com/docs/plugins/wpsso/notes/developer/constants/)
	* [Filters](https://wpsso.com/docs/plugins/wpsso/notes/developer/filters/)
		* [Filter Examples](https://wpsso.com/docs/plugins/wpsso/notes/developer/filters/examples/)
			* [A Custom Field Value for a Schema Property](https://wpsso.com/docs/plugins/wpsso-schema-json-ld/notes/developer/filters/examples/a-custom-field-value-for-a-schema-property/)
			* [Detect YouTube URL Links as Videos](https://wpsso.com/docs/plugins/wpsso/notes/developer/filters/examples/detect-youtube-url-links-as-videos/)
			* [Exclude Schema Markup by Post Type](https://wpsso.com/docs/plugins/wpsso/notes/developer/filters/examples/exclude-schema-markup-by-post-type/)
			* [Fix 'hentry' Errors in your Theme Templates](https://wpsso.com/docs/plugins/wpsso/notes/developer/filters/examples/fix-hentry-errors-in-your-theme-templates/)
			* [Modify the aggregateRating Property](https://wpsso.com/docs/plugins/wpsso/notes/developer/filters/examples/modify-the-aggregaterating-property/)
			* [Modify the Default Article Section List](https://wpsso.com/docs/plugins/wpsso/notes/developer/filters/examples/modify-the-default-article-sections-list/)
	* [The $mod Variable](https://wpsso.com/docs/plugins/wpsso/notes/developer/the-mod-variable/)
* [Inline Variables](https://wpsso.com/docs/plugins/wpsso/notes/inline-variables/)
* [Multisite / Network Support](https://wpsso.com/docs/plugins/wpsso/notes/multisite-network-support/)

== Screenshots ==

01. The Essential, General, and Advanced settings pages provide all the options you may need, from simple blog sites to advanced e-commerce shops and everything in-between.

== Changelog ==

<h3 class="top">Release Schedule</h3>

<p>New versions of the plugin are released approximately every week (more or less). New features are added, tested, and released incrementally, instead of grouping them together in a major version release. When minor bugs fixes and/or code improvements are applied, new versions are also released. This release schedule keeps the code stable and reliable, at the cost of more frequent updates.</p>

<p>See <a href="https://en.wikipedia.org/wiki/Release_early,_release_often">release early, release often (RERO) software development philosophy</a> on Wikipedia for more information on the benefits of smaller / more frequent releases.</p>

<h3>Version Numbering</h3>

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

* {major} = Major structural code changes and/or incompatible API changes (ie. breaking changes).hanges).
* {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/)
* [WordPress.org](https://plugins.trac.wordpress.org/browser/wpsso/)

<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/advanced/">the latest development version under the Advanced Options section</a>.</strong></p>

<h3>Changelog / Release Notes</h3>

**Version 15.2.0 (2023/02/11)**

* **New Features**
	* None.
* **Improvements**
	* Added new Place tab options in the SSO &gt; Advanced Settings &gt; Schema Defaults metabox:
		* Default Place Schema Type
		* Default Place Country
		* Default Place Timezone
	* Added an '@id' property value to the Schema AggregateRating markup.
	* Added support for the WooCommerce 'woocommerce_breadcrumb_main_term' filter to return the primary product category.
	* Removed the offers property from the Schema ProductGroup markup (not required as each variant has its own offers property).
* **Bugfixes**
	* None.
* **Developer Notes**
	* Added a new `WpssoAbstractWpMeta->md_cache_disable()` method.
	* Added a new `WpssoAbstractWpMeta->md_cache_enable()` method.
* **Requires At Least**
	* PHP v7.2.
	* WordPress v5.2.

**Version 15.1.1 (2023/02/08)**

* **New Features**
	* None.
* **Improvements**
	* Added support for Schema products with offers or Schema product groups with variants, depending on the Schema Type selected in the Document SSO metabox.
	* Added inheritance of some Schema ProductGroup properties ('name', 'description', 'aggregateRating', and 'review') for the product group variants.
* **Bugfixes**
	* None.
* **Developer Notes**
	* Added a Schema '@id' property to product reviews.
	* Added a new `WpssoIntegEcomWooCommerce->add_mt_ratings()` private method.
	* Added a new `WpssoIntegEcomWooCommerce->add_mt_reviews()` private method.
	* Updated the `WpssoIntegEcomWooCommerce->filter_og_seed()` method to return variants for the Schema ProductGroup type, and offers for the Schema Product type.
	* Updated the `WpssoJsonTypeProductGroup->filter_json_data_https_schema_org_productgroup()` method to provide inheritance of 'name', 'description', 'aggregateRating', 'review' properties for the product group variants.
	* Updated the `WpssoOpenGraphNS->filter_og_data_https_ogp_me_ns_product()` method to provide inheritance of 'og:description' for product offers and product group variants.
* **Requires At Least**
	* PHP v7.2.
	* WordPress v5.2.

**Version 15.0.1 (2023/02/04)**

* **New Features**
	* None.
* **Improvements**
	* None.
* **Bugfixes**
	* Fixed re-setting PHP 'error_log' to an empty value when PHP 'open_basedir' is true.
* **Developer Notes**
	* Refactored the `SucomUtil::safe_error_log()` method.
* **Requires At Least**
	* PHP v7.2.
	* WordPress v5.2.

**Version 15.0.0 (2023/02/03)**

This version changes the Schema markup for WooCommerce variations. Instead of creating Schema Product markup with offers (one offer per variation), WPSSO Core now creates Schema ProductGroup markup with products (one product per variation) and one offer per product.

See here for more info: https://surniaulula.com/2023/apps/wordpress/plugins/wpsso/whats-new-in-wpsso-core-v15/

* **New Features**
	* Added support for Schema ProductGroup markup for WooCommerce product variations.
* **Improvements**
	* Added a new "Minimize Schema JSON-LD" option in the SSO &gt; Advanced Settings page.
	* Removed filter to allow sorting of the WooCommerce variations array (no longer needed).
* **Bugfixes**
	* Fixed potential missing price currency and value units meta tags for WooCommerce products with variations.
	* Fixed extra min/max energy efficiency meta tags when no energy efficiency value selected.
* **Developer Notes**
	* Added a new 'wpsso_json_data_single_product_group_exclude_varies_by' filter.
	* Added a new 'wpsso_json_data_single_product_group_varies_by' filter.
	* Added a new 'wpsso_init_json_filter_{lib_dir}_{lib_id}' filter.
	* Added a new `WpssoSchemaSingle::add_product_group_data()` method.
	* Added a new `WpssoOpenGraph->get_product_retailer_item_image_urls()` method.
	* Added a new `WpssoOpenGraph->get_product_retailer_item_image()` method.
	* Added a new `WpssoOpenGraph->get_product_retailer_item_mod()` method.
	* Added a '$page_type_id' argument to the `WpssoSchemaSingle::add_offer_data()` method.
	* Added a '$page_type_id' argument to the `WpssoSchemaSingle::add_product_data()` method.
	* Added a '$page_type_id' argument to the `WpssoSchemaSingle::get_offer_data()` method.
	* Added a '$page_type_id' argument to the `WpssoSchemaSingle::get_product_data()` method.
	* Renamed the `WpssoSchema::add_author_coauthor_data()` method to `WpssoSchema::add_author_coauthors_data()`.
	* Renamed the `WpssoSchema::add_comment_list_data()` method to `WpssoSchema::add_comments_data()`.
	* Renamed the `WpssoSchema::add_howto_step_data()` method to `WpssoSchema::add_howto_steps_data()`.
	* Renamed the `WpssoSchema::add_offers_aggregate_data()` method to `WpssoSchema::add_offers_aggregate_data_mt()`.
	* Renamed the `WpssoSchema::add_offers_data()` method to `WpssoSchema::add_offers_data_mt()`.
	* Renamed the `WpssoSchema::add_variants_data()` method to `WpssoSchema::add_variants_data_mt()`.
	* Removed the `WpssoIntegEcomWooCommerce->maybe_sort_available_variations()` private method.
	* Removed the 'wpsso_request_url_query_attrs_cache_disable' filter.
	* Removed the WPSSO_JSON_PRETTY_PRINT constant.
* **Requires At Least**
	* PHP v7.2.
	* WordPress v5.4.

**Version 14.8.0 (2023/01/30)**

This version includes several code updates required for WPSSO Core v15.0.0.

* **New Features**
	* None.
* **Improvements**
	* Extended the "Inherit Featured Image" option to include private content (ie. WooCommerce variations).
	* Removed the "Clear Cache" button from the SSO &gt; Tools and Actions settings page - the "Refresh Cache" button is a better option.
	* Removed the "Clear Short URLs on Clear Cache" option from the SSO &gt; Advanced Settings page.
* **Bugfixes**
	* None.
* **Developer Notes**
	* Added a new 'product:shipping_class_id'' internal meta tag.
	* Added a new 'product:shipping_offers' internal meta tag.
	* Added a new 'product:variants' internal meta tag.
	* Added a new 'wpsso_og_add_mt_variants' filter.
	* Added a new 'wpsso_json_data_https_schema_org_product_group' filter hook.
	* Added a new `WpssoSchema::add_variants_data()` method.
	* Added a new `WpssoSchemaSingle::add_offer_data()` method.
	* Added a new `WpssoSchemaSingle::add_product_data()` method.
	* Added a new `WpssoSchemaSingle::get_product_data()` method.
	* Added a new private `WpssoSchemaSingle::add_or_replace_data()` method.
	* Refactoted the `WpssoSchemaSingle::get_offer_data()` method.
	* Refactored the 'wpsso_json_data_https_schema_org_product' filter hook by moving its code to a new `WpssoSchemaSingle::add_product_data()` method.
	* Refactored the `SucomNotice` class to improve handling of notices for background tasks.
	* Removed the `$mod` argument from the `WpssoSchema::add_offers_data()` and `WpssoSchema::add_offers_aggregate_data()` methods.
* **Requires At Least**
	* PHP v7.2.
	* WordPress v5.4.

**Version 14.7.0 (2023/01/26)**

* **New Features**
	* None.
* **Improvements**
	* Added compatibility declaration for WooCommerce HPOS.
	* Updated the list of ignored tracking and advertising URL query args for caching.
	* Updated conflict notices for Yoast SEO v20.0.
	* Updated the minimum WordPress version from v5.2 to v5.4.
	* Removed the "Your Rating Is Important" metabox under the SSO &gt; Dashboard settings page.
* **Bugfixes**
	* Fixed possible 404 HTML content under the Document SSO &gt; Preview oEmbed tab for non-public posts.
	* Fixed the missing page number for the WooCommerce shop page canonical URLs.
	* Fixed pading for the shortlink URL.
* **Developer Notes**
	* Updated the `WpssoAbstractAddOn->add_hooks()` method to add support for the plugin config 'wc_compat' array.
	* Renamed the 'sucom_remove_tracking_args' filter to 'sucom_ignored_url_query_args'.
	* Refactored the `SucomUtil::get_url()` method to add a local cache.
	* Refactored the `SucomUtil::get_posts()` method to sanitize deprecated query arguments.
	* Refactored the `WpssoPost->get_posts_ids()` method to use `SucomUtilWP::get_posts()`.
	* Refactored the `WpssoTerm->get_posts_ids()` method to use `SucomUtilWP::get_posts()`.
	* Refactored the `WpssoUser->get_posts_ids()` method to use `SucomUtilWP::get_posts()`.
* **Requires At Least**
	* PHP v7.2.
	* WordPress v5.4.

**Version 14.6.0 (2023/01/22)**

* **New Features**
	* None.
* **Improvements**
	* Added a filter to allow sorting of the WooCommerce variations array (moving the requested variation first) for the WPSSO GMF add-on.
	* Updated the post cache clearing method to clear the cache of any post children as well.
* **Bugfixes**
	* Fixed extra min/max energy efficiency meta tags when no energy efficiency value selected.
* **Developer Notes**
	* Added a new `WpssoIntegEcomWooCommerce->maybe_sort_available_variations()` private method.
	* Added a new 'wpsso_request_url_query_attrs_cache_disable' filter.
	* Renamed the 'wpsso_url_query_cache_disable' filter to 'wpsso_request_url_query_cache_disable'.
	* Updated the `SucomUtil::move_to_front()` static method to handle non-associative arrays.
	* Updated the `WpssoPost->clear_cache()` method to clear the cache of any direct post children.
* **Requires At Least**
	* PHP v7.2.
	* WordPress v5.2.

**Version 14.5.0 (2023/01/20)**

* **New Features**
	* Added a new WPSSO Commerce Manager Catalog Feed XML add-on.
	* Added an integration module for the Perfect Images plugin.
* **Improvements**
	* Updated the Yoast SEO compatibility filter to keep its breadcrumbs markup.
* **Bugfixes**
	* Fixed possibly exceeding the PHP 'max_input_vars' limit on post editing pages.
* **Developer Notes**
	* Added a submit event on post, term, and user editing pages to run `sucomDisableUnchanged()` on the Document SSO metabox options.
	* Added a new `WpssoUtil->is_size_cropped()` method.
	* Added a new `lib/integ/media/wp-retina-2x.php` library file.
	* Moved `WpssoCompat->update_wr2x_retina_sizes()` to `WpssoIntegMediaWpRetina2x->update_wr2x_retina_sizes()`.
	* Refactored, moved and renamed `WpssoUtil->count_identical_sizes()` to `WpssoMedia->can_rename_image_filename()`.
* **Requires At Least**
	* PHP v7.2.
	* WordPress v5.2.

**Version 14.4.0 (2023/01/11)**

* **New Features**
	* None.
* **Improvements**
	* Added a new "Speakable CSS Selectors" option under the SSO &gt; Advanced Settings &gt; Integration tab.
	* Removed minimum image dimensions checks for Google image sizes (1:1, 4:3, and 16:9) as they are no longer mentioned in the [Google Structured Data Guidelines](https://developers.google.com/search/docs/appearance/structured-data/search-gallery).
	* Updated the default and recommended Facebook image size from 1200x630 to 1200x628.
* **Bugfixes**
	* None.
* **Developer Notes**
	* Added new filters to add, remove, or change unit values:
		* 'wpsso_dimension_units'
		* 'wpsso_fluid_volume_units'
		* 'wpsso_weight_units'
	* Renamed the meta options 'schema_keywords' key to 'schema_keywords_csv'.
* **Requires At Least**
	* PHP v7.2.
	* WordPress v5.2.

**Version 14.3.0 (2023/01/05)**

* **New Features**
	* None.
* **Improvements**
	* Exclude matching Open Graph meta tags for the main product if found in the product offers.
	* Updated the settings saving notice from "You can Clear All Caches now to reflect these changes or wait for caches to expire." to "You can refresh the cache now or let the cache refresh over the next 1 month."
* **Bugfixes**
	* None.
* **Developer Notes**
	* Added an 'is_public' check to `WpssoSchema::check_required_props()` to avoid Schema property warnings for non-public post types.
	* Updated the `WpssoOpengraph->sanitize_mt_array()` method to sanitize product offer meta tags.
* **Requires At Least**
	* PHP v7.2.
	* WordPress v5.2.

**Version 14.2.0 (2023/01/03)**

* **New Features**
	* None.
* **Improvements**
	* Added a new "Default Product Target Gender" option in the Advanced Settings page.
	* Added a new "Default Product Size Group" option in the Advanced Settings page.
	* Updated the "Product Size Group" option in the Document SSO metabox to add a second selection.
* **Bugfixes**
	* Fixed usage of an old NextGEN Gallery media library setting that should have been removed.
* **Developer Notes**
	* Added a new `SucomUtil::is_post_type()` method.
	* Added a new `SucomUtil::get_options_value_transl()` method.
	* Added a new `WpssoConfig::get_attr_md_index()` method.
	* Added a new `WpssoIntegEcomWooCommerce->filter_import_product_attributes()` method.
	* Added a new `WpssoIntegEcomWooCommerce->add_variation_title()` method.
	* Added a new `WpssoIntegEcomWooCommerce->add_variation_description()` method.
	* Added a new `WpssoOpenGraph->get_def_md_key()` method.
	* Added a new `WpssoOpenGraph->add_data_og_type_md_values()` method.
	* Added a new `WpssoOpenGraph->check_mt_value_energy_efficiency()` method.
	* Added a new `WpssoUtil->maybe_add_md_key_units()` method.
	* Added a new `WpssoUtilWooCommerce->get_product_wp_meta()` method.
	* Added a new 'wpsso_import_product_attributes' filter.
	* Updated the 'wpsso_import_custom_fields' filter arguments to insert the $mod array.
	* Renamed `WpssoOpengraph->add_og_type_mt_md()` to `See WpssoOpengraph->add_data_og_type_md()`.
	* Renamed `WpssoConfig::get_cf_md_multi()` to `WpssoConfig::get_md_keys_multi()`.
	* Renamed `WpssoSchema::get_enumeration_values()` to `WpssoSchema::get_enumeration_examples()`.
	* Renamed `SucomUtil::get_options_transl()` to `SucomUtil::get_options_label_transl()`.
	* Renamed 'wpsso_wc_variation_cf_meta_keys' filter to 'wpsso_wc_variation_alt_options'.
	* Refactored `WpssoSchema::check_prop_value_enumeration()` to allow reading translated values.
	* Removed the `WpssoUtil->get_product_attr_names()` method.
* **Requires At Least**
	* PHP v7.2.
	* WordPress v5.2.

**Version 14.1.1 (2022/12/30)**

* **New Features**
	* None.
* **Improvements**
	* None.
* **Bugfixes**
	* Fixed the property name for the Schema SizeSpecification type.
* **Developer Notes**
	* None.
* **Requires At Least**
	* PHP v7.2.
	* WordPress v5.2.

**Version 14.1.0 (2022/12/29)**

* **New Features**
	* None.
* **Improvements**
	* None.
* **Bugfixes**
	* Fixed saving an incorrect noindex meta tag value when `is_embed()` is true.
* **Developer Notes**
	* Added new cache refresh functions:
		* `wpsso_refresh_cache()`
		* `wpsso_refresh_post_cache()`
	* Refactored loading of the lib/abstract/wp-meta.php library in WpssoComment, WpssoPost, WpssoTerm, and WpssoUser.
	* Re-added static methods to the `WpssoUtilWooCommerce` class with a deprecation notice:
		* `WpssoUtilWooCommerce::get_dimension_label()`.
		* `WpssoUtilWooCommerce::get_dimension()`.
		* `WpssoUtilWooCommerce::get_fluid_volume_label()`.
		* `WpssoUtilWooCommerce::get_fluid_volume_units()`.
		* `WpssoUtilWooCommerce::get_fluid_volume()`.
	* Renamed static methods in `WpssoUtilUnits`:
		* `get_convert_dimension()`    to `get_dimension_convert()`
		* `get_convert_fluid_volume()` to `get_fluid_volume_convert()`
		* `get_convert_weight()`       to `get_weight_convert()`
* **Requires At Least**
	* PHP v7.2.
	* WordPress v5.2.

**Version 14.0.0 (2022/12/28)**

* **New Features**
	* Added support for the Schema Product 'size' property as a Schema SizeSpecification type.
	* Added support for the Schema Product 'hasEnergyConsumptionDetails' property.
	* Added new options in the General Settings page:
		* Default Dimension Units
		* Default Weight Units
		* Default Fluid Volume Units
	* Added new options in the Advanced Settings page:
		* Default Product Energy Rating Range
		* Default Product Size System
	* Added new product related Document SSO options, attributes, and custom fields:
		* Product Energy Rating
		* Product Size System
		* Product Net Length
		* Product Net Width
		* Product Net Height
		* Product Net Weight
	* Added new product related Document SSO options and custom fields:
		* Product Shipping Length
		* Product Shipping Width
		* Product Shipping Height
		* Product Shipping Weight
* **Improvements**
	* Added support for localized Product Attribute values in the Advanced Settings page.
	* Added a list of suggested attributes in the WooCommerce Product data metabox Attributes tab.
	* Updated the WooCommerce integration module to provide shipping dimensions and weight (instead of product net dimensions and weight).
	* Updated the SSO &gt; Advanced Settings &gt; Attributes and Metadata options to show default dimension, weight, and fluid volume units.
	* Renamed the Adult Oriented options to Adult Type.
	* Removed Document SSO product options, attributes, and custom fields:
		* Product Depth
		* Product Depth Attribute
		* Product Depth Custom Field
* **Bugfixes**
	* None.
* **Developer Notes**
	* Added a new `WpssoUtilUnits` class with static methods:
		* `WpssoUtilUnits::get_convert()`
		* `WpssoUtilUnits::get_mixed_label()`
		* `WpssoUtilUnits::get_mixed_text()`
		* `WpssoUtilUnits::get_mixed_type()`
		* `WpssoUtilUnits::get_convert_dimension()`
		* `WpssoUtilUnits::get_dimension_label()`
		* `WpssoUtilUnits::get_dimension_units()`
		* `WpssoUtilUnits::get_convert_fluid_volume()`
		* `WpssoUtilUnits::get_fluid_volume_label()`
		* `WpssoUtilUnits::get_fluid_volume_units()`
		* `WpssoUtilUnits::get_convert_weight()`
		* `WpssoUtilUnits::get_weight_label()`
		* `WpssoUtilUnits::get_weight_units()`
	* Updated `WpssoOpenGraph->add_og_type_mt_md()` to convert dimension and weight units.
	* Renamed `WpssoSchema->get_data_unit_text()` to `WpssoSchema->get_unit_text()`.
	* Removed `WpssoSchema->get_data_unit_from_assoc()`.
	* Removed static methods from the `WpssoUtilWooCommerce` class:
		* `WpssoUtilWooCommerce::get_dimension_label()`.
		* `WpssoUtilWooCommerce::get_dimension_units()`.
		* `WpssoUtilWooCommerce::get_dimension()`.
		* `WpssoUtilWooCommerce::get_fluid_volume_label()`.
		* `WpssoUtilWooCommerce::get_fluid_volume_units()`.
		* `WpssoUtilWooCommerce::get_fluid_volume()`.
		* `WpssoUtilWooCommerce::get_weight_label()`.
		* `WpssoUtilWooCommerce::get_weight_units()`.
		* `WpssoUtilWooCommerce::get_weight()`.
	* Renamed internal meta tags:
		* 'product:adult_oriented'    to 'product:adult_type'
		* 'product:quantity:value'    to 'product:eligible_quantity:value'
		* 'product:quantity:minvalue' to 'product:eligible_quantity:min_value'
		* 'product:quantity:maxvalue' to 'product:eligible_quantity:max_value'
		* 'product:quantity:unitcode' to 'product:eligible_quantity:unit_code'
		* 'product:quantity:unittext' to 'product:eligible_quantity:unit_text'
		* 'product:price:type'        to 'product:price_type'
		* 'product:size:type'         to 'product:size_group'
	* Renamed options keys:
		* 'plugin_attr_product_adult_oriented' to 'plugin_attr_product_adult_type',
		* 'plugin_attr_product_size_type'      to 'plugin_attr_product_size_group',
		* 'plugin_cf_product_adult_oriented'   to 'plugin_cf_product_adult_type',
		* 'plugin_cf_product_size_type'        to 'plugin_cf_product_size_group',
		* 'schema_def_product_adult_oriented'  to 'schema_def_product_adult_type',
	* Renamed metadata options keys:
		* 'product_adult_oriented'    to 'product_adult_type',
		* 'product_depth_value'       to 'product_length_value',
		* 'product_size_type'         to 'product_size_group',
		* 'schema_review_rating_from' to 'schema_review_rating_min',
		* 'schema_review_rating_to'   to 'schema_review_rating_max',
* **Requires At Least**
	* PHP v7.2.
	* WordPress v5.2.

== Upgrade Notice ==

= 15.2.0 =

(2023/02/11) Added new Place tab options in the SSO &gt; Advanced Settings &gt; Schema Defaults metabox. Added support for the WooCommerce 'woocommerce_breadcrumb_main_term' filter.

= 15.1.1 =

(2023/02/08) Added support for Schema products with offers or Schema product groups with variants. Added inheritance of some Schema ProductGroup properties for the product group variants.

= 15.0.1 =

(2023/02/04) Fixed re-setting PHP 'error_log' to an empty value.

= 15.0.0 =

(2023/02/03) Added support for Schema ProductGroup markup. Fixed potential missing price currency and value units meta tags. Fixed extra min/max energy efficiency meta tags.

= 14.8.0 =

(2023/01/30) Extended the "Inherit Featured Image" option to include private content. Removed the "Clear Cache" button.

= 14.7.0 =

(2023/01/26) Added compatibility declaration for WooCommerce HPOS. Updated the list of ignored tracking and advertising URL query args for caching.

= 14.6.0 =

(2023/01/22) Added a filter hook to allow sorting of the WooCommerce variations array. Fixed extra min/max energy efficiency meta tags when no energy efficiency value selected.

= 14.5.0 =

(2023/01/20) Added a new WPSSO Commerce Manager Catalog Feed XML add-on. Fixed possibly exceeding the PHP 'max_input_vars' limit on post editing pages.

= 14.4.0 =

(2023/01/11) Added a new "Speakable CSS Selectors" option. Removed minimum image dimensions checks for Google image sizes.

= 14.3.0 =

(2023/01/05) Exclude matching Open Graph meta tags for the main product if found in the product offers.

= 14.2.0 =

(2023/01/03) Added new "Default Product Target Gender" and "Default Product Size Group" options. Updated the "Product Size Group" option in the Document SSO metabox.

= 14.1.1 =

(2022/12/30) Fixed the property name for the Schema SizeSpecification type.

= 14.1.0 =

(2022/12/29) Added new cache refresh functions. Fixed saving an incorrect noindex meta tag value when `is_embed()` is true.

= 14.0.0 =

(2022/12/28) Added support for the Schema Product 'hasEnergyConsumptionDetails' property. Added new options in the General Settings page. Added new product related Document SSO options, attributes, and custom fields.

