Description

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.

Paramètre

$classes

(string) Liste de classes CSS séparées par des espaces.

Où trouver le hook admin_body_class dans le CMS Wordpress

wp-admin/nav-menus.php

Ligne 526

}

add_filter( 'admin_body_class', 'wp_nav_menu_max_depth' );

wp_nav_menu_setup();

wp-admin/admin-header.php

Ligne 221

 * @param string $classes Space-separated list of CSS classes.
 */
$admin_body_classes = apply_filters( 'admin_body_class', '' );
$admin_body_classes = ltrim( $admin_body_classes . ' ' . $admin_body_class );
?>
<body class="wp-admin wp-core-ui no-js <?php echo $admin_body_classes; ?>">

wp-admin/widgets.php

Ligne 32

if ( 'on' == $widgets_access ) {
    add_filter( 'admin_body_class', 'wp_widgets_access_body_class' );
} else {

wp-admin/includes/class-wp-site-health.php

Ligne 31

        add_filter( 'admin_body_class', array( $this, 'admin_body_class' ) );

wp-admin/includes/template.php

Ligne 1959

    <?php
    /** This filter is documented in wp-admin/admin-header.php */
    $admin_body_classes = apply_filters( 'admin_body_class', '' );
    $admin_body_classes = ltrim( $admin_body_classes . ' ' . $admin_body_class );

Exemple

Ajouter des espaces à gauche et à droite de la liste de classes prévient les accidents de concaténation des classes appoté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

Source Wordpress : admin_body_class

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