array(),
'unregister' => array(),
);
}
public function sanitize( array $data ): array {
$custom_raw = isset( $data['custom'] ) && is_array( $data['custom'] ) ? $data['custom'] : array();
$custom = array();
$seen = array();
foreach ( $custom_raw as $row ) {
if ( ! is_array( $row ) ) {
continue;
}
$slug = isset( $row['slug'] ) ? sanitize_title( (string) $row['slug'] ) : '';
$name = isset( $row['name'] ) ? sanitize_text_field( wp_unslash( (string) $row['name'] ) ) : '';
$description = isset( $row['description'] ) ? sanitize_text_field( wp_unslash( (string) $row['description'] ) ) : '';
// Skip empty rows and duplicates.
if ( '' === $slug || '' === $name ) {
continue;
}
if ( isset( $seen[ $slug ] ) ) {
continue;
}
$seen[ $slug ] = true;
$custom[] = array(
'slug' => $slug,
'name' => $name,
'description' => $description,
);
}
$unreg_raw = isset( $data['unregister'] ) && is_array( $data['unregister'] ) ? $data['unregister'] : array();
$unreg = array();
foreach ( $unreg_raw as $id ) {
$id = sanitize_title( (string) $id );
if ( '' === $id ) {
continue;
}
$unreg[] = $id;
}
return array(
'custom' => $custom,
'unregister' => array_values( array_unique( $unreg ) ),
);
}
public function register(): void {
add_action( 'widgets_init', array( $this, 'register_custom_sidebars' ), 11 );
add_action( 'widgets_init', array( $this, 'unregister_sidebars' ), 99 );
add_action( 'init', array( $this, 'register_shortcode' ) );
}
public function register_custom_sidebars(): void {
$customs = bw_dev()->settings()->get( $this->slug(), 'custom', array() );
if ( ! is_array( $customs ) ) {
return;
}
foreach ( $customs as $row ) {
if ( ! is_array( $row ) || empty( $row['slug'] ) || empty( $row['name'] ) ) {
continue;
}
register_sidebar(
array(
'id' => (string) $row['slug'],
'name' => (string) $row['name'],
'description' => isset( $row['description'] ) ? (string) $row['description'] : '',
'before_widget' => '',
'before_title' => '',
)
);
}
}
public function unregister_sidebars(): void {
$ids = bw_dev()->settings()->get( $this->slug(), 'unregister', array() );
if ( ! is_array( $ids ) ) {
return;
}
// Never unregister our own customs — guard in case a slug ended up in both lists.
$customs = bw_dev()->settings()->get( $this->slug(), 'custom', array() );
$custom_slugs = array();
if ( is_array( $customs ) ) {
foreach ( $customs as $row ) {
if ( is_array( $row ) && ! empty( $row['slug'] ) ) {
$custom_slugs[ (string) $row['slug'] ] = true;
}
}
}
foreach ( $ids as $id ) {
$id = (string) $id;
if ( '' === $id || isset( $custom_slugs[ $id ] ) ) {
continue;
}
unregister_sidebar( $id );
}
}
public function register_shortcode(): void {
add_shortcode( self::SHORTCODE, array( $this, 'render_shortcode' ) );
}
public function render_shortcode( $atts ): string {
$atts = shortcode_atts(
array(
'slug' => '',
),
(array) $atts,
self::SHORTCODE
);
$slug = sanitize_title( (string) $atts['slug'] );
if ( '' === $slug || ! is_registered_sidebar( $slug ) ) {
return '';
}
if ( ! is_active_sidebar( $slug ) ) {
return '';
}
ob_start();
dynamic_sidebar( $slug );
return (string) ob_get_clean();
}
/* ---------------------------------------------------------------------
* Settings tab
* ------------------------------------------------------------------- */
public function render_tab(): void {
$customs = bw_dev()->settings()->get( $this->slug(), 'custom', array() );
$unreg = bw_dev()->settings()->get( $this->slug(), 'unregister', array() );
if ( ! is_array( $customs ) ) {
$customs = array();
}
if ( ! is_array( $unreg ) ) {
$unreg = array();
}
$unreg_map = array_flip( $unreg );
$registered = isset( $GLOBALS['wp_registered_sidebars'] ) && is_array( $GLOBALS['wp_registered_sidebars'] )
? $GLOBALS['wp_registered_sidebars']
: array();
$custom_slugs = array();
foreach ( $customs as $row ) {
if ( is_array( $row ) && ! empty( $row['slug'] ) ) {
$custom_slugs[ (string) $row['slug'] ] = true;
}
}
$base = BW_Dev_Settings::OPTION . '[' . $this->slug() . ']';
?>
[ slug="footer-cta"]