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