WP_Widget_Area_Customize_Control WordPress Class
The WP_Widget_Area_Customize_Control WordPress class is used to create a custom widget area in the WordPress Customizer. You can use this class to add a new widget area to your theme, and to customize the settings for that widget area.
WP_Widget_Area_Customize_Control #
Widget Area Customize Control class.
Description
See also
Source
File: wp-includes/customize/class-wp-widget-area-customize-control.php
class WP_Widget_Area_Customize_Control extends WP_Customize_Control { /** * Customize control type. * * @since 3.9.0 * @var string */ public $type = 'sidebar_widgets'; /** * Sidebar ID. * * @since 3.9.0 * @var int|string */ public $sidebar_id; /** * Refreshes the parameters passed to the JavaScript via JSON. * * @since 3.9.0 */ public function to_json() { parent::to_json(); $exported_properties = array( 'sidebar_id' ); foreach ( $exported_properties as $key ) { $this->json[ $key ] = $this->$key; } } /** * Renders the control's content. * * @since 3.9.0 */ public function render_content() { $id = 'reorder-widgets-desc-' . str_replace( array( '[', ']' ), array( '-', '' ), $this->id ); ?> <button type="button" class="button add-new-widget" aria-expanded="false" aria-controls="available-widgets"> <?php _e( 'Add a Widget' ); ?> </button> <button type="button" class="button-link reorder-toggle" aria-label="<?php esc_attr_e( 'Reorder widgets' ); ?>" aria-describedby="<?php echo esc_attr( $id ); ?>"> <span class="reorder"><?php _e( 'Reorder' ); ?></span> <span class="reorder-done"><?php _e( 'Done' ); ?></span> </button> <p class="screen-reader-text" id="<?php echo esc_attr( $id ); ?>"><?php _e( 'When in reorder mode, additional controls to reorder widgets will be available in the widgets list above.' ); ?></p> <?php } }
Expand full source codeCollapse full source codeView on TracView on GitHub
Methods
- render_content— Renders the control's content.
- to_json— Refreshes the parameters passed to the JavaScript via JSON.
Changelog
Version | Description |
---|---|
3.9.0 | Introduced. |