File: /home/undanet/www/wp-content/plugins/mu-plugins/src/Admin/ListTable.php
<?php
namespace WordPress\ORM\Admin;
/**
* Base class for displaying a list of items in an HTML table. Intended to mimic
* the internal class WP_List_Table which was not designed for non-core code to
* use. The purpose of this class is to allow users to make custom list table
* classes without a bunch of extra work.
*
* @author Brandon Wamboldt <brandon.wamboldt@gmail.com>
*/
abstract class ListTable
{
/**
* @var array
*/
protected $items;
/**
* @var array
*/
protected $args;
/**
* @var array
*/
protected $pagination_args = array();
/**
* @var object
*/
protected $screen;
/**
* @var array
*/
protected $actions;
/**
* @var string
*/
protected $pagination;
/**
* Constructor. The child class should call this constructor from its own constructor
*
* @param array $args
*/
public function __construct(array $args = array())
{
$args = wp_parse_args($args, array(
'plural' => '',
'singular' => '',
'ajax' => false,
'screen' => null,
));
$this->screen = convert_to_screen($args['screen']);
add_filter("manage_{$this->screen->id}_columns", array(&$this, 'get_columns'), 0);
if (!$args['plural']) {
$args['plural'] = $this->screen->base;
}
$args['plural'] = sanitize_key($args['plural']);
$args['singular'] = sanitize_key($args['singular']);
$this->args = $args;
if ($args['ajax']) {
// wp_enqueue_script( 'list-table' );
add_action('admin_footer', array(&$this, 'js_vars'));
}
}
/**
* Checks the current user's permissions.
*
* @abstract
*/
abstract public function ajax_user_can();
/**
* Prepares the list of items for displaying.
*
* @abstract
*/
abstract public function prepare_items();
/**
* An internal method that sets all the necessary pagination arguments.
*
* @param array $args
*/
protected function set_pagination_args(array $args)
{
$args = wp_parse_args($args, array(
'total_items' => 0,
'total_pages' => 0,
'per_page' => 0
));
if (!$args['total_pages'] && $args['per_page'] > 0) {
$args['total_pages'] = ceil($args['total_items'] / $args['per_page']);
}
// Redirect if page number is invalid and headers are not already sent
if (!headers_sent() && (!defined('DOING_AJAX') || !DOING_AJAX) && $args['total_pages'] > 0 && $this->get_pagenum() > $args['total_pages']) {
wp_redirect(add_query_arg('paged', $args['total_pages']));
exit;
}
$this->pagination_args = $args;
}
/**
* Access the pagination args.
*
* @param string $key
* @return array
*/
public function get_pagination_arg($key)
{
if ('page' == $key) {
return $this->get_pagenum();
}
if (isset($this->pagination_args[$key])) {
return $this->pagination_args[$key];
}
}
/**
* Whether the table has items to display or not.
*
* @return bool
*/
public function has_items()
{
return !empty($this->items);
}
/**
* Message to be displayed when there are no items.
*/
public function no_items()
{
_e('No items found.');
}
/**
* Cause the real one doesn't work.
*/
public function get_search_query($escaped = true)
{
$s = isset($_REQUEST['s']) ? $_REQUEST['s'] : '';
$query = apply_filters('get_search_query', $s);
if ($escaped) {
$query = esc_attr($query);
}
return $query;
}
/**
* Display the search box.
*
* @param string $text
* @param string $input_id
*/
public function search_box($text, $input_id)
{
if (empty($_REQUEST['s']) && !$this->has_items()) {
return;
}
$input_id = $input_id . '-search-input';
if (!empty($_REQUEST['orderby'])) {
echo '<input type="hidden" name="orderby" value="' . esc_attr($_REQUEST['orderby']) . '">';
}
if (!empty($_REQUEST['order'])) {
echo '<input type="hidden" name="order" value="' . esc_attr($_REQUEST['order']) . '">';
}
if (!empty($_REQUEST['post_mime_type'])) {
echo '<input type="hidden" name="post_mime_type" value="' . esc_attr($_REQUEST['post_mime_type']) . '">';
}
if (!empty($_REQUEST['detached'])) {
echo '<input type="hidden" name="detached" value="' . esc_attr($_REQUEST['detached']) . '">';
}
?>
<p class="search-box">
<label class="screen-reader-text" for="<?php echo $input_id ?>"><?php echo $text ?>:</label>
<input type="search" id="<?php echo $input_id ?>" name="s" value="<?php _admin_search_query() ?>" />
<?php submit_button($text, 'button', false, false, array('id' => 'search-submit')) ?>
</p>
<?php
}
/**
* Get an associative array ( id => link ) with the list of views available
* on this table.
*
* @return array
*/
protected function get_views()
{
return array();
}
/**
* Display the list of views available on this table.
*/
public function views()
{
$views = $this->get_views();
$views = apply_filters('views_' . $this->screen->id, $views);
if (empty($views)) {
return;
}
echo "<ul class='subsubsub'>\n";
foreach ( $views as $class => $view ) {
$views[ $class ] = "\t<li class='$class'>$view";
}
echo implode( " |</li>\n", $views ) . "</li>\n";
echo "</ul>";
}
/**
* Get an associative array ( option_name => option_title ) with the list
* of bulk actions available on this table.
*
* @return array
*/
protected function get_bulk_actions()
{
return array();
}
/**
* Display the bulk actions dropdown.
*/
public function bulk_actions()
{
if (is_null($this->actions)) {
$this->actions = $this->get_bulk_actions();
$this->actions = apply_filters('bulk_actions-' . $this->screen->id, $this->actions);
$two = '';
} else {
$two = '2';
}
if (empty($this->actions)) {
return;
}
echo "<select name='action$two'>\n";
echo "<option value='-1' selected='selected'>" . __('Bulk Actions') . "</option>\n";
foreach ($this->actions as $name => $title) {
$class = 'edit' == $name ? ' class="hide-if-no-js"' : '';
echo "\t<option value='$name'$class>$title</option>\n";
}
echo "</select>\n";
submit_button(__('Apply'), 'action', false, false, array('id' => "doaction$two"));
echo "\n";
}
/**
* Get the current action selected from the bulk actions dropdown.
*
* @return string|bool
*/
public function current_action()
{
if (isset($_REQUEST['action']) && -1 != $_REQUEST['action']) {
return $_REQUEST['action'];
}
if (isset($_REQUEST['action2']) && -1 != $_REQUEST['action2']) {
return $_REQUEST['action2'];
}
return false;
}
/**
* Generate row actions div
*
* @param array $actions
* @param bool $always_visible
* @return string
*/
protected function row_actions($actions, $always_visible = false)
{
$action_count = count($actions);
$i = 0;
if (!$action_count) {
return '';
}
$out = '<div class="' . ($always_visible ? 'row-actions-visible' : 'row-actions') . '">';
foreach ($actions as $action => $link) {
$i++;
($i == $action_count) ? $sep = '' : $sep = ' | ';
$out .= "<span class='$action'>$link$sep</span>";
}
$out .= '</div>';
return $out;
}
/**
* Display a monthly dropdown for filtering items
*/
protected function months_dropdown($post_type)
{
global $wpdb, $wp_locale;
$months = $wpdb->get_results($wpdb->prepare("
SELECT DISTINCT YEAR(post_date) AS year, MONTH(post_date) AS month
FROM $wpdb->posts
WHERE post_type = %s
ORDER BY post_date DESC
", $post_type));
$month_count = count($months);
if (!$month_count || (1 == $month_count && 0 == $months[0]->month)) {
return;
}
$m = isset($_GET['m']) ? (int) $_GET['m'] : 0;
?>
<select name='m'>
<option<?php selected( $m, 0 ); ?> value='0'><?php _e( 'Show all dates' ); ?></option>
<?php
foreach ( $months as $arc_row ) {
if ( 0 == $arc_row->year )
continue;
$month = zeroise( $arc_row->month, 2 );
$year = $arc_row->year;
printf( "<option %s value='%s'>%s</option>\n",
selected( $m, $year . $month, false ),
esc_attr( $arc_row->year . $month ),
/* translators: 1: month name, 2: 4-digit year */
sprintf( __( '%1$s %2$d' ), $wp_locale->get_month( $month ), $year )
);
}
?>
</select>
<?php
}
/**
* Display a view switcher
*/
protected function view_switcher($current_mode)
{
$modes = array(
'list' => __('List View'),
'excerpt' => __('Excerpt View')
);
?>
<input type="hidden" name="mode" value="<?php echo esc_attr( $current_mode ); ?>" />
<div class="view-switch">
<?php
foreach ( $modes as $mode => $title ) {
$class = ( $current_mode == $mode ) ? 'class="current"' : '';
echo "<a href='" . esc_url( add_query_arg( 'mode', $mode, $_SERVER['REQUEST_URI'] ) ) . "' $class><img id='view-switch-$mode' src='" . esc_url( includes_url( 'images/blank.gif' ) ) . "' width='20' height='20' title='$title' alt='$title' /></a>\n";
}
?>
</div>
<?php
}
/**
* Display a comment count bubble
*
* @param integer $post_id
* @param integer $pending_comments
*/
protected function comments_bubble($post_id, $pending_comments)
{
$pending_phrase = sprintf(__('%s pending'), number_format($pending_comments));
if ($pending_comments) {
echo '<strong>';
}
echo "<a href='" . esc_url(add_query_arg('p', $post_id, admin_url('edit-comments.php'))) . "' title='" . esc_attr($pending_phrase) . "' class='post-com-count'><span class='comment-count'>" . number_format_i18n(get_comments_number()) . "</span></a>";
if ($pending_comments) {
echo '</strong>';
}
}
/**
* Get the current page number
*
* @return integer
*/
public function get_pagenum()
{
$pagenum = isset($_REQUEST['paged']) ? absint($_REQUEST['paged']) : 0;
if (isset($this->pagination_args['total_pages']) && $pagenum > $this->pagination_args['total_pages']) {
$pagenum = $this->pagination_args['total_pages'];
}
return max(1, $pagenum);
}
/**
* Get number of items to display on a single page
*
* @return integer
*/
protected function get_items_per_page($option, $default = 20)
{
$per_page = (int) get_user_option($option);
if (empty($per_page) || $per_page < 1) {
$per_page = $default;
}
return (int) apply_filters($option, $per_page);
}
/**
* Display the pagination.
*/
protected function pagination($which)
{
if (empty($this->pagination_args)) {
return;
}
extract($this->pagination_args, EXTR_SKIP);
$output = '<span class="displaying-num">' . sprintf(_n('1 item', '%s items', $total_items), number_format_i18n($total_items)) . '</span>';
$current = $this->get_pagenum();
$current_url = set_url_scheme('http://' . $_SERVER['HTTP_HOST'] . $_SERVER['REQUEST_URI']);
$current_url = remove_query_arg(array('hotkeys_highlight_last', 'hotkeys_highlight_first'), $current_url);
$page_links = array();
$disable_first = $disable_last = '';
if ($current == 1) {
$disable_first = ' disabled';
}
if ($current == $total_pages) {
$disable_last = ' disabled';
}
$page_links[] = sprintf( "<a class='%s' title='%s' href='%s'>%s</a>",
'first-page' . $disable_first,
esc_attr__('Go to the first page'),
esc_url(remove_query_arg('paged', $current_url)),
'«'
);
$page_links[] = sprintf("<a class='%s' title='%s' href='%s'>%s</a>",
'prev-page' . $disable_first,
esc_attr__('Go to the previous page'),
esc_url(add_query_arg('paged', max(1, $current - 1), $current_url)),
'‹'
);
if ('bottom' == $which) {
$html_current_page = $current;
} else {
$html_current_page = sprintf("<input class='current-page' title='%s' type='text' name='paged' value='%s' size='%d' />",
esc_attr__('Current page'),
$current,
strlen($total_pages)
);
}
$html_total_pages = sprintf("<span class='total-pages'>%s</span>", number_format_i18n($total_pages));
$page_links[] = '<span class="paging-input">' . sprintf(_x('%1$s of %2$s', 'paging'), $html_current_page, $html_total_pages) . '</span>';
$page_links[] = sprintf("<a class='%s' title='%s' href='%s'>%s</a>",
'next-page' . $disable_last,
esc_attr__('Go to the next page'),
esc_url(add_query_arg('paged', min($total_pages, $current + 1), $current_url)),
'›'
);
$page_links[] = sprintf("<a class='%s' title='%s' href='%s'>%s</a>",
'last-page' . $disable_last,
esc_attr__('Go to the last page'),
esc_url(add_query_arg('paged', $total_pages, $current_url)),
'»'
);
$pagination_links_class = 'pagination-links';
if (!empty($infinite_scroll)) {
$pagination_links_class = ' hide-if-js';
}
$output .= "\n<span class='$pagination_links_class'>" . join("\n", $page_links) . '</span>';
if ($total_pages) {
$page_class = $total_pages < 2 ? ' one-page' : '';
} else {
$page_class = ' no-pages';
}
$this->pagination = "<div class='tablenav-pages{$page_class}'>$output</div>";
echo $this->pagination;
}
/**
* Get a list of columns. The format is: 'internal-name' => 'Title'
*
* @return array
*/
abstract protected function get_columns();
/**
* Get a list of sortable columns. The format is:
* 'internal-name' => 'orderby'
* or
* 'internal-name' => array( 'orderby', true )
*
* The second format will make the initial sorting order be descending.
*
* @return array
*/
protected function get_sortable_columns()
{
return array();
}
/**
* Get a list of all, hidden and sortable columns, with filter applied
*
* @return array
*/
protected function get_column_info()
{
if (isset($this->column_headers)) {
return $this->column_headers;
}
$columns = get_column_headers($this->screen);
$hidden = get_hidden_columns($this->screen);
$_sortable = apply_filters("manage_{$this->screen->id}_sortable_columns", $this->get_sortable_columns());
$sortable = array();
foreach ($_sortable as $id => $data) {
if (empty($data)) {
continue;
}
$data = (array) $data;
if (!isset($data[1])) {
$data[1] = false;
}
$sortable[$id] = $data;
}
$this->column_headers = array($columns, $hidden, $sortable);
return $this->column_headers;
}
/**
* Return number of visible columns.
*
* @return int
*/
public function get_column_count()
{
list($columns, $hidden) = $this->get_column_info();
$hidden = array_intersect(array_keys($columns), array_filter($hidden));
return count($columns) - count($hidden);
}
/**
* Print column headers, accounting for hidden and sortable columns.
*
* @param bool $with_id
*/
protected function print_column_headers($with_id = true)
{
list($columns, $hidden, $sortable) = $this->get_column_info();
$current_url = set_url_scheme('http://' . $_SERVER['HTTP_HOST'] . $_SERVER['REQUEST_URI']);
$current_url = remove_query_arg('paged', $current_url);
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';
}
if (!empty($columns['cb'])) {
static $cb_counter = 1;
$columns['cb'] = '<label class="screen-reader-text" for="cb-select-all-' . $cb_counter . '">' . __('Select All') . '</label>'
. '<input id="cb-select-all-' . $cb_counter . '" type="checkbox" />';
$cb_counter++;
}
foreach ($columns as $column_key => $column_display_name) {
$class = array('manage-column', "column-$column_key");
$style = '';
if (in_array($column_key, $hidden)) {
$style = 'display:none;';
}
$style = ' style="' . $style . '"';
if ('cb' == $column_key) {
$class[] = 'check-column';
} elseif (in_array($column_key, array('posts', 'comments', 'links'))) {
$class[] = 'num';
}
if (isset($sortable[$column_key])) {
list($orderby, $desc_first) = $sortable[$column_key];
if ($current_orderby == $orderby) {
$order = 'asc' == $current_order ? 'desc' : 'asc';
$class[] = 'sorted';
$class[] = $current_order;
} else {
$order = $desc_first ? 'desc' : 'asc';
$class[] = 'sortable';
$class[] = $desc_first ? 'asc' : 'desc';
}
$column_display_name = '<a href="' . esc_url(add_query_arg(compact('orderby', 'order'), $current_url)) . '"><span>' . $column_display_name . '</span><span class="sorting-indicator"></span></a>';
}
$id = $with_id ? "id='$column_key'" : '';
if (!empty($class)) {
$class = "class='" . join(' ', $class) . "'";
}
echo "<th scope='col' $id $class $style>$column_display_name</th>";
}
}
/**
* Display the table.
*/
public function display()
{
extract($this->args);
$this->display_tablenav('top');
?>
<table class="wp-list-table <?php echo implode(' ', $this->get_table_classes()) ?>" cellspacing="0">
<thead>
<tr>
<?php $this->print_column_headers(); ?>
</tr>
</thead>
<tfoot>
<tr>
<?php $this->print_column_headers( false ); ?>
</tr>
</tfoot>
<tbody id="the-list"<?php if ( $singular ) echo " data-wp-lists='list:$singular'"; ?>>
<?php $this->display_rows_or_placeholder(); ?>
</tbody>
</table>
<?php
$this->display_tablenav('bottom');
}
/**
* Get a list of CSS classes for the <table> tag
*
* @return array
*/
protected function get_table_classes()
{
return array('widefat', 'fixed', $this->args['plural']);
}
/**
* Generate the table navigation above or below the table.
*/
protected function display_tablenav($which)
{
if ('top' == $which) {
wp_nonce_field('bulk-' . $this->args['plural']);
}
?>
<div class="tablenav <?php echo esc_attr($which) ?>">
<div class="alignleft actions">
<?php $this->bulk_actions() ?>
</div>
<?php
$this->extra_tablenav($which);
$this->pagination($which);
?>
<br class="clear">
</div>
<?php
}
/**
* Extra controls to be displayed between bulk actions and pagination.
*/
protected function extra_tablenav($which)
{
}
/**
* Generate the <tbody> part of the table.
*/
protected function display_rows_or_placeholder()
{
if ($this->has_items()) {
$this->display_rows();
} else {
list($columns, $hidden) = $this->get_column_info();
echo '<tr class="no-items"><td class="colspanchange" colspan="' . $this->get_column_count() . '">';
$this->no_items();
echo '</td></tr>';
}
}
/**
* Generate the table rows.
*/
protected function display_rows()
{
foreach ($this->items as $item) {
$this->single_row($item);
}
}
/**
* Generates content for a single row of the table.
*
* @param object $item The current item
*/
protected function single_row($item)
{
static $row_class = '';
$row_class = ($row_class == '' ? ' class="alternate"' : '');
echo '<tr' . $row_class . '>';
$this->single_row_columns($item);
echo '</tr>';
}
/**
* Generates the columns for a single row of the table.
*
* @param object $item The current item
*/
protected function single_row_columns($item)
{
list($columns, $hidden) = $this->get_column_info();
foreach ($columns as $column_name => $column_display_name) {
$class = "class='$column_name column-$column_name'";
$style = '';
if (in_array($column_name, $hidden)) {
$style = ' style="display:none;"';
}
$attributes = "$class$style";
if ('cb' == $column_name) {
echo '<th scope="row" class="check-column">';
echo $this->column_cb($item);
echo '</th>';
} elseif (method_exists($this, 'column_' . $column_name)) {
echo "<td $attributes>";
echo call_user_func(array(&$this, 'column_' . $column_name), $item);
echo "</td>";
} else {
echo "<td $attributes>";
echo $this->column_default($item, $column_name);
echo "</td>";
}
}
}
/**
* Handle an incoming ajax request (called from admin-ajax.php).
*/
public function ajax_response()
{
$this->prepare_items();
extract($this->args);
extract($this->pagination_args, EXTR_SKIP);
ob_start();
if (!empty($_REQUEST['no_placeholder'])) {
$this->display_rows();
} else {
$this->display_rows_or_placeholder();
}
$rows = ob_get_clean();
$response = array('rows' => $rows);
if (isset($total_items)) {
$response['total_items_i18n'] = sprintf(_n('1 item', '%s items', $total_items), number_format_i18n($total_items));
}
if (isset($total_pages)) {
$response['total_pages'] = $total_pages;
$response['total_pages_i18n'] = number_format_i18n($total_pages);
}
die(json_encode($response));
}
/**
* Send required variables to JavaScript land.
*/
protected function js_vars()
{
$args = array(
'class' => get_class($this),
'screen' => array(
'id' => $this->screen->id,
'base' => $this->screen->base,
)
);
printf("<script type='text/javascript'>list_args = %s;</script>\n", json_encode($args));
}
}