Description
Compatible with PHP 8.2
Widget Alias allows you to create an “alias” of any existing widget, effectively reproducing / duplicating it. This can be especially handy when you want the same widget to appear in multiple sidebars. Normally you would have to edit each widget independently, but Widget Alias means you’ll only have to edit one.
A MIGHTYminnow plugin.
Features
This plugin is similar to Duplicate Widget, with a few key differences:
- Widget Alias gives you the option to override the aliased widget’s title.
- Widget Alias uses AJAX to update the drop-down
<select>
menus on the fly, which means you see widget changes (adding widgets, deleting widgets, re-ordering widgets, etc) in real time. - If you delete a widget that is being aliased, the aliased copies simply revert to “None”, instead of being deleted. This allows you to keep track of where you’ve used Widget Alias widgets, if need be.
Usage
Widget Alias can be used in one of two ways:
1. Widget
In Appearances > Widgets you’ll see a new widget called “Widget Alias”, in which you can specify an override title if desired, and use the drop-down <select>
menu to choose the ID of the widget you would like to alias.
2. Shortcode
Widget Alias also comes packaged with a shortcode that looks like this:
[widget_alias id=”target-widget-id” title=”Override Title”]
To use the shortcode simply enter the ID of the widget you would like to alias (id
parameter), and an override title (title
parameter) if you would like to change the aliased widget’s title.
Widget IDs
Widget Alias makes it super-easy for you to find the ID of any widget you would like to alias. In Appearance > Widgets, all active widgets now have their ID appended below the widget title. Note: these IDs are added using jQuery, and will not appear if JavaScript is disabled.
Removing / Deleting Aliased Widgets
Widget Alias makes it easy to tell which widgets are being aliased – each aliased widget has a note below its widget controls letting you know how many times it is aliased. If you delete an aliased widget, the Widget Alias widgets that previously pointed to it will revert to the default alias value of “None.”
Banner photo by Susannah Kay.
Installation
Install and activate the plugin. That’s it! You’ll now have access to the Widget Alias widget via Appearance > Widgets, as well as the [wa]
shortcode.
Reviews
Contributors & Developers
“Widget Alias” is open source software. The following people have contributed to this plugin.
ContributorsTranslate “Widget Alias” into your language.
Interested in development?
Browse the code, check out the SVN repository, or subscribe to the development log by RSS.
Changelog
1.7.3
- Fix deprecated “ready” event.
1.7.2
- Update jQuery to show widget ID’s in the customizer.
- Enqueue scripts and styles only on the widgets and customizer pages.
- Refactor code to enclose previously global variables/functions, and prefix all functions.
1.7.1
- Fix deprecated widget constructor call.
1.7
- Fix issue with shortcode method throwing error.
1.6
- Add missing .pot file.
1.5
- Add extra JS conditional to prevent AJAX errors.
1.4
- Fixed bug in which Widget Alias would cause all widgets to disappear
- Added more efficient jQuery
- Improved admin styling
1.3
- Fixed bug in which Widget Alias was simply echoing widget output, instead of returning it in the correct location.
1.2
- Further modifications to JS and CSS to utilize default WP admin classes for improved aesthetics.
1.1
- Modified JS and CSS to improve the display of each widget’s ID
1.0
- First release