mirror of
https://github.com/WordPress/WordPress.git
synced 2024-11-05 18:32:23 +01:00
208330f2dc
The Menu Customizer feature includes a performance technique whereby the controls for nav menu items are only embedded into the DOM once the containing menu section is expanded. This commit implements the same DOM deferral for widgets but goes a step further than just embedding the controls once the widget area's Customizer section is expanded: it also defers the embedding of the widget control's form until the widget is expanded, at which point the `widget-added` event also fires to allow any additional widget initialization to be done. The deferred DOM embedding can speed up initial load time by 10x or more. This DOM deferral also yields a reduction in overall memory usage in the browser process. Includes changes to `wp_widget_control()` to facilitate separating out the widget form from the surrounding accordion container; also includes unit tests for this previously-untested function. Also included are initial QUnit tests (finally) for widgets in the Customizer. Fixes #33901. Built from https://develop.svn.wordpress.org/trunk@34563 git-svn-id: http://core.svn.wordpress.org/trunk@34527 1a063a9b-81f0-0310-95a4-ce76da25c4cd
281 lines
9.3 KiB
PHP
281 lines
9.3 KiB
PHP
<?php
|
|
/**
|
|
* WordPress Widgets Administration API
|
|
*
|
|
* @package WordPress
|
|
* @subpackage Administration
|
|
*/
|
|
|
|
/**
|
|
* Display list of the available widgets.
|
|
*
|
|
* @since 2.5.0
|
|
*
|
|
* @global array $wp_registered_widgets
|
|
* @global array $wp_registered_widget_controls
|
|
*/
|
|
function wp_list_widgets() {
|
|
global $wp_registered_widgets, $wp_registered_widget_controls;
|
|
|
|
$sort = $wp_registered_widgets;
|
|
usort( $sort, '_sort_name_callback' );
|
|
$done = array();
|
|
|
|
foreach ( $sort as $widget ) {
|
|
if ( in_array( $widget['callback'], $done, true ) ) // We already showed this multi-widget
|
|
continue;
|
|
|
|
$sidebar = is_active_widget( $widget['callback'], $widget['id'], false, false );
|
|
$done[] = $widget['callback'];
|
|
|
|
if ( ! isset( $widget['params'][0] ) )
|
|
$widget['params'][0] = array();
|
|
|
|
$args = array( 'widget_id' => $widget['id'], 'widget_name' => $widget['name'], '_display' => 'template' );
|
|
|
|
if ( isset($wp_registered_widget_controls[$widget['id']]['id_base']) && isset($widget['params'][0]['number']) ) {
|
|
$id_base = $wp_registered_widget_controls[$widget['id']]['id_base'];
|
|
$args['_temp_id'] = "$id_base-__i__";
|
|
$args['_multi_num'] = next_widget_id_number($id_base);
|
|
$args['_add'] = 'multi';
|
|
} else {
|
|
$args['_add'] = 'single';
|
|
if ( $sidebar )
|
|
$args['_hide'] = '1';
|
|
}
|
|
|
|
$args = wp_list_widget_controls_dynamic_sidebar( array( 0 => $args, 1 => $widget['params'][0] ) );
|
|
call_user_func_array( 'wp_widget_control', $args );
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Callback to sort array by a 'name' key.
|
|
*
|
|
* @since 3.1.0
|
|
* @access private
|
|
*
|
|
* @return int
|
|
*/
|
|
function _sort_name_callback( $a, $b ) {
|
|
return strnatcasecmp( $a['name'], $b['name'] );
|
|
}
|
|
|
|
/**
|
|
* Show the widgets and their settings for a sidebar.
|
|
* Used in the admin widget config screen.
|
|
*
|
|
* @since 2.5.0
|
|
*
|
|
* @param string $sidebar Sidebar ID.
|
|
* @param string $sidebar_name Optional. Sidebar name. Default empty.
|
|
*/
|
|
function wp_list_widget_controls( $sidebar, $sidebar_name = '' ) {
|
|
add_filter( 'dynamic_sidebar_params', 'wp_list_widget_controls_dynamic_sidebar' );
|
|
|
|
$description = wp_sidebar_description( $sidebar );
|
|
|
|
echo '<div id="' . esc_attr( $sidebar ) . '" class="widgets-sortables">';
|
|
|
|
if ( $sidebar_name ) {
|
|
?>
|
|
<div class="sidebar-name">
|
|
<div class="sidebar-name-arrow"><br /></div>
|
|
<h3><?php echo esc_html( $sidebar_name ); ?> <span class="spinner"></span></h3>
|
|
</div>
|
|
<?php
|
|
}
|
|
|
|
if ( ! empty( $description ) ) {
|
|
?>
|
|
<div class="sidebar-description">
|
|
<p class="description"><?php echo $description; ?></p>
|
|
</div>
|
|
<?php
|
|
}
|
|
|
|
dynamic_sidebar( $sidebar );
|
|
|
|
echo '</div>';
|
|
}
|
|
|
|
/**
|
|
* {@internal Missing Short Description}}
|
|
*
|
|
* @since 2.5.0
|
|
*
|
|
* @global array $wp_registered_widgets
|
|
*
|
|
* @staticvar int $i
|
|
*
|
|
* @param array $params
|
|
* @return array
|
|
*/
|
|
function wp_list_widget_controls_dynamic_sidebar( $params ) {
|
|
global $wp_registered_widgets;
|
|
static $i = 0;
|
|
$i++;
|
|
|
|
$widget_id = $params[0]['widget_id'];
|
|
$id = isset($params[0]['_temp_id']) ? $params[0]['_temp_id'] : $widget_id;
|
|
$hidden = isset($params[0]['_hide']) ? ' style="display:none;"' : '';
|
|
|
|
$params[0]['before_widget'] = "<div id='widget-{$i}_{$id}' class='widget'$hidden>";
|
|
$params[0]['after_widget'] = "</div>";
|
|
$params[0]['before_title'] = "%BEG_OF_TITLE%"; // deprecated
|
|
$params[0]['after_title'] = "%END_OF_TITLE%"; // deprecated
|
|
if ( is_callable( $wp_registered_widgets[$widget_id]['callback'] ) ) {
|
|
$wp_registered_widgets[$widget_id]['_callback'] = $wp_registered_widgets[$widget_id]['callback'];
|
|
$wp_registered_widgets[$widget_id]['callback'] = 'wp_widget_control';
|
|
}
|
|
|
|
return $params;
|
|
}
|
|
|
|
/**
|
|
*
|
|
* @global array $wp_registered_widgets
|
|
*
|
|
* @param string $id_base
|
|
* @return int
|
|
*/
|
|
function next_widget_id_number( $id_base ) {
|
|
global $wp_registered_widgets;
|
|
$number = 1;
|
|
|
|
foreach ( $wp_registered_widgets as $widget_id => $widget ) {
|
|
if ( preg_match( '/' . $id_base . '-([0-9]+)$/', $widget_id, $matches ) )
|
|
$number = max($number, $matches[1]);
|
|
}
|
|
$number++;
|
|
|
|
return $number;
|
|
}
|
|
|
|
/**
|
|
* Meta widget used to display the control form for a widget.
|
|
*
|
|
* Called from dynamic_sidebar().
|
|
*
|
|
* @since 2.5.0
|
|
*
|
|
* @global array $wp_registered_widgets
|
|
* @global array $wp_registered_widget_controls
|
|
* @global array $sidebars_widgets
|
|
*
|
|
* @param array $sidebar_args
|
|
* @return array
|
|
*/
|
|
function wp_widget_control( $sidebar_args ) {
|
|
global $wp_registered_widgets, $wp_registered_widget_controls, $sidebars_widgets;
|
|
|
|
$widget_id = $sidebar_args['widget_id'];
|
|
$sidebar_id = isset($sidebar_args['id']) ? $sidebar_args['id'] : false;
|
|
$key = $sidebar_id ? array_search( $widget_id, $sidebars_widgets[$sidebar_id] ) : '-1'; // position of widget in sidebar
|
|
$control = isset($wp_registered_widget_controls[$widget_id]) ? $wp_registered_widget_controls[$widget_id] : array();
|
|
$widget = $wp_registered_widgets[$widget_id];
|
|
|
|
$id_format = $widget['id'];
|
|
$widget_number = isset($control['params'][0]['number']) ? $control['params'][0]['number'] : '';
|
|
$id_base = isset($control['id_base']) ? $control['id_base'] : $widget_id;
|
|
$multi_number = isset($sidebar_args['_multi_num']) ? $sidebar_args['_multi_num'] : '';
|
|
$add_new = isset($sidebar_args['_add']) ? $sidebar_args['_add'] : '';
|
|
|
|
$before_form = isset( $sidebar_args['before_form'] ) ? $sidebar_args['before_form'] : '<form method="post">';
|
|
$after_form = isset( $sidebar_args['after_form'] ) ? $sidebar_args['after_form'] : '</form>';
|
|
$before_widget_content = isset( $sidebar_args['before_widget_content'] ) ? $sidebar_args['before_widget_content'] : '<div class="widget-content">';
|
|
$after_widget_content = isset( $sidebar_args['after_widget_content'] ) ? $sidebar_args['after_widget_content'] : '</div>';
|
|
|
|
$query_arg = array( 'editwidget' => $widget['id'] );
|
|
if ( $add_new ) {
|
|
$query_arg['addnew'] = 1;
|
|
if ( $multi_number ) {
|
|
$query_arg['num'] = $multi_number;
|
|
$query_arg['base'] = $id_base;
|
|
}
|
|
} else {
|
|
$query_arg['sidebar'] = $sidebar_id;
|
|
$query_arg['key'] = $key;
|
|
}
|
|
|
|
/*
|
|
* We aren't showing a widget control, we're outputting a template
|
|
* for a multi-widget control.
|
|
*/
|
|
if ( isset($sidebar_args['_display']) && 'template' == $sidebar_args['_display'] && $widget_number ) {
|
|
// number == -1 implies a template where id numbers are replaced by a generic '__i__'
|
|
$control['params'][0]['number'] = -1;
|
|
// With id_base widget id's are constructed like {$id_base}-{$id_number}.
|
|
if ( isset($control['id_base']) )
|
|
$id_format = $control['id_base'] . '-__i__';
|
|
}
|
|
|
|
$wp_registered_widgets[$widget_id]['callback'] = $wp_registered_widgets[$widget_id]['_callback'];
|
|
unset($wp_registered_widgets[$widget_id]['_callback']);
|
|
|
|
$widget_title = esc_html( strip_tags( $sidebar_args['widget_name'] ) );
|
|
$has_form = 'noform';
|
|
|
|
echo $sidebar_args['before_widget']; ?>
|
|
<div class="widget-top">
|
|
<div class="widget-title-action">
|
|
<a class="widget-action hide-if-no-js" href="#available-widgets"></a>
|
|
<a class="widget-control-edit hide-if-js" href="<?php echo esc_url( add_query_arg( $query_arg ) ); ?>">
|
|
<span class="edit"><?php _ex( 'Edit', 'widget' ); ?></span>
|
|
<span class="add"><?php _ex( 'Add', 'widget' ); ?></span>
|
|
<span class="screen-reader-text"><?php echo $widget_title; ?></span>
|
|
</a>
|
|
</div>
|
|
<div class="widget-title"><h4><?php echo $widget_title ?><span class="in-widget-title"></span></h4></div>
|
|
</div>
|
|
|
|
<div class="widget-inside">
|
|
<?php echo $before_form; ?>
|
|
<?php echo $before_widget_content; ?>
|
|
<?php
|
|
if ( isset( $control['callback'] ) ) {
|
|
$has_form = call_user_func_array( $control['callback'], $control['params'] );
|
|
} else {
|
|
echo "\t\t<p>" . __('There are no options for this widget.') . "</p>\n";
|
|
}
|
|
?>
|
|
<?php echo $after_widget_content; ?>
|
|
<input type="hidden" name="widget-id" class="widget-id" value="<?php echo esc_attr($id_format); ?>" />
|
|
<input type="hidden" name="id_base" class="id_base" value="<?php echo esc_attr($id_base); ?>" />
|
|
<input type="hidden" name="widget-width" class="widget-width" value="<?php if (isset( $control['width'] )) echo esc_attr($control['width']); ?>" />
|
|
<input type="hidden" name="widget-height" class="widget-height" value="<?php if (isset( $control['height'] )) echo esc_attr($control['height']); ?>" />
|
|
<input type="hidden" name="widget_number" class="widget_number" value="<?php echo esc_attr($widget_number); ?>" />
|
|
<input type="hidden" name="multi_number" class="multi_number" value="<?php echo esc_attr($multi_number); ?>" />
|
|
<input type="hidden" name="add_new" class="add_new" value="<?php echo esc_attr($add_new); ?>" />
|
|
|
|
<div class="widget-control-actions">
|
|
<div class="alignleft">
|
|
<a class="widget-control-remove" href="#remove"><?php _e('Delete'); ?></a> |
|
|
<a class="widget-control-close" href="#close"><?php _e('Close'); ?></a>
|
|
</div>
|
|
<div class="alignright<?php if ( 'noform' === $has_form ) echo ' widget-control-noform'; ?>">
|
|
<?php submit_button( __( 'Save' ), 'button-primary widget-control-save right', 'savewidget', false, array( 'id' => 'widget-' . esc_attr( $id_format ) . '-savewidget' ) ); ?>
|
|
<span class="spinner"></span>
|
|
</div>
|
|
<br class="clear" />
|
|
</div>
|
|
<?php echo $after_form; ?>
|
|
</div>
|
|
|
|
<div class="widget-description">
|
|
<?php echo ( $widget_description = wp_widget_description($widget_id) ) ? "$widget_description\n" : "$widget_title\n"; ?>
|
|
</div>
|
|
<?php
|
|
echo $sidebar_args['after_widget'];
|
|
|
|
return $sidebar_args;
|
|
}
|
|
|
|
/**
|
|
*
|
|
* @param string $classes
|
|
* @return string
|
|
*/
|
|
function wp_widgets_access_body_class($classes) {
|
|
return "$classes widgets_access ";
|
|
}
|