I’ve built several completely custom WordPress themes in he past.  While it isn’t terribly difficult to do if you have a history of developing sites in php, it can seem terribly daunting to someone who hasn’t been buried neck-deep in code before, and even for those who have, keeping track of all the different functions and hooks can be a bit troubling at times.

Wouldn’t it be great if there was a simple to follow tutorial that you could use to get your own theme up and running a little more quickly?  One that covers the basics of building a theme in language that a novice can understand, but is also useful as a reference for those of us who just needed to look something up in a hurry?

The guys at ThemShaper thought so too, and they have published what, in my humble opinion, is probably the single best tutorial on building a WordPress theme ever written.  Their tutorial covers everything from how to set up a test server on your Windows or Mac machine to how to enable threaded comments and add widgetized areas.

While this is a great starter tutorial for those who have never built their own theme from scratch before, it can probably teach those of us who don’t do it daily a thing or two as well.  it’s also a great reference read if you just need to remember a few WordPress calls.

Kudos to ThemeShaper.  not only have they got one of the greatest free WordPress themes ever released with Thematic, but they’re more than willing to help other people craft an awesome theme as well.

You might not have noticed this, but WordPress has one intrinsic flaw that absolutely nobody seems to care at all about; The built-in search.  I suppose that for many people it’s fine just to get a smattering of semi-random results when you look for them, but as someone who has coded search functions and as someone who searches for information regularly, there are several massive problems that present themselves in the off the shelf search algorithm that ships with even the latest version of WordPress and WordPress MU.

The problem is that the search function in WordPress is strictly keyword-based.  It doesn’t look for any real relevance, nor does it weigh any one portion of the results more heavily than another.  For a blog like my food and recipe blog this can lead to results that have absolutely nothing to do with the search terms entered.

In my case, each post links to other, similar posts.  Sometimes these posts reference recipes with similar methods, but that may not include the same main ingredient as the recipe I’ve written.  In the case of a pork dish that references a chicken dish at the end, the WordPress search doesn’t see any reason not to return “Pork Sate” in a search for “chicken”, or in-fact, any post with the word “chicken” in it.  These are returned in chronological order, so the results can be confusing.

The Search Unleashed WordPress plugin solves these issues quickly and simply.  Not only does it give the option for standard wordPress searches (if these are working for you) and an indexed WordPress search (faster), but for full blown MySQL Fulltext or Lucene searching, which return results that you would expect from a mjor search engine.  Right on your WordPress blog

Configuration is pretty simple, as illustrated here:

In short, this is one plugin that you absolutely should install if you want relevant results for searches on your WordPress blog.  setup is nearly painless and even on a blog with a lot of information o index, it doesn’t bring normal operations to a standstill while it’s working, unlike other search plugins I’ve tried.

Check it out for yourself.  Search Unleashed is one plugin that you shouldn’t be without.

The Thematic framework is a robust tool for designers and developers, but before we can even begin to dig in to making modifications we’re going to need to know where to look.  Thematic provides a robust set of predefined CSS selectors and fortunately for our purposes, Deryk Wenaus of Blue Mandala has built a wonderful diagram of the framework as it ships out of the box.

So before we even begin to discuss making changes to our very own custom child theme I think it’s best if today’s post just lays out the structure of the Thematic framework for us.  Take some time to study this diagram carefully against a default thematic layout.  It will be our reference point for any modifications made in the future.

Thematic Page Structure

This is an outline of major elements on a thematic page. It includes most div elements, theme actions and hooks, and widget areas.

Once again I’d like to thank Deryk for giving me permission to use his wonderful diagram as a jumping off point. I’ll be referring to it often as we move through the next few posts.  You may find it very handy too if you’re getting ready to tackle Thematic’s default theme, so feel free to download a copy of the image for your own reference.

If you haven’t heard of WordPress child themes you’ve either been buried under a rock somewhere or, like me, you just don’t keep up with the WordPress developer buzz as well as you should.  Either way, child themes are about to revolutionize the way we develop for WordPress.

Basically put, a child theme is a template that inherits all of the styles and functions of its parent theme.  This allows you to modify a theme to your liking without ever mucking around in the original authors source code (unless you want to) and your changes will not be modified even if a newer version of that heme becomes available.

The bonus here is simplicity and continuity.  you can change a compatible theme until theme unil the cows come home and upgrade to the newest version with the newest, coolest options without ever losing the changes you’ve made to the theme.  For those of us that regularly change header code to point to feedburner feeds or custom trackers this is a mystical and magical thing.

I could spend weeks explaining the details and setting up a parent theme for your perusal, but the work has already been done for us, so let’s start with what’s already working, and working well.

Enter the Thematic Theme Foundation, a parent theme that has all the features any serious blog developer could ever imagine all in one place and just itching to be modified.  Not only is the framework ready to go as it comes, but it ships with a sample child theme, several different default layout files and a ton of other goodies.

We could easily start with the default child theme, but Devin from WordPress Theming has done a lot of our work for us in terms of adding some useful features to thematic with his very own child theme framework that incorporates an options panel and some neat code bites, so why not just start with his example and expand it?

To follow along over the next few days, you’ll need to install both the Thematic Theme Foundation and Devin’s Example Framework.  Both are installed just like normal WordPress themes, but we won’t be working with either directly.

*Note: You’ll probably want to install these themes on a sandbox or development version of WordPress, as thematic is not very visually appealing out of the box.

In the next installment I’ll walk you through a closer look at what Thematic is and how it works, as well as taking a look at what Devin has already done for us in terms of getting options wothy of any premium theme in place. (We all like theme options, don’t we?)  thematic has an awful lot going on, so we’ll have to get a bit technical in the beginning if we want to have a hope of making changes that work the way we’d like them to.

From there we’ll get started modifying the thing to be something far more visually stimulating than we started off with. We’ll put the full power of Thematic’s 13 Widget aware areas to use and tweak the design and layout into something resembling a pro-blogger theme.

If there are any particular topics you’d like me to cover, feel free to leave them in the comments.  I’m just digging into thematic as well, so your interests could help this tutorial move in a direction that’s more useful for all of us.

Until tomorrow;

Peace. I’m out.

If you’re running a WordPress powered blog and like the functionality of the flash image uploader, you might just want to wait to upgrade your Flash Player.  Flash Player 10, which is shipping now causes the flash uploader to break.  There are no fixes at this time.

On the other hand, if you’ve suddenly lost the use of your flash based uploader and the symptom is that when you click the button nothing happens at all… Then you’ve probably already got Flash 10 installed.  Don’t worry, you didn’t break anything, just sit back, use the browser based uploader for a bit and wait for WordPress 2.7, which should be shipping in a few weeks.  From what I hear, they’ve got a fix going in that will get your nice pretty multiple file upload capability back for you.

At least I hope so, because I’m tired of having to upload them manually.

This is the third in a series of articles that will cover making several modifications to the Mimbo 2.2 Theme by Darren Hoyt.  I am modifying the theme to fit the requirements for my own site.  To see the first step requirements and get an overview of what I have planned, please read The first article in the series; Modifying Mimbo 2.2: Step One – Identifying Requirements. For the methods used to modify the way the theme handles output in various places, check the second article in the series; Modifying Mimbo 2.2: Step Two – Modifying index.php. This article focuses on modifying the way Mimbo pulls images for the lead and secondary articles on the main page.

Darren Hoyt's Excellent Mimbo Theme

As I mentioned in the first part of this series, I wanted to change the way Mimbo handles it’s images to better suit my work flow.  By default, mimbo stores it’s main page images under the theme folder in a folder named (appropriately enough) images.  Using this method requires that the user has to find an alternate method of uploading his or her image files, which to me is counter-intuitive.  My solution is to store the images in the standard WordPress manner and upload them using the “Add media” dialog.

This might sound inefficient, but for me, the ability to simply paste the image url into the proper custom field makes things much more pleasant, especially when I’m trying to get several posts knocked out in one session.

The default Mimbo code for the “Featured” image is as follows:

<?php
// this is where the Lead Story module begins
   query_posts('showposts=1&cat=3'); ?>
 
    <a title="Permanent Link to <?php the_title(); ?>" rel="bookmark" href="<?php the_permalink() ?>"><img src="<?php bloginfo('template_url'); ?>/images/<?php
// this is where the Lead Story image gets printed	
	$values = get_post_custom_values("Image"); echo $values[0]; ?>" alt="" id="leadpic" /></a>
 
<a class="title" title="Permanent Link to <?php the_title(); ?>" rel="bookmark" href="<?php the_permalink() ?>">
    </a>

The important piece of code in this instance is in the image call where Mimbo’s creator hard coded the image location:

< img src="<?php bloginfo('template_url'); ?>/images/<?php
// this is where the Lead Story image gets printed

by simply removing the hard coded file location, we can now add our images in the normal way and simply paste the url into the custom fields we’ve created to handle them. In my case these fields were lead_image and secondary_image respectively.

That’s as simple as it gets, script kiddies! with just a few tweaks, you can easily take Mimbo from this:

Darren Hoyt's Excellent Mimbo Theme

To this:

Pretty nifty, huh?

If you’re thinking to yourself… “Hey, there are a LOT of modifications here!” You would be absolutely correct.  Unfortunately these are out of the scope of what I set out to do here, and I’m not going to get into them. Truth be told, I didn’t do anything that difficult, even for a WordPress theme novice.  All of the information you need to get the job done is in the WordPress Codex or on various sites areound the Internet.  There really is no reason for me to go over them again.  I’ll leave it up to you as an excercise in coding.

I do hope that some of the information provided here proves useful to someone.  If so, drop me a comment and let me know!

Happy Coding!

This is the second in a series of articles that will cover making several modifications to the Mimbo 2.2 Theme by Darren Hoyt.  I am modifying the theme to fit the requirements for my own site.  To see the first step requirements and get an overview of what I have planned, please read The first article in the series; Modifying Mimbo 2.2: Step One – Identifying Requirements

Without further ado, let’s dive into the code for Mimbo’s index page and make some changes.

As mentioned in the first article of this series, one of my first requirements is to use category names to pull posts out of the DB instead of the default setup used by Mimbo.  This isn’t a complicated change, but when there is the possibility of category ID’s Changing over the course of a development cycle, it’s one worth making.  To make this modification, we first need to find the section of code that calls Lead Story and modify it to suit our new requirements.

Again, this is where Mimbo shines, since we find the first module right at line 6 of the index.php file:

    <a title="Permanent Link to <?php the_title(); ?>" rel="bookmark" href="<?php the_permalink() ?>"><img src="<?php bloginfo('template_url'); ?>/images/<?php // this is where the Lead Story image gets printed     $values = get_post_custom_values(" alt="" />" alt="" id="leadpic" /></a>
 
<a class="title" title="Permanent Link to <?php the_title(); ?>" rel="bookmark" href="<?php the_permalink() ?>">
 
    </a>
 
    {<a title="Permanent Link to <?php the_title(); ?>" rel="bookmark" href="<?php the_permalink() ?>">More»</a>}
 
<!--END FEATURE-->

Line 8 is the one we need to take note of.

query_posts('showposts=1&cat=3'); ?>

This call uses the query_post() WordPress Template Tag to get 1 post from category number 3. What I want to do is get the category information by name, in this case, I want to display the latest post in the “Recipes” category, so we’ll change it to read as follows:

query_posts('showposts=1&category_name="Recipes"'); ?>

The next call to a category ID is at line 16, where the category title is displayed:

// this is where the name of the Lead Story category gets printed
wp_list_categories('include=3&title_li=&style=none'); ?>

Unfortunately, wp_list_categories does not allow for calling categories by name, But since we’re already specifying the ctegory that we want by name, we can actually eliminate the need for a php call and simply print out the name using standard html, like so:

// this is where the name of the Lead Story category gets printed
?>Recipes

In the case of the project I’m working on I don’t think it’s necessary to print anything at all, since it’s going to be pretty obvious that what the reader is looking at is going to be a recipe, so I’ve made the following changes, starting at line 13:

<!--h3 -->
<!-- /h3 -->

Note: I’ve only commented these lines out in the example so that line numbering is not affected. In my production site, I removed them from the code altogether.

The second change needed to match my requirements is that all posts must show author information and date posted. This is required by several of my advertisers so that they can keep track of the dates that ads and reviews were posted. I really like to keep the people that make me money happy, so I’m going to add it in.

I want the author and date information directly under the title of the post, so I’ll start adding it in at line 19:

Original Code:

// this is where the title of the Lead Story gets printed
the_title(); ?>

And we change it to:

// this is where the title of the Lead Story gets printed
    the_title(); ?>
 
    <small>By   •  • Category: </small>

What we end up with is this:

The layout works, but it's not pretty. It'll look better once images are added and a little css work is done

As you can see, we now have no category title and we’ve got author information posted below the post title using the <small> tag. It’s ugly as heck, but all that will be fixed later when I modify the stylesheet to fit the look that I want. What we’ve got is working, and I call that so-far so-good.

At this point we need to modify the second column to work in the same manner. Since we’ve already covered the changes needed in detail, I’ll just show you the code before and after modification, you should easily be able to spot the changes:

Original Featured Column:

<div id="leftcol">
 
<div class="feature"><a title="Permanent Link to <?php the_title(); ?>" rel="bookmark" href="<?php the_permalink() ?>"><img src="<?php bloginfo('template_url'); ?>/images/<?php // this is where the custom field prints images for each Feature       $values = get_post_custom_values(" alt="" />" alt="" /></a><a class="title" rel="bookmark" href="<?php the_permalink() ?>">
      »</a></div>
</div>
 
 
<!--END LEFTCOL-->

Modified Featured Column:

<div id="leftcol">
 
<h3>Recent Recipes</h3>
 
 
<div class="feature"><a title="Permanent Link to <?php the_title(); ?>" rel="bookmark" href="<?php the_permalink() ?>"><img src="<?php bloginfo('template_url'); ?>/images/<?php // this is where the custom field prints images for each Recent Recipe       $values = get_post_custom_values(" alt="" />" alt="" /></a><a class="title" rel="bookmark" href="<?php the_permalink() ?>">
      »</a>
 
<div><small>By   • </small></div>
 
 
{<a title="Permanent Link to <?php the_title(); ?>" rel="bookmark" href="<?php the_permalink() ?>">More»</a>}</div>
</div>
 
 
<!--END LEFTCOL-->

The only real difference between the first examples is at line 36 of the modified code:

    query_posts('showposts=5&category_name="Recipes"&offset=1'); ?>

Take note of the offset parameter. Since we’re using this column as a continuation of the Recipes category and we’ve already displayed the first, or newest, post in the category, we use the offset parameter and set it to 1. This tells query_posts() to skip the newest post in this category and move on to the next, thus avoiding a duplicate entry.
The other main addition to the original Mimbo code is that I added post excerpts to the second column so that my readers get a glimpse, or teaser, of what the post contains. I’ve found that this can, at times, persuade a casual passerby to move a little deeper into the blog to find what he or she needs, and again adheres to the requirements of some of the companies that pay me to do what I do.
Modifying the third column is much the same as the first two. with just one exception. By default Mimbo uses an array of integers to get the first post in any number of categories specified and display them in that column:

<div id="rightcol">
 
<div class="clearfloat">
 
I just switched the code up a bit to use category names so that all the sections matched:
 
<pre escaped="true" lang="php">// this is where you enter the IDs of which categories you want to display
$display_categories = array("Reviews","Product Spotlight", "Blog Events", "Shopping Alerts", "Blog Spotlight");
foreach ($display_categories as $category) { ?>
 
<div class="clearfloat">

all I did was change the array to hold category names instead of ID’s. After that, changing just the “cat=” parameter to “category_name=” was enough to let the theme do the rest. Easy Peasy!

I think that’s enough to digest for now. In the next article I’ll address modifying the way Mimbo handles images on the main page.

Have fun coding!

The time has come for a major revision to my cooking and recipe blog and I’ve chosen Mimbo to act as the basis for the redesign.  This is the first in a series of articles that will detail the changes I’ve implemented to get Mimbo working the way that I need it to.

There are few WordPress themes that have garnered as much interest as Mimbo 2.2 by Darren Hoyt. Not only is the layout elegant and very functional, the code is commented well enough to allow anything from minor tweaks to major customizations without much trouble at all. This ease of customization is a major component to Mimbo’s success and in my opinion it is also Mimbo’s strongest point.

As with any theme modification, steps need to be taken in advance to know what your requirements are.  In this case, Mimbo’s layout is nearly everything that I want for the new look, but there are some very real changes that I need implemented.  Styling is almost always a more significant time investment, so it’s best to decide early on if the project will have to be switched to another theme. Before worrying about new header graphics of mucking with CSS styles, it’s necessary to map out the core functionality necessary for your specific needs and make sure that everything is functioning in the way that you need it to. This can save hours in development time.

With that in mind, let’s look at the way that Mimbo functions “out of the box”.

Darren Hoyt's Mimbo. As a theme, it's a work of art

Mimbo has four main “Modules” on the index page. (The sidebar has multiple modules, but I’ll focus on those in a later post) Each of these modules displays the latest information from different defined categories in whatever order the blog owner prefers. Let’s look at each in turn and see how the theme author has this laid out.

1. The Lead Story Module: Designed to handle important news, or the most relevant piece of “core content” of your blog.  It puts it right out there in front of the world at twice the width of anything else on the page.
2. The “Features” Module: a chronological listing from the “Featured” category.  Generally the column where important “bread and butter” articles would be featured.  Again this targets your core content, but it’s content of a less immediately relevant nature than the Lead Story.
3. The Right Column Module: The right column module displays the latest article posted in any number of assigned categories.  This is really the feature that puts Mimbo firmly in the “Magazine Style” WordPress theme category, and it is a very powerful tool which shows the casual visitor a brief overview of the topics you’ve been covering.
4. The Sidebar Module: Mimbo’s sidebar contains all of the usual suspects for a WordPress theme. It has Widget support, categories, and recent this-or-that in place right out of the box.  It also has a few custom pieces like another module for displaying very short snippets of site news and advertising space built in, which just ads another level of power to this theme.

If you’re just looking for a theme that looks great and works flawlessly, Mimbo is good right off the shelf.  Unfortunately, it’s almost never that simple. Every blog or website has its own special requirements and even as good as Mimbo is, it’s just not quite what I need at this point.

The first change I need to implement is in modules 1 and 2.  For my needs, both of these modules needs to display information from the same category. They also need to display the date the post was published and a few other bits of information, such as a spoiler (or excerpt) and author information.

Module 3 is already set up much the way I need it, so the basic functionality does not need to change, but there are some formatting issues that need to be addressed. As with Modules 1 and 2, I need the date published, a better excerpt and author information shown on the main page.

In addition, I want to change the way Mimbo handles some of it’s main display functions to better suit my work flow and the fact that I’ll be importing a live site into a test environment more than once during the build process. This could change the category ID’s on me while I’m testing, and that’s just not a great way to play.

In the next installment, I’ll dive into the code changes necessary to accomplish this first round of goals.  Hopefully it will give a better understanding of theme tweaks in general and allow those of you who have always wanted to mess with your theme files to take the leap into true customization.

For my more experienced readers, perhaps it will persuade you to play around with Mimbo and see if it suits your needs as well.

Until next time!

If you’re a long time WordPress user like myself, you may have gotten used to using the  <!– more –> tag to display teaser material in your RSS feeds.  If so, the decision to remove support for this feature in the 2.5 release of WordPress may have had you a bit put off. Since WordPress 2.5, you either had to go with full feeds, (Not good in cases where traffic to your blog = money) or you had to fill in the description field for each and every post.  (Honestly, if I wanted to use Joomla! I would have been doing so already!)

Enter the Better Feed plugin from Ozh.  Not only does this bad boy return you to the stock behavior of earlier WordPress versions, but it allows you to add just about anything you ever thought of to the footer of your RSS feed. How about Post word counts, custom (Read More) text, number of comments, a nice little reminder that you’re running a contest?  You name it, this plugin will do it.

I’ve used several plugins over the past few years that added advertising to my RSS feeds, but none of those solutions was very elegant.  Better Feed makes this process simple.  Each time a new round of advertisements that I feel my readers would be interested in comes through my inbox, I simply append the best of them using the plugin interface, hit save and forget about it until next week.  No more worrying about whether I’ve fubar-ed the code for one of five rotating ad choices or mucking with a management script designed to handle far more than I will ever need on a C-list blog. (I’m working at hitting th A-List, but hey, it takes time!)

There is a bit of a learning curve to Better Feed, but It’s nothing that should send you into a fit.  The tags are pretty straightforward and the editor will be familiar to anyone who has ever edited their comments before.  Getting things to look just the way you’d like may take a bit of time, but you’ll get there, don’t worry.

In the end, I’m listing this as one of my “Must have” WordPress plugins.  I just don’t know what I’d do without it at this point!

Grid Focus Public, by Derek Punsalan is one of the most respected magazine style themes that has been released for WordPress to date. It’s strengths lie in its extreme simplicity and elegance, not only in the way it presents information to the reader, but in the gorgeous minimal code design as well.

Grid Focus Public is definitely a theme tweaker’s dream.  The code for the template is so easy to get through that it’s almost like a vacation to modify.  It’s just that much fun. Want to add something to the sidebar?  No problem.  Change the colors, menus, layout options?  Easy. Change the header, footer or anything else about the template.  A sheer walk in the park. Unfortunately, that simplicity comes with a price.

The price is that Grid Focus Public, even though it’s been updated to work with the newest releases of WordPress without a hitch, does not have a lot of the modern features that one would expect in a theme of this type.  For example, there are no options that can be set via the admin panel. There is no widget support (Though I find this more of a blessing than a curse…  I despise widgets and almost never use them.) and things like automated menus simply don’t exist.  If you want to modify this theme, you’ll have to play with the code or hire someone that can do it for you.

That being said, this theme has gained some pretty avid supporters in the blogging world, and those who do use it are not only happy with it, they sing its praises. Among the evangelical masses are such sites as Skelliewag.org and Anywired, which at first glance appear to use slightly different themes, but the difference is only due to placement and coloration of the headers and a few sidebar items. There is also my site at ADHDFamilies.org, which is currently using a version that is far less modified than I would eventually like to see…  (I know, shameless plug for myself…  Sorry!)

My opinion currently…  If you like the look of the layout and you know your way around a theme.  DIVE IN!  You’ll be happy that you did.  Grid Focus makes life a lot easier.