Please help support the continued development of AZIndex, particularly if you are using the plugin in your work or as part of a for-profit website. All contributions, no matter what size, will be gratefully received.

Tweaking Themes the Plugin Way

How many WordPress users install a brand new theme for their blog and never feel the need to tweak it in some way?  Not many, I’d wager.  While there are many great themes out there, there’s almost always something that’s not quite right for your blog.  Perhaps the blog title is too big, or something in the sidebar doesn’t look quite the way you want it to.

And so it’s off into the theme files you go—fumbling around with functions.php, header.php, and style.css, until you get it the exactly the way you want your blog to look.  I should know, I’ve never met a theme I didn’t want to tweak in, oh so many ways. (That doesn’t make me a person, does it?)

Anyway, there’s usually no real harm in tweaking a few theme files now and again, until you find out that there is a new version of the theme, with even more bells and whistles that you are just dying to try out.

Fine.  Just a quick download and… uh oh… you just overwrote all that painstaking work you did to get the previous version looking just right.  Even if you did remember to back everything up the first time, there’s still a good chance that you’ve forgotten where you put all the little modifications and tweaks you made.  I know of what I speak!

So, is there a better way?  Of course there is, otherwise what would be the point of this article?  For many of the theme tweaks you want to make, you can use a plugin instead of attacking the theme files.

“A plugin?” I hear you gasp.  “But aren’t they all hundreds of lines of code written by those geeky programmers?”  Well, yes they are, for the most part, but there’s no reason why a plugin can’t contain just a few lines of code to do something really useful.  In fact, I’m about to show you a plugin you can use with any theme that’s only six lines long (excluding all those comments that clutter up the place).

Consider how many times you want to add some more CSS styles to your theme’s main stylesheet (style.css) or maybe tweak the values that are already in there.  Unless you are extremely conscientious about comments, you will soon forget which values you added or changed.  It would be much better if you could consolidate all your changes in another CSS file (e.g. my-style.css) that you know will never be overwritten.  You can certainly do this by modifying the header template of your theme and including a <styles> tag, but even that modification should not be necessary.  You can use a plugin instead.

And here’s the code:

add_action('wp_head', 'my_add_headers');

function my_add_headers() {
   if (file_exists(get_stylesheet_directory().'/my-style.css')) {
      echo '<link rel="stylesheet"href="'.get_stylesheet_directory_uri()
           .'/my-style.css" type="text/css" />';
   }
}

That’s all there is to it.  The function my_add_headers() checks to see if there is a my-style.css file in the current theme’s folder, and if there is one, adds a link to it into the HTML header section of your blog page.  So the code works fine whether or not you decide to create your own stylesheet file.

The magic to make this happen is in the first line.  The add_action() function call “hooks into” WordPress just after it has generated all the HTML headers your blog needs for displaying a page.  (WordPress has dozens of  these “action” and “filter” hooks that can be used to inject your own code and HTML into a blog page.)

The one we are using here is the wp_head action which, as the name suggests, is invoked just before the </head> end tag is added to the HTML going to the browser.  This is an excellent place to hook in your own stylesheet file without having to change any existing theme files at all.

The great thing is that this will work for any theme you use.  Anytime you switch to a different theme, all you have to do is create another my-style.css file in that theme’s directory (or copy an old one over) and you’re done. No more messing about with theme files.

Now all that’s left to do now is to bundle this code up into a plugin, so that WordPress will recognize it properly.  That’s pretty easy too.  Just add the following comment lines to the top of the file:

/*
    Plugin Name: My Tweaks
    Plugin URI: none
    Description: Customize the theme without modifying any template files
    Version: 1.0
    Author: Your name here
    Author URI: Your home page URL here
*/

All you really need here is the Plugin Name: line, but the rest of the information will show up on the Manage Plugins page, so it’s useful to put something in there so you remember what it is when you look at it in several months’ time.

Finally, because this is PHP code, you need to add the <?php and ?> tags around the whole thing, so the complete file looks like this:

<?php
/*
    Plugin Name: My Theme Tweaks
    Plugin URI: none
    Description: Customize the theme without modifying any template files
    Version: 1.0
    Author: Your name here
    Author URI: Your home page URL here
*/

add_action('wp_head', 'my_add_headers');

function my_add_headers() {
   if (file_exists(get_stylesheet_directory().'/my-style.css')) {
      echo '<link rel="stylesheet"href="'.get_stylesheet_directory_uri()
           .'/my-style.css" type="text/css" />';
   }
}
?>

Create an new file called something like my-tweaks.php and place it in a directory with a name like my-tweaks (imaginative, or what?).  Then add the file and directory into a zip file, and you’re ready to install it.  Go to Plugins » Add New in your blog’s administration pages and upload the zip file to your blog by clicking the Install Now button.

Your plugin will install in a few seconds, and at the next screen just click the Activate Plugin link to finish the process.  You will be taken to the main plugin page where you will see your new plugin taking pride of place amongst all the other plugins you installed.

If you’re worried about the process of making your own zip file, here is one I prepared earlier:

zipfile

Simply download this to your computer and install it using the instructions above. If you want, you can edit the information in the plugin comment by clicking the Edit link next to your plugin in the list of installed plugins once it is running on your blog. (Be careful not to change anything outside the comment lines unless you know what you’re doing.)

Now you can start adding all those new CSS styles into your my-style.css file and they will immediately be picked up by your blog.  Remember, because your stylesheet file is added after the main style.css file in the page header, you can also override the default theme CSS values with your own.  (You may have to use the !important tag for to override them successfully in some cases, but you should only use that when you really have to.)

Stay tuned for some more interesting things you can do with your new tweaks plugin.

287 comments to Tweaking Themes the Plugin Way

  • I precisely needed to thank you very much yet again. I do not know the things I would have made to happen without those solutions contributed by you directly on that concern. It became an absolute challenging circumstance in my position, nevertheless being able to view the specialized way you treated the issue made me to leap over happiness. Extremely happy for the assistance and even expect you are aware of an amazing job you are getting into training other individuals with the aid of your web page. Probably you’ve never encountered all of us.

  • I appreciate, result in I discovered just what I used to be having a look for. You have ended my 4 day lengthy hunt! God Bless you man. Have a great day. Bye

  • This is so helpful to me! I have such trouble messing with WordPress themes…

  • Thank you a lot for sharing this with all folks you actually recognize what you’re talking about! Bookmarked. Please additionally talk over with my website =). We will have a hyperlink exchange arrangement among us!

  • I not to mention my friends were viewing the best pointers on your web blog and then quickly got a terrible feeling I never expressed respect to you for those strategies. All the men had been so joyful to learn them and have now quite simply been enjoying those things. Thanks for genuinely quite helpful and then for opting for varieties of helpful useful guides most people are really desperate to be informed on. My personal honest apologies for not saying thanks to you sooner.

  • I would like to thank you for the efforts you have put in writing this site. I’m hoping the same high-grade site post from you in the upcoming as well. Actually your creative writing abilities has inspired me to get my own site now. Actually the blogging is spreading its wings fast. Your write up is a good example of it.

  • I don’t even understand how I finished up here, however I assumed this post was great. I do not recognize who you are however definitely you are going to a well-known blogger when you aren’t already 😉 Cheers!

  • I’ve been exploring for a little for any high-quality articles or blog posts on this kind of area . Exploring in Yahoo I ultimately stumbled upon this web site. Studying this info So i am happy to convey that I have an incredibly just right uncanny feeling I discovered just what I needed. I so much indubitably will make certain to don’t overlook this site and provides it a glance on a relentless basis.

  • Outstanding article once again! Thumbs up;)

  • It’s exhausting to search out educated individuals on this topic, however you sound like you already know what you’re speaking about! Thanks

  • I happen to be writing to let you know what a amazing encounter my wife’s daughter went through reading your blog. She noticed a wide variety of details, most notably how it is like to have an ideal giving mood to get certain people very easily fully understand a number of multifaceted subject areas. You undoubtedly surpassed my expected results. I appreciate you for coming up with such powerful, safe, explanatory and in addition unique thoughts on this topic to Mary.

  • Great write-up, I am regular visitor of one’s blog, maintain up the excellent operate, and It’s going to be a regular visitor for a long time.

  • You made some first rate points there. I appeared on the web for the problem and located most individuals will go along with with your website.

  • I am delighted that I detected this weblog, exactly the right information that I was looking for!

  • I together with my guys were actually checking out the best secrets on your web site and at once developed an awful suspicion I had not expressed respect to you for those strategies. These guys appeared to be as a consequence thrilled to learn them and now have really been loving them. We appreciate you genuinely considerably thoughtful as well as for pick out variety of high-quality information most people are really wanting to learn about. My honest regret for not expressing gratitude to you earlier.

  • I have been absent for a while, but now I remember why I used to love this web site. Thank you, I’ll try and check back more often. How frequently you update your web site?

  • I am glad to be a visitor of this utter blog, thanks for this rare information!

  • Over again nifty read-up cheers rafts for sharing, keep me posted I’ll be interpretation many of your pieces in the future!

  • I’ve recently started a blog, the info you provide on this web site has helped me tremendously. Thanks for all of your time & work.

  • You need to take part in a contest for one of the best blogs on the web. I will recommend this website!

Leave a Reply to Samuel L. Cancel reply

You can use these HTML tags

<a href="" title=""> <abbr title=""> <acronym title=""> <b> <blockquote cite=""> <cite> <code> <del datetime=""> <em> <i> <q cite=""> <s> <strike> <strong>