apply_filters( 'admin_body_class', string $classes )

Filtre les classes css de la balise HTML body de l'administration Wordpress.

Paramètre

$classes(string)

Liste de classes CSS séparées par des espaces.

Description / Informations supplémentaires

Ce filtre diffère des filtres 'post_class' et 'body_class' :

  • Le paramètre $classes est une chaîne où les classes sont séparées par des espaces au lieu d'un tableau.
  • Peut rajouter des classes mais pas en supprimer.

Application du hook admin_body_class

Le hook admin_body_class est appliqué dans le fichier wp-admin/admin-header.php à la ligne 242 :

$admin_body_classes = apply_filters( 'admin_body_class', '' );

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

Exemple

Ajouter des espaces à gauche et à droite de la liste de classes prévient les accidents de concaténation des classes apportées par différents plugins :
function admin_body_class( $classes ) {
    // Mauvais : pas d'espace en fin et début.
    $classes .= 'ma-class1 ma-class2';
 
    // Bon : Ajouter un espace au début et à la fin.
    $classes .= ' ma-class1 ma-class2 ';
 
    return $classes;
}

Sources

Codex WordPress : admin_body_class

Autres hooks dans le même fichier : wp-admin/admin-header.php

Retour