do_action( 'after_switch_theme', string $old_name, WP_Theme $old_theme )

Le hook after_switch_theme se lance au premier chargement de WordPress après un changement de thème si l'ancien thème existe encore.

Paramètres

$old_name(string)

Nom de l'ancien thème

$old_theme(WP_Theme)

Instance de l'ancien thème

Description / Informations supplémentaires

Cette action se lance plusieurs fois et les paramètres diffèrent en s'accordant au contexte, si l'ancien thème existe ou pas. Si l'ancien thème est manquant, le paramètre sera le slug de l'ancien thème.

Application du hook after_switch_theme

Le hook after_switch_theme est appliqué dans le fichier wp-includes/theme.php :

à la ligne 3504 :

do_action( 'after_switch_theme', $old_theme->get( 'Name' ), $old_theme );

et à la ligne 3507 :

do_action( 'after_switch_theme', $stylesheet, $old_theme );
check_theme_switched()

Vérifie si un thème a été modifié et exécute le hook after_switch_theme lors du prochain chargement de WordPress.

Où est utilisé le hook after_switch_theme dans le CMS WordPress

Exemple

Mettre à jour la taille par défaut d'une image medium quand un nouveau thème est activé
function maj_default_image_size( $old_theme_name, $old_theme = false ) {
    update_option( 'medium_size_w', 800 );
    update_option( 'medium_size_h', 400 );
}
add_action( 'after_switch_theme', 'maj_default_image_size', 10, 2 );

Sources

Codex WordPress : after_switch_theme

Autres hooks dans le même fichier : wp-includes/theme.php

Retour