[ Index ]

PHP Cross Reference of WordPress Trunk (Updated Daily)

Search

title

Body

[close]

/wp-admin/includes/ -> template.php (source)

   1  <?php
   2  /**
   3   * Template WordPress Administration API.
   4   *
   5   * A Big Mess. Also some neat functions that are nicely written.
   6   *
   7   * @package WordPress
   8   * @subpackage Administration
   9   */
  10  
  11  /** Walker_Category_Checklist class */
  12  require_once  ABSPATH . 'wp-admin/includes/class-walker-category-checklist.php';
  13  
  14  /** WP_Internal_Pointers class */
  15  require_once  ABSPATH . 'wp-admin/includes/class-wp-internal-pointers.php';
  16  
  17  //
  18  // Category Checklists.
  19  //
  20  
  21  /**
  22   * Outputs an unordered list of checkbox input elements labeled with category names.
  23   *
  24   * @since 2.5.1
  25   *
  26   * @see wp_terms_checklist()
  27   *
  28   * @param int         $post_id              Optional. Post to generate a categories checklist for. Default 0.
  29   *                                          $selected_cats must not be an array. Default 0.
  30   * @param int         $descendants_and_self Optional. ID of the category to output along with its descendants.
  31   *                                          Default 0.
  32   * @param int[]|false $selected_cats        Optional. Array of category IDs to mark as checked. Default false.
  33   * @param int[]|false $popular_cats         Optional. Array of category IDs to receive the "popular-category" class.
  34   *                                          Default false.
  35   * @param Walker      $walker               Optional. Walker object to use to build the output.
  36   *                                          Default is a Walker_Category_Checklist instance.
  37   * @param bool        $checked_ontop        Optional. Whether to move checked items out of the hierarchy and to
  38   *                                          the top of the list. Default true.
  39   */
  40  function wp_category_checklist( $post_id = 0, $descendants_and_self = 0, $selected_cats = false, $popular_cats = false, $walker = null, $checked_ontop = true ) {
  41      wp_terms_checklist(
  42          $post_id,
  43          array(
  44              'taxonomy'             => 'category',
  45              'descendants_and_self' => $descendants_and_self,
  46              'selected_cats'        => $selected_cats,
  47              'popular_cats'         => $popular_cats,
  48              'walker'               => $walker,
  49              'checked_ontop'        => $checked_ontop,
  50          )
  51      );
  52  }
  53  
  54  /**
  55   * Outputs an unordered list of checkbox input elements labelled with term names.
  56   *
  57   * Taxonomy-independent version of wp_category_checklist().
  58   *
  59   * @since 3.0.0
  60   * @since 4.4.0 Introduced the `$echo` argument.
  61   *
  62   * @param int          $post_id Optional. Post ID. Default 0.
  63   * @param array|string $args {
  64   *     Optional. Array or string of arguments for generating a terms checklist. Default empty array.
  65   *
  66   *     @type int    $descendants_and_self ID of the category to output along with its descendants.
  67   *                                        Default 0.
  68   *     @type int[]  $selected_cats        Array of category IDs to mark as checked. Default false.
  69   *     @type int[]  $popular_cats         Array of category IDs to receive the "popular-category" class.
  70   *                                        Default false.
  71   *     @type Walker $walker               Walker object to use to build the output. Default empty which
  72   *                                        results in a Walker_Category_Checklist instance being used.
  73   *     @type string $taxonomy             Taxonomy to generate the checklist for. Default 'category'.
  74   *     @type bool   $checked_ontop        Whether to move checked items out of the hierarchy and to
  75   *                                        the top of the list. Default true.
  76   *     @type bool   $echo                 Whether to echo the generated markup. False to return the markup instead
  77   *                                        of echoing it. Default true.
  78   * }
  79   * @return string HTML list of input elements.
  80   */
  81  function wp_terms_checklist( $post_id = 0, $args = array() ) {
  82      $defaults = array(
  83          'descendants_and_self' => 0,
  84          'selected_cats'        => false,
  85          'popular_cats'         => false,
  86          'walker'               => null,
  87          'taxonomy'             => 'category',
  88          'checked_ontop'        => true,
  89          'echo'                 => true,
  90      );
  91  
  92      /**
  93       * Filters the taxonomy terms checklist arguments.
  94       *
  95       * @since 3.4.0
  96       *
  97       * @see wp_terms_checklist()
  98       *
  99       * @param array|string $args    An array or string of arguments.
 100       * @param int          $post_id The post ID.
 101       */
 102      $params = apply_filters( 'wp_terms_checklist_args', $args, $post_id );
 103  
 104      $parsed_args = wp_parse_args( $params, $defaults );
 105  
 106      if ( empty( $parsed_args['walker'] ) || ! ( $parsed_args['walker'] instanceof Walker ) ) {
 107          $walker = new Walker_Category_Checklist();
 108      } else {
 109          $walker = $parsed_args['walker'];
 110      }
 111  
 112      $taxonomy             = $parsed_args['taxonomy'];
 113      $descendants_and_self = (int) $parsed_args['descendants_and_self'];
 114  
 115      $args = array( 'taxonomy' => $taxonomy );
 116  
 117      $tax              = get_taxonomy( $taxonomy );
 118      $args['disabled'] = ! current_user_can( $tax->cap->assign_terms );
 119  
 120      $args['list_only'] = ! empty( $parsed_args['list_only'] );
 121  
 122      if ( is_array( $parsed_args['selected_cats'] ) ) {
 123          $args['selected_cats'] = array_map( 'intval', $parsed_args['selected_cats'] );
 124      } elseif ( $post_id ) {
 125          $args['selected_cats'] = wp_get_object_terms( $post_id, $taxonomy, array_merge( $args, array( 'fields' => 'ids' ) ) );
 126      } else {
 127          $args['selected_cats'] = array();
 128      }
 129  
 130      if ( is_array( $parsed_args['popular_cats'] ) ) {
 131          $args['popular_cats'] = array_map( 'intval', $parsed_args['popular_cats'] );
 132      } else {
 133          $args['popular_cats'] = get_terms(
 134              array(
 135                  'taxonomy'     => $taxonomy,
 136                  'fields'       => 'ids',
 137                  'orderby'      => 'count',
 138                  'order'        => 'DESC',
 139                  'number'       => 10,
 140                  'hierarchical' => false,
 141              )
 142          );
 143      }
 144  
 145      if ( $descendants_and_self ) {
 146          $categories = (array) get_terms(
 147              array(
 148                  'taxonomy'     => $taxonomy,
 149                  'child_of'     => $descendants_and_self,
 150                  'hierarchical' => 0,
 151                  'hide_empty'   => 0,
 152              )
 153          );
 154          $self       = get_term( $descendants_and_self, $taxonomy );
 155          array_unshift( $categories, $self );
 156      } else {
 157          $categories = (array) get_terms(
 158              array(
 159                  'taxonomy' => $taxonomy,
 160                  'get'      => 'all',
 161              )
 162          );
 163      }
 164  
 165      $output = '';
 166  
 167      if ( $parsed_args['checked_ontop'] ) {
 168          /*
 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   */
 211  function 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   */
 267  function 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   */
 311  function 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   */
 413  function 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   */
 555  function 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   */
 585  function 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   */
 631  function _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   */
 692  function 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( '&mdash; Select &mdash;' ); ?></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   */
 807  function 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   */
 909  function 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   */
 934  function 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( '&nbsp;', $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   */
 973  function 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   */
 998  function 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   */
1075  function 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   */
1183  function 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   */
1244  function _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   */
1299  function 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   */
1484  function 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   */
1534  function 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   */
1632  function 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   */
1710  function 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   */
1761  function 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   */
1811  function 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   */
1865  function 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   */
1912  function 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   */
1980  function 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   */
2027  function 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   */
2074  function 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   */
2092  function _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   */
2108  function _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   */
2125  function 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' ); ?> &rsaquo; <?php echo $title; ?> &#8212; <?php _e( 'WordPress' ); ?></title>
2138      <?php
2139      wp_enqueue_style( 'colors' );
2140      ?>
2141  <script type="text/javascript">
2142  addLoadEvent = function(func){if(typeof jQuery!=='undefined')jQuery(function(){func();});else if(typeof wpOnload!=='function'){wpOnload=func;}else{var oldonload=wpOnload;wpOnload=function(){oldonload();func();}}};
2143  function tb_close(){var win=window.dialogArguments||opener||parent||top;win.tb_remove();}
2144  var 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(){
2192  var c = document.body.className;
2193  c = c.replace(/no-js/, 'js');
2194  document.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   */
2205  function 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   */
2248  function _post_states( $post, $display = true ) {
2249      $post_states        = get_post_states( $post );
2250      $post_states_string = '';
2251  
2252      if ( ! empty( $post_states ) ) {
2253          $state_count = count( $post_states );
2254  
2255          $i = 0;
2256  
2257          $post_states_string .= ' &mdash; ';
2258  
2259          foreach ( $post_states as $state ) {
2260              ++$i;
2261  
2262              $separator = ( $i < $state_count ) ? ', ' : '';
2263  
2264              $post_states_string .= "<span class='post-state'>{$state}{$separator}</span>";
2265          }
2266      }
2267  
2268      if ( $display ) {
2269          echo $post_states_string;
2270      }
2271  
2272      return $post_states_string;
2273  }
2274  
2275  /**
2276   * Retrieves an array of post states from a post.
2277   *
2278   * @since 5.3.0
2279   *
2280   * @param WP_Post $post The post to retrieve states for.
2281   * @return string[] Array of post state labels keyed by their state.
2282   */
2283  function get_post_states( $post ) {
2284      $post_states = array();
2285  
2286      if ( isset( $_REQUEST['post_status'] ) ) {
2287          $post_status = $_REQUEST['post_status'];
2288      } else {
2289          $post_status = '';
2290      }
2291  
2292      if ( ! empty( $post->post_password ) ) {
2293          $post_states['protected'] = _x( 'Password protected', 'post status' );
2294      }
2295  
2296      if ( 'private' === $post->post_status && 'private' !== $post_status ) {
2297          $post_states['private'] = _x( 'Private', 'post status' );
2298      }
2299  
2300      if ( 'draft' === $post->post_status ) {
2301          if ( get_post_meta( $post->ID, '_customize_changeset_uuid', true ) ) {
2302              $post_states[] = __( 'Customization Draft' );
2303          } elseif ( 'draft' !== $post_status ) {
2304              $post_states['draft'] = _x( 'Draft', 'post status' );
2305          }
2306      } elseif ( 'trash' === $post->post_status && get_post_meta( $post->ID, '_customize_changeset_uuid', true ) ) {
2307          $post_states[] = _x( 'Customization Draft', 'post status' );
2308      }
2309  
2310      if ( 'pending' === $post->post_status && 'pending' !== $post_status ) {
2311          $post_states['pending'] = _x( 'Pending', 'post status' );
2312      }
2313  
2314      if ( is_sticky( $post->ID ) ) {
2315          $post_states['sticky'] = _x( 'Sticky', 'post status' );
2316      }
2317  
2318      if ( 'future' === $post->post_status ) {
2319          $post_states['scheduled'] = _x( 'Scheduled', 'post status' );
2320      }
2321  
2322      if ( 'page' === get_option( 'show_on_front' ) ) {
2323          if ( (int) get_option( 'page_on_front' ) === $post->ID ) {
2324              $post_states['page_on_front'] = _x( 'Front Page', 'page label' );
2325          }
2326  
2327          if ( (int) get_option( 'page_for_posts' ) === $post->ID ) {
2328              $post_states['page_for_posts'] = _x( 'Posts Page', 'page label' );
2329          }
2330      }
2331  
2332      if ( (int) get_option( 'wp_page_for_privacy_policy' ) === $post->ID ) {
2333          $post_states['page_for_privacy_policy'] = _x( 'Privacy Policy Page', 'page label' );
2334      }
2335  
2336      /**
2337       * Filters the default post display states used in the posts list table.
2338       *
2339       * @since 2.8.0
2340       * @since 3.6.0 Added the `$post` parameter.
2341       * @since 5.5.0 Also applied in the Customizer context. If any admin functions
2342       *              are used within the filter, their existence should be checked
2343       *              with `function_exists()` before being used.
2344       *
2345       * @param string[] $post_states An array of post display states.
2346       * @param WP_Post  $post        The current post object.
2347       */
2348      return apply_filters( 'display_post_states', $post_states, $post );
2349  }
2350  
2351  /**
2352   * Outputs the attachment media states as HTML.
2353   *
2354   * @since 3.2.0
2355   * @since 5.6.0 Added the `$display` parameter and a return value.
2356   *
2357   * @param WP_Post $post    The attachment post to retrieve states for.
2358   * @param bool    $display Optional. Whether to display the post states as an HTML string.
2359   *                         Default true.
2360   * @return string Media states string.
2361   */
2362  function _media_states( $post, $display = true ) {
2363      $media_states        = get_media_states( $post );
2364      $media_states_string = '';
2365  
2366      if ( ! empty( $media_states ) ) {
2367          $state_count = count( $media_states );
2368  
2369          $i = 0;
2370  
2371          $media_states_string .= ' &mdash; ';
2372  
2373          foreach ( $media_states as $state ) {
2374              ++$i;
2375  
2376              $separator = ( $i < $state_count ) ? ', ' : '';
2377  
2378              $media_states_string .= "<span class='post-state'>{$state}{$separator}</span>";
2379          }
2380      }
2381  
2382      if ( $display ) {
2383          echo $media_states_string;
2384      }
2385  
2386      return $media_states_string;
2387  }
2388  
2389  /**
2390   * Retrieves an array of media states from an attachment.
2391   *
2392   * @since 5.6.0
2393   *
2394   * @param WP_Post $post The attachment to retrieve states for.
2395   * @return string[] Array of media state labels keyed by their state.
2396   */
2397  function get_media_states( $post ) {
2398      static $header_images;
2399  
2400      $media_states = array();
2401      $stylesheet   = get_option( 'stylesheet' );
2402  
2403      if ( current_theme_supports( 'custom-header' ) ) {
2404          $meta_header = get_post_meta( $post->ID, '_wp_attachment_is_custom_header', true );
2405  
2406          if ( is_random_header_image() ) {
2407              if ( ! isset( $header_images ) ) {
2408                  $header_images = wp_list_pluck( get_uploaded_header_images(), 'attachment_id' );
2409              }
2410  
2411              if ( $meta_header === $stylesheet && in_array( $post->ID, $header_images, true ) ) {
2412                  $media_states[] = __( 'Header Image' );
2413              }
2414          } else {
2415              $header_image = get_header_image();
2416  
2417              // Display "Header Image" if the image was ever used as a header image.
2418              if ( ! empty( $meta_header ) && $meta_header === $stylesheet && wp_get_attachment_url( $post->ID ) !== $header_image ) {
2419                  $media_states[] = __( 'Header Image' );
2420              }
2421  
2422              // Display "Current Header Image" if the image is currently the header image.
2423              if ( $header_image && wp_get_attachment_url( $post->ID ) === $header_image ) {
2424                  $media_states[] = __( 'Current Header Image' );
2425              }
2426          }
2427  
2428          if ( get_theme_support( 'custom-header', 'video' ) && has_header_video() ) {
2429              $mods = get_theme_mods();
2430              if ( isset( $mods['header_video'] ) && $post->ID === $mods['header_video'] ) {
2431                  $media_states[] = __( 'Current Header Video' );
2432              }
2433          }
2434      }
2435  
2436      if ( current_theme_supports( 'custom-background' ) ) {
2437          $meta_background = get_post_meta( $post->ID, '_wp_attachment_is_custom_background', true );
2438  
2439          if ( ! empty( $meta_background ) && $meta_background === $stylesheet ) {
2440              $media_states[] = __( 'Background Image' );
2441  
2442              $background_image = get_background_image();
2443              if ( $background_image && wp_get_attachment_url( $post->ID ) === $background_image ) {
2444                  $media_states[] = __( 'Current Background Image' );
2445              }
2446          }
2447      }
2448  
2449      if ( (int) get_option( 'site_icon' ) === $post->ID ) {
2450          $media_states[] = __( 'Site Icon' );
2451      }
2452  
2453      if ( (int) get_theme_mod( 'custom_logo' ) === $post->ID ) {
2454          $media_states[] = __( 'Logo' );
2455      }
2456  
2457      /**
2458       * Filters the default media display states for items in the Media list table.
2459       *
2460       * @since 3.2.0
2461       * @since 4.8.0 Added the `$post` parameter.
2462       *
2463       * @param string[] $media_states An array of media states. Default 'Header Image',
2464       *                               'Background Image', 'Site Icon', 'Logo'.
2465       * @param WP_Post  $post         The current attachment object.
2466       */
2467      return apply_filters( 'display_media_states', $media_states, $post );
2468  }
2469  
2470  /**
2471   * Tests support for compressing JavaScript from PHP.
2472   *
2473   * Outputs JavaScript that tests if compression from PHP works as expected
2474   * and sets an option with the result. Has no effect when the current user
2475   * is not an administrator. To run the test again the option 'can_compress_scripts'
2476   * has to be deleted.
2477   *
2478   * @since 2.8.0
2479   */
2480  function compression_test() {
2481      ?>
2482      <script type="text/javascript">
2483      var compressionNonce = <?php echo wp_json_encode( wp_create_nonce( 'update_can_compress_scripts' ), JSON_HEX_TAG | JSON_UNESCAPED_SLASHES ); ?>;
2484      var testCompression = {
2485          get : function(test) {
2486              var x;
2487              if ( window.XMLHttpRequest ) {
2488                  x = new XMLHttpRequest();
2489              } else {
2490                  try{x=new ActiveXObject('Msxml2.XMLHTTP');}catch(e){try{x=new ActiveXObject('Microsoft.XMLHTTP');}catch(e){};}
2491              }
2492  
2493              if (x) {
2494                  x.onreadystatechange = function() {
2495                      var r, h;
2496                      if ( x.readyState == 4 ) {
2497                          r = x.responseText.substr(0, 18);
2498                          h = x.getResponseHeader('Content-Encoding');
2499                          testCompression.check(r, h, test);
2500                      }
2501                  };
2502  
2503                  x.open('GET', ajaxurl + '?action=wp-compression-test&test='+test+'&_ajax_nonce='+compressionNonce+'&'+(new Date()).getTime(), true);
2504                  x.send('');
2505              }
2506          },
2507  
2508          check : function(r, h, test) {
2509              if ( ! r && ! test )
2510                  this.get(1);
2511  
2512              if ( 1 == test ) {
2513                  if ( h && ( h.match(/deflate/i) || h.match(/gzip/i) ) )
2514                      this.get('no');
2515                  else
2516                      this.get(2);
2517  
2518                  return;
2519              }
2520  
2521              if ( 2 == test ) {
2522                  if ( '"wpCompressionTest' === r )
2523                      this.get('yes');
2524                  else
2525                      this.get('no');
2526              }
2527          }
2528      };
2529      testCompression.check();
2530      </script>
2531      <?php
2532  }
2533  
2534  /**
2535   * Echoes a submit button, with provided text and appropriate class(es).
2536   *
2537   * @since 3.1.0
2538   *
2539   * @see get_submit_button()
2540   *
2541   * @param string       $text             Optional. The text of the button. Defaults to 'Save Changes'.
2542   * @param string       $type             Optional. The type and CSS class(es) of the button. Core values
2543   *                                       include 'primary', 'small', and 'large'. Default 'primary'.
2544   * @param string       $name             Optional. The HTML name of the submit button. If no `id` attribute
2545   *                                       is given in the `$other_attributes` parameter, `$name` will be used
2546   *                                       as the button's `id`. Default 'submit'.
2547   * @param bool         $wrap             Optional. True if the output button should be wrapped in a paragraph tag,
2548   *                                       false otherwise. Default true.
2549   * @param array|string $other_attributes Optional. Other attributes that should be output with the button,
2550   *                                       mapping attributes to their values, e.g. `array( 'id' => 'search-submit' )`.
2551   *                                       These key/value attribute pairs will be output as `attribute="value"`,
2552   *                                       where attribute is the key. Attributes can also be provided as a string,
2553   *                                       e.g. `id="search-submit"`, though the array format is generally preferred.
2554   *                                       Default empty string.
2555   */
2556  function submit_button( $text = '', $type = 'primary', $name = 'submit', $wrap = true, $other_attributes = '' ) {
2557      echo get_submit_button( $text, $type, $name, $wrap, $other_attributes );
2558  }
2559  
2560  /**
2561   * Returns a submit button, with provided text and appropriate class.
2562   *
2563   * @since 3.1.0
2564   *
2565   * @param string       $text             Optional. The text of the button. Defaults to 'Save Changes'.
2566   * @param string       $type             Optional. The type and CSS class(es) of the button. Core values
2567   *                                       include 'primary', 'small', and 'large'. Default 'primary large'.
2568   * @param string       $name             Optional. The HTML name of the submit button. If no `id` attribute
2569   *                                       is given in the `$other_attributes` parameter, `$name` will be used
2570   *                                       as the button's `id`. Default 'submit'.
2571   * @param bool         $wrap             Optional. True if the output button should be wrapped in a paragraph tag,
2572   *                                       false otherwise. Default true.
2573   * @param array|string $other_attributes Optional. Other attributes that should be output with the button,
2574   *                                       mapping attributes to their values, e.g. `array( 'id' => 'search-submit' )`.
2575   *                                       These key/value attribute pairs will be output as `attribute="value"`,
2576   *                                       where attribute is the key. Attributes can also be provided as a string,
2577   *                                       e.g. `id="search-submit"`, though the array format is generally preferred.
2578   *                                       Default empty string.
2579   * @return string Submit button HTML.
2580   */
2581  function get_submit_button( $text = '', $type = 'primary large', $name = 'submit', $wrap = true, $other_attributes = '' ) {
2582      if ( ! is_array( $type ) ) {
2583          $type = explode( ' ', $type );
2584      }
2585  
2586      $button_shorthand = array( 'primary', 'small', 'large' );
2587      $classes          = array( 'button' );
2588  
2589      foreach ( $type as $t ) {
2590          if ( 'secondary' === $t || 'button-secondary' === $t ) {
2591              continue;
2592          }
2593  
2594          $classes[] = in_array( $t, $button_shorthand, true ) ? 'button-' . $t : $t;
2595      }
2596  
2597      // Remove empty items, remove duplicate items, and finally build a string.
2598      $class = implode( ' ', array_unique( array_filter( $classes ) ) );
2599  
2600      $text = $text ? $text : __( 'Save Changes' );
2601  
2602      // Default the id attribute to $name unless an id was specifically provided in $other_attributes.
2603      $id = $name;
2604      if ( is_array( $other_attributes ) && isset( $other_attributes['id'] ) ) {
2605          $id = $other_attributes['id'];
2606          unset( $other_attributes['id'] );
2607      }
2608  
2609      $attributes = '';
2610      if ( is_array( $other_attributes ) ) {
2611          foreach ( $other_attributes as $attribute => $value ) {
2612              $attributes .= $attribute . '="' . esc_attr( $value ) . '" '; // Trailing space is important.
2613          }
2614      } elseif ( ! empty( $other_attributes ) ) { // Attributes provided as a string.
2615          $attributes = $other_attributes;
2616      }
2617  
2618      // Don't output empty name and id attributes.
2619      $name_attr = $name ? ' name="' . esc_attr( $name ) . '"' : '';
2620      $id_attr   = $id ? ' id="' . esc_attr( $id ) . '"' : '';
2621  
2622      $button  = '<input type="submit"' . $name_attr . $id_attr . ' class="' . esc_attr( $class );
2623      $button .= '" value="' . esc_attr( $text ) . '" ' . $attributes . ' />';
2624  
2625      if ( $wrap ) {
2626          $button = '<p class="submit">' . $button . '</p>';
2627      }
2628  
2629      return $button;
2630  }
2631  
2632  /**
2633   * Prints out the beginning of the admin HTML header.
2634   *
2635   * @since 3.3.0
2636   *
2637   * @global bool $is_IE
2638   */
2639  function _wp_admin_html_begin() {
2640      global $is_IE;
2641  
2642      $admin_html_class = ( is_admin_bar_showing() ) ? 'wp-toolbar' : '';
2643  
2644      if ( $is_IE ) {
2645          header( 'X-UA-Compatible: IE=edge' );
2646      }
2647  
2648      ?>
2649  <!DOCTYPE html>
2650  <html class="<?php echo $admin_html_class; ?>"
2651      <?php
2652      /**
2653       * Fires inside the HTML tag in the admin header.
2654       *
2655       * @since 2.2.0
2656       */
2657      do_action( 'admin_xml_ns' );
2658  
2659      language_attributes();
2660      ?>
2661  >
2662  <head>
2663  <meta http-equiv="Content-Type" content="<?php bloginfo( 'html_type' ); ?>; charset=<?php echo get_option( 'blog_charset' ); ?>" />
2664      <?php
2665  }
2666  
2667  /**
2668   * Converts a screen string to a screen object.
2669   *
2670   * @since 3.0.0
2671   *
2672   * @param string $hook_name The hook name (also known as the hook suffix) used to determine the screen.
2673   * @return WP_Screen Screen object.
2674   */
2675  function convert_to_screen( $hook_name ) {
2676      if ( ! class_exists( 'WP_Screen' ) ) {
2677          _doing_it_wrong(
2678              'convert_to_screen(), add_meta_box()',
2679              sprintf(
2680                  /* translators: 1: wp-admin/includes/template.php, 2: add_meta_box(), 3: add_meta_boxes */
2681                  __( '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.' ),
2682                  '<code>wp-admin/includes/template.php</code>',
2683                  '<code>add_meta_box()</code>',
2684                  '<code>add_meta_boxes</code>'
2685              ),
2686              '3.3.0'
2687          );
2688          return (object) array(
2689              'id'   => '_invalid',
2690              'base' => '_are_belong_to_us',
2691          );
2692      }
2693  
2694      return WP_Screen::get( $hook_name );
2695  }
2696  
2697  /**
2698   * Outputs the HTML for restoring the post data from DOM storage
2699   *
2700   * @since 3.6.0
2701   * @access private
2702   */
2703  function _local_storage_notice() {
2704      $local_storage_message  = '<p class="local-restore">';
2705      $local_storage_message .= __( 'The backup of this post in your browser is different from the version below.' );
2706      $local_storage_message .= '<button type="button" class="button restore-backup">' . __( 'Restore the backup' ) . '</button></p>';
2707      $local_storage_message .= '<p class="help">';
2708      $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.' );
2709      $local_storage_message .= '</p>';
2710  
2711      wp_admin_notice(
2712          $local_storage_message,
2713          array(
2714              'id'                 => 'local-storage-notice',
2715              'additional_classes' => array( 'hidden' ),
2716              'dismissible'        => true,
2717              'paragraph_wrap'     => false,
2718          )
2719      );
2720  }
2721  
2722  /**
2723   * Outputs a HTML element with a star rating for a given rating.
2724   *
2725   * Outputs a HTML element with the star rating exposed on a 0..5 scale in
2726   * half star increments (ie. 1, 1.5, 2 stars). Optionally, if specified, the
2727   * number of ratings may also be displayed by passing the $number parameter.
2728   *
2729   * @since 3.8.0
2730   * @since 4.4.0 Introduced the `echo` parameter.
2731   *
2732   * @param array $args {
2733   *     Optional. Array of star ratings arguments.
2734   *
2735   *     @type int|float $rating The rating to display, expressed in either a 0.5 rating increment,
2736   *                             or percentage. Default 0.
2737   *     @type string    $type   Format that the $rating is in. Valid values are 'rating' (default),
2738   *                             or, 'percent'. Default 'rating'.
2739   *     @type int       $number The number of ratings that makes up this rating. Default 0.
2740   *     @type bool      $echo   Whether to echo the generated markup. False to return the markup instead
2741   *                             of echoing it. Default true.
2742   * }
2743   * @return string Star rating HTML.
2744   */
2745  function wp_star_rating( $args = array() ) {
2746      $defaults    = array(
2747          'rating' => 0,
2748          'type'   => 'rating',
2749          'number' => 0,
2750          'echo'   => true,
2751      );
2752      $parsed_args = wp_parse_args( $args, $defaults );
2753  
2754      // Non-English decimal places when the $rating is coming from a string.
2755      $rating = (float) str_replace( ',', '.', $parsed_args['rating'] );
2756  
2757      // Convert percentage to star rating, 0..5 in .5 increments.
2758      if ( 'percent' === $parsed_args['type'] ) {
2759          $rating = round( $rating / 10, 0 ) / 2;
2760      }
2761  
2762      // Calculate the number of each type of star needed.
2763      $full_stars  = floor( $rating );
2764      $half_stars  = ceil( $rating - $full_stars );
2765      $empty_stars = 5 - $full_stars - $half_stars;
2766  
2767      if ( $parsed_args['number'] ) {
2768          /* translators: Hidden accessibility text. 1: The rating, 2: The number of ratings. */
2769          $format = _n( '%1$s rating based on %2$s rating', '%1$s rating based on %2$s ratings', $parsed_args['number'] );
2770          $title  = sprintf( $format, number_format_i18n( $rating, 1 ), number_format_i18n( $parsed_args['number'] ) );
2771      } else {
2772          /* translators: Hidden accessibility text. %s: The rating. */
2773          $title = sprintf( __( '%s rating' ), number_format_i18n( $rating, 1 ) );
2774      }
2775  
2776      $output  = '<div class="star-rating">';
2777      $output .= '<span class="screen-reader-text">' . $title . '</span>';
2778      $output .= str_repeat( '<div class="star star-full" aria-hidden="true"></div>', $full_stars );
2779      $output .= str_repeat( '<div class="star star-half" aria-hidden="true"></div>', $half_stars );
2780      $output .= str_repeat( '<div class="star star-empty" aria-hidden="true"></div>', $empty_stars );
2781      $output .= '</div>';
2782  
2783      if ( $parsed_args['echo'] ) {
2784          echo $output;
2785      }
2786  
2787      return $output;
2788  }
2789  
2790  /**
2791   * Outputs a notice when editing the page for posts (internal use only).
2792   *
2793   * @ignore
2794   * @since 4.2.0
2795   */
2796  function _wp_posts_page_notice() {
2797      wp_admin_notice(
2798          __( 'You are currently editing the page that shows your latest posts.' ),
2799          array(
2800              'type'               => 'warning',
2801              'additional_classes' => array( 'inline' ),
2802          )
2803      );
2804  }
2805  
2806  /**
2807   * Outputs a notice when editing the page for posts in the block editor (internal use only).
2808   *
2809   * @ignore
2810   * @since 5.8.0
2811   */
2812  function _wp_block_editor_posts_page_notice() {
2813      wp_add_inline_script(
2814          'wp-notices',
2815          sprintf(
2816              'wp.data.dispatch( "core/notices" ).createWarningNotice( "%s", { isDismissible: false } )',
2817              __( 'You are currently editing the page that shows your latest posts.' )
2818          ),
2819          'after'
2820      );
2821  }


Generated : Tue Sep 9 08:20:04 2025 Cross-referenced by PHPXref