Develop WooCommerce

The official WooCommerce development blog

wc-admin v0.5.0 release notes — January 16, 2019

wc-admin v0.5.0 release notes

We are happy to announce the availability of a new build of the wc-admin feature plugin! If this is the first time you have heard about wc-admin, it is a new JavaScript-driven interface for managing your WooCommerce stores that is focusing on creating new and improved reports, and a dashboard to monitor all the important key metrics of your site. You can read more about the background of the project in our Alpha announcement post – or watch the keynote from WooSesh.

And while the plugin isn’t quite ready yet to be run on production sites, we would love for you to install it on a staging or test instance and try it out. You can download version 0.5.0 right here. If you do test out the plugin, and have some feedback – please do open an issue in the GitHub repository, or reach out to me on WooCommerce slack!

0.5.0 Highlights

REST API Updates

  • Added a new v4 of the Orders endpoint which supports a variety of new query arguments.
  • A new Store Performance endpoint has also been added which allows for fetching of stats details from all stat endpoints in one combined request.
  • The Customers endpoint was also shipped in this release! This new endpoint is backed by a lookup table which allows for tracking of all customers – registered and non-registered – along with seeing how many orders they have placed along with average order value.
  • And finally another new endpoint added in this release provides stats for product Downloads. Download stats can be queried by date range, product, order number, and download IP address.

Customers Report

The new customers endpoint is fully hooked up and powering the new Customers Report. This report provides a powerful look into all customer data for a store. The table lists out all registered and un-registered customers along with pertinent data about each customer such as their email address, number of orders, lifetime spend, and average order value.

Additionally you can search the customer table by customer’s name, country, username, and email address. You are also able to segment the customer data by applying custom filters for things like number of orders, total spend, and average order value.

Known Issues: Some of the advanced filter and search tools are still being actively worked on, as are some performance enhancements for stores with a large number of customers.

Downloads Report

The Downloads report is now hooked up to the new REST endpoint! This report also boasts a number of advanced filters which allows store operators to lookup download data based upon product, username, order number and IP address.

Stock Report

Live data is now viewable within the Stock Report. The report also allows for filtering a store’s entire product catalog by products that are in stock, low stock, and out of stock.

Dashboard Updates

The new analytics dashboard also received a number of big updates in this release. The logic behind the Leaderboards ( i.e. Top Products ) was improved to allow for easier creation of additional leaderboard tables. And building upon that new logic, a new Top Categories leaderboard has been added in this release.

The charts on the dashboard also were updated with some nice new features. Clicking on any of the charts will load the associated report for deeper data analysis. Also you can now select a custom interval for the charts depending on the date range selected.

Changelog

The release also includes a number of bug fixes and enhancements throughout the code base:

  • Webpack: replaced extract-text-webpack-plugin with mini-css-extract-plugin
  • Performance: Initial state of user preferences hydrated on server side during the initial page load.
  • Components: New prop to disable ellipsis menu in TableCard component.
  • Filters: New Date advanced filter
  • Bug Fix: Chart tooltip showing NaN in Safari
  • Bug Fix: Removed decimals from Y-axis in chart
  • Bug Fix: Duplicated Y-axis values in chart
  • Bug Fix: Gross Revenue Summary Number in Categories Report
  • Bug Fix: Sorting by name in Categories Report
  • Bug Fix: Dashboard Charts Responsive
  • Bug Fix: Chart Plot >88 points in narrow viewport
  • Dashboard: Charts Update on Date Range Picker change
  • Components: Add loading indicator to charts
  • Bug Fix: Product Report chart truncated

What’s Coming Next?

Much of the next fortnight will be spent focusing on various enhancements and bug fixes in both the REST API, and Analytics sections of the plugin. A new segmentation querying option is close to being finalized in the REST API for Order Stats, so we hope to add enhanced reporting capabilities that leverage these new options too. Also look for some big enhancements to the dashboard Store Performance section.

If you would like to see more details about what we are working on, please visit our project board on GitHub.

WooCommerce Blocks 1.3.0 Release Notes — January 15, 2019

WooCommerce Blocks 1.3.0 Release Notes

Version 1.3.0 of WooCommerce Blocks is now available as a feature plugin. It’s the easiest, most flexible way to display your products on posts and pages!

New for 1.3.0 – we’ve added six new blocks:

Featured Product Block
Select and display a single product in a new, high-impact fashion. Control text alignment, hide or show the price and description, add a color overlay, change the button call to action, and override the product photo.

screenshot-1
Featured Product Block in the editor

Hand-Picked Products Block
The Hand-Picked Products Block lets you quickly search and display products of your choice in a grid.

Best Selling Products Block
Display a grid of your best selling products, filterable by category.

Top Rated Products Block
Display a grid of your top rated products, filterable by category.

 Newest Products Block
Display a grid of your newest products, filterable by category.

On Sale Products Block
Display a grid of on sale products, filterable by category.

Improvements to category selection:

We’ve also improved the category selection filter. If you select two or more categories, you can now chose to show products that match ANY or ALL of your selected categories.

What’s next?

We’re planing a 1.4 release for the last week of January. It will include further enhancements to the Featured Product block, and we’ll be adding a Products by Attribute block as well.

In this release, we’ve removed the legacy “Products block” from the inserter (Although it’s still a registered block type, so if you’re using it your layouts, nothing will change.) In a future release we plan to remove the dependency on the products shortcode, which will give us more flexibly in controlling the layout within the block. At that point we’ll sunset the legacy “Products Block”, and provide paths to transform them into the new blocks if they need to be edited.

Blocks that are further out on the roadmap include a Reviews Block, and a Featured Category Block that would behave in a similar fashion to the Featured Product block.

The full changelog for version 1.3.0 is below:

  • Feature: Added new blocks: “Featured Product”, “Hand-picked Products”, “Best Selling Products”, “Newest Products”, “On Sale Products”, “Top Rated Products”
  • Enhancement: Create new “WooCommerce” block category, all blocks are found there now
  • Enhancement: Added a control to “Products by Category” block to control whether products need to match any selected categories or all selected categories
  • Fix: A “Products by Category” block with no category selected will no longer show all products
  • Legacy block: Remove legacy “Products” block from being shown in the block inserter (still loading the block for an existing uses)
  • Legacy block: Fix an issue with imageless products in the legacy “Products” block.
  • Components: Add new Control components ProductControl, ProductsControl, ProductOrderbyControl
  • Components: Update SearchListControl to allow selecting a single item
  • API: Add cat_operator support to products endpoint
  • API: Add product description & short_description to each product
  • API: Add attribute group names to each attribute
  • Build: Update packages
  • Build: Add cssnano to minify CSS
  • Build: Split out node_modules code into separate vendors files

To get started with WooCommerce Blocks, make sure you are updated to the latest version of Gutenberg, or running WordPress 5.0.x. Then download the latest version of the plugin here or venture over to Dashboard → Updates, to update the plugin from from WordPress.

As always, if you got feature requests, or spot any bugs,  please log them in detail on Github.

wc-admin v0.4.0 release notes — December 28, 2018

wc-admin v0.4.0 release notes

Two weeks have flown by since our last release of wc-admin, so it is time for another release and a quick synopsis of all that has changed! If this is the first time you have heard about wc-admin, it is a new JavaScript-driven interface for managing your WooCommerce stores that is focusing on creating new and improved reports, a notifications system to help keep your store running smoothly, and a dashboard to monitor all the important key metrics of your site. You can read more about the background of the project in our Alpha announcement post – or watch the keynote from WooSesh.

The plugin isn’t quite ready yet to be run on production sites, but we would love for you to install it on a staging or test instance and try it out. You can download version 0.4.0 right here. If you do test out the plugin, and have some feedback – please do open an issue in the GitHub repository, or reach out to me on WooCommerce slack!

Release Highlights

Bug Fixes

  • Fixed issues with using wc-admin in IE11
  • Many improvements to the chart, in particular issues with the Y-axis ticks.
  • Fixed overflow issue with search box in advanced filters.
  • Fix for wrong order count on Products Report.
  • Average order value bug fixed.

REST API Updates:

  • Added reports/downloads endpoint
  • Added reports/coupons endpoint
  • Added reports/coupons/stats endpoint

Documentation Updates:

  • The Report Components now have their own dedicated section in our developer documentation.

Dashboard Charts:

  • You can now view charted data within the Dashboard. Fourteen different data points are available to chart on the dashboard, and you can toggle between line and bar charts.

Known Issues:

  • The dashboard chart selections are not persisting between page loads.
  • The charts do not respond to changes in the Dashboard date range picker yet.
  • Charts need to be linked to their corresponding reports to allow users to navigate easily to the full report.

Downloads Report:

  • In the Downloads Report we added support for Advanced Filters which will allow filtering of Downloads by Product, Username, Order Number, and IP Address.

Known Issues

  • The downloads report is still using test data, and is not hooked up to the REST API yet.

Advanced Filters:

A variety of new Advanced Filters were developed during the past few weeks to add functionality needed in the Customers Report.

  • Numeric Filters allow adding in filters to report that are based off of numeric inputs. The filter supports matches for more than, less than, and between inputs of numeric values.
  • Customer Name Filter is a new autocompleter filter that allows for creating filters based upon orders for a particular customer.
  • Email Filter is another autocompleter filter that is powered by the Customers REST API endpoint and will allow quick filtering of reports by customer email.
  • Country Filter is the last new autocompleter filter added in this release.

Single Date Picker Component:

Another need of the Customers Report is the ability to create a filter based upon a single date ( i.e. Registered on/before/after a certain date ). The new DatePicker component is built upon the WordPress core DatePicker and will soon be available to use as an Advanced Filter within the project.

Category Report & Categories Data:

The Categories Report table is now hooked up to live data! Also in both the Categories and Products reports, enhanced Category Data is now displayed for nested categories. For stores that use deeply nested categories, category names are now display a breadcrumb path:

Coupons Report:

The Coupons Report is now fully hooked up to live data via the REST API. The report also offers the ability to compare multiple coupon codes and quickly see values of how many orders used coupons, and the total amount discounted.

Taxes Report:

The Taxes Report is also now serving up live data from the API. Much like the Coupons Report, you can compare multiple Tax codes on this report, and access data around how much tax was collected for orders, and shipping.

Stock Report:

The Stock Report page is now available, but many of the underlying functionality is still in development.

Reviews Activity Panel:

The Reviews Activity Panel now shows real data for all product reviews that need moderation:

What is Coming Next?

During the next two weeks, the team will be focusing on the following items:

  • REST API
    • Finalizing endpoints for Customers, and Stock Report
    • Continued work on ability to Segment Data for better visualization of comparisons
    • Updates to the core Orders endpoint to add in needed query options for the Orders Report.
  • Analytics
    • Finalize Customers, Downloads, and Stock reports with live data.
  • Dashboard
    • Improvements to Chart Block
    • New Leaderboards Section and Blocks for Top Categories and Coupons
  • Report Lookup Tables
    • Enhancements to logic that populates the lookup tables that power the reports.
WooCommerce 3.5.3 release notes — December 20, 2018

WooCommerce 3.5.3 release notes

WooCommerce 3.5.3 is now available. This patch release fixes an issue affecting stores running WordPress 5.0.2. This new version of WordPress was released yesterday, and changed the default value of a few variables. This modification caused the WooCommerce orders list table displayed in WP Admin to break. More information on this bug can be found in this WordPress core ticket, as well as this WooCommerce issue.

1 commit made it into this release and the full changelog is below.

* Fix - Fix orders list table in the admin after a change introduced in WordPress 5.0.2. #22273 

Download the latest release of WooCommerce here or venture over to Dashboard → Updates to update your plugins from WordPress.

As usual, if you spot any other issues in WooCommerce core please log them in detail on Github, and to disclose a security issue to our team, please submit a report via HackerOne here. Comments on this post are closed.

wc-admin v0.3.0 release notes — December 11, 2018

wc-admin v0.3.0 release notes

It has been two weeks since our last release of the `wc-admin` feature plugin, so we wanted to give you all an update on what has been worked on, and give you a fresh build to test with! If this is the first time you have heard about `wc-admin`, it is a new JavaScript-driven interface for managing your WooCommerce stores that is focusing on creating new and improved reports, a notifications system to help keep your store running smoothly, and a dashboard to monitor all the important key metrics of your site. You can read more about the background of the project in our Alpha announcement post – or watch the keynote from WooSesh.

And of course we like to always mention that it isn’t ready for use on production sites, we are developing the new interface publicly so our developer community can comment and contribute, and are starting to make certain features available as a feature plugin.

Version 0.3.0 is available for download here! This pre-built zip file of the project is the easiest way to test out all of the new functionality.

Release Highlights

Bug Fixes

  • Charts with empty data sets no longer throwing an error
  • Fix for false positives in Report Stats unit tests
  • Autocompleter for products advanced report filter no longer will return already selected products and variations
  • Autocompleter for products bug fix for not supporting multi-word product entries
  • Chart: Fix bug with chart not updating width on filter changes
  • Accessibility: Allow table headings to have longer labels for screen readers
  • Fixed a bug in Orders Report summary numbers where net revenue did not reflect refunds.
  • Order refunds now properly trigger a sync to update the Order Stats table
  • Resolve lodash conflict issues which was causing bugs in various WooCommerce screens.

REST API Updates:

  • New /reports/variations endpoint
  • Added support for sorting /reports/products results by Product Name
  • Grouped all extended info of data in /reports/products endpoint into the `extended_info` object
  • Stock_status and stock_quantity values added to the /reports/products and /reports/variations endpoints

Products Report Updates:

  • Products report now supports a product detail view for Variant data. When viewing a Products report, use the “Single Product” filter to select a product with variant data. You will now see all variant data in the tabular data section in which you can filter to specific variants.

Taxes Report Updates:

  • Compare Tax codes filter has been added which allows you to compare tax report data by different tax codes.

Orders Report Updates:

  • The Orders Report now supports more advanced filters! You can now filter order data for a given time period by: order status ( i.e. is pending and complete ), product ( orders with or without certain products ), coupon codes ( coupon codes were/were not used on orders ), and filtering by new and returning customers.

Activity Panel Updates:

  • The Orders activity panel now shows all “Pending” orders for the store. Each card is linked to the associated Order screen for management.

Revenue Report Updates:

  • Added summary numbers to the footer of the Revenue Report table.

Orders Report

  • For a selected date range, it reports the total number of orders, net revenue, the average order value, and average number of items per order.

Known Issues

  • Advanced filters aren’t hooked up to the API, so applying filters doesn’t have an affect on the report.

Customers Report

  • View Customer Data: Name, Sign Up date, Email, number of Orders, Lifetime Spend, Average Order Value, Last Purchase Date, and Country

Known Issues

  • The Customers report is still in development, and no live data is available yet.

What is Coming Next?

During the next two weeks, the team will be focusing on the following items:

  • REST API
    • Finalizing endpoints for Coupons, Taxes, and Stock Report
    • Creation of new Customers report endpoint
    • Ability to Segment Data for better visualization of comparisons
  • Analytics
    • Finalize Coupons, Taxes, and Stock reports with live data.
    • Customers Report and advanced filtering tools.
    • Downloads Report
    • Add support for nested product categories in report data
  • Dashboard
    • Finalize and ship new Chart Block
  • Activity Panels
    • Add live data to Reviews Panel