January 4, 2010  |  documentation

The new features and bug fixes to the new releases of BigFeature are listed here.

See here for all releases.

Version 1.5 (released October 2012)
  • new:

    Sidebar menu widget.

    Created a sidebar menu widget called “BF Sidebar Menu”. It is a vertical menu and the submenus shows when the parent is clicked (only works for the main sidebar and sidebar2 + custom sidebars when added as vertical).

  • new:

    Created a shortcode called bftdynamic.

    It adds dynamic options for the BF Template, like filter, sort, layouts and posts per page.

    Here’s an example of it added to a page:

    [bftdynamic sid="bftdynamic-test" filter="category&video_tag" filter_method="or" target_sid="test" sort="date=desc&name" layout="thumbs=2427&list=2433" posts_per_page="6,12,24,48"]
    [bftemplate sid="test" template="{l=2427}" dynamic="http-get"]

    It shows the dropdown lists above the bftemplate. The target_sid must match the bftemplate sid for it to be used. The filter list is a list of taxonomies or taxonomies and terms can be manually added like this: filter=”category=design,photo&video_category”. This adds the design and photo categories for normal posts and also adds all terms in the video_category taxonomy (this is the syntax of categories for custom post types added in the theme settings (posttype_category and posttype_tag)).

    The sort list adds what to sort by and the first element can have a default order. See here for more sort paramaters.

    The layout list makes it possible to select what template to use. The parameter syntax is “template label = template ID/slug” (thumbs=2427). And then the bftemplate must use the l (layout) paramater as a variable like this: {l=2427} (2427 is the default template).

    Here’s an example of a template:

    [bfthumbs sid="bfthumbs-dynamic" showposts="{ppp=6}" tax="{tax}" tax_method="{tax_method}" post_type="post,video" orderby="{orderby}" order="{order}"]

    The filter is passed as a {tax} variable, filter_method as {tax_method}, posts_per_page as {ppp}, sort as {orderby} (and also as sort) and order as {order}.

    The bftdynamic also works with the bfthumbs shortcode, but then the layout functionality doesn’t work.


    [bftdynamic sid="bftdynamic-test" filter="category" filter_method="or" target_sid="bfthumbs-test" filter_width="350" sort="true" posts_per_page="6,12,24"]
    [bfthumbs sid="bfthumbs-test" dynamic="http-get" showposts="6"]
  • new:

    Ajax custom single functionality.

    Added an ajax custom single functionality for bfthumbs and bfloop where it loads a template in a separate container. This way videos, images, products etc. can be loaded in the same page without going to the single post page.


    [bfthumbs sid="bfthumbs-csa" showposts="6" numcols="3" width="100" marginright="5" marginbottom="5" margintop="0" class="alignleft" custom_single="cs-ajax" csa_container="csportfolio" csa_changeurl="true" csa_loadpost="1" text="false" title="false"]
    <div id="csportfolio" class="alignleft" style="width: 400px; margin-left: 20px;"></div>

    The parameters:

    • sid – Required. There must be a unique ID for the bfthumbs shortcode for this functionality to work.
    • custom_single – Required. This is the slug of the BF template (quick edit to see the slug) to show the content in the specified container.
    • csa_container – Required. This is the id if the container where to show the content outputted from the template.
    • csa_changeurl – Optional. true or false. Sets if the url will change so that the content can be linked/bookmarked.
    • csa_loadpost – Optional. The number post to load if no # url is set. The default is 1 (loads the first post). Set it to false to not to load a post by default.
    • csa_trigger – Optional. click or mouseover. Sets the method of triggering the thumb.

    Here’s an example of a template (with a title of cs-ajax):

    [bfthumbs sid="bft-ajaxtest" numposts="1" width="500" image_align="left" image_width="200" image_height="200" margintop="0"]

    The template can be any shortcode, and a post id parameter is passed to the template, so this it possible: id=”{id}”, but not necessary for the bfthumbs or bfloop since they know what post to show.

    bfthumbs can now also fetch images from a post/page ID (get_images parameter), so this can work as a gallery.

    Example of gallery with bfthumbs:

    <div id="csgallery" style="min-height:400px;"></div>
    [bfthumbs sid="bftgallery" get_images="2119" numposts="6" width="200" height="120" custom_single="csgallery" csa_container="csgallery" csa_changeurl="true" csa_loadpost="1"]

    and the csgallery template:

    <img src="{image_url}" class="maxwidth" />

    or use bfloop in the template to add extra info:

    [bfloop sid="bflgallery"]{image_wp_large}{post_title}[/bfloop]

    Another idea with this feature is to have two of more bfthumbs to show content in the same container. For example to show videos, having new videos below the video and related videos in a sidebar both showing videos in the same container.

  • new:


    Created a new shortcode called bfloop, that is an alternative to bfthumbs for showing posts in a template or a page. The initial idea with the bfloop shortcode was to be able to create other kind post layouts than possible than with bfthumbs and that it should work with the new snippets system.

    Example of a table loop:

    [bfloop category="featured" numposts="10"]

    Everything inside the bfloop will iterate the number of times the showposts/numposts parameter is set to. The showposts parameter will show page navigation at the bottom, and the numposts parameter will just show the number of posts without breaking it up into pages. This is exactly how it works for the bfthumbs shortcode. And as bfthumbs there is an ajax navigation feature, but here it is not default, it must be set with the ajaxnav=”true” parameter.

    Example of a list:

    [bfloop category="featured" numposts="10" height="600" class="postlist"]
    <span class="pn">{postnumber}</span>

    When a height is set scrollbars will appear. And the {postnumber} variable will show the number in the list.

    And It can also be used to easily create single post templates:

    <div class="mb20">{image_feature}</div>
    <div class="post">

    As you can see the content of the shortcode is the template for the post(s). The post elements are added with template variables like {post_title}. In the shortcode GUI there is an easy way of inserting variables. All the variables available can be listed by adding a variables=”true” parameter to the shortcode.

    Here’s an example of a blog index/frontpage loop:

    [bfloop image_width="600" image_height="350" showposts="6"]
    <div class="post">

    Here a {image_timthumb} variable was used to show the image, and then the image dimensions are set as shortcode parameters (image_width and image_height). showposts also works to override the default posts per page number. It is also possible to have columns like bfthumbs with the numcols parameter (example: numcols=”5″). These columns have fluid width so they will fit in any container width.

    bfloop also works with post formats:

    {% begin post_format video %}
    <div class="post">
    {% end post_format video %}
    {% begin post_format standard %}
    <div class="post">
    {% end post_format standard %}

    The post format name must be without spaces and the standard/default post format should be added last, since the last one will be used if no post type is assigned. Post formats can be created in the theme settings (custom tab).

    Custom content variables can be added with a filter, like this (in a child theme functions.php):

    function bfloop_custom_variable($value, $variable, $atts) {
      global $post;
      if ($variable == 'myvar') $value = 'my content';
      return $value;
    add_filter('bfloop_add_variable', bfloop_custom_variable);

    An existing parameter can also be modified with the filter:

    function bfloop_custom_variable($value, $variable, $atts) {
      global $post;
      if ($variable == 'post_title') $value = 'my title';
      return $value;
    add_filter('bfloop_add_variable', bfloop_custom_variable);

    And to add the custom variables to the list in the shortcode GUI variable inserter add this after the function:

    $bflcvar = array('myvar', 'myvar2');

    Plugins or other php code can be inserted with a bfhook shortcode (a custom variable like shown above can also be used). The bfhook shortcode outputs the content from an hook function. Here’s an example of a hook call:

    [bfhook sid="bfhook-st" name="myplugin"]

    and the function that can be added to functions.php of a child theme:

    function bf_myplugin() {
        global $post;
        echo myplugin($post->ID);
    add_action( 'myplugin', 'bf_myplugin' );

    The bfloop template must be styled and the css can be added to a child theme style.css or it can also be added to the css field in the template. This shortcode can be used in combinations with other shortcodes, like bfthumbs or bfhook (shortcodes can be mixed with the tags). This means that related posts can be added below the the post on single post view with a bfthumbs.

    The bfthumbs custom single functionality was also added to bfloop. Example:

    [bfloop sid="bfloop-cstest" category="featured" custom_single="single_template2"]

    Here a BF Template called single_template2 will be used to show the single post. The template can be an import shortcode of a single php template or a bfloop shortcode single template like shown above.

    btw, it is important to use the html mode of the editor when adding bfloop shortcodes, since the visual editor converts html tags.

  • new:

    bftemplate shortcode.

    Created a template shortcode that shows templates and takes custom parameters. The parameters can be added to template in this syntax: {width} or {height=300} and the shortcode can be used like this: and the width will be passed to the template and height will use the default value of 300. Dynamic paramaters from forms or url can be passed instead of hardcoding them.


    [bftemplate sid="fpt" dynamic="http" template="fpt" height="200"]

    and then with a such url to pass parameters (or form post):

    and the template:

    [bfthumbs category="{category=design}" height="{height}"]

    The sid in the url/form must match the bftemplate sid for the parameters to be used by this shortcode (several sids can be added (comma separated) to target more than one shortcode).

    The template paramater can also be a dynamic parameter.


    [bftemplate sid="fpt" template="{t=1546}"]

    and then with a such url to pass parameters (or form post):

    The template value passed can be ID, slug or title. This makes it possible to build several layouts for the same page, changing them with passing a http get or for post parameter.

  • new:

    dynamic bfthumbs.

    Added a dynamic parameter to bfthumbs so that posts can be fetched based om the current posts categories, tags, yarpp (related posts. must have the yarpp plugin installed and activated for this option to work) and http parameters (post or get). The bfthumbs shortcode can be added to the blog index/frontpage (Adspace – Below Posts) or single post page (Adspace – Below Article).

    Here’s how:

    1. Create a page with the bfthumbs shortcode:

    Related Posts
    [bfthumbs sid="bftrelated" dynamic="yarpp" numposts="4" width="124" numcols="4" marginright="10" text="false"]

    2. Add it to one of the widget areas mentioned with the BF Page widget.

    The bfthumbs shortcode can also instead be added to the textwidget (enabled shortcodes for it in this version), but then you can not use the shortcode GUI or the layout manager.

    And here is an http-get example:

    [bfthumbs sid="bft" category="design" dynamic="http-get"]

    and then the url is like this:

    Only parameters used in the shortcode can be changed with the url, and the sid must be passed as a parameter (can be comma separated for targeting more than one bfthumbs shortcode).

  • new:

    Custom post type and taxonomy creator.

    Added a custom post type and taxonomy creator in the theme settings. When creating a custom post type it also automatically creates separate category and tags taxonomy for the post type (posttype_category and posttype_tag).

    Example bfthumbs:

    [bfthumbs post_type="video" category="sport" tags="funny,extreme"]

    This works even though they are custom taxonomies, because it’s converted to the syntax below:

    [bfthumbs post_type="video" tax="video_category:sport;video_tag:funny,extreme"]
  • new:

    bfthumbs custom_single.

    Added a custom_single parameter to bfthumbs, where a template name/slug/id (bf template feature) can be added to be used to show single posts. In the template there can be an include shortcode to a php or bfthumbs can be used to show the single post.

    bfthumbs with a custom_single parameter:

    [bfthumbs custom_single="bft-single-template"]

    Template (bft-single-template):

    [bfinclude sid="bfinclude-single" filename="single-nosidebar.php"]

    The custom_single parameter can be the template slug, name or ID.

    Extra http parameters can be passed like this (can be used with bfthumbs dynamic functionality):

    [bfthumbs custom_single="bft-single-template&sid=bft&category=design"]
  • new:

    Dynamic functionality for targeted templates.

    Added dynamic {parameters} functionality to targeted templates. For example a template that is targeted for the blog (index/frontpage) can pass a url parameter for how many posts to show. Or a selectbox can send via http post how many posts to show.

    Template targeted to Blog and “Enable dynamic http {variables} for targeted templates” setting is enabled:

    [bfthumbs showposts="{sp=6}"]


    The {sp=6} will be replaced with the sp parameter, but the default of 6 will be used if the parameter is not passed.

  • new:

    Nested shortcodes.

    The shortcode GUI now works with nested shortcodes (can update and use the bfthumbs layout manager).


    [box sid="mybox"]
    [bfthumbs sid="mythumb"]

    Before the bfthumbs could not be accessed in the “current shortcodes” list, because it did not support nested shortcodes. Therefore the bfthumbs layout manager was not accessible for it either. The only solution was to move it out of the box shortcode and update it and then move it back. Now that’s not necessary anymore, since it works for nested shortcodes too.

  • new:

    Responsive bfthumbs.

    Added a responsive parameter to the bfthumbs shortcode. And also marginleft and container_height to work together with the responsiveness.

    Here’s an example shortcode:

    [bfthumbs sid="bfthumbs-resptest" width="120" numposts="8" responsive="true" container_height="420" marginright="10" marginleft="10" numwords="20"]

    The responsive=”true” removes the numcols functionality, so the number of columns will depend on the container. The container_height=”420″ sets the height of each thumb. This is done instead of clearing the floats, that was done by the numcols functionality. This means that the container_height must be more than the highest thumb to clear the next row of thumbs. The marginleft=”10″ parameter was added to so that left and right margins can be set, instead of just right, so that the margins are distributed evenly.

  • new:

    bfthumbs custom_field parameter.

    Added custom_field parameter to the bfthumbs shortcode. It works like this:

    [bfthumbs custom_field="mycats:category"]

    The mycats is the name of the custom field, and category is the bfthumbs parameter to assign it to.

    [bfthumbs custom_field="cq:query_string"]

    The query_string parameter makes it possible to change the query arguments in a string (use query_stringa for arguments that must be an array). Here’s and example of a custom field value for the query_string paramater:

  • new:

    bfthumbs fluid columns.

    Added fluid columns to bfthumbs (just like bfloop. max 6 columns).


    [bfthumbs sid="bft-fluidcols" fluid_columns="true" numcols="4" showposts="8" width="200" height="120"]

    The image can be aligned and reduced in size like this:

    [bfthumbs sid="bft-fluidcols" fluid_columns="true" numcols="4" showposts="8" image_align="true" image_width="200" image_height="120"]
  • new:

    tax_method parameter.

    Added a tax_method parameter to bfthumbs and bfloop. This sets the if posts must match all taxonomy terms (and) or just one of them (or). tax_method=”or” The tax parameter must be like this to use if on one taxonomy: tax=”video:action;video:comedy”. With a tax_method of or, posts that are in one of the terms will be listed, but with and posts must be in both terms.

  • new:

    Custom shortcodes.

    Added a custom shortcodes fields in the theme settings. Makes it possible to create custom shortcodes with content and parameters. Even other shortcodes can be added to it’s content.

  • new:

    Snippets Feature.

    Created a snippets feature. Where shortcode snippets can be inserted into templates/pages/posts. It also has an update functionality built in that will import new snippets made available on (there are no snippets available at the moment, but I will create a whole bunch of them). The snippets feature is only available for the administrator, but there are capabilities available to assign to other roles/users (ask in the forum about this).

  • new:

    Google fonts loader improvement.

    Separated google fonts (added to the google font loader) by type (font weight/italic) in the theme settings font selection lists. This means that font-weight and font-style doesn’t have to be set with css.

  • new:

    Custom tab in the theme settings.

    Added a new tab to the theme settings. It’s called custom, and in it are inputs for custom post types, widgets, taxonomies, shortcodes, post formats and css/script input fields.

  • new:

    Custom taxonomies.

    Added a custom taxonomy creator in the theme settings.

  • new:

    Social Share buttons.

    Added “Add Social Share buttons at the bottom of posts” theme setting. Adds facebook like, tweet and google+ buttons at the bottom of posts.

  • new:

    Adspace below posts.

    Added “Adspace – Below Posts” widget area and bf_below_posts hook to show stuff below every article on the blog index/frontpage. This makes it easy to add social buttons etc. on the bottom of every post on the blog frontpage. Use the “Adspace – Below Article” widget area for adding stuff at the bottom of single post view.

  • new:

    Custom css.

    Added a css field in the theme settings for custom css. The styles are added in the head tag. This is an alternative to adding css to a child theme. Adding them in a child theme is better, but this is for for small tweaks, where a child theme might be an overkill.

  • new:

    Importer plugin.

    Created an importer plugin that can ovewrite existing posts. This way templates, snippets and other posts can be updated by importing a standard wordpress import file. It can be downloaded here.

  • new:

    bfthumbs image gallery.

    Added a get_images parameter to bfthumbs that fetches all images from a post/page ID, so this can work as a gallery. And in combination with the custom single ajax functionality images can be shown in the same page (without having to go to single post/attachment view).

  • new:

    Custom Taxonomies navigation item.

    Added custom taxonomies to the “Items that can be added to the navigation” in the theme settings (taxonomy terms can also be added in a list below the navigations). A taxonomy can be added to the sidebar navigation widget and it will be the heading and list all terms below it. This makes it easy to create sidebar menus for custom taxonomies.

  • new:

    Move sidebars to the left.

    Added a “Move the main sidebar and sidebar2 to the left of the content” theme setting under misc.

  • new:

    Post pagination styling.

    Changed the post pagination styling. It is now with next page links and numbers and it is also right aligned.

  • new:

    Post formats.

    Added a post format creation field in the theme settings (that can be used with the bfloop shortcode).

  • new:

    bfthumbs query_stringa parameter

    Added bfthumbs parameter query_stringa. Works like query_string, but for array arguments.


    [bfthumbs query_stringa="post__not_in=1724,1511&category__not_in=6"]
  • new:

    Shortcode GUI insert/update shortcut.

    Added a click to insert/update functionality to the labels in the Shortcode GUI (like in the theme settings), so it’s not necessary to scroll the whole way down to the buttons every time.

  • new:

    Shortcode templates – remove navigation.

    Added a “remove navigation” setting for the shortcode template system. Also the remove header features has been modified not to remove the navigation.

  • new:

    Shortcode templates – add sidebars.

    Added an “Add sidebars” setting for the shortcode template system. Makes it possible to add custom sidebars to the template without using the widgetarea shortcode.

  • new:

    Shortcode templates – css field.

    Added a css field setting for the shortcode template system. Adds css to the head tags only to those pages that are targeted by the template.

  • new:

    Improved the columns shortcode.

    Added 2 more columns (6 columns is now prossible) and some variations. Demo

  • fix: Fixed a security issue. It is recommended to upgrade to patch this security hole.
  • fix: Fixed a caption align left margin problem.
  • fix: Fixed the problem with that parent pages was removed from the navigation when children was updated.
  • fix: Fixed a bug with the right margin in the template option “Include the sidebars (main and sidebar2) if widgets in them.”
  • fix: Removed the comma separation for the google fonts loader (fonts must now be only separated with linebreaks). It was causing problems with the font styles that also have comma separation in them.
  • fix: The bfthumbs layout html node now executes shortcodes.
  • fix: Removed the “Adspace – Below Article” widget area from index.php and blogposts.php (blog index/frontpage) so that it only shows below the article in single view.
  • fix: Correctly sized images now skips timthumb in shortcodes also (bfthumbs, slider etc.). This only worked for the blog, archive, search and single post view before, that correctly feature/default images skipped timthumb, but it makes sense to make this a global feature. Now even images added to the thumb field under the editor works like that.
  • fix: Removed custom styling of wordpress captions (captions inserted into the post) due to a wordpress 3.4 issue.
  • fix: Fixed a deprecated add background image function call.
  • fix: Removed the Facebook Share button, since it was deprecated, and stopped working as it should. It is replaced by the FB Like button (see entry below).
  • fix: Added bf_after_article hook to the single-nosidebar.php template.
  • fix: Added missing colborder class for the columns shortcode.
  • fix: Fixed a bug with the onlynav and offsetnav parameters for the bfthumbs shortcode.
  • fix: Removed empty categories from the theme navigation admin.

There was a security issue and many bugs fixed with this release so I recommend an upgrade.

Here’s how to upgrade.

Version 1.4.1
  • new:

    Bfthumbs shortcode improvements.

    • A layout gui. This makes it possible to rearrange the image, title, meta etc. and also add any information from wordpress and plugins.
    • query_string parameter. Makes it possible to refine the query (ex: query_string=”ignore_sticky_posts=0″).
    • image_align parameter. The image will no be the width of the thumbpost, but left/right/center aligned. If timthumb is used for the images (this can be changed in the layout manager) a seperate image_width and image_height can be set. Using the WP image sizes is now also possible.
    • image_width parameter. Set the width of the image when using the image_align parameter in combination with timthumb.
    • image_height parameter. Set the height of the image when using the image_align parameter in combination with timthumb.
    • zoomcrop parameter improved. Timthumb is updated to version 2.7 and with it comes a new zoom crop alignment feature, that got many options. This is also updated in the theme settings “TimThumb Cropping Alignment” select list. The new parameters available is also listed in the shortcode gui for bfthumbs (this will override the theme settings one).
    • wp_query compability. If no category, taxonomy etc. specified bfthumbs will take on the wp_query parameters instead. Making it possible to use bfthumbs to replace the blog/archive/search/single pages with the new shortcode template system.
    • Normal page navigation for bfthumbs (need one of the pagenavi plugins). ajaxnav=”false”.
    • Possibility to only show something on the first page with bfthumbs (when using the feature above). onlyfirstpage=”true”.
  • new:

    bfthumbs layout GUI.

    This can be accessed by editing a current post bfthumbs in the shortcode gui, there will be a button called “bfthumbs layout”. In this gui bfthumbs posts can be totally changed, rearranged, new stuff added. For example there is a plugin node there where several plugins have been integrated, and can be just added to the bfthumbs post by dragging the node and choosing the plugin (the plugin must be installed and activated).

    Every node got parameters that can be changed. These parameters can be accessed by clicking on the node so it will expand to reveal all it’s options. The labels above the input fields have tooltips with description what it is, so by hovering the label it will appear.

    Some nodes can also be nested, like f.ex. the meta node can have child nodes (just drag a node to the bottom of the expanded meta node and it will become nested). This way child nodes can have it’s parents settings and style. Another example is the image node that can have the caption node as child. And the caption node can have any placement in the image, and this also makes it possible to add more than one caption on to an image.

    bfthumbs layout nodes:
    • image – The post image. It can be resized by titmthumb or use a featured image size. It can also be overridden by a video added to the video field below the post editor. A custom link can also be added with the cf-link parameter (add a custom field name and add a url in that custom field in the posts where a redirection is wanted).
    • title – The post title. A custom title can be added by a custom field. Add a name of the custom field to the cf-title field and then add the custom field with the custom title in the post. A custom link can also be added like for the image. A cufon font can be selected, or a web font like google fonts (or webkit) can be used instead. The google-font field loads the font added and uses it. Google fonts can also be loaded from the theme settings, and then the font name can be added to the font-family field instead. A font size can also be set (just a number for pixel size). This font-size field can also set the lineheight and letterspacing by using this format: 24px/1em/1px.
    • text – The post text. The text can use the normal functionality where the text is fetched from the excerpt field if text is entered there or if a tag is entered to the post text what’s before that tag is used (and the text remains then formatted), or else the automatic limiter is used (number of words can be set in the theme settings or by adding a numwords parameter to the shortcode). The excerpt method fetches the text from the excerpt field, but if it’s no text there it will use the wordpress excerpt function that will fetch a preview text from the post. The whole post method is for example useful if using bfthumbs in single post view. The “meta description field” method fetches the text form the meta description field below the editor. The last one is unfiltered, but the other either got the_content or the_excerpt filter applied. The text can also be fetched from a custom field (cf-text field). And a google font can also be added for the text (see title node for more explanation).
    • meta – This is the muta style parent node. It doesn’t display any meta information by itself, but can style other nodes added to it (expand it and drag another node to the bottom to nest). See previous node descriptions for more information about google font.
    • readmore – If a text method does not automatically show a readmore link a manual one can be added. It got some styles to choose from, links and buttons. It can even be nested to the text node so it’s inside it’s paragraph (on the same line as the last word of the text).
    • caption – Caption text that can be added to image node. Several captions can be added and it’s source text can grabbed from a custom field specified with the cf-text field.
    • customfield – Grabs text from a custom field specified.
    • plugin – Integrates several plugins. These are:
    • html – Add html.
    • php – Add php or include a php file (it will search in the child theme and bigfeature folder. The administrator needs the exec_php capability to use this (add it with a plugin or like shown here)).
    • postdate – Add post date meta info.
    • category – Add the post categories.
    • tags – Add the post tags.
    • taxonomy – Add custom taxonomies. The taxname field must be the lowercase name (db id) of the taxonomy.
    • author – Add author name and link.
    • editlink – Add the editlink (will only be showed for administrators).
    • commentlink – Add a formatted link to the post comments. This can also be the comment icon bubble showed on the theme demo blog index.
  • new:

    shortcode GUI.

    This was already release in version, but since that was a beta version of 1.4.1 all it’s features are also listed here. The shortcode GUI makes it possible insert and update current post shortcodes. It’s also possible to save them to a list that can be accessed from other posts/pages. There are 3 dropdown lists at the top where the shortcodes are listed.

    The first dropdown list is showing all the shortcodes available with the theme, and selecting one will show the input fields for creating a new shortcode. A very important field is the first one, called sid (shortcode ID). When a shortcode got a sid it can be edited and updated with the shortcode gui, without such a unique id parameter it will not show up in the “current post shortcodes” list.

    Saved shortcodes will show up in the “saved shortcodes list, and can be accessed from other posts. When updating a “current post shortcode” the post will be updated, and the change can be seen when refreshing the post/page with re publishing the post. This also means that when exiting the shortcode GUI after updating the post editing page must be reloaded to reflect the changes done to the shortcode.

    One very important new feature to the bfthumbs shortcode is the “bfthumbs layout” and this gui can only be accessed when editing a “current post shortcode”. All the input fields in the GUI got a description making easier to understand what it is, and also making more documentation not necessary.

  • new:

    shortcode template system.

    This system makes it possible to use shortcodes as templates, and target any section of the website. Categories or Custom taxonomies can be created and used for template targeting. Anything selected in the template post will be targeted, so if a custom taxonomy is created it must be assigned to the Templates post type to be used with the targeting system. This way categories or taxonomies can be added to the navigation and used as page templates, but just so much easier and more flexible.

    Check “Enable Custom Templates Feature” in the theme setting. And now a custom post type called Templates will appear. Create a new post there and add a bfthumbs without any category/tag/taxonomy parameter into the post, and it will use the wp_query parameters instead. That means the posts that was previously shown with a page template will now be shown with the bfthumbs shortcode. This makes it so easy to change the post design, just a little tweak in the shortcode gui and it changes the layout. For example, changing the numcols parameter will change the number of columns shown, or the changing showposts parameters will show more posts per page.

    For the next version there will be premaid templates with several free child themes showcasing the design available to download. This will make it easier to switch design, and also not making it neccessary to understand all the shortcodes. The templates can be exported and imported and all the information is included, even the bfthumbs layout elements. This way a selection of templates can be imported with a press of a button ready to be used with another click of a button.

    In the template there are several ways to target the sections of the website. These are listed below the text editor, but also categories, tags and custom taxonomies added can be used to further refine the targeting. For example when choosing the archive target it will be used for all archives, including categories, tags and taxonomies, but if one of those is selected in the right column the template will only target the one chosen.

    template targets:
    • blog – This will show instead of the blog index. It works even if the blog is the frontpage or set as a page.
    • search – This will show instead of the search.
    • archive – This will target the archive and further refinement can be chosen (categories etc.)
    • single – This will target single post view and further refinement can be chosen (categories etc.). Bfthumbs can be used to show single posts by setting the numcols to 1 and the width to the content area width. The “full post” text method must be chosen in the bfthumbs layout gui for the whole post to be shown.
    • url – Target by url. whole or parts of the url works (with wildcards).
    • page – A page (or several comma seperated ones) can be targeted too, but this is not necessary since shortcodes can be added to pages and used as templates (added to the navigation).
    • categories – One or more category can be chosen in combination with the archive and/or single targets.
    • post tags – One or more tags can be added in combination with the archive and/or single targets.
    • custom taxonomies – One or more taxonomy can be chosen in combination with the archive and/or single targets.
  • new:

    new and modified shortcodes.

    • widgetarea – Shows any sidebar/widgetarea. This makes it possible to add any number of sidebars at a page or a shortcode template. New ones can now be created in the theme settings.
    • bfhook – Display a hook content.
    • bfinclude – Makes it possible to include a php file (the file can be in the theme folder or in a child theme folder).
    • bfbreadcrumbs – Shows the Breadcrumb NavXT plugin breadcrumb path (the plugin must be installed and active).
    • comments – Shows the post comments.
    • bfyarpp – Makes it possible to have a bfthumbs template for the yet another related posts plugin. The yarpp-template-bf.php template must selected as template in the plugin settings. This template file is updated to make this shortcode work, so if you have an older version in a child theme folder this one must be updated.
    • bfauthorinfo – Display author info box in single post view. The author info box must be enabled in the user profile to be displayed.
    • bfthumbs – The biggest change is the addition of the layout manager, and making it work with the shortcode template system. See at the top of this versions changelog for more information.
    • nivoslider – Current post as default. Just add a shortcode without parameters, like this (to the “Feature HTML” input box or into the editor): [nvoslider]. The thumbs style of this shortcode is fixed (“Show preview thumbnails” checkbox in the shortcode gui). Also the reload bug is fixed (nothing showed when reloading the page). Some new transitions has also been added.
    • galleria – Current post as default, just as nivoslider, see above for more information. Created a Galleria theme where the thumbnails are hidden. theme=”nothumbs”. Also added a fullscreen theme, but that is a little experimental, since the only way out of it is the back button.
    • divider – Added a toplink type.
    • bfslider – Fixed the vertical slides (“Slide vertically” checkbox in the shortcode gui). Added button style6 (buttons=”style6). Fixed the “Show default images in the slider instead of videos” theme setting misc feature.
    • button – Added color and shape parameters.
    • columns, image, box – Fixed the wpaoutop issue (no more annoying extra paragraphs added).
  • new: theme settings. google fonts, custom sidebars, shortcode template system, zoomcrop improved, a header code input box.
  • new: WP e-Commerce integration and adjustments. The page.php bug fixed. Added some css to fix some styling (shoppingcart, single product view and the checkout page). Added integration in the bfthumbs layout gui so that a “add to cart” button and the price can be added to posts. To use bfthumbs with WP e-Commerce just add a post_type=”wpsc-product” and a category parameter to show a product category listing. Then add the add the price and add to cart button in the bfthumbs layout (plugin node).
  • new: Google font support. Google fonts can be added in the theme settings (typography tab). Just copy the font name from the list on google and now you can add it in the font-family field in the layout gui (The font can also be loaded from the layout gui). The new fonts will also be listed in the theme settings for the body and heading font lists.
  • fix: updated timthumb to version 2.7 and added support the new zoomcrop alignment functionality.
  • new: navigation admin type. possible to have both the theme navigation system and wp menu at the same time. Example:
    [bfnav name="sidebar" style="vertical" admin="wp"]

    or calling the function, like this: bf_nav("sidebar","vertical","wp");

  • new: Added tax custom field parameter to page templates.
  • new: Added support for several website link in the portfolio (link,name;link,name).
  • new: Added classes to the navigation items.
  • new: Added navigation sorting for link category listing (add sorting to notes area).
  • fix: Added multisite support for the image shortcode.
  • fix: Fixed post_types parameter in bfthumbs so that multiple custom post types are now possible (post_type=”portfolio,photoblog”).
  • fix: Fixed the feature area content filter problem caused by some plugins (duplicate stuff was added below the feature image).
Version 1.4.
  • new: Content Shortcodes. Boxes, Buttons, Columns, Dropcaps & Pullquotes, Image frames & Captions, Lists, Tabs & Toggle.
  • new: Nivoslider (image slider). Demo.
  • new: Galleria (image gallery and slider). Demo 1, 2, 3, 4.
  • new: Thumbnail post styles. Demo.
  • new: Improved thumbnail slider functionality. Demo.
  • new: Body classes (can style differently based on page/post/category/tags).
  • new: Image loading animation.
  • new: Facebook share button in the post meta area.
  • new: Overlay caption style.
  • new: “Simple Facebook Connect” integration added (code added to comments area).
  • new: Added canonical link meta field for posts and pages.
  • new: Moved shortcode scripts and styles to the footer.
  • new: Added normal image url input field (so that timthumb also can be skipped for blog frontpage images if wished).
  • new: Added support for iframe video embed code.
  • new: Added feature html input field (f.ex. add shortcodes (a slider or maybe a html5 video plugin) for the feature area in single post view).
  • new: Cufon target field for the default cufon font.
  • new: Setting for moving the image below the title.
  • new: Setting for moving the the post meta information below the post content.
  • new: Offset added to the featured widget.
  • new: Added possibility to add/remove theme settings from a child theme.
  • new: Added orderby and order parameters to the slider.
  • new: Added the possibility to overide functions in child themes (meta ++).
  • fix: Replaced imagefit with css for image resizing.
  • fix: zoomcrop=”false” will skip timthumb for the nextgen sliders (bfslider and nivoslider).
  • fix: bfslider exclude posts without a default image or video.
  • fix: Blog posts template (WP3.0 compability).
  • fix: Image url’s for feeds is now the full url.
  • fix: Image url’s for WP3.0 multisite fixed.
  • fix: Theme settings now appears for wp3 multisite admins.
  • fix: WP3 navigation intergration.
  • fix: Static frontpage paging bug fixed.
  • fix: The dropdown indicator nav bug with ie6/7 is fixed.
  • fix: Caption center style fixed.
  • fix: bfthumbs offset with pagination fixed.

NB! before you upgrade: export the theme settings and move the widgets to the inactive widgets area, because changes have been made so this will be lost when upgrading. After upgrading import the settings and move the widgets back. Here’s how to upgrade.

Version (released 19. May)
  • new: WordPress 3.0 compability. Added support for the new navigation admin system built in to wordpress. Also added the background image/color functionality.
  • new: The slider now hides all slides until everything is loaded.
  • new: Setting for number of columns in the footer links widget area.
  • new: Possibility to override videos with images in the slider.
  • new: Added sorting to the nextgen slider.
  • new: Setting for container top margin. This is useful when used with the background image functionality to show an image above the container.
  • new: Added a vertical navigation style (example: [bfnav name=”about” style=”navertical”]). Useful for submenus.
  • new: Child theme stylesheet order changed (no more need to use specificity to override the optionstyles css).
  • new: Added the possibility to use shortcodes in the page slider.
  • fix: Navigation last class fixed.
  • fix: Fixed height issue in the nextgen slider.
  • fix: Fixed the theme settings error that occurred when nothing in the misc section was enabled.

Version 1.3.5 (released 4. May)
  • new: Parameters for setting the dimension of images in the slider. Demo.
  • new: Slider integration with the NextGen gallery. Demo.
  • new: Author info box at the end of posts. Integration with the My Profiles plugin to show social links. Enable it in the user profile page.
  • new: Export/import for the theme settings (buttons at the bottom of the theme settings).
  • new: SEO improvements. Possibility to add a custom title tag and meta tags for the blog and posts/pages.
  • new: More slider button styles (style3-5). Also added larger hotspot click area for the default buttons. Demo.
  • new: Setting for moving sidebar2 to the left of the content.
  • new: Created a new adspace to show ads in the header.
  • new: Some new bfthumbs parameters. hideimage=”true” (for hiding images), removelinks=”true” (for removing links), zoomcrop=”center” (change the zoom position (possible values: topleft/center/false)), offset=”2″ (number of posts to skip (a value of 2 = start from post 3)).
  • new: Enabled the WP2.9 set thumbnail functionality, and recoded it to use timthumb. In other words, you can press “Set Thumbnail” when editing a post/page to set the default image this way.
  • new: Added excerpt to pages.
  • new: Added useful classes to the styles dropdown list in the editor. Install the TinyMCE Advanced plugin for it to show (go to this plugin settings and add the styles dropdown to the editor bar).
  • new: Dynamic checkbox added to the Featured Posts widget. When enabled the post’s category is automatically used to display posts.
  • new: Added a “Hide from search and nav-admin” checkbox for pages to exclude it from the navigation admin and the search (useful for design and slider pages).
  • new: Pages set as private is hidden from the navigation
  • new: The css max-width is replaced with a javascript that makes too wide images fit the content width (and also container width for pages/posts without a sidebar).
  • new: The “Thumbnail image URL” now overrides the video thumb image.
  • new: Added a “Hide videos from the frontpage of the blog” setting.
  • new: Added avatars to recent comments.
  • new: Added classes and margins to adspace widget areas.
  • new: Sidebar link color added to the color settings.
  • new: The content width is displayed in the theme settings (below the setting for the container width). This is useful to know when setting the media settings (the max image width for content images).
  • new: Added possibility to change the default thumb post width in the theme settings. The default width is calculated from the content width, so adding a static value makes the thumb posts not fill the content width, but makes it possible to add paddings and backgrounds.
  • new: Added a zoomcrop setting that makes it possible to choose where the zoom center is (and the possibility to turn cropping off). A parameter zoomcrop has also been added to the bfthumbs and bfslider shortcodes to override the default (possible values: topleft/center/false).
  • fix: Caption for default images in pages is now working (when setting the default image with the Set Thumbnail functionality). Lightbox rel is also added to the links like for posts.
  • fix: Adblocker adspace issue fixed.
  • fix: Fixed the anchor links for comments.
  • fix: The “Show older posts on the blog frontpage as thumbnail posts” setting will now also display other pages than the frontpage as thumbnails.
  • fix: Revisions are now also showing for pages.

Version 1.3.4
  • Improved the bfthumbs shortcode. Demo.
  • Fade animation for the slider. Demo
  • Added a 2. sidebar column.
  • No sidebar is showing if no widgets are added.
  • Video url now produce a thumb if proplayer is installed (and activated).
  • Added support for videos in the photoblog template.
  • Separate read more setting for thumbnail posts.
  • Created a links page template (show posts as links).
  • Max width added for images and videos.
  • Fixed the plugin conflict with the theme settings. The theme settings will now show nomather if there is a conflict.
  • Link target included for links added to the navigation.
  • Confirmation dialog box added for the reset button in the theme settings.
  • More custom field parameters for the portfolio template (imagewidth, textwidth, divider (set false to hide the divider)).
  • Name parameter for the bfpage shortcode (name=”infobox”).
  • Added lightbox rel to the feature image on single pages (only if original image is larger than the one displayed).
  • Changes in the theme settings. Thumbnail post section. Container/sidebar/margin width. Added some stuff to the color section (text color, footer text/link color).
  • Fixed IE6 linebreak navigation issue.
  • Duplicate categories in the all category navigation item removed.
  • Category visibility problem with the blog posts template fixed.

Version 1.3.3
  • Integration with the “Yet Another Related Posts Plugin”. (se docs folder of the downloaded zip file for how to set it up).
  • Photoblog template. Demo.
  • Navigation highlighted when on a post that belongs to page template added to the navigation (also works with categories).
  • More parameters for the bfthumbs shortcode. Can add pages, set the height, remove the text, sort order etc.
  • Added a theme setting to “exclude the text from thumbnail posts”.
  • noresize custom field parameter for the portfolio template. Custom field: name: noresize and value: true (image doesn’t get re sized).
  • Support for the WP2.9 oembed video url tranformation. Just add a video url to the video input field (instead of an embed code).
  • Caching of optionstyles.php (creates a css file instead). Set the “Cache the settings stylesheet” theme setting for it to work (optionstyles.css will be written to library/css folder. Make the folder writeable if this is not working automatically).
  • Default targeting in cufon. Add the word default in the description field list and it will be the default font.
  • Pages now displayed correctly in searches.
  • Comments number fixed (it was showing not approved comments).
  • Fonts selection in theme settings fixed.
  • Paged title tag fixed.
  • Retweet button in post setting re added.
  • Wrong default image url problem fixed.
  • Stylesheets added with a hook (also from a child theme, because it speeds it up).
  • reset.css has been added to the top of style.css.
  • single-nosidebar.php custom single template added. It’s very much like the single-portfolio.php, but without the date modification.
  • new stuff added to the translation files.
  • styling added for the calendar widget.
  • “Add to navigation” issue with WP2.9 fixed.
  • Theme settings for Colors fixed.
  • Removed the link to posts on the videos (this was an issue with webkit browsers).
  • Thumbnail post max height is now changed to just height (the thumbnails will resize to that height).
  • Navigation down arrow issue fixed.
  • Child themes updated to send the stylesheet with a hook instead of importing them (speeds up the child themes).