WPSSO Core – The Complete Structured Data Plugin

修改日誌

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 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 < a (alpha) < b (beta) < rc (release candidate).

Standard Edition Repositories

• GitHub
• WordPress.org

Development Version Updates

WPSSO Core Premium edition 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. When new development versions are available, they will automatically appear under your WordPress Dashboard > Updates page. You can reselect the “Stable / Production” version filter at any time to reinstall the latest stable version.

WPSSO Core Standard edition users (ie. the plugin hosted on WordPress.org) have access to the latest development version under the Advanced Options section.

Changelog / Release Notes

Version 15.1.1 (2023/02/08)

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

Version 15.0.1 (2023/02/04)

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

Version 15.0.0 (2023/02/03)

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

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

Version 14.8.0 (2023/01/30)

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

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

Version 14.7.0 (2023/01/26)

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

Version 14.6.0 (2023/01/22)

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

Version 14.5.0 (2023/01/20)

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

Version 14.4.0 (2023/01/11)

• New Features
  • None.
• Improvements
  • Added a new “Speakable CSS Selectors” option under the SSO > Advanced Settings > Integration tab.
  • Removed minimum image dimensions checks for Google image sizes (1:1, 4:3, and 16:9) as they are no longer mentioned in the Google Structured Data Guidelines.
  • Updated the default and recommended Facebook image size from 1200×630 to 1200×628.
• Bugfixes
  • None.
• Developer Notes
  • Added new filters to add, remove, or change unit values:
    • ‘wpsso_dimension_units’
    • ‘wpsso_fluid_volume_units’
    • ‘wpsso_weight_units’
  • Renamed the meta options ‘schema_keywords’ key to ‘schema_keywords_csv’.
• Requires At Least
  • PHP v7.2.
  • WordPress v5.2.

Version 14.3.0 (2023/01/05)

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

Version 14.2.0 (2023/01/03)

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

Version 14.1.1 (2022/12/30)

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

Version 14.1.0 (2022/12/29)

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

Version 14.0.0 (2022/12/28)

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