diff -r 490d5cc509ed -r cf61fcea0001 wp/wp-admin/includes/class-wp-list-table.php --- a/wp/wp-admin/includes/class-wp-list-table.php Tue Jun 09 11:14:17 2015 +0000 +++ b/wp/wp-admin/includes/class-wp-list-table.php Mon Oct 14 17:39:30 2019 +0200 @@ -1,35 +1,38 @@ get_column_info() + * Stores the value returned by ->get_column_info(). * + * @since 4.1.0 * @var array */ protected $_column_headers; + /** + * {@internal Missing Summary} + * + * @var array + */ protected $compat_fields = array( '_args', '_pagination_args', 'screen', '_actions', '_pagination' ); + /** + * {@internal Missing Summary} + * + * @var array + */ protected $compat_methods = array( 'set_pagination_args', 'get_views', 'get_bulk_actions', 'bulk_actions', 'row_actions', 'months_dropdown', 'view_switcher', 'comments_bubble', 'get_items_per_page', 'pagination', 'get_sortable_columns', 'get_column_info', 'get_table_classes', 'display_tablenav', 'extra_tablenav', @@ -93,7 +103,6 @@ * the default $args. * * @since 3.1.0 - * @access public * * @param array|string $args { * Array or string of arguments. @@ -103,10 +112,10 @@ * in the list table, e.g. 'posts'. Default empty. * @type string $singular Singular label for an object being listed, e.g. 'post'. * Default empty - * @type bool $ajax Whether the list table supports AJAX. This includes loading + * @type bool $ajax Whether the list table supports Ajax. This includes loading * and sorting data, for example. If true, the class will call - * the {@see _js_vars()} method in the footer to provide variables - * to any scripts handling AJAX events. Default false. + * the _js_vars() method in the footer to provide variables + * to any scripts handling Ajax events. Default false. * @type string $screen String containing the hook name used to determine the current * screen. If left null, the current screen will be automatically set. * Default null. @@ -146,10 +155,9 @@ } /** - * Make private properties readable for backwards compatibility. + * Make private properties readable for backward compatibility. * * @since 4.0.0 - * @access public * * @param string $name Property to get. * @return mixed Property. @@ -161,10 +169,9 @@ } /** - * Make private properties settable for backwards compatibility. + * Make private properties settable for backward compatibility. * * @since 4.0.0 - * @access public * * @param string $name Property to check if set. * @param mixed $value Property value. @@ -177,10 +184,9 @@ } /** - * Make private properties checkable for backwards compatibility. + * Make private properties checkable for backward compatibility. * * @since 4.0.0 - * @access public * * @param string $name Property to check if set. * @return bool Whether the property is set. @@ -192,10 +198,9 @@ } /** - * Make private properties un-settable for backwards compatibility. + * Make private properties un-settable for backward compatibility. * * @since 4.0.0 - * @access public * * @param string $name Property to unset. */ @@ -206,10 +211,9 @@ } /** - * Make private/protected methods readable for backwards compatibility. + * Make private/protected methods readable for backward compatibility. * * @since 4.0.0 - * @access public * * @param callable $name Method to call. * @param array $arguments Arguments to pass when calling. @@ -226,7 +230,6 @@ * Checks the current user's permissions * * @since 3.1.0 - * @access public * @abstract */ public function ajax_user_can() { @@ -238,7 +241,6 @@ * @uses WP_List_Table::set_pagination_args() * * @since 3.1.0 - * @access public * @abstract */ public function prepare_items() { @@ -248,8 +250,9 @@ /** * An internal method that sets all the necessary pagination arguments * - * @param array $args An associative array with information about the pagination - * @access protected + * @since 3.1.0 + * + * @param array|string $args Array or string of arguments with information about the pagination. */ protected function set_pagination_args( $args ) { $args = wp_parse_args( $args, array( @@ -262,7 +265,7 @@ $args['total_pages'] = ceil( $args['total_items'] / $args['per_page'] ); // Redirect if page number is invalid and headers are not already sent. - if ( ! headers_sent() && ( ! defined( 'DOING_AJAX' ) || ! DOING_AJAX ) && $args['total_pages'] > 0 && $this->get_pagenum() > $args['total_pages'] ) { + if ( ! headers_sent() && ! wp_doing_ajax() && $args['total_pages'] > 0 && $this->get_pagenum() > $args['total_pages'] ) { wp_redirect( add_query_arg( 'paged', $args['total_pages'] ) ); exit; } @@ -274,25 +277,25 @@ * Access the pagination args. * * @since 3.1.0 - * @access public * * @param string $key Pagination argument to retrieve. Common values include 'total_items', * 'total_pages', 'per_page', or 'infinite_scroll'. * @return int Number of items that correspond to the given pagination argument. */ public function get_pagination_arg( $key ) { - if ( 'page' == $key ) + if ( 'page' === $key ) { return $this->get_pagenum(); + } - if ( isset( $this->_pagination_args[$key] ) ) + if ( isset( $this->_pagination_args[$key] ) ) { return $this->_pagination_args[$key]; + } } /** * Whether the table has items to display or not * * @since 3.1.0 - * @access public * * @return bool */ @@ -304,20 +307,18 @@ * Message to be displayed when there are no items * * @since 3.1.0 - * @access public */ public function no_items() { _e( 'No items found.' ); } /** - * Display the search box. + * Displays the search box. * * @since 3.1.0 - * @access public * - * @param string $text The search button text - * @param string $input_id The search input id + * @param string $text The 'submit' button label. + * @param string $input_id ID attribute value for the search input field. */ public function search_box( $text, $input_id ) { if ( empty( $_REQUEST['s'] ) && !$this->has_items() ) @@ -335,9 +336,9 @@ echo ''; ?>

- - - 'search-submit') ); ?> + + + 'search-submit' ) ); ?>

get_views(); /** - * Filter the list of available list table views. + * Filters the list of available list table views. * * The dynamic portion of the hook name, `$this->screen->id`, refers * to the ID of the current screen, usually a string. @@ -378,6 +377,8 @@ if ( empty( $views ) ) return; + $this->screen->render_screen_reader_content( 'heading_views' ); + echo "