Skip to content


Subversion checkout URL

You can clone with
Download ZIP
Fetching latest commit...
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.


<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "">
<html xmlns="">
<meta http-equiv="Content-Type" content="text/html;charset=utf-8" />
<title>A guide to the Path theme</title>

<style type="text/css">body{width:750px;margin:36px auto 60px auto;font:16px/25px Georgia,Times,'Times New Roman',serif}a:link,a:visited{color:#2f6eb9;text-decoration:none}a:hover,a:active{text-decoration:underline}h1,h2,h3,h4,h5,h6{margin:40px 0 30px 0;color:#000;font-weight:bold;font-family:Arial,sans-serif}h1{margin-top:80px;font-size:2.2em}code{padding:0 3px;background:#eee}pre code{padding:0}pre{padding:9px;background:#eee;border:1px solid #ccc}ul{list-style:square}p.first{font-size:21px}p.second{font-size:15px} li{margin-bottom:10px}.section{overflow:hidden}.columns-2{float:left;width:350px;margin:0 0 21px 25px}.columns-3{float:left;width:230px;margin:0 0 21px 20px}</style>


<h1>Path WordPress theme</h1>

<p class="first"><em>Path</em> is a parent theme for WordPress.  </p>

<p class="second">This theme is a parent theme.  <strong>All modification</strong> should be made via a child theme.</p>


<p><em>Path</em> is built on <a href="" title="Hybrid Core theme framework">Hybrid Core</a> framework. I can't thank enough <a href="" title="Justin Tadlock">Justin Tadlock</a> who has created it. This theme rolemodel is <a href="" title="My Life">My Life</a> theme, so check out all the <a href="" title="Hybrid Themes">Hybrid Themes</a>.</p>

	<li>Per-post layouts which means that you can choose one, two or three column layout. Content on the left, right or center.</li>
	<li>Post setting that allows you to add a custom stylesheet for individual posts.</li>
	<li>A smart breadcrumb system.</li>
	<li>Built-in pagination.</li>
	<li>Post thumbnails that work with WordPress featured image functionality and provide extra features.</li>
	<li>Multiple sidebars areas: Primary, Secondary, Subsidiary, Before Content and After Singular.</li>
	<li>Dynamic body, post, and comment <acronym title="Cascading Style Sheets">CSS</acronym> classes.</li>
	<li>Fully internationalized, so you can translate the theme in any language. You should place your translations files to child theme <code>languages</code> folder.</li>
	<li>Built-in WordPress menu system. There are three menus in the theme: Primary, Secondary and Subsidiary.</li>
	<li>Context-aware action and filter hooks.</li>
	<li>Some of the most-used filter hooks are shortcode-ready and have accompanying shortcodes.</li>
	<li>Theme settings page (Appearance &raquo;&raquo; Theme Settings) that allows you to add footer text and set global layout.</li>
	<li>Set logo under Appearance &raquo;&raquo; Header.</li>
	<li>Set background under Appearance &raquo;&raquo; Background.</li>
	<li>Ability to create custom templates for any post type in multiple ways.</li>
	<li>Highly-configurable widgets that give you full control over their display.</li>
	<li>Widget areas are content-aware, meaning that they only appear if they contain active widgets.</li>
	<li>Support for Post Formats.</li>
	<li>Theme was designed with <a href="" title="Mobile First">Mobile First</a> attitude. It uses so called footer menus for "mobile" devices, <a href="" title="Respond.js">Respond.js</a> for legacy browsers and <a href="" title="Fit Vids">Fit Vids</a> for videos.</li>

<h2>Child themes</h2>

<p><em>Path</em> is a parent theme, so create a child theme for any customizations.</p>

	<li>Create a theme folder in your <code>/wp-content/themes</code> directory called <code>path-child</code>.</li>
	<li>After that create a <code>style.css</code> file in <code>/wp-content/themes/path-child</code> folder.</li>
	<li>At the top of your <code>style.css</code> file, add the below information.</li>

 * Theme Name: Path Child
 * Theme URI:
 * Description: Describe your child theme.
 * Version: 0.1
 * Author: Your Name
 * Author URI:
 * Tags: Some, Tags
 * Template: path

<p>After that you might want to import all the styles from parent theme.</p>

<pre><code>@import url( '../path/style.css' );

/* Custom code goes below here. */</code></pre>

<p>This is officially-supported way of modifying themes in WordPress.</p>

If you want to use media queries in child theme and support them in browsers like IE7 and IE8,
you should copy and paste css rules from parent theme <code>style.css</code> to child theme <code>style.css</code> and remove line <code>@import url( '../path/style.css' );</code>
Remember to change all the url like this.<br />
<code>background: url(../path/images/menu-plus.png) no-repeat 0 0;</code>

<h2>Supported plugins</h2>

<p><strong>Co-Authors Plus</strong></p>
<p>Theme is designed for multi-author blogging or magazine style websites. Theme filters byline so that all authors are displayed if <a href="" title="Co-Authors Plus">Co-Authors Plus</a> is installed. And theme also adds author metabox under every article, displaying all authors. You can also add Twitter username in user profile.</p>

<p><strong>Smart Archives Reloaded</strong></p>
<p>If <a href="" title="Smart Archives Reloaded">Smart Archives Reloaded</a> is installed and active, it automatically do its magic in <em>Archives</em> page template.</p> 

<p><strong>Social Path</strong></p>

<p>If <a href="" title="Social Path">Social Path</a> is installed and active, you can share your posts on Twitter, Google+ and Facebook. Plugin adds these buttons after singular post.</p>

<p><strong>Gravity Forms</strong></p>
<p>Path includes base CSS for <a href="" title="Gravity Forms">Gravity Forms</a> plugin. CSS can be found in the middle of the <code>style.css</code>.</p>

<h2>Theme Settings (Appearance &raquo;&raquo; Theme Settings)</h2>

<p><strong>Set logo</strong></p>

<p>Set logo under Appearance &raquo;&raquo; Header. Suggested logo size is 300 x 99 (in pixels). Image size is flexible so you can try different image size. Theme is using Header images only for logo, not header images. Of course you can remove default logo and Blog name will be displayed.</p>

<p><strong>Set background</strong></p>

<p>Set background under Appearance &raquo;&raquo; Background.</p>

<p><strong>Change default layout</strong></p>

Path theme has two column layout by default, content on the left and sidebar on the right. You can change this default layout under Appearance &raquo;&raquo; Theme Settings. You can overwrite this in post
editor by choosing layout for that certain post:
<li>One Column</li>
<li>Two Columns, Left (theme default)</li>
<li>Two Columns, Right</li>
<li>Three Columns, Left</li>
<li>Three Columns, Right</li>
<li>Three Columns, Center</li>

<p><strong>Footer text</strong></p>

<p>You can change Footer text in Footer Settings metabox.</p>

<p><strong>Theme customize</strong></p>

<p>You can also customize theme in live preview using WordPress customize. Check it out under <strong>Appearance &raquo;&raquo; Customize</strong>. It's pretty cool.</p>

<h2>Page Templates</h2>

<p>There are several page templates in this theme. They are located in <code>page-templates</code> folder. If you need to overwrite page templates in a child theme, create subfolder <code>page-templates</code> in child theme and copy certain page template in that folder and start modifying.</p>

	<li>Archives (archives.php): this page template automatically work with <a href="" title="Smart Archives Reloaded ">Smart Archives Reloaded</a> Plugin. If it's not active, you're still covered with some basic archive stuff.</li>
	<li>Authors (authors.php): displays all the authors who have capability to publish or edit posts or pages.</li>
	<li>Most Popular (most-popular.php): displays most read articles in all time.</li>
	<li>Most Popular by comment (most-popular-by-comments.php): displays most commented articles in all time.</li>
	<li>Most Popular by month (most-popular-by-month.php): displays most read articles in current month and year.</li>
	<li>Most Popular by year (most-popular-by-year.php): displays most read articles in current year.</li>
	<li>Most Popular last 30 days (most-popular-last-30-days-php): displays most read articles in last 30 days.</li>
	<li>Slider (path-slider.php): Displays Sticky Posts in a slider and some more articles after that. So remember to <strong>use some Sticky Posts to see slider</strong> activated. Theme is using FlexSlider.</li>
	<li>Tag Cloud (tag-cloud.php): Displays Tag Cloud.</li>


<p>Path uses <a href="" title="FlexSlider">FlexSlider</a> in <em>Slider</em> page template and in home page. Only sticky posts are shown in Slider, so if you want to see it in action you need to use some sticky posts. Recommended image size is 660 x 300 (in pixels). It's safe to use WordPress featured image as slider image but it's not necessary if you have attached images in posts. It graps the first one automatically. <code>get_the_image</code> extension is used to do all the magic.</p>

<h2>Action Hooks reference</h2>
With action hooks you can add your custom code in a certain points in the theme. If you open <code>header.php</code> for example you'll
see this line of code: 

<pre><code>&lt;?php do_atomic( 'open_body' ); // path_open_body ?&gt;</code></pre>

It means that you can add your code in that spot  without modifying <code>header.php</code> file. 
You do it using child theme <code>functions.php</code>. Add this inside setup function.

<pre><code>add_action( "{$prefix}_open_body", 'my_open_body_code' );</code></pre>

<p>And this after setup function.</p>

function my_open_body_code() {

	echo 'My code';


<p>Here are all the hooks used in Path theme.</p>

<li><strong>404.php</strong>, <strong>attachment-image.php</strong>, <strong>content-*.php</strong>, <strong>index.php</strong>, <strong>search.php</strong>, <strong>taxonomy-post_format-video.php</strong>
	<li>path_before_entry (not in 404.php)</li>
	<li>path_open_entry (not in 404.php)</li>
	<li>path_close_entry(not in 404.php)</li>
	<li>path_after_entry(not in 404.php)</li>
	<li>path_after_singular (not in 404.php, search.php and taxonomy-post_format-video.php)</li>

<h2>Theme support</h2>

<p>Support for the <em>Path</em> theme is not offered on the WordPress support forums.  There is a community called <a href="" title="Theme Hybrid">Theme Hybrid</a> where support is offered for this theme.  You are encouraged to sign up to the site to use its support forums and become a part of the community.</p>


<p>Path is build on <a href="" title="Hybrid Core">Hybrid Core</a> framework by <a href="" title="Justin Tadlock">Justin Tadlock</a>.</p>

<p>Theme uses</p>

	<li><a href="" title="Google Font">Google Font Abel</a>, which is licensed under <a href="" title="OFL">OFL</a>.</li>
	<li><a href="" title="Flexslider">FlexSlider</a>, which is licensed under the <a href="" title="GPLv2">GPLv2</a> license.</li>
	<li><a href="" title="FitVids">FitVids</a>, which is licensed under <a href="" title="WTFPL">WTFPL</a>.</li>
	<li><a href="" title="Respond.js">Respond.js</a>, which is licensed under <a href="" title="MIT">MIT</a>.</li>
	<li><a href="" title="html5shiv">html5shiv</a>, which is licensed under <a href="" title="GPLv2">GPLv2</a> license.</li>

<h2>Copyright &amp; license</h2>

<p><em>Path</em> is licensed under the <a href="" title="GNU GPL">GNU General Public License</a>, version 2 (<acronym title="GNU General Public License">GPL</acronym>).</p>

<p>This theme is copyrighted to <a href="" title="Sami Keijonen">Sami Keijonen</a>.</p>

<p>2012 &copy; Sami Keijonen.  All rights reserved.</p>

Something went wrong with that request. Please try again.