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