2010-08-11 23:54:51 +02:00
|
|
|
<?php
|
2015-10-17 08:07:24 +02:00
|
|
|
/**
|
|
|
|
* Administration API: WP_List_Table class
|
|
|
|
*
|
|
|
|
* @package WordPress
|
|
|
|
* @subpackage List_Table
|
|
|
|
* @since 3.1.0
|
|
|
|
*/
|
|
|
|
|
2010-08-11 23:54:51 +02:00
|
|
|
/**
|
2010-10-25 06:04:18 +02:00
|
|
|
* Base class for displaying a list of items in an ajaxified HTML table.
|
2010-08-11 23:54:51 +02:00
|
|
|
*
|
|
|
|
* @since 3.1.0
|
2011-01-16 22:47:24 +01:00
|
|
|
* @access private
|
2010-08-11 23:54:51 +02:00
|
|
|
*/
|
|
|
|
class WP_List_Table {
|
|
|
|
|
|
|
|
/**
|
2015-10-11 05:34:26 +02:00
|
|
|
* The current list of items.
|
2010-08-11 23:54:51 +02:00
|
|
|
*
|
|
|
|
* @since 3.1.0
|
2015-10-11 05:34:26 +02:00
|
|
|
* @var array
|
2010-08-11 23:54:51 +02:00
|
|
|
*/
|
2014-08-07 04:51:16 +02:00
|
|
|
public $items;
|
2010-08-11 23:54:51 +02:00
|
|
|
|
|
|
|
/**
|
2015-10-11 05:34:26 +02:00
|
|
|
* Various information about the current table.
|
2010-08-11 23:54:51 +02:00
|
|
|
*
|
|
|
|
* @since 3.1.0
|
2015-10-11 05:34:26 +02:00
|
|
|
* @var array
|
2010-08-11 23:54:51 +02:00
|
|
|
*/
|
2014-12-21 00:27:25 +01:00
|
|
|
protected $_args;
|
2010-08-11 23:54:51 +02:00
|
|
|
|
|
|
|
/**
|
2015-10-11 05:34:26 +02:00
|
|
|
* Various information needed for displaying the pagination.
|
2010-08-11 23:54:51 +02:00
|
|
|
*
|
|
|
|
* @since 3.1.0
|
|
|
|
* @var array
|
|
|
|
*/
|
2015-01-12 17:26:21 +01:00
|
|
|
protected $_pagination_args = array();
|
2010-08-11 23:54:51 +02:00
|
|
|
|
|
|
|
/**
|
2015-10-11 05:34:26 +02:00
|
|
|
* The current screen.
|
2010-08-11 23:54:51 +02:00
|
|
|
*
|
|
|
|
* @since 3.1.0
|
2020-10-10 21:14:04 +02:00
|
|
|
* @var WP_Screen
|
2010-08-11 23:54:51 +02:00
|
|
|
*/
|
Add access modifiers to methods and members of list table classes:
* `WP_List_Table` is the base class that implements `__get()` and `__call()` for BC
* Adds unit tests to confirm that subclasses properly inherit magic methods
* Add modifiers to subclasses: `WP_Links_List_Table`, `WP_Media_List_Table`, `WP_MS_Sites_List_Table`, `WP_MS_Themes_List_Table`, `WP_MS_Users_List_Table`, `WP_Plugin_Install_List_Table`, `WP_Plugins_List_Table`, `WP_Posts_List_Table`, `WP_Terms_List_Table`, `WP_Theme_Install_List_Table`, `WP_Themes_List_Table`
See #27881, #22234.
Built from https://develop.svn.wordpress.org/trunk@28493
git-svn-id: http://core.svn.wordpress.org/trunk@28319 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2014-05-19 03:17:15 +02:00
|
|
|
protected $screen;
|
2010-08-11 23:54:51 +02:00
|
|
|
|
|
|
|
/**
|
2015-10-11 05:34:26 +02:00
|
|
|
* Cached bulk actions.
|
2010-08-11 23:54:51 +02:00
|
|
|
*
|
|
|
|
* @since 3.1.0
|
2015-10-11 05:34:26 +02:00
|
|
|
* @var array
|
2010-08-11 23:54:51 +02:00
|
|
|
*/
|
Add access modifiers to methods and members of list table classes:
* `WP_List_Table` is the base class that implements `__get()` and `__call()` for BC
* Adds unit tests to confirm that subclasses properly inherit magic methods
* Add modifiers to subclasses: `WP_Links_List_Table`, `WP_Media_List_Table`, `WP_MS_Sites_List_Table`, `WP_MS_Themes_List_Table`, `WP_MS_Users_List_Table`, `WP_Plugin_Install_List_Table`, `WP_Plugins_List_Table`, `WP_Posts_List_Table`, `WP_Terms_List_Table`, `WP_Theme_Install_List_Table`, `WP_Themes_List_Table`
See #27881, #22234.
Built from https://develop.svn.wordpress.org/trunk@28493
git-svn-id: http://core.svn.wordpress.org/trunk@28319 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2014-05-19 03:17:15 +02:00
|
|
|
private $_actions;
|
2010-08-11 23:54:51 +02:00
|
|
|
|
|
|
|
/**
|
2015-10-11 05:34:26 +02:00
|
|
|
* Cached pagination output.
|
2010-08-11 23:54:51 +02:00
|
|
|
*
|
|
|
|
* @since 3.1.0
|
2015-10-11 05:34:26 +02:00
|
|
|
* @var string
|
2010-08-11 23:54:51 +02:00
|
|
|
*/
|
Add access modifiers to methods and members of list table classes:
* `WP_List_Table` is the base class that implements `__get()` and `__call()` for BC
* Adds unit tests to confirm that subclasses properly inherit magic methods
* Add modifiers to subclasses: `WP_Links_List_Table`, `WP_Media_List_Table`, `WP_MS_Sites_List_Table`, `WP_MS_Themes_List_Table`, `WP_MS_Users_List_Table`, `WP_Plugin_Install_List_Table`, `WP_Plugins_List_Table`, `WP_Posts_List_Table`, `WP_Terms_List_Table`, `WP_Theme_Install_List_Table`, `WP_Themes_List_Table`
See #27881, #22234.
Built from https://develop.svn.wordpress.org/trunk@28493
git-svn-id: http://core.svn.wordpress.org/trunk@28319 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2014-05-19 03:17:15 +02:00
|
|
|
private $_pagination;
|
2010-08-11 23:54:51 +02:00
|
|
|
|
2014-11-01 20:56:24 +01:00
|
|
|
/**
|
2014-11-28 12:22:23 +01:00
|
|
|
* The view switcher modes.
|
2014-11-01 20:56:24 +01:00
|
|
|
*
|
|
|
|
* @since 4.1.0
|
2015-10-11 05:34:26 +02:00
|
|
|
* @var array
|
2014-11-01 20:56:24 +01:00
|
|
|
*/
|
|
|
|
protected $modes = array();
|
|
|
|
|
2015-01-10 07:57:22 +01:00
|
|
|
/**
|
2015-10-11 05:34:26 +02:00
|
|
|
* Stores the value returned by ->get_column_info().
|
2015-01-10 07:57:22 +01:00
|
|
|
*
|
2015-10-11 05:34:26 +02:00
|
|
|
* @since 4.1.0
|
2015-01-10 07:57:22 +01:00
|
|
|
* @var array
|
|
|
|
*/
|
|
|
|
protected $_column_headers;
|
|
|
|
|
2015-10-11 05:34:26 +02:00
|
|
|
/**
|
|
|
|
* {@internal Missing Summary}
|
|
|
|
*
|
|
|
|
* @var array
|
|
|
|
*/
|
2015-01-11 23:20:22 +01:00
|
|
|
protected $compat_fields = array( '_args', '_pagination_args', 'screen', '_actions', '_pagination' );
|
|
|
|
|
2015-10-11 05:34:26 +02:00
|
|
|
/**
|
|
|
|
* {@internal Missing Summary}
|
|
|
|
*
|
|
|
|
* @var array
|
|
|
|
*/
|
2017-12-01 00:11:00 +01:00
|
|
|
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',
|
|
|
|
'single_row_columns',
|
|
|
|
);
|
2015-01-11 23:20:22 +01:00
|
|
|
|
2010-08-11 23:54:51 +02:00
|
|
|
/**
|
2014-08-10 04:18:17 +02:00
|
|
|
* Constructor.
|
2010-08-11 23:54:51 +02:00
|
|
|
*
|
2014-08-10 04:18:17 +02:00
|
|
|
* The child class should call this constructor from its own constructor to override
|
|
|
|
* the default $args.
|
|
|
|
*
|
|
|
|
* @since 3.1.0
|
|
|
|
*
|
|
|
|
* @param array|string $args {
|
|
|
|
* Array or string of arguments.
|
|
|
|
*
|
|
|
|
* @type string $plural Plural value used for labels and the objects being listed.
|
|
|
|
* This affects things such as CSS class-names and nonces used
|
|
|
|
* in the list table, e.g. 'posts'. Default empty.
|
|
|
|
* @type string $singular Singular label for an object being listed, e.g. 'post'.
|
|
|
|
* Default empty
|
2016-07-10 02:51:30 +02:00
|
|
|
* @type bool $ajax Whether the list table supports Ajax. This includes loading
|
2014-08-10 04:18:17 +02:00
|
|
|
* and sorting data, for example. If true, the class will call
|
2016-05-02 06:00:28 +02:00
|
|
|
* the _js_vars() method in the footer to provide variables
|
2016-07-10 02:51:30 +02:00
|
|
|
* to any scripts handling Ajax events. Default false.
|
2014-08-10 04:18:17 +02:00
|
|
|
* @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.
|
|
|
|
* }
|
2014-09-04 17:23:16 +02:00
|
|
|
*/
|
Add access modifiers to methods and members of list table classes:
* `WP_List_Table` is the base class that implements `__get()` and `__call()` for BC
* Adds unit tests to confirm that subclasses properly inherit magic methods
* Add modifiers to subclasses: `WP_Links_List_Table`, `WP_Media_List_Table`, `WP_MS_Sites_List_Table`, `WP_MS_Themes_List_Table`, `WP_MS_Users_List_Table`, `WP_Plugin_Install_List_Table`, `WP_Plugins_List_Table`, `WP_Posts_List_Table`, `WP_Terms_List_Table`, `WP_Theme_Install_List_Table`, `WP_Themes_List_Table`
See #27881, #22234.
Built from https://develop.svn.wordpress.org/trunk@28493
git-svn-id: http://core.svn.wordpress.org/trunk@28319 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2014-05-19 03:17:15 +02:00
|
|
|
public function __construct( $args = array() ) {
|
2017-12-01 00:11:00 +01:00
|
|
|
$args = wp_parse_args(
|
2018-08-17 03:51:36 +02:00
|
|
|
$args,
|
|
|
|
array(
|
2017-12-01 00:11:00 +01:00
|
|
|
'plural' => '',
|
|
|
|
'singular' => '',
|
|
|
|
'ajax' => false,
|
|
|
|
'screen' => null,
|
|
|
|
)
|
|
|
|
);
|
2010-08-11 23:54:51 +02:00
|
|
|
|
2012-09-19 14:43:31 +02:00
|
|
|
$this->screen = convert_to_screen( $args['screen'] );
|
2010-08-11 23:54:51 +02:00
|
|
|
|
2013-09-05 18:34:09 +02:00
|
|
|
add_filter( "manage_{$this->screen->id}_columns", array( $this, 'get_columns' ), 0 );
|
2010-09-24 15:35:06 +02:00
|
|
|
|
2017-12-01 00:11:00 +01:00
|
|
|
if ( ! $args['plural'] ) {
|
2012-09-19 14:43:31 +02:00
|
|
|
$args['plural'] = $this->screen->base;
|
2017-12-01 00:11:00 +01:00
|
|
|
}
|
2010-08-11 23:54:51 +02:00
|
|
|
|
2017-12-01 00:11:00 +01:00
|
|
|
$args['plural'] = sanitize_key( $args['plural'] );
|
2011-10-20 01:51:06 +02:00
|
|
|
$args['singular'] = sanitize_key( $args['singular'] );
|
|
|
|
|
2010-08-11 23:54:51 +02:00
|
|
|
$this->_args = $args;
|
|
|
|
|
2011-01-21 22:17:12 +01:00
|
|
|
if ( $args['ajax'] ) {
|
|
|
|
// wp_enqueue_script( 'list-table' );
|
2013-09-05 18:34:09 +02:00
|
|
|
add_action( 'admin_footer', array( $this, '_js_vars' ) );
|
2011-01-21 22:17:12 +01:00
|
|
|
}
|
2014-11-01 20:56:24 +01:00
|
|
|
|
|
|
|
if ( empty( $this->modes ) ) {
|
|
|
|
$this->modes = array(
|
2020-07-12 13:36:04 +02:00
|
|
|
'list' => __( 'Compact view' ),
|
|
|
|
'excerpt' => __( 'Extended view' ),
|
2014-11-01 20:56:24 +01:00
|
|
|
);
|
|
|
|
}
|
2010-08-11 23:54:51 +02:00
|
|
|
}
|
|
|
|
|
Add access modifiers to methods and members of list table classes:
* `WP_List_Table` is the base class that implements `__get()` and `__call()` for BC
* Adds unit tests to confirm that subclasses properly inherit magic methods
* Add modifiers to subclasses: `WP_Links_List_Table`, `WP_Media_List_Table`, `WP_MS_Sites_List_Table`, `WP_MS_Themes_List_Table`, `WP_MS_Users_List_Table`, `WP_Plugin_Install_List_Table`, `WP_Plugins_List_Table`, `WP_Posts_List_Table`, `WP_Terms_List_Table`, `WP_Theme_Install_List_Table`, `WP_Themes_List_Table`
See #27881, #22234.
Built from https://develop.svn.wordpress.org/trunk@28493
git-svn-id: http://core.svn.wordpress.org/trunk@28319 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2014-05-19 03:17:15 +02:00
|
|
|
/**
|
2016-05-13 20:41:31 +02:00
|
|
|
* Make private properties readable for backward compatibility.
|
Add access modifiers to methods and members of list table classes:
* `WP_List_Table` is the base class that implements `__get()` and `__call()` for BC
* Adds unit tests to confirm that subclasses properly inherit magic methods
* Add modifiers to subclasses: `WP_Links_List_Table`, `WP_Media_List_Table`, `WP_MS_Sites_List_Table`, `WP_MS_Themes_List_Table`, `WP_MS_Users_List_Table`, `WP_Plugin_Install_List_Table`, `WP_Plugins_List_Table`, `WP_Posts_List_Table`, `WP_Terms_List_Table`, `WP_Theme_Install_List_Table`, `WP_Themes_List_Table`
See #27881, #22234.
Built from https://develop.svn.wordpress.org/trunk@28493
git-svn-id: http://core.svn.wordpress.org/trunk@28319 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2014-05-19 03:17:15 +02:00
|
|
|
*
|
|
|
|
* @since 4.0.0
|
2014-07-14 01:55:16 +02:00
|
|
|
*
|
|
|
|
* @param string $name Property to get.
|
|
|
|
* @return mixed Property.
|
Add access modifiers to methods and members of list table classes:
* `WP_List_Table` is the base class that implements `__get()` and `__call()` for BC
* Adds unit tests to confirm that subclasses properly inherit magic methods
* Add modifiers to subclasses: `WP_Links_List_Table`, `WP_Media_List_Table`, `WP_MS_Sites_List_Table`, `WP_MS_Themes_List_Table`, `WP_MS_Users_List_Table`, `WP_Plugin_Install_List_Table`, `WP_Plugins_List_Table`, `WP_Posts_List_Table`, `WP_Terms_List_Table`, `WP_Theme_Install_List_Table`, `WP_Themes_List_Table`
See #27881, #22234.
Built from https://develop.svn.wordpress.org/trunk@28493
git-svn-id: http://core.svn.wordpress.org/trunk@28319 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2014-05-19 03:17:15 +02:00
|
|
|
*/
|
|
|
|
public function __get( $name ) {
|
2020-04-05 05:02:11 +02:00
|
|
|
if ( in_array( $name, $this->compat_fields, true ) ) {
|
2015-01-11 23:20:22 +01:00
|
|
|
return $this->$name;
|
|
|
|
}
|
Add access modifiers to methods and members of list table classes:
* `WP_List_Table` is the base class that implements `__get()` and `__call()` for BC
* Adds unit tests to confirm that subclasses properly inherit magic methods
* Add modifiers to subclasses: `WP_Links_List_Table`, `WP_Media_List_Table`, `WP_MS_Sites_List_Table`, `WP_MS_Themes_List_Table`, `WP_MS_Users_List_Table`, `WP_Plugin_Install_List_Table`, `WP_Plugins_List_Table`, `WP_Posts_List_Table`, `WP_Terms_List_Table`, `WP_Theme_Install_List_Table`, `WP_Themes_List_Table`
See #27881, #22234.
Built from https://develop.svn.wordpress.org/trunk@28493
git-svn-id: http://core.svn.wordpress.org/trunk@28319 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2014-05-19 03:17:15 +02:00
|
|
|
}
|
|
|
|
|
2014-05-19 08:31:15 +02:00
|
|
|
/**
|
2016-05-13 20:41:31 +02:00
|
|
|
* Make private properties settable for backward compatibility.
|
2014-05-19 08:31:15 +02:00
|
|
|
*
|
|
|
|
* @since 4.0.0
|
2014-07-14 01:55:16 +02:00
|
|
|
*
|
2015-01-11 23:20:22 +01:00
|
|
|
* @param string $name Property to check if set.
|
2014-07-14 01:55:16 +02:00
|
|
|
* @param mixed $value Property value.
|
|
|
|
* @return mixed Newly-set property.
|
2014-05-19 08:31:15 +02:00
|
|
|
*/
|
|
|
|
public function __set( $name, $value ) {
|
2020-04-05 05:02:11 +02:00
|
|
|
if ( in_array( $name, $this->compat_fields, true ) ) {
|
2015-01-11 23:20:22 +01:00
|
|
|
return $this->$name = $value;
|
|
|
|
}
|
2014-05-19 08:31:15 +02:00
|
|
|
}
|
|
|
|
|
2014-05-19 08:52:14 +02:00
|
|
|
/**
|
2016-05-13 20:41:31 +02:00
|
|
|
* Make private properties checkable for backward compatibility.
|
2014-05-19 08:52:14 +02:00
|
|
|
*
|
|
|
|
* @since 4.0.0
|
2014-07-14 01:55:16 +02:00
|
|
|
*
|
|
|
|
* @param string $name Property to check if set.
|
|
|
|
* @return bool Whether the property is set.
|
2014-05-19 08:52:14 +02:00
|
|
|
*/
|
|
|
|
public function __isset( $name ) {
|
2020-04-05 05:02:11 +02:00
|
|
|
if ( in_array( $name, $this->compat_fields, true ) ) {
|
2015-01-11 23:20:22 +01:00
|
|
|
return isset( $this->$name );
|
|
|
|
}
|
2014-05-19 08:52:14 +02:00
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
2016-05-13 20:41:31 +02:00
|
|
|
* Make private properties un-settable for backward compatibility.
|
2014-05-19 08:52:14 +02:00
|
|
|
*
|
|
|
|
* @since 4.0.0
|
2014-07-14 01:55:16 +02:00
|
|
|
*
|
|
|
|
* @param string $name Property to unset.
|
2014-05-19 08:52:14 +02:00
|
|
|
*/
|
|
|
|
public function __unset( $name ) {
|
2020-04-05 05:02:11 +02:00
|
|
|
if ( in_array( $name, $this->compat_fields, true ) ) {
|
2015-01-11 23:20:22 +01:00
|
|
|
unset( $this->$name );
|
|
|
|
}
|
2014-05-19 08:52:14 +02:00
|
|
|
}
|
|
|
|
|
Add access modifiers to methods and members of list table classes:
* `WP_List_Table` is the base class that implements `__get()` and `__call()` for BC
* Adds unit tests to confirm that subclasses properly inherit magic methods
* Add modifiers to subclasses: `WP_Links_List_Table`, `WP_Media_List_Table`, `WP_MS_Sites_List_Table`, `WP_MS_Themes_List_Table`, `WP_MS_Users_List_Table`, `WP_Plugin_Install_List_Table`, `WP_Plugins_List_Table`, `WP_Posts_List_Table`, `WP_Terms_List_Table`, `WP_Theme_Install_List_Table`, `WP_Themes_List_Table`
See #27881, #22234.
Built from https://develop.svn.wordpress.org/trunk@28493
git-svn-id: http://core.svn.wordpress.org/trunk@28319 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2014-05-19 03:17:15 +02:00
|
|
|
/**
|
2016-05-13 20:41:31 +02:00
|
|
|
* Make private/protected methods readable for backward compatibility.
|
Add access modifiers to methods and members of list table classes:
* `WP_List_Table` is the base class that implements `__get()` and `__call()` for BC
* Adds unit tests to confirm that subclasses properly inherit magic methods
* Add modifiers to subclasses: `WP_Links_List_Table`, `WP_Media_List_Table`, `WP_MS_Sites_List_Table`, `WP_MS_Themes_List_Table`, `WP_MS_Users_List_Table`, `WP_Plugin_Install_List_Table`, `WP_Plugins_List_Table`, `WP_Posts_List_Table`, `WP_Terms_List_Table`, `WP_Theme_Install_List_Table`, `WP_Themes_List_Table`
See #27881, #22234.
Built from https://develop.svn.wordpress.org/trunk@28493
git-svn-id: http://core.svn.wordpress.org/trunk@28319 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2014-05-19 03:17:15 +02:00
|
|
|
*
|
|
|
|
* @since 4.0.0
|
2014-07-14 01:55:16 +02:00
|
|
|
*
|
2020-07-23 22:01:04 +02:00
|
|
|
* @param string $name Method to call.
|
|
|
|
* @param array $arguments Arguments to pass when calling.
|
2014-07-14 01:55:16 +02:00
|
|
|
* @return mixed|bool Return value of the callback, false otherwise.
|
Add access modifiers to methods and members of list table classes:
* `WP_List_Table` is the base class that implements `__get()` and `__call()` for BC
* Adds unit tests to confirm that subclasses properly inherit magic methods
* Add modifiers to subclasses: `WP_Links_List_Table`, `WP_Media_List_Table`, `WP_MS_Sites_List_Table`, `WP_MS_Themes_List_Table`, `WP_MS_Users_List_Table`, `WP_Plugin_Install_List_Table`, `WP_Plugins_List_Table`, `WP_Posts_List_Table`, `WP_Terms_List_Table`, `WP_Theme_Install_List_Table`, `WP_Themes_List_Table`
See #27881, #22234.
Built from https://develop.svn.wordpress.org/trunk@28493
git-svn-id: http://core.svn.wordpress.org/trunk@28319 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2014-05-19 03:17:15 +02:00
|
|
|
*/
|
|
|
|
public function __call( $name, $arguments ) {
|
2020-04-05 05:02:11 +02:00
|
|
|
if ( in_array( $name, $this->compat_methods, true ) ) {
|
2019-09-15 13:53:56 +02:00
|
|
|
return $this->$name( ...$arguments );
|
2015-01-11 23:20:22 +01:00
|
|
|
}
|
|
|
|
return false;
|
Add access modifiers to methods and members of list table classes:
* `WP_List_Table` is the base class that implements `__get()` and `__call()` for BC
* Adds unit tests to confirm that subclasses properly inherit magic methods
* Add modifiers to subclasses: `WP_Links_List_Table`, `WP_Media_List_Table`, `WP_MS_Sites_List_Table`, `WP_MS_Themes_List_Table`, `WP_MS_Users_List_Table`, `WP_Plugin_Install_List_Table`, `WP_Plugins_List_Table`, `WP_Posts_List_Table`, `WP_Terms_List_Table`, `WP_Theme_Install_List_Table`, `WP_Themes_List_Table`
See #27881, #22234.
Built from https://develop.svn.wordpress.org/trunk@28493
git-svn-id: http://core.svn.wordpress.org/trunk@28319 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2014-05-19 03:17:15 +02:00
|
|
|
}
|
|
|
|
|
2010-08-13 01:21:05 +02:00
|
|
|
/**
|
|
|
|
* Checks the current user's permissions
|
|
|
|
*
|
|
|
|
* @since 3.1.0
|
2011-01-12 09:05:23 +01:00
|
|
|
* @abstract
|
2010-08-13 01:21:05 +02:00
|
|
|
*/
|
Add access modifiers to methods and members of list table classes:
* `WP_List_Table` is the base class that implements `__get()` and `__call()` for BC
* Adds unit tests to confirm that subclasses properly inherit magic methods
* Add modifiers to subclasses: `WP_Links_List_Table`, `WP_Media_List_Table`, `WP_MS_Sites_List_Table`, `WP_MS_Themes_List_Table`, `WP_MS_Users_List_Table`, `WP_Plugin_Install_List_Table`, `WP_Plugins_List_Table`, `WP_Posts_List_Table`, `WP_Terms_List_Table`, `WP_Theme_Install_List_Table`, `WP_Themes_List_Table`
See #27881, #22234.
Built from https://develop.svn.wordpress.org/trunk@28493
git-svn-id: http://core.svn.wordpress.org/trunk@28319 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2014-05-19 03:17:15 +02:00
|
|
|
public function ajax_user_can() {
|
2019-11-17 08:43:01 +01:00
|
|
|
die( 'function WP_List_Table::ajax_user_can() must be overridden in a subclass.' );
|
2010-08-13 01:21:05 +02:00
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Prepares the list of items for displaying.
|
2017-12-01 00:11:00 +01:00
|
|
|
*
|
2010-08-13 01:21:05 +02:00
|
|
|
* @uses WP_List_Table::set_pagination_args()
|
|
|
|
*
|
|
|
|
* @since 3.1.0
|
2011-01-12 09:05:23 +01:00
|
|
|
* @abstract
|
2010-08-13 01:21:05 +02:00
|
|
|
*/
|
Add access modifiers to methods and members of list table classes:
* `WP_List_Table` is the base class that implements `__get()` and `__call()` for BC
* Adds unit tests to confirm that subclasses properly inherit magic methods
* Add modifiers to subclasses: `WP_Links_List_Table`, `WP_Media_List_Table`, `WP_MS_Sites_List_Table`, `WP_MS_Themes_List_Table`, `WP_MS_Users_List_Table`, `WP_Plugin_Install_List_Table`, `WP_Plugins_List_Table`, `WP_Posts_List_Table`, `WP_Terms_List_Table`, `WP_Theme_Install_List_Table`, `WP_Themes_List_Table`
See #27881, #22234.
Built from https://develop.svn.wordpress.org/trunk@28493
git-svn-id: http://core.svn.wordpress.org/trunk@28319 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2014-05-19 03:17:15 +02:00
|
|
|
public function prepare_items() {
|
2019-11-17 08:43:01 +01:00
|
|
|
die( 'function WP_List_Table::prepare_items() must be overridden in a subclass.' );
|
2010-08-13 01:21:05 +02:00
|
|
|
}
|
|
|
|
|
2010-08-11 23:54:51 +02:00
|
|
|
/**
|
|
|
|
* An internal method that sets all the necessary pagination arguments
|
|
|
|
*
|
2015-11-02 22:03:24 +01:00
|
|
|
* @since 3.1.0
|
2015-05-29 22:17:26 +02:00
|
|
|
*
|
2015-11-02 22:03:24 +01:00
|
|
|
* @param array|string $args Array or string of arguments with information about the pagination.
|
2010-08-11 23:54:51 +02:00
|
|
|
*/
|
Add access modifiers to methods and members of list table classes:
* `WP_List_Table` is the base class that implements `__get()` and `__call()` for BC
* Adds unit tests to confirm that subclasses properly inherit magic methods
* Add modifiers to subclasses: `WP_Links_List_Table`, `WP_Media_List_Table`, `WP_MS_Sites_List_Table`, `WP_MS_Themes_List_Table`, `WP_MS_Users_List_Table`, `WP_Plugin_Install_List_Table`, `WP_Plugins_List_Table`, `WP_Posts_List_Table`, `WP_Terms_List_Table`, `WP_Theme_Install_List_Table`, `WP_Themes_List_Table`
See #27881, #22234.
Built from https://develop.svn.wordpress.org/trunk@28493
git-svn-id: http://core.svn.wordpress.org/trunk@28319 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2014-05-19 03:17:15 +02:00
|
|
|
protected function set_pagination_args( $args ) {
|
2017-12-01 00:11:00 +01:00
|
|
|
$args = wp_parse_args(
|
2018-08-17 03:51:36 +02:00
|
|
|
$args,
|
|
|
|
array(
|
2017-12-01 00:11:00 +01:00
|
|
|
'total_items' => 0,
|
|
|
|
'total_pages' => 0,
|
|
|
|
'per_page' => 0,
|
|
|
|
)
|
|
|
|
);
|
2010-08-11 23:54:51 +02:00
|
|
|
|
2017-12-01 00:11:00 +01:00
|
|
|
if ( ! $args['total_pages'] && $args['per_page'] > 0 ) {
|
2010-08-11 23:54:51 +02:00
|
|
|
$args['total_pages'] = ceil( $args['total_items'] / $args['per_page'] );
|
2017-12-01 00:11:00 +01:00
|
|
|
}
|
2010-08-11 23:54:51 +02:00
|
|
|
|
2014-07-17 11:14:16 +02:00
|
|
|
// Redirect if page number is invalid and headers are not already sent.
|
2016-08-23 16:33:30 +02:00
|
|
|
if ( ! headers_sent() && ! wp_doing_ajax() && $args['total_pages'] > 0 && $this->get_pagenum() > $args['total_pages'] ) {
|
2011-05-12 08:09:42 +02:00
|
|
|
wp_redirect( add_query_arg( 'paged', $args['total_pages'] ) );
|
|
|
|
exit;
|
|
|
|
}
|
|
|
|
|
2010-08-11 23:54:51 +02:00
|
|
|
$this->_pagination_args = $args;
|
|
|
|
}
|
|
|
|
|
2010-08-19 00:26:22 +02:00
|
|
|
/**
|
2014-11-04 16:55:23 +01:00
|
|
|
* Access the pagination args.
|
2010-08-19 00:26:22 +02:00
|
|
|
*
|
|
|
|
* @since 3.1.0
|
|
|
|
*
|
2014-11-04 16:55:23 +01:00
|
|
|
* @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.
|
2010-08-19 00:26:22 +02:00
|
|
|
*/
|
Add access modifiers to methods and members of list table classes:
* `WP_List_Table` is the base class that implements `__get()` and `__call()` for BC
* Adds unit tests to confirm that subclasses properly inherit magic methods
* Add modifiers to subclasses: `WP_Links_List_Table`, `WP_Media_List_Table`, `WP_MS_Sites_List_Table`, `WP_MS_Themes_List_Table`, `WP_MS_Users_List_Table`, `WP_Plugin_Install_List_Table`, `WP_Plugins_List_Table`, `WP_Posts_List_Table`, `WP_Terms_List_Table`, `WP_Theme_Install_List_Table`, `WP_Themes_List_Table`
See #27881, #22234.
Built from https://develop.svn.wordpress.org/trunk@28493
git-svn-id: http://core.svn.wordpress.org/trunk@28319 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2014-05-19 03:17:15 +02:00
|
|
|
public function get_pagination_arg( $key ) {
|
2015-09-22 08:06:25 +02:00
|
|
|
if ( 'page' === $key ) {
|
2010-08-19 00:26:22 +02:00
|
|
|
return $this->get_pagenum();
|
2015-09-22 08:06:25 +02:00
|
|
|
}
|
2010-10-21 21:55:28 +02:00
|
|
|
|
2017-12-01 00:11:00 +01:00
|
|
|
if ( isset( $this->_pagination_args[ $key ] ) ) {
|
|
|
|
return $this->_pagination_args[ $key ];
|
2015-09-22 08:06:25 +02:00
|
|
|
}
|
2010-08-19 00:26:22 +02:00
|
|
|
}
|
|
|
|
|
2010-08-11 23:54:51 +02:00
|
|
|
/**
|
2010-10-08 04:35:06 +02:00
|
|
|
* Whether the table has items to display or not
|
2010-08-11 23:54:51 +02:00
|
|
|
*
|
|
|
|
* @since 3.1.0
|
|
|
|
*
|
|
|
|
* @return bool
|
|
|
|
*/
|
Add access modifiers to methods and members of list table classes:
* `WP_List_Table` is the base class that implements `__get()` and `__call()` for BC
* Adds unit tests to confirm that subclasses properly inherit magic methods
* Add modifiers to subclasses: `WP_Links_List_Table`, `WP_Media_List_Table`, `WP_MS_Sites_List_Table`, `WP_MS_Themes_List_Table`, `WP_MS_Users_List_Table`, `WP_Plugin_Install_List_Table`, `WP_Plugins_List_Table`, `WP_Posts_List_Table`, `WP_Terms_List_Table`, `WP_Theme_Install_List_Table`, `WP_Themes_List_Table`
See #27881, #22234.
Built from https://develop.svn.wordpress.org/trunk@28493
git-svn-id: http://core.svn.wordpress.org/trunk@28319 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2014-05-19 03:17:15 +02:00
|
|
|
public function has_items() {
|
2017-12-01 00:11:00 +01:00
|
|
|
return ! empty( $this->items );
|
2010-08-11 23:54:51 +02:00
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Message to be displayed when there are no items
|
|
|
|
*
|
|
|
|
* @since 3.1.0
|
|
|
|
*/
|
Add access modifiers to methods and members of list table classes:
* `WP_List_Table` is the base class that implements `__get()` and `__call()` for BC
* Adds unit tests to confirm that subclasses properly inherit magic methods
* Add modifiers to subclasses: `WP_Links_List_Table`, `WP_Media_List_Table`, `WP_MS_Sites_List_Table`, `WP_MS_Themes_List_Table`, `WP_MS_Users_List_Table`, `WP_Plugin_Install_List_Table`, `WP_Plugins_List_Table`, `WP_Posts_List_Table`, `WP_Terms_List_Table`, `WP_Theme_Install_List_Table`, `WP_Themes_List_Table`
See #27881, #22234.
Built from https://develop.svn.wordpress.org/trunk@28493
git-svn-id: http://core.svn.wordpress.org/trunk@28319 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2014-05-19 03:17:15 +02:00
|
|
|
public function no_items() {
|
2010-08-11 23:54:51 +02:00
|
|
|
_e( 'No items found.' );
|
|
|
|
}
|
|
|
|
|
2010-12-16 21:45:10 +01:00
|
|
|
/**
|
2016-07-23 13:00:36 +02:00
|
|
|
* Displays the search box.
|
2010-12-16 21:45:10 +01:00
|
|
|
*
|
|
|
|
* @since 3.1.0
|
|
|
|
*
|
2016-07-23 13:00:36 +02:00
|
|
|
* @param string $text The 'submit' button label.
|
|
|
|
* @param string $input_id ID attribute value for the search input field.
|
2010-12-16 21:45:10 +01:00
|
|
|
*/
|
Add access modifiers to methods and members of list table classes:
* `WP_List_Table` is the base class that implements `__get()` and `__call()` for BC
* Adds unit tests to confirm that subclasses properly inherit magic methods
* Add modifiers to subclasses: `WP_Links_List_Table`, `WP_Media_List_Table`, `WP_MS_Sites_List_Table`, `WP_MS_Themes_List_Table`, `WP_MS_Users_List_Table`, `WP_Plugin_Install_List_Table`, `WP_Plugins_List_Table`, `WP_Posts_List_Table`, `WP_Terms_List_Table`, `WP_Theme_Install_List_Table`, `WP_Themes_List_Table`
See #27881, #22234.
Built from https://develop.svn.wordpress.org/trunk@28493
git-svn-id: http://core.svn.wordpress.org/trunk@28319 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2014-05-19 03:17:15 +02:00
|
|
|
public function search_box( $text, $input_id ) {
|
2017-12-01 00:11:00 +01:00
|
|
|
if ( empty( $_REQUEST['s'] ) && ! $this->has_items() ) {
|
2010-12-16 21:45:10 +01:00
|
|
|
return;
|
2017-12-01 00:11:00 +01:00
|
|
|
}
|
2010-12-16 21:45:10 +01:00
|
|
|
|
|
|
|
$input_id = $input_id . '-search-input';
|
|
|
|
|
2017-12-01 00:11:00 +01:00
|
|
|
if ( ! empty( $_REQUEST['orderby'] ) ) {
|
2011-01-22 19:36:54 +01:00
|
|
|
echo '<input type="hidden" name="orderby" value="' . esc_attr( $_REQUEST['orderby'] ) . '" />';
|
2017-12-01 00:11:00 +01:00
|
|
|
}
|
|
|
|
if ( ! empty( $_REQUEST['order'] ) ) {
|
2011-01-22 19:36:54 +01:00
|
|
|
echo '<input type="hidden" name="order" value="' . esc_attr( $_REQUEST['order'] ) . '" />';
|
2017-12-01 00:11:00 +01:00
|
|
|
}
|
|
|
|
if ( ! empty( $_REQUEST['post_mime_type'] ) ) {
|
2012-09-04 23:20:51 +02:00
|
|
|
echo '<input type="hidden" name="post_mime_type" value="' . esc_attr( $_REQUEST['post_mime_type'] ) . '" />';
|
2017-12-01 00:11:00 +01:00
|
|
|
}
|
|
|
|
if ( ! empty( $_REQUEST['detached'] ) ) {
|
2012-09-04 23:20:51 +02:00
|
|
|
echo '<input type="hidden" name="detached" value="' . esc_attr( $_REQUEST['detached'] ) . '" />';
|
2017-12-01 00:11:00 +01:00
|
|
|
}
|
2018-08-17 03:51:36 +02:00
|
|
|
?>
|
2010-12-16 21:45:10 +01:00
|
|
|
<p class="search-box">
|
2016-07-23 13:00:36 +02:00
|
|
|
<label class="screen-reader-text" for="<?php echo esc_attr( $input_id ); ?>"><?php echo $text; ?>:</label>
|
|
|
|
<input type="search" id="<?php echo esc_attr( $input_id ); ?>" name="s" value="<?php _admin_search_query(); ?>" />
|
2018-08-17 03:51:36 +02:00
|
|
|
<?php submit_button( $text, '', '', false, array( 'id' => 'search-submit' ) ); ?>
|
2010-12-16 21:45:10 +01:00
|
|
|
</p>
|
2018-08-17 03:51:36 +02:00
|
|
|
<?php
|
2010-12-16 21:45:10 +01:00
|
|
|
}
|
|
|
|
|
2010-09-05 23:26:27 +02:00
|
|
|
/**
|
2020-06-25 10:56:16 +02:00
|
|
|
* Gets the list of views available on this table.
|
|
|
|
*
|
|
|
|
* The format is an associative array:
|
|
|
|
* - `'id' => 'link'`
|
2010-09-05 23:26:27 +02:00
|
|
|
*
|
|
|
|
* @since 3.1.0
|
|
|
|
*
|
|
|
|
* @return array
|
|
|
|
*/
|
Add access modifiers to methods and members of list table classes:
* `WP_List_Table` is the base class that implements `__get()` and `__call()` for BC
* Adds unit tests to confirm that subclasses properly inherit magic methods
* Add modifiers to subclasses: `WP_Links_List_Table`, `WP_Media_List_Table`, `WP_MS_Sites_List_Table`, `WP_MS_Themes_List_Table`, `WP_MS_Users_List_Table`, `WP_Plugin_Install_List_Table`, `WP_Plugins_List_Table`, `WP_Posts_List_Table`, `WP_Terms_List_Table`, `WP_Theme_Install_List_Table`, `WP_Themes_List_Table`
See #27881, #22234.
Built from https://develop.svn.wordpress.org/trunk@28493
git-svn-id: http://core.svn.wordpress.org/trunk@28319 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2014-05-19 03:17:15 +02:00
|
|
|
protected function get_views() {
|
2010-09-05 23:26:27 +02:00
|
|
|
return array();
|
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
2020-06-25 10:56:16 +02:00
|
|
|
* Displays the list of views available on this table.
|
2010-09-05 23:26:27 +02:00
|
|
|
*
|
|
|
|
* @since 3.1.0
|
|
|
|
*/
|
Add access modifiers to methods and members of list table classes:
* `WP_List_Table` is the base class that implements `__get()` and `__call()` for BC
* Adds unit tests to confirm that subclasses properly inherit magic methods
* Add modifiers to subclasses: `WP_Links_List_Table`, `WP_Media_List_Table`, `WP_MS_Sites_List_Table`, `WP_MS_Themes_List_Table`, `WP_MS_Users_List_Table`, `WP_Plugin_Install_List_Table`, `WP_Plugins_List_Table`, `WP_Posts_List_Table`, `WP_Terms_List_Table`, `WP_Theme_Install_List_Table`, `WP_Themes_List_Table`
See #27881, #22234.
Built from https://develop.svn.wordpress.org/trunk@28493
git-svn-id: http://core.svn.wordpress.org/trunk@28319 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2014-05-19 03:17:15 +02:00
|
|
|
public function views() {
|
2010-09-05 23:26:27 +02:00
|
|
|
$views = $this->get_views();
|
2013-11-26 09:12:09 +01:00
|
|
|
/**
|
2016-05-22 20:01:30 +02:00
|
|
|
* Filters the list of available list table views.
|
2013-11-26 09:12:09 +01:00
|
|
|
*
|
2014-11-30 12:28:24 +01:00
|
|
|
* The dynamic portion of the hook name, `$this->screen->id`, refers
|
2013-11-26 09:12:09 +01:00
|
|
|
* to the ID of the current screen, usually a string.
|
|
|
|
*
|
2020-07-25 20:55:03 +02:00
|
|
|
* @since 3.1.0
|
2013-11-26 09:12:09 +01:00
|
|
|
*
|
2018-03-22 21:27:32 +01:00
|
|
|
* @param string[] $views An array of available list table views.
|
2013-11-26 09:12:09 +01:00
|
|
|
*/
|
|
|
|
$views = apply_filters( "views_{$this->screen->id}", $views );
|
2010-09-05 23:26:27 +02:00
|
|
|
|
2017-12-01 00:11:00 +01:00
|
|
|
if ( empty( $views ) ) {
|
2010-09-05 23:26:27 +02:00
|
|
|
return;
|
2017-12-01 00:11:00 +01:00
|
|
|
}
|
2010-09-05 23:26:27 +02:00
|
|
|
|
2015-10-07 03:28:25 +02:00
|
|
|
$this->screen->render_screen_reader_content( 'heading_views' );
|
|
|
|
|
2010-09-05 23:26:27 +02:00
|
|
|
echo "<ul class='subsubsub'>\n";
|
2010-11-05 15:34:09 +01:00
|
|
|
foreach ( $views as $class => $view ) {
|
2010-12-18 00:47:40 +01:00
|
|
|
$views[ $class ] = "\t<li class='$class'>$view";
|
2010-11-05 15:34:09 +01:00
|
|
|
}
|
2010-09-05 23:26:27 +02:00
|
|
|
echo implode( " |</li>\n", $views ) . "</li>\n";
|
2017-12-01 00:11:00 +01:00
|
|
|
echo '</ul>';
|
2010-09-05 23:26:27 +02:00
|
|
|
}
|
|
|
|
|
2010-08-11 23:54:51 +02:00
|
|
|
/**
|
2020-10-18 18:22:10 +02:00
|
|
|
* Retrieves the list of bulk actions available for this table.
|
2020-06-25 10:56:16 +02:00
|
|
|
*
|
2020-10-18 18:22:10 +02:00
|
|
|
* The format is an associative array where each element represents either a top level option value and label, or
|
|
|
|
* an array representing an optgroup and its options.
|
|
|
|
*
|
|
|
|
* For a standard option, the array element key is the field value and the array element value is the field label.
|
|
|
|
*
|
|
|
|
* For an optgroup, the array element key is the label and the array element value is an associative array of
|
|
|
|
* options as above.
|
|
|
|
*
|
|
|
|
* Example:
|
|
|
|
*
|
|
|
|
* [
|
|
|
|
* 'edit' => 'Edit',
|
|
|
|
* 'delete' => 'Delete',
|
|
|
|
* 'Change State' => [
|
|
|
|
* 'feature' => 'Featured',
|
|
|
|
* 'sale' => 'On Sale',
|
|
|
|
* ]
|
|
|
|
* ]
|
2010-08-11 23:54:51 +02:00
|
|
|
*
|
|
|
|
* @since 3.1.0
|
2020-10-18 18:22:10 +02:00
|
|
|
* @since 5.6.0 A bulk action can now contain an array of options in order to create an optgroup.
|
2010-08-11 23:54:51 +02:00
|
|
|
*
|
|
|
|
* @return array
|
|
|
|
*/
|
Add access modifiers to methods and members of list table classes:
* `WP_List_Table` is the base class that implements `__get()` and `__call()` for BC
* Adds unit tests to confirm that subclasses properly inherit magic methods
* Add modifiers to subclasses: `WP_Links_List_Table`, `WP_Media_List_Table`, `WP_MS_Sites_List_Table`, `WP_MS_Themes_List_Table`, `WP_MS_Users_List_Table`, `WP_Plugin_Install_List_Table`, `WP_Plugins_List_Table`, `WP_Posts_List_Table`, `WP_Terms_List_Table`, `WP_Theme_Install_List_Table`, `WP_Themes_List_Table`
See #27881, #22234.
Built from https://develop.svn.wordpress.org/trunk@28493
git-svn-id: http://core.svn.wordpress.org/trunk@28319 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2014-05-19 03:17:15 +02:00
|
|
|
protected function get_bulk_actions() {
|
2010-08-11 23:54:51 +02:00
|
|
|
return array();
|
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
2020-06-25 10:56:16 +02:00
|
|
|
* Displays the bulk actions dropdown.
|
2010-08-11 23:54:51 +02:00
|
|
|
*
|
|
|
|
* @since 3.1.0
|
2014-07-25 02:20:16 +02:00
|
|
|
*
|
|
|
|
* @param string $which The location of the bulk actions: 'top' or 'bottom'.
|
2016-05-13 20:41:31 +02:00
|
|
|
* This is designated as optional for backward compatibility.
|
2010-08-11 23:54:51 +02:00
|
|
|
*/
|
2014-08-07 23:30:15 +02:00
|
|
|
protected function bulk_actions( $which = '' ) {
|
2010-08-11 23:54:51 +02:00
|
|
|
if ( is_null( $this->_actions ) ) {
|
2016-09-23 22:33:30 +02:00
|
|
|
$this->_actions = $this->get_bulk_actions();
|
2020-06-25 10:56:16 +02:00
|
|
|
|
2013-11-26 09:12:09 +01:00
|
|
|
/**
|
2020-10-18 18:22:10 +02:00
|
|
|
* Filters the items in the bulk actions menu of the list table.
|
2013-11-26 09:12:09 +01:00
|
|
|
*
|
2014-11-30 12:28:24 +01:00
|
|
|
* The dynamic portion of the hook name, `$this->screen->id`, refers
|
2020-10-18 18:22:10 +02:00
|
|
|
* to the ID of the current screen.
|
2013-11-26 09:12:09 +01:00
|
|
|
*
|
2020-07-25 20:55:03 +02:00
|
|
|
* @since 3.1.0
|
2020-10-18 18:22:10 +02:00
|
|
|
* @since 5.6.0 A bulk action can now contain an array of options in order to create an optgroup.
|
2013-11-26 09:12:09 +01:00
|
|
|
*
|
2020-10-18 18:22:10 +02:00
|
|
|
* @param array $actions An array of the available bulk actions.
|
2013-11-26 09:12:09 +01:00
|
|
|
*/
|
2020-01-29 01:45:18 +01:00
|
|
|
$this->_actions = apply_filters( "bulk_actions-{$this->screen->id}", $this->_actions ); // phpcs:ignore WordPress.NamingConventions.ValidHookName.UseUnderscores
|
2020-06-25 10:56:16 +02:00
|
|
|
|
|
|
|
$two = '';
|
2011-01-14 08:20:13 +01:00
|
|
|
} else {
|
2010-08-11 23:54:51 +02:00
|
|
|
$two = '2';
|
|
|
|
}
|
|
|
|
|
2017-12-01 00:11:00 +01:00
|
|
|
if ( empty( $this->_actions ) ) {
|
2010-08-11 23:54:51 +02:00
|
|
|
return;
|
2017-12-01 00:11:00 +01:00
|
|
|
}
|
2010-08-11 23:54:51 +02:00
|
|
|
|
2015-09-24 03:07:24 +02:00
|
|
|
echo '<label for="bulk-action-selector-' . esc_attr( $which ) . '" class="screen-reader-text">' . __( 'Select bulk action' ) . '</label>';
|
|
|
|
echo '<select name="action' . $two . '" id="bulk-action-selector-' . esc_attr( $which ) . "\">\n";
|
2020-07-06 23:52:21 +02:00
|
|
|
echo '<option value="-1">' . __( 'Bulk actions' ) . "</option>\n";
|
2011-06-11 01:01:45 +02:00
|
|
|
|
2020-10-18 18:22:10 +02:00
|
|
|
foreach ( $this->_actions as $key => $value ) {
|
|
|
|
if ( is_array( $value ) ) {
|
|
|
|
echo "\t" . '<optgroup label="' . esc_attr( $key ) . '">' . "\n";
|
|
|
|
|
|
|
|
foreach ( $value as $name => $title ) {
|
|
|
|
$class = ( 'edit' === $name ) ? ' class="hide-if-no-js"' : '';
|
|
|
|
|
|
|
|
echo "\t\t" . '<option value="' . esc_attr( $name ) . '"' . $class . '>' . $title . "</option>\n";
|
|
|
|
}
|
|
|
|
echo "\t" . "</optgroup>\n";
|
|
|
|
} else {
|
|
|
|
$class = ( 'edit' === $key ) ? ' class="hide-if-no-js"' : '';
|
2011-06-10 02:01:16 +02:00
|
|
|
|
2020-10-18 18:22:10 +02:00
|
|
|
echo "\t" . '<option value="' . esc_attr( $key ) . '"' . $class . '>' . $value . "</option>\n";
|
|
|
|
}
|
2011-06-10 02:01:16 +02:00
|
|
|
}
|
|
|
|
|
2010-08-11 23:54:51 +02:00
|
|
|
echo "</select>\n";
|
|
|
|
|
2020-08-26 16:18:04 +02:00
|
|
|
submit_button( __( 'Apply' ), 'action', '', false, array( 'id' => "doaction$two" ) );
|
2010-10-28 23:56:43 +02:00
|
|
|
echo "\n";
|
2010-08-11 23:54:51 +02:00
|
|
|
}
|
|
|
|
|
2010-09-22 02:10:39 +02:00
|
|
|
/**
|
2020-06-25 10:56:16 +02:00
|
|
|
* Gets the current action selected from the bulk actions dropdown.
|
2010-09-22 02:10:39 +02:00
|
|
|
*
|
|
|
|
* @since 3.1.0
|
|
|
|
*
|
2020-06-25 10:56:16 +02:00
|
|
|
* @return string|false The action name. False if no action was selected.
|
2010-09-22 02:10:39 +02:00
|
|
|
*/
|
Add access modifiers to methods and members of list table classes:
* `WP_List_Table` is the base class that implements `__get()` and `__call()` for BC
* Adds unit tests to confirm that subclasses properly inherit magic methods
* Add modifiers to subclasses: `WP_Links_List_Table`, `WP_Media_List_Table`, `WP_MS_Sites_List_Table`, `WP_MS_Themes_List_Table`, `WP_MS_Users_List_Table`, `WP_Plugin_Install_List_Table`, `WP_Plugins_List_Table`, `WP_Posts_List_Table`, `WP_Terms_List_Table`, `WP_Theme_Install_List_Table`, `WP_Themes_List_Table`
See #27881, #22234.
Built from https://develop.svn.wordpress.org/trunk@28493
git-svn-id: http://core.svn.wordpress.org/trunk@28319 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2014-05-19 03:17:15 +02:00
|
|
|
public function current_action() {
|
2017-12-01 00:11:00 +01:00
|
|
|
if ( isset( $_REQUEST['filter_action'] ) && ! empty( $_REQUEST['filter_action'] ) ) {
|
2014-06-30 03:10:15 +02:00
|
|
|
return false;
|
2017-12-01 00:11:00 +01:00
|
|
|
}
|
2014-06-30 03:10:15 +02:00
|
|
|
|
2020-06-23 07:56:08 +02:00
|
|
|
if ( isset( $_REQUEST['action'] ) && -1 != $_REQUEST['action'] ) {
|
|
|
|
return $_REQUEST['action'];
|
2017-12-01 00:11:00 +01:00
|
|
|
}
|
2010-10-21 21:55:28 +02:00
|
|
|
|
2020-08-26 16:18:04 +02:00
|
|
|
if ( isset( $_REQUEST['action2'] ) && -1 != $_REQUEST['action2'] ) {
|
|
|
|
return $_REQUEST['action2'];
|
|
|
|
}
|
|
|
|
|
2010-09-22 02:10:39 +02:00
|
|
|
return false;
|
|
|
|
}
|
|
|
|
|
2010-09-05 18:53:59 +02:00
|
|
|
/**
|
2019-10-28 20:48:01 +01:00
|
|
|
* Generates the required HTML for a list of row action links.
|
2010-09-05 18:53:59 +02:00
|
|
|
*
|
|
|
|
* @since 3.1.0
|
|
|
|
*
|
2018-03-22 21:27:32 +01:00
|
|
|
* @param string[] $actions An array of action links.
|
|
|
|
* @param bool $always_visible Whether the actions should be always visible.
|
2019-10-28 20:48:01 +01:00
|
|
|
* @return string The HTML for the row actions.
|
2010-09-05 18:53:59 +02:00
|
|
|
*/
|
Add access modifiers to methods and members of list table classes:
* `WP_List_Table` is the base class that implements `__get()` and `__call()` for BC
* Adds unit tests to confirm that subclasses properly inherit magic methods
* Add modifiers to subclasses: `WP_Links_List_Table`, `WP_Media_List_Table`, `WP_MS_Sites_List_Table`, `WP_MS_Themes_List_Table`, `WP_MS_Users_List_Table`, `WP_Plugin_Install_List_Table`, `WP_Plugins_List_Table`, `WP_Posts_List_Table`, `WP_Terms_List_Table`, `WP_Theme_Install_List_Table`, `WP_Themes_List_Table`
See #27881, #22234.
Built from https://develop.svn.wordpress.org/trunk@28493
git-svn-id: http://core.svn.wordpress.org/trunk@28319 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2014-05-19 03:17:15 +02:00
|
|
|
protected function row_actions( $actions, $always_visible = false ) {
|
2010-09-05 18:53:59 +02:00
|
|
|
$action_count = count( $actions );
|
|
|
|
|
2017-12-01 00:11:00 +01:00
|
|
|
if ( ! $action_count ) {
|
2010-09-05 18:53:59 +02:00
|
|
|
return '';
|
2017-12-01 00:11:00 +01:00
|
|
|
}
|
2010-09-05 18:53:59 +02:00
|
|
|
|
2020-07-07 21:12:03 +02:00
|
|
|
$mode = get_user_setting( 'posts_list_mode', 'list' );
|
2020-07-10 18:04:05 +02:00
|
|
|
|
2020-07-12 13:36:04 +02:00
|
|
|
if ( 'excerpt' === $mode ) {
|
2020-07-07 21:12:03 +02:00
|
|
|
$always_visible = true;
|
|
|
|
}
|
|
|
|
|
2013-09-24 03:54:09 +02:00
|
|
|
$out = '<div class="' . ( $always_visible ? 'row-actions visible' : 'row-actions' ) . '">';
|
2020-07-10 18:04:05 +02:00
|
|
|
|
|
|
|
$i = 0;
|
|
|
|
|
2010-09-05 18:53:59 +02:00
|
|
|
foreach ( $actions as $action => $link ) {
|
|
|
|
++$i;
|
2020-07-10 18:04:05 +02:00
|
|
|
|
|
|
|
$sep = ( $i < $action_count ) ? ' | ' : '';
|
|
|
|
|
|
|
|
$out .= "<span class='$action'>$link$sep</span>";
|
2010-09-05 18:53:59 +02:00
|
|
|
}
|
2020-07-10 18:04:05 +02:00
|
|
|
|
2010-09-05 18:53:59 +02:00
|
|
|
$out .= '</div>';
|
|
|
|
|
List tables: A better responsive view.
Instead of truncating columns, the data that's already in the markup can now be toggled into view. Only seems appropriate to celebrate four years of contributing by finally doing the first thing I ever mocked up.
Known issues / concerns:
* Custom list tables that don't define a primary column will show nothing at all. These are not extremely common, as `WP_List_Table` isn't really recommended for plugin consumption, but it happens. We need to come up with some kind of fallback.
* Some visual elements, particularly whitespace, could use refining.
* Needs a11y review.
* Touch performance on iOS feels sluggish - is there anything we can do about that?
* Would this be better accordion-style (only one expanded at a time)?
* Is `wp_strip_all_tags()` good enough for column titles that have HTML in them? It's essentially a workaround for the fact that core's comments column does that for the icon, which maybe it shouldn't. Perhaps worth another ticket, as a markup change would be fairly independent.
* Visual hierarchy is not great when expanded (also worthy of another ticket).
* Quick edit now becomes noticeably more annoying to cancel out of, as you have to scroll all the way down and you lose your position from before it was opened. Again, worthy of another ticket.
props Michael Arestad, helen.
see #32395.
Built from https://develop.svn.wordpress.org/trunk@33016
git-svn-id: http://core.svn.wordpress.org/trunk@32987 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2015-07-01 03:31:25 +02:00
|
|
|
$out .= '<button type="button" class="toggle-row"><span class="screen-reader-text">' . __( 'Show more details' ) . '</span></button>';
|
|
|
|
|
2010-09-05 18:53:59 +02:00
|
|
|
return $out;
|
|
|
|
}
|
|
|
|
|
2010-08-11 23:54:51 +02:00
|
|
|
/**
|
2019-10-28 20:48:01 +01:00
|
|
|
* Displays a dropdown for filtering items in the list table by month.
|
2010-08-11 23:54:51 +02:00
|
|
|
*
|
|
|
|
* @since 3.1.0
|
2014-12-01 01:33:23 +01:00
|
|
|
*
|
2019-08-04 03:12:56 +02:00
|
|
|
* @global wpdb $wpdb WordPress database abstraction object.
|
2019-08-04 03:46:55 +02:00
|
|
|
* @global WP_Locale $wp_locale WordPress date and time locale object.
|
2015-05-28 23:41:30 +02:00
|
|
|
*
|
2019-10-28 20:48:01 +01:00
|
|
|
* @param string $post_type The post type.
|
2010-08-11 23:54:51 +02:00
|
|
|
*/
|
Add access modifiers to methods and members of list table classes:
* `WP_List_Table` is the base class that implements `__get()` and `__call()` for BC
* Adds unit tests to confirm that subclasses properly inherit magic methods
* Add modifiers to subclasses: `WP_Links_List_Table`, `WP_Media_List_Table`, `WP_MS_Sites_List_Table`, `WP_MS_Themes_List_Table`, `WP_MS_Users_List_Table`, `WP_Plugin_Install_List_Table`, `WP_Plugins_List_Table`, `WP_Posts_List_Table`, `WP_Terms_List_Table`, `WP_Theme_Install_List_Table`, `WP_Themes_List_Table`
See #27881, #22234.
Built from https://develop.svn.wordpress.org/trunk@28493
git-svn-id: http://core.svn.wordpress.org/trunk@28319 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2014-05-19 03:17:15 +02:00
|
|
|
protected function months_dropdown( $post_type ) {
|
2010-08-11 23:54:51 +02:00
|
|
|
global $wpdb, $wp_locale;
|
|
|
|
|
2015-02-12 19:38:29 +01:00
|
|
|
/**
|
2016-05-22 20:01:30 +02:00
|
|
|
* Filters whether to remove the 'Months' drop-down from the post list table.
|
2015-02-12 19:38:29 +01:00
|
|
|
*
|
|
|
|
* @since 4.2.0
|
|
|
|
*
|
|
|
|
* @param bool $disable Whether to disable the drop-down. Default false.
|
|
|
|
* @param string $post_type The post type.
|
|
|
|
*/
|
|
|
|
if ( apply_filters( 'disable_months_dropdown', false, $post_type ) ) {
|
|
|
|
return;
|
|
|
|
}
|
|
|
|
|
List Tables: don't render "extra tablenav" if there are no posts. This includes Bulk Actions, Dates Dropdown, Category Dropdowns, Pagination.
Also ensure that the Months dropdown, when it is shown, shows months from the proper set of posts.
Props egower, CoenJacobs, MikeHansenMe, mehulkaklotar.
Fixes #33824, #21015, #21856.
Built from https://develop.svn.wordpress.org/trunk@34076
git-svn-id: http://core.svn.wordpress.org/trunk@34044 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2015-09-12 10:13:24 +02:00
|
|
|
$extra_checks = "AND post_status != 'auto-draft'";
|
|
|
|
if ( ! isset( $_GET['post_status'] ) || 'trash' !== $_GET['post_status'] ) {
|
|
|
|
$extra_checks .= " AND post_status != 'trash'";
|
|
|
|
} elseif ( isset( $_GET['post_status'] ) ) {
|
2015-09-12 10:19:24 +02:00
|
|
|
$extra_checks = $wpdb->prepare( ' AND post_status = %s', $_GET['post_status'] );
|
List Tables: don't render "extra tablenav" if there are no posts. This includes Bulk Actions, Dates Dropdown, Category Dropdowns, Pagination.
Also ensure that the Months dropdown, when it is shown, shows months from the proper set of posts.
Props egower, CoenJacobs, MikeHansenMe, mehulkaklotar.
Fixes #33824, #21015, #21856.
Built from https://develop.svn.wordpress.org/trunk@34076
git-svn-id: http://core.svn.wordpress.org/trunk@34044 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2015-09-12 10:13:24 +02:00
|
|
|
}
|
|
|
|
|
2017-12-01 00:11:00 +01:00
|
|
|
$months = $wpdb->get_results(
|
|
|
|
$wpdb->prepare(
|
|
|
|
"
|
2010-08-11 23:54:51 +02:00
|
|
|
SELECT DISTINCT YEAR( post_date ) AS year, MONTH( post_date ) AS month
|
|
|
|
FROM $wpdb->posts
|
|
|
|
WHERE post_type = %s
|
List Tables: don't render "extra tablenav" if there are no posts. This includes Bulk Actions, Dates Dropdown, Category Dropdowns, Pagination.
Also ensure that the Months dropdown, when it is shown, shows months from the proper set of posts.
Props egower, CoenJacobs, MikeHansenMe, mehulkaklotar.
Fixes #33824, #21015, #21856.
Built from https://develop.svn.wordpress.org/trunk@34076
git-svn-id: http://core.svn.wordpress.org/trunk@34044 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2015-09-12 10:13:24 +02:00
|
|
|
$extra_checks
|
2010-08-11 23:54:51 +02:00
|
|
|
ORDER BY post_date DESC
|
2018-08-17 03:51:36 +02:00
|
|
|
",
|
|
|
|
$post_type
|
2017-12-01 00:11:00 +01:00
|
|
|
)
|
|
|
|
);
|
2010-08-11 23:54:51 +02:00
|
|
|
|
2013-09-21 20:35:09 +02:00
|
|
|
/**
|
2016-05-22 20:01:30 +02:00
|
|
|
* Filters the 'Months' drop-down results.
|
2013-09-21 20:35:09 +02:00
|
|
|
*
|
|
|
|
* @since 3.7.0
|
|
|
|
*
|
2019-12-06 23:23:04 +01:00
|
|
|
* @param object[] $months Array of the months drop-down query results.
|
|
|
|
* @param string $post_type The post type.
|
2013-09-21 20:35:09 +02:00
|
|
|
*/
|
|
|
|
$months = apply_filters( 'months_dropdown_results', $months, $post_type );
|
|
|
|
|
2010-08-11 23:54:51 +02:00
|
|
|
$month_count = count( $months );
|
|
|
|
|
2017-12-01 00:11:00 +01:00
|
|
|
if ( ! $month_count || ( 1 == $month_count && 0 == $months[0]->month ) ) {
|
2010-08-11 23:54:51 +02:00
|
|
|
return;
|
2017-12-01 00:11:00 +01:00
|
|
|
}
|
2010-08-11 23:54:51 +02:00
|
|
|
|
|
|
|
$m = isset( $_GET['m'] ) ? (int) $_GET['m'] : 0;
|
2018-08-17 03:51:36 +02:00
|
|
|
?>
|
2014-08-07 21:44:15 +02:00
|
|
|
<label for="filter-by-date" class="screen-reader-text"><?php _e( 'Filter by date' ); ?></label>
|
|
|
|
<select name="m" id="filter-by-date">
|
2014-05-19 07:04:16 +02:00
|
|
|
<option<?php selected( $m, 0 ); ?> value="0"><?php _e( 'All dates' ); ?></option>
|
2018-08-17 03:51:36 +02:00
|
|
|
<?php
|
|
|
|
foreach ( $months as $arc_row ) {
|
|
|
|
if ( 0 == $arc_row->year ) {
|
|
|
|
continue;
|
|
|
|
}
|
2010-08-11 23:54:51 +02:00
|
|
|
|
2018-08-17 03:51:36 +02:00
|
|
|
$month = zeroise( $arc_row->month, 2 );
|
|
|
|
$year = $arc_row->year;
|
2010-08-11 23:54:51 +02:00
|
|
|
|
2018-08-17 03:51:36 +02:00
|
|
|
printf(
|
|
|
|
"<option %s value='%s'>%s</option>\n",
|
|
|
|
selected( $m, $year . $month, false ),
|
|
|
|
esc_attr( $arc_row->year . $month ),
|
2019-09-03 02:41:05 +02:00
|
|
|
/* translators: 1: Month name, 2: 4-digit year. */
|
2018-08-17 03:51:36 +02:00
|
|
|
sprintf( __( '%1$s %2$d' ), $wp_locale->get_month( $month ), $year )
|
|
|
|
);
|
|
|
|
}
|
|
|
|
?>
|
2010-08-11 23:54:51 +02:00
|
|
|
</select>
|
2018-08-17 03:51:36 +02:00
|
|
|
<?php
|
2010-08-11 23:54:51 +02:00
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
2020-06-25 10:56:16 +02:00
|
|
|
* Displays a view switcher.
|
2010-08-11 23:54:51 +02:00
|
|
|
*
|
|
|
|
* @since 3.1.0
|
2014-12-01 01:33:23 +01:00
|
|
|
*
|
|
|
|
* @param string $current_mode
|
2010-08-11 23:54:51 +02:00
|
|
|
*/
|
Add access modifiers to methods and members of list table classes:
* `WP_List_Table` is the base class that implements `__get()` and `__call()` for BC
* Adds unit tests to confirm that subclasses properly inherit magic methods
* Add modifiers to subclasses: `WP_Links_List_Table`, `WP_Media_List_Table`, `WP_MS_Sites_List_Table`, `WP_MS_Themes_List_Table`, `WP_MS_Users_List_Table`, `WP_Plugin_Install_List_Table`, `WP_Plugins_List_Table`, `WP_Posts_List_Table`, `WP_Terms_List_Table`, `WP_Theme_Install_List_Table`, `WP_Themes_List_Table`
See #27881, #22234.
Built from https://develop.svn.wordpress.org/trunk@28493
git-svn-id: http://core.svn.wordpress.org/trunk@28319 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2014-05-19 03:17:15 +02:00
|
|
|
protected function view_switcher( $current_mode ) {
|
2018-08-17 03:51:36 +02:00
|
|
|
?>
|
2010-08-11 23:54:51 +02:00
|
|
|
<input type="hidden" name="mode" value="<?php echo esc_attr( $current_mode ); ?>" />
|
|
|
|
<div class="view-switch">
|
2018-08-17 03:51:36 +02:00
|
|
|
<?php
|
|
|
|
foreach ( $this->modes as $mode => $title ) {
|
2019-11-18 17:51:02 +01:00
|
|
|
$classes = array( 'view-' . $mode );
|
|
|
|
$aria_current = '';
|
|
|
|
|
2018-08-17 03:51:36 +02:00
|
|
|
if ( $current_mode === $mode ) {
|
2019-11-18 17:51:02 +01:00
|
|
|
$classes[] = 'current';
|
|
|
|
$aria_current = ' aria-current="page"';
|
2018-08-17 03:51:36 +02:00
|
|
|
}
|
2020-07-12 13:36:04 +02:00
|
|
|
|
2018-08-17 03:51:36 +02:00
|
|
|
printf(
|
2019-11-18 17:51:02 +01:00
|
|
|
"<a href='%s' class='%s' id='view-switch-$mode'$aria_current><span class='screen-reader-text'>%s</span></a>\n",
|
2020-06-05 23:13:10 +02:00
|
|
|
esc_url( remove_query_arg( 'attachment-filter', add_query_arg( 'mode', $mode ) ) ),
|
2018-08-17 03:51:36 +02:00
|
|
|
implode( ' ', $classes ),
|
|
|
|
$title
|
|
|
|
);
|
|
|
|
}
|
2010-08-11 23:54:51 +02:00
|
|
|
?>
|
|
|
|
</div>
|
2018-08-17 03:51:36 +02:00
|
|
|
<?php
|
2010-08-11 23:54:51 +02:00
|
|
|
}
|
|
|
|
|
2010-08-18 18:41:58 +02:00
|
|
|
/**
|
2020-06-25 10:56:16 +02:00
|
|
|
* Displays a comment count bubble.
|
2010-08-18 18:30:27 +02:00
|
|
|
*
|
|
|
|
* @since 3.1.0
|
|
|
|
*
|
2014-07-03 21:28:14 +02:00
|
|
|
* @param int $post_id The post ID.
|
|
|
|
* @param int $pending_comments Number of pending comments.
|
2010-08-18 18:30:27 +02:00
|
|
|
*/
|
Add access modifiers to methods and members of list table classes:
* `WP_List_Table` is the base class that implements `__get()` and `__call()` for BC
* Adds unit tests to confirm that subclasses properly inherit magic methods
* Add modifiers to subclasses: `WP_Links_List_Table`, `WP_Media_List_Table`, `WP_MS_Sites_List_Table`, `WP_MS_Themes_List_Table`, `WP_MS_Users_List_Table`, `WP_Plugin_Install_List_Table`, `WP_Plugins_List_Table`, `WP_Posts_List_Table`, `WP_Terms_List_Table`, `WP_Theme_Install_List_Table`, `WP_Themes_List_Table`
See #27881, #22234.
Built from https://develop.svn.wordpress.org/trunk@28493
git-svn-id: http://core.svn.wordpress.org/trunk@28319 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2014-05-19 03:17:15 +02:00
|
|
|
protected function comments_bubble( $post_id, $pending_comments ) {
|
2015-07-10 23:44:25 +02:00
|
|
|
$approved_comments = get_comments_number();
|
2010-08-18 18:30:27 +02:00
|
|
|
|
2015-07-10 23:44:25 +02:00
|
|
|
$approved_comments_number = number_format_i18n( $approved_comments );
|
2017-12-01 00:11:00 +01:00
|
|
|
$pending_comments_number = number_format_i18n( $pending_comments );
|
2010-08-18 18:30:27 +02:00
|
|
|
|
I18N: Improve translator comments.
* Add missing translator comments.
* Fix placement of some translator comments. Translator comments should be on the line directly above the line containing the translation function call for optimal compatibility with various `.pot` file generation tools. The CS auto-fixing, which changed some inconsistent function calls to multi-line function calls, is part of the reason why this was no longer the case for a select group of translator comments.
Includes minor code layout fixes.
Polyglots, rejoice! All WordPress core files now have translator comments for all strings with placeholders!
Props jrf, subrataemfluence, GaryJ, webdados, Dency, swissspidy, alvarogois, marcomartins, mihaiiceyro, vladwtz, niq1982, flipkeijzer, michielatyoast, chandrapatel, thrijith, joshuanoyce, FesoVik, tessak22, bhaktirajdev, cleancoded, dhavalkasvala, garrett-eclipse, bibliofille, socalchristina, priyankkpatel, 5hel2l2y, adamsilverstein, JeffPaul, pierlo, SergeyBiryukov.
Fixes #44360.
Built from https://develop.svn.wordpress.org/trunk@45926
git-svn-id: http://core.svn.wordpress.org/trunk@45737 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2019-09-01 19:13:59 +02:00
|
|
|
$approved_only_phrase = sprintf(
|
2019-09-03 02:41:05 +02:00
|
|
|
/* translators: %s: Number of comments. */
|
I18N: Improve translator comments.
* Add missing translator comments.
* Fix placement of some translator comments. Translator comments should be on the line directly above the line containing the translation function call for optimal compatibility with various `.pot` file generation tools. The CS auto-fixing, which changed some inconsistent function calls to multi-line function calls, is part of the reason why this was no longer the case for a select group of translator comments.
Includes minor code layout fixes.
Polyglots, rejoice! All WordPress core files now have translator comments for all strings with placeholders!
Props jrf, subrataemfluence, GaryJ, webdados, Dency, swissspidy, alvarogois, marcomartins, mihaiiceyro, vladwtz, niq1982, flipkeijzer, michielatyoast, chandrapatel, thrijith, joshuanoyce, FesoVik, tessak22, bhaktirajdev, cleancoded, dhavalkasvala, garrett-eclipse, bibliofille, socalchristina, priyankkpatel, 5hel2l2y, adamsilverstein, JeffPaul, pierlo, SergeyBiryukov.
Fixes #44360.
Built from https://develop.svn.wordpress.org/trunk@45926
git-svn-id: http://core.svn.wordpress.org/trunk@45737 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2019-09-01 19:13:59 +02:00
|
|
|
_n( '%s comment', '%s comments', $approved_comments ),
|
|
|
|
$approved_comments_number
|
|
|
|
);
|
|
|
|
|
|
|
|
$approved_phrase = sprintf(
|
2019-09-03 02:41:05 +02:00
|
|
|
/* translators: %s: Number of comments. */
|
I18N: Improve translator comments.
* Add missing translator comments.
* Fix placement of some translator comments. Translator comments should be on the line directly above the line containing the translation function call for optimal compatibility with various `.pot` file generation tools. The CS auto-fixing, which changed some inconsistent function calls to multi-line function calls, is part of the reason why this was no longer the case for a select group of translator comments.
Includes minor code layout fixes.
Polyglots, rejoice! All WordPress core files now have translator comments for all strings with placeholders!
Props jrf, subrataemfluence, GaryJ, webdados, Dency, swissspidy, alvarogois, marcomartins, mihaiiceyro, vladwtz, niq1982, flipkeijzer, michielatyoast, chandrapatel, thrijith, joshuanoyce, FesoVik, tessak22, bhaktirajdev, cleancoded, dhavalkasvala, garrett-eclipse, bibliofille, socalchristina, priyankkpatel, 5hel2l2y, adamsilverstein, JeffPaul, pierlo, SergeyBiryukov.
Fixes #44360.
Built from https://develop.svn.wordpress.org/trunk@45926
git-svn-id: http://core.svn.wordpress.org/trunk@45737 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2019-09-01 19:13:59 +02:00
|
|
|
_n( '%s approved comment', '%s approved comments', $approved_comments ),
|
|
|
|
$approved_comments_number
|
|
|
|
);
|
|
|
|
|
|
|
|
$pending_phrase = sprintf(
|
2019-09-03 02:41:05 +02:00
|
|
|
/* translators: %s: Number of comments. */
|
I18N: Improve translator comments.
* Add missing translator comments.
* Fix placement of some translator comments. Translator comments should be on the line directly above the line containing the translation function call for optimal compatibility with various `.pot` file generation tools. The CS auto-fixing, which changed some inconsistent function calls to multi-line function calls, is part of the reason why this was no longer the case for a select group of translator comments.
Includes minor code layout fixes.
Polyglots, rejoice! All WordPress core files now have translator comments for all strings with placeholders!
Props jrf, subrataemfluence, GaryJ, webdados, Dency, swissspidy, alvarogois, marcomartins, mihaiiceyro, vladwtz, niq1982, flipkeijzer, michielatyoast, chandrapatel, thrijith, joshuanoyce, FesoVik, tessak22, bhaktirajdev, cleancoded, dhavalkasvala, garrett-eclipse, bibliofille, socalchristina, priyankkpatel, 5hel2l2y, adamsilverstein, JeffPaul, pierlo, SergeyBiryukov.
Fixes #44360.
Built from https://develop.svn.wordpress.org/trunk@45926
git-svn-id: http://core.svn.wordpress.org/trunk@45737 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2019-09-01 19:13:59 +02:00
|
|
|
_n( '%s pending comment', '%s pending comments', $pending_comments ),
|
|
|
|
$pending_comments_number
|
|
|
|
);
|
2010-08-18 18:30:27 +02:00
|
|
|
|
2015-07-10 23:44:25 +02:00
|
|
|
if ( ! $approved_comments && ! $pending_comments ) {
|
Comments: Don't display edit links to trashed post comments.
If a post is in the trash, the comments bubble won't link to the comments list.
Fixes: #37826.
Props: swissspidy, helen, FolioVision, DrewAPicture, stevenlinx, donmhico, birgire, garrett-eclipse, andraganescu, johnbillion.
Built from https://develop.svn.wordpress.org/trunk@48050
git-svn-id: http://core.svn.wordpress.org/trunk@47817 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2020-06-16 01:06:08 +02:00
|
|
|
// No comments at all.
|
2017-12-01 00:11:00 +01:00
|
|
|
printf(
|
|
|
|
'<span aria-hidden="true">—</span><span class="screen-reader-text">%s</span>',
|
2015-07-10 23:44:25 +02:00
|
|
|
__( 'No comments' )
|
|
|
|
);
|
Comments: Don't display edit links to trashed post comments.
If a post is in the trash, the comments bubble won't link to the comments list.
Fixes: #37826.
Props: swissspidy, helen, FolioVision, DrewAPicture, stevenlinx, donmhico, birgire, garrett-eclipse, andraganescu, johnbillion.
Built from https://develop.svn.wordpress.org/trunk@48050
git-svn-id: http://core.svn.wordpress.org/trunk@47817 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2020-06-16 01:06:08 +02:00
|
|
|
} elseif ( $approved_comments && 'trash' === get_post_status( $post_id ) ) {
|
|
|
|
// Don't link the comment bubble for a trashed post.
|
|
|
|
printf(
|
|
|
|
'<span class="post-com-count post-com-count-approved"><span class="comment-count-approved" aria-hidden="true">%s</span><span class="screen-reader-text">%s</span></span>',
|
|
|
|
$approved_comments_number,
|
|
|
|
$pending_comments ? $approved_phrase : $approved_only_phrase
|
|
|
|
);
|
2015-07-10 23:44:25 +02:00
|
|
|
} elseif ( $approved_comments ) {
|
Comments: Don't display edit links to trashed post comments.
If a post is in the trash, the comments bubble won't link to the comments list.
Fixes: #37826.
Props: swissspidy, helen, FolioVision, DrewAPicture, stevenlinx, donmhico, birgire, garrett-eclipse, andraganescu, johnbillion.
Built from https://develop.svn.wordpress.org/trunk@48050
git-svn-id: http://core.svn.wordpress.org/trunk@47817 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2020-06-16 01:06:08 +02:00
|
|
|
// Link the comment bubble to approved comments.
|
2017-12-01 00:11:00 +01:00
|
|
|
printf(
|
|
|
|
'<a href="%s" class="post-com-count post-com-count-approved"><span class="comment-count-approved" aria-hidden="true">%s</span><span class="screen-reader-text">%s</span></a>',
|
|
|
|
esc_url(
|
|
|
|
add_query_arg(
|
|
|
|
array(
|
|
|
|
'p' => $post_id,
|
|
|
|
'comment_status' => 'approved',
|
2018-08-17 03:51:36 +02:00
|
|
|
),
|
|
|
|
admin_url( 'edit-comments.php' )
|
2017-12-01 00:11:00 +01:00
|
|
|
)
|
|
|
|
),
|
2015-07-10 23:44:25 +02:00
|
|
|
$approved_comments_number,
|
|
|
|
$pending_comments ? $approved_phrase : $approved_only_phrase
|
|
|
|
);
|
|
|
|
} else {
|
Comments: Don't display edit links to trashed post comments.
If a post is in the trash, the comments bubble won't link to the comments list.
Fixes: #37826.
Props: swissspidy, helen, FolioVision, DrewAPicture, stevenlinx, donmhico, birgire, garrett-eclipse, andraganescu, johnbillion.
Built from https://develop.svn.wordpress.org/trunk@48050
git-svn-id: http://core.svn.wordpress.org/trunk@47817 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2020-06-16 01:06:08 +02:00
|
|
|
// Don't link the comment bubble when there are no approved comments.
|
2017-12-01 00:11:00 +01:00
|
|
|
printf(
|
|
|
|
'<span class="post-com-count post-com-count-no-comments"><span class="comment-count comment-count-no-comments" aria-hidden="true">%s</span><span class="screen-reader-text">%s</span></span>',
|
2015-07-10 23:44:25 +02:00
|
|
|
$approved_comments_number,
|
|
|
|
$pending_comments ? __( 'No approved comments' ) : __( 'No comments' )
|
|
|
|
);
|
|
|
|
}
|
|
|
|
|
|
|
|
if ( $pending_comments ) {
|
2017-12-01 00:11:00 +01:00
|
|
|
printf(
|
|
|
|
'<a href="%s" class="post-com-count post-com-count-pending"><span class="comment-count-pending" aria-hidden="true">%s</span><span class="screen-reader-text">%s</span></a>',
|
|
|
|
esc_url(
|
|
|
|
add_query_arg(
|
|
|
|
array(
|
|
|
|
'p' => $post_id,
|
|
|
|
'comment_status' => 'moderated',
|
2018-08-17 03:51:36 +02:00
|
|
|
),
|
|
|
|
admin_url( 'edit-comments.php' )
|
2017-12-01 00:11:00 +01:00
|
|
|
)
|
|
|
|
),
|
2015-07-10 23:44:25 +02:00
|
|
|
$pending_comments_number,
|
|
|
|
$pending_phrase
|
|
|
|
);
|
2015-08-20 18:36:25 +02:00
|
|
|
} else {
|
2017-12-01 00:11:00 +01:00
|
|
|
printf(
|
|
|
|
'<span class="post-com-count post-com-count-pending post-com-count-no-pending"><span class="comment-count comment-count-no-pending" aria-hidden="true">%s</span><span class="screen-reader-text">%s</span></span>',
|
2015-08-20 18:36:25 +02:00
|
|
|
$pending_comments_number,
|
|
|
|
$approved_comments ? __( 'No pending comments' ) : __( 'No comments' )
|
|
|
|
);
|
2015-07-10 23:44:25 +02:00
|
|
|
}
|
2010-08-18 18:30:27 +02:00
|
|
|
}
|
|
|
|
|
2010-08-11 23:54:51 +02:00
|
|
|
/**
|
2020-06-25 10:56:16 +02:00
|
|
|
* Gets the current page number.
|
2010-08-11 23:54:51 +02:00
|
|
|
*
|
|
|
|
* @since 3.1.0
|
|
|
|
*
|
|
|
|
* @return int
|
|
|
|
*/
|
2014-07-12 05:27:14 +02:00
|
|
|
public function get_pagenum() {
|
2010-11-18 18:00:24 +01:00
|
|
|
$pagenum = isset( $_REQUEST['paged'] ) ? absint( $_REQUEST['paged'] ) : 0;
|
2010-10-19 09:48:22 +02:00
|
|
|
|
2017-12-01 00:11:00 +01:00
|
|
|
if ( isset( $this->_pagination_args['total_pages'] ) && $pagenum > $this->_pagination_args['total_pages'] ) {
|
2011-01-12 18:24:34 +01:00
|
|
|
$pagenum = $this->_pagination_args['total_pages'];
|
2017-12-01 00:11:00 +01:00
|
|
|
}
|
2011-01-12 18:24:34 +01:00
|
|
|
|
2010-08-11 23:54:51 +02:00
|
|
|
return max( 1, $pagenum );
|
|
|
|
}
|
|
|
|
|
2010-09-05 17:15:46 +02:00
|
|
|
/**
|
2020-06-25 10:56:16 +02:00
|
|
|
* Gets the number of items to display on a single page.
|
2010-09-05 17:15:46 +02:00
|
|
|
*
|
|
|
|
* @since 3.1.0
|
|
|
|
*
|
2014-12-01 01:33:23 +01:00
|
|
|
* @param string $option
|
|
|
|
* @param int $default
|
2010-09-05 17:15:46 +02:00
|
|
|
* @return int
|
2010-10-19 09:48:22 +02:00
|
|
|
*/
|
Add access modifiers to methods and members of list table classes:
* `WP_List_Table` is the base class that implements `__get()` and `__call()` for BC
* Adds unit tests to confirm that subclasses properly inherit magic methods
* Add modifiers to subclasses: `WP_Links_List_Table`, `WP_Media_List_Table`, `WP_MS_Sites_List_Table`, `WP_MS_Themes_List_Table`, `WP_MS_Users_List_Table`, `WP_Plugin_Install_List_Table`, `WP_Plugins_List_Table`, `WP_Posts_List_Table`, `WP_Terms_List_Table`, `WP_Theme_Install_List_Table`, `WP_Themes_List_Table`
See #27881, #22234.
Built from https://develop.svn.wordpress.org/trunk@28493
git-svn-id: http://core.svn.wordpress.org/trunk@28319 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2014-05-19 03:17:15 +02:00
|
|
|
protected function get_items_per_page( $option, $default = 20 ) {
|
2010-09-05 17:15:46 +02:00
|
|
|
$per_page = (int) get_user_option( $option );
|
2017-12-01 00:11:00 +01:00
|
|
|
if ( empty( $per_page ) || $per_page < 1 ) {
|
2010-09-05 17:15:46 +02:00
|
|
|
$per_page = $default;
|
2017-12-01 00:11:00 +01:00
|
|
|
}
|
2010-09-05 17:15:46 +02:00
|
|
|
|
2013-11-26 09:12:09 +01:00
|
|
|
/**
|
2016-05-22 20:01:30 +02:00
|
|
|
* Filters the number of items to be displayed on each page of the list table.
|
2013-11-26 09:12:09 +01:00
|
|
|
*
|
2020-07-14 00:10:07 +02:00
|
|
|
* The dynamic hook name, `$option`, refers to the `per_page` option depending
|
|
|
|
* on the type of list table in use. Possible filter names include:
|
|
|
|
*
|
|
|
|
* - `edit_comments_per_page`
|
|
|
|
* - `sites_network_per_page`
|
|
|
|
* - `site_themes_network_per_page`
|
|
|
|
* - `themes_network_per_page'`
|
|
|
|
* - `users_network_per_page`
|
|
|
|
* - `edit_post_per_page`
|
|
|
|
* - `edit_page_per_page'`
|
|
|
|
* - `edit_{$post_type}_per_page`
|
|
|
|
* - `edit_post_tag_per_page`
|
|
|
|
* - `edit_category_per_page`
|
|
|
|
* - `edit_{$taxonomy}_per_page`
|
|
|
|
* - `site_users_network_per_page`
|
|
|
|
* - `users_per_page`
|
2013-11-26 09:12:09 +01:00
|
|
|
*
|
|
|
|
* @since 2.9.0
|
|
|
|
*
|
|
|
|
* @param int $per_page Number of items to be displayed. Default 20.
|
|
|
|
*/
|
2016-12-14 05:18:42 +01:00
|
|
|
return (int) apply_filters( "{$option}", $per_page );
|
2010-09-05 17:15:46 +02:00
|
|
|
}
|
|
|
|
|
2010-08-11 23:54:51 +02:00
|
|
|
/**
|
2020-06-25 10:56:16 +02:00
|
|
|
* Displays the pagination.
|
2010-08-11 23:54:51 +02:00
|
|
|
*
|
|
|
|
* @since 3.1.0
|
2014-12-01 01:33:23 +01:00
|
|
|
*
|
|
|
|
* @param string $which
|
2010-08-11 23:54:51 +02:00
|
|
|
*/
|
Add access modifiers to methods and members of list table classes:
* `WP_List_Table` is the base class that implements `__get()` and `__call()` for BC
* Adds unit tests to confirm that subclasses properly inherit magic methods
* Add modifiers to subclasses: `WP_Links_List_Table`, `WP_Media_List_Table`, `WP_MS_Sites_List_Table`, `WP_MS_Themes_List_Table`, `WP_MS_Users_List_Table`, `WP_Plugin_Install_List_Table`, `WP_Plugins_List_Table`, `WP_Posts_List_Table`, `WP_Terms_List_Table`, `WP_Theme_Install_List_Table`, `WP_Themes_List_Table`
See #27881, #22234.
Built from https://develop.svn.wordpress.org/trunk@28493
git-svn-id: http://core.svn.wordpress.org/trunk@28319 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2014-05-19 03:17:15 +02:00
|
|
|
protected function pagination( $which ) {
|
2014-05-13 07:27:14 +02:00
|
|
|
if ( empty( $this->_pagination_args ) ) {
|
2010-08-11 23:54:51 +02:00
|
|
|
return;
|
2014-05-13 07:27:14 +02:00
|
|
|
}
|
2010-08-11 23:54:51 +02:00
|
|
|
|
2017-12-01 00:11:00 +01:00
|
|
|
$total_items = $this->_pagination_args['total_items'];
|
|
|
|
$total_pages = $this->_pagination_args['total_pages'];
|
2014-05-13 07:27:14 +02:00
|
|
|
$infinite_scroll = false;
|
|
|
|
if ( isset( $this->_pagination_args['infinite_scroll'] ) ) {
|
|
|
|
$infinite_scroll = $this->_pagination_args['infinite_scroll'];
|
|
|
|
}
|
2010-08-11 23:54:51 +02:00
|
|
|
|
2015-10-07 03:28:25 +02:00
|
|
|
if ( 'top' === $which && $total_pages > 1 ) {
|
|
|
|
$this->screen->render_screen_reader_content( 'heading_pagination' );
|
|
|
|
}
|
|
|
|
|
I18N: Improve translator comments.
* Add missing translator comments.
* Fix placement of some translator comments. Translator comments should be on the line directly above the line containing the translation function call for optimal compatibility with various `.pot` file generation tools. The CS auto-fixing, which changed some inconsistent function calls to multi-line function calls, is part of the reason why this was no longer the case for a select group of translator comments.
Includes minor code layout fixes.
Polyglots, rejoice! All WordPress core files now have translator comments for all strings with placeholders!
Props jrf, subrataemfluence, GaryJ, webdados, Dency, swissspidy, alvarogois, marcomartins, mihaiiceyro, vladwtz, niq1982, flipkeijzer, michielatyoast, chandrapatel, thrijith, joshuanoyce, FesoVik, tessak22, bhaktirajdev, cleancoded, dhavalkasvala, garrett-eclipse, bibliofille, socalchristina, priyankkpatel, 5hel2l2y, adamsilverstein, JeffPaul, pierlo, SergeyBiryukov.
Fixes #44360.
Built from https://develop.svn.wordpress.org/trunk@45926
git-svn-id: http://core.svn.wordpress.org/trunk@45737 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2019-09-01 19:13:59 +02:00
|
|
|
$output = '<span class="displaying-num">' . sprintf(
|
2019-09-03 02:41:05 +02:00
|
|
|
/* translators: %s: Number of items. */
|
I18N: Improve translator comments.
* Add missing translator comments.
* Fix placement of some translator comments. Translator comments should be on the line directly above the line containing the translation function call for optimal compatibility with various `.pot` file generation tools. The CS auto-fixing, which changed some inconsistent function calls to multi-line function calls, is part of the reason why this was no longer the case for a select group of translator comments.
Includes minor code layout fixes.
Polyglots, rejoice! All WordPress core files now have translator comments for all strings with placeholders!
Props jrf, subrataemfluence, GaryJ, webdados, Dency, swissspidy, alvarogois, marcomartins, mihaiiceyro, vladwtz, niq1982, flipkeijzer, michielatyoast, chandrapatel, thrijith, joshuanoyce, FesoVik, tessak22, bhaktirajdev, cleancoded, dhavalkasvala, garrett-eclipse, bibliofille, socalchristina, priyankkpatel, 5hel2l2y, adamsilverstein, JeffPaul, pierlo, SergeyBiryukov.
Fixes #44360.
Built from https://develop.svn.wordpress.org/trunk@45926
git-svn-id: http://core.svn.wordpress.org/trunk@45737 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2019-09-01 19:13:59 +02:00
|
|
|
_n( '%s item', '%s items', $total_items ),
|
|
|
|
number_format_i18n( $total_items )
|
|
|
|
) . '</span>';
|
2010-08-11 23:54:51 +02:00
|
|
|
|
2017-12-01 00:11:00 +01:00
|
|
|
$current = $this->get_pagenum();
|
2016-06-09 03:56:27 +02:00
|
|
|
$removable_query_args = wp_removable_query_args();
|
2010-08-11 23:54:51 +02:00
|
|
|
|
2012-08-30 15:33:00 +02:00
|
|
|
$current_url = set_url_scheme( 'http://' . $_SERVER['HTTP_HOST'] . $_SERVER['REQUEST_URI'] );
|
2011-02-09 18:35:36 +01:00
|
|
|
|
2016-06-09 03:56:27 +02:00
|
|
|
$current_url = remove_query_arg( $removable_query_args, $current_url );
|
2010-08-11 23:54:51 +02:00
|
|
|
|
|
|
|
$page_links = array();
|
|
|
|
|
2015-06-05 07:01:25 +02:00
|
|
|
$total_pages_before = '<span class="paging-input">';
|
2016-06-29 15:30:28 +02:00
|
|
|
$total_pages_after = '</span></span>';
|
2015-06-05 07:01:25 +02:00
|
|
|
|
2019-07-01 14:52:01 +02:00
|
|
|
$disable_first = false;
|
|
|
|
$disable_last = false;
|
|
|
|
$disable_prev = false;
|
|
|
|
$disable_next = false;
|
2015-06-25 22:32:26 +02:00
|
|
|
|
2020-02-09 17:55:09 +01:00
|
|
|
if ( 1 == $current ) {
|
2015-06-25 22:32:26 +02:00
|
|
|
$disable_first = true;
|
2017-12-01 00:11:00 +01:00
|
|
|
$disable_prev = true;
|
|
|
|
}
|
2020-02-09 17:55:09 +01:00
|
|
|
if ( 2 == $current ) {
|
2015-06-25 22:32:26 +02:00
|
|
|
$disable_first = true;
|
2014-05-13 07:27:14 +02:00
|
|
|
}
|
2020-02-09 17:55:09 +01:00
|
|
|
if ( $total_pages == $current ) {
|
2015-06-25 22:32:26 +02:00
|
|
|
$disable_last = true;
|
|
|
|
$disable_next = true;
|
2017-12-01 00:11:00 +01:00
|
|
|
}
|
2020-02-09 17:55:09 +01:00
|
|
|
if ( $total_pages - 1 == $current ) {
|
2015-06-25 22:32:26 +02:00
|
|
|
$disable_last = true;
|
|
|
|
}
|
|
|
|
|
|
|
|
if ( $disable_first ) {
|
2018-04-29 18:25:21 +02:00
|
|
|
$page_links[] = '<span class="tablenav-pages-navspan button disabled" aria-hidden="true">«</span>';
|
2015-06-25 22:32:26 +02:00
|
|
|
} else {
|
2017-12-01 00:11:00 +01:00
|
|
|
$page_links[] = sprintf(
|
2018-04-29 18:25:21 +02:00
|
|
|
"<a class='first-page button' href='%s'><span class='screen-reader-text'>%s</span><span aria-hidden='true'>%s</span></a>",
|
2015-06-25 22:32:26 +02:00
|
|
|
esc_url( remove_query_arg( 'paged', $current_url ) ),
|
|
|
|
__( 'First page' ),
|
|
|
|
'«'
|
|
|
|
);
|
|
|
|
}
|
|
|
|
|
|
|
|
if ( $disable_prev ) {
|
2018-04-29 18:25:21 +02:00
|
|
|
$page_links[] = '<span class="tablenav-pages-navspan button disabled" aria-hidden="true">‹</span>';
|
2015-06-25 22:32:26 +02:00
|
|
|
} else {
|
2017-12-01 00:11:00 +01:00
|
|
|
$page_links[] = sprintf(
|
2018-04-29 18:25:21 +02:00
|
|
|
"<a class='prev-page button' href='%s'><span class='screen-reader-text'>%s</span><span aria-hidden='true'>%s</span></a>",
|
2017-12-01 00:11:00 +01:00
|
|
|
esc_url( add_query_arg( 'paged', max( 1, $current - 1 ), $current_url ) ),
|
2015-06-25 22:32:26 +02:00
|
|
|
__( 'Previous page' ),
|
|
|
|
'‹'
|
|
|
|
);
|
2014-05-13 07:27:14 +02:00
|
|
|
}
|
2010-08-11 23:54:51 +02:00
|
|
|
|
2015-09-22 08:06:25 +02:00
|
|
|
if ( 'bottom' === $which ) {
|
2015-06-05 07:01:25 +02:00
|
|
|
$html_current_page = $current;
|
2016-06-29 15:30:28 +02:00
|
|
|
$total_pages_before = '<span class="screen-reader-text">' . __( 'Current Page' ) . '</span><span id="table-paging" class="paging-input"><span class="tablenav-paging-text">';
|
2014-05-13 07:27:14 +02:00
|
|
|
} else {
|
2017-12-01 00:11:00 +01:00
|
|
|
$html_current_page = sprintf(
|
|
|
|
"%s<input class='current-page' id='current-page-selector' type='text' name='paged' value='%s' size='%d' aria-describedby='table-paging' /><span class='tablenav-paging-text'>",
|
2015-06-05 07:01:25 +02:00
|
|
|
'<label for="current-page-selector" class="screen-reader-text">' . __( 'Current Page' ) . '</label>',
|
2011-01-16 22:47:24 +01:00
|
|
|
$current,
|
|
|
|
strlen( $total_pages )
|
|
|
|
);
|
2014-05-13 07:27:14 +02:00
|
|
|
}
|
2010-08-11 23:54:51 +02:00
|
|
|
$html_total_pages = sprintf( "<span class='total-pages'>%s</span>", number_format_i18n( $total_pages ) );
|
I18N: Improve translator comments.
* Add missing translator comments.
* Fix placement of some translator comments. Translator comments should be on the line directly above the line containing the translation function call for optimal compatibility with various `.pot` file generation tools. The CS auto-fixing, which changed some inconsistent function calls to multi-line function calls, is part of the reason why this was no longer the case for a select group of translator comments.
Includes minor code layout fixes.
Polyglots, rejoice! All WordPress core files now have translator comments for all strings with placeholders!
Props jrf, subrataemfluence, GaryJ, webdados, Dency, swissspidy, alvarogois, marcomartins, mihaiiceyro, vladwtz, niq1982, flipkeijzer, michielatyoast, chandrapatel, thrijith, joshuanoyce, FesoVik, tessak22, bhaktirajdev, cleancoded, dhavalkasvala, garrett-eclipse, bibliofille, socalchristina, priyankkpatel, 5hel2l2y, adamsilverstein, JeffPaul, pierlo, SergeyBiryukov.
Fixes #44360.
Built from https://develop.svn.wordpress.org/trunk@45926
git-svn-id: http://core.svn.wordpress.org/trunk@45737 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2019-09-01 19:13:59 +02:00
|
|
|
$page_links[] = $total_pages_before . sprintf(
|
2019-09-03 02:41:05 +02:00
|
|
|
/* translators: 1: Current page, 2: Total pages. */
|
I18N: Improve translator comments.
* Add missing translator comments.
* Fix placement of some translator comments. Translator comments should be on the line directly above the line containing the translation function call for optimal compatibility with various `.pot` file generation tools. The CS auto-fixing, which changed some inconsistent function calls to multi-line function calls, is part of the reason why this was no longer the case for a select group of translator comments.
Includes minor code layout fixes.
Polyglots, rejoice! All WordPress core files now have translator comments for all strings with placeholders!
Props jrf, subrataemfluence, GaryJ, webdados, Dency, swissspidy, alvarogois, marcomartins, mihaiiceyro, vladwtz, niq1982, flipkeijzer, michielatyoast, chandrapatel, thrijith, joshuanoyce, FesoVik, tessak22, bhaktirajdev, cleancoded, dhavalkasvala, garrett-eclipse, bibliofille, socalchristina, priyankkpatel, 5hel2l2y, adamsilverstein, JeffPaul, pierlo, SergeyBiryukov.
Fixes #44360.
Built from https://develop.svn.wordpress.org/trunk@45926
git-svn-id: http://core.svn.wordpress.org/trunk@45737 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2019-09-01 19:13:59 +02:00
|
|
|
_x( '%1$s of %2$s', 'paging' ),
|
|
|
|
$html_current_page,
|
|
|
|
$html_total_pages
|
|
|
|
) . $total_pages_after;
|
2010-08-11 23:54:51 +02:00
|
|
|
|
2015-06-25 22:32:26 +02:00
|
|
|
if ( $disable_next ) {
|
2018-04-29 18:25:21 +02:00
|
|
|
$page_links[] = '<span class="tablenav-pages-navspan button disabled" aria-hidden="true">›</span>';
|
2015-06-25 22:32:26 +02:00
|
|
|
} else {
|
2017-12-01 00:11:00 +01:00
|
|
|
$page_links[] = sprintf(
|
2018-04-29 18:25:21 +02:00
|
|
|
"<a class='next-page button' href='%s'><span class='screen-reader-text'>%s</span><span aria-hidden='true'>%s</span></a>",
|
2017-12-01 00:11:00 +01:00
|
|
|
esc_url( add_query_arg( 'paged', min( $total_pages, $current + 1 ), $current_url ) ),
|
2015-06-25 22:32:26 +02:00
|
|
|
__( 'Next page' ),
|
|
|
|
'›'
|
|
|
|
);
|
|
|
|
}
|
|
|
|
|
|
|
|
if ( $disable_last ) {
|
2018-04-29 18:25:21 +02:00
|
|
|
$page_links[] = '<span class="tablenav-pages-navspan button disabled" aria-hidden="true">»</span>';
|
2015-06-25 22:32:26 +02:00
|
|
|
} else {
|
2017-12-01 00:11:00 +01:00
|
|
|
$page_links[] = sprintf(
|
2018-04-29 18:25:21 +02:00
|
|
|
"<a class='last-page button' href='%s'><span class='screen-reader-text'>%s</span><span aria-hidden='true'>%s</span></a>",
|
2015-06-25 22:32:26 +02:00
|
|
|
esc_url( add_query_arg( 'paged', $total_pages, $current_url ) ),
|
|
|
|
__( 'Last page' ),
|
|
|
|
'»'
|
|
|
|
);
|
|
|
|
}
|
2010-08-11 23:54:51 +02:00
|
|
|
|
2012-03-02 23:09:26 +01:00
|
|
|
$pagination_links_class = 'pagination-links';
|
2014-05-13 07:27:14 +02:00
|
|
|
if ( ! empty( $infinite_scroll ) ) {
|
2017-07-09 13:12:43 +02:00
|
|
|
$pagination_links_class .= ' hide-if-js';
|
2014-05-13 07:27:14 +02:00
|
|
|
}
|
2012-03-02 23:09:26 +01:00
|
|
|
$output .= "\n<span class='$pagination_links_class'>" . join( "\n", $page_links ) . '</span>';
|
2010-08-11 23:54:51 +02:00
|
|
|
|
2014-05-13 07:27:14 +02:00
|
|
|
if ( $total_pages ) {
|
2011-05-04 21:45:41 +02:00
|
|
|
$page_class = $total_pages < 2 ? ' one-page' : '';
|
2014-05-13 07:27:14 +02:00
|
|
|
} else {
|
2011-05-04 21:45:41 +02:00
|
|
|
$page_class = ' no-pages';
|
2014-05-13 07:27:14 +02:00
|
|
|
}
|
2010-12-26 23:06:15 +01:00
|
|
|
$this->_pagination = "<div class='tablenav-pages{$page_class}'>$output</div>";
|
2010-08-11 23:54:51 +02:00
|
|
|
|
|
|
|
echo $this->_pagination;
|
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
2020-06-25 10:56:16 +02:00
|
|
|
* Gets a list of columns.
|
|
|
|
*
|
|
|
|
* The format is:
|
|
|
|
* - `'internal-name' => 'Title'`
|
2010-08-11 23:54:51 +02:00
|
|
|
*
|
|
|
|
* @since 3.1.0
|
2011-01-12 09:05:23 +01:00
|
|
|
* @abstract
|
2010-08-11 23:54:51 +02:00
|
|
|
*
|
|
|
|
* @return array
|
|
|
|
*/
|
2014-07-12 05:27:14 +02:00
|
|
|
public function get_columns() {
|
2019-11-17 08:43:01 +01:00
|
|
|
die( 'function WP_List_Table::get_columns() must be overridden in a subclass.' );
|
2010-08-11 23:54:51 +02:00
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
2020-06-25 10:56:16 +02:00
|
|
|
* Gets a list of sortable columns.
|
2010-11-26 03:03:02 +01:00
|
|
|
*
|
2020-06-24 01:15:10 +02:00
|
|
|
* The format is:
|
|
|
|
* - `'internal-name' => 'orderby'`
|
2020-06-25 10:56:16 +02:00
|
|
|
* - `'internal-name' => array( 'orderby', 'asc' )` - The second element sets the initial sorting order.
|
|
|
|
* - `'internal-name' => array( 'orderby', true )` - The second element makes the initial order descending.
|
2010-08-11 23:54:51 +02:00
|
|
|
*
|
|
|
|
* @since 3.1.0
|
|
|
|
*
|
|
|
|
* @return array
|
|
|
|
*/
|
Add access modifiers to methods and members of list table classes:
* `WP_List_Table` is the base class that implements `__get()` and `__call()` for BC
* Adds unit tests to confirm that subclasses properly inherit magic methods
* Add modifiers to subclasses: `WP_Links_List_Table`, `WP_Media_List_Table`, `WP_MS_Sites_List_Table`, `WP_MS_Themes_List_Table`, `WP_MS_Users_List_Table`, `WP_Plugin_Install_List_Table`, `WP_Plugins_List_Table`, `WP_Posts_List_Table`, `WP_Terms_List_Table`, `WP_Theme_Install_List_Table`, `WP_Themes_List_Table`
See #27881, #22234.
Built from https://develop.svn.wordpress.org/trunk@28493
git-svn-id: http://core.svn.wordpress.org/trunk@28319 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2014-05-19 03:17:15 +02:00
|
|
|
protected function get_sortable_columns() {
|
2010-08-11 23:54:51 +02:00
|
|
|
return array();
|
|
|
|
}
|
|
|
|
|
2015-05-29 04:41:25 +02:00
|
|
|
/**
|
2015-07-12 20:32:24 +02:00
|
|
|
* Gets the name of the default primary column.
|
2015-05-29 04:41:25 +02:00
|
|
|
*
|
|
|
|
* @since 4.3.0
|
|
|
|
*
|
2015-05-31 03:29:26 +02:00
|
|
|
* @return string Name of the default primary column, in this case, an empty string.
|
2015-05-29 04:41:25 +02:00
|
|
|
*/
|
|
|
|
protected function get_default_primary_column_name() {
|
2015-07-07 17:12:27 +02:00
|
|
|
$columns = $this->get_columns();
|
2017-12-01 00:11:00 +01:00
|
|
|
$column = '';
|
2015-07-07 17:12:27 +02:00
|
|
|
|
2015-11-19 00:01:26 +01:00
|
|
|
if ( empty( $columns ) ) {
|
|
|
|
return $column;
|
|
|
|
}
|
|
|
|
|
2015-07-07 17:12:27 +02:00
|
|
|
// We need a primary defined so responsive views show something,
|
|
|
|
// so let's fall back to the first non-checkbox column.
|
2015-08-25 22:28:22 +02:00
|
|
|
foreach ( $columns as $col => $column_name ) {
|
2015-07-07 17:12:27 +02:00
|
|
|
if ( 'cb' === $col ) {
|
|
|
|
continue;
|
|
|
|
}
|
|
|
|
|
|
|
|
$column = $col;
|
|
|
|
break;
|
|
|
|
}
|
|
|
|
|
|
|
|
return $column;
|
2015-05-29 04:41:25 +02:00
|
|
|
}
|
|
|
|
|
2015-09-15 05:35:25 +02:00
|
|
|
/**
|
2015-09-16 12:51:25 +02:00
|
|
|
* Public wrapper for WP_List_Table::get_default_primary_column_name().
|
2015-09-15 05:35:25 +02:00
|
|
|
*
|
|
|
|
* @since 4.4.0
|
|
|
|
*
|
|
|
|
* @return string Name of the default primary column.
|
|
|
|
*/
|
2015-09-14 22:29:26 +02:00
|
|
|
public function get_primary_column() {
|
|
|
|
return $this->get_primary_column_name();
|
|
|
|
}
|
|
|
|
|
2015-05-29 04:41:25 +02:00
|
|
|
/**
|
2015-07-12 20:32:24 +02:00
|
|
|
* Gets the name of the primary column.
|
2015-05-29 04:41:25 +02:00
|
|
|
*
|
|
|
|
* @since 4.3.0
|
|
|
|
*
|
2015-05-31 03:29:26 +02:00
|
|
|
* @return string The name of the primary column.
|
2015-05-29 04:41:25 +02:00
|
|
|
*/
|
2015-09-14 22:29:26 +02:00
|
|
|
protected function get_primary_column_name() {
|
2015-11-07 16:27:25 +01:00
|
|
|
$columns = get_column_headers( $this->screen );
|
2015-05-29 04:41:25 +02:00
|
|
|
$default = $this->get_default_primary_column_name();
|
2015-05-31 03:29:26 +02:00
|
|
|
|
2020-01-29 01:45:18 +01:00
|
|
|
// If the primary column doesn't exist,
|
|
|
|
// fall back to the first non-checkbox column.
|
2015-07-14 18:18:25 +02:00
|
|
|
if ( ! isset( $columns[ $default ] ) ) {
|
|
|
|
$default = WP_List_Table::get_default_primary_column_name();
|
|
|
|
}
|
|
|
|
|
2015-05-29 04:41:25 +02:00
|
|
|
/**
|
2016-05-22 20:01:30 +02:00
|
|
|
* Filters the name of the primary column for the current list table.
|
2015-05-29 04:41:25 +02:00
|
|
|
*
|
|
|
|
* @since 4.3.0
|
|
|
|
*
|
2015-05-31 03:29:26 +02:00
|
|
|
* @param string $default Column name default for the specific list table, e.g. 'name'.
|
|
|
|
* @param string $context Screen ID for specific list table, e.g. 'plugins'.
|
2015-05-29 04:41:25 +02:00
|
|
|
*/
|
2017-12-01 00:11:00 +01:00
|
|
|
$column = apply_filters( 'list_table_primary_column', $default, $this->screen->id );
|
2015-05-29 04:41:25 +02:00
|
|
|
|
|
|
|
if ( empty( $column ) || ! isset( $columns[ $column ] ) ) {
|
|
|
|
$column = $default;
|
|
|
|
}
|
|
|
|
|
|
|
|
return $column;
|
|
|
|
}
|
|
|
|
|
2010-08-11 23:54:51 +02:00
|
|
|
/**
|
2020-06-25 10:56:16 +02:00
|
|
|
* Gets a list of all, hidden and sortable columns, with filter applied.
|
2010-08-11 23:54:51 +02:00
|
|
|
*
|
|
|
|
* @since 3.1.0
|
|
|
|
*
|
|
|
|
* @return array
|
|
|
|
*/
|
Add access modifiers to methods and members of list table classes:
* `WP_List_Table` is the base class that implements `__get()` and `__call()` for BC
* Adds unit tests to confirm that subclasses properly inherit magic methods
* Add modifiers to subclasses: `WP_Links_List_Table`, `WP_Media_List_Table`, `WP_MS_Sites_List_Table`, `WP_MS_Themes_List_Table`, `WP_MS_Users_List_Table`, `WP_Plugin_Install_List_Table`, `WP_Plugins_List_Table`, `WP_Posts_List_Table`, `WP_Terms_List_Table`, `WP_Theme_Install_List_Table`, `WP_Themes_List_Table`
See #27881, #22234.
Built from https://develop.svn.wordpress.org/trunk@28493
git-svn-id: http://core.svn.wordpress.org/trunk@28319 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2014-05-19 03:17:15 +02:00
|
|
|
protected function get_column_info() {
|
2020-01-29 01:45:18 +01:00
|
|
|
// $_column_headers is already set / cached.
|
2015-06-10 16:59:30 +02:00
|
|
|
if ( isset( $this->_column_headers ) && is_array( $this->_column_headers ) ) {
|
|
|
|
// Back-compat for list tables that have been manually setting $_column_headers for horse reasons.
|
|
|
|
// In 4.3, we added a fourth argument for primary column.
|
2015-07-07 17:12:27 +02:00
|
|
|
$column_headers = array( array(), array(), array(), $this->get_primary_column_name() );
|
2015-06-10 16:59:30 +02:00
|
|
|
foreach ( $this->_column_headers as $key => $value ) {
|
|
|
|
$column_headers[ $key ] = $value;
|
|
|
|
}
|
|
|
|
|
|
|
|
return $column_headers;
|
2015-06-10 03:46:27 +02:00
|
|
|
}
|
2010-11-26 03:03:02 +01:00
|
|
|
|
2012-09-19 14:43:31 +02:00
|
|
|
$columns = get_column_headers( $this->screen );
|
2017-12-01 00:11:00 +01:00
|
|
|
$hidden = get_hidden_columns( $this->screen );
|
2010-08-11 23:54:51 +02:00
|
|
|
|
2013-11-26 09:12:09 +01:00
|
|
|
$sortable_columns = $this->get_sortable_columns();
|
|
|
|
/**
|
2016-05-22 20:01:30 +02:00
|
|
|
* Filters the list table sortable columns for a specific screen.
|
2013-11-26 09:12:09 +01:00
|
|
|
*
|
2014-11-30 12:28:24 +01:00
|
|
|
* The dynamic portion of the hook name, `$this->screen->id`, refers
|
2020-10-10 21:14:04 +02:00
|
|
|
* to the ID of the current screen.
|
2013-11-26 09:12:09 +01:00
|
|
|
*
|
2020-07-25 20:55:03 +02:00
|
|
|
* @since 3.1.0
|
2013-11-26 09:12:09 +01:00
|
|
|
*
|
|
|
|
* @param array $sortable_columns An array of sortable columns.
|
|
|
|
*/
|
|
|
|
$_sortable = apply_filters( "manage_{$this->screen->id}_sortable_columns", $sortable_columns );
|
2010-11-26 03:03:02 +01:00
|
|
|
|
|
|
|
$sortable = array();
|
|
|
|
foreach ( $_sortable as $id => $data ) {
|
2017-12-01 00:11:00 +01:00
|
|
|
if ( empty( $data ) ) {
|
2010-11-26 03:03:02 +01:00
|
|
|
continue;
|
2017-12-01 00:11:00 +01:00
|
|
|
}
|
2010-11-26 03:03:02 +01:00
|
|
|
|
|
|
|
$data = (array) $data;
|
2017-12-01 00:11:00 +01:00
|
|
|
if ( ! isset( $data[1] ) ) {
|
2010-11-26 03:03:02 +01:00
|
|
|
$data[1] = false;
|
2017-12-01 00:11:00 +01:00
|
|
|
}
|
2010-12-13 22:21:50 +01:00
|
|
|
|
2017-12-01 00:11:00 +01:00
|
|
|
$sortable[ $id ] = $data;
|
2010-08-11 23:54:51 +02:00
|
|
|
}
|
|
|
|
|
2017-12-01 00:11:00 +01:00
|
|
|
$primary = $this->get_primary_column_name();
|
2015-05-29 04:41:25 +02:00
|
|
|
$this->_column_headers = array( $columns, $hidden, $sortable, $primary );
|
2010-11-26 03:03:02 +01:00
|
|
|
|
2010-08-11 23:54:51 +02:00
|
|
|
return $this->_column_headers;
|
|
|
|
}
|
|
|
|
|
2010-11-14 19:00:09 +01:00
|
|
|
/**
|
2020-06-25 10:56:16 +02:00
|
|
|
* Returns the number of visible columns.
|
2010-11-14 19:00:09 +01:00
|
|
|
*
|
|
|
|
* @since 3.1.0
|
|
|
|
*
|
|
|
|
* @return int
|
|
|
|
*/
|
Add access modifiers to methods and members of list table classes:
* `WP_List_Table` is the base class that implements `__get()` and `__call()` for BC
* Adds unit tests to confirm that subclasses properly inherit magic methods
* Add modifiers to subclasses: `WP_Links_List_Table`, `WP_Media_List_Table`, `WP_MS_Sites_List_Table`, `WP_MS_Themes_List_Table`, `WP_MS_Users_List_Table`, `WP_Plugin_Install_List_Table`, `WP_Plugins_List_Table`, `WP_Posts_List_Table`, `WP_Terms_List_Table`, `WP_Theme_Install_List_Table`, `WP_Themes_List_Table`
See #27881, #22234.
Built from https://develop.svn.wordpress.org/trunk@28493
git-svn-id: http://core.svn.wordpress.org/trunk@28319 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2014-05-19 03:17:15 +02:00
|
|
|
public function get_column_count() {
|
2010-11-14 19:00:09 +01:00
|
|
|
list ( $columns, $hidden ) = $this->get_column_info();
|
2017-12-01 00:11:00 +01:00
|
|
|
$hidden = array_intersect( array_keys( $columns ), array_filter( $hidden ) );
|
2010-11-14 19:00:09 +01:00
|
|
|
return count( $columns ) - count( $hidden );
|
|
|
|
}
|
|
|
|
|
2010-08-11 23:54:51 +02:00
|
|
|
/**
|
2020-06-25 10:56:16 +02:00
|
|
|
* Prints column headers, accounting for hidden and sortable columns.
|
2010-08-11 23:54:51 +02:00
|
|
|
*
|
|
|
|
* @since 3.1.0
|
2010-08-21 20:08:42 +02:00
|
|
|
*
|
2020-06-20 14:02:12 +02:00
|
|
|
* @param bool $with_id Whether to set the ID attribute or not
|
2010-08-11 23:54:51 +02:00
|
|
|
*/
|
2014-07-14 00:09:16 +02:00
|
|
|
public function print_column_headers( $with_id = true ) {
|
List tables: A better responsive view.
Instead of truncating columns, the data that's already in the markup can now be toggled into view. Only seems appropriate to celebrate four years of contributing by finally doing the first thing I ever mocked up.
Known issues / concerns:
* Custom list tables that don't define a primary column will show nothing at all. These are not extremely common, as `WP_List_Table` isn't really recommended for plugin consumption, but it happens. We need to come up with some kind of fallback.
* Some visual elements, particularly whitespace, could use refining.
* Needs a11y review.
* Touch performance on iOS feels sluggish - is there anything we can do about that?
* Would this be better accordion-style (only one expanded at a time)?
* Is `wp_strip_all_tags()` good enough for column titles that have HTML in them? It's essentially a workaround for the fact that core's comments column does that for the icon, which maybe it shouldn't. Perhaps worth another ticket, as a markup change would be fairly independent.
* Visual hierarchy is not great when expanded (also worthy of another ticket).
* Quick edit now becomes noticeably more annoying to cancel out of, as you have to scroll all the way down and you lose your position from before it was opened. Again, worthy of another ticket.
props Michael Arestad, helen.
see #32395.
Built from https://develop.svn.wordpress.org/trunk@33016
git-svn-id: http://core.svn.wordpress.org/trunk@32987 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2015-07-01 03:31:25 +02:00
|
|
|
list( $columns, $hidden, $sortable, $primary ) = $this->get_column_info();
|
2010-08-11 23:54:51 +02:00
|
|
|
|
2012-08-30 15:33:00 +02:00
|
|
|
$current_url = set_url_scheme( 'http://' . $_SERVER['HTTP_HOST'] . $_SERVER['REQUEST_URI'] );
|
2011-01-16 22:47:24 +01:00
|
|
|
$current_url = remove_query_arg( 'paged', $current_url );
|
2010-08-11 23:54:51 +02:00
|
|
|
|
2015-12-07 20:16:26 +01:00
|
|
|
if ( isset( $_GET['orderby'] ) ) {
|
|
|
|
$current_orderby = $_GET['orderby'];
|
|
|
|
} else {
|
|
|
|
$current_orderby = '';
|
|
|
|
}
|
|
|
|
|
|
|
|
if ( isset( $_GET['order'] ) && 'desc' === $_GET['order'] ) {
|
|
|
|
$current_order = 'desc';
|
|
|
|
} else {
|
|
|
|
$current_order = 'asc';
|
|
|
|
}
|
2010-08-11 23:54:51 +02:00
|
|
|
|
2012-07-24 20:01:22 +02:00
|
|
|
if ( ! empty( $columns['cb'] ) ) {
|
|
|
|
static $cb_counter = 1;
|
2017-12-01 00:11:00 +01:00
|
|
|
$columns['cb'] = '<label class="screen-reader-text" for="cb-select-all-' . $cb_counter . '">' . __( 'Select All' ) . '</label>'
|
2012-07-25 18:18:14 +02:00
|
|
|
. '<input id="cb-select-all-' . $cb_counter . '" type="checkbox" />';
|
2012-07-24 20:01:22 +02:00
|
|
|
$cb_counter++;
|
|
|
|
}
|
|
|
|
|
2010-08-11 23:54:51 +02:00
|
|
|
foreach ( $columns as $column_key => $column_display_name ) {
|
|
|
|
$class = array( 'manage-column', "column-$column_key" );
|
|
|
|
|
2020-04-05 05:02:11 +02:00
|
|
|
if ( in_array( $column_key, $hidden, true ) ) {
|
2015-06-10 21:47:27 +02:00
|
|
|
$class[] = 'hidden';
|
|
|
|
}
|
2010-08-11 23:54:51 +02:00
|
|
|
|
2017-12-01 00:11:00 +01:00
|
|
|
if ( 'cb' === $column_key ) {
|
2010-08-11 23:54:51 +02:00
|
|
|
$class[] = 'check-column';
|
2020-04-05 05:02:11 +02:00
|
|
|
} elseif ( in_array( $column_key, array( 'posts', 'comments', 'links' ), true ) ) {
|
2010-08-11 23:54:51 +02:00
|
|
|
$class[] = 'num';
|
2017-12-01 00:11:00 +01:00
|
|
|
}
|
2010-08-11 23:54:51 +02:00
|
|
|
|
List tables: A better responsive view.
Instead of truncating columns, the data that's already in the markup can now be toggled into view. Only seems appropriate to celebrate four years of contributing by finally doing the first thing I ever mocked up.
Known issues / concerns:
* Custom list tables that don't define a primary column will show nothing at all. These are not extremely common, as `WP_List_Table` isn't really recommended for plugin consumption, but it happens. We need to come up with some kind of fallback.
* Some visual elements, particularly whitespace, could use refining.
* Needs a11y review.
* Touch performance on iOS feels sluggish - is there anything we can do about that?
* Would this be better accordion-style (only one expanded at a time)?
* Is `wp_strip_all_tags()` good enough for column titles that have HTML in them? It's essentially a workaround for the fact that core's comments column does that for the icon, which maybe it shouldn't. Perhaps worth another ticket, as a markup change would be fairly independent.
* Visual hierarchy is not great when expanded (also worthy of another ticket).
* Quick edit now becomes noticeably more annoying to cancel out of, as you have to scroll all the way down and you lose your position from before it was opened. Again, worthy of another ticket.
props Michael Arestad, helen.
see #32395.
Built from https://develop.svn.wordpress.org/trunk@33016
git-svn-id: http://core.svn.wordpress.org/trunk@32987 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2015-07-01 03:31:25 +02:00
|
|
|
if ( $column_key === $primary ) {
|
|
|
|
$class[] = 'column-primary';
|
|
|
|
}
|
|
|
|
|
2017-12-01 00:11:00 +01:00
|
|
|
if ( isset( $sortable[ $column_key ] ) ) {
|
|
|
|
list( $orderby, $desc_first ) = $sortable[ $column_key ];
|
2010-11-26 03:03:02 +01:00
|
|
|
|
2015-09-22 08:06:25 +02:00
|
|
|
if ( $current_orderby === $orderby ) {
|
2020-06-25 10:56:16 +02:00
|
|
|
$order = 'asc' === $current_order ? 'desc' : 'asc';
|
|
|
|
|
2010-11-26 03:03:02 +01:00
|
|
|
$class[] = 'sorted';
|
|
|
|
$class[] = $current_order;
|
2010-08-11 23:54:51 +02:00
|
|
|
} else {
|
2020-06-25 13:35:13 +02:00
|
|
|
$order = strtolower( $desc_first );
|
|
|
|
|
|
|
|
if ( ! in_array( $order, array( 'desc', 'asc' ), true ) ) {
|
2020-06-24 01:15:10 +02:00
|
|
|
$order = $desc_first ? 'desc' : 'asc';
|
|
|
|
}
|
2020-06-25 10:56:16 +02:00
|
|
|
|
2010-08-11 23:54:51 +02:00
|
|
|
$class[] = 'sortable';
|
2020-06-24 01:15:10 +02:00
|
|
|
$class[] = 'desc' === $order ? 'asc' : 'desc';
|
2010-08-11 23:54:51 +02:00
|
|
|
}
|
2010-11-26 03:03:02 +01:00
|
|
|
|
2020-06-25 13:35:13 +02:00
|
|
|
$column_display_name = sprintf(
|
|
|
|
'<a href="%s"><span>%s</span><span class="sorting-indicator"></span></a>',
|
|
|
|
esc_url( add_query_arg( compact( 'orderby', 'order' ), $current_url ) ),
|
|
|
|
$column_display_name
|
|
|
|
);
|
2010-08-11 23:54:51 +02:00
|
|
|
}
|
|
|
|
|
2017-12-01 00:11:00 +01:00
|
|
|
$tag = ( 'cb' === $column_key ) ? 'td' : 'th';
|
2015-06-28 07:46:25 +02:00
|
|
|
$scope = ( 'th' === $tag ) ? 'scope="col"' : '';
|
2017-12-01 00:11:00 +01:00
|
|
|
$id = $with_id ? "id='$column_key'" : '';
|
2010-08-11 23:54:51 +02:00
|
|
|
|
2017-12-01 00:11:00 +01:00
|
|
|
if ( ! empty( $class ) ) {
|
2010-08-11 23:54:51 +02:00
|
|
|
$class = "class='" . join( ' ', $class ) . "'";
|
2017-12-01 00:11:00 +01:00
|
|
|
}
|
2010-08-11 23:54:51 +02:00
|
|
|
|
2015-06-28 07:46:25 +02:00
|
|
|
echo "<$tag $scope $id $class>$column_display_name</$tag>";
|
2010-08-11 23:54:51 +02:00
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
2019-09-29 13:04:58 +02:00
|
|
|
* Displays the table.
|
2010-08-11 23:54:51 +02:00
|
|
|
*
|
|
|
|
* @since 3.1.0
|
|
|
|
*/
|
Add access modifiers to methods and members of list table classes:
* `WP_List_Table` is the base class that implements `__get()` and `__call()` for BC
* Adds unit tests to confirm that subclasses properly inherit magic methods
* Add modifiers to subclasses: `WP_Links_List_Table`, `WP_Media_List_Table`, `WP_MS_Sites_List_Table`, `WP_MS_Themes_List_Table`, `WP_MS_Users_List_Table`, `WP_Plugin_Install_List_Table`, `WP_Plugins_List_Table`, `WP_Posts_List_Table`, `WP_Terms_List_Table`, `WP_Theme_Install_List_Table`, `WP_Themes_List_Table`
See #27881, #22234.
Built from https://develop.svn.wordpress.org/trunk@28493
git-svn-id: http://core.svn.wordpress.org/trunk@28319 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2014-05-19 03:17:15 +02:00
|
|
|
public function display() {
|
2014-05-13 07:08:13 +02:00
|
|
|
$singular = $this->_args['singular'];
|
2010-08-11 23:54:51 +02:00
|
|
|
|
|
|
|
$this->display_tablenav( 'top' );
|
2015-10-07 03:28:25 +02:00
|
|
|
|
|
|
|
$this->screen->render_screen_reader_content( 'heading_list' );
|
2018-08-17 03:51:36 +02:00
|
|
|
?>
|
2014-01-26 21:28:12 +01:00
|
|
|
<table class="wp-list-table <?php echo implode( ' ', $this->get_table_classes() ); ?>">
|
2010-08-11 23:54:51 +02:00
|
|
|
<thead>
|
|
|
|
<tr>
|
|
|
|
<?php $this->print_column_headers(); ?>
|
|
|
|
</tr>
|
|
|
|
</thead>
|
|
|
|
|
2017-12-01 00:11:00 +01:00
|
|
|
<tbody id="the-list"
|
2018-08-17 03:51:36 +02:00
|
|
|
<?php
|
|
|
|
if ( $singular ) {
|
|
|
|
echo " data-wp-lists='list:$singular'";
|
|
|
|
}
|
2017-12-01 00:11:00 +01:00
|
|
|
?>
|
|
|
|
>
|
2010-12-16 20:05:14 +01:00
|
|
|
<?php $this->display_rows_or_placeholder(); ?>
|
2010-08-11 23:54:51 +02:00
|
|
|
</tbody>
|
2015-02-22 22:48:26 +01:00
|
|
|
|
|
|
|
<tfoot>
|
|
|
|
<tr>
|
|
|
|
<?php $this->print_column_headers( false ); ?>
|
|
|
|
</tr>
|
|
|
|
</tfoot>
|
|
|
|
|
2010-08-11 23:54:51 +02:00
|
|
|
</table>
|
2018-08-17 03:51:36 +02:00
|
|
|
<?php
|
2010-08-11 23:54:51 +02:00
|
|
|
$this->display_tablenav( 'bottom' );
|
|
|
|
}
|
|
|
|
|
2010-12-16 20:05:14 +01:00
|
|
|
/**
|
2020-06-25 10:56:16 +02:00
|
|
|
* Gets a list of CSS classes for the WP_List_Table table tag.
|
2010-12-16 20:05:14 +01:00
|
|
|
*
|
|
|
|
* @since 3.1.0
|
|
|
|
*
|
2019-11-05 22:30:03 +01:00
|
|
|
* @return string[] Array of CSS classes for the table tag.
|
2010-12-16 20:05:14 +01:00
|
|
|
*/
|
Add access modifiers to methods and members of list table classes:
* `WP_List_Table` is the base class that implements `__get()` and `__call()` for BC
* Adds unit tests to confirm that subclasses properly inherit magic methods
* Add modifiers to subclasses: `WP_Links_List_Table`, `WP_Media_List_Table`, `WP_MS_Sites_List_Table`, `WP_MS_Themes_List_Table`, `WP_MS_Users_List_Table`, `WP_Plugin_Install_List_Table`, `WP_Plugins_List_Table`, `WP_Posts_List_Table`, `WP_Terms_List_Table`, `WP_Theme_Install_List_Table`, `WP_Themes_List_Table`
See #27881, #22234.
Built from https://develop.svn.wordpress.org/trunk@28493
git-svn-id: http://core.svn.wordpress.org/trunk@28319 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2014-05-19 03:17:15 +02:00
|
|
|
protected function get_table_classes() {
|
2020-07-10 18:04:05 +02:00
|
|
|
$mode = get_user_setting( 'posts_list_mode', 'list' );
|
|
|
|
|
|
|
|
$mode_class = esc_attr( 'table-view-' . $mode );
|
2020-07-07 21:12:03 +02:00
|
|
|
|
|
|
|
return array( 'widefat', 'fixed', 'striped', $mode_class, $this->_args['plural'] );
|
2010-12-16 20:05:14 +01:00
|
|
|
}
|
|
|
|
|
2010-08-11 23:54:51 +02:00
|
|
|
/**
|
2020-06-25 10:56:16 +02:00
|
|
|
* Generates the table navigation above or below the table
|
2010-08-11 23:54:51 +02:00
|
|
|
*
|
|
|
|
* @since 3.1.0
|
2014-12-01 01:33:23 +01:00
|
|
|
* @param string $which
|
2010-08-11 23:54:51 +02:00
|
|
|
*/
|
Add access modifiers to methods and members of list table classes:
* `WP_List_Table` is the base class that implements `__get()` and `__call()` for BC
* Adds unit tests to confirm that subclasses properly inherit magic methods
* Add modifiers to subclasses: `WP_Links_List_Table`, `WP_Media_List_Table`, `WP_MS_Sites_List_Table`, `WP_MS_Themes_List_Table`, `WP_MS_Users_List_Table`, `WP_Plugin_Install_List_Table`, `WP_Plugins_List_Table`, `WP_Posts_List_Table`, `WP_Terms_List_Table`, `WP_Theme_Install_List_Table`, `WP_Themes_List_Table`
See #27881, #22234.
Built from https://develop.svn.wordpress.org/trunk@28493
git-svn-id: http://core.svn.wordpress.org/trunk@28319 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2014-05-19 03:17:15 +02:00
|
|
|
protected function display_tablenav( $which ) {
|
2015-09-22 08:06:25 +02:00
|
|
|
if ( 'top' === $which ) {
|
2010-08-11 23:54:51 +02:00
|
|
|
wp_nonce_field( 'bulk-' . $this->_args['plural'] );
|
2015-09-22 08:06:25 +02:00
|
|
|
}
|
2015-09-30 02:47:27 +02:00
|
|
|
?>
|
2010-11-28 20:05:12 +01:00
|
|
|
<div class="tablenav <?php echo esc_attr( $which ); ?>">
|
2010-08-11 23:54:51 +02:00
|
|
|
|
2017-12-01 00:11:00 +01:00
|
|
|
<?php if ( $this->has_items() ) : ?>
|
2013-09-19 23:01:09 +02:00
|
|
|
<div class="alignleft actions bulkactions">
|
2014-07-25 02:20:16 +02:00
|
|
|
<?php $this->bulk_actions( $which ); ?>
|
2010-08-11 23:54:51 +02:00
|
|
|
</div>
|
2018-08-17 03:51:36 +02:00
|
|
|
<?php
|
2017-12-01 00:11:00 +01:00
|
|
|
endif;
|
2010-08-11 23:54:51 +02:00
|
|
|
$this->extra_tablenav( $which );
|
|
|
|
$this->pagination( $which );
|
2019-01-12 07:41:52 +01:00
|
|
|
?>
|
2010-08-11 23:54:51 +02:00
|
|
|
|
2010-10-31 06:13:46 +01:00
|
|
|
<br class="clear" />
|
2010-08-11 23:54:51 +02:00
|
|
|
</div>
|
2018-08-17 03:51:36 +02:00
|
|
|
<?php
|
2010-08-11 23:54:51 +02:00
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
2020-06-25 10:56:16 +02:00
|
|
|
* Extra controls to be displayed between bulk actions and pagination.
|
2010-08-11 23:54:51 +02:00
|
|
|
*
|
|
|
|
* @since 3.1.0
|
2014-12-01 01:33:23 +01:00
|
|
|
*
|
|
|
|
* @param string $which
|
2010-08-11 23:54:51 +02:00
|
|
|
*/
|
Add access modifiers to methods and members of list table classes:
* `WP_List_Table` is the base class that implements `__get()` and `__call()` for BC
* Adds unit tests to confirm that subclasses properly inherit magic methods
* Add modifiers to subclasses: `WP_Links_List_Table`, `WP_Media_List_Table`, `WP_MS_Sites_List_Table`, `WP_MS_Themes_List_Table`, `WP_MS_Users_List_Table`, `WP_Plugin_Install_List_Table`, `WP_Plugins_List_Table`, `WP_Posts_List_Table`, `WP_Terms_List_Table`, `WP_Theme_Install_List_Table`, `WP_Themes_List_Table`
See #27881, #22234.
Built from https://develop.svn.wordpress.org/trunk@28493
git-svn-id: http://core.svn.wordpress.org/trunk@28319 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2014-05-19 03:17:15 +02:00
|
|
|
protected function extra_tablenav( $which ) {}
|
2010-08-11 23:54:51 +02:00
|
|
|
|
|
|
|
/**
|
2020-06-25 10:56:16 +02:00
|
|
|
* Generates the tbody element for the list table.
|
2010-08-11 23:54:51 +02:00
|
|
|
*
|
|
|
|
* @since 3.1.0
|
|
|
|
*/
|
2014-07-14 00:09:16 +02:00
|
|
|
public function display_rows_or_placeholder() {
|
2010-12-16 20:05:14 +01:00
|
|
|
if ( $this->has_items() ) {
|
|
|
|
$this->display_rows();
|
|
|
|
} else {
|
2011-01-21 08:39:21 +01:00
|
|
|
echo '<tr class="no-items"><td class="colspanchange" colspan="' . $this->get_column_count() . '">';
|
2010-12-16 20:05:14 +01:00
|
|
|
$this->no_items();
|
|
|
|
echo '</td></tr>';
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
2020-06-25 10:56:16 +02:00
|
|
|
* Generates the table rows.
|
2010-12-16 20:05:14 +01:00
|
|
|
*
|
|
|
|
* @since 3.1.0
|
|
|
|
*/
|
2014-07-14 00:09:16 +02:00
|
|
|
public function display_rows() {
|
2017-12-01 00:11:00 +01:00
|
|
|
foreach ( $this->items as $item ) {
|
2010-09-16 22:07:39 +02:00
|
|
|
$this->single_row( $item );
|
2017-12-01 00:11:00 +01:00
|
|
|
}
|
2010-09-16 22:07:39 +02:00
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
2020-06-25 10:56:16 +02:00
|
|
|
* Generates content for a single row of the table.
|
2010-09-16 22:07:39 +02:00
|
|
|
*
|
|
|
|
* @since 3.1.0
|
|
|
|
*
|
2010-11-18 20:12:48 +01:00
|
|
|
* @param object $item The current item
|
2010-09-16 22:07:39 +02:00
|
|
|
*/
|
2014-07-14 00:09:16 +02:00
|
|
|
public function single_row( $item ) {
|
2015-01-14 23:14:22 +01:00
|
|
|
echo '<tr>';
|
2013-04-29 03:10:50 +02:00
|
|
|
$this->single_row_columns( $item );
|
2010-09-18 19:21:32 +02:00
|
|
|
echo '</tr>';
|
|
|
|
}
|
2010-09-16 22:07:39 +02:00
|
|
|
|
2015-05-29 22:17:26 +02:00
|
|
|
/**
|
|
|
|
* @param object $item
|
|
|
|
* @param string $column_name
|
|
|
|
*/
|
2015-01-16 19:37:24 +01:00
|
|
|
protected function column_default( $item, $column_name ) {}
|
|
|
|
|
2015-05-29 22:17:26 +02:00
|
|
|
/**
|
|
|
|
* @param object $item
|
|
|
|
*/
|
2015-01-16 19:37:24 +01:00
|
|
|
protected function column_cb( $item ) {}
|
2015-01-16 18:42:22 +01:00
|
|
|
|
2010-09-18 19:21:32 +02:00
|
|
|
/**
|
2020-06-25 10:56:16 +02:00
|
|
|
* Generates the columns for a single row of the table.
|
2010-09-18 19:21:32 +02:00
|
|
|
*
|
|
|
|
* @since 3.1.0
|
|
|
|
*
|
2020-06-25 10:56:16 +02:00
|
|
|
* @param object $item The current item.
|
2010-09-18 19:21:32 +02:00
|
|
|
*/
|
Add access modifiers to methods and members of list table classes:
* `WP_List_Table` is the base class that implements `__get()` and `__call()` for BC
* Adds unit tests to confirm that subclasses properly inherit magic methods
* Add modifiers to subclasses: `WP_Links_List_Table`, `WP_Media_List_Table`, `WP_MS_Sites_List_Table`, `WP_MS_Themes_List_Table`, `WP_MS_Users_List_Table`, `WP_Plugin_Install_List_Table`, `WP_Plugins_List_Table`, `WP_Posts_List_Table`, `WP_Terms_List_Table`, `WP_Theme_Install_List_Table`, `WP_Themes_List_Table`
See #27881, #22234.
Built from https://develop.svn.wordpress.org/trunk@28493
git-svn-id: http://core.svn.wordpress.org/trunk@28319 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2014-05-19 03:17:15 +02:00
|
|
|
protected function single_row_columns( $item ) {
|
2015-05-29 04:41:25 +02:00
|
|
|
list( $columns, $hidden, $sortable, $primary ) = $this->get_column_info();
|
2010-09-16 22:07:39 +02:00
|
|
|
|
|
|
|
foreach ( $columns as $column_name => $column_display_name ) {
|
2015-05-29 04:41:25 +02:00
|
|
|
$classes = "$column_name column-$column_name";
|
|
|
|
if ( $primary === $column_name ) {
|
|
|
|
$classes .= ' has-row-actions column-primary';
|
|
|
|
}
|
2010-09-16 22:07:39 +02:00
|
|
|
|
2020-04-05 05:02:11 +02:00
|
|
|
if ( in_array( $column_name, $hidden, true ) ) {
|
2015-06-10 21:47:27 +02:00
|
|
|
$classes .= ' hidden';
|
2015-05-29 04:41:25 +02:00
|
|
|
}
|
2010-09-16 22:07:39 +02:00
|
|
|
|
List tables: A better responsive view.
Instead of truncating columns, the data that's already in the markup can now be toggled into view. Only seems appropriate to celebrate four years of contributing by finally doing the first thing I ever mocked up.
Known issues / concerns:
* Custom list tables that don't define a primary column will show nothing at all. These are not extremely common, as `WP_List_Table` isn't really recommended for plugin consumption, but it happens. We need to come up with some kind of fallback.
* Some visual elements, particularly whitespace, could use refining.
* Needs a11y review.
* Touch performance on iOS feels sluggish - is there anything we can do about that?
* Would this be better accordion-style (only one expanded at a time)?
* Is `wp_strip_all_tags()` good enough for column titles that have HTML in them? It's essentially a workaround for the fact that core's comments column does that for the icon, which maybe it shouldn't. Perhaps worth another ticket, as a markup change would be fairly independent.
* Visual hierarchy is not great when expanded (also worthy of another ticket).
* Quick edit now becomes noticeably more annoying to cancel out of, as you have to scroll all the way down and you lose your position from before it was opened. Again, worthy of another ticket.
props Michael Arestad, helen.
see #32395.
Built from https://develop.svn.wordpress.org/trunk@33016
git-svn-id: http://core.svn.wordpress.org/trunk@32987 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2015-07-01 03:31:25 +02:00
|
|
|
// Comments column uses HTML in the display name with screen reader text.
|
|
|
|
// Instead of using esc_attr(), we strip tags to get closer to a user-friendly string.
|
|
|
|
$data = 'data-colname="' . wp_strip_all_tags( $column_display_name ) . '"';
|
|
|
|
|
|
|
|
$attributes = "class='$classes' $data";
|
2010-09-16 22:07:39 +02:00
|
|
|
|
2015-09-22 08:06:25 +02:00
|
|
|
if ( 'cb' === $column_name ) {
|
2010-09-16 22:07:39 +02:00
|
|
|
echo '<th scope="row" class="check-column">';
|
|
|
|
echo $this->column_cb( $item );
|
|
|
|
echo '</th>';
|
2015-07-14 19:47:24 +02:00
|
|
|
} elseif ( method_exists( $this, '_column_' . $column_name ) ) {
|
|
|
|
echo call_user_func(
|
|
|
|
array( $this, '_column_' . $column_name ),
|
|
|
|
$item,
|
|
|
|
$classes,
|
|
|
|
$data,
|
|
|
|
$primary
|
|
|
|
);
|
|
|
|
} elseif ( method_exists( $this, 'column_' . $column_name ) ) {
|
2010-09-16 22:07:39 +02:00
|
|
|
echo "<td $attributes>";
|
2013-09-05 18:34:09 +02:00
|
|
|
echo call_user_func( array( $this, 'column_' . $column_name ), $item );
|
2015-05-29 04:41:25 +02:00
|
|
|
echo $this->handle_row_actions( $item, $column_name, $primary );
|
2017-12-01 00:11:00 +01:00
|
|
|
echo '</td>';
|
2015-07-14 19:47:24 +02:00
|
|
|
} else {
|
2010-09-16 22:07:39 +02:00
|
|
|
echo "<td $attributes>";
|
|
|
|
echo $this->column_default( $item, $column_name );
|
2015-05-29 04:41:25 +02:00
|
|
|
echo $this->handle_row_actions( $item, $column_name, $primary );
|
2017-12-01 00:11:00 +01:00
|
|
|
echo '</td>';
|
2010-09-16 22:07:39 +02:00
|
|
|
}
|
|
|
|
}
|
2010-08-11 23:54:51 +02:00
|
|
|
}
|
|
|
|
|
2015-05-29 04:41:25 +02:00
|
|
|
/**
|
2015-07-12 20:32:24 +02:00
|
|
|
* Generates and display row actions links for the list table.
|
2015-05-29 04:41:25 +02:00
|
|
|
*
|
|
|
|
* @since 4.3.0
|
|
|
|
*
|
2015-05-31 03:29:26 +02:00
|
|
|
* @param object $item The item being acted upon.
|
|
|
|
* @param string $column_name Current column name.
|
|
|
|
* @param string $primary Primary column name.
|
2020-01-11 18:57:03 +01:00
|
|
|
* @return string The row actions HTML, or an empty string
|
|
|
|
* if the current column is not the primary column.
|
2015-05-29 04:41:25 +02:00
|
|
|
*/
|
|
|
|
protected function handle_row_actions( $item, $column_name, $primary ) {
|
2015-09-22 08:06:25 +02:00
|
|
|
return $column_name === $primary ? '<button type="button" class="toggle-row"><span class="screen-reader-text">' . __( 'Show more details' ) . '</span></button>' : '';
|
2017-12-01 00:11:00 +01:00
|
|
|
}
|
2015-05-29 04:41:25 +02:00
|
|
|
|
2010-08-11 23:54:51 +02:00
|
|
|
/**
|
2020-06-25 10:56:16 +02:00
|
|
|
* Handles an incoming ajax request (called from admin-ajax.php)
|
2010-08-11 23:54:51 +02:00
|
|
|
*
|
2010-08-25 02:51:44 +02:00
|
|
|
* @since 3.1.0
|
2010-08-11 23:54:51 +02:00
|
|
|
*/
|
Add access modifiers to methods and members of list table classes:
* `WP_List_Table` is the base class that implements `__get()` and `__call()` for BC
* Adds unit tests to confirm that subclasses properly inherit magic methods
* Add modifiers to subclasses: `WP_Links_List_Table`, `WP_Media_List_Table`, `WP_MS_Sites_List_Table`, `WP_MS_Themes_List_Table`, `WP_MS_Users_List_Table`, `WP_Plugin_Install_List_Table`, `WP_Plugins_List_Table`, `WP_Posts_List_Table`, `WP_Terms_List_Table`, `WP_Theme_Install_List_Table`, `WP_Themes_List_Table`
See #27881, #22234.
Built from https://develop.svn.wordpress.org/trunk@28493
git-svn-id: http://core.svn.wordpress.org/trunk@28319 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2014-05-19 03:17:15 +02:00
|
|
|
public function ajax_response() {
|
2010-08-13 01:21:05 +02:00
|
|
|
$this->prepare_items();
|
|
|
|
|
2010-08-11 23:54:51 +02:00
|
|
|
ob_start();
|
2014-05-13 07:14:14 +02:00
|
|
|
if ( ! empty( $_REQUEST['no_placeholder'] ) ) {
|
2010-12-20 16:26:44 +01:00
|
|
|
$this->display_rows();
|
2014-05-13 07:14:14 +02:00
|
|
|
} else {
|
2010-12-20 16:26:44 +01:00
|
|
|
$this->display_rows_or_placeholder();
|
2014-05-13 07:14:14 +02:00
|
|
|
}
|
2010-12-20 16:26:44 +01:00
|
|
|
|
2010-08-11 23:54:51 +02:00
|
|
|
$rows = ob_get_clean();
|
|
|
|
|
2010-10-21 17:30:35 +02:00
|
|
|
$response = array( 'rows' => $rows );
|
|
|
|
|
2014-05-13 07:14:14 +02:00
|
|
|
if ( isset( $this->_pagination_args['total_items'] ) ) {
|
|
|
|
$response['total_items_i18n'] = sprintf(
|
2019-09-03 02:41:05 +02:00
|
|
|
/* translators: Number of items. */
|
2015-05-09 21:22:24 +02:00
|
|
|
_n( '%s item', '%s items', $this->_pagination_args['total_items'] ),
|
2014-05-13 07:14:14 +02:00
|
|
|
number_format_i18n( $this->_pagination_args['total_items'] )
|
|
|
|
);
|
|
|
|
}
|
|
|
|
if ( isset( $this->_pagination_args['total_pages'] ) ) {
|
2017-12-01 00:11:00 +01:00
|
|
|
$response['total_pages'] = $this->_pagination_args['total_pages'];
|
2014-05-13 07:14:14 +02:00
|
|
|
$response['total_pages_i18n'] = number_format_i18n( $this->_pagination_args['total_pages'] );
|
2010-11-17 18:03:27 +01:00
|
|
|
}
|
2010-10-21 17:30:35 +02:00
|
|
|
|
2014-10-28 19:35:19 +01:00
|
|
|
die( wp_json_encode( $response ) );
|
2010-08-11 23:54:51 +02:00
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
2020-06-25 10:56:16 +02:00
|
|
|
* Sends required variables to JavaScript land.
|
|
|
|
*
|
|
|
|
* @since 3.1.0
|
2010-08-11 23:54:51 +02:00
|
|
|
*/
|
2014-07-14 00:09:16 +02:00
|
|
|
public function _js_vars() {
|
2010-11-04 16:00:55 +01:00
|
|
|
$args = array(
|
2011-10-01 02:24:44 +02:00
|
|
|
'class' => get_class( $this ),
|
|
|
|
'screen' => array(
|
2012-09-19 14:43:31 +02:00
|
|
|
'id' => $this->screen->id,
|
|
|
|
'base' => $this->screen->base,
|
2017-12-01 00:11:00 +01:00
|
|
|
),
|
2010-08-11 23:54:51 +02:00
|
|
|
);
|
2010-11-04 16:00:55 +01:00
|
|
|
|
2014-10-28 19:35:19 +01:00
|
|
|
printf( "<script type='text/javascript'>list_args = %s;</script>\n", wp_json_encode( $args ) );
|
2010-08-11 23:54:51 +02:00
|
|
|
}
|
|
|
|
}
|