wp_ensure_editable_role( string $role )

Parameters

$rolestring

Role the user is attempting to assign.

Uses · 3

• get_editable_roles()Fetch a filtered list of user roles that the current user is allowed to edit.
• wp_die()Kills WordPress execution and displays HTML page with an error message.
• __()Retrieves the translation of $text.

Source

View on Trac ↗View on GitHub ↗

1181function wp_ensure_editable_role( $role ) {1182	$roles = get_editable_roles();1183	if ( ! isset( $roles[ $role ] ) ) {1184		wp_die( __( 'Sorry, you are not allowed to give users that role.' ), 403 );1185	}1186}

History

Introduced in 6.8.0. Unchanged from 6.8.8 through 7.1.0.

1. 6.8.8
2. 6.9.7
3. 7.0.4
4. 7.1.0

Signature, return type and hooks compared across 4 parsed releases.

About this page

Parsed data

Generated from the wordpress-develop 7.0.4 tag, from src/wp-admin/includes/ms.php, and regenerated for each WordPress release so it tracks the code rather than a snapshot of it.

Corrections

Something wrong on this page? Report it and it gets fixed in the next regeneration.