members_register_default_roles

The members members register default roles function.

Published Date - July 31, 2023

Description

Registers any roles stored globally with WordPress.

members_register_default_roles( $wp_roles );

Parameters

1. $wp_roles

---

Usage

The following example is for adding a hook callback.

if ( !function_exists( 'members_register_default_roles' ) ) {
    require_once ABSPATH . PLUGINDIR . 'membersmembers/inc/functions-roles.php';
}

// The input(s). 
$wp_roles = null;

// NOTICE! Understand what this does before running.
$result = members_register_default_roles( $wp_roles );
            

Defined

The function is defined in the following location(s).

members/inc/functions-roles.php

function members_register_default_roles( $wp_roles ) {

	foreach ( $wp_roles->roles as $name => $object ) {

		$args = array(
			'label' => $object['name'],
			'caps'  => $object['capabilities']
		);

		members_register_role( $name, $args );
	}

	// Unset any roles that were registered previously but are not currently available.
	foreach ( members_get_roles() as $role ) {

		if ( ! isset( $wp_roles->roles[ $role->name ] ) )
			members_unregister_role( $role->name );
	}
}

---