update_themes_(hostname) │ filter-hook │ WP 6.1.0

Filters the update response for a given theme hostname.

The dynamic portion of the hook name, $hostname, refers to the hostname of the URI specified in the Update URI header field.

Usage

add_filter( 'update_themes_(hostname)', 'wp_kama_update_themes_hostname_filter', 10, 4 );

/**
 * Function for `update_themes_(hostname)` filter-hook.
 * 
 * @param array|false $update           The theme update data with the latest details.
 * @param array       $theme_data       Theme headers.
 * @param string      $theme_stylesheet Theme stylesheet.
 * @param string[]    $locales          Installed locales to look up translations for.
 *
 * @return array|false
 */
function wp_kama_update_themes_hostname_filter( $update, $theme_data, $theme_stylesheet, $locales ){

	// filter...
	return $update;
}

$update(array|false)

The theme update data with the latest details.

Default: false

• id(string)
  Optional. ID of the theme for update purposes, should be a URI specified in the Update URI header field.

• theme(string)
  Directory name of the theme.

• version(string)
  The version of the theme.

• url(string)
  The URL for details of the theme.

• package(string)
  Optional. The update ZIP for the theme.

• tested(string)
  Optional. The version of WordPress the theme is tested against.

• requires_php(string)
  Optional. The version of PHP which the theme requires.

• autoupdate(true|false)
  Optional. Whether the theme should automatically update.

• translations(array)
  Optional. List of translation updates for the theme.

  • language(string)
    The language the translation update is for.

  • version(string)
    The version of the theme this translation is for. This is not the version of the language file.

  • updated(string)
    The update timestamp of the translation file. Should be a date in the YYYY-MM-DD HH:MM:SS format.

  • package(string)
    The ZIP location containing the translation update.

  • autoupdate(string)
    Whether the translation should be automatically installed.

$theme_data(array)

Theme headers.

$theme_stylesheet(string)

Theme stylesheet.

$locales(string[])

Installed locales to look up translations for.

Changelog

Where the hook is called

$update = apply_filters( "update_themes_{$hostname}", false, $theme_data, $theme_stylesheet, $locales );

Where the hook is used in WordPress