当我开始这个答案时，应该只是一个小字条。好吧，我失败了。抱歉! 和我呆在一起，里面藏着一个好东西……
WordPress小部件的存储方式
小部件列表存储在名为的选项中'sidebars_widgets'。A var_export()可能会给出以下内容：
array (
'wp_inactive_widgets' =>
array (
),
'top-widget' =>
array (
),
'bottom-widget' =>
array (
),
'array_version' => 3,
)
忽略'wp_inactive_widgets'和'array_version'。我们不必关心那些。
其他键是注册侧边栏的标识符。在这种情况下，侧栏可能已使用以下代码注册：
// Register two sidebars.
$sidebars = array ( 'a' => 'top-widget', 'b' => 'bottom-widget' );
foreach ( $sidebars as $sidebar )
{
register_sidebar(
array (
'name' => $sidebar,
'id' => $sidebar,
'before_widget' => '',
'after_widget' => ''
)
);
}
默认情况下，边栏在注册后为空。当然。
对于每个注册的窗口小部件类，将创建一个单独的选项，其中包含所有必需的选项。该选项以字符串为前缀widget_。要获得所有活动RSS小部件的选项，我们必须研究…
get_option( 'widget_rss' );
可能的输出：
array (
2 =>
array (
'title' => 'WordPress Stack Exchange',
'url' => 'http://wordpress.stackexchange.com/feeds',
'link' => 'http://wordpress.stackexchange.com/questions',
'items' => 5,
'show_summary' => 1,
'show_author' => 0,
'show_date' => 0,
),
)
注意数字2。多个实例的参数全部存储在此选项中，并按数字排序。
要查看WordPress已经知道哪些窗口小部件类，请wp-admin/options.php向下滚动直到看到类似这样的内容：
是的，序列化数据。不，您在这里看不到它们。不用担心，您不必。
演示小部件
为了更好地说明内部工作原理，我编写了一个非常简单的演示小部件：
/**
* Super simple widget.
*/
class T5_Demo_Widget extends WP_Widget
{
public function __construct()
{ // id_base , visible name
parent::__construct( 't5_demo_widget', 'T5 Demo Widget' );
}
public function widget( $args, $instance )
{
echo $args['before_widget'], wpautop( $instance['text'] ), $args['after_widget'];
}
public function form( $instance )
{
$text = isset ( $instance['text'] )
? esc_textarea( $instance['text'] ) : '';
printf(
'<textarea class="widefat" rows="7" cols="20" id="%1$s" name="%2$s">%3$s</textarea>',
$this->get_field_id( 'text' ),
$this->get_field_name( 'text' ),
$text
);
}
}
注意构造函数：'t5_demo_widget'是$id_base此窗口小部件的标识符。如屏幕截图所示，其参数存储在option中widget_t5_demo_widget。您所有的自定义小部件都将被这样处理。您不必猜测名称。并且由于您已经编写了小部件（可能），因此您知道了类$instance参数中的所有参数。
主题基础
首先，您必须注册一些侧栏和自定义窗口小部件。对此的正确操作很容易记住：'widgets_init'。将所有内容放入容器–类或函数。为简单起见，我将使用名为的函数t5_default_widget_demo()。
以下所有代码都放入functions.php。该类T5_Demo_Widget应该已经加载。我只是把它放在同一个文件中...
add_action( 'widgets_init', 't5_default_widget_demo' );
function t5_default_widget_demo()
{
// Register our own widget.
register_widget( 'T5_Demo_Widget' );
// Register two sidebars.
$sidebars = array ( 'a' => 'top-widget', 'b' => 'bottom-widget' );
foreach ( $sidebars as $sidebar )
{
register_sidebar(
array (
'name' => $sidebar,
'id' => $sidebar,
'before_widget' => '',
'after_widget' => ''
)
);
}
到目前为止，如此简单。现在我们的主题已经准备就绪，小部件已众所周知。现在好玩。
$active_widgets = get_option( 'sidebars_widgets' );
if ( ! empty ( $active_widgets[ $sidebars['a'] ] )
or ! empty ( $active_widgets[ $sidebars['b'] ] )
)
{ // Okay, no fun anymore. There is already some content.
return;
}
您确实不想破坏用户设置。如果侧边栏中已经有一些内容，则您的代码不应在其上运行。这就是我们在这种情况下停止的原因。
好的，假设边栏为空...我们需要一个计数器：
$counter = 1;
小部件编号。这些数字是WordPress的第二个标识符。
让我们来更改它的数组：
$active_widgets = get_option( 'sidebars_widgets' );
我们也需要一个计数器（稍后再介绍）：
$counter = 1;
这就是我们使用计数器，侧边栏名称和小部件参数的方式（嗯，我们只有一个参数：）text。
// Add a 'demo' widget to the top sidebar …
$active_widgets[ $sidebars['a'] ][0] = 't5_demo_widget-' . $counter;
// … and write some text into it:
$demo_widget_content[ $counter ] = array ( 'text' => "This works!\n\nAmazing!" );
$counter++;
注意如何创建窗口小部件标识符：id_base，减号-和计数器。小部件的内容存储在另一个变量中$demo_widget_content。这是密钥和小部件参数存储在数组中的计数器。
为了避免冲突，我们将计数器加一。
那很简单。现在是一个RSS小部件。更多字段，更多乐趣！
$active_widgets[ $sidebars['a'] ][] = 'rss-' . $counter;
// The latest 15 questions from WordPress Stack Exchange.
$rss_content[ $counter ] = array (
'title' => 'WordPress Stack Exchange',
'url' => 'http://wordpress.stackexchange.com/feeds',
'link' => 'http://wordpress.stackexchange.com/questions',
'items' => 15,
'show_summary' => 0,
'show_author' => 1,
'show_date' => 1,
);
update_option( 'widget_rss', $rss_content );
$counter++;
这是新内容：update_option()它将RSS小部件参数存储在单独的选项中。WordPress稍后会自动找到它们。
我们没有保存演示小部件参数，因为我们现在在第二个侧边栏中添加了第二个实例……
// Okay, now to our second sidebar. We make it short.
$active_widgets[ $sidebars['b'] ][] = 't5_demo_widget-' . $counter;
#$demo_widget_content = get_option( 'widget_t5_demo_widget', array() );
$demo_widget_content[ $counter ] = array ( 'text' => 'The second instance of our amazing demo widget.' );
update_option( 'widget_t5_demo_widget', $demo_widget_content );
…一口气保存所有参数t5_demo_widget。无需两次更新同一选项。
好了，今天有足够的小部件，让我们也保存一下sidebars_widgets：
update_option( 'sidebars_widgets', $active_widgets );
现在，WordPress将知道有一些已注册的小部件以及每个小部件的参数存储在哪里。var_export()sidebar_widgets上的A 将如下所示：
array (
'wp_inactive_widgets' =>
array (
),
'top-widget' =>
array (
0 => 't5_demo_widget-1',
1 => 'rss-2',
),
'bottom-widget' =>
array (
0 => 't5_demo_widget-3',
),
'array_version' => 3,
)
将完整的 代码再次：
add_action( 'widgets_init', 't5_default_widget_demo' );
function t5_default_widget_demo()
{
// Register our own widget.
register_widget( 'T5_Demo_Widget' );
// Register two sidebars.
$sidebars = array ( 'a' => 'top-widget', 'b' => 'bottom-widget' );
foreach ( $sidebars as $sidebar )
{
register_sidebar(
array (
'name' => $sidebar,
'id' => $sidebar,
'before_widget' => '',
'after_widget' => ''
)
);
}
// Okay, now the funny part.
// We don't want to undo user changes, so we look for changes first.
$active_widgets = get_option( 'sidebars_widgets' );
if ( ! empty ( $active_widgets[ $sidebars['a'] ] )
or ! empty ( $active_widgets[ $sidebars['b'] ] )
)
{ // Okay, no fun anymore. There is already some content.
return;
}
// The sidebars are empty, let's put something into them.
// How about a RSS widget and two instances of our demo widget?
// Note that widgets are numbered. We need a counter:
$counter = 1;
// Add a 'demo' widget to the top sidebar …
$active_widgets[ $sidebars['a'] ][0] = 't5_demo_widget-' . $counter;
// … and write some text into it:
$demo_widget_content[ $counter ] = array ( 'text' => "This works!\n\nAmazing!" );
#update_option( 'widget_t5_demo_widget', $demo_widget_content );
$counter++;
// That was easy. Now a RSS widget. More fields, more fun!
$active_widgets[ $sidebars['a'] ][] = 'rss-' . $counter;
// The latest 15 questions from WordPress Stack Exchange.
$rss_content[ $counter ] = array (
'title' => 'WordPress Stack Exchange',
'url' => 'http://wordpress.stackexchange.com/feeds',
'link' => 'http://wordpress.stackexchange.com/questions',
'items' => 15,
'show_summary' => 0,
'show_author' => 1,
'show_date' => 1,
);
update_option( 'widget_rss', $rss_content );
$counter++;
// Okay, now to our second sidebar. We make it short.
$active_widgets[ $sidebars['b'] ][] = 't5_demo_widget-' . $counter;
#$demo_widget_content = get_option( 'widget_t5_demo_widget', array() );
$demo_widget_content[ $counter ] = array ( 'text' => 'The second instance of our amazing demo widget.' );
update_option( 'widget_t5_demo_widget', $demo_widget_content );
// Now save the $active_widgets array.
update_option( 'sidebars_widgets', $active_widgets );
}
如果现在转到，wp-admin/widgets.php您将看到三个预设的小部件：
就是这样。采用 …
dynamic_sidebar( 'top-widget' );
dynamic_sidebar( 'bottom-widget' );
…打印小部件。
有一个小故障：您必须为前端注册两次加载前端。如果有人可以在这里帮助我，我将非常感激。