=== Section Widget === Contributors: oltdev, godfreykfc, enej, ubcdev, ctlt-dev, ctlt-dev Tags: text, html, shortcode, tabs, tabbed, widget, conditional, section, per page, post type, taxonomies Requires at least: 3.6 Tested up to: 3.8 Stable tag: trunk
Display arbitrary information only on selected sections of your site. Also allows you to easily organize them into tabs in your sidebar.
== Description ==
Grand Prize winner of WordPress Plugin Competition 2009
Ever wanted to display a widget only on the front page? Subpages of certain pages? Posts with a certain tag? We've got you covered. With an extremely easy to use interface, you can create your section-specific widget in no time - without going through the frustration of writing PHP code (ala Widget Logic).
In addition to plain text and HTML, we have added shortcodes support into the mix. This means you can easily turn your crazy widget ideas into reality. Need a RSS widget for the posts in the "Movies" category? Yep, there is a shortcode for that. Show your AdSense ads only on the front page? There is a shortcode for that too - not to mention tag clouds, Paypal, Amazon... you name it. Or throw more CMS hotness into your sidebar with our conditional custom fields shortcodes. Checkout the screenshots for more inspirations.
But before you hit the download button, we have saved a surprise for you. In order to help you fit all those insane ideas into your already crowded sidebar, we have decided to add tabs to the equation. With an intuitive drag-and-drop interface, creating your own tabbed widget is completely effortless - even for your grandparents. (See the screenshots for details.) To bring this to the next level, we have bundled 25 (!) switchable themes (powered by the jQuery UI project) with the plugin - and we even included a on preview in the settings page! And of course, you can always roll your own theme to suit the design of your site. (A lite version with the 2 basic themes is also available here.)
With all those awesome features, you should definitely download it and try it out. If you still cannot find a need for this, you're probably using WordPress the wrong way ;) Let us know what you think, drop us a line at the forums - we would love to hear about your creative ways of using this plugin!
If you are running a earlier version of the WordPress 3.5 or earlier don't use the latest version of the plugin.
= Built-in Conditionals =
In this version, you can freely mix and match these predefined rules which gives you control of where the widget should be displayed:
Please note: JavaScript is required for the widget interface to display correctly.
This plugin will only run on Wordpress 3.3+.
== Installation ==
== Frequently Asked Questions ==
How do I switch themes?
Go to the Section Widget settings page (under the Appearance admin menu). Select any themes from the drop-down. Click "Preview" to show the on preview.
I cannot see the widget!!!
Did you forget to set up the conditions for the widget to display? Try checking "Everywhere" and start from there. If you still do not see the widget, there is probably no sidebar on that page. Try adding "?swt-scope-test" to the end of your page's URL (e.g. http://www.myblog.com/?swt-scope-test) - if you have at least one tabbed section widget activated and you do not see "Section Widget Scope Test" on your page, there is probably something wrong with your WordPress theme.
Why does the tabbed section widget looks so weird on my site?
Make sure you have set a correct CSS scope in the Section Widget settings page (under the Appearance admin menu). Let us detect that setting for you if you are not sure what to do - simply click on the help link besides the text field and follow the instructions there. On the other hand, if your widget looks stretched out, try checking the "Height fix" checkbox in the settings page (especially if you're using the default WordPress theme). Finally, make sure you have JavaScript enabled in your browser.
Can I use shortcodes in the widget content?
Yes. However, please beware some shortcodes (for example our conditional custom fields shortcodes) will only work when an individual pages or posts is being displayed, not on an archive pages. This is because they require information (e.g. custom fields) that are attached to individual pages/posts.
Can I use PHP code in the content?
By default, no. But if you really want to do that, there is a shortcode for that. ;)
Can I use HTML in the content?
Yep.
Can I use JavaScript in the content?
See below.
Is the HTML code filtered?
It depends. Unless the user who edited the widget has the unfiltered_html capabilities (this means Administrators and Editors on the default settings), all "non-safe" HTML elements (particularly JavaScript) will be stripped.
What does "Display title" do?
When checked, your widget's title will be displayed before the its content just like the regular text widget. When unchecked, the title will be hidden which gives you more flexibility if you need to style the widget manually.
How should I style the widget?
If you have access to the theme CSS files, you can wrap your content in an id (or give it a CSS class), and then style it from there. Otherwise, you can always use inline CSS. For information on styling the tabbed widget, please refer to the jQuery UI theming guide.
The themes are taking up too much space!
You can remove any unneeded themes but deleting the corresponding folder in the "section-widget/themes" folder. However, please do not delete the "Base" theme.
== Screenshots ==
Easy to use widget interface
Selecting individual pages
Selecting individual categories
Creating tabs is fun - you can even drag-and-drop to reorder them
How it looks on an actual page
Switching themes - with on preview
(Ideas) Giving your confused visitors a helping hand
(Ideas) Save space by combining your navigations (Tag cloud and Category list powered by Template Tag Shortcode, pages list by our own Subpages Navigation plugin - coming soon!)
(Ideas) Or go wild with our Conditional Custom Fields Shortcode
== Changelog ==
= Version 3.2.4 =
= Version 3.2.3 =
= Version 3.2.2 =
= Version 3.2.1 =
= Version 3.2 =
= Version 3.1 =
= Version 3.0.4 =
= Version 3.0.3 =
= Version 3.0.2 =
= Version 3.0.1 =
= Version 3.0 =
= Version 2.03 =
= Version 2.02 =
= Version 2.0 =