a902058b25
git-svn-id: https://develop.svn.wordpress.org/trunk@10916 602fd350-edb4-49c9-b593-d223f7449a82
243 lines
8.3 KiB
PHP
243 lines
8.3 KiB
PHP
<?php
|
|
/**
|
|
* WordPress Widgets Administration API
|
|
*
|
|
* @package WordPress
|
|
* @subpackage Administration
|
|
*/
|
|
|
|
/**
|
|
* Display list of the available widgets, either all or matching search.
|
|
*
|
|
* The search parameter are search terms separated by spaces.
|
|
*
|
|
* @since unknown
|
|
*
|
|
* @param string $show Optional, default is all. What to display, can be 'all', 'unused', or 'used'.
|
|
* @param string $_search Optional. Search for widgets. Should be unsanitized.
|
|
*/
|
|
function wp_list_widgets( $show = 'all', $_search = false ) {
|
|
global $wp_registered_widgets, $sidebars_widgets, $wp_registered_widget_controls;
|
|
|
|
if ( $_search ) {
|
|
// sanitize
|
|
$search = preg_replace( '/[^\w\s]/', '', $_search );
|
|
// array of terms
|
|
$search_terms = preg_split( '/[\s]/', $search, -1, PREG_SPLIT_NO_EMPTY );
|
|
} else {
|
|
$search_terms = array();
|
|
}
|
|
|
|
if ( !in_array( $show, array( 'all', 'unused', 'used' ) ) )
|
|
$show = 'all';
|
|
?>
|
|
|
|
<ul id="widget-list">
|
|
<?php
|
|
$no_widgets_shown = true;
|
|
$already_shown = array();
|
|
foreach ( $wp_registered_widgets as $name => $widget ) {
|
|
if ( 'all' == $show && in_array( $widget['callback'], $already_shown ) ) // We already showed this multi-widget
|
|
continue;
|
|
|
|
if ( $search_terms ) {
|
|
$hit = false;
|
|
// Simple case-insensitive search. Boolean OR.
|
|
$search_text = preg_replace( '/[^\w]/', '', $widget['name'] );
|
|
if ( isset($widget['description']) )
|
|
$search_text .= preg_replace( '/[^\w]/', '', $widget['description'] );
|
|
|
|
foreach ( $search_terms as $search_term ) {
|
|
if ( stristr( $search_text, $search_term ) ) {
|
|
$hit = true;
|
|
break;
|
|
}
|
|
}
|
|
if ( !$hit )
|
|
continue;
|
|
}
|
|
|
|
$sidebar = is_active_widget( $widget['callback'], $widget['id'] );
|
|
|
|
if ( ( 'unused' == $show && $sidebar ) || ( 'used' == $show && !$sidebar ) )
|
|
continue;
|
|
|
|
if ( ! isset( $widget['params'][0] ) )
|
|
$widget['params'][0] = array();
|
|
|
|
$already_shown[] = $widget['callback'];
|
|
$no_widgets_shown = false;
|
|
|
|
$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 );
|
|
}
|
|
|
|
if ( $no_widgets_shown )
|
|
echo '<li>' . __( 'No matching widgets' ) . "</li>\n";
|
|
?>
|
|
</ul>
|
|
<?php
|
|
}
|
|
|
|
/**
|
|
* {@internal Missing Short Description}}
|
|
*
|
|
* @since unknown
|
|
*
|
|
* @param string $sidebar
|
|
*/
|
|
function wp_list_widget_controls( $sidebar, $hide = false ) {
|
|
add_filter( 'dynamic_sidebar_params', 'wp_list_widget_controls_dynamic_sidebar' );
|
|
?>
|
|
|
|
<ul class="widgets-sortables<?php echo $hide ? ' hide-if-js' : ''; ?>">
|
|
<?php dynamic_sidebar( $sidebar ); ?>
|
|
</ul>
|
|
|
|
<?php
|
|
}
|
|
|
|
/**
|
|
* {@internal Missing Short Description}}
|
|
*
|
|
* @since unknown
|
|
*
|
|
* @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'] = "<li id='widget-${i}_$id' class='widget'$hidden>";
|
|
$params[0]['after_widget'] = "</li>";
|
|
$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;
|
|
}
|
|
|
|
function next_widget_id_number($id_base) {
|
|
global $wp_registered_widgets;
|
|
$number = 2;
|
|
|
|
while ( isset($wp_registered_widgets["$id_base-$number"]) )
|
|
$number++;
|
|
|
|
return $number;
|
|
}
|
|
|
|
/**
|
|
* Meta widget used to display the control form for a widget.
|
|
*
|
|
* Called from dynamic_sidebar().
|
|
*
|
|
* @since unknown
|
|
*
|
|
* @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;
|
|
|
|
$control = isset($wp_registered_widget_controls[$widget_id]) ? $wp_registered_widget_controls[$widget_id] : array();
|
|
$widget = $wp_registered_widgets[$widget_id];
|
|
|
|
$key = $sidebar_id ? array_search( $widget_id, $sidebars_widgets[$sidebar_id] ) : 'no-key'; // position of widget in sidebar
|
|
|
|
$edit = isset($_GET['editwidget']); // editing without js
|
|
$nonce = $edit ? wp_create_nonce("edit-widget_$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'] : '';
|
|
|
|
// We aren't showing a widget control, we're outputing a template for a mult-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;
|
|
// if given, id_base means widget id's should be 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 = wp_specialchars( strip_tags( $sidebar_args['widget_name'] ) );
|
|
|
|
echo $sidebar_args['before_widget']; ?>
|
|
<div class="widget-top">
|
|
<div class="widget-title-action">
|
|
<?php if ( !$edit ) { ?>
|
|
<a class="widget-action widget-control-edit" href="<?php echo clean_url( add_query_arg( array( 'edit' => $id_format, 'key' => $key ) ) ); ?>"></a>
|
|
<?php } ?>
|
|
</div>
|
|
<div class="widget-title"><h4><?php echo $widget_title ?></h4></div>
|
|
</div>
|
|
|
|
<div class="widget-inside">
|
|
<form action="" method="post">
|
|
<div class="widget-control">
|
|
<?php
|
|
if ( isset($control['callback']) )
|
|
call_user_func_array( $control['callback'], $control['params'] );
|
|
else
|
|
echo "\t\t<p>" . __('There are no options for this widget.') . "</p>\n"; ?>
|
|
|
|
<input type="hidden" name="widget-id" class="widget-id" value="<?php echo $id_format; ?>" />
|
|
<input type="hidden" name="id_base" class="id_base" value="<?php echo $id_base; ?>" />
|
|
<input type="hidden" name="widget-width" class="widget-width" value="<?php echo $control['width']; ?>" />
|
|
<input type="hidden" name="widget-height" class="widget-height" value="<?php echo $control['height']; ?>" />
|
|
<input type="hidden" name="widget_number" class="widget_number" value="<?php echo $widget_number; ?>" />
|
|
<input type="hidden" name="multi_number" class="multi_number" value="<?php echo $multi_number; ?>" />
|
|
<input type="hidden" name="add_new" class="add_new" value="<?php echo $add_new; ?>" />
|
|
|
|
<div class="widget-control-actions">
|
|
<a class="button widget-control-remove alignleft" href="<?php echo $edit ? clean_url( add_query_arg( array( 'remove' => $id_format, 'key' => $key, '_wpnonce' => $nonce ) ) ) : '#remove'; ?>"><?php _e('Remove'); ?></a>
|
|
<?php if ( !empty($control) ) { ?>
|
|
<a class="button-primary widget-control-save alignright" href="<?php echo $edit ? clean_url( add_query_arg( array( 'save' => $id_format, 'key' => $key, '_wpnonce' => $nonce ) ) ) : '#save'; ?>"><?php _e('Save'); ?></a>
|
|
<?php } ?>
|
|
<br class="clear" />
|
|
</div>
|
|
</div>
|
|
</form>
|
|
<div class="widget-description">
|
|
<?php echo ( $widget_description = wp_widget_description($widget_id) ) ? "$widget_description\n" : "$widget_title\n"; ?>
|
|
</div>
|
|
</div>
|
|
<?php
|
|
echo $sidebar_args['after_widget'];
|
|
|
|
return $sidebar_args;
|
|
}
|
|
|