Hazel Documentation

Hazel Video Academy

Videos to learn how install the theme, import demos and work with theme features.

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

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

SetEnv MAGICK_THREAD_LIMIT 1

Update Theme & Plugins

To update theme and plugins you need to download and install this plugin first Easy Theme and Plugin Upgrades

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

1. Go to Appearance -> Themes
2. Click Add New -> Upload Theme
3. Upload the zip called hazel.zip
4. 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

Update to Hazel 4.0

Hazel 4.0 is a major update and it's comes with a lot of new features, new admin panels with more options, new templates options, new demos etc and some of this new functionalities will break parts of your website, but no worries :) it has a quick fix. So, after update to version 4.0 you will need to save the new options in the database, and this is what you need to do:

• Go to menu Appearance -> Hazel Options -> Save Changes (Green Button at the top right corner)
• Go to menu Appearance -> Hazel Style Options -> Save Changes
• Now go to Pages -> Click to edit the page -> Hit the Update Button. Repeat the process on each page you have.
• Same for posts, go to Posts -> open and Update each post you have

Install the theme

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

2. Import Demos

2.1 Manual Demo Install

2.1 One CLick Demo Install

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

• Choose your Demo from the folder Demo Contents -> 16 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

2.1 Server Requirements

To import the demo via One Click your server need to have the following settings/extensions activated

See How to increase server limits

Server Limits

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

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

2.2 Import Sliders Revolution Pack (320+ Sliders!)

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 ;)

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...

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.

6. Hazel Included Plugins

Hazel theme comes with 4 premium plugins included in your purchase. Please note that the plugins licenses are not included we purchased extended licenses of the plugins so we can include them with the theme, but we cannot share the license.

This are the plugins included and the respective documentation:

• Ultimate Addons | Documentation here
• Cube Portfolio | Documentation here
• Revolution Slider | Documentation here
• WP Bakery Page Builder | Documentation here
• Contact Form 7(with Captcha) | Documentation here
• WPML (compatible) *

7. 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
  
  
  
  

8. 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.

9. 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.

10. 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.

• Go to Appearance > Menus and create new menus.
• Create a new Sidebar.
• Create a new page, and set the sidebar you've created inside of it.
• Use the Custom Menu widget inside of the sidebar you've created, and call the Shortcodes Menu.

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.

• Go to Appearance > Widgets.
• Create a new Sidebar.
• Click on the Custom Menu Widget and add a menu widget to that sidebar.
• Now, select the menu that you created previously, and click the Save button.
• Now, just create a new page, and set the sidebar you've created inside of it, or set it inside any page that you want.

11. Setup Instagram Feed

• To show your instagram feed, first install this plugin https://wordpress.org/plugins/instagram-feed/
• Now you can add it on your pages with the plugin shortcode or you can use it on menu Appearance -> Widgets -> Bottom Footer (Instagram Feed)

12. 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.

13. 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

14. 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!

15. 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.

16. 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.

17. 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.

18. Translation Ready

18.1 - Via Plugin (Loco Translate)

You can translate the theme strings to your language directly on the WordPress dashboard by use a plugin called "Loco Translate". Check the following video

18.2 - Via Poedit Software

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');"

19. 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 Cloudways or A2 Hosting (Shared Turbo)

2. Use a CDN

• First we will use a CDN (Content Delivery Network) you can learn more about what's a cdn here http://www.wpbeginner.com/beginners-guide/why-you-need-a-cdn-for-your-wordpress-blog-infographic/
• I use cloudflare. Go here https://www.cloudflare.com/ and create your account.
• Now you need to add your website and change the dns of your domain to pointing to cloudflare.

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 >
							

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

• WP Meteor Page Speed Optimization Topping https://wordpress.org/plugins/wp-meteor/
  This is an amazing plugin that can help you archive good results on page speed and gtmetrix
• EWWW Image Optimizer https://wordpress.org/plugins/ewww-image-optimizer/
• LiteSpeed Cache In case you don't need cloudflare i recommend to use a cache plugin like https://wordpress.org/plugins/litespeed-cache/

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

20. RTL Websites

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

• 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.