WordPress.org

Plugin Directory

amr shortcode any widget

Include any widget in a page for any theme. [do_widget widgetname ] or [do_widget "widget name" ] [do_widget id=widgetnamedashed-n ]or inc

  1. Test your chosen widget in a normal sidebar or widget area first.
  2. Then activate this plugin
  3. Go to Appearance > widgets and find the " widgets for shortcode" sidebar or widget area
  4. Drag your chosen widget from your normal sidebar to the shortcodes sidebar. Save.
  5. Now go to a page and enter a do_widget shortcode The shortcode any widget settings page has some helpful (hopefully) examples and links.
  • [do_widget widgetname] eg: [do_widget calendar]
  • [do_widget "widget name"]. eg: [do_widget "tag cloud"]
  • [do_widget id=widgetid] . eg: [do_widget id=tag-cloud-3]

  • [do_widget_area] (will use the "widgets in shortcodes" widget area / sidebar

  • [do_widget_area sidebarname] or [do_widget_area widget_area=sidebarname] for another sidebar or widget area - eg: to maximise likelihood of getting your theme's widget css to apply.

[do_widget ...] Parameters:

  • nameofwidget or name="nameofwidget" This is NOT the title of the widget. THis is the name that you see in the widgets menu page even when unassigned to a sidebar. For existing users , you can also use just the name of the widget without name=. It must be the first parameter then. You can only do this with the name, not the id.
  • id=wordpress assigned id of widget. Examples: id=meta-3, id=tag-cloud-9 etc
  • title=false to hide the widgets title OR to override your themes first sidebar html settings for widget titles, use title=htmltag where htmltag is one of h1,h2,h3,h4,h5,header,strong,em.
  • wrap=htmltag where htmltag is one of div,p,main,aside,section. This will override your themes first sidebar widget wrapping html.
  • widget_classes=none This will remove the class "widget" from the wrapping html and the class "widget_title" from the title html. This may be enough to remove any unwanted css caused by your theme.
  • class=yourclassname By default the plugin will add a class of amr-widget to the wrapping html. You can use this to add any special css. Add css either by editing your themes stylesheet if it is a custom theme, or using something like the wordpress custom css plugin.
  • sidebar="sidebarname" will default to widgets_for_shortcode sidebar. Only use if you want to re-use a widget already being used in another sidebar. THis is theme dependent and WILL break if you change themes. Safer to use the widget_id.

[do_widget_area ...] Parameters:

  • widget_area=yourwidgetarea defaults to 'widgets_for_shortcodes' if nothing entered
  • widget_area_class=none /* option to remove theme styling by removing the widget_area class from the sidebar html */
  • widget_classes=none /* option to remove the widget class from the widget wrappinghtml
  • class=yourclassname default is amr_widget_area. This will affect the widget area NOT the individual widgets. At the moment can only remove the widget classes, not replace them when using do_widget_area.

Advanced users WARNING: using do_widget_area with a widget area other than the shortcode one means that if you changes themes and the new theme has different sidebars, then this shortcode with a named widget area will not work.

See the settings page for links to help your create the shortcodes in a page.

The plugin has been tested with most standard widgets (rss feeds, tag cloud, pages, meta, search, and of course my own plugins widgets - upcoming events list, calendar and user lists.

If you use a widget more than once for different reasons, you may need to use the widget id to isolate which widget instance and it's settings to use. ie: [do_widget id=categories-6] . If you just use the name, it will display all widgets in the shortcode sidebar with that name (all instances).

If you liked this plugin, you might also like my other plugins:

  • icalevents.com - a ics compliant events plugin fully integrated with wordpress, so it will work with many other plugins (seo, maps, social)
  • wpusersplugin.com - a suite of plugins to help with membership sites. Major plugin is amr users

Compatible up to: 4.5.3
Last Updated: 4 months ago
Active Installs: 70,000+

Ratings

4.5 out of 5 stars

Support

1 of 3 support threads in the last two months have been marked resolved.

Got something to say? Need help?

Compatibility

+
=
Not enough data

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

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