Hiroto WordPress Theme - Documentation

Theme Installation

To install this theme you must have a working version of WordPress. Make sure that your installed WordPress version is 4.1 or higher.

If you need help by installation of WordPress, follow the instructions in WordPress Codex. Also here you can download the latest version of WordPress.

Downloading

At first, after purchasing this theme please download the package from ThemeForest (to do this you must be logged in ThemeForest). Move your mouse over your ThemeForest login name in right top corner and then click Download. On the Downloads page you will find all the items that you have purchased. This theme will also be here.

In the next step click the Download -> All files & documentation button and save package on your computer.

Please unpack the entire package after downloading.

The Main Files includes the following files and folders:

• Demo Content folder - contains demo data file
  • theme-data.xml - xml file with demo data
• Documentation folder - contains this document
  • assets folder - contains files for documentation
  • documentation.html - documentation file
• hiroto.zip - Hiroto theme (ZIP archive for installation)
• Changelog.txt - changelog text file
• Readme.txt - some information about folders and files in the package

1. Installing from the WordPress Dashboard

1.1 Go to Themes Page

Log in to your WordPress admin area;

Go to Appearance -> Themes;

Click on "Add New".

1.2 Upload Theme

Click on "Upload Theme".

1.3 Upload Theme zip File

Click on "Choose file" and select the theme zip file (hiroto.zip);

Then click on "Install Now" button.

The installation process starts...

1.4 Activate Theme

Click on "Activate" link.

1.5 Required Plugins

The theme is now activated. Upon first install, the theme will offer a list of required (Meta Box) and recommended (bwp- Shortcodes) plugins.

Click on "Begin installing plugins" link.

1.6 Plugins Installation

Choose the plugins you want to install and then choose "Install" from the dropdown menu. Click "Apply" to continue the installation.

1.7 Plugins Installation Complete

Plugins installation completed. Now you can return to the Dashboard.

1.8 Reading Settings

Go to Settings -> Reading -> Front page displays and select "Your latest posts";

Click on "Save Changes".

2. Installing by FTP

If you have any problems with installing the theme from the WordPress Dashboard (for example, you see this error: "The uploaded file exceeds the upload_max_filesize directive in php.ini"), then you need to install it via FTP.

For this you need to upload non-zipped theme folder called hiroto to /wp-content/themes/ folder in your WordPress installation folder on your server.

Next, login to your WordPress admin page and activate the theme (Appearance -> Themes).

After the successful activation see Step 1.5 of this documentation.

How to Update Hiroto

In this part of the guide describes how to update Hiroto. Just follow these seven steps:

Step 1. At first, you need to download the latest package from ThemeForest.

Step 2. Unpack the entire package after downloading.

Step 3. Next, please unpack the archive with the theme: hiroto.zip.

Step 4. After that you need to remove the hiroto folder from your server (/wp-content/themes/hiroto). For this you can use any FTP client, for example, FileZilla.

Step 5. Then you need to upload non-zipped hiroto folder to /wp-content/themes/ folder in your WordPress installation folder on your server.

Step 6. Next, login to your WordPress admin page and install required plugins (if it is necessary). You will see a notification about this.

Step 7. Clear your browser's cache, and update plugins cache (if you have caching plugins).

Remember, that all your data in the database are safe because after updating theme files does not change anything in the database. Please also always make a backup of your files before you overwrite them with the new.

If you have made changes in the files, then after updating all your changes will be lost.

Creating Blog Posts

To create a blog, first make sure that on the front page displays your latest posts. For this navigate to Settings -> Reading -> Front page displays and choose "Your latest posts" option. After that you can create new blog posts.

Adding new posts works similar to standard WordPress Posts -> Add New. All posts will be displayed on the front page.

With this theme you can use 5 post formats: standard, image, gallery, video, and audio.

Below you can see the "Add New Post" page.

Adding Pagination to the Post

If you want to split your post on the pages, use <!--nextpage--> quicktag.

Adding "Magnific Popup" to the Image

Step 1

Click on "Edit" icon.

Step 2

From the "Link To" drop-down menu select "Media File";

Next click on "ADVANCED OPTIONS" link;

Add the following class to the "Link CSS Class" field: popup-image

Click on "Update".

Creating Pages

Adding new pages works similar to standard WordPress Pages -> Add New.

Creating Menus

The first step of creating our menu is to open the WordPress Menu Editor. For this go to Appearance -> Menus, type Name for your menu and press Create Menu button.

Once you've created the menu, the your next step is to select the New Menu as the "First menu" (it is located at the top of the site) or the "Second menu" (it is located under the logo area) under the "Theme locations".

The final step is adding pages, links and categories to your New Menu. You can just select a page via the checkbox and click on "Add to Menu".

When you're done customizing your menu, click on "Save Menu".

Widgets

You can manage widgets on the Widgets page (Appearance -> Widgets).

Available widget areas:

• Homepage
• Archive pages
• Single post page
• Pages
• Footer (column 1)
• Footer (column 2)
• Footer (column 3)

This theme includes 5 new widgets, but in total you have 20 different widgets to use.

New widgets:

• Popular posts - Widget shows a list of popular posts
• Random posts - Widget shows a list of random posts
• Recent posts - Widget shows a list of recent posts
• Social links - Widget shows links to social profiles
• Thumbnails gallery - Widget shows a gallery of thumbnails

To get them, all you need to do is drag widgets available on the left side and drop into the right sidebars on the right side.

Shortcodes

This theme includes "bwp- Shortcodes" plugin. More information about this plugin you can see here.

Importing Demo Data

In the theme main files, that you have downloaded from ThemeForest, you can find a folder labeled "Demo Content" which contains an export file. This file you can use to import the demo data to your site. To do this, you need to perform a few simple steps.

Step 1

Go to Tools -> Import;

Click on "WordPress" link.

Step 2

Click on "Install Now".

Step 3

Click on "Activate Plugin & Run Importer" link.

Step 4

Next, press Choose file button and select the "theme-data.xml" file from the "Demo Content" folder (/Demo Content/theme-data.xml);

Press Upload file and import button.

Step 5

After you will then be offered to Assign Authors. You can read the description at the top as this explains everything;

Check the box "Download and import file attachments". This will download attachments for images included in the live preview demo;

Press Submit button.

Step 6

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

Theme Options

Site Identity

General Settings

Colors

Header

Header Image

Background Image

Menu Settings

Carousel

Blog

Pages Headings

Single Post Page

Quote (Footer)

Footer

Typography

Custom CSS / Additional CSS

Translation

To translate this theme, I recommend using the .mo and .po files. These files work in pairs, so for each language you need to have 2 files with the same name but a different extension. For example, if you want to translate the theme into Turkish language, your files would be tr_TR.mo and tr_TR.po.

At first, you need to create these files. For this you need to use Poedit software which is very easy to use. You can download it here. After installation Poedit software, you need to run it. Then, in Poedit go to File -> New from POT/PO file..., select and open the pot file from the "languages" folder (/languages/hiroto.pot). After that you just need to select your language, add translation, and save your changes.

Now you have .mo and .po files with your translation, and all you need to do is upload these both files into the "languages" folder on your server (/wp-content/themes/hiroto/languages/).

Support and Feedback

All questions you can send via the contact form HERE.

I answer all questions every day from Monday to Friday from 8:00 to 18:00 (GMT+3) within 24-48h in the order they were received.

Please do not panic if I do not answer too long – I love my buyers and I’ll answer for all questions ;)

Support for my items includes:

• Answering questions about how to use the item
• Answering technical questions about the item (and included third party assets)
• Help with defects in the item or included third party assets
• Item updates to ensure ongoing compatibility and to resolve security vulnerabilities

Item support does not include:

• Item customization
• Installation of the item
• Hosting, server environment, or software
• Support for third party plug-ins
• Plugins integration
• WordPress General Support (use the WordPress forums for general WordPress support)
• Support for issues caused by user modifications in the theme’s code, styling and general functionality

Credits

Thanks so much:

• Bootstrap - Bootstrap is the most popular HTML, CSS, and JS framework for developing responsive, mobile first projects on the web.
• QueryLoader2 - A simple script to create a preloader for images.
• Retina.js - Retina.js is an open source script that makes it easy to serve high-resolution images to devices with retina displays.
• jQuery Superfish Menu Plugin from Joel Birch - Superfish is a jQuery plugin that adds usability enhancements to multi-level drop-down menus. Fully supports touch devices and keyboard interaction.
• jQuery viewport checker - Little script that detects if an element is in the viewport and adds a class to it.
• OWL Carousel - Touch enabled jQuery plugin that lets you create beautiful responsive carousel slider.
• Masonry - Cascading grid layout library.
• imagesLoaded - Detect when images have been loaded.
• jQuery Parallax by Ian Lunn.
• Magnific Popup - Magnific Popup is a responsive lightbox & dialog script with focus on performance and providing best experience for user with any device.
• Font Awesome - The iconic font and CSS toolkit.
• Animate.css - A cross-browser library of CSS animations.
• Meta Box Plugin - Meta Boxes and Custom Fields Plugin For WordPress.
• TGM Plugin Activation - TGM Plugin Activation is a PHP library that allows you to easily require or recommend plugins for your WordPress themes (and plugins).
• Post Like System by JonMasterson - Post Like System for WordPress.
• Google Fonts - Lora, Open Sans.
• Subtle Patterns - Collection texture patterns.

Images in the demo:

• picjumbo
• SplitShire
• Unsplash

Audio and Video from the demo:

• song of storms piano again from lilypichu
• Dresden Elbe Hochwasser – 5 Juni 2013 from Sebastian Linda
• Working at Envato from Envato
• Seasons from Erica Haowei Hu