IshYoBoy - LOOKIN' FO' DESIGN? TEMPLATE? THEME?
LOOKIN' FO' DESIGN? TEMPLATE? THEME?

Web: ishyoboy.com
Twitter: @ishyoboydotcom

Thank you for purchasing one of our items.
We really appreciate it.

Support requests:
http://support.ishyoboy.com/

Any questions in general:
hello@ishyoboy.com

Documentation

Leepho WP - Parallax Photography Theme

Premium Theme Setup
Tip: Are you a WordPress beginner?
Let us Install & Setup the theme for you, hassle-free →
Table of contents
  1. Update Instructions
  2. General overview
  3. First steps
  4. Page Builder Elements
  5. Creating & Managing Content
  6. Sources and credits
  7. Change-log
0. Update instructions

If you have just purchased this theme please skip this section and go directly to 1. General overview.

1. UPDATE STEP: Back up your current theme & assets plugin to a safe place.

1. Copy the folder leepho located in wp-content\themes\leepho from your FTP server to a safe place.
2. Copy the folder ishyoboy-leepho-assets located in wp-content\plugins\ from your FTP server to a safe place.

Do not skip these steps as you might loose previously made changes and might regret it later. Rather be safe than sorry!

2. UPDATE STEP: Delete (remove) the existing theme.

Delete the folder leepho located in wp-content\themes\leepho from your FTP server. Please remove it completely as simply replacing the existing folder might end up in a merged version containing files both from the newest version and from the older one. This might lead to nasty Errors and hour of problem solving.

If you are managing your themes directly from WordPress rather than using FTP server then do the following steps:

  1. Activate a different theme (e.g. Twenty twelve ) and delete your current version of Leepho theme under "Appearance -> Themes" by clicking on it and clicking the delete button in the right bottom corner of the pop-up window. Don't worry all the changes made in the administration and all content will remain.
  2. Install the zip file the way you did when you first installed Leepho.
  3. Go to Theme Options and re-save all settings again.

Do not worry, all changes made within the CMS will remain untouched! You will not loose your content.

3. UPDATE STEP: Install and activate the new version of Leepho WordPress theme

WordPress Theme Uploader:

  1. From the left sidebar click on Appearance, and click on Themes.
  2. Now click on the Add New button.
  3. Click on the Upload link.
  4. Click on the Choose File button and locate the unzipped Leepho archive in your computer. Select the leepho.zip file.
  5. Finally, just click Install now and voila! The theme is now available to be activated in WordPress!

FTP upload:

  1. Connect to your FTP account using an FTP client (Total commander on a PC, Transmit or Cyberduck on a MAC). Navigate to your WordPress installation directory and enter wp-content\themes folder in it.
  2. Now, in a second window, browse the files in your computer and locate the contents of the unzipped Leepho archive and the Theme Zip folder.
  3. In it, you will find a file called leepho.zip. Unzip it and you should have a folder called leepho. To be 100% it's the right folder, it should contain functions.php and style.css directly in it.
  4. Just upload the leepho folder to wp-content\themes.

Activating the theme:

Now if you navigate back to "Appearance -> Themes" you will see Leepho WordPress theme in the "Available Themes". Activate this theme.

4. UPDATE STEP: Update IshYoBoy Leepho Assets plugin

Make sure to update the IshYoBoy Leepho assets plugin under Plugins -> Installed Plugins. You should have an automatic update notification but it might take up to 12hrs to show up. To update the plugin manually deactivate it and delete it. Navigate to "Appearance -> Install Plugins". Install and activate the plugin.

5. UPDATE STEP: Refresh Permalinks.

To avoid unnecessary rewrite problems leading into 404 errors, please navigate to "Settings -> Permalinks" and hit "Save Changes" button.

6. UPDATE STEP: Re-save all Theme Options & Empty Web Browser's cache memory.

1. This step is very !important. Navigate to "Appearance -> Theme Options" and hit the "Save All Changes" button in the right top corner. If you have a multilingual setup, please do this step for each language.

2. Now make sure to clear your browser's cache memory, so that the latest JavaScript and CSS Style files will be loaded. You can check an online guide on how to do it, based on your web browser (Chrome, Firefox, Internet Explorer...) - How to Clear Your Browser's Cache.

Ignoring this steps might lead to unnecessary problems and complications.

Please go through all new options inside "Appearance -> Theme Options" and modify them to your needs.

7. UPDATE STEP: There's no such step. You are done!

This was the last step for a correct update installation of Leepho WordPress theme.

For a complete change-log please navigate to your Leepho theme administration -> Appearance -> Theme Options -> Theme Update -> View older versions

All the changes are results of your requests, wishes and feedback. A big "THANKS" goes to you for helping us make our themes better!

Top
1. General overview

Before you can start enjoying your new theme, let's see what the Leepho zip file includes:

  • Documentation - You are currently reading the file in it :)
  • Demo Content - XML file with pre-defined content for manual import
  • Child Theme - Starter child theme for future theme modifications
  • Theme Zip - Zipped version for the built-in WordPress Theme Uploader
Top
2. First steps

To be able to use Leepho WordPress theme please follow all of these steps:

Tip: Are you a WordPress beginner?

If you're looking for WordPress theme installation and Setup to look exactly like the live theme demo and do not feel comfortable to go through all the steps below - then we're here to help.

Let us Install & Setup the theme for you, hassle-free →
Top
1. Install WordPress

Please download and install the latest WordPress version on your server from wordpress.org. If your hosting provider does not provide an automatic "one click" WordPress install, here is a little tutorial to help you do it manually:

If you haven't worked with WordPress before, check these tutorials in order to learn at least the minimum WordPress basics.

Top
2. Install both "Leepho" and "Leepho Child" themes and activate the child theme

Option 1: WordPress Theme Uploader

  1. After having WordPress installed, log into the admin area.
  2. From the left sidebar click on Appearance, and click on Themes.


  3. Now click on the Add New button.


  4. Click on the Upload Theme button.


  5. Click on the Choose File button and locate the unzipped Leepho archive in your computer. Select the leepho.zip file.


  6. Click Install now and wait until the install process is ready.
  7. If you get the "Are you sure you want to do this?" message, it means you have an upload file size limit and you should either install the theme via FTP (see "Option 2" in this step), or call your hosting company and ask them to increase the limit (provide this information: "upload_max_filesize" and "post_max_size" and ask them to set it to 40MB).
  8. Repeat all the steps and install the leepho-child.zip from the unzipped Leepho archive
  9. Both Leepho and Leepho Child should now be available for activation
  10. Hit the Activate button next of the Leepho Child theme.


  11. Voila! The theme is now activated and ready to use!

Option 2: FTP upload

  1. Connect to your FTP account using an FTP client (Total commander on a PC, Transmit or Cyberduck on a MAC). Navigate to your WordPress installation directory and enter wp-content\themes folder in it.
  2. Now, in a second window, browse the files in your computer and locate the contents of the unzipped Leepho archive and the Theme Zip folder.
  3. In it, you will find a file called leepho.zip. Unzip it and you should have a folder called leepho. To be 100% it's the right folder, it should contain functions.php and style.css directly in it.
  4. Just upload the leepho folder to wp-content\themes.
  5. Now find the "Child Theme" folder in the unzipped Leepho archive.
  6. In it, you will find a folder called leepho-child.
  7. Just upload the leepho-child folder to wp-content\themes.
  8. After having both themes uploaded, log into the admin area.
  9. From the left sidebar click on Appearance, and click on Themes.
  10. Both Leepho and Leepho Child should now be available for activation
  11. Hit the Activate button next of the Leepho Child theme.
  12. Voila! The theme is now activated and ready to use!

This was the last step needed for a correct installation of Leepho WordPress theme.
Now please follow these additional steps in order to make Leepho WordPress theme look and work correctly.

Top
3a. Install "IshYoBoy Leepho Assets" & "Contact Form 7" plugins

Navigate to "Appearance -> Install Plugins" or click the "Begin installing plugins" link in the Notification area. Install and activate both plugins.


IshYoBoy Leepho Assets plugin is mandatory for the theme to run correctly. It will add the portfolio functionality and all content elements which can be used to build your pages' content.

Contact Form 7 plugin is used for the main contact form. It has an excellent documentation so please follow it to set-up the plugin correctly. After you are done with the installation, you will find a new "Contact" link in the left navigation sidebar. This is the basic "Contact Form 7" form that is used on the site: 

<p>Your Name (required)<br />
    [text* your-name placeholder "Your Name"] </p>

<p>Your Email (required)<br />
    [email* your-email placeholder "Your Email"] </p>

<p>Subject<br />
    [text your-subject placeholder "Subject"] </p>

<p>Your Message<br />
    [textarea your-message placeholder "Your Message"] </p>

<p>[submit "Send"]</p>

Note: Whether you decide to use the default CF7 configuration or to import the demo one in the next step. Do not forget to set the e-mail to which all filled contact forms will be sent.

Top
4a. Import and set everything automatically


! This step is highly recommended as you will be able to see all pages and elements used correctly exactly as in the online preview.
It can spare you a huge amount of time and sweat drops. We've warned you. The decision is up to you now.

Ensure "IshYoBoy Leepho Assets" and "Contact Form 7" are installed and activated

To avoid unnecessary errors and headaches during the import, please make sure "IshYoBoy Leepho Assets" and "Contact Form 7" are installed and activated under "Appearance -> Install Plugins" before importing the demo content.

Ensure "WooCommerce - excelling eCommerce" is installed and activated if you plan to import our live shop

If you also want to import the content of our live demo shop, please make sure WooCommerce plugin is installed and activated as well. To install it, head to "Plugins -> Add new", use the search functionality to look for "woocommerce" and install the "WooCommerce - excelling eCommerce" plugin.

Use the One Click Import provided by the theme

Navigate to "Appearance -> Theme Options" or click the "Theme Options" link in the admin bar and enter tha "Demo Data Import" tab. Ensure all necessary plugins are installed and active. Now click the "Import Demo Content" button, sit back and wait until the process is finished.



Once successfully imported, skip the next steps and jump directly to step 9.

4b. Import and set everything manually


Navigate to "Tools -> Import" then click "Wordpress" and install "Wordpress Importer". After installation choose the "leepho.xml" located in the "Demo Content" folder and import the chosen XML file. In the next step select "Download and import file attachments" and press "Submit".

! As our demo content consists of many pages and images, if you decide to download all attachments, this action might take up to few minutes based on your internet connection speed and server configuration. Therefore please wait while everything loads. If for any reason the Import freezes and fails without the "All done, have fun" message, please upload and import the xml file again until you get the message.

Top
5. Change permalink style


! Ignore this step if you have used the Automatic Import in step 4a.

Navigate to "Settings -> Permalinks" and under "Common settings" choose "Post name".

Change permalinks

Top
6. Set up home page and blog


! Ignore this step if you have used the Automatic Import in step 4a.

Navigate to "Settings -> Reading" and under "Front page displays" set "A static page". As "Front page" set "Home". As "Posts page" set "Blog".

Set up home page and blog

Top
7. Create a navigation Menu and set it


! Ignore this step if you have used the Automatic Import in step 4a.

Navigate to "Appearance -> Menus". If no menu exist please create a new one and add you pages to it.
Do not forget to set it to be used in "Main menu" area. Ignoring this step might lead to navigation problems and its incorrect display. For more information about WordPress menus, please visit http://codex.wordpress.org/Appearance_Menus_Screen

Top
8. Set up widgets

! Ignore this step if you have used the Automatic Import in step 4a.

First of all navigate to "Appearance -> Widgets". On the left, there is a set of widgets that can be used. On the right side you can find a list of all pre-defined sidebars.

Theses sidebars can be used on several Widgetized (Sidebar) areas throughout the whole webpage. Leepho comes with the following set of widgetized areas:

  1. Expandable area - on all pages
  2. Blog Sidebar area - Left or Right blog sidebar - used on Blog pages only
  3. Portfolio Sidebar area - Left or Right portfolio sidebar - used on Portfolio pages only
  4. Woocommerce Sidebar area - Left or Right woocommerce sidebar - used on Woocommerce pages only
  5. Footer - Main footer area used on all pages

Widgetized areas

All these areas can be set globally for all pages from "Appearance -> Theme Options", but can also be customized on every single page. This is where the "Unlimited Sidebars" Leepho feature comes in handy. You have the possibility to create unlimited number of sidebars under "Appearance -> Sidebars" and then decide in which area to use them.

Custom Sidebars on every page

The order is to firstly create new custom sidebar under "Appearance -> Sidebars" by clicking on "+ Add Sidebar" button, Then navigate to "Appearance -> Widgets" where you'll see your freshly created sidebar in the right column. Now simply add the widgets you want and define their widths. Once done, navigate either to "Appearance -> Theme Options" and set the Sidebar to be used in the widgetized area you wish, or navigate to the exact Page, Blog or Portfolio and set it there for the given page only.

Unlimited sidebars

Enough theory! To finish the setup of widgets we recommend to remove all widgets from all widgetized areas. This makes all the areas clear and ready for Leepho WordPress theme widgets.

Once all widgets are set in the "sidebars" it's time to decide where to display each area. Leepho provides the opportunity for you to manage all widgetized areas and decide which sidebars to display in them. Navigate to "Theme Options" and in each section "Header Options"

All custom Leepho Wordpress theme widgets are marked with yellow icon right to the titles.

Top
9. Set all "Theme Options"

Leepho provides advanced theme customization interface under "Appearance -> Theme Options". Please go through all settings and tweak them to your needs. The settings are self explanatory but you can also find description next to each option.

The "Demo Content" folder contains an export of all "Theme Options" as they are set on the live preview page. If you wish to import them, please open the "theme-options.txt" file located in the "Demo Content" folder and copy its contents. Now open WordPress admin and navigate to "Appearance -> Theme Options", select the "Backup Options" tab and replace the text code under "Transfer Theme Options Data". Now simply hit "Import Options"

Theme Options

Top
3. Page Builder Elements

Leepho comes with an outstanding set of content elements available to help you assemble the content just in seconds. Whether you are a developer or a newbie you will be able to make thousands of combinations. All elements are integrated using a custom Drag and Drop Page Builder and are extremely easy to use.

When editing any page or post detail, just click on the yellow "Switch to Page Builder" button located above the default WordPress Visual Editor. This will transform the default editor into a drag and drop page builder. Click the "Add element" button and choose from the provided list of available elements.

Each element has its own settings with descriptions to help you understand what they do.

4. Creating & Managing Content
Page Content

All the content on all pages is managed through the Page Builder. Whether it's a Blog Post, Portfolio Item or Regular Page, all the content can be created using the page builder. Leepho provides advanced "Grid System" for perfect content positioning along with dividers and separators to add more space to the design of each page.

Top
Page Settings

By default every page uses the "default", global options managed under "Appearance -> Theme Options". In some cases a custom setting is needed which differs from all other pages. This is when "Page Settings" can be used.

There are a few meta-boxes allowing you to control the layout of the current page, the breadcrumbs, sidebar, etc..

Top
SEO Options

Leepho was built following the most up to date SEO best practices. It was built to play well with the amazing WordPress SEO by Yoast plugin but can also be combined with any properly-coded SEO plugin.

Top
Pages - Creation and Editing

If you have followed the documentation until here you already know everything about the content management of pages.

Top
Portfolio - Creation and Editing

Before starting with the portfolio creation, please decide whether you'll use 1 portfolio or several portfolios. If the latter, different portfolios will be represented by portfolio categories, therefore it's necessary to use categories nesting.

The portfolio or portfolios can be displayed on any page by using the Portfolio element, which provides a great level of customization plus it inherits all its options from the global, "Theme Options". Please create a Portfolio page, set it as the main portfolio page in "Theme Options", set all "Portfolio Options" and use the page builder's "Portfolio" element to make the page display the portfolio.

Creating the single Portfolio items is as easy as creating any page. There is no layout restriction, use elements to create any layout you wish. There is a set of Portfolio only elements which can be used to display the dynamic content within a single portfolio item: Portfolio Gallery, Portfolio Links, Portfolio Categories.

You are provided with an absolute freedom within the content. Use the "Media Embed" element for Videos and other Media, add Images, Slideshows, columns, menus...

Adding images gallery to a portfolio single item and managing the images order is very simple and intuitive.

The sidebar settings if set to "Default Setting" are inherited from "Portfolio Options" Tab under "Appearance -> Theme Options".

NOTE: Every Portfolio item needs to have "Featured image" set as this will be used to represent the item. Always upload the images in high quality. Leepho will then optimize them.

Editing the portfolio single item settings

Top
Blog Post - Creation and Editing

The content of every Blog post is a free field and all content elements can be used to create the content and the desired layout. If set in "Theme Options" social share buttons will be displayed after the content. If not, they can be entered inside the content via the "Social Share Bar" element.

For every Blog post a Post Format can be set and so:

  • Standard - Text only posts.
  • Image - Text and Image posts. You can set a featured image to represent the post.
  • Audio - Use the Audio settings field to enter the mp3 url, featured image can be used.
  • Video - Use the Video settings field to enter the url, embed code or self-hosted video. Featured image will be used as a backup if no video is provided.
  • Link - Use the link settings to enter the URL and the Text for the link. Featured image can be used
  • Quote - Use the quote settings to enter the quote and author. If content is provided it will be displayed after the quote. Featured image can be used as well.

Post Audio

Post Video

Post Link

Post Quote


Top
Expandable area

The Expandable area is controlled in Theme Options and can be either disabled or displayed on all pages.


Top
WPML - Multilingual CMS

Leepho theme is compatible with the great WPML - Multilingual CMS WordPress plugin. In case you and your business need a multilingual site, WPML is the solution. Not only you can provide different language versions of pages and content, but the "Theme Options" are per-language, which means you can completely change the look and settings of the website for every language.

If you are new to WPML please refer the official website and the Getting Started Guide.

NOTE: We strongly recommend preparing your content and website settings without the WPML Plugin being installed and first then, when your content is ready, installing it and starting with the content translation. This will spare you lots of problems and headaches.

Language specific Theme Options

Language specific Theme Options

Use the WPML language selector in the WordPress Admin bar to switch between languages. When a new language is added it will copy the current Theme Options from the default language and from this moment the "Theme Options" will not be synchronized anymore between the language versions. If a change is done to the options of one language and it needs to be in all languages, the change needs to be manually applied into each language's options. This is why it's better to first configure all options in the "default language theme options" and first then create, all other languages.

To simplify the process, you are provided with the option of exporting and Importing the theme, options. You can copy the "Transfer Theme Options Data" string of the one language from "Backup Options" tab under "Theme Options" and import it in other languages by pasting it into their "Transfer Theme Options Data" and hitting the "Import Options" button.


Top
Backup Options

Leepho theme provides "Theme Options" Backup and Restore functionality. The backups are per-language if you're using the WPML Multilingual Plugin. Therefore you can backup the "Theme Options" of every language.

Only the latest backup is saved. If you back the "Theme Options" up again, it will be overwritten. To backup all data, please navigate to "Backup Options" tab under "Theme Options". If you're using the WPML plugin, make sure you are viewing the settings of the correct language as the "Theme Options" are specific for each language. Now click on the "Backup Options" or "Restore Options" buttons and you are done!

NOTE: We strongly recommend preparing your content and website settings without the WPML Plugin being installed and first then, when your content is ready, installing it and starting with the content translation. This will spare you lots of problems and headaches.

Leepho provides the option of exporting and Importing the theme, options. You can copy the "Transfer Theme Options Data" string of the one language from "Backup Options" tab under "Theme Options" and import it in other languages by pasting it into their "Transfer Theme Options Data" and hitting the "Import Options" button.

Transfer Theme Options Data

To reset the "Theme Options" to their defaults use the "Reset Options" button located on the left bottom corner of every page. Please note this will erase all your modified settings on all "Theme Options" tabs.

NOTE: "Reset Options" is language specific therefor only the current language' options will be reset. To reset the settings of all languages please navigate to every language's "Theme Options" page and hit the "Reset Options" button.


Top
Woocommerce

Leepho is Woocommerce fully compatible! This awesome free plugin turns your website into advanced ecommerce shop. For more information about installing and setting the plugin up, navigate to Woocommerce official page


Top
5. Sources and credits

The following fonts, icons and other files were used:

Fonts
Iconic Fonts
Javascript 3rd-party plugins
Patterns, Images & SVGs
Theme Options
Top
6. Change-log

For complete change-log please navigate to your Leepho theme administration -> Appearance -> Theme Options -> Theme Update -> View older versions

Top
ishyoboy.com - Thank you again! Top