WPSSO Core | Complete Structured Data – Meta Tags, oEmbed, REST API, Rich Pins, Rich Results, Schema JSON-LD, Twitter Cards, XML

Changelog

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 Edition Repositories

• GitHub
• WordPress.org

Development Version Updates

WPSSO Core Premium customers have access to development, alpha, beta, and release candidate version updates:

Under the SSO > Update Manager settings page, select the “Development and Up” (for example) version filter for the WPSSO Core plugin and/or its add-ons. Save the plugin settings and click the “Check for Plugin Updates” button to fetch the latest version information. When new development versions are available, they will automatically appear under your WordPress Dashboard > Updates page. You can always reselect the “Stable / Production” version filter at any time to reinstall the latest stable version.

Changelog / Release Notes

Version 9.15.0-b.1 (2022/01/26)

• New Features
  • Added a new “Import Yoast SEO Block Attrs” option under the SSO > Advanced Settings > Plugin Settings > Integration tab.
• Improvements
  • None.
• Bugfixes
  • None.
• Developer Notes
  • Added a new WpssoSchema->get_mod_script_type_application_ld_json_html() method.
  • Added a new WpssoAdminHeadSuggestAddons class in lib/admin-head-suggest-addons.php.
  • Added a new WpssoAdminHeadSuggestOptions class in lib/admin-head-suggest-options.php.
  • Added a new WpssoUtilBlocks class in lib/util-blocks.php.
  • Added a new WpssoProUtilWpseoBlocks class in lib/pro/util/wpseo-blocks.php (Premium edition).
  • Moved ‘.wpsso-notice.update-nag’ CSS from lib/config.php to css/com/admin-page.css.
• Requires At Least
  • PHP v7.2.
  • WordPress v5.2.

Version 9.14.2 (2022/01/23)

• New Features
  • None.
• Improvements
  • Added a new “Movie Released Date” option in the Document SSO metabox.
• Bugfixes
  • None.
• Developer Notes
  • Deprecated the following unused methods:
    • SucomUtil::get_first_num()
    • SucomUtil::get_last_num()
    • SucomUtil::get_next_num()
    • SucomUtil::get_first_last_next_nums()
• Requires At Least
  • PHP v7.2.
  • WordPress v5.2.

Version 9.14.1 (2022/01/22)

• New Features
  • None.
• Improvements
  • None.
• Bugfixes
  • Fixed an undefined property error for WpssoMessages::$doc_title_disabled.
• Developer Notes
  • Removed the following unused methods:
    • SucomUtil::maybe_link_url()
    • SucomUtil::get_first_value()
    • SucomPlugin::get_wp_plugin_dir()
    • SucomPlugin::activate_plugin()
    • SucomPlugin::is_slug_active()
    • SucomPlugin::get_slug_info()
    • SucomPlugin::get_slug_name()
    • SucomPlugin::get_slug_download_url()
    • SucomPlugin::download_and_install_slug()
    • WpssoUtil->filter_pub_lang()
  • Renamed SucomUtil::$pub_lang to SucomUtil::$publisher_languages.
  • Renamed SucomUtil::get_pub_lang() to SucomUtil::get_publisher_languages().
• Requires At Least
  • PHP v7.2.
  • WordPress v5.2.

Version 9.14.0 (2022/01/19)

• New Features
  • Added new options under the SSO > Advanced Settings > Integration tab:
    • “Import All in One SEO Pack Metadata”
    • “Import Rank Math SEO Metadata”
    • “Import The SEO Framework Metadata”
• Improvements
  • Removed the Document SSO > Head Markup tab and renamed all other Document SSO metabox tabs (including their labels, keys, and filters).
  • Renamed the “Import Yoast SEO Social Meta” option to “Import Yoast SEO Metadata”.
  • Removed the “Show Yoast SEO Import Details” option.
• Bugfixes
  • Fixed addition of sameAs URLs for post ID 0.
• Developer Notes
  • Added a new WpssoProUtilAbstractSeoMeta abstract class.
  • Added a new WpssoProUtilAioseopMeta class to import All in One SEO Pack metadata.
  • Added a new WpssoProUtilRankmathMeta class to import Rank Math SEO metadata.
  • Added a new WpssoProUtilSeoframeworkMeta class to import The SEO Framework metadata.
  • Refactored the WpssoProUtilWpseoMeta class to import Yoast SEO metadata.
  • Renamed lib/abstracts/ folder to lib/abstract/.
  • Renamed the SucomAddOn class to SucomAbstractAddOn.
  • Renamed the WpssoAddOn class to WpssoAbstractAddOn.
  • Renamed the WpssoWpMeta class to WpssoAbstractWpMeta.
  • Renamed the ‘plugin_wpseo_social_meta’ options key to ‘plugin_import_wpseo_meta’.
  • Removed the ‘plugin_wpseo_show_import’ options key.
• Requires At Least
  • PHP v7.2.
  • WordPress v5.2.

Version 9.13.1 (2022/01/13)

• New Features
  • None.
• Improvements
  • Updated “Organization Schema Type” option help text.
• Bugfixes
  • Fixed the addition of WPSSO OPM places in the Document SSO metabox “Select a Place” option.
• Developer Notes
  • Refactored the WpssoMessages->maybe_ext_required() method.
  • Refactored the WpssoUtil->get_form_cache() method to replace self::$form_cache with a static $local_cache variable.
• Requires At Least
  • PHP v7.2.
  • WordPress v5.2.

Version 9.13.0 (2022/01/06)

• New Features
  • None.
• Improvements
  • WP List Table changes (columns can be enabled/disabled from the SSO > Advanced > Interface tab):
    • Added a new ‘Schema Type’ column.
    • Renamed the ‘Schema’ column to ‘Schema ID’.
    • Renamed the ‘Open Graph’ column to ‘OG ID’.
• Bugfixes
  • None.
• Developer Notes
  • Refactored the WpssoSchema->get_mod_schema_type() method for backwards compatibility with older WPSSO JSON versions.
  • Refactored the WpssoOpenGraph->get_mod_og_type() method.
  • Added a new WpssoOpenGraph->get_mod_og_type_id() method.
  • Added a new WpssoOpenGraph->get_mod_og_type_ns() method.
• Requires At Least
  • PHP v7.2.
  • WordPress v5.2.

Version 9.12.4 (2022/01/03)

• New Features
  • None.
• Improvements
  • Added extra config sanitation in case an add-on config is incomplete.
  • Added WPSSO JSON update URL to config for older WPSSO JSON versions.
• Bugfixes
  • None.
• Developer Notes
  • None.
• Requires At Least
  • PHP v7.2.
  • WordPress v5.2.

Version 9.12.3 (2021/12/21)

• New Features
  • None.
• Improvements
  • Added support for the WPSSO OPM add-on when checking for required organization logo / banner images in WpssoSchemaSingle::add_organization_data().
• Bugfixes
  • None.
• Developer Notes
  • None.
• Requires At Least
  • PHP v7.2.
  • WordPress v5.2.

Version 9.12.2 (2021/12/17)

• New Features
  • None.
• Improvements
  • None.
• Bugfixes
  • None.
• Developer Notes
  • Added a WpssoOptions->set_version() method for the new WPSSO OPM add-on.
  • Updated / added SucomUtilWP static methods for the new WPSSO OPM add-on:
    • raw_update_post()
    • raw_update_post_title()
    • raw_update_post_title_content()
• Requires At Least
  • PHP v7.2.
  • WordPress v5.2.

Version 9.12.1 (2021/12/17)

• New Features
  • None.
• Improvements
  • None.
• Bugfixes
  • Fixed incorrect variable usage in WpssoSchemaSingle::add_job_data().
• Developer Notes
  • None.
• Requires At Least
  • PHP v7.2.
  • WordPress v5.2.

Version 9.12.0 (2021/12/16)

• New Features
  • None.
• Improvements
  • Extended the “WP List Table Columns” option, under the SSO > Advanced Settings > Interface tab, with custom post and taxonomy types.
  • Refactored the handling of disabled form fields by using a ‘disabled’ CSS class.
• Bugfixes
  • None.
• Developer Notes
  • Added a new SucomForm->get_columns_post_tax_user() method.
  • Added the ‘wpsso_import_custom_fields’ filter to the WpssoWpMeta->get_defaults() method.
  • Renamed disabled option key suffix from ":is" = "disabled" to ":disabled" = true.
  • Removed the ‘wpsso_schema_types_select’ filter.
• Requires At Least
  • PHP v7.2.
  • WordPress v5.2.

Version 9.11.0 (2021/12/08)

The default format of Schema and Open Graph types in select drop-downs has changed from “ID | Host/Name” to simply “Name”. If you prefer the older format, you can choose different formats under the SSO > Advanced Settings > Interface tab.

• New Features
  • None.
• Improvements
  • Added new options under the SSO > Advanced Settings > Interface tab:
    • Schema Type Select Format
    • Open Graph Type Select Format
• Bugfixes
  • None.
• Developer Notes
  • Added a new SucomUtilWP::get_update_meta_cache() method.
  • Added a new SucomUtilWP::raw_metadata_exists() method.
  • Changed comment cache clearing by using the WordPress ‘comment_post’ and ‘transition_comment_status’ action hooks instead of ‘clean_comment_cache’.
  • Optimized loading of post, term, and user editing page metaboxes.
• Requires At Least
  • PHP v7.2.
  • WordPress v5.2.

Version 9.10.1 (2021/12/01)

• New Features
  • None.
• Improvements
  • The Document SSO metabox now shows default option values when creating new post / pages (ie. for the ‘auto-draft’ status).
  • The Validators toolbar menu now refreshes when the post / page is saved in the Block Editor (validation links are available for published posts).
  • Added new options under the SSO > Advanced Settings > Integration tab:
    • Inherit Featured Image
    • Inherit Custom Images
• Bugfixes
  • None.
• Developer Notes
  • Added a ‘wp_after_insert_post’ hook to update the default meta tag values for ‘auto-draft’ posts.
  • Updated the jQuery wpssoBlockEditor.refreshPostbox function to call sucomToolbarValidators().
  • Added a new jQuery sucomToolbarValidators() method in js/com/jquery-admin-page.js.
  • Added a new ‘wpsso_inherit_featured_image’ and ‘wpsso_inherit_custom_images’ filter.
• Requires At Least
  • PHP v7.2.
  • WordPress v5.2.

Version 9.9.0 (2021/11/27)

• New Features
  • None.
• Improvements
  • None.
• Bugfixes
  • None.
• Developer Notes
  • Added a wpssoBlockEditor “namespace” to the js/jquery-block-editor.js script.
  • Updates to rename the javascript sucomAdminPageL10n variable to wpssoAdminPageL10n:
    • Added a new ‘admin_l10n’ element in the plugin config array.
    • Added a new ‘wpsso-metabox’ script in ‘js/jquery-metabox.js’.
    • Added a new SucomForm->set_admin_l10n() method.
    • Added a new SucomForm->get_plugin_admin_l10n() method.
    • Updated the wp_localize_script() for ‘sucom-admin-page’ to use the new ‘admin_l10n’ config value.
    • Updated SucomForm::get_no_input_clipboard() calls to SucomForm->get_no_input_clipboard().
    • Renamed the SucomForm->get_menu_ext() method to SucomForm->get_ext_id().
• Requires At Least
  • PHP v7.2.
  • WordPress v5.2.

Version 9.8.1 (2021/11/20)

• New Features
  • None.
• Improvements
  • Updated the Google product taxonomy IDs.
  • Added a new “Flush Rewrite Rules” button in the SSO > Tools and Actions page.
  • Removed Open Graph, Pinterest, Twitter, and some Schema options in the Document SSO metabox for non-public content.
• Bugfixes
  • Fixed incorrect reenabling of the ‘Schema Type’ option when purposely disabled for a fixed content type.
• Developer Notes
  • None.
• Requires At Least
  • PHP v7.2.
  • WordPress v5.2.

Version 9.8.0 (2021/11/16)

• New Features
  • Moved the WordPress Sitemaps features to a new WPSSO WP Sitemaps XML add-on.
• Improvements
  • Added Schema Review subject type check, and issue a warning if not supported by Google.
  • Updated the Yoast SEO integration modules to import or filter the ‘noindex’ value (Premium edition).
• Bugfixes
  • None.
• Developer Notes
  • Added a new WpssoAdminHeadSuggest class.
  • Added a new ‘wpsso_robots_is_noindex’ filter.
  • Added a new WpssoUtil->get_available_feed_locale_names() method (filtered by the Polylang and WPML integration modules).
  • Added a new WpssoUtilRobots->is_disabled() method.
  • Added a new WpssoUtilRobots->is_enabled() method.
  • Added a new WpssoUtilWP::sitemaps_disabled() method.
  • Refactored the WpssoUtilRobots->get_directives() method.
  • Refactored the WpssoUtilRobots->is_noindex() method.
  • Refactored the SucomAddOn->get_missing_requirements() method.
• Requires At Least
  • PHP v7.2.
  • WordPress v5.2.

Version 9.7.0 (2021/11/10)

• New Features
  • None.
• Improvements
  • Added new Product options in the Document SSO metabox:
    • Product Pattern
    • Product Size Type
• Bugfixes
  • Fixed incorrect parent-child inheritance of custom metadata.
• Developer Notes
  • Added new filter hooks:
    • ‘wpsso_cache_cleared_notice’
    • ‘wpsso_cache_refreshed_notice’
  • Added a new WpssoOpenGraph->get_product_retailer_category() method.
  • Added a new WpssoOpenGraph->get_product_retailer_categories() method.
• Requires At Least
  • PHP v7.0.
  • WordPress v5.0.

Version 9.6.0 (2021/11/05)

• New Features
  • None.
• Improvements
  • Document SSO > Priority Media tab options changes:
    • Added a new Video Stream URL option.
    • Show the Twitter Card and Pinterest options by default.
    • Moved the following options to the Customize tab:
      • Maximum Images
      • Maximum Videos
      • Include Video Previews
  • Removed the SSO > General Settings > Google > Schema Max. Images to Include option. Schema markup will use the default Maximum Images to Include option value from the SSO > General Settings > Images tab.
• Bugfixes
  • Fixed the disabled “or an Image URL” options under the Document SSO > Priority Media tab.
• Developer Notes
  • Renamed the ‘plugin_upscale_img_max’ options key to ‘plugin_upscale_pct_max’.
• Requires At Least
  • PHP v7.0.
  • WordPress v5.0.

Version 9.5.0 (2021/11/02)

• New Features
  • Discontinued the WPSSO IPM add-on:
    • All features of the WPSSO Inherit Parent Metadata add-on were integrated into the WPSSO Core v9.5.0 plugin.
• Improvements
  • Added support for new inline variables:
    • %%title%%
    • %%page%%
    • %%pagenumber%%
    • %%pagetotal%%
    • %%sep%%
  • Removed the SSO > Advanced Settings > Clear Term Cache when Publishing option (now always enabled).
  • Removed the SSO > Advanced Settings > Clear Post Cache for New Comment option (now always enabled).
• Bugfixes
  • Fixed missing ‘author’ in Schema CreativeWork markup.
  • Fixed inheritance of custom images for WooCommerce product offers (Premium edition).
• Developer Notes
  • Added a new WpssoUtilInline class.
  • Replaced WpssoUtil->replace_inline_variables() by WpssoUtil->inline->replace_variables().
  • Replaced WpssoUtil->get_inline_variables() by WpssoUtil->inline->get_variables().
  • Replaced WpssoUtil->get_inline_values() by WpssoUtil->inline->get_values().
  • Restored the Schema CreativeWork properties moved in WPSSO Core v9.4.0:
    • ‘dateCreated’
    • ‘datePublished’
    • ‘dateModified’
    • ‘author’
    • ‘contributor’
• Requires At Least
  • PHP v7.0.
  • WordPress v5.0.

Version 9.4.1 (2021/10/30)

• New Features
  • None.
• Improvements
  • None.
• Bugfixes
  • Fixed Open Graph and Schema image sizes for WooCommerce product offers (Premium edition).
• Developer Notes
  • None.
• Requires At Least
  • PHP v7.0.
  • WordPress v5.0.

Version 9.4.0 (2021/10/28)

• New Features
  • Added an integration module for the Elementor Website Builder plugin.
• Improvements
  • Added support for the Elementor video widget.
  • Added support for the ‘elementor/editor/after_save’ action to clear the post cache.
  • Added ‘knowledge-graph’ to the home page Schema Organization ‘@id’ value for Google.
  • Added new options under the Document SSO > Customize tab:
    • Book Author Type
    • Book Author Name
    • Book Author URL
    • Book Published Date
    • Book Created Date
    • Book Edition
    • Book Format
    • Number of Pages
    • Book ISBN
  • Moved addition of some Schema CreativeWork properties to its sub-types (Article, QAPage, Question, Review, and WebPage):
    • ‘dateCreated’
    • ‘datePublished’
    • ‘dateModified’
    • ‘author’
    • ‘contributor’
• Bugfixes
  • Fixed home page Schema Organization logo detection by Google.
  • Fixed missing product currency when the default currency is selected in the Document SSO metabox.
• Developer Notes
  • None.
• Requires At Least
  • PHP v7.0.
  • WordPress v5.0.

Version 9.3.0 (2021/10/23)

• New Features
  • None.
• Improvements
  • Refactored several methods to offer selective local caching (enabled by default).
• Bugfixes
  • None.
• Developer Notes
  • Added a new WpssoAdmin->activated_plugin() method.
  • Added a new WpssoAdmin->after_switch_theme() method.
  • Added a new WpssoAdmin->upgrader_process_complete() method.
  • Moved WpssoAdmin::reset_admin_check_options() to WpssoRegister->reset_admin_check_options().
  • Refactored the WpssoUtil->maybe_load_textdomain() method to add support for WPMU_PLUGIN_DIR.
  • Refactored the WpssoConfig::get_config() method to remove the $apply_filters argument.
  • Refactored the WpssoConfig::get_ext_dir() method to add a $read_cache argument (true by default).
  • Refactored the SucomPlugin::get_active_plugins() method.
  • Refactored the SucomPlugin::is_plugin_installed() method.
  • Refactored the SucomPlugin::get_plugins() method to add a $read_cache argument (true by default).
  • Deprecated the SucomPlugin::clear_plugins_cache() method.
• Requires At Least
  • PHP v7.0.
  • WordPress v5.0.

Version 9.2.1 (2021/10/19)

• New Features
  • None.
• Improvements
  • Added a minimum version check when the Yoast SEO plugin is active.
• Bugfixes
  • None.
• Developer Notes
  • Moved allow_aggregate_rating() and allow_review() filter methods to the WpssoSchema class.
• Requires At Least
  • PHP v7.0.
  • WordPress v5.0.

Version 9.2.0 (2021/10/16)

• New Features
  • None.
• Improvements
  • None.
• Bugfixes
  • Fixed a condition where WP_HOME could be used for the Site Address URL for non-default sites in a multisite setup.
• Developer Notes
  • Updated the SucomUtilWP class methods for WordPress v5.8.1.
• Requires At Least
  • PHP v7.0.
  • WordPress v5.0.

Version 9.1.2 (2021/10/15)

• New Features
  • None.
• Improvements
  • Added a “Current Site Address” information field to the SSO > Premium Licenses settings page.
  • Added a compatibility filter for Yoast WooCommerce SEO presenters to avoid conflicting markup.
• Bugfixes
  • Fixed a possible Schema type conflict for the site organization with a custom home page Schema type.
• Developer Notes
  • None.
• Requires At Least
  • PHP v7.0.
  • WordPress v5.0.

Version 9.1.1 (2021/10/11)

• New Features
  • None.
• Improvements
  • None.
• Bugfixes
  • Fixed unnecessary loading of the ‘sucom-block-editor-admin’ script in the WordPress widgets editing page.
• Developer Notes
  • None.
• Requires At Least
  • PHP v7.0.
  • WordPress v5.0.

Version 9.1.0 (2021/10/06)

• New Features
  • None.
• Improvements
  • Added Schema Event, Place, and Product ‘subjectOf’ property for videos.
• Bugfixes
  • Fixed the Document SSO > Publisher Org. option value.
  • Fixed the Advanced Settings > Default Publisher Org. option value.
• Developer Notes
  • Standardized get_table_rows() calls and filters in ‘submenu’ and ‘sitesubmenu’ classes.
  • Refactored the WpssoProMediaGravatar->filter_user_image_urls() method.
  • Removed the unused WpssoWpMeta->get_table_rows() method.
• Requires At Least
  • PHP v7.0.
  • WordPress v5.0.

Version 9.0.1 (2021/09/30)

• New Features
  • None.
• Improvements
  • Updated the SSO > Setup Guide text.
  • Updated information text in the Document SSO metabox.
• Bugfixes
  • None.
• Developer Notes
  • Optimized the metabox container update process in the block editor.
• Requires At Least
  • PHP v7.0.
  • WordPress v5.0.

Version 9.0.0 (2021/09/24)

• New Features
  • Discontinued the WPSSO JSON add-on:
    • The [schema] shortcode was migrated to a new WPSSO Schema Shortcode add-on.
    • All other features of the WPSSO Schema JSON-LD Markup add-on were integrated into the WPSSO Core v9.0.0 plugin.
  • Updated the SSO > Advanced Settings > Integration > Enable Tags for Pages feature to register a non-public Page Tags taxonomy.
• Improvements
  • Added a Document SSO > Customize > Twitter Card Title option.
  • Refactored the Rank Math integration module to read Google, Facebook, and Twitter metadata (Premium edition).
  • Deprecated the Schema link and meta itemprop tags.
  • Deprecated the head attributes check in theme header templates.
  • Removed the SSO > Advanced Settings > HTML Tags > Schema tab.
  • Moved the Schema data filters from the WPSSO JSON add-on to the WPSSO Core plugin.
  • Moved the Document SSO > Schema Markup / Google Rich Results sections from the WPSSO JSON add-on to the WPSSO Core plugin.
• Bugfixes
  • Fixed caching of option defaults array once plugin objects have been initialized.
  • Fixed missing ‘areaServed’ property in Schema LocalBusiness markup for places / locations.
  • Fixed the saving of selected option colors using wpColorPicker().
  • Fixed an undefined $mt_ret variable error in lib/util.php.
  • Fixed reading of transient cache in WpssoSchema->get_schema_types_array().
  • Fixed saving of the “Primary Category” option value when the default category ID is 1.
• Developer Notes
  • Added a new ‘wpsso_{post_type}_tag_taxonomy’ filter.
  • Added a new WpssoOptionsFilters class.
  • Added a new WpssoConfig::get_social_accounts() method.
  • Removed the WpssoMetaItem class.
  • Removed the WpssoSchemaNoScript class.
  • Removed the ‘wpsso_add_schema_head_attributes’ filter.
  • Removed the ‘wpsso_add_schema_meta_array’ filter.
  • Removed the ‘wpsso_add_schema_noscript_aggregaterating’ filter.
  • Removed the ‘wpsso_add_schema_noscript_array’ filter.
  • Removed the ‘wpsso_schema_meta_itemprop’ filter.
  • Removed the WPSSO_HEAD_ATTR_FILTER_NAME constant.
  • Removed the WPSSO_HEAD_ATTR_FILTER_PRIO constant.
  • Deprecated the WpssoAdmin->check_tmpl_head_attributes() method.
• Requires At Least
  • PHP v7.0.
  • WordPress v5.0.