Feb 112010

Version 3.3.1 of Suffusion was approved a few minutes back. This has some quite significant features:

  1. Export / Import Theme Options
    This is quite big. Though this was not on my immediate agenda, some unsavory incidents on the support forum during the weekend precipitated this fix. This feature is going to be a must if you are running several blogs and you want to replicate the settings across them. 
    You can go to Suffusion Theme Options –> Introduction –> Export / Import to see this. You can export your current theme settings as a file called “suffusion-options.php”, then copy it to the folder called “import” under suffusion/admin/ in your new blog installation, then click “Import” on your new blog installation.
    All your look and feel settings plus blog features etc will be copied over. What will not be copied over is the list of pages / categories / links you have selected in one installation, because the page ids may be different between your installations.
  2. New Widget Areas
    The Top Navigation bar has two widget areas – one each on the left and right. You can add small widgets to these widget areas to enhance your site’s look.
  3. You can now choose alignment options for the drop-down menu in the top navigation bar – left or right.
  4. Code Housekeeping
    I made a small tweak to the code for the search widget. Earlier I had set it up such that if the “before_title” and “after_title” elements of the widget’s definition were empty, the title wouldn’t print. I have reversed the condition – if the title is empty, the “before_title” and “after_title” elements will not print. I have also added a function that checks if a widget area has any widgets associated with it. If it doesn’t, the widget area is not printed.

Up next, a few more widget areas.

Feb 102010

Version 3.3.0 was released earlier today. Actually the original version I had submitted was 3.2.9 and it had a really wonderful feature, but I had to pull that feature after the WP reviewer pointed out that it could pose a security risk. So here is the list of features:

  1. Mixed mode layout
    One of the features that had been requested was the ability to display full contents for the top x posts and excerpts for the subsequent posts. I am happy to say that this release features this capability. You can have full contents displayed for a handful of posts and show excerpts, lists or tiles for the remaining posts on that page. You can control the settings via Blog Features –> Excerpts / Full Contents
  2. I have deprecated a few options: "Category Info in ‘Display List’ option", "Author Info in ‘Display List’ option" and "Tag Info in ‘Display List’ option". You can use the controls in the individual templates for Category, Author and Tag respectively instead.
  3. There is now a new control to display the tag description in the Single Tag template. Earlier you couldn’t see the description.
  4. Fixed minor bugs in the “List” layout
  5. I cleaned up some code for the different layouts, making things a lot more streamlined behind the scenes.
  6. Thanks to Harry Karayannis, the Greek translation of Suffusion is now 100% complete.

Now for the feature that I had to pull. I had provided a really cool short code that would let you execute any PHP function as a short code. However I have had to remove that call, because in a multi-user blog you could have unauthorized people with author privileges call admin functions unchecked. If you are running a personal blog you can create the short code yourself, though. To do this, add the following PHP code to functions.php:

function sc_php_function($attr) {
    $function = $attr['function'];
    $params = $attr['params'];
    $params = explode("||", $params);

    if (is_callable($function)) {
        $ret = call_user_func_array($function, $params);

    return $ret;

add_shortcode(‘php-function', 'sc_php_function');


Feb 082010

Version 3.2.8 was released a couple of hours backs, with a bunch of modifications:

  1. New Short Codes
    You now have two new short codes. The first is “suffusion-adsense”, which takes the parameters client, slot, width and height, and prints out the ad corresponding to these parameters wherever invoked. You could call it in the middle of a post to see the ads in there, or you could call this in the widgets. The second short code is “suffusion-tag-cloud” and it prints out your tag cloud. It takes all parameters of the wp_tag_cloud() function and you can use it to print a tag cloud in your text widgets with the font sizes you wish and change the number of tags displayed there from 45 to something else.
  2. New Tiles Layout
    The previous release had a “List Layout” and this one has a new “Tiles Layout”. This is analogous to a magazine layout enabled for different types of views – category, tag, search etc. See the new options in “Excerpts / Full Contents” under “Blog Features”
  3. Fixes and Modifications
    If you were to use the new templates I provided in version 3.2.5 (Single Left Sidebar etc) you would have noticed some discrepancies in the drag-and-drop behavior. If you haven’t noticed those, it simply means I have beaten you to the bug and fixed the issues ;-). I also made pages included in Featured Content order by menu_order. Lastly I had made a “Programming 101” error in one of my fixes in 3.2.7 and put in an erroneous “if” condition in the “Follow Me” widget. Thanks to Wim Scholtes’ alert eyes this has been fixed.
  4. Updated Translations
    I received updated translations from Didier for French, Manfred for German (Du) and Connie for German (Sie). So along with Wim’s Dutch translation, Team Blogos’ Danish translation and Memoria’s Spanish translation, these are the new ones that are 100% translated. Thanks folks!

I would like to reach out to the other folks who can translate. The following translations are out of date and could use your help:

  1. Arabic – ar.po, ar.mo, 47% translated
  2. Catalan – ca.po, ca.mo, 25% translated
  3. Greek – el_GR.po, el_GR.mo, 85% translated (Harry has said he will translate the remaining strings)
  4. Norwegian – nb_NO.po, nb_NO.mo, 88% translated
  5. Brazilian Portuguese – pt_BR.po, pt_BR.mo, 90% translated
  6. Portuguese – pt_PT.po, pt_PT.mo, 38% translated
  7. Swedish – sv_SE.po, sv_SE.mo, 41% translated.

The ones with less than 50% translation need some attention. Also I would like to welcome translations for other common languages like Mandarin and Russian.

I realized that with some of the changes I made over the past few releases some aspects of the RTL layout may have broken. I will work on fixing those soon.

Feb 052010

Suffusion Version 3.2.7 was released today. The following key features are a part of this release:

  1. Favicons
    After having been asked umpteen times about Favicons, I finally bit the bullet and decided to offer integrated Favicon support with the theme. Mind you though, all modern and arcane browsers (up to Internet Explorer 4) are capable of dealing with a favicon.ico file in your root directory / other directories. However, given the frequency of the question I finally added explicit support for it.
  2. “List” Display
    In keeping with my goal of multiple layouts I have built out the capability to show a “list” of posts instead of full content or excerpts. You can set this up through the “Excerpts / Full Contents” options.
  3. Bug Fixes
    There are two bug fixes. The first was causing the thumbnail container in the magazine layout to appear irrespective of the settings. The second was not a bug per se, but it was an incompatibility with certain paranoid hosts that was causing the “Follow Me” widget to error out. Thanks to Wim Scholtes, that has now been fixed.

I have received some translation updates that I will include in the next version.

Feb 032010

Version 3.2.6 of Suffusion went live today. Hopefully people with download issues on 3.2.5 will not face the same problems on 3.2.6. The following are the changes in 3.2.6:

  1. New Navigation Bar
    Bowing to frequent demand, I decided to provide a new navigation bar!! This navigation bar occurs at the top of the page, above the header. It has drop-down menus enabled and you can add pages, categories and links to it. Currently there are no widget areas there, but that will be a new feature very very soon.
  2. Customizable 404 Page Content
    You can now set the title and content of the 404 pages to something other than the rather boring and monotonous defaults. And yes, you can use short codes there.
  3. Fixed a bug in the custom styles calculations that was not passing the number of sidebars to a function call.

As you can see, I am in the process of opening up the layout of the theme in a bid to make it more flexible. In the last release I provided a handful of new templates and here you have a new navigation bar. Soon I will add new widget areas. Soon.

Feb 012010

Version 3.2.5 of Suffusion was released today. The following are the new changes:

  1. New Templates
    I have provided 5 new templates with different sidebar layouts in the theme. For each template you can control the widths of the content and each sidebar:
    1. Single Left Sidebar
    2. Single Right Sidebar
    3. Single Left, Single Right Sidebar
    4. Double Left Sidebars
    5. Double Right Sidebars
  2. New Short Codes
    A handful of new short codes have been provided:
    1. suffusion-loginout – Analogous to the call wp_loginout(). Takes the parameter “redirect”
    2. suffusion-register – Analogous to the call wp_register(). Takes the parameters “before” and “after”
    3. suffusion-login-url – Analogous to the call wp_login_url(). Takes the parameter “redirect”
    4. suffusion-logout-url – Analogous to the call wp_logout_url(). Takes the parameter “redirect”
Jan 282010

Version 3.2.4 was released today with the following features:

  1. More short codes and short code support
    Short code support has been added to text widgets, the sidebar tabs and to the page footer. In addition I created a new short code for printing post information. The short code is called suffusion-the-post and can be used with a parameter called display=’id’ or display=’title’ or display=’permalink’
  2. Fixed a bug that was causing links in the navigation bar to be taken to new windows instead of being opened in the same window.
Jan 272010

Version 3.2.3 of Suffusion was released today. The following were the key modifications:

  1. Full WordPress 2.9 Support
    In a recent release I provided support for user contact methods, a WP 2.9 feature. In this release I have incorporated the other WP 2.9 features that can be bundled with a theme:
    1. Post Thumbnails
      Now you don’t have to go through the “Thumbnail” field in “Additional Options for Suffusion” to define post thumbnails. If you have WP 2.9 or higher you should see a section on the right side of your “Edit Page” or “Edit Post” screens that says “Page Thumbnail” or “Post Thumbnail”. Using this you can images from your media library. You can also choose to display this thumbnail in your post / page itself, not just in the excerpt. Mind you, if you want to continue using the old method, you can do so without impact.
    2. Excerpt Controls
      You can now change the length of the auto-generated excerpt and also the “[…]” that appears at the end of an excerpt.
  2. Added “target” support for “Links” in dropdown menus. Earlier the links would all open in the same page. Now they will open based on the setting in the “Edit Link” page.
  3. Fixed a Featured Content image sizing issue
    In my zeal to release a TimThumb based image resizing approach I had mucked up some code, causing the “full size” setting to be ignored for images in the Featured Content slider. I have fixed this.
  4. Fixed an “empty” Featured Content issue
    In certain cases the featured content section would display an empty box. This has been fixed.
  5. Fixed an “excerpts” bug
    There was a bug that caused posts to appear as excerpts even if the full posts were to be displayed. I have fixed this.
Jan 252010

After the glitches with the version distributed by WP for 3.2.0, I am happy to announce the release of 3.2.2. Do let me know if you face download issues with the new version – I will report it to WP. The following are the major features of this version:

  1. New Thumbnail Resizing

    In the past I received a fair share of reports regarding image resizing not working well enough. A lot of it had to do with WP caching an image with a different size. With this release I switched to the ultra-popular TimThumb resizing script. I did have to make my fair share of tweaks to get this to work as I would have liked, but it wasn’t that difficult. Hopefully things should work for you out of the box. If you download the new version of the theme TimThumb should be activated by default.

    Depending on the permissions you have, things should work smoothly for you from the start. If it doesn’t, check the folder called wp-content/uploads. Do you have “write” permissions on it? If so, are there folders called “thumb-cache” and “thumb-temp” there? You might need to change their permissions to “777” through shell access on your hosting account.

    Also, you may have issues getting TimThumb to work with WP-MU. Note that you can always switch back to the default WP resizing method if you don’t like TimThumb or if things don’t work out well for you. Go to Blog Features –> Excerpts / Full Contents –> Use TimThumb for Resizing and change the setting.

  2. Fixed a Twitter Widget rendering bug
    I had made a rather simple coding error that was causing invalid XHTML code output for the Twitter widget under certain conditions. I have fixed this.
  3. Fixed a W3C XHTML validation issue
    Thanks to a post on the support forum, I fixed an XHTML validation issue that was occurring for the featured posts.
  4. Fixed an alignment issue for the “Follow Me” widget in the “Right Header Widgets”
    This was again one of those things that escaped my attention the first time and got fixed thanks to a bug report.

I have another bug on my radar for the next version, which deals with featured content. I am also considering providing some short codes and templates in the next version.

Jan 232010

I have received a sizeable number of reports from people trying to upgrade to version 3.2.0 from WordPress facing issues claiming that the automatic upgrade reports some files missing. The reason for this is sometimes the download file gets corrupted. I have faced this problem a few times in the past, with version 2.4.9, 3.1.9 and now 3.2.0. There is nothing wrong with the theme itself, but for some reason the download doesn’t work for some people. To cite an example I could do a smooth upgrade on 2 of my sites, but on the third site I faced the problem myself.

Anyway, if you face problems, please see this thread on the support forum. I have provided the right file to download over there along with instructions.