woocommerce / storefront

Official theme for WooCommerce

Storefront is a robust and flexible WordPress theme, designed and built by the team at WooCommerce to help you make the most out of using the WooCommerce plugin to power your online store. It's available to download for free from the WordPress theme repository.

It features deep integration with WooCommerce core plus several of the most popular extensions:

• WooCommerce Bookings
• WooCommerce Wishlists
• WooCommerce Brands
• WooCommerce Subscriptions

For developers, Storefront is the perfect starting point for your project. Its lean and extensible codebase will allow you to easily add functionality to your site via a child theme and/or custom plugin(s).

Storefront Status

Please read this document explaining the current status of Storefront development.

Storefront extensions

Looking to take your storefront powered store to the next level? Be sure to checkout the premium Storefront extensions.

Storefront Documentation

You can view detailed Storefront documentation on the WooCommerce documentation website.

Storefront in your language

Storefront translations can be downloaded from WordPress.org. To use one of these translations it is recommended that you upload it to wp-content/languages/themes/storefront-pt_BR.mo. Adding it to this location means the file will not be lost when you update Storefront. It is however possible to add a translation to the languages folder in your child theme if you'd prefer.

Storefront help & support

WooCommerce customers can get support at the WooCommerce support portal. Otherwise, you can try posting on the WordPress support forums. Please remember, GitHub is for bug reports and contributions, not support.

Contributing to Storefront

If you have a patch, or you've stumbled upon an issue with Storefront core, you can contribute this back to the code. Please read our contributor guidelines for more information about how you can do this.

If you have an idea or feature request please take a look at the Storefront Feature Requests to see if it's already been suggested, planned, or is under development. If not, please add it there.

You can keep up with the latest Storefront developments on the dev blog.

Testing Storefront

Want to help test upcoming Storefront releases? Check out the Storefront Beta Tester plugin.

storefront's Issues

Header widget bottom border

Should this bottom border be shown if there is no widgets? It leaves a 1px border between header and hero component http://d.pr/i/RYDd/5Lai8r4i

Check composite products frontend

Footer Widget without title pushes other widgets down to next line

screenshots w/o title:

http://cld.wthms.co/WgIe
http://cld.wthms.co/13Bj

exact same widgets with titles: http://cld.wthms.co/Nq28

Composite products thumbnails mode.

Check the borders!

Empty column on 'tank you' screen

404 page styling

Not sure if this is already done, looks like it can use some spacing.

Division by 0 on shop page

For some reason i have an error message on the shop page: http://cld.wthms.co/1fs3F
while in the customizer I do see products listed properly.

Customer details left spacing on 'thank you' screen

remove gridset js / handles

Search error box color

Maybe make error box red instead of blue?

Site Logo - plugin no longer supported

I want to have a logo instead of my site name so I downloaded the Site Logo plugin as per the suggestion on the Storefront page in wp-admin.

That crashed the theme.

Also noticed on the github page for Site Logo plugin that it is no longer supported and has been integrated into Jetpack.

But when I look into Jetpack there isn't a Site Logo option. There is Site Icon - but that is just a favicon.

So how do we replace the site name with a logo?

Missing link to WooThemes website

I think we should add a "Meet WooThemes" button on this box in the welcome page: http://cld.wthms.co/11UqK

Cart Table Responsiveness broken in Tablet Widths

Between ~920px and 767px, it looks like this: http://cld.wthms.co/W4mY

(pardon my horrible testing colors)

Breadcrumbs

@mattyza mentioned third party SEO integration for titles in #16. When working at Yoast I've also dealt with chanigng the Woo breadcrumbs, is this taking into account?

Product Images on single product pages seem to be non responsive after the 768px break point

When viewing the site on certain tablet or smartphones the main product images seems to be non responsive and sits to to the left hand side.

Screenshot: http://cld.wthms.co/dY7W

Might be an idea to have this 100% on smaller screens so it takes up the full available width.

Create a wrapper function for the title tag

For future proofing, and compatibility with third party SEO plugins, we should use a wrapper function instead of calling wp_title() directly.

Small Credit Card input fields

Imo, the CC input fields are too small.

Shop overview columns same height?

Idea: make shop columns same height.

clean animation.scss

Sale margin is off in shop page

This is what I'm seeing on the shop page http://cld.wthms.co/1lIle
Haven't played with CSS much yet but assuming that div class onsale might need a margin on the left. Doing so reveals the box though.

Check display of ajax filtering

.woocommerce-validated / .woocommerce-invalid

postMessage on some color settings

Post excerpts on the blog archive

Not sure if this is intentional or not, so you may be able to disregard it :)

When viewing the blog archive, the full post is displayed rather than the excerpt. This necessitates the use of the <!--more--> tag, which I believe is inconsistent with the rest of your themes and probably isn't familiar to most users. May be helpful to automatically break the post at ~70 words or something instead.

Make copyright content filterable.

https://trello.com/c/BGaiFNF1/3-storefront-copyright-bar-after-the-footer-with-left-right-or-center-section

Customizer reset button

Would be useful to have a "Reset all" button in the customizer, or at least in each customizer section.

remove redirect on activation

Replace with a notice linking to welcome screen.

check settings sanitization

Checkout button alignment off

In the cart page if there's a sidebar, the proceed to checkout button is off: http://cld.wthms.co/11AMl

Individual product archive / homepage background colour is inconsistent on products

When viewing the homepage are the background colour of the product items seems inconsistent with some having a grey background and others not.

Screenshot: http://cld.wthms.co/sA91

Product categories also display like this too ;)

Screenshot: http://cld.wthms.co/1rQh

Same for related products on a single product page http://cld.wthms.co/uJjx

Shake effect on Notice boxes

I think that the shake effect on notice boxes is very annoying. Would it be possible to find another way to highlight them?

Or at least disable it

demo store notice

readme

Product Categories not working

Here's a screenshot: http://cld.wthms.co/12Neg

Warning: Division by zero in /Users/michael/Dropbox/WooThemes/wordpress-instances/wordpress-1/wp-content/plugins/woocommerce/templates/content-product.php on line 33

Warning: Division by zero in /Users/michael/Dropbox/WooThemes/wordpress-instances/wordpress-1/wp-content/plugins/woocommerce/templates/content-product.php on line 35

The error appears as though it's coming from WooCommerce but activating other themes does not have this error. Occurring on only product categories AFAIK.

"WooThemes" not "woothemes"

The footer text should read "WooThemes" rather than "woothemes".

Using this for a screencast, so don't fix it too quickly, @jameskoster ! ;)

Integrate with JetPacks logo feature

Product Categories thumbnails are not being centered on mobile

On the homepage, the Product Categories thumbnails are not being centered for @media only screen and (max-width: 768px): http://cld.wthms.co/ZOR9

Irregular display on the checkout screen

http://cl.ly/image/3H1X2J0p122P

This seems a bit odd, to me. Is this the theme, or my setup, somehow?

No way to remove products added to cart on an iPhone.

This isn't really a bug per say but it is something that crops up as a question in support quite a lot as when our themes scale down to tablets and smartphones it hides the ability to remove products from a cart.

Screenshot smartphone: http://cld.wthms.co/TUCu

Desktop: http://cld.wthms.co/685v

I understand it's a amount of available space per screen size issue but it's maybe something we could work out in this particular theme that would allow them to remove products on smaller screens.

Thoughts?

Payment gateway images combined with long gateway title

Header cart text color

Text color should maybe be set to the same as link color for best styling?

http://d.pr/i/1daZO/gwYLOfH9

images license

Integration with WooCommerce Photography extension

The calendar widget is wider than the sidebar

The oh-so-very-useful calendar widget doesn't look great: http://cld.wthms.co/Dmv8

WooThemes in footer needs capital W & T

W

Replace README.md with a WordPress.org friendly readme.txt file

WordPress.org requires a readme.txt file for use within WordPress. Lets perhaps replace our Markdown file with a readme.txt file.

responsive table styles for WooCommerce 2.3

Check display of variation swatches extension

Permission error when closing the customizer

I closed the customizer using the X button and i got this error: You do not have sufficient permissions to access this page.

I think it's because it links to index.php?page=storefront-welcome instead of themes.php?page=storefront-welcome

Layout sidebar left setting also effects the homepage

When changing the layout settings to sidebar left the homepage is also affected and creates a small spacing issue to the left hand side of the homepage content area.

Screenshot: http://cld.wthms.co/P75L

All other sections seem to be fine :)