Difference between revisions of "Builder Frequently Asked Questions"

From iThemes Codex
Jump to: navigation, search
m (Method 1)
m (Method 1)
Line 118: Line 118:
<!-- Begin changes -->
<!-- Begin changes -->
<div class="alignmiddle">
<div class="alignmiddle">
<p><a href="<?php bloginfo('url'); ?>">Home</a> | <a href="<?php bloginfo('url'); ?>/privacy-policy/">Privacy Policy</a> | <a href="<?php bloginfo('url'); ?>/terms-conditions/">Terms & Conditions</a></p>
<p><a href="<?php bloginfo('url'); ?>">Home</a> | <a href="<?php bloginfo('url'); ?>/privacy-policy/">Privacy Policy</a> | <a href="<?php bloginfo('url'); ?>/terms-conditions/">Terms &amp; Conditions</a></p>
<p><?php echo date( 'Y' ); ?> - Copyright &copy; All Rights Reserved</p>
<p><?php echo date( 'Y' ); ?> - Copyright &copy; All Rights Reserved</p>

Revision as of 07:08, 1 March 2012


Most Frequently Asked Questions

Where can I learn about the basics of how Builder works?

Please start here: http://ithemes.com/builder-basics-training/

What are child themes? Should I use a child theme?

It is a good idea to use a child theme (of Builder) as your active theme and not Builder directly. This will protect any modifications and customizations you might have done from being erased when you upgrade Builder.

To learn how to do this, go to: Child Themes Introduction Child Themes Tutorial

Screenshots of the available child themes for Builder

Activated a child theme. How come my site does not look like the demo site?

To get a Builder site with a child theme active to look like the child theme's demo site, it has to be built by way of arranging layouts, modules, widgets and in some cases, editing style.css.

When a child theme is activated, the site will NOT look like the demo site out of the box.

When we create the demo sites, we make no adjustments to any .php or .css files within the theme. The only adjustments we make are within the WordPress dashboard. Like with all themes and child themes (both iThemes and other companies), every site need a little set up. For example, one will need to add some pages, write some posts, create menus, etc. In other words, every site need content. There is no way any theme can do all of these things for customers.

For Thinner child theme (as an example), if one writes some posts, sets a post thumbnail for seven or more of those posts, and selects the slider extension in his/her layout (My Theme > Layouts & Views) that points to his/her main blog, he/she will find a comparable layout as the Thinner home page.

As one can see, there is no way we can provide content for a customer. However, if one takes the time to set up WordPress and add default WordPress items, he/she will see that our child theme demos do represent what a child theme would look like when on a site with content.

If time permits, we will provide instructions on how to create a layout similar to the demo.

Example: This link has instructions on how a Builder site with Americana child theme can be made to look like its demo site.

Use a static page as front page

Q: I want to have a static page as front page (i.e., at www.mysite.com) and the blog posts to appear at another page, say www.mysite.com/blog. How do I do this?

  • Go to Settings -> Permalinks and set the permalink structure to something like /%postname%/
  • Create two empty pages (with no content in them) titled Home and Blog.
  • Go to Settings -> Reading. Under Front page displays, select "A static page (select below)", choose Home for Front page and Blog for Posts page. Save changes.

Apply a layout to the Posts page

Q:I have created a layout for my Posts page. How do I apply this layout to the Posts page?

A: Go to My Theme -> Layouts and Views. Click on Views tab, then Add View and associate Blog view with the layout you have created for the Posts page.

All the pages are getting re-directed to front(home) page

  1. Ensure that the default layout has a content module. It is a common occurrence to construct site's home/front page layout with just widget bars, HTML modules etc. and leave it as default. The layout used for Pages, posts, archives, search, category pages etc. must have a content module or else, there will be no place for the content to show up in. Therefore, it is highly recommended that default layout has content module.
  2. If you using some sort of Redirection plugin, check its settings/deactivate it (for troubleshooting)

Is it possible to have a 100% full width modules in Builder?

It is possible to have 100% fluid modules using by editing theme's functions.php. Click here for details.

When using the above method, to specify 100% width to more than 1 module see this forum thread and this.

You might also want to check out http://vanweerd.com/how-to-add-full-width-header-and-footer-to-the-builder-theme/

How do I display post excerpts as opposed to the full posts in my Posts page?

Edit your active theme's (should be a child theme of Builder) index.php. (Note: for the Acute theme, edit content.php).

Replace a line similar to

<?php the_content( __( 'Read More→', 'it-l10n-Builder' ) ); ?>


<?php the_excerpt(); ?>

Note: To do the same for other views like category pages, edit the appropriate template file - archive.php, in this case. See http://codex.wordpress.org/images/1/18/Template_Hierarchy.png

If you would like to control the number of characters to appear in excerpts and change the cut-off character from "..." to something else, you might want to use The Excerpt re-reloaded or Excerpts Deluxe or Advanced Excerpt.

Also see http://codex.wordpress.org/Function_Reference/the_excerpt

How do I display full posts as opposed to post excerpts in my Posts page?

Edit your theme's index.php. (Note: for the Acute theme, edit content.php).


<?php the_excerpt(); ?>


<?php the_content(); ?>

How do I edit the footer?

Method 1

Make a copy of footer.php from parent Builder directory, edit it and place in your child theme's (active theme) directory.

Video and detailed instructions

Examples of customized footer.php: 1

If you would like to have a footer.php that looks like the screenshot below as starting point to use as is or further customize, download this zip file, extract it and upload footer.php to your child theme directory.

Screenshot showing customized footer - Click to enlarge

This is the code in footer.php just in case the download link does not work:


function render_footer() {
	<!-- Begin changes -->
	<div class="alignmiddle">
		<p><a href="<?php bloginfo('url'); ?>">Home</a> | <a href="<?php bloginfo('url'); ?>/privacy-policy/">Privacy Policy</a> | <a href="<?php bloginfo('url'); ?>/terms-conditions/">Terms & Conditions</a></p>
		<p><?php echo date( 'Y' ); ?> - Copyright © All Rights Reserved</p>
	<!-- End changes -->

	<?php wp_footer(); ?>


add_action( 'builder_layout_engine_render_footer', 'render_footer' );


In the above replace © with & c o p y ; without the spaces.

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

.alignmiddle {
	text-align: center;

Method 2

To remove the credit to iThemes Builder (but leave the standard copyright notice, powered by WordPress etc.) you could also include this function in your child theme's functions.php:

add_filter( 'builder_footer_credit', 'custom_builder_footer_credit' );

function custom_builder_footer_credit( $footer_credit ) {
    $footer_credit = 'Powered by <a href="http://wordpress.org">WordPress</a><br />Customized by <a href="http://me.com/">Myself!</a>';
    return $footer_credit;

Ensure that line numbers are not present in the code in functions.php.

See http://www.screencast.com/t/R2hJBzCRk and http://www.screencast.com/t/ZajvGiQGo

Source: http://ithemes.com/forum/index.php?/topic/12687-edit-footer/#p59955

How to backup and restore a WordPress site that uses Builder

The standard method of backing up database, editing the resulting .sql file to do a find and replace of source and destination URLs, importing the modified .sql to the new server and then uploading the files will not work in case of Builder sites.

BackupBuddy is the only solution that lets you completely backup and restore a Builder site. For a discussion on the reason behind this, see post # 8 at this forum thread.

How to add a custom favicon

Upload favicon.ico file to your child theme's images directory. Ex.: wp-content/themes/BuilderChild-Foundation/images

Tip: There are services like this and this which lets you upload a regular image (jpg, png, gif etc.) and convert them to a .ico file.

How to upgrade Builder?

See How to upgrade Builder

How to fix "Fatal Error: Class 'ITStorage2' not found"

This happens because of upgrading Builder without first updating the associated plugins like Style Manager and SEO plugin.

This could have been avoided by following the instructions we provided on how to upgrade Builder here.

To fix the issue,

  1. Connect to your web server using either the file manager in cPanel of your hosting account or a FTP client.
  2. Download the latest versions of Style Manager (if you are using this plugin) and Builder SEO plugin (if you are using this plugin) zip files from your Member Panel.
  3. Extract the contents of these plugins (whichever is being used i.e., present at wp-content/plugins) and upload them to the corresponding directories in wp-content/plugins overwriting the existing ones.

How to upgrade Builder when a child theme isn't being used?

It is always good to use a child theme of Builder as the active theme and not Builder directly. This will avoid custom changes to the theme files from being overwritten by the upgrade.

If you were not aware of this and have been directly using Builder as the active theme and would like to now upgrade to the latest version, follow this approach:

  1. Take a full backup of your site using BackupBuddy. If purchasing BackupBuddy is not an option, take a backup of wp-content/themes/Builder directory and WordPress database (using phpMyAdmin or otherwise) at the least.
  2. Make a note of all file changes (modifications and new additions) inside Builder directory. Usually modifications will be done to templates like index.php, single.php, archive.php and style.css.
  3. Upload the latest default child theme to wp-content/themes. It can be downloaded from member panel.
  4. Apply all changes that were noted in step 2 in wp-content/themes/BuilderChild-Default
  5. Upgrade Builder to the latest version by following the steps in http://ithemes.com/codex/page/Builder_Documentation#How_to_upgrade_Builder
  6. Activate the child theme.
  7. Check your site and fix anything that is amiss. If there are any links whose URLs point to files inside Builder directory, they may have to be changed to point to the child theme directory.

How do I add search at the right side of my nav bar?

Method 1

Pre-requisite: WordPress 3+, Builder 2.4.10+

Rather than using the navigation module, add an HTML module where you want the navigation to appear

  • add the following content to the textbox (assuming your menu is called "menu1", change of course if needed):
<div id="nav_container">
<?php wp_nav_menu( array( 'menu' => 'menu1', 'menu_class' => 'builder-module-navigation') ); ?>

<div class="search_in_nav">
   <?php get_search_form(); ?>

  • save the html module, select no sidebars, and enable PHP,
  • save the Builder layout
  • add the following code to your stylesheet:
#nav_container {
    height: 34px;
    display: block;
    width: 100%;
    background: #FFFFFF url('images/nav_bg.png') repeat top left;

.search_in_nav {
    float: right;
    display: block;
    width: 250px;
    height: 24px;
    padding: 0px 5px;
    margin: 0px;
  • play around a bit with the margins and paddings, heights and widths.

Note: This method can also be applied to place a image or RSS feed or any HTML in the nav bar.

this topic on the forum

Additional Resource 1, Additional Resource 2

Method 2


At Appearance -> Editor, templates like footer.php do not appear

See this and this.


When Builder is being installed, if the following appears

Installing Theme from uploaded file: Builder.zip

Unpacking the package…

Incompatible Archive. PCLZIP_ERR_BAD_FORMAT (-10) : Unable to find End of Central Dir Record signature

it means that the zip file is corrupt. Try re-downloading it using another browser.

From our observation, this is happening only on Macs. So if you have a spare Windows computer, try downloading Builder again from PC.

How to center my navigation menu


How to assign a layout to all posts belonging to a specific category

No view exists which can be used for all single post pages belonging to a particular category.

There are design questions that need to be addressed before implementing such a view. What will happen if a post belongs to multiple categories? In such case suppose the user sets a view associating all posts from Category A and another one for all posts from Category B, and if a post belongs to both the categories there will be conflicting views which leads to the question: which layout should be applied for that post's single page?

The only way currently is to edit each post and set the layout manually.

Forum topic on this: http://ithemes.com/forum/topic/17616-layout-for-single-post-page-of-only-one-post-category/

Update: There now is a fairly straightforward solution for this

Chris has come up with a code snippet that needs to be placed in functions.php which allows you to specify a specific layout using specific conditions.

function custom_filter_category_layouts( $layout_id ) {
    if ( is_single() && in_category( 'news' ) )
            return '4e5f997043d8e';
    return $layout_id;
add_filter( 'builder_filter_current_layout', 'custom_filter_category_layouts' );

The builder_filter_current_layout filter runs after the Layout selection process has finished and allows custom code to have the final say on what Layout is used. The example code will force the current Layout to be the one with an ID of "4e5f997043d8e" if the site is currently showing an individual post that is in the "news" category. If this condition isn't met, it returns the current Layout ID so that it doesn't change any of the other portions of the site. This can be modified to use any category and any Layout ID.

To find the ID for a Layout, go to the Layouts listing, copy the edit link for the desired Layout, paste the link somewhere, and grab the text after the last equal sign. For example, consider the following link:


The Layout's ID is 4e5f997043849.

To use the code, simply add it to your child theme's functions.php file."

See also: http://ithemes.com/forum/topic/22220-assigning-a-layout-for-post-page-by-category

Less Frequently Asked Questions

How do I disable comments on all Pages?

Use the no comments on pages plugin

I want to get rid of the text "Comments are closed" at the bottom of the content

Add the following to your theme's style.css:

.nocomments {
   display: none;

Uploaded images do not appear

1. Ensure that the image is saved in the right format (extension). For example, if a png file is incorrectly saved as .jpg, then it won't work. Two ways of checking this is opening the image in a) Photoshop b) Irfanview.

2. In your WP dashboard go to "Media" under "Settings" in the left column. Ensure that the path defined for uploads folder is "wp-content/uploads". See also General FAQ.

3. Check to see if GD image library support is enabled in your hosting. This can be checked by saving the following as a php file, say phpinfo.php and accessing it from the URL like yoursite.com/phpinfo.php.

<?php phpinfo();?>

Tip: While uploading an image in image module if you want a fully wide image (i.e., no sidebar) ensure that image width is the same as that of layout. Also specify the exact image height in the module's settings. This will avoid the image from getting stretched disproportionately.

I am unable to drag and drop widgets onto the sidebar

Add Module shows a blank window

Q: When I go into My Theme, Layout, Create Layout then choose Add Module, a blank window comes up and just seems to hang there.

A: Deactivate FCKEditor plugin.

Is it possible to have vertical navigation?

See this video, the content of interest starts at 07:38 in the video

Pages and/or Categories widget can be used in the sidebar of any widget.

Other solutions:

The theme you are currently using isn't widget-aware

Q: I can't put any widgets in the theme and keep getting this pop-up "The theme you are currently using isn’t widget-aware, meaning that it has no sidebars that you are able to change. For information on making your theme widget-aware, please follow these instructions."


  • Go to the Appearance > Widgets page
  • Click the Screen Options tab towards the top-right of the page
  • Click the "Disable accessibility mode" link

See also this Support forum thread

How to I remove the space at the top of the page

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

.builder-container-outer-wrapper {
    margin-top: 0;

The last image in billboard appears below compared with the others

To fix this, add the following at the end of your theme's style.css:

.ithemes-billboard :last-child {
    margin-bottom: 1.5em !important;

How do I get notified by email whenever there's a Builder update?

Updates to Builder Release Notes page can be tracked via its RSS feed. We can use a service like Feed My Inbox to have this RSS feed delivered to your email inbox automatically.

array_merge() warning

When a child theme of Builder is activated, if a warning similar to the one below appears on the site

Warning: array_merge() [function.array-merge]: Argument #1 is not an array in ..\themes\Builder\lib\layout-engine\sidebars.php on line 264

the fix is to reset the theme.

Go to My Theme -> Settings. Click Reset Options button.

Author link contains spaces

For description of the problem and the solution, visit this forum post.

Make parent navigation item not clickable

Q: I want to create a menu item in the navigation (page defined nav) that has child pages but this menu item shouldn't be clickable.

A: Check this forum post or you can use a plugin, such as the page lists plus plugin

How to remove bullets above tabs in Tabber Widget widgets

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

ul.tabber-widget-tabs {
    list-style: none;

How to show blog posts at site's front page (/) as well as at another Page (/blog)

  1. At Settings -> Reading, ensure that Front page is set to display latest posts. This is the default setting in WordPress.
  2. Create a new Page (or edit an existing one) named say, Blog, ensure that it is blank, set the Template to Blog Template and publish/update it.
  3. [Optional] If you would like to apply a layout to front page, go to My Theme -> Layouts, create a layout (or duplicate existing one) for it, go to Configure Views, Add View and add associate Home view with the layout created for front page.
  4. [Optional] If you would like to apply a layout to Blog page, edit the Page and select your desired layout from Custom Layout meta box.

How to disable Builders built-in SEO functions

In your WordPress backend, go to My Theme -> Settings and set 'Would You like to use post tags as META keywords on single posts?' to NO (Yes is the default).

Then add the following code your child theme's functions.php as described.

// Remove Parent themes SEO
function remove_seo() {
    remove_action( 'builder_add_meta_data', 'builder_seo_options' );

add_action('init', 'remove_seo');

See also this support forum thread

What is the recommended way to edit theme templates like index.php and archive.php?

See this forum post

How to change the name of a child theme?

Follow this example.

Does WordPress 3.0 menu system work in Builder?

Oh yes! Even before the WordPress 3.0 menu system's final version got released. Then what about this message "Your theme supports 0 menus. Select which menu appears in each location."?, you may be asking. Well, just ignore it. Go ahead and create your menu at Appearance -> Menus, then edit your layout and in the navigation module's settings, select "Custom Menu - name".

You might want to watch WordPress 3.0 Menus Demo Video on iThemes Builder.

Where is functions.php?

One should never make changes in functions.php inside parent Builder directory. functions.php in child theme directory should be the one to make changes in. Some child themes will have functions.php and some don't. If this file is not present in child theme directory, create a new file named functions.php, place opening (<?php) and closing (?>) PHP tags, save and upload it to child theme directory using a FTP client. Alternately cPanel's file manager also lets us create files on the server.

Here is how a sample fresh functions.php file looks like:



Any code that we advise you to add in functions.php must be added before the closing PHP tag.

Which Builder themes are mobile compatible?

With Builder, any of our child themes could be used as mobile themes simply by setting up your layout to be more narrow like the size of the iPhone screen.

Here are a few things to consider with mobile themes though:

Load times are slow, so you will want to use a theme that doesn't have many images to load. Any of the Foundation themes are a good example of this (among others).

None of our existing child themes have any gesturing built in to them, so some of the gestures that are very useful on the iPhone won't exist in child themes.

We do offer the Mobile plugin, which comes with a set of themes and a simple style manager that will allow you to match the colors of your mobile theme to the colors of your standard theme. You should have access to the Mobile plugin in your member area.

What are the minimum requirements for running Builder

The same as those needed for running WordPress 3.2 namely: at least php 5.2.4 and MySQL 5+.

More info: http://ithemes.com/forum/index.php?/topic/15708-minimum-requirements-for-builder-theme/

How to setup a server on your computer, develop Builder sites locally and migrate them to another location

If you are on Windows:

  1. Install XAMPP.
  2. Set C:\xampp as the installation folder, now your localhost root will be in "htdocs" folder inside C:\xampp.
  3. [Optional] Set a password for MySQL.
  4. Download WordPress, extract the zip file and copy/move 'wordpress' folder inside C:\xampp\htdocs. Rename 'wordpress' folder to whatever is the name of your project.
  5. Install WP manually.
  6. Set up Builder.
  7. Once it is all ready, use BackupBuddy to do a full backup. The generated zip file should be in wp-content/uploads. Download importbuddy.php.
  8. To learn how to restore the site to another location, watch the video here.

If you are on Mac, install free version of MAMP by following this video. Do from step 4 (the root folder on Mac will differ) onwards listed above. I have set "Sites" inside my user directory as the root.


Screen shot 2011-07-23 at 9.24.59 AM.png

Can Builder be used to create a fluid/responsive site?


Builder uses px or em based containers (i.e., content size is "absolute" in pixels, not relative to the width).

Click here for an explanation.

I installed my Builder powered WordPress site at site.com/wordpress. How do I move it to site.com?

Follow this.

Forum topic.