WooCommerce 2.1 – Please Debug Your Template Overrides

peppy-penguin1

WooCommerce 2.1, also known as the “Pepppy Penguin” was released just two days ago.

Before you upgrade please make sure to read this release post thoroughly along with this post, which Coen Jacobs is actively updating, that lists common upgrade issues and solutions.

Anyway, I wanted to tell you all that there is a neat debugging tool in WooCommerce 2.1 which allows you to disable all template overrides for logged-in administrators only.

You’ll find this from the WP Dashboard -> WooCommerce -> System Status -> Tools page.

template-debug

Why is this useful?

There are a TON of themes which override core WooCommerce templates and have not updated them for WooCommerce 2.1.

Like with WooCommerce 1.6.6 -> 2.0, most of the support inquiries we are seeing with the 2.0.x -> 2.1 are template related.

So before you are quick to blame WooCommerce for breaking your site with latest update, please take a few minutes and use this very helpful tool to rule out any template conflicts or compatibility issues with your theme.

You should then check out Patrick Rauland’s post about WooCommerce 2.1 and outdated templates here or look into contacting the developers of your theme to see if they have an updated version for 2.1 or let them know there is an issue that needs to be addressed.

Hope this helps!

3 Comments

  1. Sam February 26, 2014 at 3:01 am #

    The templates that I need to override are wooCommerce template like edit-address. I had modified the templates in my child theme (miStyle). Now I turned the debug mode on… but things still don’t work properly. .. what to do?

    • Scott February 28, 2014 at 8:28 pm #

      Hey Sam,

      Unfortunately I’m not sure exactly what’s causing the issue but it sounds like it’s due to the template changes you’ve made or a compatibility issue with either a plugin or theme.

      I would try to rule them out by testing with Twenty Eleven/Twelve bundled with WP and de-activating your plugins one by one.

      Hope this helps!

Trackbacks/Pingbacks

  1. WooCommerce 2.1 is out, so what now? / Remi Corson - February 12, 2014

    […] WooCommerce 2.1 – Please Debug Your Template Overrides – Scott Basgaard […]

Leave a Reply