Berry WordPress Theme Documentation v1.2.3

1. Getting Started

Documentation & Guide

1.1 Installation

To install Berry Theme, first you need a working WordPress site. Click the link below to find out how to install WordPress: http://codex.wordpress.org/Installing_WordPress

We assume that you already have a running WordPress site. Now let's install Berry.

You need to download the theme zip file from ThemeForest first. Go to Downloads on ThemeForest, and find Berry. Download the files and find berry.zip - that's what you need for installation.

  1. On your website dashboard, go to Appearance > Themes > Add New > Upload Theme.
  2. Choose berry.zip you just downloaded.
  3. Install and activate it.
  4. You will see the notice “This theme requires/recommends the following plugins…”, please click on those links and follow instructions to install those plugins.
  5. Done.

Please note: If you are going to write custom code for the theme, then please also upload the berry-child.zip file (you will find it in the folder "WordPress Child Theme" in your download package), then install and activate the child theme. Then you can change code or write your own custom styles for the theme in the child theme files. Later when you need to update the theme, just update berry.zip (the parent theme), so your custom code changes will not be overwritten (because they are all in the child theme).

Theme Requirements

To use Berry theme, please make sure your server meets the following requirements:

  • WordPress 4.6 or higher (v4.7.x and above recommended, some features are only available since v4.7.x)
  • PHP 5.6 or higher
  • mysql 5.2 or higher

1.2 Required & Recommended Plugins

Install Required Plugin

As mentioned above, when installing & activating Berry theme, you will see the notice "This theme requires the following plugin: Berry Extension". It is the Berry Theme function extensions - including these features: post like, post sharing, gallery slider and Instagram feed.

  1. After Installing Berry theme, activate it, then you will see a note box, it says: "This theme requires the following plugin: Berry Extension." Click on "Begin installing plugin" to install it.
    to-install-berry-extension
    Begin installing plugin
  2. After clicking on "Begin installing plugin" link, it will go to "Install Required Plugins" page, then click on "Install" link below "Berry Extension".
    install-berry-extension
    Install Required Plugins
  3. Then don't forget to activate "Berry Extension".

If you need to find "Berry Extension" zip file, please go to "berry" theme folder > inc > plugins > then there is "berry-extension.zip".

berry-extension-in-folder
berry-extension.zip location

Or you can download the whole package "BerryWP.zip", unzip it to get the "Berry" folder and open it, then go to "Plugin" to find "berry-extension.zip".

As mentioned above, when installing & activating Berry theme, you will see the notice "This theme recommends the following plugins…". Those plugins are not required to use the theme, but will extend the theme basic functionality. All those plugins are hosted on the official WordPress repository and are made by other authors. You don't need to install and activate all of them, just choose those you will use on your site.

  1. After Installing Berry theme, activate it, then you will see a note box, it says: "This theme recommends the following plugin: …" Click on "Begin installing plugin" to install it.
    Recommended plugins
    Recommended Plugins
  2. After clicking on "Begin installing plugin" link, it will go to "Install Required Plugins" page, tick the boxes of the plugins you will need on your site, then choose "Install" from "Bulk Actions" drop down list and click on "Apply" button. (You can install the required plugin and recommended plugins at one time.)
    Install recommended plugins
    Install Recommended Plugins
  3. Then don't forget to activate the plugins.

The recommended plugins are:


1.3 Update Berry Theme

Auto Update with Envato Market Plugin

We recommend Envato Market plugin. It can install WordPress themes and plugins purchased from ThemeForest & CodeCanyon by connecting with the Envato Market API using a secure OAuth personal token. Once your themes & plugins are installed WordPress will periodically check for updates, so keeping your items up to date is as simple as a few clicks.

You will see this note while installing Berry theme, please click it to install and activate Envato Market plugin.

Activate Envato Market plugin
Activate Envato Market plugin

Then go to Envato Market > Settings, click on the link to generate a personal token, and then insert it below, then save changes.

Click on the link to generate a personal token
Click on the link to generate a personal token

There will show new tabs: Themes & Plugins (if you have purchased both themes & plugins from Envato).

As you can see in the screenshot below: if there is a newer version for a theme or a plugin, it will show the notice, and you can update the item by clicking on the link Update Available.

auto check for updates
When an item can be updated

Update Manually

Please follow steps below when you need to update Berry theme manually on your site:

  1. On your WordPress dashboard, go to Appearance > Themes, activate another theme, for example, Twenty Sixteen (one of WordPress default themes).
    Activate another theme
    Step 1 - Activate another theme.
  2. Find Berry theme, hover on it to show "Theme Details", click on it.
    Berry Theme Details
    Step 2 - Go to Berry Theme Details.
  3. In the theme details panel, find the "Delete" button in the bottom right corner, click on it to delete Berry theme.
    Delete Berry Theme
    Step 3 - Delete Berry Theme.
  4. Click on "Add New" button, then "Upload Theme" button, to upload the latest version of berry.zip file.
    Add New Theme
    Click on “Add New” button.
    Upload Theme
    Click on “Upload Theme” button.
    Upload berry.zip file
    Upload “berry.zip” file.
  5. After installing berry.zip, activate Berry theme again. The previous customizations will not lose.
  6. Update the Required Plugin - When update Berry theme, if you also see this note, please click on "Begin updating plugin" link to update the Berry Extension plugin as well.
    Update: Berry Extension Plugin
    Please remember to update Berry Extension plugin if see this note while updating the theme.
  7. Reactivate the Required Plugin - When updating Berry theme manually, please don't forget to reactivate Berry Extension plugin (because when switching themes WordPress will deactivate the required plugin of a theme). If the required plugin is not activated, some features will not be available.

1.4 Import Demo Content

To import the demo content, please make sure you have installed the recommended plugin One Click Demo Import while installing Berry theme.

After installing Berry and required/recommended plugins, refresh the page, you will see Import Demo Data under Appearance in the left sidebar. Click it, then you will see 9 demos' screenshots. Choose one demo, click on the Import button. It can take a couple of minutes, please wait.

Please note: Don't import multiple demos to the same site, it will create duplicate data.

One Click Demo Import
One Click Demo Import

When importing finished, please follow the steps below:

  1. Menus have been imported, but you will need to tell WordPress where to use the menus. Go to Appearance > Menus.
    1. Choose Main Menu, then find "Menu Settings" option > "Theme locations", check the box before "Primary Menu". Click on "Save Menu" button.
      Main Menu Location
      Main Menu Location
    2. Choose Social Menu, then find "Menu Settings" option > "Theme locations", check the box before "Social Menu". Click on "Save Menu" button.
      Social Menu Location
      Social Menu Location
  2. On the demo import page, you will see there is a note:
    Demo Import - Setup MailChimp for WordPress
    Demo Import - Setup MailChimp for WordPress
    If you want to build the subscription form with the plugin MailChimp for WordPress, click on the link to get to the settings page of the plugin, then enter your MailChimp API key.

Import Demo Manually

If you don't want to import everything of a demo, you can choose any one of them and import manually. Demo files are located in the Berry theme folder > inc > ocdi.

Import Content Only

In the ocdi folder, find these 2 folders: Content Default & Content Strawberry. Open either of the folders, there is the file "demo-content.xml" in it. It is the content data file.

On your site dashboard, please go to Tools > Import, choose WordPress and install it.

Install WordPress Import Tool
Install WordPress Import Tool

After installing, click on "Run Importer", choose "demo-content.xml" in one of those 2 folders, upload and import.

Import Widgets Only

In the ocdi folder, find these 2 folders: Content Default & Content Strawberry. Open either of the folders, there is the file "widgets.wie" in it. It is the widgets data file.

Please install this free plugin: Widget Importer & Exporter. Install and activate this plugin, then go to Tools > Widget Importer & Exporter, choose "widgets.wie" in one of those 2 folders, upload and import.

Import Customizer Settings Only

In the ocdi folder, you can see the 9 folders: default-1, default-2, ... , strawberry-1, strawberry-2, ...

Open any one of those folders, you can find the file "customization.dat" in it, that's the customizer data of that demo.

Please install this free plugin: Customizer Export/Import. Install and activate this plugin, then go to Appearance > Customize > Export/Import > Import, choose "customization.dat", upload and import.

1.5 WooCommerce Installation

Berry theme supports WooCommerce since v1.2. You can sell products on your own site with Berry theme and WooCommerce plugin.

Install WooCommerce

First of all, you need to install and activate the free plugin WooCommerce. Please read WooCommerce official documentation to know how to install and use this plugin.

Import WooCommerce Dummy Content

Right after installing WooCommerce you may find you have an empty store. There are no products, orders, reviews, and more by default. You can start to create your own products, or perhaps you’d like to see what sample orders and products look like, then you can choose to import some dummy content. Please check this article Importing WooCommerce Dummy Data to know details.

Customize your shop & product pages

After you have set up your online store and created some products, you can tweak the layout of the shop index page and single product page via WordPress customizer. Please read the sub chapter Theme Customizer > Shop of Berry documentation to find out more.

2. Theme Customizer

Go to Appearance > Customize, there you can customise and personalise your theme layout and styles.


2.1 Site Identity

You will find the following options in this section:

  • Logo – Upload your custom brand image then display it as site logo in the site header. Supports SVG logo since version 1.1.2. When upload a SVG logo, please always click "Skip Cropping" button.
  • Logo Width – To keep your custom brand image look sharp on retina devices, we recommend upload an image with 2x size and give 1x size. For example, upload an image which is 200 x 200 px, and enter 100 px as the image width value.
  • Site Title – Enter your site title and it will show in the site header below the logo image.
  • Tagline – Input the brief description of your site.
  • Display Site Title and Tagline – Uncheck it to hide site title and tagline so only show the logo image.
  • Site Icon – Upload a square image to use it as a browser and app icon for your site.

2.2 General

In this section you can set general options for your site.

  • Site LayoutFullwidth / Boxed.
  • Boxed Layout Options – When choose Boxed for Site Layout option, there will show more options for Boxed Layout.
    • Site Max Width – Set the max width of inner content page.
    • Background Color – Choose any background color for outer area.
  • Background Image – Upload a background image for your site. If you cannot see background image, please go to Colors > General and set Page Background to be transparent.
  • Read More Button – You can change the text on the Read More button after each post.
  • Button StyleDefault / Slide. you can control the style of all buttons on your site, including post “Read More” button, submit button in forms (like comment form, Contact Form 7, Subscribe form, etc).
    Button Style - Slide
    Button Style - Slide: When hover on the button, the primary background color will slide in.
  • Page/Post Header
    • Enable parallax for large featured image in header - Check to enable parallax scrolling effect for featured image in page/post header, and also works for the large gallery slider in gallery-format post's header. Please note: it only works when screen width is larger than 1024 px.

In this section you can choose nav bar style, show or hide elements in site header.

  • Header LayoutNav Bar + Logo / Logo + Nav Bar.
  • Navigation StyleTop Bar / Off Canvas. Choose “Top Bar”, then the site menu items will show in the nav bar at the top of the browser. Choose “Off Canvas”, then the site menu will hide, and show when click on the hamburger menu button. Please note:Top Bar” nav style will be changed to “Off Canvas” when screen is narrower than 980px.
    Navigation - Top Bar
    Navigation Style - Top Bar
    Navigation - Off Canvs
    Navigation Style - Off Canvas
  • Sticky Navigation – Check to make the navigation bar always sticks to the browser top, so it’s always visible when scroll the page.
  • Social Icons – Check to show your social menu in the site header.
  • Fold Social Icons – Check to fold social icons and hover/click to show them. Please note: Social icons will always be folded when screen width is smaller than 980px.
    Fold Social Icons
    Fold Social Icons
  • Enable Search – Check to show the search field in the site header.
  • Background Image – Upload a background image for your site header.
  • Header Image – Upload an image and it will be shown as the “Off Canvas” menu background when the menu is expanded. If the navigation style is “Top Bar”, the image will show as the expanded menu background when screen is narrower than 980px.
    Header Image
    Header Image is used as the expanded off-canvas menu background.

In this section you can choose to show or hide elements in site footer, and set its layout.

  • Instagram Feed – Check it and enter the username of an Instagram account. And you can enter a title (optional) for the feed, for example, “Follow Me on Instagram”. It will show the latest 8 pictures from the Instagram account in a full-width row at the top of the site footer. And you can choose to "Link Title to Instagram Account" by ticking the checkbox. Please note: your Instagram account needs to be public to show feed on your site.
  • Footer Column – You can choose from 1 to 3.
  • Footer Logo – Check and upload a logo image to show it in the site footer.
  • Logo Width – To keep your custom brand image look sharp on retina devices, we recommend upload an image with 2x size and give 1x size. For example, upload an image which is 200 x 200 px, and enter 100 px as the image width value.
  • Footer Text – Check it, then enter some text content. It supports HTML tags. So you can use < h1 > to < h6 > tags, and < p >, < ul > tags to style the content.
  • Footer Social – Check to show your social menu in the site footer.
  • Footer Background Image – Upload a background image for your site footer.
  • Back To Top – Check to show the “Back To Top” bar in the site footer. It will scroll back to page top when click on the bar.
Footer - 2 Columns
Footer - 2 Columns.

2.5 Colors

In this section you can change element’s color/background color/border color of your site.

2.5.1 General

The settings in this sub section will work globally.

  • Primary Color – This color will be used for links in content, the text of categories and publish date of posts, buttons, and more.
    Primary Color
    Primary Color
  • Base Text Color – It’s your site basic text color, will be applied to all text, like headings, navigations, footer text, widget text and more.
  • Content Text Color – This color will be applied to the post/page content text, but H1 to H6 headings will not be included. Headings will still use the base text color.
  • Page Background Color – It’s the background color for the site page/inner content page (when choose "Boxed Layout"). Default is #F7F7F7.
  • Make page background color to be transparent – Tick the box to make page background color to be transparent, so if your site has a background image it won't be covered by the background color.

2.5.2 Site Header

  • Background Color – Choose any color in the color picker to use it as the site header background color.
  • Make site header background color to be transparent – Tick the box to make site header background color to be transparent.
  • Text Color – Choose a color for site title and tagline.

2.5.3 Nav Bar

  • Nav Color SchemeLight / Dark.
  • Nav Highlight ColorDefault / Primary Color. Choose “Default” then no highlight color. Choose “Primary Color” to use the primary color for the highlighted nav item.
  • Nav Background Color – Choose any color in the color picker to use it as the nav bar background color.
Nav Bar Colors
Nav Bar Colors
  • Footer Background Color – Choose any color in the color picker to use it as the site footer background color.
  • Footer Text Color – Choose a color for text in the site footer.
  • Back To Top Color SchemeLight / Dark.
  • Back To Top Background Color – Choose a custom background color for “Back To Top” bar.
Footer Colors
Footer Colors

2.5.5 Blog Page

  • Featured Slider Color SchemeLight / Dark.
  • Featured Boxes Section Background – Choose a custom background color for Featured Boxes Section.

2.5.6 Sidebar

  • Widget Background Color – Choose a custom background color for the widgets in sidebar.
  • Widget Border Color – Choose a custom border color for the widgets in sidebar.
  • Widget Title Color – Choose a color for widgets' titles in sidebar.

2.6 Blog Page

In this section you can control the layout and posts style for the blog/posts page of your site. If your site homepage displays your latest posts, then your homepage is the blog/posts page, so you can also customize your homepage here.

2.6.1 Page Layout

You can select a page template for your blog page. There are 3 options:

  • Fullwidth
  • With Right Sidebar
  • With Left Sidebar

Check to show a slider of some posts at the top of the post archive. And more options for it will show:

  • Choose Slider StyleLarge Slider / Carousel 2 Col / Carousel 3 Col.
  • Choose Posts - Pick the featured posts By Category, By Tag or By Featured Posts (How to choose Featured Posts).
  • You can choose to remove these posts from Latest Posts Archive (New feature since v1.1.3).
  • Then you will be able to select one or multiple categories/tags. Please hold the CTRL key (PC) or COMMAND key (Mac) to select multiple items.
  • Post Number - Enter a number to decide how many posts will be show in the slider. 1 to 6. If enter 3, then the latest 3 posts from the categories/tags you choose in the option above will be appear in the slider.
  • Check to Enable Auto Play - The featured slider will be auto-played. Then the 3 options below will show:
  • Pause Duration - Enter a number to set the pause duration of each slide. Default: 5000 ms.
  • Transition Speed - Enter a number to set the transition speed. Default: 500 ms.
  • Pause when hover - Enable it, then auto play will be paused when hover on the featured slider.

2.6.3 Featured Boxes

Featured Boxes section is a new feature since version 1.1.3. Here you can upload background image for each box, then enter box title and link to each one.

Featured Boxes
Featured Boxes

2.6.4 Post Archive

Here you can control the latest post archive layout.

  • Posts Layout
    • Classic
    • Classic Card
    • List
    • List Card
    • Grid - 1 Col
    • Grid - 2 Cols
    • Grid - 3 Cols
    • Classic Grid - 2 Cols (New since v1.1.3)
    • Classic Grid - 3 Cols (New since v1.1.3)
    • Flip Grid - 2 Cols (New since v1.1.3)
    • Flip Grid - 3 Cols (New since v1.1.3)
  • Show at most x posts – Enter a number to decide how many posts show per page. It’s the same feature as WordPress dashboard > Settings > Reading > Blog pages show at most x posts.

2.7 Archive Pages

In this section you can set the layout and style of the 3 types of archive pages:

  • Category Archive
  • Author Archive
  • Date-based Archive

Just like Blog Page, you can choose the page layout and archive layout. And there is another option "Show all posts on one page", check it to ignore "show at most x posts" setting and list all posts of this archive on one page.

For example, to change the category archive pages' layout, please go to Customizer > Archive Pages > Category, there you can choose page layout, posts layout, and more.

Category Archive Layout
Category Archive Layout

2.8 Post

In this section you can control single post default template, and show or hide some elements on single post.

  • Default TemplateFullwidth / With Right Sidebar / With Left Sidebar. You can change each post's template while editing it (click here to know details).
  • Single Post Header StyleFullwidth Featured Image on Top / Normal Featured Image below Post Title.
  • Post Share – Check to show social share buttons. Then you can check to select some social medias.
  • Related Posts – Check to show related posts, then choose to show related posts by category or tag. Related posts will be randomised each time refresh the page, and will show at most 3 posts.
  • Related Posts Title – Give a title of the related posts section
  • Author Info Box – Check to show the author info box after single post content.

2.9 Shop

In this section you will be able to style your WooCommerce shop pages (New feature since v1.2).

  • Sidebar – Set sidebar layout for shop page & single product page, and also choose which sidebar to display.
    • General Sidebar LayoutFullwidth / With Right Sidebar / With Left Sidebar. It controls sidebar layout for your shop archive pages: Shop page, category archives, tag archives, search archive.
    • Single Product Sidebar LayoutFullwidth / With Right Sidebar / With Left Sidebar.
    • Sidebar ContentMain Sidebar / Shop Sidebar. If choose Shop Sidebar then you can add shop related widgets to this sidebar and only display those widgets on shop pages.
  • Shop Page – Controls styles of shop index page.
    • Page Header StyleOverlay / Normal.
    • Show at most x products per page.

2.10 Typography

In this section you will be able to set font options for text.

2.10.1 Font Family

Options in this sub section will work for the whole site. You can choose 2 different fonts for different types of text. All 800+ Google Fonts are included in the drop down lists.

  • Primary Font Family – It’s the font family for the main text content: Page/post content and title, widgets text, and more.
  • Secondary Font Family – This font will be used for: Widgets title, navigation items in site header, posts categories, author name and publish date of posts/comments, and more.

2.10.2 Content

In this sub section you can tweak page/post content text style for Heading Text and Content Text separately.

  • Heading Text – H1 to H6 heading in page/post content. Options including:
    • Font Weight
    • Letter Spacing
    • Text Transform
    • Style
  • Content Text – Options including:
    • Font Size
    • Line Height

2.10.3 Page/Post Title

In this sub section you are going to set font style for single page/post title, and posts title on blog/posts page and archive pages. Options including:

  • Font Weight
  • Letter Spacing
  • Text Transform
  • Style

2.10.4 Widget Title

Options including:

  • Font Weight
  • Letter Spacing
  • Text Transform
  • Style

4. Pages

4.1 Homepage & Blog Page

To display your latest blog posts on the homepage, you can:

  • Go to Appearance > Customize > Static Front Page > Front page displays, then choose “Your latest posts”.
  • Or on your site dashboard, go to Settings > Reading > Front page displays, then choose “Your latest posts”.

Then go to Appearance > Customize > Blog Page, there you can customize the page layout and latest posts layout.

You can also choose a static page as the homepage, then create a new page, name it “News”, “Journal” or any other title, and set it as the posts page. Then you can style your posts page via Appearance > Customize > Blog Page.


4.2 Page Template

Berry provides 3 page templates for different page layout:

  • Default Template (With Right Sidebar)
  • Fullwidth
  • With Left Sidebar

To choose a template for a page, on the site dashboard, go to Pages > All Pages, choose a page to edit it, then on the right hand side, you will find Page Attributes option panel, click to open the Template drop down list, choose a template for this page.


4.3 Category Archive

Go to Posts > Categories, when adding a new category or edit an existing one, you can upload an image for this category, then on the category archive page, this image will be used as the page header background image.

And this image will also be used for the custom widget: Berry Category widget.

Social Menu
Category Image
Social Menu
Category Archive

To change the page layout and archive styles, please go to Customizer > Archive Pages > Category.


4.4 Author Archive & Info

The author information will show:

  • At the top of Author Archive page
  • After single post content

Author information includes the author profile picture and biographical info.

To edit author biographical info, go to your site dashboard > Users > All Users, find the user you are going to edit, click to open the Edit User page, there you can edit the biographical info.

Author Bio
Author Biographical Info

To add or edit the author profile picture, please visit https://en.gravatar.com/ for more information.

To change the page layout and archive styles, please go to Customizer > Archive Pages > Author.

To hide the author info box after single post content, please go to Customizer > Post > Author Info Box, then uncheck the box.

5. Posts

5.1 Post Template

You can choose a default template for posts, and you are also able to choose different templates for different posts.

Please note: this feature requires WordPress 4.7. Please check your WordPress version and get the version 4.7 to use this feature.

To choose a template for a post, on the site dashboard, go to Posts > All Posts, choose a post to edit it, then on the right hand side, you will find Post Attributes option panel, click to open the Template drop down list, choose a template for this post.

There are 4 options:

  • Default - When choose this, it means the post will use the template you have selected in Customizer > Post > Default Template. So if you change the default post template in Customizer, this post's template will also change to that one.
  • Fullwidth
  • With Left Sidebar
  • With Right Sidebar

If you choose "Fullwidth" or "Left Sidebar" or "Right Sidebar" for one post, then when you change the default post template in Customizer, the change will not affect this post.


5.2 Single Post Header Style

Since version 1.1.5, Berry theme has 2 single post header styles for users to choose.

On your site dashboard, go to Appearance > Customize > Post, then you will see an option Single Post Header Style:

  • Fullwidth Featured Image on Top - The featured image (or a gallery slider for a Gallery Post) will be shown as fullwidth section on the top of the post header - post title and other meta.
  • Normal Featured Image below Post Title - The featured image (or a gallery slider for a Gallery Post) will be shown inside of the post frame, below the post title and other meta.
Single Post Header Style
Option to choose Single Post Header Style.
Fullwidth Featured Image on Top
Fullwidth Featured Image on Top.
Normal Featured Image below Post Title
Normal Featured Image below Post Title.

5.3 Post Formats

Berry supports 4 post formats: Standard, Gallery, Video and Audio.

  • Standard Post - Just choose “Standard” as post format.
  • Gallery Post - You can insert a gallery into the post content by clicking on “Add Media” button, then choose “Create Gallery”, and choose “Gallery” as post format. You can also upload a featured image if you will add this post into the featured posts slider. Please note: the featured image of a gallery post will not show on its single post page or the posts page.
  • Video Post - Insert a video embed code into the post content, or upload a video by clicking on "Add Media" button. And choose “Video” as post format. You can also upload a featured image for displaying on posts page for “Grid” or “List” layout.
  • Audio Post - Insert an audio embed code into the post content, or upload an audio by clicking on "Add Media" button. And choose “Audio” as post format. You can also upload a featured image for displaying on posts page for “Grid” or “List” layout.

5.4 Featured Post

You can choose some posts and set them as "Featured Post" manually. Then you can insert them into the Featured Slider on blog page. This is a new feature since v1.1.3.

On your dashboard, go to Posts > All Posts, then you will see the column Featured Post, tick the box of some posts to mark them as the featured posts.

Featured Posts
Featured Posts

You can also mark a post as featured post on its edit page.

Featured Post Box
Berry Option - Featured Post Box

5.5 Post Like/Heart Counts

If you have enabled "Post Like" feature, you will see a small heart icon below each post. Visitors/readers can click on the heart icon, the number will count up at every click. If your site already has many posts before using Berry theme, because your previous themes don’t have this feature, so the number is zero for every post. You can add a fake start number of hearts for each post, please see this link to know how to do it: How to add a start number for post like count.


5.6 Hide Featured Image

Since version 1.1.5, we have added a checkbox on each single post edit page, so users can choose to hide or show a post's featured image on its single post page.

Hide Featured Image
Checkbox to hide Featured Image on its single post page.

If checked, then the post's featured image (if uploaded) will show in the featured slider on homepage, and in the post archive list (like on homepage, category archive page, etc), but will not show on its single post page.

And please note: if a post is a gallery post (post format "Gallery"), and the post has both a featured image and a gallery, the featured image will not show on its single post page, no matter if enable the option or not.

6. Widgets

6.1 Widgets Basics

Berry provides 1 widgets area: the left/right sidebar when the page template is not “Fullwidth”. To manage widgets, you can:

  • On your website dashboard, go to Appearance > Widgets.
  • Or go to Appearance > Customize > Widgets.

You can add widgets into the sidebar, and drag to reorder the items.


6.2 Berry Custom Widgets

There are 8 custom widgets included in Berry.

6.2.1 Berry Profile

Add brief information about you and your site.

6.2.2 Berry Category

Display selected (up to 5) categories with background image in the sidebar.

Each category's background image can be added/edited via Dashboard > Posts > Categories.

Please hold the CTRL key (PC) or COMMAND key (Mac) to select multiple items.

6.2.3 Berry Ads

Upload an image and enter a link to the page you are advertising/promoting about. And you can also choose to open it in the current tab or a new tab.

6.2.4 Berry Latest Posts

The custom latest posts widget will show your latest posts with the featured image, post title and meta info.

6.2.5 Berry Latest Comments

The custom latest comments widget will show the latest comments with comment author photo, post title and comment publish date.

6.2.6 Berry Social

Add this custom widget into your sidebar to show your social menu.

6.2.7 Berry Instagram

Enter the username of an Instagram account to display the latest photos from this account. And you can decide how many pictures to show in the feed.

6.2.8 Berry Facebook

Enter your Facebook page URL to display the Facebook like box.

7. Image Size

To make sure images on your site always look sharp and clear on all devices, the recommended width of images is at least 1600 px when it is supposed to be a full-width image.

Images will be scaled and saved into different sizes after you upload them. You can set image sizes via dashboard > Settings > Media.

Recommended media sizes for Berry theme:

  • Medium size - Max Width: 300, Max Height: 300
  • Large size - Max Width: 1024, Max Height: 1024
  • Full size - 1920 x 1280 (3:2)

After you change the media size settings, when you upload new images they will be scaled and saved into the new sizes. But for the existing images, you can use this plugin to regenerate the new sizes: Force Regenerate Thumbnails.

We suggest use images in 3:2 aspect ratio for the features images and photos in a gallery (especially a slider gallery).

8. WPML Compatible

8.1 Introduction

Berry theme is officially compatible with WPML. Which means you can turn Berry multilingual with WPML. Please read guide below to know how to build a multilingual site with Berry and WPML.

8.2 What you will need

  • Berry theme (version 1.1.2 or above)
  • A recent version of WPML, including the String Translation, Translation Management and Media translation add-ons.

8.3 Essential resources

8.4 How to translate

Content

8.4.1 Getting started

  1. Install and activate Berry
  2. Install and activate the core WPML plugins (WPML Multilingual CMS, WPML String Translation, WPML Translation Management) first, followed by other WPML plugins that may depend on them.
  3. Set up WPML from WPML > Languages. See WPML Getting Started Guide for complete reference, but the initial simple three-step setup is self-explanatory, asking you to choose your default language, a set of active languages, and a language selector.

8.4.2 Translating pages and posts

1) Creating pages and posts in the site's default language

Before you can start translating, you need to create pages and posts in the site’s default language.

For example, navigate to "Pages" and add a new page (as you would without WPML). You will see there is a Language panel on the page.

Creating pages and posts in the site's default language
Creating pages and posts in the site's default language

2) Translating pages and posts

After publish a new page or a post, you will see Translate This Document in the Language panel and a list of languages.

Translating pages and posts
Translating pages and posts

Click on the "+" button of the language you are about to translate the content to. For example, "Serbian". This creates a new Serbian translation for it. Then enter the content written in Serbian. And publish the page.

Translating content manually
Translating content manually

Once you have translated the page, it will display the title and content in the language of your choice.

Page in 2 languages
The page will be displayed in different languages.

3) Updating the translation of a page or post

On your WordPress site dashboard, go to Pages or Posts, in the list you will see a column for each active language, with a pencil icon (for 'edit translation') or a '+' icon (for 'add translation') next to each page/post.

For example, the page "Our Team" hasn't been trasnlated yet, so the icon is "+". Click on it to create a new Serbian translation for this page.

When you’ve already translated, the "+" icon will change to a pencil icon. Click on the pencil icon if you need to modify your translation.

Language Edit Button
Language Edit Button

Sometimes, you need to use the same, untranslated contents in other languages. In this case, WPML provides a content duplication feature. To read more about this topic, please visit the page about displaying untranslated content using content duplication.

8.4.3 Translating post categories and tags

1) Translating post categories

  1. Navigating to Posts > Categories, as an example we will create a category and name it "Books", also upload a category image for it, and click on the Add New Category button. (The category image will be used as the category archive page header background, and the background of Featured Categories widget in sidebar.)
    Create a category
    Create a category
  2. Click on the category that we have created.
    Edit a category
    Edit a category
  3. Click on the "add" link to add the translation of the category.
    Add the translation of the category
    Add the translation of the category
  4. Fill the Name and Slug fields with the category translation, and also choose the same category image for it, and then click on the Add New Category button.
    Translate the category
    Translate the category

2) Translating post tags

Translating post tags is just as same as translating categories. The only difference is you only need to enter tag Name and Slug.

3) Taxonomy Translation

You can also translate post categories and tags via WPML Taxonomy Translation.

  1. Navigating to WPML > Taxonomy Translation. Select Tags (or Categories) from the Select the taxonomy to translate drop-down menu. Then click on the "+" icon or the pencil icon to translate a tag (or a category).
    Taxonomy Translation
    Taxonomy Translation
  2. The Term Translation box will pop up. Enter the translation and click on "Save" button.
    Term Translation
    Term Translation

8.4.4 Translating Berry's theme text and other strings

To translate the theme strings, you will need to scan it for strings. This will register the strings for translation on the String Translation screen. (Read more about Theme and Plugin Localization.)

This can be done by following the steps below:

  1. Go to WPML > Theme and plugin localization.
  2. Choose Translate the theme and plugins using WPML's String Translation and load .mo files as backup, and save.
    Theme and plugin localization
    Theme and plugin localization setting
  3. Click on the Scan the theme for strings button. This will register the theme texts for translation on the String Translation screen.
  4. Now you can navigate to WPML > String translation.

Translating via String Translation screen

What you need to translate via String Translation screen:

  • Site title and tagline
  • Read More button
  • Post Share text
  • Widgets
  • Search form
  • Featured Boxes text
  • Footer text
  • Back to Top at footer bottom

For example: Translating Berry's custom widget - Berry Profile:

Berry's custom widget - Berry Profile
Berry's custom widget - Berry Profile
  1. Navigate to WPML > String translation. Enter some keywords copied from the profile, for example, "independent photographer", and search. You will see the search result as shown below, then click on translations.
    Search for the string
    Search for the string
  2. Add your translated text. Then choose the Translation is complete option and click Save.
    Translate the string
    Translate the string

8.4.5 Translating Berry menus

WPML lets you translate WordPress menus and create different menus per language. You can translate menus manually, or have WPML synchronize menu content. Please check Translating Menus for more details.

8.4.6 Translating widgets

WPML lets you easily translate your Widgets via the String Translation screen. This requires that the WPML String Translation module is installed. The module is available in the Multilingual CMS version.

And we have talked about how to translate Berry's custom widget "Berry Profile" via the String Translation screen in sub section - 8.4.4 Translating Berry's theme text and other strings.

8.4.7 Language Switcher in main menu

Go to Appearance > Menus, click on Customize the language switcher button.

Customize the Language Switcher Button
Customize the Language Switcher Button

The Edit Menu Language Switcher screen will pop up. There you can customize the language switcher.

Customize the Language Switcher
Customize the Language Switcher

8.5 Need Help for WPML

If you need help with using WPML with Berry theme, please head over to WPML technical forum. Before posting about issues, we recommend that you review this quick checklist:

  • Make sure you have the latest versions of the theme and of the WPML plugins, and that they are all activated. These include WPML Multilingual CMS, WPML String Translation and WPML Translation Management.
  • Check that the problem does not appear if the WPML plugins are deactivated, and it does appear when only the core WPML plugins are activated.

Please always remember to search and read WPML official documentation for more details about how to use WPML.