Skip navigation

# Documentation

An overview of Acerola, how to install and use, theme options and examples, and more.

# General Information

We would like to thank you for purchasing Acerola!

This documentation file helps you to understand the whole theme concept and how it works. You should read all sections of the file before start your work. Here have multiple detailed explain of elements, theme sections and included video tutorials.

If you have any questions that are beyond the scope of this help file, please check out and search for Forum page.

After that you still can't find the solution yet, please leave a ticket on Support system then support agents help your issue.

# WordPress Information

Surely you have already installed WordPress on your server. If you don't installed it yet and you are new to WP and have problems installing it, you might want to check out following tips.

About WordPress
  Detailed instruction about WordPress
Installing Tutorials
  Installation tutorial by WordPress
Instructional Video
  Video lessons by Woo Themes
Getting Started
  WordPress Tips for Beginners
WP101 Basix Training
  Some great videos from WPTuts on WordPress

# What’s Included In Package

You need to download theme files after you've purchased the it. Following image describes downloads section of the item and you have 2 download choices.

Downloading All Files gives you a all-files.zip file with all the content listed below

Documentation
  This is costumer's handbook. Obviously, If you can reading this file, you're open this file :)
Acerola (Zip)
  You can use this file for install function of built in WordPress.
Acerola-Child (Zip)
  Child theme. Please make your file changes in it. And this child theme helps you to keep your changes in it even updated main theme continually. You should read more details about child theme here.
Licencing (Folder)
  This contains the licensing files.
DummyData (Folder)
  You have an One Click option for import demo data. But if you need detailed xml files please pick up those here. You should read about how to use it from Dummy Data part of this document.
Changelog (Text)
  Contains changes history, date and modified files list.

Downloading the installalable WordPress theme only gives you the Acerola.zip file.

# Installation

You can either choose to upload the theme via WordPress upload function or via ftp to your site.

### 1. Via WordPress theme uploader (recommended)

Step 1
  Login to your website
Step 2
  Go to `Appearance -> Themes`
Step 3
  Click on `Install Themes` tab
Step 4
  Click on Upload link and Browse to the `Acerola.zip` file (it is located in the folder you've downloaded from ThemeForest).
Step 5
  Click `Install Now` button
Step 6
  Then you see Acerola settings page right side on Dashboard menu section.
Step 7
  Now you are ready to go. Create your new site and control it.

### 2. Via FTP client

Step 1
  Login to your hosting via FTP client application (such as FileZilla and CuteFTP)
Step 2
  Go to `wp-content -> themes` directory
Step 3
  Upload Acerola folder (uncompressed) into this directory
Step 4
  Refresh `Appearance -> Themes` of your dashboard and Activate the theme.

# Initial Settings

After the activation you see this notice at top of your dashboard. This theme requires those three additional plugins and you need to install those.

Please click on Begin insalling plugins.

Envato Toolkit
  The Envato WordPress Toolkit enables you to access your Envato WordPress purchases from within your WordPress Dashboard. It allows you to not only install themes, but also to receive update notifications and update automatically, just like regular WordPress themes.
Visual Composer
  The most advanced PageBuilder Plugin that is drag and drop frontend and backend page builder plugin that will save you tons of time working on the site content. You will be able to take full control over your WordPress site, build any layout you can imagine – no programming knowledge required
Revloution Slider
  This plugin features tons of unique transition effects, an image preloader, video embedding, autoplay that stops on user interaction and lots of easy to set options to create your own effects.
Portfolio Plugin
  This plugin an optional plugin but highly recommended for your portfolio. It has own features and sinlge post options those compatible with portfolio details section. Your portfolio posts won't let go after you activated different themes on your site and that's the biggest reason why we are adding portfolio post type as in a custom plugin.

Please select all plugins and select Install option on dropdown and finally click on Apply button.

You will see this page after activated plugins.

### Configure Envato Toolkit Plugin

Envato Toolkit plugin requires MarketPlace username and API Key. You can get API key from your Settings tab of ThemeForest account. Lets provide those infomation and get theme update anytime and easily.

# Demo Data

### One Click Demo Data Options

Theme has dedicated data option. You should click one of those link and select your desired home page layout. Action will set few important tasks including selection of Home page, Main navigation setting and Sidebar widgets when you click on Import Demo Data button.

Please wait for a while until imports all the content.

### Full content Demo site setup

Previous option helps you to include minimized demo content on your site reason for quick include. But you can have full demo data with regular XML data imports.

1. Go to Tools → Import
2. Choose WordPress from the list.
3. Upload the demo content.xml using the form provided on download.
4. You will be asked to map the authors in this export file to users on the blog. For each author, you may choose to map to an existing user on the blog or to create a new user.
5. You will then have the choice to import attachments, so click on the “Download and import file attachments” box.
6. Please be patient while WordPress imports all the content. Posts, Pages, Projects, and Menus are imported. You will need assign the menu a theme location & you’ll need to configure widgets. This is a limitation of WordPress’ import system.

# Update Instructions

#### Note

Please make sure you backup your existing theme folder before updating. Additionally we recommend performing the update on a development site before making it on your live site.

### Via Envato Toolkit Plugin (recommended)

Hope you have provided your account information in Envato Toolkit plugin. If you go to the plugin page, you'll see similar to following image. Let's click on Update automatically link at right bottom. This is a most efficienat and easy way to integrate latest verion on your site.

After clicking to auto-update, you’ll see the confirmation that everything worked correctly.

### Via WordPress theme uploader

Go to the Appearance => Themes and activate another theme than Acerola such as TwentyTwelve, TwentyThirteen or Acerola child theme. Delete the old version of the theme because folder name existing error comes up when we try to install it without deletion. Then install the theme again as you see early in this documentation.

### Via FTP client application

Usually updating a theme means replacing the old files with the new ones. You can see changelog.txt file from the new download archive and you can get updated files list as modified/added and deleted. Upload and overwrite those files on your theme directory.

If theme changed lots of files and you really hard to collect changed files, there is a better way to do it when it comes to WordPress themes.

WordPress treats two version of the same theme as different themes. That is, if you have Acerola v1.2 and v1.3 in your `wp-content/themes` folder they are treated as two different themes independent of each other.

That means you can have multiple version of the same theme installed on your blog. So whenever there is a new version of your theme available, instead of replacing or deleting the files of the older version follow this procedure.

1. Try to upload new theme archive to the site
2. If the folder name of the new version clashes with the old version, rename the folder of new version.
3. Upload the new version to your `wp-content/themes` folder via FTP or through the interface provided by your web host or by using the upload feature in WordPress.
4. Activate the new version from your dashboard.

The main advantage of following the above procedure is you can quickly switch back to the old version of the theme if you find any problems with the new version or if it clashes with any plugins you are using.

# Live Customize Panel

Live Customize panel has many options those help you to control your site. You have to know only where your desired options exist and how to use them. Please take some time to navigate through each tab and read options' description.

Group | Class | Description
--- | --- | ---
`General` | Background color | You can change the background color.
Header background color | More flexible and you can control header background color.
Logo color | it is possible to change the logo color.
Menu color | Here is you change the menu color its is more flexible.
Menu hover color | Hover color you can control your colors.
`Branding &Logo`
`Logo Image Options` |
Logo Image | Choose you logo image and see live result. If you think your logo image bigger at top, you can edit directly the image from media library popup.
Logo Width | Don't you remember? Just click on your logo image and see the image details from media library.
Favicon | 16x16, PNG/ICO/JPG
Login Page Logo | up to 274x95px
`Page Title`
Title height | You can control page title height padding.
Background image | You can select background image on your page.
`Footer`
Enable footer | On/Off
Footer text color | You can change the what you want footer text color.
Footer link color | Here is link color of footer. You can select color on you site link
CopyRight Content | Protects the copyright of all your Internet publications legally certifying the authorship of your blog posts.
`Post types`
Post |
Page | You can control your page. More flexible
Portfolio | Show your portfolio posts by category and specific numbers.
`Extras`
Export/Imports |
Custom CSS | Here is you can insert your css code.
`Widgets` |  | You can add your widgets here to sidebars and footer columns.

You can Reset all your changes back to default with bottom corner icon. Don't forget to backup your settings if you think some of them are important to you.

# Page Builder : Visual Composer

After the installation, you can configure something on following place for Visual Composer. You might want to allow VC for your custom post types initially.

Please read more about Visual Composer page builder from separate documentation file.

# Additional VC Elements by our theme

Visual composer has tons of elements that presents content view. But our theme has a few advanced elements that enriches this beautiful theme. Please hit on the tab and find elements and use them for your need. Every element has a purpose and detailed options.

Group | Description
--- | ---
`Blog posts` | Show your blog posts by 5 different column variation.
`Google maps` | The element allows options for you to fill overlay coloured layer and custom map marker image.
`Image Showcase` | Single image element but it's picture gallery and more classic.
`Portfolio` | Show your portfolio / project posts by 5 different column options and with category filter or without.
`Price table` | Here is show your insert price of gods.
`Progress Bar` | This is graphical control element and you can insert your graphical.
`Service Box` | This element is showe your company services. Additional, here is classic icons. Hope you like it.
`Team Member` | Manage your team member profile pages using our Team Member custom post type, create multiple teams.

# Page Options

You'll find Page options at bottom of your main editor. Please read the option name and description and use them for customize your every single page.

# Portfolio Options

Theme has an additional element for your portfolio. You can make your portfolio page with it first by it's options including Column variations, Filter and Pagination options.

# WooCommerce Setup

## Automatic installation

Automatic installation is the easiest option as WordPress handles the file transfers itself and you don’t even need to leave your web browser. To do an automatic install of WooCommerce log in to your WordPress admin panel and go to: Plugins > Add New. In the search field type “WooCommerce” and click Search Plugins. Once you’ve found the plugin you can view details about it such as the the point release, rating and description. Most importantly of course, you can install it by simply clicking Install Now. After clicking that link you will be asked if you’re sure you want to install the plugin. Click “yes” and WordPress will automatically complete the installation. It’s possible at this stage that you will be taken to a page requesting the FTP details of your webserver. This will be the case if you’ve not installed a plugin on this particular installation of WordPress before. If so, simply fill in your details to complete the installation..

## Manual installation

The manual installation involves downloading the plugin and uploading it to your webserver via your favourite FTP application.

1. Download the plugin " to your computer."
2. Unzip the file.
3. Using an FTP program, or your hosting control panel, upload the unzipped plugin folder to your WordPress installation’s wp-content/plugins directory.
4. Active the plugin from the Plugins menu within the WordPress admin.

After you’ve installed and activated the plugin, be sure to select ‘Install WooCommerce Pages‘ to get started.

## More details of WooCommerce setup

If you need more detailed documentation of WooCommerce usage, you should visit this link and get your information.

# Menu & Navigation controls

Menu system works through WordPress core functions. Then I hope you don't have any trouble with it. We extended menu options with a few options such as Menu Icon and Mega menu options. Please look at next images and follow the steps for your menu.

# Contact Form

Our theme is compatible with Contact form 7 and please put following markup on the Form field of your form. Then your form turns similar into our style that presents on Contact page.

    [text* your-name placeholder "Name*"]
    [email* your-email placeholder "Email*"]
    [text your-subject placeholder "Subject"]
    [textarea your-message placeholder "Message"]
    [submit "Send message"]

# Sources and Credits

Thank you to all who developed following projects/products. We really appreciate your support and time. We definitely couldn't do this template without you. We wish you all the best.

Special thanks to:

#### Open Source Projects

- Animsition
- Bootstrap
- Font awesome
- Swiper By Vladimir Kharlampidi
- Isotope
- Magnific Popup by Dmitry Semenov
- Waypoints by Caleb Troughton

#### Premium Projects

- Visual Composer by WPBakery
- Revolution Slider by ThemePunch