2010-11-01 04:56:27 -04:00
|
|
|
<?php
|
|
|
|
/**
|
|
|
|
* Helper functions for displaying a list of items in an ajaxified HTML table.
|
|
|
|
*
|
|
|
|
* @package WordPress
|
|
|
|
* @subpackage List_Table
|
|
|
|
* @since 3.1.0
|
|
|
|
*/
|
|
|
|
|
|
|
|
/**
|
2018-05-07 13:20:22 -04:00
|
|
|
* Fetches an instance of a WP_List_Table class.
|
2010-11-01 04:56:27 -04:00
|
|
|
*
|
2011-01-16 16:47:24 -05:00
|
|
|
* @access private
|
2010-11-01 04:56:27 -04:00
|
|
|
* @since 3.1.0
|
|
|
|
*
|
2015-05-28 17:41:30 -04:00
|
|
|
* @global string $hook_suffix
|
|
|
|
*
|
2011-01-16 16:47:24 -05:00
|
|
|
* @param string $class The type of the list table, which is the class name.
|
2018-05-07 13:20:22 -04:00
|
|
|
* @param array $args Optional. Arguments to pass to the class. Accepts 'screen'.
|
|
|
|
* @return WP_List_Table|bool List table object on success, false if the class does not exist.
|
2010-11-01 04:56:27 -04:00
|
|
|
*/
|
2012-09-19 08:43:31 -04:00
|
|
|
function _get_list_table( $class, $args = array() ) {
|
2010-11-01 04:56:27 -04:00
|
|
|
$core_classes = array(
|
2020-01-17 19:54:04 -05:00
|
|
|
// Site Admin.
|
2019-05-26 22:40:53 -04:00
|
|
|
'WP_Posts_List_Table' => 'posts',
|
|
|
|
'WP_Media_List_Table' => 'media',
|
|
|
|
'WP_Terms_List_Table' => 'terms',
|
|
|
|
'WP_Users_List_Table' => 'users',
|
|
|
|
'WP_Comments_List_Table' => 'comments',
|
|
|
|
'WP_Post_Comments_List_Table' => array( 'comments', 'post-comments' ),
|
|
|
|
'WP_Links_List_Table' => 'links',
|
|
|
|
'WP_Plugin_Install_List_Table' => 'plugin-install',
|
|
|
|
'WP_Themes_List_Table' => 'themes',
|
|
|
|
'WP_Theme_Install_List_Table' => array( 'themes', 'theme-install' ),
|
|
|
|
'WP_Plugins_List_Table' => 'plugins',
|
2019-05-26 16:50:53 -04:00
|
|
|
|
2020-01-17 19:54:04 -05:00
|
|
|
// Network Admin.
|
2019-05-26 22:40:53 -04:00
|
|
|
'WP_MS_Sites_List_Table' => 'ms-sites',
|
|
|
|
'WP_MS_Users_List_Table' => 'ms-users',
|
|
|
|
'WP_MS_Themes_List_Table' => 'ms-themes',
|
2019-05-26 16:50:53 -04:00
|
|
|
|
2020-01-17 19:54:04 -05:00
|
|
|
// Privacy requests tables.
|
2019-05-26 16:50:53 -04:00
|
|
|
'WP_Privacy_Data_Export_Requests_List_Table' => 'privacy-data-export-requests',
|
|
|
|
'WP_Privacy_Data_Removal_Requests_List_Table' => 'privacy-data-removal-requests',
|
2010-11-01 04:56:27 -04:00
|
|
|
);
|
|
|
|
|
|
|
|
if ( isset( $core_classes[ $class ] ) ) {
|
2017-11-30 18:11:00 -05:00
|
|
|
foreach ( (array) $core_classes[ $class ] as $required ) {
|
2016-08-31 12:31:29 -04:00
|
|
|
require_once( ABSPATH . 'wp-admin/includes/class-wp-' . $required . '-list-table.php' );
|
2017-11-30 18:11:00 -05:00
|
|
|
}
|
2016-08-31 12:31:29 -04:00
|
|
|
|
2017-11-30 18:11:00 -05:00
|
|
|
if ( isset( $args['screen'] ) ) {
|
2012-09-19 08:43:31 -04:00
|
|
|
$args['screen'] = convert_to_screen( $args['screen'] );
|
2017-11-30 18:11:00 -05:00
|
|
|
} elseif ( isset( $GLOBALS['hook_suffix'] ) ) {
|
2012-09-19 08:43:31 -04:00
|
|
|
$args['screen'] = get_current_screen();
|
2017-11-30 18:11:00 -05:00
|
|
|
} else {
|
2012-11-25 22:39:29 -05:00
|
|
|
$args['screen'] = null;
|
2017-11-30 18:11:00 -05:00
|
|
|
}
|
2012-09-19 08:43:31 -04:00
|
|
|
|
|
|
|
return new $class( $args );
|
2010-11-01 04:56:27 -04:00
|
|
|
}
|
2010-11-01 05:19:50 -04:00
|
|
|
|
2010-11-01 04:56:27 -04:00
|
|
|
return false;
|
|
|
|
}
|
|
|
|
|
2011-01-13 18:19:51 -05:00
|
|
|
/**
|
|
|
|
* Register column headers for a particular screen.
|
|
|
|
*
|
2019-10-26 17:09:04 -04:00
|
|
|
* @see get_column_headers(), print_column_headers(), get_hidden_columns()
|
|
|
|
*
|
2011-01-13 18:19:51 -05:00
|
|
|
* @since 2.7.0
|
|
|
|
*
|
2019-10-26 17:09:04 -04:00
|
|
|
* @param string $screen The handle for the screen to add help to. This is usually the hook name returned by the
|
|
|
|
* add_*_page() functions.
|
|
|
|
* @param string[] $columns An array of columns with column IDs as the keys and translated column names as the values.
|
2011-01-13 18:19:51 -05:00
|
|
|
*/
|
2017-11-30 18:11:00 -05:00
|
|
|
function register_column_headers( $screen, $columns ) {
|
2016-08-30 16:07:29 -04:00
|
|
|
new _WP_List_Table_Compat( $screen, $columns );
|
2011-01-13 18:19:51 -05:00
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Prints column headers for a particular screen.
|
|
|
|
*
|
|
|
|
* @since 2.7.0
|
2016-01-08 20:45:26 -05:00
|
|
|
*
|
|
|
|
* @param string|WP_Screen $screen The screen hook name or screen object.
|
|
|
|
* @param bool $with_id Whether to set the id attribute or not.
|
2011-01-13 18:19:51 -05:00
|
|
|
*/
|
2016-01-08 20:45:26 -05:00
|
|
|
function print_column_headers( $screen, $with_id = true ) {
|
2017-11-30 18:11:00 -05:00
|
|
|
$wp_list_table = new _WP_List_Table_Compat( $screen );
|
2011-01-13 18:19:51 -05:00
|
|
|
|
2016-01-08 20:45:26 -05:00
|
|
|
$wp_list_table->print_column_headers( $with_id );
|
2011-01-13 18:19:51 -05:00
|
|
|
}
|