| [ Index ] |
PHP Cross Reference of WordPress |
[Summary view] [Print] [Text view]
1 <?php 2 /** 3 * Template WordPress Administration API. 4 * 5 * A Big Mess. Also some neat functions that are nicely written. 6 * 7 * @package WordPress 8 * @subpackage Administration 9 */ 10 11 /** Walker_Category_Checklist class */ 12 require_once ABSPATH . 'wp-admin/includes/class-walker-category-checklist.php'; 13 14 /** WP_Internal_Pointers class */ 15 require_once ABSPATH . 'wp-admin/includes/class-wp-internal-pointers.php'; 16 17 // 18 // Category Checklists. 19 // 20 21 /** 22 * Outputs an unordered list of checkbox input elements labeled with category names. 23 * 24 * @since 2.5.1 25 * 26 * @see wp_terms_checklist() 27 * 28 * @param int $post_id Optional. Post to generate a categories checklist for. Default 0. 29 * $selected_cats must not be an array. Default 0. 30 * @param int $descendants_and_self Optional. ID of the category to output along with its descendants. 31 * Default 0. 32 * @param int[]|false $selected_cats Optional. Array of category IDs to mark as checked. Default false. 33 * @param int[]|false $popular_cats Optional. Array of category IDs to receive the "popular-category" class. 34 * Default false. 35 * @param Walker $walker Optional. Walker object to use to build the output. 36 * Default is a Walker_Category_Checklist instance. 37 * @param bool $checked_ontop Optional. Whether to move checked items out of the hierarchy and to 38 * the top of the list. Default true. 39 */ 40 function wp_category_checklist( $post_id = 0, $descendants_and_self = 0, $selected_cats = false, $popular_cats = false, $walker = null, $checked_ontop = true ) { 41 wp_terms_checklist( 42 $post_id, 43 array( 44 'taxonomy' => 'category', 45 'descendants_and_self' => $descendants_and_self, 46 'selected_cats' => $selected_cats, 47 'popular_cats' => $popular_cats, 48 'walker' => $walker, 49 'checked_ontop' => $checked_ontop, 50 ) 51 ); 52 } 53 54 /** 55 * Outputs an unordered list of checkbox input elements labelled with term names. 56 * 57 * Taxonomy-independent version of wp_category_checklist(). 58 * 59 * @since 3.0.0 60 * @since 4.4.0 Introduced the `$echo` argument. 61 * 62 * @param int $post_id Optional. Post ID. Default 0. 63 * @param array|string $args { 64 * Optional. Array or string of arguments for generating a terms checklist. Default empty array. 65 * 66 * @type int $descendants_and_self ID of the category to output along with its descendants. 67 * Default 0. 68 * @type int[] $selected_cats Array of category IDs to mark as checked. Default false. 69 * @type int[] $popular_cats Array of category IDs to receive the "popular-category" class. 70 * Default false. 71 * @type Walker $walker Walker object to use to build the output. Default empty which 72 * results in a Walker_Category_Checklist instance being used. 73 * @type string $taxonomy Taxonomy to generate the checklist for. Default 'category'. 74 * @type bool $checked_ontop Whether to move checked items out of the hierarchy and to 75 * the top of the list. Default true. 76 * @type bool $echo Whether to echo the generated markup. False to return the markup instead 77 * of echoing it. Default true. 78 * } 79 * @return string HTML list of input elements. 80 */ 81 function wp_terms_checklist( $post_id = 0, $args = array() ) { 82 $defaults = array( 83 'descendants_and_self' => 0, 84 'selected_cats' => false, 85 'popular_cats' => false, 86 'walker' => null, 87 'taxonomy' => 'category', 88 'checked_ontop' => true, 89 'echo' => true, 90 ); 91 92 /** 93 * Filters the taxonomy terms checklist arguments. 94 * 95 * @since 3.4.0 96 * 97 * @see wp_terms_checklist() 98 * 99 * @param array|string $args An array or string of arguments. 100 * @param int $post_id The post ID. 101 */ 102 $params = apply_filters( 'wp_terms_checklist_args', $args, $post_id ); 103 104 $parsed_args = wp_parse_args( $params, $defaults ); 105 106 if ( empty( $parsed_args['walker'] ) || ! ( $parsed_args['walker'] instanceof Walker ) ) { 107 $walker = new Walker_Category_Checklist; 108 } else { 109 $walker = $parsed_args['walker']; 110 } 111 112 $taxonomy = $parsed_args['taxonomy']; 113 $descendants_and_self = (int) $parsed_args['descendants_and_self']; 114 115 $args = array( 'taxonomy' => $taxonomy ); 116 117 $tax = get_taxonomy( $taxonomy ); 118 $args['disabled'] = ! current_user_can( $tax->cap->assign_terms ); 119 120 $args['list_only'] = ! empty( $parsed_args['list_only'] ); 121 122 if ( is_array( $parsed_args['selected_cats'] ) ) { 123 $args['selected_cats'] = array_map( 'intval', $parsed_args['selected_cats'] ); 124 } elseif ( $post_id ) { 125 $args['selected_cats'] = wp_get_object_terms( $post_id, $taxonomy, array_merge( $args, array( 'fields' => 'ids' ) ) ); 126 } else { 127 $args['selected_cats'] = array(); 128 } 129 130 if ( is_array( $parsed_args['popular_cats'] ) ) { 131 $args['popular_cats'] = array_map( 'intval', $parsed_args['popular_cats'] ); 132 } else { 133 $args['popular_cats'] = get_terms( 134 array( 135 'taxonomy' => $taxonomy, 136 'fields' => 'ids', 137 'orderby' => 'count', 138 'order' => 'DESC', 139 'number' => 10, 140 'hierarchical' => false, 141 ) 142 ); 143 } 144 145 if ( $descendants_and_self ) { 146 $categories = (array) get_terms( 147 array( 148 'taxonomy' => $taxonomy, 149 'child_of' => $descendants_and_self, 150 'hierarchical' => 0, 151 'hide_empty' => 0, 152 ) 153 ); 154 $self = get_term( $descendants_and_self, $taxonomy ); 155 array_unshift( $categories, $self ); 156 } else { 157 $categories = (array) get_terms( 158 array( 159 'taxonomy' => $taxonomy, 160 'get' => 'all', 161 ) 162 ); 163 } 164 165 $output = ''; 166 167 if ( $parsed_args['checked_ontop'] ) { 168 // Post-process $categories rather than adding an exclude to the get_terms() query 169 // to keep the query the same across all posts (for any query cache). 170 $checked_categories = array(); 171 $keys = array_keys( $categories ); 172 173 foreach ( $keys as $k ) { 174 if ( in_array( $categories[ $k ]->term_id, $args['selected_cats'], true ) ) { 175 $checked_categories[] = $categories[ $k ]; 176 unset( $categories[ $k ] ); 177 } 178 } 179 180 // Put checked categories on top. 181 $output .= $walker->walk( $checked_categories, 0, $args ); 182 } 183 // Then the rest of them. 184 $output .= $walker->walk( $categories, 0, $args ); 185 186 if ( $parsed_args['echo'] ) { 187 echo $output; 188 } 189 190 return $output; 191 } 192 193 /** 194 * Retrieves a list of the most popular terms from the specified taxonomy. 195 * 196 * If the `$display` argument is true then the elements for a list of checkbox 197 * `<input>` elements labelled with the names of the selected terms is output. 198 * If the `$post_ID` global is not empty then the terms associated with that 199 * post will be marked as checked. 200 * 201 * @since 2.5.0 202 * 203 * @param string $taxonomy Taxonomy to retrieve terms from. 204 * @param int $default_term Optional. Not used. 205 * @param int $number Optional. Number of terms to retrieve. Default 10. 206 * @param bool $display Optional. Whether to display the list as well. Default true. 207 * @return int[] Array of popular term IDs. 208 */ 209 function wp_popular_terms_checklist( $taxonomy, $default_term = 0, $number = 10, $display = true ) { 210 $post = get_post(); 211 212 if ( $post && $post->ID ) { 213 $checked_terms = wp_get_object_terms( $post->ID, $taxonomy, array( 'fields' => 'ids' ) ); 214 } else { 215 $checked_terms = array(); 216 } 217 218 $terms = get_terms( 219 array( 220 'taxonomy' => $taxonomy, 221 'orderby' => 'count', 222 'order' => 'DESC', 223 'number' => $number, 224 'hierarchical' => false, 225 ) 226 ); 227 228 $tax = get_taxonomy( $taxonomy ); 229 230 $popular_ids = array(); 231 232 foreach ( (array) $terms as $term ) { 233 $popular_ids[] = $term->term_id; 234 235 if ( ! $display ) { // Hack for Ajax use. 236 continue; 237 } 238 239 $id = "popular-$taxonomy-$term->term_id"; 240 $checked = in_array( $term->term_id, $checked_terms, true ) ? 'checked="checked"' : ''; 241 ?> 242 243 <li id="<?php echo $id; ?>" class="popular-category"> 244 <label class="selectit"> 245 <input id="in-<?php echo $id; ?>" type="checkbox" <?php echo $checked; ?> value="<?php echo (int) $term->term_id; ?>" <?php disabled( ! current_user_can( $tax->cap->assign_terms ) ); ?> /> 246 <?php 247 /** This filter is documented in wp-includes/category-template.php */ 248 echo esc_html( apply_filters( 'the_category', $term->name, '', '' ) ); 249 ?> 250 </label> 251 </li> 252 253 <?php 254 } 255 return $popular_ids; 256 } 257 258 /** 259 * Outputs a link category checklist element. 260 * 261 * @since 2.5.1 262 * 263 * @param int $link_id 264 */ 265 function wp_link_category_checklist( $link_id = 0 ) { 266 $default = 1; 267 268 $checked_categories = array(); 269 270 if ( $link_id ) { 271 $checked_categories = wp_get_link_cats( $link_id ); 272 // No selected categories, strange. 273 if ( ! count( $checked_categories ) ) { 274 $checked_categories[] = $default; 275 } 276 } else { 277 $checked_categories[] = $default; 278 } 279 280 $categories = get_terms( 281 array( 282 'taxonomy' => 'link_category', 283 'orderby' => 'name', 284 'hide_empty' => 0, 285 ) 286 ); 287 288 if ( empty( $categories ) ) { 289 return; 290 } 291 292 foreach ( $categories as $category ) { 293 $cat_id = $category->term_id; 294 295 /** This filter is documented in wp-includes/category-template.php */ 296 $name = esc_html( apply_filters( 'the_category', $category->name, '', '' ) ); 297 $checked = in_array( $cat_id, $checked_categories, true ) ? ' checked="checked"' : ''; 298 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>'; 299 } 300 } 301 302 /** 303 * Adds hidden fields with the data for use in the inline editor for posts and pages. 304 * 305 * @since 2.7.0 306 * 307 * @param WP_Post $post Post object. 308 */ 309 function get_inline_data( $post ) { 310 $post_type_object = get_post_type_object( $post->post_type ); 311 if ( ! current_user_can( 'edit_post', $post->ID ) ) { 312 return; 313 } 314 315 $title = esc_textarea( trim( $post->post_title ) ); 316 317 echo ' 318 <div class="hidden" id="inline_' . $post->ID . '"> 319 <div class="post_title">' . $title . '</div>' . 320 /** This filter is documented in wp-admin/edit-tag-form.php */ 321 '<div class="post_name">' . apply_filters( 'editable_slug', $post->post_name, $post ) . '</div> 322 <div class="post_author">' . $post->post_author . '</div> 323 <div class="comment_status">' . esc_html( $post->comment_status ) . '</div> 324 <div class="ping_status">' . esc_html( $post->ping_status ) . '</div> 325 <div class="_status">' . esc_html( $post->post_status ) . '</div> 326 <div class="jj">' . mysql2date( 'd', $post->post_date, false ) . '</div> 327 <div class="mm">' . mysql2date( 'm', $post->post_date, false ) . '</div> 328 <div class="aa">' . mysql2date( 'Y', $post->post_date, false ) . '</div> 329 <div class="hh">' . mysql2date( 'H', $post->post_date, false ) . '</div> 330 <div class="mn">' . mysql2date( 'i', $post->post_date, false ) . '</div> 331 <div class="ss">' . mysql2date( 's', $post->post_date, false ) . '</div> 332 <div class="post_password">' . esc_html( $post->post_password ) . '</div>'; 333 334 if ( $post_type_object->hierarchical ) { 335 echo '<div class="post_parent">' . $post->post_parent . '</div>'; 336 } 337 338 echo '<div class="page_template">' . ( $post->page_template ? esc_html( $post->page_template ) : 'default' ) . '</div>'; 339 340 if ( post_type_supports( $post->post_type, 'page-attributes' ) ) { 341 echo '<div class="menu_order">' . $post->menu_order . '</div>'; 342 } 343 344 $taxonomy_names = get_object_taxonomies( $post->post_type ); 345 346 foreach ( $taxonomy_names as $taxonomy_name ) { 347 $taxonomy = get_taxonomy( $taxonomy_name ); 348 349 if ( ! $taxonomy->show_in_quick_edit ) { 350 continue; 351 } 352 353 if ( $taxonomy->hierarchical ) { 354 355 $terms = get_object_term_cache( $post->ID, $taxonomy_name ); 356 if ( false === $terms ) { 357 $terms = wp_get_object_terms( $post->ID, $taxonomy_name ); 358 wp_cache_add( $post->ID, wp_list_pluck( $terms, 'term_id' ), $taxonomy_name . '_relationships' ); 359 } 360 $term_ids = empty( $terms ) ? array() : wp_list_pluck( $terms, 'term_id' ); 361 362 echo '<div class="post_category" id="' . $taxonomy_name . '_' . $post->ID . '">' . implode( ',', $term_ids ) . '</div>'; 363 364 } else { 365 366 $terms_to_edit = get_terms_to_edit( $post->ID, $taxonomy_name ); 367 if ( ! is_string( $terms_to_edit ) ) { 368 $terms_to_edit = ''; 369 } 370 371 echo '<div class="tags_input" id="' . $taxonomy_name . '_' . $post->ID . '">' 372 . esc_html( str_replace( ',', ', ', $terms_to_edit ) ) . '</div>'; 373 374 } 375 } 376 377 if ( ! $post_type_object->hierarchical ) { 378 echo '<div class="sticky">' . ( is_sticky( $post->ID ) ? 'sticky' : '' ) . '</div>'; 379 } 380 381 if ( post_type_supports( $post->post_type, 'post-formats' ) ) { 382 echo '<div class="post_format">' . esc_html( get_post_format( $post->ID ) ) . '</div>'; 383 } 384 385 /** 386 * Fires after outputting the fields for the inline editor for posts and pages. 387 * 388 * @since 4.9.8 389 * 390 * @param WP_Post $post The current post object. 391 * @param WP_Post_Type $post_type_object The current post's post type object. 392 */ 393 do_action( 'add_inline_data', $post, $post_type_object ); 394 395 echo '</div>'; 396 } 397 398 /** 399 * Outputs the in-line comment reply-to form in the Comments list table. 400 * 401 * @since 2.7.0 402 * 403 * @global WP_List_Table $wp_list_table 404 * 405 * @param int $position 406 * @param bool $checkbox 407 * @param string $mode 408 * @param bool $table_row 409 */ 410 function wp_comment_reply( $position = 1, $checkbox = false, $mode = 'single', $table_row = true ) { 411 global $wp_list_table; 412 /** 413 * Filters the in-line comment reply-to form output in the Comments 414 * list table. 415 * 416 * Returning a non-empty value here will short-circuit display 417 * of the in-line comment-reply form in the Comments list table, 418 * echoing the returned value instead. 419 * 420 * @since 2.7.0 421 * 422 * @see wp_comment_reply() 423 * 424 * @param string $content The reply-to form content. 425 * @param array $args An array of default args. 426 */ 427 $content = apply_filters( 428 'wp_comment_reply', 429 '', 430 array( 431 'position' => $position, 432 'checkbox' => $checkbox, 433 'mode' => $mode, 434 ) 435 ); 436 437 if ( ! empty( $content ) ) { 438 echo $content; 439 return; 440 } 441 442 if ( ! $wp_list_table ) { 443 if ( 'single' === $mode ) { 444 $wp_list_table = _get_list_table( 'WP_Post_Comments_List_Table' ); 445 } else { 446 $wp_list_table = _get_list_table( 'WP_Comments_List_Table' ); 447 } 448 } 449 450 ?> 451 <form method="get"> 452 <?php if ( $table_row ) : ?> 453 <table style="display:none;"><tbody id="com-reply"><tr id="replyrow" class="inline-edit-row" style="display:none;"><td colspan="<?php echo $wp_list_table->get_column_count(); ?>" class="colspanchange"> 454 <?php else : ?> 455 <div id="com-reply" style="display:none;"><div id="replyrow" style="display:none;"> 456 <?php endif; ?> 457 <fieldset class="comment-reply"> 458 <legend> 459 <span class="hidden" id="editlegend"><?php _e( 'Edit Comment' ); ?></span> 460 <span class="hidden" id="replyhead"><?php _e( 'Reply to Comment' ); ?></span> 461 <span class="hidden" id="addhead"><?php _e( 'Add new Comment' ); ?></span> 462 </legend> 463 464 <div id="replycontainer"> 465 <label for="replycontent" class="screen-reader-text"><?php _e( 'Comment' ); ?></label> 466 <?php 467 $quicktags_settings = array( 'buttons' => 'strong,em,link,block,del,ins,img,ul,ol,li,code,close' ); 468 wp_editor( 469 '', 470 'replycontent', 471 array( 472 'media_buttons' => false, 473 'tinymce' => false, 474 'quicktags' => $quicktags_settings, 475 ) 476 ); 477 ?> 478 </div> 479 480 <div id="edithead" style="display:none;"> 481 <div class="inside"> 482 <label for="author-name"><?php _e( 'Name' ); ?></label> 483 <input type="text" name="newcomment_author" size="50" value="" id="author-name" /> 484 </div> 485 486 <div class="inside"> 487 <label for="author-email"><?php _e( 'Email' ); ?></label> 488 <input type="text" name="newcomment_author_email" size="50" value="" id="author-email" /> 489 </div> 490 491 <div class="inside"> 492 <label for="author-url"><?php _e( 'URL' ); ?></label> 493 <input type="text" id="author-url" name="newcomment_author_url" class="code" size="103" value="" /> 494 </div> 495 </div> 496 497 <div id="replysubmit" class="submit"> 498 <p class="reply-submit-buttons"> 499 <button type="button" class="save button button-primary"> 500 <span id="addbtn" style="display: none;"><?php _e( 'Add Comment' ); ?></span> 501 <span id="savebtn" style="display: none;"><?php _e( 'Update Comment' ); ?></span> 502 <span id="replybtn" style="display: none;"><?php _e( 'Submit Reply' ); ?></span> 503 </button> 504 <button type="button" class="cancel button"><?php _e( 'Cancel' ); ?></button> 505 <span class="waiting spinner"></span> 506 </p> 507 <div class="notice notice-error notice-alt inline hidden"> 508 <p class="error"></p> 509 </div> 510 </div> 511 512 <input type="hidden" name="action" id="action" value="" /> 513 <input type="hidden" name="comment_ID" id="comment_ID" value="" /> 514 <input type="hidden" name="comment_post_ID" id="comment_post_ID" value="" /> 515 <input type="hidden" name="status" id="status" value="" /> 516 <input type="hidden" name="position" id="position" value="<?php echo $position; ?>" /> 517 <input type="hidden" name="checkbox" id="checkbox" value="<?php echo $checkbox ? 1 : 0; ?>" /> 518 <input type="hidden" name="mode" id="mode" value="<?php echo esc_attr( $mode ); ?>" /> 519 <?php 520 wp_nonce_field( 'replyto-comment', '_ajax_nonce-replyto-comment', false ); 521 if ( current_user_can( 'unfiltered_html' ) ) { 522 wp_nonce_field( 'unfiltered-html-comment', '_wp_unfiltered_html_comment', false ); 523 } 524 ?> 525 </fieldset> 526 <?php if ( $table_row ) : ?> 527 </td></tr></tbody></table> 528 <?php else : ?> 529 </div></div> 530 <?php endif; ?> 531 </form> 532 <?php 533 } 534 535 /** 536 * Outputs 'undo move to Trash' text for comments. 537 * 538 * @since 2.9.0 539 */ 540 function wp_comment_trashnotice() { 541 ?> 542 <div class="hidden" id="trash-undo-holder"> 543 <div class="trash-undo-inside"> 544 <?php 545 /* translators: %s: Comment author, filled by Ajax. */ 546 printf( __( 'Comment by %s moved to the Trash.' ), '<strong></strong>' ); 547 ?> 548 <span class="undo untrash"><a href="#"><?php _e( 'Undo' ); ?></a></span> 549 </div> 550 </div> 551 <div class="hidden" id="spam-undo-holder"> 552 <div class="spam-undo-inside"> 553 <?php 554 /* translators: %s: Comment author, filled by Ajax. */ 555 printf( __( 'Comment by %s marked as spam.' ), '<strong></strong>' ); 556 ?> 557 <span class="undo unspam"><a href="#"><?php _e( 'Undo' ); ?></a></span> 558 </div> 559 </div> 560 <?php 561 } 562 563 /** 564 * Outputs a post's public meta data in the Custom Fields meta box. 565 * 566 * @since 1.2.0 567 * 568 * @param array $meta 569 */ 570 function list_meta( $meta ) { 571 // Exit if no meta. 572 if ( ! $meta ) { 573 echo ' 574 <table id="list-table" style="display: none;"> 575 <thead> 576 <tr> 577 <th class="left">' . _x( 'Name', 'meta name' ) . '</th> 578 <th>' . __( 'Value' ) . '</th> 579 </tr> 580 </thead> 581 <tbody id="the-list" data-wp-lists="list:meta"> 582 <tr><td></td></tr> 583 </tbody> 584 </table>'; // TBODY needed for list-manipulation JS. 585 return; 586 } 587 $count = 0; 588 ?> 589 <table id="list-table"> 590 <thead> 591 <tr> 592 <th class="left"><?php _ex( 'Name', 'meta name' ); ?></th> 593 <th><?php _e( 'Value' ); ?></th> 594 </tr> 595 </thead> 596 <tbody id='the-list' data-wp-lists='list:meta'> 597 <?php 598 foreach ( $meta as $entry ) { 599 echo _list_meta_row( $entry, $count ); 600 } 601 ?> 602 </tbody> 603 </table> 604 <?php 605 } 606 607 /** 608 * Outputs a single row of public meta data in the Custom Fields meta box. 609 * 610 * @since 2.5.0 611 * 612 * @param array $entry 613 * @param int $count 614 * @return string 615 */ 616 function _list_meta_row( $entry, &$count ) { 617 static $update_nonce = ''; 618 619 if ( is_protected_meta( $entry['meta_key'], 'post' ) ) { 620 return ''; 621 } 622 623 if ( ! $update_nonce ) { 624 $update_nonce = wp_create_nonce( 'add-meta' ); 625 } 626 627 $r = ''; 628 ++ $count; 629 630 if ( is_serialized( $entry['meta_value'] ) ) { 631 if ( is_serialized_string( $entry['meta_value'] ) ) { 632 // This is a serialized string, so we should display it. 633 $entry['meta_value'] = maybe_unserialize( $entry['meta_value'] ); 634 } else { 635 // This is a serialized array/object so we should NOT display it. 636 --$count; 637 return ''; 638 } 639 } 640 641 $entry['meta_key'] = esc_attr( $entry['meta_key'] ); 642 $entry['meta_value'] = esc_textarea( $entry['meta_value'] ); // Using a <textarea />. 643 $entry['meta_id'] = (int) $entry['meta_id']; 644 645 $delete_nonce = wp_create_nonce( 'delete-meta_' . $entry['meta_id'] ); 646 647 $r .= "\n\t<tr id='meta-{$entry['meta_id']}'>"; 648 $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' type='text' size='20' value='{$entry['meta_key']}' />"; 649 650 $r .= "\n\t\t<div class='submit'>"; 651 $r .= get_submit_button( __( 'Delete' ), 'deletemeta small', "deletemeta[{$entry['meta_id']}]", false, array( 'data-wp-lists' => "delete:the-list:meta-{$entry['meta_id']}::_ajax_nonce=$delete_nonce" ) ); 652 $r .= "\n\t\t"; 653 $r .= get_submit_button( __( 'Update' ), 'updatemeta small', "meta-{$entry['meta_id']}-submit", false, array( 'data-wp-lists' => "add:the-list:meta-{$entry['meta_id']}::_ajax_nonce-add-meta=$update_nonce" ) ); 654 $r .= '</div>'; 655 $r .= wp_nonce_field( 'change-meta', '_ajax_nonce', false, false ); 656 $r .= '</td>'; 657 658 $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' rows='2' cols='30'>{$entry['meta_value']}</textarea></td>\n\t</tr>"; 659 return $r; 660 } 661 662 /** 663 * Prints the form in the Custom Fields meta box. 664 * 665 * @since 1.2.0 666 * 667 * @global wpdb $wpdb WordPress database abstraction object. 668 * 669 * @param WP_Post $post Optional. The post being edited. 670 */ 671 function meta_form( $post = null ) { 672 global $wpdb; 673 $post = get_post( $post ); 674 675 /** 676 * Filters values for the meta key dropdown in the Custom Fields meta box. 677 * 678 * Returning a non-null value will effectively short-circuit and avoid a 679 * potentially expensive query against postmeta. 680 * 681 * @since 4.4.0 682 * 683 * @param array|null $keys Pre-defined meta keys to be used in place of a postmeta query. Default null. 684 * @param WP_Post $post The current post object. 685 */ 686 $keys = apply_filters( 'postmeta_form_keys', null, $post ); 687 688 if ( null === $keys ) { 689 /** 690 * Filters the number of custom fields to retrieve for the drop-down 691 * in the Custom Fields meta box. 692 * 693 * @since 2.1.0 694 * 695 * @param int $limit Number of custom fields to retrieve. Default 30. 696 */ 697 $limit = apply_filters( 'postmeta_form_limit', 30 ); 698 699 $keys = $wpdb->get_col( 700 $wpdb->prepare( 701 "SELECT DISTINCT meta_key 702 FROM $wpdb->postmeta 703 WHERE meta_key NOT BETWEEN '_' AND '_z' 704 HAVING meta_key NOT LIKE %s 705 ORDER BY meta_key 706 LIMIT %d", 707 $wpdb->esc_like( '_' ) . '%', 708 $limit 709 ) 710 ); 711 } 712 713 if ( $keys ) { 714 natcasesort( $keys ); 715 $meta_key_input_id = 'metakeyselect'; 716 } else { 717 $meta_key_input_id = 'metakeyinput'; 718 } 719 ?> 720 <p><strong><?php _e( 'Add New Custom Field:' ); ?></strong></p> 721 <table id="newmeta"> 722 <thead> 723 <tr> 724 <th class="left"><label for="<?php echo $meta_key_input_id; ?>"><?php _ex( 'Name', 'meta name' ); ?></label></th> 725 <th><label for="metavalue"><?php _e( 'Value' ); ?></label></th> 726 </tr> 727 </thead> 728 729 <tbody> 730 <tr> 731 <td id="newmetaleft" class="left"> 732 <?php if ( $keys ) { ?> 733 <select id="metakeyselect" name="metakeyselect"> 734 <option value="#NONE#"><?php _e( '— Select —' ); ?></option> 735 <?php 736 foreach ( $keys as $key ) { 737 if ( is_protected_meta( $key, 'post' ) || ! current_user_can( 'add_post_meta', $post->ID, $key ) ) { 738 continue; 739 } 740 echo "\n<option value='" . esc_attr( $key ) . "'>" . esc_html( $key ) . '</option>'; 741 } 742 ?> 743 </select> 744 <input class="hide-if-js" type="text" id="metakeyinput" name="metakeyinput" value="" /> 745 <a href="#postcustomstuff" class="hide-if-no-js" onclick="jQuery('#metakeyinput, #metakeyselect, #enternew, #cancelnew').toggle();return false;"> 746 <span id="enternew"><?php _e( 'Enter new' ); ?></span> 747 <span id="cancelnew" class="hidden"><?php _e( 'Cancel' ); ?></span></a> 748 <?php } else { ?> 749 <input type="text" id="metakeyinput" name="metakeyinput" value="" /> 750 <?php } ?> 751 </td> 752 <td><textarea id="metavalue" name="metavalue" rows="2" cols="25"></textarea></td> 753 </tr> 754 755 <tr><td colspan="2"> 756 <div class="submit"> 757 <?php 758 submit_button( 759 __( 'Add Custom Field' ), 760 '', 761 'addmeta', 762 false, 763 array( 764 'id' => 'newmeta-submit', 765 'data-wp-lists' => 'add:the-list:newmeta', 766 ) 767 ); 768 ?> 769 </div> 770 <?php wp_nonce_field( 'add-meta', '_ajax_nonce-add-meta', false ); ?> 771 </td></tr> 772 </tbody> 773 </table> 774 <?php 775 776 } 777 778 /** 779 * Prints out HTML form date elements for editing post or comment publish date. 780 * 781 * @since 0.71 782 * @since 4.4.0 Converted to use get_comment() instead of the global `$comment`. 783 * 784 * @global WP_Locale $wp_locale WordPress date and time locale object. 785 * 786 * @param int|bool $edit Accepts 1|true for editing the date, 0|false for adding the date. 787 * @param int|bool $for_post Accepts 1|true for applying the date to a post, 0|false for a comment. 788 * @param int $tab_index The tabindex attribute to add. Default 0. 789 * @param int|bool $multi Optional. Whether the additional fields and buttons should be added. 790 * Default 0|false. 791 */ 792 function touch_time( $edit = 1, $for_post = 1, $tab_index = 0, $multi = 0 ) { 793 global $wp_locale; 794 $post = get_post(); 795 796 if ( $for_post ) { 797 $edit = ! ( in_array( $post->post_status, array( 'draft', 'pending' ), true ) && ( ! $post->post_date_gmt || '0000-00-00 00:00:00' === $post->post_date_gmt ) ); 798 } 799 800 $tab_index_attribute = ''; 801 if ( (int) $tab_index > 0 ) { 802 $tab_index_attribute = " tabindex=\"$tab_index\""; 803 } 804 805 // @todo Remove this? 806 // 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 />'; 807 808 $post_date = ( $for_post ) ? $post->post_date : get_comment()->comment_date; 809 $jj = ( $edit ) ? mysql2date( 'd', $post_date, false ) : current_time( 'd' ); 810 $mm = ( $edit ) ? mysql2date( 'm', $post_date, false ) : current_time( 'm' ); 811 $aa = ( $edit ) ? mysql2date( 'Y', $post_date, false ) : current_time( 'Y' ); 812 $hh = ( $edit ) ? mysql2date( 'H', $post_date, false ) : current_time( 'H' ); 813 $mn = ( $edit ) ? mysql2date( 'i', $post_date, false ) : current_time( 'i' ); 814 $ss = ( $edit ) ? mysql2date( 's', $post_date, false ) : current_time( 's' ); 815 816 $cur_jj = current_time( 'd' ); 817 $cur_mm = current_time( 'm' ); 818 $cur_aa = current_time( 'Y' ); 819 $cur_hh = current_time( 'H' ); 820 $cur_mn = current_time( 'i' ); 821 822 $month = '<label><span class="screen-reader-text">' . __( 'Month' ) . '</span><select class="form-required" ' . ( $multi ? '' : 'id="mm" ' ) . 'name="mm"' . $tab_index_attribute . ">\n"; 823 for ( $i = 1; $i < 13; $i = $i + 1 ) { 824 $monthnum = zeroise( $i, 2 ); 825 $monthtext = $wp_locale->get_month_abbrev( $wp_locale->get_month( $i ) ); 826 $month .= "\t\t\t" . '<option value="' . $monthnum . '" data-text="' . $monthtext . '" ' . selected( $monthnum, $mm, false ) . '>'; 827 /* translators: 1: Month number (01, 02, etc.), 2: Month abbreviation. */ 828 $month .= sprintf( __( '%1$s-%2$s' ), $monthnum, $monthtext ) . "</option>\n"; 829 } 830 $month .= '</select></label>'; 831 832 $day = '<label><span class="screen-reader-text">' . __( 'Day' ) . '</span><input type="text" ' . ( $multi ? '' : 'id="jj" ' ) . 'name="jj" value="' . $jj . '" size="2" maxlength="2"' . $tab_index_attribute . ' autocomplete="off" class="form-required" /></label>'; 833 $year = '<label><span class="screen-reader-text">' . __( 'Year' ) . '</span><input type="text" ' . ( $multi ? '' : 'id="aa" ' ) . 'name="aa" value="' . $aa . '" size="4" maxlength="4"' . $tab_index_attribute . ' autocomplete="off" class="form-required" /></label>'; 834 $hour = '<label><span class="screen-reader-text">' . __( 'Hour' ) . '</span><input type="text" ' . ( $multi ? '' : 'id="hh" ' ) . 'name="hh" value="' . $hh . '" size="2" maxlength="2"' . $tab_index_attribute . ' autocomplete="off" class="form-required" /></label>'; 835 $minute = '<label><span class="screen-reader-text">' . __( 'Minute' ) . '</span><input type="text" ' . ( $multi ? '' : 'id="mn" ' ) . 'name="mn" value="' . $mn . '" size="2" maxlength="2"' . $tab_index_attribute . ' autocomplete="off" class="form-required" /></label>'; 836 837 echo '<div class="timestamp-wrap">'; 838 /* translators: 1: Month, 2: Day, 3: Year, 4: Hour, 5: Minute. */ 839 printf( __( '%1$s %2$s, %3$s at %4$s:%5$s' ), $month, $day, $year, $hour, $minute ); 840 841 echo '</div><input type="hidden" id="ss" name="ss" value="' . $ss . '" />'; 842 843 if ( $multi ) { 844 return; 845 } 846 847 echo "\n\n"; 848 849 $map = array( 850 'mm' => array( $mm, $cur_mm ), 851 'jj' => array( $jj, $cur_jj ), 852 'aa' => array( $aa, $cur_aa ), 853 'hh' => array( $hh, $cur_hh ), 854 'mn' => array( $mn, $cur_mn ), 855 ); 856 857 foreach ( $map as $timeunit => $value ) { 858 list( $unit, $curr ) = $value; 859 860 echo '<input type="hidden" id="hidden_' . $timeunit . '" name="hidden_' . $timeunit . '" value="' . $unit . '" />' . "\n"; 861 $cur_timeunit = 'cur_' . $timeunit; 862 echo '<input type="hidden" id="' . $cur_timeunit . '" name="' . $cur_timeunit . '" value="' . $curr . '" />' . "\n"; 863 } 864 ?> 865 866 <p> 867 <a href="#edit_timestamp" class="save-timestamp hide-if-no-js button"><?php _e( 'OK' ); ?></a> 868 <a href="#edit_timestamp" class="cancel-timestamp hide-if-no-js button-cancel"><?php _e( 'Cancel' ); ?></a> 869 </p> 870 <?php 871 } 872 873 /** 874 * Prints out option HTML elements for the page templates drop-down. 875 * 876 * @since 1.5.0 877 * @since 4.7.0 Added the `$post_type` parameter. 878 * 879 * @param string $default_template Optional. The template file name. Default empty. 880 * @param string $post_type Optional. Post type to get templates for. Default 'post'. 881 */ 882 function page_template_dropdown( $default_template = '', $post_type = 'page' ) { 883 $templates = get_page_templates( null, $post_type ); 884 885 ksort( $templates ); 886 887 foreach ( array_keys( $templates ) as $template ) { 888 $selected = selected( $default_template, $templates[ $template ], false ); 889 echo "\n\t<option value='" . esc_attr( $templates[ $template ] ) . "' $selected>" . esc_html( $template ) . '</option>'; 890 } 891 } 892 893 /** 894 * Prints out option HTML elements for the page parents drop-down. 895 * 896 * @since 1.5.0 897 * @since 4.4.0 `$post` argument was added. 898 * 899 * @global wpdb $wpdb WordPress database abstraction object. 900 * 901 * @param int $default_page Optional. The default page ID to be pre-selected. Default 0. 902 * @param int $parent_page Optional. The parent page ID. Default 0. 903 * @param int $level Optional. Page depth level. Default 0. 904 * @param int|WP_Post $post Post ID or WP_Post object. 905 * @return void|false Void on success, false if the page has no children. 906 */ 907 function parent_dropdown( $default_page = 0, $parent_page = 0, $level = 0, $post = null ) { 908 global $wpdb; 909 910 $post = get_post( $post ); 911 $items = $wpdb->get_results( 912 $wpdb->prepare( 913 "SELECT ID, post_parent, post_title 914 FROM $wpdb->posts 915 WHERE post_parent = %d AND post_type = 'page' 916 ORDER BY menu_order", 917 $parent_page 918 ) 919 ); 920 921 if ( $items ) { 922 foreach ( $items as $item ) { 923 // A page cannot be its own parent. 924 if ( $post && $post->ID && (int) $item->ID === $post->ID ) { 925 continue; 926 } 927 928 $pad = str_repeat( ' ', $level * 3 ); 929 $selected = selected( $default_page, $item->ID, false ); 930 931 echo "\n\t<option class='level-$level' value='$item->ID' $selected>$pad " . esc_html( $item->post_title ) . '</option>'; 932 parent_dropdown( $default_page, $item->ID, $level + 1 ); 933 } 934 } else { 935 return false; 936 } 937 } 938 939 /** 940 * Prints out option HTML elements for role selectors. 941 * 942 * @since 2.1.0 943 * 944 * @param string $selected Slug for the role that should be already selected. 945 */ 946 function wp_dropdown_roles( $selected = '' ) { 947 $r = ''; 948 949 $editable_roles = array_reverse( get_editable_roles() ); 950 951 foreach ( $editable_roles as $role => $details ) { 952 $name = translate_user_role( $details['name'] ); 953 // Preselect specified role. 954 if ( $selected === $role ) { 955 $r .= "\n\t<option selected='selected' value='" . esc_attr( $role ) . "'>$name</option>"; 956 } else { 957 $r .= "\n\t<option value='" . esc_attr( $role ) . "'>$name</option>"; 958 } 959 } 960 961 echo $r; 962 } 963 964 /** 965 * Outputs the form used by the importers to accept the data to be imported 966 * 967 * @since 2.0.0 968 * 969 * @param string $action The action attribute for the form. 970 */ 971 function wp_import_upload_form( $action ) { 972 973 /** 974 * Filters the maximum allowed upload size for import files. 975 * 976 * @since 2.3.0 977 * 978 * @see wp_max_upload_size() 979 * 980 * @param int $max_upload_size Allowed upload size. Default 1 MB. 981 */ 982 $bytes = apply_filters( 'import_upload_size_limit', wp_max_upload_size() ); 983 $size = size_format( $bytes ); 984 $upload_dir = wp_upload_dir(); 985 if ( ! empty( $upload_dir['error'] ) ) : 986 ?> 987 <div class="error"><p><?php _e( 'Before you can upload your import file, you will need to fix the following error:' ); ?></p> 988 <p><strong><?php echo $upload_dir['error']; ?></strong></p></div> 989 <?php 990 else : 991 ?> 992 <form enctype="multipart/form-data" id="import-upload-form" method="post" class="wp-upload-form" action="<?php echo esc_url( wp_nonce_url( $action, 'import-upload' ) ); ?>"> 993 <p> 994 <?php 995 printf( 996 '<label for="upload">%s</label> (%s)', 997 __( 'Choose a file from your computer:' ), 998 /* translators: %s: Maximum allowed file size. */ 999 sprintf( __( 'Maximum size: %s' ), $size ) 1000 ); 1001 ?> 1002 <input type="file" id="upload" name="import" size="25" /> 1003 <input type="hidden" name="action" value="save" /> 1004 <input type="hidden" name="max_file_size" value="<?php echo $bytes; ?>" /> 1005 </p> 1006 <?php submit_button( __( 'Upload file and import' ), 'primary' ); ?> 1007 </form> 1008 <?php 1009 endif; 1010 } 1011 1012 /** 1013 * Adds a meta box to one or more screens. 1014 * 1015 * @since 2.5.0 1016 * @since 4.4.0 The `$screen` parameter now accepts an array of screen IDs. 1017 * 1018 * @global array $wp_meta_boxes 1019 * 1020 * @param string $id Meta box ID (used in the 'id' attribute for the meta box). 1021 * @param string $title Title of the meta box. 1022 * @param callable $callback Function that fills the box with the desired content. 1023 * The function should echo its output. 1024 * @param string|array|WP_Screen $screen Optional. The screen or screens on which to show the box 1025 * (such as a post type, 'link', or 'comment'). Accepts a single 1026 * screen ID, WP_Screen object, or array of screen IDs. Default 1027 * is the current screen. If you have used add_menu_page() or 1028 * add_submenu_page() to create a new screen (and hence screen_id), 1029 * make sure your menu slug conforms to the limits of sanitize_key() 1030 * otherwise the 'screen' menu may not correctly render on your page. 1031 * @param string $context Optional. The context within the screen where the box 1032 * should display. Available contexts vary from screen to 1033 * screen. Post edit screen contexts include 'normal', 'side', 1034 * and 'advanced'. Comments screen contexts include 'normal' 1035 * and 'side'. Menus meta boxes (accordion sections) all use 1036 * the 'side' context. Global default is 'advanced'. 1037 * @param string $priority Optional. The priority within the context where the box should show. 1038 * Accepts 'high', 'core', 'default', or 'low'. Default 'default'. 1039 * @param array $callback_args Optional. Data that should be set as the $args property 1040 * of the box array (which is the second parameter passed 1041 * to your callback). Default null. 1042 */ 1043 function add_meta_box( $id, $title, $callback, $screen = null, $context = 'advanced', $priority = 'default', $callback_args = null ) { 1044 global $wp_meta_boxes; 1045 1046 if ( empty( $screen ) ) { 1047 $screen = get_current_screen(); 1048 } elseif ( is_string( $screen ) ) { 1049 $screen = convert_to_screen( $screen ); 1050 } elseif ( is_array( $screen ) ) { 1051 foreach ( $screen as $single_screen ) { 1052 add_meta_box( $id, $title, $callback, $single_screen, $context, $priority, $callback_args ); 1053 } 1054 } 1055 1056 if ( ! isset( $screen->id ) ) { 1057 return; 1058 } 1059 1060 $page = $screen->id; 1061 1062 if ( ! isset( $wp_meta_boxes ) ) { 1063 $wp_meta_boxes = array(); 1064 } 1065 if ( ! isset( $wp_meta_boxes[ $page ] ) ) { 1066 $wp_meta_boxes[ $page ] = array(); 1067 } 1068 if ( ! isset( $wp_meta_boxes[ $page ][ $context ] ) ) { 1069 $wp_meta_boxes[ $page ][ $context ] = array(); 1070 } 1071 1072 foreach ( array_keys( $wp_meta_boxes[ $page ] ) as $a_context ) { 1073 foreach ( array( 'high', 'core', 'default', 'low' ) as $a_priority ) { 1074 if ( ! isset( $wp_meta_boxes[ $page ][ $a_context ][ $a_priority ][ $id ] ) ) { 1075 continue; 1076 } 1077 1078 // If a core box was previously removed, don't add. 1079 if ( ( 'core' === $priority || 'sorted' === $priority ) 1080 && false === $wp_meta_boxes[ $page ][ $a_context ][ $a_priority ][ $id ] 1081 ) { 1082 return; 1083 } 1084 1085 // If a core box was previously added by a plugin, don't add. 1086 if ( 'core' === $priority ) { 1087 /* 1088 * If the box was added with default priority, give it core priority 1089 * to maintain sort order. 1090 */ 1091 if ( 'default' === $a_priority ) { 1092 $wp_meta_boxes[ $page ][ $a_context ]['core'][ $id ] = $wp_meta_boxes[ $page ][ $a_context ]['default'][ $id ]; 1093 unset( $wp_meta_boxes[ $page ][ $a_context ]['default'][ $id ] ); 1094 } 1095 return; 1096 } 1097 1098 // If no priority given and ID already present, use existing priority. 1099 if ( empty( $priority ) ) { 1100 $priority = $a_priority; 1101 /* 1102 * Else, if we're adding to the sorted priority, we don't know the title 1103 * or callback. Grab them from the previously added context/priority. 1104 */ 1105 } elseif ( 'sorted' === $priority ) { 1106 $title = $wp_meta_boxes[ $page ][ $a_context ][ $a_priority ][ $id ]['title']; 1107 $callback = $wp_meta_boxes[ $page ][ $a_context ][ $a_priority ][ $id ]['callback']; 1108 $callback_args = $wp_meta_boxes[ $page ][ $a_context ][ $a_priority ][ $id ]['args']; 1109 } 1110 1111 // An ID can be in only one priority and one context. 1112 if ( $priority !== $a_priority || $context !== $a_context ) { 1113 unset( $wp_meta_boxes[ $page ][ $a_context ][ $a_priority ][ $id ] ); 1114 } 1115 } 1116 } 1117 1118 if ( empty( $priority ) ) { 1119 $priority = 'low'; 1120 } 1121 1122 if ( ! isset( $wp_meta_boxes[ $page ][ $context ][ $priority ] ) ) { 1123 $wp_meta_boxes[ $page ][ $context ][ $priority ] = array(); 1124 } 1125 1126 $wp_meta_boxes[ $page ][ $context ][ $priority ][ $id ] = array( 1127 'id' => $id, 1128 'title' => $title, 1129 'callback' => $callback, 1130 'args' => $callback_args, 1131 ); 1132 } 1133 1134 1135 /** 1136 * Renders a "fake" meta box with an information message, 1137 * shown on the block editor, when an incompatible meta box is found. 1138 * 1139 * @since 5.0.0 1140 * 1141 * @param mixed $data_object The data object being rendered on this screen. 1142 * @param array $box { 1143 * Custom formats meta box arguments. 1144 * 1145 * @type string $id Meta box 'id' attribute. 1146 * @type string $title Meta box title. 1147 * @type callable $old_callback The original callback for this meta box. 1148 * @type array $args Extra meta box arguments. 1149 * } 1150 */ 1151 function do_block_editor_incompatible_meta_box( $data_object, $box ) { 1152 $plugin = _get_plugin_from_callback( $box['old_callback'] ); 1153 $plugins = get_plugins(); 1154 echo '<p>'; 1155 if ( $plugin ) { 1156 /* translators: %s: The name of the plugin that generated this meta box. */ 1157 printf( __( 'This meta box, from the %s plugin, is not compatible with the block editor.' ), "<strong>{$plugin['Name']}</strong>" ); 1158 } else { 1159 _e( 'This meta box is not compatible with the block editor.' ); 1160 } 1161 echo '</p>'; 1162 1163 if ( empty( $plugins['classic-editor/classic-editor.php'] ) ) { 1164 if ( current_user_can( 'install_plugins' ) ) { 1165 $install_url = wp_nonce_url( 1166 self_admin_url( 'plugin-install.php?tab=favorites&user=wordpressdotorg&save=0' ), 1167 'save_wporg_username_' . get_current_user_id() 1168 ); 1169 1170 echo '<p>'; 1171 /* translators: %s: A link to install the Classic Editor plugin. */ 1172 printf( __( 'Please install the <a href="%s">Classic Editor plugin</a> to use this meta box.' ), esc_url( $install_url ) ); 1173 echo '</p>'; 1174 } 1175 } elseif ( is_plugin_inactive( 'classic-editor/classic-editor.php' ) ) { 1176 if ( current_user_can( 'activate_plugins' ) ) { 1177 $activate_url = wp_nonce_url( 1178 self_admin_url( 'plugins.php?action=activate&plugin=classic-editor/classic-editor.php' ), 1179 'activate-plugin_classic-editor/classic-editor.php' 1180 ); 1181 1182 echo '<p>'; 1183 /* translators: %s: A link to activate the Classic Editor plugin. */ 1184 printf( __( 'Please activate the <a href="%s">Classic Editor plugin</a> to use this meta box.' ), esc_url( $activate_url ) ); 1185 echo '</p>'; 1186 } 1187 } elseif ( $data_object instanceof WP_Post ) { 1188 $edit_url = add_query_arg( 1189 array( 1190 'classic-editor' => '', 1191 'classic-editor__forget' => '', 1192 ), 1193 get_edit_post_link( $data_object ) 1194 ); 1195 echo '<p>'; 1196 /* translators: %s: A link to use the Classic Editor plugin. */ 1197 printf( __( 'Please open the <a href="%s">classic editor</a> to use this meta box.' ), esc_url( $edit_url ) ); 1198 echo '</p>'; 1199 } 1200 } 1201 1202 /** 1203 * Internal helper function to find the plugin from a meta box callback. 1204 * 1205 * @since 5.0.0 1206 * 1207 * @access private 1208 * 1209 * @param callable $callback The callback function to check. 1210 * @return array|null The plugin that the callback belongs to, or null if it doesn't belong to a plugin. 1211 */ 1212 function _get_plugin_from_callback( $callback ) { 1213 try { 1214 if ( is_array( $callback ) ) { 1215 $reflection = new ReflectionMethod( $callback[0], $callback[1] ); 1216 } elseif ( is_string( $callback ) && false !== strpos( $callback, '::' ) ) { 1217 $reflection = new ReflectionMethod( $callback ); 1218 } else { 1219 $reflection = new ReflectionFunction( $callback ); 1220 } 1221 } catch ( ReflectionException $exception ) { 1222 // We could not properly reflect on the callable, so we abort here. 1223 return null; 1224 } 1225 1226 // Don't show an error if it's an internal PHP function. 1227 if ( ! $reflection->isInternal() ) { 1228 1229 // Only show errors if the meta box was registered by a plugin. 1230 $filename = wp_normalize_path( $reflection->getFileName() ); 1231 $plugin_dir = wp_normalize_path( WP_PLUGIN_DIR ); 1232 1233 if ( strpos( $filename, $plugin_dir ) === 0 ) { 1234 $filename = str_replace( $plugin_dir, '', $filename ); 1235 $filename = preg_replace( '|^/([^/]*/).*$|', '\\1', $filename ); 1236 1237 $plugins = get_plugins(); 1238 1239 foreach ( $plugins as $name => $plugin ) { 1240 if ( strpos( $name, $filename ) === 0 ) { 1241 return $plugin; 1242 } 1243 } 1244 } 1245 } 1246 1247 return null; 1248 } 1249 1250 /** 1251 * Meta-Box template function. 1252 * 1253 * @since 2.5.0 1254 * 1255 * @global array $wp_meta_boxes 1256 * 1257 * @param string|WP_Screen $screen The screen identifier. If you have used add_menu_page() or 1258 * add_submenu_page() to create a new screen (and hence screen_id) 1259 * make sure your menu slug conforms to the limits of sanitize_key() 1260 * otherwise the 'screen' menu may not correctly render on your page. 1261 * @param string $context The screen context for which to display meta boxes. 1262 * @param mixed $data_object Gets passed to the meta box callback function as the first parameter. 1263 * Often this is the object that's the focus of the current screen, 1264 * for example a `WP_Post` or `WP_Comment` object. 1265 * @return int Number of meta_boxes. 1266 */ 1267 function do_meta_boxes( $screen, $context, $data_object ) { 1268 global $wp_meta_boxes; 1269 static $already_sorted = false; 1270 1271 if ( empty( $screen ) ) { 1272 $screen = get_current_screen(); 1273 } elseif ( is_string( $screen ) ) { 1274 $screen = convert_to_screen( $screen ); 1275 } 1276 1277 $page = $screen->id; 1278 1279 $hidden = get_hidden_meta_boxes( $screen ); 1280 1281 printf( '<div id="%s-sortables" class="meta-box-sortables">', esc_attr( $context ) ); 1282 1283 // Grab the ones the user has manually sorted. 1284 // Pull them out of their previous context/priority and into the one the user chose. 1285 $sorted = get_user_option( "meta-box-order_$page" ); 1286 1287 if ( ! $already_sorted && $sorted ) { 1288 foreach ( $sorted as $box_context => $ids ) { 1289 foreach ( explode( ',', $ids ) as $id ) { 1290 if ( $id && 'dashboard_browser_nag' !== $id ) { 1291 add_meta_box( $id, null, null, $screen, $box_context, 'sorted' ); 1292 } 1293 } 1294 } 1295 } 1296 1297 $already_sorted = true; 1298 1299 $i = 0; 1300 1301 if ( isset( $wp_meta_boxes[ $page ][ $context ] ) ) { 1302 foreach ( array( 'high', 'sorted', 'core', 'default', 'low' ) as $priority ) { 1303 if ( isset( $wp_meta_boxes[ $page ][ $context ][ $priority ] ) ) { 1304 foreach ( (array) $wp_meta_boxes[ $page ][ $context ][ $priority ] as $box ) { 1305 if ( false === $box || ! $box['title'] ) { 1306 continue; 1307 } 1308 1309 $block_compatible = true; 1310 if ( is_array( $box['args'] ) ) { 1311 // If a meta box is just here for back compat, don't show it in the block editor. 1312 if ( $screen->is_block_editor() && isset( $box['args']['__back_compat_meta_box'] ) && $box['args']['__back_compat_meta_box'] ) { 1313 continue; 1314 } 1315 1316 if ( isset( $box['args']['__block_editor_compatible_meta_box'] ) ) { 1317 $block_compatible = (bool) $box['args']['__block_editor_compatible_meta_box']; 1318 unset( $box['args']['__block_editor_compatible_meta_box'] ); 1319 } 1320 1321 // If the meta box is declared as incompatible with the block editor, override the callback function. 1322 if ( ! $block_compatible && $screen->is_block_editor() ) { 1323 $box['old_callback'] = $box['callback']; 1324 $box['callback'] = 'do_block_editor_incompatible_meta_box'; 1325 } 1326 1327 if ( isset( $box['args']['__back_compat_meta_box'] ) ) { 1328 $block_compatible = $block_compatible || (bool) $box['args']['__back_compat_meta_box']; 1329 unset( $box['args']['__back_compat_meta_box'] ); 1330 } 1331 } 1332 1333 $i++; 1334 // get_hidden_meta_boxes() doesn't apply in the block editor. 1335 $hidden_class = ( ! $screen->is_block_editor() && in_array( $box['id'], $hidden, true ) ) ? ' hide-if-js' : ''; 1336 echo '<div id="' . $box['id'] . '" class="postbox ' . postbox_classes( $box['id'], $page ) . $hidden_class . '" ' . '>' . "\n"; 1337 1338 echo '<div class="postbox-header">'; 1339 echo '<h2 class="hndle">'; 1340 if ( 'dashboard_php_nag' === $box['id'] ) { 1341 echo '<span aria-hidden="true" class="dashicons dashicons-warning"></span>'; 1342 echo '<span class="screen-reader-text">' . __( 'Warning:' ) . ' </span>'; 1343 } 1344 echo $box['title']; 1345 echo "</h2>\n"; 1346 1347 if ( 'dashboard_browser_nag' !== $box['id'] ) { 1348 $widget_title = $box['title']; 1349 1350 if ( is_array( $box['args'] ) && isset( $box['args']['__widget_basename'] ) ) { 1351 $widget_title = $box['args']['__widget_basename']; 1352 // Do not pass this parameter to the user callback function. 1353 unset( $box['args']['__widget_basename'] ); 1354 } 1355 1356 echo '<div class="handle-actions hide-if-no-js">'; 1357 1358 echo '<button type="button" class="handle-order-higher" aria-disabled="false" aria-describedby="' . $box['id'] . '-handle-order-higher-description">'; 1359 echo '<span class="screen-reader-text">' . __( 'Move up' ) . '</span>'; 1360 echo '<span class="order-higher-indicator" aria-hidden="true"></span>'; 1361 echo '</button>'; 1362 echo '<span class="hidden" id="' . $box['id'] . '-handle-order-higher-description">' . sprintf( 1363 /* translators: %s: Meta box title. */ 1364 __( 'Move %s box up' ), 1365 $widget_title 1366 ) . '</span>'; 1367 1368 echo '<button type="button" class="handle-order-lower" aria-disabled="false" aria-describedby="' . $box['id'] . '-handle-order-lower-description">'; 1369 echo '<span class="screen-reader-text">' . __( 'Move down' ) . '</span>'; 1370 echo '<span class="order-lower-indicator" aria-hidden="true"></span>'; 1371 echo '</button>'; 1372 echo '<span class="hidden" id="' . $box['id'] . '-handle-order-lower-description">' . sprintf( 1373 /* translators: %s: Meta box title. */ 1374 __( 'Move %s box down' ), 1375 $widget_title 1376 ) . '</span>'; 1377 1378 echo '<button type="button" class="handlediv" aria-expanded="true">'; 1379 echo '<span class="screen-reader-text">' . sprintf( 1380 /* translators: %s: Meta box title. */ 1381 __( 'Toggle panel: %s' ), 1382 $widget_title 1383 ) . '</span>'; 1384 echo '<span class="toggle-indicator" aria-hidden="true"></span>'; 1385 echo '</button>'; 1386 1387 echo '</div>'; 1388 } 1389 echo '</div>'; 1390 1391 echo '<div class="inside">' . "\n"; 1392 1393 if ( WP_DEBUG && ! $block_compatible && 'edit' === $screen->parent_base && ! $screen->is_block_editor() && ! isset( $_GET['meta-box-loader'] ) ) { 1394 $plugin = _get_plugin_from_callback( $box['callback'] ); 1395 if ( $plugin ) { 1396 ?> 1397 <div class="error inline"> 1398 <p> 1399 <?php 1400 /* translators: %s: The name of the plugin that generated this meta box. */ 1401 printf( __( 'This meta box, from the %s plugin, is not compatible with the block editor.' ), "<strong>{$plugin['Name']}</strong>" ); 1402 ?> 1403 </p> 1404 </div> 1405 <?php 1406 } 1407 } 1408 1409 call_user_func( $box['callback'], $data_object, $box ); 1410 echo "</div>\n"; 1411 echo "</div>\n"; 1412 } 1413 } 1414 } 1415 } 1416 1417 echo '</div>'; 1418 1419 return $i; 1420 1421 } 1422 1423 /** 1424 * Removes a meta box from one or more screens. 1425 * 1426 * @since 2.6.0 1427 * @since 4.4.0 The `$screen` parameter now accepts an array of screen IDs. 1428 * 1429 * @global array $wp_meta_boxes 1430 * 1431 * @param string $id Meta box ID (used in the 'id' attribute for the meta box). 1432 * @param string|array|WP_Screen $screen The screen or screens on which the meta box is shown (such as a 1433 * post type, 'link', or 'comment'). Accepts a single screen ID, 1434 * WP_Screen object, or array of screen IDs. 1435 * @param string $context The context within the screen where the box is set to display. 1436 * Contexts vary from screen to screen. Post edit screen contexts 1437 * include 'normal', 'side', and 'advanced'. Comments screen contexts 1438 * include 'normal' and 'side'. Menus meta boxes (accordion sections) 1439 * all use the 'side' context. 1440 */ 1441 function remove_meta_box( $id, $screen, $context ) { 1442 global $wp_meta_boxes; 1443 1444 if ( empty( $screen ) ) { 1445 $screen = get_current_screen(); 1446 } elseif ( is_string( $screen ) ) { 1447 $screen = convert_to_screen( $screen ); 1448 } elseif ( is_array( $screen ) ) { 1449 foreach ( $screen as $single_screen ) { 1450 remove_meta_box( $id, $single_screen, $context ); 1451 } 1452 } 1453 1454 if ( ! isset( $screen->id ) ) { 1455 return; 1456 } 1457 1458 $page = $screen->id; 1459 1460 if ( ! isset( $wp_meta_boxes ) ) { 1461 $wp_meta_boxes = array(); 1462 } 1463 if ( ! isset( $wp_meta_boxes[ $page ] ) ) { 1464 $wp_meta_boxes[ $page ] = array(); 1465 } 1466 if ( ! isset( $wp_meta_boxes[ $page ][ $context ] ) ) { 1467 $wp_meta_boxes[ $page ][ $context ] = array(); 1468 } 1469 1470 foreach ( array( 'high', 'core', 'default', 'low' ) as $priority ) { 1471 $wp_meta_boxes[ $page ][ $context ][ $priority ][ $id ] = false; 1472 } 1473 } 1474 1475 /** 1476 * Meta Box Accordion Template Function. 1477 * 1478 * Largely made up of abstracted code from do_meta_boxes(), this 1479 * function serves to build meta boxes as list items for display as 1480 * a collapsible accordion. 1481 * 1482 * @since 3.6.0 1483 * 1484 * @uses global $wp_meta_boxes Used to retrieve registered meta boxes. 1485 * 1486 * @param string|object $screen The screen identifier. 1487 * @param string $context The screen context for which to display accordion sections. 1488 * @param mixed $data_object Gets passed to the section callback function as the first parameter. 1489 * @return int Number of meta boxes as accordion sections. 1490 */ 1491 function do_accordion_sections( $screen, $context, $data_object ) { 1492 global $wp_meta_boxes; 1493 1494 wp_enqueue_script( 'accordion' ); 1495 1496 if ( empty( $screen ) ) { 1497 $screen = get_current_screen(); 1498 } elseif ( is_string( $screen ) ) { 1499 $screen = convert_to_screen( $screen ); 1500 } 1501 1502 $page = $screen->id; 1503 1504 $hidden = get_hidden_meta_boxes( $screen ); 1505 ?> 1506 <div id="side-sortables" class="accordion-container"> 1507 <ul class="outer-border"> 1508 <?php 1509 $i = 0; 1510 $first_open = false; 1511 1512 if ( isset( $wp_meta_boxes[ $page ][ $context ] ) ) { 1513 foreach ( array( 'high', 'core', 'default', 'low' ) as $priority ) { 1514 if ( isset( $wp_meta_boxes[ $page ][ $context ][ $priority ] ) ) { 1515 foreach ( $wp_meta_boxes[ $page ][ $context ][ $priority ] as $box ) { 1516 if ( false === $box || ! $box['title'] ) { 1517 continue; 1518 } 1519 1520 $i++; 1521 $hidden_class = in_array( $box['id'], $hidden, true ) ? 'hide-if-js' : ''; 1522 1523 $open_class = ''; 1524 if ( ! $first_open && empty( $hidden_class ) ) { 1525 $first_open = true; 1526 $open_class = 'open'; 1527 } 1528 ?> 1529 <li class="control-section accordion-section <?php echo $hidden_class; ?> <?php echo $open_class; ?> <?php echo esc_attr( $box['id'] ); ?>" id="<?php echo esc_attr( $box['id'] ); ?>"> 1530 <h3 class="accordion-section-title hndle" tabindex="0"> 1531 <?php echo esc_html( $box['title'] ); ?> 1532 <span class="screen-reader-text"><?php _e( 'Press return or enter to open this section' ); ?></span> 1533 </h3> 1534 <div class="accordion-section-content <?php postbox_classes( $box['id'], $page ); ?>"> 1535 <div class="inside"> 1536 <?php call_user_func( $box['callback'], $data_object, $box ); ?> 1537 </div><!-- .inside --> 1538 </div><!-- .accordion-section-content --> 1539 </li><!-- .accordion-section --> 1540 <?php 1541 } 1542 } 1543 } 1544 } 1545 ?> 1546 </ul><!-- .outer-border --> 1547 </div><!-- .accordion-container --> 1548 <?php 1549 return $i; 1550 } 1551 1552 /** 1553 * Adds a new section to a settings page. 1554 * 1555 * Part of the Settings API. Use this to define new settings sections for an admin page. 1556 * Show settings sections in your admin page callback function with do_settings_sections(). 1557 * Add settings fields to your section with add_settings_field(). 1558 * 1559 * The $callback argument should be the name of a function that echoes out any 1560 * content you want to show at the top of the settings section before the actual 1561 * fields. It can output nothing if you want. 1562 * 1563 * @since 2.7.0 1564 * 1565 * @global array $wp_settings_sections Storage array of all settings sections added to admin pages. 1566 * 1567 * @param string $id Slug-name to identify the section. Used in the 'id' attribute of tags. 1568 * @param string $title Formatted title of the section. Shown as the heading for the section. 1569 * @param callable $callback Function that echos out any content at the top of the section (between heading and fields). 1570 * @param string $page The slug-name of the settings page on which to show the section. Built-in pages include 1571 * 'general', 'reading', 'writing', 'discussion', 'media', etc. Create your own using 1572 * add_options_page(); 1573 */ 1574 function add_settings_section( $id, $title, $callback, $page ) { 1575 global $wp_settings_sections; 1576 1577 if ( 'misc' === $page ) { 1578 _deprecated_argument( 1579 __FUNCTION__, 1580 '3.0.0', 1581 sprintf( 1582 /* translators: %s: misc */ 1583 __( 'The "%s" options group has been removed. Use another settings group.' ), 1584 'misc' 1585 ) 1586 ); 1587 $page = 'general'; 1588 } 1589 1590 if ( 'privacy' === $page ) { 1591 _deprecated_argument( 1592 __FUNCTION__, 1593 '3.5.0', 1594 sprintf( 1595 /* translators: %s: privacy */ 1596 __( 'The "%s" options group has been removed. Use another settings group.' ), 1597 'privacy' 1598 ) 1599 ); 1600 $page = 'reading'; 1601 } 1602 1603 $wp_settings_sections[ $page ][ $id ] = array( 1604 'id' => $id, 1605 'title' => $title, 1606 'callback' => $callback, 1607 ); 1608 } 1609 1610 /** 1611 * Adds a new field to a section of a settings page. 1612 * 1613 * Part of the Settings API. Use this to define a settings field that will show 1614 * as part of a settings section inside a settings page. The fields are shown using 1615 * do_settings_fields() in do_settings_sections(). 1616 * 1617 * The $callback argument should be the name of a function that echoes out the 1618 * HTML input tags for this setting field. Use get_option() to retrieve existing 1619 * values to show. 1620 * 1621 * @since 2.7.0 1622 * @since 4.2.0 The `$class` argument was added. 1623 * 1624 * @global array $wp_settings_fields Storage array of settings fields and info about their pages/sections. 1625 * 1626 * @param string $id Slug-name to identify the field. Used in the 'id' attribute of tags. 1627 * @param string $title Formatted title of the field. Shown as the label for the field 1628 * during output. 1629 * @param callable $callback Function that fills the field with the desired form inputs. The 1630 * function should echo its output. 1631 * @param string $page The slug-name of the settings page on which to show the section 1632 * (general, reading, writing, ...). 1633 * @param string $section Optional. The slug-name of the section of the settings page 1634 * in which to show the box. Default 'default'. 1635 * @param array $args { 1636 * Optional. Extra arguments used when outputting the field. 1637 * 1638 * @type string $label_for When supplied, the setting title will be wrapped 1639 * in a `<label>` element, its `for` attribute populated 1640 * with this value. 1641 * @type string $class CSS Class to be added to the `<tr>` element when the 1642 * field is output. 1643 * } 1644 */ 1645 function add_settings_field( $id, $title, $callback, $page, $section = 'default', $args = array() ) { 1646 global $wp_settings_fields; 1647 1648 if ( 'misc' === $page ) { 1649 _deprecated_argument( 1650 __FUNCTION__, 1651 '3.0.0', 1652 sprintf( 1653 /* translators: %s: misc */ 1654 __( 'The "%s" options group has been removed. Use another settings group.' ), 1655 'misc' 1656 ) 1657 ); 1658 $page = 'general'; 1659 } 1660 1661 if ( 'privacy' === $page ) { 1662 _deprecated_argument( 1663 __FUNCTION__, 1664 '3.5.0', 1665 sprintf( 1666 /* translators: %s: privacy */ 1667 __( 'The "%s" options group has been removed. Use another settings group.' ), 1668 'privacy' 1669 ) 1670 ); 1671 $page = 'reading'; 1672 } 1673 1674 $wp_settings_fields[ $page ][ $section ][ $id ] = array( 1675 'id' => $id, 1676 'title' => $title, 1677 'callback' => $callback, 1678 'args' => $args, 1679 ); 1680 } 1681 1682 /** 1683 * Prints out all settings sections added to a particular settings page 1684 * 1685 * Part of the Settings API. Use this in a settings page callback function 1686 * to output all the sections and fields that were added to that $page with 1687 * add_settings_section() and add_settings_field() 1688 * 1689 * @global array $wp_settings_sections Storage array of all settings sections added to admin pages. 1690 * @global array $wp_settings_fields Storage array of settings fields and info about their pages/sections. 1691 * @since 2.7.0 1692 * 1693 * @param string $page The slug name of the page whose settings sections you want to output. 1694 */ 1695 function do_settings_sections( $page ) { 1696 global $wp_settings_sections, $wp_settings_fields; 1697 1698 if ( ! isset( $wp_settings_sections[ $page ] ) ) { 1699 return; 1700 } 1701 1702 foreach ( (array) $wp_settings_sections[ $page ] as $section ) { 1703 if ( $section['title'] ) { 1704 echo "<h2>{$section['title']}</h2>\n"; 1705 } 1706 1707 if ( $section['callback'] ) { 1708 call_user_func( $section['callback'], $section ); 1709 } 1710 1711 if ( ! isset( $wp_settings_fields ) || ! isset( $wp_settings_fields[ $page ] ) || ! isset( $wp_settings_fields[ $page ][ $section['id'] ] ) ) { 1712 continue; 1713 } 1714 echo '<table class="form-table" role="presentation">'; 1715 do_settings_fields( $page, $section['id'] ); 1716 echo '</table>'; 1717 } 1718 } 1719 1720 /** 1721 * Prints out the settings fields for a particular settings section. 1722 * 1723 * Part of the Settings API. Use this in a settings page to output 1724 * a specific section. Should normally be called by do_settings_sections() 1725 * rather than directly. 1726 * 1727 * @global array $wp_settings_fields Storage array of settings fields and their pages/sections. 1728 * 1729 * @since 2.7.0 1730 * 1731 * @param string $page Slug title of the admin page whose settings fields you want to show. 1732 * @param string $section Slug title of the settings section whose fields you want to show. 1733 */ 1734 function do_settings_fields( $page, $section ) { 1735 global $wp_settings_fields; 1736 1737 if ( ! isset( $wp_settings_fields[ $page ][ $section ] ) ) { 1738 return; 1739 } 1740 1741 foreach ( (array) $wp_settings_fields[ $page ][ $section ] as $field ) { 1742 $class = ''; 1743 1744 if ( ! empty( $field['args']['class'] ) ) { 1745 $class = ' class="' . esc_attr( $field['args']['class'] ) . '"'; 1746 } 1747 1748 echo "<tr{$class}>"; 1749 1750 if ( ! empty( $field['args']['label_for'] ) ) { 1751 echo '<th scope="row"><label for="' . esc_attr( $field['args']['label_for'] ) . '">' . $field['title'] . '</label></th>'; 1752 } else { 1753 echo '<th scope="row">' . $field['title'] . '</th>'; 1754 } 1755 1756 echo '<td>'; 1757 call_user_func( $field['callback'], $field['args'] ); 1758 echo '</td>'; 1759 echo '</tr>'; 1760 } 1761 } 1762 1763 /** 1764 * Registers a settings error to be displayed to the user. 1765 * 1766 * Part of the Settings API. Use this to show messages to users about settings validation 1767 * problems, missing settings or anything else. 1768 * 1769 * Settings errors should be added inside the $sanitize_callback function defined in 1770 * register_setting() for a given setting to give feedback about the submission. 1771 * 1772 * By default messages will show immediately after the submission that generated the error. 1773 * Additional calls to settings_errors() can be used to show errors even when the settings 1774 * page is first accessed. 1775 * 1776 * @since 3.0.0 1777 * @since 5.3.0 Added `warning` and `info` as possible values for `$type`. 1778 * 1779 * @global array $wp_settings_errors Storage array of errors registered during this pageload 1780 * 1781 * @param string $setting Slug title of the setting to which this error applies. 1782 * @param string $code Slug-name to identify the error. Used as part of 'id' attribute in HTML output. 1783 * @param string $message The formatted message text to display to the user (will be shown inside styled 1784 * `<div>` and `<p>` tags). 1785 * @param string $type Optional. Message type, controls HTML class. Possible values include 'error', 1786 * 'success', 'warning', 'info'. Default 'error'. 1787 */ 1788 function add_settings_error( $setting, $code, $message, $type = 'error' ) { 1789 global $wp_settings_errors; 1790 1791 $wp_settings_errors[] = array( 1792 'setting' => $setting, 1793 'code' => $code, 1794 'message' => $message, 1795 'type' => $type, 1796 ); 1797 } 1798 1799 /** 1800 * Fetches settings errors registered by add_settings_error(). 1801 * 1802 * Checks the $wp_settings_errors array for any errors declared during the current 1803 * pageload and returns them. 1804 * 1805 * If changes were just submitted ($_GET['settings-updated']) and settings errors were saved 1806 * to the 'settings_errors' transient then those errors will be returned instead. This 1807 * is used to pass errors back across pageloads. 1808 * 1809 * Use the $sanitize argument to manually re-sanitize the option before returning errors. 1810 * This is useful if you have errors or notices you want to show even when the user 1811 * hasn't submitted data (i.e. when they first load an options page, or in the {@see 'admin_notices'} 1812 * action hook). 1813 * 1814 * @since 3.0.0 1815 * 1816 * @global array $wp_settings_errors Storage array of errors registered during this pageload 1817 * 1818 * @param string $setting Optional. Slug title of a specific setting whose errors you want. 1819 * @param bool $sanitize Optional. Whether to re-sanitize the setting value before returning errors. 1820 * @return array { 1821 * Array of settings errors. 1822 * 1823 * @type string $setting Slug title of the setting to which this error applies. 1824 * @type string $code Slug-name to identify the error. Used as part of 'id' attribute in HTML output. 1825 * @type string $message The formatted message text to display to the user (will be shown inside styled 1826 * `<div>` and `<p>` tags). 1827 * @type string $type Optional. Message type, controls HTML class. Possible values include 'error', 1828 * 'success', 'warning', 'info'. Default 'error'. 1829 * } 1830 */ 1831 function get_settings_errors( $setting = '', $sanitize = false ) { 1832 global $wp_settings_errors; 1833 1834 /* 1835 * If $sanitize is true, manually re-run the sanitization for this option 1836 * This allows the $sanitize_callback from register_setting() to run, adding 1837 * any settings errors you want to show by default. 1838 */ 1839 if ( $sanitize ) { 1840 sanitize_option( $setting, get_option( $setting ) ); 1841 } 1842 1843 // If settings were passed back from options.php then use them. 1844 if ( isset( $_GET['settings-updated'] ) && $_GET['settings-updated'] && get_transient( 'settings_errors' ) ) { 1845 $wp_settings_errors = array_merge( (array) $wp_settings_errors, get_transient( 'settings_errors' ) ); 1846 delete_transient( 'settings_errors' ); 1847 } 1848 1849 // Check global in case errors have been added on this pageload. 1850 if ( empty( $wp_settings_errors ) ) { 1851 return array(); 1852 } 1853 1854 // Filter the results to those of a specific setting if one was set. 1855 if ( $setting ) { 1856 $setting_errors = array(); 1857 1858 foreach ( (array) $wp_settings_errors as $key => $details ) { 1859 if ( $setting === $details['setting'] ) { 1860 $setting_errors[] = $wp_settings_errors[ $key ]; 1861 } 1862 } 1863 1864 return $setting_errors; 1865 } 1866 1867 return $wp_settings_errors; 1868 } 1869 1870 /** 1871 * Displays settings errors registered by add_settings_error(). 1872 * 1873 * Part of the Settings API. Outputs a div for each error retrieved by 1874 * get_settings_errors(). 1875 * 1876 * This is called automatically after a settings page based on the 1877 * Settings API is submitted. Errors should be added during the validation 1878 * callback function for a setting defined in register_setting(). 1879 * 1880 * The $sanitize option is passed into get_settings_errors() and will 1881 * re-run the setting sanitization 1882 * on its current value. 1883 * 1884 * The $hide_on_update option will cause errors to only show when the settings 1885 * page is first loaded. if the user has already saved new values it will be 1886 * hidden to avoid repeating messages already shown in the default error 1887 * reporting after submission. This is useful to show general errors like 1888 * missing settings when the user arrives at the settings page. 1889 * 1890 * @since 3.0.0 1891 * @since 5.3.0 Legacy `error` and `updated` CSS classes are mapped to 1892 * `notice-error` and `notice-success`. 1893 * 1894 * @param string $setting Optional slug title of a specific setting whose errors you want. 1895 * @param bool $sanitize Whether to re-sanitize the setting value before returning errors. 1896 * @param bool $hide_on_update If set to true errors will not be shown if the settings page has 1897 * already been submitted. 1898 */ 1899 function settings_errors( $setting = '', $sanitize = false, $hide_on_update = false ) { 1900 1901 if ( $hide_on_update && ! empty( $_GET['settings-updated'] ) ) { 1902 return; 1903 } 1904 1905 $settings_errors = get_settings_errors( $setting, $sanitize ); 1906 1907 if ( empty( $settings_errors ) ) { 1908 return; 1909 } 1910 1911 $output = ''; 1912 1913 foreach ( $settings_errors as $key => $details ) { 1914 if ( 'updated' === $details['type'] ) { 1915 $details['type'] = 'success'; 1916 } 1917 1918 if ( in_array( $details['type'], array( 'error', 'success', 'warning', 'info' ), true ) ) { 1919 $details['type'] = 'notice-' . $details['type']; 1920 } 1921 1922 $css_id = sprintf( 1923 'setting-error-%s', 1924 esc_attr( $details['code'] ) 1925 ); 1926 $css_class = sprintf( 1927 'notice %s settings-error is-dismissible', 1928 esc_attr( $details['type'] ) 1929 ); 1930 1931 $output .= "<div id='$css_id' class='$css_class'> \n"; 1932 $output .= "<p><strong>{$details['message']}</strong></p>"; 1933 $output .= "</div> \n"; 1934 } 1935 1936 echo $output; 1937 } 1938 1939 /** 1940 * Outputs the modal window used for attaching media to posts or pages in the media-listing screen. 1941 * 1942 * @since 2.7.0 1943 * 1944 * @param string $found_action 1945 */ 1946 function find_posts_div( $found_action = '' ) { 1947 ?> 1948 <div id="find-posts" class="find-box" style="display: none;"> 1949 <div id="find-posts-head" class="find-box-head"> 1950 <?php _e( 'Attach to existing content' ); ?> 1951 <button type="button" id="find-posts-close"><span class="screen-reader-text"><?php _e( 'Close media attachment panel' ); ?></span></button> 1952 </div> 1953 <div class="find-box-inside"> 1954 <div class="find-box-search"> 1955 <?php if ( $found_action ) { ?> 1956 <input type="hidden" name="found_action" value="<?php echo esc_attr( $found_action ); ?>" /> 1957 <?php } ?> 1958 <input type="hidden" name="affected" id="affected" value="" /> 1959 <?php wp_nonce_field( 'find-posts', '_ajax_nonce', false ); ?> 1960 <label class="screen-reader-text" for="find-posts-input"><?php _e( 'Search' ); ?></label> 1961 <input type="text" id="find-posts-input" name="ps" value="" /> 1962 <span class="spinner"></span> 1963 <input type="button" id="find-posts-search" value="<?php esc_attr_e( 'Search' ); ?>" class="button" /> 1964 <div class="clear"></div> 1965 </div> 1966 <div id="find-posts-response"></div> 1967 </div> 1968 <div class="find-box-buttons"> 1969 <?php submit_button( __( 'Select' ), 'primary alignright', 'find-posts-submit', false ); ?> 1970 <div class="clear"></div> 1971 </div> 1972 </div> 1973 <?php 1974 } 1975 1976 /** 1977 * Displays the post password. 1978 * 1979 * The password is passed through esc_attr() to ensure that it is safe for placing in an HTML attribute. 1980 * 1981 * @since 2.7.0 1982 */ 1983 function the_post_password() { 1984 $post = get_post(); 1985 if ( isset( $post->post_password ) ) { 1986 echo esc_attr( $post->post_password ); 1987 } 1988 } 1989 1990 /** 1991 * Gets the post title. 1992 * 1993 * The post title is fetched and if it is blank then a default string is 1994 * returned. 1995 * 1996 * @since 2.7.0 1997 * 1998 * @param int|WP_Post $post Optional. Post ID or WP_Post object. Default is global $post. 1999 * @return string The post title if set. 2000 */ 2001 function _draft_or_post_title( $post = 0 ) { 2002 $title = get_the_title( $post ); 2003 if ( empty( $title ) ) { 2004 $title = __( '(no title)' ); 2005 } 2006 return esc_html( $title ); 2007 } 2008 2009 /** 2010 * Displays the search query. 2011 * 2012 * A simple wrapper to display the "s" parameter in a `GET` URI. This function 2013 * should only be used when the_search_query() cannot. 2014 * 2015 * @since 2.7.0 2016 */ 2017 function _admin_search_query() { 2018 echo isset( $_REQUEST['s'] ) ? esc_attr( wp_unslash( $_REQUEST['s'] ) ) : ''; 2019 } 2020 2021 /** 2022 * Generic Iframe header for use with Thickbox. 2023 * 2024 * @since 2.7.0 2025 * 2026 * @global string $hook_suffix 2027 * @global string $admin_body_class 2028 * @global WP_Locale $wp_locale WordPress date and time locale object. 2029 * 2030 * @param string $title Optional. Title of the Iframe page. Default empty. 2031 * @param bool $deprecated Not used. 2032 */ 2033 function iframe_header( $title = '', $deprecated = false ) { 2034 show_admin_bar( false ); 2035 global $hook_suffix, $admin_body_class, $wp_locale; 2036 $admin_body_class = preg_replace( '/[^a-z0-9_-]+/i', '-', $hook_suffix ); 2037 2038 $current_screen = get_current_screen(); 2039 2040 header( 'Content-Type: ' . get_option( 'html_type' ) . '; charset=' . get_option( 'blog_charset' ) ); 2041 _wp_admin_html_begin(); 2042 ?> 2043 <title><?php bloginfo( 'name' ); ?> › <?php echo $title; ?> — <?php _e( 'WordPress' ); ?></title> 2044 <?php 2045 wp_enqueue_style( 'colors' ); 2046 ?> 2047 <script type="text/javascript"> 2048 addLoadEvent = function(func){if(typeof jQuery!=='undefined')jQuery(function(){func();});else if(typeof wpOnload!=='function'){wpOnload=func;}else{var oldonload=wpOnload;wpOnload=function(){oldonload();func();}}}; 2049 function tb_close(){var win=window.dialogArguments||opener||parent||top;win.tb_remove();} 2050 var ajaxurl = '<?php echo esc_js( admin_url( 'admin-ajax.php', 'relative' ) ); ?>', 2051 pagenow = '<?php echo esc_js( $current_screen->id ); ?>', 2052 typenow = '<?php echo esc_js( $current_screen->post_type ); ?>', 2053 adminpage = '<?php echo esc_js( $admin_body_class ); ?>', 2054 thousandsSeparator = '<?php echo esc_js( $wp_locale->number_format['thousands_sep'] ); ?>', 2055 decimalPoint = '<?php echo esc_js( $wp_locale->number_format['decimal_point'] ); ?>', 2056 isRtl = <?php echo (int) is_rtl(); ?>; 2057 </script> 2058 <?php 2059 /** This action is documented in wp-admin/admin-header.php */ 2060 do_action( 'admin_enqueue_scripts', $hook_suffix ); 2061 2062 /** This action is documented in wp-admin/admin-header.php */ 2063 do_action( "admin_print_styles-{$hook_suffix}" ); // phpcs:ignore WordPress.NamingConventions.ValidHookName.UseUnderscores 2064 2065 /** This action is documented in wp-admin/admin-header.php */ 2066 do_action( 'admin_print_styles' ); 2067 2068 /** This action is documented in wp-admin/admin-header.php */ 2069 do_action( "admin_print_scripts-{$hook_suffix}" ); // phpcs:ignore WordPress.NamingConventions.ValidHookName.UseUnderscores 2070 2071 /** This action is documented in wp-admin/admin-header.php */ 2072 do_action( 'admin_print_scripts' ); 2073 2074 /** This action is documented in wp-admin/admin-header.php */ 2075 do_action( "admin_head-{$hook_suffix}" ); // phpcs:ignore WordPress.NamingConventions.ValidHookName.UseUnderscores 2076 2077 /** This action is documented in wp-admin/admin-header.php */ 2078 do_action( 'admin_head' ); 2079 2080 $admin_body_class .= ' locale-' . sanitize_html_class( strtolower( str_replace( '_', '-', get_user_locale() ) ) ); 2081 2082 if ( is_rtl() ) { 2083 $admin_body_class .= ' rtl'; 2084 } 2085 2086 ?> 2087 </head> 2088 <?php 2089 /** 2090 * @global string $body_id 2091 */ 2092 $admin_body_id = isset( $GLOBALS['body_id'] ) ? 'id="' . $GLOBALS['body_id'] . '" ' : ''; 2093 2094 /** This filter is documented in wp-admin/admin-header.php */ 2095 $admin_body_classes = apply_filters( 'admin_body_class', '' ); 2096 $admin_body_classes = ltrim( $admin_body_classes . ' ' . $admin_body_class ); 2097 ?> 2098 <body <?php echo $admin_body_id; ?>class="wp-admin wp-core-ui no-js iframe <?php echo $admin_body_classes; ?>"> 2099 <script type="text/javascript"> 2100 (function(){ 2101 var c = document.body.className; 2102 c = c.replace(/no-js/, 'js'); 2103 document.body.className = c; 2104 })(); 2105 </script> 2106 <?php 2107 } 2108 2109 /** 2110 * Generic Iframe footer for use with Thickbox. 2111 * 2112 * @since 2.7.0 2113 */ 2114 function iframe_footer() { 2115 /* 2116 * We're going to hide any footer output on iFrame pages, 2117 * but run the hooks anyway since they output JavaScript 2118 * or other needed content. 2119 */ 2120 2121 /** 2122 * @global string $hook_suffix 2123 */ 2124 global $hook_suffix; 2125 ?> 2126 <div class="hidden"> 2127 <?php 2128 /** This action is documented in wp-admin/admin-footer.php */ 2129 do_action( 'admin_footer', $hook_suffix ); 2130 2131 /** This action is documented in wp-admin/admin-footer.php */ 2132 do_action( "admin_print_footer_scripts-{$hook_suffix}" ); // phpcs:ignore WordPress.NamingConventions.ValidHookName.UseUnderscores 2133 2134 /** This action is documented in wp-admin/admin-footer.php */ 2135 do_action( 'admin_print_footer_scripts' ); 2136 ?> 2137 </div> 2138 <script type="text/javascript">if(typeof wpOnload==='function')wpOnload();</script> 2139 </body> 2140 </html> 2141 <?php 2142 } 2143 2144 /** 2145 * Echoes or returns the post states as HTML. 2146 * 2147 * @since 2.7.0 2148 * @since 5.3.0 Added the `$display` parameter and a return value. 2149 * 2150 * @see get_post_states() 2151 * 2152 * @param WP_Post $post The post to retrieve states for. 2153 * @param bool $display Optional. Whether to display the post states as an HTML string. 2154 * Default true. 2155 * @return string Post states string. 2156 */ 2157 function _post_states( $post, $display = true ) { 2158 $post_states = get_post_states( $post ); 2159 $post_states_string = ''; 2160 2161 if ( ! empty( $post_states ) ) { 2162 $state_count = count( $post_states ); 2163 2164 $i = 0; 2165 2166 $post_states_string .= ' — '; 2167 2168 foreach ( $post_states as $state ) { 2169 ++$i; 2170 2171 $sep = ( $i < $state_count ) ? ', ' : ''; 2172 2173 $post_states_string .= "<span class='post-state'>$state$sep</span>"; 2174 } 2175 } 2176 2177 if ( $display ) { 2178 echo $post_states_string; 2179 } 2180 2181 return $post_states_string; 2182 } 2183 2184 /** 2185 * Retrieves an array of post states from a post. 2186 * 2187 * @since 5.3.0 2188 * 2189 * @param WP_Post $post The post to retrieve states for. 2190 * @return string[] Array of post state labels keyed by their state. 2191 */ 2192 function get_post_states( $post ) { 2193 $post_states = array(); 2194 2195 if ( isset( $_REQUEST['post_status'] ) ) { 2196 $post_status = $_REQUEST['post_status']; 2197 } else { 2198 $post_status = ''; 2199 } 2200 2201 if ( ! empty( $post->post_password ) ) { 2202 $post_states['protected'] = _x( 'Password protected', 'post status' ); 2203 } 2204 2205 if ( 'private' === $post->post_status && 'private' !== $post_status ) { 2206 $post_states['private'] = _x( 'Private', 'post status' ); 2207 } 2208 2209 if ( 'draft' === $post->post_status ) { 2210 if ( get_post_meta( $post->ID, '_customize_changeset_uuid', true ) ) { 2211 $post_states[] = __( 'Customization Draft' ); 2212 } elseif ( 'draft' !== $post_status ) { 2213 $post_states['draft'] = _x( 'Draft', 'post status' ); 2214 } 2215 } elseif ( 'trash' === $post->post_status && get_post_meta( $post->ID, '_customize_changeset_uuid', true ) ) { 2216 $post_states[] = _x( 'Customization Draft', 'post status' ); 2217 } 2218 2219 if ( 'pending' === $post->post_status && 'pending' !== $post_status ) { 2220 $post_states['pending'] = _x( 'Pending', 'post status' ); 2221 } 2222 2223 if ( is_sticky( $post->ID ) ) { 2224 $post_states['sticky'] = _x( 'Sticky', 'post status' ); 2225 } 2226 2227 if ( 'future' === $post->post_status ) { 2228 $post_states['scheduled'] = _x( 'Scheduled', 'post status' ); 2229 } 2230 2231 if ( 'page' === get_option( 'show_on_front' ) ) { 2232 if ( (int) get_option( 'page_on_front' ) === $post->ID ) { 2233 $post_states['page_on_front'] = _x( 'Front Page', 'page label' ); 2234 } 2235 2236 if ( (int) get_option( 'page_for_posts' ) === $post->ID ) { 2237 $post_states['page_for_posts'] = _x( 'Posts Page', 'page label' ); 2238 } 2239 } 2240 2241 if ( (int) get_option( 'wp_page_for_privacy_policy' ) === $post->ID ) { 2242 $post_states['page_for_privacy_policy'] = _x( 'Privacy Policy Page', 'page label' ); 2243 } 2244 2245 /** 2246 * Filters the default post display states used in the posts list table. 2247 * 2248 * @since 2.8.0 2249 * @since 3.6.0 Added the `$post` parameter. 2250 * @since 5.5.0 Also applied in the Customizer context. If any admin functions 2251 * are used within the filter, their existence should be checked 2252 * with `function_exists()` before being used. 2253 * 2254 * @param string[] $post_states An array of post display states. 2255 * @param WP_Post $post The current post object. 2256 */ 2257 return apply_filters( 'display_post_states', $post_states, $post ); 2258 } 2259 2260 /** 2261 * Outputs the attachment media states as HTML. 2262 * 2263 * @since 3.2.0 2264 * @since 5.6.0 Added the `$display` parameter and a return value. 2265 * 2266 * @param WP_Post $post The attachment post to retrieve states for. 2267 * @param bool $display Optional. Whether to display the post states as an HTML string. 2268 * Default true. 2269 * @return string Media states string. 2270 */ 2271 function _media_states( $post, $display = true ) { 2272 $media_states = get_media_states( $post ); 2273 $media_states_string = ''; 2274 2275 if ( ! empty( $media_states ) ) { 2276 $state_count = count( $media_states ); 2277 2278 $i = 0; 2279 2280 $media_states_string .= ' — '; 2281 2282 foreach ( $media_states as $state ) { 2283 ++$i; 2284 2285 $sep = ( $i < $state_count ) ? ', ' : ''; 2286 2287 $media_states_string .= "<span class='post-state'>$state$sep</span>"; 2288 } 2289 } 2290 2291 if ( $display ) { 2292 echo $media_states_string; 2293 } 2294 2295 return $media_states_string; 2296 } 2297 2298 /** 2299 * Retrieves an array of media states from an attachment. 2300 * 2301 * @since 5.6.0 2302 * 2303 * @param WP_Post $post The attachment to retrieve states for. 2304 * @return string[] Array of media state labels keyed by their state. 2305 */ 2306 function get_media_states( $post ) { 2307 static $header_images; 2308 2309 $media_states = array(); 2310 $stylesheet = get_option( 'stylesheet' ); 2311 2312 if ( current_theme_supports( 'custom-header' ) ) { 2313 $meta_header = get_post_meta( $post->ID, '_wp_attachment_is_custom_header', true ); 2314 2315 if ( is_random_header_image() ) { 2316 if ( ! isset( $header_images ) ) { 2317 $header_images = wp_list_pluck( get_uploaded_header_images(), 'attachment_id' ); 2318 } 2319 2320 if ( $meta_header === $stylesheet && in_array( $post->ID, $header_images, true ) ) { 2321 $media_states[] = __( 'Header Image' ); 2322 } 2323 } else { 2324 $header_image = get_header_image(); 2325 2326 // Display "Header Image" if the image was ever used as a header image. 2327 if ( ! empty( $meta_header ) && $meta_header === $stylesheet && wp_get_attachment_url( $post->ID ) !== $header_image ) { 2328 $media_states[] = __( 'Header Image' ); 2329 } 2330 2331 // Display "Current Header Image" if the image is currently the header image. 2332 if ( $header_image && wp_get_attachment_url( $post->ID ) === $header_image ) { 2333 $media_states[] = __( 'Current Header Image' ); 2334 } 2335 } 2336 2337 if ( get_theme_support( 'custom-header', 'video' ) && has_header_video() ) { 2338 $mods = get_theme_mods(); 2339 if ( isset( $mods['header_video'] ) && $post->ID === $mods['header_video'] ) { 2340 $media_states[] = __( 'Current Header Video' ); 2341 } 2342 } 2343 } 2344 2345 if ( current_theme_supports( 'custom-background' ) ) { 2346 $meta_background = get_post_meta( $post->ID, '_wp_attachment_is_custom_background', true ); 2347 2348 if ( ! empty( $meta_background ) && $meta_background === $stylesheet ) { 2349 $media_states[] = __( 'Background Image' ); 2350 2351 $background_image = get_background_image(); 2352 if ( $background_image && wp_get_attachment_url( $post->ID ) === $background_image ) { 2353 $media_states[] = __( 'Current Background Image' ); 2354 } 2355 } 2356 } 2357 2358 if ( (int) get_option( 'site_icon' ) === $post->ID ) { 2359 $media_states[] = __( 'Site Icon' ); 2360 } 2361 2362 if ( (int) get_theme_mod( 'custom_logo' ) === $post->ID ) { 2363 $media_states[] = __( 'Logo' ); 2364 } 2365 2366 /** 2367 * Filters the default media display states for items in the Media list table. 2368 * 2369 * @since 3.2.0 2370 * @since 4.8.0 Added the `$post` parameter. 2371 * 2372 * @param string[] $media_states An array of media states. Default 'Header Image', 2373 * 'Background Image', 'Site Icon', 'Logo'. 2374 * @param WP_Post $post The current attachment object. 2375 */ 2376 return apply_filters( 'display_media_states', $media_states, $post ); 2377 } 2378 2379 /** 2380 * Tests support for compressing JavaScript from PHP. 2381 * 2382 * Outputs JavaScript that tests if compression from PHP works as expected 2383 * and sets an option with the result. Has no effect when the current user 2384 * is not an administrator. To run the test again the option 'can_compress_scripts' 2385 * has to be deleted. 2386 * 2387 * @since 2.8.0 2388 */ 2389 function compression_test() { 2390 ?> 2391 <script type="text/javascript"> 2392 var compressionNonce = <?php echo wp_json_encode( wp_create_nonce( 'update_can_compress_scripts' ) ); ?>; 2393 var testCompression = { 2394 get : function(test) { 2395 var x; 2396 if ( window.XMLHttpRequest ) { 2397 x = new XMLHttpRequest(); 2398 } else { 2399 try{x=new ActiveXObject('Msxml2.XMLHTTP');}catch(e){try{x=new ActiveXObject('Microsoft.XMLHTTP');}catch(e){};} 2400 } 2401 2402 if (x) { 2403 x.onreadystatechange = function() { 2404 var r, h; 2405 if ( x.readyState == 4 ) { 2406 r = x.responseText.substr(0, 18); 2407 h = x.getResponseHeader('Content-Encoding'); 2408 testCompression.check(r, h, test); 2409 } 2410 }; 2411 2412 x.open('GET', ajaxurl + '?action=wp-compression-test&test='+test+'&_ajax_nonce='+compressionNonce+'&'+(new Date()).getTime(), true); 2413 x.send(''); 2414 } 2415 }, 2416 2417 check : function(r, h, test) { 2418 if ( ! r && ! test ) 2419 this.get(1); 2420 2421 if ( 1 == test ) { 2422 if ( h && ( h.match(/deflate/i) || h.match(/gzip/i) ) ) 2423 this.get('no'); 2424 else 2425 this.get(2); 2426 2427 return; 2428 } 2429 2430 if ( 2 == test ) { 2431 if ( '"wpCompressionTest' === r ) 2432 this.get('yes'); 2433 else 2434 this.get('no'); 2435 } 2436 } 2437 }; 2438 testCompression.check(); 2439 </script> 2440 <?php 2441 } 2442 2443 /** 2444 * Echoes a submit button, with provided text and appropriate class(es). 2445 * 2446 * @since 3.1.0 2447 * 2448 * @see get_submit_button() 2449 * 2450 * @param string $text The text of the button (defaults to 'Save Changes') 2451 * @param string $type Optional. The type and CSS class(es) of the button. Core values 2452 * include 'primary', 'small', and 'large'. Default 'primary'. 2453 * @param string $name The HTML name of the submit button. Defaults to "submit". If no 2454 * id attribute is given in $other_attributes below, $name will be 2455 * used as the button's id. 2456 * @param bool $wrap True if the output button should be wrapped in a paragraph tag, 2457 * false otherwise. Defaults to true. 2458 * @param array|string $other_attributes Other attributes that should be output with the button, mapping 2459 * attributes to their values, such as setting tabindex to 1, etc. 2460 * These key/value attribute pairs will be output as attribute="value", 2461 * where attribute is the key. Other attributes can also be provided 2462 * as a string such as 'tabindex="1"', though the array format is 2463 * preferred. Default null. 2464 */ 2465 function submit_button( $text = null, $type = 'primary', $name = 'submit', $wrap = true, $other_attributes = null ) { 2466 echo get_submit_button( $text, $type, $name, $wrap, $other_attributes ); 2467 } 2468 2469 /** 2470 * Returns a submit button, with provided text and appropriate class. 2471 * 2472 * @since 3.1.0 2473 * 2474 * @param string $text Optional. The text of the button. Default 'Save Changes'. 2475 * @param string $type Optional. The type and CSS class(es) of the button. Core values 2476 * include 'primary', 'small', and 'large'. Default 'primary large'. 2477 * @param string $name Optional. The HTML name of the submit button. Defaults to "submit". 2478 * If no id attribute is given in $other_attributes below, `$name` will 2479 * be used as the button's id. Default 'submit'. 2480 * @param bool $wrap Optional. True if the output button should be wrapped in a paragraph 2481 * tag, false otherwise. Default true. 2482 * @param array|string $other_attributes Optional. Other attributes that should be output with the button, 2483 * mapping attributes to their values, such as `array( 'tabindex' => '1' )`. 2484 * These attributes will be output as `attribute="value"`, such as 2485 * `tabindex="1"`. Other attributes can also be provided as a string such 2486 * as `tabindex="1"`, though the array format is typically cleaner. 2487 * Default empty. 2488 * @return string Submit button HTML. 2489 */ 2490 function get_submit_button( $text = '', $type = 'primary large', $name = 'submit', $wrap = true, $other_attributes = '' ) { 2491 if ( ! is_array( $type ) ) { 2492 $type = explode( ' ', $type ); 2493 } 2494 2495 $button_shorthand = array( 'primary', 'small', 'large' ); 2496 $classes = array( 'button' ); 2497 2498 foreach ( $type as $t ) { 2499 if ( 'secondary' === $t || 'button-secondary' === $t ) { 2500 continue; 2501 } 2502 2503 $classes[] = in_array( $t, $button_shorthand, true ) ? 'button-' . $t : $t; 2504 } 2505 2506 // Remove empty items, remove duplicate items, and finally build a string. 2507 $class = implode( ' ', array_unique( array_filter( $classes ) ) ); 2508 2509 $text = $text ? $text : __( 'Save Changes' ); 2510 2511 // Default the id attribute to $name unless an id was specifically provided in $other_attributes. 2512 $id = $name; 2513 if ( is_array( $other_attributes ) && isset( $other_attributes['id'] ) ) { 2514 $id = $other_attributes['id']; 2515 unset( $other_attributes['id'] ); 2516 } 2517 2518 $attributes = ''; 2519 if ( is_array( $other_attributes ) ) { 2520 foreach ( $other_attributes as $attribute => $value ) { 2521 $attributes .= $attribute . '="' . esc_attr( $value ) . '" '; // Trailing space is important. 2522 } 2523 } elseif ( ! empty( $other_attributes ) ) { // Attributes provided as a string. 2524 $attributes = $other_attributes; 2525 } 2526 2527 // Don't output empty name and id attributes. 2528 $name_attr = $name ? ' name="' . esc_attr( $name ) . '"' : ''; 2529 $id_attr = $id ? ' id="' . esc_attr( $id ) . '"' : ''; 2530 2531 $button = '<input type="submit"' . $name_attr . $id_attr . ' class="' . esc_attr( $class ); 2532 $button .= '" value="' . esc_attr( $text ) . '" ' . $attributes . ' />'; 2533 2534 if ( $wrap ) { 2535 $button = '<p class="submit">' . $button . '</p>'; 2536 } 2537 2538 return $button; 2539 } 2540 2541 /** 2542 * @global bool $is_IE 2543 */ 2544 function _wp_admin_html_begin() { 2545 global $is_IE; 2546 2547 $admin_html_class = ( is_admin_bar_showing() ) ? 'wp-toolbar' : ''; 2548 2549 if ( $is_IE ) { 2550 header( 'X-UA-Compatible: IE=edge' ); 2551 } 2552 2553 ?> 2554 <!DOCTYPE html> 2555 <html class="<?php echo $admin_html_class; ?>" 2556 <?php 2557 /** 2558 * Fires inside the HTML tag in the admin header. 2559 * 2560 * @since 2.2.0 2561 */ 2562 do_action( 'admin_xml_ns' ); 2563 2564 language_attributes(); 2565 ?> 2566 > 2567 <head> 2568 <meta http-equiv="Content-Type" content="<?php bloginfo( 'html_type' ); ?>; charset=<?php echo get_option( 'blog_charset' ); ?>" /> 2569 <?php 2570 } 2571 2572 /** 2573 * Converts a screen string to a screen object. 2574 * 2575 * @since 3.0.0 2576 * 2577 * @param string $hook_name The hook name (also known as the hook suffix) used to determine the screen. 2578 * @return WP_Screen Screen object. 2579 */ 2580 function convert_to_screen( $hook_name ) { 2581 if ( ! class_exists( 'WP_Screen' ) ) { 2582 _doing_it_wrong( 2583 'convert_to_screen(), add_meta_box()', 2584 sprintf( 2585 /* translators: 1: wp-admin/includes/template.php, 2: add_meta_box(), 3: add_meta_boxes */ 2586 __( 'Likely direct inclusion of %1$s in order to use %2$s. This is very wrong. Hook the %2$s call into the %3$s action instead.' ), 2587 '<code>wp-admin/includes/template.php</code>', 2588 '<code>add_meta_box()</code>', 2589 '<code>add_meta_boxes</code>' 2590 ), 2591 '3.3.0' 2592 ); 2593 return (object) array( 2594 'id' => '_invalid', 2595 'base' => '_are_belong_to_us', 2596 ); 2597 } 2598 2599 return WP_Screen::get( $hook_name ); 2600 } 2601 2602 /** 2603 * Output the HTML for restoring the post data from DOM storage 2604 * 2605 * @since 3.6.0 2606 * @access private 2607 */ 2608 function _local_storage_notice() { 2609 ?> 2610 <div id="local-storage-notice" class="hidden notice is-dismissible"> 2611 <p class="local-restore"> 2612 <?php _e( 'The backup of this post in your browser is different from the version below.' ); ?> 2613 <button type="button" class="button restore-backup"><?php _e( 'Restore the backup' ); ?></button> 2614 </p> 2615 <p class="help"> 2616 <?php _e( 'This will replace the current editor content with the last backup version. You can use undo and redo in the editor to get the old content back or to return to the restored version.' ); ?> 2617 </p> 2618 </div> 2619 <?php 2620 } 2621 2622 /** 2623 * Outputs a HTML element with a star rating for a given rating. 2624 * 2625 * Outputs a HTML element with the star rating exposed on a 0..5 scale in 2626 * half star increments (ie. 1, 1.5, 2 stars). Optionally, if specified, the 2627 * number of ratings may also be displayed by passing the $number parameter. 2628 * 2629 * @since 3.8.0 2630 * @since 4.4.0 Introduced the `echo` parameter. 2631 * 2632 * @param array $args { 2633 * Optional. Array of star ratings arguments. 2634 * 2635 * @type int|float $rating The rating to display, expressed in either a 0.5 rating increment, 2636 * or percentage. Default 0. 2637 * @type string $type Format that the $rating is in. Valid values are 'rating' (default), 2638 * or, 'percent'. Default 'rating'. 2639 * @type int $number The number of ratings that makes up this rating. Default 0. 2640 * @type bool $echo Whether to echo the generated markup. False to return the markup instead 2641 * of echoing it. Default true. 2642 * } 2643 * @return string Star rating HTML. 2644 */ 2645 function wp_star_rating( $args = array() ) { 2646 $defaults = array( 2647 'rating' => 0, 2648 'type' => 'rating', 2649 'number' => 0, 2650 'echo' => true, 2651 ); 2652 $parsed_args = wp_parse_args( $args, $defaults ); 2653 2654 // Non-English decimal places when the $rating is coming from a string. 2655 $rating = (float) str_replace( ',', '.', $parsed_args['rating'] ); 2656 2657 // Convert percentage to star rating, 0..5 in .5 increments. 2658 if ( 'percent' === $parsed_args['type'] ) { 2659 $rating = round( $rating / 10, 0 ) / 2; 2660 } 2661 2662 // Calculate the number of each type of star needed. 2663 $full_stars = floor( $rating ); 2664 $half_stars = ceil( $rating - $full_stars ); 2665 $empty_stars = 5 - $full_stars - $half_stars; 2666 2667 if ( $parsed_args['number'] ) { 2668 /* translators: 1: The rating, 2: The number of ratings. */ 2669 $format = _n( '%1$s rating based on %2$s rating', '%1$s rating based on %2$s ratings', $parsed_args['number'] ); 2670 $title = sprintf( $format, number_format_i18n( $rating, 1 ), number_format_i18n( $parsed_args['number'] ) ); 2671 } else { 2672 /* translators: %s: The rating. */ 2673 $title = sprintf( __( '%s rating' ), number_format_i18n( $rating, 1 ) ); 2674 } 2675 2676 $output = '<div class="star-rating">'; 2677 $output .= '<span class="screen-reader-text">' . $title . '</span>'; 2678 $output .= str_repeat( '<div class="star star-full" aria-hidden="true"></div>', $full_stars ); 2679 $output .= str_repeat( '<div class="star star-half" aria-hidden="true"></div>', $half_stars ); 2680 $output .= str_repeat( '<div class="star star-empty" aria-hidden="true"></div>', $empty_stars ); 2681 $output .= '</div>'; 2682 2683 if ( $parsed_args['echo'] ) { 2684 echo $output; 2685 } 2686 2687 return $output; 2688 } 2689 2690 /** 2691 * Outputs a notice when editing the page for posts (internal use only). 2692 * 2693 * @ignore 2694 * @since 4.2.0 2695 */ 2696 function _wp_posts_page_notice() { 2697 printf( 2698 '<div class="notice notice-warning inline"><p>%s</p></div>', 2699 __( 'You are currently editing the page that shows your latest posts.' ) 2700 ); 2701 } 2702 2703 /** 2704 * Outputs a notice when editing the page for posts in the block editor (internal use only). 2705 * 2706 * @ignore 2707 * @since 5.8.0 2708 */ 2709 function _wp_block_editor_posts_page_notice() { 2710 wp_add_inline_script( 2711 'wp-notices', 2712 sprintf( 2713 'wp.data.dispatch( "core/notices" ).createWarningNotice( "%s", { isDismissible: false } )', 2714 __( 'You are currently editing the page that shows your latest posts.' ) 2715 ), 2716 'after' 2717 ); 2718 }
title
Description
Body
title
Description
Body
title
Description
Body
title
Body
| Generated: Tue Jul 1 01:00:02 2025 | Cross-referenced by PHPXref 0.7.1 |