From iThemes Codex
Jump to: navigation, search

How to set up Covell like the demo site

Note: These instructions are incomplete.

Live Demo

1. Activate Covell child theme

2. Go to Pages -> Add New. Create Pages that should be present in your site.

[Optional] If you would like to import the data in demo site

3. Go to Appearance -> Menus and create a new menu titled Demoñu (copy the menu title text from this page and paste it). Populate this menu with items that should appear at the top navigation.


4. Take a backup of your existing layouts, views and Settings as a safety measure. Go to My Theme -> Settings. Click "Import / Export" tab. Create an export containing existing data (Layouts and Views, Settings).

5. Download Go to My Theme -> Settings. Click "Import / Export" tab. Click Import Data link. Browse to where has been saved and click Import. Select Replace (Note: If you have set up a lot of layouts already, you should Add Layouts instead of Replace) and go to next step.


Click Run Import.


How to make use of the Projects feature

Covell's unique feature is the Projects custom post type.

When Covell is activated, Projects section appears in the dashboard below Posts.


To create a new Project entry, click on Add New.

Enter a title, project description, click on "Set featured image" link and select one, optionally a layout that this project page (single view) should use and hit Publish.


Repeat this for as many projects as you want.

To visit the page that lists all projects, go to Note: Do not create a Page titled "Projects".


Note that projects page has been designed to only show featured images and not content of the projects. Each featured image will link to its project page (single view).

How to display Projects instead of posts on Posts page





Edit theme's index.php.

Add the following above <?php if ( have_posts() ) : ?>

<?php if(is_home()) { query_posts(array('post_type'=>'builder_projects', 'paged' => get_query_var( 'paged' ) ) ); } ?>

How to push single post thumbnail to its own line when the width is small

Add the following at the end of child theme's style.css:

.single-post-thumbnail {
    clear: both;

How to align single post thumbnail to the right of content with text wrapping around

1. Edit theme's single.php.

Cut the following code

<?php if ( has_post_thumbnail() ) { ?>
				<div class="single-post-thumbnail">
					<?php the_post_thumbnail('inside-page-thumbnail'); ?>
			<?php } ?>

and paste it immediately above <?php the_content(); ?>

2. Add the following at the end of child theme's style.css:

.single-post-thumbnail {
    float: right;
	margin-left: 1em;

.single-post-thumbnail img {
	margin-top: 0;

How to add categories and tags support to Projects

1. Edit child theme's functions.php.

Add the following below 'supports' => array( 'title', 'editor', 'thumbnail', 'author'),

'taxonomies' => array('category', 'post_tag'), // To add Categories and Post Tags boxes for this custom post type

2. Now Project Add/Edit screen will have Categories and Post Tags boxes.


3. Download this image, rename it as tag-bg.gif and upload it to your theme's images directory.

4. Add the following at the end of child theme's style.css:

.meta-bottom .tags {
	display: block;
	background: url("images/tag-bg.gif") no-repeat left center;
    font-size: 0.8em;
    padding-left: 25px;

How to display entries of Projects post type instead of blog posts on category pages

Let's say we have 5 posts and 2 entries of Projects post type categorized under "Issues". When Issues category page is visited at say, by default it will show the 5 posts. To make all the Projects entries display here instead of the blog posts, do this:

Copy wp-content/themes/BuilderChild-Covell/archive.php as category.php and edit it.


<?php while ( have_posts() ) : // The Loop ?>


<?php // Modify the default loop, include custom post types
			global $wp_query;
			$args = array_merge( $wp_query->query, array( 'post_type' => array('builder_projects') ) );		
			query_posts( $args );


How to change the slug from 'projects' to something else

If you would like to change to say, edit theme's functions.php.


			'rewrite' => array('slug' => 'projects'),


			'rewrite' => array('slug' => 'onlinestore'),

Now visit If you get Page Not Found, go to Settings -> Permalinks and just hit Save Changes without making any changes.

How to add linked titles above featured images in projects archive page


1. Edit child theme's archive-builder_projects.php.


						<h3 class="entry-title"><a href="<?php the_permalink() ?>" rel="bookmark" title="<?php the_title(); ?>"><?php the_title(); ?></a></h3>						


						<?php if ( has_post_thumbnail() ) : ?>

2. Add the following at the end of child theme's style.css:

.post-type-archive-builder_projects .entry-title {
    margin-bottom: 1em;

How to change the order of the projects on projects archive page

The easiest solution is to edit the published dates on the project entries. Latest appears first (left).

Note: This applies to Covert as well.

How to make Covell Posts and archive pages look like a standard list of posts


1. Replace Covell's index.php with this code.

2. Replace Covell's archive.php with this code.

3. Add the following at the end of child theme's style.css (WP dashboard -> Appearance -> Editor):

.blog .entry-title,
.archive .entry-title {
    margin: 0 0 1em 0;
    padding: 10px 15px;
    font-size: 1.5em;
    line-height: 26px;
    background: #ebebeb url('images/diag3.png') repeat;
    -moz-border-radius: 5px;
    border-radius: 5px;
    border: 1px solid #dddddd;
    float: none;

.blog .entry-title a,
.archive .entry-title a {
    margin-top: 0;
    margin-bottom: 0;
    color: #767c85;
    -webkit-transition:  all .2s linear;
    -moz-transition:  all .2s linear 0s;

.blog .entry-title a:hover,
.archive .entry-title a:hover {
    color: #333333;

.blog .entry-header .entry-meta,
.archive .entry-header .entry-meta {
    border: none;
    padding: 0;
    float: none;
    line-height: 1;

.blog .entry-content,
.archive .entry-content {
    margin-top: 2em;

.blog .entry-footer,
.archive .entry-footer {
    padding-top: 0;

.blog .hentry,
.archive .hentry {
    margin-bottom: 2em;

How to get rid of top space in nav bar when it is below a HTML module

This applies to Covell 2.0.1.

When a Navigation Module is below a HTML module, 1em (12px) space appears at the top of navigation module.

Sample image:

Screen Shot 2013-01-24 at 10.22.57 PM.png

In order to get rid of this unwanted space, add the following at end of child theme's style.css (WP dashboard -> Appearance -> Editor):

.builder-module-navigation {
    padding-top: 0;