Collapsible Widget Area - ChoosePlugin.com

Creates a tabbed or accordion-style widget that can hold other widgets.

Author:	cgrymala (profile at wordpress.org)
WordPress version required:	4.0
WordPress version tested:	4.9.4
Plugin version:	1.0
Added to WordPress repository:	20-01-2012
Last updated:	03-04-2018 Warning! This plugin has not been updated in over 2 years. It may no longer be maintained or supported and may have compatibility issues when used with more recent versions of WordPress.
Rating, %:	92
Rated by:	8
Plugin URI:	http://plugins.ten-321.com/collapsible-widget...
Total downloads:	15 325
Active installs:	300+
Click to start download

Screenshots
FAQ

Installation Instructions

Automatic Installation

The easiest way to install this plugin automatically from within your administration area.

Go to Plugins -> Add New in your administration area, then search for the plugin “Collapsible Widget Area”.
Click the “Install” button.
Go to the Plugins dashboard and “Activate” the plugin (for MultiSite users, you can safely “Network Activate” this plugin).

Manual Installation

If that doesn’t work, or if you prefer to install it manually, you have two options.

Upload the ZIP

Download the ZIP file from the WordPress plugin repository.
Go to Plugins -> Add New -> Upload in your administration area.
Click the “Browse” (or “Choose File”) button and find the ZIP file you downloaded.
Click the “Upload” button.
Go to the Plugins dashboard and “Activate” the plugin (for MultiSite users, you can safely “Network Activate” this plugin).

FTP Installation

Download the ZIP file from the WordPress plugin repository.
Unzip the file somewhere on your harddrive.
FTP into your Web server and navigate to the /wp-content/plugins directory.
Upload the collapsible-widget-area folder and all of its contents into your plugins directory.
Go to the Plugins dashboard and “Activate” the plugin (for MultiSite users, you can safely “Network Activate” this plugin).

Must-Use Installation

If you would like to force this plugin to be active (generally only useful for Multi Site installations) without an option to deactivate it, you can upload the contents of the collapsible-widget-area folder to your /wp-content/mu-plugins folder. If that folder does not exist, you can safely create it.

Why am I seeing widget content used as the title/handle for the accordion/tab?

In order to render accordions and tabs, this plugin needs to set the Widget Title as the accordion/tab handle, and the Widget Content as the content of the item. If your widget doesn’t have a Widget Title for some reason, the formatting can get messed up, and can actually cause the content of one widget to be set as the title/handle, while using the title of the next widget as the content of that accordion/tab.

Will this plugin work in versions of WordPress older than 3.3?

There is limited support for the tabbed interface in WordPress 3.2.x, but the accordion interface does not work.

My widget title should have a link/image, but it doesn’t. Why not?

In order to create the handles for the accordions/tabs, the titles have to be wrapped in links to those items. Since you can’t wrap a link inside of a link, this plugin strips any HTML from the widget title before rendering the collapsible interface.

Does this work on multisite installations?

Yes. This plugin is set up to work in any of the following situations:

Single site installs
Multisite installs where the plugin is activated on a site-by-site basis
Multisite installs where the plugin is network activated
Multi-network installs (some multi-network functionality of this plugin will only work if you have our multi-network function files installed)

Can I have more than one Collapsible Widget Area?

Yes you can. Simply go to Settings -> Collapsible Widget Options and specify how many Collapsible Widget Areas you want. Then, when you go back to Appearance -> Widgets, you will see that many Collapsible Widget Areas available on the right side.

Can I insert the Collapsible Widget Area into a post or page, instead of using it in a widgetized area?

Yes, you can use the shortcode [collapsible-widget id=#] (where you replace the # with the ID of the Collapsible Widget Area you want to render). The following options are available for the shortcode:

id (int) – the ID of the Collapsible Widget Area to be rendered. Defaults to 1
show_what (accordion|tabbed) – specifies which type of interface to use. Defaults to “tabbed”
collapsible (bool) – if the type is set to accordion, this option specifies whether or not the entire accordion can be closed, or if one item always has to be open. Defaults to false
closed (bool) – if the type is set to accordion, and the collapsible option is set to true, this option specifies whether or not to start with the accordion completely collapsed. Defaults to false
cookie (bool) – if the type is set to tabbed, this option specifies whether to save which tab is active so that it will be the active tab the next time the person returns to the page. Defaults to false

Can I use the Collapsible Widget Area in my theme, rather than using it in a widgetized area?

Again, theoretically, yes. You should be able to use the_widget() to insert this directly into your theme, but that has not been tested, and it would probably take some effort to get it working correctly.

How does the plugin create the tabs/accordions?

This plugin uses jQueryUI (either the Tabs feature or the Accordion feature) to implement the tabs/accordions. A little extra JavaScript is thrown in just to make sure the elements are in the correct places before trying to apply the tab/accordion interface.

How does the plugin style the tabs/accordions?

Since this plugin uses jQueryUI, it uses the same style definitions that any other jQueryUI accordion/tab interface would use. You can choose to use any of the existing jQueryUI themes (all hosted on Google’s CDN), you can leave out custom styling altogether (for instance, if you already have a jQueryUI theme pulled into your theme, or if you have specific style definitions for jQueryUI widgets baked into your theme’s stylesheet), or you can apply a custom theme by hooking into the collapsible-widget-ui-theme filter and returning the URI of the CSS file you want to use.

What filters does this plugin introduce?

collapsible-widget-ui-theme – the parameters sent to this filter are: 1) the URI of the CSS file being used (or a blank string if “none” was selected from the options) and 2) the theme option that was selected in the plugin’s settings
collapsible-widget-area-args – the arguments sent to the register_sidebar() function when registering the Collapsible Widget Area sidebar
collapsible-widget-theme-list – an associative array of the jQueryUI themes available for use with this plugin: The keyword used in the Google CDN URI (or, the full URI to a custom theme) is used as the key, and the human-friendly name of the theme is used as the value for each array item.
collapsible-widget-defaults
collapsible-widget-javascript-arguments (since v0.5.1) – the arguments printed in JSON to tell jQueryUI how to instantiate the accordion/tab items. This is a nested array of arguments. Reasons to use this might include changing the heightStyle argument, so that accordion areas are only as tall as the content inside of them, rather than all being a uniform height.

Can I see examples of how to use these filters?

Yes, you can see some very basic code examples of how these filters can be used on Github.

Hide FAQ

ChangeLog

1.0

Update WordPress version compatibility
Fix bug in persistent active tab functionality
Add feature that allows tabbed items to be totally collapsed
Add feature that allows the active accordion item to be persistent across pages
Add option to choose the heightStyle of Tabbed and Accordion widget areas
Make widget IDs more consistent

0.5.3

Fixes bug with wp_register_script location h/t NinjaDoll_
Fixes bug with undefined index on Widgets screen h/t NinjaDoll_

0.5.2

Increment version number because code push didn’t work properly with 0.5.1

0.5.1

Fixes bug with the way scripts/styles are enqueued/registered h/t NinjaDoll_
The “Base” theme no longer seems to exist, so it has been removed from options and the new default UI theme is Smoothness
Fixes bug with missing UI stylesheets h/t Ayreona (Google doesn’t treat the style sheet versions the same way it treats the scripts, so explicit version numbers are necessary in the style sheet URL).
Adds collapsible-widget-javascript-arguments filter to allow modifying widget arguments (see FAQ for usage information) h/t nstampler and ndesign55 for suggestion

0.5

Update compatibility
Fix old-style widget constructor
Update version of jQueryUI themes used in newer versions of WordPress

0.4

Fixed more jQuery/UI issues that cropped up when 3.5 went final
Implement ability to use more than one collapsible widget area
Implement error handling for situations where a collapsible widget is dragged into a collapsible widget area
Begin implementing shortcode (still remains fairly untested)
Fixes various bugs (for instance, if you specified an accordion should be collapsible, that might not have worked correctly)

0.3.1a

Remove extraneous debug info that threw PHP error about headers already being sent

0.3a

Fix errors in CSS. With the bump to 1.9 in jQueryUI, the UI theme stylesheets that were being included also got bumped up to 1.9, while the version of jQueryUI that’s included with WP 3.1-3.4.2 is 1.8, causing some issues with layout. The plugin has been updated to be more specific about which stylesheet is included, using 1.7 for versions of WP earlier than 3.1, using 1.8 for versions between 3.1 and 3.5 (not including 3.5) and using 1.9 for 3.5 and above.

0.2a

Modified JavaScript to strip HTML from widget titles before rendering collapsible interface
Modified JavaScript to add first-tab and last-tab classes to first and last items in collapsible area

0.1a

This is the first version of this plugin

Hide ChangeLog