Comment masquer les aides de WP Rocket ?

L’interface des options de WP Rocket est riche en information, aide et conseils. Aussi, vous connaissez peut-être ces aides par cœur et souhaiteriez les masquer ?

Merci les hooks

WP Rocket inclus beaucoup de hooks vous permettant d’intervenir un peu par partout. Nous avons souhaité garder une grande flexibilité comme WordPress l’offre et cela même dans un plugin de type « premium ».

Le hook qui nous intéresse ici est rocket_help. Il contient 3 paramètres :

• $description qui sera l’aide à afficher.
• $name qui est le nom de cet aide qui est comme un ID.
• $context qui indique dans quel type d’aide on se trouve.

Les 3 contextes ont chacun un rôle différent :

• description : indique à quoi sert cette option.
• help : indique comment on se sert de cette option.
• warning : indique si l’option peut poser des problèmes ou insiste sur un point important de son paramétrage.

Grâce au contexte, il est possible d’afficher que les descriptions, que les aides, que les avertissements, ou 2 d’entre eux, bref à vous de choisir. Et comme l’indique le titre de cet astuce, vous pouvez aussi tout masquer.

Vous pourriez aussi modifier ou supprimer les descriptions selon leur nom. Par exemple, pour ajouter plus de détails sur une option pour un client.

Comment faire pour masquer les aides ?

Pour cela, nous avons besoin de modifier le fichier functions.php de votre thème enfant (évitez de modifier celui du thème parent) ou de créer un mu-plugin.

Voici quelques exemples possibles :

Masquer les descriptions

add_filter( 'rocket_help', 'hide_rocket_desc', 10, 3 );
function hide_rocket_desc( $description, $name, $context )
{
	if ( 'description' == $context ) {
		return '';
	}
	return $description;
}

Masquer les aides

add_filter( 'rocket_help', 'hide_rocket_help', 10, 3 );
function hide_rocket_help( $description, $name, $context )
{
	if ( 'help' == $context ) {
		return '';
	}
	return $description;
}

Masquer les avertissements

add_filter( 'rocket_help', 'hide_rocket_warning', 10, 3 );
function hide_rocket_warning( $description, $name, $context )
{
	if ( 'warning' == $context ) {
		return '';
	}
	return $description;
}

Masquer toutes les aides

add_filter( 'rocket_help', '__return_false', 11 );

Modifier la description de l’option « lazyload »

add_filter( 'rocket_help', 'change_rocket_desc', 10, 3 );
function change_rocket_desc( $description, $name, $context )
{
	if ( 'lazyload' == $name ) {
		return '<em>Merci de laisser cette option active.</em>';
	}
	return $description;
}

Vous trouverez le nom de l’option en inspectant le tag HTML en question, démo :

Démonstration en images

Pour conclure cet article, voici un comparatif avant/après où nous avons tout masqué.