Hazel Quick Help



Ideal memory related settings to import large sized XML data into your WordPress site.

Install this plugin PHP Settings and add the following settings

max_execution_time = 1200
memory_limit = 264M
post_max_size = 128M
upload_max_filesize = 128M

You can also increase the php memory on the wp-config.php settings

define( 'WP_MEMORY_LIMIT', '256M' );
define( 'WP_MAX_MEMORY_LIMIT', '512M' );

If the process stoped again, you just need to repeat the process again (tools -> import -> contents.xml) many times until you got the message, All Done, Enjoy.



Every time I want to edit a slider from slider revolution, I keep on getting an AJAX Error.

Add the following code on the .htaccess

SetEnv MAGICK_THREAD_LIMIT 1


The settings above, will fix errors like:

1) When installing this theme, I got the following error: "Are you sure you want to do this? Please try again." What should i do to fix this?! Also if this happen, you just need to force the importations of the content.xml file, import it how many times your server need, until you got the message, All done, Enjoy!

2) When installing this theme, I got the following error: "Warning: POST Content-Length of xxxxxxx bytes exceeds the limit of xxxxxx bytes in Unknown on line 0. Are you sure you want to do this? Please try again." What should i do to fix this?!




I'm using Child-Theme option and my website's not changing when i make some modification...

In case you change the folder's name, you need to edit the themes-child style.css file (located < in your themes folder >/hazel-child/style.css) and set the the exact same name (case-sensitive) in lines 5 and 8 in order to use the child theme.



Getting started

We assume you have your own WordPress installation, so let's get started! if not, and if you don't know how to do that, check this link



1. Installing the theme

There are 2 ways to install wordpress theme: upload unzipped theme via FTP or use the zipped file directly by on the wordpress theme installer .
You have to setup Wordpress first. (download it at : link)


1.1 Upload via FTP
  • Log into your site via FTP (if you don't have any FTP program you can use FileZilla ).
  • Browse to your folder located at yoursite.com/wp-content/themes
  • Upload the unzipped theme folder
  • Login to Wordpress, and on Left Menu go to Appearance -> Themes
  • Find & Activate the theme

1.2 Upload via Wordpress
  • Login to Wordpress
  • Go to Appearance -> Themes
  • You will see Install Theme tabs. Click Upload right below the tab
  • Click choose file, browse to theme folder and choose the file hazel.zip, click Install and wait for a second.
  • Activate the theme

Update Theme & Plugins

To update theme and plugins, please install Easy Theme and Plugin Upgrades plugin trough the top notice that appears on your wordpress dashboard





Now you just need to download the latest files from the market, and install the new versions. The plugin will create backup from the previous versions.

Update theme

Update hazel to the latest version
  • Go to Appearance -> Themes
  • Click Add New -> Upload Theme
  • Upload the zip called hazel.zip
  • Done! You have the latest version

Update Plugins

To update the plugins click on Begin update plugins in the top notice that appears on your wordpress dashboard





Update plugins via zip files
  • Go to Appearance -> Plugins
  • Click Add New -> Upload Plugin
  • No go the folder you downloaded from the market, and look inside the folder Plugins
  • Upload one plugin at the time
  • Install and activate all plugins
  • Done! You have the latest version


New Slider Revolution Pack (320+ Sliders!)

Since vs 2.7 Hazel come with this amazing ready-to-use Slider Revolution templates pack. Tons of sliders ready to use! Since the pack is too big to add it on the package, you need to download it from here Download Sliders Pack



After download the pack, you just need to follow this steps:
  • First unzip the file you downloaded
  • Now choose the sliders you want to import
  • Go to Slider Revolution -> Manual Import
  • Done! Enjoy ;)





New Instagram Feed (with Plugin)

Since vs 2.8.2 the Built-in instagram has been deprecated. Now the theme use a plugin to do the job. Please follow the next steps to learn how to setup it.


After download the new theme update, you just need to follow this steps:
  • First install the plugin Meks Easy Instagram Widget, trough the notice


  • Now you need to connect and authorize your Instagram account


  • Now go to Appearance -> Widgets
  • You will see a new sidebar called Bottom Footer (Instagram Feed)
  • Now just drag the Meks Easy Instagram Widget to the new sidebar
  • Fill the options of the widget. Don't forget to add the username



2. Import Demos





Follow the next steps. It's important follow this order!

  • Choose your Demo from the folder Demo Contents -> 11 Hazel Demos
  • First go Hazel Options -> Import/Export Options and Import options.xml file
  • Now go Hazel Style Options -> Import/Export Options and Import style_options.xml file
  • Time to Setup contents.xml file. In the Wordpress menu go to Tools -> Import
  • Choose Wordpress, if the plugin haven't not been installed , the popup window will show up and just click Install Now.
  • Click Activate Plugin & Run Importer
  • Now upload the contents.xml file

  • I got the following error: "Are you sure you want to do this? Please try again." You just need to force the importation of the content.xml file, import it how many times your server needed, until you got the message, "All done, Enjoy!" Some servers need 10 times!



  • Time to import all portfolios. For that go to Cube Portfolio -> Import/export
  • Now is time to import all sliders. For that go to Revolution Slider -> Import Slider
  • All done! Enjoy


Here the final guide File vs Option
  • options.xml -> Hazel Options -> Import
  • style_options.xml -> Hazel Style Options -> Import
  • contents.xml -> Tools -> Import -> WordPress
  • widgets.wie -> Tools -> Widgets Import Export
  • slider(s).zip -> Slider Revolution -> Import
  • cubeportfolio.json -> Cubeportfolio -> Import
  • linearicons -> Ultimate -> Icons Manager -> Upload New Icons -> and choose linearicons.zip from the media

If some error pop-up when you try to install the icons, you may need to ask to your hosting provider to install ZipArchive extension on the server.



2.1 Import Elementstop

Elements are no longer on the demo by default, since we have the Page Builder Templates with all sections examples, but if you want to import the elements pages seeing on the live demo, Follow the next steps:


  • Go to Tools -> Import
  • Click on WordPress -> Install, or in case you already have the plugin installed, WordPress -> Run Importer
  • Now download all package from your templatemonster account
  • Go to folder Demo Contents -> Parts -> Only Elements and import the file pagebuilder-elements.xml
  • Now you can see all elements pages on wordpress menu -> pages
  • All done! Enjoy


3. Hazel Options

Hazel comes with a very powerful options panel. After the theme is installed you can access the options panel by logging into the Wordpress dashboard and clicking Hazel Options. Go to menu Appearance -> Hazel Options and discover it!

Hazel Options panel is meant for the empowering of your theme with some visual enhancements described below.


Some cool stuff over our powerfull Options Panel:
  • Adding logos;
  • Header types;
  • Widgets;
  • Seo Options;
  • Language Settings;
  • Social Icons;
  • Custom css;
  • Etc...



IMPORTANT: Style options, like color changes, styles, backgrounds, etc, are set over the next section Hazel Style Options.

4. Hazel Style Options

Hazel allows you to create different styles in this new Style Options Panel. You will be able to make your own styles with lots of features and options for customizing your website.




5. One / Multipage System

Hazel allow you have one or multi page websites. The system is easy, we use normal wordpress pages, that works like pages (multipage) or sections (one page). On each page you create, you need to choose the template for your page. One Page Template or Multi Page Template






After create your pages/sections, add them in the wordpress menus. In case of one page site, your pages will be sections, and the order for that you will present them will follow the order in the wp menus. For example HOME - ABOUT - SERVICES


Get More info here on One Page Templates or the Multipage Template.


6. Hazel Included Plugins

In this theme you can find the most featured plugins:



1. So you can use these plugins, you'll need to upload the hazel.zip into your server through an FTP program such as Filezilla.

2. On your wordpress admin panel, you need to go to Plugins Section and activate them.

3. When active, they'll appear on your Custom Post Types menu.

4. Now you'll be able to use those nice plugins on your website. Just follow the documentation so you can use it well.



* WPML plugin isn't provided with this theme! For you to have it running on your installation, you should buy the license here: http://wpml.org

7. Setting Fonts





  • 1. Go to Ultimate
  • 2. Click Google Fonts
  • 3. Add the font you want to the collection
  • 4. DONE! Now you can use them inside the Hazel Style Editor Panel.

8. Using Page templates


    Hazel come with 6 templates
  • One Page Template
  • Blog Masonry Template
  • Blog Template
  • Home Page Template
  • Multipage Template
  • Blank Template

  • To use the page templates, simply create a new page in Pages -> Add new and choose the template you want to use for that page in Page Attributes box.


    You can also select the Page Layout for your page. You can select the Options Fullwidth, Left Sidebar and Right Sidebar.






Blog Template & Blog Masonry Template

The options you'll find below works for the two kind of blog templates.


1. Select Blog Template or Blog Masonry Template.

2. Scroll a bit down to the end of the page, and go to Blog Style and set your options relative to the Blog Template or Blog Masonry Template.

3. Click Publish / Update.







One Page Template

This is how you can implement your One page website:


1. Create a new page.

2. Select One Page Template.

3. IMPORTANT NOTE: The page you've created will work as a section for your One Page website.

4. Now go to Appearance > Menus and select the pages you've created previously as One Page Template and order the menu according to the way you want to display your pages (sections of the One Page Template) and save the Menu.


This is how you will get your One Page website. Easy!!!




MultiPage Template

This is the same as the One Page Template, but with this template you'll have a default style website with the pages each one for each link. Also this template will have custom page options, to style the page title, add sliders to it or if you desired so, hide it from the page.

9. Creating Hazel Menus


11.1 Wordpress Menus

This theme uses WordPress Custom Menus.

Go to Appearance > Menus and you will see a panel where you can create new menus.

Create one, add your created pages to it (from the left side panels) and save it.

After this, in the left side you have a Theme Locations drop down box where you can select the Menu.

Choose your newly created menu, click Save and your menu is ready.






You also can create a menu, and set it as a Widget with the "Custom Menus".







11.2 Mega Menu

Setting a Mega Menu, is easy as this:


  • 1. Go to Appearance > Menus and you will see a panel where you can create new menus.
  • 2. Create one, add your created pages to it (from the left side panels) and save it.
  • 3. Select the Mega Menu checkbox so it assumes it as a Mega Menu item.




  • 4. If you selected the parent menu as Mega Menu, you'll be set the following b and c options.


    • b - Hide Title?
    • As it describes above, this should hide the title for dislaying over the Mega Menu area.


    • c - Just Label (Without Link)?
    • This will only show the page created as Sub-Menu Page item from the Mega Menu without having it with a link to a page.



  • 5. Now you'll only need to set the pages under the sub menu items so that they become menu items from the sub-menu items from the Mega Menu.


    • 5.1. Mega Menu menu;
    • 5.2. Mega Menu Item (Title or Label);
    • 5.3. Mega Menu Sub-Item (The pages linked to each Title or Label);


  • 6. The style for these item can be set over Appearance > Hazel Style Options > Menu and select the Just Label (Without Link) section.



11.3 Sidebar Menus

This theme uses WordPress 3.5.2 Custom Menus.

Go to Appearance > Menus and you will see a panel where you can create new menus.

Create one, add your created pages to it (from the left side panels) and save it.

Choose your newly created menu, click Save and your menu is ready.








10. Setting Sliders



    Revolution Slider
  • Import rev slider contents if you want it like our demo. You can find the txt files on the download folder > Demo Contents > Revolution Slider
  • Create a page with one of the templates available
  • Add the slider via Page Builder Module Revolution Slider
  • Hit Publish.

  • NOTE: You can use the Revolution Slider documentation to learn how to manage this awesome plugin. Find it here.


    NOTE: If an error occur when using the slider, you can try fix the issue by activating the "Jquery No Conflict Mode" following steps:


  • 1. Create New Revolution Slider or Edit existing created Slider.
  • 2. Select existing slider.
  • 3. Scroll down to the bottom of the page and go to Troubleshooting, and set "Jquery No Conflict Mode" off.




11. Creating Sidebars


Hazel allow you add sidebars in two different ways.



    Creating the Sidebar in the Admin Panel
  • Go to Appearance > Hazel Options.
  • Now on Footer / Sidebars > Sidebars.
  • Enter a Name for the sidebar.
  • Hit Add Sidebar.
  • Hit SAVE CHANGES.



    Add Widgets to the Sidebar
  • Go to Appearance > Widgets.
  • 1. and 2. Drag-and-drop widgets you'd like to use into "Your Sidebar" widget area, here's an example:



    12.1 Use Page Layouts
  • Go to Pages > Add New.
  • Go to Page Attributes > Page Layout.
  • Choose the page layout that you want.
  • Choose the sidebar

12. Setting Portfolio Pages


Create and edit portfolios
  • 1. Go to Cube Portfolio.
  • 2. Create a New Portfolio
  • 3. Select which Portfolio you want to use.

    You will have the following types:


    • Juicy Projects
    • LightBox Gallery
    • Meet the Team
    • Full Box
    • Masonry
    • Blog Posts




Create and edit Projects
  • 1. Go to Projects.
  • 2. Create a New Project

Now on the cube portfolio items, and depending of the type of project, Single Page, Single Page Inline or Simple link. Add the full project link in the field "Link"


Add the Portfolio in your Pages
  • 1. Open WP Bakery Page Builder plugin from inside any page you are creating, and select Cube Portfolio shortcode.
  • 2.Choose your portfolio and Done!! Your Cube portfolio is set up on your page!


For further information check the documentation here!



13. Setting Blog Page

How we've explained on the 10. Using Page templates under the 10.2 step, you can set your Blog Page easily and you can have two ways of doing so.






Blog Template


  • These posts should be created by the default Posts from wordpress.
  • Create the categories and just add them to the created post.
  • Now over the page you've created, just scroll a bit down to the end of the page, and go to Blog Style and set your options relative to the Blog Template.
  • Click Update button.















Blog Masonry Template


  • These posts should be created by the default Posts from wordpress.
  • Create the categories and just add them to the created post.
  • Now over the page you've created, just scroll a bit down to the end of the page, and go to Blog Style and set your options relative to the Blog Masonry Template.
  • Click Update button.

14. Setting Contact Forms


For setting up new contact pages, we use Contact form 7 plugin. This is an awesome way of setting up contact forms in a simple way and for a few clicks.


Create a Contact Form:
  • 1. Go to forms and create a New Form.
  • 2. Set the fields with your information.
  • 3. Fill up the message fields.




NOTE: Now that you've created the forms, you'll need to go to the page where you want to display it, and just go to WP Bakery Page Builder and select the Contact Form 7 item, and select which one you want to use.

15. Setting Testimonials

This are the steps you need to take for adding testimonials:


    How to create them:

    1. Go to Testimonials > Add New.

    2. Add your testimonial menu name.

    3. Add the testimonial message.

    4. Go to Testimonial Author and set the authors name.

    5. Go to Testimonial Author Company and set the authors company name.

    6. After you have all of this set up, just add your testimonial featured image, and then just save changes.






    How to set it up:
  • Go to the page where you want to use it and under WP Bakery Page Builder, just select the Testimonials.
  • You will be prompted which style you intend to use. You'll have the Slider and the fixed option for it.
  • This will generate your shortcode, that can be used wherever you want to.

16. Translation Ready

So you can replace the theme language to your defined language, follow the next steps:


  • Edit the hazel.pot file (/wp-content/themes/hazel/languages folder) using the Poedit software.
  • Save the file with the name of your language (for example: fr_FR for French) on the /wp-content/themes/hazel/languages folder.
  • Edit the wp-config.php file, on the root of your wordpress theme, and change the line 72 to the name of the file you created. For example: "define('WPLANG', 'fr_FR');"

17. Better Results on Google Page Speed

Due to users demand, i decide to write some lines about this and tell you guys what you need to do o get better results with Hazel theme. So lets go, follow the next steps:



1. Good Server

First and most important of all you will need a good server!! I recommend this one A2 Hosting (Shared Turbo)




2. Use a CDN



3. Change your htaccess file

Add the following lines in the top of the file. Htaccess file is on the root of your wordpress installation.

## EXPIRES CACHING ##
< IfModule mod_expires.c >
ExpiresActive On
ExpiresByType image/jpg "access 1 year"
ExpiresByType image/jpeg "access 1 year"
ExpiresByType image/gif "access 1 year"
ExpiresByType image/png "access 1 year"
ExpiresByType text/css "access 1 month"
ExpiresByType text/html "access 1 month"
ExpiresByType application/pdf "access 1 month"
ExpiresByType text/x-javascript "access 1 month"
ExpiresByType application/x-shockwave-flash "access 1 month"
ExpiresByType image/x-icon "access 1 year"
ExpiresDefault "access 1 month"
< / IfModule >
## EXPIRES CACHING ##

## ENABLE GZIP COMPRESSION ##
< ifModule mod_gzip.c >
mod_gzip_on Yes
mod_gzip_dechunk Yes
mod_gzip_item_include file .(html?|txt|css|js|php|pl)$
mod_gzip_item_include handler ^cgi-script$
mod_gzip_item_include mime ^text/.*
mod_gzip_item_include mime ^application/x-javascript.*
mod_gzip_item_exclude mime ^image/.*
mod_gzip_item_exclude rspheader ^Content-Encoding:.*gzip.*
< / ifModule >

# 1 Month for most static assets
< filesMatch ".(css|jpg|jpeg|png|gif|js|ico)$" >
Header set Cache-Control "max-age=2592000, public"
< / filesMatch >
							

NOTE: Remove the spaces on IfModule and filesMatch tags


Learn how to work with htaccess file https://varvy.com/pagespeed/htaccess.html

More about gzip compression https://varvy.com/pagespeed/enable-compression.html




4. Plugins you need to install



2. Complete Analytics Optimization Suite (CAOS)

This plugin is for that you can use google analytics code without compromise the page speed score.






3. EWWW Image Optimizer

The EWWW Image Optimizer is a WordPress plugin that will automatically optimize your images as you upload them to your site. It can optimize the images that you have already uploaded, convert your images automatically to the file format that will produce the smallest image size (make sure you read the WARNINGS), and optionally apply lossy compression to achieve huge savings for PNG and JPG images.

After install it go to Media -> Bulk Optimize and optimize all images






4. Speed Booster Pack

Speed Booster Pack allows you to improve your page loading speed and get a higher score on the major speed testing services such as GTmetrix, Google PageSpeed, YSlow, Pingdom, Webpagetest or other speed testing tools.

After install it go to Settings -> Speed Booster Pack and check the options like i have on the following image


18. Page Builder Templates

With Hazel 2.0 come a new awesome feature Page Builder Templates. With this tool you can create pages more faster and easy, check how this work.



  • 1. Go to Pages -> Add New Page
  • 2. On Page Builder buttons, click on Backend Editor


  • 3. Now click on the button Templates


  • 4. Now you have all sections there, just click on the name of each one, to add them on the editor


  • 5. Hit Update or Save Page


19. RTL Websites

Hazel support RTL websites, here some things you need to know about RTL on Hazel.



Please note that important rtl updates have been made on version 2.9.9. You need to have Hazel vs2.9.9 or above.



  • 1. On the WordPress menu Go to Settings -> General -> Site Language change the language to your rtl language.


  • 2. After this, the majority of your site are already RTL with some exceptions, because on some page builder elements you need to select the options RTL, or align element to the right, like the following screenshots.