eric lightbody

I’m going to show you (you, being the wordpress theme developer or modifier) how to add elements to your blog that will change based on which page you are on. A great example of this is changing which button is on for your navigation to indicate which section is currently active. I will also show you how to get multiple widgetized sidebars rocking for your theme. I’m going to make the assumption that you already know what wordpress pages are and how wordpress can act as a cms. I will also assume you know how to widgetize your theme. Onwards.

Creating multiple dynamic sidebars

Let’s take care of a simple task first, creating multiple sidebars. Normally for a standard wordpress theme you will have this function call to register your dynamic sidebar in your theme’s function.php file:

if ( function_exists('register_sidebar') )
register_sidebar();

That needs to go away. The code below allows you to create multiple sidebars and name each one uniquely. Just simply rename ’sidebar#’ and put in as many sidebars as you like.

if ( function_exists('register_sidebar') ) {
register_sidebar(array('name'=>'sidebar1'));
register_sidebar(array('name'=>'sidebar2'));
register_sidebar(array('name'=>'sidebar3'));
}

Here is an example of wordpress 2.7.1 using multiple sidebars in the widget screen:

There is a catch with this. With multiple sidebars, most likely you are going to want to add the same widget to multiple sidebars. Some widgets allow you to have multiple instances of the widget on your sidebar(s). These widgets have a dropdown box in the admin section that allows you to select how many widgets you would like:

However, most do not. In this case you need to find the php code for the plugin that initializes the widget. You will be looking for the register_sidebar_widget call. For instance, in the delicious cached plugin, I found this function call:

register_sidebar_widget('Delicious Cached++', 'widget_deliciouspp');

All that you need to do is duplicate that line for as many widgets as you need and change the name in the first parameter. My php code now looks like this:

register_sidebar_widget('Delicious Cached++ 1', 'widget_deliciouspp');
register_sidebar_widget('Delicious Cached++ 2', 'widget_deliciouspp');
register_sidebar_widget('Delicious Cached++ 3', 'widget_deliciouspp');
register_sidebar_widget('Delicious Cached++ 4', 'widget_deliciouspp');

Now you should notice your admin interface show multiple instances of the widget like this:

Displaying different sidebars depending what page or subpage you are on

Now comes the fun part. Let’s get those sidebars showing up when you want them to. You’re going to want to add this code to your functions.php file. I won’t explain what it does until the next part (trust me) (also, thanks to Alberto for this post: http://www.altrugon.com/php/get-the-top-parent-page-in-wordpress/)

function getTopParentPostName($myid) {
$mypage = get_page($myid);

if ($mypage->post_parent == 0){
return $mypage->post_name;
}
else{
return getTopParentPostName($mypage->post_parent);
}
}

function is_tree( $p_name ) {    // $p_name = The page we're looking for pages underneath
global $post;       // We load this as we're outside of the post
$top_post_name = getTopParentPostName($post);

if ( $p_name == $top_post_name ) return true;
else return false;
}

Now, normally in order to register a dynamic sidebar for your theme, you just do this in sidebar.php (according to wordpress):

if ( function_exists('register_sidebar') )
register_sidebar();

You will be changing it to something like this where main page title # is your main page title name and sidebar# matches your sidebar names as discussed earlier:

if ( is_tree('main page title 1') ) {
if (!function_exists('dynamic_sidebar') || !dynamic_sidebar( 'sidebar1') ) { $generic_sidebar = true; }
}
elseif ( is_tree('main page title 2')) {
if (!function_exists('dynamic_sidebar') || !dynamic_sidebar( 'sidebar2') ) { $generic_sidebar = true; }
}
elseif ( is_tree('main page title 3' )) {
if (!function_exists('dynamic_sidebar') || !dynamic_sidebar( 'sidebar3') ) { $generic_sidebar = true; }
}

Here is what’s happening: the is_tree call checks to see if the current page or subpage you are on is in the family “main page title #”. If it is, then it registers the appropriate sidebar. That’s it! So, sidebars are cool and all, but what about other elements?

Displaying other elements depending what page or subpage you are on

This part is easy now that we’ve got the sidebars done. Let’s use an unordered list for top navigation as an example. I am just adding a class of “over” to the active menu item. You can see that the is_tree function is called again.

<ul>
<li <?php if ( is_tree('need-a-website') ) echo ' class="over"'; ?>><a href="http://www.google.com">Google</a></li>
<li <?php if ( is_tree('blogging') ) echo ' class="over"'; ?>><a href="http://www.homestarrunner.com/">Is not dead</a></li>
<li <?php if ( is_tree('statistics') ) echo ' class="over"'; ?>><a href="http://www.ericlightbody.com">Coolest website in the universe</a></li>
</ul>