WP_User

Définition : WP_User est la classe du Core qui représente un utilisateur WordPress et fournit l’accès à ses propriétés, rôles et capacités. Elle intervient dans l’authentification, les contrôles d’accès et la gestion des comptes.

Terminologie

Appellation officielle : WP_User

Autres appellations : Objet utilisateur, Classe utilisateur WordPress

Comprendre le fonctionnement

L’objet WP_User identifie un compte et expose ses caractéristiques utiles aux traitements WordPress : identifiant, nom affiché, données utilisateur et capacités calculées en fonction des rôles et du site concerné. Dans une installation multisite, le contexte du site compte pour l’évaluation des autorisations. La classe n’est pas une preuve qu’une action est permise : la capacité demandée doit être évaluée.

Lorsqu’une extension doit savoir si une personne peut modifier un contenu, la vérification d’autorisation ne doit pas reposer sur un nom de rôle affiché ou un champ descriptif. Les fonctions current_user_can() et user_can() sont généralement adaptées au contrôle des capacités. Les propriétés potentiellement privées, comme l’adresse électronique, ne doivent pas être exposées sans motif et autorisation.

Exemple concret

Une interface réservée aux gestionnaires vérifie les capacités avant de proposer une action administrative.

Exemple de code commenté

<?php
// Vérifier les droits dans un contexte chargé par WordPress.
if ( current_user_can( 'manage_options' ) ) {
    echo '<p>' . esc_html__( 'Accès autorisé.', 'default' ) . '</p>';
}