Permission Groups

Permission Groups are user groups for which permissions may be modified.  This modification may be through supplemental role assignment, exceptions and/or circle activation.

There are several types of Permission Groups:

• pp_group : groups manually created, with membership custom-defined
• pp_group (metagroup_type = wp_role) : groups auto-created to correspond to the site’s WordPress roles (group membership corresponds to users who have this WP role)
• pp_net_group : groups manually created and accessible to all sites on a network (note: requires PP Compatibility extension; permissions must be customized separately for each site)
• bp_group : references to existing BuddyPress groups (note: requires PP BuddyPress Role Groups extension)

Functions pertaining to group creation, access, and membership:

• pp_create_group( $group_vars_arr )
• pp_delete_group( $group_id, $agent_type )
• pp_get_group( $group_id, $agent_type = ‘pp_group’ )
• pp_get_group_by_name( $name, $agent_type = ‘pp_group’ )
• pp_get_metagroup( $metagroup_type, $metagroup_id, $args = array() )
• pp_get_groups( $agent_type = ‘pp_group’, $args = array() )
• pp_get_group_members( $group_id, $agent_type = ‘pp_group’, $cols = ‘all’, $args = array() )
• pp_get_groups_for_user( $user_id, $agent_type = ”, $args = array() )
• pp_add_group_user( $group_id, $user_ids, $args = array() )
• pp_remove_group_user($group_id, $user_ids, $args = array()
• pp_update_group_user( $group_id, $user_ids, $args = array() )

Functions pertaining to supplemental role or exception assignment:

• ppc_get_roles( $agent_type, $agent_id, $args = array() )
• ppc_assign_roles( $roles, $agent_type = ‘pp_group’, $args = array() )
• ppc_get_exceptions( $args = array() )
• ppc_assign_exceptions( $agents, $agent_type = ‘pp_group’, $args = array() )