Getting Started

Before you can start playing around with your new theme, let’s first check what the theme package includes. After you have downloaded the .zip file from ThemeForest and unzipped it, its should reveal the following folders:

Demo Content
Documentation
Hawa Theme
Licensing

Installing Hawa

After downloading the Hawa installation file from ThemeForest, extract it and in the extracted folder locate the Hawawp.zip file. You can then install the Hawa theme using one of two methods described below.

It really doesn’t matter at all which one of these techniques you want to use, so choose the one which seems to make more sense to you.

1. WordPress upload – For most users, this is probably the simplest installation method. To install the Hawa theme using this method, please follow these steps:
   1. Login to your WordPress admin panel
   2. Navigate to Appearance > Themes > Add New > Upload Theme
   3. Click on Choose File and select Hawawp.zip
   4. Click on Install Now
2. FTP upload – If you would like to install the Hawa theme via FTP, please follow these steps:
   1. Extract the Hawawp.zip file you previously located. You should now see a folder named Hawawp
   2. Using an FTP client, login to the server where your WordPress website is hosted
   3. Using an FTP client, navigate to the /wp-content/themes/ directory under your WordPress website’s root directory
   4. Using an FTP client, upload the previously extracted Hawawp folder to the themes directory on your remote server

Activate the Theme

Once the installation is complete, your Hawa theme will be ready for use. Now all you need to do is navigate to Appearance > Themesand activate the Hawa theme. After you have done this, you should see there one more theme called Hawa. Find it and just click Activate (if theme was uploaded via FTP).

Or click Activate right after theme was installed (if it was installed with Theme Uploader)

After you have done this, you should also see notification that appears in the left navigation bar of  your WordPress admin panel. It require plugins that need to be installed. Please install and activate all of the required plugins, since they are necessary for the theme to function properly

Installation (Importing Demo Content)

After activating theme will be opened quick setup wizard. It will help you to install theme required plugins, demo content. Just in a few clicks your website will be ready for use.

Read welcome message and click “Continue”.

Wizard will ask you to install theme required plugins. Click “Continue” and it will install and activate all required plugins.

Default Content. By clicking “Continue” setup wizard will import all demo data – pages, posts, portfolios and media files. Please note that import provess will take time needed to download all attachments.

Theme customization. Here you can read information about widgets and child theme. Click “Continue”.

That’s all! Theme required plugins were installed and demo content was imported.

There is the last step – Setting menu. Go to Appearance > Menus. All that you need is to mark “Main menu” as Primary menu and Save changes.

Updating Hawa

You can update your theme by performing the following steps:

1. Download the latest theme .zip file from ThemeForest
2. Extract it and locate Hawawp.zip
3. Extract Hawawp.zip and locate the Hawawp folder
4. Copy/Replace the contents of the Hawawp folder to the /wp-content/themes/Hawawp folder of your web site.

Troubleshooting FAQ

1. Why can’t I save my menu?

WordPress by default has a limited number of menu items. When you import our demo content, which contains a lot of menu items, you might not be able to save changes you make to a menu. You can fix this problem by contacting your hosting and asking them to add the following lines to the php.ini file:

1. suhosin.post.max_vars = 5000
2. suhosin.request.max_vars = 5000

2. Why is there a smiley displayed on blank pages?

This problem is most likely related to JetPack and memory settings of your hosting. You can either disable JetPack or read what the JetPack developer wrote: Regarding the memory limit, please refer to the WordPress Codex section concerning this problem. Some sites that load many plugins alongside WordPress ultimately require a higher memory limit than WordPress defaults to, but since this is limited to specific hosts and configurations, it must be dealt with on an individual basis. You’ll find the Codex article at: http://codex.wordpress.org/Common_WordPress_Errors#Allowed_memory_size_exhausted

3. How do I optimize my site?

Please use this tool to investigate reasons for slow loading: https://developers.google.com/speed/pagespeed/insights/?hl=en

4. How to translate or rename default theme labels?

You can use the Poedit software (http://poedit.net/wordpress) to translate/rename all the theme’s labels. Another solution is to edit the theme folder/languages/en_US.po file directly in a text editor and manually edit the labels you want to translate.

5. Why do I see a white screen when importing demo content?

If you get a white screen or some other error when trying to import our demo content, this probably happens because of the maximum execution time limit. You need to increase the maximum execution time (upload time) setting of your web server. The default maximum execution time on web servers is 30 seconds. Please increase it to 120 seconds. Possible ways of achieving this are:

• By Wp-config.php changes – set_time_limit(120);
• In htaccess – php_value max_execution_time 120;
• In php.ini file – max_execution_time = 120

Ask your hosting provider to take care of this for you.

Child and Parent theme

A WordPress child theme takes the functionality of another theme, named parent theme. It gives you the possibility to customize an existing theme. Instead of modifying the theme files directly, you can activate the child theme and work within it. All customizations are stored in the child theme and anything in the child takes priority over the parent. So if the same file exist in both child and parent, the file from the child will control that aspect of the theme.

Working with child themes, your customizations are safeguarded from future upgrades because you only upgrade the parent theme, which you never edit, while the customizations are protected in your child theme which you don’t upgrade.

Why use a Child theme?

Safe Updates. You can easily modify your website using child themes without ever changing the parent theme. When a new version of the parent theme appears, you can safely update it as all your modifications are saved in the child theme.

Easy to Extend. A child theme has a great flexibility. It does not require writing a lot of code. You can modify only those template files and functions that you need.

Notice! When you install one of our themes you must upload both parent and child theme folders to /wp-content/themes/ but you should only activate the Child theme via Appearance > Themes.

Modifying files from the Parent theme folder

While you should never edit files in your Parent theme, if you really must, the safest way to do it is to download a copy of the file you want to modify on your computer, make the changes, and then upload it into your child theme folder.

This way of modifying the files can be used for any files from the parent theme — note that you must re-create the same folder structure in your child theme that exist in the parent theme in order for the modifications to take effect.