wpseek.com
Eine auf WordPress spezialiserte Suchmaschine für Entwickler und Theme-Autoren



add_role › WordPress Function

Seit
Veraltetn/v
› add_role ( $role, $display_name, $capabilities = array() )
Parameter: (3)
  • (string) $role Role name.
    Erforderlich: Ja
  • (string) $display_name Display name for role.
    Erforderlich: Ja
  • (array<string,bool>|array<int,string>) $capabilities Capabilities to be added to the role. Default empty array.
    Erforderlich: Nein
    Standard: array()
Gibt zurück:
  • (WP_Role|void) WP_Role object, if the role is added.
Definiert in:
Codex:
Changelog:
  • 2.0.0

Adds a role, if it does not exist.

The list of capabilities can be passed either as a numerically indexed array of capability names, or an associative array of boolean values keyed by the capability name. To explicitly deny the role a capability, set the value for that capability to false. Examples: // Add a role that can edit posts. add_role( 'custom_role', 'Custom Role', array( 'read', 'edit_posts', ) ); Or, using an associative array: // Add a role that can edit posts but explicitly cannot not delete them. add_role( 'custom_role', 'Custom Role', array( 'read' => true, 'edit_posts' => true, 'delete_posts' => false, ) );


Ähnliche Funktionen: add_filter, wp_roles, get_role, add_feed, add_link

Quellcode 

function add_role( $role, $display_name, $capabilities = array() ) {
	if ( empty( $role ) ) {
		return;
	}

	return wp_roles()->add_role( $role, $display_name, $capabilities );
}