wpseek.com
A WordPress-centric search engine for devs and theme authors



wp_dropdown_roles › WordPress Function

Since2.1.0
Deprecatedn/a
› wp_dropdown_roles ( $selected = '', $editable_roles = null )
Parameters: (2)
  • (string) $selected Slug for the role that should be already selected.
    Required: No
    Default: (empty)
  • (array) $editable_roles Array of roles to include in the dropdown. Defaults to all roles the current user is allowed to edit.
    Required: No
    Default: null
Defined at:
Codex:
Change Log:
  • 7.0.0

Prints out option HTML elements for role selectors.



Related Functions: wp_dropdown_pages, wp_dropdown_cats, wp_dropdown_languages, wp_dropdown_categories, wp_dropdown_users

Source 

function wp_dropdown_roles( $selected = '', $editable_roles = null ) {
	$r = '';

	if ( null === $editable_roles ) {
		$editable_roles = array_reverse( get_editable_roles() );
	}

	foreach ( $editable_roles as $role => $details ) {
		$name = translate_user_role( $details['name'] );
		// Preselect specified role.
		if ( $selected === $role ) {
			$r .= "\n\t<option selected='selected' value='" . esc_attr( $role ) . "'>$name</option>";
		} else {
			$r .= "\n\t<option value='" . esc_attr( $role ) . "'>$name</option>";
		}
	}

	echo $r;
}