源代碼

File: wp-includes/widgets.php

function _wp_sidebars_changed() {
	global $sidebars_widgets;

	if ( ! is_array( $sidebars_widgets ) )
		$sidebars_widgets = wp_get_sidebars_widgets();

	retrieve_widgets(true);
}

更新日志

在WordPress中，_wp_sidebars_changed() 是一個內(nèi)部函數(shù)，用于在側(cè)邊欄（widget areas）被添加、更新或刪除時更新側(cè)邊欄的元數(shù)據(jù)。這個函數(shù)通常不應(yīng)該在你的主題或插件代碼中直接調(diào)用，因為它主要是為WordPress內(nèi)部使用而設(shè)計的。
不過，了解這個函數(shù)的工作方式可能有助于你在開發(fā)主題或插件時理解WordPress側(cè)邊欄和widget系統(tǒng)的工作原理。
_wp_sidebars_changed() 函數(shù)不接受任何參數(shù)，并且沒有返回值。當(dāng)你在管理后臺添加、編輯或刪除側(cè)邊欄時，WordPress會在內(nèi)部調(diào)用這個函數(shù)來更新側(cè)邊欄的元數(shù)據(jù)。
下面是該函數(shù)的基本用法：

_wp_sidebars_changed();

由于這個函數(shù)是內(nèi)部的，并且不面向開發(fā)者公開，因此你通常不需要直接使用它。WordPress核心會在適當(dāng)?shù)臅r機自動調(diào)用這個函數(shù)。
如果你正在開發(fā)一個需要操作側(cè)邊欄（widget areas）的插件或主題，你應(yīng)該使用WordPress提供的公共API函數(shù)來添加、刪除或修改側(cè)邊欄。以下是一些相關(guān)的函數(shù)：

• register_sidebar()：用于注冊一個新的側(cè)邊欄。
• unregister_sidebar()：用于注銷一個已注冊的側(cè)邊欄。
• wp_get_sidebars_widgets()：獲取當(dāng)前激活的側(cè)邊欄和小部件。
  以下是一個示例，展示如何使用 register_sidebar() 來添加一個新的側(cè)邊欄：

function my_custom_sidebar() {
    // 注冊一個新的側(cè)邊欄
    register_sidebar( array(
        'name'          => 'My Custom Sidebar',
        'id'            => 'my-custom-sidebar',
        'description'   => 'A custom sidebar for my theme',
        'before_widget' => '<div id="%1$s" class="widget %2$s">',
        'after_widget'  => '</div>',
        'before_title'  => '<h2 class="widgettitle">',
        'after_title'   => '</h2>',
    ) );
}
// 在 'widgets_init' 動作中添加側(cè)邊欄
add_action( 'widgets_init', 'my_custom_sidebar' );

在上面的代碼中，我們定義了一個函數(shù) my_custom_sidebar()，該函數(shù)使用 register_sidebar() 注冊一個新的側(cè)邊欄。然后，我們使用 add_action() 將該函數(shù)掛鉤到 widgets_init 動作上，這樣在WordPress初始化側(cè)邊欄時就會調(diào)用我們的函數(shù)。
請記住，直接使用WordPress的內(nèi)部函數(shù)可能會導(dǎo)致代碼不穩(wěn)定，因為它們可能在未來的WordPress版本中更改或被移除。始終推薦使用公開的API函數(shù)和鉤子來開發(fā)插件和主題。

未經(jīng)允許不得轉(zhuǎn)載：445IT之家 » WordPress函數(shù)_wp_sidebars_changed()用法