]> scripts.mit.edu Git - autoinstalls/wordpress.git/blobdiff - wp-admin/includes/class-wp-posts-list-table.php
Wordpress 4.6
[autoinstalls/wordpress.git] / wp-admin / includes / class-wp-posts-list-table.php
index d52ebc983213738685edf66acc1e74e7a19e32d4..7ef790e31a252f0e06d7ed98b72e599eab1785d0 100644 (file)
@@ -72,8 +72,8 @@ class WP_Posts_List_Table extends WP_List_Table {
         *
         * @see WP_List_Table::__construct() for more information on default arguments.
         *
-        * @global object $post_type_object
-        * @global wpdb   $wpdb
+        * @global WP_Post_Type $post_type_object
+        * @global wpdb         $wpdb
         *
         * @param array $args An associative array of arguments.
         */
@@ -174,9 +174,9 @@ class WP_Posts_List_Table extends WP_List_Table {
 
                if ( ! empty( $_REQUEST['mode'] ) ) {
                        $mode = $_REQUEST['mode'] === 'excerpt' ? 'excerpt' : 'list';
-                       set_user_setting ( 'posts_list_mode', $mode );
+                       set_user_setting( 'posts_list_mode', $mode );
                } else {
-                       $mode = get_user_setting ( 'posts_list_mode', 'list' );
+                       $mode = get_user_setting( 'posts_list_mode', 'list' );
                }
 
                $this->is_trash = isset( $_REQUEST['post_status'] ) && $_REQUEST['post_status'] === 'trash';
@@ -412,31 +412,56 @@ class WP_Posts_List_Table extends WP_List_Table {
        }
 
        /**
-        * @global int $cat
+        * Displays a categories drop-down for filtering on the Posts list table.
+        *
+        * @since 4.6.0
+        * @access protected
+        *
+        * @global int $cat Currently selected category.
+        *
+        * @param string $post_type Post type slug.
+        */
+       protected function categories_dropdown( $post_type ) {
+               global $cat;
+
+               /**
+                * Filters whether to remove the 'Categories' drop-down from the post list table.
+                *
+                * @since 4.6.0
+                *
+                * @param bool   $disable   Whether to disable the categories drop-down. Default false.
+                * @param string $post_type Post type slug.
+                */
+               if ( false !== apply_filters( 'disable_categories_dropdown', false, $post_type ) ) {
+                       return;
+               }
+
+               if ( is_object_in_taxonomy( $post_type, 'category' ) ) {
+                       $dropdown_options = array(
+                               'show_option_all' => get_taxonomy( 'category' )->labels->all_items,
+                               'hide_empty' => 0,
+                               'hierarchical' => 1,
+                               'show_count' => 0,
+                               'orderby' => 'name',
+                               'selected' => $cat
+                       );
+
+                       echo '<label class="screen-reader-text" for="cat">' . __( 'Filter by category' ) . '</label>';
+                       wp_dropdown_categories( $dropdown_options );
+               }
+       }
+
+       /**
         * @param string $which
         */
        protected function extra_tablenav( $which ) {
-               global $cat;
 ?>
                <div class="alignleft actions">
 <?php
                if ( 'top' === $which && !is_singular() ) {
 
                        $this->months_dropdown( $this->screen->post_type );
-
-                       if ( is_object_in_taxonomy( $this->screen->post_type, 'category' ) ) {
-                               $dropdown_options = array(
-                                       'show_option_all' => __( 'All categories' ),
-                                       'hide_empty' => 0,
-                                       'hierarchical' => 1,
-                                       'show_count' => 0,
-                                       'orderby' => 'name',
-                                       'selected' => $cat
-                               );
-
-                               echo '<label class="screen-reader-text" for="cat">' . __( 'Filter by category' ) . '</label>';
-                               wp_dropdown_categories( $dropdown_options );
-                       }
+                       $this->categories_dropdown( $this->screen->post_type );
 
                        /**
                         * Fires before the Filter button on the Posts and Pages list tables.
@@ -446,10 +471,13 @@ class WP_Posts_List_Table extends WP_List_Table {
                         *
                         * @since 2.1.0
                         * @since 4.4.0 The `$post_type` parameter was added.
+                        * @since 4.6.0 The `$which` parameter was added.
                         *
                         * @param string $post_type The post type slug.
+                        * @param string $which     The location of the extra table nav markup:
+                        *                          'top' or 'bottom'.
                         */
-                       do_action( 'restrict_manage_posts', $this->screen->post_type );
+                       do_action( 'restrict_manage_posts', $this->screen->post_type, $which );
 
                        submit_button( __( 'Filter' ), 'button', 'filter_action', false, array( 'id' => 'post-query-submit' ) );
                }
@@ -512,7 +540,7 @@ class WP_Posts_List_Table extends WP_List_Table {
                $taxonomies = wp_filter_object_list( $taxonomies, array( 'show_admin_column' => true ), 'and', 'name' );
 
                /**
-                * Filter the taxonomy columns in the Posts list table.
+                * Filters the taxonomy columns in the Posts list table.
                 *
                 * The dynamic portion of the hook name, `$post_type`, refers to the post
                 * type slug.
@@ -545,7 +573,7 @@ class WP_Posts_List_Table extends WP_List_Table {
                if ( 'page' === $post_type ) {
 
                        /**
-                        * Filter the columns displayed in the Pages list table.
+                        * Filters the columns displayed in the Pages list table.
                         *
                         * @since 2.5.0
                         *
@@ -555,7 +583,7 @@ class WP_Posts_List_Table extends WP_List_Table {
                } else {
 
                        /**
-                        * Filter the columns displayed in the Posts list table.
+                        * Filters the columns displayed in the Posts list table.
                         *
                         * @since 1.5.0
                         *
@@ -566,7 +594,7 @@ class WP_Posts_List_Table extends WP_List_Table {
                }
 
                /**
-                * Filter the columns displayed in the Posts list table for a specific post type.
+                * Filters the columns displayed in the Posts list table for a specific post type.
                 *
                 * The dynamic portion of the hook name, `$post_type`, refers to the post type slug.
                 *
@@ -877,8 +905,14 @@ class WP_Posts_List_Table extends WP_List_Table {
                $title = _draft_or_post_title();
 
                if ( $can_edit_post && $post->post_status != 'trash' ) {
-                       $edit_link = get_edit_post_link( $post->ID );
-                       echo '<a class="row-title" href="' . $edit_link . '" title="' . esc_attr( sprintf( __( 'Edit &#8220;%s&#8221;' ), $title ) ) . '">' . $pad . $title . '</a>';
+                       printf(
+                               '<a class="row-title" href="%s" aria-label="%s">%s%s</a>',
+                               get_edit_post_link( $post->ID ),
+                               /* translators: %s: post title */
+                               esc_attr( sprintf( __( '&#8220;%s&#8221; (Edit)' ), $title ) ),
+                               $pad,
+                               $title
+                       );
                } else {
                        echo $pad . $title;
                }
@@ -955,7 +989,7 @@ class WP_Posts_List_Table extends WP_List_Table {
                echo '<br />';
                if ( 'excerpt' === $mode ) {
                        /**
-                        * Filter the published time of the post.
+                        * Filters the published time of the post.
                         *
                         * If `$mode` equals 'excerpt', the published time and date are both displayed.
                         * If `$mode` equals 'list' (default), the publish date is displayed, with the
@@ -1169,38 +1203,80 @@ class WP_Posts_List_Table extends WP_List_Table {
                $post_type_object = get_post_type_object( $post->post_type );
                $can_edit_post = current_user_can( 'edit_post', $post->ID );
                $actions = array();
+               $title = _draft_or_post_title();
 
                if ( $can_edit_post && 'trash' != $post->post_status ) {
-                       $actions['edit'] = '<a href="' . get_edit_post_link( $post->ID ) . '" title="' . esc_attr__( 'Edit this item' ) . '">' . __( 'Edit' ) . '</a>';
-                       $actions['inline hide-if-no-js'] = '<a href="#" class="editinline" title="' . esc_attr__( 'Edit this item inline' ) . '">' . __( 'Quick&nbsp;Edit' ) . '</a>';
+                       $actions['edit'] = sprintf(
+                               '<a href="%s" aria-label="%s">%s</a>',
+                               get_edit_post_link( $post->ID ),
+                               /* translators: %s: post title */
+                               esc_attr( sprintf( __( 'Edit &#8220;%s&#8221;' ), $title ) ),
+                               __( 'Edit' )
+                       );
+                       $actions['inline hide-if-no-js'] = sprintf(
+                               '<a href="#" class="editinline" aria-label="%s">%s</a>',
+                               /* translators: %s: post title */
+                               esc_attr( sprintf( __( 'Quick edit &#8220;%s&#8221; inline' ), $title ) ),
+                               __( 'Quick&nbsp;Edit' )
+                       );
                }
 
                if ( current_user_can( 'delete_post', $post->ID ) ) {
-                       if ( 'trash' === $post->post_status )
-                               $actions['untrash'] = "<a title='" . esc_attr__( 'Restore this item from the Trash' ) . "' href='" . wp_nonce_url( admin_url( sprintf( $post_type_object->_edit_link . '&amp;action=untrash', $post->ID ) ), 'untrash-post_' . $post->ID ) . "'>" . __( 'Restore' ) . "</a>";
-                       elseif ( EMPTY_TRASH_DAYS )
-                               $actions['trash'] = "<a class='submitdelete' title='" . esc_attr__( 'Move this item to the Trash' ) . "' href='" . get_delete_post_link( $post->ID ) . "'>" . __( 'Trash' ) . "</a>";
-                       if ( 'trash' === $post->post_status || !EMPTY_TRASH_DAYS )
-                               $actions['delete'] = "<a class='submitdelete' title='" . esc_attr__( 'Delete this item permanently' ) . "' href='" . get_delete_post_link( $post->ID, '', true ) . "'>" . __( 'Delete Permanently' ) . "</a>";
+                       if ( 'trash' === $post->post_status ) {
+                               $actions['untrash'] = sprintf(
+                                       '<a href="%s" aria-label="%s">%s</a>',
+                                       wp_nonce_url( admin_url( sprintf( $post_type_object->_edit_link . '&amp;action=untrash', $post->ID ) ), 'untrash-post_' . $post->ID ),
+                                       /* translators: %s: post title */
+                                       esc_attr( sprintf( __( 'Restore &#8220;%s&#8221; from the Trash' ), $title ) ),
+                                       __( 'Restore' )
+                               );
+                       } elseif ( EMPTY_TRASH_DAYS ) {
+                               $actions['trash'] = sprintf(
+                                       '<a href="%s" class="submitdelete" aria-label="%s">%s</a>',
+                                       get_delete_post_link( $post->ID ),
+                                       /* translators: %s: post title */
+                                       esc_attr( sprintf( __( 'Move &#8220;%s&#8221; to the Trash' ), $title ) ),
+                                       _x( 'Trash', 'verb' )
+                               );
+                       }
+                       if ( 'trash' === $post->post_status || ! EMPTY_TRASH_DAYS ) {
+                               $actions['delete'] = sprintf(
+                                       '<a href="%s" class="submitdelete" aria-label="%s">%s</a>',
+                                       get_delete_post_link( $post->ID, '', true ),
+                                       /* translators: %s: post title */
+                                       esc_attr( sprintf( __( 'Delete &#8220;%s&#8221; permanently' ), $title ) ),
+                                       __( 'Delete Permanently' )
+                               );
+                       }
                }
 
                if ( is_post_type_viewable( $post_type_object ) ) {
-                       $title = _draft_or_post_title();
                        if ( in_array( $post->post_status, array( 'pending', 'draft', 'future' ) ) ) {
                                if ( $can_edit_post ) {
-                                       $unpublished_link = set_url_scheme( get_permalink( $post ) );
-                                       $preview_link = get_preview_post_link( $post, array(), $unpublished_link );
-                                       $actions['view'] = '<a href="' . esc_url( $preview_link ) . '" title="' . esc_attr( sprintf( __( 'Preview &#8220;%s&#8221;' ), $title ) ) . '" rel="permalink">' . __( 'Preview' ) . '</a>';
+                                       $preview_link = get_preview_post_link( $post );
+                                       $actions['view'] = sprintf(
+                                               '<a href="%s" rel="permalink" aria-label="%s">%s</a>',
+                                               esc_url( $preview_link ),
+                                               /* translators: %s: post title */
+                                               esc_attr( sprintf( __( 'Preview &#8220;%s&#8221;' ), $title ) ),
+                                               __( 'Preview' )
+                                       );
                                }
                        } elseif ( 'trash' != $post->post_status ) {
-                               $actions['view'] = '<a href="' . get_permalink( $post->ID ) . '" title="' . esc_attr( sprintf( __( 'View &#8220;%s&#8221;' ), $title ) ) . '" rel="permalink">' . __( 'View' ) . '</a>';
+                               $actions['view'] = sprintf(
+                                       '<a href="%s" rel="permalink" aria-label="%s">%s</a>',
+                                       get_permalink( $post->ID ),
+                                       /* translators: %s: post title */
+                                       esc_attr( sprintf( __( 'View &#8220;%s&#8221;' ), $title ) ),
+                                       __( 'View' )
+                               );
                        }
                }
 
                if ( is_post_type_hierarchical( $post->post_type ) ) {
 
                        /**
-                        * Filter the array of row action links on the Pages list table.
+                        * Filters the array of row action links on the Pages list table.
                         *
                         * The filter is evaluated only for hierarchical post types.
                         *
@@ -1215,7 +1291,7 @@ class WP_Posts_List_Table extends WP_List_Table {
                } else {
 
                        /**
-                        * Filter the array of row action links on the Posts list table.
+                        * Filters the array of row action links on the Posts list table.
                         *
                         * The filter is evaluated only for non-hierarchical post types.
                         *
@@ -1257,7 +1333,7 @@ class WP_Posts_List_Table extends WP_List_Table {
                        $show_in_quick_edit = $taxonomy->show_in_quick_edit;
 
                        /**
-                        * Filter whether the current taxonomy should be shown in the Quick Edit panel.
+                        * Filters whether the current taxonomy should be shown in the Quick Edit panel.
                         *
                         * @since 4.2.0
                         *
@@ -1335,7 +1411,8 @@ class WP_Posts_List_Table extends WP_List_Table {
                                        'name' => 'post_author',
                                        'class'=> 'authors',
                                        'multi' => 1,
-                                       'echo' => 0
+                                       'echo' => 0,
+                                       'show' => 'display_name_with_login',
                                );
                                if ( $bulk )
                                        $users_opt['show_option_none'] = __( '&mdash; No Change &mdash;' );
@@ -1355,7 +1432,7 @@ class WP_Posts_List_Table extends WP_List_Table {
        if ( !$bulk && $can_publish ) :
        ?>
 
-                       <div class="inline-edit-group">
+                       <div class="inline-edit-group wp-clearfix">
                                <label class="alignleft">
                                        <span class="title"><?php _e( 'Password' ); ?></span>
                                        <span class="input-text-wrap"><input type="text" name="post_password" class="inline-edit-password-input" value="" /></span>
@@ -1421,7 +1498,7 @@ class WP_Posts_List_Table extends WP_List_Table {
                        $dropdown_args['show_option_no_change'] =  __( '&mdash; No Change &mdash;' );
 
                /**
-                * Filter the arguments used to generate the Quick Edit page-parent drop-down.
+                * Filters the arguments used to generate the Quick Edit page-parent drop-down.
                 *
                 * @since 2.7.0
                 *
@@ -1487,7 +1564,7 @@ class WP_Posts_List_Table extends WP_List_Table {
        <?php if ( post_type_supports( $screen->post_type, 'comments' ) || post_type_supports( $screen->post_type, 'trackbacks' ) ) :
                if ( $bulk ) : ?>
 
-                       <div class="inline-edit-group">
+                       <div class="inline-edit-group wp-clearfix">
                <?php if ( post_type_supports( $screen->post_type, 'comments' ) ) : ?>
                        <label class="alignleft">
                                <span class="title"><?php _e( 'Comments' ); ?></span>
@@ -1511,7 +1588,7 @@ class WP_Posts_List_Table extends WP_List_Table {
 
        <?php else : // $bulk ?>
 
-                       <div class="inline-edit-group">
+                       <div class="inline-edit-group wp-clearfix">
                        <?php if ( post_type_supports( $screen->post_type, 'comments' ) ) : ?>
                                <label class="alignleft">
                                        <input type="checkbox" name="comment_status" value="open" />
@@ -1528,7 +1605,7 @@ class WP_Posts_List_Table extends WP_List_Table {
        <?php endif; // $bulk
        endif; // post_type_supports comments or pings ?>
 
-                       <div class="inline-edit-group">
+                       <div class="inline-edit-group wp-clearfix">
                                <label class="inline-edit-status alignleft">
                                        <span class="title"><?php _e( 'Status' ); ?></span>
                                        <select name="_status">