[Summary view] [Print] [Text view]

   1  <?php
   2  /**
   3   * WordPress Administration Media API.
   4   *
   5   * @package WordPress
   6   * @subpackage Administration
   7   */
   8  
   9  /**
  10   * Defines the default media upload tabs.
  11   *
  12   * @since 2.5.0
  13   *
  14   * @return string[] Default tabs.
  15   */
  16  function media_upload_tabs() {
  17      $_default_tabs = array(
  18          'type'     => __( 'From Computer' ), // Handler action suffix => tab text.
  19          'type_url' => __( 'From URL' ),
  20          'gallery'  => __( 'Gallery' ),
  21          'library'  => __( 'Media Library' ),
  22      );
  23  
  24      /**
  25       * Filters the available tabs in the legacy (pre-3.5.0) media popup.
  26       *
  27       * @since 2.5.0
  28       *
  29       * @param string[] $_default_tabs An array of media tabs.
  30       */
  31      return apply_filters( 'media_upload_tabs', $_default_tabs );
  32  }
  33  
  34  /**
  35   * Adds the gallery tab back to the tabs array if post has image attachments.
  36   *
  37   * @since 2.5.0
  38   *
  39   * @global wpdb $wpdb WordPress database abstraction object.
  40   *
  41   * @param array $tabs
  42   * @return array $tabs with gallery if post has image attachment
  43   */
  44  function update_gallery_tab( $tabs ) {
  45      global $wpdb;
  46  
  47      if ( ! isset( $_REQUEST['post_id'] ) ) {
  48          unset( $tabs['gallery'] );
  49          return $tabs;
  50      }
  51  
  52      $post_id = (int) $_REQUEST['post_id'];
  53  
  54      if ( $post_id ) {
  55          $attachments = (int) $wpdb->get_var( $wpdb->prepare( "SELECT count(*) FROM $wpdb->posts WHERE post_type = 'attachment' AND post_status != 'trash' AND post_parent = %d", $post_id ) );
  56      }
  57  
  58      if ( empty( $attachments ) ) {
  59          unset( $tabs['gallery'] );
  60          return $tabs;
  61      }
  62  
  63      /* translators: %s: Number of attachments. */
  64      $tabs['gallery'] = sprintf( __( 'Gallery (%s)' ), "<span id='attachments-count'>$attachments</span>" );
  65  
  66      return $tabs;
  67  }
  68  
  69  /**
  70   * Outputs the legacy media upload tabs UI.
  71   *
  72   * @since 2.5.0
  73   *
  74   * @global string $redir_tab
  75   */
  76  function the_media_upload_tabs() {
  77      global $redir_tab;
  78      $tabs    = media_upload_tabs();
  79      $default = 'type';
  80  
  81      if ( ! empty( $tabs ) ) {
  82          echo "<ul id='sidemenu'>\n";
  83  
  84          if ( isset( $redir_tab ) && array_key_exists( $redir_tab, $tabs ) ) {
  85              $current = $redir_tab;
  86          } elseif ( isset( $_GET['tab'] ) && array_key_exists( $_GET['tab'], $tabs ) ) {
  87              $current = $_GET['tab'];
  88          } else {
  89              /** This filter is documented in wp-admin/media-upload.php */
  90              $current = apply_filters( 'media_upload_default_tab', $default );
  91          }
  92  
  93          foreach ( $tabs as $callback => $text ) {
  94              $class = '';
  95  
  96              if ( $current == $callback ) {
  97                  $class = " class='current'";
  98              }
  99  
 100              $href = add_query_arg(
 101                  array(
 102                      'tab'            => $callback,
 103                      's'              => false,
 104                      'paged'          => false,
 105                      'post_mime_type' => false,
 106                      'm'              => false,
 107                  )
 108              );
 109              $link = "<a href='" . esc_url( $href ) . "'$class>$text</a>";
 110              echo "\t<li id='" . esc_attr( "tab-$callback" ) . "'>$link</li>\n";
 111          }
 112  
 113          echo "</ul>\n";
 114      }
 115  }
 116  
 117  /**
 118   * Retrieves the image HTML to send to the editor.
 119   *
 120   * @since 2.5.0
 121   *
 122   * @param int          $id      Image attachment ID.
 123   * @param string       $caption Image caption.
 124   * @param string       $title   Image title attribute.
 125   * @param string       $align   Image CSS alignment property.
 126   * @param string       $url     Optional. Image src URL. Default empty.
 127   * @param bool|string  $rel     Optional. Value for rel attribute or whether to add a default value. Default false.
 128   * @param string|int[] $size    Optional. Image size. Accepts any registered image size name, or an array of
 129   *                              width and height values in pixels (in that order). Default 'medium'.
 130   * @param string       $alt     Optional. Image alt attribute. Default empty.
 131   * @return string The HTML output to insert into the editor.
 132   */
 133  function get_image_send_to_editor( $id, $caption, $title, $align, $url = '', $rel = false, $size = 'medium', $alt = '' ) {
 134  
 135      $html = get_image_tag( $id, $alt, '', $align, $size );
 136  
 137      if ( $rel ) {
 138          if ( is_string( $rel ) ) {
 139              $rel = ' rel="' . esc_attr( $rel ) . '"';
 140          } else {
 141              $rel = ' rel="attachment wp-att-' . (int) $id . '"';
 142          }
 143      } else {
 144          $rel = '';
 145      }
 146  
 147      if ( $url ) {
 148          $html = '<a href="' . esc_url( $url ) . '"' . $rel . '>' . $html . '</a>';
 149      }
 150  
 151      /**
 152       * Filters the image HTML markup to send to the editor when inserting an image.
 153       *
 154       * @since 2.5.0
 155       * @since 5.6.0 The `$rel` parameter was added.
 156       *
 157       * @param string       $html    The image HTML markup to send.
 158       * @param int          $id      The attachment ID.
 159       * @param string       $caption The image caption.
 160       * @param string       $title   The image title.
 161       * @param string       $align   The image alignment.
 162       * @param string       $url     The image source URL.
 163       * @param string|int[] $size    Requested image size. Can be any registered image size name, or
 164       *                              an array of width and height values in pixels (in that order).
 165       * @param string       $alt     The image alternative, or alt, text.
 166       * @param string       $rel     The image rel attribute.
 167       */
 168      $html = apply_filters( 'image_send_to_editor', $html, $id, $caption, $title, $align, $url, $size, $alt, $rel );
 169  
 170      return $html;
 171  }
 172  
 173  /**
 174   * Adds image shortcode with caption to editor.
 175   *
 176   * @since 2.6.0
 177   *
 178   * @param string  $html    The image HTML markup to send.
 179   * @param int     $id      Image attachment ID.
 180   * @param string  $caption Image caption.
 181   * @param string  $title   Image title attribute (not used).
 182   * @param string  $align   Image CSS alignment property.
 183   * @param string  $url     Image source URL (not used).
 184   * @param string  $size    Image size (not used).
 185   * @param string  $alt     Image `alt` attribute (not used).
 186   * @return string The image HTML markup with caption shortcode.
 187   */
 188  function image_add_caption( $html, $id, $caption, $title, $align, $url, $size, $alt = '' ) {
 189  
 190      /**
 191       * Filters the caption text.
 192       *
 193       * Note: If the caption text is empty, the caption shortcode will not be appended
 194       * to the image HTML when inserted into the editor.
 195       *
 196       * Passing an empty value also prevents the {@see 'image_add_caption_shortcode'}
 197       * Filters from being evaluated at the end of image_add_caption().
 198       *
 199       * @since 4.1.0
 200       *
 201       * @param string $caption The original caption text.
 202       * @param int    $id      The attachment ID.
 203       */
 204      $caption = apply_filters( 'image_add_caption_text', $caption, $id );
 205  
 206      /**
 207       * Filters whether to disable captions.
 208       *
 209       * Prevents image captions from being appended to image HTML when inserted into the editor.
 210       *
 211       * @since 2.6.0
 212       *
 213       * @param bool $bool Whether to disable appending captions. Returning true from the filter
 214       *                   will disable captions. Default empty string.
 215       */
 216      if ( empty( $caption ) || apply_filters( 'disable_captions', '' ) ) {
 217          return $html;
 218      }
 219  
 220      $id = ( 0 < (int) $id ) ? 'attachment_' . $id : '';
 221  
 222      if ( ! preg_match( '/width=["\']([0-9]+)/', $html, $matches ) ) {
 223          return $html;
 224      }
 225  
 226      $width = $matches[1];
 227  
 228      $caption = str_replace( array( "\r\n", "\r" ), "\n", $caption );
 229      $caption = preg_replace_callback( '/<[a-zA-Z0-9]+(?: [^<>]+>)*/', '_cleanup_image_add_caption', $caption );
 230  
 231      // Convert any remaining line breaks to <br />.
 232      $caption = preg_replace( '/[ \n\t]*\n[ \t]*/', '<br />', $caption );
 233  
 234      $html = preg_replace( '/(class=["\'][^\'"]*)align(none|left|right|center)\s?/', '$1', $html );
 235      if ( empty( $align ) ) {
 236          $align = 'none';
 237      }
 238  
 239      $shcode = '[caption id="' . $id . '" align="align' . $align . '" width="' . $width . '"]' . $html . ' ' . $caption . '[/caption]';
 240  
 241      /**
 242       * Filters the image HTML markup including the caption shortcode.
 243       *
 244       * @since 2.6.0
 245       *
 246       * @param string $shcode The image HTML markup with caption shortcode.
 247       * @param string $html   The image HTML markup.
 248       */
 249      return apply_filters( 'image_add_caption_shortcode', $shcode, $html );
 250  }
 251  
 252  /**
 253   * Private preg_replace callback used in image_add_caption().
 254   *
 255   * @access private
 256   * @since 3.4.0
 257   *
 258   * @param array $matches Single regex match.
 259   * @return string Cleaned up HTML for caption.
 260   */
 261  function _cleanup_image_add_caption( $matches ) {
 262      // Remove any line breaks from inside the tags.
 263      return preg_replace( '/[\r\n\t]+/', ' ', $matches[0] );
 264  }
 265  
 266  /**
 267   * Adds image HTML to editor.
 268   *
 269   * @since 2.5.0
 270   *
 271   * @param string $html
 272   */
 273  function media_send_to_editor( $html ) {
 274      ?>
 275      <script type="text/javascript">
 276      var win = window.dialogArguments || opener || parent || top;
 277      win.send_to_editor( <?php echo wp_json_encode( $html ); ?> );
 278      </script>
 279      <?php
 280      exit;
 281  }
 282  
 283  /**
 284   * Saves a file submitted from a POST request and create an attachment post for it.
 285   *
 286   * @since 2.5.0
 287   *
 288   * @param string $file_id   Index of the `$_FILES` array that the file was sent.
 289   * @param int    $post_id   The post ID of a post to attach the media item to. Required, but can
 290   *                          be set to 0, creating a media item that has no relationship to a post.
 291   * @param array  $post_data Optional. Overwrite some of the attachment.
 292   * @param array  $overrides Optional. Override the wp_handle_upload() behavior.
 293   * @return int|WP_Error ID of the attachment or a WP_Error object on failure.
 294   */
 295  function media_handle_upload( $file_id, $post_id, $post_data = array(), $overrides = array( 'test_form' => false ) ) {
 296      $time = current_time( 'mysql' );
 297      $post = get_post( $post_id );
 298  
 299      if ( $post ) {
 300          // The post date doesn't usually matter for pages, so don't backdate this upload.
 301          if ( 'page' !== $post->post_type && substr( $post->post_date, 0, 4 ) > 0 ) {
 302              $time = $post->post_date;
 303          }
 304      }
 305  
 306      $file = wp_handle_upload( $_FILES[ $file_id ], $overrides, $time );
 307  
 308      if ( isset( $file['error'] ) ) {
 309          return new WP_Error( 'upload_error', $file['error'] );
 310      }
 311  
 312      $name = $_FILES[ $file_id ]['name'];
 313      $ext  = pathinfo( $name, PATHINFO_EXTENSION );
 314      $name = wp_basename( $name, ".$ext" );
 315  
 316      $url     = $file['url'];
 317      $type    = $file['type'];
 318      $file    = $file['file'];
 319      $title   = sanitize_text_field( $name );
 320      $content = '';
 321      $excerpt = '';
 322  
 323      if ( preg_match( '#^audio#', $type ) ) {
 324          $meta = wp_read_audio_metadata( $file );
 325  
 326          if ( ! empty( $meta['title'] ) ) {
 327              $title = $meta['title'];
 328          }
 329  
 330          if ( ! empty( $title ) ) {
 331  
 332              if ( ! empty( $meta['album'] ) && ! empty( $meta['artist'] ) ) {
 333                  /* translators: 1: Audio track title, 2: Album title, 3: Artist name. */
 334                  $content .= sprintf( __( '"%1$s" from %2$s by %3$s.' ), $title, $meta['album'], $meta['artist'] );
 335              } elseif ( ! empty( $meta['album'] ) ) {
 336                  /* translators: 1: Audio track title, 2: Album title. */
 337                  $content .= sprintf( __( '"%1$s" from %2$s.' ), $title, $meta['album'] );
 338              } elseif ( ! empty( $meta['artist'] ) ) {
 339                  /* translators: 1: Audio track title, 2: Artist name. */
 340                  $content .= sprintf( __( '"%1$s" by %2$s.' ), $title, $meta['artist'] );
 341              } else {
 342                  /* translators: %s: Audio track title. */
 343                  $content .= sprintf( __( '"%s".' ), $title );
 344              }
 345          } elseif ( ! empty( $meta['album'] ) ) {
 346  
 347              if ( ! empty( $meta['artist'] ) ) {
 348                  /* translators: 1: Audio album title, 2: Artist name. */
 349                  $content .= sprintf( __( '%1$s by %2$s.' ), $meta['album'], $meta['artist'] );
 350              } else {
 351                  $content .= $meta['album'] . '.';
 352              }
 353          } elseif ( ! empty( $meta['artist'] ) ) {
 354  
 355              $content .= $meta['artist'] . '.';
 356  
 357          }
 358  
 359          if ( ! empty( $meta['year'] ) ) {
 360              /* translators: Audio file track information. %d: Year of audio track release. */
 361              $content .= ' ' . sprintf( __( 'Released: %d.' ), $meta['year'] );
 362          }
 363  
 364          if ( ! empty( $meta['track_number'] ) ) {
 365              $track_number = explode( '/', $meta['track_number'] );
 366  
 367              if ( is_numeric( $track_number[0] ) ) {
 368                  if ( isset( $track_number[1] ) && is_numeric( $track_number[1] ) ) {
 369                      $content .= ' ' . sprintf(
 370                          /* translators: Audio file track information. 1: Audio track number, 2: Total audio tracks. */
 371                          __( 'Track %1$s of %2$s.' ),
 372                          number_format_i18n( $track_number[0] ),
 373                          number_format_i18n( $track_number[1] )
 374                      );
 375                  } else {
 376                      $content .= ' ' . sprintf(
 377                          /* translators: Audio file track information. %s: Audio track number. */
 378                          __( 'Track %s.' ),
 379                          number_format_i18n( $track_number[0] )
 380                      );
 381                  }
 382              }
 383          }
 384  
 385          if ( ! empty( $meta['genre'] ) ) {
 386              /* translators: Audio file genre information. %s: Audio genre name. */
 387              $content .= ' ' . sprintf( __( 'Genre: %s.' ), $meta['genre'] );
 388          }
 389  
 390          // Use image exif/iptc data for title and caption defaults if possible.
 391      } elseif ( str_starts_with( $type, 'image/' ) ) {
 392          $image_meta = wp_read_image_metadata( $file );
 393  
 394          if ( $image_meta ) {
 395              if ( trim( $image_meta['title'] ) && ! is_numeric( sanitize_title( $image_meta['title'] ) ) ) {
 396                  $title = $image_meta['title'];
 397              }
 398  
 399              if ( trim( $image_meta['caption'] ) ) {
 400                  $excerpt = $image_meta['caption'];
 401              }
 402          }
 403      }
 404  
 405      // Construct the attachment array.
 406      $attachment = array_merge(
 407          array(
 408              'post_mime_type' => $type,
 409              'guid'           => $url,
 410              'post_parent'    => $post_id,
 411              'post_title'     => $title,
 412              'post_content'   => $content,
 413              'post_excerpt'   => $excerpt,
 414          ),
 415          $post_data
 416      );
 417  
 418      // This should never be set as it would then overwrite an existing attachment.
 419      unset( $attachment['ID'] );
 420  
 421      // Save the data.
 422      $attachment_id = wp_insert_attachment( $attachment, $file, $post_id, true );
 423  
 424      if ( ! is_wp_error( $attachment_id ) ) {
 425          /*
 426           * Set a custom header with the attachment_id.
 427           * Used by the browser/client to resume creating image sub-sizes after a PHP fatal error.
 428           */
 429          if ( ! headers_sent() ) {
 430              header( 'X-WP-Upload-Attachment-ID: ' . $attachment_id );
 431          }
 432  
 433          /*
 434           * The image sub-sizes are created during wp_generate_attachment_metadata().
 435           * This is generally slow and may cause timeouts or out of memory errors.
 436           */
 437          wp_update_attachment_metadata( $attachment_id, wp_generate_attachment_metadata( $attachment_id, $file ) );
 438      }
 439  
 440      return $attachment_id;
 441  }
 442  
 443  /**
 444   * Handles a side-loaded file in the same way as an uploaded file is handled by media_handle_upload().
 445   *
 446   * @since 2.6.0
 447   * @since 5.3.0 The `$post_id` parameter was made optional.
 448   *
 449   * @param string[] $file_array Array that represents a `$_FILES` upload array.
 450   * @param int      $post_id    Optional. The post ID the media is associated with.
 451   * @param string   $desc       Optional. Description of the side-loaded file. Default null.
 452   * @param array    $post_data  Optional. Post data to override. Default empty array.
 453   * @return int|WP_Error The ID of the attachment or a WP_Error on failure.
 454   */
 455  function media_handle_sideload( $file_array, $post_id = 0, $desc = null, $post_data = array() ) {
 456      $overrides = array( 'test_form' => false );
 457  
 458      if ( isset( $post_data['post_date'] ) && substr( $post_data['post_date'], 0, 4 ) > 0 ) {
 459          $time = $post_data['post_date'];
 460      } else {
 461          $post = get_post( $post_id );
 462          if ( $post && substr( $post->post_date, 0, 4 ) > 0 ) {
 463              $time = $post->post_date;
 464          } else {
 465              $time = current_time( 'mysql' );
 466          }
 467      }
 468  
 469      $file = wp_handle_sideload( $file_array, $overrides, $time );
 470  
 471      if ( isset( $file['error'] ) ) {
 472          return new WP_Error( 'upload_error', $file['error'] );
 473      }
 474  
 475      $url     = $file['url'];
 476      $type    = $file['type'];
 477      $file    = $file['file'];
 478      $title   = preg_replace( '/\.[^.]+$/', '', wp_basename( $file ) );
 479      $content = '';
 480  
 481      // Use image exif/iptc data for title and caption defaults if possible.
 482      $image_meta = wp_read_image_metadata( $file );
 483  
 484      if ( $image_meta ) {
 485          if ( trim( $image_meta['title'] ) && ! is_numeric( sanitize_title( $image_meta['title'] ) ) ) {
 486              $title = $image_meta['title'];
 487          }
 488  
 489          if ( trim( $image_meta['caption'] ) ) {
 490              $content = $image_meta['caption'];
 491          }
 492      }
 493  
 494      if ( isset( $desc ) ) {
 495          $title = $desc;
 496      }
 497  
 498      // Construct the attachment array.
 499      $attachment = array_merge(
 500          array(
 501              'post_mime_type' => $type,
 502              'guid'           => $url,
 503              'post_parent'    => $post_id,
 504              'post_title'     => $title,
 505              'post_content'   => $content,
 506          ),
 507          $post_data
 508      );
 509  
 510      // This should never be set as it would then overwrite an existing attachment.
 511      unset( $attachment['ID'] );
 512  
 513      // Save the attachment metadata.
 514      $attachment_id = wp_insert_attachment( $attachment, $file, $post_id, true );
 515  
 516      if ( ! is_wp_error( $attachment_id ) ) {
 517          wp_update_attachment_metadata( $attachment_id, wp_generate_attachment_metadata( $attachment_id, $file ) );
 518      }
 519  
 520      return $attachment_id;
 521  }
 522  
 523  /**
 524   * Outputs the iframe to display the media upload page.
 525   *
 526   * @since 2.5.0
 527   * @since 5.3.0 Formalized the existing and already documented `...$args` parameter
 528   *              by adding it to the function signature.
 529   *
 530   * @global string $body_id
 531   *
 532   * @param callable $content_func Function that outputs the content.
 533   * @param mixed    ...$args      Optional additional parameters to pass to the callback function when it's called.
 534   */
 535  function wp_iframe( $content_func, ...$args ) {
 536      global $body_id;
 537  
 538      _wp_admin_html_begin();
 539      ?>
 540      <title><?php bloginfo( 'name' ); ?> &rsaquo; <?php _e( 'Uploads' ); ?> &#8212; <?php _e( 'WordPress' ); ?></title>
 541      <?php
 542  
 543      wp_enqueue_style( 'colors' );
 544      // Check callback name for 'media'.
 545      if (
 546          ( is_array( $content_func ) && ! empty( $content_func[1] ) && str_starts_with( (string) $content_func[1], 'media' ) ) ||
 547          ( ! is_array( $content_func ) && str_starts_with( $content_func, 'media' ) )
 548      ) {
 549          wp_enqueue_style( 'deprecated-media' );
 550      }
 551  
 552      ?>
 553      <script type="text/javascript">
 554      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();}}};
 555      var ajaxurl = '<?php echo esc_js( admin_url( 'admin-ajax.php', 'relative' ) ); ?>', pagenow = 'media-upload-popup', adminpage = 'media-upload-popup',
 556      isRtl = <?php echo (int) is_rtl(); ?>;
 557      </script>
 558      <?php
 559      /** This action is documented in wp-admin/admin-header.php */
 560      do_action( 'admin_enqueue_scripts', 'media-upload-popup' );
 561  
 562      /**
 563       * Fires when admin styles enqueued for the legacy (pre-3.5.0) media upload popup are printed.
 564       *
 565       * @since 2.9.0
 566       */
 567      do_action( 'admin_print_styles-media-upload-popup' );  // phpcs:ignore WordPress.NamingConventions.ValidHookName.UseUnderscores
 568  
 569      /** This action is documented in wp-admin/admin-header.php */
 570      do_action( 'admin_print_styles' );
 571  
 572      /**
 573       * Fires when admin scripts enqueued for the legacy (pre-3.5.0) media upload popup are printed.
 574       *
 575       * @since 2.9.0
 576       */
 577      do_action( 'admin_print_scripts-media-upload-popup' ); // phpcs:ignore WordPress.NamingConventions.ValidHookName.UseUnderscores
 578  
 579      /** This action is documented in wp-admin/admin-header.php */
 580      do_action( 'admin_print_scripts' );
 581  
 582      /**
 583       * Fires when scripts enqueued for the admin header for the legacy (pre-3.5.0)
 584       * media upload popup are printed.
 585       *
 586       * @since 2.9.0
 587       */
 588      do_action( 'admin_head-media-upload-popup' ); // phpcs:ignore WordPress.NamingConventions.ValidHookName.UseUnderscores
 589  
 590      /** This action is documented in wp-admin/admin-header.php */
 591      do_action( 'admin_head' );
 592  
 593      if ( is_string( $content_func ) ) {
 594          /**
 595           * Fires in the admin header for each specific form tab in the legacy
 596           * (pre-3.5.0) media upload popup.
 597           *
 598           * The dynamic portion of the hook name, `$content_func`, refers to the form
 599           * callback for the media upload type.
 600           *
 601           * @since 2.5.0
 602           */
 603          do_action( "admin_head_{$content_func}" );
 604      }
 605  
 606      $body_id_attr = '';
 607  
 608      if ( isset( $body_id ) ) {
 609          $body_id_attr = ' id="' . $body_id . '"';
 610      }
 611  
 612      ?>
 613      </head>
 614      <body<?php echo $body_id_attr; ?> class="wp-core-ui no-js">
 615      <script type="text/javascript">
 616      document.body.className = document.body.className.replace('no-js', 'js');
 617      </script>
 618      <?php
 619  
 620      call_user_func_array( $content_func, $args );
 621  
 622      /** This action is documented in wp-admin/admin-footer.php */
 623      do_action( 'admin_print_footer_scripts' );
 624  
 625      ?>
 626      <script type="text/javascript">if(typeof wpOnload==='function')wpOnload();</script>
 627      </body>
 628      </html>
 629      <?php
 630  }
 631  
 632  /**
 633   * Adds the media button to the editor.
 634   *
 635   * @since 2.5.0
 636   *
 637   * @global int $post_ID
 638   *
 639   * @param string $editor_id
 640   */
 641  function media_buttons( $editor_id = 'content' ) {
 642      static $instance = 0;
 643      ++$instance;
 644  
 645      $post = get_post();
 646  
 647      if ( ! $post && ! empty( $GLOBALS['post_ID'] ) ) {
 648          $post = $GLOBALS['post_ID'];
 649      }
 650  
 651      wp_enqueue_media( array( 'post' => $post ) );
 652  
 653      $img = '<span class="wp-media-buttons-icon"></span> ';
 654  
 655      $id_attribute = 1 === $instance ? ' id="insert-media-button"' : '';
 656  
 657      printf(
 658          '<button type="button"%s class="button insert-media add_media" data-editor="%s">%s</button>',
 659          $id_attribute,
 660          esc_attr( $editor_id ),
 661          $img . __( 'Add Media' )
 662      );
 663  
 664      /**
 665       * Filters the legacy (pre-3.5.0) media buttons.
 666       *
 667       * Use {@see 'media_buttons'} action instead.
 668       *
 669       * @since 2.5.0
 670       * @deprecated 3.5.0 Use {@see 'media_buttons'} action instead.
 671       *
 672       * @param string $string Media buttons context. Default empty.
 673       */
 674      $legacy_filter = apply_filters_deprecated( 'media_buttons_context', array( '' ), '3.5.0', 'media_buttons' );
 675  
 676      if ( $legacy_filter ) {
 677          // #WP22559. Close <a> if a plugin started by closing <a> to open their own <a> tag.
 678          if ( 0 === stripos( trim( $legacy_filter ), '</a>' ) ) {
 679              $legacy_filter .= '</a>';
 680          }
 681          echo $legacy_filter;
 682      }
 683  }
 684  
 685  /**
 686   * Retrieves the upload iframe source URL.
 687   *
 688   * @since 3.0.0
 689   *
 690   * @global int $post_ID
 691   *
 692   * @param string $type    Media type.
 693   * @param int    $post_id Post ID.
 694   * @param string $tab     Media upload tab.
 695   * @return string Upload iframe source URL.
 696   */
 697  function get_upload_iframe_src( $type = null, $post_id = null, $tab = null ) {
 698      global $post_ID;
 699  
 700      if ( empty( $post_id ) ) {
 701          $post_id = $post_ID;
 702      }
 703  
 704      $upload_iframe_src = add_query_arg( 'post_id', (int) $post_id, admin_url( 'media-upload.php' ) );
 705  
 706      if ( $type && 'media' !== $type ) {
 707          $upload_iframe_src = add_query_arg( 'type', $type, $upload_iframe_src );
 708      }
 709  
 710      if ( ! empty( $tab ) ) {
 711          $upload_iframe_src = add_query_arg( 'tab', $tab, $upload_iframe_src );
 712      }
 713  
 714      /**
 715       * Filters the upload iframe source URL for a specific media type.
 716       *
 717       * The dynamic portion of the hook name, `$type`, refers to the type
 718       * of media uploaded.
 719       *
 720       * Possible hook names include:
 721       *
 722       *  - `image_upload_iframe_src`
 723       *  - `media_upload_iframe_src`
 724       *
 725       * @since 3.0.0
 726       *
 727       * @param string $upload_iframe_src The upload iframe source URL.
 728       */
 729      $upload_iframe_src = apply_filters( "{$type}_upload_iframe_src", $upload_iframe_src );
 730  
 731      return add_query_arg( 'TB_iframe', true, $upload_iframe_src );
 732  }
 733  
 734  /**
 735   * Handles form submissions for the legacy media uploader.
 736   *
 737   * @since 2.5.0
 738   *
 739   * @return null|array|void Array of error messages keyed by attachment ID, null or void on success.
 740   */
 741  function media_upload_form_handler() {
 742      check_admin_referer( 'media-form' );
 743  
 744      $errors = null;
 745  
 746      if ( isset( $_POST['send'] ) ) {
 747          $keys    = array_keys( $_POST['send'] );
 748          $send_id = (int) reset( $keys );
 749      }
 750  
 751      if ( ! empty( $_POST['attachments'] ) ) {
 752          foreach ( $_POST['attachments'] as $attachment_id => $attachment ) {
 753              $post  = get_post( $attachment_id, ARRAY_A );
 754              $_post = $post;
 755  
 756              if ( ! current_user_can( 'edit_post', $attachment_id ) ) {
 757                  continue;
 758              }
 759  
 760              if ( isset( $attachment['post_content'] ) ) {
 761                  $post['post_content'] = $attachment['post_content'];
 762              }
 763  
 764              if ( isset( $attachment['post_title'] ) ) {
 765                  $post['post_title'] = $attachment['post_title'];
 766              }
 767  
 768              if ( isset( $attachment['post_excerpt'] ) ) {
 769                  $post['post_excerpt'] = $attachment['post_excerpt'];
 770              }
 771  
 772              if ( isset( $attachment['menu_order'] ) ) {
 773                  $post['menu_order'] = $attachment['menu_order'];
 774              }
 775  
 776              if ( isset( $send_id ) && $attachment_id == $send_id ) {
 777                  if ( isset( $attachment['post_parent'] ) ) {
 778                      $post['post_parent'] = $attachment['post_parent'];
 779                  }
 780              }
 781  
 782              /**
 783               * Filters the attachment fields to be saved.
 784               *
 785               * @since 2.5.0
 786               *
 787               * @see wp_get_attachment_metadata()
 788               *
 789               * @param array $post       An array of post data.
 790               * @param array $attachment An array of attachment metadata.
 791               */
 792              $post = apply_filters( 'attachment_fields_to_save', $post, $attachment );
 793  
 794              if ( isset( $attachment['image_alt'] ) ) {
 795                  $image_alt = wp_unslash( $attachment['image_alt'] );
 796  
 797                  if ( get_post_meta( $attachment_id, '_wp_attachment_image_alt', true ) !== $image_alt ) {
 798                      $image_alt = wp_strip_all_tags( $image_alt, true );
 799  
 800                      // update_post_meta() expects slashed.
 801                      update_post_meta( $attachment_id, '_wp_attachment_image_alt', wp_slash( $image_alt ) );
 802                  }
 803              }
 804  
 805              if ( isset( $post['errors'] ) ) {
 806                  $errors[ $attachment_id ] = $post['errors'];
 807                  unset( $post['errors'] );
 808              }
 809  
 810              if ( $post != $_post ) {
 811                  wp_update_post( $post );
 812              }
 813  
 814              foreach ( get_attachment_taxonomies( $post ) as $t ) {
 815                  if ( isset( $attachment[ $t ] ) ) {
 816                      wp_set_object_terms( $attachment_id, array_map( 'trim', preg_split( '/,+/', $attachment[ $t ] ) ), $t, false );
 817                  }
 818              }
 819          }
 820      }
 821  
 822      if ( isset( $_POST['insert-gallery'] ) || isset( $_POST['update-gallery'] ) ) {
 823          ?>
 824          <script type="text/javascript">
 825          var win = window.dialogArguments || opener || parent || top;
 826          win.tb_remove();
 827          </script>
 828          <?php
 829  
 830          exit;
 831      }
 832  
 833      if ( isset( $send_id ) ) {
 834          $attachment = wp_unslash( $_POST['attachments'][ $send_id ] );
 835          $html       = isset( $attachment['post_title'] ) ? $attachment['post_title'] : '';
 836  
 837          if ( ! empty( $attachment['url'] ) ) {
 838              $rel = '';
 839  
 840              if ( str_contains( $attachment['url'], 'attachment_id' ) || get_attachment_link( $send_id ) === $attachment['url'] ) {
 841                  $rel = " rel='attachment wp-att-" . esc_attr( $send_id ) . "'";
 842              }
 843  
 844              $html = "<a href='{$attachment['url']}'$rel>$html</a>";
 845          }
 846  
 847          /**
 848           * Filters the HTML markup for a media item sent to the editor.
 849           *
 850           * @since 2.5.0
 851           *
 852           * @see wp_get_attachment_metadata()
 853           *
 854           * @param string $html       HTML markup for a media item sent to the editor.
 855           * @param int    $send_id    The first key from the $_POST['send'] data.
 856           * @param array  $attachment Array of attachment metadata.
 857           */
 858          $html = apply_filters( 'media_send_to_editor', $html, $send_id, $attachment );
 859  
 860          return media_send_to_editor( $html );
 861      }
 862  
 863      return $errors;
 864  }
 865  
 866  /**
 867   * Handles the process of uploading media.
 868   *
 869   * @since 2.5.0
 870   *
 871   * @return null|string
 872   */
 873  function wp_media_upload_handler() {
 874      $errors = array();
 875      $id     = 0;
 876  
 877      if ( isset( $_POST['html-upload'] ) && ! empty( $_FILES ) ) {
 878          check_admin_referer( 'media-form' );
 879          // Upload File button was clicked.
 880          $id = media_handle_upload( 'async-upload', $_REQUEST['post_id'] );
 881          unset( $_FILES );
 882  
 883          if ( is_wp_error( $id ) ) {
 884              $errors['upload_error'] = $id;
 885              $id                     = false;
 886          }
 887      }
 888  
 889      if ( ! empty( $_POST['insertonlybutton'] ) ) {
 890          $src = $_POST['src'];
 891  
 892          if ( ! empty( $src ) && ! strpos( $src, '://' ) ) {
 893              $src = "http://$src";
 894          }
 895  
 896          if ( isset( $_POST['media_type'] ) && 'image' !== $_POST['media_type'] ) {
 897              $title = esc_html( wp_unslash( $_POST['title'] ) );
 898              if ( empty( $title ) ) {
 899                  $title = esc_html( wp_basename( $src ) );
 900              }
 901  
 902              if ( $title && $src ) {
 903                  $html = "<a href='" . esc_url( $src ) . "'>$title</a>";
 904              }
 905  
 906              $type = 'file';
 907              $ext  = preg_replace( '/^.+?\.([^.]+)$/', '$1', $src );
 908  
 909              if ( $ext ) {
 910                  $ext_type = wp_ext2type( $ext );
 911                  if ( 'audio' === $ext_type || 'video' === $ext_type ) {
 912                      $type = $ext_type;
 913                  }
 914              }
 915  
 916              /**
 917               * Filters the URL sent to the editor for a specific media type.
 918               *
 919               * The dynamic portion of the hook name, `$type`, refers to the type
 920               * of media being sent.
 921               *
 922               * Possible hook names include:
 923               *
 924               *  - `audio_send_to_editor_url`
 925               *  - `file_send_to_editor_url`
 926               *  - `video_send_to_editor_url`
 927               *
 928               * @since 3.3.0
 929               *
 930               * @param string $html  HTML markup sent to the editor.
 931               * @param string $src   Media source URL.
 932               * @param string $title Media title.
 933               */
 934              $html = apply_filters( "{$type}_send_to_editor_url", $html, sanitize_url( $src ), $title );
 935          } else {
 936              $align = '';
 937              $alt   = esc_attr( wp_unslash( $_POST['alt'] ) );
 938  
 939              if ( isset( $_POST['align'] ) ) {
 940                  $align = esc_attr( wp_unslash( $_POST['align'] ) );
 941                  $class = " class='align$align'";
 942              }
 943  
 944              if ( ! empty( $src ) ) {
 945                  $html = "<img src='" . esc_url( $src ) . "' alt='$alt'$class />";
 946              }
 947  
 948              /**
 949               * Filters the image URL sent to the editor.
 950               *
 951               * @since 2.8.0
 952               *
 953               * @param string $html  HTML markup sent to the editor for an image.
 954               * @param string $src   Image source URL.
 955               * @param string $alt   Image alternate, or alt, text.
 956               * @param string $align The image alignment. Default 'alignnone'. Possible values include
 957               *                      'alignleft', 'aligncenter', 'alignright', 'alignnone'.
 958               */
 959              $html = apply_filters( 'image_send_to_editor_url', $html, sanitize_url( $src ), $alt, $align );
 960          }
 961  
 962          return media_send_to_editor( $html );
 963      }
 964  
 965      if ( isset( $_POST['save'] ) ) {
 966          $errors['upload_notice'] = __( 'Saved.' );
 967          wp_enqueue_script( 'admin-gallery' );
 968  
 969          return wp_iframe( 'media_upload_gallery_form', $errors );
 970  
 971      } elseif ( ! empty( $_POST ) ) {
 972          $return = media_upload_form_handler();
 973  
 974          if ( is_string( $return ) ) {
 975              return $return;
 976          }
 977  
 978          if ( is_array( $return ) ) {
 979              $errors = $return;
 980          }
 981      }
 982  
 983      if ( isset( $_GET['tab'] ) && 'type_url' === $_GET['tab'] ) {
 984          $type = 'image';
 985  
 986          if ( isset( $_GET['type'] ) && in_array( $_GET['type'], array( 'video', 'audio', 'file' ), true ) ) {
 987              $type = $_GET['type'];
 988          }
 989  
 990          return wp_iframe( 'media_upload_type_url_form', $type, $errors, $id );
 991      }
 992  
 993      return wp_iframe( 'media_upload_type_form', 'image', $errors, $id );
 994  }
 995  
 996  /**
 997   * Downloads an image from the specified URL, saves it as an attachment, and optionally attaches it to a post.
 998   *
 999   * @since 2.6.0
1000   * @since 4.2.0 Introduced the `$return_type` parameter.
1001   * @since 4.8.0 Introduced the 'id' option for the `$return_type` parameter.
1002   * @since 5.3.0 The `$post_id` parameter was made optional.
1003   * @since 5.4.0 The original URL of the attachment is stored in the `_source_url`
1004   *              post meta value.
1005   * @since 5.8.0 Added 'webp' to the default list of allowed file extensions.
1006   *
1007   * @param string $file        The URL of the image to download.
1008   * @param int    $post_id     Optional. The post ID the media is to be associated with.
1009   * @param string $desc        Optional. Description of the image.
1010   * @param string $return_type Optional. Accepts 'html' (image tag html) or 'src' (URL),
1011   *                            or 'id' (attachment ID). Default 'html'.
1012   * @return string|int|WP_Error Populated HTML img tag, attachment ID, or attachment source
1013   *                             on success, WP_Error object otherwise.
1014   */
1015  function media_sideload_image( $file, $post_id = 0, $desc = null, $return_type = 'html' ) {
1016      if ( ! empty( $file ) ) {
1017  
1018          $allowed_extensions = array( 'jpg', 'jpeg', 'jpe', 'png', 'gif', 'webp' );
1019  
1020          /**
1021           * Filters the list of allowed file extensions when sideloading an image from a URL.
1022           *
1023           * The default allowed extensions are:
1024           *
1025           *  - `jpg`
1026           *  - `jpeg`
1027           *  - `jpe`
1028           *  - `png`
1029           *  - `gif`
1030           *  - `webp`
1031           *
1032           * @since 5.6.0
1033           * @since 5.8.0 Added 'webp' to the default list of allowed file extensions.
1034           *
1035           * @param string[] $allowed_extensions Array of allowed file extensions.
1036           * @param string   $file               The URL of the image to download.
1037           */
1038          $allowed_extensions = apply_filters( 'image_sideload_extensions', $allowed_extensions, $file );
1039          $allowed_extensions = array_map( 'preg_quote', $allowed_extensions );
1040  
1041          // Set variables for storage, fix file filename for query strings.
1042          preg_match( '/[^\?]+\.(' . implode( '|', $allowed_extensions ) . ')\b/i', $file, $matches );
1043  
1044          if ( ! $matches ) {
1045              return new WP_Error( 'image_sideload_failed', __( 'Invalid image URL.' ) );
1046          }
1047  
1048          $file_array         = array();
1049          $file_array['name'] = wp_basename( $matches[0] );
1050  
1051          // Download file to temp location.
1052          $file_array['tmp_name'] = download_url( $file );
1053  
1054          // If error storing temporarily, return the error.
1055          if ( is_wp_error( $file_array['tmp_name'] ) ) {
1056              return $file_array['tmp_name'];
1057          }
1058  
1059          // Do the validation and storage stuff.
1060          $id = media_handle_sideload( $file_array, $post_id, $desc );
1061  
1062          // If error storing permanently, unlink.
1063          if ( is_wp_error( $id ) ) {
1064              @unlink( $file_array['tmp_name'] );
1065              return $id;
1066          }
1067  
1068          // Store the original attachment source in meta.
1069          add_post_meta( $id, '_source_url', $file );
1070  
1071          // If attachment ID was requested, return it.
1072          if ( 'id' === $return_type ) {
1073              return $id;
1074          }
1075  
1076          $src = wp_get_attachment_url( $id );
1077      }
1078  
1079      // Finally, check to make sure the file has been saved, then return the HTML.
1080      if ( ! empty( $src ) ) {
1081          if ( 'src' === $return_type ) {
1082              return $src;
1083          }
1084  
1085          $alt  = isset( $desc ) ? esc_attr( $desc ) : '';
1086          $html = "<img src='$src' alt='$alt' />";
1087  
1088          return $html;
1089      } else {
1090          return new WP_Error( 'image_sideload_failed' );
1091      }
1092  }
1093  
1094  /**
1095   * Retrieves the legacy media uploader form in an iframe.
1096   *
1097   * @since 2.5.0
1098   *
1099   * @return string|null
1100   */
1101  function media_upload_gallery() {
1102      $errors = array();
1103  
1104      if ( ! empty( $_POST ) ) {
1105          $return = media_upload_form_handler();
1106  
1107          if ( is_string( $return ) ) {
1108              return $return;
1109          }
1110  
1111          if ( is_array( $return ) ) {
1112              $errors = $return;
1113          }
1114      }
1115  
1116      wp_enqueue_script( 'admin-gallery' );
1117      return wp_iframe( 'media_upload_gallery_form', $errors );
1118  }
1119  
1120  /**
1121   * Retrieves the legacy media library form in an iframe.
1122   *
1123   * @since 2.5.0
1124   *
1125   * @return string|null
1126   */
1127  function media_upload_library() {
1128      $errors = array();
1129  
1130      if ( ! empty( $_POST ) ) {
1131          $return = media_upload_form_handler();
1132  
1133          if ( is_string( $return ) ) {
1134              return $return;
1135          }
1136          if ( is_array( $return ) ) {
1137              $errors = $return;
1138          }
1139      }
1140  
1141      return wp_iframe( 'media_upload_library_form', $errors );
1142  }
1143  
1144  /**
1145   * Retrieves HTML for the image alignment radio buttons with the specified one checked.
1146   *
1147   * @since 2.7.0
1148   *
1149   * @param WP_Post $post
1150   * @param string  $checked
1151   * @return string
1152   */
1153  function image_align_input_fields( $post, $checked = '' ) {
1154  
1155      if ( empty( $checked ) ) {
1156          $checked = get_user_setting( 'align', 'none' );
1157      }
1158  
1159      $alignments = array(
1160          'none'   => __( 'None' ),
1161          'left'   => __( 'Left' ),
1162          'center' => __( 'Center' ),
1163          'right'  => __( 'Right' ),
1164      );
1165  
1166      if ( ! array_key_exists( (string) $checked, $alignments ) ) {
1167          $checked = 'none';
1168      }
1169  
1170      $output = array();
1171  
1172      foreach ( $alignments as $name => $label ) {
1173          $name     = esc_attr( $name );
1174          $output[] = "<input type='radio' name='attachments[{$post->ID}][align]' id='image-align-{$name}-{$post->ID}' value='$name'" .
1175              ( $checked == $name ? " checked='checked'" : '' ) .
1176              " /><label for='image-align-{$name}-{$post->ID}' class='align image-align-{$name}-label'>$label</label>";
1177      }
1178  
1179      return implode( "\n", $output );
1180  }
1181  
1182  /**
1183   * Retrieves HTML for the size radio buttons with the specified one checked.
1184   *
1185   * @since 2.7.0
1186   *
1187   * @param WP_Post     $post
1188   * @param bool|string $check
1189   * @return array
1190   */
1191  function image_size_input_fields( $post, $check = '' ) {
1192      /**
1193       * Filters the names and labels of the default image sizes.
1194       *
1195       * @since 3.3.0
1196       *
1197       * @param string[] $size_names Array of image size labels keyed by their name. Default values
1198       *                             include 'Thumbnail', 'Medium', 'Large', and 'Full Size'.
1199       */
1200      $size_names = apply_filters(
1201          'image_size_names_choose',
1202          array(
1203              'thumbnail' => __( 'Thumbnail' ),
1204              'medium'    => __( 'Medium' ),
1205              'large'     => __( 'Large' ),
1206              'full'      => __( 'Full Size' ),
1207          )
1208      );
1209  
1210      if ( empty( $check ) ) {
1211          $check = get_user_setting( 'imgsize', 'medium' );
1212      }
1213  
1214      $output = array();
1215  
1216      foreach ( $size_names as $size => $label ) {
1217          $downsize = image_downsize( $post->ID, $size );
1218          $checked  = '';
1219  
1220          // Is this size selectable?
1221          $enabled = ( $downsize[3] || 'full' === $size );
1222          $css_id  = "image-size-{$size}-{$post->ID}";
1223  
1224          // If this size is the default but that's not available, don't select it.
1225          if ( $size == $check ) {
1226              if ( $enabled ) {
1227                  $checked = " checked='checked'";
1228              } else {
1229                  $check = '';
1230              }
1231          } elseif ( ! $check && $enabled && 'thumbnail' !== $size ) {
1232              /*
1233               * If $check is not enabled, default to the first available size
1234               * that's bigger than a thumbnail.
1235               */
1236              $check   = $size;
1237              $checked = " checked='checked'";
1238          }
1239  
1240          $html = "<div class='image-size-item'><input type='radio' " . disabled( $enabled, false, false ) . "name='attachments[$post->ID][image-size]' id='{$css_id}' value='{$size}'$checked />";
1241  
1242          $html .= "<label for='{$css_id}'>$label</label>";
1243  
1244          // Only show the dimensions if that choice is available.
1245          if ( $enabled ) {
1246              $html .= " <label for='{$css_id}' class='help'>" . sprintf( '(%d&nbsp;&times;&nbsp;%d)', $downsize[1], $downsize[2] ) . '</label>';
1247          }
1248          $html .= '</div>';
1249  
1250          $output[] = $html;
1251      }
1252  
1253      return array(
1254          'label' => __( 'Size' ),
1255          'input' => 'html',
1256          'html'  => implode( "\n", $output ),
1257      );
1258  }
1259  
1260  /**
1261   * Retrieves HTML for the Link URL buttons with the default link type as specified.
1262   *
1263   * @since 2.7.0
1264   *
1265   * @param WP_Post $post
1266   * @param string  $url_type
1267   * @return string
1268   */
1269  function image_link_input_fields( $post, $url_type = '' ) {
1270  
1271      $file = wp_get_attachment_url( $post->ID );
1272      $link = get_attachment_link( $post->ID );
1273  
1274      if ( empty( $url_type ) ) {
1275          $url_type = get_user_setting( 'urlbutton', 'post' );
1276      }
1277  
1278      $url = '';
1279  
1280      if ( 'file' === $url_type ) {
1281          $url = $file;
1282      } elseif ( 'post' === $url_type ) {
1283          $url = $link;
1284      }
1285  
1286      return "
1287      <input type='text' class='text urlfield' name='attachments[$post->ID][url]' value='" . esc_attr( $url ) . "' /><br />
1288      <button type='button' class='button urlnone' data-link-url=''>" . __( 'None' ) . "</button>
1289      <button type='button' class='button urlfile' data-link-url='" . esc_url( $file ) . "'>" . __( 'File URL' ) . "</button>
1290      <button type='button' class='button urlpost' data-link-url='" . esc_url( $link ) . "'>" . __( 'Attachment Post URL' ) . '</button>
1291  ';
1292  }
1293  
1294  /**
1295   * Outputs a textarea element for inputting an attachment caption.
1296   *
1297   * @since 3.4.0
1298   *
1299   * @param WP_Post $edit_post Attachment WP_Post object.
1300   * @return string HTML markup for the textarea element.
1301   */
1302  function wp_caption_input_textarea( $edit_post ) {
1303      // Post data is already escaped.
1304      $name = "attachments[{$edit_post->ID}][post_excerpt]";
1305  
1306      return '<textarea name="' . $name . '" id="' . $name . '">' . $edit_post->post_excerpt . '</textarea>';
1307  }
1308  
1309  /**
1310   * Retrieves the image attachment fields to edit form fields.
1311   *
1312   * @since 2.5.0
1313   *
1314   * @param array  $form_fields
1315   * @param object $post
1316   * @return array
1317   */
1318  function image_attachment_fields_to_edit( $form_fields, $post ) {
1319      return $form_fields;
1320  }
1321  
1322  /**
1323   * Retrieves the single non-image attachment fields to edit form fields.
1324   *
1325   * @since 2.5.0
1326   *
1327   * @param array   $form_fields An array of attachment form fields.
1328   * @param WP_Post $post        The WP_Post attachment object.
1329   * @return array Filtered attachment form fields.
1330   */
1331  function media_single_attachment_fields_to_edit( $form_fields, $post ) {
1332      unset( $form_fields['url'], $form_fields['align'], $form_fields['image-size'] );
1333      return $form_fields;
1334  }
1335  
1336  /**
1337   * Retrieves the post non-image attachment fields to edit form fields.
1338   *
1339   * @since 2.8.0
1340   *
1341   * @param array   $form_fields An array of attachment form fields.
1342   * @param WP_Post $post        The WP_Post attachment object.
1343   * @return array Filtered attachment form fields.
1344   */
1345  function media_post_single_attachment_fields_to_edit( $form_fields, $post ) {
1346      unset( $form_fields['image_url'] );
1347      return $form_fields;
1348  }
1349  
1350  /**
1351   * Retrieves the media element HTML to send to the editor.
1352   *
1353   * @since 2.5.0
1354   *
1355   * @param string  $html
1356   * @param int     $attachment_id
1357   * @param array   $attachment
1358   * @return string
1359   */
1360  function image_media_send_to_editor( $html, $attachment_id, $attachment ) {
1361      $post = get_post( $attachment_id );
1362  
1363      if ( str_starts_with( $post->post_mime_type, 'image' ) ) {
1364          $url   = $attachment['url'];
1365          $align = ! empty( $attachment['align'] ) ? $attachment['align'] : 'none';
1366          $size  = ! empty( $attachment['image-size'] ) ? $attachment['image-size'] : 'medium';
1367          $alt   = ! empty( $attachment['image_alt'] ) ? $attachment['image_alt'] : '';
1368          $rel   = ( str_contains( $url, 'attachment_id' ) || get_attachment_link( $attachment_id ) === $url );
1369  
1370          return get_image_send_to_editor( $attachment_id, $attachment['post_excerpt'], $attachment['post_title'], $align, $url, $rel, $size, $alt );
1371      }
1372  
1373      return $html;
1374  }
1375  
1376  /**
1377   * Retrieves the attachment fields to edit form fields.
1378   *
1379   * @since 2.5.0
1380   *
1381   * @param WP_Post $post
1382   * @param array   $errors
1383   * @return array
1384   */
1385  function get_attachment_fields_to_edit( $post, $errors = null ) {
1386      if ( is_int( $post ) ) {
1387          $post = get_post( $post );
1388      }
1389  
1390      if ( is_array( $post ) ) {
1391          $post = new WP_Post( (object) $post );
1392      }
1393  
1394      $image_url = wp_get_attachment_url( $post->ID );
1395  
1396      $edit_post = sanitize_post( $post, 'edit' );
1397  
1398      $form_fields = array(
1399          'post_title'   => array(
1400              'label' => __( 'Title' ),
1401              'value' => $edit_post->post_title,
1402          ),
1403          'image_alt'    => array(),
1404          'post_excerpt' => array(
1405              'label' => __( 'Caption' ),
1406              'input' => 'html',
1407              'html'  => wp_caption_input_textarea( $edit_post ),
1408          ),
1409          'post_content' => array(
1410              'label' => __( 'Description' ),
1411              'value' => $edit_post->post_content,
1412              'input' => 'textarea',
1413          ),
1414          'url'          => array(
1415              'label' => __( 'Link URL' ),
1416              'input' => 'html',
1417              'html'  => image_link_input_fields( $post, get_option( 'image_default_link_type' ) ),
1418              'helps' => __( 'Enter a link URL or click above for presets.' ),
1419          ),
1420          'menu_order'   => array(
1421              'label' => __( 'Order' ),
1422              'value' => $edit_post->menu_order,
1423          ),
1424          'image_url'    => array(
1425              'label' => __( 'File URL' ),
1426              'input' => 'html',
1427              'html'  => "<input type='text' class='text urlfield' readonly='readonly' name='attachments[$post->ID][url]' value='" . esc_attr( $image_url ) . "' /><br />",
1428              'value' => wp_get_attachment_url( $post->ID ),
1429              'helps' => __( 'Location of the uploaded file.' ),
1430          ),
1431      );
1432  
1433      foreach ( get_attachment_taxonomies( $post ) as $taxonomy ) {
1434          $t = (array) get_taxonomy( $taxonomy );
1435  
1436          if ( ! $t['public'] || ! $t['show_ui'] ) {
1437              continue;
1438          }
1439  
1440          if ( empty( $t['label'] ) ) {
1441              $t['label'] = $taxonomy;
1442          }
1443  
1444          if ( empty( $t['args'] ) ) {
1445              $t['args'] = array();
1446          }
1447  
1448          $terms = get_object_term_cache( $post->ID, $taxonomy );
1449  
1450          if ( false === $terms ) {
1451              $terms = wp_get_object_terms( $post->ID, $taxonomy, $t['args'] );
1452          }
1453  
1454          $values = array();
1455  
1456          foreach ( $terms as $term ) {
1457              $values[] = $term->slug;
1458          }
1459  
1460          $t['value'] = implode( ', ', $values );
1461  
1462          $form_fields[ $taxonomy ] = $t;
1463      }
1464  
1465      /*
1466       * Merge default fields with their errors, so any key passed with the error
1467       * (e.g. 'error', 'helps', 'value') will replace the default.
1468       * The recursive merge is easily traversed with array casting:
1469       * foreach ( (array) $things as $thing )
1470       */
1471      $form_fields = array_merge_recursive( $form_fields, (array) $errors );
1472  
1473      // This was formerly in image_attachment_fields_to_edit().
1474      if ( str_starts_with( $post->post_mime_type, 'image' ) ) {
1475          $alt = get_post_meta( $post->ID, '_wp_attachment_image_alt', true );
1476  
1477          if ( empty( $alt ) ) {
1478              $alt = '';
1479          }
1480  
1481          $form_fields['post_title']['required'] = true;
1482  
1483          $form_fields['image_alt'] = array(
1484              'value' => $alt,
1485              'label' => __( 'Alternative Text' ),
1486              'helps' => __( 'Alt text for the image, e.g. &#8220;The Mona Lisa&#8221;' ),
1487          );
1488  
1489          $form_fields['align'] = array(
1490              'label' => __( 'Alignment' ),
1491              'input' => 'html',
1492              'html'  => image_align_input_fields( $post, get_option( 'image_default_align' ) ),
1493          );
1494  
1495          $form_fields['image-size'] = image_size_input_fields( $post, get_option( 'image_default_size', 'medium' ) );
1496  
1497      } else {
1498          unset( $form_fields['image_alt'] );
1499      }
1500  
1501      /**
1502       * Filters the attachment fields to edit.
1503       *
1504       * @since 2.5.0
1505       *
1506       * @param array   $form_fields An array of attachment form fields.
1507       * @param WP_Post $post        The WP_Post attachment object.
1508       */
1509      $form_fields = apply_filters( 'attachment_fields_to_edit', $form_fields, $post );
1510  
1511      return $form_fields;
1512  }
1513  
1514  /**
1515   * Retrieves HTML for media items of post gallery.
1516   *
1517   * The HTML markup retrieved will be created for the progress of SWF Upload
1518   * component. Will also create link for showing and hiding the form to modify
1519   * the image attachment.
1520   *
1521   * @since 2.5.0
1522   *
1523   * @global WP_Query $wp_the_query WordPress Query object.
1524   *
1525   * @param int   $post_id Post ID.
1526   * @param array $errors  Errors for attachment, if any.
1527   * @return string HTML content for media items of post gallery.
1528   */
1529  function get_media_items( $post_id, $errors ) {
1530      $attachments = array();
1531  
1532      if ( $post_id ) {
1533          $post = get_post( $post_id );
1534  
1535          if ( $post && 'attachment' === $post->post_type ) {
1536              $attachments = array( $post->ID => $post );
1537          } else {
1538              $attachments = get_children(
1539                  array(
1540                      'post_parent' => $post_id,
1541                      'post_type'   => 'attachment',
1542                      'orderby'     => 'menu_order ASC, ID',
1543                      'order'       => 'DESC',
1544                  )
1545              );
1546          }
1547      } else {
1548          if ( is_array( $GLOBALS['wp_the_query']->posts ) ) {
1549              foreach ( $GLOBALS['wp_the_query']->posts as $attachment ) {
1550                  $attachments[ $attachment->ID ] = $attachment;
1551              }
1552          }
1553      }
1554  
1555      $output = '';
1556      foreach ( (array) $attachments as $id => $attachment ) {
1557          if ( 'trash' === $attachment->post_status ) {
1558              continue;
1559          }
1560  
1561          $item = get_media_item( $id, array( 'errors' => isset( $errors[ $id ] ) ? $errors[ $id ] : null ) );
1562  
1563          if ( $item ) {
1564              $output .= "\n<div id='media-item-$id' class='media-item child-of-$attachment->post_parent preloaded'><div class='progress hidden'><div class='bar'></div></div><div id='media-upload-error-$id' class='hidden'></div><div class='filename hidden'></div>$item\n</div>";
1565          }
1566      }
1567  
1568      return $output;
1569  }
1570  
1571  /**
1572   * Retrieves HTML form for modifying the image attachment.
1573   *
1574   * @since 2.5.0
1575   *
1576   * @global string $redir_tab
1577   *
1578   * @param int          $attachment_id Attachment ID for modification.
1579   * @param string|array $args          Optional. Override defaults.
1580   * @return string HTML form for attachment.
1581   */
1582  function get_media_item( $attachment_id, $args = null ) {
1583      global $redir_tab;
1584  
1585      $thumb_url     = false;
1586      $attachment_id = (int) $attachment_id;
1587  
1588      if ( $attachment_id ) {
1589          $thumb_url = wp_get_attachment_image_src( $attachment_id, 'thumbnail', true );
1590  
1591          if ( $thumb_url ) {
1592              $thumb_url = $thumb_url[0];
1593          }
1594      }
1595  
1596      $post            = get_post( $attachment_id );
1597      $current_post_id = ! empty( $_GET['post_id'] ) ? (int) $_GET['post_id'] : 0;
1598  
1599      $default_args = array(
1600          'errors'     => null,
1601          'send'       => $current_post_id ? post_type_supports( get_post_type( $current_post_id ), 'editor' ) : true,
1602          'delete'     => true,
1603          'toggle'     => true,
1604          'show_title' => true,
1605      );
1606  
1607      $parsed_args = wp_parse_args( $args, $default_args );
1608  
1609      /**
1610       * Filters the arguments used to retrieve an image for the edit image form.
1611       *
1612       * @since 3.1.0
1613       *
1614       * @see get_media_item
1615       *
1616       * @param array $parsed_args An array of arguments.
1617       */
1618      $parsed_args = apply_filters( 'get_media_item_args', $parsed_args );
1619  
1620      $toggle_on  = __( 'Show' );
1621      $toggle_off = __( 'Hide' );
1622  
1623      $file     = get_attached_file( $post->ID );
1624      $filename = esc_html( wp_basename( $file ) );
1625      $title    = esc_attr( $post->post_title );
1626  
1627      $post_mime_types = get_post_mime_types();
1628      $keys            = array_keys( wp_match_mime_types( array_keys( $post_mime_types ), $post->post_mime_type ) );
1629      $type            = reset( $keys );
1630      $type_html       = "<input type='hidden' id='type-of-$attachment_id' value='" . esc_attr( $type ) . "' />";
1631  
1632      $form_fields = get_attachment_fields_to_edit( $post, $parsed_args['errors'] );
1633  
1634      if ( $parsed_args['toggle'] ) {
1635          $class        = empty( $parsed_args['errors'] ) ? 'startclosed' : 'startopen';
1636          $toggle_links = "
1637          <a class='toggle describe-toggle-on' href='#'>$toggle_on</a>
1638          <a class='toggle describe-toggle-off' href='#'>$toggle_off</a>";
1639      } else {
1640          $class        = '';
1641          $toggle_links = '';
1642      }
1643  
1644      $display_title = ( ! empty( $title ) ) ? $title : $filename; // $title shouldn't ever be empty, but just in case.
1645      $display_title = $parsed_args['show_title'] ? "<div class='filename new'><span class='title'>" . wp_html_excerpt( $display_title, 60, '&hellip;' ) . '</span></div>' : '';
1646  
1647      $gallery = ( ( isset( $_REQUEST['tab'] ) && 'gallery' === $_REQUEST['tab'] ) || ( isset( $redir_tab ) && 'gallery' === $redir_tab ) );
1648      $order   = '';
1649  
1650      foreach ( $form_fields as $key => $val ) {
1651          if ( 'menu_order' === $key ) {
1652              if ( $gallery ) {
1653                  $order = "<div class='menu_order'> <input class='menu_order_input' type='text' id='attachments[$attachment_id][menu_order]' name='attachments[$attachment_id][menu_order]' value='" . esc_attr( $val['value'] ) . "' /></div>";
1654              } else {
1655                  $order = "<input type='hidden' name='attachments[$attachment_id][menu_order]' value='" . esc_attr( $val['value'] ) . "' />";
1656              }
1657  
1658              unset( $form_fields['menu_order'] );
1659              break;
1660          }
1661      }
1662  
1663      $media_dims = '';
1664      $meta       = wp_get_attachment_metadata( $post->ID );
1665  
1666      if ( isset( $meta['width'], $meta['height'] ) ) {
1667          $media_dims .= "<span id='media-dims-$post->ID'>{$meta['width']}&nbsp;&times;&nbsp;{$meta['height']}</span> ";
1668      }
1669  
1670      /**
1671       * Filters the media metadata.
1672       *
1673       * @since 2.5.0
1674       *
1675       * @param string  $media_dims The HTML markup containing the media dimensions.
1676       * @param WP_Post $post       The WP_Post attachment object.
1677       */
1678      $media_dims = apply_filters( 'media_meta', $media_dims, $post );
1679  
1680      $image_edit_button = '';
1681  
1682      if ( wp_attachment_is_image( $post->ID ) && wp_image_editor_supports( array( 'mime_type' => $post->post_mime_type ) ) ) {
1683          $nonce             = wp_create_nonce( "image_editor-$post->ID" );
1684          $image_edit_button = "<input type='button' id='imgedit-open-btn-$post->ID' onclick='imageEdit.open( $post->ID, \"$nonce\" )' class='button' value='" . esc_attr__( 'Edit Image' ) . "' /> <span class='spinner'></span>";
1685      }
1686  
1687      $attachment_url = get_permalink( $attachment_id );
1688  
1689      $item = "
1690          $type_html
1691          $toggle_links
1692          $order
1693          $display_title
1694          <table class='slidetoggle describe $class'>
1695              <thead class='media-item-info' id='media-head-$post->ID'>
1696              <tr>
1697              <td class='A1B1' id='thumbnail-head-$post->ID'>
1698              <p><a href='$attachment_url' target='_blank'><img class='thumbnail' src='$thumb_url' alt='' /></a></p>
1699              <p>$image_edit_button</p>
1700              </td>
1701              <td>
1702              <p><strong>" . __( 'File name:' ) . "</strong> $filename</p>
1703              <p><strong>" . __( 'File type:' ) . "</strong> $post->post_mime_type</p>
1704              <p><strong>" . __( 'Upload date:' ) . '</strong> ' . mysql2date( __( 'F j, Y' ), $post->post_date ) . '</p>';
1705  
1706      if ( ! empty( $media_dims ) ) {
1707          $item .= '<p><strong>' . __( 'Dimensions:' ) . "</strong> $media_dims</p>\n";
1708      }
1709  
1710      $item .= "</td></tr>\n";
1711  
1712      $item .= "
1713          </thead>
1714          <tbody>
1715          <tr><td colspan='2' class='imgedit-response' id='imgedit-response-$post->ID'></td></tr>\n
1716          <tr><td style='display:none' colspan='2' class='image-editor' id='image-editor-$post->ID'></td></tr>\n
1717          <tr><td colspan='2'><p class='media-types media-types-required-info'>" .
1718              wp_required_field_message() .
1719          "</p></td></tr>\n";
1720  
1721      $defaults = array(
1722          'input'      => 'text',
1723          'required'   => false,
1724          'value'      => '',
1725          'extra_rows' => array(),
1726      );
1727  
1728      if ( $parsed_args['send'] ) {
1729          $parsed_args['send'] = get_submit_button( __( 'Insert into Post' ), '', "send[$attachment_id]", false );
1730      }
1731  
1732      $delete = empty( $parsed_args['delete'] ) ? '' : $parsed_args['delete'];
1733      if ( $delete && current_user_can( 'delete_post', $attachment_id ) ) {
1734          if ( ! EMPTY_TRASH_DAYS ) {
1735              $delete = "<a href='" . wp_nonce_url( "post.php?action=delete&amp;post=$attachment_id", 'delete-post_' . $attachment_id ) . "' id='del[$attachment_id]' class='delete-permanently'>" . __( 'Delete Permanently' ) . '</a>';
1736          } elseif ( ! MEDIA_TRASH ) {
1737              $delete = "<a href='#' class='del-link' onclick=\"document.getElementById('del_attachment_$attachment_id').style.display='block';return false;\">" . __( 'Delete' ) . "</a>
1738                  <div id='del_attachment_$attachment_id' class='del-attachment' style='display:none;'>" .
1739                  /* translators: %s: File name. */
1740                  '<p>' . sprintf( __( 'You are about to delete %s.' ), '<strong>' . $filename . '</strong>' ) . "</p>
1741                  <a href='" . wp_nonce_url( "post.php?action=delete&amp;post=$attachment_id", 'delete-post_' . $attachment_id ) . "' id='del[$attachment_id]' class='button'>" . __( 'Continue' ) . "</a>
1742                  <a href='#' class='button' onclick=\"this.parentNode.style.display='none';return false;\">" . __( 'Cancel' ) . '</a>
1743                  </div>';
1744          } else {
1745              $delete = "<a href='" . wp_nonce_url( "post.php?action=trash&amp;post=$attachment_id", 'trash-post_' . $attachment_id ) . "' id='del[$attachment_id]' class='delete'>" . __( 'Move to Trash' ) . "</a>
1746              <a href='" . wp_nonce_url( "post.php?action=untrash&amp;post=$attachment_id", 'untrash-post_' . $attachment_id ) . "' id='undo[$attachment_id]' class='undo hidden'>" . __( 'Undo' ) . '</a>';
1747          }
1748      } else {
1749          $delete = '';
1750      }
1751  
1752      $thumbnail       = '';
1753      $calling_post_id = 0;
1754  
1755      if ( isset( $_GET['post_id'] ) ) {
1756          $calling_post_id = absint( $_GET['post_id'] );
1757      } elseif ( isset( $_POST ) && count( $_POST ) ) {// Like for async-upload where $_GET['post_id'] isn't set.
1758          $calling_post_id = $post->post_parent;
1759      }
1760  
1761      if ( 'image' === $type && $calling_post_id
1762          && current_theme_supports( 'post-thumbnails', get_post_type( $calling_post_id ) )
1763          && post_type_supports( get_post_type( $calling_post_id ), 'thumbnail' )
1764          && get_post_thumbnail_id( $calling_post_id ) != $attachment_id
1765      ) {
1766  
1767          $calling_post             = get_post( $calling_post_id );
1768          $calling_post_type_object = get_post_type_object( $calling_post->post_type );
1769  
1770          $ajax_nonce = wp_create_nonce( "set_post_thumbnail-$calling_post_id" );
1771          $thumbnail  = "<a class='wp-post-thumbnail' id='wp-post-thumbnail-" . $attachment_id . "' href='#' onclick='WPSetAsThumbnail(\"$attachment_id\", \"$ajax_nonce\");return false;'>" . esc_html( $calling_post_type_object->labels->use_featured_image ) . '</a>';
1772      }
1773  
1774      if ( ( $parsed_args['send'] || $thumbnail || $delete ) && ! isset( $form_fields['buttons'] ) ) {
1775          $form_fields['buttons'] = array( 'tr' => "\t\t<tr class='submit'><td></td><td class='savesend'>" . $parsed_args['send'] . " $thumbnail $delete</td></tr>\n" );
1776      }
1777  
1778      $hidden_fields = array();
1779  
1780      foreach ( $form_fields as $id => $field ) {
1781          if ( '_' === $id[0] ) {
1782              continue;
1783          }
1784  
1785          if ( ! empty( $field['tr'] ) ) {
1786              $item .= $field['tr'];
1787              continue;
1788          }
1789  
1790          $field = array_merge( $defaults, $field );
1791          $name  = "attachments[$attachment_id][$id]";
1792  
1793          if ( 'hidden' === $field['input'] ) {
1794              $hidden_fields[ $name ] = $field['value'];
1795              continue;
1796          }
1797  
1798          $required      = $field['required'] ? ' ' . wp_required_field_indicator() : '';
1799          $required_attr = $field['required'] ? ' required' : '';
1800          $class         = $id;
1801          $class        .= $field['required'] ? ' form-required' : '';
1802  
1803          $item .= "\t\t<tr class='$class'>\n\t\t\t<th scope='row' class='label'><label for='$name'><span class='alignleft'>{$field['label']}{$required}</span><br class='clear' /></label></th>\n\t\t\t<td class='field'>";
1804  
1805          if ( ! empty( $field[ $field['input'] ] ) ) {
1806              $item .= $field[ $field['input'] ];
1807          } elseif ( 'textarea' === $field['input'] ) {
1808              if ( 'post_content' === $id && user_can_richedit() ) {
1809                  // Sanitize_post() skips the post_content when user_can_richedit.
1810                  $field['value'] = htmlspecialchars( $field['value'], ENT_QUOTES );
1811              }
1812              // Post_excerpt is already escaped by sanitize_post() in get_attachment_fields_to_edit().
1813              $item .= "<textarea id='$name' name='$name'{$required_attr}>" . $field['value'] . '</textarea>';
1814          } else {
1815              $item .= "<input type='text' class='text' id='$name' name='$name' value='" . esc_attr( $field['value'] ) . "'{$required_attr} />";
1816          }
1817  
1818          if ( ! empty( $field['helps'] ) ) {
1819              $item .= "<p class='help'>" . implode( "</p>\n<p class='help'>", array_unique( (array) $field['helps'] ) ) . '</p>';
1820          }
1821          $item .= "</td>\n\t\t</tr>\n";
1822  
1823          $extra_rows = array();
1824  
1825          if ( ! empty( $field['errors'] ) ) {
1826              foreach ( array_unique( (array) $field['errors'] ) as $error ) {
1827                  $extra_rows['error'][] = $error;
1828              }
1829          }
1830  
1831          if ( ! empty( $field['extra_rows'] ) ) {
1832              foreach ( $field['extra_rows'] as $class => $rows ) {
1833                  foreach ( (array) $rows as $html ) {
1834                      $extra_rows[ $class ][] = $html;
1835                  }
1836              }
1837          }
1838  
1839          foreach ( $extra_rows as $class => $rows ) {
1840              foreach ( $rows as $html ) {
1841                  $item .= "\t\t<tr><td></td><td class='$class'>$html</td></tr>\n";
1842              }
1843          }
1844      }
1845  
1846      if ( ! empty( $form_fields['_final'] ) ) {
1847          $item .= "\t\t<tr class='final'><td colspan='2'>{$form_fields['_final']}</td></tr>\n";
1848      }
1849  
1850      $item .= "\t</tbody>\n";
1851      $item .= "\t</table>\n";
1852  
1853      foreach ( $hidden_fields as $name => $value ) {
1854          $item .= "\t<input type='hidden' name='$name' id='$name' value='" . esc_attr( $value ) . "' />\n";
1855      }
1856  
1857      if ( $post->post_parent < 1 && isset( $_REQUEST['post_id'] ) ) {
1858          $parent      = (int) $_REQUEST['post_id'];
1859          $parent_name = "attachments[$attachment_id][post_parent]";
1860          $item       .= "\t<input type='hidden' name='$parent_name' id='$parent_name' value='$parent' />\n";
1861      }
1862  
1863      return $item;
1864  }
1865  
1866  /**
1867   * @since 3.5.0
1868   *
1869   * @param int   $attachment_id
1870   * @param array $args
1871   * @return array
1872   */
1873  function get_compat_media_markup( $attachment_id, $args = null ) {
1874      $post = get_post( $attachment_id );
1875  
1876      $default_args = array(
1877          'errors'   => null,
1878          'in_modal' => false,
1879      );
1880  
1881      $user_can_edit = current_user_can( 'edit_post', $attachment_id );
1882  
1883      $args = wp_parse_args( $args, $default_args );
1884  
1885      /** This filter is documented in wp-admin/includes/media.php */
1886      $args = apply_filters( 'get_media_item_args', $args );
1887  
1888      $form_fields = array();
1889  
1890      if ( $args['in_modal'] ) {
1891          foreach ( get_attachment_taxonomies( $post ) as $taxonomy ) {
1892              $t = (array) get_taxonomy( $taxonomy );
1893  
1894              if ( ! $t['public'] || ! $t['show_ui'] ) {
1895                  continue;
1896              }
1897  
1898              if ( empty( $t['label'] ) ) {
1899                  $t['label'] = $taxonomy;
1900              }
1901  
1902              if ( empty( $t['args'] ) ) {
1903                  $t['args'] = array();
1904              }
1905  
1906              $terms = get_object_term_cache( $post->ID, $taxonomy );
1907  
1908              if ( false === $terms ) {
1909                  $terms = wp_get_object_terms( $post->ID, $taxonomy, $t['args'] );
1910              }
1911  
1912              $values = array();
1913  
1914              foreach ( $terms as $term ) {
1915                  $values[] = $term->slug;
1916              }
1917  
1918              $t['value']    = implode( ', ', $values );
1919              $t['taxonomy'] = true;
1920  
1921              $form_fields[ $taxonomy ] = $t;
1922          }
1923      }
1924  
1925      /*
1926       * Merge default fields with their errors, so any key passed with the error
1927       * (e.g. 'error', 'helps', 'value') will replace the default.
1928       * The recursive merge is easily traversed with array casting:
1929       * foreach ( (array) $things as $thing )
1930       */
1931      $form_fields = array_merge_recursive( $form_fields, (array) $args['errors'] );
1932  
1933      /** This filter is documented in wp-admin/includes/media.php */
1934      $form_fields = apply_filters( 'attachment_fields_to_edit', $form_fields, $post );
1935  
1936      unset(
1937          $form_fields['image-size'],
1938          $form_fields['align'],
1939          $form_fields['image_alt'],
1940          $form_fields['post_title'],
1941          $form_fields['post_excerpt'],
1942          $form_fields['post_content'],
1943          $form_fields['url'],
1944          $form_fields['menu_order'],
1945          $form_fields['image_url']
1946      );
1947  
1948      /** This filter is documented in wp-admin/includes/media.php */
1949      $media_meta = apply_filters( 'media_meta', '', $post );
1950  
1951      $defaults = array(
1952          'input'         => 'text',
1953          'required'      => false,
1954          'value'         => '',
1955          'extra_rows'    => array(),
1956          'show_in_edit'  => true,
1957          'show_in_modal' => true,
1958      );
1959  
1960      $hidden_fields = array();
1961  
1962      $item = '';
1963  
1964      foreach ( $form_fields as $id => $field ) {
1965          if ( '_' === $id[0] ) {
1966              continue;
1967          }
1968  
1969          $name    = "attachments[$attachment_id][$id]";
1970          $id_attr = "attachments-$attachment_id-$id";
1971  
1972          if ( ! empty( $field['tr'] ) ) {
1973              $item .= $field['tr'];
1974              continue;
1975          }
1976  
1977          $field = array_merge( $defaults, $field );
1978  
1979          if ( ( ! $field['show_in_edit'] && ! $args['in_modal'] ) || ( ! $field['show_in_modal'] && $args['in_modal'] ) ) {
1980              continue;
1981          }
1982  
1983          if ( 'hidden' === $field['input'] ) {
1984              $hidden_fields[ $name ] = $field['value'];
1985              continue;
1986          }
1987  
1988          $readonly      = ! $user_can_edit && ! empty( $field['taxonomy'] ) ? " readonly='readonly' " : '';
1989          $required      = $field['required'] ? ' ' . wp_required_field_indicator() : '';
1990          $required_attr = $field['required'] ? ' required' : '';
1991          $class         = 'compat-field-' . $id;
1992          $class        .= $field['required'] ? ' form-required' : '';
1993  
1994          $item .= "\t\t<tr class='$class'>";
1995          $item .= "\t\t\t<th scope='row' class='label'><label for='$id_attr'><span class='alignleft'>{$field['label']}</span>$required<br class='clear' /></label>";
1996          $item .= "</th>\n\t\t\t<td class='field'>";
1997  
1998          if ( ! empty( $field[ $field['input'] ] ) ) {
1999              $item .= $field[ $field['input'] ];
2000          } elseif ( 'textarea' === $field['input'] ) {
2001              if ( 'post_content' === $id && user_can_richedit() ) {
2002                  // sanitize_post() skips the post_content when user_can_richedit.
2003                  $field['value'] = htmlspecialchars( $field['value'], ENT_QUOTES );
2004              }
2005              $item .= "<textarea id='$id_attr' name='$name'{$required_attr}>" . $field['value'] . '</textarea>';
2006          } else {
2007              $item .= "<input type='text' class='text' id='$id_attr' name='$name' value='" . esc_attr( $field['value'] ) . "' $readonly{$required_attr} />";
2008          }
2009  
2010          if ( ! empty( $field['helps'] ) ) {
2011              $item .= "<p class='help'>" . implode( "</p>\n<p class='help'>", array_unique( (array) $field['helps'] ) ) . '</p>';
2012          }
2013  
2014          $item .= "</td>\n\t\t</tr>\n";
2015  
2016          $extra_rows = array();
2017  
2018          if ( ! empty( $field['errors'] ) ) {
2019              foreach ( array_unique( (array) $field['errors'] ) as $error ) {
2020                  $extra_rows['error'][] = $error;
2021              }
2022          }
2023  
2024          if ( ! empty( $field['extra_rows'] ) ) {
2025              foreach ( $field['extra_rows'] as $class => $rows ) {
2026                  foreach ( (array) $rows as $html ) {
2027                      $extra_rows[ $class ][] = $html;
2028                  }
2029              }
2030          }
2031  
2032          foreach ( $extra_rows as $class => $rows ) {
2033              foreach ( $rows as $html ) {
2034                  $item .= "\t\t<tr><td></td><td class='$class'>$html</td></tr>\n";
2035              }
2036          }
2037      }
2038  
2039      if ( ! empty( $form_fields['_final'] ) ) {
2040          $item .= "\t\t<tr class='final'><td colspan='2'>{$form_fields['_final']}</td></tr>\n";
2041      }
2042  
2043      if ( $item ) {
2044          $item = '<p class="media-types media-types-required-info">' .
2045              wp_required_field_message() .
2046              '</p>' .
2047              '<table class="compat-attachment-fields">' . $item . '</table>';
2048      }
2049  
2050      foreach ( $hidden_fields as $hidden_field => $value ) {
2051          $item .= '<input type="hidden" name="' . esc_attr( $hidden_field ) . '" value="' . esc_attr( $value ) . '" />' . "\n";
2052      }
2053  
2054      if ( $item ) {
2055          $item = '<input type="hidden" name="attachments[' . $attachment_id . '][menu_order]" value="' . esc_attr( $post->menu_order ) . '" />' . $item;
2056      }
2057  
2058      return array(
2059          'item' => $item,
2060          'meta' => $media_meta,
2061      );
2062  }
2063  
2064  /**
2065   * Outputs the legacy media upload header.
2066   *
2067   * @since 2.5.0
2068   */
2069  function media_upload_header() {
2070      $post_id = isset( $_REQUEST['post_id'] ) ? (int) $_REQUEST['post_id'] : 0;
2071  
2072      echo '<script type="text/javascript">post_id = ' . $post_id . ';</script>';
2073  
2074      if ( empty( $_GET['chromeless'] ) ) {
2075          echo '<div id="media-upload-header">';
2076          the_media_upload_tabs();
2077          echo '</div>';
2078      }
2079  }
2080  
2081  /**
2082   * Outputs the legacy media upload form.
2083   *
2084   * @since 2.5.0
2085   *
2086   * @global string $type
2087   * @global string $tab
2088   *
2089   * @param array $errors
2090   */
2091  function media_upload_form( $errors = null ) {
2092      global $type, $tab;
2093  
2094      if ( ! _device_can_upload() ) {
2095          echo '<p>' . sprintf(
2096              /* translators: %s: https://apps.wordpress.org/ */
2097              __( 'The web browser on your device cannot be used to upload files. You may be able to use the <a href="%s">native app for your device</a> instead.' ),
2098              'https://apps.wordpress.org/'
2099          ) . '</p>';
2100          return;
2101      }
2102  
2103      $upload_action_url = admin_url( 'async-upload.php' );
2104      $post_id           = isset( $_REQUEST['post_id'] ) ? (int) $_REQUEST['post_id'] : 0;
2105      $_type             = isset( $type ) ? $type : '';
2106      $_tab              = isset( $tab ) ? $tab : '';
2107  
2108      $max_upload_size = wp_max_upload_size();
2109      if ( ! $max_upload_size ) {
2110          $max_upload_size = 0;
2111      }
2112  
2113      ?>
2114      <div id="media-upload-notice">
2115      <?php
2116  
2117      if ( isset( $errors['upload_notice'] ) ) {
2118          echo $errors['upload_notice'];
2119      }
2120  
2121      ?>
2122      </div>
2123      <div id="media-upload-error">
2124      <?php
2125  
2126      if ( isset( $errors['upload_error'] ) && is_wp_error( $errors['upload_error'] ) ) {
2127          echo $errors['upload_error']->get_error_message();
2128      }
2129  
2130      ?>
2131      </div>
2132      <?php
2133  
2134      if ( is_multisite() && ! is_upload_space_available() ) {
2135          /**
2136           * Fires when an upload will exceed the defined upload space quota for a network site.
2137           *
2138           * @since 3.5.0
2139           */
2140          do_action( 'upload_ui_over_quota' );
2141          return;
2142      }
2143  
2144      /**
2145       * Fires just before the legacy (pre-3.5.0) upload interface is loaded.
2146       *
2147       * @since 2.6.0
2148       */
2149      do_action( 'pre-upload-ui' ); // phpcs:ignore WordPress.NamingConventions.ValidHookName.UseUnderscores
2150  
2151      $post_params = array(
2152          'post_id'  => $post_id,
2153          '_wpnonce' => wp_create_nonce( 'media-form' ),
2154          'type'     => $_type,
2155          'tab'      => $_tab,
2156          'short'    => '1',
2157      );
2158  
2159      /**
2160       * Filters the media upload post parameters.
2161       *
2162       * @since 3.1.0 As 'swfupload_post_params'
2163       * @since 3.3.0
2164       *
2165       * @param array $post_params An array of media upload parameters used by Plupload.
2166       */
2167      $post_params = apply_filters( 'upload_post_params', $post_params );
2168  
2169      /*
2170      * Since 4.9 the `runtimes` setting is hardcoded in our version of Plupload to `html5,html4`,
2171      * and the `flash_swf_url` and `silverlight_xap_url` are not used.
2172      */
2173      $plupload_init = array(
2174          'browse_button'    => 'plupload-browse-button',
2175          'container'        => 'plupload-upload-ui',
2176          'drop_element'     => 'drag-drop-area',
2177          'file_data_name'   => 'async-upload',
2178          'url'              => $upload_action_url,
2179          'filters'          => array( 'max_file_size' => $max_upload_size . 'b' ),
2180          'multipart_params' => $post_params,
2181      );
2182  
2183      /*
2184       * Currently only iOS Safari supports multiple files uploading,
2185       * but iOS 7.x has a bug that prevents uploading of videos when enabled.
2186       * See #29602.
2187       */
2188      if (
2189          wp_is_mobile() &&
2190          str_contains( $_SERVER['HTTP_USER_AGENT'], 'OS 7_' ) &&
2191          str_contains( $_SERVER['HTTP_USER_AGENT'], 'like Mac OS X' )
2192      ) {
2193          $plupload_init['multi_selection'] = false;
2194      }
2195  
2196      // Check if WebP images can be edited.
2197      if ( ! wp_image_editor_supports( array( 'mime_type' => 'image/webp' ) ) ) {
2198          $plupload_init['webp_upload_error'] = true;
2199      }
2200  
2201      // Check if AVIF images can be edited.
2202      if ( ! wp_image_editor_supports( array( 'mime_type' => 'image/avif' ) ) ) {
2203          $plupload_init['avif_upload_error'] = true;
2204      }
2205  
2206      /**
2207       * Filters the default Plupload settings.
2208       *
2209       * @since 3.3.0
2210       *
2211       * @param array $plupload_init An array of default settings used by Plupload.
2212       */
2213      $plupload_init = apply_filters( 'plupload_init', $plupload_init );
2214  
2215      ?>
2216      <script type="text/javascript">
2217      <?php
2218      // Verify size is an int. If not return default value.
2219      $large_size_h = absint( get_option( 'large_size_h' ) );
2220  
2221      if ( ! $large_size_h ) {
2222          $large_size_h = 1024;
2223      }
2224  
2225      $large_size_w = absint( get_option( 'large_size_w' ) );
2226  
2227      if ( ! $large_size_w ) {
2228          $large_size_w = 1024;
2229      }
2230  
2231      ?>
2232      var resize_height = <?php echo $large_size_h; ?>, resize_width = <?php echo $large_size_w; ?>,
2233      wpUploaderInit = <?php echo wp_json_encode( $plupload_init ); ?>;
2234      </script>
2235  
2236      <div id="plupload-upload-ui" class="hide-if-no-js">
2237      <?php
2238      /**
2239       * Fires before the upload interface loads.
2240       *
2241       * @since 2.6.0 As 'pre-flash-upload-ui'
2242       * @since 3.3.0
2243       */
2244      do_action( 'pre-plupload-upload-ui' ); // phpcs:ignore WordPress.NamingConventions.ValidHookName.UseUnderscores
2245  
2246      ?>
2247      <div id="drag-drop-area">
2248          <div class="drag-drop-inside">
2249          <p class="drag-drop-info"><?php _e( 'Drop files to upload' ); ?></p>
2250          <p><?php _ex( 'or', 'Uploader: Drop files here - or - Select Files' ); ?></p>
2251          <p class="drag-drop-buttons"><input id="plupload-browse-button" type="button" value="<?php esc_attr_e( 'Select Files' ); ?>" class="button" /></p>
2252          </div>
2253      </div>
2254      <?php
2255      /**
2256       * Fires after the upload interface loads.
2257       *
2258       * @since 2.6.0 As 'post-flash-upload-ui'
2259       * @since 3.3.0
2260       */
2261      do_action( 'post-plupload-upload-ui' ); // phpcs:ignore WordPress.NamingConventions.ValidHookName.UseUnderscores
2262      ?>
2263      </div>
2264  
2265      <div id="html-upload-ui" class="hide-if-js">
2266      <?php
2267      /**
2268       * Fires before the upload button in the media upload interface.
2269       *
2270       * @since 2.6.0
2271       */
2272      do_action( 'pre-html-upload-ui' ); // phpcs:ignore WordPress.NamingConventions.ValidHookName.UseUnderscores
2273  
2274      ?>
2275      <p id="async-upload-wrap">
2276          <label class="screen-reader-text" for="async-upload">
2277              <?php
2278              /* translators: Hidden accessibility text. */
2279              _e( 'Upload' );
2280              ?>
2281          </label>
2282          <input type="file" name="async-upload" id="async-upload" />
2283          <?php submit_button( __( 'Upload' ), 'primary', 'html-upload', false ); ?>
2284          <a href="#" onclick="try{top.tb_remove();}catch(e){}; return false;"><?php _e( 'Cancel' ); ?></a>
2285      </p>
2286      <div class="clear"></div>
2287      <?php
2288      /**
2289       * Fires after the upload button in the media upload interface.
2290       *
2291       * @since 2.6.0
2292       */
2293      do_action( 'post-html-upload-ui' ); // phpcs:ignore WordPress.NamingConventions.ValidHookName.UseUnderscores
2294  
2295      ?>
2296      </div>
2297  
2298  <p class="max-upload-size">
2299      <?php
2300      /* translators: %s: Maximum allowed file size. */
2301      printf( __( 'Maximum upload file size: %s.' ), esc_html( size_format( $max_upload_size ) ) );
2302      ?>
2303  </p>
2304      <?php
2305  
2306      /**
2307       * Fires on the post upload UI screen.
2308       *
2309       * Legacy (pre-3.5.0) media workflow hook.
2310       *
2311       * @since 2.6.0
2312       */
2313      do_action( 'post-upload-ui' ); // phpcs:ignore WordPress.NamingConventions.ValidHookName.UseUnderscores
2314  }
2315  
2316  /**
2317   * Outputs the legacy media upload form for a given media type.
2318   *
2319   * @since 2.5.0
2320   *
2321   * @param string       $type
2322   * @param array        $errors
2323   * @param int|WP_Error $id
2324   */
2325  function media_upload_type_form( $type = 'file', $errors = null, $id = null ) {
2326  
2327      media_upload_header();
2328  
2329      $post_id = isset( $_REQUEST['post_id'] ) ? (int) $_REQUEST['post_id'] : 0;
2330  
2331      $form_action_url = admin_url( "media-upload.php?type=$type&tab=type&post_id=$post_id" );
2332  
2333      /**
2334       * Filters the media upload form action URL.
2335       *
2336       * @since 2.6.0
2337       *
2338       * @param string $form_action_url The media upload form action URL.
2339       * @param string $type            The type of media. Default 'file'.
2340       */
2341      $form_action_url = apply_filters( 'media_upload_form_url', $form_action_url, $type );
2342      $form_class      = 'media-upload-form type-form validate';
2343  
2344      if ( get_user_setting( 'uploader' ) ) {
2345          $form_class .= ' html-uploader';
2346      }
2347  
2348      ?>
2349      <form enctype="multipart/form-data" method="post" action="<?php echo esc_url( $form_action_url ); ?>" class="<?php echo $form_class; ?>" id="<?php echo $type; ?>-form">
2350          <?php submit_button( '', 'hidden', 'save', false ); ?>
2351      <input type="hidden" name="post_id" id="post_id" value="<?php echo (int) $post_id; ?>" />
2352          <?php wp_nonce_field( 'media-form' ); ?>
2353  
2354      <h3 class="media-title"><?php _e( 'Add media files from your computer' ); ?></h3>
2355  
2356      <?php media_upload_form( $errors ); ?>
2357  
2358      <script type="text/javascript">
2359      jQuery(function($){
2360          var preloaded = $(".media-item.preloaded");
2361          if ( preloaded.length > 0 ) {
2362              preloaded.each(function(){prepareMediaItem({id:this.id.replace(/[^0-9]/g, '')},'');});
2363          }
2364          updateMediaForm();
2365      });
2366      </script>
2367      <div id="media-items">
2368      <?php
2369  
2370      if ( $id ) {
2371          if ( ! is_wp_error( $id ) ) {
2372              add_filter( 'attachment_fields_to_edit', 'media_post_single_attachment_fields_to_edit', 10, 2 );
2373              echo get_media_items( $id, $errors );
2374          } else {
2375              echo '<div id="media-upload-error">' . esc_html( $id->get_error_message() ) . '</div></div>';
2376              exit;
2377          }
2378      }
2379  
2380      ?>
2381      </div>
2382  
2383      <p class="savebutton ml-submit">
2384          <?php submit_button( __( 'Save all changes' ), '', 'save', false ); ?>
2385      </p>
2386      </form>
2387      <?php
2388  }
2389  
2390  /**
2391   * Outputs the legacy media upload form for external media.
2392   *
2393   * @since 2.7.0
2394   *
2395   * @param string  $type
2396   * @param object  $errors
2397   * @param int     $id
2398   */
2399  function media_upload_type_url_form( $type = null, $errors = null, $id = null ) {
2400      if ( null === $type ) {
2401          $type = 'image';
2402      }
2403  
2404      media_upload_header();
2405  
2406      $post_id = isset( $_REQUEST['post_id'] ) ? (int) $_REQUEST['post_id'] : 0;
2407  
2408      $form_action_url = admin_url( "media-upload.php?type=$type&tab=type&post_id=$post_id" );
2409      /** This filter is documented in wp-admin/includes/media.php */
2410      $form_action_url = apply_filters( 'media_upload_form_url', $form_action_url, $type );
2411      $form_class      = 'media-upload-form type-form validate';
2412  
2413      if ( get_user_setting( 'uploader' ) ) {
2414          $form_class .= ' html-uploader';
2415      }
2416  
2417      ?>
2418      <form enctype="multipart/form-data" method="post" action="<?php echo esc_url( $form_action_url ); ?>" class="<?php echo $form_class; ?>" id="<?php echo $type; ?>-form">
2419      <input type="hidden" name="post_id" id="post_id" value="<?php echo (int) $post_id; ?>" />
2420          <?php wp_nonce_field( 'media-form' ); ?>
2421  
2422      <h3 class="media-title"><?php _e( 'Insert media from another website' ); ?></h3>
2423  
2424      <script type="text/javascript">
2425      var addExtImage = {
2426  
2427      width : '',
2428      height : '',
2429      align : 'alignnone',
2430  
2431      insert : function() {
2432          var t = this, html, f = document.forms[0], cls, title = '', alt = '', caption = '';
2433  
2434          if ( '' === f.src.value || '' === t.width )
2435              return false;
2436  
2437          if ( f.alt.value )
2438              alt = f.alt.value.replace(/'/g, '&#039;').replace(/"/g, '&quot;').replace(/</g, '&lt;').replace(/>/g, '&gt;');
2439  
2440          <?php
2441          /** This filter is documented in wp-admin/includes/media.php */
2442          if ( ! apply_filters( 'disable_captions', '' ) ) {
2443              ?>
2444              if ( f.caption.value ) {
2445                  caption = f.caption.value.replace(/\r\n|\r/g, '\n');
2446                  caption = caption.replace(/<[a-zA-Z0-9]+( [^<>]+)?>/g, function(a){
2447                      return a.replace(/[\r\n\t]+/, ' ');
2448                  });
2449  
2450                  caption = caption.replace(/\s*\n\s*/g, '<br />');
2451              }
2452              <?php
2453          }
2454  
2455          ?>
2456          cls = caption ? '' : ' class="'+t.align+'"';
2457  
2458          html = '<img alt="'+alt+'" src="'+f.src.value+'"'+cls+' width="'+t.width+'" height="'+t.height+'" />';
2459  
2460          if ( f.url.value ) {
2461              url = f.url.value.replace(/'/g, '&#039;').replace(/"/g, '&quot;').replace(/</g, '&lt;').replace(/>/g, '&gt;');
2462              html = '<a href="'+url+'">'+html+'</a>';
2463          }
2464  
2465          if ( caption )
2466              html = '[caption id="" align="'+t.align+'" width="'+t.width+'"]'+html+caption+'[/caption]';
2467  
2468          var win = window.dialogArguments || opener || parent || top;
2469          win.send_to_editor(html);
2470          return false;
2471      },
2472  
2473      resetImageData : function() {
2474          var t = addExtImage;
2475  
2476          t.width = t.height = '';
2477          document.getElementById('go_button').style.color = '#bbb';
2478          if ( ! document.forms[0].src.value )
2479              document.getElementById('status_img').innerHTML = '';
2480          else document.getElementById('status_img').innerHTML = '<img src="<?php echo esc_url( admin_url( 'images/no.png' ) ); ?>" alt="" />';
2481      },
2482  
2483      updateImageData : function() {
2484          var t = addExtImage;
2485  
2486          t.width = t.preloadImg.width;
2487          t.height = t.preloadImg.height;
2488          document.getElementById('go_button').style.color = '#333';
2489          document.getElementById('status_img').innerHTML = '<img src="<?php echo esc_url( admin_url( 'images/yes.png' ) ); ?>" alt="" />';
2490      },
2491  
2492      getImageData : function() {
2493          if ( jQuery('table.describe').hasClass('not-image') )
2494              return;
2495  
2496          var t = addExtImage, src = document.forms[0].src.value;
2497  
2498          if ( ! src ) {
2499              t.resetImageData();
2500              return false;
2501          }
2502  
2503          document.getElementById('status_img').innerHTML = '<img src="<?php echo esc_url( admin_url( 'images/spinner-2x.gif' ) ); ?>" alt="" width="16" height="16" />';
2504          t.preloadImg = new Image();
2505          t.preloadImg.onload = t.updateImageData;
2506          t.preloadImg.onerror = t.resetImageData;
2507          t.preloadImg.src = src;
2508      }
2509      };
2510  
2511      jQuery( function($) {
2512          $('.media-types input').click( function() {
2513              $('table.describe').toggleClass('not-image', $('#not-image').prop('checked') );
2514          });
2515      } );
2516      </script>
2517  
2518      <div id="media-items">
2519      <div class="media-item media-blank">
2520      <?php
2521      /**
2522       * Filters the insert media from URL form HTML.
2523       *
2524       * @since 3.3.0
2525       *
2526       * @param string $form_html The insert from URL form HTML.
2527       */
2528      echo apply_filters( 'type_url_form_media', wp_media_insert_url_form( $type ) );
2529  
2530      ?>
2531      </div>
2532      </div>
2533      </form>
2534      <?php
2535  }
2536  
2537  /**
2538   * Adds gallery form to upload iframe.
2539   *
2540   * @since 2.5.0
2541   *
2542   * @global string $redir_tab
2543   * @global string $type
2544   * @global string $tab
2545   *
2546   * @param array $errors
2547   */
2548  function media_upload_gallery_form( $errors ) {
2549      global $redir_tab, $type;
2550  
2551      $redir_tab = 'gallery';
2552      media_upload_header();
2553  
2554      $post_id         = (int) $_REQUEST['post_id'];
2555      $form_action_url = admin_url( "media-upload.php?type=$type&tab=gallery&post_id=$post_id" );
2556      /** This filter is documented in wp-admin/includes/media.php */
2557      $form_action_url = apply_filters( 'media_upload_form_url', $form_action_url, $type );
2558      $form_class      = 'media-upload-form validate';
2559  
2560      if ( get_user_setting( 'uploader' ) ) {
2561          $form_class .= ' html-uploader';
2562      }
2563  
2564      ?>
2565      <script type="text/javascript">
2566      jQuery(function($){
2567          var preloaded = $(".media-item.preloaded");
2568          if ( preloaded.length > 0 ) {
2569              preloaded.each(function(){prepareMediaItem({id:this.id.replace(/[^0-9]/g, '')},'');});
2570              updateMediaForm();
2571          }
2572      });
2573      </script>
2574      <div id="sort-buttons" class="hide-if-no-js">
2575      <span>
2576          <?php _e( 'All Tabs:' ); ?>
2577      <a href="#" id="showall"><?php _e( 'Show' ); ?></a>
2578      <a href="#" id="hideall" style="display:none;"><?php _e( 'Hide' ); ?></a>
2579      </span>
2580          <?php _e( 'Sort Order:' ); ?>
2581      <a href="#" id="asc"><?php _e( 'Ascending' ); ?></a> |
2582      <a href="#" id="desc"><?php _e( 'Descending' ); ?></a> |
2583      <a href="#" id="clear"><?php _ex( 'Clear', 'verb' ); ?></a>
2584      </div>
2585      <form enctype="multipart/form-data" method="post" action="<?php echo esc_url( $form_action_url ); ?>" class="<?php echo $form_class; ?>" id="gallery-form">
2586          <?php wp_nonce_field( 'media-form' ); ?>
2587      <table class="widefat">
2588      <thead><tr>
2589      <th><?php _e( 'Media' ); ?></th>
2590      <th class="order-head"><?php _e( 'Order' ); ?></th>
2591      <th class="actions-head"><?php _e( 'Actions' ); ?></th>
2592      </tr></thead>
2593      </table>
2594      <div id="media-items">
2595          <?php add_filter( 'attachment_fields_to_edit', 'media_post_single_attachment_fields_to_edit', 10, 2 ); ?>
2596          <?php echo get_media_items( $post_id, $errors ); ?>
2597      </div>
2598  
2599      <p class="ml-submit">
2600          <?php
2601          submit_button(
2602              __( 'Save all changes' ),
2603              'savebutton',
2604              'save',
2605              false,
2606              array(
2607                  'id'    => 'save-all',
2608                  'style' => 'display: none;',
2609              )
2610          );
2611          ?>
2612      <input type="hidden" name="post_id" id="post_id" value="<?php echo (int) $post_id; ?>" />
2613      <input type="hidden" name="type" value="<?php echo esc_attr( $GLOBALS['type'] ); ?>" />
2614      <input type="hidden" name="tab" value="<?php echo esc_attr( $GLOBALS['tab'] ); ?>" />
2615      </p>
2616  
2617      <div id="gallery-settings" style="display:none;">
2618      <div class="title"><?php _e( 'Gallery Settings' ); ?></div>
2619      <table id="basic" class="describe"><tbody>
2620          <tr>
2621          <th scope="row" class="label">
2622              <label>
2623              <span class="alignleft"><?php _e( 'Link thumbnails to:' ); ?></span>
2624              </label>
2625          </th>
2626          <td class="field">
2627              <input type="radio" name="linkto" id="linkto-file" value="file" />
2628              <label for="linkto-file" class="radio"><?php _e( 'Image File' ); ?></label>
2629  
2630              <input type="radio" checked="checked" name="linkto" id="linkto-post" value="post" />
2631              <label for="linkto-post" class="radio"><?php _e( 'Attachment Page' ); ?></label>
2632          </td>
2633          </tr>
2634  
2635          <tr>
2636          <th scope="row" class="label">
2637              <label>
2638              <span class="alignleft"><?php _e( 'Order images by:' ); ?></span>
2639              </label>
2640          </th>
2641          <td class="field">
2642              <select id="orderby" name="orderby">
2643                  <option value="menu_order" selected="selected"><?php _e( 'Menu order' ); ?></option>
2644                  <option value="title"><?php _e( 'Title' ); ?></option>
2645                  <option value="post_date"><?php _e( 'Date/Time' ); ?></option>
2646                  <option value="rand"><?php _e( 'Random' ); ?></option>
2647              </select>
2648          </td>
2649          </tr>
2650  
2651          <tr>
2652          <th scope="row" class="label">
2653              <label>
2654              <span class="alignleft"><?php _e( 'Order:' ); ?></span>
2655              </label>
2656          </th>
2657          <td class="field">
2658              <input type="radio" checked="checked" name="order" id="order-asc" value="asc" />
2659              <label for="order-asc" class="radio"><?php _e( 'Ascending' ); ?></label>
2660  
2661              <input type="radio" name="order" id="order-desc" value="desc" />
2662              <label for="order-desc" class="radio"><?php _e( 'Descending' ); ?></label>
2663          </td>
2664          </tr>
2665  
2666          <tr>
2667          <th scope="row" class="label">
2668              <label>
2669              <span class="alignleft"><?php _e( 'Gallery columns:' ); ?></span>
2670              </label>
2671          </th>
2672          <td class="field">
2673              <select id="columns" name="columns">
2674                  <option value="1">1</option>
2675                  <option value="2">2</option>
2676                  <option value="3" selected="selected">3</option>
2677                  <option value="4">4</option>
2678                  <option value="5">5</option>
2679                  <option value="6">6</option>
2680                  <option value="7">7</option>
2681                  <option value="8">8</option>
2682                  <option value="9">9</option>
2683              </select>
2684          </td>
2685          </tr>
2686      </tbody></table>
2687  
2688      <p class="ml-submit">
2689      <input type="button" class="button" style="display:none;" onMouseDown="wpgallery.update();" name="insert-gallery" id="insert-gallery" value="<?php esc_attr_e( 'Insert gallery' ); ?>" />
2690      <input type="button" class="button" style="display:none;" onMouseDown="wpgallery.update();" name="update-gallery" id="update-gallery" value="<?php esc_attr_e( 'Update gallery settings' ); ?>" />
2691      </p>
2692      </div>
2693      </form>
2694      <?php
2695  }
2696  
2697  /**
2698   * Outputs the legacy media upload form for the media library.
2699   *
2700   * @since 2.5.0
2701   *
2702   * @global wpdb      $wpdb            WordPress database abstraction object.
2703   * @global WP_Query  $wp_query        WordPress Query object.
2704   * @global WP_Locale $wp_locale       WordPress date and time locale object.
2705   * @global string    $type
2706   * @global string    $tab
2707   * @global array     $post_mime_types
2708   *
2709   * @param array $errors
2710   */
2711  function media_upload_library_form( $errors ) {
2712      global $wpdb, $wp_query, $wp_locale, $type, $tab, $post_mime_types;
2713  
2714      media_upload_header();
2715  
2716      $post_id = isset( $_REQUEST['post_id'] ) ? (int) $_REQUEST['post_id'] : 0;
2717  
2718      $form_action_url = admin_url( "media-upload.php?type=$type&tab=library&post_id=$post_id" );
2719      /** This filter is documented in wp-admin/includes/media.php */
2720      $form_action_url = apply_filters( 'media_upload_form_url', $form_action_url, $type );
2721      $form_class      = 'media-upload-form validate';
2722  
2723      if ( get_user_setting( 'uploader' ) ) {
2724          $form_class .= ' html-uploader';
2725      }
2726  
2727      $q                   = $_GET;
2728      $q['posts_per_page'] = 10;
2729      $q['paged']          = isset( $q['paged'] ) ? (int) $q['paged'] : 0;
2730      if ( $q['paged'] < 1 ) {
2731          $q['paged'] = 1;
2732      }
2733      $q['offset'] = ( $q['paged'] - 1 ) * 10;
2734      if ( $q['offset'] < 1 ) {
2735          $q['offset'] = 0;
2736      }
2737  
2738      list($post_mime_types, $avail_post_mime_types) = wp_edit_attachments_query( $q );
2739  
2740      ?>
2741      <form id="filter" method="get">
2742      <input type="hidden" name="type" value="<?php echo esc_attr( $type ); ?>" />
2743      <input type="hidden" name="tab" value="<?php echo esc_attr( $tab ); ?>" />
2744      <input type="hidden" name="post_id" value="<?php echo (int) $post_id; ?>" />
2745      <input type="hidden" name="post_mime_type" value="<?php echo isset( $_GET['post_mime_type'] ) ? esc_attr( $_GET['post_mime_type'] ) : ''; ?>" />
2746      <input type="hidden" name="context" value="<?php echo isset( $_GET['context'] ) ? esc_attr( $_GET['context'] ) : ''; ?>" />
2747  
2748      <p id="media-search" class="search-box">
2749          <label class="screen-reader-text" for="media-search-input">
2750              <?php
2751              /* translators: Hidden accessibility text. */
2752              _e( 'Search Media:' );
2753              ?>
2754          </label>
2755          <input type="search" id="media-search-input" name="s" value="<?php the_search_query(); ?>" />
2756          <?php submit_button( __( 'Search Media' ), '', '', false ); ?>
2757      </p>
2758  
2759      <ul class="subsubsub">
2760          <?php
2761          $type_links = array();
2762          $_num_posts = (array) wp_count_attachments();
2763          $matches    = wp_match_mime_types( array_keys( $post_mime_types ), array_keys( $_num_posts ) );
2764          foreach ( $matches as $_type => $reals ) {
2765              foreach ( $reals as $real ) {
2766                  if ( isset( $num_posts[ $_type ] ) ) {
2767                      $num_posts[ $_type ] += $_num_posts[ $real ];
2768                  } else {
2769                      $num_posts[ $_type ] = $_num_posts[ $real ];
2770                  }
2771              }
2772          }
2773          // If available type specified by media button clicked, filter by that type.
2774          if ( empty( $_GET['post_mime_type'] ) && ! empty( $num_posts[ $type ] ) ) {
2775              $_GET['post_mime_type']                        = $type;
2776              list($post_mime_types, $avail_post_mime_types) = wp_edit_attachments_query();
2777          }
2778          if ( empty( $_GET['post_mime_type'] ) || 'all' === $_GET['post_mime_type'] ) {
2779              $class = ' class="current"';
2780          } else {
2781              $class = '';
2782          }
2783          $type_links[] = '<li><a href="' . esc_url(
2784              add_query_arg(
2785                  array(
2786                      'post_mime_type' => 'all',
2787                      'paged'          => false,
2788                      'm'              => false,
2789                  )
2790              )
2791          ) . '"' . $class . '>' . __( 'All Types' ) . '</a>';
2792          foreach ( $post_mime_types as $mime_type => $label ) {
2793              $class = '';
2794  
2795              if ( ! wp_match_mime_types( $mime_type, $avail_post_mime_types ) ) {
2796                  continue;
2797              }
2798  
2799              if ( isset( $_GET['post_mime_type'] ) && wp_match_mime_types( $mime_type, $_GET['post_mime_type'] ) ) {
2800                  $class = ' class="current"';
2801              }
2802  
2803              $type_links[] = '<li><a href="' . esc_url(
2804                  add_query_arg(
2805                      array(
2806                          'post_mime_type' => $mime_type,
2807                          'paged'          => false,
2808                      )
2809                  )
2810              ) . '"' . $class . '>' . sprintf( translate_nooped_plural( $label[2], $num_posts[ $mime_type ] ), '<span id="' . $mime_type . '-counter">' . number_format_i18n( $num_posts[ $mime_type ] ) . '</span>' ) . '</a>';
2811          }
2812          /**
2813           * Filters the media upload mime type list items.
2814           *
2815           * Returned values should begin with an `<li>` tag.
2816           *
2817           * @since 3.1.0
2818           *
2819           * @param string[] $type_links An array of list items containing mime type link HTML.
2820           */
2821          echo implode( ' | </li>', apply_filters( 'media_upload_mime_type_links', $type_links ) ) . '</li>';
2822          unset( $type_links );
2823          ?>
2824      </ul>
2825  
2826      <div class="tablenav">
2827  
2828          <?php
2829          $page_links = paginate_links(
2830              array(
2831                  'base'      => add_query_arg( 'paged', '%#%' ),
2832                  'format'    => '',
2833                  'prev_text' => __( '&laquo;' ),
2834                  'next_text' => __( '&raquo;' ),
2835                  'total'     => (int) ceil( $wp_query->found_posts / 10 ),
2836                  'current'   => $q['paged'],
2837              )
2838          );
2839  
2840          if ( $page_links ) {
2841              echo "<div class='tablenav-pages'>$page_links</div>";
2842          }
2843          ?>
2844  
2845      <div class="alignleft actions">
2846          <?php
2847  
2848          $arc_query = "SELECT DISTINCT YEAR(post_date) AS yyear, MONTH(post_date) AS mmonth FROM $wpdb->posts WHERE post_type = 'attachment' ORDER BY post_date DESC";
2849  
2850          $arc_result = $wpdb->get_results( $arc_query );
2851  
2852          $month_count    = count( $arc_result );
2853          $selected_month = isset( $_GET['m'] ) ? $_GET['m'] : 0;
2854  
2855          if ( $month_count && ! ( 1 == $month_count && 0 == $arc_result[0]->mmonth ) ) {
2856              ?>
2857              <select name='m'>
2858              <option<?php selected( $selected_month, 0 ); ?> value='0'><?php _e( 'All dates' ); ?></option>
2859              <?php
2860  
2861              foreach ( $arc_result as $arc_row ) {
2862                  if ( 0 == $arc_row->yyear ) {
2863                      continue;
2864                  }
2865  
2866                  $arc_row->mmonth = zeroise( $arc_row->mmonth, 2 );
2867  
2868                  if ( $arc_row->yyear . $arc_row->mmonth == $selected_month ) {
2869                      $default = ' selected="selected"';
2870                  } else {
2871                      $default = '';
2872                  }
2873  
2874                  echo "<option$default value='" . esc_attr( $arc_row->yyear . $arc_row->mmonth ) . "'>";
2875                  echo esc_html( $wp_locale->get_month( $arc_row->mmonth ) . " $arc_row->yyear" );
2876                  echo "</option>\n";
2877              }
2878  
2879              ?>
2880              </select>
2881          <?php } ?>
2882  
2883          <?php submit_button( __( 'Filter &#187;' ), '', 'post-query-submit', false ); ?>
2884  
2885      </div>
2886  
2887      <br class="clear" />
2888      </div>
2889      </form>
2890  
2891      <form enctype="multipart/form-data" method="post" action="<?php echo esc_url( $form_action_url ); ?>" class="<?php echo $form_class; ?>" id="library-form">
2892      <?php wp_nonce_field( 'media-form' ); ?>
2893  
2894      <script type="text/javascript">
2895      jQuery(function($){
2896          var preloaded = $(".media-item.preloaded");
2897          if ( preloaded.length > 0 ) {
2898              preloaded.each(function(){prepareMediaItem({id:this.id.replace(/[^0-9]/g, '')},'');});
2899              updateMediaForm();
2900          }
2901      });
2902      </script>
2903  
2904      <div id="media-items">
2905          <?php add_filter( 'attachment_fields_to_edit', 'media_post_single_attachment_fields_to_edit', 10, 2 ); ?>
2906          <?php echo get_media_items( null, $errors ); ?>
2907      </div>
2908      <p class="ml-submit">
2909          <?php submit_button( __( 'Save all changes' ), 'savebutton', 'save', false ); ?>
2910      <input type="hidden" name="post_id" id="post_id" value="<?php echo (int) $post_id; ?>" />
2911      </p>
2912      </form>
2913      <?php
2914  }
2915  
2916  /**
2917   * Creates the form for external url.
2918   *
2919   * @since 2.7.0
2920   *
2921   * @param string $default_view
2922   * @return string HTML content of the form.
2923   */
2924  function wp_media_insert_url_form( $default_view = 'image' ) {
2925      /** This filter is documented in wp-admin/includes/media.php */
2926      if ( ! apply_filters( 'disable_captions', '' ) ) {
2927          $caption = '
2928          <tr class="image-only">
2929              <th scope="row" class="label">
2930                  <label for="caption"><span class="alignleft">' . __( 'Image Caption' ) . '</span></label>
2931              </th>
2932              <td class="field"><textarea id="caption" name="caption"></textarea></td>
2933          </tr>';
2934      } else {
2935          $caption = '';
2936      }
2937  
2938      $default_align = get_option( 'image_default_align' );
2939  
2940      if ( empty( $default_align ) ) {
2941          $default_align = 'none';
2942      }
2943  
2944      if ( 'image' === $default_view ) {
2945          $view        = 'image-only';
2946          $table_class = '';
2947      } else {
2948          $view        = 'not-image';
2949          $table_class = $view;
2950      }
2951  
2952      return '
2953      <p class="media-types"><label><input type="radio" name="media_type" value="image" id="image-only"' . checked( 'image-only', $view, false ) . ' /> ' . __( 'Image' ) . '</label> &nbsp; &nbsp; <label><input type="radio" name="media_type" value="generic" id="not-image"' . checked( 'not-image', $view, false ) . ' /> ' . __( 'Audio, Video, or Other File' ) . '</label></p>
2954      <p class="media-types media-types-required-info">' .
2955          wp_required_field_message() .
2956      '</p>
2957      <table class="describe ' . $table_class . '"><tbody>
2958          <tr>
2959              <th scope="row" class="label" style="width:130px;">
2960                  <label for="src"><span class="alignleft">' . __( 'URL' ) . '</span> ' . wp_required_field_indicator() . '</label>
2961                  <span class="alignright" id="status_img"></span>
2962              </th>
2963              <td class="field"><input id="src" name="src" value="" type="text" required onblur="addExtImage.getImageData()" /></td>
2964          </tr>
2965  
2966          <tr>
2967              <th scope="row" class="label">
2968                  <label for="title"><span class="alignleft">' . __( 'Title' ) . '</span> ' . wp_required_field_indicator() . '</label>
2969              </th>
2970              <td class="field"><input id="title" name="title" value="" type="text" required /></td>
2971          </tr>
2972  
2973          <tr class="not-image"><td></td><td><p class="help">' . __( 'Link text, e.g. &#8220;Ransom Demands (PDF)&#8221;' ) . '</p></td></tr>
2974  
2975          <tr class="image-only">
2976              <th scope="row" class="label">
2977                  <label for="alt"><span class="alignleft">' . __( 'Alternative Text' ) . '</span> ' . wp_required_field_indicator() . '</label>
2978              </th>
2979              <td class="field"><input id="alt" name="alt" value="" type="text" required />
2980              <p class="help">' . __( 'Alt text for the image, e.g. &#8220;The Mona Lisa&#8221;' ) . '</p></td>
2981          </tr>
2982          ' . $caption . '
2983          <tr class="align image-only">
2984              <th scope="row" class="label"><p><label for="align">' . __( 'Alignment' ) . '</label></p></th>
2985              <td class="field">
2986                  <input name="align" id="align-none" value="none" onclick="addExtImage.align=\'align\'+this.value" type="radio"' . ( 'none' === $default_align ? ' checked="checked"' : '' ) . ' />
2987                  <label for="align-none" class="align image-align-none-label">' . __( 'None' ) . '</label>
2988                  <input name="align" id="align-left" value="left" onclick="addExtImage.align=\'align\'+this.value" type="radio"' . ( 'left' === $default_align ? ' checked="checked"' : '' ) . ' />
2989                  <label for="align-left" class="align image-align-left-label">' . __( 'Left' ) . '</label>
2990                  <input name="align" id="align-center" value="center" onclick="addExtImage.align=\'align\'+this.value" type="radio"' . ( 'center' === $default_align ? ' checked="checked"' : '' ) . ' />
2991                  <label for="align-center" class="align image-align-center-label">' . __( 'Center' ) . '</label>
2992                  <input name="align" id="align-right" value="right" onclick="addExtImage.align=\'align\'+this.value" type="radio"' . ( 'right' === $default_align ? ' checked="checked"' : '' ) . ' />
2993                  <label for="align-right" class="align image-align-right-label">' . __( 'Right' ) . '</label>
2994              </td>
2995          </tr>
2996  
2997          <tr class="image-only">
2998              <th scope="row" class="label">
2999                  <label for="url"><span class="alignleft">' . __( 'Link Image To:' ) . '</span></label>
3000              </th>
3001              <td class="field"><input id="url" name="url" value="" type="text" /><br />
3002  
3003              <button type="button" class="button" value="" onclick="document.forms[0].url.value=null">' . __( 'None' ) . '</button>
3004              <button type="button" class="button" value="" onclick="document.forms[0].url.value=document.forms[0].src.value">' . __( 'Link to image' ) . '</button>
3005              <p class="help">' . __( 'Enter a link URL or click above for presets.' ) . '</p></td>
3006          </tr>
3007          <tr class="image-only">
3008              <td></td>
3009              <td>
3010                  <input type="button" class="button" id="go_button" style="color:#bbb;" onclick="addExtImage.insert()" value="' . esc_attr__( 'Insert into Post' ) . '" />
3011              </td>
3012          </tr>
3013          <tr class="not-image">
3014              <td></td>
3015              <td>
3016                  ' . get_submit_button( __( 'Insert into Post' ), '', 'insertonlybutton', false ) . '
3017              </td>
3018          </tr>
3019      </tbody></table>';
3020  }
3021  
3022  /**
3023   * Displays the multi-file uploader message.
3024   *
3025   * @since 2.6.0
3026   *
3027   * @global int $post_ID
3028   */
3029  function media_upload_flash_bypass() {
3030      $browser_uploader = admin_url( 'media-new.php?browser-uploader' );
3031  
3032      $post = get_post();
3033      if ( $post ) {
3034          $browser_uploader .= '&amp;post_id=' . (int) $post->ID;
3035      } elseif ( ! empty( $GLOBALS['post_ID'] ) ) {
3036          $browser_uploader .= '&amp;post_id=' . (int) $GLOBALS['post_ID'];
3037      }
3038  
3039      ?>
3040      <p class="upload-flash-bypass">
3041      <?php
3042          printf(
3043              /* translators: 1: URL to browser uploader, 2: Additional link attributes. */
3044              __( 'You are using the multi-file uploader. Problems? Try the <a href="%1$s" %2$s>browser uploader</a> instead.' ),
3045              $browser_uploader,
3046              'target="_blank"'
3047          );
3048      ?>
3049      </p>
3050      <?php
3051  }
3052  
3053  /**
3054   * Displays the browser's built-in uploader message.
3055   *
3056   * @since 2.6.0
3057   */
3058  function media_upload_html_bypass() {
3059      ?>
3060      <p class="upload-html-bypass hide-if-no-js">
3061          <?php _e( 'You are using the browser&#8217;s built-in file uploader. The WordPress uploader includes multiple file selection and drag and drop capability. <a href="#">Switch to the multi-file uploader</a>.' ); ?>
3062      </p>
3063      <?php
3064  }
3065  
3066  /**
3067   * Used to display a "After a file has been uploaded..." help message.
3068   *
3069   * @since 3.3.0
3070   */
3071  function media_upload_text_after() {}
3072  
3073  /**
3074   * Displays the checkbox to scale images.
3075   *
3076   * @since 3.3.0
3077   */
3078  function media_upload_max_image_resize() {
3079      $checked = get_user_setting( 'upload_resize' ) ? ' checked="true"' : '';
3080      $a       = '';
3081      $end     = '';
3082  
3083      if ( current_user_can( 'manage_options' ) ) {
3084          $a   = '<a href="' . esc_url( admin_url( 'options-media.php' ) ) . '" target="_blank">';
3085          $end = '</a>';
3086      }
3087  
3088      ?>
3089      <p class="hide-if-no-js"><label>
3090      <input name="image_resize" type="checkbox" id="image_resize" value="true"<?php echo $checked; ?> />
3091      <?php
3092      /* translators: 1: Link start tag, 2: Link end tag, 3: Width, 4: Height. */
3093      printf( __( 'Scale images to match the large size selected in %1$simage options%2$s (%3$d &times; %4$d).' ), $a, $end, (int) get_option( 'large_size_w', '1024' ), (int) get_option( 'large_size_h', '1024' ) );
3094  
3095      ?>
3096      </label></p>
3097      <?php
3098  }
3099  
3100  /**
3101   * Displays the out of storage quota message in Multisite.
3102   *
3103   * @since 3.5.0
3104   */
3105  function multisite_over_quota_message() {
3106      echo '<p>' . sprintf(
3107          /* translators: %s: Allowed space allocation. */
3108          __( 'Sorry, you have used your space allocation of %s. Please delete some files to upload more files.' ),
3109          size_format( get_space_allowed() * MB_IN_BYTES )
3110      ) . '</p>';
3111  }
3112  
3113  /**
3114   * Displays the image and editor in the post editor
3115   *
3116   * @since 3.5.0
3117   *
3118   * @param WP_Post $post A post object.
3119   */
3120  function edit_form_image_editor( $post ) {
3121      $open = isset( $_GET['image-editor'] );
3122  
3123      if ( $open ) {
3124          require_once  ABSPATH . 'wp-admin/includes/image-edit.php';
3125      }
3126  
3127      $thumb_url     = false;
3128      $attachment_id = (int) $post->ID;
3129  
3130      if ( $attachment_id ) {
3131          $thumb_url = wp_get_attachment_image_src( $attachment_id, array( 900, 450 ), true );
3132      }
3133  
3134      $alt_text = get_post_meta( $post->ID, '_wp_attachment_image_alt', true );
3135  
3136      $att_url = wp_get_attachment_url( $post->ID );
3137      ?>
3138      <div class="wp_attachment_holder wp-clearfix">
3139      <?php
3140  
3141      if ( wp_attachment_is_image( $post->ID ) ) :
3142          $image_edit_button = '';
3143          if ( wp_image_editor_supports( array( 'mime_type' => $post->post_mime_type ) ) ) {
3144              $nonce             = wp_create_nonce( "image_editor-$post->ID" );
3145              $image_edit_button = "<input type='button' id='imgedit-open-btn-$post->ID' onclick='imageEdit.open( $post->ID, \"$nonce\" )' class='button' value='" . esc_attr__( 'Edit Image' ) . "' /> <span class='spinner'></span>";
3146          }
3147  
3148          $open_style     = '';
3149          $not_open_style = '';
3150  
3151          if ( $open ) {
3152              $open_style = ' style="display:none"';
3153          } else {
3154              $not_open_style = ' style="display:none"';
3155          }
3156  
3157          ?>
3158          <div class="imgedit-response" id="imgedit-response-<?php echo $attachment_id; ?>"></div>
3159  
3160          <div<?php echo $open_style; ?> class="wp_attachment_image wp-clearfix" id="media-head-<?php echo $attachment_id; ?>">
3161              <p id="thumbnail-head-<?php echo $attachment_id; ?>"><img class="thumbnail" src="<?php echo set_url_scheme( $thumb_url[0] ); ?>" style="max-width:100%" alt="" /></p>
3162              <p><?php echo $image_edit_button; ?></p>
3163          </div>
3164          <div<?php echo $not_open_style; ?> class="image-editor" id="image-editor-<?php echo $attachment_id; ?>">
3165          <?php
3166  
3167          if ( $open ) {
3168              wp_image_editor( $attachment_id );
3169          }
3170  
3171          ?>
3172          </div>
3173          <?php
3174      elseif ( $attachment_id && wp_attachment_is( 'audio', $post ) ) :
3175  
3176          wp_maybe_generate_attachment_metadata( $post );
3177  
3178          echo wp_audio_shortcode( array( 'src' => $att_url ) );
3179  
3180      elseif ( $attachment_id && wp_attachment_is( 'video', $post ) ) :
3181  
3182          wp_maybe_generate_attachment_metadata( $post );
3183  
3184          $meta = wp_get_attachment_metadata( $attachment_id );
3185          $w    = ! empty( $meta['width'] ) ? min( $meta['width'], 640 ) : 0;
3186          $h    = ! empty( $meta['height'] ) ? $meta['height'] : 0;
3187  
3188          if ( $h && $w < $meta['width'] ) {
3189              $h = round( ( $meta['height'] * $w ) / $meta['width'] );
3190          }
3191  
3192          $attr = array( 'src' => $att_url );
3193  
3194          if ( ! empty( $w ) && ! empty( $h ) ) {
3195              $attr['width']  = $w;
3196              $attr['height'] = $h;
3197          }
3198  
3199          $thumb_id = get_post_thumbnail_id( $attachment_id );
3200  
3201          if ( ! empty( $thumb_id ) ) {
3202              $attr['poster'] = wp_get_attachment_url( $thumb_id );
3203          }
3204  
3205          echo wp_video_shortcode( $attr );
3206  
3207      elseif ( isset( $thumb_url[0] ) ) :
3208          ?>
3209          <div class="wp_attachment_image wp-clearfix" id="media-head-<?php echo $attachment_id; ?>">
3210              <p id="thumbnail-head-<?php echo $attachment_id; ?>">
3211                  <img class="thumbnail" src="<?php echo set_url_scheme( $thumb_url[0] ); ?>" style="max-width:100%" alt="" />
3212              </p>
3213          </div>
3214          <?php
3215  
3216      else :
3217  
3218          /**
3219           * Fires when an attachment type can't be rendered in the edit form.
3220           *
3221           * @since 4.6.0
3222           *
3223           * @param WP_Post $post A post object.
3224           */
3225          do_action( 'wp_edit_form_attachment_display', $post );
3226  
3227      endif;
3228  
3229      ?>
3230      </div>
3231      <div class="wp_attachment_details edit-form-section">
3232      <?php if ( str_starts_with( $post->post_mime_type, 'image' ) ) : ?>
3233          <p class="attachment-alt-text">
3234              <label for="attachment_alt"><strong><?php _e( 'Alternative Text' ); ?></strong></label><br />
3235              <textarea class="widefat" name="_wp_attachment_image_alt" id="attachment_alt" aria-describedby="alt-text-description"><?php echo esc_attr( $alt_text ); ?></textarea>
3236          </p>
3237          <p class="attachment-alt-text-description" id="alt-text-description">
3238          <?php
3239  
3240          printf(
3241              /* translators: 1: Link to tutorial, 2: Additional link attributes, 3: Accessibility text. */
3242              __( '<a href="%1$s" %2$s>Learn how to describe the purpose of the image%3$s</a>. Leave empty if the image is purely decorative.' ),
3243              esc_url( 'https://www.w3.org/WAI/tutorials/images/decision-tree' ),
3244              'target="_blank" rel="noopener"',
3245              sprintf(
3246                  '<span class="screen-reader-text"> %s</span>',
3247                  /* translators: Hidden accessibility text. */
3248                  __( '(opens in a new tab)' )
3249              )
3250          );
3251  
3252          ?>
3253          </p>
3254      <?php endif; ?>
3255  
3256          <p>
3257              <label for="attachment_caption"><strong><?php _e( 'Caption' ); ?></strong></label><br />
3258              <textarea class="widefat" name="excerpt" id="attachment_caption"><?php echo $post->post_excerpt; ?></textarea>
3259          </p>
3260  
3261      <?php
3262  
3263      $quicktags_settings = array( 'buttons' => 'strong,em,link,block,del,ins,img,ul,ol,li,code,close' );
3264      $editor_args        = array(
3265          'textarea_name' => 'content',
3266          'textarea_rows' => 5,
3267          'media_buttons' => false,
3268          'tinymce'       => false,
3269          'quicktags'     => $quicktags_settings,
3270      );
3271  
3272      ?>
3273  
3274      <label for="attachment_content" class="attachment-content-description"><strong><?php _e( 'Description' ); ?></strong>
3275      <?php
3276  
3277      if ( preg_match( '#^(audio|video)/#', $post->post_mime_type ) ) {
3278          echo ': ' . __( 'Displayed on attachment pages.' );
3279      }
3280  
3281      ?>
3282      </label>
3283      <?php wp_editor( format_to_edit( $post->post_content ), 'attachment_content', $editor_args ); ?>
3284  
3285      </div>
3286      <?php
3287  
3288      $extras = get_compat_media_markup( $post->ID );
3289      echo $extras['item'];
3290      echo '<input type="hidden" id="image-edit-context" value="edit-attachment" />' . "\n";
3291  }
3292  
3293  /**
3294   * Displays non-editable attachment metadata in the publish meta box.
3295   *
3296   * @since 3.5.0
3297   */
3298  function attachment_submitbox_metadata() {
3299      $post          = get_post();
3300      $attachment_id = $post->ID;
3301  
3302      $file     = get_attached_file( $attachment_id );
3303      $filename = esc_html( wp_basename( $file ) );
3304  
3305      $media_dims = '';
3306      $meta       = wp_get_attachment_metadata( $attachment_id );
3307  
3308      if ( isset( $meta['width'], $meta['height'] ) ) {
3309          $media_dims .= "<span id='media-dims-$attachment_id'>{$meta['width']}&nbsp;&times;&nbsp;{$meta['height']}</span> ";
3310      }
3311      /** This filter is documented in wp-admin/includes/media.php */
3312      $media_dims = apply_filters( 'media_meta', $media_dims, $post );
3313  
3314      $att_url = wp_get_attachment_url( $attachment_id );
3315  
3316      $author = new WP_User( $post->post_author );
3317  
3318      $uploaded_by_name = __( '(no author)' );
3319      $uploaded_by_link = '';
3320  
3321      if ( $author->exists() ) {
3322          $uploaded_by_name = $author->display_name ? $author->display_name : $author->nickname;
3323          $uploaded_by_link = get_edit_user_link( $author->ID );
3324      }
3325      ?>
3326      <div class="misc-pub-section misc-pub-uploadedby">
3327          <?php if ( $uploaded_by_link ) { ?>
3328              <?php _e( 'Uploaded by:' ); ?> <a href="<?php echo $uploaded_by_link; ?>"><strong><?php echo $uploaded_by_name; ?></strong></a>
3329          <?php } else { ?>
3330              <?php _e( 'Uploaded by:' ); ?> <strong><?php echo $uploaded_by_name; ?></strong>
3331          <?php } ?>
3332      </div>
3333  
3334      <?php
3335      if ( $post->post_parent ) {
3336          $post_parent = get_post( $post->post_parent );
3337          if ( $post_parent ) {
3338              $uploaded_to_title = $post_parent->post_title ? $post_parent->post_title : __( '(no title)' );
3339              $uploaded_to_link  = get_edit_post_link( $post->post_parent, 'raw' );
3340              ?>
3341              <div class="misc-pub-section misc-pub-uploadedto">
3342                  <?php if ( $uploaded_to_link ) { ?>
3343                      <?php _e( 'Uploaded to:' ); ?> <a href="<?php echo $uploaded_to_link; ?>"><strong><?php echo $uploaded_to_title; ?></strong></a>
3344                  <?php } else { ?>
3345                      <?php _e( 'Uploaded to:' ); ?> <strong><?php echo $uploaded_to_title; ?></strong>
3346                  <?php } ?>
3347              </div>
3348              <?php
3349          }
3350      }
3351      ?>
3352  
3353      <div class="misc-pub-section misc-pub-attachment">
3354          <label for="attachment_url"><?php _e( 'File URL:' ); ?></label>
3355          <input type="text" class="widefat urlfield" readonly="readonly" name="attachment_url" id="attachment_url" value="<?php echo esc_attr( $att_url ); ?>" />
3356          <span class="copy-to-clipboard-container">
3357              <button type="button" class="button copy-attachment-url edit-media" data-clipboard-target="#attachment_url"><?php _e( 'Copy URL to clipboard' ); ?></button>
3358              <span class="success hidden" aria-hidden="true"><?php _e( 'Copied!' ); ?></span>
3359          </span>
3360      </div>
3361      <div class="misc-pub-section misc-pub-download">
3362          <a href="<?php echo esc_attr( $att_url ); ?>" download><?php _e( 'Download file' ); ?></a>
3363      </div>
3364      <div class="misc-pub-section misc-pub-filename">
3365          <?php _e( 'File name:' ); ?> <strong><?php echo $filename; ?></strong>
3366      </div>
3367      <div class="misc-pub-section misc-pub-filetype">
3368          <?php _e( 'File type:' ); ?>
3369          <strong>
3370          <?php
3371  
3372          if ( preg_match( '/^.*?\.(\w+)$/', get_attached_file( $post->ID ), $matches ) ) {
3373              echo esc_html( strtoupper( $matches[1] ) );
3374              list( $mime_type ) = explode( '/', $post->post_mime_type );
3375              if ( 'image' !== $mime_type && ! empty( $meta['mime_type'] ) ) {
3376                  if ( "$mime_type/" . strtolower( $matches[1] ) !== $meta['mime_type'] ) {
3377                      echo ' (' . $meta['mime_type'] . ')';
3378                  }
3379              }
3380          } else {
3381              echo strtoupper( str_replace( 'image/', '', $post->post_mime_type ) );
3382          }
3383  
3384          ?>
3385          </strong>
3386      </div>
3387  
3388      <?php
3389  
3390      $file_size = false;
3391  
3392      if ( isset( $meta['filesize'] ) ) {
3393          $file_size = $meta['filesize'];
3394      } elseif ( file_exists( $file ) ) {
3395          $file_size = wp_filesize( $file );
3396      }
3397  
3398      if ( ! empty( $file_size ) ) {
3399          ?>
3400          <div class="misc-pub-section misc-pub-filesize">
3401              <?php _e( 'File size:' ); ?> <strong><?php echo size_format( $file_size ); ?></strong>
3402          </div>
3403          <?php
3404      }
3405  
3406      if ( preg_match( '#^(audio|video)/#', $post->post_mime_type ) ) {
3407          $fields = array(
3408              'length_formatted' => __( 'Length:' ),
3409              'bitrate'          => __( 'Bitrate:' ),
3410          );
3411  
3412          /**
3413           * Filters the audio and video metadata fields to be shown in the publish meta box.
3414           *
3415           * The key for each item in the array should correspond to an attachment
3416           * metadata key, and the value should be the desired label.
3417           *
3418           * @since 3.7.0
3419           * @since 4.9.0 Added the `$post` parameter.
3420           *
3421           * @param array   $fields An array of the attachment metadata keys and labels.
3422           * @param WP_Post $post   WP_Post object for the current attachment.
3423           */
3424          $fields = apply_filters( 'media_submitbox_misc_sections', $fields, $post );
3425  
3426          foreach ( $fields as $key => $label ) {
3427              if ( empty( $meta[ $key ] ) ) {
3428                  continue;
3429              }
3430  
3431              ?>
3432              <div class="misc-pub-section misc-pub-mime-meta misc-pub-<?php echo sanitize_html_class( $key ); ?>">
3433                  <?php echo $label; ?>
3434                  <strong>
3435                  <?php
3436  
3437                  switch ( $key ) {
3438                      case 'bitrate':
3439                          echo round( $meta['bitrate'] / 1000 ) . 'kb/s';
3440                          if ( ! empty( $meta['bitrate_mode'] ) ) {
3441                              echo ' ' . strtoupper( esc_html( $meta['bitrate_mode'] ) );
3442                          }
3443                          break;
3444                      default:
3445                          echo esc_html( $meta[ $key ] );
3446                          break;
3447                  }
3448  
3449                  ?>
3450                  </strong>
3451              </div>
3452              <?php
3453          }
3454  
3455          $fields = array(
3456              'dataformat' => __( 'Audio Format:' ),
3457              'codec'      => __( 'Audio Codec:' ),
3458          );
3459  
3460          /**
3461           * Filters the audio attachment metadata fields to be shown in the publish meta box.
3462           *
3463           * The key for each item in the array should correspond to an attachment
3464           * metadata key, and the value should be the desired label.
3465           *
3466           * @since 3.7.0
3467           * @since 4.9.0 Added the `$post` parameter.
3468           *
3469           * @param array   $fields An array of the attachment metadata keys and labels.
3470           * @param WP_Post $post   WP_Post object for the current attachment.
3471           */
3472          $audio_fields = apply_filters( 'audio_submitbox_misc_sections', $fields, $post );
3473  
3474          foreach ( $audio_fields as $key => $label ) {
3475              if ( empty( $meta['audio'][ $key ] ) ) {
3476                  continue;
3477              }
3478  
3479              ?>
3480              <div class="misc-pub-section misc-pub-audio misc-pub-<?php echo sanitize_html_class( $key ); ?>">
3481                  <?php echo $label; ?> <strong><?php echo esc_html( $meta['audio'][ $key ] ); ?></strong>
3482              </div>
3483              <?php
3484          }
3485      }
3486  
3487      if ( $media_dims ) {
3488          ?>
3489          <div class="misc-pub-section misc-pub-dimensions">
3490              <?php _e( 'Dimensions:' ); ?> <strong><?php echo $media_dims; ?></strong>
3491          </div>
3492          <?php
3493      }
3494  
3495      if ( ! empty( $meta['original_image'] ) ) {
3496          ?>
3497          <div class="misc-pub-section misc-pub-original-image word-wrap-break-word">
3498              <?php _e( 'Original image:' ); ?>
3499              <a href="<?php echo esc_url( wp_get_original_image_url( $attachment_id ) ); ?>">
3500                  <strong><?php echo esc_html( wp_basename( wp_get_original_image_path( $attachment_id ) ) ); ?></strong>
3501              </a>
3502          </div>
3503          <?php
3504      }
3505  }
3506  
3507  /**
3508   * Parses ID3v2, ID3v1, and getID3 comments to extract usable data.
3509   *
3510   * @since 3.6.0
3511   *
3512   * @param array $metadata An existing array with data.
3513   * @param array $data Data supplied by ID3 tags.
3514   */
3515  function wp_add_id3_tag_data( &$metadata, $data ) {
3516      foreach ( array( 'id3v2', 'id3v1' ) as $version ) {
3517          if ( ! empty( $data[ $version ]['comments'] ) ) {
3518              foreach ( $data[ $version ]['comments'] as $key => $list ) {
3519                  if ( 'length' !== $key && ! empty( $list ) ) {
3520                      $metadata[ $key ] = wp_kses_post( reset( $list ) );
3521                      // Fix bug in byte stream analysis.
3522                      if ( 'terms_of_use' === $key && str_starts_with( $metadata[ $key ], 'yright notice.' ) ) {
3523                          $metadata[ $key ] = 'Cop' . $metadata[ $key ];
3524                      }
3525                  }
3526              }
3527              break;
3528          }
3529      }
3530  
3531      if ( ! empty( $data['id3v2']['APIC'] ) ) {
3532          $image = reset( $data['id3v2']['APIC'] );
3533          if ( ! empty( $image['data'] ) ) {
3534              $metadata['image'] = array(
3535                  'data'   => $image['data'],
3536                  'mime'   => $image['image_mime'],
3537                  'width'  => $image['image_width'],
3538                  'height' => $image['image_height'],
3539              );
3540          }
3541      } elseif ( ! empty( $data['comments']['picture'] ) ) {
3542          $image = reset( $data['comments']['picture'] );
3543          if ( ! empty( $image['data'] ) ) {
3544              $metadata['image'] = array(
3545                  'data' => $image['data'],
3546                  'mime' => $image['image_mime'],
3547              );
3548          }
3549      }
3550  }
3551  
3552  /**
3553   * Retrieves metadata from a video file's ID3 tags.
3554   *
3555   * @since 3.6.0
3556   *
3557   * @param string $file Path to file.
3558   * @return array|false Returns array of metadata, if found.
3559   */
3560  function wp_read_video_metadata( $file ) {
3561      if ( ! file_exists( $file ) ) {
3562          return false;
3563      }
3564  
3565      $metadata = array();
3566  
3567      if ( ! defined( 'GETID3_TEMP_DIR' ) ) {
3568          define( 'GETID3_TEMP_DIR', get_temp_dir() );
3569      }
3570  
3571      if ( ! class_exists( 'getID3', false ) ) {
3572          require ABSPATH . WPINC . '/ID3/getid3.php';
3573      }
3574  
3575      $id3 = new getID3();
3576      // Required to get the `created_timestamp` value.
3577      $id3->options_audiovideo_quicktime_ReturnAtomData = true; // phpcs:ignore WordPress.NamingConventions.ValidVariableName
3578  
3579      $data = $id3->analyze( $file );
3580  
3581      if ( isset( $data['video']['lossless'] ) ) {
3582          $metadata['lossless'] = $data['video']['lossless'];
3583      }
3584  
3585      if ( ! empty( $data['video']['bitrate'] ) ) {
3586          $metadata['bitrate'] = (int) $data['video']['bitrate'];
3587      }
3588  
3589      if ( ! empty( $data['video']['bitrate_mode'] ) ) {
3590          $metadata['bitrate_mode'] = $data['video']['bitrate_mode'];
3591      }
3592  
3593      if ( ! empty( $data['filesize'] ) ) {
3594          $metadata['filesize'] = (int) $data['filesize'];
3595      }
3596  
3597      if ( ! empty( $data['mime_type'] ) ) {
3598          $metadata['mime_type'] = $data['mime_type'];
3599      }
3600  
3601      if ( ! empty( $data['playtime_seconds'] ) ) {
3602          $metadata['length'] = (int) round( $data['playtime_seconds'] );
3603      }
3604  
3605      if ( ! empty( $data['playtime_string'] ) ) {
3606          $metadata['length_formatted'] = $data['playtime_string'];
3607      }
3608  
3609      if ( ! empty( $data['video']['resolution_x'] ) ) {
3610          $metadata['width'] = (int) $data['video']['resolution_x'];
3611      }
3612  
3613      if ( ! empty( $data['video']['resolution_y'] ) ) {
3614          $metadata['height'] = (int) $data['video']['resolution_y'];
3615      }
3616  
3617      if ( ! empty( $data['fileformat'] ) ) {
3618          $metadata['fileformat'] = $data['fileformat'];
3619      }
3620  
3621      if ( ! empty( $data['video']['dataformat'] ) ) {
3622          $metadata['dataformat'] = $data['video']['dataformat'];
3623      }
3624  
3625      if ( ! empty( $data['video']['encoder'] ) ) {
3626          $metadata['encoder'] = $data['video']['encoder'];
3627      }
3628  
3629      if ( ! empty( $data['video']['codec'] ) ) {
3630          $metadata['codec'] = $data['video']['codec'];
3631      }
3632  
3633      if ( ! empty( $data['audio'] ) ) {
3634          unset( $data['audio']['streams'] );
3635          $metadata['audio'] = $data['audio'];
3636      }
3637  
3638      if ( empty( $metadata['created_timestamp'] ) ) {
3639          $created_timestamp = wp_get_media_creation_timestamp( $data );
3640  
3641          if ( false !== $created_timestamp ) {
3642              $metadata['created_timestamp'] = $created_timestamp;
3643          }
3644      }
3645  
3646      wp_add_id3_tag_data( $metadata, $data );
3647  
3648      $file_format = isset( $metadata['fileformat'] ) ? $metadata['fileformat'] : null;
3649  
3650      /**
3651       * Filters the array of metadata retrieved from a video.
3652       *
3653       * In core, usually this selection is what is stored.
3654       * More complete data can be parsed from the `$data` parameter.
3655       *
3656       * @since 4.9.0
3657       *
3658       * @param array       $metadata    Filtered video metadata.
3659       * @param string      $file        Path to video file.
3660       * @param string|null $file_format File format of video, as analyzed by getID3.
3661       *                                 Null if unknown.
3662       * @param array       $data        Raw metadata from getID3.
3663       */
3664      return apply_filters( 'wp_read_video_metadata', $metadata, $file, $file_format, $data );
3665  }
3666  
3667  /**
3668   * Retrieves metadata from an audio file's ID3 tags.
3669   *
3670   * @since 3.6.0
3671   *
3672   * @param string $file Path to file.
3673   * @return array|false Returns array of metadata, if found.
3674   */
3675  function wp_read_audio_metadata( $file ) {
3676      if ( ! file_exists( $file ) ) {
3677          return false;
3678      }
3679  
3680      $metadata = array();
3681  
3682      if ( ! defined( 'GETID3_TEMP_DIR' ) ) {
3683          define( 'GETID3_TEMP_DIR', get_temp_dir() );
3684      }
3685  
3686      if ( ! class_exists( 'getID3', false ) ) {
3687          require ABSPATH . WPINC . '/ID3/getid3.php';
3688      }
3689  
3690      $id3 = new getID3();
3691      // Required to get the `created_timestamp` value.
3692      $id3->options_audiovideo_quicktime_ReturnAtomData = true; // phpcs:ignore WordPress.NamingConventions.ValidVariableName
3693  
3694      $data = $id3->analyze( $file );
3695  
3696      if ( ! empty( $data['audio'] ) ) {
3697          unset( $data['audio']['streams'] );
3698          $metadata = $data['audio'];
3699      }
3700  
3701      if ( ! empty( $data['fileformat'] ) ) {
3702          $metadata['fileformat'] = $data['fileformat'];
3703      }
3704  
3705      if ( ! empty( $data['filesize'] ) ) {
3706          $metadata['filesize'] = (int) $data['filesize'];
3707      }
3708  
3709      if ( ! empty( $data['mime_type'] ) ) {
3710          $metadata['mime_type'] = $data['mime_type'];
3711      }
3712  
3713      if ( ! empty( $data['playtime_seconds'] ) ) {
3714          $metadata['length'] = (int) round( $data['playtime_seconds'] );
3715      }
3716  
3717      if ( ! empty( $data['playtime_string'] ) ) {
3718          $metadata['length_formatted'] = $data['playtime_string'];
3719      }
3720  
3721      if ( empty( $metadata['created_timestamp'] ) ) {
3722          $created_timestamp = wp_get_media_creation_timestamp( $data );
3723  
3724          if ( false !== $created_timestamp ) {
3725              $metadata['created_timestamp'] = $created_timestamp;
3726          }
3727      }
3728  
3729      wp_add_id3_tag_data( $metadata, $data );
3730  
3731      $file_format = isset( $metadata['fileformat'] ) ? $metadata['fileformat'] : null;
3732  
3733      /**
3734       * Filters the array of metadata retrieved from an audio file.
3735       *
3736       * In core, usually this selection is what is stored.
3737       * More complete data can be parsed from the `$data` parameter.
3738       *
3739       * @since 6.1.0
3740       *
3741       * @param array       $metadata    Filtered audio metadata.
3742       * @param string      $file        Path to audio file.
3743       * @param string|null $file_format File format of audio, as analyzed by getID3.
3744       *                                 Null if unknown.
3745       * @param array       $data        Raw metadata from getID3.
3746       */
3747      return apply_filters( 'wp_read_audio_metadata', $metadata, $file, $file_format, $data );
3748  }
3749  
3750  /**
3751   * Parses creation date from media metadata.
3752   *
3753   * The getID3 library doesn't have a standard method for getting creation dates,
3754   * so the location of this data can vary based on the MIME type.
3755   *
3756   * @since 4.9.0
3757   *
3758   * @link https://github.com/JamesHeinrich/getID3/blob/master/structure.txt
3759   *
3760   * @param array $metadata The metadata returned by getID3::analyze().
3761   * @return int|false A UNIX timestamp for the media's creation date if available
3762   *                   or a boolean FALSE if a timestamp could not be determined.
3763   */
3764  function wp_get_media_creation_timestamp( $metadata ) {
3765      $creation_date = false;
3766  
3767      if ( empty( $metadata['fileformat'] ) ) {
3768          return $creation_date;
3769      }
3770  
3771      switch ( $metadata['fileformat'] ) {
3772          case 'asf':
3773              if ( isset( $metadata['asf']['file_properties_object']['creation_date_unix'] ) ) {
3774                  $creation_date = (int) $metadata['asf']['file_properties_object']['creation_date_unix'];
3775              }
3776              break;
3777  
3778          case 'matroska':
3779          case 'webm':
3780              if ( isset( $metadata['matroska']['comments']['creation_time'][0] ) ) {
3781                  $creation_date = strtotime( $metadata['matroska']['comments']['creation_time'][0] );
3782              } elseif ( isset( $metadata['matroska']['info'][0]['DateUTC_unix'] ) ) {
3783                  $creation_date = (int) $metadata['matroska']['info'][0]['DateUTC_unix'];
3784              }
3785              break;
3786  
3787          case 'quicktime':
3788          case 'mp4':
3789              if ( isset( $metadata['quicktime']['moov']['subatoms'][0]['creation_time_unix'] ) ) {
3790                  $creation_date = (int) $metadata['quicktime']['moov']['subatoms'][0]['creation_time_unix'];
3791              }
3792              break;
3793      }
3794  
3795      return $creation_date;
3796  }
3797  
3798  /**
3799   * Encapsulates the logic for Attach/Detach actions.
3800   *
3801   * @since 4.2.0
3802   *
3803   * @global wpdb $wpdb WordPress database abstraction object.
3804   *
3805   * @param int    $parent_id Attachment parent ID.
3806   * @param string $action    Optional. Attach/detach action. Accepts 'attach' or 'detach'.
3807   *                          Default 'attach'.
3808   */
3809  function wp_media_attach_action( $parent_id, $action = 'attach' ) {
3810      global $wpdb;
3811  
3812      if ( ! $parent_id ) {
3813          return;
3814      }
3815  
3816      if ( ! current_user_can( 'edit_post', $parent_id ) ) {
3817          wp_die( __( 'Sorry, you are not allowed to edit this post.' ) );
3818      }
3819  
3820      $ids = array();
3821  
3822      foreach ( (array) $_REQUEST['media'] as $attachment_id ) {
3823          $attachment_id = (int) $attachment_id;
3824  
3825          if ( ! current_user_can( 'edit_post', $attachment_id ) ) {
3826              continue;
3827          }
3828  
3829          $ids[] = $attachment_id;
3830      }
3831  
3832      if ( ! empty( $ids ) ) {
3833          $ids_string = implode( ',', $ids );
3834  
3835          if ( 'attach' === $action ) {
3836              $result = $wpdb->query( $wpdb->prepare( "UPDATE $wpdb->posts SET post_parent = %d WHERE post_type = 'attachment' AND ID IN ( $ids_string )", $parent_id ) );
3837          } else {
3838              $result = $wpdb->query( "UPDATE $wpdb->posts SET post_parent = 0 WHERE post_type = 'attachment' AND ID IN ( $ids_string )" );
3839          }
3840      }
3841  
3842      if ( isset( $result ) ) {
3843          foreach ( $ids as $attachment_id ) {
3844              /**
3845               * Fires when media is attached or detached from a post.
3846               *
3847               * @since 5.5.0
3848               *
3849               * @param string $action        Attach/detach action. Accepts 'attach' or 'detach'.
3850               * @param int    $attachment_id The attachment ID.
3851               * @param int    $parent_id     Attachment parent ID.
3852               */
3853              do_action( 'wp_media_attach_action', $action, $attachment_id, $parent_id );
3854  
3855              clean_attachment_cache( $attachment_id );
3856          }
3857  
3858          $location = 'upload.php';
3859          $referer  = wp_get_referer();
3860  
3861          if ( $referer ) {
3862              if ( str_contains( $referer, 'upload.php' ) ) {
3863                  $location = remove_query_arg( array( 'attached', 'detach' ), $referer );
3864              }
3865          }
3866  
3867          $key      = 'attach' === $action ? 'attached' : 'detach';
3868          $location = add_query_arg( array( $key => $result ), $location );
3869  
3870          wp_redirect( $location );
3871          exit;
3872      }
3873  }