### Kona WordPress Theme Documentation

First of all, a big thank you for purchasing this theme. This document includes a how-to guide and helpful informations about options and features of the theme.

### Support

Please read and search this documentation file before seeking support. If you have any questions that are beyond the scope of this document you can still contact us and open a support ticket here.

Do not use the comment section on the themeforest item page.
This will slow down the support process.

Please make sure that you are using the latest theme and plugin versions before asking for help.

### Theme Installation See video tutorial

This theme requires the latest Wordpress version (4.9 and later).

There are 2 different ways to upload/install the theme.

1. FTP: Unpack the kona.zip and upload the unpacked folder into the wp-content/themes/ folder
2. WordPress: Login into WordPress and go to Appearance > Add New Themes > Upload. Select the zipped theme file kona.zip and click Install Now.

Once you have uploaded the theme you need to activate it. Go to Appearance > Themes and you should see the new Theme. Click Activate.

After activating the theme you will see a notice to install required plugins.
Click on "Begin installing plugin" and install them. Note that the installation process can take several minutes!

You can now import the demo content if wanted. (Recommended)

### Import Demo See video tutorial

PHP Configuration limits

Make sure to fulfil at least these PHP configuration parameters before importing a demo. You can either increase these limits on your own, or contact your web host.

- max_execution_time 300
- upload_max_filesize 64M
- memory_limit 96M
- post_max_size 32M

You can import the demo content with just one click. Go to Appearance > Theme Options > Import Demo and choose the demo you want import. The importing process can take several minutes.

### Update Theme

If you need to update the theme, there are 3 ways to do this:

- Auto Update: Download the Envato Market plugin to get automatic updates for your themes and plugins.https://envato.com/market-plugin/
- WordPress: Deactivate the current theme by activating any other theme. Once the theme is not active you can delete this theme. After deleting it install the new updated theme and activate it. Don't worry, you won't lose your settings,options,content, ...
- FTP: Delete the current theme folder 'kona' in wp-content/themes/ and upload the new one.

NOTE You won't lose your settings,options,content, ... But if you did customizations to the theme files (edit/add code), they will of course be lost because the files are replaced by the new files. This is the reason why you always should use a child theme to make your customizations.

#### Update Plugins

If one of the plugins needs an update, a message will appear to update this plugin. Click on "begin updating plugin" and update it.

If this doesn't work, there is a second method to update the plugin. Follow these steps:

- Go to Plugins > Installed Plugins
- Deactivate the plugin in question
- Once deactivated, delete the plugin in question.
- Now you will get a message again, for installing the plugin.

### Customize Theme

If you want to make any customizations to the theme, it is recommended to use the child theme. You shouldn't change anything on the original files, because these changes will be lost on the next update.

### Theme Options

The theme uses its own Theme options panel which you can access by navigating to Appearance > Theme Options. They give you full control over your website, and you can customize a design without using a single line of code.

Please go through all options to set up your site to the way you want it.

### Adding Logo

Please upload your logo in 2 different version to the media library.

- Dark logo
- Light logo

Retina ready

If you want to make your logo retina ready you need to upload the @2x version of your dark + light logo. The @2x version should have double the size of the normal logo.
Example: your dark logo is called dark-logo.png (100px * 40px). Call your retina logo dark-logo@2x.png (200px * 80px) and upload it. It's very important that you upload both logos to the library at the same time/day.

Once you uploaded your logos to the library you can select your Logo in the Theme Options.

1. Go to Appearance > Theme Options > General
2. Add your Logo(s) by clicking on Upload Image
3. Choose your image on your Media Library OR upload a new image and click on Select Image. Make sure to select the normal logo version, not the @2x version.

#### Favicon

You can also upload a favicon to the them options panel. This will only have impact if you did not upload any Site Icon for your Site identity in Appearance > Customize > Site identity. It is recommended to upload a Site Icon instead of the theme option favicon.

### Header

Set up your default header appearance layout in the theme options.

### Menu

If you imported a demo, a menu has also be imported.

#### Basic Menu

1. Go To Apperance > Menu
2. Create A New Menu by clicking on create a new menu
3. Add your menu items by selecting them on the left side
4. Choose "Primary Menu" as location and save your menu

Now, head to Appearance > Theme Options > Header & Menu and select your preferred Menu Layout.

#### Mega Menu

This theme has a Mega Menu option without the use of a plugin or coding skills.

To turn on a Mega Menu, just create a normal (usual) menu as you done for basic menu setup. Once you have done this, follow the below steps.

1. Click on the arrow of the menu item which you want to transform to mega menu and choose how many colums you would like.
2. Add now the sub items for this menu item (if you choosed 4 columns = 4 sub item). These are the columns.
3. Now add sub items to the columns

### Footer

Choose your Footer layout in Appearance > Theme Options > Footer.

Now you can add different widgets to add different content to the footer area.

### Typography

This themes gives you full control about your typography and fonts.

Choose your font and typography settings for the different parts and elements.

Additionally, you can also select different font sizes for different devices.

#### Font Manager

You can add fonts from Typekit or custom fonts. To do so scroll down to the font manager and add a new font.

Important It's very important that you enter the correct values for the "Family Name" and "Weights & Style".
Choose your type (Typekit,Custom Font,Google font). Only choose "Google font" when the font does not show in the Font list but is well available on the google font library.

Once you've added the font you can select it on the font list, add the very top.

##### Typekit

1. Add the font(s) to the font manager with the correct values and check the 'Typekit' type.
2. Put the ID / TOKEN (which you got from typekit) to the typekit field.

Important For typekit you need to use the familay name typekits gives you. For example:
Proxima Nova would be proxima-nova
Brandon Grotesque would be brandon-grotesque

##### Custom fonts

Follow these steps if you want to use a customwebfont

1. Make sure you have installed the Child theme.
2. Copy the folder/files that contain the web font to the Child theme.
3. Copy the @fontface CSS, and put it inside the style.css of the theme child, it should look something like the following code example.

       @font-face{
       font-family: 'MyWebFont';
       src: url('folder/WebFont.eot');
       src: url('folder/WebFont.eot?#iefix') format('embedded-opentype'),
       url('folder/WebFont.woff') format('woff'),
       url('folder/WebFont.ttf') format('truetype'),
       url('folder/WebFont.svg#webfont') format('svg');
       }

   MyWebFont is the name you need also to use when adding the font to the font manager
4. Add the font(s) to the font manager with the correct values and check the 'Custom Font' type.

### Social Networks

For all social networks you have a profile, please enter the url's of these profiles.

With the shortcode [sr-social style="normal"], you can now display these networks on any part of your website. Usually it is entered into a footer area or menu area.

### Blog Setup

First of all, create a page where your Blog posts should be displayed. Once the page is created head to Settings > Reading and choose "A static page" and choose your Blog page you just created for "Posts Page". All your blog posts will be displayed on this page.

Note If you don't have selected a page for "Front Page" yet, you should select one. This is the main front page (home page) the visitor will see when it visits to your site.

Select also an amount for "Blog pages show at most". This is the amount of posts shown per page.

Head now to Appearance > Theme Options > Blog to setup your general blog layout appearance.
If you choose a layout with sidebar you can add your widgets for the sidebar in Appearance > Widgets.

#### Add blog posts to any page

The pagebuilder gives you the possibility easily add some posts in any page you want.

To do so, just add a "Blog Posts" Element to the pagebuilder and set up your options.

### Blog Posts

To create blog posts, just go to Posts > Add New.
Select your post format and depending on the forma set up the different options related to your format.

Add now your content to the editor and save the post.

Note You will find further option like sharing, pagination, show date, ... in the theme options.

#### Add Featured Image

Featured Images are very important for this Theme. You should add a featured image to all your posts. This is the image which will "represent" your project (on the grid, sharing, ...). To do so, click on Set featured image and choose your Image.

### Shop Setup

Make sure to have the WooCommerce plugin installed. If not, go to Appearance > Install Plugins and install & activate it.

Once installed, you might be redirected to "Run the Setup Wizard".

Important If you plan to import one of the shop demos, it is not recommended to run the wizard, because this will create double pages for 'cart','checkout','my account'. So in this case you should skip it, import the demo and set up your different WooComerce settings manually by going to WooCommmerce > Settings.

#### Product Size Guide plugin See video tutorial

Kona comes bundled with the WooCommerce Product Size Guide plugin. If you need a size guide feature, install this plugin and follow the video tutorial to know how to set them up.

### Product Variations

Kona has the feature to add beautiful variations swatches to your single products and on the archive/shop page.

To do so, it uses the WooCommerce Variation Swatches plugin which comes bundled with the theme.

Note In the Swatches Settings it is recommended to disable the 'Enable Stylesheet' option.

Info There also exist a Pro Version of this plugin, but this is not mandatory. It will also work with the free version.

#### Variations on Archive/Shop Page

To activate the variation on your archive/Shop page you just need to go to Theme Options > Shop and activate the option Enable variations .

### Hero & Page Title See video tutorial

The Hero / Page Title is the first content of the page. It can contain a big image,video,slider,etc. or just the name of a page.

You can set up individual hero for each of your page/portfolio/post. Go to your page and scroll down to the "Page Title / Hero Settings".

For the hero, you can choose between different background options (color,image,video or slider).

Note If "Show Pagetitle" is off and no background option is selected for the "Hero Type", no pagetitle/hero will be showed and your page starts with the normal content.

### Pagebuilder

This theme uses a build-in pagebuilder to handle it's content. Using Kona's pagebuilder, you can create beautiful layouts with ease and control every part of your page.

To activate the Pagebuilder, click on the blue pagebuilder button on the default Wordpress editor.

Attention When you activate the Pagebuilder you will lose all the editor content.
Important Pagebuilder is can not be activated on blog posts yet. This might change in future.

You can now start adding your different rows and elements.

### Shortcodes

The Shortcodes mainly are selfexplained. You can access the Shortcodes via the shortcode button (blue "+" button). This allows you to add some small elements like buttons, icons, tabs, etc.

### Revolution Slider

Revolution Slider Update 6.0+

If you purchased the theme before the version 6.0 has been released, you might ckeck all your sliders after the update to version 6 (or higher). You should also update the code for changing the logo color depending on the slider background (see below).

The theme comes packed with the incredible Revolution slider plugin. This great plugin has loads of useful options. We recommend you to have a look at the original Slider Revolution resources to learn more about the plugin and its usage.

- Official product page
- Official documentation

#### Include Slider to your page

To inlcude the slider into your page go to the Hero settings and select Revolution Slider. Select here the slider you want to include in the hero part of the page.

If no slider exist yet, please create one by heading to Slider Recolution > New Slider.

#### Change Logo color depending slider background

The feature you need to know about the combination with Kona and Revolution Slider is the automatic color change for the header part (logo + menu). To activate this feature, just add the classnames text-light or text-dark based on the slide skin.

Make sure to add this for each of your slide.

Now you need to add some javascript.
Go to your slider settings and scroll down to the Custom CSS / Javascript section. Paste the following into the "Custom Javascript" field.
New Code (Since Revolution Slider version 6.0)

    revapi1.bind("revolution.slide.onchange",function (e,data) {
     if (data.currentslide.hasClass('text-light')) {
    	if (jQuery("#hero").hasClass("hero-fullwidth")) { jQuery(".header-inner").addClass("header-light");}
    	jQuery("#hero rs-module .tparrows.custom").addClass("kona-light").removeClass("kona-dark");
    	jQuery("#hero rs-module .tp-bullets.custom").addClass("kona-light").removeClass("kona-dark");
    	jQuery("#hero rs-module .kona-tabs").addClass("kona-light").removeClass("kona-dark");
     } else {
    	jQuery(".header-inner").removeClass("header-light");
    	jQuery("#hero rs-module .tparrows.custom").addClass("kona-dark").removeClass("kona-light");
    	jQuery("#hero rs-module .tp-bullets.custom").addClass("kona-dark").removeClass("kona-light");
    	jQuery("#hero rs-module .kona-tabs").addClass("kona-dark").removeClass("kona-light");
     }
    });

Old Code

    revapi1.bind("revolution.slide.onchange",function (e,data) {
     if (data.currentslide.hasClass('text-light')) {
    	jQuery("#logo").addClass("text-light");
    	jQuery("#hero #scrolldown").addClass("text-light");
    	jQuery("#hero .revolution-slider .kona-nav").addClass("kona-light").removeClass("kona-dark");
    	jQuery("#hero .revolution-slider .kona-bullets").addClass("kona-light").removeClass("kona-dark");
     } else {
    	jQuery("#logo").removeClass("text-light");
    	jQuery("#hero #scrolldown").removeClass("text-light");
    	jQuery("#hero .revolution-slider .kona-nav").addClass("kona-dark").removeClass("kona-light");
    	jQuery("#hero .revolution-slider .kona-bullets").addClass("kona-dark").removeClass("kona-light");
     }
    });

`revapi1` You might have to change this. Ceck it by clicking on "API Functions" and check the name.
If the name is different adapt it in the javascript field.

### Retina

I recommend to install the plugin WP Retina 2x by Jordan Meow. After activating it, go to Meow Apps > Retina, choose the Picturefill method and save your your changes.

### Multilingual / WPML

Kona is tested and certified by the WPML official team. WPML is the best known WordPress plugin for multi-language websites. WPML makes it easy to build multilingual sites and run them. It’s powerful enough for corporate sites, yet simple for blogs.

Have a look at the WPML Website for more information and documentation.

#### How to setup WPML with Kona theme

After you installed the wpml plugin, go through the wpml setup. In the "language Switcher" step, it is recommended to NOT add the switcher to the menu,widget or footer. Instead, activate the Theme switcher in Theme Options > Header & Menu > WPML

#### Duplicate pages,post for translation

The duplicate option is the recommended option to create the translations for your pages. Because, if you're using the '+' icon to add translation, it will not duplicate the content, and for pages,posts with a lot of pagebuilder elements, you will need to recreate all these elements and structure. So instead, use the duplicate option.
This is the only way you can copy/duplicate the pagebuilder content.

To do so, go to your page,post,portfolio you want to translate and check the Duplicate checkbox of all the languages you want to translate and click on the "Duplicate" button.

Once you've done this the page has been duplicated and you can now edit the wanted language of this page.

When you decide to provide any page,posts,portfolio project in different language, WPML will duplicate this page,post,project for each of your language. This means, If you decide to deactivate the wpml plugin any time later, you will have multiple/duplicated pages,posts,projects.

#### Translate the theme related words/strings

When making your site multilingual, you will see some theme related words/senteces which you can't change. For example "Next Project" in the single portfolio navigation. You need to install the "WPML String Translation" plugin. Thanks to this you can translate any theme related string.

### Duplicate Pages, Posts, Projects

The theme does not have a build in duplicate option but there are tons of plugins which does this. The best plugin, and the one which is compatible with the Kona theme, is the WP Duplicate posts pages & CPT

Note After duplicating pages, I recommend to manually change the publication date of the duplicated item, in order to have a different date than the original page.

### Newsletter Mailchimp See video tutorial

There are tons of ways to register users emails in order to use it for a Newsletter System. The Contact Form 7 Mailchimp integration makes it really easy to add visitors to your mailing list. Whenever someone submits a form they are automatically added to Mailchimp.

Install and activate the Contact Form 7 MailChimp Extension and use it with the contact form 7 plugin which comes bundled with the theme. Follow the Video tutorial on how to set it up.

In order to use the theme's layout and style for the sign-up field it is recommended to use the following code for your form.
If you use the code above you should delete the 'Subscriber Name' in the Mailchimp Settings because this field does not exist

    <div class="newsletter-signup">[email* your-email placeholder"Email address"][submit "Sign Up"]</div>

### Ressources / Credits

#### Javascipt / jQuery

- jQuery by John Resig
- Isotope by David DeSandro
- Images Laoded by David DeSandro
- Easing by George Smith
- Owlcarousel by Bartosz Wojciechowski
- Fit-Vids by Chris Coyier
- jQuery vissible by Digital Fusion
- Tweenmax by Greensock
- Lightcase by Cornel Bopp Art
- Revolution Slider by Themepunch

#### CSS / Fonts

- Ionicons
- Font Awesome
- Google Fonts