Requires at least: 5.4 Tested up to: 5.5 Stable tag: 13.7 Requires PHP: 5.6.20 Depends: Yoast SEO, WooCommerce
This extension to WooCommerce and Yoast SEO makes sure there's perfect communication between the two plugins.
This repository uses the Yoast grunt tasks plugin.
- Go to Plugins -> Add New.
- Click "Upload" right underneath "Install Plugins".
- Upload the zip file that this readme was contained in.
- Activate the plugin.
- Go to SEO -> Licenses and enter your WooCommerce SEO license key.
- Save settings, your license key will be validated. If all is well, you should now see the WooCommerce SEO settings.
You can find the FAQ online here.
Enhancements:
- Shows the price and availability of a product in its snippet when sharing the product on Slack.
Bugfixes:
- Fixes a bug where no plugin icon and compatibility data would be displayed on the plugins update screen.
Other:
- We've tested with WooCommerce 4.5. Everything works as expected!
Enhancements:
- Adds ‘WebPage’ as schema
@type
to Product pages and Checkout pages. This results in a@type
array with at least 'WebPage' and 'ItemPage', or 'WebPage' and 'CheckoutPage'.
Other:
- Enables tracking when activating the plugin. This can be disabled in the Yoast SEO configuration wizard.
- Sets the minimum supported WordPress version to 5.4.
Enhancements:
- Hides the Yoast SEO columns in the Products overview table by default.
Bugfixes:
- Fixes a bug where no SKU would be output when the SKU field was left empty. It will now fall back to the product’s ID.
Enhancements:
- Outputs
PreOrder
as availability property value in the Product schema when the product is “on backorder”.
Bugfixes:
- Fixes a bug where the organization schema for a primary term would error.
- Fixes a bug where a potential undefined variable notice was shown when toggling the 'prices have tax included' WooCommerce option.
- Fixes a bug where changing the product permalinks would not reset the permalinks in their respective indexables.
Enhancements:
- Omits the
product:price:amount
andproduct:price:currency
og meta for variable and grouped products. - Hides all Yoast columns in the Product overview page except the SEO Score column.
Bugfixes:
- Fixes a bug where the
twitter:image
meta tag would not fall back on the first product gallery image when no main product image was set. - Fixes a bug where all product gallery images would be output as
og:image
even though a user had set a specific image for a product.
Bugfixes:
- Fixes a bug where thumbnail product gallery images were added to the XML product sitemap instead of full size images.
Enhancements:
- Adds a
Term hierarchy
snippet variable. - Unifies the OpenGraph description fallbacks as per https://developer.yoast.com/features/meta-tags/.
Other:
- Compatibility with Yoast SEO 14.0.
- Sets the minimum supported Yoast SEO version to 14.0.
- Sets the minimum supported WordPress version to 5.3.
Bugfixes:
- Fixes a bug where PHP notices and a PHP warning were thrown for
Product
schema without a price. - Fixes a bug where the
priceValidUntil
schema property wasn't output for products on sale with an explicitly set sale end date.
Enhancements:
- Improves the Open Graph product availability for better compatibility with Facebook and Pinterest.
- Adds the product identifiers (GTIN, ISBN etc.) to the SEO title and Meta description replacement variables.
- Adds a
color
attribute to theProduct
Schema output.
Other:
- We've tested with WooCommerce 4.0. Everything works as expected!
Bugfixes:
- Fixes a bug where the product price and tax inclusion were not accurately reflected in the Schema and Open Graph metatags.
Enhancements:
- Removes the
valueAddedTaxIncluded
Schema property when tax rate calculations are disabled in WooCommerce. - Removes the 'Prices in Open Graph and Schema include tax' setting in the plugin. Whether tax is included in Open Graph and Schema now solely relies on your product page settings in WooCommerce.
Bugfixes:
- Fixes a bug where the internal linking and additional keyphrase functionality are missing from the product edit page.
- Fixes a bug where the short description for the meta description and Twitter and Facebook description could still contain HTML tags and redundant spaces.
Enhancements:
- Adds explanatory copy above the input fields for GTIN, ISBN etc.
- Adds an option to display the price in Schema and OpenGraph with tax included.
Bugfixes:
- Fixes a bug where not all product attributes were available in the Brands and Manufacturer dropdowns.
Enhancements:
- Adds a Yoast SEO section to the WooCommerce product data metabox that allows entering a GTIN, ISBN and MPN number.
- Analyzes the content of the short description as part of the page content.
- Throws a warning when WooCommerce is not active.
- Adjusts the wording for when Yoast SEO is not active.
- Schema:
- Adds an
@id
attribute to every individual review. - Adds a
name
attribute to every individual review. - Adds an
@id
attribute to every offer. - Adds a
productID
attribute to theProduct
output. - Adds a
gtin8
attribute to theProduct
output. - Adds a
gtin12
attribute to theProduct
output. - Adds a
gtin13
attribute to theProduct
output. - Adds a
gtin14
attribute to theProduct
output. - Adds a
mpn
attribute to theProduct
output. - Adds an
isbn
attribute to theProduct
output. If an ISBN number is set, it double types the schema output to[ Product, Book ]
. By double typing it, the Product can have the attributes of both schema.org/Book and schema.org/Product, and thus it can have an ISBN attribute and a price etc. - Removes the
priceValidUntil
attribute, as it's not sensible.
- Adds an
- OpenGraph:
- Adds a
product:condition
meta tag to the OpenGraph output. It defaults tonew
but can be filtered using the newYoast\WP\Woocommerce\product_condition
filter. - Adds a
product:retailer_item_id
meta tag to the OpenGraph output for Facebook Catalog usage.
- Adds a
- Don't try to use the WooCommerce shop page in the sitemap when it is not set in WooCommerce.
Bugfixes:
- Fixes a bug where the
product:brand
meta tag would not always be the selected primary term. - Fixes a bug where the
product:availability
meta tag would be set toinstock
instead of the correctin stock
. - Fixes a bug where a PHP notice would be thrown on products with variations where a variation lacked an image.
- Fixes a bug where Organization would be used in the schema output, while no organization was set.
- Fixes a bug where non-public taxonomies could be chosen as manufacturer and brand.
- Fixes a bug where the shop page would be shown in the XML sitemap when it was set to
noindex
. Props stodorovic. - Fixes a bug where an empty
product:retailer_item_id
was output when there was no SKU.
Other:
- Deprecates the
wpseo_woocommerce_og_price
filter hook in favor of theYoast\WP\Woocommerce\og_price
hook.
Bugfixes:
- Fixes a bug where reviews weren't output in the Product schema when WooCommerce 3.8.1 was installed.
Other:
- Sets the minimum WordPress version to 5.2 and the minimum Yoast SEO version to 12.6.
- Replaces the HelpScout beacon on the WooCommerce SEO admin page.
Bugfixes:
- Fixes a bug where hidden products would show in the XML sitemap.
Other:
- Sets the minimum required WordPress version to 5.2, and the minimum PHP version to 5.6.20.
Enhancements:
- Shows a floating
Save changes
button on the Yoast SEO for WooCommerce admin page when the normal button is not visible in the browser window.
Other:
- Removes the colon from the form labels in the settings.
- Compatibility with Yoast SEO 12.2
Other:
- Compatibility with Yoast SEO 12.1
Bugfixes:
- Fixes a bug where the primary category would not be reflected correctly in the product schema output when it was being used to set the manufacturer or brand.
Other:
- Compatibility with Yoast SEO 12.0
Bugfixes:
- Fixes a bug where invalid schema would be output when a product used the placeholder image.
Other:
- Compatibility with Yoast SEO 11.9
Bugfixes:
- Fixes a bug where the Yoast SEO WooCommerce schema was output when the
wpseo_json_ld_output
filter was set to false.
Other:
- Compatibility with Yoast SEO 11.8
Other:
- Compatibility with Yoast SEO 11.7
Other:
- Fixes a deprecation notice when calling
get_woocommerce_term_meta
. - Compatibility with Yoast SEO 11.6
Other:
- Compatibility with Yoast SEO 11.5
Other:
- Compatibility with Yoast SEO 11.4
Other:
- Compatibility with Yoast SEO 11.3
Other:
- Compatibility with Yoast SEO 11.2
Bugfixes:
- Fixes a bug where a PHP warning would occur on a product page when a review is added.
- Fixes bug where a fatal crash would occur on the checkout page when WooCommerce is not active.
Other:
- Disables plugin when WooCommerce is not active.
- Compatibility with Yoast SEO 11.1
Enhancements:
- Improves the integration of Woo & Yoast's Schema output, bringing it to a whole new level.
- Schema: Changes page type on Checkout to
CheckoutPage
. - Schema: Changes page type on Product to
ItemPage
.
Other:
- Removes Woo breadcrumbs Schema output.
- Sets the minimum required Yoast SEO version to 11.0.
Enhancements:
- Changes
og:brand
toproduct:brand
to match the OpenGraph specifications better.
Other:
- Sets the minimum required Yoast SEO version to 10.1.
- Removes an empty method that has been deprecated since version 5.6.
Other:
- Compatibility with Yoast SEO 10.0
Other:
- Compatibility with Yoast SEO 9.7
Other:
- Compatibility with Yoast SEO 9.6.1
Other:
- Compatibility with Yoast SEO 9.6
Other:
- Compatibility with Yoast SEO 9.5
Other:
- Compatibility with Yoast SEO 9.4
Enhancements:
- The short product description assessment in the SEO analysis is now updated whenever the description gets changed inside the Text-based editor (previously only in the Visual editor).
Bugfixes:
- Fixes a bug where the WooCommerce breadcrumbs were not replaced by the Yoast SEO breadcrumbs.
- Fixes a bug where switching to the visual editor with the text editor active could cause the Product editor to crash.
Other:
- Compatibility with Yoast SEO 9.3
- Compatibility with Yoast SEO 9.2
Bugfixes:
- Fixes a bug where the
Yoast SEO Breadcrumbs
settings page link did not go to the correct page. - Fixes a bug where a PHP warning would be displayed when
php_uname
has been disabled for security reasons.
Other:
- Compatibility with Yoast SEO 9.1
- Compatibility with Yoast SEO 9.0
- Compatibility with Yoast SEO 8.4
- Compatibility with Yoast SEO 8.3
- Compatibility with Yoast SEO 8.2
- Compatibility with Yoast SEO 8.1
- Compatibility with Yoast SEO 8.0
- Compatibility with Yoast SEO 7.9.1
- Compatibility with Yoast SEO 7.9
- Excludes the WooCommerce core pages from the sitemap, as they are set to
noindex
by WooCommerce. - Hides excluded catalog products from the products sitemap.
- Compatibility with Yoast SEO 7.8
- Adds recommended templates with replacements variables for WooCommerce pages.
- Compatibility with Yoast SEO 7.7
- Compatibility with Yoast SEO 7.6
- Compatibility with Yoast SEO 7.5
- Compatibility with Yoast SEO 7.4
- Compatibility with Yoast SEO 7.3
- Compatibility with Yoast SEO 7.2
- Compatibility with Yoast SEO 7.1
Other:
- Removes backfill for
wp_installing()
as this was introduced in WordPress 4.4. - Requires WordPress 4.8 or higher to be installed.
- Requires Yoast SEO 7.0 or higher to be installed.
- Security hardening.
- Compatibility with Yoast SEO 6.3
Enhancements:
- Adds
%%wc_price%%
,%%wc_sku%%
,%%wc_shortdesc%%
and%%wc_brand%%
replacement variables for titles and meta description.
Enhancements:
- Excludes product names from being translated.
Bugfixes:
- Fixes a bug where there was a link to a settings page that no longer existed.
- Compatibility with Yoast SEO 6.0
Bugfixes:
- Fixes a bug where product gallery images were being placed above the featured image in the OpenGraph output. This caused an unexpected image to be used when sharing the page.
- Fixes a bug where the Yoast SEO link count columns where not removed from the product page when the setting
Remove Yoast SEO columns
is used.
Other:
- Compatibility with Yoast SEO 5.9
- Compatibility with Yoast SEO 5.8
- Compatibility with Yoast SEO 5.7
Enhancements:
- Changes the capability on which the submenu is registered to
wpseo_manage_options
- Changes the way the submenu is registered to use the
wpseo_submenu_pages
filter
Bugfixes:
- Fixes a bug where the short product description was cut after 156 characters in the meta description
- Fixes a bug where the license check endpoint was using an incorrect URL
- Updated the internationalization module to version 3.0.
- Compatibility with Yoast SEO 5.4
- Compatibility with Yoast SEO 5.3
- Compatibility with Yoast SEO 5.2
- Compatibility with Yoast SEO 5.1
- Compatibility with Yoast SEO 5.0
- Adds a filter to set the primary category in the permalink.
- Adds fallbacks for several deprecated warnings.
- Fixes a bug where not all Yoast SEO columns were hidden when the columns output by Yoast were removed.
- Compatibility with Yoast SEO 4.8
- Compatibility with Yoast SEO 4.7
- Compatibility with Yoast SEO 4.6
- Compatibility with Yoast SEO 4.5
- Compatibility with Yoast SEO 4.4
- Bugfixes
- Fixes a bug where duplicate opengraph image tags were added to product categories.
- Bugfixes
- Fixes "Fatal error: Class 'yoast_i18n' not found".
- Compatibility with Yoast SEO 4.2
- Compatibility with Yoast SEO 4.1
- Compatibility with Yoast SEO 4.0
- Compatibility with Yoast SEO 3.9
- Compatibility with Yoast SEO 3.8
- Compatibility with Yoast SEO 3.7
- Changes
- Updated translations.
- Compatibility with YoastSEO 3.5
- Changes
- Updated translations.
-
Enhancements
- Adds the Yoast i18n module to the Yoast SEO WooCommerce settings page, which informs users the plugin isn't available in their language and what they can do about it.
-
Bugfixes
- Fixes a bug where the support beacon for Yoast SEO WooCommerce was added to all Yoast SEO settings pages.
- Fixes a bug where updates were not working reliably when multiple paid Yoast plugins were active.
- Bug fixes
- Fixes a bug where the rel=next and rel=prev links were not displayed on shop archive pages 2 and up.
- Bug fixes
- Fixes a bug where clicking the 'Update now' button on the plugin page didn't update correctly.
- Fixes a bug where product specific checks that were added to the content analysis would no longer work in combination with Yoast SEO 3.2 and higher.
- Bug fixes
- Fixes a bug where the Yoast content analysis would break on product edit pages when Yoast WooCommerce SEO and Yoast SEO (Premium) 3.1+ are both active.
-
Bug fixes
- Fixes a bug where our license manager could sometimes not reach our licensing system due to problems with ssl.
-
Enhancements
- Makes sure users don't have to reactivate their license after updating or disabling/enabling the plugin.
- Adds a support beacon on the WooCommerce SEO settings page enabling users to ask for support from the WordPress backend.
- Makes license calls a bit faster.
- Removed all Twitter card functionality since the Product twitter card no longer exists.
-
Synchronized plugin version with all other Yoast SEO plugins for WordPress.
-
Bug fixes
- Fixes deprecation warnings for filters and functions that have been removed in Yoast SEO
- Fixes a fatal on the frontend when WooCommerce SEO is active but WooCommerce isn't.
-
Enhancements
- Makes sure WooCommerce specific content analysis checks work well with the Real Time content analysis tool in Yoast SEO 3.0.
- Makes sure the product image galleries are still analyzed as part of the content by the Real Time content analysis tool in Yoast SEO 3.0.
- Improves the order in which opengraph images are output. First the facebook image, then the facebook image, then the product gallery images.
- Bugfixes
- Fixes a bug where a Fatal error was being raised on the frontend when WooCommerce is not activated.
- Fixes a bug where Open Graph image tags for featured images and facebook images were not included first when a product image gallery existed.
- Enhancements
- Defaults to the short description for the meta description when no meta description is set.
- Added 8 new languages: da_DK, en_GB, es_ES, es_MX, it_IT, nb_NO, nl_NL and tr_TR.
- Prevent adding product archive link to XML sitemap
- Add
wpseo_woocommerce_og_price
filter. Returning false on it prevents price from being put out in OpenGraph tags. - Add attribute to breadcrumbs when attribute is selected.
- Removed unused breadcrumb option.
- Only initiate plugin when WP is not installing.
- Improved how WooCommerce breadcrumbs are replaced.
- Fixed double class instantiation within same method.
- Add call to
load_plugin_textdomain()
. - Make sure we recognize WooCommerce product gallery images in page analysis.
- Add images from product gallery to XML sitemap.
- Use product category thumbnail for og:image.
- Make sure short description length test also soft errors when short description is too long.
- Use WooCommerce price formatting functions for price in Twitter card.
- Fixed a bug where the breadcrumb caused a fatal error.
- Added Yoast license manager to plugin.
-
Compatibility update for WP SEO v1.5 including application of a number of best practices.
-
Bugfixes
- Fixed shortcodes should be removed from ogdesc.
- Fixed duplicate twitter domain meta tag
- Fixed error loading stylesheet (WPSEO_URL no longer defined).
-
Additional enhancements
- Change the minimum content length requirements to 200, instead of the WP SEO default of 300.
- Add a length test for the products short description.
- Make sure the content analysis tests use the product images as well.
- If a product category has a description, use it for the OpenGraph description.
- Switch to general WP SEO Licensing class
- Add check whether WordPress and WordPress SEO by Yoast are installed and up-to-date
- Initial version.