Skip to content

MIGHTYminnow/widget-alias

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

27 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

=== Widget Alias ===
Contributors:      McGuive7, MIGHTYminnow
Donate link:       http://mightyminnow.com
Tags:              duplicate, widget, alias, reproduce, synchronize, mimic, sidebar, widgets, shortcode, specific, multiple
Requires at least: 3.0
Tested up to:      6.6.1
Stable tag:        1.7.3
License:           GPLv2 or later
License URI:       http://www.gnu.org/licenses/gpl-2.0.html

Duplicate any existing widget using the Widget Alias widget and shortcode.

== 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**](http://mightyminnow.com) plugin.

= Features =
This plugin is similar to [Duplicate Widget](http://wordpress.org/plugins/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](http://susannahkay.com).

== 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.

== Screenshots ==
1. Widget Alias Features

== 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

== Upgrade Notice ==

= 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

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Packages

No packages published

Languages

  • PHP 67.8%
  • JavaScript 30.2%
  • CSS 2.0%