WordPress.org

Ready to get started?Download WordPress

Plugin Directory

Widget Wrangler

A plugin for managing the display of widgets on a page by page basis. Using widgets as a post type.

What is a Corral

A Corral is an arbitrary group of widgets. WordPress calls them "sidebars", but they are not ultimately limited by that terminology. You could have multiple Corrals appear within a single Sidebar if needed.

Where does a widget's html come from?

With the new "Theme compatibility" setting, it is possible for the widget's html to come from 2 places. If Theme Compatibility is not enabled, then all the html for widgets come from Widget Wrangler's widget template (widget.php). With Theme Compatibility enabled, the outer html for the widget comes from the registered sidebar's properties ($before_widget, $before_title, etc), while the inner content html comes from the widget template.

Be aware that on new Widget Wrangler installs, "Theme Compatibility" is enabled by default.

How do I display a single widget within a Page's content?

Widget Wrangler comes with built in shortcode support for each widget. To show a single widget in a content area, use the shortcode pattern of [ww_widget id={post_id}]. ie. [ww_widget id=240] where 240 is the post_id of the widget.

How do I find out a widget's post ID?

A widget's post ID is displayed in the 'Options' panel when editing that widget.

How do I display my widgets?

The easiest way is to go to the standard Widget area under the Appearance admin menu item and drag the "Widget Wrangler - Corral" widget into the sidebar area where you want it, then select which Widget Wrangler corral should be shown from the widget options. The other way requires you to edit your template files and find any instance of the dynamic_sidebar() function. Replace these functions with ww_dynamic_sidebar('corral_slug').

How can I control the widget's template (HTML)?

In the widget-wrangler directory there is a file named 'templates/widget.php'. Copy this file to your theme's root directory and rename it 'widget.php'. You can edit the HTML in the file to have widgets defaultly appear as you want. To template specific widgets, save a copy of templates/widget.php as widget-[widget ID].php in your theme directory. (eg. widget-121.php, where 121 is the widget's ID)

Can I use existing wordpress widgets?

Mostly. Widgets designed for WordPress 3+ are able to be used with the 'Copy WP Widget' option in the Widget Wrangler menu. Widgets programmed for older versions of wordpress may not work.

What does it mean to Copy/Clone a widget?

When you Copy a wordpress widget, it creates a new widget post in the Widget Wrangler system with the settings for the original wordpress widget pre-filled. A copied widget will contain the original widget form for the WP widget.

Requires: 3 or higher
Compatible up to: 3.9.1
Last Updated: 2014-7-27
Downloads: 22,971

Ratings

4 stars
4.4 out of 5 stars

Support

4 of 5 support threads in the last two months have been resolved.

Got something to say? Need help?

Compatibility

+
=
Not enough data

0 people say it works.
0 people say it's broken.

100,2,2 100,1,1 100,1,1
100,2,2 100,1,1
100,2,2 100,1,1 100,1,1 100,1,1 100,1,1
100,1,1 100,1,1
100,1,1 100,1,1
100,1,1 100,1,1
100,1,1 100,1,1 100,1,1 100,1,1 100,1,1
100,2,2 100,2,2 100,1,1 100,1,1
100,2,2 100,3,3 100,3,3 0,1,0 100,1,1 100,2,2 100,4,4 75,4,3
100,2,2 100,2,2 100,1,1 100,2,2
0,1,0
100,1,1 100,1,1 100,1,1 100,1,1
100,1,1 100,1,1 100,1,1
100,1,1