# Installation

Follow the steps below to get started with your Site Template:

1. Unzip the downloaded zip file `themeforest-xxxxx.zip` folder
2. Open folder named `main-file`
3. Here you will find folders of all templates and vendor folder
4. You will need to Upload these files to your Web Server using FTP in order to use it on your Website.
5. Make sure you upload the required files/folders listed below:
   - `vendors` - All plugins and elements used in templates are saved here
   - `req-template-folder` - All inner pages, images etc folders are here
   Followings are files and sub-folders saved in this folder
   - `css` - Extra Stylesheets Folder plus Main Stylesheet File
   - `img` - Images Folder
   - `js` - Javacripts Folder
   - `.html` extension files - Inner pages Files
   The other files can be used according to your preferences.
6. Below is the demonstration example of installation of theme:

For instance: To install template named `Personal-portffolio` you must have following folders:

- `vendors` - All plugins and elements used in templates are saved here
- `personal-portfolio` - All inner pages, images etc folders are here
Followings are files and sub-folders saved in personal-portfolio folder
- `css` - Extra Stylesheets Folder plus Main Stylesheet File
- `img` - Images Folder
- `js` - Javacripts Folder
- `.html` extension files - Inner pages Files

You will need to Upload these files to your Web Server using FTP in order to use it on your Website and give the paths of files in `.html` extension files.
7. You're now good to go..! Start adding your Content and show off your Brand New Beautiful Website in style.

# HTML Structure

Megaone follows a simple coding structure. here is the sample:

    <!DOCTYPE html>
    <html dir="ltr" lang="en">

      <!-- All your metas will be here ========= -->
    <meta name="viewport" content="width=device-width, initial-scale=1">
    <head>

      <!-- Your Stylesheets, Title
    	============================================= -->
    	...

    </head>
    <body>

      <!-- The Loader Before Site Load
    	============================================= -->
    <div class="loader">
      ....
    </div>

      <!-- Header
    		============================================= -->
    <header>
      <nav class="navbar">
        ...
      </nav>
    </header>

      <!-- Site Content
    		============================================= -->
    <section>
      <div class="container">
        ...
      </div>
    </section>

      <!-- Footer
    		============================================= -->
    <footer>
      <div class="container">
      ...
      <!-- Copyrights
      ============================================= -->
      </div>
    </footer>

    <!-- Your All Scripts will be here
    	============================================= -->
    	...

    </body>
    </html>

### Favicons & Apple Touch Icons

You can add a Favicon to your Website using the following code just bottom to the Stylesheet files links:

    <link rel="icon" href="img/favicon.ico" sizes="16x16">

You can add Apple Touch Icons to your Website using the following code:

    <link rel="apple-touch-icon" href="touch-icon-iphone.png">
    <link rel="apple-touch-icon" sizes="76x76" href="touch-icon-ipad.png">
    <link rel="apple-touch-icon" sizes="120x120" href="touch-icon-iphone-retina.png">
    <link rel="apple-touch-icon" sizes="152x152" href="touch-icon-ipad-retina.png">

# Third Party Plugins

Please note that all common plugins are included in vendor folder. You can use any plugins from that folder by including them into your html files.

# Page Loading Transitions

You can show Interactive loaders to your Visitors while the Pages of your Website loads in the background & then Reveal show Interactive loaders to your Visitors while your Pages with CSS3 Transitions. Page Loading Transitions are enabled by default. To disable the Transition, you can simply remove `.loader` Class just after the `<body>` Tag.

# Logo Settings

The Logo Container can be found in the Header Container - `nav` tag

         <a class="logo" href="javascript:void(0)"><img src="img/logo.png" alt="logo" title="Logo"></a>

# Changing Fonts

Change your Fonts from Google Fonts Library directly if you plan to use a Google Font. You can find the Linking to the Font Files in the `style.css`file.

    @import url('https://fonts.googleapis.com/css?family=Raleway:200,300,400,500,600,700');

    @import url('https://fonts.googleapis.com/css?family=Open+Sans:300,400,500,700');

In order to change the Fonts, you will need to Edit the Above Links with your Custom Font, if you plan to use a Google Font or Remove it completely if you plan to use a Self Hosted font. Here is an Example for using Self Hosted Fonts.

By default, Megaone uses two Fonts namely: `Raleway` and `Open Sans` from the Google Fonts Library

# Website Optimization Tips

A Fast & Optimized Website has several factors which needs to be implemented in order to achieve the desired results. There are several Optimization Techniques available which will definitely affect your Website's Performance in a Positive Way & we want to share a few of them with you:

- #### gZip Compression & Browser Caching

  This is probably one of the Most Important Techniques you should definitely implement in order to bump up your Website's Loading Speed. gZip Compression is used to compress the Files that are delivered when loading a Website. It covers HTML, CSS, Javascript & Font Files along with other miscellaneous text files. Where as Browser Caching also covers Images & Videos apart from including the above files. This is used to saves the Static Data in your Browser itself so that when you open the Next Pages on the Same Website, the content does not gets Downloaded again, loading the Website fast.

  gZip Compression & Browser Caching can be enabled using the `.htaccess` File on an Apache Web Server. You can use the Codes from here: https://github.com/h5bp/html5-boilerplate/blob/master/dist/.htaccess to enable these modules on your server.

- #### Image Compression & Optimization

  We tend to use Lots of Images on our Websites but we often do not make efforts to Compress & Optimize them. Remember, the Larger the Image, the more time it takes to download and therefore this slows your website loading times affecting User Experience. Your customer will leave your website if it does not load within 3-5 Seconds which adversely affects your Sales. Therefore, it is important to Resize, Optimize & Compress your Images before using it on your Website. Here are some Tips which might come handy in optimizing images:

  - Resize your Images: Resize your Images before using it on your Website. Do not just Download an Image & place it as it is in your Website's `<img>` Tag without resizing it. The size/resolution of the Image matters since it is not recommended to use an Image size of `1200px` x `800px` in a Content Size of `300px` x `200px` as this is unnecessary. Resize it to `300px` x `200px`
  - Image Formats: There are three common file types that are used for web images which are JPEG, GIF, & PNG. For images with a Flat Background use JPEG images, for images with a Transparent background use PNG images and for images with Animations use GIF images.
  - Compressing Images: Images Compression is important as it considerably reduces the size without losing the quality. There are several FREE Image Optimization Tools available to Download.
    For MAC use ImageOptim
    For Windows use Riot for compressing JPEG Images & PNG Gauntlet for PNG Images.

- #### CSS & jQuery Minifications

  It is also recommended that you Combine & Minify all your CSS Files to a single CSS File & all Javascript Files to a single JS File since Minification reduces the size of the File and Combining the files helps in reducing the number of HTTP requests made to the server. This is also an Important Factor in increasing the speed of your website. There are several tools available online to Minify your CSS & JS Files. Our recommendations are:
  For CSS use CSS Minifier and For Javascript use Javascript Minifier.

- #### Content Delivery Network

  You can use a CDN to further speed up your website. You can use the CDN to deliver static files of your website like CSS, JS, Images & Font Files. There are several CDN Hosting Providers available on the Internet but we would recommend MaxCDN or CloudFlare. Note: CDN setup requires Extra monthly Fees to setup, so it is completely optional & according to your needs.

- #### Fast Web Hosting Servers

  A lot depends on your Web Hosting Servers, so it is recommended that you choose a Hosting Company/Server that provides a Reliable & a Fast Hosting Service. You can check out some recommended Hosting Services here: http://themeforest.net/get_hosting.

# Header

You can choose the headers while creating your Pages. Default Header with a white Background while turns Stickey after a little scrolling &,you can make header without stickey effect for this just remove the `.header-appear` from the `header` tag. You can also choose the transparent header by using `navbar transparent-bg` Class on `nav` tag, Simply follow the structure below to create the header:

    <header>
    	...
    </header>

## Menu Styles

Default Menu Style which aligns to the right, You can use the Menu just as

    <nav class="navbar navbar-top-default navbar-expand-lg">
    	...
    </nav>

         <!-- for Transparent style use code below -->
    <nav class="navbar navbar-top-default navbar-expand-lg transparent-bg">
    	...
    </nav>

# Page Titles

Default Page Title style with Text aligned Left.

# Columns & Grid

### Bootstrap Grid

.col-md-1
.col-md-1
.col-md-1
.col-md-1
.col-md-1
.col-md-1
.col-md-1
.col-md-1
.col-md-1
.col-md-1
.col-md-1
.col-md-1
.col-md-2
.col-md-2
.col-md-2
.col-md-2
.col-md-2
.col-md-2
.col-md-3
.col-md-3
.col-md-3
.col-md-3
.col-md-4
.col-md-4
.col-md-4
.col-md-5
.col-md-5
.col-md-2
.col-md-6
.col-md-6
.col-md-1
.col-md-11
.col-md-2
.col-md-10
.col-md-3
.col-md-9
.col-md-4
.col-md-8
.col-md-5
.col-md-7

# Side Panel

You can add a revealable Side Panel on your Website with Additional Information about your Website. here we are giving you a demo with all possible information, Simply use the Code below:

        <aside>
    <div class="col-lg-4 col-md-5">
        <div class="text-left">
            <!-- Search Box -->
            <div class="widget heading-space-half wow fadeIn" data-wow-delay="300ms">
                <form class="search-box">
                    <p class="color-black mb-4">Explore what the world is searching. Enter a search term or a topic.</p>

                    <div class="input-group">
                        <input type="search" class="form-control" placeholder="Enter keyword..." required>
                        <button type="submit" class="search-addon"><i class="fa fa-search line-height-35px"></i> </button>
                    </div>
                </form>
            </div>
            <!-- Recent Post -->
            <div class="widget heading-space-half wow fadeIn" data-wow-delay="350ms">
                <h5 class="color-black font-weight-600 text-capitalize mb-4">Blog Posts</h5>
                <div class="single-post mb-3">
                    <a href="javascript:void(0)" class="post"><img src="img/post1.jpg" alt="image"></a>
                    <div class="text">
                        <a href="javascript:void(0)" class="color-grey">Project Lead</a>
                        <span>October 19,2019</span>
                    </div>
                </div>
                <div class="single-post mb-3">
                    <a href="javascript:void(0)" class="post"><img src="img/post2.jpg" alt="image"></a>
                    <div class="text">
                        <a href="javascript:void(0)" class="color-grey">Business Solutions Analyst</a>
                        <span>November 09,2019</span>
                    </div>
                </div>
            </div>
            <!-- Categories -->
            <div class="widget heading-space-half wow fadeIn" data-wow-delay="400ms">
                <h5 class="color-black font-weight-600 text-capitalize">Categories</h5>
                <div>
                    <div class="categories-name">
                        <a href="javascript:void(0)">
                            <p class="font-16 color-grey text-capitalize"><i class="fa fa-angle-right font-14 color-blue mr-1"></i> Investment Planning  <span>25</span> </p>
                        </a>
                    </div>
                    <div class="categories-name">
                        <a href="javascript:void(0)">
                            <p class="font-16 color-grey text-capitalize"><i class="fa fa-angle-right font-14 color-blue mr-1"></i> Market Research <span>21</span> </p>
                        </a>
                    </div>
                    <div class="categories-name">
                        <a href="javascript:void(0)">
                            <p class="font-16 color-grey text-capitalize"><i class="fa fa-angle-right font-14 color-blue mr-1"></i> Insurance Business<span>25</span> </p>
                        </a>
                    </div>
                    <div class="categories-name">
                        <a href="javascript:void(0)">
                            <p class="font-16 color-grey text-capitalize"><i class="fa fa-angle-right font-14 color-blue mr-1"></i> Startup Funding <span>37</span> </p>
                        </a>
                    </div>
                    <div class="categories-name mb-2">
                        <a href="javascript:void(0)">
                            <p class="font-16 color-grey text-capitalize"><i class="fa fa-angle-right font-14 color-blue mr-1"></i> Finance Planning <span>30</span> </p>
                        </a>
                    </div>
                </div>
            </div>
            <!-- Tags -->
            <div class="widget heading-space-half wow fadeIn" data-wow-delay="450ms">
                <h5 class="color-black font-weight-600 mb-4 text-capitalize">popular tags</h5>
                <div>
                    <ul class="tags">
                        <li>
                            <p class="font-13 text-capitalize">Business</p>
                        </li>
                        <li>
                            <p class="font-13 text-capitalize">Corporate</p>
                        </li>
                        <li>
                            <p class="font-13">SEO</p>
                        </li>
                        <li>
                            <p class="font-13 text-capitalize">Creative</p>
                        </li>
                        <li>
                            <p class="font-13 text-capitalize">Finance</p>
                        </li>
                        <li>
                            <p class="font-13 text-capitalize">Marketing</p>
                        </li>
                        <li>
                            <p class="font-13 text-capitalize">Envato</p>
                        </li>
                        <li>
                            <p class="font-13 text-capitalize">Theme Development</p>
                        </li>
                    </ul>
                </div>
            </div>
            <!-- Newsletter -->
            <div class="widget-parallax heading-space-half mb-0 parallax-setting parallaxie newsletter1 position-relative wow fadeIn" data-wow-delay="500ms">
                <div class="bg-overlay bg-blue opacity-7"></div>
                <form class="search-box position-relative bg-change">
                    <h5 class="color-white font-weight-600 text-capitalize mb-3">Newsletter</h5>
                    <p class="color-white newsletter-para mb-4"> Vestibulum auctor nunc vitae diam eleifend, in maximus metus sollicitudin. Quisque vitae sodales lectus. </p>
                    <div class="input-group">
                        <input type="email" class="form-control" placeholder="Enter email..." required>
                        <button type="submit" class="search-addon"><i class="fa fa-envelope line-height-35px"></i> </button>
                    </div>
                </form>
            </div>
        </div>
    </div>
        </aside>

Note: Make sure that you add the Side Panel's Code just after the `#blog` Starts.

### Side Panel Position

A Side Panel can be revealed from either Left or Right. The Side Panel is revealed from the Right by default. If you would like to change the Reveal Position of the Side Panel to Left, then you can simply add the `.float-left` Class to the `<aside>` Tag.

    <aside class="float-left">

# Helper Classes

We have created some really useful helper classes for you. Here are a few of them:

- `.p-7rem` - padding of 7rem on the top and bottom of elements.
- `.pt-7rem` - padding of 7rem on top of sections.
- `.pb-7rem` - padding of 7rem on the bottom of elements.
- `.p-half` - padding of 3.75rem on the top and bottom of elements.
- `.pt-half` - padding of 3.75rem on top of elements.
- `.pb-half` - padding of 3.75rem on bottom of elements.
- `.p-0` - for 0 padding or remove the padding
- `.mt-7rem` - margin of 7rem on the top of sections
- `.mb-7rem` - margin of 7rem on the bottom of sections
- `.mt-10px` - margin of 10px for top.
- `.mb-10px` - margin of 10px for bottom.
- `.mt-20px` - margin of 20px for top.
- `.mb-20px` - margin of 20px for bottom.
- `.mt-25px` - margin of 25px for top.
- `.mb-25px` - margin of 25px for bottom.
- `.mt-30px` - margin of 30px for top.
- `.mb-30px` - margin of 30px for bottom.
- `.mt-35px` - margin of 35px for top.
- `.mb-35px` - margin of 35px for bottom.
- `.mt-40px` - margin of 40px for top.
- `.mb-40px` - margin of 40px for bottom.
- `.mb-50px` - margin of 50px for top.
- `.mb-50px` - margin of 50px for bottom.
- `.m-0` - for 0 margin or remove the margin
- `.bg-blue` - blue background in website.
- `.bg-green` - green background in website.
- `.bg-black` - black background in website.
- `.bg-light-gray` - light grey background in website.
- `.color-blue` -blue color fot text used in website.
- `.color-green` -green color fot text used in website.
- `.color-white` -white color fot text used in website.
- `.color-black` -black color fot text used in website.
- `.color-grey` -grey color fot text used in website.
- `.color-light-grey` - light grey color fot text used in website.
- `.btn-setting` - default button used in website.
- `.overlay` - to create overlay effects.

# Slider Types & their Options

Bistro includes 2 Unique Sliders for you to be used on any Page with 100s of Options. The List of all the Sliders included are mentioned as follows:

- Revolution Slider

  You can find the Revolution Slider related Documentation here.
  Read Revolution Slider Docs

- Swiper Slider

  You can find the Swiper Slider related Documentation here.
  Swiper Docs & Demos

# Introduction

Megaone boasts of a huge number of handy Shortcodes which are quite powerful, flexible, functional & easy to use. Setting up shortcodes is very easy & Self Explanatory. Here is the List of Shortcodes included with Bistro:

- `Animations`
- `Buttons`
- `Carousels`
- `Clients`
- `Columns`
- `Dividers`
- `Icon Boxes`
- `Galleries`
- `Heading Styles`
- `Icon Lists`
- `Lightboxs`
- `Lists & Panels`
- `Media Embeds`
- `Navigations`
- `Paginations`
- `Pricing Boxes`
- `Responsive`
- `Sections`
- `Social Icons`
- `Alert Boxes`
- `Styled Icons`
- `Tables`
- `Tabs`
- `Testimonials`
- `Thumbnails`
- `Toggles`

Each of the above mentioned Shortcodes are easily extendable, flexible & easy to use. You can find the sample codes in their respective files. We are explaining a few of them for your Reference.

# Animations

Scroll to reveal Animations are latest in the Trends. You can do them too with Bistro. You can use animations on any element you want. Here is the Sample Code:

    <div class="wow fadeInDown" ></div>

You can also use delays for your Animations:

    <div data-wow-duration="500ms" data-wow-delay="300ms"></div>

Note: Delay Duration is in milliseconds.

Here is the list of the Animation Types you can use:

- `bounce`
- `flash`
- `pulse`
- `rubberBand`
- `shake`
- `swing`
- `tada`
- `wobble`
- `bounceIn`
- `bounceInDown`
- `bounceInLeft`
- `bounceInRight`
- `bounceInUp`
- `bounceOut`
- `bounceOutDown`
- `bounceOutLeft`
- `bounceOutRight`
- `bounceOutUp`
- `fadeIn`
- `fadeInDown`
- `fadeInDownBig`
- `fadeInLeft`
- `fadeInLeftBig`
- `fadeInRight`
- `fadeInRightBig`
- `fadeInUp`
- `fadeInUpBig`
- `fadeOut`
- `fadeOutDown`
- `fadeOutDownBig`
- `fadeOutLeft`
- `fadeOutLeftBig`
- `fadeOutRight`
- `fadeOutRightBig`
- `fadeOutUp`
- `fadeOutUpBig`
- `flip`
- `flipInX`
- `flipInY`
- `flipOutX`
- `flipOutY`
- `lightSpeedIn`
- `lightSpeedOut`
- `rotateIn`
- `rotateInDownLeft`
- `rotateInDownRight`
- `rotateInUpLeft`
- `rotateInUpRight`
- `rotateOut`
- `rotateOutDownLeft`
- `rotateOutDownRight`
- `rotateOutUpLeft`
- `rotateOutUpRight`
- `hinge`
- `rollIn`
- `rollOut`
- `zoomIn`
- `zoomInDown`
- `zoomInLeft`
- `zoomInRight`
- `zoomInUp`
- `zoomOut`
- `zoomOutDown`
- `zoomOutLeft`
- `zoomOutRight`
- `zoomOutUp`

# Icons

Font Awesome

## Widgets

Widgets are simple & easy to setup, completely flexible & can be used anywhere on a page. All possible widgets are placed in side panels:

# How to add UI Block elements?

Follow the instructions below to add blocks into your templates

Step 1 :

Please add the following css stylesheet link tag before your style.css file. (Please adjust the css file path according to your folder structure).

    <link href="vendor/css/elements.css" rel="stylesheet">

Step 2 :

Please copy block html code from starting block comment to the ending block comment of required block and paste it in your template at your desired location. For example:

    <!-- UI-Block-02 start -->
    <section class="half-section p-0 bg-change bg-yellow ui-block-02 blog">
    <h2 class="d-none">heading</h2>
       <div class="container-fluid">
           <div class="row align-items-center">
              <div class="col-lg-6 col-md-12 p-0">.....</div>
          </div>
       </div>
    </section>
    <!-- UI-Block-02 End -->

Step 3 :

If a block has html script then just copy all the script tags of that block section and paste it before the ending body tag at the bottom of your html file. For example:

    <script src="vendor/js/parallaxie.min.js"></script>
    <script>
    if ($(window).width() > 992) {
    $(".ui-block-02.quote.parallax").parallaxie({ speed: 0.55, offset: 0,}); }
    </script>

That's It, You are done.

# Simple Contact Form (Alternate Method)

Go to the `vendor folder` in contact-mailer.php file you need to replace your email with existing one at line no 14.

     $your_email = "user@website.com";

# Contact Form with PHP Mailer

In case the above simple mail settings doesn't work for you then please go to the `vendor folder` in contact-mailer.php file you need to uncomment this code from line 270 to line 276. and change your username with your email and your password with your provided password. and also you need to change your `SMTP` according to your hosting provider

        $mail->isSMTP();                                            // Send using SMTP
        $mail->Host       = 'smtp.yourwebsite.com';                    // Set the SMTP server to send through
        $mail->SMTPAuth   = true;                                   // Enable SMTP authentication
        $mail->Username   = 'user@yourwebsite.com';                     // SMTP username
        $mail->Password   = 'your password';                         // SMTP password
        $mail->SMTPSecure = 'TLS';         // Enable TLS encryption; `PHPMailer::ENCRYPTION_SMTPS` also accepted
        $mail->Port       = 587;                                    // TCP port to connect to

# Images

- The Stocks
- Unsplash
- Freepik
- RaumRot
- Picjumbo
- Stockphotos.io
- Imcreator FREE
- Flickr CC-Search
- Mazwai (Stock Footage)

# jQuery

- Revolution Slider
- Swiper
- JQuery-MatchHeight
- Bootstrap 4
- Cube Portfolio
- Google Map api

# CSS & Fonts

- Bootstrap 4
- Animation
- Themify Icons (Font Icons)
- Swiper
- Cube Portfolio
- Google Fonts
- Raleway
- Open Sans