WordPress Hidden Gems: Child Themes

Child themes are modifications of other themes. They have their own directories and you upload them just like a separate theme, but they depend on their parent themes, and they won’t work if the parent is not installed. All your modifications to the original theme will take place in the child theme, so the parent theme remains untouched—and you can update it without wiping out your changes.

Creating a child theme is the best way to modify another theme. However, they’re not all that widely known yet, partially because the WordPress Theme Directory doesn’t yet support them.

Child themes must include at least a style.css file. All other files are optional, even index.php. If a required file is not present in the child theme directory, WordPress will look for the file in the parent theme directory. In other words, you need to create files only when you want to override the parent theme’s display.

To demonstrate how child themes work, I’ll go over my own theme, [link id=”2820″]Cub Reporter[/link], a child of the Journalist theme by Lucian E. Marin.

The child theme’s comment block requires one additional line: the Template. This should be the name of the directory containing your parent theme.

/*  
    Theme Name: Cub Reporter
    Theme URI: http://stephanieleary.com
    Description: A child theme for Journalist, by <a href="lucianmarin.com">Lucian E. Marin</a>
    Author: Stephanie Leary
    Author URI: http://stephanieleary.com
    Template: journalist
    Version: 1.0
    License: GPL
*/
@import url(../journalist/style.css);

Child themes’ stylesheets take advantage of the cascade feature of CSS. The first line of your child theme, after the required comment block, should import the parent theme’s stylesheet. If the parent theme contains multiple stylesheets, you should include them all, unless you plan to replace them with your own.
The beauty of the cascade is that any duplicate style declarations occurring later in the stylesheet will override the original declaration. In a child theme, that means that once you’ve imported the parent styles, you can modify them easily by duplicating the selectors and replacing the style declarations.

Aside from style.css, which is required, you may replace as many of the parent theme’s template files as you like—or none at all, if your changes can be accomplished with CSS alone. Be careful with the theme functions file! If you include one in the child theme, both functions.php files will be executed, so be careful not to duplicate any functions from the parent theme, or you’ll see fatal errors. If the functions in the parent theme have been wrapped in if (function_exists(…)) statements, you can safely replace them with your own, since your theme functions file will be called first. For example, Twenty Ten’s header styles function can be overridden.

// in Twenty Ten’s functions.php
if ( ! function_exists( 'twentyten_admin_header_style' ) ) :
function twentyten_admin_header_style() {
?>
<style type="text/css">
#headimg {
	height: <?php echo HEADER_IMAGE_HEIGHT; ?>px;
	width: <?php echo HEADER_IMAGE_WIDTH; ?>px;
}
#headimg h1, #headimg #desc {
	display: none;
}
</style>
<?php
}
endif;

// in your child theme’s functions.php
function twentyten_admin_header_style() {
?>
<style type="text/css">
#headimg {
	height: <?php echo HEADER_IMAGE_HEIGHT; ?>px;
	width: <?php echo HEADER_IMAGE_WIDTH; ?>px;
}
#headimg h1, #headimg #desc {
	text-indent: -99999px;
}
</style>
<?php
}
&#91;/code&#93;

The <code>bloginfo()</code> function has four possible arguments that will print URLs to the two theme directories. Here's how to get the URLs for parent and child theme stylesheets and directories:


<?php
bloginfo(‘stylesheet_directory’);	// Child theme directory
bloginfo(‘stylesheet_url’); 		// Child theme stylesheet
bloginfo(‘template_directory’);		// Parent theme directory
bloginfo(‘template_url’);		// Parent theme stylesheet
?>

Find all the WordPress Hidden Gems in [link id="2675"]Beginning WordPress 3[/link].