Title: Duplicate Widget
Author: Scott Reilly
Published: <strong>2011 年 12 月 12 日</strong>
Last modified: 2012 年 6 月 12 日

---

搜尋外掛

這個外掛**並未在最新的 3 個 WordPress 主要版本上進行測試**。開發者可能不再對這個
外掛進行維護或提供技術支援，並可能會與更新版本的 WordPress 產生使用上的相容性問題。

![](https://s.w.org/plugins/geopattern-icon/duplicate-widget.svg)

# Duplicate Widget

 由 [Scott Reilly](https://profiles.wordpress.org/coffee2code/) 開發

[下載](https://downloads.wordpress.org/plugin/duplicate-widget.1.0.2.zip)

 * [詳細資料](https://tw.wordpress.org/plugins/duplicate-widget/#description)
 * [使用者評論](https://tw.wordpress.org/plugins/duplicate-widget/#reviews)
 *  [安裝方式](https://tw.wordpress.org/plugins/duplicate-widget/#installation)
 * [開發資訊](https://tw.wordpress.org/plugins/duplicate-widget/#developers)

 [技術支援](https://wordpress.org/support/plugin/duplicate-widget/)

## 外掛說明

A widget that can act as a duplicate of another widget (for synchronized use in 
another sidebar)

Define a widget once, use it in multiple sidebars. This saves you from having to
manually configure each copy of the widget and later having to worry about keeping
them in sync should you ever need to make any changes. Particularly useful for those
who define logic in their themes to conditionally include different versions of 
a sidebar depending on what template is being shown. Depending on use, it is an 
alternative to plugins that introduce in-widget logic to determine when widgets 
should be visible (Widget Logic, Section Widget, Conditional Widgets, etc).

Quick overview of what this plugin does:

 * Adds a widget called “Duplicate”. The widget’s only setting is a dropdown listing
   all active widgets. The selected widget will be the widget duplicated by the 
   duplicate widget.
 * A duplicate widget shows the same title and content as its source widget, even
   if those values later get changed in the source widget.
 * A widget can be duplicated any number of times and can appear multiple times 
   within the same page. (Yes, even within the same sidebar, though why would you
   do that?)
 * A duplicate widget will abide by the configuration of the sidebar it is placed
   in, not the configuration of the sidebar containing the source widget. So it 
   uses ‘before_widget’, ‘after_widget’, ‘before_title’, ‘after_title’ values of
   its own sidebar.
 * Widgets that are duplicated will have “[D]” prepended to their name in the widget
   titlebar in the admin to denote they have duplicates. Also, at the bottom of 
   the widget’s configuration form (when the widget is expanded), a short blurb 
   also explains that the widget has duplicate(s) and a count of how many duplicates
   it has.
 * If a widget is deactivated or deleted, if it has any duplicates, they get deleted
   as well.
 * The widget id and widget type of the source widget are included as HTML classes
   in the duplicate widget’s markup.

Links: [Plugin Homepage](http://coffee2code.com/wp-plugins/duplicate-widget/) | 
[Plugin Directory Page](https://wordpress.org/extend/plugins/duplicate-widget/) 
| [Author Homepage](http://coffee2code.com)

### Filters

The plugin exposes four actions for hooking. Typically, customizations utilizing
these hooks would be put into your active theme’s functions.php file, or used by
another plugin.

#### c2c_before_duplicate_widget (action)

The ‘c2c_before_duplicate_widget’ hook allows you to output text, or perform some
sort of action, just before the output of the duplicate widget.

Arguments:

 * $instance (array) : The settings for the widget instance (namely: title and widget_to_duplicate)
 * $args (array) : The configuration for the widget and sidebar

Example:

    ```
    // Output an opening <div> before duplicate widget content
    add_action( 'c2c_before_duplicate_widget', 'my_c2c_before_duplicate_widget', 10, 2 );
    function my_c2c_before_duplicate_widget( $instance, $args ) {
        echo '<div class="a_duplicate_widget">;
    }
    ```

#### c2c_after_duplicate_widget (action)

The ‘c2c_after_duplicate_widget’ hook allows you to output text, or perform some
sort of action, just after the output of the duplicate widget.

Arguments:

 * $instance (array) : The settings for the widget instance (namely: title and widget_to_duplicate)
 * $args (array) : The configuration for the widget and sidebar

Example:

    ```
    // Output an closing </div> after duplicate widget content
    add_action( 'c2c_after_duplicate_widget', 'my_c2c_after_duplicate_widget', 10, 2 );
    function my_c2c_after_duplicate_widget( $instance, $args ) {
        echo '</div>;
    }
    ```

#### c2c_before_duplicate_widget_form (action)

The ‘c2c_before_duplicate_widget_form’ hook allows you to output text, or perform
some sort of action, just before the output of the duplicate widget’s configuration
form (in the WP admin).

Arguments:

 * $instance (array) : The settings for the widget instance (namely: title and widget_to_duplicate)

Example:

    ```
    // Display a message just before the duplicate widget settings form
    add_action( 'c2c_before_duplicate_widget_form', 'my_c2c_before_duplicate_widget_form' );
    function my_c2c_before_duplicate_widget_form( $instance ) {
        echo '<p>Note: this is a note above the widget settings form.</p>';
    }
    ```

#### c2c_after_duplicate_widget_form (action)

The ‘c2c_after_duplicate_widget_form’ hook allows you to output text, or perform
some sort of action, just after the output of the duplicate widget’s configuration
form (in the WP admin).

Arguments:

 * $instance (array) : The settings for the widget instance (namely: title and widget_to_duplicate)

Example:

    ```
    // Display a message just after the duplicate widget settings form
    add_action( 'c2c_after_duplicate_widget_form', 'my_c2c_after_duplicate_widget_form' );
    function my_c2c_after_duplicate_widget_form( $instance ) {
        echo '<p>Note: this is a note below the widget settings form.</p>';
    }
    ```

## 螢幕擷圖

[⌊A screenshot of the "Widgets" admin page. The "Text: Mini Bio" widget in the Main
Sidebar has a duplicate in Footer Area One.⌉⌊A screenshot of the "Widgets" admin
page. The "Text: Mini Bio" widget in the Main Sidebar has a duplicate in Footer 
Area One.⌉[

A screenshot of the “Widgets” admin page. The “Text: Mini Bio” widget in the Main
Sidebar has a duplicate in Footer Area One.

## 安裝方式

 1. Unzip `duplicate-widget.zip` inside the `/wp-content/plugins/` directory for your
    site (or install via the built-in WordPress plugin installer)
 2. Activate the plugin through the ‘Plugins’ admin menu in WordPress
 3. Use the ‘Duplicate’ widget to duplicate any other active widget

## 常見問題集

  Installation Instructions

 1. Unzip `duplicate-widget.zip` inside the `/wp-content/plugins/` directory for your
    site (or install via the built-in WordPress plugin installer)
 2. Activate the plugin through the ‘Plugins’ admin menu in WordPress
 3. Use the ‘Duplicate’ widget to duplicate any other active widget

  What happens to the duplicate(s) of a widget when that widget gets deactivated
or deleted?

When a widget gets deactivated (dragged to the “Inactive Widgets” section of the
widgets admin page) or deleted, all of its duplicates get deleted. The plugin provides
numerous cues to make you aware of what widgets have duplicates.

  Why can’t I see a newly added widget as an option in a duplicate widget’s dropdown?

If a widget is newly activated, any existing active duplicate widgets will not have
it listed in their dropdowns immediately. Either a page reload must occur or the
duplicate widget must be saved (which causes the widget to be retrieved via AJAX
and thus the dropdown is regenerated).

  Can a widget be duplicated into another sidebar on the same page (so it’ll appear
twice on the page)?

Yes.

## 使用者評論

這個外掛目前沒有任何使用者評論。

## 參與者及開發者

以下人員參與了開源軟體〈Duplicate Widget〉的開發相關工作。

參與者

 *   [ Scott Reilly ](https://profiles.wordpress.org/coffee2code/)

[將〈Duplicate Widget〉外掛本地化為台灣繁體中文版](https://translate.wordpress.org/projects/wp-plugins/duplicate-widget)

### 對開發相關資訊感興趣？

任何人均可[瀏覽程式碼](https://plugins.trac.wordpress.org/browser/duplicate-widget/)、
查看 [SVN 存放庫](https://plugins.svn.wordpress.org/duplicate-widget/)，或透過 [RSS](https://plugins.trac.wordpress.org/log/duplicate-widget/?limit=100&mode=stop_on_copy&format=rss)
訂閱[開發記錄](https://plugins.trac.wordpress.org/log/duplicate-widget/)。

## 變更記錄

#### 1.0.2

 * Use string instead of variable to specify translation textdomain
 * Re-license as GPLv2 or later (from X11)
 * Add ‘License’ and ‘License URI’ header tags to readme.txt and plugin file
 * Remove ending PHP close tag
 * Note compatibility through WP 3.4+

#### 1.0.1

 * Minor bugfixes
 * Add Upgrade Notice section to readme.txt

#### 1.0

 * Initial release

## 中繼資料

 *  版本 **1.0.2**
 *  最後更新 **9 年前**
 *  啟用安裝數 **1,000+**
 *  WordPress 版本需求 ** 3.1 或更新版本 **
 *  已測試相容的 WordPress 版本 **3.4.2**
 *  語言
 * [English (US)](https://wordpress.org/plugins/duplicate-widget/)
 * 標籤:
 * [coffee2code](https://tw.wordpress.org/plugins/tags/coffee2code/)[duplicate](https://tw.wordpress.org/plugins/tags/duplicate/)
   [sidebar](https://tw.wordpress.org/plugins/tags/sidebar/)[widget](https://tw.wordpress.org/plugins/tags/widget/)
   [widgets](https://tw.wordpress.org/plugins/tags/widgets/)
 *  [進階檢視](https://tw.wordpress.org/plugins/duplicate-widget/advanced/)

## 評分

 4.3 星，滿分為 5 星

 *  [  9 個 5 星使用者評論     ](https://wordpress.org/support/plugin/duplicate-widget/reviews/?filter=5)
 *  [  1 個 4 星使用者評論     ](https://wordpress.org/support/plugin/duplicate-widget/reviews/?filter=4)
 *  [  0 個 3 星使用者評論     ](https://wordpress.org/support/plugin/duplicate-widget/reviews/?filter=3)
 *  [  1 個 2 星使用者評論     ](https://wordpress.org/support/plugin/duplicate-widget/reviews/?filter=2)
 *  [  1 個 1 星使用者評論     ](https://wordpress.org/support/plugin/duplicate-widget/reviews/?filter=1)

[Your review](https://wordpress.org/support/plugin/duplicate-widget/reviews/#new-post)

[查看全部使用者評論](https://wordpress.org/support/plugin/duplicate-widget/reviews/)

## 參與者

 *   [ Scott Reilly ](https://profiles.wordpress.org/coffee2code/)

## 技術支援

使用者可在技術支援論壇提出意見反應或使用問題。

 [檢視技術支援論壇](https://wordpress.org/support/plugin/duplicate-widget/)

## 贊助

想要支援這個外掛的發展嗎？

 [ 贊助這個外掛 ](http://coffee2code.com/donate)