[ Index ]

PHP Cross Reference of WordPress Trunk (Updated Daily)

Search

title

Body

[close]

/wp-admin/includes/ -> class-wp-media-list-table.php (source)

   1  <?php
   2  /**
   3   * List Table API: WP_Media_List_Table class
   4   *
   5   * @package WordPress
   6   * @subpackage Administration
   7   * @since 3.1.0
   8   */
   9  
  10  /**
  11   * Core class used to implement displaying media items in a list table.
  12   *
  13   * @since 3.1.0
  14   * @access private
  15   *
  16   * @see WP_List_Table
  17   */
  18  class WP_Media_List_Table extends WP_List_Table {
  19      /**
  20       * Holds the number of pending comments for each post.
  21       *
  22       * @since 4.4.0
  23       * @var array
  24       */
  25      protected $comment_pending_count = array();
  26  
  27      private $detached;
  28  
  29      private $is_trash;
  30  
  31      /**
  32       * Constructor.
  33       *
  34       * @since 3.1.0
  35       *
  36       * @see WP_List_Table::__construct() for more information on default arguments.
  37       *
  38       * @param array $args An associative array of arguments.
  39       */
  40  	public function __construct( $args = array() ) {
  41          $this->detached = ( isset( $_REQUEST['attachment-filter'] ) && 'detached' === $_REQUEST['attachment-filter'] );
  42  
  43          $this->modes = array(
  44              'list' => __( 'List view' ),
  45              'grid' => __( 'Grid view' ),
  46          );
  47  
  48          parent::__construct(
  49              array(
  50                  'plural' => 'media',
  51                  'screen' => isset( $args['screen'] ) ? $args['screen'] : null,
  52              )
  53          );
  54      }
  55  
  56      /**
  57       * @return bool
  58       */
  59  	public function ajax_user_can() {
  60          return current_user_can( 'upload_files' );
  61      }
  62  
  63      /**
  64       * @global string   $mode                  List table view mode.
  65       * @global WP_Query $wp_query              WordPress Query object.
  66       * @global array    $post_mime_types
  67       * @global array    $avail_post_mime_types
  68       */
  69  	public function prepare_items() {
  70          global $mode, $wp_query, $post_mime_types, $avail_post_mime_types;
  71  
  72          $mode = empty( $_REQUEST['mode'] ) ? 'list' : $_REQUEST['mode'];
  73  
  74          /*
  75           * Exclude attachments scheduled for deletion in the next two hours
  76           * if they are for zip packages for interrupted or failed updates.
  77           * See File_Upload_Upgrader class.
  78           */
  79          $not_in = array();
  80  
  81          $crons = _get_cron_array();
  82  
  83          if ( is_array( $crons ) ) {
  84              foreach ( $crons as $cron ) {
  85                  if ( isset( $cron['upgrader_scheduled_cleanup'] ) ) {
  86                      $details = reset( $cron['upgrader_scheduled_cleanup'] );
  87  
  88                      if ( ! empty( $details['args'][0] ) ) {
  89                          $not_in[] = (int) $details['args'][0];
  90                      }
  91                  }
  92              }
  93          }
  94  
  95          if ( ! empty( $_REQUEST['post__not_in'] ) && is_array( $_REQUEST['post__not_in'] ) ) {
  96              $not_in = array_merge( array_values( $_REQUEST['post__not_in'] ), $not_in );
  97          }
  98  
  99          if ( ! empty( $not_in ) ) {
 100              $_REQUEST['post__not_in'] = $not_in;
 101          }
 102  
 103          list( $post_mime_types, $avail_post_mime_types ) = wp_edit_attachments_query( $_REQUEST );
 104  
 105          $this->is_trash = isset( $_REQUEST['attachment-filter'] ) && 'trash' === $_REQUEST['attachment-filter'];
 106  
 107          $this->set_pagination_args(
 108              array(
 109                  'total_items' => $wp_query->found_posts,
 110                  'total_pages' => $wp_query->max_num_pages,
 111                  'per_page'    => $wp_query->query_vars['posts_per_page'],
 112              )
 113          );
 114      }
 115  
 116      /**
 117       * @global array $post_mime_types
 118       * @global array $avail_post_mime_types
 119       * @return array
 120       */
 121  	protected function get_views() {
 122          global $post_mime_types, $avail_post_mime_types;
 123  
 124          $type_links = array();
 125  
 126          $filter = empty( $_GET['attachment-filter'] ) ? '' : $_GET['attachment-filter'];
 127  
 128          $type_links['all'] = sprintf(
 129              '<option value=""%s>%s</option>',
 130              selected( $filter, true, false ),
 131              __( 'All media items' )
 132          );
 133  
 134          foreach ( $post_mime_types as $mime_type => $label ) {
 135              if ( ! wp_match_mime_types( $mime_type, $avail_post_mime_types ) ) {
 136                  continue;
 137              }
 138  
 139              $selected = selected(
 140                  $filter && 0 === strpos( $filter, 'post_mime_type:' ) &&
 141                      wp_match_mime_types( $mime_type, str_replace( 'post_mime_type:', '', $filter ) ),
 142                  true,
 143                  false
 144              );
 145  
 146              $type_links[ $mime_type ] = sprintf(
 147                  '<option value="post_mime_type:%s"%s>%s</option>',
 148                  esc_attr( $mime_type ),
 149                  $selected,
 150                  $label[0]
 151              );
 152          }
 153  
 154          $type_links['detached'] = '<option value="detached"' . ( $this->detached ? ' selected="selected"' : '' ) . '>' . _x( 'Unattached', 'media items' ) . '</option>';
 155  
 156          $type_links['mine'] = sprintf(
 157              '<option value="mine"%s>%s</option>',
 158              selected( 'mine' === $filter, true, false ),
 159              _x( 'Mine', 'media items' )
 160          );
 161  
 162          if ( $this->is_trash || ( defined( 'MEDIA_TRASH' ) && MEDIA_TRASH ) ) {
 163              $type_links['trash'] = sprintf(
 164                  '<option value="trash"%s>%s</option>',
 165                  selected( 'trash' === $filter, true, false ),
 166                  _x( 'Trash', 'attachment filter' )
 167              );
 168          }
 169  
 170          return $type_links;
 171      }
 172  
 173      /**
 174       * @return array
 175       */
 176  	protected function get_bulk_actions() {
 177          $actions = array();
 178  
 179          if ( MEDIA_TRASH ) {
 180              if ( $this->is_trash ) {
 181                  $actions['untrash'] = __( 'Restore' );
 182                  $actions['delete']  = __( 'Delete permanently' );
 183              } else {
 184                  $actions['trash'] = __( 'Move to Trash' );
 185              }
 186          } else {
 187              $actions['delete'] = __( 'Delete permanently' );
 188          }
 189  
 190          if ( $this->detached ) {
 191              $actions['attach'] = __( 'Attach' );
 192          }
 193  
 194          return $actions;
 195      }
 196  
 197      /**
 198       * @param string $which
 199       */
 200  	protected function extra_tablenav( $which ) {
 201          if ( 'bar' !== $which ) {
 202              return;
 203          }
 204          ?>
 205          <div class="actions">
 206              <?php
 207              if ( ! $this->is_trash ) {
 208                  $this->months_dropdown( 'attachment' );
 209              }
 210  
 211              /** This action is documented in wp-admin/includes/class-wp-posts-list-table.php */
 212              do_action( 'restrict_manage_posts', $this->screen->post_type, $which );
 213  
 214              submit_button( __( 'Filter' ), '', 'filter_action', false, array( 'id' => 'post-query-submit' ) );
 215  
 216              if ( $this->is_trash && $this->has_items()
 217                  && current_user_can( 'edit_others_posts' )
 218              ) {
 219                  submit_button( __( 'Empty Trash' ), 'apply', 'delete_all', false );
 220              }
 221              ?>
 222          </div>
 223          <?php
 224      }
 225  
 226      /**
 227       * @return string
 228       */
 229  	public function current_action() {
 230          if ( isset( $_REQUEST['found_post_id'] ) && isset( $_REQUEST['media'] ) ) {
 231              return 'attach';
 232          }
 233  
 234          if ( isset( $_REQUEST['parent_post_id'] ) && isset( $_REQUEST['media'] ) ) {
 235              return 'detach';
 236          }
 237  
 238          if ( isset( $_REQUEST['delete_all'] ) || isset( $_REQUEST['delete_all2'] ) ) {
 239              return 'delete_all';
 240          }
 241  
 242          return parent::current_action();
 243      }
 244  
 245      /**
 246       * @return bool
 247       */
 248  	public function has_items() {
 249          return have_posts();
 250      }
 251  
 252      /**
 253       */
 254  	public function no_items() {
 255          if ( $this->is_trash ) {
 256              _e( 'No media files found in Trash.' );
 257          } else {
 258              _e( 'No media files found.' );
 259          }
 260      }
 261  
 262      /**
 263       * Override parent views so we can use the filter bar display.
 264       *
 265       * @global string $mode List table view mode.
 266       */
 267  	public function views() {
 268          global $mode;
 269  
 270          $views = $this->get_views();
 271  
 272          $this->screen->render_screen_reader_content( 'heading_views' );
 273          ?>
 274          <div class="wp-filter">
 275              <div class="filter-items">
 276                  <?php $this->view_switcher( $mode ); ?>
 277  
 278                  <label for="attachment-filter" class="screen-reader-text"><?php _e( 'Filter by type' ); ?></label>
 279                  <select class="attachment-filters" name="attachment-filter" id="attachment-filter">
 280                      <?php
 281                      if ( ! empty( $views ) ) {
 282                          foreach ( $views as $class => $view ) {
 283                              echo "\t$view\n";
 284                          }
 285                      }
 286                      ?>
 287                  </select>
 288  
 289                  <?php
 290                  $this->extra_tablenav( 'bar' );
 291  
 292                  /** This filter is documented in wp-admin/inclues/class-wp-list-table.php */
 293                  $views = apply_filters( "views_{$this->screen->id}", array() );
 294  
 295                  // Back compat for pre-4.0 view links.
 296                  if ( ! empty( $views ) ) {
 297                      echo '<ul class="filter-links">';
 298                      foreach ( $views as $class => $view ) {
 299                          echo "<li class='$class'>$view</li>";
 300                      }
 301                      echo '</ul>';
 302                  }
 303                  ?>
 304              </div>
 305  
 306              <div class="search-form">
 307                  <label for="media-search-input" class="media-search-input-label"><?php esc_html_e( 'Search' ); ?></label>
 308                  <input type="search" id="media-search-input" class="search" name="s" value="<?php _admin_search_query(); ?>">
 309              </div>
 310          </div>
 311          <?php
 312      }
 313  
 314      /**
 315       * @return array
 316       */
 317  	public function get_columns() {
 318          $posts_columns       = array();
 319          $posts_columns['cb'] = '<input type="checkbox" />';
 320          /* translators: Column name. */
 321          $posts_columns['title']  = _x( 'File', 'column name' );
 322          $posts_columns['author'] = __( 'Author' );
 323  
 324          $taxonomies = get_taxonomies_for_attachments( 'objects' );
 325          $taxonomies = wp_filter_object_list( $taxonomies, array( 'show_admin_column' => true ), 'and', 'name' );
 326  
 327          /**
 328           * Filters the taxonomy columns for attachments in the Media list table.
 329           *
 330           * @since 3.5.0
 331           *
 332           * @param string[] $taxonomies An array of registered taxonomy names to show for attachments.
 333           * @param string   $post_type  The post type. Default 'attachment'.
 334           */
 335          $taxonomies = apply_filters( 'manage_taxonomies_for_attachment_columns', $taxonomies, 'attachment' );
 336          $taxonomies = array_filter( $taxonomies, 'taxonomy_exists' );
 337  
 338          foreach ( $taxonomies as $taxonomy ) {
 339              if ( 'category' === $taxonomy ) {
 340                  $column_key = 'categories';
 341              } elseif ( 'post_tag' === $taxonomy ) {
 342                  $column_key = 'tags';
 343              } else {
 344                  $column_key = 'taxonomy-' . $taxonomy;
 345              }
 346  
 347              $posts_columns[ $column_key ] = get_taxonomy( $taxonomy )->labels->name;
 348          }
 349  
 350          /* translators: Column name. */
 351          if ( ! $this->detached ) {
 352              $posts_columns['parent'] = _x( 'Uploaded to', 'column name' );
 353  
 354              if ( post_type_supports( 'attachment', 'comments' ) ) {
 355                  $posts_columns['comments'] = sprintf(
 356                      '<span class="vers comment-grey-bubble" title="%1$s" aria-hidden="true"></span><span class="screen-reader-text">%2$s</span>',
 357                      esc_attr__( 'Comments' ),
 358                      __( 'Comments' )
 359                  );
 360              }
 361          }
 362  
 363          /* translators: Column name. */
 364          $posts_columns['date'] = _x( 'Date', 'column name' );
 365  
 366          /**
 367           * Filters the Media list table columns.
 368           *
 369           * @since 2.5.0
 370           *
 371           * @param string[] $posts_columns An array of columns displayed in the Media list table.
 372           * @param bool     $detached      Whether the list table contains media not attached
 373           *                                to any posts. Default true.
 374           */
 375          return apply_filters( 'manage_media_columns', $posts_columns, $this->detached );
 376      }
 377  
 378      /**
 379       * @return array
 380       */
 381  	protected function get_sortable_columns() {
 382          return array(
 383              'title'    => 'title',
 384              'author'   => 'author',
 385              'parent'   => 'parent',
 386              'comments' => 'comment_count',
 387              'date'     => array( 'date', true ),
 388          );
 389      }
 390  
 391      /**
 392       * Handles the checkbox column output.
 393       *
 394       * @since 4.3.0
 395       * @since 5.9.0 Renamed `$post` to `$item` to match parent class for PHP 8 named parameter support.
 396       *
 397       * @param WP_Post $item The current WP_Post object.
 398       */
 399  	public function column_cb( $item ) {
 400          // Restores the more descriptive, specific name for use within this method.
 401          $post = $item;
 402  
 403          if ( current_user_can( 'edit_post', $post->ID ) ) {
 404              ?>
 405              <label class="screen-reader-text" for="cb-select-<?php echo $post->ID; ?>">
 406                  <?php
 407                  /* translators: %s: Attachment title. */
 408                  printf( __( 'Select %s' ), _draft_or_post_title() );
 409                  ?>
 410              </label>
 411              <input type="checkbox" name="media[]" id="cb-select-<?php echo $post->ID; ?>" value="<?php echo $post->ID; ?>" />
 412              <?php
 413          }
 414      }
 415  
 416      /**
 417       * Handles the title column output.
 418       *
 419       * @since 4.3.0
 420       *
 421       * @param WP_Post $post The current WP_Post object.
 422       */
 423  	public function column_title( $post ) {
 424          list( $mime ) = explode( '/', $post->post_mime_type );
 425  
 426          $title      = _draft_or_post_title();
 427          $thumb      = wp_get_attachment_image( $post->ID, array( 60, 60 ), true, array( 'alt' => '' ) );
 428          $link_start = '';
 429          $link_end   = '';
 430  
 431          if ( current_user_can( 'edit_post', $post->ID ) && ! $this->is_trash ) {
 432              $link_start = sprintf(
 433                  '<a href="%s" aria-label="%s">',
 434                  get_edit_post_link( $post->ID ),
 435                  /* translators: %s: Attachment title. */
 436                  esc_attr( sprintf( __( '&#8220;%s&#8221; (Edit)' ), $title ) )
 437              );
 438              $link_end = '</a>';
 439          }
 440  
 441          $class = $thumb ? ' class="has-media-icon"' : '';
 442          ?>
 443          <strong<?php echo $class; ?>>
 444              <?php
 445              echo $link_start;
 446  
 447              if ( $thumb ) :
 448                  ?>
 449                  <span class="media-icon <?php echo sanitize_html_class( $mime . '-icon' ); ?>"><?php echo $thumb; ?></span>
 450                  <?php
 451              endif;
 452  
 453              echo $title . $link_end;
 454  
 455              _media_states( $post );
 456              ?>
 457          </strong>
 458          <p class="filename">
 459              <span class="screen-reader-text"><?php _e( 'File name:' ); ?> </span>
 460              <?php
 461              $file = get_attached_file( $post->ID );
 462              echo esc_html( wp_basename( $file ) );
 463              ?>
 464          </p>
 465          <?php
 466      }
 467  
 468      /**
 469       * Handles the author column output.
 470       *
 471       * @since 4.3.0
 472       *
 473       * @param WP_Post $post The current WP_Post object.
 474       */
 475  	public function column_author( $post ) {
 476          printf(
 477              '<a href="%s">%s</a>',
 478              esc_url( add_query_arg( array( 'author' => get_the_author_meta( 'ID' ) ), 'upload.php' ) ),
 479              get_the_author()
 480          );
 481      }
 482  
 483      /**
 484       * Handles the description column output.
 485       *
 486       * @since 4.3.0
 487       *
 488       * @param WP_Post $post The current WP_Post object.
 489       */
 490  	public function column_desc( $post ) {
 491          echo has_excerpt() ? $post->post_excerpt : '';
 492      }
 493  
 494      /**
 495       * Handles the date column output.
 496       *
 497       * @since 4.3.0
 498       *
 499       * @param WP_Post $post The current WP_Post object.
 500       */
 501  	public function column_date( $post ) {
 502          if ( '0000-00-00 00:00:00' === $post->post_date ) {
 503              $h_time = __( 'Unpublished' );
 504          } else {
 505              $time      = get_post_timestamp( $post );
 506              $time_diff = time() - $time;
 507  
 508              if ( $time && $time_diff > 0 && $time_diff < DAY_IN_SECONDS ) {
 509                  /* translators: %s: Human-readable time difference. */
 510                  $h_time = sprintf( __( '%s ago' ), human_time_diff( $time ) );
 511              } else {
 512                  $h_time = get_the_time( __( 'Y/m/d' ), $post );
 513              }
 514          }
 515  
 516          /**
 517           * Filters the published time of an attachment displayed in the Media list table.
 518           *
 519           * @since 6.0.0
 520           *
 521           * @param string  $h_time      The published time.
 522           * @param WP_Post $post        Attachment object.
 523           * @param string  $column_name The column name.
 524           */
 525          echo apply_filters( 'media_date_column_time', $h_time, $post, 'date' );
 526      }
 527  
 528      /**
 529       * Handles the parent column output.
 530       *
 531       * @since 4.3.0
 532       *
 533       * @param WP_Post $post The current WP_Post object.
 534       */
 535  	public function column_parent( $post ) {
 536          $user_can_edit = current_user_can( 'edit_post', $post->ID );
 537  
 538          if ( $post->post_parent > 0 ) {
 539              $parent = get_post( $post->post_parent );
 540          } else {
 541              $parent = false;
 542          }
 543  
 544          if ( $parent ) {
 545              $title       = _draft_or_post_title( $post->post_parent );
 546              $parent_type = get_post_type_object( $parent->post_type );
 547  
 548              if ( $parent_type && $parent_type->show_ui && current_user_can( 'edit_post', $post->post_parent ) ) {
 549                  printf( '<strong><a href="%s">%s</a></strong>', get_edit_post_link( $post->post_parent ), $title );
 550              } elseif ( $parent_type && current_user_can( 'read_post', $post->post_parent ) ) {
 551                  printf( '<strong>%s</strong>', $title );
 552              } else {
 553                  _e( '(Private post)' );
 554              }
 555  
 556              if ( $user_can_edit ) :
 557                  $detach_url = add_query_arg(
 558                      array(
 559                          'parent_post_id' => $post->post_parent,
 560                          'media[]'        => $post->ID,
 561                          '_wpnonce'       => wp_create_nonce( 'bulk-' . $this->_args['plural'] ),
 562                      ),
 563                      'upload.php'
 564                  );
 565                  printf(
 566                      '<br /><a href="%s" class="hide-if-no-js detach-from-parent" aria-label="%s">%s</a>',
 567                      $detach_url,
 568                      /* translators: %s: Title of the post the attachment is attached to. */
 569                      esc_attr( sprintf( __( 'Detach from &#8220;%s&#8221;' ), $title ) ),
 570                      __( 'Detach' )
 571                  );
 572              endif;
 573          } else {
 574              _e( '(Unattached)' );
 575              ?>
 576              <?php
 577              if ( $user_can_edit ) {
 578                  $title = _draft_or_post_title( $post->post_parent );
 579                  printf(
 580                      '<br /><a href="#the-list" onclick="findPosts.open( \'media[]\', \'%s\' ); return false;" class="hide-if-no-js aria-button-if-js" aria-label="%s">%s</a>',
 581                      $post->ID,
 582                      /* translators: %s: Attachment title. */
 583                      esc_attr( sprintf( __( 'Attach &#8220;%s&#8221; to existing content' ), $title ) ),
 584                      __( 'Attach' )
 585                  );
 586              }
 587          }
 588      }
 589  
 590      /**
 591       * Handles the comments column output.
 592       *
 593       * @since 4.3.0
 594       *
 595       * @param WP_Post $post The current WP_Post object.
 596       */
 597  	public function column_comments( $post ) {
 598          echo '<div class="post-com-count-wrapper">';
 599  
 600          if ( isset( $this->comment_pending_count[ $post->ID ] ) ) {
 601              $pending_comments = $this->comment_pending_count[ $post->ID ];
 602          } else {
 603              $pending_comments = get_pending_comments_num( $post->ID );
 604          }
 605  
 606          $this->comments_bubble( $post->ID, $pending_comments );
 607  
 608          echo '</div>';
 609      }
 610  
 611      /**
 612       * Handles output for the default column.
 613       *
 614       * @since 4.3.0
 615       * @since 5.9.0 Renamed `$post` to `$item` to match parent class for PHP 8 named parameter support.
 616       *
 617       * @param WP_Post $item        The current WP_Post object.
 618       * @param string  $column_name Current column name.
 619       */
 620  	public function column_default( $item, $column_name ) {
 621          // Restores the more descriptive, specific name for use within this method.
 622          $post = $item;
 623  
 624          if ( 'categories' === $column_name ) {
 625              $taxonomy = 'category';
 626          } elseif ( 'tags' === $column_name ) {
 627              $taxonomy = 'post_tag';
 628          } elseif ( 0 === strpos( $column_name, 'taxonomy-' ) ) {
 629              $taxonomy = substr( $column_name, 9 );
 630          } else {
 631              $taxonomy = false;
 632          }
 633  
 634          if ( $taxonomy ) {
 635              $terms = get_the_terms( $post->ID, $taxonomy );
 636  
 637              if ( is_array( $terms ) ) {
 638                  $out = array();
 639                  foreach ( $terms as $t ) {
 640                      $posts_in_term_qv             = array();
 641                      $posts_in_term_qv['taxonomy'] = $taxonomy;
 642                      $posts_in_term_qv['term']     = $t->slug;
 643  
 644                      $out[] = sprintf(
 645                          '<a href="%s">%s</a>',
 646                          esc_url( add_query_arg( $posts_in_term_qv, 'upload.php' ) ),
 647                          esc_html( sanitize_term_field( 'name', $t->name, $t->term_id, $taxonomy, 'display' ) )
 648                      );
 649                  }
 650                  echo implode( wp_get_list_item_separator(), $out );
 651              } else {
 652                  echo '<span aria-hidden="true">&#8212;</span><span class="screen-reader-text">' . get_taxonomy( $taxonomy )->labels->no_terms . '</span>';
 653              }
 654  
 655              return;
 656          }
 657  
 658          /**
 659           * Fires for each custom column in the Media list table.
 660           *
 661           * Custom columns are registered using the {@see 'manage_media_columns'} filter.
 662           *
 663           * @since 2.5.0
 664           *
 665           * @param string $column_name Name of the custom column.
 666           * @param int    $post_id     Attachment ID.
 667           */
 668          do_action( 'manage_media_custom_column', $column_name, $post->ID );
 669      }
 670  
 671      /**
 672       * @global WP_Post $post Global post object.
 673       */
 674  	public function display_rows() {
 675          global $post, $wp_query;
 676  
 677          $post_ids = wp_list_pluck( $wp_query->posts, 'ID' );
 678          reset( $wp_query->posts );
 679  
 680          $this->comment_pending_count = get_pending_comments_num( $post_ids );
 681  
 682          add_filter( 'the_title', 'esc_html' );
 683  
 684          while ( have_posts() ) :
 685              the_post();
 686  
 687              if ( $this->is_trash && 'trash' !== $post->post_status
 688                  || ! $this->is_trash && 'trash' === $post->post_status
 689              ) {
 690                  continue;
 691              }
 692  
 693              $post_owner = ( get_current_user_id() === (int) $post->post_author ) ? 'self' : 'other';
 694              ?>
 695              <tr id="post-<?php echo $post->ID; ?>" class="<?php echo trim( ' author-' . $post_owner . ' status-' . $post->post_status ); ?>">
 696                  <?php $this->single_row_columns( $post ); ?>
 697              </tr>
 698              <?php
 699          endwhile;
 700      }
 701  
 702      /**
 703       * Gets the name of the default primary column.
 704       *
 705       * @since 4.3.0
 706       *
 707       * @return string Name of the default primary column, in this case, 'title'.
 708       */
 709  	protected function get_default_primary_column_name() {
 710          return 'title';
 711      }
 712  
 713      /**
 714       * @param WP_Post $post
 715       * @param string  $att_title
 716       * @return array
 717       */
 718  	private function _get_row_actions( $post, $att_title ) {
 719          $actions = array();
 720  
 721          if ( $this->detached ) {
 722              if ( current_user_can( 'edit_post', $post->ID ) ) {
 723                  $actions['edit'] = sprintf(
 724                      '<a href="%s" aria-label="%s">%s</a>',
 725                      get_edit_post_link( $post->ID ),
 726                      /* translators: %s: Attachment title. */
 727                      esc_attr( sprintf( __( 'Edit &#8220;%s&#8221;' ), $att_title ) ),
 728                      __( 'Edit' )
 729                  );
 730              }
 731  
 732              if ( current_user_can( 'delete_post', $post->ID ) ) {
 733                  if ( EMPTY_TRASH_DAYS && MEDIA_TRASH ) {
 734                      $actions['trash'] = sprintf(
 735                          '<a href="%s" class="submitdelete aria-button-if-js" aria-label="%s">%s</a>',
 736                          wp_nonce_url( "post.php?action=trash&amp;post=$post->ID", 'trash-post_' . $post->ID ),
 737                          /* translators: %s: Attachment title. */
 738                          esc_attr( sprintf( __( 'Move &#8220;%s&#8221; to the Trash' ), $att_title ) ),
 739                          _x( 'Trash', 'verb' )
 740                      );
 741                  } else {
 742                      $delete_ays        = ! MEDIA_TRASH ? " onclick='return showNotice.warn();'" : '';
 743                      $actions['delete'] = sprintf(
 744                          '<a href="%s" class="submitdelete aria-button-if-js"%s aria-label="%s">%s</a>',
 745                          wp_nonce_url( "post.php?action=delete&amp;post=$post->ID", 'delete-post_' . $post->ID ),
 746                          $delete_ays,
 747                          /* translators: %s: Attachment title. */
 748                          esc_attr( sprintf( __( 'Delete &#8220;%s&#8221; permanently' ), $att_title ) ),
 749                          __( 'Delete Permanently' )
 750                      );
 751                  }
 752              }
 753  
 754              $actions['view'] = sprintf(
 755                  '<a href="%s" aria-label="%s" rel="bookmark">%s</a>',
 756                  get_permalink( $post->ID ),
 757                  /* translators: %s: Attachment title. */
 758                  esc_attr( sprintf( __( 'View &#8220;%s&#8221;' ), $att_title ) ),
 759                  __( 'View' )
 760              );
 761  
 762              if ( current_user_can( 'edit_post', $post->ID ) ) {
 763                  $actions['attach'] = sprintf(
 764                      '<a href="#the-list" onclick="findPosts.open( \'media[]\', \'%s\' ); return false;" class="hide-if-no-js aria-button-if-js" aria-label="%s">%s</a>',
 765                      $post->ID,
 766                      /* translators: %s: Attachment title. */
 767                      esc_attr( sprintf( __( 'Attach &#8220;%s&#8221; to existing content' ), $att_title ) ),
 768                      __( 'Attach' )
 769                  );
 770              }
 771          } else {
 772              if ( current_user_can( 'edit_post', $post->ID ) && ! $this->is_trash ) {
 773                  $actions['edit'] = sprintf(
 774                      '<a href="%s" aria-label="%s">%s</a>',
 775                      get_edit_post_link( $post->ID ),
 776                      /* translators: %s: Attachment title. */
 777                      esc_attr( sprintf( __( 'Edit &#8220;%s&#8221;' ), $att_title ) ),
 778                      __( 'Edit' )
 779                  );
 780              }
 781  
 782              if ( current_user_can( 'delete_post', $post->ID ) ) {
 783                  if ( $this->is_trash ) {
 784                      $actions['untrash'] = sprintf(
 785                          '<a href="%s" class="submitdelete aria-button-if-js" aria-label="%s">%s</a>',
 786                          wp_nonce_url( "post.php?action=untrash&amp;post=$post->ID", 'untrash-post_' . $post->ID ),
 787                          /* translators: %s: Attachment title. */
 788                          esc_attr( sprintf( __( 'Restore &#8220;%s&#8221; from the Trash' ), $att_title ) ),
 789                          __( 'Restore' )
 790                      );
 791                  } elseif ( EMPTY_TRASH_DAYS && MEDIA_TRASH ) {
 792                      $actions['trash'] = sprintf(
 793                          '<a href="%s" class="submitdelete aria-button-if-js" aria-label="%s">%s</a>',
 794                          wp_nonce_url( "post.php?action=trash&amp;post=$post->ID", 'trash-post_' . $post->ID ),
 795                          /* translators: %s: Attachment title. */
 796                          esc_attr( sprintf( __( 'Move &#8220;%s&#8221; to the Trash' ), $att_title ) ),
 797                          _x( 'Trash', 'verb' )
 798                      );
 799                  }
 800  
 801                  if ( $this->is_trash || ! EMPTY_TRASH_DAYS || ! MEDIA_TRASH ) {
 802                      $delete_ays        = ( ! $this->is_trash && ! MEDIA_TRASH ) ? " onclick='return showNotice.warn();'" : '';
 803                      $actions['delete'] = sprintf(
 804                          '<a href="%s" class="submitdelete aria-button-if-js"%s aria-label="%s">%s</a>',
 805                          wp_nonce_url( "post.php?action=delete&amp;post=$post->ID", 'delete-post_' . $post->ID ),
 806                          $delete_ays,
 807                          /* translators: %s: Attachment title. */
 808                          esc_attr( sprintf( __( 'Delete &#8220;%s&#8221; permanently' ), $att_title ) ),
 809                          __( 'Delete Permanently' )
 810                      );
 811                  }
 812              }
 813  
 814              if ( ! $this->is_trash ) {
 815                  $actions['view'] = sprintf(
 816                      '<a href="%s" aria-label="%s" rel="bookmark">%s</a>',
 817                      get_permalink( $post->ID ),
 818                      /* translators: %s: Attachment title. */
 819                      esc_attr( sprintf( __( 'View &#8220;%s&#8221;' ), $att_title ) ),
 820                      __( 'View' )
 821                  );
 822  
 823                  $actions['copy'] = sprintf(
 824                      '<span class="copy-to-clipboard-container"><button type="button" class="button-link copy-attachment-url media-library" data-clipboard-text="%s" aria-label="%s">%s</button><span class="success hidden" aria-hidden="true">%s</span></span>',
 825                      esc_url( wp_get_attachment_url( $post->ID ) ),
 826                      /* translators: %s: Attachment title. */
 827                      esc_attr( sprintf( __( 'Copy &#8220;%s&#8221; URL to clipboard' ), $att_title ) ),
 828                      __( 'Copy URL to clipboard' ),
 829                      __( 'Copied!' )
 830                  );
 831              }
 832          }
 833  
 834          /**
 835           * Filters the action links for each attachment in the Media list table.
 836           *
 837           * @since 2.8.0
 838           *
 839           * @param string[] $actions  An array of action links for each attachment.
 840           *                           Default 'Edit', 'Delete Permanently', 'View'.
 841           * @param WP_Post  $post     WP_Post object for the current attachment.
 842           * @param bool     $detached Whether the list table contains media not attached
 843           *                           to any posts. Default true.
 844           */
 845          return apply_filters( 'media_row_actions', $actions, $post, $this->detached );
 846      }
 847  
 848      /**
 849       * Generates and displays row action links.
 850       *
 851       * @since 4.3.0
 852       * @since 5.9.0 Renamed `$post` to `$item` to match parent class for PHP 8 named parameter support.
 853       *
 854       * @param WP_Post $item        Attachment being acted upon.
 855       * @param string  $column_name Current column name.
 856       * @param string  $primary     Primary column name.
 857       * @return string Row actions output for media attachments, or an empty string
 858       *                if the current column is not the primary column.
 859       */
 860  	protected function handle_row_actions( $item, $column_name, $primary ) {
 861          if ( $primary !== $column_name ) {
 862              return '';
 863          }
 864  
 865          $att_title = _draft_or_post_title();
 866          $actions   = $this->_get_row_actions(
 867              $item, // WP_Post object for an attachment.
 868              $att_title
 869          );
 870  
 871          return $this->row_actions( $actions );
 872      }
 873  }


Generated : Fri Aug 19 08:20:02 2022 Cross-referenced by PHPXref