WPSSO Core (Premium)

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

WPSSO automatically creates meta tags and structured data markup for Facebook / Open Graph, Pinterest Rich Pins, Twitter Cards, Google Knowledge Graph, Google Rich Results (aka Schema, Rich Snippets, Structured Data), WhatsApp and Messaging Apps, Mobile Web Browsers, WordPress REST API, LinkedIn / oEmbed data and more.

Reads existing WordPress content, plugin data, and service API data:

There's no need to manually re-enter descriptions, titles, product information, and re-select images / videos like other meta tag, SEO, or Schema plugins.

WPSSO can be used as your only social and search optimization plugin, or combined with your existing SEO plugin to improve its meta tags and Schema markup (including All in One SEO Pack, Jetpack SEO Tools, Rank Math SEO, SEO Ultimate, SEOPress, The SEO Framework, WP Meta SEO, Yoast SEO, and more).

Fast, lightweight, and coded for maximum performance:

WPSSO is coded for speed and makes full use of all WordPress caching methods — along with advanced caching features like transient cache pre-seeding in background. WPSSO Core and its complementary add-ons load only the PHP libraries and classes they need, keeping their code small, fast and light. All code is fully tested and compatible with the latest version of WordPress and PHP v8.

Customizable settings for different languages:

Text, image, and video related option values are WordPress language / locale aware, which means you can easily switch languages and customize these options for different front-end languages.

Users Love the WPSSO Core Plugin

★★★★★ — "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

★★★★★ — "This plugin has been a lifesaver in terms of making our images and links and descriptions look beautiful everywhere we post them! It’s so easy to use and the preview functions are incredibly helpful." - lotusblooms

★★★★★ — "What a fantastic plugin. If you want to fix all the errors in search console for structured data, this is the plugin to use. Love it." - goviral

★★★★★ — "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

★★★★★ — "Yoast SEO on steroids! As an SEO marketer, I love using Yoast SEO for my basic on-page SEO. But Yoast SEO only allows you to enter basic Open Graph social settings. This plugin gives you SO many more options on completing the Open Graph for Facebook, Twitter cards, Pinterest etc." - gregmontag

WPSSO Core Plugin Features

Offers meta tag and Schema markup options for all WordPress pages:

• Home Page (static page or blog)
• Posts, Pages, and Custom Post Types
• Categories, Tags, and Custom Taxonomy / Terms
• User Profile Pages
• Media Attachment Pages
• Search Result Pages
• Archive Pages

Enhances the WordPress oEmbed markup for LinkedIn and provides additional article and product meta tags for Slack.

Includes structured data images from numerous sources, including featured, attached, gallery shortcode, content images, or a custom fallback image.

Offers optimized structured data image sizes:

• Open Graph (Facebook and oEmbed)
• Pinterest Pin It
• Schema 1:1 (Google Rich Results and SEO)
• Schema 4:3 (Google Rich Results and SEO)
• Schema 16:9 (Google Rich Results and SEO)
• Schema Thumbnail Image
• Twitter Summary Card
• Twitter Large Image Summary Card
• [Premium] Twitter Player Card

Built-in compatibility with AMP plugins:

• AMP
• AMP for WP

Built-in compatibility with optimization and caching plugins:

• Autoptimize
• Cache Enabler
• Comet Cache
• LiteSpeed Cache
• Hummingbird Cache
• Pagely, Siteground Optimizer
• Perfect Images + Retina
• W3 Total Cache (aka W3TC)
• WP Engine Cache
• WP Fastest Cache
• WP Rocket Cache
• WP Super Cache

Built-in compatibility with popular SEO plugins:

• All in One SEO Pack
• Jetpack SEO
• Rank Math SEO
• SEO Ultimate
• SEOPress
• Slim SEO
• Squirrly SEO
• The SEO Framework
• WP Meta SEO
• Yoast SEO
• Yoast WooCommerce SEO

Built-in compatibility for advanced WordPress configurations:

• WordPress MU Domain Mapping
• Network / Multisite Installations

Includes advanced quality assurance features and options:

• Checks and warns of any missing PHP modules.
• Checks 3rd party plugin settings for possible conflicts.
• Checks for minimum / maximum image dimensions and aspect ratios.
• Shows notices for missing and required images.
• Validates theme header templates for correct HTML markup.
• Verifies webpage HTML for duplicate meta tags.

The WPSSO Core Standard plugin is designed to satisfy the requirements of most standard WordPress sites. If your site requires additional 3rd party plugin and service API integration, like WooCommerce shops, embedded video support, or advanced customization features, then you may want to get the WPSSO Core Premium plugin for those additional features.

[Premium] Detection of embedded videos from Facebook, Slideshare, Vimeo, Wistia, and Youtube in the content text.

[Premium] Support for the Twitter Player Card for embedded videos.

[Premium] Optional upscaling of small images from the Media Library to satisfy minimum image size requirements for social sharing and Schema markup.

[Premium] URL shortening with Bitly, DLMY.App, Google, Ow.ly, TinyURL, or YOURLS.

[Premium] Complete Schema JSON-LD markup for WooCommerce products (WPSSO JSON add-on required).

[Premium] Integrates with 3rd party plugins and service APIs for additional image, video, e-Commerce product details, SEO settings, etc. The following modules are included with the Premium version and automatically loaded if/when the supported plugins and/or services are required.

• Integration with 3rd Party Plugins:

  • All in One SEO Pack
  • bbPress
  • BuddyPress
  • Co-Authors Plus
  • Easy Digital Downloads
  • Gravity Forms + GravityView
  • NextCellent Gallery - NextGEN Legacy
  • NextGEN Gallery
  • Perfect WooCommerce Brands
  • Polylang
  • Product GTIN (EAN, UPC, ISBN) for WooCommerce
  • Rate my Post
  • rtMedia for WordPress, BuddyPress and bbPress
  • SEOPress
  • Simple Job Board
  • The Events Calendar
  • The SEO Framework
  • 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
  • WP Ultimate Recipe
  • WPML
  • YITH WooCommerce Brands Add-on
  • Yoast SEO
  • Yotpo Social Reviews for WooCommerce

• Integration with Service APIs:

  • Bitly
  • DLMY.App
  • Facebook Embedded Videos
  • Gravatar (Author Image)
  • Ow.ly
  • Shopper Approved (Ratings and Reviews)
  • Slideshare Presentations
  • Soundcloud Tracks (for the Twitter Player Card)
  • TinyURL
  • Vimeo Videos
  • Wistia Videos
  • WordPress Video Shortcode (and Self-Hosted Videos)
  • Your Own URL Shortener (YOURLS)
  • YouTube Videos and Playlists

Free Complementary Add-ons

Do you need even more advanced, special and unique features?

Simply activate the free complementary add-on(s) you require:

• WPSSO FAQ Manager to manage FAQ categories with Question and Answer pages.
• WPSSO Inherit Parent Metadata to inherit featured and custom images.
• WPSSO Mobile App Meta Tags to manage mobile App information.
• WPSSO Organization Markup to manage multiple Organizations.
• WPSSO Place and Local SEO Markup to manage multiple locations.
• WPSSO Product Metadata for WooCommerce to add GTIN, GTIN-8, GTIN-12 (UPC), GTIN-13 (EAN), GTIN-14, ISBN, MPN, depth, and volume for WooCommerce products and variations.
• WPSSO Ratings and Reviews to add ratings in WordPress comments.
• WPSSO REST API to add meta tags and Schema markup in REST API queries.
• WPSSO Ridiculously Responsive Social Sharing Buttons to add responsive share buttons.
• WPSSO Schema Breadcrumbs Markup to add Breadcrumbs markup for Google.
• WPSSO Schema JSON-LD Markup to provide Google with Schema markup in its preferred format.
• WPSSO Shipping Delivery Time for WooCommerce to provide Google with shipping rates and delivery time estimates.
• WPSSO Strip Schema Microdata to strip incorrect markup from templates.
• WPSSO Tune WP Image Editors for better looking WordPress thumbnails.
• WPSSO User Locale Selector to switch languages quickly and easily.

Install and Uninstall

• Install the WPSSO Core Plugin
• Uninstall the WPSSO Core Plugin

Plugin Setup

• Setup Guide
• Much Better Schema Markup for WooCommerce Products
• Integration Notes
  • BuddyPress Integration Notes
  • WooCommerce Integration Notes
• Troubleshooting Guide
• Developer Special: Buy one, Get one Free

Frequently Asked Questions

• Does LinkedIn read Facebook / Open Graph meta tags?
• How can I fix a ERR_TOO_MANY_REDIRECTS error?
• How can I fix a generic HTTP 500 error?
• How can I fix a PHP fatal "out of memory" error?
• How can I fix an HTTP error when uploading images?
• How can I have smaller dimensions for the default image?
• How can I see what the Facebook crawler sees?
• How do I enable WordPress WP_DEBUG?
• How do I fix Google Structured Data > hatom errors?
• How do I remove duplicate meta tags?
• How does WPSSO Core find and select images?
• How does WPSSO Core find and select videos?
• W3C says "there is no attribute 'property'"
• Why are some HTML elements missing or misaligned?
• Why does Facebook show the wrong image / text?
• Why does Google Structured Data Test Tool show errors?
• Why shouldn't I upload small images to the media library?

Notes and Documentation

• Developer Resources
  • Constants
  • Filters
    • All Filters
    • Filter Examples
      • Define a Custom Post Type (CPT) as a Product
      • Detect YouTube URL Links as Videos
      • Modify the "article:tag" Keywords / Names
      • Modify the Default Article Section List
      • Modify the Sharing URL
      • Remove / Fix 'hentry' Errors in your Theme Templates
      • Strip Additional Shortcodes
      • Use the REQUEST_URI for Post URLs
      • Working with Pre-defined Meta Tags and Custom Post Types
    • Filters by Category
      • Head Filters
      • Media Filters
      • Facebook / Open Graph Filters
      • Twitter Card Filters
      • Webpage Filters
    • Other Filters
  • The $mod Variable
• Inline Variables
• Multisite / Network Support

1. 

   The essential settings page offers a quick and easy setup.

2. 

   You can easily customize the details of articles, events, e-Commerce products, recipes, reviews, and much more.

3. 

   The preview tab allows you to quickly preview an example social share.

Release Schedule

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.

See release early, release often (RERO) software development philosophy on Wikipedia for more information on the benefits of smaller / more frequent releases.

Version Numbering

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

• {major} = Major structural code changes / re-writes or incompatible API 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 < a (alpha) < b (beta) < rc (release candidate).

Standard Version Repositories

• GitHub
• WordPress.org

Development Updates for Premium Users

Development, alpha, beta, and release candidate updates are available for Premium users.

Under the SSO > Update Manager settings page, select the "Development and Up" version filter for WPSSO Core and all its extensions (to satisfy any version dependencies). Save the plugin settings, and click the "Check for Plugin Updates" button to fetch the latest / current WPSSO version information. When new Development versions are available, they will automatically appear under your WordPress Dashboard > Updates page. You can always re-select the "Stable / Production" version filter at any time to re-install the last stable / production version of a plugin.

Changelog / Release Notes

Version 8.26.3 (2021/04/17)

• New Features
  • None.
• Improvements
  • Included support for custom post types that do not appear in the WordPress menu.
  • Allowed 'expired' posts to have an 'article:published_time' meta tag (expired posts are assumed to have been previously published).
• Bugfixes
  • None.
• Developer Notes
  • Added debug messages to the WpssoPost, WpssoTerm, and WpssoUser add_meta_boxes() method.
  • Added a new SucomUtilWP::get_available_languages() method.
  • Added a new SucomForm->get_checklist_post_tax_user() method.
  • Refactored the SucomForm->get_checklist_post_types() method.
• Requires At Least
  • PHP v7.0.
  • WordPress v4.5.

Version 8.26.2 (2021/04/13)

• New Features
  • None.
• Improvements
  • Added a new SSO > Tools and Actions > Clear Failed URL Connections button.
• Bugfixes
  • Fixed the default size values included in help text for the Pinterest Pin It image size option.
• Developer Notes
  • Refactored the WpssoUtilCache->clear_cache_files() method.
  • Added a new WpssoUtilCache->count_cache_files() method.
  • Added a new WpssoUtilCache->get_cache_files() method.
  • Added a new WpssoUtilCache->clear_ignored_urls() method.
  • Added a new WpssoUtilCache->count_ignored_urls() method.
  • Added a new SucomCache->clear_ignored_urls() method.
  • Added a new SucomCache->count_ignored_urls() method.
  • Added a new SucomCache->get_ignored_urls() method.
• Requires At Least
  • PHP v7.0.
  • WordPress v4.5.

Version 8.26.1 (2021/04/02)

• New Features
  • None.
• Improvements
  • Moved the SSO > Image Sizes settings to the SSO > Advanced Settings > Image Sizes tab.
  • Moved the SSO > Document Types settings to the SSO > Advanced Settings > Document Types metabox.
  • Removed the Add Pinterest "nopin" to Images option from the SSO > Essential Settings page (available in General Settings).
  • Removed the Add Hidden Image for Pinterest option from the SSO > Essential Settings page (available in General Settings).
• Bugfixes
  • Fixed an incorrect prefix for site verification meta tag names.
• Developer Notes
  • Added a new 'wpsso_og_add_wc_mt_rating' filter.
  • Added a new 'wpsso_og_add_wc_mt_reviews' filter.
• Requires At Least
  • PHP v7.0.
  • WordPress v4.5.

Version 8.25.2 (2021/03/30)

• New Features
  • None.
• Improvements
  • Added a 'wpsso_add_schema_head_attributes' filter check (true by default) before validating theme header templates.
• Bugfixes
  • Fixed plugin option pattern matching for taxonomy names ending with '_time'.
• Developer Notes
  • Added a PHP class object check before getting the post content reading time.
• Requires At Least
  • PHP v7.0.
  • WordPress v4.5.

Version 8.25.1 (2021/03/19)

• New Features
  • None.
• Improvements
  • Added an is_embed() check for the robots 'noindex' default.
• Bugfixes
  • None.
• Developer Notes
  • None.
• Requires At Least
  • PHP v7.0.
  • WordPress v4.5.

Version 8.25.0 (2021/03/11)

• New Features
  • None.
• Improvements
  • Added a new option in the Document SSO metabox for Open Graph articles:
    • Est. Reading Time
  • Added a new option under the SSO > Advanced Settings > Plugin Admin tab:
    • Use Local Plugin Translations
  • Added new options under the SSO > General Settings > Social and Search Sites > Other Sites tab:
    • Ahrefs Website Verification ID
    • Baidu Website Verification ID
    • Bing Website Verification ID
    • Yandex Website Verification ID
  • Moved customization of image sizes to the Premium version.
• Bugfixes
  • Fixed plugin conflict detection with All In One SEO v4.0.
• Developer Notes
  • None.
• Requires At Least
  • PHP v7.0.
  • WordPress v4.5.

Version 8.24.0 (2021/03/04)

• New Features
  • Added theme templates for iframe embed content with additional support for custom image URLs.
• Improvements
  • None.
• Bugfixes
  • None.
• Developer Notes
  • Added a new lib/theme-compat/embed.php template.
  • Added a new lib/theme-compat/embed-content.php template.
• Requires At Least
  • PHP v7.0.
  • WordPress v4.5.

Version 8.23.0 (2021/02/25)

• New Features
  • None.
• Improvements
  • Added business page URL options in the SSO > Social Pages settings page:
    • Medium Business Page URL
    • TikTok Business Page URL
  • Added custom contact options in the SSO > Advanced settings page (Premium version):
    • Medium URL
    • TikTok URL
  • Updated the banners and icons of WPSSO Core and its add-ons.
• Bugfixes
  • None.
• Developer Notes
  • None.
• Requires At Least
  • PHP v7.0.
  • WordPress v4.5.

Version 8.22.0 (2021/02/09)

• New Features
  • None.
• Improvements
  • None.
• Bugfixes
  • None.
• Developer Notes
  • Updated product offer methods in WpssoSchema for WPSSO JSON v4.14.0:
    • Added a new add_offers_data() method.
    • Renamed the add_aggregate_offer_data() method to add_offers_aggregate_data().
• Requires At Least
  • PHP v7.0.
  • WordPress v4.5.

Version 8.21.0 (2021/01/30)

• New Features
  • None.
• Improvements
  • None.
• Bugfixes
  • None.
• Developer Notes
  • Added new functions to retrieve Facebook / Open Graph image URLs:
    • wpsso_get_mod_og_image_url()
    • wpsso_get_post_og_image_url()
    • wpsso_get_term_og_image_url()
    • wpsso_get_user_og_image_url()
  • Added a new SucomUtil::get_first_og_image_url() method.
  • Refactored error handling and error messages in URL shortening classes (Premium version).
  • Refactored the WpssoErrorException class and added a new SucomErrorException class.
  • Refactored the WpssoCache->add_ignored_url() method to report cURL and SSL error messages.
  • Removed the 'wpsso_version_updates' action.
• Requires At Least
  • PHP v7.0.
  • WordPress v4.5.

Version 8.20.0 (2021/01/21)

• New Features
  • None.
• Improvements
  • Added support for images in WooCommerce product reviews (Premium version).
• Bugfixes
  • Fixed jQuery "document ready" event incompatibility with the block editor.
• Developer Notes
  • Added a new WpssoComment class in lib/comment.php.
  • Added support for 'is_comment' in WpssoUtil->get_type_url().
  • Added support for 'reviews-images' comment metadata in WpssoWpMeta->get_mt_comment_review().
  • Renamed WpssoPost->get_og_type_reviews() to WpssoPost->get_mt_reviews().
  • Moved WpssoPost->get_og_comment_review() to WpssoWpMeta->get_mt_comment_review().
  • Changed jQuery( document ).on( 'ready' ) event handlers to jQuery() for jQuery v3.0 compatibility.
• Requires At Least
  • PHP v7.0.
  • WordPress v4.5.

Version 8.19.4 (2021/01/17)

• New Features
  • None.
• Improvements
  • None.
• Bugfixes
  • Fixed relocation of toolbar notices in WooCommerce 4.9.0 product pages.
• Developer Notes
  • None.
• Requires At Least
  • PHP v7.0.
  • WordPress v4.5.

Version 8.19.3 (2021/01/16)

• New Features
  • None.
• Improvements
  • None.
• Bugfixes
  • None.
• Developer Notes
  • Updated the jQuery event to update toolbar notices from on( 'ready' ) to on( 'load' ).
• Requires At Least
  • PHP v7.0.
  • WordPress v4.5.

Version 8.19.2 (2021/01/11)

• New Features
  • None.
• Improvements
  • None.
• Bugfixes
  • None.
• Developer Notes
  • Updated jQuery( document ).ready() calls to jQuery( document ).on( 'ready' ).
• Requires At Least
  • PHP v7.0.
  • WordPress v4.5.

Version 8.19.1 (2021/01/07)

• New Features
  • None.
• Improvements
  • Sorted transient labels in the SSO > Dashboard > Cache Status metabox.
• Bugfixes
  • Fix to allow the new "Disable Cache for Debugging" option to be changed in the Standard version.
• Developer Notes
  • None.
• Requires At Least
  • PHP v7.0.
  • WordPress v4.5.

Version 8.19.0 (2020/12/29)

• New Features
  • None.
• Improvements
  • Added a new "Disable Cache for Debugging" option in the SSO > Advanced Settings page.
• Bugfixes
  • Fixed a missing 'article:modified_time' meta tag value.
• Developer Notes
  • Added a Wpsso->get_const_status_bool() method.
  • Added a Wpsso->get_const_status_transl() method.
  • Added a WpssoUtil->rename_options_by_ext() method.
  • Added a WpssoUtil->rename_options_keys() method.
  • Added a WpssoUtilCache->expire_zero_filters() method.
  • Added a WpssoWpMeta->is_upgrade_options_required() method.
  • Added support for a new WPSSO_CACHE_DISABLE constant.
  • Refactored the WpssoWpMeta->upgrade_options() method.
  • Removed the WpssoUtil->disable_cache_filters() method.
  • Removed the WpssoUtil->rename_opts_by_ext() method.
  • Removed the SucomUtil::rename_keys() method.
  • Renamed the WPSSO_CACHEDIR constant to WPSSO_CACHE_DIR.
  • Renamed the WPSSO_CACHEURL constant to WPSSO_CACHE_URL.
• Requires At Least
  • PHP v7.0.
  • WordPress v4.5.

Version 8.18.0 (2020/12/17)

• New Features
  • None.
• Improvements
  • Updated product information text in the Document SSO metabox for WooCommerce (Premium version).
• Bugfixes
  • None.
• Developer Notes
  • Added a minimum version check for WooCommerce detection in the WpssoCheck->get_avail() method.
  • Added $single = false argument to the WpssoSchema->get_json_data() method.
  • Added $output = 'objects' argument to the WpssoPost->get_primary_terms() method.
  • Added a new WpssoPost->get_default_term_id() method.
  • Refactored the WpssoPost->get_primary_term_id() method.
  • Refactored the WpssoPost->get_primary_terms() method.
  • Renamed the SucomUtil::get_site_url() method to SucomUtil::get_home_url().
  • Removed the SucomUtil::get_query_salt() method.
  • Removed deprecated methods from 2019.
• Requires At Least
  • PHP v7.0.
  • WordPress v4.5.

Version 8.17.1 (2020/12/13)

• New Features
  • None.
• Improvements
  • None.
• Bugfixes
  • Fixed an incorrect 'wpsso_post_url' argument count in the NextGEN Gallery integration module (Premium version).
• Developer Notes
  • None.
• Requires At Least
  • PHP v5.6.
  • WordPress v4.5.

Version 8.17.0 (2020/12/11)

• New Features
  • None.
• Improvements
  • None.
• Bugfixes
  • Fixed canonical and sharing URL pagination.
  • Fixed Schema SearchResultsPage markup to use the search query.
• Developer Notes
  • Added new $mod array elements:
    • 'query_vars'
    • 'is_404'
    • 'is_search'
    • 'is_archive'
    • 'is_date'
    • 'is_year'
    • 'is_month'
    • 'is_day'
  • Added a new SucomUtilWP::doing_ajax() method.
  • Added a new SucomUtilWP::doing_cron() method.
  • Added a new SucomUtilWP::doing_autosave() method.
  • Refactored the WpssoUtil->get_page_url() method.
  • Refactored the WpssoUtil->get_url_paged() method.
  • Refactored the WpssoUtil->get_request_url() method.
  • Refactored and moved WpssoUtil->get_page_posts_mods() to WpssoPage->get_posts_mods().
  • Removed the 'wpsso_server_request_url_cache_disabled' filter.
  • Removed the $add_page argument from the following filters:
    • 'wpsso_post_url'
    • 'wpsso_home_url'
    • 'wpsso_term_url'
    • 'wpsso_user_url'
    • 'wpsso_search_url'
    • 'wpsso_archive_page_url'
  • Removed the $posts_per_page and $paged arguments from the following methods:
    • WpssoPost->get_posts_ids()
    • WpssoTerm->get_posts_ids()
    • WpssoUser->get_posts_ids()
  • Removed the $posts_per_page argument from the following methods:
    • WpssoSchema->add_itemlist_data()
    • WpssoSchema->add_posts_data()
  • Removed the WpssoSchema->add_page_links() method.
  • Removed the $wpsso_paged global variable.
  • Renamed the WPSSO_SCHEMA_REVIEWS_PER_PAGE_MAX constant to WPSSO_SCHEMA_REVIEWS_MAX.
  • Updated the 'pre_update_option_active_plugins' filter hook fallback to sorting like WordPress (instead of leaving the order as-is).
• Requires At Least
  • PHP v5.6.
  • WordPress v4.5.

Version 8.16.0 (2020/12/08)

• New Features
  • None.
• Improvements
  • Renamed the "Product Category" option to "Product Type" in the Document SSO metabox.
  • Added a new "Primary Category" option in the Document SSO metabox.
  • Added support for the Yoast SEO primary category value (Premium version).
  • Added support for the SEO Framework primary category value (Premium version).
  • Added support for the SEOPress primary category value (Premium version).
  • Added a new integration module for Rank Math SEO to provide a primary category value (Premium version).
• Bugfixes
  • Fixed a duplicate meta name="author" meta tag from SEOPress.
• Developer Notes
  • Refactored the WpssoPost->get_primary_term_id() method.
  • Added a new WpssoPost->get_primary_terms() method.
  • Added a new wpsso_get_post_primary_category() function.
  • Added a new 'wpsso_primary_tax_slug' filter.
  • Added a new 'wpsso_primary_term_id' filter.
  • Added a new 'wpsso_primary_terms' filter.
• Requires At Least
  • PHP v5.6.
  • WordPress v4.5.

Version 8.15.0 (2020/12/05)

• New Features
  • None.
• Improvements
  • Added a new SSO > Advanced Settings > Services API metabox.
• Bugfixes
  • None.
• Developer Notes
  • Added a new WpssoPost->get_primary_term_id() method.
• Requires At Least
  • PHP v5.6.
  • WordPress v4.4.

Version 8.14.1 (2020/11/30)

• New Features
  • None.
• Improvements
  • Improved suggested add-on notifications for the WooCommerce plugin.
• Bugfixes
  • Fixed an "undeclared static property: SucomUtilRobots::$directives" error.
• Developer Notes
  • None.
• Requires At Least
  • PHP v5.6.
  • WordPress v4.4.

Version 8.14.0 (2020/11/26)

• New Features
  • Added WP Sitemaps filters to add article modified dates, and exclude posts / pages, terms, and users with 'noindex' checked under the Document SSO > Robots Meta tab.
• Improvements
  • Added a possible 'disabled' status light (Yellow) in the SSO > Features Status page.
  • Added new features in the SSO > Features Status > Standard Features metabox:
    • Link Relation URL Tags
    • oEmbed Response Enhancements
    • Pinterest / SEO Meta Name Tags
    • Post, Term, and User Robots Meta
    • WP Sitemaps Enhancements
• Bugfixes
  • None.
• Developer Notes
  • Added a new WpssoUtilRobots class.
  • Added a new SucomUtilRobots class (extended by WpssoUtilRobots).
  • Added a new WpssoProUtilCheckImgDims class (Premium version).
  • Added an update option 'active_plugins' filter to sort the WPSSO Core plugin before its add-ons.
  • Added a new Wpsso->id variable to replace Wpsso->lca (now deprecated).
  • Removed the WpssoConfig::$cf[ 'lca' ] array element (deprecated in 2017).
• Requires At Least
  • PHP v5.6.
  • WordPress v4.4.

Version 8.13.0 (2020/11/20)

This release includes a new "Validators" toolbar menu and several changes to the Advanced Settings page.

• New Features
  • Added a "Validators" menu in the top toolbar.
• Improvements
  • Added a "Show Validators Toolbar Menu" option under the new SSO > Advanced Settings > Interface tab.
  • Moved all options from the SSO > Advanced Settings > Table Columns tab to the new Interface tab (removing the Table Columns tab).
  • Moved all options from the SSO > Advanced Settings > Content and Text tab to the Integration tab (removing the Content and Text tab).
  • Moved the "Default Currency" option to the SSO > General Settings > Site Information tab.
  • Moved the "Check for Embedded Media" options to the SSO > Advanced Settings > Service APIs tab.
  • Moved the "Plugin Options to Show by Default" options to the new SSO > Advanced Settings > Interface tab.
  • Moved the "Show Document SSO Metabox" option to the new SSO > Advanced Settings > Interface tab.
  • Moved the "Import Yoast SEO Social Meta" and "Show Yoast SEO Import Details" options to the SSO > Advanced Settings > Integration tab.
  • Removed the "Notification System" option.
  • Removed the "<head> Attributes Filter Hook" option.
  • Removed the "<html> Attributes Filter Hook" option.
• Bugfixes
  • None.
• Developer Notes
  • None.
• Requires At Least
  • PHP v5.6.
  • WordPress v4.4.

Version 8.12.1 (2020/11/13)

This release adds a new SSO > Features Status page and integration module for SEOPress (Premium version).

• New Features
  • None.
• Improvements
  • Added a new SSO > Features Status page.
  • Added an integration module for SEOPress (Premium version).
  • Replaced the status light images in the SSO > Features Status page by CSS background colors.
• Bugfixes
  • None.
• Developer Notes
  • Added a new lib/conflict-seo.php library file.
  • Added a new WpssoWpMeta::get_mod_meta() method for SEO integration modules.
  • Re-ordered the default options in lib/config.php.
• Requires At Least
  • PHP v5.6.
  • WordPress v4.4.

Version 8.11.2 (2020/11/07)

• New Features
  • None.
• Improvements
  • The "Enforce Image Dimension Checks" option is now disabled by default.
• Bugfixes
  • Fixed an undefined index streamingData error in cases where YouTube video details are incomplete or could not be retrieved.
• Developer Notes
  • Added new SucomAddon->get_ext() and SucomAddon->get_p_ext() methods to retrieve those property values.
• Requires At Least
  • PHP v5.6.
  • WordPress v4.4.

Version 8.11.1 (2020/10/31)

• New Features
  • None.
• Improvements
  • None.
• Bugfixes
  • Fixed incorrect array type casting when retrieving custom event or job options.
• Developer Notes
  • None.
• Requires At Least
  • PHP v5.6.
  • WordPress v4.4.

Version 8.11.0 (2020/10/29)

• New Features
  • None.
• Improvements
  • Added extra article and product Twitter Card meta tags for Slack.
• Bugfixes
  • Fixed formatting of the Schema 'cutoffTime', 'opens', and 'closes' property values.
• Developer Notes
  • Refactored the WpssoTwitter->get_array() method.
• Requires At Least
  • PHP v5.6.
  • WordPress v4.4.

Version 8.10.0 (2020/10/28)

• New Features
  • None.
• Improvements
  • Added 'businessDays' and 'cutoffTime' to Schema ShippingDeliveryTime markup for the WPSSO Shipping Delivery Time for WooCommerce add-on.
• Bugfixes
  • None.
• Developer Notes
  • Added a new 'wpsso_schema_type_for_post_type_{post_type}' filter.
  • Added a new WpssoSchemaSingle::get_opening_hours_data() method.
  • Removed arguments from the WpssoUtil->add_plugin_image_sizes() method as they are not required.
  • Updated the SucomUtil::preg_grep_keys() method to handle a replacement string or array.
  • Shortened Schema '@id' property values by removing the home URL prefix.
• Requires At Least
  • PHP v5.6.
  • WordPress v4.4.

Version 8.9.0 (2020/10/24)

• New Features
  • None.
• Improvements
  • Updated the markdown library used to parse WordPress readme files.
  • Added a check for the post status before retrieving Shopper Approved ratings and reviews (Premium version).
• Bugfixes
  • None.
• Developer Notes
  • Re-added the WpssoUtil::save_all_times() deprecated method for old add-ons.
  • Refactored lib/ext/markdown.php to use lib/ext/markdown/MarkdownExtra.inc.php.
  • Refactored the SucomForm->get_select_timezone() method.
  • Added a new SucomUtilWP::get_timezones() method.
  • Added a new SucomUtilWP::get_default_timezone() method.
• Requires At Least
  • PHP v5.6.
  • WordPress v4.4.

Version 8.8.1 (2020/10/17)

• New Features
  • Added a new WPSSO Shipping Delivery Time for WooCommerce add-on.
• Improvements
  • None.
• Bugfixes
  • Fixed backwards compatibility with older 'init_objects' and 'init_plugin' action arguments.
• Developer Notes
  • Added a new WpssoAddOn class in lib/abstracts/add-on.php.
  • Added a new SucomAddOn class in lib/abstracts/com/add-on.php.
• Requires At Least
  • PHP v5.6.
  • WordPress v4.4.

Version 8.7.1 (2020/10/04)

• New Features
  • None.
• Improvements
  • Added a check for WooCommerce shipping requirements (ie. coupon and/or minimum amount) when getting shipping rates (Premium version).
• Bugfixes
  • None.
• Developer Notes
  • None.
• Requires At Least
  • PHP v5.6.
  • WordPress v4.4.

Version 8.7.0 (2020/10/02)

Added support for the new Schema shippingDetails property in Schema Product offers for WooCommerce products. Note that Google is now showing shipping costs from Schema markup in search results.

• New Features
  • None.
• Improvements
  • Added support for the new Schema shippingDetails property in Schema Product offers for WooCommerce products, including shippingRate values by currency, and shippingDestination with countries, states, and postal code limits (Premium version).
• Bugfixes
  • Fixed a bug that prevented abbreviated Schema enumerations from being detected (ie. New and NewCondition as abbreviations for https://schema.org/NewCondition).
• Developer Notes
  • Deprecated the wpsso_is_mobile() function.
  • Deprecated the SucomUtil::is_mobile() method.
  • Deprecated the SucomUtil::is_desktop() method.
  • Removed the lib/ext/mobile-detect.php library file.
• Requires At Least
  • PHP v5.6.
  • WordPress v4.4.

Version 8.6.0 (2020/09/25)

The minimum WordPress version has been increased from v4.2 to v4.4.

• New Features
  • None.
• Improvements
  • Added a new "Webpage Document Title" option under the SSO > Advanced Settings > Content and Text tab.
  • Added WooCommerce product shipping data (zone, class, methods, and locations) for the WPSSO JSON v4.4.0 add-on (Premium version).
• Bugfixes
  • Fixed incorrect Schema AggregateRating meta tag markup when the WPSSO JSON add-on is not active.
  • Fixed an "undeclared static property" error in the SSO > Dashboard page.
• Developer Notes
  • None.
• Requires At Least
  • PHP v5.6.
  • WordPress v4.4.

Version 8.5.1 (2020/09/18)

The SSO > Setup Guide content is now available for translation. If you are fluent in a language other than English, and would like to assist translating the WPSSO Core option labels, help text, notice messages, or Setup Guide, you can contribute to the translation of WPSSO Core here.

• New Features
  • None.
• Improvements
  • Additional translation string updates for the SSO > Setup Guide.
  • Added an acknowledgement message when the Site Address URL value has changed.
  • Added new Schema Review sub-types:
    • https://schema.org/CriticReview
    • https://schema.org/EmployerReview
    • https://schema.org/MediaReview
    • https://schema.org/Recommendation
    • https://schema.org/UserReview
• Bugfixes
  • Fixed All in One SEO Pack plugin detection by using the "AIOSEOP_Core" class name.
  • Fixed Squirrly SEO conflict notification texts and links for the latest version of Squirrly SEO.
• Developer Notes
  • Added enqueue recursion to work around the Squirrly SEO fixEnqueueErrors() and clearStyles() methods that break toolbar notifications.
  • Added a new WpssoAdminFilters class in lib/admin-filters.php.
  • Added a new WPSSO_ADMIN_SCRIPTS_PRIORITY constant.
  • Added a new WPSSO_BLOCK_ASSETS_PRIORITY constant.
  • Renamed the WPSSO_SEO_SEED_FILTERS_PRIORITY constant to WPSSO_SEO_SEED_PRIORITY.
• Requires At Least
  • PHP v5.6.
  • WordPress v4.2.

Version 8.5.0 (2020/09/15)

The SSO > Setup Guide content is now available for translation and the complete French translation of the Setup Guide will be available shortly. If you are fluent in a language other than English, and would like to assist translating the WPSSO Core option labels, help text, notice messages, or Setup Guide, you can contribute to the translation of WPSSO Core here.

• New Features
  • None.
• Improvements
  • Added translation support for the SSO > Setup Guide page.
  • Moved the SSO > Advanced Settings > Document Types metabox to a new SSO > Document Types settings page.
• Bugfixes
  • Fixed an incorrect "The value of option must be numeric" error message for 'robots_max_snippet' and 'robots_max_video_preview' when saving posts.
• Developer Notes
  • Moved extracted translation strings from lib/gettext-*.php files to a new gettext/ folder.
  • Added a new gettext/gettext-html-setup.php file to translate the Setup Guide.
• Requires At Least
  • PHP v5.6.
  • WordPress v4.2.

Version 8.4.1 (2020/09/11)

This release adds a new "Robots Meta" tab in the Document SSO metabox with options for Google Search and other search engine robots.

This release also fixes an important bug, introduced in v8.3.0, that prevented getting archive post objects when not in an archive page.

• New Features
  • Added a new "Robots Meta" tab in the Document SSO metabox with options for Google Search:
    • No Archive
    • No Follow
    • No Image Index
    • No Index
    • No Snippet
    • No Translate
    • Snippet Max. Length
    • Image Preview Size
    • Video Max. Previews
  • Added new options under the SSO > General Settings > Google tab:
    • Robots Snippet Max. Length
    • Robots Image Preview Size
    • Robots Video Max. Previews
• Improvements
  • Added a dismissible notice if the "meta name robots" HTML tag and a known SEO plugin has not been detected.
  • Removed the "Robots" options from the classic editor Publish metabox.
  • Replaced the option tooltip help image with a font.
• Bugfixes
  • Fixed an important bug, introduced in v8.3.0, that prevented getting archive post objects when not in an archive page.
  • Fixed the top toolbar overlaying the block editor in fullscreen mode when there are SSO notifications.
• Developer Notes
  • Refactored the WpssoSchema::get_page_posts_mods() method to allow getting archive post objects when not in an archive page.
  • Refactored SucomUtil::get_robots_default_directives() to include disabled directives as well.
  • Refactored WpssoUtil::get_robots_content() to use custom options from the Document SSO metabox.
  • Added a post/term/user ID argument to the WpssoWpMeta->upgrade_options() method.
  • Added new get_meta(), update_meta(), and delete_meta() static methods in the WpssoWpMeta, WpssoPost, WpssoTerm, and WpssoUser classes.
  • Moved the get_attached(), add_attached(), and delete_attached() static methods from the WpssoPost, WpssoTerm, and WpssoUser classes to the WpssoWpMeta class.
  • Changed WpssoWpMeta->must_be_extended() to a WpssoWpMeta::must_be_extended() static method.
  • Removed the WpssoPost->show_robots_options() and WpssoPost->save_robots_options() methods (replaced by the "Robots Meta" tab in the Document SSO metabox).
  • Added custom CSS filters for Yoast SEO and Rank Math in the WpssoCompat class.
• Requires At Least
  • PHP v5.6.
  • WordPress v4.2.

Version 8.3.1 (2020/09/06)

• New Features
  • None.
• Improvements
  • Improved the CSS of plugin settings pages.
  • Improved the notice reference message when adding Schema Organization, Person, and Place markup.
  • Updated the SSO menu and toolbar notification icons.
• Bugfixes
  • None.
• Developer Notes
  • Added SucomNotice->is_enabled(), SucomNotice->enable(), and SucomNotice->disable() methods for WPSSO REST v2.6.1.
• Requires At Least
  • PHP v5.6.
  • WordPress v4.2.

Version 8.3.0 (2020/09/05)

• New Features
  • None.
• Improvements
  • Updated the cleanup method for Rank Math to remove only the Facebook and Twitter meta tags.
• Bugfixes
  • Fixed the Schema markup user profile query to include only posts and not pages.
• Developer Notes
  • Added a new SucomUtil::get_wp_url() method.
  • Refactored the SucomUtil::is_toplevel_edit() method.
  • Refactored the WpssoUtil->get_page_url() method to handle 'is_search' and 'is_date' module array elements.
  • Refactored the WpssoPage->get_description() method to handle 'is_search' and 'is_date' module array elements.
  • Refactored the WpssoPage->get_the_title() method to handle 'is_search' and 'is_date' module array elements.
  • Added a lib/compat.php library file for 3rd party plugin and theme compatibility actions and filters.
• Requires At Least
  • PHP v5.6.
  • WordPress v4.2.

Version 8.2.2 (2020/08/28)

• New Features
  • None.
• Improvements
  • None.
• Bugfixes
  • Fixed the Shopper Approved integration modules to skip the WooCommerce shop archive page (Premium version).
• Developer Notes
  • None.
• Requires At Least
  • PHP v5.6.
  • WordPress v4.2.

Version 8.2.1 (2020/08/15)

Google has updated their Rich Results requirements to use the complete URL of Schema enumeration values instead of only the enumeration name (as they previously required). The product availability, product condition, event attendance, event status, and offer availability values have all been updated to include their complete enumeration URL. For example, a previous product condition might have been 'New' or 'NewCondition' and will now be included in Schema markup as 'https://schema.org/NewCondition'.

• New Features
  • None.
• Improvements
  • Added 'https://schema.org/' to the Schema item availability, item condition, event attendance, and event status property values.
• Bugfixes
  • Fixed a possible missing 'publisher' property for the Schema Article type.
• Developer Notes
  • Added a new 'wpsso_sanitize_md_options' filter hook in WpssoSchema to sanitize the post metadata product availability and condition values.
  • Added a new WpssoSchema::check_prop_value_enumeration() method.
  • Deprecated the WpssoSchema::check_itemprop_content_map() method.
  • Replaced the jQuery .load( handler ) event function trigger with .on( 'load', handler ).
  • Replaced the jQuery hover event with mouseenter in SucomForm->get_event_load_json_script().
• Requires At Least
  • PHP v5.6.
  • WordPress v4.2.

Version 8.1.0 (2020/08/13)

• New Features
  • None.
• Improvements
  • Added new options under SSO > Advanced Settings > Shopper Approved (Premium version):
    • Maximum Number of Reviews (100)
    • Maximum Age of Reviews (60) months
• Bugfixes
  • Fixed a PHP fatal error for SucomUtil::preg_grep_keys() when adding a custom video from the Document SSO metabox.
• Developer Notes
  • Added extra checks and debugging messages for a possible invalid video array from the WpssoOpenGraph->get_all_videos() method.
• Requires At Least
  • PHP v5.6.
  • WordPress v4.2.

Version 8.0.0 (2020/08/11)

Google has updated their Rich Results requirements and now prefers 1:1, 4:3, and 16:9 images for all Schema types, not just the Schema Article type for AMP webpages. The "Schema" and "Schema Article" image sizes have been removed and replaced by new Schema 1:1, 4:3, and 16:9 image sizes (minimum dimensions are 1200x1200px, 1200x900px, and 1200x675px).

The WP eCommerce plugin is no longer supported (last update in January 2019) and the WPSSO Core Premium integration module for WP eCommerce has been removed.

• New Features
  • Added an API integration module for Shopper Approved ratings and reviews. See the SSO > Advanced Settings > Service APIs tab to enter your Shopper Approved API token and enabled reviews for specific post types (Premium version).
• Improvements
  • Added a new "Gravatar Image Size" option (default is 1200px).
  • Added shortening service API status to the SSO > Dashboard > Premium Features Status metabox:
    • Bitly Shortener API
    • DLMY.App Shortener API
    • Ow.ly Shortener API
    • TinyURL Shortener API
    • YOURLS Shortener API
  • Renamed the following SSO > Image Sizes:
    • Schema Article AMP 1:1 to Schema 1:1 (Google)
    • Schema Article AMP 4:3 to Schema 4:3 (Google)
    • Schema Article AMP 16:9 to Schema 16:9 (Google)
  • Removed the following SSO > Image Sizes:
    • Schema
    • Schema Article
  • Removed the "Schema Image URL" option in the Document SSO metabox.
  • Removed the WPSSO Core Premium integration module for the WP eCommerce plugin (Premium version).
  • Removed the SSO > Advanced Settings > Cache > Clear All Caches on Save Settings option (Premium version).
• Bugfixes
  • Fixed incorrect sanitation of plugin settings for multisite blogs.
• Developer Notes
  • Added a new WpssoUtilMetabox class.
  • Added a new WpssoProUtilShorten->load_lib() method.
  • Added new WpssoSchema::is_valid_key() and is_valid_val() methods.
  • Renamed the WpssoProUtilShorten->set_instance() method to get_svc_instance().
  • Refactored WpssoProUtilShorten->get_svc_instance() to use the new self->load_lib() method.
  • Added more debugging messages to the WpssoProEcomWooCommerce class for missing product class methods (Premium version).
  • Added a 'label_transl' key to the $features array for the SSO > Dashboard > Premium Features Status metabox.
  • Refactored the Gravatar integration module to always fallback to the "mystery person" image.
  • Refactored the WpssoMedia->get_featured() method to use a local cache to avoid duplicate database queries.
  • Refactored the WpssoMedia->get_attached_images() method to use a local cache to avoid duplicate database queries.
• Requires At Least
  • PHP v5.6.
  • WordPress v4.2.