| [ XREF Home ] [ Index ] |
PHP Cross Reference of WordPress TrunkProvided by Yoast |
[Summary view] [Print] [Text view]
1 <?php 2 /** 3 * Widgets administration panel. 4 * 5 * @package WordPress 6 * @subpackage Administration 7 */ 8 9 /** WordPress Administration Bootstrap */ 10 require_once ( './admin.php' ); 11 12 /** WordPress Administration Widgets API */ 13 require_once (ABSPATH . 'wp-admin/includes/widgets.php'); 14 15 if ( ! current_user_can('edit_theme_options') ) 16 wp_die( __( 'Cheatin’ uh?' )); 17 18 wp_admin_css( 'widgets' ); 19 20 $widgets_access = get_user_setting( 'widgets_access' ); 21 if ( isset($_GET['widgets-access']) ) { 22 $widgets_access = 'on' == $_GET['widgets-access'] ? 'on' : 'off'; 23 set_user_setting( 'widgets_access', $widgets_access ); 24 } 25 26 if ( 'on' == $widgets_access ) 27 add_filter( 'admin_body_class', create_function('', '{return " widgets_access ";}') ); 28 else 29 wp_enqueue_script('admin-widgets'); 30 31 do_action( 'sidebar_admin_setup' ); 32 33 $title = __( 'Widgets' ); 34 $parent_file = 'themes.php'; 35 36 $help = ' 37 <p>' . __('Widgets are independent sections of content that can be placed into any widgetized area provided by your theme (commonly called sidebars). To populate your sidebars/widget areas with individual widgets, drag and drop the title bars into the desired area. By default, only the first widget area is expanded. To populate additional widget areas, click on their title bars to expand them.') . '</p> 38 <p>' . __('The Available Widgets section contains all the widgets you can choose from. Once you drag a widget into a sidebar, it will open to allow you to configure its settings. When you are happy with the widget settings, click the Save button and the widget will go live on your site. If you click Delete, it will remove the widget.') . '</p> 39 <p>' . __('If you want to remove the widget but save its setting for possible future use, just drag it into the Inactive Widgets area. You can add them back anytime from there. This is especially helpful when you switch to a theme with fewer or different widget areas.') . '</p> 40 <p>' . __('Widgets may be used multiple times. You can give each widget a title, to display on your site, but it’s not required.') . '</p> 41 <p>' . __('Enabling Accessibility Mode, via Screen Options, allows you to use Add and Edit buttons instead of using drag and drop.') . '</p> 42 <p>' . __('Many themes show some sidebar widgets by default until you edit your sidebars, but they are not automatically displayed in your sidebar management tool. After you make your first widget change, you can re-add the default widgets by adding them from the Available Widgets area.') . '</p> 43 '; 44 $help .= '<p><strong>' . __('For more information:') . '</strong></p>'; 45 $help .= '<p>' . __('<a href="http://codex.wordpress.org/Appearance_Widgets_Screen" target="_blank">Documentation on Widgets</a>') . '</p>'; 46 $help .= '<p>' . __('<a href="http://wordpress.org/support/" target="_blank">Support Forums</a>') . '</p>'; 47 add_contextual_help($current_screen, $help); 48 49 // register the inactive_widgets area as sidebar 50 register_sidebar(array( 51 'name' => __('Inactive Widgets'), 52 'id' => 'wp_inactive_widgets', 53 'description' => '', 54 'before_widget' => '', 55 'after_widget' => '', 56 'before_title' => '', 57 'after_title' => '', 58 )); 59 60 // These are the widgets grouped by sidebar 61 $sidebars_widgets = wp_get_sidebars_widgets(); 62 if ( empty( $sidebars_widgets ) ) 63 $sidebars_widgets = wp_get_widget_defaults(); 64 65 // look for "lost" widgets, this has to run at least on each theme change 66 function retrieve_widgets() { 67 global $wp_registered_widget_updates, $wp_registered_sidebars, $sidebars_widgets, $wp_registered_widgets; 68 69 $_sidebars_widgets = array(); 70 $sidebars = array_keys($wp_registered_sidebars); 71 72 unset( $sidebars_widgets['array_version'] ); 73 74 $old = array_keys($sidebars_widgets); 75 sort($old); 76 sort($sidebars); 77 78 if ( $old == $sidebars ) 79 return; 80 81 // Move the known-good ones first 82 foreach ( $sidebars as $id ) { 83 if ( array_key_exists( $id, $sidebars_widgets ) ) { 84 $_sidebars_widgets[$id] = $sidebars_widgets[$id]; 85 unset($sidebars_widgets[$id], $sidebars[$id]); 86 } 87 } 88 89 // if new theme has less sidebars than the old theme 90 if ( !empty($sidebars_widgets) ) { 91 foreach ( $sidebars_widgets as $lost => $val ) { 92 if ( is_array($val) ) 93 $_sidebars_widgets['wp_inactive_widgets'] = array_merge( (array) $_sidebars_widgets['wp_inactive_widgets'], $val ); 94 } 95 } 96 97 // discard invalid, theme-specific widgets from sidebars 98 $shown_widgets = array(); 99 foreach ( $_sidebars_widgets as $sidebar => $widgets ) { 100 if ( !is_array($widgets) ) 101 continue; 102 103 $_widgets = array(); 104 foreach ( $widgets as $widget ) { 105 if ( isset($wp_registered_widgets[$widget]) ) 106 $_widgets[] = $widget; 107 } 108 $_sidebars_widgets[$sidebar] = $_widgets; 109 $shown_widgets = array_merge($shown_widgets, $_widgets); 110 } 111 112 $sidebars_widgets = $_sidebars_widgets; 113 unset($_sidebars_widgets, $_widgets); 114 115 // find hidden/lost multi-widget instances 116 $lost_widgets = array(); 117 foreach ( $wp_registered_widgets as $key => $val ) { 118 if ( in_array($key, $shown_widgets, true) ) 119 continue; 120 121 $number = preg_replace('/.+?-([0-9]+)$/', '$1', $key); 122 123 if ( 2 > (int) $number ) 124 continue; 125 126 $lost_widgets[] = $key; 127 } 128 129 $sidebars_widgets['wp_inactive_widgets'] = array_merge($lost_widgets, (array) $sidebars_widgets['wp_inactive_widgets']); 130 wp_set_sidebars_widgets($sidebars_widgets); 131 } 132 retrieve_widgets(); 133 134 if ( count($wp_registered_sidebars) == 1 ) { 135 // If only "wp_inactive_widgets" is defined the theme has no sidebars, die. 136 require_once ( './admin-header.php' ); 137 ?> 138 139 <div class="wrap"> 140 <?php screen_icon(); ?> 141 <h2><?php echo esc_html( $title ); ?></h2> 142 <div class="error"> 143 <p><?php _e( 'No Sidebars Defined' ); ?></p> 144 </div> 145 <p><?php _e( 'The theme you are currently using isn’t widget-aware, meaning that it has no sidebars that you are able to change. For information on making your theme widget-aware, please <a href="http://codex.wordpress.org/Widgetizing_Themes">follow these instructions</a>.' ); ?></p> 146 </div> 147 148 <?php 149 require_once ( './admin-footer.php' ); 150 exit; 151 } 152 153 // We're saving a widget without js 154 if ( isset($_POST['savewidget']) || isset($_POST['removewidget']) ) { 155 $widget_id = $_POST['widget-id']; 156 check_admin_referer("save-delete-widget-$widget_id"); 157 158 $number = isset($_POST['multi_number']) ? (int) $_POST['multi_number'] : ''; 159 if ( $number ) { 160 foreach ( $_POST as $key => $val ) { 161 if ( is_array($val) && preg_match('/__i__|%i%/', key($val)) ) { 162 $_POST[$key] = array( $number => array_shift($val) ); 163 break; 164 } 165 } 166 } 167 168 $sidebar_id = $_POST['sidebar']; 169 $position = isset($_POST[$sidebar_id . '_position']) ? (int) $_POST[$sidebar_id . '_position'] - 1 : 0; 170 171 $id_base = $_POST['id_base']; 172 $sidebar = isset($sidebars_widgets[$sidebar_id]) ? $sidebars_widgets[$sidebar_id] : array(); 173 174 // delete 175 if ( isset($_POST['removewidget']) && $_POST['removewidget'] ) { 176 177 if ( !in_array($widget_id, $sidebar, true) ) { 178 wp_redirect( admin_url('widgets.php?error=0') ); 179 exit; 180 } 181 182 $sidebar = array_diff( $sidebar, array($widget_id) ); 183 $_POST = array('sidebar' => $sidebar_id, 'widget-' . $id_base => array(), 'the-widget-id' => $widget_id, 'delete_widget' => '1'); 184 } 185 186 $_POST['widget-id'] = $sidebar; 187 188 foreach ( (array) $wp_registered_widget_updates as $name => $control ) { 189 if ( $name != $id_base || !is_callable($control['callback']) ) 190 continue; 191 192 ob_start(); 193 call_user_func_array( $control['callback'], $control['params'] ); 194 ob_end_clean(); 195 196 break; 197 } 198 199 $sidebars_widgets[$sidebar_id] = $sidebar; 200 201 // remove old position 202 if ( !isset($_POST['delete_widget']) ) { 203 foreach ( $sidebars_widgets as $key => $sb ) { 204 if ( is_array($sb) ) 205 $sidebars_widgets[$key] = array_diff( $sb, array($widget_id) ); 206 } 207 array_splice( $sidebars_widgets[$sidebar_id], $position, 0, $widget_id ); 208 } 209 210 wp_set_sidebars_widgets($sidebars_widgets); 211 wp_redirect( admin_url('widgets.php?message=0') ); 212 exit; 213 } 214 215 // Output the widget form without js 216 if ( isset($_GET['editwidget']) && $_GET['editwidget'] ) { 217 $widget_id = $_GET['editwidget']; 218 219 if ( isset($_GET['addnew']) ) { 220 // Default to the first sidebar 221 $sidebar = array_shift( $keys = array_keys($wp_registered_sidebars) ); 222 223 if ( isset($_GET['base']) && isset($_GET['num']) ) { // multi-widget 224 // Copy minimal info from an existing instance of this widget to a new instance 225 foreach ( $wp_registered_widget_controls as $control ) { 226 if ( $_GET['base'] === $control['id_base'] ) { 227 $control_callback = $control['callback']; 228 $multi_number = (int) $_GET['num']; 229 $control['params'][0]['number'] = -1; 230 $widget_id = $control['id'] = $control['id_base'] . '-' . $multi_number; 231 $wp_registered_widget_controls[$control['id']] = $control; 232 break; 233 } 234 } 235 } 236 } 237 238 if ( isset($wp_registered_widget_controls[$widget_id]) && !isset($control) ) { 239 $control = $wp_registered_widget_controls[$widget_id]; 240 $control_callback = $control['callback']; 241 } elseif ( !isset($wp_registered_widget_controls[$widget_id]) && isset($wp_registered_widgets[$widget_id]) ) { 242 $name = esc_html( strip_tags($wp_registered_widgets[$widget_id]['name']) ); 243 } 244 245 if ( !isset($name) ) 246 $name = esc_html( strip_tags($control['name']) ); 247 248 if ( !isset($sidebar) ) 249 $sidebar = isset($_GET['sidebar']) ? $_GET['sidebar'] : 'wp_inactive_widgets'; 250 251 if ( !isset($multi_number) ) 252 $multi_number = isset($control['params'][0]['number']) ? $control['params'][0]['number'] : ''; 253 254 $id_base = isset($control['id_base']) ? $control['id_base'] : $control['id']; 255 256 // show the widget form 257 $width = ' style="width:' . max($control['width'], 350) . 'px"'; 258 $key = isset($_GET['key']) ? (int) $_GET['key'] : 0; 259 260 require_once ( './admin-header.php' ); ?> 261 <div class="wrap"> 262 <?php screen_icon(); ?> 263 <h2><?php echo esc_html( $title ); ?></h2> 264 <div class="editwidget"<?php echo $width; ?>> 265 <h3><?php printf( __( 'Widget %s' ), $name ); ?></h3> 266 267 <form action="widgets.php" method="post"> 268 <div class="widget-inside"> 269 <?php 270 if ( is_callable( $control_callback ) ) 271 call_user_func_array( $control_callback, $control['params'] ); 272 else 273 echo '<p>' . __('There are no options for this widget.') . "</p>\n"; ?> 274 </div> 275 276 <p class="describe"><?php _e('Select both the sidebar for this widget and the position of the widget in that sidebar.'); ?></p> 277 <div class="widget-position"> 278 <table class="widefat"><thead><tr><th><?php _e('Sidebar'); ?></th><th><?php _e('Position'); ?></th></tr></thead><tbody> 279 <?php 280 foreach ( $wp_registered_sidebars as $sbname => $sbvalue ) { 281 echo "\t\t<tr><td><label><input type='radio' name='sidebar' value='" . esc_attr($sbname) . "'" . checked( $sbname, $sidebar, false ) . " /> $sbvalue[name]</label></td><td>"; 282 if ( 'wp_inactive_widgets' == $sbname ) { 283 echo ' '; 284 } else { 285 if ( !isset($sidebars_widgets[$sbname]) || !is_array($sidebars_widgets[$sbname]) ) { 286 $j = 1; 287 $sidebars_widgets[$sbname] = array(); 288 } else { 289 $j = count($sidebars_widgets[$sbname]); 290 if ( isset($_GET['addnew']) || !in_array($widget_id, $sidebars_widgets[$sbname], true) ) 291 $j++; 292 } 293 $selected = ''; 294 echo "\t\t<select name='{$sbname}_position'>\n"; 295 echo "\t\t<option value=''>" . __('— Select —') . "</option>\n"; 296 for ( $i = 1; $i <= $j; $i++ ) { 297 if ( in_array($widget_id, $sidebars_widgets[$sbname], true) ) 298 $selected = selected( $i, $key + 1, false ); 299 echo "\t\t<option value='$i'$selected> $i </option>\n"; 300 } 301 echo "\t\t</select>\n"; 302 } 303 echo "</td></tr>\n"; 304 } ?> 305 </tbody></table> 306 </div> 307 308 <div class="widget-control-actions"> 309 <?php 310 if ( isset($_GET['addnew']) ) { ?> 311 <a href="widgets.php" class="button alignleft"><?php _e('Cancel'); ?></a> 312 <?php 313 } else { 314 submit_button( __( 'Delete' ), 'button alignleft', 'removewidget', false ); 315 } 316 submit_button( __( 'Save Widget' ), 'button-primary alignright', 'savewidget', false ); ?> 317 <input type="hidden" name="widget-id" class="widget-id" value="<?php echo esc_attr($widget_id); ?>" /> 318 <input type="hidden" name="id_base" class="id_base" value="<?php echo esc_attr($id_base); ?>" /> 319 <input type="hidden" name="multi_number" class="multi_number" value="<?php echo esc_attr($multi_number); ?>" /> 320 <?php wp_nonce_field("save-delete-widget-$widget_id"); ?> 321 <br class="clear" /> 322 </div> 323 </form> 324 </div> 325 </div> 326 <?php 327 require_once ( './admin-footer.php' ); 328 exit; 329 } 330 331 $messages = array( 332 __('Changes saved.') 333 ); 334 335 $errors = array( 336 __('Error while saving.'), 337 __('Error in displaying the widget settings form.') 338 ); 339 340 require_once ( './admin-header.php' ); ?> 341 342 <div class="wrap"> 343 <?php screen_icon(); ?> 344 <h2><?php echo esc_html( $title ); ?></h2> 345 346 <?php if ( isset($_GET['message']) && isset($messages[$_GET['message']]) ) { ?> 347 <div id="message" class="updated"><p><?php echo $messages[$_GET['message']]; ?></p></div> 348 <?php } ?> 349 <?php if ( isset($_GET['error']) && isset($errors[$_GET['error']]) ) { ?> 350 <div id="message" class="error"><p><?php echo $errors[$_GET['error']]; ?></p></div> 351 <?php } ?> 352 353 <?php do_action( 'widgets_admin_page' ); ?> 354 355 <div class="widget-liquid-left"> 356 <div id="widgets-left"> 357 <div id="available-widgets" class="widgets-holder-wrap"> 358 <div class="sidebar-name"> 359 <div class="sidebar-name-arrow"><br /></div> 360 <h3><?php _e('Available Widgets'); ?> <span id="removing-widget"><?php _ex('Deactivate', 'removing-widget'); ?> <span></span></span></h3></div> 361 <div class="widget-holder"> 362 <p class="description"><?php _e('Drag widgets from here to a sidebar on the right to activate them. Drag widgets back here to deactivate them and delete their settings.'); ?></p> 363 <div id="widget-list"> 364 <?php wp_list_widgets(); ?> 365 </div> 366 <br class='clear' /> 367 </div> 368 <br class="clear" /> 369 </div> 370 371 <div class="widgets-holder-wrap"> 372 <div class="sidebar-name"> 373 <div class="sidebar-name-arrow"><br /></div> 374 <h3><?php _e('Inactive Widgets'); ?> 375 <span><img src="<?php echo esc_url( admin_url( 'images/wpspin_light.gif' ) ); ?>" class="ajax-feedback" title="" alt="" /></span></h3></div> 376 <div class="widget-holder inactive"> 377 <p class="description"><?php _e('Drag widgets here to remove them from the sidebar but keep their settings.'); ?></p> 378 <?php wp_list_widget_controls('wp_inactive_widgets'); ?> 379 <br class="clear" /> 380 </div> 381 </div> 382 </div> 383 </div> 384 385 <div class="widget-liquid-right"> 386 <div id="widgets-right"> 387 <?php 388 $i = 0; 389 foreach ( $wp_registered_sidebars as $sidebar => $registered_sidebar ) { 390 if ( 'wp_inactive_widgets' == $sidebar ) 391 continue; 392 $closed = $i ? ' closed' : ''; ?> 393 <div class="widgets-holder-wrap<?php echo $closed; ?>"> 394 <div class="sidebar-name"> 395 <div class="sidebar-name-arrow"><br /></div> 396 <h3><?php echo esc_html( $registered_sidebar['name'] ); ?> 397 <span><img src="<?php echo esc_url( admin_url( 'images/wpspin_dark.gif' ) ); ?>" class="ajax-feedback" title="" alt="" /></span></h3></div> 398 <?php wp_list_widget_controls( $sidebar ); // Show the control forms for each of the widgets in this sidebar ?> 399 </div> 400 <?php 401 $i++; 402 } ?> 403 </div> 404 </div> 405 <form action="" method="post"> 406 <?php wp_nonce_field( 'save-sidebar-widgets', '_wpnonce_widgets', false ); ?> 407 </form> 408 <br class="clear" /> 409 </div> 410 411 <?php 412 do_action( 'sidebar_admin_page' ); 413 require_once ( './admin-footer.php' );
title
Description
Body
title
Description
Body
title
Description
Body
title
Body
| Generated: Wed Jun 1 08:30:02 2011 |
Cross-referenced by PHPXref 0.7 Provided by Yoast and awesome WordPress Hosting |