Documentation & Guide
To install Berry theme, first you need a self-hosted WordPress site. Click the link below to go to WordPress download page, there you will find useful information about installing WordPress.
If you are new to WordPress, we recommend learning a little bit about it before you get started. Here are some useful links in case you need help with WordPress.
To use Berry theme, please make sure your server meets the following requirements:
If you encounter any issue listed below, it is related to low PHP configuration limits:
The solution is to increase those PHP configuration limits. Please log into your hosting cPanel and change them. Or you can try to contact your hosting provider and ask them to increase those limits to a minimum as follows:
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.
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).
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, Instagram feed and more.
Why do you need to install the required plugin?
Because of WordPress code standards and ThemeForest requirements: "Themes execute the presentation and styling of content, while plugins handle content creation and functionality." Therefore, some features must be included in the required plugin but not included in the theme itself.
Please note: Before version 1.3, the required plugin "Berry Extension" was activated automatically after installation. But since version 1.3, we cancelled the auto-activation because of the latest Envato WordPress theme requirements.
Therefore, after installing/updating the plugin, please always make sure the plugin is activated.
If you need to find "Berry Extension" zip file, please go to "berry" theme folder > inc > plugins > then there is "berry-extension.zip".
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.
The recommended plugins are:
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.
Then go to Envato Market > Settings, click on the link to generate a personal token, and then insert it below, then save changes.
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.
Please follow steps below when you need to update Berry theme manually on your site:
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.
Reactivate the Required Plugin - Please make sure to reactivate Berry Extension plugin after updating. If the required plugin is not activated, some features will not be available.
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.
When importing finished, please follow the steps below:
It happens rarely, but if you have issues while importing a demo, please check the documentation Import Issues written by the author of the plugin One Click Demo Import (which we are using for demo importing feature in Berry theme).
If you see this error message after clicking on import button, this usually indicates a poor server configuration, usually on a cheap shared hosting (low values for PHP settings, missing PHP modules, and so on). Please see this article to know how to fix it.
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.
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.
After installing, click on "Run Importer", choose "demo-content.xml" in one of those 2 folders, upload and import.
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.
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.
Berry theme supports WooCommerce since v1.2. You can sell products on your own site with Berry theme and WooCommerce plugin.
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.
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.
Go to Appearance > Customize, there you can customise and personalise your theme layout and styles.
You will find the following options in this section:
In this section you can set general options for your site.
In this section you can choose nav bar style, show or hide elements in site header.
In this section you can choose to show or hide elements in site footer, and set its layout.
In this section you can change element’s color/background color/border color of your site.
The settings in this sub section will work globally.
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.
You can select a page template for your blog page. There are 3 options:
Check to show a slider of some posts at the top of the post archive. And more options for it will show:
Since v1.2.8, users can display a custom hero image instead of the Featured Slider.
In customizer, please go to Blog Page > Featured Slider Alternative. Enable the option, choose A simple hero image from the dropdown list, then upload your custom hero image.
Please note: when enable "Featured Slider Alternative", the Featured Slider created by Berry theme will be removed from your blog/home page.
Since v1.2.8, users can display a custom slider created by a third-party plugin instead of the Featured Slider created by Berry theme.
Please note: when enable "Featured Slider Alternative", the Featured Slider created by Berry theme will be removed from your blog/home page.
Why use a third-party plugin for creating a custom slider?
WordPress theme controls over the look and presentation of the material on your website, plugin extends your site functionality. Although Berry theme also provides some extra functionalities, but there already are many great plugins for creating sliders. They are powerful and flexible, some are maintained well by their authors.
It's better to provide a simple and convenient interface to support those third-party plugins than to create our own built-in custom sliders feature from scratch.
Please also note: Usually those third-party plugins provide design options so Berry theme doesn't contain any style for those plugins.
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.
Here you can control the latest post archive layout.
In this section you can set the layout and style of the 4 types of archive pages:
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.
And the Hide categories option is available since v1.2.5, so you can choose to show or hide posts' categories meta on specific archive pages.
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.
Since v1.2.4, you can choose to show subcategories instead of posts on parent category page.
In the Customizer, go to Archive Pages > Category, you will see the option at the bottom of the panel:
In this section you can control single post default template, and show or hide some elements on single post.
In this section you will be able to style your WooCommerce shop pages (New feature since v1.2).
In this section you will be able to set font options for text.
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.
In this sub section you can tweak page/post content text style for Heading Text and Content Text separately.
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:
Sometimes you might like to add some custom CSS to your site to personalize some elements' styles. In the customizer, please locate to Additional CSS sub section and add your custom CSS code. Like the example showing in the screenshot below:
This is a default feature of WordPress since WordPress v4.7. If you can’t find Additional CSS sub section in your customizer, then it means your WordPress version is lower than 4.7, please update your WordPress to the latest version.
When using Berry theme, you can display your Instagram feed on your website: in site footer as a fullwidth section, or in a widget area (sidebar) by adding the custom widget "Berry Instagram".
By default, the Instagram cache will exist for up to 2 hours, which means that if your Instagram has just added some new photos, those photos will not be shown on your website until the cache expires. In some cases, you may like to manually clear the cache. Please open your WordPress Customizer, go to Instagram Settings, find the "Clear Instagram Cache" option, and click the "Clear Cache" button.
Please note: this is a new feature added since Berry v1.4.
If you use any caching plugin on your site, you may find that sometimes your Instagram photos stop updating, especially if you haven't updated your site content for a while, such as posting a new article. This is because the Instagram feature uses PHP code to render content by default. When the cache plugin works, the code of the Instagram feature may not run.
To avoid this problem, please open your WordPress Customizer, go to Instagram Settings, find the "Load Instagram pictures dynamically with AJAX" option, tick the box to enable this option.
Please note: this is a new feature added since Berry v1.4.
Usually, when using Berry theme to display your Instagram feed, you don't need to authenticate.
However, Instagram officially recommends using Instagram Access Token for authentication and authorization. Moreover, since the Instagram API changes from time to time, using Instagram Access Token is a safer way to link your Instagram account.
In addition, although it happens very rarely, but some users may find that their Instagram feed cannot be displayed on their website without adding the Instagram Access Token. If this happens, then you will need to add your Instagram Access Token.
Step 1 – Generate your Instagram Token.
Please visit instagram.pixelunion.net, and click on “Generate Access Token” button.
Step 2 – Add your Instagram Token to your website.
Please go to Appearance > Customizer > Instagram Settings, copy and paste your token into the "Instagram Token" field. Then save the changes.
The token is not valid forever
According to the Instagram official developer documentation, the Instagram Access Token will expire after a period, it is not valid forever. However, the expiration time is NOT specified.
Therefore, if you find that your token expires, please regenerate it and add your new token to your website again.
Even though our access tokens do not specify an expiration time, your app should handle the case that either the user revokes access, or Instagram expires the token after some period of time. If the token is no longer valid, API responses will contain an “error_type=OAuthAccessTokenException”. In this case you will need to re-authenticate the user to obtain a new valid token. In other words: do not assume your access_token is valid forever. - Instagram Developer Doc
To display your latest blog posts on the homepage, you can:
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.
Berry provides 3 page templates for different page layout:
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.
Since version 1.3, users can choose to hide the page header specifically for each single page.
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.
To change the page layout and archive styles, please go to Customizer > Archive Pages > Category.
The author information will show:
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.
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.
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:
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.
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:
Berry supports 4 post formats: Standard, Gallery, Video and Audio.
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.
You can also mark a post as featured post on its edit page.
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.
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.
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.
The WordPress Excerpt is an optional summary or description of a post; in short, a post summary. And there are three different ways to show the summary to your post content.
By default, excerpt length in Berry theme is set to 25 words. So on the posts archives pages, each post displays 25 words of its content by default, and with an ellipsis … and a "Read More" button at the end. And HTML formatting and tags will be stripped from the content.
When adding <!–more–> quicktag into post content, it will display the content before the more tag when displaying your posts list, also with a "Read More" button at the end.
However, in Berry theme, if the content before the more tag is longer than 25 words (the default excerpt length set in Berry theme), then it will display content up to 25 words, and will add an ellipsis … at the end. (If the content before the more tag is shorter than 25 words, then it will not add an ellipsis.)
How to insert the more tag
When writing in the visual post editor, please click the "Insert Read More tag" button to insert a more tag.
When using the text editor, you can insert the more tag by clicking the "more" button or typing it manually: <!--more-->.
A manual excerpt is the hand-crafted summaries of your content.
To add manual excerpt, please write excerpt in the Excerpt field under the post editor.
The result on website:
If you can't find the Excerpt field, it is most likely hidden by default. Please scroll up to the top of the post edit screen, and click the Screen Options, then make sure the Excerpt box is checked.
Berry provides 1 widgets area: the left/right sidebar when the page template is not “Fullwidth”. To manage widgets, you can:
You can add widgets into the sidebar, and drag to reorder the items.
There are 8 custom widgets included in Berry.
Add brief information about you and your site.
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.
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.
The custom latest posts widget will show your latest posts with the featured image, post title and meta info.
The custom latest comments widget will show the latest comments with comment author photo, post title and comment publish date.
Add this custom widget into your sidebar to show your social menu.
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.
Enter your Facebook page URL to display the Facebook like box.
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:
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).
We have included tips and resources related to this topic in this how-to article:
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.
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.
After publish a new page or a post, you will see Translate This Document in the Language panel and a list of languages.
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.
Once you have translated the page, it will display the title and content in the language of your choice.
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.
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.
Translating post tags is just as same as translating categories. The only difference is you only need to enter tag Name and Slug.
You can also translate post categories and tags via WPML Taxonomy Translation.
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:
What you need to translate via String Translation screen:
For example: Translating Berry's custom widget - Berry Profile:
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.
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.
Go to Appearance > Menus, click on Customize the language switcher button.
The Edit Menu Language Switcher screen will pop up. There you can customize the language switcher.
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:
Please always remember to search and read WPML official documentation for more details about how to use WPML.