vendredi 25 septembre 2026

À propos

Contact

Lexique · Administration & contenus

Écran d’options

En anglais : « Screen options »

Panneau déroulant présent en haut de nombreux écrans d'administration, permettant à chaque utilisateur d'ajuster l'affichage sans intervention du développeur.

Repliable dans un coin, souvent ignoré des débutants, ce petit onglet mérite pourtant d’être connu : il donne à chaque utilisateur la main sur ce qu’il voit, sans toucher au code ni aux réglages globaux du site.

Ce qu’il permet et comment l’alimenter

Sur la liste des articles, il permet de cocher ou décocher les colonnes visibles et de définir le nombre d’éléments affichés par page. Sur l’écran d’édition, il propose d’afficher ou masquer certaines boîtes meta. Ces réglages sont propres à chaque utilisateur : ils sont stockés en tant que métadonnée utilisateur, par exemple manageedit-postcolumnshidden.

Un développeur peut ajouter sa propre option à ce panneau grâce au filtre screen_settings, ou définir un nombre d’éléments par page personnalisé avec set_screen_options() combiné au filtre set-screen-option (devenu screen_settings dans les versions récentes pour la partie affichage).

Exemple : nombre d’éléments par page pour un type personnalisé

<?php
add_filter( 'screen_options_show_screen', '__return_true' );
add_filter( 'manage_produit_posts_per_page', function ( $per_page ) {
    return get_user_option( 'produit_per_page' ) ?: 20;
} );

Pièges fréquents

  • Le panneau n’apparaît que sur les écrans qui l’implémentent explicitement via l’objet WP_Screen : ajouter une page d’administration personnalisée sans s’y raccorder ne le fait pas apparaître automatiquement.
  • Les préférences choisies ici ne sont pas partagées entre utilisateurs : un contributeur et un administrateur peuvent voir des colonnes différentes sur le même écran.
  • Ne confondez pas ce panneau avec un écran de réglages classique : il ne modifie jamais la configuration du site, seulement le confort d’affichage de la personne connectée.