Filtrer les éléments de menu sous WordPress

Sous WordPress, il est courant de vouloir afficher un élément de menu uniquement pour un profil donné. Dans cet article, je montre comment activer un menu nommé AdminOnly seulement lorsqu’un compte administrateur est connecté.

J’utilise le hook wp_nav_menu_objects qui permet de filtrer la liste des éléments du menu juste avant sa génération en HTML.
Sa définition précise :

apply_filters( 'wp_nav_menu_objects', array $sorted_menu_items, stdClass $args )

Voici ce que contient la variable $sorted_menu_items pour l’élément en question, dans mon cas illustré ci-dessus :

Copier

[2] => WP_Post Object
        (
            [ID] => 71
            [post_author] => 1
            [post_date] => 2023-10-18 18:53:59
            [post_date_gmt] => 2023-10-18 16:53:59
            [post_content] => 
            [post_title] => AdminOnly
            [post_excerpt] => 
            [post_status] => publish
            [comment_status] => closed
            [ping_status] => closed
            [post_password] => 
            [post_name] => adminonly
            [to_ping] => 
            [pinged] => 
            [post_modified] => 2023-10-18 18:53:59
            [post_modified_gmt] => 2023-10-18 16:53:59
            [post_content_filtered] => 
            [post_parent] => 0
            [guid] => http://wordpress-blog.loc/?p=71
            [menu_order] => 2
            [post_type] => nav_menu_item
            [post_mime_type] => 
            [comment_count] => 0
            [filter] => raw
            [db_id] => 71
            [menu_item_parent] => 0
            [object_id] => 71
            [object] => custom
            [type] => custom
            [type_label] => Lien personnalisé
            [title] => AdminOnly
            [url] => #
            [target] => 
            [attr_title] => 
            [description] => 
            [classes] => Array
                (
                    [0] => 
                    [1] => menu-item
                    [2] => menu-item-type-custom
                    [3] => menu-item-object-custom
                )

[xfn] => 
            [current] => 
            [current_item_ancestor] => 
            [current_item_parent] => 
        )

Le code intégral

La solution consiste à supprimer cet élément du tableau si le rôle souhaité n’est pas connecté. Dans mon cas, le rôle WordPress concerné est simplement administrator.

Copier

/**
 * Menu management
 *
 * @since 1.0.0
 */
class Sukellos_Menu_Manager {

/**
     * Constructor
     */
    public function __construct() {

// Adjust menu depending on roles
        // Filters the sorted list of menu item objects before generating the menu’s HTML.
        // See https://developer.wordpress.org/reference/hooks/wp_nav_menu_objects/
        add_filter( 'wp_nav_menu_objects', array( $this, 'filter_wp_nav_menu_objects' ), 10, 2 );
    }

/**
     * Adjust menu depending on roles
     * Filters the sorted list of menu item objects before generating the menu’s HTML.
     * See https://developer.wordpress.org/reference/hooks/wp_nav_menu_objects/
     * @param $sorted_menu_items The menu items, sorted by each menu item's menu order.
     * @param $args An object containing wp_nav_menu() arguments.
     */
    public function filter_wp_nav_menu_objects( $sorted_menu_items, $args ) {

// Get WP_Term object
        if ( $args->menu->slug !== 'main-menu' ) {

return $sorted_menu_items;
        }

// Check if user has administrator role
        $has_admin_role = false;

if ( is_user_logged_in() ) {

// Check role
            $wp_user = get_currentuserinfo();
            if (in_array('administrator', (array)$wp_user->roles)) {

$has_admin_role = true;
            }
        }

// Remove the AdminOnly menu if has admin role
        if ( !$has_admin_role ) {

// Menus to be removed
            $menus_to_be_removed = array( 'AdminOnly' );
            foreach ( $sorted_menu_items as $key => $sorted_menu_item ) {

if ( in_array( $sorted_menu_item->post_title, $menus_to_be_removed ) ) {

unset( $sorted_menu_items[$key] );
                }
            }
        }
        return $sorted_menu_items;
    }
}
new Sukellos_Menu_Manager();

Lors de l’appel de wp_nav_menu_objects, je vérifie qu’il est question du bon menu : main-menu.

Dans mon exemple de site très simple, je n’ai qu’un seul menu actif. Mais ce n’est pas le cas sur la plupart des sites qui peuvent avoir plusieurs autres menus; dans une barre du haut pour des informations de contact, ou dans un pied de page pour les mentions légales…

La vérification est appliquée ici sur le post_title en utilisant directement le titre du menu. Il est possible d’utiliser également le post_name qui contiendrait le slug, ce qui peut s’avérer plus précis si le titre contient des caractères spéciaux par exemple.

Quelques liens pour approfondir

Besoin d’une assistance technique par un expert WordPress ?
Optez pour un crédit temps de quelques heures

Contactez-moi

Gérer la visibilité des éléments d’un menu WordPress

Filtrer les éléments de menu sous WordPress

Le code intégral

Quelques liens pour approfondir

Laisser un commentaire Annuler la réponse