<?php
/**
- * Media Library List Table class.
+ * List Table API: WP_Media_List_Table class
*
* @package WordPress
- * @subpackage List_Table
+ * @subpackage Administration
+ * @since 3.1.0
+ */
+
+/**
+ * Core class used to implement displaying media items in a list table.
+ *
* @since 3.1.0
* @access private
+ *
+ * @see WP_List_Table
*/
class WP_Media_List_Table extends WP_List_Table {
+ /**
+ * Holds the number of pending comments for each post.
+ *
+ * @since 4.4.0
+ * @var array
+ * @access protected
+ */
+ protected $comment_pending_count = array();
private $detached;
) );
}
+ /**
+ *
+ * @return bool
+ */
public function ajax_user_can() {
return current_user_can('upload_files');
}
+ /**
+ *
+ * @global WP_Query $wp_query
+ * @global array $post_mime_types
+ * @global array $avail_post_mime_types
+ * @global string $mode
+ */
public function prepare_items() {
global $wp_query, $post_mime_types, $avail_post_mime_types, $mode;
list( $post_mime_types, $avail_post_mime_types ) = wp_edit_attachments_query( $_REQUEST );
- $this->is_trash = isset( $_REQUEST['attachment-filter'] ) && 'trash' == $_REQUEST['attachment-filter'];
+ $this->is_trash = isset( $_REQUEST['attachment-filter'] ) && 'trash' === $_REQUEST['attachment-filter'];
$mode = empty( $_REQUEST['mode'] ) ? 'list' : $_REQUEST['mode'];
) );
}
+ /**
+ * @global array $post_mime_types
+ * @global array $avail_post_mime_types
+ * @return array
+ */
protected function get_views() {
- global $wpdb, $post_mime_types, $avail_post_mime_types;
+ global $post_mime_types, $avail_post_mime_types;
$type_links = array();
- $_num_posts = (array) wp_count_attachments();
- $_total_posts = array_sum($_num_posts) - $_num_posts['trash'];
- $total_orphans = $wpdb->get_var( "SELECT COUNT( * ) FROM $wpdb->posts WHERE post_type = 'attachment' AND post_status != 'trash' AND post_parent < 1" );
- $matches = wp_match_mime_types(array_keys($post_mime_types), array_keys($_num_posts));
- foreach ( $matches as $type => $reals )
- foreach ( $reals as $real )
- $num_posts[$type] = ( isset( $num_posts[$type] ) ) ? $num_posts[$type] + $_num_posts[$real] : $_num_posts[$real];
-
- $selected = empty( $_GET['attachment-filter'] ) ? ' selected="selected"' : '';
- $type_links['all'] = "<option value=''$selected>" . sprintf( _nx( 'All (%s)', 'All (%s)', $_total_posts, 'uploaded files' ), number_format_i18n( $_total_posts ) ) . '</option>';
+
+ $filter = empty( $_GET['attachment-filter'] ) ? '' : $_GET['attachment-filter'];
+
+ $type_links['all'] = sprintf(
+ '<option value=""%s>%s</option>',
+ selected( $filter, true, false ),
+ __( 'All media items' )
+ );
+
foreach ( $post_mime_types as $mime_type => $label ) {
- if ( !wp_match_mime_types($mime_type, $avail_post_mime_types) )
+ if ( ! wp_match_mime_types( $mime_type, $avail_post_mime_types ) ) {
continue;
+ }
- $selected = '';
- if ( !empty( $_GET['attachment-filter'] ) && strpos( $_GET['attachment-filter'], 'post_mime_type:' ) === 0 && wp_match_mime_types( $mime_type, str_replace( 'post_mime_type:', '', $_GET['attachment-filter'] ) ) )
- $selected = ' selected="selected"';
- if ( !empty( $num_posts[$mime_type] ) )
- $type_links[$mime_type] = '<option value="post_mime_type:' . esc_attr( $mime_type ) . '"' . $selected . '>' . sprintf( translate_nooped_plural( $label[2], $num_posts[$mime_type] ), number_format_i18n( $num_posts[$mime_type] )) . '</option>';
- }
- $type_links['detached'] = '<option value="detached"' . ( $this->detached ? ' selected="selected"' : '' ) . '>' . sprintf( _nx( 'Unattached (%s)', 'Unattached (%s)', $total_orphans, 'detached files' ), number_format_i18n( $total_orphans ) ) . '</option>';
+ $selected = selected(
+ $filter && 0 === strpos( $filter, 'post_mime_type:' ) &&
+ wp_match_mime_types( $mime_type, str_replace( 'post_mime_type:', '', $filter ) ),
+ true,
+ false
+ );
- if ( !empty($_num_posts['trash']) )
- $type_links['trash'] = '<option value="trash"' . ( (isset($_GET['attachment-filter']) && $_GET['attachment-filter'] == 'trash' ) ? ' selected="selected"' : '') . '>' . sprintf( _nx( 'Trash (%s)', 'Trash (%s)', $_num_posts['trash'], 'uploaded files' ), number_format_i18n( $_num_posts['trash'] ) ) . '</option>';
+ $type_links[$mime_type] = sprintf(
+ '<option value="post_mime_type:%s"%s>%s</option>',
+ esc_attr( $mime_type ),
+ $selected,
+ $label[0]
+ );
+ }
+ $type_links['detached'] = '<option value="detached"' . ( $this->detached ? ' selected="selected"' : '' ) . '>' . __( 'Unattached' ) . '</option>';
+ if ( $this->is_trash || ( defined( 'MEDIA_TRASH') && MEDIA_TRASH ) ) {
+ $type_links['trash'] = sprintf(
+ '<option value="trash"%s>%s</option>',
+ selected( 'trash' === $filter, true, false ),
+ __( 'Trash' )
+ );
+ }
return $type_links;
}
+ /**
+ *
+ * @return array
+ */
protected function get_bulk_actions() {
$actions = array();
if ( MEDIA_TRASH ) {
}
if ( $this->detached )
- $actions['attach'] = __( 'Attach to a post' );
+ $actions['attach'] = __( 'Attach' );
return $actions;
}
}
/** This action is documented in wp-admin/includes/class-wp-posts-list-table.php */
- do_action( 'restrict_manage_posts' );
+ do_action( 'restrict_manage_posts', $this->screen->post_type );
+
submit_button( __( 'Filter' ), 'button', 'filter_action', false, array( 'id' => 'post-query-submit' ) );
}
<?php
}
+ /**
+ *
+ * @return string
+ */
public function current_action() {
if ( isset( $_REQUEST['found_post_id'] ) && isset( $_REQUEST['media'] ) )
return 'attach';
return parent::current_action();
}
+ /**
+ *
+ * @return bool
+ */
public function has_items() {
return have_posts();
}
+ /**
+ * @access public
+ */
public function no_items() {
_e( 'No media attachments found.' );
}
/**
* Override parent views so we can use the filter bar display.
+ *
+ * @global string $mode
*/
public function views() {
global $mode;
$views = $this->get_views();
+
+ $this->screen->render_screen_reader_content( 'heading_views' );
?>
<div class="wp-filter">
<div class="filter-items">
<?php
}
+ /**
+ *
+ * @return array
+ */
public function get_columns() {
$posts_columns = array();
$posts_columns['cb'] = '<input type="checkbox" />';
- $posts_columns['icon'] = '';
/* translators: column name */
$posts_columns['title'] = _x( 'File', 'column name' );
$posts_columns['author'] = __( 'Author' );
$taxonomies = array_filter( $taxonomies, 'taxonomy_exists' );
foreach ( $taxonomies as $taxonomy ) {
- if ( 'category' == $taxonomy )
+ if ( 'category' === $taxonomy ) {
$column_key = 'categories';
- elseif ( 'post_tag' == $taxonomy )
+ } elseif ( 'post_tag' === $taxonomy ) {
$column_key = 'tags';
- else
+ } else {
$column_key = 'taxonomy-' . $taxonomy;
-
+ }
$posts_columns[ $column_key ] = get_taxonomy( $taxonomy )->labels->name;
}
if ( !$this->detached ) {
$posts_columns['parent'] = _x( 'Uploaded to', 'column name' );
if ( post_type_supports( 'attachment', 'comments' ) )
- $posts_columns['comments'] = '<span class="vers"><span title="' . esc_attr__( 'Comments' ) . '" class="comment-grey-bubble"></span></span>';
+ $posts_columns['comments'] = '<span class="vers comment-grey-bubble" title="' . esc_attr__( 'Comments' ) . '"><span class="screen-reader-text">' . __( 'Comments' ) . '</span></span>';
}
/* translators: column name */
$posts_columns['date'] = _x( 'Date', 'column name' );
* @param bool $detached Whether the list table contains media not attached
* to any posts. Default true.
*/
- $posts_columns = apply_filters( 'manage_media_columns', $posts_columns, $this->detached );
-
- return $posts_columns;
+ return apply_filters( 'manage_media_columns', $posts_columns, $this->detached );
}
+ /**
+ *
+ * @return array
+ */
protected function get_sortable_columns() {
return array(
'title' => 'title',
);
}
- public function display_rows() {
- global $post;
-
- add_filter( 'the_title','esc_html' );
-
- while ( have_posts() ) : the_post();
- $user_can_edit = current_user_can( 'edit_post', $post->ID );
-
- if ( $this->is_trash && $post->post_status != 'trash'
- || !$this->is_trash && $post->post_status == 'trash' )
- continue;
-
- $post_owner = ( get_current_user_id() == $post->post_author ) ? 'self' : 'other';
- $att_title = _draft_or_post_title();
-?>
- <tr id="post-<?php echo $post->ID; ?>" class="<?php echo trim( ' author-' . $post_owner . ' status-' . $post->post_status ); ?>">
-<?php
-
-list( $columns, $hidden ) = $this->get_column_info();
-foreach ( $columns as $column_name => $column_display_name ) {
- $class = "class='$column_name column-$column_name'";
-
- $style = '';
- if ( in_array( $column_name, $hidden ) )
- $style = ' style="display:none;"';
+ /**
+ * Handles the checkbox column output.
+ *
+ * @since 4.3.0
+ * @access public
+ *
+ * @param WP_Post $post The current WP_Post object.
+ */
+ public function column_cb( $post ) {
+ if ( current_user_can( 'edit_post', $post->ID ) ) { ?>
+ <label class="screen-reader-text" for="cb-select-<?php echo $post->ID; ?>"><?php
+ echo sprintf( __( 'Select %s' ), _draft_or_post_title() );
+ ?></label>
+ <input type="checkbox" name="media[]" id="cb-select-<?php echo $post->ID; ?>" value="<?php echo $post->ID; ?>" />
+ <?php }
+ }
- $attributes = $class . $style;
+ /**
+ * Handles the title column output.
+ *
+ * @since 4.3.0
+ * @access public
+ *
+ * @param WP_Post $post The current WP_Post object.
+ */
+ public function column_title( $post ) {
+ list( $mime ) = explode( '/', $post->post_mime_type );
- switch ( $column_name ) {
+ $title = _draft_or_post_title();
+ $thumb = wp_get_attachment_image( $post->ID, array( 60, 60 ), true, array( 'alt' => '' ) );
+ $link_start = $link_end = '';
- case 'cb':
-?>
- <th scope="row" class="check-column">
- <?php if ( $user_can_edit ) { ?>
- <label class="screen-reader-text" for="cb-select-<?php the_ID(); ?>"><?php echo sprintf( __( 'Select %s' ), $att_title );?></label>
- <input type="checkbox" name="media[]" id="cb-select-<?php the_ID(); ?>" value="<?php the_ID(); ?>" />
- <?php } ?>
- </th>
-<?php
- break;
+ if ( current_user_can( 'edit_post', $post->ID ) && ! $this->is_trash ) {
+ $link_start = '<a href="' . get_edit_post_link( $post->ID ) . '">';
+ $link_end = '</a>';
+ }
- case 'icon':
- list( $mime ) = explode( '/', $post->post_mime_type );
- $attributes = 'class="column-icon media-icon ' . $mime . '-icon"' . $style;
-?>
- <td <?php echo $attributes ?>><?php
- if ( $thumb = wp_get_attachment_image( $post->ID, array( 80, 60 ), true ) ) {
- if ( $this->is_trash || ! $user_can_edit ) {
- echo $thumb;
- } else {
-?>
- <a href="<?php echo get_edit_post_link( $post->ID ); ?>" title="<?php echo esc_attr( sprintf( __( 'Edit “%s”' ), $att_title ) ); ?>">
- <?php echo $thumb; ?>
- </a>
+ $class = $thumb ? ' class="has-media-icon"' : '';
-<?php }
- }
-?>
- </td>
-<?php
- break;
+ ?>
+ <strong<?php echo $class; ?>>
+ <?php echo $link_start; ?>
+ <?php if ( $thumb ) : ?>
+ <span class="media-icon <?php echo sanitize_html_class( $mime . '-icon' ); ?>"><?php echo $thumb; ?></span>
+ <?php endif; ?>
- case 'title':
-?>
- <td <?php echo $attributes ?>><strong>
- <?php if ( $this->is_trash || ! $user_can_edit ) {
- echo $att_title;
- } else { ?>
- <a href="<?php echo get_edit_post_link( $post->ID ); ?>"
- title="<?php echo esc_attr( sprintf( __( 'Edit “%s”' ), $att_title ) ); ?>">
- <?php echo $att_title; ?></a>
- <?php };
- _media_states( $post ); ?></strong>
- <p class="filename"><?php echo wp_basename( $post->guid ); ?></p>
-<?php
- echo $this->row_actions( $this->_get_row_actions( $post, $att_title ) );
-?>
- </td>
-<?php
- break;
+ <span aria-hidden="true"><?php echo $title; ?></span>
+ <span class="screen-reader-text"><?php printf( __( 'Edit “%s”' ), $title ); ?></span>
+ <?php echo $link_end; ?>
+ <?php _media_states( $post ); ?>
+ </strong>
+ <p class="filename">
+ <span class="screen-reader-text"><?php _e( 'File name:' ); ?> </span>
+ <?php
+ $file = get_attached_file( $post->ID );
+ echo wp_basename( $file );
+ ?>
+ </p>
+ <?php
+ }
- case 'author':
-?>
- <td <?php echo $attributes ?>><?php
- printf( '<a href="%s">%s</a>',
- esc_url( add_query_arg( array( 'author' => get_the_author_meta('ID') ), 'upload.php' ) ),
- get_the_author()
- );
- ?></td>
-<?php
- break;
+ /**
+ * Handles the author column output.
+ *
+ * @since 4.3.0
+ * @access public
+ *
+ * @param WP_Post $post The current WP_Post object.
+ */
+ public function column_author( $post ) {
+ printf( '<a href="%s">%s</a>',
+ esc_url( add_query_arg( array( 'author' => get_the_author_meta('ID') ), 'upload.php' ) ),
+ get_the_author()
+ );
+ }
- case 'desc':
-?>
- <td <?php echo $attributes ?>><?php echo has_excerpt() ? $post->post_excerpt : ''; ?></td>
-<?php
- break;
+ /**
+ * Handles the description column output.
+ *
+ * @since 4.3.0
+ * @access public
+ *
+ * @param WP_Post $post The current WP_Post object.
+ */
+ public function column_desc( $post ) {
+ echo has_excerpt() ? $post->post_excerpt : '';
+ }
- case 'date':
- if ( '0000-00-00 00:00:00' == $post->post_date ) {
+ /**
+ * Handles the date column output.
+ *
+ * @since 4.3.0
+ * @access public
+ *
+ * @param WP_Post $post The current WP_Post object.
+ */
+ public function column_date( $post ) {
+ if ( '0000-00-00 00:00:00' === $post->post_date ) {
$h_time = __( 'Unpublished' );
} else {
$m_time = $post->post_date;
$time = get_post_time( 'G', true, $post, false );
if ( ( abs( $t_diff = time() - $time ) ) < DAY_IN_SECONDS ) {
- if ( $t_diff < 0 )
+ if ( $t_diff < 0 ) {
$h_time = sprintf( __( '%s from now' ), human_time_diff( $time ) );
- else
+ } else {
$h_time = sprintf( __( '%s ago' ), human_time_diff( $time ) );
+ }
} else {
$h_time = mysql2date( __( 'Y/m/d' ), $m_time );
}
}
-?>
- <td <?php echo $attributes ?>><?php echo $h_time ?></td>
-<?php
- break;
- case 'parent':
- if ( $post->post_parent > 0 )
+ echo $h_time;
+ }
+
+ /**
+ * Handles the parent column output.
+ *
+ * @since 4.3.0
+ * @access public
+ *
+ * @param WP_Post $post The current WP_Post object.
+ */
+ public function column_parent( $post ) {
+ $user_can_edit = current_user_can( 'edit_post', $post->ID );
+
+ if ( $post->post_parent > 0 ) {
$parent = get_post( $post->post_parent );
- else
+ } else {
$parent = false;
+ }
if ( $parent ) {
$title = _draft_or_post_title( $post->post_parent );
$parent_type = get_post_type_object( $parent->post_type );
?>
- <td <?php echo $attributes ?>><strong>
- <?php if ( $parent_type && $parent_type->show_ui && current_user_can( 'edit_post', $post->post_parent ) ) { ?>
- <a href="<?php echo get_edit_post_link( $post->post_parent ); ?>">
- <?php echo $title ?></a><?php
- } else {
- echo $title;
- } ?></strong>,
- <?php echo get_the_time( __( 'Y/m/d' ) ); ?><br />
- <?php
- if ( $user_can_edit ):
- $detach_url = add_query_arg( array(
- 'parent_post_id' => $post->post_parent,
- 'media[]' => $post->ID,
- '_wpnonce' => wp_create_nonce( 'bulk-' . $this->_args['plural'] )
- ), 'upload.php' ); ?>
- <a class="hide-if-no-js detach-from-parent" href="<?php echo $detach_url ?>"><?php _e( 'Detach' ); ?></a>
- <?php endif; ?>
- </td>
-<?php
+ <strong>
+ <?php if ( $parent_type && $parent_type->show_ui && current_user_can( 'edit_post', $post->post_parent ) ) { ?>
+ <a href="<?php echo get_edit_post_link( $post->post_parent ); ?>">
+ <?php echo $title ?></a><?php
+ } else {
+ echo $title;
+ } ?></strong>
+ <br />
+ <?php
+ if ( $user_can_edit ):
+ $detach_url = add_query_arg( array(
+ 'parent_post_id' => $post->post_parent,
+ 'media[]' => $post->ID,
+ '_wpnonce' => wp_create_nonce( 'bulk-' . $this->_args['plural'] )
+ ), 'upload.php' ); ?>
+ <a class="hide-if-no-js detach-from-parent" href="<?php echo $detach_url ?>"><?php _e( 'Detach' ); ?></a>
+ <?php endif;
} else {
-?>
- <td <?php echo $attributes ?>><?php _e( '(Unattached)' ); ?><br />
+ _e( '(Unattached)' ); ?><br />
<?php if ( $user_can_edit ) { ?>
<a class="hide-if-no-js"
onclick="findPosts.open( 'media[]','<?php echo $post->ID ?>' ); return false;"
href="#the-list">
<?php _e( 'Attach' ); ?></a>
- <?php } ?></td>
-<?php
+ <?php }
}
- break;
+ }
- case 'comments':
- $attributes = 'class="comments column-comments num"' . $style;
-?>
- <td <?php echo $attributes ?>>
- <div class="post-com-count-wrapper">
-<?php
- $pending_comments = get_pending_comments_num( $post->ID );
+ /**
+ * Handles the comments column output.
+ *
+ * @since 4.3.0
+ * @access public
+ *
+ * @param WP_Post $post The current WP_Post object.
+ */
+ public function column_comments( $post ) {
+ echo '<div class="post-com-count-wrapper">';
+
+ if ( isset( $this->comment_pending_count[ $post->ID ] ) ) {
+ $pending_comments = $this->comment_pending_count[ $post->ID ];
+ } else {
+ $pending_comments = get_pending_comments_num( $post->ID );
+ }
$this->comments_bubble( $post->ID, $pending_comments );
-?>
- </div>
- </td>
-<?php
- break;
- default:
- if ( 'categories' == $column_name )
+ echo '</div>';
+ }
+
+ /**
+ * Handles output for the default column.
+ *
+ * @since 4.3.0
+ * @access public
+ *
+ * @param WP_Post $post The current WP_Post object.
+ * @param string $column_name Current column name.
+ */
+ public function column_default( $post, $column_name ) {
+ if ( 'categories' === $column_name ) {
$taxonomy = 'category';
- elseif ( 'tags' == $column_name )
+ } elseif ( 'tags' === $column_name ) {
$taxonomy = 'post_tag';
- elseif ( 0 === strpos( $column_name, 'taxonomy-' ) )
+ } elseif ( 0 === strpos( $column_name, 'taxonomy-' ) ) {
$taxonomy = substr( $column_name, 9 );
- else
+ } else {
$taxonomy = false;
+ }
if ( $taxonomy ) {
- echo '<td ' . $attributes . '>';
- if ( $terms = get_the_terms( $post->ID, $taxonomy ) ) {
+ $terms = get_the_terms( $post->ID, $taxonomy );
+ if ( is_array( $terms ) ) {
$out = array();
foreach ( $terms as $t ) {
$posts_in_term_qv = array();
/* translators: used between list items, there is a space after the comma */
echo join( __( ', ' ), $out );
} else {
- echo '—';
+ echo '<span aria-hidden="true">—</span><span class="screen-reader-text">' . get_taxonomy( $taxonomy )->labels->no_terms . '</span>';
}
- echo '</td>';
- break;
+
+ return;
}
-?>
- <td <?php echo $attributes ?>><?php
- /**
- * Fires for each custom column in the Media list table.
- *
- * Custom columns are registered using the 'manage_media_columns' filter.
- *
- * @since 2.5.0
- *
- * @param string $column_name Name of the custom column.
- * @param int $post_id Attachment ID.
- */
- do_action( 'manage_media_custom_column', $column_name, $post->ID );
- ?></td>
-<?php
- break;
+
+ /**
+ * Fires for each custom column in the Media list table.
+ *
+ * Custom columns are registered using the {@see 'manage_media_columns'} filter.
+ *
+ * @since 2.5.0
+ *
+ * @param string $column_name Name of the custom column.
+ * @param int $post_id Attachment ID.
+ */
+ do_action( 'manage_media_custom_column', $column_name, $post->ID );
}
-}
-?>
- </tr>
-<?php endwhile;
+
+ /**
+ *
+ * @global WP_Post $post
+ */
+ public function display_rows() {
+ global $post, $wp_query;
+
+ $post_ids = wp_list_pluck( $wp_query->posts, 'ID' );
+ reset( $wp_query->posts );
+
+ $this->comment_pending_count = get_pending_comments_num( $post_ids );
+
+ add_filter( 'the_title','esc_html' );
+
+ while ( have_posts() ) : the_post();
+ if (
+ ( $this->is_trash && $post->post_status != 'trash' )
+ || ( ! $this->is_trash && $post->post_status === 'trash' )
+ ) {
+ continue;
+ }
+ $post_owner = ( get_current_user_id() == $post->post_author ) ? 'self' : 'other';
+ ?>
+ <tr id="post-<?php echo $post->ID; ?>" class="<?php echo trim( ' author-' . $post_owner . ' status-' . $post->post_status ); ?>">
+ <?php $this->single_row_columns( $post ); ?>
+ </tr>
+ <?php
+ endwhile;
+ }
+
+ /**
+ * Gets the name of the default primary column.
+ *
+ * @since 4.3.0
+ * @access protected
+ *
+ * @return string Name of the default primary column, in this case, 'title'.
+ */
+ protected function get_default_primary_column_name() {
+ return 'title';
}
/**
* @param WP_Post $post
* @param string $att_title
+ *
+ * @return array
*/
private function _get_row_actions( $post, $att_title ) {
$actions = array();
* @param bool $detached Whether the list table contains media not attached
* to any posts. Default true.
*/
- $actions = apply_filters( 'media_row_actions', $actions, $post, $this->detached );
+ return apply_filters( 'media_row_actions', $actions, $post, $this->detached );
+ }
- return $actions;
+ /**
+ * Generates and displays row action links.
+ *
+ * @since 4.3.0
+ * @access protected
+ *
+ * @param object $post Attachment being acted upon.
+ * @param string $column_name Current column name.
+ * @param string $primary Primary column name.
+ * @return string Row actions output for media attachments.
+ */
+ protected function handle_row_actions( $post, $column_name, $primary ) {
+ if ( $primary !== $column_name ) {
+ return '';
+ }
+
+ $att_title = _draft_or_post_title();
+ return $this->row_actions( $this->_get_row_actions( $post, $att_title ) );
}
}
scripts.mit.edu / autoinstalls / wordpress.git / blobdiff