Carrington 1.3 has been released

If you pay attention to your WordPress Dashboard (I notice mine every 2-3 days), you might have seen that version 1.3 of Carrington has been released. Carrington is the theme I use for SilverPen Publishing, but it’s more than a theme: Carrington is a unique shift in theme framework development and finds itself in a significantly more advanced category than your standard WordPress theme.

Simply put, it’s all kinds of wonderful, and I’ve really enjoyed having its style represent SilverPen Publishing. However, I have had to make a few tweaks to the theme, and when faced with an upgrade, I was hesitant to recommit myself to that task. All of those changes would have to be made once again, and I didn’t take notes on what I had edited because I didn’t think I’d have to do it again any time soon, let alone with this theme.

Most theme publishers write a theme, put it out for public consumption, and leave it. I never expect upgrades of a theme unless a major change in WordPress outright breaks the theme, and even then it doesn’t get upgraded most of the time. Alex King‘s a champ, though, and stands by his work. If I could laud him any more highly I would, but for now my praise and recommendation will have to be sufficient. Such dedication caught me by surprise though, hence the lack of notes.

Because there were some important security upgrades in this version, I went ahead and upgraded after backing up my current theme, and then spent some time going through and changing what I needed to. In addition, I actually took notes this time as I went, and I’m going to go ahead and post them here. As I read in someone else’s blog recently, notes for me, notes for you.

Reasons to upgrade:

From Alex King’s blog:

Version 1.3 of Carrington Blog is now available for download.

Upgrading is strongly recommended due to a security patch in this release.

This version has a couple of changes – both bug fixes and new features:

  • Added an image.php file for displaying media. This is not yet abstracted into the framework, but will be in the future.
  • Added a field to the settings page for adding in analytics code.
  • Fixed a problem with IE7 and the dropdown menus.
  • Explicitly send headers with AJAX responses, hopefully fixes some issues reported by Safari users.
  • Added a Log In link to the header.
  • Added code to load in translations.
  • Updated documentation.

Changes I make:

Header

Kampyle

I add my Kampyle code, which provides the feedback button you can see at the bottom right of your browser window.

Breadcrumbs

I replace the categories code in the header with code from Yoast Breadcrumbs. Though I keep the categories styling (div id=”all-categories”), I do delete the span that gives it the “Categories:” prefix to the line. Yoast Breadcrumbs supplies its own prefix, so I don’t need on typed in there.

In addition, I need to edit the CSS for this div tag to remove the wrapping, otherwise the breadcrumb will be placed on a separate line than the search box in some instances. To do this, go into the css and change the following:

#sub-header #all-categories {
float:left;
margin-top:3px;
width:740px;
}

to:

#sub-header #all-categories {
float:left;
margin-top:3px;
}

Register/Login

I really liked, in the last version of Carrington, where it had smaller Register/Site Admin links that changed dynamically depending on your current state in the header at the top right. The new version puts those on the same level and styling as the Pages at the top, and I really disliked that, so I restored that code from the last version of Carrington.

As Alex pointed out, this isn’t really necessary. I have reverted this change, though I have noticed that the “logout” link that now appears in the header when logged in does not work. Hopefully the next version of Carrington (releasing sometime after WordPress 2.7 comes out) will fix this.

To do this, just replace the current login code:

                <!-- #navigation -->

with the following:

                <!-- #navigation -->

In addition to this, I needed to add the following code to the new CSS file from the old one to give these links the proper styling:

#navigation li.wp-register {float:right;}
#navigation .wp-register a,
#navigation .wp-register a:visited {
    font-weight:normal;
    margin-right:0;
    text-transform:none;
}

About

This version of Carrington added a way to edit the “About” text via the theme administrative panel. Unfortunately, it saves this text as a post, which means that my Simple Tags plugin automatically adds “Related Posts” to the end of it. Not what I want to see in my About panel at the top of the sidebar.

So, I edited this text in the sidebar/sidebar-default.php, replacing the following code:

<?php
    echo $about_text;
?>
        </div>
    </div><!--.widget-->
<?php
}
?>

With this:

        
           

SilverPen Publishing is the personal website of Matthew Stublefield and is focused on self-publishing, be it simple blog entries or entire books. Though we don’t have any printing presses of our own, all work is published online and freely distributed under a Creative Commons license.

More →        

Banner

In the single/single-default.php and the posts/home.php files, I added a Banner (right now, it’s for Child’s Play Charity) to be displayed at the top of the main page, just above the content, and on single posts. I also added the following code to the CSS file to align it correctly:

.banner {
        text-align: center;
        padding-top: 18px;
}

“…reply to post via trackbacks”

In forms/comment.php, there is an unnecessary comma that is displayed just to the right of the Submit Comment button, so I edit this file to delete that comma.

Footer

I delete out the PHP related to generating a logo and other text and replace it with my own, as you can see below. I keep the “generator-link” paragraph ID, though, to maintain that styling.

Conclusion

Hopefully, by making some notes, it won’t take me as long in the future to get all this set. Thanks again to Alex King for his wonderful work on this theme!

4 thoughts on “Carrington 1.3 has been released

  1. Thanks for the kind words. Regarding this item:

    The new version puts those on the same level and styling as the Pages at the top, and I really disliked that, so I restored that code from the last version of Carrington.

    If you force-reload your page your browser will get the latest CSS which give them the same treatment as version 1.2.

    Hope this helps.

  2. Thanks for the tip, Alex. While trying to fix the “About” box in the sidebar, I went ahead and reverted this change. Now, if I could only get my “About” information to show back up…

Leave a Reply

Fill in your details below or click an icon to log in:

WordPress.com Logo

You are commenting using your WordPress.com account. Log Out / Change )

Twitter picture

You are commenting using your Twitter account. Log Out / Change )

Facebook photo

You are commenting using your Facebook account. Log Out / Change )

Google+ photo

You are commenting using your Google+ account. Log Out / Change )

Connecting to %s