This week we’re happy to announce WC 2.2 “Prowling Pangolin” beta 1 is available for testing.

             ,___,           ╭────────────╮
      ╭╴╴╴╴/ ⏖ ⏖ ╴╴╴╮    ┃  Woo! 2.2  ┃
   ╭╯⏖ ⏖ ⏖ ⏖ ⏖ ⏖ ( ⦿    ╰─y──────────╯
 ↜╯╯    ‴▾▾LL▾▾▾▾▾LL   \   

Since 2.1 we’ve had a whopping 1401 commits. You can view the changelog here and see what we’ve been busy working on:

Before going into the features, developers should be aware of the following changes:

  1. Order statuses are no longer taxonomy based – the post status is used. This makes order queries lighter, but custom order queries may need to be updated.
  2. Orders can now be retrieved using the get_order() wc_get_order() function.
  3. Orders can be created using the new wc_create_order() function.
  4. Gateways can now handle refunds by declaring support for the ‘refunds’ feature, and including a process_refund() method (see PayPal Standard in WC core for an example).
  5. Gateways can pass the payment_complete() method a transaction ID to have it stored in a standardized format.
  6. v2 of the API which includes PUT/POST/DELETE methods is included. v1 of the API is still present until v3 is eventually released.

Aside from the countless fixes and tweaks, here are a few of the key features in 2.2.

Rest API v2

Version 2 of the API introduces PUT/POST/DELETE support for Coupons, Orders, Products and customers and will really widen the possibilities of integrating with WooCommerce from external apps. Full documentation for v2 of the API should be ready soon, but it’s there if you want to play.

Massive props to SkyVerge (Max and Justin in particular) for their contributions to the API.


Refunds has been a feature we’ve wanted to tackle for a long time, but has been put back due to it’s scope a few times. We’re proud to finally have this feature built.

Refunds consists of two parts;

  1. An API for Payment Gateways to handle refunds directly though code.
  2. An interface to handle refunds from the orders UI.

The greatest challenges with refunds were;

  1. Keeping reports accurate after partial refunds.
  2. Having a simple interface to handle the refund process…
  3. …which led us to redesign the order item and order totals panels and combine them.
  4. Modifying our data structures (particulary for line items) to support the above.

Here is an example of the new UI for order totals and items:

2014-08-01 at 10.05

You’ll notice shipping, taxes, fees are all displayed in the same area which should improve usability.

This is what the UI looks like when doing a refund:

2014-08-01 at 10.06

Unfortunetely, due to the structure of data in 2.1 and below (particulary the way in which taxes were stored, never at line level) we’ve had to sacrifice the tax columns and partial refund functionality for legacy orders – but going forward, all new orders will benefit from the new functionality.

We’re keen to hear your feedback about refunds in 2.2!

Improved language file handling

One thing we started noticing with recent releases was that the filesize for WooCommerce was huge. 2.1.12 was over 8mb. This can make updating difficult for example if there are upload limits.

The reason for the size; localisation files. Uncompressed we’re talking 32mb of PO and MO files in core.

To resolve this, 2.2 includes a language pack downloader. PO and MO files will no longer be bundled with the plugin – they will be downloadable from your dashboard if you have the WPLANG constant set, or from a git repository if you wish to grab them manually.

Give us your feedback and get involved

We’re happy to hear your feedback about 2.2 and would appriciate any bug reports going directly to Github.

Download 2.2 Beta 1

If you find a bug with the beta, please ensure you prepend the ticket title with [2.2] when submitting the issue to GitHub, or at least mention what version you are using in the ticket description.

Also when reporting anything to us:

  1. Describe the issue in detail, with a system status report
  2. Don’t report issues with extensions, only core
  3. Don’t report issues with themes
  4. Report bugs, not feature requests