A guide to the Hybrid theme

Hybrid is a theme framework.

What this means is that the possibilities are endless. It is about rethinking how WordPress themes should work. It looks simple on the outside, but you can do nearly anything with enough creativity. Everyone from first-time WordPress users to advanced developers and designers can take advantage of this theme framework.

Theme Options

Each theme option has been carefully weighed and removed then added again in an attempt to only put things that matter into the WordPress backend. Theme options are about sharing your content with the world.

Every theme option available is there for your convenience, but they won't bloat your site or get in the way of your customization. In fact, you can ignore the options altogether and run your site.


Hybrid comes with a lot of widget options. If used along with a plugin such as Widget Logic, you can have a powerful site with dynamic widgets. All widget areas completely collapse if there are no widgets active, which leaves you with a clean layout without extra markup.

This is the main widget area. Hence, the name Primary. It is typically used as a sidebar and is loaded after the main content in the source code.
Typically used as a sidebar and is loaded after Primary in the source code.
Located in the footer and is loaded before the main footer content.
Utility Inserts
There are several Utility widget sections used throughout the theme to allow for easier customization. These load nothing by default and will not appear in your markup until a widget is added to them.

Hybrid also does a massive overhaul of the default WordPress widgets. You'll be presented with more options than ever before and can use most widgets an unlimited number of times. Talk about true power over your WordPress-powered site.

Page Templates

This framework is packaged with loads of useful page templates. Page templates change the way a page displays or functions depending on the particular template you've chosen.

By default, this template will show your category and monthly archives. To overwrite this, you can activate one of three plugins: Clean Archives, Smart Archives, or Smarter Archives.
The Authors template will list each of your authors (in order of display name) with the biographical information from their user profiles along with a spam-protected link to their email address. Only authors with posts are shown.
The Biography template will set the page author's information at the top of the page (from author's profile). It's a good way to start off a single-author blog's about page.
If you don't use a blog-based front page, this template is useful for setting up an alternate blog page. It will show the number of posts set in your reading settings.
Will produce an unordered list of your bookmarks by default. Alternately, you can install the Hot Friends plugin, which will overwrite the default setting.
The Categories template will list your categories along with their post counts and RSS feed links. Activating the No Widget Category Cloud plugin will overwrite the default settings.
Logged In
This template will allow you to show custom content to only logged-in users. For users without permission to see the content, a link to log in and a link to register (if registrations allowed) will be displayed.
Log In
With this template, you can create a custom log in page. You won't have to send your users to the wp-login.php page that looks nothing like your site anymore.
No Widgets
For use on pages where you don't want any widgets displayed.
This page template allows users to update their profiles without having to go to the dashboard.
The Register template allows you to have a custom registration page that looks and feels like the rest of your site. New users will no longer have to visit the WordPress admin-styled wp-register.php page.
The template gives you a complete XHTML sitemap with links to every page, post, and archive on your site.
The Tags template will show a tag cloud of all your site's tags. You can also overwrite this by installing the Configurable Tag Cloud Widget.
The Widgets template is completely widgetized. Basically, you can do anything you want with it. You could even create your own custom home page with just widgets.

Child Themes

When I call Hybrid a theme framework, I mean it. It is meant to be used as a base theme to build from. What this allows us to do is extend it through child themes.

Yes, you can create your own theme. Even if you're a total noob to WordPress!

Just create a new theme folder in your /wp-content/themes directory. Call it something like My Hybrid or some other much cooler name. So, you'd have a directory like /wp-content/themes/my-hybrid. Then, create a style.css file within your theme folder. At the top, add this information:

Theme Name: My Hybrid
Theme URI: http://link-to-your-site.com
Description: Describe what your theme should be like.
Version: 0.1
Author: Your Name
Author URI: http://link-to-your-site.com
Tags: Add, Whatever, Tags, You, Want
Template: hybrid

Now, you have your own theme! Of course, you might want to style it.

Here are a few stylesheets that will help you get started. Just add this to your new style.css file.

/* Get base 21px CSS */
@import url('../hybrid/library/css/21px.css');

/* Get the plugins CSS */
@import url('../hybrid/library/css/plugins.css');

/* Get the dropdowns CSS */
@import url('../hybrid/library/css/drop-downs.css');

/* Get default Hybrid CSS */
@import url('../hybrid/library/css/screen.css');

The 21px.css resets all browser defaults, gives you 21px margins, and sets up some nice typography for you to start with. The plugins.css sets some default styling for supported plugins. The drop-downs.css gives you some base styling for drop-down menus. The screen.css is the default theme CSS that you can overwrite.

Theme Support

The most authoritative source for finding out how to use the theme or do some nifty stuff is the theme documentation. I'll constantly update it with tutorials and frequently asked questions.

We also have a vibrant community at the Theme Hybrid Support Forums. If you ever lose the link, you can find it right from your Hybrid Settings page in your WordPress dashboard.

Built-in support for plugins

Frameworks & Other Code

Hybrid owes a lot of thanks to several CSS frameworks and code other people have worked hard at putting together. The default styles and extra stylesheets take ideas and code from many different frameworks and stylesheets. Video attachment handling is done via Flowplayer.


I don't know if I can come close to naming all the people that should be credited, but I'll list some of the main folks.

Copyright & License

Hybrid is licensed under the GNU General Public License, version 2 (GPL).

This theme is copyrighted to Justin Tadlock and Theme Hybrid.

2008 © Justin Tadlock