=== WPSSO Core - Complete Schema Markup and Meta Tags ===
Plugin Name: WPSSO Core
Plugin Slug: wpsso
Text Domain: wpsso
Domain Path: /languages
License: GPLv3
License URI: https://wpsso.com/wp-content/plugins/wpsso/license/premium.txt
Assets URI: https://surniaulula.github.io/wpsso/assets/
Tags: schema, woocommerce, search results, optimize, meta tags
Contributors: jsmoriss
Requires PHP: 7.4.33
Requires At Least: 6.0
Tested Up To: 6.9.4
WC Tested Up To: 10.6.2
Stable Tag: 22.0.0

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

== Description ==

<h3 class="top">Complete Schema Markup and Meta Tags for WordPress</h3>

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

<!-- about -->

<p><strong>The most comprehensive and accurate Schema markup plugin for WooCommerce products.</strong></p>

<p>Supports over 500 different Schema types and sub-types (including Schema Event, Product Group, and the Service type for WooCommerce products).</p>

<p><strong>Provides complete Schema markup and meta tags 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>Instagram Catalog Feed XMLs</li>
	<li>Meta (Facebook and Instagram) Catalog Feed XMLs</li>
	<li>Mobile Web Browsers</li>
	<li>oEmbed for LinkedIn, Discord, and Drupal</li>
	<li>Pinterest Rich Pins</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>
	<li>X (Twitter) Cards</li>
</ul>

<!-- /about -->

<p><strong>Fixes all Google Rich Results and Google Merchant errors, including:</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*
* *Either "price" or "priceSpecification" should be specified (in "offers")*
* *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 "address"*
* *Missing field "aggregateRating"*
* *Missing field "brand"*
* *Missing field "businessDays"*
* *Missing field "cutoffTime"*
* *Missing field "deliveryTime"*
* *Missing field "hasMerchantReturnPolicy" (in "offers")*
* *Missing field "image"*
* *Missing field "priceRange"*
* *Missing field "review"*
* *Missing field "shippingDetails" (in "offers")*
* *Missing field "telephone"*
* *No global identifier provided (e.g. gtin mpn isbn)*
* *Not a known valid target type for the itemReviewed property*
* *Price Mismatched value (page crawl): (price [price])*

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

* Commerce Manager Catalog Feed XML (Facebook and Instagram)
* 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
* Video Preview Image
* X (Twitter) Summary Card
* X (Twitter) Summary Card Large Image

<p><strong>Reads additional information from active plugins, including:</strong></p>

* <a href="https://wordpress.org/plugins/co-authors-plus/">Co-Authors Plus</a>
* <a href="https://wordpress.org/plugins/elementor/">Elementor Website Builder</a>
* Gravity Forms
* Gravity View
* <a href="https://wordpress.org/plugins/jetpack/">Jetpack</a>
* <a href="https://wordpress.org/plugins/jetpack-boost/">Jetpack Boost</a>
* <a href="https://wordpress.org/plugins/judgeme-product-reviews-woocommerce/">Judge.me Product Reviews for WooCommerce</a>
* <a href="https://wordpress.org/plugins/wp-retina-2x/">Perfect Images</a>
* <a href="https://wordpress.org/plugins/perfect-woocommerce-brands/">Perfect Brands for WooCommerce</a>
* <a href="https://wordpress.org/plugins/polylang/">Polylang</a>
* Product GTIN (EAN, UPC, ISBN) for WooCommerce
* <a href="https://wordpress.org/plugins/publishpress-authors">PublishPress Authors</a>
* qTranslate-XT
* <a href="https://wordpress.org/plugins/rate-my-post/">Rate my Post</a>
* <a href="https://wordpress.org/plugins/simple-job-board/">Simple Job Board</a>
* <a href="https://wordpress.org/plugins/the-events-calendar/">The Events Calendar</a>
* <a href="https://wordpress.org/plugins/ultimate-member/">Ultimate Member</a>
* <a href="https://wordpress.org/plugins/woocommerce/">WooCommerce</a>
* WooCommerce Brands
* WooCommerce Currency Switcher
* WooCommerce UPC, EAN, and ISBN
* <a href="https://wordpress.org/plugins/wp-job-manager/">WP Job Manager</a>
* <a href="https://wordpress.org/plugins/wp-postratings/">WP-PostRatings</a>
* WP Product Review
* <a href="https://wordpress.org/plugins/wp-recipe-maker/">WP Recipe Maker</a>
* WPML
* <a href="https://wordpress.org/plugins/yith-woocommerce-brands-add-on/">YITH WooCommerce Brands Add-on</a>
* <a href="https://wordpress.org/plugins/yotpo-social-reviews-for-woocommerce/">Yotpo Social Reviews for WooCommerce</a>

<p><strong>Supports additional WooCommerce product attributes:</strong></p>

* Product Adult Type
* Product Age Group
* Product Availability
* Product Brand
* Product Google Category ID
* Product Color
* Product Condition
* Product Currency
* Product Energy Rating
* Product Fluid Volume
* Product GTIN-14
* Product GTIN-13 (EAN)
* Product GTIN-12 (UPC)
* Product GTIN-8
* Product GTIN
* Product Net Height
* Product ISBN
* Product Net Len. / Depth
* Product Material
* Product MPN
* Product Min Advert Price
* Product Pattern
* Product Price
* Product Price Type
* Product SKU
* Product Shipping Height
* Product Shipping Length
* Product Shipping Weight
* Product Shipping Width
* Product Size
* Product Size Group
* Product Size System
* Product Target Gender
* Product Net Weight
* Product Net Width

<p><strong>Optionally improves the structured data markup of other SEO plugins:</strong></p>

WPSSO Core and its add-ons can also run in combination with other SEO plugins to improve their performance and structured data markup.

* All in One SEO Pack
* Rank Math SEO
* SEOPress
* The SEO Framework
* WP Meta SEO
* Yoast SEO

<p><strong>Premium edition can retrieve data from service APIs automatically, including:</strong></p>

* Bitly Short URL
* DLMY.App Short URL
* Facebook Video Data
* Gravatar Image Data
* Judge.me Review Data
* Ow.ly Short URL
* Shopper Approved Review Data
* Slideshare Presentation Data
* Soundcloud Track Data
* Stamped.io Review Data
* TinyURL Short URL
* Vimeo Video Data
* Wistia Video Data
* WP Media Library Video Block Data
* WP Media Library Video Shortcode Data
* Your Own URL Shortener (YOURLS) Short URL
* YouTube Video and Playlist Data

== 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 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/)
	* [$mod Variable](https://wpsso.com/docs/plugins/wpsso/notes/developer/the-mod-variable/)
	* [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/)
* [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">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 22.0.0 (2026/05/01)**

WPSSO Core can reduce its use of the WordPress transients cache (used by plugins and themes to store temporary data) for meta tags and Schema markup when a full webpage caching plugin or service is detected.

* **New Features**
	* Added a new "Cache Plugin or Service is Active" option under the SSO &gt; Advanced Settings &gt; Plugin Settings metabox &gt; Integration tab. If one of the following cache plugins is active, the new "Cache Plugin or Service is Active" option value will be enabled by default:
		* Cache Enabler
		* Comet Cache
		* Hummingbird Cache
		* LiteSpeed Cache
		* Pagely Cache
		* SiteGround Cache
		* W3 Total Cache
		* WP Engine Cache
		* WP Fastest Cache
		* WP Rocket Cache
		* WP Super Cache
* **Improvements**
	* Changed the meta tags and Schema markup default cache expiration from 1 month to 1 week, and 1 hour if a caching plugin is detected.
* **Bugfixes**
	* None.
* **Developer Notes**
	* Added a new `__return_half_hour_in_seconds()` function.
* **Requires At Least**
	* PHP v7.4.33.
	* WordPress v6.0.
	* WPSSO Update Manager v7.2.0 (for Premium edition).

**Version 21.13.3 (2026/04/27)**

* **New Features**
	* None.
* **Improvements**
	* None.
* **Bugfixes**
	* Fixed `Call to a member function pro_feature_video_found_notice() on null` error in the WPSSO Core Standard version.
* **Developer Notes**
	* None.
* **Requires At Least**
	* PHP v7.4.33.
	* WordPress v6.0.
	* WPSSO Update Manager v7.2.0 (for Premium edition).

**Version 21.13.2 (2026/04/20)**

* **New Features**
	* None.
* **Improvements**
	* None.
* **Bugfixes**
	* None.
* **Developer Notes**
	* Fixed case statements followed by semicolon in `WpssoUtilUnits->get_mixed_type()`.
* **Requires At Least**
	* PHP v7.4.33.
	* WordPress v6.0.
	* WPSSO Update Manager v7.2.0 (for Premium edition).

**Version 21.13.1 (2026/04/15)**

* **New Features**
	* None.
* **Improvements**
	* Changed the default "Review Comment Title" option value from 'Review by %%comment_author%% on %%comment_date%%' to 'Review by %%comment_author%%'
* **Bugfixes**
	* None.
* **Developer Notes**
	* Fixed `WpssoErrorException::__construct(): Implicitly marking parameter $previous as nullable is deprecated` warning for PHP v8.4.
* **Requires At Least**
	* PHP v7.4.33.
	* WordPress v6.0.
	* WPSSO Update Manager v7.2.0 (for Premium edition).

**Version 21.13.0 (2026/04/11)**

* **New Features**
	* None.
* **Improvements**
	* None.
* **Bugfixes**
	* None.
* **Developer Notes**
	* Added new filters to include or exclude additional Schema image sizes (ie. not 1x1):
		* 'wpsso_add_image_sizes_schema_4x3'
		* 'wpsso_add_image_sizes_schema_16x9'
		* 'wpsso_add_image_sizes_schema_thumb'
* **Requires At Least**
	* PHP v7.4.33.
	* WordPress v6.0.
	* WPSSO Update Manager v7.2.0 (for Premium edition).

== Upgrade Notice ==

= 22.0.0 =

(2026/05/01) Changed the meta tags and Schema markup default cache expiration from 1 month to 1 week, and 1 hour if a caching plugin is detected. Added a new "Cache Plugin or Service is Active" option.

= 21.13.3 =

(2026/04/27) Fixed `Call to a member function pro_feature_video_found_notice() on null` error in the WPSSO Core Standard version.

= 21.13.2 =

(2026/04/20) Fixed case statements followed by semicolon in `WpssoUtilUnits->get_mixed_type()`.

= 21.13.1 =

(2026/04/15) Changed the default "Review Comment Title" option value. Fixed `WpssoErrorException::__construct(): Implicitly marking parameter $previous as nullable is deprecated` warning for PHP v8.4.

= 21.13.0 =

(2026/04/11) Added new filters to include or exclude additional Schema image sizes (ie. not 1x1).