WPSSO Core – The Complete Structured Data Plugin

Journal

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.13.2-dev.2 (2023/06/07)

• New Features
  • None.
• Improvements
  • Fixed sanitation of periods for hide/unhide class names.
• Bugfixes
  • None.
• Developer Notes
  • None.
• Requires At Least
  • PHP v7.2.5.
  • WordPress v5.5.

Version 15.13.1 (2023/06/06)

• New Features
  • None.
• Improvements
  • Added a definition for the new WPSSO Merchant Return Policy Manager add-on.
  • Updated some label string values for consistency with the WPSSO MRP and OPM add-ons.
• Bugfixes
  • None.
• Developer Notes
  • None.
• Requires At Least
  • PHP v7.2.5.
  • WordPress v5.5.

Version 15.13.0 (2023/06/05)

• New Features
  • None.
• Improvements
  • Added a new « Product Return Policy » option in the Document SSO metabox.
  • Added a new « Default Product Return Policy » option in the SSO > Advanced Settings page.
  • Added a ‘hasMerchantReturnPolicy’ property to Schema Product markup (WPSSO MRP add-on required).
  • Updated the SSO > Dashboard > Version Information layout.
  • Updated the WooCommerce shipping destination markup for « Everywhere » to include all countries.
• Bugfixes
  • Fix to avoid triggering a bug in WooCommerce, where a variation image in the Media Library would inherit the featured image of the main product image.
• Developer Notes
  • Added a $event_names argument to the SucomForm->get_checklist() method.
  • Added a new SucomForm->get_css_class_on_change() method.
  • Added a new SucomUtil::sanitize_input_name() method.
  • Added a new WpssoSchemaSingle::add_merchant_return_policy_data() method.
  • Renamed the sucomSelectChangeUnhideRows() function to sucomChangeHideUnhideRows() in js/com/jquery-metabox.js.
  • Refactored the SucomUtil::sanitize_css_class() method.
  • Refactored the SucomUtil::sanitize_css_id() method.
  • Refactored the sucomChangeHideUnhideRows() function in js/com/jquery-metabox.js.
  • Refactored the WpssoMessagesTooltipMeta->get() method.
• Requires At Least
  • PHP v7.2.5.
  • WordPress v5.5.

Version 15.12.0 (2023/05/26)

• New Features
  • None.
• Improvements
  • Update the notification toolbar after an async upload.
  • Changed the notice container height from 60vh to 40vh when notices are shown automatically.
• Bugfixes
  • None.
• Developer Notes
  • Added a new WpssoScript->on_async_upload_update_toolbar_script() method.
• Requires At Least
  • PHP v7.2.5.
  • WordPress v5.5.

Version 15.11.1 (2023/05/21)

• New Features
  • None.
• Improvements
  • None.
• Bugfixes
  • Fixed missing trimming of spaces for image URL options.
• Developer Notes
  • None.
• Requires At Least
  • PHP v7.2.5.
  • WordPress v5.5.

Version 15.11.0 (2023/04/27)

• New Features
  • None.
• Improvements
  • Added a cache refresh when a supported plugin is activated.
  • Changed the notice container height from 90vh to 60vh when notices are shown automatically.
• Bugfixes
  • Fixed using « show once » text in a dismissed notice.
• Developer Notes
  • Refactored the WpssoAdmin->activated_plugin() method.
• Requires At Least
  • PHP v7.2.5.
  • WordPress v5.5.

Version 15.10.0 (2023/04/22)

• New Features
  • None.
• Improvements
  • Added support for WP Meta SEO taxonomy term metadata.
  • Added a new SSO > Advanced Settings > Plugin Settings > Integration > Import WP Meta SEO Metadata option.
  • Changed timeout of notices display (2 secs for error and warning, 1.5 secs for information, and 1 secs update messages).
• Bugfixes
  • Fixed an array to string conversion error in WpssoAbstractWpMeta->get_column_wp_cache().
• Developer Notes
  • None.
• Requires At Least
  • PHP v7.2.
  • WordPress v5.5.

Version 15.9.0 (2023/04/20)

• New Features
  • None.
• Improvements
  • Updated the SSO > Advanced Settings > Plugin Settings > Interface > WP List Table Columns options:
    • Added an SSO Lang column.
    • Removed the OG ID column.
    • Removed the Schema ID column.
    • Renamed the Schema Type column to SSO Schema.
  • Updated the Facebook supported locales list.
• Bugfixes
  • None.
• Developer Notes
  • Refactored the WpssoAbstractWpMeta::get_column_meta_query_og_type() method:
    • Added an $schema_lang argument.
    • Added the ‘_wpsso_head_info_schema_lang’ key to the meta query.
  • Renamed and refectored the WpssoSchema ->get_lang() method to WpssoSchema ->get_schema_lang().
• Requires At Least
  • PHP v7.2.
  • WordPress v5.5.

Version 15.8.0 (2023/04/13)

• New Features
  • None.
• Improvements
  • Added automatic display of notices with a timeout (3 secs for error and warning, 2 secs for information, and 1.5 secs update messages).
• Bugfixes
  • Fixed the possible incorrect addition of term hierarchy in the breadcrumb title.
• Developer Notes
  • Added a new WPSSO_SCHEDULE_SINGLE_EVENT_TIME constant (default is 8 seconds).
  • Added a new WpssoSchema->refresh_schema_types() method.
  • Added a new WpssoAbstractWpMeta::get_column_meta_query_og_type() method.
  • Added a new WpssoAbstractWpMeta::get_column_meta_query_exclude() method.
  • Updated WpssoUtilCache->refresh() to refresh the Schema types cache.
  • Updated WpssoUtilCache->refresh() to refresh posts, terms, and users without cache metadata first.
  • Refactored the WpssoPost::get_public_ids() method.
  • Refactored the WpssoTerm::get_public_ids() method.
  • Refactored the WpssoUser::get_public_ids() method.
  • Updated filter arguments:
    • ‘wpsso_post_public_ids’ ( array $public_ids, array $posts_args )
    • ‘wpsso_term_public_ids’ ( array $public_ids, array $terms_args )
    • ‘wpsso_user_public_ids’ ( array $public_ids, array $users_args )
• Requires At Least
  • PHP v7.2.
  • WordPress v5.5.

Version 15.7.0 (2023/04/08)

• New Features
  • None.
• Improvements
  • Added support for new Schema types:
    • https://schema.org/Consortium
    • https://schema.org/FundingScheme
    • https://schema.org/LibrarySystem
    • https://schema.org/NewsMediaOrganization
    • https://schema.org/OnlineBusiness
    • https://schema.org/OnlineStore
    • https://schema.org/FundingAgency
    • https://schema.org/Project
    • https://schema.org/ResearchProject
    • https://schema.org/ResearchOrganization
    • https://schema.org/SearchRescueOrganization
    • https://schema.org/WorkersUnion
• Bugfixes
  • None.
• Developer Notes
  • None.
• Requires At Least
  • PHP v7.2.
  • WordPress v5.4.

Version 15.6.0 (2023/04/02)

Note that the default Image Dimension Checks option has changed from disabled to enabled. This is an Advanced Setting option, so the existing option value will be updated automatically in the Free / Standard version. The existing option value in the Premium version will not change, only the default value for new activations has changed.

• New Features
  • None.
• Improvements
  • Added a new SSO > Advanced Settings > Integration > Prevent Thumbnail Conflicts option.
  • Changed the default value for the SSO > Advanced Settings > Integration > Image Dimension Checks option from disabled to enabled.
• Bugfixes
  • None.
• Developer Notes
  • Added a new ‘wpsso_cropped_image_filepath’ filter.
• Requires At Least
  • PHP v7.2.
  • WordPress v5.4.

Version 15.5.1 (2023/03/26)

• New Features
  • None.
• Improvements
  • None.
• Bugfixes
  • Fixed an array_pad() error when image_downsize() returns false.
• Developer Notes
  • None.
• Requires At Least
  • PHP v7.2.
  • WordPress v5.4.

Version 15.5.0 (2023/03/10)

• New Features
  • None.
• Improvements
  • Added a SSO > Advanced Settings > Document Types > Schema > Type by Post Type > Products Group option.
  • Removed support for the Easy Digital Downloads plugin.
  • Removed support for the WooCommerce Show Single Variations plugin.
• Bugfixes
  • None.
• Developer Notes
  • Added a new ‘product:quantity’ internal meta tag for the WPSSO GMF add-on.
• Requires At Least
  • PHP v7.2.
  • WordPress v5.4.

Version 15.4.3 (2023/03/04)

• New Features
  • None.
• Improvements
  • Added a notice to recommend enabling the « Inherit Featured Image » option for WooCommerce.
  • Updated the WPSSO JSON add-on deprecation notice.
• Bugfixes
  • Fixed missing WpssoUtil::save_all_times() method for old deprecated add-ons.
• Developer Notes
  • None.
• Requires At Least
  • PHP v7.2.
  • WordPress v5.4.

Version 15.4.2 (2023/02/28)

• New Features
  • None.
• Improvements
  • Re-added the WPSSO JSON add-on deprecation notice.
• Bugfixes
  • Fixed missing add-on names in deprecation notices for plugins that no longer exist.
• Developer Notes
  • None.
• Requires At Least
  • PHP v7.2.
  • WordPress v5.4.

Version 15.4.1 (2023/02/23)

• New Features
  • None.
• Improvements
  • Updated the notice text for rejected images.
• Bugfixes
  • Fixed the version number when registering the ‘sucom-admin-page’ script.
• Developer Notes
  • Updated « admin_bar » variable names to « toolbar » for uniformity.
  • Refactored transient cache handling in the WpssoHead->get_head_array() method.
  • Replaced the static version number for ‘sucom-admin-page’ in WpssoScript->admin_register_page_scripts().
• Requires At Least
  • PHP v7.2.
  • WordPress v5.4.

Version 15.4.0 (2023/02/20)

• New Features
  • None.
• Improvements
  • Updated the default tabs layout to vertical.
  • Updated custom fields import to ignore non-existant custom fields instead of using an empty string.
  • Removed the SSO > Advanced Settings > Attributes and Metadata > Custom Fields options:
    • How-To Steps Custom Field
    • How-To Supplies Custom Field
    • How-To Tools Custom Field
    • Recipe Ingredients Custom Field
    • Recipe Instructions Custom Field
• Bugfixes
  • None.
• Developer Notes
  • Renamed the ‘wpsso_status_std_features’ filter to ‘wpsso_features_status’.
  • Removed the ‘wpsso_metabox_tabs_layout_{metabox_id}’ filter.
• Requires At Least
  • PHP v7.2.
  • WordPress v5.4.

Version 15.3.1 (2023/02/17)

• New Features
  • None.
• Improvements
  • Added an informational notice when a background task is running.
• Bugfixes
  • Fixed the missing notices stylesheet when in the WordPress block editor.
  • Fixed multi input and textarea fields to always show if they have a value (even if the previous field is empty).
• Developer Notes
  • Added a new WpssoUtil->action_show_admin_notices() method.
  • Removed the ‘is_required’ CSS class from input fields.
• Requires At Least
  • PHP v7.2.
  • WordPress v5.4.

Version 15.3.0 (2023/02/14)

• New Features
  • None.
• Improvements
  • Changed the default « Product Variation Title » value in the Advanced Settings page to ‘%%var_title%% %%sep%% %%var_attrs%%’.
  • Deprecated the WPSSO Core cache clearing function and method.
• Bugfixes
  • Fixed Google warning « Review has multiple aggregate ratings » for Schema ProductGroup variants.
• Developer Notes
  • Added a new SucomErrorException::http_error() method for the WPSSO GMF and CMCF add-ons.
  • Added a new WpssoUser->get_cache_id() method.
  • Added a new WpssoUser->doing_task() method.
  • Added a new WpssoUtil->is_task_running() method.
  • Added a new WpssoUtil->set_task_limit() method.
  • Added a new WpssoUtilCache->get_cache_id() method.
  • Added a new WpssoUtilCache->doing_task() method.
  • Refactored WpssoUser->schedule_add_person_role() method.
  • Refactored WpssoUser->add_person_role() method.
  • Refactored WpssoUser->schedule_remove_person_role() method.
  • Refactored WpssoUser->remove_person_role() method.
  • Refactored WpssoUtilCache->schedule_refresh() method.
  • Refactored WpssoUtilCache->refresh() method.
  • Deprecated the WpssoUser->stop_add_person_role() method.
  • Deprecated the WpssoUtilCache->schedule_clear() method.
  • Deprecated the WpssoUtilCache->clear() method.
  • Deprecated the WpssoUtilCache->stop_refresh() method.
  • Deprecated the wpsso_clear_cache() function.
  • Renamed the WpssoUtilCache->clear_other() method to WpssoUtilCache->clear_cache().
  • Renamed the ‘WPSSO_META_CACHE_PRIORITY’ constant to ‘WPSSO_META_CLEAR_PRIORITY’.
  • Removed the ‘WPSSO_CACHE_REFRESH_SLEEP_TIME’ constant.
• Requires At Least
  • PHP v7.2.
  • WordPress v5.4.

Version 15.2.0 (2023/02/11)

• New Features
  • None.
• Improvements
  • Added new Place tab options in the SSO > Advanced Settings > Schema Defaults metabox:
    • Default Place Schema Type
    • Default Place Country
    • Default Place Timezone
  • Added an ‘@id’ property value to the Schema AggregateRating markup.
  • Added support for the WooCommerce ‘woocommerce_breadcrumb_main_term’ filter to return the primary product category.
  • Removed the offers property from the Schema ProductGroup markup (not required as each variant has its own offers property).
• Bugfixes
  • None.
• Developer Notes
  • Added a new WpssoAbstractWpMeta->md_cache_disable() method.
  • Added a new WpssoAbstractWpMeta->md_cache_enable() method.
• Requires At Least
  • PHP v7.2.
  • WordPress v5.4.

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.4.

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.4.

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.

See here for more info: https://surniaulula.com/2023/apps/wordpress/plugins/wpsso/whats-new-in-wpsso-core-v15/

• 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.