install_theme_complete_actions │ filter-hook │ WP 2.8.0

Filters the list of action links available following a single theme installation.

Usage

add_filter( 'install_theme_complete_actions', 'wp_kama_install_theme_complete_actions_filter', 10, 4 );

/**
 * Function for `install_theme_complete_actions` filter-hook.
 * 
 * @param string[] $install_actions Array of theme action links.
 * @param object   $api             Object containing WordPress.org API theme data.
 * @param string   $stylesheet      Theme directory name.
 * @param WP_Theme $theme_info      Theme object.
 *
 * @return string[]
 */
function wp_kama_install_theme_complete_actions_filter( $install_actions, $api, $stylesheet, $theme_info ){

	// filter...
	return $install_actions;
}

$install_actions(string[])

Array of theme action links.

$api(object)

Object containing WordPress.org API theme data.

$stylesheet(string)

Theme directory name.

$theme_info(WP_Theme)

Theme object.

Changelog

Where the hook is called

$install_actions = apply_filters( 'install_theme_complete_actions', $install_actions, $this->api, $stylesheet, $theme_info );

Where the hook is used in WordPress

add_filter( 'install_theme_complete_actions', array( $this, 'hide_activate_preview_actions' ) );

add_filter( 'install_theme_complete_actions', '__return_false', 999 ); // Don't show any actions after installing the theme.

add_filter( 'install_theme_complete_actions', array( $this, 'hide_activate_preview_actions' ) );

remove_filter( 'install_theme_complete_actions', '__return_false', 999 );