installation

Documentation

Welcome to Yaga

Yaga is a multipurpose WooCommerce-ready premium WordPress theme designed and developed by PeHaa THEMES. We wanted to keep it simple and elegant. In parallel with Yaga we developed two plugins that enhance the theme functionalities.

PeHaa THEMES Page Builder allows you building fancy page and posts layouts.
PeHaa THEMES Simple Post Types allows to easily add custom post types.
Both together will result in original layouts for whatever you want to showcase.

Setup

Once activated Yaga will display a Welcome Screen sending you to the Yaga Setup page (you can also access it in Appearance > Yaga Setup).

setupscreen

You can choose between installing and activating recommended plugins and installing, activating, configuring for the demo and importing the demo data.

setup2

If you choose Install and Activate Plugins four plugins will be installed and activated:

  • PeHaa Themes Simple Post Types
  • PeHaa Themes Page Builder
  • Envato Toolkit
  • CMB2 (Custom Metaboxes  and Fields by WebDevStudios)

Note that no custom post types will be added. The page builder will be activated on pages (default configuration).

If you choose Install + Activate Plugins and Import the Demo Data the plugins listed above will be installed and activated. PeHaa Themes Simple Post Types will be configured and “project” custom post type will be added together with its custom taxonomy “project_tag”. PeHaa Themes Page Builder will be activated on pages and projects.

The demo data is imported from wptemplates.pehaa.com/yaga-demo-01/ There will be imported:

  • 15 pages (Blog, Features, five home page versions and 8 portfolio versions).
  • 7 posts
  • 8 projects
  • custom menu for main navigation

Please note that for the copyright reasons the attached images are blurred.

We recommend installing the demo into a fresh WordPress install on your localhost.

Recommended Plugins

Yaga theme setup recommends the installation of four plugins:

  • PeHaa Themes Simple Post Types
  • PeHaa Themes Page Builder
  • Envato Toolkit
  • CMB2 (Custom Metaboxes  and Fields by WebDevStudios)

Note that none of them is strictly necessary and if you don’t install them or deactivate any of them Yaga will still be fully functional.

PeHaa Themes Page Builder

Yaga ships with the PeHaa Themes Page Builder a page builder plugin.

Pages is the only post type that will be activated for page builder by default after the plugin activation. If you want to use page builder for posts or custom post types added with PHT Simple Post Types go to the PHT Page Builder menu page and check the post types you want to use the page builder for.

PeHaa Themes Simple Post Types

PeHaa Themes Simple Post Types is a simple plugin by PeHaa Themes that allows you add easily custom post types and custom taxonomies. So if  posts and pages are not enough and you need projects, recipes, team members or kittens then PHT Simple Post Types is a way to go.

Envato WordPress Toolkit

Yaga Theme recommends the installation of Envato WordPress Toolkit plugin for keeping up to date with the theme updates.

APIkeyYou’ll need to generate and your Envato API key. Login to your Themeforest account and go to Settings > API Keys, copy your API key if it exists already or generate a new one.

Once the plugin installed and activated click on the Envato Toolkit link in your dashboard sidebar, type your marketplace username and paste your API key. Click “Save Settings.” In the Themes Tab you’ll see all of your purchases.

Note that with a theme update all your modifications to the theme files will be lost. To avoid it make sure to install and activate a child theme and use it to modify Yaga.

CMB2

Custom Metaboxes and Fields – you will need this plugin (available in WordPress repository) to manage some additional settings for your posts and pages. See the Posts and Pages section.

child

If you want to modify the theme css, you’ll have to edit the css/style.css file. It contains the three lines of code as below. Please note that you should not use “@import”, the parent css is loaded before your custom child css so “@import” is no needed.

/* Theme customization starts here. */
/* DO NOT use "@import". Just type some css that you need to add or override. */
/* Good luck with your project! */

If you are translating your theme (see Translate Your Theme section) you should add your translation files into the languages folder in your child-theme. From Yaga 1.0.2 we include an empty languages folder in the yaga-child folder, otherwise you have to create a folder named languages.

Navigation

Yaga theme has one theme location for a menu – Main Navigation. We try to automatically optimise the way the nested links are displayed. If all nested links have they own nested links they will be displayed within the columns ( see the image below). The number of columns can vary from two to four.

navigation

Theme Options

All the Yaga Theme customization happens through the WordPress customizer. That means the front-end view and your changes instantly visible – a big advantage from the user perspective.

Important!

All your customization is theme specific and your settings will not be applied if you switch between a child and the parent theme.

docs-customizer

Logo, Title and Tagline

You can upload two versions of logo, the second one can be used alternatively on posts and pages.

docs-logos

Preloader

Choose on which pages you’d like to add a preloader. You’ll have four options:

  • Archive pages and Check-in/out for custom pages and posts,
  • Check-in/out for custom pages and posts
  • Always
  • Never

Check-in/out for custom pages and posts” means that post and pages will have a Page Preloader metafield so that you choose whether to use a preloader individually for each page.

docs-preloader-meta

Custom Scripts and Footer Copy

If you use some traffic tracking script, it’s where you can paste your code.

You can choose whether to add your custom script to the page head or to the footer.

Also, if you don’t like the default footer copyright text, you can modify it here.

Dashboard Login

Some users like to personalize the logo displayed on the login page. You can upload a dashboard logo that will replace the default WordPress one.

The displayed logo height is 84 pixels. For a crispy look on retina screens prepare your image double sized – the width should not exceed 640px and the height should be 168px.

Sidebar

Here, you can choose if you want to have a left or right-sided widgets area.

If you display the recent posts on your home page you can set here whether you want or not display the sidebar.

Blog

What can you set here?

  • Choose between the standard pagination or a “Load More” button
  • Choose between the grid or one column view of your recent post page (note that the archive pages will use the grid layout).
  • Decide what meta information (date, category, author, number of comments) should be displayed and in which area (above the title or below the excerpt).

Fonts

With Yaga you can use two custom font families: one for the body text and one for the headings.

Simply choose a Google Font for body from Google Font Directory.

While choosing the body font family make sure that the italic, bold and bold italic styles exist, see the image below:

docs-fonts

You can also decide whether to capitalize all the headings (like in Yaga Portfolio) or not (like in Yaga Blog).

Colors

You can set custom colors for:

  • links and links on hover
  • body background and text
  • menu drop-downs background and text
  • footer background and text
  • footer copyright area background and text
  • the background of boxes used for posts and in sidebar, the same color is applied to the page borders.

Custom css

You can add custom styles here. You might also consider (recommended) using the child-theme stylesheet instead.

WooCommerce

If you activate the WooCommerce plugin there are four settings you can modify here.

You can set the numbers of products displayed par page (we set the default value to 12 that works well for both four and three columns view).

You can also switch on/off the side widgets on particular types of WooCommerce pages.

Posts and Pages

Once the CMB2 plugin is installed and activated all posts and pages display a custom metabox Yaga Custom Settings.

You can choose the color variant of the header (light or dark) and choose the logo version. This is useful if you use a page builder, skip the header and use a custom background for your first section.

Pages: Skip Elements include “Header” and “Sidebar”. Note that for pages that use PeHaa THEMES Page Builder sidebar is not displayed by default.

Posts: For posts you can decide to skip any of the following elements: header, sidebar, featured image, author’s bio, taxonomies, related articles slider.

docs-meta

Related articles slider

With Yaga Theme you can display a carousel of related posts at the bottom of your single post view.

The carousel is displayed if there are 5 related posts found. Note that only the posts with a featured image are taken into account. It there are no related posts (same tags or same category) 5 recent posts will be displayed instead.

You can disable the carousel for each post in the General Single View Settings metabox (see above).

docs-slider

Comments on Pages

Comments are by default enabled on pages. The comments area will be displayed if comments are opened (Quick Edit > Allow Comments) or if there are already some comments.

If you want to disable comments for all pages use this code snippet (it’s included commented in your child theme functions.php file – you just need to uncomment it):

add_filter( 'yaga_post_types_with_comments_displayed', 'yaga_child_post_types_with_comments_displayed' );
function yaga_child_post_types_with_comments_displayed() { return array( 'post' ); }
translation1

Troubleshooting

Sometimes things do not work as they should…

Header Video:

If the video doesn’t display you might have to add the following in your .htaccess file (Linux/Apache servers).

AddType video/ogg .ogv
AddType video/mp4 .mp4
AddType video/webm .webm
For more information see Mediaelementjs documentation.

Featured Images:

There are four image size variants used in this template, they are generated by WordPress during the image upload. If your images are already uploaded please use the Regenerate Thumbnails plugin, that will generate the missing sizes for you.

You don’t need this plugin if you start building your site with Yaga and you’ll upload all your images with Yaga being activated.

Theme styles not loading properly:

Yaga theme minifies the css and javascripts files. If you are used a service like Cloudflare it may happen that the double minification of the css files causes problems. It’s recommended that you only have one minify option turned on for your website.

In this case you should either turn off the css minification via your optimizationn service or enqueue the unminified css file.

Use a child theme and add the following block of code to yaga-child/functions.php:

add_filter( 'pehaathemes_main_stylesheet', 'not_minified_pehaathemes_main_stylesheet', 11 );
function not_minified_pehaathemes_main_stylesheet( $stylesheet ) {
	if ( 'style' === $stylesheet ) {
		return 'style.dev';
	}
	if ( 'style-wc' === $stylesheet ) {
		return 'style-wc.dev';
	}
	return $stylesheet;	
}

Helper css classes

Since you can add custom class attributes to your page builder modules we provide a few helper classes:

Text alignment

If you want to align text within your module/column/section:

  • pht-text-center
  • pht-text-left
  • pht-text-right

Margins

To force the bottom/top margins of your module/column:

  • pht-mb  – will force a 24px bottom margin
  • pht-mb0  – will force a 0px bottom margin
  • pht-mt – will force a 24px top margin
  • pht-ml – will force a 24px left margin
  • pht-mr – will force a 24px right margin

Letter Spacing

pht-spacedletters will increase the spacing between letters

Links

pht-underline-links – will display links underlined, same color as the text

Thank you. Please don’t hesitate to contact us via our themeforest profile page.

/*-------------------------------------------------------------------------*/
/* Yaga Theme Changelog
/*-------------------------------------------------------------------------*/
Yaga 2.0.4

release date: 08-04-2016

includes/class-yaga-phtpb-addons.php
	- rounded images possible for images module
css/style.css, css/style-wc.css
	- fixed site-header double search field
	- fixed first section display 
includes/class-yaga-woocommerce.php, includes/woocommerce/
	- fixed support for categories and subcategories on shop page
style.css
	- updated version number


Yaga 2.0.3

release date: 06-03-2016

library/classes/class-pht-theme-start.php
	- added filter enabling extending google font subsets 
includes/woocommerce/single-product/product-thumbnails
	- fixed thumbnail size and added filter enabling setting
woocommerce image sizes
includes/class-yaga-woocommerce.php
	- added filter enabling setting woocommerce image sizes
includes/class-yaga-customizer.php
	- fixed typo
includes/class-pht-theme-config.php
	- removed the documentation link from the dashboard menu - 
causing errors for ome server configurations
includes/class-yaga-woocommerce.php
	- fixed missing translatable strings
style.css
	- updated version number

All versions

/*------------------------*/
/* Yaga Theme Changelog
/*------------------------*/
Yaga 2.0.4

release date: 08-04-2016

includes/class-yaga-phtpb-addons.php
	- rounded images possible for images module
css/style.css, css/style-wc.css
	- fixed site-header double search field
	- fixed first section display 
includes/class-yaga-woocommerce.php, includes/woocommerce/
	- fixed support for categories and subcategories on shop page
style.css
	- updated version number


Yaga 2.0.3

release date: 06-03-2016

library/classes/class-pht-theme-start.php
	- added filter enabling extending google font subsets 
includes/woocommerce/single-product/product-thumbnails
	- fixed thumbnail size and added filter enabling setting woocommerce image sizes
includes/class-yaga-woocommerce.php
	- added filter enabling setting woocommerce image sizes
includes/class-yaga-customizer.php
	- fixed typo
includes/class-pht-theme-config.php
	- removed the documentation link from the dashboard menu - causing errors for ome server configurations
includes/class-yaga-woocommerce.php
	- fixed missing translatable strings
style.css
	- updated version number

Yaga 2.0.2
release date: 02-03-2016
includes/class-yaga-woocommerce.php
 - added filter enabling more links in the cart menu item
includes/class-yaga-phtpb-addons.php, includes/class-yaga-view.php, js/
 - fixed lightbox gallery
includes/class-yaga-phtpb-addons.php
 - fixed scrolling down arrows
style.css
 - updated version number
Yaga 2.0.1
release date: 22-02-2016
css/style.css, css/style-wc.css
 - fixed site-header bugs
style.css
 - updated version number
Yaga 2.0.0
release date: 20-02-2016
screenshot.png
 - changed to version 2.0
includes/setup, js/
 - multiple demos
 - added new demo
 - added contact page to the main demo
js/
 - added countdown module and images carousel
includes/class-yaga-phtpb-addons.php
 - overrides the Contact Form module
 - overrides the _phtpb_img_carousel_slide function
library/classes/pht-tiled-gallery, includes/class-yaga-tiled-gallery.php, includes/class-yaga-phtpb-addons.php
 - added skip resize for gif images in gallery and portfolio
library/classes/class-pht-resize-image.php, library/functions.php
 - added skip resize for specified mime type
includes/class-pht-theme-config.php
 - fixed sidebar defaults overrides
includes/class-yaga-megamenu-walker.php
 - replace #link by esc_url( home_url( '/') )#link
css/style.css, css/style-wc.css
 - fixed behavior for transparent png hover images
 - styles for countdown module and images carousel added
 - improved Contact Form 7 notifications
woocommerce/content-product
 - fixed the width classes to improve layout on smaller screens
includes/class-yaga-phtpb-addons.php
 - fixed a bug where ids where not added to columns
style.css
 - updated version number
Yaga 1.2.1
includes/class-yaga-widget-socials
 - added Behance
fonts, css/style.css, css/style-wc.css
 - added Behance icon
css/style.css, css/style-wc.css
 fixed woocommerce notifiction "view cart"
includes/class-yaga-entry.php
 - fixed typo
woocommerce/cart/mini-cart.php, woocommerce/content-product.php, woocommerce/loop/add-to-cart.php, woocommerce/single-product/review.php
 - WooCommerce version 2.5 compatibility
header.php
 - conditional pingback link
css/style.css, css/style-wc.css
 - fixed header video position,
 - fixed gallery and gallery portfolio links position
includes/class-yaga-single-view.php
 - added 'yaga_related_starts_display_from' and 'yaga_related_posts_count' hooks to ad more flexibility to the posts carousel
includes/class-yaga-site-header.php
 - possibility to disable the main navigation
includes/class-yaga-phtpb-addons.php
 - fixes possible errors with custom query
style.css
 - updated version number
Yaga 1.2
includes/class-pht-theme-config.php
 fixed page builder on special pages (woocommerce, posts page)
includes/class-yaga-phtpb-addons
 added hooks to enable modifications via child theme,
 added All Items Label field for Filtrable Portfolio Module
css/style.css, css/style-wc.css
 - style for WPML menu icons
js/
 - Waypoints updated to 4.0.0
 - Fixed menu behavior
style.css
 - updated version number
Yaga 1.1
css/style.css, css/style-wc.css
 - allow breaking too long links in comments
includes/class-yaga-customizer.php
 - fixed changing drop-down menu colors
includes/class-yaga-config.php
 - fixed custom logo height
includes/class-yaga-single-view, includes/class-yaga-site-header, includes/class-pht-theme-config.php
 - fixed behavior on password protected posts
library/classes/class-pht-theme-start.php, includes/class-yaga-sidebar.php, includes/class-pht-theme-config.php
 - changed the name of static variable PeHaaThemes_Theme_Start::$post_types_with_FPB to PeHaaThemes_Theme_Start::$post_types_with_PHTPB
library/classes/class-pht-theme-start.php
 - added "if class_exists" to avoid potential errors if redefined in a child-theme
js/
 - updated slick.js to version 1.5.9
 - added smooth scroll for menu items with anchors on the same page
style.css
 - updated version number
Yaga 1.0.2
library/class-pht-theme-start.php
 - fixed text domain bug
 - enabled adding translation files to a child theme
style.css
 - updated version number
Yaga 1.0.1
css/style.css, css/style-wc.css
 - fixed overlay bug in Edge browser
 - fixed default border color for galleries
 - fixed menu color bug
 - fixed left and right margins for a full-width button
readme.txt 
 - fixed theme text domain info
style.css
 - updated version number
Yaga 1.0.0
Initial release