mirror of
https://github.com/WordPress/WordPress.git
synced 2024-08-29 09:09:39 +02:00
aebe05f6f4
Matches the method signatures of the parent class and each child class. Why? PHP 8 introduces the ability to pass named arguments to function/method calls. This means the child and parent method signatures (i.e. parameter names) need to match. For readability: - `@since` clearly specifies the original parameter name and its new name as well as why the change happened - in methods longer than a single line, the generic parameter is reassigned to the original parameter restoring it for context for use within the method. An inline comment is added to explain why this reassignment is made. Follow-up to [32644], [32664], [32798], [38489], [49183], [49197]. Props jrf, hellofromTonya, sergeybiryukov, azaozz, desrosj, johnbillion. See #51553. Built from https://develop.svn.wordpress.org/trunk@51737 git-svn-id: http://core.svn.wordpress.org/trunk@51345 1a063a9b-81f0-0310-95a4-ce76da25c4cd
750 lines
20 KiB
PHP
750 lines
20 KiB
PHP
<?php
|
|
/**
|
|
* List Table API: WP_MS_Sites_List_Table class
|
|
*
|
|
* @package WordPress
|
|
* @subpackage Administration
|
|
* @since 3.1.0
|
|
*/
|
|
|
|
/**
|
|
* Core class used to implement displaying sites in a list table for the network admin.
|
|
*
|
|
* @since 3.1.0
|
|
* @access private
|
|
*
|
|
* @see WP_List_Table
|
|
*/
|
|
class WP_MS_Sites_List_Table extends WP_List_Table {
|
|
|
|
/**
|
|
* Site status list.
|
|
*
|
|
* @since 4.3.0
|
|
* @var array
|
|
*/
|
|
public $status_list;
|
|
|
|
/**
|
|
* Constructor.
|
|
*
|
|
* @since 3.1.0
|
|
*
|
|
* @see WP_List_Table::__construct() for more information on default arguments.
|
|
*
|
|
* @param array $args An associative array of arguments.
|
|
*/
|
|
public function __construct( $args = array() ) {
|
|
$this->status_list = array(
|
|
'archived' => array( 'site-archived', __( 'Archived' ) ),
|
|
'spam' => array( 'site-spammed', _x( 'Spam', 'site' ) ),
|
|
'deleted' => array( 'site-deleted', __( 'Deleted' ) ),
|
|
'mature' => array( 'site-mature', __( 'Mature' ) ),
|
|
);
|
|
|
|
parent::__construct(
|
|
array(
|
|
'plural' => 'sites',
|
|
'screen' => isset( $args['screen'] ) ? $args['screen'] : null,
|
|
)
|
|
);
|
|
}
|
|
|
|
/**
|
|
* @return bool
|
|
*/
|
|
public function ajax_user_can() {
|
|
return current_user_can( 'manage_sites' );
|
|
}
|
|
|
|
/**
|
|
* Prepares the list of sites for display.
|
|
*
|
|
* @since 3.1.0
|
|
*
|
|
* @global string $mode List table view mode.
|
|
* @global string $s
|
|
* @global wpdb $wpdb WordPress database abstraction object.
|
|
*/
|
|
public function prepare_items() {
|
|
global $mode, $s, $wpdb;
|
|
|
|
if ( ! empty( $_REQUEST['mode'] ) ) {
|
|
$mode = 'excerpt' === $_REQUEST['mode'] ? 'excerpt' : 'list';
|
|
set_user_setting( 'sites_list_mode', $mode );
|
|
} else {
|
|
$mode = get_user_setting( 'sites_list_mode', 'list' );
|
|
}
|
|
|
|
$per_page = $this->get_items_per_page( 'sites_network_per_page' );
|
|
|
|
$pagenum = $this->get_pagenum();
|
|
|
|
$s = isset( $_REQUEST['s'] ) ? wp_unslash( trim( $_REQUEST['s'] ) ) : '';
|
|
$wild = '';
|
|
if ( false !== strpos( $s, '*' ) ) {
|
|
$wild = '*';
|
|
$s = trim( $s, '*' );
|
|
}
|
|
|
|
/*
|
|
* If the network is large and a search is not being performed, show only
|
|
* the latest sites with no paging in order to avoid expensive count queries.
|
|
*/
|
|
if ( ! $s && wp_is_large_network() ) {
|
|
if ( ! isset( $_REQUEST['orderby'] ) ) {
|
|
$_GET['orderby'] = '';
|
|
$_REQUEST['orderby'] = '';
|
|
}
|
|
if ( ! isset( $_REQUEST['order'] ) ) {
|
|
$_GET['order'] = 'DESC';
|
|
$_REQUEST['order'] = 'DESC';
|
|
}
|
|
}
|
|
|
|
$args = array(
|
|
'number' => (int) $per_page,
|
|
'offset' => (int) ( ( $pagenum - 1 ) * $per_page ),
|
|
'network_id' => get_current_network_id(),
|
|
);
|
|
|
|
if ( empty( $s ) ) {
|
|
// Nothing to do.
|
|
} elseif ( preg_match( '/^[0-9]{1,3}\.[0-9]{1,3}\.[0-9]{1,3}\.[0-9]{1,3}$/', $s ) ||
|
|
preg_match( '/^[0-9]{1,3}\.[0-9]{1,3}\.[0-9]{1,3}\.?$/', $s ) ||
|
|
preg_match( '/^[0-9]{1,3}\.[0-9]{1,3}\.?$/', $s ) ||
|
|
preg_match( '/^[0-9]{1,3}\.$/', $s ) ) {
|
|
// IPv4 address.
|
|
$sql = $wpdb->prepare( "SELECT blog_id FROM {$wpdb->registration_log} WHERE {$wpdb->registration_log}.IP LIKE %s", $wpdb->esc_like( $s ) . ( ! empty( $wild ) ? '%' : '' ) );
|
|
$reg_blog_ids = $wpdb->get_col( $sql );
|
|
|
|
if ( $reg_blog_ids ) {
|
|
$args['site__in'] = $reg_blog_ids;
|
|
}
|
|
} elseif ( is_numeric( $s ) && empty( $wild ) ) {
|
|
$args['ID'] = $s;
|
|
} else {
|
|
$args['search'] = $s;
|
|
|
|
if ( ! is_subdomain_install() ) {
|
|
$args['search_columns'] = array( 'path' );
|
|
}
|
|
}
|
|
|
|
$order_by = isset( $_REQUEST['orderby'] ) ? $_REQUEST['orderby'] : '';
|
|
if ( 'registered' === $order_by ) {
|
|
// 'registered' is a valid field name.
|
|
} elseif ( 'lastupdated' === $order_by ) {
|
|
$order_by = 'last_updated';
|
|
} elseif ( 'blogname' === $order_by ) {
|
|
if ( is_subdomain_install() ) {
|
|
$order_by = 'domain';
|
|
} else {
|
|
$order_by = 'path';
|
|
}
|
|
} elseif ( 'blog_id' === $order_by ) {
|
|
$order_by = 'id';
|
|
} elseif ( ! $order_by ) {
|
|
$order_by = false;
|
|
}
|
|
|
|
$args['orderby'] = $order_by;
|
|
|
|
if ( $order_by ) {
|
|
$args['order'] = ( isset( $_REQUEST['order'] ) && 'DESC' === strtoupper( $_REQUEST['order'] ) ) ? 'DESC' : 'ASC';
|
|
}
|
|
|
|
if ( wp_is_large_network() ) {
|
|
$args['no_found_rows'] = true;
|
|
} else {
|
|
$args['no_found_rows'] = false;
|
|
}
|
|
|
|
// Take into account the role the user has selected.
|
|
$status = isset( $_REQUEST['status'] ) ? wp_unslash( trim( $_REQUEST['status'] ) ) : '';
|
|
if ( in_array( $status, array( 'public', 'archived', 'mature', 'spam', 'deleted' ), true ) ) {
|
|
$args[ $status ] = 1;
|
|
}
|
|
|
|
/**
|
|
* Filters the arguments for the site query in the sites list table.
|
|
*
|
|
* @since 4.6.0
|
|
*
|
|
* @param array $args An array of get_sites() arguments.
|
|
*/
|
|
$args = apply_filters( 'ms_sites_list_table_query_args', $args );
|
|
|
|
$_sites = get_sites( $args );
|
|
if ( is_array( $_sites ) ) {
|
|
update_site_cache( $_sites );
|
|
|
|
$this->items = array_slice( $_sites, 0, $per_page );
|
|
}
|
|
|
|
$total_sites = get_sites(
|
|
array_merge(
|
|
$args,
|
|
array(
|
|
'count' => true,
|
|
'offset' => 0,
|
|
'number' => 0,
|
|
)
|
|
)
|
|
);
|
|
|
|
$this->set_pagination_args(
|
|
array(
|
|
'total_items' => $total_sites,
|
|
'per_page' => $per_page,
|
|
)
|
|
);
|
|
}
|
|
|
|
/**
|
|
*/
|
|
public function no_items() {
|
|
_e( 'No sites found.' );
|
|
}
|
|
|
|
/**
|
|
* Gets links to filter sites by status.
|
|
*
|
|
* @since 5.3.0
|
|
*
|
|
* @return array
|
|
*/
|
|
protected function get_views() {
|
|
$counts = wp_count_sites();
|
|
|
|
$statuses = array(
|
|
/* translators: %s: Number of sites. */
|
|
'all' => _nx_noop(
|
|
'All <span class="count">(%s)</span>',
|
|
'All <span class="count">(%s)</span>',
|
|
'sites'
|
|
),
|
|
|
|
/* translators: %s: Number of sites. */
|
|
'public' => _n_noop(
|
|
'Public <span class="count">(%s)</span>',
|
|
'Public <span class="count">(%s)</span>'
|
|
),
|
|
|
|
/* translators: %s: Number of sites. */
|
|
'archived' => _n_noop(
|
|
'Archived <span class="count">(%s)</span>',
|
|
'Archived <span class="count">(%s)</span>'
|
|
),
|
|
|
|
/* translators: %s: Number of sites. */
|
|
'mature' => _n_noop(
|
|
'Mature <span class="count">(%s)</span>',
|
|
'Mature <span class="count">(%s)</span>'
|
|
),
|
|
|
|
/* translators: %s: Number of sites. */
|
|
'spam' => _nx_noop(
|
|
'Spam <span class="count">(%s)</span>',
|
|
'Spam <span class="count">(%s)</span>',
|
|
'sites'
|
|
),
|
|
|
|
/* translators: %s: Number of sites. */
|
|
'deleted' => _n_noop(
|
|
'Deleted <span class="count">(%s)</span>',
|
|
'Deleted <span class="count">(%s)</span>'
|
|
),
|
|
);
|
|
|
|
$view_links = array();
|
|
$requested_status = isset( $_REQUEST['status'] ) ? wp_unslash( trim( $_REQUEST['status'] ) ) : '';
|
|
$url = 'sites.php';
|
|
|
|
foreach ( $statuses as $status => $label_count ) {
|
|
$current_link_attributes = $requested_status === $status || ( '' === $requested_status && 'all' === $status )
|
|
? ' class="current" aria-current="page"'
|
|
: '';
|
|
if ( (int) $counts[ $status ] > 0 ) {
|
|
$label = sprintf( translate_nooped_plural( $label_count, $counts[ $status ] ), number_format_i18n( $counts[ $status ] ) );
|
|
$full_url = 'all' === $status ? $url : add_query_arg( 'status', $status, $url );
|
|
|
|
$view_links[ $status ] = sprintf(
|
|
'<a href="%1$s"%2$s>%3$s</a>',
|
|
esc_url( $full_url ),
|
|
$current_link_attributes,
|
|
$label
|
|
);
|
|
}
|
|
}
|
|
|
|
return $view_links;
|
|
}
|
|
|
|
/**
|
|
* @return array
|
|
*/
|
|
protected function get_bulk_actions() {
|
|
$actions = array();
|
|
if ( current_user_can( 'delete_sites' ) ) {
|
|
$actions['delete'] = __( 'Delete' );
|
|
}
|
|
$actions['spam'] = _x( 'Mark as spam', 'site' );
|
|
$actions['notspam'] = _x( 'Not spam', 'site' );
|
|
|
|
return $actions;
|
|
}
|
|
|
|
/**
|
|
* @global string $mode List table view mode.
|
|
*
|
|
* @param string $which The location of the pagination nav markup: 'top' or 'bottom'.
|
|
*/
|
|
protected function pagination( $which ) {
|
|
global $mode;
|
|
|
|
parent::pagination( $which );
|
|
|
|
if ( 'top' === $which ) {
|
|
$this->view_switcher( $mode );
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Extra controls to be displayed between bulk actions and pagination.
|
|
*
|
|
* @since 5.3.0
|
|
*
|
|
* @param string $which The location of the extra table nav markup: 'top' or 'bottom'.
|
|
*/
|
|
protected function extra_tablenav( $which ) {
|
|
?>
|
|
<div class="alignleft actions">
|
|
<?php
|
|
if ( 'top' === $which ) {
|
|
ob_start();
|
|
|
|
/**
|
|
* Fires before the Filter button on the MS sites list table.
|
|
*
|
|
* @since 5.3.0
|
|
*
|
|
* @param string $which The location of the extra table nav markup: 'top' or 'bottom'.
|
|
*/
|
|
do_action( 'restrict_manage_sites', $which );
|
|
|
|
$output = ob_get_clean();
|
|
|
|
if ( ! empty( $output ) ) {
|
|
echo $output;
|
|
submit_button( __( 'Filter' ), '', 'filter_action', false, array( 'id' => 'site-query-submit' ) );
|
|
}
|
|
}
|
|
?>
|
|
</div>
|
|
<?php
|
|
/**
|
|
* Fires immediately following the closing "actions" div in the tablenav for the
|
|
* MS sites list table.
|
|
*
|
|
* @since 5.3.0
|
|
*
|
|
* @param string $which The location of the extra table nav markup: 'top' or 'bottom'.
|
|
*/
|
|
do_action( 'manage_sites_extra_tablenav', $which );
|
|
}
|
|
|
|
/**
|
|
* @return array
|
|
*/
|
|
public function get_columns() {
|
|
$sites_columns = array(
|
|
'cb' => '<input type="checkbox" />',
|
|
'blogname' => __( 'URL' ),
|
|
'lastupdated' => __( 'Last Updated' ),
|
|
'registered' => _x( 'Registered', 'site' ),
|
|
'users' => __( 'Users' ),
|
|
);
|
|
|
|
if ( has_filter( 'wpmublogsaction' ) ) {
|
|
$sites_columns['plugins'] = __( 'Actions' );
|
|
}
|
|
|
|
/**
|
|
* Filters the displayed site columns in Sites list table.
|
|
*
|
|
* @since MU (3.0.0)
|
|
*
|
|
* @param string[] $sites_columns An array of displayed site columns. Default 'cb',
|
|
* 'blogname', 'lastupdated', 'registered', 'users'.
|
|
*/
|
|
return apply_filters( 'wpmu_blogs_columns', $sites_columns );
|
|
}
|
|
|
|
/**
|
|
* @return array
|
|
*/
|
|
protected function get_sortable_columns() {
|
|
return array(
|
|
'blogname' => 'blogname',
|
|
'lastupdated' => 'lastupdated',
|
|
'registered' => 'blog_id',
|
|
);
|
|
}
|
|
|
|
/**
|
|
* Handles the checkbox column output.
|
|
*
|
|
* @since 4.3.0
|
|
* @since 5.9.0 Renamed `$blog` to `$item` to match parent class for PHP 8 named parameter support.
|
|
*
|
|
* @param array $item Current site.
|
|
*/
|
|
public function column_cb( $item ) {
|
|
// Restores the more descriptive, specific name for use within this method.
|
|
$blog = $item;
|
|
|
|
if ( ! is_main_site( $blog['blog_id'] ) ) :
|
|
$blogname = untrailingslashit( $blog['domain'] . $blog['path'] );
|
|
?>
|
|
<label class="screen-reader-text" for="blog_<?php echo $blog['blog_id']; ?>">
|
|
<?php
|
|
/* translators: %s: Site URL. */
|
|
printf( __( 'Select %s' ), $blogname );
|
|
?>
|
|
</label>
|
|
<input type="checkbox" id="blog_<?php echo $blog['blog_id']; ?>" name="allblogs[]" value="<?php echo esc_attr( $blog['blog_id'] ); ?>" />
|
|
<?php
|
|
endif;
|
|
}
|
|
|
|
/**
|
|
* Handles the ID column output.
|
|
*
|
|
* @since 4.4.0
|
|
*
|
|
* @param array $blog Current site.
|
|
*/
|
|
public function column_id( $blog ) {
|
|
echo $blog['blog_id'];
|
|
}
|
|
|
|
/**
|
|
* Handles the site name column output.
|
|
*
|
|
* @since 4.3.0
|
|
*
|
|
* @global string $mode List table view mode.
|
|
*
|
|
* @param array $blog Current site.
|
|
*/
|
|
public function column_blogname( $blog ) {
|
|
global $mode;
|
|
|
|
$blogname = untrailingslashit( $blog['domain'] . $blog['path'] );
|
|
|
|
?>
|
|
<strong>
|
|
<a href="<?php echo esc_url( network_admin_url( 'site-info.php?id=' . $blog['blog_id'] ) ); ?>" class="edit"><?php echo $blogname; ?></a>
|
|
<?php $this->site_states( $blog ); ?>
|
|
</strong>
|
|
<?php
|
|
if ( 'list' !== $mode ) {
|
|
switch_to_blog( $blog['blog_id'] );
|
|
echo '<p>';
|
|
printf(
|
|
/* translators: 1: Site title, 2: Site tagline. */
|
|
__( '%1$s – %2$s' ),
|
|
get_option( 'blogname' ),
|
|
'<em>' . get_option( 'blogdescription' ) . '</em>'
|
|
);
|
|
echo '</p>';
|
|
restore_current_blog();
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Handles the lastupdated column output.
|
|
*
|
|
* @since 4.3.0
|
|
*
|
|
* @global string $mode List table view mode.
|
|
*
|
|
* @param array $blog Current site.
|
|
*/
|
|
public function column_lastupdated( $blog ) {
|
|
global $mode;
|
|
|
|
if ( 'list' === $mode ) {
|
|
$date = __( 'Y/m/d' );
|
|
} else {
|
|
$date = __( 'Y/m/d g:i:s a' );
|
|
}
|
|
|
|
echo ( '0000-00-00 00:00:00' === $blog['last_updated'] ) ? __( 'Never' ) : mysql2date( $date, $blog['last_updated'] );
|
|
}
|
|
|
|
/**
|
|
* Handles the registered column output.
|
|
*
|
|
* @since 4.3.0
|
|
*
|
|
* @global string $mode List table view mode.
|
|
*
|
|
* @param array $blog Current site.
|
|
*/
|
|
public function column_registered( $blog ) {
|
|
global $mode;
|
|
|
|
if ( 'list' === $mode ) {
|
|
$date = __( 'Y/m/d' );
|
|
} else {
|
|
$date = __( 'Y/m/d g:i:s a' );
|
|
}
|
|
|
|
if ( '0000-00-00 00:00:00' === $blog['registered'] ) {
|
|
echo '—';
|
|
} else {
|
|
echo mysql2date( $date, $blog['registered'] );
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Handles the users column output.
|
|
*
|
|
* @since 4.3.0
|
|
*
|
|
* @param array $blog Current site.
|
|
*/
|
|
public function column_users( $blog ) {
|
|
$user_count = wp_cache_get( $blog['blog_id'] . '_user_count', 'blog-details' );
|
|
if ( ! $user_count ) {
|
|
$blog_users = new WP_User_Query(
|
|
array(
|
|
'blog_id' => $blog['blog_id'],
|
|
'fields' => 'ID',
|
|
'number' => 1,
|
|
'count_total' => true,
|
|
)
|
|
);
|
|
$user_count = $blog_users->get_total();
|
|
wp_cache_set( $blog['blog_id'] . '_user_count', $user_count, 'blog-details', 12 * HOUR_IN_SECONDS );
|
|
}
|
|
|
|
printf(
|
|
'<a href="%s">%s</a>',
|
|
esc_url( network_admin_url( 'site-users.php?id=' . $blog['blog_id'] ) ),
|
|
number_format_i18n( $user_count )
|
|
);
|
|
}
|
|
|
|
/**
|
|
* Handles the plugins column output.
|
|
*
|
|
* @since 4.3.0
|
|
*
|
|
* @param array $blog Current site.
|
|
*/
|
|
public function column_plugins( $blog ) {
|
|
if ( has_filter( 'wpmublogsaction' ) ) {
|
|
/**
|
|
* Fires inside the auxiliary 'Actions' column of the Sites list table.
|
|
*
|
|
* By default this column is hidden unless something is hooked to the action.
|
|
*
|
|
* @since MU (3.0.0)
|
|
*
|
|
* @param int $blog_id The site ID.
|
|
*/
|
|
do_action( 'wpmublogsaction', $blog['blog_id'] );
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Handles output for the default column.
|
|
*
|
|
* @since 4.3.0
|
|
* @since 5.9.0 Renamed `$blog` to `$item` to match parent class for PHP 8 named parameter support.
|
|
*
|
|
* @param array $item Current site.
|
|
* @param string $column_name Current column name.
|
|
*/
|
|
public function column_default( $item, $column_name ) {
|
|
/**
|
|
* Fires for each registered custom column in the Sites list table.
|
|
*
|
|
* @since 3.1.0
|
|
*
|
|
* @param string $column_name The name of the column to display.
|
|
* @param int $blog_id The site ID.
|
|
*/
|
|
do_action( 'manage_sites_custom_column', $column_name, $item['blog_id'] );
|
|
}
|
|
|
|
/**
|
|
* @global string $mode List table view mode.
|
|
*/
|
|
public function display_rows() {
|
|
foreach ( $this->items as $blog ) {
|
|
$blog = $blog->to_array();
|
|
$class = '';
|
|
reset( $this->status_list );
|
|
|
|
foreach ( $this->status_list as $status => $col ) {
|
|
if ( 1 == $blog[ $status ] ) {
|
|
$class = " class='{$col[0]}'";
|
|
}
|
|
}
|
|
|
|
echo "<tr{$class}>";
|
|
|
|
$this->single_row_columns( $blog );
|
|
|
|
echo '</tr>';
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Maybe output comma-separated site states.
|
|
*
|
|
* @since 5.3.0
|
|
*
|
|
* @param array $site
|
|
*/
|
|
protected function site_states( $site ) {
|
|
$site_states = array();
|
|
|
|
// $site is still an array, so get the object.
|
|
$_site = WP_Site::get_instance( $site['blog_id'] );
|
|
|
|
if ( is_main_site( $_site->id ) ) {
|
|
$site_states['main'] = __( 'Main' );
|
|
}
|
|
|
|
reset( $this->status_list );
|
|
|
|
$site_status = isset( $_REQUEST['status'] ) ? wp_unslash( trim( $_REQUEST['status'] ) ) : '';
|
|
foreach ( $this->status_list as $status => $col ) {
|
|
if ( ( 1 === (int) $_site->{$status} ) && ( $site_status !== $status ) ) {
|
|
$site_states[ $col[0] ] = $col[1];
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Filters the default site display states for items in the Sites list table.
|
|
*
|
|
* @since 5.3.0
|
|
*
|
|
* @param array $site_states An array of site states. Default 'Main',
|
|
* 'Archived', 'Mature', 'Spam', 'Deleted'.
|
|
* @param WP_Site $site The current site object.
|
|
*/
|
|
$site_states = apply_filters( 'display_site_states', $site_states, $_site );
|
|
|
|
if ( ! empty( $site_states ) ) {
|
|
$state_count = count( $site_states );
|
|
$i = 0;
|
|
echo ' — ';
|
|
foreach ( $site_states as $state ) {
|
|
++$i;
|
|
( $i == $state_count ) ? $sep = '' : $sep = ', ';
|
|
echo "<span class='post-state'>{$state}{$sep}</span>";
|
|
}
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Gets the name of the default primary column.
|
|
*
|
|
* @since 4.3.0
|
|
*
|
|
* @return string Name of the default primary column, in this case, 'blogname'.
|
|
*/
|
|
protected function get_default_primary_column_name() {
|
|
return 'blogname';
|
|
}
|
|
|
|
/**
|
|
* Generates and displays row action links.
|
|
*
|
|
* @since 4.3.0
|
|
* @since 5.9.0 Renamed `$blog` to `$item` to match parent class for PHP 8 named parameter support.
|
|
*
|
|
* @param array $item Site being acted upon.
|
|
* @param string $column_name Current column name.
|
|
* @param string $primary Primary column name.
|
|
* @return string Row actions output for sites in Multisite, or an empty string
|
|
* if the current column is not the primary column.
|
|
*/
|
|
protected function handle_row_actions( $item, $column_name, $primary ) {
|
|
if ( $primary !== $column_name ) {
|
|
return '';
|
|
}
|
|
|
|
// Restores the more descriptive, specific name for use within this method.
|
|
$blog = $item;
|
|
$blogname = untrailingslashit( $blog['domain'] . $blog['path'] );
|
|
|
|
// Preordered.
|
|
$actions = array(
|
|
'edit' => '',
|
|
'backend' => '',
|
|
'activate' => '',
|
|
'deactivate' => '',
|
|
'archive' => '',
|
|
'unarchive' => '',
|
|
'spam' => '',
|
|
'unspam' => '',
|
|
'delete' => '',
|
|
'visit' => '',
|
|
);
|
|
|
|
$actions['edit'] = '<a href="' . esc_url( network_admin_url( 'site-info.php?id=' . $blog['blog_id'] ) ) . '">' . __( 'Edit' ) . '</a>';
|
|
$actions['backend'] = "<a href='" . esc_url( get_admin_url( $blog['blog_id'] ) ) . "' class='edit'>" . __( 'Dashboard' ) . '</a>';
|
|
if ( get_network()->site_id != $blog['blog_id'] ) {
|
|
if ( '1' == $blog['deleted'] ) {
|
|
$actions['activate'] = '<a href="' . esc_url( wp_nonce_url( network_admin_url( 'sites.php?action=confirm&action2=activateblog&id=' . $blog['blog_id'] ), 'activateblog_' . $blog['blog_id'] ) ) . '">' . __( 'Activate' ) . '</a>';
|
|
} else {
|
|
$actions['deactivate'] = '<a href="' . esc_url( wp_nonce_url( network_admin_url( 'sites.php?action=confirm&action2=deactivateblog&id=' . $blog['blog_id'] ), 'deactivateblog_' . $blog['blog_id'] ) ) . '">' . __( 'Deactivate' ) . '</a>';
|
|
}
|
|
|
|
if ( '1' == $blog['archived'] ) {
|
|
$actions['unarchive'] = '<a href="' . esc_url( wp_nonce_url( network_admin_url( 'sites.php?action=confirm&action2=unarchiveblog&id=' . $blog['blog_id'] ), 'unarchiveblog_' . $blog['blog_id'] ) ) . '">' . __( 'Unarchive' ) . '</a>';
|
|
} else {
|
|
$actions['archive'] = '<a href="' . esc_url( wp_nonce_url( network_admin_url( 'sites.php?action=confirm&action2=archiveblog&id=' . $blog['blog_id'] ), 'archiveblog_' . $blog['blog_id'] ) ) . '">' . _x( 'Archive', 'verb; site' ) . '</a>';
|
|
}
|
|
|
|
if ( '1' == $blog['spam'] ) {
|
|
$actions['unspam'] = '<a href="' . esc_url( wp_nonce_url( network_admin_url( 'sites.php?action=confirm&action2=unspamblog&id=' . $blog['blog_id'] ), 'unspamblog_' . $blog['blog_id'] ) ) . '">' . _x( 'Not Spam', 'site' ) . '</a>';
|
|
} else {
|
|
$actions['spam'] = '<a href="' . esc_url( wp_nonce_url( network_admin_url( 'sites.php?action=confirm&action2=spamblog&id=' . $blog['blog_id'] ), 'spamblog_' . $blog['blog_id'] ) ) . '">' . _x( 'Spam', 'site' ) . '</a>';
|
|
}
|
|
|
|
if ( current_user_can( 'delete_site', $blog['blog_id'] ) ) {
|
|
$actions['delete'] = '<a href="' . esc_url( wp_nonce_url( network_admin_url( 'sites.php?action=confirm&action2=deleteblog&id=' . $blog['blog_id'] ), 'deleteblog_' . $blog['blog_id'] ) ) . '">' . __( 'Delete' ) . '</a>';
|
|
}
|
|
}
|
|
|
|
$actions['visit'] = "<a href='" . esc_url( get_home_url( $blog['blog_id'], '/' ) ) . "' rel='bookmark'>" . __( 'Visit' ) . '</a>';
|
|
|
|
/**
|
|
* Filters the action links displayed for each site in the Sites list table.
|
|
*
|
|
* The 'Edit', 'Dashboard', 'Delete', and 'Visit' links are displayed by
|
|
* default for each site. The site's status determines whether to show the
|
|
* 'Activate' or 'Deactivate' link, 'Unarchive' or 'Archive' links, and
|
|
* 'Not Spam' or 'Spam' link for each site.
|
|
*
|
|
* @since 3.1.0
|
|
*
|
|
* @param string[] $actions An array of action links to be displayed.
|
|
* @param int $blog_id The site ID.
|
|
* @param string $blogname Site path, formatted depending on whether it is a sub-domain
|
|
* or subdirectory multisite installation.
|
|
*/
|
|
$actions = apply_filters( 'manage_sites_action_links', array_filter( $actions ), $blog['blog_id'], $blogname );
|
|
|
|
return $this->row_actions( $actions );
|
|
}
|
|
}
|