Pense-bête technique Wordpress

WordPress 3.1 : Utiliser l’API des users

Nous avons « enfin » une API dans la version 3.1 de WordPress pour gérer les utilisateurs, certes pas forcément évolué mais surement très évolutive.

Celle-ci reprend le même système que le get_posts avec « get_users« . Ainsi comme get_posts utilise la classe WP_Query, get_users utilise la classe WP_User_Query.

Le tableau d’arguments que prend la fonction « get_users » et la classe « WP_User_Query » est celui ci dessous:

• ‘blog_id’ : Id du blog (valide qu’en multisite)(integer),
• ‘role’ : rôle des utilisateurs(string),
• ‘meta_key‘ : clé du champ méta (string),
• ‘meta_value‘ : valeur du champ méta(string),
• ‘meta_compare’ : opérateur de comparaison du champ méta(string),
• ‘include‘ : tableau de user id à inclure (array),
• ‘exclude‘ : tableau de user id à exclure (array),
• ‘search’ : chaine de caractère à chercher dans les users (string),
• ‘orderby’ : champ utiliser pour le tri(string),
• ‘order’ : ‘ASC’ ou ‘DESC’,
• ‘offset’ : nombre de user à passer avant affichage(int),
• ‘number’ : nombre de user à retourner(int),
• ‘count_total’ : retourne de nombre d’utilisateur (boolean),
• ‘fields’ (string // ‘all’),

Vous pouvez donc récupérer la liste des utilisateurs du site par rôle, par clé, etc. Cette fonction était jusqu’alors inexistante sur la version 3.0 ou antérieur de WordPress. La seule façon était de récupérer la liste avec un get_users_of_blog() et faire le filtrage via PHP.

Cette fonction retourne un tableau d’objets de type user.

Tester si l’utilisateur est loggué ou pas

Pour tester si l’internaute est loggué, utilisez cette fonction dans un test:

is_user_logged_in()

Search