WordPress函数is_registered_sidebar()函数检查侧边栏是否已注册

WordPress函数is_registered_sidebar()函数检查侧边栏是否已注册

　　在 WordPress CMS内容管理系统中，is_registered_sidebar()函数是 WordPress 中内置函数。WordPress PHP 函数is_registered_sidebar () 检查侧边栏是否已注册

　　推荐：[最新版]WordPress SEO插件Rank Math Pro

is_registered_sidebar()函数基本语法

描述

　　为主题加载侧边栏模板

用法

is_registered_sidebar($sidebar_id);

• $sidebar_id(string|int)（必需）– 注册时的侧边栏 ID

　　推荐：WordPress函数add_network_option()添加新的网络选项

is_registered_sidebar()函数

　　在 WordPress 中，该is_registered_sidebar()函数检查侧边栏是否已注册（源文件可参考这里）

function is_registered_sidebar( $sidebar_id ) {
	global $wp_registered_sidebars;

	return isset( $wp_registered_sidebars[ $sidebar_id ] );
}

　　推荐：Max Mega Menu插件教程WordPress添加超级菜单

如何使用is_registered_sidebar()

　　检查特定侧边栏是否已注册检查“自定义侧边栏”是否已注册并相应地显示消息。

if ( is_registered_sidebar( 'custom-sidebar' ) ) {
    echo 'Custom sidebar is registered.';
} else {
    echo 'Custom sidebar is not registered.';
}

　　显示后备侧边栏当首选侧边栏未注册时，显示后备侧边栏。

$preferred_sidebar = 'preferred-sidebar';
$fallback_sidebar = 'fallback-sidebar';

if ( is_registered_sidebar( $preferred_sidebar ) ) {
    dynamic_sidebar( $preferred_sidebar );
} else {
    dynamic_sidebar( $fallback_sidebar );
}

　　仅当尚未注册时才注册侧边栏仅当侧边栏尚未注册时，才使用ID“new-sidebar”注册一个新侧边栏。

$new_sidebar_id = 'new-sidebar';

if ( ! is_registered_sidebar( $new_sidebar_id ) ) {
    register_sidebar( array(
        'id' => $new_sidebar_id,
        'name' => 'New Sidebar',
    ) );
}

　　如果侧边栏已注册，则取消注册如果已注册，请取消注册ID为“unwanted-sidebar”的侧边栏。

$unwanted_sidebar_id = 'unwanted-sidebar';

if ( is_registered_sidebar( $unwanted_sidebar_id ) ) {
    unregister_sidebar( $unwanted_sidebar_id );
}

　　为每个已注册的侧边栏显示一条消息循环遍历侧边栏ID数组并为每个已注册的侧边栏显示一条消息。

$sidebars = array( 'sidebar-1', 'sidebar-2', 'custom-sidebar' );

foreach ( $sidebars as $sidebar_id ) {
    if ( is_registered_sidebar( $sidebar_id ) ) {
        echo "The sidebar '{$sidebar_id}' is registered.";
    }
}

　　推荐：怎么安装Genesis Framework主题框架

　　推荐：WordPress函数使用手册