WP_Theme_Install_List_Table::single_row( stdClass $theme )

Parameters

$themestdClass

An object that contains theme data returned by the WordPress.org API.

• $namestring

  Theme name, e.g. 'Twenty Twenty-One'.

• $slugstring

  Theme slug, e.g. 'twentytwentyone'.

• $versionstring

  Theme version, e.g. '1.1'.

• $authorstring

  Theme author username, e.g. 'melchoyce'.

• $preview_urlstring

  Preview URL, e.g. '<a href="https://2021.wordpress.net/">https://2021.wordpress.net/</a>'.

• $screenshot_urlstring

  Screenshot URL, e.g. '<a href="https://wordpress.org/themes/twentytwentyone/">https://wordpress.org/themes/twentytwentyone/</a>'.

• $ratingfloat

  Rating score.

• $num_ratingsint

  The number of ratings.

• $homepagestring

  Theme homepage, e.g. '<a href="https://wordpress.org/themes/twentytwentyone/">https://wordpress.org/themes/twentytwentyone/</a>'.

• $descriptionstring

  Theme description.

• $download_linkstring

  Theme ZIP download URL.

Hooks fired · 1

One hook fires while WP_Theme_Install_List_Table::single_row() runs, in this order:

1. 1
   apply_filters( theme_install_actions )filterline 363 (+88 into the body)

   Filters the install action links for a theme in the Install Themes list table.

Uses · 13

• wp_kses()Filters text content and strips out disallowed HTML.
• __()Retrieves the translation of $text.
• add_query_arg()Retrieves a modified URL query string.
• self_admin_url()Retrieves the URL to the admin area for either the current site or the network depending on context.
• esc_url()Checks and cleans a URL.
• wp_nonce_url()Retrieves URL with nonce added to URL query.
• esc_attr()Escaping for HTML attributes.
• esc_attr__()Retrieves the translation of $text and escapes it for safe use in an attribute.
• _x()Retrieves translated string with gettext context.
• apply_filters()Calls the callback functions that have been added to a filter hook.
• _e()Displays translated text.
• WP_Theme_Install_List_Table::_get_theme_status()Checks to see if the theme is already installed.

Used by · 1

• WP_Theme_Install_List_Table::display_rows()Generates the list table rows.

Source

View on Trac ↗View on GitHub ↗

275	public function single_row( $theme ) {276		global $themes_allowedtags;277 278		if ( empty( $theme ) ) {279			return;280		}281 282		$name   = wp_kses( $theme->name, $themes_allowedtags );283		$author = wp_kses( $theme->author, $themes_allowedtags );284 285		/* translators: %s: Theme name. */286		$preview_title = sprintf( __( 'Preview &#8220;%s&#8221;' ), $name );287		$preview_url   = add_query_arg(288			array(289				'tab'   => 'theme-information',290				'theme' => $theme->slug,291			),292			self_admin_url( 'theme-install.php' )293		);294 295		$actions = array();296 297		$install_url = add_query_arg(298			array(299				'action' => 'install-theme',300				'theme'  => $theme->slug,301			),302			self_admin_url( 'update.php' )303		);304 305		$update_url = add_query_arg(306			array(307				'action' => 'upgrade-theme',308				'theme'  => $theme->slug,309			),310			self_admin_url( 'update.php' )311		);312 313		$status = $this->_get_theme_status( $theme );314 315		switch ( $status ) {316			case 'update_available':317				$actions[] = sprintf(318					'<a class="install-now" href="%s" title="%s">%s</a>',319					esc_url( wp_nonce_url( $update_url, 'upgrade-theme_' . $theme->slug ) ),320					/* translators: %s: Theme version. */321					esc_attr( sprintf( __( 'Update to version %s' ), $theme->version ) ),322					__( 'Update' )323				);324				break;325			case 'newer_installed':326			case 'latest_installed':327				$actions[] = sprintf(328					'<span class="install-now" title="%s">%s</span>',329					esc_attr__( 'This theme is already installed and is up to date' ),330					_x( 'Installed', 'theme' )331				);332				break;333			case 'install':334			default:335				$actions[] = sprintf(336					'<a class="install-now" href="%s" title="%s">%s</a>',337					esc_url( wp_nonce_url( $install_url, 'install-theme_' . $theme->slug ) ),338					/* translators: %s: Theme name. */339					esc_attr( sprintf( _x( 'Install %s', 'theme' ), $name ) ),340					_x( 'Install Now', 'theme' )341				);342				break;343		}344 345		$actions[] = sprintf(346			'<a class="install-theme-preview" href="%s" title="%s">%s</a>',347			esc_url( $preview_url ),348			/* translators: %s: Theme name. */349			esc_attr( sprintf( __( 'Preview %s' ), $name ) ),350			__( 'Preview' )351		);352 353		/**354		 * Filters the install action links for a theme in the Install Themes list table.

History

Introduced in 3.1.0. Unchanged from 6.7.7 through 7.1.0.

1. 6.7.7
2. 6.8.8
3. 6.9.7
4. 7.0.4
5. 7.1.0

Signature, return type and hooks compared across 5 parsed releases.

About this page

Parsed data

Generated from the wordpress-develop 6.7.7 tag, from src/wp-admin/includes/class-wp-theme-install-list-table.php, and regenerated for each WordPress release so it tracks the code rather than a snapshot of it.

Corrections

Something wrong on this page? Report it and it gets fixed in the next regeneration.