Bagberry Theme Documentation

Before Getting Started

↑ Back to top

(Optional) We recommend you to complete Woocommerce subscription setup after completing the order/purchase. It will help you to install your theme/extensions & keep them up to date.

Installation

↑ Back to top

Prerequisite: Make sure that you’ve downloaded the theme package from https://woocommerce.com/my-account/downloads/

Method 1 (via WordPress dashboard)

↑ Back to top

This is simple & straight forward way to install theme for your site. Here you can find the instructions to install theme step by step,

  1. Login to your WordPress Dashboard and go to Appearance -> Themes.
  2. Click Add New and then Upload theme.
  3. Click Choose file and locate bagberry.zip from the your computer.
  4. Click Install Now. Once theme installed successfully, you can activate the theme.

Method 2 (via FTP)

↑ Back to top
  1. Extract the actual theme package bagberry.zip to the folder “bagberry”
  2. Login/Connect to your server via FTP Client
  3. Go to wp-content/themes/ at your installed WordPress directory.
  4. Upload the bagberry folder (Now you have successfully installed the theme).
  5. Login to WordPress Dashboard and go to Appearance -> Themes and activate the bagberry theme.

Demo Importer

↑ Back to top

Prerequisite: You must have installed & activated bagberry theme before proceeding to import.

Note: We recommend you to use the fresh WordPress Installation for importing demos, this import process will not remove or overwrite any of the existing content in your site.

To make your site building process quick and simple, you can start with pre-built demos or pages. Here you can find the step by step instructions to import demo contents.

  1. Go to your WordPress Dashboard and click Appearance -> Demo Import menu from left side menu.
  2. Check/uncheck the options based on your needs and click Import All.
  3. Now, it will take few minutes (5 – 30mins) based on your server & network capabilities to complete whole import process.

Block Patterns

↑ Back to top

Block Patterns are predefined block layouts, available from the patterns tab of the block inserter. Once inserted into content, the blocks are ready for additional or modified content and configuration. Here you can find the step by step instructions to insert patterns.

  1. Go to Pages and choose your desired page.
  2. Now, you can click + icon and choose Patterns tab to see all available patterns.
  3. Choose your desire one and start editing

Note: You can use patterns inside posts & products as well in the same way you’re using it for pages.

Blocks

↑ Back to top

The block editor introduces a modular approach to pages, posts & products each piece of content in the editor, from a paragraph to an image gallery to a headline, is its own block. And just like physical blocks, WordPress blocks can be added, arranged, and rearranged, allowing WordPress users to create media-rich pages in a visually intuitive way — and without work-arounds like shortcodes or custom HTML.

Here you can find the instructions to insert blocks,

  1. Go to Pages and choose your desired page.
  2. Now, you can click + icon at the top left inside toolbar to insert blocks

Optionally you can simply start typing the block name with “/” prefix. it will list all available blocks. for ex. “/woo” it will display all blocks exclusively created by WooCommerce team.

Note: You can use blocks inside posts & products as well in the same way you’re using it for pages.

Useful Links:

Site Editor (FSE)

↑ Back to top

Site Editor allows you to controls whole site such as Header, Content & Footer. Site Editor can be accessed by clicking WordPress icon (WordPress logo) at the top left corner. It consists of three areas

  1. Templates
  2. Template Parts
  3. Site

Templates

↑ Back to top

Templates area will allow you to define the structure of content area of your site such as archives of products & posts, page, 404, search, etc…

  • From the Site Editor Appearance -> Editor(beta) click on the WordPress icon (or Site icon if you have set one) to open the Site Editor left navigation.
  • Click on Templates to view the list of templates on your site, including any you have created and any that come with theme.
  • Click on any of the templates in the list to edit the template. From here you can customize the layout of the selected template using blocks.

Template Parts

↑ Back to top

Template parts will allow you to display same set of contents (global contents) for all templates to keep it organized and to customize easily. It defines the header, footer, filter & cart sidebar areas. It can be accessed commonly by all templates such as pages, products, etc…

Single Product Template

↑ Back to top

To edit the Single product template, you need to go inside Templates -> Single Product

To add new blocks, just click + icon to insert the block inside current product template or create completely new set of blocks by deleting all blocks as per your wish.

For changing the product gallery on the single product, you can use the Custom CSS has-woocommerce-product-gallery-slider for the parent of WooCommerce Single Product Block You can access Custom CSS from Advanced tab inside Block Settings side bar (Gear icon inside tool bar from top right).

Creating Responsive Header

↑ Back to top

To edit the header, you need to go inside Templates Parts -> Header or Templates Parts -> Header Additional or Templates Parts -> Header Accent based on your preference.

To add new blocks, just click + icon to insert the block inside current header or create completely new set of blocks by deleting all blocks as per your wish.

Though, you see the a single header. But technically, there are two headers one for mobile & another one for desktop.

First header with custom class hide-on-mobile & another header with custom class hide-on-desktop .You can access them from Advanced tab inside Block Settings side bar (Gear icon inside tool bar from top right).

To change the header skin you can add custom class header-accent or header-additional. You can access them from Advanced tab inside Block Settings side bar (Gear icon inside tool bar from top right).

For transparent header, you can use the custom class has-transparent-header under Advanced tab inside Block Settings

Editing Shop Filters

↑ Back to top

To edit the shop filter, you need to go inside Templates Parts -> Product Filter. Here you can see the all inserted filters on the left side columns.

To add new filter, just click + icon inside the filters column and search for filter blocks inside WooCommerce Blocks

Creating Megamenu

↑ Back to top

At first, you need to create normal menu for your header inside Templates Parts -> Header. And insert Navigation block to insert menu items.

To convert your usual menu to megamenu, you need to add the class has-megamenu to the menu of respective Navigation block.

Customizer Options

↑ Back to top

As we have full control of the site inside Templates & Template Parts, customizer is having only limited options which we consider as backward compatibility. Below we can see options to control product archive grid & product images.

Products Display

↑ Back to top

Product Catalog

You can set number of products to display inside Product archives, it allows you to set number of rows and number of products on each row. You can see below options under WooCommerce/Product Catalog tab inside Appearance -> Customize

  1. Products per row
  2. Rows per page

Customizer visibility

Incase you can’t see the Customizer submenu under Appearance, you can access them directly using the url for ex. https://example.com/wp-admin/customize.php

Product Images

You can allow control the size of product images on archives & individual product page. You can see below options under WooCommerce/Product Images tab inside Appearance -> Customize

  1. Main Image Width (Individual product page)
  2. Thumbnail Size (Archive pages)
  3. Thumbnails Aspect ratio.

Set Homepage

↑ Back to top

You can set your static home page inside Settings -> Readings tab under Your homepage displays choose Static page and select your desired Homepage

Custom CSS

↑ Back to top

You can add your own css styles under Custom CSS tab inside Appearance -> Customize

Update Theme

↑ Back to top

We recommend you to keep the theme up to date always. Theme update will include major/minor improvements/fixes on codes, options, functionalities, layouts, etc…

Things to consider before update,

  • If you’ve renamed your theme folder, update will considered as fresh copy of theme and you can’t see any of your changes after update.
  • We strongly recommend you to take a backup WordPress Installation directory & Database for recovery in case something went wrong.

Here you can find instructions to update,

  1. Go to your WordPress Dashboard and click Appearance -> Themes menu from left side menu.
  2. Now you can see the update icon over your theme, just click to update new version of theme.

Optionally you can download theme package from https://woocommerce.com/my-account/downloads/ and install theme on top of current version by following same installation procedure.

Child Theme

↑ Back to top

Child theme is yet another theme which inherits/uses the properties of parent theme which we were assigned to. In this case bagberry is parent theme. You can create theme with any name with line of declaration to act as a child of bagberry.

Important aspect of child theme is to allow you to keep your changes & modifications separate from parent theme functions, to preserve it from theme updates.

Note: If you’re familiar with theme installation, you can follow the same step to install child theme as well. You can find instructions to install & activate theme here

Useful Links:

Use of your personal data
We and our partners process your personal data (such as browsing data, IP Addresses, cookie information, and other unique identifiers) based on your consent and/or our legitimate interest to optimize our website, marketing activities, and your user experience.