Headless WooCommerce Made Easy with CoCart

更新日志

📢 Only bug and security updates will be provided here on WordPress dot ORG. Any new major updates starting with v5.0 will be provided directly from us.

v4.6.0 – 26th June, 2025

This release is a compatibility release for the next WooCommerce release.

What’s new?

• WordPress dot ORG: Added a Playground blueprint.

Changes

• Plugin: Branding for CoCart has been updated.
• Plugin: Styling for CoCart pages have been improved and more consistent on all pages by reducing conflicts with WordPress and WooCommerce styling.

Improvements

• REST API: Basic authentication is detected much better.
• REST API: Authentication failures now has debug logs.
• WordPress Dashboard: Semantic markup overhaul for better screen reader interpretation.
• WordPress Dashboard: Setup wizard and Support pages have been updated.

Compatibility

• Tested with WooCommerce v10.0

v4.5.0 – 31st May, 2025

This release will most likely be the last update released on the WordPress plugin directory with anything NEW added.

What’s New?

• REST API: Products can now be filtered to return only products by brand names.

Bug Fix

• REST API: Added missing option for allowing to order products by random. Solves issue #516

Plugin Details

• Plugin: Updated links for documentation.
• WordPress Dashboard: Updated link for upgrade page.
• WordPress Dashboard: Plugin action links are added after now, not before.

Compatibility

• Tested with WooCommerce v9.9

v4.4.0 – 16th May, 2025

This release focuses on supporting such tools like ManageWP, MainWP, Blogvault etc.

Changes

• WordPress Dashboard: Database updates now run automatically if needed. Resolves issue #511
• WordPress Dashboard: Sessions now transfer automatically for new installs.
• Session: Cart session expiration’s are now matching the default expiration WooCommerce set for better compatibility and abandoned cart support.
• Session: Cart session expiration for logged in users renew daily and expire in a week. This is to keep carts persistent for logged in users.

Note: The session expiration’s can still be filtered back to the previous values but that would mean it would match the expiration for logged in users.

Third Party Support

• Plugin: LiteSpeed Cache will now exclude CoCart from being cached. Commit

Developers

• Filter cocart_cart_expiring added parameter is_user_logged_in() to allow the expiration for logged in users to be filtered.
• Filter cocart_cart_expiration added parameter is_user_logged_in() to allow the expiration for logged in users to be filtered.

Internal

• Improved the logger. Commit
• Added logs for database update procedure. Commit

Deprecations

• Filter cocart_log_entry_name no longer used.
• Filter cocart_log_entry_version no longer used.
• Filter cocart_log_entry_source no longer used.
• Filter cocart_setup_wizard_store_save_next_step_override no longer used.

v4.3.30 – 27th April, 2025

Bug Fix

• WordPress Dashboard: Fix plugin update warning for core plugin. Solves issue #506

Improvement

• REST API: Variation attribute data is now sanitized. Labels are converted to names (e.g. Size to pa_size), and values are cleaned.

Compatibility

• Tested with WordPress v6.8

v4.3.29 – 10th April, 2025

Bug Fix

• REST API: Package details would not return but showed fine in shipping meta.

Improvements

• REST API: Optimized fetching the cart in all Cart API endpoints.
• REST API: Shipping now fully respects the shipping settings.

Dev note: Meaning if you have requested that the customer provides the shipping address first before shipping is calculated, then no shipping methods will return until it’s provided.

Compatibility

• Tested with WooCommerce v9.8

v4.3.28 – 6th April, 2025

Bug Fix

• REST API: Fixed unidentified item key when adding grouped products.

v4.3.27 – 3rd April, 2025

Bug Fix

• REST API: Undone a change to fix any WooCommerce cookies from setting with the Cart API. Related to fixing persistent cart back in November last year.

v4.3.26 – 1st April, 2025

Bug Fix

• REST API: Fixed critical error when adding an item and asking to return the item details. Solves issue #509

Improvements

• REST API: Corrected and added missing schema information for Cart API v1.
• WordPress Dashboard: Tweaked plugin screen modal for listing untested plugins.

Requirement change

• WordPress 6.3 is the new minimum version required.

v4.3.25 – 17th March, 2025

Bug Fixes

• Plugin: Failed to activate fully when network activated due to how admin notices where set. – Bug Report
• WordPress Dashboard: Plugin suggestions was not letting you press the “Install Now” button.

v4.3.24 – 10th March, 2025

Bug Fix

• Fixed a few typo’s in the session handler.

Improvements

• WordPress Dashboard: Improved detection of a suggested plugin hosted on WordPress dot ORG and from a third party.
• WP-CLI: Update command now asks for confirmation before proceeding.

v4.3.23 – 3rd March, 2025

Bug Fixes

• Authentication: Changed access for setting an authentication error from protected to public. Allowing other authenticators to not fail when an error does occur.
• WP-CLI: When updating the plugin, we don’t need to include the install class again.

Improvements

• Database: Simply modified the structure for columns that were BIGINT UNSIGNED to bigint(20) unsigned.
• Session handler: Guest carts will now have a prefix t_ before the cart key provided. This matches with WooCommerce session handler where it maybe used by 3rd party plugins or web host configurations to identify if the session is for a guest user.

Dev note: This affects only new guest sessions.

Compatibility

• Tested with WooCommerce v9.7

v4.3.22 – 26th February, 2025

Corrections

• REST API: Schema corrections for cart endpoint.
• REST API: Schema corrections for items endpoint to match cart schema.

For Developers

• Moved filter cocart_get_customer_{field} after value instead of using it only when there is no value returned for a customers field. Replace {field} with the section prefix followed by the field name. e.g. billing_country

Developer note: This allows you to then alter values such as the billing country. See example.

add_filter( 'cocart_get_customer_billing_country', function( $value ) {
    if ( WC()->countries->country_exists( $value ) ) {
        return WC()->countries->get_countries()[ $value ];
    }

    return $value;
}, 10, 1);

• Introduced new filter cocart_get_after_customer_{field-type}_fields that allows you to change the customer fields after they returned. Replace {field-type} with either billing or shipping for the fields to alter.

v4.3.21 – 20th February, 2025

Improvement

• REST API: Added no-store as part of the Cache-Control header for guest users.

v4.3.20 – 8th February, 2025

Bug Fix

• REST API: Fixed product reviews not returning.

v4.3.19 – 6th February, 2025

Bug Fix

• REST API: Fixed setting a customers shipping address line 1 and 2.

v4.3.18 – 22nd January, 2025

General

• Updated link to Next Changelog for coming future major release. (v5.0)
• Improved SASS to CSS conversion.

Compatibility

• Tested with WooCommerce v9.6

v4.3.17 – 14th January, 2025

Bug Fix

• REST API: Stock status was incorrectly queried for Products API and now checks available stock statuses before filtering.

Improvements

• REST API: Version of CoCart only returns in the returned headers when debug is enabled now.
• REST API: WP_DEBUG is made sure it is defined before returning extras for developers in the store response.

Compatibility

• Tested with WooCommerce v9.5

View the full changelog here.