WordPress at a glance

get_editable_roles() WP 1.0

Fetch a filtered list of user roles that the current user is allowed to edit.

Simple function whose main purpose is to allow filtering of the list of roles in the $wp_roles object so that plugins can remove inappropriate ones depending on the situation or user making edits. Specifically because without filtering anyone with the edit_users capability can edit others to be administrators, even if they are only editors or authors. This filter allows admins to delegate user management.

Is the basis for: wp_dropdown_roles()
Works based on: wp_roles()
✈ 1 time = 0.000358s = fast | 50000 times = 8.56s = fast | PHP 7.0.32, WP 5.1
Hooks from the function
Return

Array[]. Array of arrays containing role information.

Usage

get_editable_roles();

Changelog

Since 2.8.0 Introduced.

Code of get editable roles: wp-admin/includes/user.php WP 5.2.2

<?php
function get_editable_roles() {
	$all_roles = wp_roles()->roles;

	/**
	 * Filters the list of editable roles.
	 *
	 * @since 2.8.0
	 *
	 * @param array[] $all_roles Array of arrays containing role information.
	 */
	$editable_roles = apply_filters( 'editable_roles', $all_roles );

	return $editable_roles;
}

Related Functions

From tag: Roles capabilities

More from category: Other

No comments
    Hello, !     Log In . Register