Skip to content

Getting Started

Jump to bottom Edit New page
Gary Cao edited this page Jun 6, 2013 · 6 revisions

Before you play with the new theme engine, there are a couple of things you need to do.

Requirements

  • WordPress 3.6-alpha+ The new theme engine is developed and tested using WordPress 3.6-alpha. We intend to release it publicly around (or after) the time WP 3.6 is released.

  • WordPress e-Commerce theme component fork You will need to use a special version / fork of WP e-Commerce that will support the transition from the old theme engine and the new one. This fork will eventually be merged into one of the 3.8.x releases after it has been proven to be bug-free.

    What you need to do, is clone @garyc40's fork: https://github.com/garyc40/WP-e-Commerce/

    And then switch to branch pr-78: https://github.com/garyc40/WP-e-Commerce/tree/pr-78

    See: WP-e-Commerce/#398 WP-e-Commerce/#78

  • Only after you've made sure the above requirements are met should you proceed to install the Theme Engine v2 Plugin.

Installation

  1. Open wp-config.php in your WordPress core folder and flip WP_DEBUG constant to true. This makes sure you'll see any error messages as you play with this theme engine. It's rough around the edges so there will absolutely be issues here and there. Please report any PHP notices, errors or bugs that you think is caused by the new theme engine.

  2. Activate WP e-Commerce. At this point, the old theme engine is still active, and a few pages are automatically created for you: Products Page, Your Account, Transaction Results, Checkout etc. These pages will not be used at all by the new theme engine, so you can remove them.

  3. Go to Settings->Permalinks and select any permalink scheme that is not default (we'll add support for the default permalink scheme soon enough).

  4. Activate WPEC Theme Engine V2 Now you can access your store at http://yoursite.com/store/

    If you don't like the slugs, go to Settings->Store->Permalinks and edit the slugs as you see fit. Note that you don't need any pages to be created. The store slugs will work as-is.

What to expect

You should not expect this to be 100% bug free yet, so don't use it on your live stores.

If you're testing with a theme that is already customized for the old theme engine, expect to see something totally different. None of the previous customization you did will be replicated on the new theme engine as it is a totally different engine.

When the Theme Engine v2 Plugin is proved to be stable enough, it will replace the current theme engine in 3.8 as the default one.

Add a custom footer
Add a custom sidebar
Clone this wiki locally