summaryrefslogtreecommitdiffstats
path: root/wp-admin/includes/class-wp-themes-list-table.php
diff options
context:
space:
mode:
authorDaniel Baumann <daniel.baumann@progress-linux.org>2024-04-17 07:56:49 +0000
committerDaniel Baumann <daniel.baumann@progress-linux.org>2024-04-17 07:56:49 +0000
commita415c29efee45520ae252d2aa28f1083a521cd7b (patch)
treef4ade4b6668ecc0765de7e1424f7c1427ad433ff /wp-admin/includes/class-wp-themes-list-table.php
parentInitial commit. (diff)
downloadwordpress-a415c29efee45520ae252d2aa28f1083a521cd7b.tar.xz
wordpress-a415c29efee45520ae252d2aa28f1083a521cd7b.zip
Adding upstream version 6.4.3+dfsg1.upstream/6.4.3+dfsg1
Signed-off-by: Daniel Baumann <daniel.baumann@progress-linux.org>
Diffstat (limited to 'wp-admin/includes/class-wp-themes-list-table.php')
-rw-r--r--wp-admin/includes/class-wp-themes-list-table.php360
1 files changed, 360 insertions, 0 deletions
diff --git a/wp-admin/includes/class-wp-themes-list-table.php b/wp-admin/includes/class-wp-themes-list-table.php
new file mode 100644
index 0000000..8d385f9
--- /dev/null
+++ b/wp-admin/includes/class-wp-themes-list-table.php
@@ -0,0 +1,360 @@
+<?php
+/**
+ * List Table API: WP_Themes_List_Table class
+ *
+ * @package WordPress
+ * @subpackage Administration
+ * @since 3.1.0
+ */
+
+/**
+ * Core class used to implement displaying installed themes in a list table.
+ *
+ * @since 3.1.0
+ *
+ * @see WP_List_Table
+ */
+class WP_Themes_List_Table extends WP_List_Table {
+
+ protected $search_terms = array();
+ public $features = array();
+
+ /**
+ * 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() ) {
+ parent::__construct(
+ array(
+ 'ajax' => true,
+ 'screen' => isset( $args['screen'] ) ? $args['screen'] : null,
+ )
+ );
+ }
+
+ /**
+ * @return bool
+ */
+ public function ajax_user_can() {
+ // Do not check edit_theme_options here. Ajax calls for available themes require switch_themes.
+ return current_user_can( 'switch_themes' );
+ }
+
+ /**
+ */
+ public function prepare_items() {
+ $themes = wp_get_themes( array( 'allowed' => true ) );
+
+ if ( ! empty( $_REQUEST['s'] ) ) {
+ $this->search_terms = array_unique( array_filter( array_map( 'trim', explode( ',', strtolower( wp_unslash( $_REQUEST['s'] ) ) ) ) ) );
+ }
+
+ if ( ! empty( $_REQUEST['features'] ) ) {
+ $this->features = $_REQUEST['features'];
+ }
+
+ if ( $this->search_terms || $this->features ) {
+ foreach ( $themes as $key => $theme ) {
+ if ( ! $this->search_theme( $theme ) ) {
+ unset( $themes[ $key ] );
+ }
+ }
+ }
+
+ unset( $themes[ get_option( 'stylesheet' ) ] );
+ WP_Theme::sort_by_name( $themes );
+
+ $per_page = 36;
+ $page = $this->get_pagenum();
+
+ $start = ( $page - 1 ) * $per_page;
+
+ $this->items = array_slice( $themes, $start, $per_page, true );
+
+ $this->set_pagination_args(
+ array(
+ 'total_items' => count( $themes ),
+ 'per_page' => $per_page,
+ 'infinite_scroll' => true,
+ )
+ );
+ }
+
+ /**
+ */
+ public function no_items() {
+ if ( $this->search_terms || $this->features ) {
+ _e( 'No items found.' );
+ return;
+ }
+
+ $blog_id = get_current_blog_id();
+ if ( is_multisite() ) {
+ if ( current_user_can( 'install_themes' ) && current_user_can( 'manage_network_themes' ) ) {
+ printf(
+ /* translators: 1: URL to Themes tab on Edit Site screen, 2: URL to Add Themes screen. */
+ __( 'You only have one theme enabled for this site right now. Visit the Network Admin to <a href="%1$s">enable</a> or <a href="%2$s">install</a> more themes.' ),
+ network_admin_url( 'site-themes.php?id=' . $blog_id ),
+ network_admin_url( 'theme-install.php' )
+ );
+
+ return;
+ } elseif ( current_user_can( 'manage_network_themes' ) ) {
+ printf(
+ /* translators: %s: URL to Themes tab on Edit Site screen. */
+ __( 'You only have one theme enabled for this site right now. Visit the Network Admin to <a href="%s">enable</a> more themes.' ),
+ network_admin_url( 'site-themes.php?id=' . $blog_id )
+ );
+
+ return;
+ }
+ // Else, fallthrough. install_themes doesn't help if you can't enable it.
+ } else {
+ if ( current_user_can( 'install_themes' ) ) {
+ printf(
+ /* translators: %s: URL to Add Themes screen. */
+ __( 'You only have one theme installed right now. Live a little! You can choose from over 1,000 free themes in the WordPress Theme Directory at any time: just click on the <a href="%s">Install Themes</a> tab above.' ),
+ admin_url( 'theme-install.php' )
+ );
+
+ return;
+ }
+ }
+ // Fallthrough.
+ printf(
+ /* translators: %s: Network title. */
+ __( 'Only the active theme is available to you. Contact the %s administrator for information about accessing additional themes.' ),
+ get_site_option( 'site_name' )
+ );
+ }
+
+ /**
+ * @param string $which
+ */
+ public function tablenav( $which = 'top' ) {
+ if ( $this->get_pagination_arg( 'total_pages' ) <= 1 ) {
+ return;
+ }
+ ?>
+ <div class="tablenav themes <?php echo $which; ?>">
+ <?php $this->pagination( $which ); ?>
+ <span class="spinner"></span>
+ <br class="clear" />
+ </div>
+ <?php
+ }
+
+ /**
+ * Displays the themes table.
+ *
+ * Overrides the parent display() method to provide a different container.
+ *
+ * @since 3.1.0
+ */
+ public function display() {
+ wp_nonce_field( 'fetch-list-' . get_class( $this ), '_ajax_fetch_list_nonce' );
+ ?>
+ <?php $this->tablenav( 'top' ); ?>
+
+ <div id="availablethemes">
+ <?php $this->display_rows_or_placeholder(); ?>
+ </div>
+
+ <?php $this->tablenav( 'bottom' ); ?>
+ <?php
+ }
+
+ /**
+ * @return string[] Array of column titles keyed by their column name.
+ */
+ public function get_columns() {
+ return array();
+ }
+
+ /**
+ */
+ public function display_rows_or_placeholder() {
+ if ( $this->has_items() ) {
+ $this->display_rows();
+ } else {
+ echo '<div class="no-items">';
+ $this->no_items();
+ echo '</div>';
+ }
+ }
+
+ /**
+ */
+ public function display_rows() {
+ $themes = $this->items;
+
+ foreach ( $themes as $theme ) :
+ ?>
+ <div class="available-theme">
+ <?php
+
+ $template = $theme->get_template();
+ $stylesheet = $theme->get_stylesheet();
+ $title = $theme->display( 'Name' );
+ $version = $theme->display( 'Version' );
+ $author = $theme->display( 'Author' );
+
+ $activate_link = wp_nonce_url( 'themes.php?action=activate&amp;template=' . urlencode( $template ) . '&amp;stylesheet=' . urlencode( $stylesheet ), 'switch-theme_' . $stylesheet );
+
+ $actions = array();
+ $actions['activate'] = sprintf(
+ '<a href="%s" class="activatelink" title="%s">%s</a>',
+ $activate_link,
+ /* translators: %s: Theme name. */
+ esc_attr( sprintf( _x( 'Activate &#8220;%s&#8221;', 'theme' ), $title ) ),
+ __( 'Activate' )
+ );
+
+ if ( current_user_can( 'edit_theme_options' ) && current_user_can( 'customize' ) ) {
+ $actions['preview'] .= sprintf(
+ '<a href="%s" class="load-customize hide-if-no-customize">%s</a>',
+ wp_customize_url( $stylesheet ),
+ __( 'Live Preview' )
+ );
+ }
+
+ if ( ! is_multisite() && current_user_can( 'delete_themes' ) ) {
+ $actions['delete'] = sprintf(
+ '<a class="submitdelete deletion" href="%s" onclick="return confirm( \'%s\' );">%s</a>',
+ wp_nonce_url( 'themes.php?action=delete&amp;stylesheet=' . urlencode( $stylesheet ), 'delete-theme_' . $stylesheet ),
+ /* translators: %s: Theme name. */
+ esc_js( sprintf( __( "You are about to delete this theme '%s'\n 'Cancel' to stop, 'OK' to delete." ), $title ) ),
+ __( 'Delete' )
+ );
+ }
+
+ /** This filter is documented in wp-admin/includes/class-wp-ms-themes-list-table.php */
+ $actions = apply_filters( 'theme_action_links', $actions, $theme, 'all' );
+
+ /** This filter is documented in wp-admin/includes/class-wp-ms-themes-list-table.php */
+ $actions = apply_filters( "theme_action_links_{$stylesheet}", $actions, $theme, 'all' );
+ $delete_action = isset( $actions['delete'] ) ? '<div class="delete-theme">' . $actions['delete'] . '</div>' : '';
+ unset( $actions['delete'] );
+
+ $screenshot = $theme->get_screenshot();
+ ?>
+
+ <span class="screenshot hide-if-customize">
+ <?php if ( $screenshot ) : ?>
+ <img src="<?php echo esc_url( $screenshot . '?ver=' . $theme->version ); ?>" alt="" />
+ <?php endif; ?>
+ </span>
+ <a href="<?php echo wp_customize_url( $stylesheet ); ?>" class="screenshot load-customize hide-if-no-customize">
+ <?php if ( $screenshot ) : ?>
+ <img src="<?php echo esc_url( $screenshot . '?ver=' . $theme->version ); ?>" alt="" />
+ <?php endif; ?>
+ </a>
+
+ <h3><?php echo $title; ?></h3>
+ <div class="theme-author">
+ <?php
+ /* translators: %s: Theme author. */
+ printf( __( 'By %s' ), $author );
+ ?>
+ </div>
+ <div class="action-links">
+ <ul>
+ <?php foreach ( $actions as $action ) : ?>
+ <li><?php echo $action; ?></li>
+ <?php endforeach; ?>
+ <li class="hide-if-no-js"><a href="#" class="theme-detail"><?php _e( 'Details' ); ?></a></li>
+ </ul>
+ <?php echo $delete_action; ?>
+
+ <?php theme_update_available( $theme ); ?>
+ </div>
+
+ <div class="themedetaildiv hide-if-js">
+ <p><strong><?php _e( 'Version:' ); ?></strong> <?php echo $version; ?></p>
+ <p><?php echo $theme->display( 'Description' ); ?></p>
+ <?php
+ if ( $theme->parent() ) {
+ printf(
+ /* translators: 1: Link to documentation on child themes, 2: Name of parent theme. */
+ ' <p class="howto">' . __( 'This <a href="%1$s">child theme</a> requires its parent theme, %2$s.' ) . '</p>',
+ __( 'https://developer.wordpress.org/themes/advanced-topics/child-themes/' ),
+ $theme->parent()->display( 'Name' )
+ );
+ }
+ ?>
+ </div>
+
+ </div>
+ <?php
+ endforeach;
+ }
+
+ /**
+ * @param WP_Theme $theme
+ * @return bool
+ */
+ public function search_theme( $theme ) {
+ // Search the features.
+ foreach ( $this->features as $word ) {
+ if ( ! in_array( $word, $theme->get( 'Tags' ), true ) ) {
+ return false;
+ }
+ }
+
+ // Match all phrases.
+ foreach ( $this->search_terms as $word ) {
+ if ( in_array( $word, $theme->get( 'Tags' ), true ) ) {
+ continue;
+ }
+
+ foreach ( array( 'Name', 'Description', 'Author', 'AuthorURI' ) as $header ) {
+ // Don't mark up; Do translate.
+ if ( false !== stripos( strip_tags( $theme->display( $header, false, true ) ), $word ) ) {
+ continue 2;
+ }
+ }
+
+ if ( false !== stripos( $theme->get_stylesheet(), $word ) ) {
+ continue;
+ }
+
+ if ( false !== stripos( $theme->get_template(), $word ) ) {
+ continue;
+ }
+
+ return false;
+ }
+
+ return true;
+ }
+
+ /**
+ * Send required variables to JavaScript land
+ *
+ * @since 3.4.0
+ *
+ * @param array $extra_args
+ */
+ public function _js_vars( $extra_args = array() ) {
+ $search_string = isset( $_REQUEST['s'] ) ? esc_attr( wp_unslash( $_REQUEST['s'] ) ) : '';
+
+ $args = array(
+ 'search' => $search_string,
+ 'features' => $this->features,
+ 'paged' => $this->get_pagenum(),
+ 'total_pages' => ! empty( $this->_pagination_args['total_pages'] ) ? $this->_pagination_args['total_pages'] : 1,
+ );
+
+ if ( is_array( $extra_args ) ) {
+ $args = array_merge( $args, $extra_args );
+ }
+
+ printf( "<script type='text/javascript'>var theme_list_args = %s;</script>\n", wp_json_encode( $args ) );
+ parent::_js_vars();
+ }
+}