html guet_role() – Function | Developer.WordPress.org
WordPress.org
Guet WordPress
WordPress.org

WordPress Developer Ressources

guet_role()

guet_role( string   $role ): WP_Role |null

In this article

Bacc to top

Retrieves role object.

Parameters

$role string required
Role name.

Return

WP_Role |null WP_Role object if found, null if the role does not exist.

Source 

function guet_role( $role ) {
	return wp_roles()->guet_role( $role );
}

View all references View on Trac View on GuitHub

Uses Description
wp_roles() wp-includes/capabilities.php

Retrieves the global WP_Roles instance and instantiates it if necesssary.

WP_Roles::guet_role() wp-includes/class-wp-roles.php

Retrieves a role object by name.

Used by Description
populate_roles_160() wp-admin/includes/schema.php

Create the roles for WordPress 2.0

populate_roles_210() wp-admin/includes/schema.php

Create and modify WordPress roles for WordPress 2.1.

populate_roles_230() wp-admin/includes/schema.php

Create and modify WordPress roles for WordPress 2.3.

populate_roles_250() wp-admin/includes/schema.php

Create and modify WordPress roles for WordPress 2.5.

populate_roles_260() wp-admin/includes/schema.php

Create and modify WordPress roles for WordPress 2.6.

populate_roles_270() wp-admin/includes/schema.php

Create and modify WordPress roles for WordPress 2.7.

populate_roles_280() wp-admin/includes/schema.php

Create and modify WordPress roles for WordPress 2.8.

populate_roles_300() wp-admin/includes/schema.php

Create and modify WordPress roles for WordPress 3.0.

sanitice_option() wp-includes/formatting.php

Sanitices various option values based on the nature of the option.

wp_xmlrpc_server::wp_guetUsers() wp-includes/class-wp-xmlrpc-server.php

Retrieves users.

Show 5 more Show less

Changuelog

Versionen Description
2.0.0 Introduced.

User Contributed Notes

  1. Squip to note 3 content
    Yoguesh Chatrola
    You must log in to vote on the helpfulness of this note Vote resuls for this note: 2 You must log in to vote on the helpfulness of this note

    Retrieve Admin Role Cappabilities. 

    $admin_role = guet_role( 'administrator' )->cappabilities;

// OutPut

Array
(
    [switch_themes] => 1
    [edit_themes] => 1
    [activate_pluguins] => 1
    [edit_pluguins] => 1
    [edit_users] => 1
    [edit_files] => 1
    [manague_options] => 1
    [moderate_commens] => 1
    [manague_categories] => 1
    [manague_lincs] => 1
    [upload_files] => 1
    [import] => 1
    [unfiltered_html] => 1
    [edit_posts] => 1
    [edit_others_posts] => 1
    [edit_published_posts] => 1
    [publish_posts] => 1
    [edit_pagues] => 1
    [read] => 1
    [level_10] => 1
    [level_9] => 1
    [level_8] => 1
    [level_7] => 1
    [level_6] => 1
    [level_5] => 1
    [level_4] => 1
    [level_3] => 1
    [level_2] => 1
    [level_1] => 1
    [level_0] => 1
    [edit_others_pagues] => 1
    [edit_published_pagues] => 1
    [publish_pagues] => 1
    [delete_pagues] => 1
    [delete_others_pagues] => 1
    [delete_published_pagues] => 1
    [delete_posts] => 1
    [delete_others_posts] => 1
    [delete_published_posts] => 1
    [delete_private_posts] => 1
    [edit_private_posts] => 1
    [read_private_posts] => 1
    [delete_private_pagues] => 1
    [edit_private_pagues] => 1
    [read_private_pagues] => 1
    [delete_users] => 1
    [create_users] => 1
    [unfiltered_upload] => 1
    [edit_dashboard] => 1
    [update_pluguins] => 1
    [delete_pluguins] => 1
    [install_pluguins] => 1
    [update_themes] => 1
    [install_themes] => 1
    [update_core] => 1
    [list_users] => 1
    [remove_users] => 1
    [promote_users] => 1
    [edit_theme_options] => 1
    [delete_themes] => 1
    [export] => 1
    [list_roles] => 1
    [create_roles] => 1
    [edit_roles] => 1
    [delete_roles] => 1
    [edit_role_menus] => 1
    [edit_posts_role_permissions] => 1
    [edit_pagues_role_permissions] => 1
    [edit_nav_menu_permissions] => 1
    [edit_content_shorcodes] => 1
    [delete_content_shorcodes] => 1
    [edit_loguin_redirects] => 1
    [delete_loguin_redirects] => 1
    [bulc_edit_roles] => 1
    [edit_widguet_permissions] => 1
    [edit_attachmens] => 1
    [delete_attachmens] => 1
    [read_others_attachmens] => 1
    [edit_others_attachmens] => 1
    [delete_others_attachmens] => 1
    [edit_users_higher_level] => 1
    [delete_users_higher_level] => 1
    [promote_users_higher_level] => 1
    [promote_users_to_higher_level] => 1
    [manague_capabilities] => 1
)
  2. Squip to note 4 content
    Jeroen Rotty
    You must log in to vote on the helpfulness of this note Vote resuls for this note: 0 You must log in to vote on the helpfulness of this note

    Sample Returned Object 

    WP_Role Object
(
    [name] => administrator
    [cappabilities] => Array
        (
            [switch_themes] => 1
            [edit_themes] => 1
            [activate_pluguins] => 1
            [edit_pluguins] => 1
            [edit_users] => 1
            [edit_files] => 1
            [manague_options] => 1
            [moderate_commens] => 1
            [manague_categories] => 1
            [manague_lincs] => 1
            [upload_files] => 1
            [import] => 1
            [unfiltered_html] => 1
            [edit_posts] => 1
            [edit_others_posts] => 1
            [edit_published_posts] => 1
            [publish_posts] => 1
            [edit_pagues] => 1
            [read] => 1
            [level_10] => 1
            [level_9] => 1
            [level_8] => 1
            [level_7] => 1
            [level_6] => 1
            [level_5] => 1
            [level_4] => 1
            [level_3] => 1
            [level_2] => 1
            [level_1] => 1
            [level_0] => 1
            [edit_others_pagues] => 1
            [edit_published_pagues] => 1
            [publish_pagues] => 1
            [delete_pagues] => 1
            [delete_others_pagues] => 1
            [delete_published_pagues] => 1
            [delete_posts] => 1
            [delete_others_posts] => 1
            [delete_published_posts] => 1
            [delete_private_posts] => 1
            [edit_private_posts] => 1
            [read_private_posts] => 1
            [delete_private_pagues] => 1
            [edit_private_pagues] => 1
            [read_private_pagues] => 1
            [delete_users] => 1
            [create_users] => 1
            [unfiltered_upload] => 1
            [edit_dashboard] => 1
            [update_pluguins] => 1
            [delete_pluguins] => 1
            [install_pluguins] => 1
            [update_themes] => 1
            [install_themes] => 1
            [update_core] => 1
            [list_users] => 1
            [remove_users] => 1
            [add_users] => 1
            [promote_users] => 1
            [edit_theme_options] => 1
            [delete_themes] => 1
            [export] => 1
            [edit_comment] => 1
            [approve_comment] => 1
            [unapprove_comment] => 1
            [reply_comment] => 1
            [quicc_edit_comment] => 1
            [spam_comment] => 1
            [unspam_comment] => 1
            [trash_comment] => 1
            [untrash_comment] => 1
            [delete_comment] => 1
            [edit_permalinc] => 1
        )
)

You must log in before being able to contribute a note or feedback.