'my-sidebar',
* 'name' => __( 'My Sidebar', 'my-theme-text-domain' ),
* 'description' => __( 'A description of the intended purpose or location', 'my-theme-text-domain' ),
* )
* );
* ~~~
*
* @since 2.1.0
*
* @param string|array $args Name, ID, description and other widget area arguments.
* @return string The sidebar ID that was added.
*/
function genesis_register_widget_area( $args ) {
$defaults = array(
'before_widget' => genesis_markup( array(
'open' => '' . "\n",
'context' => 'widget-wrap',
'echo' => false,
) ),
'before_title' => '\n",
);
/**
* A filter on the default parameters used by `genesis_register_widget_area()`. For backward compatibility.
*
* @since 1.0.1
*/
$defaults = apply_filters( 'genesis_register_sidebar_defaults', $defaults, $args );
/**
* A filter on the default parameters used by `genesis_register_widget_area()`.
*
* @since 2.1.0
*/
$defaults = apply_filters( 'genesis_register_widget_area_defaults', $defaults, $args );
$args = wp_parse_args( $args, $defaults );
return register_sidebar( $args );
}
/**
* An alias for `genesis_register_widget_area()`.
*
* @since 1.0.1
*
* @param string|array $args Name, ID, description and other widget area arguments.
* @return string The sidebar ID that was added.
*/
function genesis_register_sidebar( $args ) {
return genesis_register_widget_area( $args );
}
add_action( 'genesis_setup', 'genesis_register_default_widget_areas' );
/**
* Hook the callback that registers the default Genesis widget areas.
*
* @since 1.6.0
*/
function genesis_register_default_widget_areas() {
// Temporarily register placeholder widget areas, so that child themes can unregister directly in functions.php.
genesis_register_widget_area( array(
'id' => 'header-right',
) );
genesis_register_widget_area( array(
'id' => 'sidebar',
) );
genesis_register_widget_area( array(
'id' => 'sidebar-alt',
) );
// Call all final widget area registration after themes setup, so text can be translated.
add_action( 'after_setup_theme', '_genesis_register_default_widget_areas_cb' );
add_action( 'after_setup_theme', 'genesis_register_footer_widget_areas' );
add_action( 'after_setup_theme', 'genesis_register_after_entry_widget_area' );
}
/**
* Register the default Genesis widget areas, if the placeholder widget areas are still registered.
*
* @since 2.2.0
*/
function _genesis_register_default_widget_areas_cb() {
global $wp_registered_sidebars;
if ( isset( $wp_registered_sidebars['header-right'] ) ) {
genesis_register_widget_area(
array(
'id' => 'header-right',
'name' => is_rtl() ? __( 'Header Left', 'genesis' ) : __( 'Header Right', 'genesis' ),
'description' => __( 'This is the header widget area. It typically appears next to the site title or logo. This widget area is not suitable to display every type of widget, and works best with a custom menu, a search form, or possibly a text widget.', 'genesis' ),
'_genesis_builtin' => true,
)
);
}
if ( isset( $wp_registered_sidebars['sidebar'] ) ) {
genesis_register_widget_area(
array(
'id' => 'sidebar',
'name' => __( 'Primary Sidebar', 'genesis' ),
'description' => __( 'This is the primary sidebar if you are using a two or three column site layout option.', 'genesis' ),
'_genesis_builtin' => true,
)
);
}
if ( isset( $wp_registered_sidebars['sidebar-alt'] ) ) {
genesis_register_widget_area(
array(
'id' => 'sidebar-alt',
'name' => __( 'Secondary Sidebar', 'genesis' ),
'description' => __( 'This is the secondary sidebar if you are using a three column site layout option.', 'genesis' ),
'_genesis_builtin' => true,
)
);
}
}
/**
* Register footer widget areas based on the number of widget areas the user wishes to create with `add_theme_support()`.
*
* @since 1.6.0
*
* @return void Return early if there is no theme support for `genesis-footer-widgets`
* or the number of widgets given is not set or not numeric.
*/
function genesis_register_footer_widget_areas() {
$footer_widgets = get_theme_support( 'genesis-footer-widgets' );
if ( ! $footer_widgets || ! isset( $footer_widgets[0] ) || ! is_numeric( $footer_widgets[0] ) ) {
return;
}
$footer_widgets = (int) $footer_widgets[0];
$counter = 1;
while ( $counter <= $footer_widgets ) {
genesis_register_widget_area(
array(
'id' => sprintf( 'footer-%d', $counter ),
/* translators: %d: Footer widget counter. */
'name' => sprintf( __( 'Footer %d', 'genesis' ), $counter ),
/* translators: %d: Footer widget counter. */
'description' => sprintf( __( 'Footer %d widget area.', 'genesis' ), $counter ),
'_genesis_builtin' => true,
)
);
$counter++;
}
}
/**
* Register after-entry widget area if user specifies in the child theme.
*
* @since 2.1.0
*
* @return void Return early if there is no theme support for `genesis-after-entry-widget-area`.
*/
function genesis_register_after_entry_widget_area() {
if ( ! current_theme_supports( 'genesis-after-entry-widget-area' ) ) {
return;
}
genesis_register_widget_area(
array(
'id' => 'after-entry',
'name' => __( 'After Entry', 'genesis' ),
'description' => __( 'Widgets in this widget area will display after single entries.', 'genesis' ),
'_builtin' => true,
)
);
}
/**
* Conditionally display a sidebar, wrapped in a div by default.
*
* The $args array accepts the following keys:
*
* - `before` (markup to be displayed before the widget area output),
* - `after` (markup to be displayed after the widget area output),
* - `default` (fallback text if the sidebar is not found, or has no widgets, default is an empty string),
* - `show_inactive` (flag to show inactive sidebars, default is false),
* - `before_sidebar_hook` (hook that fires before the widget area output),
* - `after_sidebar_hook` (hook that fires after the widget area output).
*
* Return false early if the sidebar is not active and the `show_inactive` argument is false.
*
* @since 1.8.0
*
* @param string $id Sidebar ID, as per when it was registered.
* @param array $args Arguments.
* @return bool `false` if `$id` is falsy, or `$args['show_inactive']` is falsy and sidebar
* is not currently being used. `true` otherwise.
*/
function genesis_widget_area( $id, $args = array() ) {
if ( ! $id ) {
return false;
}
$defaults = apply_filters( 'genesis_widget_area_defaults', array(
'before' => genesis_markup( array(
'open' => '',
'context' => 'widget-area-wrap',
'echo' => false,
) ),
'default' => '',
'show_inactive' => 0,
'before_sidebar_hook' => 'genesis_before_' . $id . '_widget_area',
'after_sidebar_hook' => 'genesis_after_' . $id . '_widget_area',
), $id, $args );
$args = wp_parse_args( $args, $defaults );
if ( ! $args['show_inactive'] && ! is_active_sidebar( $id ) ) {
return false;
}
// Opening markup.
echo $args['before'];
// Before hook.
if ( $args['before_sidebar_hook'] ) {
/**
* Fires before widget area is output.
*
* Default format of hook name is 'genesis_before_' . $id . '_widget_area'`, where `$id` is the widget area
* ID, but this can be changed when registering a new widget area.
*
* @since ???
*/
do_action( $args['before_sidebar_hook'] ); // WPCS: prefix ok.
}
if ( ! dynamic_sidebar( $id ) ) {
echo $args['default'];
}
// After hook.
if( $args['after_sidebar_hook'] ) {
/**
* Fires before widget area is output.
*
* * Default format of hook name is 'genesis_after_' . $id . '_widget_area'`, where `$id` is the widget area
* ID, but this can be changed when registering a new widget area.
*
* @since ???
*/
do_action( $args['after_sidebar_hook'] ); // WPCS: prefix ok.
}
// Closing markup.
echo $args['after'];
return true;
}
add_filter( 'genesis_register_sidebar_defaults', 'genesis_a11y_register_sidebar_defaults' );
/**
* Widget heading filter, default H4 in Widgets and sidebars modified to an H3 if genesis_a11y( 'headings' ) support
*
* For using a semantic heading structure, improves accessibility
*
* @since 2.2.0
*
* @param array $args Existing sidebar default arguments.
* @return array Amended sidebar default arguments.
*/
function genesis_a11y_register_sidebar_defaults( $args ) {
if ( genesis_a11y( 'headings' ) ) {
$args['before_title'] = '\n";
}
return $args;
}
/**
* Adds an H2 title to widget areas.
*
* For using a semantic heading structure, improves accessibility
*
* @since 2.2.0
*
* @global array $wp_registered_sidebars
*
* @param string $id Sidebar ID, as per when it was registered.
* @return string|null Widget area heading, or `null` if `headings` are not enabled for
* Genesis accessibility, or `$id` is not registered as a widget area ID.
*/
function genesis_sidebar_title( $id ) {
if ( $id && genesis_a11y( 'headings' ) ) {
global $wp_registered_sidebars;
$name = $id;
if ( array_key_exists( $id, $wp_registered_sidebars ) ) {
$name = $wp_registered_sidebars[ $id ]['name'];
}
$heading = '';
return apply_filters( 'genesis_sidebar_title_output', $heading, $id );
}
return null;
}