WelcomeBack to Top

Thank you very much for purchasing our theme. We've put a lot of hard work into it, and hope you love it as much as we do. As far as the documentation is concerned, we have tried to cover as much as possible to help you get your new theme up and running and to help you customise it.

If you have any questions or problems that aren't answered here, please feel free to email us via our user page contact form here.

We love to hear your feedback - if you find any bugs or have suggestions for improvements please get in touch. Nearly all of the time we follow your advice and issue a rapid update to Itonga.

If you like our work, please rate it. If you’re about to rate it with less than 5 stars, please let us know the reason first and we will do our best to improve the theme. Thanks so much!

WordPress InformationBack to Top

Since WordPress is constantly being updated information about how to install WordPress may become out of date, so you always can read official guide here.

Below are all the useful links for WordPress information:

Theme InstallationBack to Top

Once you've downloaded the installation file on ThemeForest, extract it and locate a file called itonga.zip. You can install the theme by using one of two installation methods:

WordPress upload

  1. Login to WordPress Admin and browse to "Appearance > Themes".
  2. Click on the "Add New" button and click "Upload Theme".
  3. Click on "Choose File" and select itonga.zip file.
  4. Click on "Install Now".
  5. When your theme is successfully installed, click "Activate" to activate the newly installed theme.

FTP upload

  1. Using FTP client, login to the server where your WordPress website is hosted.
  2. Using FTP client, navigate to the /wp-content/themes/ directory under your WordPress website's root directory.
  3. Using FTP client, upload the itonga directory to themes directory on remote server.
  4. Once uploaded, navigate to "Dashboard > Appearance > Themes" in the WordPress Dashboard and hit "Activate" below your newly uploaded theme.
When you use first or second method, please make sure that you're uploading the itonga.zip file (for first method) or itonga folder (for second method), not entire package you downloaded. If you upload the wrong file you will get an error stating “Error: missing style.css stylesheet.”

Once installation is complete, your Itonga theme will be ready to use. You should now see Itonga theme as active.

Note: If you have existing content and featured images, you will have to install Regenerate Thumbnails plugin and run it from "Tools > Regenerate Thumbnails".

Regenerate Thumbnails

If you already had images in your Media Library when you installed Itonga, you will have to resize your image thumbnails. Follow these instructions:

  1. Go to "Appearance > Install Plugins" and install Regenerate Thumbnails plugin.
  2. Next, go to "Tools > Regenerate Thumbnails".
  3. Click the "Regenerate All Thumbnails" button. It will take some time depending on the number of images you have. Do not close your browser.

Installing Required PluginsBack to Top

When you first install the theme you'll see a popup on your dashboard from the theme asking you to install a number of plugins.

Allow the theme to install these for you.

Import Demo DataBack to Top

If it's a fresh site (or a test site) with no content, it's a good idea to import demo content to get you started. You don't need to do it on a live production site as it will import several posts, pages, and images.

We have created a folder labeled Demo_Content which contains an export for the Live Preview.

  1. Log-in to your WordPress backend and open your WordPress importer "Tool > Import > WordPress".
  2. Click on "Choose file" and select the demo-content.xml.
  3. Check the box "Download and import file attachments". This will download attachments for images included in the Live Preview demo.
  4. Click "Upload file and import".

You now just need to wait for the importer to finish. This might take a few minutes depending on your hosting server speed.

Theme CustomizingBack to Top

Customize area is one of the main feature in our theme. They give you abilities to made a changes to your site without touching a single line of code.

"Customize" give you an ability to live preview changes on the site. In this field you can change a theme's custom featured content, layout, customize menus and widgets and other. You can go to theme customize at "Appearance > Customize" section from WordPress admin area.

Set Up Your HomepageBack to Top

To set up a simle blog page:

  1. Go to "Appearance > Customize > Content Area Settings".
  2. Select one of content layouts to display.
  3. Click "Publish" button.

Portfolio Set UpBack to Top

Itonga comes with a plugin "Uka Portfolio", which is responsible for adding portfolio functionality to the site.

When you first install the theme you'll see a popup on your dashboard from the theme asking you to install a number of plugins. Install the plugin "Uka Portfolio", if you need such functionality.

After activating the plugin in the admin panel of your site will be a section "Portfolio", where you can add your projects and set up categories with tags for them.

A list of your projects will be available at: yoursite.com/portfolio.

To set your portfolio as your home page:

  1. Add a new page to your site and name it "Showcase".
  2. Go to "Dashboard > Appearance > Customize > Homepage Settings" and select "A static page" for "Your homepage displays".
  3. Select your new page "Showcase" for "Homepage" and any other page for "Posts page".
  4. When add or edit portfolio item check "Add item to the showcase page." checkbox to display item at showcase page.
  5. That's all. Now the main page of your website will display selected projects from your portfolio.

In addition, the plugin "Uka Portfolio" has several settings:

To set up this go to "Dashboard > Appearance > Customize > Portfolio Settings" and customize layouts, or go to "Dashboard > Settings > Portfolio" and change other options.

If you try to view the portfolio and get a 404 error, you should update the permalinks. Go to "Dashboard > Settings > Permalinks" and click button "Save Changes".

How To Update ThemeBack to Top

If you are in need of the update, download the current build from ThemeForest to install the updated theme.

FTP Updating

If you have not customized the original theme files then you may simply drop the updated theme folder contents into the theme folder on your server – which is located in wp-content/themes/itonga.

If you wish to upload the entire updated theme as a separate theme, ensure you:

If you choose to upload the whole theme and switch to it, you may lose your Theme Customizer data and will have to add those back in.

FTP Selective Updating

On the other hand, if you have customized some files in the core theme contents, you should consider selective updating, which simply means updating only the files that are pointed out in the theme’s changelog.

There are a couple programs out there that will allow you to compare versions of files, in order to catch customizations you may not remember. Some recommended programs are WinMerge (Windows), Kaleidoscope (OSX), and handy GitHub (OSX) & (Windows).

Recommended

Overall, the safest and cleanest way to update your theme is to leave your currently modified theme on your server/site as is, rename the folder of the newly updated theme, upload the new theme, and modify that to match your original custom work. In this way, if something has gone wrong with the new version, you’re just a few clicks away from getting things back to how they originally were.

Also you can use for update Envato Market plugin.
Please note that UkaThemes is not responsible for content loss, database errors and such, which may happen to your WordPress install upon an incorrectly applied theme update.

Child ThemeBack to Top

A child theme is a theme that inherits the functionality and styling of another theme, called the parent theme. Child themes are the recommended way of modifying an existing theme.

Why use a Child Theme?

There are one main reason why you would want to use a child theme: If you modify a theme directly and it is updated, then your modifications WILL be lost. By using a child theme you will ensure that your modifications are preserved.

Installing the Child theme

Log in to your site's administration panel, and go to "Administration Panels > Appearance > Themes". Click "Add New" and follow the directions to upload the itonga-child.zip file, located in the itonga_theme folder.

Next simply click "Activate" and both the Itonga theme and Itonga child theme will be active on your WordPress site. Now you're ready to customize away.

Customizing Template Files

If you want to change more than just the stylesheet, your child theme can override any file in the parent theme: simply include a file of the same name in the child theme directory, and it will override the equivalent file in the parent theme directory when your site loads.

For instance, if you want to change the PHP code for the site header, you can include a header.php in your child theme's directory, and that file will be used instead of the parent theme's header.php.

Child Theme Functions.php

Unlike style.css, the functions.php file of a child theme does not override its counterpart from the parent. Instead, it is loaded in addition to the parent’s functions.php. (Specifically, it is loaded right before the parent’s file.)

In that way, the functions.php of a child theme provides a smart, trouble-free method of modifying the functionality of a parent theme.

Adding PHP Functions

Say that you want to add a PHP function to your theme. The fastest way would be to open the itonga/functions.php file and put the function there... But that’s not smart: The next time Itonga is updated, your function will disappear (as the entire contents of the itonga folder are replaced upon an update).

However, there is an alternative way which is the smart way: you can create a child theme, add a functions.php file in it, and add your function to that file. The function will do the exact same job from there too, with the advantage that it will not be affected by future updates of the parent theme.

Do not copy the full content of functions.php of the parent theme into functions.php in the child theme. It's not a good practice by any means.

Modifiying PHP Functions

You can use this same exact methodology to modify functions that are within the parent theme's files. Let's take a quick look at an example.

Below is an example of a typical function within most of our WordPress themes - a template tag that displays the entry date.

You would find this function (located in the itonga/inc/template-tags.php file) then copy it over to the child theme like such:

And then edit it as you see fit. This function will load before the one in the theme, which is pluggable — that is, replaceable by a child theme — conditionally.

Note that this example is for this specifcic function, you can do the same with any pluggable function that contains the following:

To learn more, read the this article on the WordPress Codex.

Translation ThemeBack to Top

You can find .POT file in next folder wp-content/themes/itonga/languages/.

  1. Install Loco Translate Plugin.
  2. Read more here.

Supported PluginsBack to Top

Theme supports the following plugins:

Contact Form 7

"Contact Form 7" can manage multiple contact forms, plus you can customize the form and the mail contents flexibly with simple markup.

Installing "Contact Form 7" can be done either by searching for "Contact Form 7" via the "Plugins > Add New" screen in your WordPress dashboard or by using the following steps:

  1. Download the plugin via WordPress.org.
  2. Upload the ZIP file through the "Plugins > Add New > Upload" screen in your WordPress dashboard.
  3. Activate the plugin through the Plugins menu in WordPress.

Settings:

  1. Go to "Contact > Contact Forms" and edit your contact form.
  2. Copy your contact form shortcode.
  3. Go to "Pages > Add New", add title for page and insert this shortcode to page text field.
  4. Press "Publish" button. Contact form will be displaying on this page.