Jun 302012

The one last version I managed to squeeze in before I embarked on my vacation was 4.2.4. Don’t worry, this post has been written prior to my vacation – it is only being posted while I am holidaying.

This is another small release (which is what I like doing, really, as opposed to humongous ones), with the following:

  1. New Features
    1. Rudimentary Device Support
      As promised in my last post, I have added support for some mobile-specific classes. There are a bunch of conditionals available, such as is_mobile, is_iphone and is_ipad, which determine the device-type based on the user-agent of the browser. Based on this, certain classes are added to the body element of the page. E.g. device-desktop is added as a class if you are browsing through a desktop. The code for all of this has been liberally lifted from the mobble plugin.
      I didn’t have the time to fit in the sidebar positioning features – those will happen after I return.
    2. More Byline Control
      I have added the capability to specify starting and trailing texts for bylines. This means you can remove things like the “Tagged with: ” for tags and add text like “Filed under” for categories. Check out the options under Other Graphical Elements → Byline Configuration. For people desiring additional control, I have added the filters suffusion_before_byline_html and suffusion_after_byline_html to help you modify the strings based on your display etc.
    3. Some Admin Extensibility
      So far Suffusion has been fairly rigid about the back-end options. Of course, you can do insane amount of stuff with the options, but there has been no way to extend the options via child themes. In a first step to even better flexibility (who knew that was possible?), you can now use the suffusion_admin_modify_option_list filter and enhance the option list. E.g. if you are building a child theme with a new byline style, you could add the byline style to your list and make it available to all users of the child theme.
  2. Bug Fixes
    1. In some cases incorrect byline information was appearing if displayed in the post footer. This has been rectified.
    2. There was a bug in the reset capability for custom backgrounds – I have taken care of that.

Hope you enjoy this release, while I enjoy my vacation.

Jun 222012

Version 4.2.3 of Suffusion was approved today. This is a small update with the following changes:

  1. The Magazine template was not showing any <h1> tag. This has been addressed.
  2. I made a small change to the way Suffusion interacts with the Category Icons plugin. In some cases the plugin was displaying 2 category icons. This shouldn’t happen now.
  3. This was a weird one. The site that distributed the original “Now Reading” plugin is currently infected. Suffusion’s admin pages had a link to this plugin, and some “security” plugins were reporting this as a critical problem, indicating that your site and / or Suffusion were infected. Be assured that there is nothing wrong with either. Nonetheless I have changed the link to the “Now Reading Reloaded” plugin’s WordPress page, which in turn points to the infected URL.
  4. The date box wasn’t lining up properly in IE. This has been fixed.
  5. Custom Background Changes:
    1. I wrote about this in depth in my previous post (see the “Impact on Suffusion” section).

      If you are using a custom background from Appearance → Suffusion Options → Skinning → Body Background, there is a high likelihood that your background will not work.

      Don’t be alarmed – this is very easy to fix. Just go to Appearance → Background, and restore the settings to the defaults.

    2. This is essentially a BP bug – BuddyPress doesn’t respect the custom background defined via Appearance → Background, so I took care of it in Suffusion. A custom background will be preserved on BP pages as well.

Baby Steps Towards “Responsive” Design

Version 4.2.4 will take baby steps towards responsive design. The first thing it will do is add device-specific classes to the <body> element. I lifted most of the code for this from the “Mobble” plugin. The second thing it will probably do is shuffle the sidebars around for narrower layouts. Of course, if it does this, it will be configurable, entirely optional and switched off by default.

My thoughts around this kind of design are no secret – I believe that is defeating the true purpose of mobile design. All it is doing is saving the users the effort to do a pinch / zoom and a horizontal pan (never mind that the effort for the vertical pan increases). It is not going to save any bandwidth. However, till I come up with more innovative ways to make sites truly responsive, this is the best I can offer.

Time Out

It has been a while since I have visited India – back then the football and cricket World Cups hadn’t happened and Roger Federer was still the master of all he surveyed. I am looking forward to my vacation a good bit, and needless to say, I will not be logging into the forum for support requests on a daily basis. Hopefully the galaxy of Suffusion will not collapse. Don’t panic!

Jun 122012

Version 4.2.1 of Suffusion had an issue with RSS feeds. Feeds were not validating correctly due to an improper character in the feed title. So I patched the issue and submitted version 4.2.2.

Additionally version 4.2.2 addresses a minor issue – the blog title and description were not getting placed on the right side of the header. I have fixed this as well.

Jun 112012

For the first time in several months I had a release of Suffusion submitted and approved on the same day. Version 4.2.1 of Suffusion is a moderately big release with the following updates, with a lot of focus on the upcoming version 3.4 of WordPress:

  1. New Features
    1. Scribbles
      The biggest feature of this release is the new skin, “Scribbles”. It features more than moderate use of CSS3, a wooden background, “Post It” and notebook styling and the “Coming Soon” font.
    2. New Iconset
      In keeping with “Scribbles”, I have added a new iconset. This iconset is largely based on the offbeat Web Design Creatives icons.
    3. New Byline Styles
      Again, another change courtesy “Scribbles” – there is now a new byline type that lets you position the bylines outside the post, by the side. Think of it like a pullout, except that in the incumbent pullout bylines, the byline was below the post title, but here the title is beside the byline. Try it out at Other Graphical Elements → Post and Page Bylines.
    4. Custom classes for Custom Post Types
      As a part of my ongoing efforts to support Custom Post Types better, I have added the capability to specify a CSS class for both, the Custom Post Type Archive template (seen under Additional Options for Suffusion → Custom Post Type Archive) and individual custom post types (seen under Custom Types → Layouts)
    5. Native Custom Headers
      This is to gear up for WP 3.4. I was earlier unable to add support for WP’s native custom headers, because WP didn’t support flexible widths. But with 3.4 this is not going to be an issue, so Suffusion 4.2.1 has support for custom headers, assuming you are on WP 3.4.
    6. WP 3.4 Theme Customizer Support
      WP 3.4 has introduced a new concept called Theme Customizer. I have added an option to just try out the skins of the theme from the Customizer without having to activate the theme. This is more of an “FYI” for you and shouldn’t have any bearing on how you use the theme.
  2. Changed Features
    1. “Follow Me” Icon Changes
      This was necessitated because there was some ambiguity around the licensing for some of the previous icons. I have replaced them with reasonable facsimiles that I have built myself. Hopefully the effect will not be too jarring.
    2. Markup Changes
      There are several markup changes due to the introduction of the new byline styles.

      Child theme users, please check your child theme template files for any differences with respect to the theme files.

    3. Translations
      In the last file I had forgotten to update the PO file for the theme. I have updated the same now.
    4. Code Housekeeping
      1. Some API calls that get deprecated with WP 3.4 have now been removed.
      2. Some “custom post meta fields” have been renamed and prefixed with “suf_”. The named fields are meta_keywords, meta_description, thumbnail and featured_image. This should be transparent from your perspective.
      3. Most of the post_class arguments have now been added through a filter. This is to facilitate better integration with plugins, but for most users it should have no effect. This is in accordance with the new guidelines from the WP Theme Review Team.
      4. The calls to wp_title have all been replaced with the appropriate filter. This is in accordance with the new guidelines from the WP Theme Review Team.
      5. Uses of get_stylesheet_directory_uri have been appropriately replaced with get_stylesheet_uri in accordance with the new guidelines from the WP Theme Review Team.
      6. The template files now have no inline styles. This means that you can use custom CSS without having to force the !important directive for many cases.
  3. Bug Fixes
    1. The Authors template had a minor (undetected) bug, that would cause issues due to a potential conflict of global variables. This should be fine now.
    2. The Custom Layout Template was not respecting the option to “Keep original heights” for the widgets. I have fixed this.
    3. The rotating headers capability was not working if the generated CSS was being linked as a file. This should be fine now, too.
    4. Under some very rare cases the breadcrumbs code was crashing. I have taken care to ensure that the appropriate checks are in place so that the code no longer crashes.

What I couldn’t fix

There were some reports of issues with incorrect tags showing up on posts. This wasn’t something I could replicate, hence I couldn’t fix this.

Additionally, I was not able to add the features of “Scribbles” to Suffusion BP Pack or Suffusion Commerce Pack.

I am going to switch to a “minor release” mode till I am done with my vacation that ends in mid-July. This means I am not going to push any big items out during this time. Photonic is due an update, as are the two Suffusion packs, so you can expect new versions of those in the near future.

Hope you enjoy this release.

May 072012

Okay, so now I can finally check the HTML5 box off Suffusion’s checklist. Version 4.2.0 was approved earlier today and it has the following changes:

  1. New Features:
    1. HTML5 and Semantic markup

      I have converted Suffusion from being an XHTML transitional theme to an HTML5 theme. Often when theme developers say their theme is HTML5 compatible, they mean that their theme uses <!DOCTYPE html>. Suffusion does that of course, and also gives you nice semantic markup out of the box. If you are wondering what semantic markup means, I explained the term and the attendant changes in a post in March. If you go through that post, you can see the list of markup element changes as well.

      If you have Custom Styles, make sure you are using the new selectors for them, as per the linked post above.

    2. Extensive Support for Custom Post Types
      I have done two things on this front:
      1. Provided a new page template called “Custom Post Type Archive”: When you create a page, you can assign this template to the page and save this page as a draft. Upon saving you will see a new tab in the Additional Options for Suffusion titled Custom Post Type Archive. In this tab you can pick things such as which post type you want to show, what kind of layout you want for it (Full posts, Excerpts, Tiles, Mosaic or List), what taxonomies you want to show for it, where you want the bylines displayed, etc.
      2. Provided a new set of options under Suffusion Options → Custom Types → Layouts: This is for the single post displays for Custom Post Types.
    3. New Action Hooks
      The following new action hooks have been added:
      1. suffusion_before_post – Executed before every post. This takes 3 parameters: the post id, the layout (blog, tile or mosaic) and the current post index.
      2. suffusion_after_post – Executed after every post. This takes 3 parameters: the post id, the layout (blog, tile or mosaic) and the current post index.
  2. Changed Features
    1. I changed the tile layout / magazine layout / custom layout from a JavaScript-based layout to a CSS3-based layout. This should make sure that the tile spacing is more accurate. Of course, there is IE, which doesn’t support the requisite CSS attributes. For them the JS-based former approach should be used.
    2. I have upgraded the embedded JQuery Masonry script to the latest version.
    3. I have also optimized some of the JS and CSS within the theme appropriately.
  3. Bug Fixes
    Since I released a bunch of patches over the past few weeks, there is only one fix, which is for the bug with respect to duplicate content from the Featured Content section showing up in the posts below.

There are a couple of minor niggles, neither of which is a bug. These come down mostly to my extreme level of exhaustion last week:

  1. I forgot to update the version number that shows up in the back-end. It still shows up as “4.1.5.b4”, while it should be “4.2.0”. This doesn’t affect any behaviour, mind you. It is just something that I missed changing.
  2. I also forgot to update the PO file for translation. Again, the main impact is in the back-end translations and it will not affect your site’s visitors.

A big thank you to the beta testers for this version, Mark et al!

Apr 222012

Version 4.0.7 of Suffusion, released earlier today addresses a minor bug. If featured content was enabled on a tile layout view, and if duplicate display was disabled, the tile layout sometimes got hammered. This version should take care of that.

Do pitch in with your comments about 4.2.0. I am getting ready to push that into the approval queue.

Apr 132012

Version 4.0.6 of Suffusion got approved a little while back. This is mostly a small release with the following changes:

  1. I added the capability to store the generated CSS as a CSS file. If you go to Back-end → Site Optimization, you will see the option to store the CSS as a file, which is the new default.
  2. There was a minor issue with the “Additional Options for Suffusion”, where the contents of the box were overlapping with things like the Media Upload panel. This should be fine now.
  3. I put in a conditional check for loading the JQuery Cycle script, so that if Photonic exists, the script will not be double-loaded.

Enjoy this release and let me know of any additional issues that you find with the beta version.

Apr 092012

As I work away on the HTML5 version of Suffusion, I thought I should release some patches that I have completed in the meanwhile. The first set of patches, released as version 4.0.5 addresses the following:

  1. Menus in “Left Header Widgets” and “Right Header Widgets” weren’t showing as dropdowns. This has been fixed.
  2. The Query Posts widget was not resetting to the original query, resulting in erratic behaviour in some cases.
  3. There was a minor conflict with styles on the post edit screen, wherein some display elements not from Suffusion were getting affected. This should be fine now.

I might release another patch before pushing the HTML5 version into beta.

Mar 062012

Version 4.0.4 was released today. This is predominantly a maintenance release with very minor changes:

  1. New Features
    1. The following filters have been added
      1. suffusion_can_display_category_information
      2. suffusion_can_display_author_information
      3. suffusion_can_display_tag_information
      4. suffusion_can_display_search_information

      Using these filters you can optionally switch off the information displayed at the top for categories, authors etc.

    2. I have added the capability to control the excerpt length for the featured posts widget. Note that this only applies to automatically generated excerpts.
    3. I have added some code so that if you are viewing a page in an old browser (IE 6-8), that gives the root <html> element a corresponding id, like #ie6. Correspondingly I have replaced a lot of IE6 hacks with more elegant id-based choices.
    4. The <body> element gets some new classes, such as preset-1000 or preset-1200 or preset-600 if you are using a preset fixed width setting. This will help you control widths better.
  2. Bug Fixes
    1. Fixed an issue where a menu in the navigation bars was occasionally not rendering correctly because the enclosing <ul> tag was not getting removed.
    2. Fixed an issue that some users were facing for the authorship feature. For the affected users the social media links were not showing up on the author page.
    3. In some cases the options needed to be saved multiple times to be effective. I have fixed this.
    4. There was a small bug with the custom layout display, where if you had a widget area with 1 widget per row, resizing the browser window affected this widget. I have addressed this.
    5. There was an issue where some images would not be shown (e.g. featured content, magazine headlines etc.) unless settings were saved. I have resolved this.
  3. Changed Features
    1. I have cleaned up some auto-generated CSS.
    2. I have made some minor adjustments to the RTL behaviour. Now the header and navigation menu positions get appropriately reversed with respect to the native left-to-right layouts.
    3. In prior versions, disabling Suffusion’s audio shortcode used to prevent the SWF file from loading, but it still included the associated JavaScript albeit in a harmless manner. This has been modified so that no trace of the shortcode shows up if you disable it.
    4. I have changed the “header height” to be a “minimum header height”. This way you don’t have to worry about adjusting header heights if your images are larger etc.

The next somewhat big release will have HTML5 compatibility (and the big release after that will be responsive). I might do a brief beta for HTML5 and Responsive and I will keep you posted regarding the same.

Feb 222012

Thanks to a pretty good beta phase, very few issues were found in 4.0.0. Of course, some issues that are much older than 4.0.0 did come up and they have been fixed appropriately in 4.0.2, which was released today. But before I proceed with details of this release, I would like to point out things that are not bugs but came up in 4.0.0.


  1. If you had tweaked your menu’s CSS to change the height of the tabs or the widths of the drop-down lists, you will need to make a minor adjustment. Basically tabs with drop-downs now get an additional class, dd-tab. You have to add this class to your selector. E.g. if you had this:
     #nav ul ul { ... } 

    … it will become:

     #nav ul .dd-tab ul { ... } 
  2. Another common question on the support forum pertained to inappropriate use of menus. The ONLY right places to add menus for navigation are the navigation bars, not the widget areas in the navigation bars. The menus have to be added in the navigation bars themselves, either by assigning them appropriately through Appearance → Menus, or by adding pages / categories / links through Suffusion Options → Other Graphical Elements → Navigation Bar Above Header (or Navigation Bar Below Header). If you have added menus through widgets in Right Header Widgets or other widget areas in the navigation bars, they will not work.
  3. If you are using a caching plugin, make sure you rebuild your CSS files – I had quite a few queries telling me that the magazine layout was showing an incorrect number of columns per row.

Now for the enhancements in this release:

  1. New Features
    1. In keeping with custom templates, I added yet another powerful capability. For every page you can choose to hide the navigation bars, header and footer. When you use this capability with Custom Layouts, you can create splash pages as you please. Earlier you would require custom CSS for doing this, however that approach had a drawback: you were still executing server processes and fetching the content. Now when you hide the content, the server will not fetch it at all.
    2. I extended the “get image” capability of the theme to fetch YAPB images if available. Now if you have YAPB installed, its thumbnails should be fetched by Suffusion for excerpts, mosaic layouts etc.
    3. A little known but long-existent feature of the theme is the capability to add user contact methods, since version 3.6.6. If you are wondering what these are, go to Users → Your Profile. You will see things like “AIM” for you to add links. In addition to those that exist, Suffusion lets you add a lot more. Visit Back-end → User Profiles for a complete list. Whatever you select from this list will show up under Users → Your Profile. I added “Google” to this list for your Google Plus Profile link.
    4. The above addition is very significant in the context of another feature that I added – authorship. Now, if you have provided links for any of your additional profiles, they will automatically show up in the Author page. Check my page on this site to see what I mean. What this does is, when Google is generating snippets for your site via search, it can automatically pull information about you, such as your picture, based on your Google Plus Profile that you have linked. Note that Google doesn’t guarantee that it will show your picture.
    5. You can now style the title for your Custom Layouts template.
  2. Bug Fixes
    1. There were some small unreported bugs in the Custom Layout options, which I detected and fixed:
      1. It wasn’t respecting the “display title” selection for a particular page.
      2. The rightmost widget in a widget area in the Custom Layout was not being floated right if it wasn’t on the first row.
      3. IE9 had some issues with the display if a widget area spanned multiple rows.
    2. The new featured content settings had a couple of minor issues:
      1. The numbered index in the featured content wasn’t showing any numbers in a unique combination of options.
      2. If overlaid icons were used for Previous / Next, the icons in the static featured content showed a background colour upon hover instead of being transparent.
    3. IE had an issue with the navigation menus showing some unstyled content before popping into place. This has been addressed.
    4. There was a conflict between the 1 Left, 1 Right Sidebar layout and the 1 Right Sidebar Layout, where the maximum width settings were not taking effect.
    5. There was an incorrect label in the Featured Content widget, which I have fixed.
  3. Changed Behaviour
    1. The review team wanted me to include some additional translations for the backend, so I have put those in.
    2. I have moved the Google Analytics script to the <head> section instead of the end of the <body> section. Note, though, that you might be better off using a plugin for analytics, as I cannot guarantee that the analytics script will be the last piece of code before the ending </head>.
    3. I have modified some backend strings for better consistency.
    4. I had introduced a capability to blank out the Widget Area Below Header and Widget Area Above Footer if they had no widgets. It turns out that some plugins strip out all widget formatting, and in such cases the widget area was killing these entities as well. I have changed the behaviour so that the widget areas get removed only if empty.

I have been working with Miguel Koscianski Vidal to build a plugin or some theme capability to make the backend options panel translation capable. Hopefully we can come up with something.