* @copyright Copyright (c) 2008 - 2017, Justin Tadlock
* @link https://themehybrid.com/hybrid-core
* @license http://www.gnu.org/licenses/old-licenses/gpl-2.0.html
*/
/**
* Wrapper function for WordPress' register_sidebar() function. This function exists so that theme authors
* can more quickly register sidebars with an HTML5 structure instead of having to write the same code
* over and over. Theme authors are also expected to pass in the ID, name, and description of the sidebar.
* This function can handle the rest at that point.
*
* @since 2.0.0
* @access public
* @param array $args
* @return string Sidebar ID.
*/
function hybrid_register_sidebar( $args ) {
// Set up some default sidebar arguments.
$defaults = array(
'id' => '',
'name' => '',
'description' => '',
'before_widget' => '',
'before_title' => ''
);
// Parse the arguments.
$args = wp_parse_args( $args, apply_filters( 'hybrid_sidebar_defaults', $defaults ) );
// Remove action.
remove_action( 'widgets_init', '__return_false', 95 );
// Register the sidebar.
return register_sidebar( apply_filters( 'hybrid_sidebar_args', $args ) );
}
# Compatibility for when a theme doesn't register any sidebars.
add_action( 'widgets_init', '__return_false', 95 );
/**
* Function for grabbing a dynamic sidebar name.
*
* @since 2.0.0
* @access public
* @global array $wp_registered_sidebars
* @param string $sidebar_id
* @return string
*/
function hybrid_get_sidebar_name( $sidebar_id ) {
global $wp_registered_sidebars;
return isset( $wp_registered_sidebars[ $sidebar_id ] ) ? $wp_registered_sidebars[ $sidebar_id ]['name'] : '';
}
/**
* Checks if a widget exists. Pass in the widget class name. This function is useful for
* checking if the widget exists before directly calling `the_widget()` within a template.
*
* @since 4.0.0
* @access public
* @param string $widget
* @return bool
*/
function hybrid_widget_exists( $widget ) {
return isset( $GLOBALS['wp_widget_factory']->widgets[ $widget ] );
}