< and upload that folder to `wp-content/themes` folder on your host
- Go to `Appearance > Themes` and activate **Calliope** theme
Install plugins
----------------
After installing Calliope, you'll see a notification in the top of the page that says the theme needs some plugins to function properly.
Calliope theme **requires** following plugins:
- [Meta Box](http://wordpress.org/plugins/meta-box/): plugin for creating meta boxes for posts, pages,... It is free and available on WordPress.org
- WPBakery Visual Composer: premium plugin for page builder. It is the most popular plugin on Codecanyon.
Calliope theme **recommends** following plugins:
- [Contact Form 7](https://wordpress.org/plugins/contact-form-7/): plugin for creating contact forms. It is free and available on WordPress.org
- OT Portfolio: Portfolio plugin allows you to create a page containing the information about your past projects.
- OT Testimonial: Easily add social proofing to your website with Testimonials Widget. List or slide reviews via functions, shortcodes, or widgets.
Calliope is working perfectly with these plugins. It automatically adds more styles to them to make the design match the theme.
To install these plugins:
- Click **Begin installing plugins**
- You'll be redirect to a page where all needed plugins are listed. Just click on **Install** below each plugin's name
- After installing, if it's required to activate the plugin, just activate
Import demo content
-------------------
If you are new to WordPress and have problems with setting up the theme you might want to import the demo content file that comes with the theme. The following actions will import some dummy posts and pages from the live preview:
- Go to `Tools > Import`
- Select **WordPress** from the list
- If you haven't installed the **WordPress import plugin**, a popup window will appears and ask you to install it. Just click **Install Now**. When the installation progress is completed, click **Activate Plugin & Run Importer**. If you have installed this plugin, skip to next step.
- Click **Browse** and select `sample-content.xml` file from the download package
- Click **Upload file and import**
- When you are asked to import author, you can create new author or import to existing author. You also should check the checkbox **Download and import file attachments**.
After completing all above steps, go to `Posts`, `Pages`, `Portfolios`, `Team` to see imported data.
Import Theme Option
-------------------
Following these steps to import theme option:
- Go to `Calliope options > import/export`
- **[1]**: Click to **import from file**
- **[2]**: Copy code in file 'theme-option.txt' and paste
- **[3]**: Click to `import`
Setup homepage and blog page
-------------------------------------
After install demo content, you'll see a page 8 Homepage pages, as you see on our demo. You can use one of theme as the homepage of the website. To set it as homepage, please go to `Settings \ Reading`, under **Front page displays**, please chose **A static page (select below)** and select a homepage version (eg: Homepage Slider Dark) for **Front page** and select **Blog** page for **Posts page**.
Setup Menu
--------------
Although the theme is working now and it shows menu, but because we haven't created a menu for primary location, the theme will display all pages by default. But displaying pages instead of one page sections is a bad idea, because Calliope is one page theme.
###Edit imported menu (recommend)
When you import demo data, WordPress automatically create a menu for you, named **Menu Main**.
- Go to `Appearance > Menus`
- Scroll to bottom of page and check **Primary Menu** for **_Theme location_**
- Click **Save Menu**
###Create New Menu
Following these steps to create a menu **OnePage(use Canvas Template)**:
- Go to `Appearance > Menus`
- Click the **create a new menu** link to create new menu.
- For normal menu item: Add URL and Link Text from the left Custom Links box and click **Add to Menu**
- On the right, feel free to drag and drop menu items to organize them
- When you're done moving menu items, check **Primary Menu** for **Theme locations** at the bottom of the page
- Click **Save Menu**
**1**: Click to create a new menu.
**2**: Enter menu name. Ex: Menu Main.
**3**: Add Custom Links to create.
**4**: Display menu.
**5**: Tick menu.
------------------------------
Create Your Home Page
====================
Calliope uses page template and meta box to create home page, so the first step is just creating a page using `Canvas` template (or you can edit exists page that has been imported via sample content file).
Calliope theme comes with Visual Composer plugin. This plugin allows you to forget about shortcodes and create most complex layouts within minutes without writing a single line of code!
###Visual Composer Basics
It has very simple and intuitive interface, but before getting started, you may find it useful to get accustomed with its documentation:
[Visual Composer Documentation](https://wpbakery.atlassian.net/wiki/display/VC/Visual+Composer+Pagebuilder+for+WordPress?title=Visual_Composer)
In Calliope theme, we also create some new Elements and add some new parameters to exists elements of Visual Composer. It will help you a lot to build your One Page easier. Following we will go through some popular elements of Visual Composer and all of new elements that Calliope theme brings to you.
###Row
This is the most popular you can't live without when using Visual Composer. In Calliope theme, we use it as a section of One Page. So, when you edit a row, there is new parameters you will see beside the defaults:
**_General tab_**:
- **Row ID**: Enter row ID (Note: make sure it is unique and valid according to [w3c specification](http://www.w3schools.com/tags/att_global_id.asp)).
- **Extra class name**: Style particular content element differently - add a class name and refer to it in custom CSS.
- **Parent Section**: Select Parent Section or not, Default: **Yes**. This Option use when build **OnePage**(Canvas) as demo. With other page should select **No**.
- **Show Footer In Bottom**: Select show or not, Default: **Yes**. Use when build **OnePage**(Canvas) as demo too.
- **Full width**: Select Fullwidth or not, Default: No fullwidth.
**_Design options tab_**:
- **Css**: It hepl you to change margin, border and padding.
- **Overlay**: This option allows to place an additional layer above the row's background.
- **Border**: Select a color for border.
- **Background **: Select a color for background.
- **Set Image**: Select a image conformity with content.
- **Box controls**: select this option will you to simplify controls.
###Column
As Row, column is also the most popular element in Visual Composer, they are always be together. In Calliope theme, we add new tab called "**Animation**" when you edit a column. This tab contains options allow you to set up animation for that column when it appear on screen for the first time. This tab contains following options:
**_General_**
- **Extra class name**: Style particular content element differently - add a class name and refer to it in custom CSS.
**_Design options_**:
- **Css**: It hepl you to change margin, border and padding.
- **Overlay**: This option allows to place an additional layer above the row's background.
- **Border**: Select a color for border.
- **Background **: Select a color for background.
- **set image**: Select a image conformity with content.
- **Box controls**: select this option will you to simplify controls.
**_Width and Responsiveness_**:
- **Width**: Select number column.
- **Responsiveness **: Adjust column for different screen sizes. Control width, offset and visibility settings.
###Heading
This element is used to create the title area for each heading. It is used in almost heading in our demo. It contains following parameters:
- **Text**: The title content
- **Element Tag**: Section Element Tag
- **Text Align**: Section Overlay.
- **Font Size**: Select font size.
- **Color**: Select color.
- **Margin Bottom**: Enter margin bottom.
- **Extra class name**: Enter extra class names if you want to apply your own style rule.
###Socials
It contains following parameters:
- **Icon 1**: Find [here](http://fontawesome.io/icons/).
- **Link 1**: Add button link 1.
- **Icon 2**: Find [here](http://fontawesome.io/icons/).
- **Link 2**: Add button link 2.
- **Icon 3**: Find [here](http://fontawesome.io/icons/).
- **Link 3**: Add button link 3.
- **Icon 4**: Find [here](http://fontawesome.io/icons/).
- **Link 4**: Add button link 4.
- **Icon 5**: Find [here](http://fontawesome.io/icons/).
- **Link 5**: Add button link 5.
###Gallery Post
It contains following parameters:
- **Images Slider**: Upload image slider if not use image.
###Video Post
It contains following parameters:
- **Link Video**: Ex: http://player.vimeo.com/video/88883554 or http://www.youtube.com/embed/eP2VWNtU5rw
###Our Team
It contains following parameters:
- **Photo Member**: Avarta of member, Recomended Size: 420 x 420.
- **Name**: Member's Name.
- **Job**: Member's job.
- **Icon 1**: Find [here](http://fontawesome.io/icons/)
- **Url 1**: Add link 1.
- **Icon 2**: Find [here](http://fontawesome.io/icons/)
- **Url 2**: Add link 2.
- **Icon 3**: Find [here](http://fontawesome.io/icons/)
- **Url 3**: Add link 3.
- **Icon 4**: Find [here](http://fontawesome.io/icons/)
- **Url 4**: Add link 4.
###Our Skills
It contains following parameters:
- **Skill Name**: Enter skill name.
- **Skill Percent**: Enter skill percent.
###Testimonial Item
This element is used to present a carousel item of testimonials. It contains following options:
- **Number Post**: Enter number post.
###Services Slider
It contains following parameters:
- **Number Post**: Enter number post.
###Service Box
It contains following parameters:
- **Image Service**: Image Top Services box.
- **Icon Service**: Add class icon. Ex: heart. Find [here](http://fontawesome.io/icons/)
- **Title Service**: Title display in Services box.
- **Content Service**: Enter content service.
- **Label Button**: Enter label button.
- **Link Service**: Add link service.
###Contact Info
It contains following parameters:
- **Icon**: Add class icon. Ex: heart. Find [here](http://fontawesome.io/icons/).
- **Infomation**: Add description info.
###Google Maps
It contains following parameters:
- **Latitude**:Please enter [Latitude](http://www.latlong.net/) google map
- **Longitude**: Please enter [Latitude](http://www.latlong.net/) google map
- Location Image**: Upload Location Image.
- **Tootip Location Click**: Add tootip location click.
- **Zoom map number**: Please enter Zoom Map, Default: 14.
- **Height (px)**: Enter height, Default 450px.
------------------------------
Theme Options
=============
Calliope theme comes with unique, creative and easy-to-use Theme Options page. You can change all theme options in one place!
All options have full description so you can know what you are doing. Just click and save!
------------------------------
Post Format
===========
[Post Formats](http://codex.wordpress.org/Post_Formats) is theme feature which is a piece of meta information that can be used by a theme to customize its presentation of a post.
In short, with a theme that supports Post Formats, a blogger can change how each post looks by choosing a Post Format from a radio-button list.
Calliope theme supports the following post formats:
- `gallery` - A gallery of images, which will be displayed in a responsive image slider, powered by Flexslider.
- `image` - A single image, which will be shown above post title.
- `video` - A single video, which can be any video from Youtube, Video or other video websites. Support URL or embed code. The video will be displayed above post title.
- `audio` - An audio file, which can be any video from Youtube, Video or other video websites. Support URL or embed code. The video will be displayed using a powerful HTML5 audio player provided by Wordpress as default player.
Using post format in Calliope lets you differentiate post from each other and make the blog page / single page looks more beautiful.
[Go to blog page](http://demo.vegatheme.com/Calliope/blog/) to see how post formats look.
When you edit a post, select a format you want to apply to that post on the **Format** meta box on the right:
When you choose a format, a corresponding meta box will appear **below** the content editor, here's the list of them:
All you need to do is just enter **all** information in the fields in these meta boxes. This information will be used to decorate the post. For example: gallery post format will uses uploaded images to show a slider above post title, a video post will display a video player above post title, etc.
------------------------------
Create And Manage Portfolio
===========================
Setting up the portfolio is quite easy and it requires only a few steps to set it up. Of course you need to install the "OT Portfolio Management" plugin in this case ( if you have not done it already ). Within the first step we recommend to create the portfolio categories first. This will make sure everything is right there when you need it. But what are portfolio categories? Let's take a look at the following example. Imagine you are a photographer and you have a wide range of images you like to show to the crowd. Inside your portfolio you have landscape and portrait images, than these both would be exactly your categories. Categories are mainly used for filtering your portfolio items later on.
Add Portfolio Categories
------------------------
In order to add new Portfolio category:
**[1]** Go to `Portfolio > Categories`
**[2]** Enter category name and hit `Enter`
Add Portfolio Project
---------------------
Now you can start adding your portfolio item. Go to `Portfolio > Add new`. Basically there is not big difference to a regular blog post, all elements like featured image and the WordPress Editor are in the same place.
And these portfolio posts are handeled exactly the same way as blog post, with one exception, you need to set a featured image for all kind of post formats. These images are used inside the portfolio overview.
**[1]** Enter portfolio project name here
**[2]** Select `backend editor` to add element
**[3]** Add element
**[5]** Select portfolio categories
**[6]** Upload portfolio featured image
**[8]** Click publish
Translation
=========
###Tell WordPress which language file to use.
If you don’t use WordPress in your native language so far, you have to tell WordPress which language to use to activate the theme translation.
You can do this by editing the wp-config.php file (the file is located in the main directory of your WordPress files) and defining the WPLANG constant. You have to set your language code there, for example fr_FR for French translation.
ust add the line below to your wp-config.php or change it if it already exists:
`define ('WPLANG', 'fr_FR');`
###First Method: Using Codestyling Plugin
The easiest way to translate your theme locally is by using the [Codestyling Localization](https://wordpress.org/plugins/codestyling-localization/) plugin. After you have installed and activated the plugin, simply go to `Tools > Localization` (shown in your language) and translate the theme from your WordPress backend following the [plugin instructions](http://www.code-styling.de/english/development/wordpress-plugin-codestyling-localization-en)
###Second Mothod: Using Poedit
Poedit is a common program which you can use to translate the theme. It’s available for free on [poedit.net](http://www.poedit.net/).
After you have installed Poedit, you can open it and select `File > New Catalog from POT file`. Then select the .pot file from the theme you wish to translate which you can find in the `/languages/` folder of theme.
Then go through every line of text and translate it to your native language. Afterwards you can save the catalog with your language code (for example `en_US.po`). Normally Poedit automatically creates the .mo file and saves it, too.
The last step you have to do is to upload your created language files to the language folder of your theme using FTP.
------------------------------
Child Theme
===========
Fastlat is fully child theme compatible. We have attached a basic child theme to the download package which contains the minimum of required files. If you are planing any code customisations we highly recommend to do this inside the child theme! Learn more about child themes [here](http://codex.wordpress.org/Child_Themes)
Need Helps
=========
If you need help, please do not hesitate to contact us! To grant best support we set up a support forum at [http://support.oceanthemes.net](http://support.oceanthemes.net). Channeling all requests at one place keeps and makes it simple, easier and even more effective for every customers to get quick help. All issues, requests and questions can be discussed and answered at one place. Please note, you will only get access to our forums with a valid purchase key!
]]>