Title: Widget Instance
Author: Global
Published: <strong>2012 年 6 月 11 日</strong>
Last modified: 2018 年 7 月 11 日

---

搜索插件

![](https://ps.w.org/widget-instance/assets/banner-772x250.jpg?rev=1187239)

**该插件尚未通过WordPress的最新3个主要版本进行测试**。 当与较新版本的WordPress一起
使用时，可能不再受到维护或支持，并且可能会存在兼容性问题。

![](https://ps.w.org/widget-instance/assets/icon-256x256.jpg?rev=1187239)

# Widget Instance

 作者：[Global](https://profiles.wordpress.org/global_1981/)

[下载](https://downloads.wordpress.org/plugin/widget-instance.zip)

 * [详情](https://cn.wordpress.org/plugins/widget-instance/#description)
 * [评价](https://cn.wordpress.org/plugins/widget-instance/#reviews)
 *  [安装](https://cn.wordpress.org/plugins/widget-instance/#installation)
 * [开发进展](https://cn.wordpress.org/plugins/widget-instance/#developers)

 [支持](https://wordpress.org/support/plugin/widget-instance/)

## 描述

Widgets are normally displayed as part of a sidebar using the dynamic_sidebar()

function. There is the_widget function for static widgets, but there is no equivalent
for specific widgets configured in the Appearance > Widgets area.

The Widget Instance plugin allows WordPress users of all abilities to display
 these
widgets outside of the sidebars they have been assigned to.

Features

 1. A wysiwyg editor button for selecting available widgets,
 2. A shortcode [widget_instance id=”[widget_id]”],
 3. A theme action do_action(‘widget_instance’, [widget_id]) and finally
 4. Utility functions for developers get_widget_instance and widget_instance

Usage

 * [widget_instance id=”[widget_id]”]
 * do_action(‘widget_instance’, ‘[widget_id]’);
 * the_widget_instance(‘[widget_id]’);
 * get_the_widget_instance(‘[widget_id]’);

## 屏幕截图

 * [[
 * The Widget Instance editor button
 * [[
 * The editor dialog for inserting a specific widget instance

## 安装

This section describes how to install the plugin and get it working.

 1. Upload `widget-instance` to the `/wp-content/plugins/` directory
 2. 通过WordPress的的“Plugins”菜单激活插件
 3. Within the editor, you can use the Widget Instance editor button to select
     from
    available widgets or enter a shortcode following the syntax: [widget_instance id
    =”[widget_id]”]
 4. Optional step: If you would like to retain the sidebar format of the widget, check
    the Include Sidebar format checkbox
 5. Within template files you can use the following php snippets:

 * Action: do_action(‘widget_instance’, ‘[widget_id]’);
 * Function: the_widget_instance(‘[widget_id]’);
 * Function: get_the_widget_instance(‘[widget_id]’);

## 常见问题

  How do I get the widget id?

Of course the editor button automagically retrieves all the available widgets
 (
and their ids) for you, but if you are using one of the PHP functions, you can get
the available widget ids by looping over the array returned by the function wp_get_sidebars_widgets()

## 评价

![](https://secure.gravatar.com/avatar/6dbf7eec55bede15de45e3ffe70c64119ebcfc1ed578a8f847bef939b02eef35?
s=60&d=retro&r=g)

### 󠀁[Works, but not with widgets that need parameters](https://wordpress.org/support/topic/works-but-not-with-widgets-that-need-parameters/)󠁿

 [jeroenm77](https://profiles.wordpress.org/jeroenm77/) 2018 年 9 月 3 日

Works, if you need a widget that doesn’t need parameters.

![](https://secure.gravatar.com/avatar/02f1f7a1add6beadf074cfe6c5957fde3be39f84739263a073b84e538e8988dd?
s=60&d=retro&r=g)

### 󠀁[Works as expected!](https://wordpress.org/support/topic/works-as-expected-303/)󠁿

 [luigitec](https://profiles.wordpress.org/luigitec/) 2017 年 5 月 9 日

Nice plugin, it does what I needed.

![](https://secure.gravatar.com/avatar/cecc642a78e07c4546e7a53a71ae2b1dba80ea102cac14441f23f93cebdf3e59?
s=60&d=retro&r=g)

### 󠀁[good](https://wordpress.org/support/topic/good-2413/)󠁿

 [pierrechecy](https://profiles.wordpress.org/pierrechecy/) 2017 年 3 月 13 日

use with other plugin “Category Posts Widget” and template Customizr very easy

![](https://secure.gravatar.com/avatar/96f3c753920654ef8d0690b3edd5f63b2639318d9262eccf4ae94932ddbad7b6?
s=60&d=retro&r=g)

### 󠀁[5 Stars Plugin. Great Great](https://wordpress.org/support/topic/5-stars-plugin-great-great/)󠁿

 [ireneml](https://profiles.wordpress.org/ireneml/) 2016 年 9 月 3 日

This plugin has saved me a lot of work and has given me all the answers I was looking
for a long time ago. Thank you very much Ben.

![](https://secure.gravatar.com/avatar/6a5c88c71ae27ce729c94c08888d7bf109298f4ae13d6667161eff14567da8f0?
s=60&d=retro&r=g)

### 󠀁[Great plugin, thank you! Also provided a solution for the dropdown issue](https://wordpress.org/support/topic/great-plugin-thank-you-also-provided-a-solution-for-the-dropdown-issue/)󠁿

 [Immánuel Fodor](https://profiles.wordpress.org/immanuelfactor/) 2016 年 9 月 3
日

If anybody has the no widges in the dropdown issue, I posted a solution, just see
here: [SOLVED] No widgets in the dropdown I hope this helps! 🙂

 [ 阅读所有9条评价 ](https://wordpress.org/support/plugin/widget-instance/reviews/)

## 贡献者及开发者

「Widget Instance」是开源软件。 以下人员对此插件做出了贡献。

贡献者

 *   [ Global ](https://profiles.wordpress.org/global_1981/)

[帮助将「Widget Instance」翻译成简体中文。](https://translate.wordpress.org/projects/wp-plugins/widget-instance)

### 对开发感兴趣吗?

您可以[浏览代码](https://plugins.trac.wordpress.org/browser/widget-instance/)，查看
[SVN仓库](https://plugins.svn.wordpress.org/widget-instance/)，或通过[RSS](https://plugins.trac.wordpress.org/log/widget-instance/?limit=100&mode=stop_on_copy&format=rss)
订阅[开发日志](https://plugins.trac.wordpress.org/log/widget-instance/)。

## 更新日志

#### 0.9.5

 * Tested in WordPress 4.9.7

#### 0.9.4

 * Included Immánuel Fodor’s fix for empty dropdown

#### 0.9.3

 * Tested in WordPress 4.2.2, new banner, icons and tinymce button created.

#### 0.9.2

 * Added javascript loader, fix for wordpress installs where wp-includes url is 
   not in the root.

#### 0.9.1

 * Can now select a widget by it’s title as well as its id. The title is in parenthesis
   after the id.

#### 0.9

 * Tested on 3.5.1
 * Fixed php warnign typo

#### 0.8

 * Tested on 3.4.1
 * Added option for including sidebar formatting
 * The widget’s title will now include the sidebar title markup (More useful than
   having a plain text title)

#### 0.5

 * Initial release

## 额外信息

 *  版本 **0.9.4**
 *  最后更新：**8 年前**
 *  活跃安装数量 **500+**
 *  WordPress 版本 ** 2.9.1 或更高版本 **
 *  已测试的最高版本为 **4.9.29**
 *  语言
 * [English (US)](https://wordpress.org/plugins/widget-instance/)
 * 标签
 * [display widget](https://cn.wordpress.org/plugins/tags/display-widget/)[widget](https://cn.wordpress.org/plugins/tags/widget/)
   [widget instance](https://cn.wordpress.org/plugins/tags/widget-instance/)[widgets](https://cn.wordpress.org/plugins/tags/widgets/)
 *  [高级视图](https://cn.wordpress.org/plugins/widget-instance/advanced/)

## 评级

 3.4 星（最高 5 星）。

 *  [  5 条 5 星评价     ](https://wordpress.org/support/plugin/widget-instance/reviews/?filter=5)
 *  [  0 条 4 星评价     ](https://wordpress.org/support/plugin/widget-instance/reviews/?filter=4)
 *  [  1 条 3 星评价     ](https://wordpress.org/support/plugin/widget-instance/reviews/?filter=3)
 *  [  0 条 2 星评价     ](https://wordpress.org/support/plugin/widget-instance/reviews/?filter=2)
 *  [  3 条 1 星评价     ](https://wordpress.org/support/plugin/widget-instance/reviews/?filter=1)

[添加我的评价](https://wordpress.org/support/plugin/widget-instance/reviews/#new-post)

[查看全部评论](https://wordpress.org/support/plugin/widget-instance/reviews/)

## 贡献者

 *   [ Global ](https://profiles.wordpress.org/global_1981/)

## 支持

有话要说吗？是否需要帮助？

 [查看支持论坛](https://wordpress.org/support/plugin/widget-instance/)

## 捐助

您愿意支持这个插件的发展吗?

 [ 捐助此插件 ](http://bcooling.com.au)