Changeset 18782
- Timestamp:
- 09/26/2011 09:32:10 PM (13 years ago)
- Location:
- trunk/wp-admin/includes
- Files:
-
- 2 edited
- 1 copied
Legend:
- Unmodified
- Added
- Removed
-
trunk/wp-admin/includes/admin.php
r17293 r18782 34 34 require_once(ABSPATH . 'wp-admin/includes/post.php'); 35 35 36 /** WordPress Administration Screen API */ 37 require_once(ABSPATH . 'wp-admin/includes/screen.php'); 38 36 39 /** WordPress Taxonomy Administration API */ 37 40 require_once(ABSPATH . 'wp-admin/includes/taxonomy.php'); -
trunk/wp-admin/includes/screen.php
r18781 r18782 1 1 <?php 2 2 /** 3 * Template WordPress Administration API. 4 * 5 * A Big Mess. Also some neat functions that are nicely written. 3 * WordPress Administration Screen API. 6 4 * 7 5 * @package WordPress 8 6 * @subpackage Administration 9 7 */ 10 11 12 //13 // Category Checklists14 //15 16 /**17 * {@internal Missing Short Description}}18 *19 * @since 2.5.120 */21 class Walker_Category_Checklist extends Walker {22 var $tree_type = 'category';23 var $db_fields = array ('parent' => 'parent', 'id' => 'term_id'); //TODO: decouple this24 25 function start_lvl(&$output, $depth, $args) {26 $indent = str_repeat("\t", $depth);27 $output .= "$indent<ul class='children'>\n";28 }29 30 function end_lvl(&$output, $depth, $args) {31 $indent = str_repeat("\t", $depth);32 $output .= "$indent</ul>\n";33 }34 35 function start_el(&$output, $category, $depth, $args) {36 extract($args);37 if ( empty($taxonomy) )38 $taxonomy = 'category';39 40 if ( $taxonomy == 'category' )41 $name = 'post_category';42 else43 $name = 'tax_input['.$taxonomy.']';44 45 $class = in_array( $category->term_id, $popular_cats ) ? ' class="popular-category"' : '';46 $output .= "\n<li id='{$taxonomy}-{$category->term_id}'$class>" . '<label class="selectit"><input value="' . $category->term_id . '" type="checkbox" name="'.$name.'[]" id="in-'.$taxonomy.'-' . $category->term_id . '"' . checked( in_array( $category->term_id, $selected_cats ), true, false ) . disabled( empty( $args['disabled'] ), false, false ) . ' /> ' . esc_html( apply_filters('the_category', $category->name )) . '</label>';47 }48 49 function end_el(&$output, $category, $depth, $args) {50 $output .= "</li>\n";51 }52 }53 54 /**55 * {@internal Missing Short Description}}56 *57 * @since 2.5.158 *59 * @param unknown_type $post_id60 * @param unknown_type $descendants_and_self61 * @param unknown_type $selected_cats62 * @param unknown_type $popular_cats63 */64 function wp_category_checklist( $post_id = 0, $descendants_and_self = 0, $selected_cats = false, $popular_cats = false, $walker = null, $checked_ontop = true ) {65 wp_terms_checklist($post_id,66 array(67 'taxonomy' => 'category',68 'descendants_and_self' => $descendants_and_self,69 'selected_cats' => $selected_cats,70 'popular_cats' => $popular_cats,71 'walker' => $walker,72 'checked_ontop' => $checked_ontop73 ));74 }75 76 /**77 * Taxonomy independent version of wp_category_checklist78 *79 * @since 3.0.080 *81 * @param int $post_id82 * @param array $args83 */84 function wp_terms_checklist($post_id = 0, $args = array()) {85 $defaults = array(86 'descendants_and_self' => 0,87 'selected_cats' => false,88 'popular_cats' => false,89 'walker' => null,90 'taxonomy' => 'category',91 'checked_ontop' => true92 );93 extract( wp_parse_args($args, $defaults), EXTR_SKIP );94 95 if ( empty($walker) || !is_a($walker, 'Walker') )96 $walker = new Walker_Category_Checklist;97 98 $descendants_and_self = (int) $descendants_and_self;99 100 $args = array('taxonomy' => $taxonomy);101 102 $tax = get_taxonomy($taxonomy);103 $args['disabled'] = !current_user_can($tax->cap->assign_terms);104 105 if ( is_array( $selected_cats ) )106 $args['selected_cats'] = $selected_cats;107 elseif ( $post_id )108 $args['selected_cats'] = wp_get_object_terms($post_id, $taxonomy, array_merge($args, array('fields' => 'ids')));109 else110 $args['selected_cats'] = array();111 112 if ( is_array( $popular_cats ) )113 $args['popular_cats'] = $popular_cats;114 else115 $args['popular_cats'] = get_terms( $taxonomy, array( 'fields' => 'ids', 'orderby' => 'count', 'order' => 'DESC', 'number' => 10, 'hierarchical' => false ) );116 117 if ( $descendants_and_self ) {118 $categories = (array) get_terms($taxonomy, array( 'child_of' => $descendants_and_self, 'hierarchical' => 0, 'hide_empty' => 0 ) );119 $self = get_term( $descendants_and_self, $taxonomy );120 array_unshift( $categories, $self );121 } else {122 $categories = (array) get_terms($taxonomy, array('get' => 'all'));123 }124 125 if ( $checked_ontop ) {126 // Post process $categories rather than adding an exclude to the get_terms() query to keep the query the same across all posts (for any query cache)127 $checked_categories = array();128 $keys = array_keys( $categories );129 130 foreach( $keys as $k ) {131 if ( in_array( $categories[$k]->term_id, $args['selected_cats'] ) ) {132 $checked_categories[] = $categories[$k];133 unset( $categories[$k] );134 }135 }136 137 // Put checked cats on top138 echo call_user_func_array(array(&$walker, 'walk'), array($checked_categories, 0, $args));139 }140 // Then the rest of them141 echo call_user_func_array(array(&$walker, 'walk'), array($categories, 0, $args));142 }143 144 /**145 * {@internal Missing Short Description}}146 *147 * @since 2.5.0148 *149 * @param unknown_type $taxonomy150 * @param unknown_type $default151 * @param unknown_type $number152 * @param unknown_type $echo153 * @return unknown154 */155 function wp_popular_terms_checklist( $taxonomy, $default = 0, $number = 10, $echo = true ) {156 global $post_ID;157 158 if ( $post_ID )159 $checked_terms = wp_get_object_terms($post_ID, $taxonomy, array('fields'=>'ids'));160 else161 $checked_terms = array();162 163 $terms = get_terms( $taxonomy, array( 'orderby' => 'count', 'order' => 'DESC', 'number' => $number, 'hierarchical' => false ) );164 165 $tax = get_taxonomy($taxonomy);166 if ( ! current_user_can($tax->cap->assign_terms) )167 $disabled = 'disabled="disabled"';168 else169 $disabled = '';170 171 $popular_ids = array();172 foreach ( (array) $terms as $term ) {173 $popular_ids[] = $term->term_id;174 if ( !$echo ) // hack for AJAX use175 continue;176 $id = "popular-$taxonomy-$term->term_id";177 $checked = in_array( $term->term_id, $checked_terms ) ? 'checked="checked"' : '';178 ?>179 180 <li id="<?php echo $id; ?>" class="popular-category">181 <label class="selectit">182 <input id="in-<?php echo $id; ?>" type="checkbox" <?php echo $checked; ?> value="<?php echo (int) $term->term_id; ?>" <?php echo $disabled ?>/>183 <?php echo esc_html( apply_filters( 'the_category', $term->name ) ); ?>184 </label>185 </li>186 187 <?php188 }189 return $popular_ids;190 }191 192 /**193 * {@internal Missing Short Description}}194 *195 * @since 2.5.1196 *197 * @param unknown_type $link_id198 */199 function wp_link_category_checklist( $link_id = 0 ) {200 $default = 1;201 202 if ( $link_id ) {203 $checked_categories = wp_get_link_cats( $link_id );204 // No selected categories, strange205 if ( ! count( $checked_categories ) )206 $checked_categories[] = $default;207 } else {208 $checked_categories[] = $default;209 }210 211 $categories = get_terms( 'link_category', array( 'orderby' => 'name', 'hide_empty' => 0 ) );212 213 if ( empty( $categories ) )214 return;215 216 foreach ( $categories as $category ) {217 $cat_id = $category->term_id;218 $name = esc_html( apply_filters( 'the_category', $category->name ) );219 $checked = in_array( $cat_id, $checked_categories ) ? ' checked="checked"' : '';220 echo '<li id="link-category-', $cat_id, '"><label for="in-link-category-', $cat_id, '" class="selectit"><input value="', $cat_id, '" type="checkbox" name="link_category[]" id="in-link-category-', $cat_id, '"', $checked, '/> ', $name, "</label></li>";221 }222 }223 8 224 9 /** … … 256 41 257 42 return (array) get_user_option( 'manage' . $screen->id . 'columnshidden' ); 258 }259 260 // adds hidden fields with the data for use in the inline editor for posts and pages261 /**262 * {@internal Missing Short Description}}263 *264 * @since 2.7.0265 *266 * @param unknown_type $post267 */268 function get_inline_data($post) {269 $post_type_object = get_post_type_object($post->post_type);270 if ( ! current_user_can($post_type_object->cap->edit_post, $post->ID) )271 return;272 273 $title = esc_textarea( trim( $post->post_title ) );274 275 echo '276 <div class="hidden" id="inline_' . $post->ID . '">277 <div class="post_title">' . $title . '</div>278 <div class="post_name">' . apply_filters('editable_slug', $post->post_name) . '</div>279 <div class="post_author">' . $post->post_author . '</div>280 <div class="comment_status">' . esc_html( $post->comment_status ) . '</div>281 <div class="ping_status">' . esc_html( $post->ping_status ) . '</div>282 <div class="_status">' . esc_html( $post->post_status ) . '</div>283 <div class="jj">' . mysql2date( 'd', $post->post_date, false ) . '</div>284 <div class="mm">' . mysql2date( 'm', $post->post_date, false ) . '</div>285 <div class="aa">' . mysql2date( 'Y', $post->post_date, false ) . '</div>286 <div class="hh">' . mysql2date( 'H', $post->post_date, false ) . '</div>287 <div class="mn">' . mysql2date( 'i', $post->post_date, false ) . '</div>288 <div class="ss">' . mysql2date( 's', $post->post_date, false ) . '</div>289 <div class="post_password">' . esc_html( $post->post_password ) . '</div>';290 291 if ( $post_type_object->hierarchical )292 echo '<div class="post_parent">' . $post->post_parent . '</div>';293 294 if ( $post->post_type == 'page' )295 echo '<div class="page_template">' . esc_html( get_post_meta( $post->ID, '_wp_page_template', true ) ) . '</div>';296 297 if ( $post_type_object->hierarchical )298 echo '<div class="menu_order">' . $post->menu_order . '</div>';299 300 $taxonomy_names = get_object_taxonomies( $post->post_type );301 foreach ( $taxonomy_names as $taxonomy_name) {302 $taxonomy = get_taxonomy( $taxonomy_name );303 304 if ( $taxonomy->hierarchical && $taxonomy->show_ui )305 echo '<div class="post_category" id="'.$taxonomy_name.'_'.$post->ID.'">' . implode( ',', wp_get_object_terms( $post->ID, $taxonomy_name, array('fields'=>'ids')) ) . '</div>';306 elseif ( $taxonomy->show_ui )307 echo '<div class="tags_input" id="'.$taxonomy_name.'_'.$post->ID.'">' . esc_html( str_replace( ',', ', ', get_terms_to_edit($post->ID, $taxonomy_name) ) ) . '</div>';308 }309 310 if ( !$post_type_object->hierarchical )311 echo '<div class="sticky">' . (is_sticky($post->ID) ? 'sticky' : '') . '</div>';312 313 if ( post_type_supports( $post->post_type, 'post-formats' ) )314 echo '<div class="post_format">' . esc_html( get_post_format( $post->ID ) ) . '</div>';315 316 echo '</div>';317 }318 319 /**320 * {@internal Missing Short Description}}321 *322 * @since 2.7.0323 *324 * @param unknown_type $position325 * @param unknown_type $checkbox326 * @param unknown_type $mode327 */328 function wp_comment_reply($position = '1', $checkbox = false, $mode = 'single', $table_row = true) {329 // allow plugin to replace the popup content330 $content = apply_filters( 'wp_comment_reply', '', array('position' => $position, 'checkbox' => $checkbox, 'mode' => $mode) );331 332 if ( ! empty($content) ) {333 echo $content;334 return;335 }336 337 if ( $mode == 'single' ) {338 $wp_list_table = _get_list_table('WP_Post_Comments_List_Table');339 } else {340 $wp_list_table = _get_list_table('WP_Comments_List_Table');341 }342 343 ?>344 <form method="get" action="">345 <?php if ( $table_row ) : ?>346 <table style="display:none;"><tbody id="com-reply"><tr id="replyrow" style="display:none;"><td colspan="<?php echo $wp_list_table->get_column_count(); ?>" class="colspanchange">347 <?php else : ?>348 <div id="com-reply" style="display:none;"><div id="replyrow" style="display:none;">349 <?php endif; ?>350 <div id="replyhead" style="display:none;"><?php _e('Reply to Comment'); ?></div>351 352 <div id="edithead" style="display:none;">353 <div class="inside">354 <label for="author"><?php _e('Name') ?></label>355 <input type="text" name="newcomment_author" size="50" value="" tabindex="101" id="author" />356 </div>357 358 <div class="inside">359 <label for="author-email"><?php _e('E-mail') ?></label>360 <input type="text" name="newcomment_author_email" size="50" value="" tabindex="102" id="author-email" />361 </div>362 363 <div class="inside">364 <label for="author-url"><?php _e('URL') ?></label>365 <input type="text" id="author-url" name="newcomment_author_url" size="103" value="" tabindex="103" />366 </div>367 <div style="clear:both;"></div>368 </div>369 370 <div id="replycontainer"><textarea rows="8" cols="40" name="replycontent" tabindex="104" id="replycontent"></textarea></div>371 372 <p id="replysubmit" class="submit">373 <a href="#comments-form" class="cancel button-secondary alignleft" tabindex="106"><?php _e('Cancel'); ?></a>374 <a href="#comments-form" class="save button-primary alignright" tabindex="104">375 <span id="savebtn" style="display:none;"><?php _e('Update Comment'); ?></span>376 <span id="replybtn" style="display:none;"><?php _e('Submit Reply'); ?></span></a>377 <img class="waiting" style="display:none;" src="<?php echo esc_url( admin_url( 'images/wpspin_light.gif' ) ); ?>" alt="" />378 <span class="error" style="display:none;"></span>379 <br class="clear" />380 </p>381 382 <input type="hidden" name="user_ID" id="user_ID" value="<?php echo get_current_user_id(); ?>" />383 <input type="hidden" name="action" id="action" value="" />384 <input type="hidden" name="comment_ID" id="comment_ID" value="" />385 <input type="hidden" name="comment_post_ID" id="comment_post_ID" value="" />386 <input type="hidden" name="status" id="status" value="" />387 <input type="hidden" name="position" id="position" value="<?php echo $position; ?>" />388 <input type="hidden" name="checkbox" id="checkbox" value="<?php echo $checkbox ? 1 : 0; ?>" />389 <input type="hidden" name="mode" id="mode" value="<?php echo esc_attr($mode); ?>" />390 <?php wp_nonce_field( 'replyto-comment', '_ajax_nonce-replyto-comment', false ); ?>391 <?php wp_comment_form_unfiltered_html_nonce(); ?>392 <?php if ( $table_row ) : ?>393 </td></tr></tbody></table>394 <?php else : ?>395 </div></div>396 <?php endif; ?>397 </form>398 <?php399 }400 401 /**402 * Output 'undo move to trash' text for comments403 *404 * @since 2.9.0405 */406 function wp_comment_trashnotice() {407 ?>408 <div class="hidden" id="trash-undo-holder">409 <div class="trash-undo-inside"><?php printf(__('Comment by %s moved to the trash.'), '<strong></strong>'); ?> <span class="undo untrash"><a href="#"><?php _e('Undo'); ?></a></span></div>410 </div>411 <div class="hidden" id="spam-undo-holder">412 <div class="spam-undo-inside"><?php printf(__('Comment by %s marked as spam.'), '<strong></strong>'); ?> <span class="undo unspam"><a href="#"><?php _e('Undo'); ?></a></span></div>413 </div>414 <?php415 }416 417 /**418 * {@internal Missing Short Description}}419 *420 * @since 1.2.0421 *422 * @param unknown_type $meta423 */424 function list_meta( $meta ) {425 // Exit if no meta426 if ( ! $meta ) {427 echo '428 <table id="list-table" style="display: none;">429 <thead>430 <tr>431 <th class="left">' . _x( 'Name', 'meta name' ) . '</th>432 <th>' . __( 'Value' ) . '</th>433 </tr>434 </thead>435 <tbody id="the-list" class="list:meta">436 <tr><td></td></tr>437 </tbody>438 </table>'; //TBODY needed for list-manipulation JS439 return;440 }441 $count = 0;442 ?>443 <table id="list-table">444 <thead>445 <tr>446 <th class="left"><?php _ex( 'Name', 'meta name' ) ?></th>447 <th><?php _e( 'Value' ) ?></th>448 </tr>449 </thead>450 <tbody id='the-list' class='list:meta'>451 <?php452 foreach ( $meta as $entry )453 echo _list_meta_row( $entry, $count );454 ?>455 </tbody>456 </table>457 <?php458 }459 460 /**461 * {@internal Missing Short Description}}462 *463 * @since 2.5.0464 *465 * @param unknown_type $entry466 * @param unknown_type $count467 * @return unknown468 */469 function _list_meta_row( $entry, &$count ) {470 static $update_nonce = false;471 472 if ( is_protected_meta( $entry['meta_key'], 'post' ) )473 return;474 475 if ( !$update_nonce )476 $update_nonce = wp_create_nonce( 'add-meta' );477 478 $r = '';479 ++ $count;480 if ( $count % 2 )481 $style = 'alternate';482 else483 $style = '';484 485 if ( is_serialized( $entry['meta_value'] ) ) {486 if ( is_serialized_string( $entry['meta_value'] ) ) {487 // this is a serialized string, so we should display it488 $entry['meta_value'] = maybe_unserialize( $entry['meta_value'] );489 } else {490 // this is a serialized array/object so we should NOT display it491 --$count;492 return;493 }494 }495 496 $entry['meta_key'] = esc_attr($entry['meta_key']);497 $entry['meta_value'] = esc_textarea( $entry['meta_value'] ); // using a <textarea />498 $entry['meta_id'] = (int) $entry['meta_id'];499 500 $delete_nonce = wp_create_nonce( 'delete-meta_' . $entry['meta_id'] );501 502 $r .= "\n\t<tr id='meta-{$entry['meta_id']}' class='$style'>";503 $r .= "\n\t\t<td class='left'><label class='screen-reader-text' for='meta[{$entry['meta_id']}][key]'>" . __( 'Key' ) . "</label><input name='meta[{$entry['meta_id']}][key]' id='meta[{$entry['meta_id']}][key]' tabindex='6' type='text' size='20' value='{$entry['meta_key']}' />";504 505 $r .= "\n\t\t<div class='submit'>";506 $r .= get_submit_button( __( 'Delete' ), "delete:the-list:meta-{$entry['meta_id']}::_ajax_nonce=$delete_nonce deletemeta", "deletemeta[{$entry['meta_id']}]", false, array( 'tabindex' => '6' ) );507 $r .= "\n\t\t";508 $r .= get_submit_button( __( 'Update' ), "add:the-list:meta-{$entry['meta_id']}::_ajax_nonce-add-meta=$update_nonce updatemeta" , 'updatemeta', false, array( 'tabindex' => '6' ) );509 $r .= "</div>";510 $r .= wp_nonce_field( 'change-meta', '_ajax_nonce', false, false );511 $r .= "</td>";512 513 $r .= "\n\t\t<td><label class='screen-reader-text' for='meta[{$entry['meta_id']}][value]'>" . __( 'Value' ) . "</label><textarea name='meta[{$entry['meta_id']}][value]' id='meta[{$entry['meta_id']}][value]' tabindex='6' rows='2' cols='30'>{$entry['meta_value']}</textarea></td>\n\t</tr>";514 return $r;515 }516 517 /**518 * {@internal Missing Short Description}}519 *520 * @since 1.2.0521 */522 function meta_form() {523 global $wpdb;524 $limit = (int) apply_filters( 'postmeta_form_limit', 30 );525 $keys = $wpdb->get_col( "526 SELECT meta_key527 FROM $wpdb->postmeta528 GROUP BY meta_key529 HAVING meta_key NOT LIKE '\_%'530 ORDER BY meta_key531 LIMIT $limit" );532 if ( $keys )533 natcasesort($keys);534 ?>535 <p><strong><?php _e( 'Add New Custom Field:' ) ?></strong></p>536 <table id="newmeta">537 <thead>538 <tr>539 <th class="left"><label for="metakeyselect"><?php _ex( 'Name', 'meta name' ) ?></label></th>540 <th><label for="metavalue"><?php _e( 'Value' ) ?></label></th>541 </tr>542 </thead>543 544 <tbody>545 <tr>546 <td id="newmetaleft" class="left">547 <?php if ( $keys ) { ?>548 <select id="metakeyselect" name="metakeyselect" tabindex="7">549 <option value="#NONE#"><?php _e( '— Select —' ); ?></option>550 <?php551 552 foreach ( $keys as $key ) {553 echo "\n<option value='" . esc_attr($key) . "'>" . esc_html($key) . "</option>";554 }555 ?>556 </select>557 <input class="hide-if-js" type="text" id="metakeyinput" name="metakeyinput" tabindex="7" value="" />558 <a href="#postcustomstuff" class="hide-if-no-js" onclick="jQuery('#metakeyinput, #metakeyselect, #enternew, #cancelnew').toggle();return false;">559 <span id="enternew"><?php _e('Enter new'); ?></span>560 <span id="cancelnew" class="hidden"><?php _e('Cancel'); ?></span></a>561 <?php } else { ?>562 <input type="text" id="metakeyinput" name="metakeyinput" tabindex="7" value="" />563 <?php } ?>564 </td>565 <td><textarea id="metavalue" name="metavalue" rows="2" cols="25" tabindex="8"></textarea></td>566 </tr>567 568 <tr><td colspan="2" class="submit">569 <?php submit_button( __( 'Add Custom Field' ), 'add:the-list:newmeta', 'addmeta', false, array( 'id' => 'addmetasub', 'tabindex' => '9' ) ); ?>570 <?php wp_nonce_field( 'add-meta', '_ajax_nonce-add-meta', false ); ?>571 </td></tr>572 </tbody>573 </table>574 <?php575 576 }577 578 /**579 * {@internal Missing Short Description}}580 *581 * @since 0.71582 *583 * @param unknown_type $edit584 * @param unknown_type $for_post585 * @param unknown_type $tab_index586 * @param unknown_type $multi587 */588 function touch_time( $edit = 1, $for_post = 1, $tab_index = 0, $multi = 0 ) {589 global $wp_locale, $post, $comment;590 591 if ( $for_post )592 $edit = ! ( in_array($post->post_status, array('draft', 'pending') ) && (!$post->post_date_gmt || '0000-00-00 00:00:00' == $post->post_date_gmt ) );593 594 $tab_index_attribute = '';595 if ( (int) $tab_index > 0 )596 $tab_index_attribute = " tabindex=\"$tab_index\"";597 598 // echo '<label for="timestamp" style="display: block;"><input type="checkbox" class="checkbox" name="edit_date" value="1" id="timestamp"'.$tab_index_attribute.' /> '.__( 'Edit timestamp' ).'</label><br />';599 600 $time_adj = current_time('timestamp');601 $post_date = ($for_post) ? $post->post_date : $comment->comment_date;602 $jj = ($edit) ? mysql2date( 'd', $post_date, false ) : gmdate( 'd', $time_adj );603 $mm = ($edit) ? mysql2date( 'm', $post_date, false ) : gmdate( 'm', $time_adj );604 $aa = ($edit) ? mysql2date( 'Y', $post_date, false ) : gmdate( 'Y', $time_adj );605 $hh = ($edit) ? mysql2date( 'H', $post_date, false ) : gmdate( 'H', $time_adj );606 $mn = ($edit) ? mysql2date( 'i', $post_date, false ) : gmdate( 'i', $time_adj );607 $ss = ($edit) ? mysql2date( 's', $post_date, false ) : gmdate( 's', $time_adj );608 609 $cur_jj = gmdate( 'd', $time_adj );610 $cur_mm = gmdate( 'm', $time_adj );611 $cur_aa = gmdate( 'Y', $time_adj );612 $cur_hh = gmdate( 'H', $time_adj );613 $cur_mn = gmdate( 'i', $time_adj );614 615 $month = "<select " . ( $multi ? '' : 'id="mm" ' ) . "name=\"mm\"$tab_index_attribute>\n";616 for ( $i = 1; $i < 13; $i = $i +1 ) {617 $month .= "\t\t\t" . '<option value="' . zeroise($i, 2) . '"';618 if ( $i == $mm )619 $month .= ' selected="selected"';620 $month .= '>' . $wp_locale->get_month_abbrev( $wp_locale->get_month( $i ) ) . "</option>\n";621 }622 $month .= '</select>';623 624 $day = '<input type="text" ' . ( $multi ? '' : 'id="jj" ' ) . 'name="jj" value="' . $jj . '" size="2" maxlength="2"' . $tab_index_attribute . ' autocomplete="off" />';625 $year = '<input type="text" ' . ( $multi ? '' : 'id="aa" ' ) . 'name="aa" value="' . $aa . '" size="4" maxlength="4"' . $tab_index_attribute . ' autocomplete="off" />';626 $hour = '<input type="text" ' . ( $multi ? '' : 'id="hh" ' ) . 'name="hh" value="' . $hh . '" size="2" maxlength="2"' . $tab_index_attribute . ' autocomplete="off" />';627 $minute = '<input type="text" ' . ( $multi ? '' : 'id="mn" ' ) . 'name="mn" value="' . $mn . '" size="2" maxlength="2"' . $tab_index_attribute . ' autocomplete="off" />';628 629 echo '<div class="timestamp-wrap">';630 /* translators: 1: month input, 2: day input, 3: year input, 4: hour input, 5: minute input */631 printf(__('%1$s%2$s, %3$s @ %4$s : %5$s'), $month, $day, $year, $hour, $minute);632 633 echo '</div><input type="hidden" id="ss" name="ss" value="' . $ss . '" />';634 635 if ( $multi ) return;636 637 echo "\n\n";638 foreach ( array('mm', 'jj', 'aa', 'hh', 'mn') as $timeunit ) {639 echo '<input type="hidden" id="hidden_' . $timeunit . '" name="hidden_' . $timeunit . '" value="' . $$timeunit . '" />' . "\n";640 $cur_timeunit = 'cur_' . $timeunit;641 echo '<input type="hidden" id="'. $cur_timeunit . '" name="'. $cur_timeunit . '" value="' . $$cur_timeunit . '" />' . "\n";642 }643 ?>644 645 <p>646 <a href="#edit_timestamp" class="save-timestamp hide-if-no-js button"><?php _e('OK'); ?></a>647 <a href="#edit_timestamp" class="cancel-timestamp hide-if-no-js"><?php _e('Cancel'); ?></a>648 </p>649 <?php650 }651 652 /**653 * {@internal Missing Short Description}}654 *655 * @since 1.5.0656 *657 * @param unknown_type $default658 */659 function page_template_dropdown( $default = '' ) {660 $templates = get_page_templates();661 ksort( $templates );662 foreach (array_keys( $templates ) as $template )663 : if ( $default == $templates[$template] )664 $selected = " selected='selected'";665 else666 $selected = '';667 echo "\n\t<option value='".$templates[$template]."' $selected>$template</option>";668 endforeach;669 }670 671 /**672 * {@internal Missing Short Description}}673 *674 * @since 1.5.0675 *676 * @param unknown_type $default677 * @param unknown_type $parent678 * @param unknown_type $level679 * @return unknown680 */681 function parent_dropdown( $default = 0, $parent = 0, $level = 0 ) {682 global $wpdb, $post_ID;683 $items = $wpdb->get_results( $wpdb->prepare("SELECT ID, post_parent, post_title FROM $wpdb->posts WHERE post_parent = %d AND post_type = 'page' ORDER BY menu_order", $parent) );684 685 if ( $items ) {686 foreach ( $items as $item ) {687 // A page cannot be its own parent.688 if (!empty ( $post_ID ) ) {689 if ( $item->ID == $post_ID ) {690 continue;691 }692 }693 $pad = str_repeat( ' ', $level * 3 );694 if ( $item->ID == $default)695 $current = ' selected="selected"';696 else697 $current = '';698 699 echo "\n\t<option class='level-$level' value='$item->ID'$current>$pad " . esc_html($item->post_title) . "</option>";700 parent_dropdown( $default, $item->ID, $level +1 );701 }702 } else {703 return false;704 }705 }706 707 /**708 * {@internal Missing Short Description}}709 *710 * @since 2.0.0711 *712 * @param unknown_type $id713 * @return unknown714 */715 function the_attachment_links( $id = false ) {716 $id = (int) $id;717 $post = & get_post( $id );718 719 if ( $post->post_type != 'attachment' )720 return false;721 722 $icon = wp_get_attachment_image( $post->ID, 'thumbnail', true );723 $attachment_data = wp_get_attachment_metadata( $id );724 $thumb = isset( $attachment_data['thumb'] );725 ?>726 <form id="the-attachment-links">727 <table>728 <col />729 <col class="widefat" />730 <tr>731 <th scope="row"><?php _e( 'URL' ) ?></th>732 <td><textarea rows="1" cols="40" type="text" class="attachmentlinks" readonly="readonly"><?php echo esc_textarea( wp_get_attachment_url() ); ?></textarea></td>733 </tr>734 <?php if ( $icon ) : ?>735 <tr>736 <th scope="row"><?php $thumb ? _e( 'Thumbnail linked to file' ) : _e( 'Image linked to file' ); ?></th>737 <td><textarea rows="1" cols="40" type="text" class="attachmentlinks" readonly="readonly"><a href="<?php echo wp_get_attachment_url(); ?>"><?php echo $icon ?></a></textarea></td>738 </tr>739 <tr>740 <th scope="row"><?php $thumb ? _e( 'Thumbnail linked to page' ) : _e( 'Image linked to page' ); ?></th>741 <td><textarea rows="1" cols="40" type="text" class="attachmentlinks" readonly="readonly"><a href="<?php echo get_attachment_link( $post->ID ) ?>" rel="attachment wp-att-<?php echo $post->ID; ?>"><?php echo $icon ?></a></textarea></td>742 </tr>743 <?php else : ?>744 <tr>745 <th scope="row"><?php _e( 'Link to file' ) ?></th>746 <td><textarea rows="1" cols="40" type="text" class="attachmentlinks" readonly="readonly"><a href="<?php echo wp_get_attachment_url(); ?>" class="attachmentlink"><?php echo basename( wp_get_attachment_url() ); ?></a></textarea></td>747 </tr>748 <tr>749 <th scope="row"><?php _e( 'Link to page' ) ?></th>750 <td><textarea rows="1" cols="40" type="text" class="attachmentlinks" readonly="readonly"><a href="<?php echo get_attachment_link( $post->ID ) ?>" rel="attachment wp-att-<?php echo $post->ID ?>"><?php the_title(); ?></a></textarea></td>751 </tr>752 <?php endif; ?>753 </table>754 </form>755 <?php756 }757 758 759 /**760 * Print out <option> html elements for role selectors761 *762 * @since 2.1.0763 *764 * @param string $selected slug for the role that should be already selected765 */766 function wp_dropdown_roles( $selected = false ) {767 $p = '';768 $r = '';769 770 $editable_roles = get_editable_roles();771 772 foreach ( $editable_roles as $role => $details ) {773 $name = translate_user_role($details['name'] );774 if ( $selected == $role ) // preselect specified role775 $p = "\n\t<option selected='selected' value='" . esc_attr($role) . "'>$name</option>";776 else777 $r .= "\n\t<option value='" . esc_attr($role) . "'>$name</option>";778 }779 echo $p . $r;780 }781 782 /**783 * {@internal Missing Short Description}}784 *785 * @since 2.3.0786 *787 * @param unknown_type $size788 * @return unknown789 */790 function wp_convert_hr_to_bytes( $size ) {791 $size = strtolower($size);792 $bytes = (int) $size;793 if ( strpos($size, 'k') !== false )794 $bytes = intval($size) * 1024;795 elseif ( strpos($size, 'm') !== false )796 $bytes = intval($size) * 1024 * 1024;797 elseif ( strpos($size, 'g') !== false )798 $bytes = intval($size) * 1024 * 1024 * 1024;799 return $bytes;800 }801 802 /**803 * {@internal Missing Short Description}}804 *805 * @since 2.3.0806 *807 * @param unknown_type $bytes808 * @return unknown809 */810 function wp_convert_bytes_to_hr( $bytes ) {811 $units = array( 0 => 'B', 1 => 'kB', 2 => 'MB', 3 => 'GB' );812 $log = log( $bytes, 1024 );813 $power = (int) $log;814 $size = pow(1024, $log - $power);815 return $size . $units[$power];816 }817 818 /**819 * {@internal Missing Short Description}}820 *821 * @since 2.5.0822 *823 * @return unknown824 */825 function wp_max_upload_size() {826 $u_bytes = wp_convert_hr_to_bytes( ini_get( 'upload_max_filesize' ) );827 $p_bytes = wp_convert_hr_to_bytes( ini_get( 'post_max_size' ) );828 $bytes = apply_filters( 'upload_size_limit', min($u_bytes, $p_bytes), $u_bytes, $p_bytes );829 return $bytes;830 }831 832 /**833 * Outputs the form used by the importers to accept the data to be imported834 *835 * @since 2.0.0836 *837 * @param string $action The action attribute for the form.838 */839 function wp_import_upload_form( $action ) {840 $bytes = apply_filters( 'import_upload_size_limit', wp_max_upload_size() );841 $size = wp_convert_bytes_to_hr( $bytes );842 $upload_dir = wp_upload_dir();843 if ( ! empty( $upload_dir['error'] ) ) :844 ?><div class="error"><p><?php _e('Before you can upload your import file, you will need to fix the following error:'); ?></p>845 <p><strong><?php echo $upload_dir['error']; ?></strong></p></div><?php846 else :847 ?>848 <form enctype="multipart/form-data" id="import-upload-form" method="post" action="<?php echo esc_attr(wp_nonce_url($action, 'import-upload')); ?>">849 <p>850 <label for="upload"><?php _e( 'Choose a file from your computer:' ); ?></label> (<?php printf( __('Maximum size: %s' ), $size ); ?>)851 <input type="file" id="upload" name="import" size="25" />852 <input type="hidden" name="action" value="save" />853 <input type="hidden" name="max_file_size" value="<?php echo $bytes; ?>" />854 </p>855 <?php submit_button( __('Upload file and import'), 'button' ); ?>856 </form>857 <?php858 endif;859 }860 861 /**862 * Add a meta box to an edit form.863 *864 * @since 2.5.0865 *866 * @param string $id String for use in the 'id' attribute of tags.867 * @param string $title Title of the meta box.868 * @param string $callback Function that fills the box with the desired content. The function should echo its output.869 * @param string $page The type of edit page on which to show the box (post, page, link).870 * @param string $context The context within the page where the boxes should show ('normal', 'advanced').871 * @param string $priority The priority within the context where the boxes should show ('high', 'low').872 */873 function add_meta_box($id, $title, $callback, $page, $context = 'advanced', $priority = 'default', $callback_args=null) {874 global $wp_meta_boxes;875 876 if ( !isset($wp_meta_boxes) )877 $wp_meta_boxes = array();878 if ( !isset($wp_meta_boxes[$page]) )879 $wp_meta_boxes[$page] = array();880 if ( !isset($wp_meta_boxes[$page][$context]) )881 $wp_meta_boxes[$page][$context] = array();882 883 foreach ( array_keys($wp_meta_boxes[$page]) as $a_context ) {884 foreach ( array('high', 'core', 'default', 'low') as $a_priority ) {885 if ( !isset($wp_meta_boxes[$page][$a_context][$a_priority][$id]) )886 continue;887 888 // If a core box was previously added or removed by a plugin, don't add.889 if ( 'core' == $priority ) {890 // If core box previously deleted, don't add891 if ( false === $wp_meta_boxes[$page][$a_context][$a_priority][$id] )892 return;893 // If box was added with default priority, give it core priority to maintain sort order894 if ( 'default' == $a_priority ) {895 $wp_meta_boxes[$page][$a_context]['core'][$id] = $wp_meta_boxes[$page][$a_context]['default'][$id];896 unset($wp_meta_boxes[$page][$a_context]['default'][$id]);897 }898 return;899 }900 // If no priority given and id already present, use existing priority901 if ( empty($priority) ) {902 $priority = $a_priority;903 // else if we're adding to the sorted priority, we don't know the title or callback. Grab them from the previously added context/priority.904 } elseif ( 'sorted' == $priority ) {905 $title = $wp_meta_boxes[$page][$a_context][$a_priority][$id]['title'];906 $callback = $wp_meta_boxes[$page][$a_context][$a_priority][$id]['callback'];907 $callback_args = $wp_meta_boxes[$page][$a_context][$a_priority][$id]['args'];908 }909 // An id can be in only one priority and one context910 if ( $priority != $a_priority || $context != $a_context )911 unset($wp_meta_boxes[$page][$a_context][$a_priority][$id]);912 }913 }914 915 if ( empty($priority) )916 $priority = 'low';917 918 if ( !isset($wp_meta_boxes[$page][$context][$priority]) )919 $wp_meta_boxes[$page][$context][$priority] = array();920 921 $wp_meta_boxes[$page][$context][$priority][$id] = array('id' => $id, 'title' => $title, 'callback' => $callback, 'args' => $callback_args);922 }923 924 /**925 * Meta-Box template function926 *927 * @since 2.5.0928 *929 * @param string $page page identifier, also known as screen identifier930 * @param string $context box context931 * @param mixed $object gets passed to the box callback function as first parameter932 * @return int number of meta_boxes933 */934 function do_meta_boxes($page, $context, $object) {935 global $wp_meta_boxes;936 static $already_sorted = false;937 938 $hidden = get_hidden_meta_boxes($page);939 940 printf('<div id="%s-sortables" class="meta-box-sortables">', htmlspecialchars($context));941 942 $i = 0;943 do {944 // Grab the ones the user has manually sorted. Pull them out of their previous context/priority and into the one the user chose945 if ( !$already_sorted && $sorted = get_user_option( "meta-box-order_$page" ) ) {946 foreach ( $sorted as $box_context => $ids ) {947 foreach ( explode(',', $ids ) as $id ) {948 if ( $id && 'dashboard_browser_nag' !== $id )949 add_meta_box( $id, null, null, $page, $box_context, 'sorted' );950 }951 }952 }953 $already_sorted = true;954 955 if ( !isset($wp_meta_boxes) || !isset($wp_meta_boxes[$page]) || !isset($wp_meta_boxes[$page][$context]) )956 break;957 958 foreach ( array('high', 'sorted', 'core', 'default', 'low') as $priority ) {959 if ( isset($wp_meta_boxes[$page][$context][$priority]) ) {960 foreach ( (array) $wp_meta_boxes[$page][$context][$priority] as $box ) {961 if ( false == $box || ! $box['title'] )962 continue;963 $i++;964 $style = '';965 $hidden_class = in_array($box['id'], $hidden) ? ' hide-if-js' : '';966 echo '<div id="' . $box['id'] . '" class="postbox ' . postbox_classes($box['id'], $page) . $hidden_class . '" ' . '>' . "\n";967 if ( 'dashboard_browser_nag' != $box['id'] )968 echo '<div class="handlediv" title="' . esc_attr__('Click to toggle') . '"><br /></div>';969 echo "<h3 class='hndle'><span>{$box['title']}</span></h3>\n";970 echo '<div class="inside">' . "\n";971 call_user_func($box['callback'], $object, $box);972 echo "</div>\n";973 echo "</div>\n";974 }975 }976 }977 } while(0);978 979 echo "</div>";980 981 return $i;982 983 }984 985 /**986 * Remove a meta box from an edit form.987 *988 * @since 2.6.0989 *990 * @param string $id String for use in the 'id' attribute of tags.991 * @param string $page The type of edit page on which to show the box (post, page, link).992 * @param string $context The context within the page where the boxes should show ('normal', 'advanced').993 */994 function remove_meta_box($id, $page, $context) {995 global $wp_meta_boxes;996 997 if ( !isset($wp_meta_boxes) )998 $wp_meta_boxes = array();999 if ( !isset($wp_meta_boxes[$page]) )1000 $wp_meta_boxes[$page] = array();1001 if ( !isset($wp_meta_boxes[$page][$context]) )1002 $wp_meta_boxes[$page][$context] = array();1003 1004 foreach ( array('high', 'core', 'default', 'low') as $priority )1005 $wp_meta_boxes[$page][$context][$priority][$id] = false;1006 43 } 1007 44 … … 1068 105 1069 106 /** 1070 * Add a new section to a settings page.1071 *1072 * Part of the Settings API. Use this to define new settings sections for an admin page.1073 * Show settings sections in your admin page callback function with do_settings_sections().1074 * Add settings fields to your section with add_settings_field()1075 *1076 * The $callback argument should be the name of a function that echoes out any1077 * content you want to show at the top of the settings section before the actual1078 * fields. It can output nothing if you want.1079 *1080 * @since 2.7.01081 *1082 * @global $wp_settings_sections Storage array of all settings sections added to admin pages1083 *1084 * @param string $id Slug-name to identify the section. Used in the 'id' attribute of tags.1085 * @param string $title Formatted title of the section. Shown as the heading for the section.1086 * @param string $callback Function that echos out any content at the top of the section (between heading and fields).1087 * @param string $page The slug-name of the settings page on which to show the section. Built-in pages include 'general', 'reading', 'writing', 'discussion', 'media', etc. Create your own using add_options_page();1088 */1089 function add_settings_section($id, $title, $callback, $page) {1090 global $wp_settings_sections;1091 1092 if ( 'misc' == $page ) {1093 _deprecated_argument( __FUNCTION__, '3.0', __( 'The miscellaneous options group has been removed. Use another settings group.' ) );1094 $page = 'general';1095 }1096 1097 if ( !isset($wp_settings_sections) )1098 $wp_settings_sections = array();1099 if ( !isset($wp_settings_sections[$page]) )1100 $wp_settings_sections[$page] = array();1101 if ( !isset($wp_settings_sections[$page][$id]) )1102 $wp_settings_sections[$page][$id] = array();1103 1104 $wp_settings_sections[$page][$id] = array('id' => $id, 'title' => $title, 'callback' => $callback);1105 }1106 1107 /**1108 * Add a new field to a section of a settings page1109 *1110 * Part of the Settings API. Use this to define a settings field that will show1111 * as part of a settings section inside a settings page. The fields are shown using1112 * do_settings_fields() in do_settings-sections()1113 *1114 * The $callback argument should be the name of a function that echoes out the1115 * html input tags for this setting field. Use get_option() to retrieve existing1116 * values to show.1117 *1118 * @since 2.7.01119 *1120 * @global $wp_settings_fields Storage array of settings fields and info about their pages/sections1121 *1122 * @param string $id Slug-name to identify the field. Used in the 'id' attribute of tags.1123 * @param string $title Formatted title of the field. Shown as the label for the field during output.1124 * @param string $callback Function that fills the field with the desired form inputs. The function should echo its output.1125 * @param string $page The slug-name of the settings page on which to show the section (general, reading, writing, ...).1126 * @param string $section The slug-name of the section of the settings page in which to show the box (default, ...).1127 * @param array $args Additional arguments1128 */1129 function add_settings_field($id, $title, $callback, $page, $section = 'default', $args = array()) {1130 global $wp_settings_fields;1131 1132 if ( 'misc' == $page ) {1133 _deprecated_argument( __FUNCTION__, '3.0', __( 'The miscellaneous options group has been removed. Use another settings group.' ) );1134 $page = 'general';1135 }1136 1137 if ( !isset($wp_settings_fields) )1138 $wp_settings_fields = array();1139 if ( !isset($wp_settings_fields[$page]) )1140 $wp_settings_fields[$page] = array();1141 if ( !isset($wp_settings_fields[$page][$section]) )1142 $wp_settings_fields[$page][$section] = array();1143 1144 $wp_settings_fields[$page][$section][$id] = array('id' => $id, 'title' => $title, 'callback' => $callback, 'args' => $args);1145 }1146 1147 /**1148 * Prints out all settings sections added to a particular settings page1149 *1150 * Part of the Settings API. Use this in a settings page callback function1151 * to output all the sections and fields that were added to that $page with1152 * add_settings_section() and add_settings_field()1153 *1154 * @global $wp_settings_sections Storage array of all settings sections added to admin pages1155 * @global $wp_settings_fields Storage array of settings fields and info about their pages/sections1156 * @since 2.7.01157 *1158 * @param string $page The slug name of the page whos settings sections you want to output1159 */1160 function do_settings_sections($page) {1161 global $wp_settings_sections, $wp_settings_fields;1162 1163 if ( !isset($wp_settings_sections) || !isset($wp_settings_sections[$page]) )1164 return;1165 1166 foreach ( (array) $wp_settings_sections[$page] as $section ) {1167 if ( $section['title'] )1168 echo "<h3>{$section['title']}</h3>\n";1169 call_user_func($section['callback'], $section);1170 if ( !isset($wp_settings_fields) || !isset($wp_settings_fields[$page]) || !isset($wp_settings_fields[$page][$section['id']]) )1171 continue;1172 echo '<table class="form-table">';1173 do_settings_fields($page, $section['id']);1174 echo '</table>';1175 }1176 }1177 1178 /**1179 * Print out the settings fields for a particular settings section1180 *1181 * Part of the Settings API. Use this in a settings page to output1182 * a specific section. Should normally be called by do_settings_sections()1183 * rather than directly.1184 *1185 * @global $wp_settings_fields Storage array of settings fields and their pages/sections1186 *1187 * @since 2.7.01188 *1189 * @param string $page Slug title of the admin page who's settings fields you want to show.1190 * @param section $section Slug title of the settings section who's fields you want to show.1191 */1192 function do_settings_fields($page, $section) {1193 global $wp_settings_fields;1194 1195 if ( !isset($wp_settings_fields) || !isset($wp_settings_fields[$page]) || !isset($wp_settings_fields[$page][$section]) )1196 return;1197 1198 foreach ( (array) $wp_settings_fields[$page][$section] as $field ) {1199 echo '<tr valign="top">';1200 if ( !empty($field['args']['label_for']) )1201 echo '<th scope="row"><label for="' . $field['args']['label_for'] . '">' . $field['title'] . '</label></th>';1202 else1203 echo '<th scope="row">' . $field['title'] . '</th>';1204 echo '<td>';1205 call_user_func($field['callback'], $field['args']);1206 echo '</td>';1207 echo '</tr>';1208 }1209 }1210 1211 /**1212 * Register a settings error to be displayed to the user1213 *1214 * Part of the Settings API. Use this to show messages to users about settings validation1215 * problems, missing settings or anything else.1216 *1217 * Settings errors should be added inside the $sanitize_callback function defined in1218 * register_setting() for a given setting to give feedback about the submission.1219 *1220 * By default messages will show immediately after the submission that generated the error.1221 * Additional calls to settings_errors() can be used to show errors even when the settings1222 * page is first accessed.1223 *1224 * @since 3.0.01225 *1226 * @global array $wp_settings_errors Storage array of errors registered during this pageload1227 *1228 * @param string $setting Slug title of the setting to which this error applies1229 * @param string $code Slug-name to identify the error. Used as part of 'id' attribute in HTML output.1230 * @param string $message The formatted message text to display to the user (will be shown inside styled <div> and <p>)1231 * @param string $type The type of message it is, controls HTML class. Use 'error' or 'updated'.1232 */1233 function add_settings_error( $setting, $code, $message, $type = 'error' ) {1234 global $wp_settings_errors;1235 1236 if ( !isset($wp_settings_errors) )1237 $wp_settings_errors = array();1238 1239 $new_error = array(1240 'setting' => $setting,1241 'code' => $code,1242 'message' => $message,1243 'type' => $type1244 );1245 $wp_settings_errors[] = $new_error;1246 }1247 1248 /**1249 * Fetch settings errors registered by add_settings_error()1250 *1251 * Checks the $wp_settings_errors array for any errors declared during the current1252 * pageload and returns them.1253 *1254 * If changes were just submitted ($_GET['settings-updated']) and settings errors were saved1255 * to the 'settings_errors' transient then those errors will be returned instead. This1256 * is used to pass errors back across pageloads.1257 *1258 * Use the $sanitize argument to manually re-sanitize the option before returning errors.1259 * This is useful if you have errors or notices you want to show even when the user1260 * hasn't submitted data (i.e. when they first load an options page, or in admin_notices action hook)1261 *1262 * @since 3.0.01263 *1264 * @global array $wp_settings_errors Storage array of errors registered during this pageload1265 *1266 * @param string $setting Optional slug title of a specific setting who's errors you want.1267 * @param boolean $sanitize Whether to re-sanitize the setting value before returning errors.1268 * @return array Array of settings errors1269 */1270 function get_settings_errors( $setting = '', $sanitize = FALSE ) {1271 global $wp_settings_errors;1272 1273 // If $sanitize is true, manually re-run the sanitizisation for this option1274 // This allows the $sanitize_callback from register_setting() to run, adding1275 // any settings errors you want to show by default.1276 if ( $sanitize )1277 sanitize_option( $setting, get_option($setting));1278 1279 // If settings were passed back from options.php then use them1280 // Ignore transients if $sanitize is true, we don't want the old values anyway1281 if ( isset($_GET['settings-updated']) && $_GET['settings-updated'] && get_transient('settings_errors') ) {1282 $settings_errors = get_transient('settings_errors');1283 delete_transient('settings_errors');1284 // Otherwise check global in case validation has been run on this pageload1285 } elseif ( count( $wp_settings_errors ) ) {1286 $settings_errors = $wp_settings_errors;1287 } else {1288 return;1289 }1290 1291 // Filter the results to those of a specific setting if one was set1292 if ( $setting ) {1293 foreach ( (array) $settings_errors as $key => $details )1294 if ( $setting != $details['setting'] )1295 unset( $settings_errors[$key] );1296 }1297 return $settings_errors;1298 }1299 1300 /**1301 * Display settings errors registered by add_settings_error()1302 *1303 * Part of the Settings API. Outputs a <div> for each error retrieved by get_settings_errors().1304 *1305 * This is called automatically after a settings page based on the Settings API is submitted.1306 * Errors should be added during the validation callback function for a setting defined in register_setting()1307 *1308 * The $sanitize option is passed into get_settings_errors() and will re-run the setting sanitization1309 * on its current value.1310 *1311 * The $hide_on_update option will cause errors to only show when the settings page is first loaded.1312 * if the user has already saved new values it will be hidden to avoid repeating messages already1313 * shown in the default error reporting after submission. This is useful to show general errors like missing1314 * settings when the user arrives at the settings page.1315 *1316 * @since 3.0.01317 *1318 * @param string $setting Optional slug title of a specific setting who's errors you want.1319 * @param boolean $sanitize Whether to re-sanitize the setting value before returning errors.1320 * @param boolean $hide_on_update If set to true errors will not be shown if the settings page has already been submitted.1321 */1322 function settings_errors( $setting = '', $sanitize = FALSE, $hide_on_update = FALSE ) {1323 1324 if ($hide_on_update AND $_GET['settings-updated']) return;1325 1326 $settings_errors = get_settings_errors( $setting, $sanitize );1327 1328 if ( !is_array($settings_errors) ) return;1329 1330 $output = '';1331 foreach ( $settings_errors as $key => $details ) {1332 $css_id = 'setting-error-' . $details['code'];1333 $css_class = $details['type'] . ' settings-error';1334 $output .= "<div id='$css_id' class='$css_class'> \n";1335 $output .= "<p><strong>{$details['message']}</strong></p>";1336 $output .= "</div> \n";1337 }1338 echo $output;1339 }1340 1341 /**1342 * {@internal Missing Short Description}}1343 *1344 * @since 2.7.01345 *1346 * @param unknown_type $found_action1347 */1348 function find_posts_div($found_action = '') {1349 ?>1350 <div id="find-posts" class="find-box" style="display:none;">1351 <div id="find-posts-head" class="find-box-head"><?php _e('Find Posts or Pages'); ?></div>1352 <div class="find-box-inside">1353 <div class="find-box-search">1354 <?php if ( $found_action ) { ?>1355 <input type="hidden" name="found_action" value="<?php echo esc_attr($found_action); ?>" />1356 <?php } ?>1357 1358 <input type="hidden" name="affected" id="affected" value="" />1359 <?php wp_nonce_field( 'find-posts', '_ajax_nonce', false ); ?>1360 <label class="screen-reader-text" for="find-posts-input"><?php _e( 'Search' ); ?></label>1361 <input type="text" id="find-posts-input" name="ps" value="" />1362 <input type="button" id="find-posts-search" value="<?php esc_attr_e( 'Search' ); ?>" class="button" /><br />1363 1364 <?php1365 $post_types = get_post_types( array('public' => true), 'objects' );1366 foreach ( $post_types as $post ) {1367 if ( 'attachment' == $post->name )1368 continue;1369 ?>1370 <input type="radio" name="find-posts-what" id="find-posts-<?php echo esc_attr($post->name); ?>" value="<?php echo esc_attr($post->name); ?>" <?php checked($post->name, 'post'); ?> />1371 <label for="find-posts-<?php echo esc_attr($post->name); ?>"><?php echo $post->label; ?></label>1372 <?php1373 } ?>1374 </div>1375 <div id="find-posts-response"></div>1376 </div>1377 <div class="find-box-buttons">1378 <input id="find-posts-close" type="button" class="button alignleft" value="<?php esc_attr_e('Close'); ?>" />1379 <?php submit_button( __( 'Select' ), 'button-primary alignright', 'find-posts-submit', false ); ?>1380 </div>1381 </div>1382 <?php1383 }1384 1385 /**1386 * Display the post password.1387 *1388 * The password is passed through {@link esc_attr()} to ensure that it1389 * is safe for placing in an html attribute.1390 *1391 * @uses attr1392 * @since 2.7.01393 */1394 function the_post_password() {1395 global $post;1396 if ( isset( $post->post_password ) ) echo esc_attr( $post->post_password );1397 }1398 1399 /**1400 107 * {@internal Missing Short Description}} 1401 108 * … … 1507 214 } 1508 215 echo "</div></div>\n"; 1509 }1510 1511 /**1512 * Get the post title.1513 *1514 * The post title is fetched and if it is blank then a default string is1515 * returned.1516 *1517 * @since 2.7.01518 * @param int $post_id The post id. If not supplied the global $post is used.1519 * @return string The post title if set1520 */1521 function _draft_or_post_title( $post_id = 0 ) {1522 $title = get_the_title($post_id);1523 if ( empty($title) )1524 $title = __('(no title)');1525 return $title;1526 }1527 1528 /**1529 * Display the search query.1530 *1531 * A simple wrapper to display the "s" parameter in a GET URI. This function1532 * should only be used when {@link the_search_query()} cannot.1533 *1534 * @uses attr1535 * @since 2.7.01536 *1537 */1538 function _admin_search_query() {1539 echo isset($_REQUEST['s']) ? esc_attr( stripslashes( $_REQUEST['s'] ) ) : '';1540 }1541 1542 /**1543 * Generic Iframe header for use with Thickbox1544 *1545 * @since 2.7.01546 * @param string $title Title of the Iframe page.1547 * @param bool $limit_styles Limit styles to colour-related styles only (unless others are enqueued).1548 *1549 */1550 function iframe_header( $title = '', $limit_styles = false ) {1551 show_admin_bar( false );1552 global $hook_suffix, $current_screen, $current_user, $admin_body_class, $wp_locale;1553 $admin_body_class = preg_replace('/[^a-z0-9_-]+/i', '-', $hook_suffix);1554 $admin_body_class .= ' iframe';1555 1556 ?><!DOCTYPE html>1557 <html xmlns="http://www.w3.org/1999/xhtml" <?php do_action('admin_xml_ns'); ?> <?php language_attributes(); ?>>1558 <head>1559 <meta http-equiv="Content-Type" content="<?php bloginfo('html_type'); ?>; charset=<?php echo get_option('blog_charset'); ?>" />1560 <title><?php bloginfo('name') ?> › <?php echo $title ?> — <?php _e('WordPress'); ?></title>1561 <?php1562 wp_enqueue_style( 'colors' );1563 ?>1564 <script type="text/javascript">1565 //<![CDATA[1566 addLoadEvent = function(func){if(typeof jQuery!="undefined")jQuery(document).ready(func);else if(typeof wpOnload!='function'){wpOnload=func;}else{var oldonload=wpOnload;wpOnload=function(){oldonload();func();}}};1567 function tb_close(){var win=window.dialogArguments||opener||parent||top;win.tb_remove();}1568 var userSettings = {1569 'url': '<?php echo SITECOOKIEPATH; ?>',1570 'uid': '<?php if ( ! isset($current_user) ) $current_user = wp_get_current_user(); echo $current_user->ID; ?>',1571 'time':'<?php echo time() ?>'1572 },1573 ajaxurl = '<?php echo admin_url('admin-ajax.php'); ?>',1574 pagenow = '<?php echo $current_screen->id; ?>',1575 typenow = '<?php if ( isset($current_screen->post_type) ) echo $current_screen->post_type; ?>',1576 adminpage = '<?php echo $admin_body_class; ?>',1577 thousandsSeparator = '<?php echo addslashes( $wp_locale->number_format['thousands_sep'] ); ?>',1578 decimalPoint = '<?php echo addslashes( $wp_locale->number_format['decimal_point'] ); ?>',1579 isRtl = <?php echo (int) is_rtl(); ?>;1580 //]]>1581 </script>1582 <?php1583 do_action('admin_enqueue_scripts', $hook_suffix);1584 do_action("admin_print_styles-$hook_suffix");1585 do_action('admin_print_styles');1586 do_action("admin_print_scripts-$hook_suffix");1587 do_action('admin_print_scripts');1588 do_action("admin_head-$hook_suffix");1589 do_action('admin_head');1590 ?>1591 </head>1592 <body<?php if ( isset($GLOBALS['body_id']) ) echo ' id="' . $GLOBALS['body_id'] . '"'; ?> class="no-js <?php echo $admin_body_class; ?>">1593 <script type="text/javascript">1594 //<![CDATA[1595 (function(){1596 var c = document.body.className;1597 c = c.replace(/no-js/, 'js');1598 document.body.className = c;1599 })();1600 //]]>1601 </script>1602 <?php1603 }1604 1605 /**1606 * Generic Iframe footer for use with Thickbox1607 *1608 * @since 2.7.01609 *1610 */1611 function iframe_footer() {1612 //We're going to hide any footer output on iframe pages, but run the hooks anyway since they output Javascript or other needed content. ?>1613 <div class="hidden">1614 <?php1615 do_action('admin_footer', '');1616 do_action('admin_print_footer_scripts'); ?>1617 </div>1618 <script type="text/javascript">if(typeof wpOnload=="function")wpOnload();</script>1619 </body>1620 </html>1621 <?php1622 }1623 1624 function _post_states($post) {1625 $post_states = array();1626 if ( isset($_GET['post_status']) )1627 $post_status = $_GET['post_status'];1628 else1629 $post_status = '';1630 1631 if ( !empty($post->post_password) )1632 $post_states['protected'] = __('Password protected');1633 if ( 'private' == $post->post_status && 'private' != $post_status )1634 $post_states['private'] = __('Private');1635 if ( 'draft' == $post->post_status && 'draft' != $post_status )1636 $post_states['draft'] = __('Draft');1637 if ( 'pending' == $post->post_status && 'pending' != $post_status )1638 /* translators: post state */1639 $post_states['pending'] = _x('Pending', 'post state');1640 if ( is_sticky($post->ID) )1641 $post_states['sticky'] = __('Sticky');1642 1643 $post_states = apply_filters( 'display_post_states', $post_states );1644 1645 if ( ! empty($post_states) ) {1646 $state_count = count($post_states);1647 $i = 0;1648 echo ' - ';1649 foreach ( $post_states as $state ) {1650 ++$i;1651 ( $i == $state_count ) ? $sep = '' : $sep = ', ';1652 echo "<span class='post-state'>$state$sep</span>";1653 }1654 }1655 1656 if ( get_post_format( $post->ID ) )1657 echo ' - <span class="post-state-format">' . get_post_format_string( get_post_format( $post->ID ) ) . '</span>';1658 }1659 1660 function _media_states( $post ) {1661 $media_states = array();1662 $stylesheet = get_option('stylesheet');1663 1664 if ( current_theme_supports( 'custom-header') ) {1665 $meta_header = get_post_meta($post->ID, '_wp_attachment_is_custom_header', true );1666 if ( ! empty( $meta_header ) && $meta_header == $stylesheet )1667 $media_states[] = __( 'Header Image' );1668 }1669 1670 if ( current_theme_supports( 'custom-background') ) {1671 $meta_background = get_post_meta($post->ID, '_wp_attachment_is_custom_background', true );1672 if ( ! empty( $meta_background ) && $meta_background == $stylesheet )1673 $media_states[] = __( 'Background Image' );1674 }1675 1676 $media_states = apply_filters( 'display_media_states', $media_states );1677 1678 if ( ! empty( $media_states ) ) {1679 $state_count = count( $media_states );1680 $i = 0;1681 echo ' - ';1682 foreach ( $media_states as $state ) {1683 ++$i;1684 ( $i == $state_count ) ? $sep = '' : $sep = ', ';1685 echo "<span class='post-state'>$state$sep</span>";1686 }1687 }1688 216 } 1689 217 … … 2037 565 2038 566 /** 2039 * Test support for compressing JavaScript from PHP2040 *2041 * Outputs JavaScript that tests if compression from PHP works as expected2042 * and sets an option with the result. Has no effect when the current user2043 * is not an administrator. To run the test again the option 'can_compress_scripts'2044 * has to be deleted.2045 *2046 * @since 2.8.02047 */2048 function compression_test() {2049 ?>2050 <script type="text/javascript">2051 /* <![CDATA[ */2052 var testCompression = {2053 get : function(test) {2054 var x;2055 if ( window.XMLHttpRequest ) {2056 x = new XMLHttpRequest();2057 } else {2058 try{x=new ActiveXObject('Msxml2.XMLHTTP');}catch(e){try{x=new ActiveXObject('Microsoft.XMLHTTP');}catch(e){};}2059 }2060 2061 if (x) {2062 x.onreadystatechange = function() {2063 var r, h;2064 if ( x.readyState == 4 ) {2065 r = x.responseText.substr(0, 18);2066 h = x.getResponseHeader('Content-Encoding');2067 testCompression.check(r, h, test);2068 }2069 }2070 2071 x.open('GET', ajaxurl + '?action=wp-compression-test&test='+test+'&'+(new Date()).getTime(), true);2072 x.send('');2073 }2074 },2075 2076 check : function(r, h, test) {2077 if ( ! r && ! test )2078 this.get(1);2079 2080 if ( 1 == test ) {2081 if ( h && ( h.match(/deflate/i) || h.match(/gzip/i) ) )2082 this.get('no');2083 else2084 this.get(2);2085 2086 return;2087 }2088 2089 if ( 2 == test ) {2090 if ( '"wpCompressionTest' == r )2091 this.get('yes');2092 else2093 this.get('no');2094 }2095 }2096 };2097 testCompression.check();2098 /* ]]> */2099 </script>2100 <?php2101 }2102 2103 /**2104 567 * Get the current screen object 2105 568 * … … 2132 595 2133 596 $current_screen = apply_filters('current_screen', $current_screen); 2134 }2135 2136 /**2137 * Echos a submit button, with provided text and appropriate class2138 *2139 * @since 3.1.02140 *2141 * @param string $text The text of the button (defaults to 'Save Changes')2142 * @param string $type The type of button. One of: primary, secondary, delete2143 * @param string $name The HTML name of the submit button. Defaults to "submit". If no id attribute2144 * is given in $other_attributes below, $name will be used as the button's id.2145 * @param bool $wrap True if the output button should be wrapped in a paragraph tag,2146 * false otherwise. Defaults to true2147 * @param array|string $other_attributes Other attributes that should be output with the button,2148 * mapping attributes to their values, such as array( 'tabindex' => '1' ).2149 * These attributes will be output as attribute="value", such as tabindex="1".2150 * Defaults to no other attributes. Other attributes can also be provided as a2151 * string such as 'tabindex="1"', though the array format is typically cleaner.2152 */2153 function submit_button( $text = NULL, $type = 'primary', $name = 'submit', $wrap = true, $other_attributes = NULL ) {2154 echo get_submit_button( $text, $type, $name, $wrap, $other_attributes );2155 }2156 2157 /**2158 * Returns a submit button, with provided text and appropriate class2159 *2160 * @since 3.1.02161 *2162 * @param string $text The text of the button (defaults to 'Save Changes')2163 * @param string $type The type of button. One of: primary, secondary, delete2164 * @param string $name The HTML name of the submit button. Defaults to "submit". If no id attribute2165 * is given in $other_attributes below, $name will be used as the button's id.2166 * @param bool $wrap True if the output button should be wrapped in a paragraph tag,2167 * false otherwise. Defaults to true2168 * @param array|string $other_attributes Other attributes that should be output with the button,2169 * mapping attributes to their values, such as array( 'tabindex' => '1' ).2170 * These attributes will be output as attribute="value", such as tabindex="1".2171 * Defaults to no other attributes. Other attributes can also be provided as a2172 * string such as 'tabindex="1"', though the array format is typically cleaner.2173 */2174 function get_submit_button( $text = NULL, $type = 'primary', $name = 'submit', $wrap = true, $other_attributes = NULL ) {2175 switch ( $type ) :2176 case 'primary' :2177 case 'secondary' :2178 $class = 'button-' . $type;2179 break;2180 case 'delete' :2181 $class = 'button-secondary delete';2182 break;2183 default :2184 $class = $type; // Custom cases can just pass in the classes they want to be used2185 endswitch;2186 $text = ( NULL == $text ) ? __( 'Save Changes' ) : $text;2187 2188 // Default the id attribute to $name unless an id was specifically provided in $other_attributes2189 $id = $name;2190 if ( is_array( $other_attributes ) && isset( $other_attributes['id'] ) ) {2191 $id = $other_attributes['id'];2192 unset( $other_attributes['id'] );2193 }2194 2195 $attributes = '';2196 if ( is_array( $other_attributes ) ) {2197 foreach ( $other_attributes as $attribute => $value ) {2198 $attributes .= $attribute . '="' . esc_attr( $value ) . '" '; // Trailing space is important2199 }2200 } else if ( !empty( $other_attributes ) ) { // Attributes provided as a string2201 $attributes = $other_attributes;2202 }2203 2204 $button = '<input type="submit" name="' . esc_attr( $name ) . '" id="' . esc_attr( $id ) . '" class="' . esc_attr( $class );2205 $button .= '" value="' . esc_attr( $text ) . '" ' . $attributes . ' />';2206 2207 if ( $wrap ) {2208 $button = '<p class="submit">' . $button . '</p>';2209 }2210 2211 return $button;2212 }2213 2214 /**2215 * Initializes the new feature pointers.2216 *2217 * @since 3.3.02218 *2219 * Pointer user settings:2220 * p0 - Admin bar pointer, added 3.3.2221 */2222 function wp_pointer_enqueue( $hook_suffix ) {2223 $enqueue = false;2224 2225 $admin_bar = get_user_setting( 'p0', 0 );2226 if ( ! $admin_bar && apply_filters( 'show_wp_pointer_admin_bar', true ) ) {2227 $enqueue = true;2228 add_action( 'admin_print_footer_scripts', '_wp_pointer_print_admin_bar' );2229 }2230 2231 if ( $enqueue ) {2232 wp_enqueue_style( 'wp-pointer' );2233 wp_enqueue_script( 'wp-pointer' );2234 wp_enqueue_script( 'utils' );2235 }2236 }2237 add_action( 'admin_enqueue_scripts', 'wp_pointer_enqueue' );2238 2239 function _wp_pointer_print_admin_bar() {2240 $pointer_content = '<h3>' . ('The admin bar has been updated in WordPress 3.3.') . '</h3>';2241 $pointer_content .= '<p>' . sprintf( ('Have some feedback? Visit this <a href="%s">ticket</a>.'), 'http://core.trac.wordpress.org/ticket/18197' ) . '</p>';2242 $pointer_content .= '<p>' . sprintf( ('P.S. You are looking at a new admin pointer. Chime in <a href="%s">here</a>.'), 'http://core.trac.wordpress.org/ticket/18693' ) . '</p>';2243 2244 ?>2245 <script type="text/javascript">2246 //<![CDATA[2247 jQuery(document).ready( function($) {2248 $('#wpadminbar').pointer({2249 content: '<?php echo $pointer_content; ?>',2250 position: {2251 my: 'left top',2252 at: 'center bottom',2253 offset: '-25 0'2254 },2255 close: function() {2256 setUserSetting( 'p0', '1' );2257 }2258 }).pointer('open');2259 });2260 //]]>2261 </script>2262 <?php2263 597 } 2264 598 -
trunk/wp-admin/includes/template.php
r18781 r18782 220 220 echo '<li id="link-category-', $cat_id, '"><label for="in-link-category-', $cat_id, '" class="selectit"><input value="', $cat_id, '" type="checkbox" name="link_category[]" id="in-link-category-', $cat_id, '"', $checked, '/> ', $name, "</label></li>"; 221 221 } 222 }223 224 /**225 * Get the column headers for a screen226 *227 * @since 2.7.0228 *229 * @param string|object $screen The screen you want the headers for230 * @return array Containing the headers in the format id => UI String231 */232 function get_column_headers( $screen ) {233 if ( is_string( $screen ) )234 $screen = convert_to_screen( $screen );235 236 global $_wp_column_headers;237 238 if ( !isset( $_wp_column_headers[ $screen->id ] ) ) {239 $_wp_column_headers[ $screen->id ] = apply_filters( 'manage_' . $screen->id . '_columns', array() );240 }241 242 return $_wp_column_headers[ $screen->id ];243 }244 245 /**246 * Get a list of hidden columns.247 *248 * @since 2.7.0249 *250 * @param string|object $screen The screen you want the hidden columns for251 * @return array252 */253 function get_hidden_columns( $screen ) {254 if ( is_string( $screen ) )255 $screen = convert_to_screen( $screen );256 257 return (array) get_user_option( 'manage' . $screen->id . 'columnshidden' );258 222 } 259 223 … … 1007 971 1008 972 /** 1009 * {@internal Missing Short Description}}1010 *1011 * @since 2.7.01012 *1013 * @param unknown_type $screen1014 */1015 function meta_box_prefs($screen) {1016 global $wp_meta_boxes;1017 1018 if ( is_string($screen) )1019 $screen = convert_to_screen($screen);1020 1021 if ( empty($wp_meta_boxes[$screen->id]) )1022 return;1023 1024 $hidden = get_hidden_meta_boxes($screen);1025 1026 foreach ( array_keys($wp_meta_boxes[$screen->id]) as $context ) {1027 foreach ( array_keys($wp_meta_boxes[$screen->id][$context]) as $priority ) {1028 foreach ( $wp_meta_boxes[$screen->id][$context][$priority] as $box ) {1029 if ( false == $box || ! $box['title'] )1030 continue;1031 // Submit box cannot be hidden1032 if ( 'submitdiv' == $box['id'] || 'linksubmitdiv' == $box['id'] )1033 continue;1034 $box_id = $box['id'];1035 echo '<label for="' . $box_id . '-hide">';1036 echo '<input class="hide-postbox-tog" name="' . $box_id . '-hide" type="checkbox" id="' . $box_id . '-hide" value="' . $box_id . '"' . (! in_array($box_id, $hidden) ? ' checked="checked"' : '') . ' />';1037 echo "{$box['title']}</label>\n";1038 }1039 }1040 }1041 }1042 1043 /**1044 * Get Hidden Meta Boxes1045 *1046 * @since 2.7.01047 *1048 * @param string|object $screen Screen identifier1049 * @return array Hidden Meta Boxes1050 */1051 function get_hidden_meta_boxes( $screen ) {1052 if ( is_string( $screen ) )1053 $screen = convert_to_screen( $screen );1054 1055 $hidden = get_user_option( "metaboxhidden_{$screen->id}" );1056 1057 // Hide slug boxes by default1058 if ( !is_array( $hidden ) ) {1059 if ( 'post' == $screen->base || 'page' == $screen->base )1060 $hidden = array('slugdiv', 'trackbacksdiv', 'postcustom', 'postexcerpt', 'commentstatusdiv', 'commentsdiv', 'authordiv', 'revisionsdiv');1061 else1062 $hidden = array( 'slugdiv' );1063 $hidden = apply_filters('default_hidden_meta_boxes', $hidden, $screen);1064 }1065 1066 return $hidden;1067 }1068 1069 /**1070 973 * Add a new section to a settings page. 1071 974 * … … 1395 1298 global $post; 1396 1299 if ( isset( $post->post_password ) ) echo esc_attr( $post->post_password ); 1397 }1398 1399 /**1400 * {@internal Missing Short Description}}1401 *1402 * @since 2.7.01403 */1404 function favorite_actions( $screen = null ) {1405 $default_action = false;1406 1407 if ( is_string($screen) )1408 $screen = convert_to_screen($screen);1409 1410 if ( $screen->is_user )1411 return;1412 1413 if ( isset($screen->post_type) ) {1414 $post_type_object = get_post_type_object($screen->post_type);1415 if ( 'add' != $screen->action )1416 $default_action = array('post-new.php?post_type=' . $post_type_object->name => array($post_type_object->labels->new_item, $post_type_object->cap->edit_posts));1417 else1418 $default_action = array('edit.php?post_type=' . $post_type_object->name => array($post_type_object->labels->name, $post_type_object->cap->edit_posts));1419 }1420 1421 if ( !$default_action ) {1422 if ( $screen->is_network ) {1423 $default_action = array('sites.php' => array( __('Sites'), 'manage_sites'));1424 } else {1425 switch ( $screen->id ) {1426 case 'upload':1427 $default_action = array('media-new.php' => array(__('New Media'), 'upload_files'));1428 break;1429 case 'media':1430 $default_action = array('upload.php' => array(__('Edit Media'), 'upload_files'));1431 break;1432 case 'link-manager':1433 case 'link':1434 if ( 'add' != $screen->action )1435 $default_action = array('link-add.php' => array(__('New Link'), 'manage_links'));1436 else1437 $default_action = array('link-manager.php' => array(__('Edit Links'), 'manage_links'));1438 break;1439 case 'users':1440 $default_action = array('user-new.php' => array(__('New User'), 'create_users'));1441 break;1442 case 'user':1443 $default_action = array('users.php' => array(__('Edit Users'), 'edit_users'));1444 break;1445 case 'plugins':1446 $default_action = array('plugin-install.php' => array(__('Install Plugins'), 'install_plugins'));1447 break;1448 case 'plugin-install':1449 $default_action = array('plugins.php' => array(__('Manage Plugins'), 'activate_plugins'));1450 break;1451 case 'themes':1452 $default_action = array('theme-install.php' => array(__('Install Themes'), 'install_themes'));1453 break;1454 case 'theme-install':1455 $default_action = array('themes.php' => array(__('Manage Themes'), 'switch_themes'));1456 break;1457 default:1458 $default_action = array('post-new.php' => array(__('New Post'), 'edit_posts'));1459 break;1460 }1461 }1462 }1463 1464 if ( !$screen->is_network ) {1465 $actions = array(1466 'post-new.php' => array(__('New Post'), 'edit_posts'),1467 'edit.php?post_status=draft' => array(__('Drafts'), 'edit_posts'),1468 'post-new.php?post_type=page' => array(__('New Page'), 'edit_pages'),1469 'media-new.php' => array(__('Upload'), 'upload_files'),1470 'edit-comments.php' => array(__('Comments'), 'moderate_comments')1471 );1472 } else {1473 $actions = array(1474 'sites.php' => array( __('Sites'), 'manage_sites'),1475 'users.php' => array( __('Users'), 'manage_network_users')1476 );1477 }1478 1479 $default_key = array_keys($default_action);1480 $default_key = $default_key[0];1481 if ( isset($actions[$default_key]) )1482 unset($actions[$default_key]);1483 $actions = array_merge($default_action, $actions);1484 $actions = apply_filters( 'favorite_actions', $actions, $screen );1485 1486 $allowed_actions = array();1487 foreach ( $actions as $action => $data ) {1488 if ( current_user_can($data[1]) )1489 $allowed_actions[$action] = $data[0];1490 }1491 1492 if ( empty($allowed_actions) )1493 return;1494 1495 $first = array_keys($allowed_actions);1496 $first = $first[0];1497 echo '<div id="favorite-actions">';1498 echo '<div id="favorite-first"><a href="' . $first . '">' . $allowed_actions[$first] . '</a></div><div id="favorite-toggle"><br /></div>';1499 echo '<div id="favorite-inside">';1500 1501 array_shift($allowed_actions);1502 1503 foreach ( $allowed_actions as $action => $label) {1504 echo "<div class='favorite-action'><a href='$action'>";1505 echo $label;1506 echo "</a></div>\n";1507 }1508 echo "</div></div>\n";1509 1300 } 1510 1301 … … 1689 1480 1690 1481 /** 1691 * Convert a screen string to a screen object1692 *1693 * @since 3.0.01694 *1695 * @param string $screen The name of the screen1696 * @return object An object containing the safe screen name and id1697 */1698 function convert_to_screen( $screen ) {1699 $screen = str_replace( array('.php', '-new', '-add', '-network', '-user' ), '', $screen);1700 1701 if ( is_network_admin() )1702 $screen .= '-network';1703 elseif ( is_user_admin() )1704 $screen .= '-user';1705 1706 $screen = (string) apply_filters( 'screen_meta_screen', $screen );1707 $screen = (object) array('id' => $screen, 'base' => $screen);1708 return $screen;1709 }1710 1711 function screen_meta($screen) {1712 global $wp_meta_boxes, $_wp_contextual_help, $wp_list_table, $wp_current_screen_options;1713 1714 if ( is_string($screen) )1715 $screen = convert_to_screen($screen);1716 1717 $columns = get_column_headers( $screen );1718 $hidden = get_hidden_columns( $screen );1719 1720 $meta_screens = array('index' => 'dashboard');1721 1722 if ( isset($meta_screens[$screen->id]) ) {1723 $screen->id = $meta_screens[$screen->id];1724 $screen->base = $screen->id;1725 }1726 1727 $show_screen = false;1728 if ( !empty($wp_meta_boxes[$screen->id]) || !empty($columns) )1729 $show_screen = true;1730 1731 $screen_options = screen_options($screen);1732 if ( $screen_options )1733 $show_screen = true;1734 1735 if ( !isset($_wp_contextual_help) )1736 $_wp_contextual_help = array();1737 1738 $settings = apply_filters('screen_settings', '', $screen);1739 1740 switch ( $screen->id ) {1741 case 'widgets':1742 $settings = '<p><a id="access-on" href="widgets.php?widgets-access=on">' . __('Enable accessibility mode') . '</a><a id="access-off" href="widgets.php?widgets-access=off">' . __('Disable accessibility mode') . "</a></p>\n";1743 $show_screen = true;1744 break;1745 }1746 if ( ! empty( $settings ) )1747 $show_screen = true;1748 1749 if ( !empty($wp_current_screen_options) )1750 $show_screen = true;1751 1752 $show_screen = apply_filters('screen_options_show_screen', $show_screen, $screen);1753 1754 // If we have screen options, add the menu to the admin bar.1755 if ( $show_screen )1756 add_action( 'admin_bar_menu', 'wp_admin_bar_screen_options_menu', 80 );1757 1758 1759 ?>1760 <div id="screen-meta">1761 <?php if ( $show_screen ) : ?>1762 <div id="screen-options-wrap" class="hidden">1763 <form id="adv-settings" action="" method="post">1764 <?php if ( isset($wp_meta_boxes[$screen->id]) ) : ?>1765 <h5><?php _ex('Show on screen', 'Metaboxes') ?></h5>1766 <div class="metabox-prefs">1767 <?php meta_box_prefs($screen); ?>1768 <br class="clear" />1769 </div>1770 <?php endif;1771 if ( ! empty($columns) ) : ?>1772 <h5><?php echo ( isset( $columns['_title'] ) ? $columns['_title'] : _x('Show on screen', 'Columns') ) ?></h5>1773 <div class="metabox-prefs">1774 <?php1775 $special = array('_title', 'cb', 'comment', 'media', 'name', 'title', 'username', 'blogname');1776 1777 foreach ( $columns as $column => $title ) {1778 // Can't hide these for they are special1779 if ( in_array( $column, $special ) )1780 continue;1781 if ( empty( $title ) )1782 continue;1783 1784 if ( 'comments' == $column )1785 $title = __( 'Comments' );1786 $id = "$column-hide";1787 echo '<label for="' . $id . '">';1788 echo '<input class="hide-column-tog" name="' . $id . '" type="checkbox" id="' . $id . '" value="' . $column . '"' . checked( !in_array($column, $hidden), true, false ) . ' />';1789 echo "$title</label>\n";1790 }1791 ?>1792 <br class="clear" />1793 </div>1794 <?php endif;1795 echo screen_layout($screen);1796 1797 if ( !empty( $screen_options ) ) {1798 ?>1799 <h5><?php _ex('Show on screen', 'Screen Options') ?></h5>1800 <?php1801 }1802 1803 echo $screen_options;1804 echo $settings; ?>1805 <div><?php wp_nonce_field( 'screen-options-nonce', 'screenoptionnonce', false ); ?></div>1806 </form>1807 </div>1808 1809 <?php endif; // $show_screen1810 1811 $_wp_contextual_help = apply_filters('contextual_help_list', $_wp_contextual_help, $screen);1812 ?>1813 <div id="contextual-help-wrap" class="hidden">1814 <?php1815 $contextual_help = '';1816 if ( isset($_wp_contextual_help[$screen->id]) && is_array($_wp_contextual_help[$screen->id]) ) {1817 $contextual_help .= '<div class="metabox-prefs">' . "\n";1818 1819 /*1820 * Loop through ['contextual-help-tabs']1821 * - It's a nested array where $key=>$value >> $title=>$content1822 * Has no output so can only loop the array once1823 */1824 $contextual_help_tabs = ''; // store looped content for later1825 $contextual_help_panels = ''; // store looped content for later1826 1827 $tab_active = true;1828 1829 foreach ( $_wp_contextual_help[$screen->id]['tabs'] as $tab ) {1830 $tab_slug = sanitize_html_class( $tab[ 0 ] );1831 $contextual_help_tabs .= '<li class="tab-' . $tab_slug . ( ($tab_active) ? ' active' : '' ) . '">';1832 $contextual_help_tabs .= '<a href="#' . $tab_slug . '">' . $tab[1] . '</a>';1833 $contextual_help_tabs .= '</li>' ."\n";1834 1835 $contextual_help_panels .= '<div id="' . $tab_slug . '" class="help-tab-content' . ( ($tab_active) ? ' active' : '' ) . '">';1836 $contextual_help_panels .= $tab[2];1837 $contextual_help_panels .= "</div>\n";1838 1839 $tab_active = false;1840 }1841 1842 // Start output from loop: Tabbed help content1843 $contextual_help .= '<ul class="contextual-help-tabs">' . "\n";1844 $contextual_help .= $contextual_help_tabs;1845 $contextual_help .= '</ul>' ."\n";1846 $contextual_help .= '<div class="contextual-help-tabs-wrap">' . "\n";1847 $contextual_help .= $contextual_help_panels;1848 $contextual_help .= "</div>\n";1849 // END: Tabbed help content1850 1851 // Sidebar to right of tabs1852 $contextual_help .= '<div class="contextual-help-links">' . "\n";1853 $contextual_help .= $_wp_contextual_help[$screen->id]['sidebar'];1854 $contextual_help .= "</div>\n";1855 1856 $contextual_help .= "</div>\n"; // end metabox1857 1858 } elseif ( isset($_wp_contextual_help[$screen->id]) ) {1859 $contextual_help .= '<div class="metabox-prefs">' . $_wp_contextual_help[$screen->id] . "</div>\n";1860 } else {1861 $contextual_help .= '<div class="metabox-prefs">';1862 $default_help = __('<a href="http://codex.wordpress.org/" target="_blank">Documentation</a>');1863 $default_help .= '<br />';1864 $default_help .= __('<a href="http://wordpress.org/support/" target="_blank">Support Forums</a>');1865 $contextual_help .= apply_filters('default_contextual_help', $default_help);1866 $contextual_help .= '</div>' . "\n";1867 }1868 1869 echo apply_filters('contextual_help', $contextual_help, $screen->id, $screen);1870 ?>1871 </div>1872 1873 </div> <?php // #screen-meta1874 }1875 1876 /**1877 * Add contextual help text for a page1878 *1879 * The array $help takes the following format:1880 * array( 'contextual-help-tabs' => array( $tab1_title => $tab1_value [, $tab2_title => $tab2_value, ...] ),1881 * 'contextual-help-links' => $help_links_as_string )1882 *1883 * For backwards compatability, a string is also accepted.1884 *1885 * @since 2.7.01886 *1887 * @param string $screen The handle for the screen to add help to. This is usually the hook name returned by the add_*_page() functions.1888 * @param array|string $help Creates tabs & links columns within help text in array.1889 *1890 */1891 function add_contextual_help($screen, $help) {1892 global $_wp_contextual_help;1893 1894 if ( is_string($screen) )1895 $screen = convert_to_screen($screen);1896 1897 if ( !isset($_wp_contextual_help) )1898 $_wp_contextual_help = array();1899 1900 $_wp_contextual_help[$screen->id] = $help;1901 }1902 1903 function screen_layout($screen) {1904 global $screen_layout_columns, $wp_current_screen_options;1905 1906 if ( is_string($screen) )1907 $screen = convert_to_screen($screen);1908 1909 // Back compat for plugins using the filter instead of add_screen_option()1910 $columns = apply_filters('screen_layout_columns', array(), $screen->id, $screen);1911 if ( !empty($columns) && isset($columns[$screen->id]) )1912 add_screen_option('layout_columns', array('max' => $columns[$screen->id]) );1913 1914 if ( !isset($wp_current_screen_options['layout_columns']) ) {1915 $screen_layout_columns = 0;1916 return '';1917 }1918 1919 $screen_layout_columns = get_user_option("screen_layout_$screen->id");1920 $num = $wp_current_screen_options['layout_columns']['max'];1921 1922 if ( ! $screen_layout_columns ) {1923 if ( isset($wp_current_screen_options['layout_columns']['default']) )1924 $screen_layout_columns = $wp_current_screen_options['layout_columns']['default'];1925 else1926 $screen_layout_columns = 'auto';1927 }1928 1929 $i = 1;1930 $return = '<h5>' . __('Screen Layout') . "</h5>\n<div class='columns-prefs'>" . __('Number of Columns:') . "\n";1931 while ( $i <= $num ) {1932 $return .= "<label><input type='radio' name='screen_columns' value='$i'" . ( ($screen_layout_columns == $i) ? " checked='checked'" : "" ) . " /> $i</label>\n";1933 ++$i;1934 }1935 $return .= "<label><input type='radio' id='wp_auto_columns' name='screen_columns' value='auto'" . ( ($screen_layout_columns == 'auto') ? " checked='checked'" : "" ) . " />" . __('auto') . "</label>\n";1936 $return .= "</div>\n";1937 return $return;1938 }1939 1940 /**1941 * Register and configure an admin screen option1942 *1943 * @since 3.1.01944 *1945 * @param string $option An option name.1946 * @param mixed $args Option dependent arguments1947 * @return void1948 */1949 function add_screen_option( $option, $args = array() ) {1950 global $wp_current_screen_options;1951 1952 if ( !isset($wp_current_screen_options) )1953 $wp_current_screen_options = array();1954 1955 $wp_current_screen_options[$option] = $args;1956 }1957 1958 function screen_options($screen) {1959 global $wp_current_screen_options;1960 1961 if ( is_string($screen) )1962 $screen = convert_to_screen($screen);1963 1964 if ( !isset($wp_current_screen_options['per_page']) )1965 return '';1966 1967 $per_page_label = $wp_current_screen_options['per_page']['label'];1968 1969 if ( empty($wp_current_screen_options['per_page']['option']) ) {1970 $option = str_replace( '-', '_', "{$screen->id}_per_page" );1971 } else {1972 $option = $wp_current_screen_options['per_page']['option'];1973 }1974 1975 $per_page = (int) get_user_option( $option );1976 if ( empty( $per_page ) || $per_page < 1 ) {1977 if ( isset($wp_current_screen_options['per_page']['default']) )1978 $per_page = $wp_current_screen_options['per_page']['default'];1979 else1980 $per_page = 20;1981 }1982 1983 if ( 'edit_comments_per_page' == $option )1984 $per_page = apply_filters( 'comments_per_page', $per_page, isset($_REQUEST['comment_status']) ? $_REQUEST['comment_status'] : 'all' );1985 elseif ( 'categories_per_page' == $option )1986 $per_page = apply_filters( 'edit_categories_per_page', $per_page );1987 else1988 $per_page = apply_filters( $option, $per_page );1989 1990 // Back compat1991 if ( isset( $screen->post_type ) )1992 $per_page = apply_filters( 'edit_posts_per_page', $per_page, $screen->post_type );1993 1994 $return = "<div class='screen-options'>\n";1995 if ( !empty($per_page_label) )1996 $return .= "<input type='text' class='screen-per-page' name='wp_screen_options[value]' id='$option' maxlength='3' value='$per_page' /> <label for='$option'>$per_page_label</label>\n";1997 $return .= get_submit_button( __( 'Apply' ), 'button', 'screen-options-apply', false );1998 $return .= "<input type='hidden' name='wp_screen_options[option]' value='" . esc_attr($option) . "' />";1999 $return .= "</div>\n";2000 return $return;2001 }2002 2003 function screen_icon( $screen = '' ) {2004 echo get_screen_icon( $screen );2005 }2006 2007 function get_screen_icon( $screen = '' ) {2008 global $current_screen, $typenow;2009 2010 if ( empty($screen) )2011 $screen = $current_screen;2012 elseif ( is_string($screen) )2013 $name = $screen;2014 2015 $class = 'icon32';2016 2017 if ( empty($name) ) {2018 if ( !empty($screen->parent_base) )2019 $name = $screen->parent_base;2020 else2021 $name = $screen->base;2022 2023 if ( 'edit' == $name && isset($screen->post_type) && 'page' == $screen->post_type )2024 $name = 'edit-pages';2025 2026 $post_type = '';2027 if ( isset( $screen->post_type ) )2028 $post_type = $screen->post_type;2029 elseif ( $current_screen == $screen )2030 $post_type = $typenow;2031 if ( $post_type )2032 $class .= ' ' . sanitize_html_class( 'icon32-posts-' . $post_type );2033 }2034 2035 return '<div id="icon-' . esc_attr( $name ) . '" class="' . $class . '"><br /></div>';2036 }2037 2038 /**2039 1482 * Test support for compressing JavaScript from PHP 2040 1483 * … … 2099 1542 </script> 2100 1543 <?php 2101 }2102 2103 /**2104 * Get the current screen object2105 *2106 * @since 3.1.02107 *2108 * @return object Current screen object2109 */2110 function get_current_screen() {2111 global $current_screen;2112 2113 if ( !isset($current_screen) )2114 return null;2115 2116 return $current_screen;2117 }2118 2119 /**2120 * Set the current screen object2121 *2122 * @since 3.0.02123 *2124 * @uses $current_screen2125 *2126 * @param string $id Screen id, optional.2127 */2128 function set_current_screen( $id = '' ) {2129 global $current_screen;2130 2131 $current_screen = new WP_Screen( $id );2132 2133 $current_screen = apply_filters('current_screen', $current_screen);2134 1544 } 2135 1545 … … 2262 1672 <?php 2263 1673 } 2264 2265 class WP_Screen {2266 var $action = '';2267 var $base;2268 var $id;2269 var $is_network;2270 var $is_user;2271 var $parent_base;2272 var $parent_file;2273 var $post_type;2274 var $taxonomy;2275 2276 function __construct( $id = '' ) {2277 global $hook_suffix, $typenow, $taxnow;2278 2279 $action = '';2280 2281 if ( empty( $id ) ) {2282 $screen = $hook_suffix;2283 $screen = str_replace('.php', '', $screen);2284 if ( preg_match('/-add|-new$/', $screen) )2285 $action = 'add';2286 $screen = str_replace('-new', '', $screen);2287 $screen = str_replace('-add', '', $screen);2288 $this->id = $this->base = $screen;2289 } else {2290 $id = sanitize_key( $id );2291 if ( false !== strpos($id, '-') ) {2292 list( $id, $typenow ) = explode('-', $id, 2);2293 if ( taxonomy_exists( $typenow ) ) {2294 $id = 'edit-tags';2295 $taxnow = $typenow;2296 $typenow = '';2297 }2298 }2299 $this->id = $this->base = $id;2300 }2301 2302 $this->action = $action;2303 2304 // Map index to dashboard2305 if ( 'index' == $this->base )2306 $this->base = 'dashboard';2307 if ( 'index' == $this->id )2308 $this->id = 'dashboard';2309 2310 if ( 'edit' == $this->id ) {2311 if ( empty($typenow) )2312 $typenow = 'post';2313 $this->id .= '-' . $typenow;2314 $this->post_type = $typenow;2315 } elseif ( 'post' == $this->id ) {2316 if ( empty($typenow) )2317 $typenow = 'post';2318 $this->id = $typenow;2319 $this->post_type = $typenow;2320 } elseif ( 'edit-tags' == $this->id ) {2321 if ( empty($taxnow) )2322 $taxnow = 'post_tag';2323 $this->id = 'edit-' . $taxnow;2324 $this->taxonomy = $taxnow;2325 }2326 2327 $this->is_network = is_network_admin();2328 $this->is_user = is_user_admin();2329 2330 if ( $this->is_network ) {2331 $this->base .= '-network';2332 $this->id .= '-network';2333 } elseif ( $this->is_user ) {2334 $this->base .= '-user';2335 $this->id .= '-user';2336 }2337 }2338 2339 function set_parentage( $parent_file ) {2340 $this->parent_file = $parent_file;2341 $this->parent_base = preg_replace('/\?.*$/', '', $parent_file);2342 $this->parent_base = str_replace('.php', '', $this->parent_base);2343 }2344 2345 function add_option( $option, $args = array() ) {2346 return add_screen_option( $option, $args );2347 }2348 2349 function add_help_tab( $id, $title, $content) {2350 global $_wp_contextual_help;2351 2352 $_wp_contextual_help[$this->id]['tabs'][] = array( $id, $title, $content );2353 }2354 2355 function add_help_sidebar( $content ) {2356 global $_wp_contextual_help;2357 2358 $_wp_contextual_help[$this->id]['sidebar'] = $content;2359 }2360 }
Note: See TracChangeset
for help on using the changeset viewer.