A WordPress child theme is a theme that inherits the functionality of another theme called the parent theme. Child themes allow you to modify, or add to the functionality of that parent theme. —WordPress Codex: Child Themes
Bookshop is a child theme for Storefront, the official WooCommerce theme. It features a classic design that presents books and other collectible products, such as wine.
Installation ↑ Back to top
Bookshop is a Storefront child theme, so you first need to install and set up Storefront and then Bookshop.
1. Download Storefront for free at Storefront theme file.
2. Download Bookshop from your WooCommerce.com account at My Downloads.
3. On your website, go to Appearance > Themes and click the Add New button.
4. Click Upload to upload the Storefront .zip file from step 1.
5. Go to Appearance > Themes to Activate.
6. Repeat steps 3-5 for the Bookshop theme from step 2.
Activate the Theme Key ↑ Back to top
Setup and Configuration ↑ Back to top
Once installation is complete and the key is activated for Bookshop, it’s time to configure and set up your themes.
Homepage Template ↑ Back to top
To set up the homepage, see Storefront Homepage Template.
Recommended Image Sizes ↑ Back to top
To account for high resolution (retina) displays, we recommend the following image dimensions as a minimum:
- Catalog images: 600 x 800
- Single product images: 600 x 800
- Product thumbnails: 180 x 180
WooCommerce image settings are found at WooCommerce > Settings > Products > Display.
When image dimensions in WooCommerce are changed, you must run the Regenerate Thumbnails plugin to regenerate and re-crop pre-existing thumbnails to the sizes you selected.
More information on WooCommerce image sizes can be found at:
- WooCommerce Image Size Settings Documentation
- WooCommerce Using Appropriate Image Sizes Documentation
Author/Format ↑ Back to top
On the demo, the product archives display an author and a format.
To display on your store, you need to set up two attributes and apply them to products. The attributes are:
- Format – Displays paperback, hardcover, special edition, etc.
- Writer – Displays the author. The term ‘author’ is a protected value in WordPress core and cannot be used.
Once added, these attributes are displayed automatically.
More info at: Managing Product Taxonomies.
Demo Content ↑ Back to top
It’s possible to import WooCommerce Dummy Data to populate your site with demo products as a starting point.
Note: We do not supply the exact images you see in our Bookshop demo due to copyright restrictions. Images used in this demo can be downloaded from the Open Library project.
FAQ ↑ Back to top
Can I change the attributes that are displayed on product archives? ↑ Back to top
You can! By default, Bookshop will display the Author attribute (pa_author) and the Format attribute (pa_format). You can use the
bookshop_author_attribute filter to change the which attribute is displayed above the product title and the
bookshop_format_attribute filter to change which attribute is displayed beneath the product title.
Here’s an example of how you’d change the author attribute (the one displayed above the product title) to display the term from the ‘newattribute’ attribute. Obviously just change ‘newattribute’ to whatever you’d like to use.
I’m using the Storefront Designer extension but noticed some settings are missing. ↑ Back to top
Bookshop applies specific styles to elements such as buttons and the header, so these settings are removed from Storefront Designer to avoid confusion.
On the demo there are sharing buttons on single product pages, how do I enable that? ↑ Back to top
Install the Storefront Product Sharing plugin.
On the demo an Add to Cart button appears when I scroll down product pages, how do I enable that? ↑ Back to top
Install the Storefront Sticky Add to Cart plugin.
On the demo there is a large drop down menu, how do I enable that? ↑ Back to top
The demo uses the Storefront Mega Menu to create the large drop down menu.
I’m using the homepage template but don’t want to display the page title/content. ↑ Back to top
If you don’t want to display content, don’t add any. To hide the title, use Title Toggle for Storefront to hide the page title on any page across your site. Alternatively use Homepage Control to toggle the display of this component.
Can I customize the look and feel of blog pages? ↑ Back to top
Yes. Go to Storefront Blog Customizer to see what’s possible.
Can I customize the look and feel of checkout? ↑ Back to top
Yes. Go to Storefront Checkout Customizer to see what’s possible.
Can I customize the look and feel of WooCommerce pages? ↑ Back to top
Yes. Go to Storefront WooCommerce Customizer to see what’s possible.
How can I customize my site when using a child theme? ↑ Back to top
Many WordPress tutorials recommend inserting code snippets in a child theme’s functions.php file. This ensure that you’re always able to update the parent theme without losing changes.
Because Bookshop is already a child theme, you are unable to do this. Any changes added to the Bookshop functions.php file will be lost when updating. Instead, we recommended that you add code snippets to a customization plugin. We’ve created one to do just this. Download Theme Customizations for free.