mirror of
https://github.com/WordPress/WordPress.git
synced 2024-11-02 16:59:35 +01:00
fd17918a8a
Implement `aria-sort` and change icon states to indicate current sort for list tables. Allow screen reader users to get context about the current sort and allow sighted users to know how the table is currently sorted. Props afercia, rianrietveld, joedolson, alexstine, johnjamesjacoby. Fixes #32170. Built from https://develop.svn.wordpress.org/trunk@55971 git-svn-id: http://core.svn.wordpress.org/trunk@55483 1a063a9b-81f0-0310-95a4-ce76da25c4cd
1032 lines
27 KiB
PHP
1032 lines
27 KiB
PHP
<?php
|
|
/**
|
|
* List Table API: WP_MS_Themes_List_Table class
|
|
*
|
|
* @package WordPress
|
|
* @subpackage Administration
|
|
* @since 3.1.0
|
|
*/
|
|
|
|
/**
|
|
* Core class used to implement displaying themes in a list table for the network admin.
|
|
*
|
|
* @since 3.1.0
|
|
*
|
|
* @see WP_List_Table
|
|
*/
|
|
class WP_MS_Themes_List_Table extends WP_List_Table {
|
|
|
|
public $site_id;
|
|
public $is_site_themes;
|
|
|
|
private $has_items;
|
|
|
|
/**
|
|
* Whether to show the auto-updates UI.
|
|
*
|
|
* @since 5.5.0
|
|
*
|
|
* @var bool True if auto-updates UI is to be shown, false otherwise.
|
|
*/
|
|
protected $show_autoupdates = true;
|
|
|
|
/**
|
|
* Constructor.
|
|
*
|
|
* @since 3.1.0
|
|
*
|
|
* @see WP_List_Table::__construct() for more information on default arguments.
|
|
*
|
|
* @global string $status
|
|
* @global int $page
|
|
*
|
|
* @param array $args An associative array of arguments.
|
|
*/
|
|
public function __construct( $args = array() ) {
|
|
global $status, $page;
|
|
|
|
parent::__construct(
|
|
array(
|
|
'plural' => 'themes',
|
|
'screen' => isset( $args['screen'] ) ? $args['screen'] : null,
|
|
)
|
|
);
|
|
|
|
$status = isset( $_REQUEST['theme_status'] ) ? $_REQUEST['theme_status'] : 'all';
|
|
if ( ! in_array( $status, array( 'all', 'enabled', 'disabled', 'upgrade', 'search', 'broken', 'auto-update-enabled', 'auto-update-disabled' ), true ) ) {
|
|
$status = 'all';
|
|
}
|
|
|
|
$page = $this->get_pagenum();
|
|
|
|
$this->is_site_themes = ( 'site-themes-network' === $this->screen->id ) ? true : false;
|
|
|
|
if ( $this->is_site_themes ) {
|
|
$this->site_id = isset( $_REQUEST['id'] ) ? (int) $_REQUEST['id'] : 0;
|
|
}
|
|
|
|
$this->show_autoupdates = wp_is_auto_update_enabled_for_type( 'theme' ) &&
|
|
! $this->is_site_themes && current_user_can( 'update_themes' );
|
|
}
|
|
|
|
/**
|
|
* @return array
|
|
*/
|
|
protected function get_table_classes() {
|
|
// @todo Remove and add CSS for .themes.
|
|
return array( 'widefat', 'plugins' );
|
|
}
|
|
|
|
/**
|
|
* @return bool
|
|
*/
|
|
public function ajax_user_can() {
|
|
if ( $this->is_site_themes ) {
|
|
return current_user_can( 'manage_sites' );
|
|
} else {
|
|
return current_user_can( 'manage_network_themes' );
|
|
}
|
|
}
|
|
|
|
/**
|
|
* @global string $status
|
|
* @global array $totals
|
|
* @global int $page
|
|
* @global string $orderby
|
|
* @global string $order
|
|
* @global string $s
|
|
*/
|
|
public function prepare_items() {
|
|
global $status, $totals, $page, $orderby, $order, $s;
|
|
|
|
wp_reset_vars( array( 'orderby', 'order', 's' ) );
|
|
|
|
$themes = array(
|
|
/**
|
|
* Filters the full array of WP_Theme objects to list in the Multisite
|
|
* themes list table.
|
|
*
|
|
* @since 3.1.0
|
|
*
|
|
* @param WP_Theme[] $all Array of WP_Theme objects to display in the list table.
|
|
*/
|
|
'all' => apply_filters( 'all_themes', wp_get_themes() ),
|
|
'search' => array(),
|
|
'enabled' => array(),
|
|
'disabled' => array(),
|
|
'upgrade' => array(),
|
|
'broken' => $this->is_site_themes ? array() : wp_get_themes( array( 'errors' => true ) ),
|
|
);
|
|
|
|
if ( $this->show_autoupdates ) {
|
|
$auto_updates = (array) get_site_option( 'auto_update_themes', array() );
|
|
|
|
$themes['auto-update-enabled'] = array();
|
|
$themes['auto-update-disabled'] = array();
|
|
}
|
|
|
|
if ( $this->is_site_themes ) {
|
|
$themes_per_page = $this->get_items_per_page( 'site_themes_network_per_page' );
|
|
$allowed_where = 'site';
|
|
} else {
|
|
$themes_per_page = $this->get_items_per_page( 'themes_network_per_page' );
|
|
$allowed_where = 'network';
|
|
}
|
|
|
|
$current = get_site_transient( 'update_themes' );
|
|
$maybe_update = current_user_can( 'update_themes' ) && ! $this->is_site_themes && $current;
|
|
|
|
foreach ( (array) $themes['all'] as $key => $theme ) {
|
|
if ( $this->is_site_themes && $theme->is_allowed( 'network' ) ) {
|
|
unset( $themes['all'][ $key ] );
|
|
continue;
|
|
}
|
|
|
|
if ( $maybe_update && isset( $current->response[ $key ] ) ) {
|
|
$themes['all'][ $key ]->update = true;
|
|
$themes['upgrade'][ $key ] = $themes['all'][ $key ];
|
|
}
|
|
|
|
$filter = $theme->is_allowed( $allowed_where, $this->site_id ) ? 'enabled' : 'disabled';
|
|
$themes[ $filter ][ $key ] = $themes['all'][ $key ];
|
|
|
|
$theme_data = array(
|
|
'update_supported' => isset( $theme->update_supported ) ? $theme->update_supported : true,
|
|
);
|
|
|
|
// Extra info if known. array_merge() ensures $theme_data has precedence if keys collide.
|
|
if ( isset( $current->response[ $key ] ) ) {
|
|
$theme_data = array_merge( (array) $current->response[ $key ], $theme_data );
|
|
} elseif ( isset( $current->no_update[ $key ] ) ) {
|
|
$theme_data = array_merge( (array) $current->no_update[ $key ], $theme_data );
|
|
} else {
|
|
$theme_data['update_supported'] = false;
|
|
}
|
|
|
|
$theme->update_supported = $theme_data['update_supported'];
|
|
|
|
/*
|
|
* Create the expected payload for the auto_update_theme filter, this is the same data
|
|
* as contained within $updates or $no_updates but used when the Theme is not known.
|
|
*/
|
|
$filter_payload = array(
|
|
'theme' => $key,
|
|
'new_version' => '',
|
|
'url' => '',
|
|
'package' => '',
|
|
'requires' => '',
|
|
'requires_php' => '',
|
|
);
|
|
|
|
$filter_payload = (object) array_merge( $filter_payload, array_intersect_key( $theme_data, $filter_payload ) );
|
|
|
|
$auto_update_forced = wp_is_auto_update_forced_for_item( 'theme', null, $filter_payload );
|
|
|
|
if ( ! is_null( $auto_update_forced ) ) {
|
|
$theme->auto_update_forced = $auto_update_forced;
|
|
}
|
|
|
|
if ( $this->show_autoupdates ) {
|
|
$enabled = in_array( $key, $auto_updates, true ) && $theme->update_supported;
|
|
if ( isset( $theme->auto_update_forced ) ) {
|
|
$enabled = (bool) $theme->auto_update_forced;
|
|
}
|
|
|
|
if ( $enabled ) {
|
|
$themes['auto-update-enabled'][ $key ] = $theme;
|
|
} else {
|
|
$themes['auto-update-disabled'][ $key ] = $theme;
|
|
}
|
|
}
|
|
}
|
|
|
|
if ( $s ) {
|
|
$status = 'search';
|
|
$themes['search'] = array_filter( array_merge( $themes['all'], $themes['broken'] ), array( $this, '_search_callback' ) );
|
|
}
|
|
|
|
$totals = array();
|
|
$js_themes = array();
|
|
foreach ( $themes as $type => $list ) {
|
|
$totals[ $type ] = count( $list );
|
|
$js_themes[ $type ] = array_keys( $list );
|
|
}
|
|
|
|
if ( empty( $themes[ $status ] ) && ! in_array( $status, array( 'all', 'search' ), true ) ) {
|
|
$status = 'all';
|
|
}
|
|
|
|
$this->items = $themes[ $status ];
|
|
WP_Theme::sort_by_name( $this->items );
|
|
|
|
$this->has_items = ! empty( $themes['all'] );
|
|
$total_this_page = $totals[ $status ];
|
|
|
|
wp_localize_script(
|
|
'updates',
|
|
'_wpUpdatesItemCounts',
|
|
array(
|
|
'themes' => $js_themes,
|
|
'totals' => wp_get_update_data(),
|
|
)
|
|
);
|
|
|
|
if ( $orderby ) {
|
|
$orderby = ucfirst( $orderby );
|
|
$order = strtoupper( $order );
|
|
|
|
if ( 'Name' === $orderby ) {
|
|
if ( 'ASC' === $order ) {
|
|
$this->items = array_reverse( $this->items );
|
|
}
|
|
} else {
|
|
uasort( $this->items, array( $this, '_order_callback' ) );
|
|
}
|
|
}
|
|
|
|
$start = ( $page - 1 ) * $themes_per_page;
|
|
|
|
if ( $total_this_page > $themes_per_page ) {
|
|
$this->items = array_slice( $this->items, $start, $themes_per_page, true );
|
|
}
|
|
|
|
$this->set_pagination_args(
|
|
array(
|
|
'total_items' => $total_this_page,
|
|
'per_page' => $themes_per_page,
|
|
)
|
|
);
|
|
}
|
|
|
|
/**
|
|
* @param WP_Theme $theme
|
|
* @return bool
|
|
*/
|
|
public function _search_callback( $theme ) {
|
|
static $term = null;
|
|
if ( is_null( $term ) ) {
|
|
$term = wp_unslash( $_REQUEST['s'] );
|
|
}
|
|
|
|
foreach ( array( 'Name', 'Description', 'Author', 'Author', 'AuthorURI' ) as $field ) {
|
|
// Don't mark up; Do translate.
|
|
if ( false !== stripos( $theme->display( $field, false, true ), $term ) ) {
|
|
return true;
|
|
}
|
|
}
|
|
|
|
if ( false !== stripos( $theme->get_stylesheet(), $term ) ) {
|
|
return true;
|
|
}
|
|
|
|
if ( false !== stripos( $theme->get_template(), $term ) ) {
|
|
return true;
|
|
}
|
|
|
|
return false;
|
|
}
|
|
|
|
// Not used by any core columns.
|
|
/**
|
|
* @global string $orderby
|
|
* @global string $order
|
|
* @param array $theme_a
|
|
* @param array $theme_b
|
|
* @return int
|
|
*/
|
|
public function _order_callback( $theme_a, $theme_b ) {
|
|
global $orderby, $order;
|
|
|
|
$a = $theme_a[ $orderby ];
|
|
$b = $theme_b[ $orderby ];
|
|
|
|
if ( $a === $b ) {
|
|
return 0;
|
|
}
|
|
|
|
if ( 'DESC' === $order ) {
|
|
return ( $a < $b ) ? 1 : -1;
|
|
} else {
|
|
return ( $a < $b ) ? -1 : 1;
|
|
}
|
|
}
|
|
|
|
/**
|
|
*/
|
|
public function no_items() {
|
|
if ( $this->has_items ) {
|
|
_e( 'No themes found.' );
|
|
} else {
|
|
_e( 'No themes are currently available.' );
|
|
}
|
|
}
|
|
|
|
/**
|
|
* @return string[] Array of column titles keyed by their column name.
|
|
*/
|
|
public function get_columns() {
|
|
$columns = array(
|
|
'cb' => '<input type="checkbox" />',
|
|
'name' => __( 'Theme' ),
|
|
'description' => __( 'Description' ),
|
|
);
|
|
|
|
if ( $this->show_autoupdates ) {
|
|
$columns['auto-updates'] = __( 'Automatic Updates' );
|
|
}
|
|
|
|
return $columns;
|
|
}
|
|
|
|
/**
|
|
* @return array
|
|
*/
|
|
protected function get_sortable_columns() {
|
|
return array(
|
|
'name' => array( 'name', false, __( 'Theme' ), __( 'Table ordered by Theme Name.' ), 'asc' ),
|
|
);
|
|
}
|
|
|
|
/**
|
|
* Gets the name of the primary column.
|
|
*
|
|
* @since 4.3.0
|
|
*
|
|
* @return string Unalterable name of the primary column name, in this case, 'name'.
|
|
*/
|
|
protected function get_primary_column_name() {
|
|
return 'name';
|
|
}
|
|
|
|
/**
|
|
* @global array $totals
|
|
* @global string $status
|
|
* @return array
|
|
*/
|
|
protected function get_views() {
|
|
global $totals, $status;
|
|
|
|
$status_links = array();
|
|
foreach ( $totals as $type => $count ) {
|
|
if ( ! $count ) {
|
|
continue;
|
|
}
|
|
|
|
switch ( $type ) {
|
|
case 'all':
|
|
/* translators: %s: Number of themes. */
|
|
$text = _nx(
|
|
'All <span class="count">(%s)</span>',
|
|
'All <span class="count">(%s)</span>',
|
|
$count,
|
|
'themes'
|
|
);
|
|
break;
|
|
case 'enabled':
|
|
/* translators: %s: Number of themes. */
|
|
$text = _nx(
|
|
'Enabled <span class="count">(%s)</span>',
|
|
'Enabled <span class="count">(%s)</span>',
|
|
$count,
|
|
'themes'
|
|
);
|
|
break;
|
|
case 'disabled':
|
|
/* translators: %s: Number of themes. */
|
|
$text = _nx(
|
|
'Disabled <span class="count">(%s)</span>',
|
|
'Disabled <span class="count">(%s)</span>',
|
|
$count,
|
|
'themes'
|
|
);
|
|
break;
|
|
case 'upgrade':
|
|
/* translators: %s: Number of themes. */
|
|
$text = _nx(
|
|
'Update Available <span class="count">(%s)</span>',
|
|
'Update Available <span class="count">(%s)</span>',
|
|
$count,
|
|
'themes'
|
|
);
|
|
break;
|
|
case 'broken':
|
|
/* translators: %s: Number of themes. */
|
|
$text = _nx(
|
|
'Broken <span class="count">(%s)</span>',
|
|
'Broken <span class="count">(%s)</span>',
|
|
$count,
|
|
'themes'
|
|
);
|
|
break;
|
|
case 'auto-update-enabled':
|
|
/* translators: %s: Number of themes. */
|
|
$text = _n(
|
|
'Auto-updates Enabled <span class="count">(%s)</span>',
|
|
'Auto-updates Enabled <span class="count">(%s)</span>',
|
|
$count
|
|
);
|
|
break;
|
|
case 'auto-update-disabled':
|
|
/* translators: %s: Number of themes. */
|
|
$text = _n(
|
|
'Auto-updates Disabled <span class="count">(%s)</span>',
|
|
'Auto-updates Disabled <span class="count">(%s)</span>',
|
|
$count
|
|
);
|
|
break;
|
|
}
|
|
|
|
if ( $this->is_site_themes ) {
|
|
$url = 'site-themes.php?id=' . $this->site_id;
|
|
} else {
|
|
$url = 'themes.php';
|
|
}
|
|
|
|
if ( 'search' !== $type ) {
|
|
$status_links[ $type ] = array(
|
|
'url' => esc_url( add_query_arg( 'theme_status', $type, $url ) ),
|
|
'label' => sprintf( $text, number_format_i18n( $count ) ),
|
|
'current' => $type === $status,
|
|
);
|
|
}
|
|
}
|
|
|
|
return $this->get_views_links( $status_links );
|
|
}
|
|
|
|
/**
|
|
* @global string $status
|
|
*
|
|
* @return array
|
|
*/
|
|
protected function get_bulk_actions() {
|
|
global $status;
|
|
|
|
$actions = array();
|
|
if ( 'enabled' !== $status ) {
|
|
$actions['enable-selected'] = $this->is_site_themes ? __( 'Enable' ) : __( 'Network Enable' );
|
|
}
|
|
if ( 'disabled' !== $status ) {
|
|
$actions['disable-selected'] = $this->is_site_themes ? __( 'Disable' ) : __( 'Network Disable' );
|
|
}
|
|
if ( ! $this->is_site_themes ) {
|
|
if ( current_user_can( 'update_themes' ) ) {
|
|
$actions['update-selected'] = __( 'Update' );
|
|
}
|
|
if ( current_user_can( 'delete_themes' ) ) {
|
|
$actions['delete-selected'] = __( 'Delete' );
|
|
}
|
|
}
|
|
|
|
if ( $this->show_autoupdates ) {
|
|
if ( 'auto-update-enabled' !== $status ) {
|
|
$actions['enable-auto-update-selected'] = __( 'Enable Auto-updates' );
|
|
}
|
|
|
|
if ( 'auto-update-disabled' !== $status ) {
|
|
$actions['disable-auto-update-selected'] = __( 'Disable Auto-updates' );
|
|
}
|
|
}
|
|
|
|
return $actions;
|
|
}
|
|
|
|
/**
|
|
*/
|
|
public function display_rows() {
|
|
foreach ( $this->items as $theme ) {
|
|
$this->single_row( $theme );
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Handles the checkbox column output.
|
|
*
|
|
* @since 4.3.0
|
|
* @since 5.9.0 Renamed `$theme` to `$item` to match parent class for PHP 8 named parameter support.
|
|
*
|
|
* @param WP_Theme $item The current WP_Theme object.
|
|
*/
|
|
public function column_cb( $item ) {
|
|
// Restores the more descriptive, specific name for use within this method.
|
|
$theme = $item;
|
|
$checkbox_id = 'checkbox_' . md5( $theme->get( 'Name' ) );
|
|
?>
|
|
<label class="label-covers-full-cell" for="<?php echo $checkbox_id; ?>" >
|
|
<span class="screen-reader-text">
|
|
<?php
|
|
printf(
|
|
/* translators: Hidden accessibility text. %s: Theme name */
|
|
__( 'Select %s' ),
|
|
$theme->display( 'Name' )
|
|
);
|
|
?>
|
|
</span>
|
|
</label>
|
|
<input type="checkbox" name="checked[]" value="<?php echo esc_attr( $theme->get_stylesheet() ); ?>" id="<?php echo $checkbox_id; ?>" />
|
|
<?php
|
|
}
|
|
|
|
/**
|
|
* Handles the name column output.
|
|
*
|
|
* @since 4.3.0
|
|
*
|
|
* @global string $status
|
|
* @global int $page
|
|
* @global string $s
|
|
*
|
|
* @param WP_Theme $theme The current WP_Theme object.
|
|
*/
|
|
public function column_name( $theme ) {
|
|
global $status, $page, $s;
|
|
|
|
$context = $status;
|
|
|
|
if ( $this->is_site_themes ) {
|
|
$url = "site-themes.php?id={$this->site_id}&";
|
|
$allowed = $theme->is_allowed( 'site', $this->site_id );
|
|
} else {
|
|
$url = 'themes.php?';
|
|
$allowed = $theme->is_allowed( 'network' );
|
|
}
|
|
|
|
// Pre-order.
|
|
$actions = array(
|
|
'enable' => '',
|
|
'disable' => '',
|
|
'delete' => '',
|
|
);
|
|
|
|
$stylesheet = $theme->get_stylesheet();
|
|
$theme_key = urlencode( $stylesheet );
|
|
|
|
if ( ! $allowed ) {
|
|
if ( ! $theme->errors() ) {
|
|
$url = add_query_arg(
|
|
array(
|
|
'action' => 'enable',
|
|
'theme' => $theme_key,
|
|
'paged' => $page,
|
|
's' => $s,
|
|
),
|
|
$url
|
|
);
|
|
|
|
if ( $this->is_site_themes ) {
|
|
/* translators: %s: Theme name. */
|
|
$aria_label = sprintf( __( 'Enable %s' ), $theme->display( 'Name' ) );
|
|
} else {
|
|
/* translators: %s: Theme name. */
|
|
$aria_label = sprintf( __( 'Network Enable %s' ), $theme->display( 'Name' ) );
|
|
}
|
|
|
|
$actions['enable'] = sprintf(
|
|
'<a href="%s" class="edit" aria-label="%s">%s</a>',
|
|
esc_url( wp_nonce_url( $url, 'enable-theme_' . $stylesheet ) ),
|
|
esc_attr( $aria_label ),
|
|
( $this->is_site_themes ? __( 'Enable' ) : __( 'Network Enable' ) )
|
|
);
|
|
}
|
|
} else {
|
|
$url = add_query_arg(
|
|
array(
|
|
'action' => 'disable',
|
|
'theme' => $theme_key,
|
|
'paged' => $page,
|
|
's' => $s,
|
|
),
|
|
$url
|
|
);
|
|
|
|
if ( $this->is_site_themes ) {
|
|
/* translators: %s: Theme name. */
|
|
$aria_label = sprintf( __( 'Disable %s' ), $theme->display( 'Name' ) );
|
|
} else {
|
|
/* translators: %s: Theme name. */
|
|
$aria_label = sprintf( __( 'Network Disable %s' ), $theme->display( 'Name' ) );
|
|
}
|
|
|
|
$actions['disable'] = sprintf(
|
|
'<a href="%s" aria-label="%s">%s</a>',
|
|
esc_url( wp_nonce_url( $url, 'disable-theme_' . $stylesheet ) ),
|
|
esc_attr( $aria_label ),
|
|
( $this->is_site_themes ? __( 'Disable' ) : __( 'Network Disable' ) )
|
|
);
|
|
}
|
|
|
|
if ( ! $allowed && ! $this->is_site_themes
|
|
&& current_user_can( 'delete_themes' )
|
|
&& get_option( 'stylesheet' ) !== $stylesheet
|
|
&& get_option( 'template' ) !== $stylesheet
|
|
) {
|
|
$url = add_query_arg(
|
|
array(
|
|
'action' => 'delete-selected',
|
|
'checked[]' => $theme_key,
|
|
'theme_status' => $context,
|
|
'paged' => $page,
|
|
's' => $s,
|
|
),
|
|
'themes.php'
|
|
);
|
|
|
|
/* translators: %s: Theme name. */
|
|
$aria_label = sprintf( _x( 'Delete %s', 'theme' ), $theme->display( 'Name' ) );
|
|
|
|
$actions['delete'] = sprintf(
|
|
'<a href="%s" class="delete" aria-label="%s">%s</a>',
|
|
esc_url( wp_nonce_url( $url, 'bulk-themes' ) ),
|
|
esc_attr( $aria_label ),
|
|
__( 'Delete' )
|
|
);
|
|
}
|
|
/**
|
|
* Filters the action links displayed for each theme in the Multisite
|
|
* themes list table.
|
|
*
|
|
* The action links displayed are determined by the theme's status, and
|
|
* which Multisite themes list table is being displayed - the Network
|
|
* themes list table (themes.php), which displays all installed themes,
|
|
* or the Site themes list table (site-themes.php), which displays the
|
|
* non-network enabled themes when editing a site in the Network admin.
|
|
*
|
|
* The default action links for the Network themes list table include
|
|
* 'Network Enable', 'Network Disable', and 'Delete'.
|
|
*
|
|
* The default action links for the Site themes list table include
|
|
* 'Enable', and 'Disable'.
|
|
*
|
|
* @since 2.8.0
|
|
*
|
|
* @param string[] $actions An array of action links.
|
|
* @param WP_Theme $theme The current WP_Theme object.
|
|
* @param string $context Status of the theme, one of 'all', 'enabled', or 'disabled'.
|
|
*/
|
|
$actions = apply_filters( 'theme_action_links', array_filter( $actions ), $theme, $context );
|
|
|
|
/**
|
|
* Filters the action links of a specific theme in the Multisite themes
|
|
* list table.
|
|
*
|
|
* The dynamic portion of the hook name, `$stylesheet`, refers to the
|
|
* directory name of the theme, which in most cases is synonymous
|
|
* with the template name.
|
|
*
|
|
* @since 3.1.0
|
|
*
|
|
* @param string[] $actions An array of action links.
|
|
* @param WP_Theme $theme The current WP_Theme object.
|
|
* @param string $context Status of the theme, one of 'all', 'enabled', or 'disabled'.
|
|
*/
|
|
$actions = apply_filters( "theme_action_links_{$stylesheet}", $actions, $theme, $context );
|
|
|
|
echo $this->row_actions( $actions, true );
|
|
}
|
|
|
|
/**
|
|
* Handles the description column output.
|
|
*
|
|
* @since 4.3.0
|
|
*
|
|
* @global string $status
|
|
* @global array $totals
|
|
*
|
|
* @param WP_Theme $theme The current WP_Theme object.
|
|
*/
|
|
public function column_description( $theme ) {
|
|
global $status, $totals;
|
|
|
|
if ( $theme->errors() ) {
|
|
$pre = 'broken' === $status ? __( 'Broken Theme:' ) . ' ' : '';
|
|
echo '<p><strong class="error-message">' . $pre . $theme->errors()->get_error_message() . '</strong></p>';
|
|
}
|
|
|
|
if ( $this->is_site_themes ) {
|
|
$allowed = $theme->is_allowed( 'site', $this->site_id );
|
|
} else {
|
|
$allowed = $theme->is_allowed( 'network' );
|
|
}
|
|
|
|
$class = ! $allowed ? 'inactive' : 'active';
|
|
if ( ! empty( $totals['upgrade'] ) && ! empty( $theme->update ) ) {
|
|
$class .= ' update';
|
|
}
|
|
|
|
echo "<div class='theme-description'><p>" . $theme->display( 'Description' ) . "</p></div>
|
|
<div class='$class second theme-version-author-uri'>";
|
|
|
|
$stylesheet = $theme->get_stylesheet();
|
|
$theme_meta = array();
|
|
|
|
if ( $theme->get( 'Version' ) ) {
|
|
/* translators: %s: Theme version. */
|
|
$theme_meta[] = sprintf( __( 'Version %s' ), $theme->display( 'Version' ) );
|
|
}
|
|
|
|
/* translators: %s: Theme author. */
|
|
$theme_meta[] = sprintf( __( 'By %s' ), $theme->display( 'Author' ) );
|
|
|
|
if ( $theme->get( 'ThemeURI' ) ) {
|
|
/* translators: %s: Theme name. */
|
|
$aria_label = sprintf( __( 'Visit theme site for %s' ), $theme->display( 'Name' ) );
|
|
|
|
$theme_meta[] = sprintf(
|
|
'<a href="%s" aria-label="%s">%s</a>',
|
|
$theme->display( 'ThemeURI' ),
|
|
esc_attr( $aria_label ),
|
|
__( 'Visit Theme Site' )
|
|
);
|
|
}
|
|
|
|
if ( $theme->parent() ) {
|
|
$theme_meta[] = sprintf(
|
|
/* translators: %s: Theme name. */
|
|
__( 'Child theme of %s' ),
|
|
'<strong>' . $theme->parent()->display( 'Name' ) . '</strong>'
|
|
);
|
|
}
|
|
|
|
/**
|
|
* Filters the array of row meta for each theme in the Multisite themes
|
|
* list table.
|
|
*
|
|
* @since 3.1.0
|
|
*
|
|
* @param string[] $theme_meta An array of the theme's metadata, including
|
|
* the version, author, and theme URI.
|
|
* @param string $stylesheet Directory name of the theme.
|
|
* @param WP_Theme $theme WP_Theme object.
|
|
* @param string $status Status of the theme.
|
|
*/
|
|
$theme_meta = apply_filters( 'theme_row_meta', $theme_meta, $stylesheet, $theme, $status );
|
|
|
|
echo implode( ' | ', $theme_meta );
|
|
|
|
echo '</div>';
|
|
}
|
|
|
|
/**
|
|
* Handles the auto-updates column output.
|
|
*
|
|
* @since 5.5.0
|
|
*
|
|
* @global string $status
|
|
* @global int $page
|
|
*
|
|
* @param WP_Theme $theme The current WP_Theme object.
|
|
*/
|
|
public function column_autoupdates( $theme ) {
|
|
global $status, $page;
|
|
|
|
static $auto_updates, $available_updates;
|
|
|
|
if ( ! $auto_updates ) {
|
|
$auto_updates = (array) get_site_option( 'auto_update_themes', array() );
|
|
}
|
|
if ( ! $available_updates ) {
|
|
$available_updates = get_site_transient( 'update_themes' );
|
|
}
|
|
|
|
$stylesheet = $theme->get_stylesheet();
|
|
|
|
if ( isset( $theme->auto_update_forced ) ) {
|
|
if ( $theme->auto_update_forced ) {
|
|
// Forced on.
|
|
$text = __( 'Auto-updates enabled' );
|
|
} else {
|
|
$text = __( 'Auto-updates disabled' );
|
|
}
|
|
$action = 'unavailable';
|
|
$time_class = ' hidden';
|
|
} elseif ( empty( $theme->update_supported ) ) {
|
|
$text = '';
|
|
$action = 'unavailable';
|
|
$time_class = ' hidden';
|
|
} elseif ( in_array( $stylesheet, $auto_updates, true ) ) {
|
|
$text = __( 'Disable auto-updates' );
|
|
$action = 'disable';
|
|
$time_class = '';
|
|
} else {
|
|
$text = __( 'Enable auto-updates' );
|
|
$action = 'enable';
|
|
$time_class = ' hidden';
|
|
}
|
|
|
|
$query_args = array(
|
|
'action' => "{$action}-auto-update",
|
|
'theme' => $stylesheet,
|
|
'paged' => $page,
|
|
'theme_status' => $status,
|
|
);
|
|
|
|
$url = add_query_arg( $query_args, 'themes.php' );
|
|
|
|
if ( 'unavailable' === $action ) {
|
|
$html[] = '<span class="label">' . $text . '</span>';
|
|
} else {
|
|
$html[] = sprintf(
|
|
'<a href="%s" class="toggle-auto-update aria-button-if-js" data-wp-action="%s">',
|
|
wp_nonce_url( $url, 'updates' ),
|
|
$action
|
|
);
|
|
|
|
$html[] = '<span class="dashicons dashicons-update spin hidden" aria-hidden="true"></span>';
|
|
$html[] = '<span class="label">' . $text . '</span>';
|
|
$html[] = '</a>';
|
|
|
|
}
|
|
|
|
if ( isset( $available_updates->response[ $stylesheet ] ) ) {
|
|
$html[] = sprintf(
|
|
'<div class="auto-update-time%s">%s</div>',
|
|
$time_class,
|
|
wp_get_auto_update_message()
|
|
);
|
|
}
|
|
|
|
$html = implode( '', $html );
|
|
|
|
/**
|
|
* Filters the HTML of the auto-updates setting for each theme in the Themes list table.
|
|
*
|
|
* @since 5.5.0
|
|
*
|
|
* @param string $html The HTML for theme's auto-update setting, including
|
|
* toggle auto-update action link and time to next update.
|
|
* @param string $stylesheet Directory name of the theme.
|
|
* @param WP_Theme $theme WP_Theme object.
|
|
*/
|
|
echo apply_filters( 'theme_auto_update_setting_html', $html, $stylesheet, $theme );
|
|
|
|
echo '<div class="notice notice-error notice-alt inline hidden"><p></p></div>';
|
|
}
|
|
|
|
/**
|
|
* Handles default column output.
|
|
*
|
|
* @since 4.3.0
|
|
* @since 5.9.0 Renamed `$theme` to `$item` to match parent class for PHP 8 named parameter support.
|
|
*
|
|
* @param WP_Theme $item The current WP_Theme object.
|
|
* @param string $column_name The current column name.
|
|
*/
|
|
public function column_default( $item, $column_name ) {
|
|
/**
|
|
* Fires inside each custom column of the Multisite themes list table.
|
|
*
|
|
* @since 3.1.0
|
|
*
|
|
* @param string $column_name Name of the column.
|
|
* @param string $stylesheet Directory name of the theme.
|
|
* @param WP_Theme $theme Current WP_Theme object.
|
|
*/
|
|
do_action(
|
|
'manage_themes_custom_column',
|
|
$column_name,
|
|
$item->get_stylesheet(), // Directory name of the theme.
|
|
$item // Theme object.
|
|
);
|
|
}
|
|
|
|
/**
|
|
* Handles the output for a single table row.
|
|
*
|
|
* @since 4.3.0
|
|
*
|
|
* @param WP_Theme $item The current WP_Theme object.
|
|
*/
|
|
public function single_row_columns( $item ) {
|
|
list( $columns, $hidden, $sortable, $primary ) = $this->get_column_info();
|
|
|
|
foreach ( $columns as $column_name => $column_display_name ) {
|
|
$extra_classes = '';
|
|
if ( in_array( $column_name, $hidden, true ) ) {
|
|
$extra_classes .= ' hidden';
|
|
}
|
|
|
|
switch ( $column_name ) {
|
|
case 'cb':
|
|
echo '<th scope="row" class="check-column">';
|
|
|
|
$this->column_cb( $item );
|
|
|
|
echo '</th>';
|
|
break;
|
|
|
|
case 'name':
|
|
$active_theme_label = '';
|
|
|
|
/* The presence of the site_id property means that this is a subsite view and a label for the active theme needs to be added */
|
|
if ( ! empty( $this->site_id ) ) {
|
|
$stylesheet = get_blog_option( $this->site_id, 'stylesheet' );
|
|
$template = get_blog_option( $this->site_id, 'template' );
|
|
|
|
/* Add a label for the active template */
|
|
if ( $item->get_template() === $template ) {
|
|
$active_theme_label = ' — ' . __( 'Active Theme' );
|
|
}
|
|
|
|
/* In case this is a child theme, label it properly */
|
|
if ( $stylesheet !== $template && $item->get_stylesheet() === $stylesheet ) {
|
|
$active_theme_label = ' — ' . __( 'Active Child Theme' );
|
|
}
|
|
}
|
|
|
|
echo "<td class='theme-title column-primary{$extra_classes}'><strong>" . $item->display( 'Name' ) . $active_theme_label . '</strong>';
|
|
|
|
$this->column_name( $item );
|
|
|
|
echo '</td>';
|
|
break;
|
|
|
|
case 'description':
|
|
echo "<td class='column-description desc{$extra_classes}'>";
|
|
|
|
$this->column_description( $item );
|
|
|
|
echo '</td>';
|
|
break;
|
|
|
|
case 'auto-updates':
|
|
echo "<td class='column-auto-updates{$extra_classes}'>";
|
|
|
|
$this->column_autoupdates( $item );
|
|
|
|
echo '</td>';
|
|
break;
|
|
default:
|
|
echo "<td class='$column_name column-$column_name{$extra_classes}'>";
|
|
|
|
$this->column_default( $item, $column_name );
|
|
|
|
echo '</td>';
|
|
break;
|
|
}
|
|
}
|
|
}
|
|
|
|
/**
|
|
* @global string $status
|
|
* @global array $totals
|
|
*
|
|
* @param WP_Theme $theme
|
|
*/
|
|
public function single_row( $theme ) {
|
|
global $status, $totals;
|
|
|
|
if ( $this->is_site_themes ) {
|
|
$allowed = $theme->is_allowed( 'site', $this->site_id );
|
|
} else {
|
|
$allowed = $theme->is_allowed( 'network' );
|
|
}
|
|
|
|
$stylesheet = $theme->get_stylesheet();
|
|
|
|
$class = ! $allowed ? 'inactive' : 'active';
|
|
if ( ! empty( $totals['upgrade'] ) && ! empty( $theme->update ) ) {
|
|
$class .= ' update';
|
|
}
|
|
|
|
printf(
|
|
'<tr class="%s" data-slug="%s">',
|
|
esc_attr( $class ),
|
|
esc_attr( $stylesheet )
|
|
);
|
|
|
|
$this->single_row_columns( $theme );
|
|
|
|
echo '</tr>';
|
|
|
|
if ( $this->is_site_themes ) {
|
|
remove_action( "after_theme_row_$stylesheet", 'wp_theme_update_row' );
|
|
}
|
|
|
|
/**
|
|
* Fires after each row in the Multisite themes list table.
|
|
*
|
|
* @since 3.1.0
|
|
*
|
|
* @param string $stylesheet Directory name of the theme.
|
|
* @param WP_Theme $theme Current WP_Theme object.
|
|
* @param string $status Status of the theme.
|
|
*/
|
|
do_action( 'after_theme_row', $stylesheet, $theme, $status );
|
|
|
|
/**
|
|
* Fires after each specific row in the Multisite themes list table.
|
|
*
|
|
* The dynamic portion of the hook name, `$stylesheet`, refers to the
|
|
* directory name of the theme, most often synonymous with the template
|
|
* name of the theme.
|
|
*
|
|
* @since 3.5.0
|
|
*
|
|
* @param string $stylesheet Directory name of the theme.
|
|
* @param WP_Theme $theme Current WP_Theme object.
|
|
* @param string $status Status of the theme.
|
|
*/
|
|
do_action( "after_theme_row_{$stylesheet}", $stylesheet, $theme, $status );
|
|
}
|
|
}
|