BP_Groups_Component::setup_nav( array $main_nav = array(), array $sub_nav = array() )
Set up component navigation.
Description Description
See also See also
- BP_Component::setup_nav(): for a description of arguments.
Parameters Parameters
- $main_nav
-
(Optional) See BP_Component::setup_nav() for description.
Default value: array()
- $sub_nav
-
(Optional) See BP_Component::setup_nav() for description.
Default value: array()
Source Source
File: bp-groups/classes/class-bp-groups-component.php
public function setup_nav( $main_nav = array(), $sub_nav = array() ) {
// Determine user to use.
if ( bp_displayed_user_domain() ) {
$user_domain = bp_displayed_user_domain();
} elseif ( bp_loggedin_user_domain() ) {
$user_domain = bp_loggedin_user_domain();
} else {
$user_domain = false;
}
// Only grab count if we're on a user page.
if ( bp_is_user() ) {
$class = ( 0 === groups_total_groups_for_user( bp_displayed_user_id() ) ) ? 'no-count' : 'count';
$nav_name = sprintf(
/* translators: %s: Group count for the current user */
_x( 'Groups %s', 'Group screen nav with counter', 'buddypress' ),
sprintf(
'<span class="%s">%s</span>',
esc_attr( $class ),
bp_get_total_group_count_for_user()
)
);
} else {
$nav_name = _x( 'Groups', 'Group screen nav without counter', 'buddypress' );
}
$slug = bp_get_groups_slug();
// Add 'Groups' to the main navigation.
$main_nav = array(
'name' => $nav_name,
'slug' => $slug,
'position' => 70,
'screen_function' => 'groups_screen_my_groups',
'default_subnav_slug' => 'my-groups',
'item_css_id' => $this->id
);
if ( ! empty( $user_domain ) ) {
$access = bp_core_can_edit_settings();
$groups_link = trailingslashit( $user_domain . $slug );
// Add the My Groups nav item.
$sub_nav[] = array(
'name' => __( 'Memberships', 'buddypress' ),
'slug' => 'my-groups',
'parent_url' => $groups_link,
'parent_slug' => $slug,
'screen_function' => 'groups_screen_my_groups',
'position' => 10,
'item_css_id' => 'groups-my-groups'
);
// Add the Group Invites nav item.
$sub_nav[] = array(
'name' => __( 'Invitations', 'buddypress' ),
'slug' => 'invites',
'parent_url' => $groups_link,
'parent_slug' => $slug,
'screen_function' => 'groups_screen_group_invites',
'user_has_access' => $access,
'position' => 30
);
parent::setup_nav( $main_nav, $sub_nav );
}
if ( bp_is_groups_component() && bp_is_single_item() ) {
// Reset sub nav.
$sub_nav = array();
/*
* The top-level Groups item is called 'Memberships' for legacy reasons.
* It does not appear in the interface.
*/
bp_core_new_nav_item( array(
'name' => __( 'Memberships', 'buddypress' ),
'slug' => $this->current_group->slug,
'position' => -1, // Do not show in BuddyBar.
'screen_function' => 'groups_screen_group_home',
'default_subnav_slug' => $this->default_extension,
'item_css_id' => $this->id
), 'groups' );
$group_link = bp_get_group_permalink( $this->current_group );
// Add the "Home" subnav item, as this will always be present.
$sub_nav[] = array(
'name' => _x( 'Home', 'Group screen navigation title', 'buddypress' ),
'slug' => 'home',
'parent_url' => $group_link,
'parent_slug' => $this->current_group->slug,
'screen_function' => 'groups_screen_group_home',
'position' => 10,
'item_css_id' => 'home'
);
// If this is a private group, and the user is not a
// member and does not have an outstanding invitation,
// show a "Request Membership" nav item.
if ( bp_current_user_can( 'groups_request_membership', array( 'group_id' => $this->current_group->id ) ) ) {
$sub_nav[] = array(
'name' => _x( 'Request Membership','Group screen nav', 'buddypress' ),
'slug' => 'request-membership',
'parent_url' => $group_link,
'parent_slug' => $this->current_group->slug,
'screen_function' => 'groups_screen_group_request_membership',
'position' => 30
);
}
if ( $this->current_group->front_template || bp_is_active( 'activity' ) ) {
/**
* If the theme is using a custom front, create activity subnav.
*/
if ( $this->current_group->front_template && bp_is_active( 'activity' ) ) {
$sub_nav[] = array(
'name' => _x( 'Activity', 'My Group screen nav', 'buddypress' ),
'slug' => 'activity',
'parent_url' => $group_link,
'parent_slug' => $this->current_group->slug,
'screen_function' => 'groups_screen_group_activity',
'position' => 11,
'user_has_access' => $this->current_group->user_has_access,
'item_css_id' => 'activity',
'no_access_url' => $group_link,
);
}
/**
* Only add the members subnav if it's not the home's nav.
*/
$sub_nav[] = array(
'name' => sprintf( _x( 'Members %s', 'My Group screen nav', 'buddypress' ), '<span>' . number_format( $this->current_group->total_member_count ) . '</span>' ),
'slug' => 'members',
'parent_url' => $group_link,
'parent_slug' => $this->current_group->slug,
'screen_function' => 'groups_screen_group_members',
'position' => 60,
'user_has_access' => $this->current_group->user_has_access,
'item_css_id' => 'members',
'no_access_url' => $group_link,
);
}
if ( bp_is_active( 'friends' ) && bp_groups_user_can_send_invites() ) {
$sub_nav[] = array(
'name' => _x( 'Send Invites', 'My Group screen nav', 'buddypress' ),
'slug' => 'send-invites',
'parent_url' => $group_link,
'parent_slug' => $this->current_group->slug,
'screen_function' => 'groups_screen_group_invite',
'item_css_id' => 'invite',
'position' => 70,
'user_has_access' => $this->current_group->user_has_access,
'no_access_url' => $group_link,
);
}
// If the user is a group admin, then show the group admin nav item.
if ( bp_is_item_admin() ) {
$sub_nav[] = array(
'name' => _x( 'Manage', 'My Group screen nav', 'buddypress' ),
'slug' => 'admin',
'parent_url' => $group_link,
'parent_slug' => $this->current_group->slug,
'screen_function' => 'groups_screen_group_admin',
'position' => 1000,
'user_has_access' => true,
'item_css_id' => 'admin',
'no_access_url' => $group_link,
);
$admin_link = trailingslashit( $group_link . 'admin' );
// Common params to all nav items.
$default_params = array(
'parent_url' => $admin_link,
'parent_slug' => $this->current_group->slug . '_manage',
'screen_function' => 'groups_screen_group_admin',
'user_has_access' => bp_is_item_admin(),
'show_in_admin_bar' => true,
);
$sub_nav[] = array_merge( array(
'name' => __( 'Details', 'buddypress' ),
'slug' => 'edit-details',
'position' => 0,
), $default_params );
$sub_nav[] = array_merge( array(
'name' => __( 'Settings', 'buddypress' ),
'slug' => 'group-settings',
'position' => 10,
), $default_params );
if ( ! bp_disable_group_avatar_uploads() && buddypress()->avatar->show_avatars ) {
$sub_nav[] = array_merge( array(
'name' => __( 'Photo', 'buddypress' ),
'slug' => 'group-avatar',
'position' => 20,
), $default_params );
}
if ( bp_group_use_cover_image_header() ) {
$sub_nav[] = array_merge( array(
'name' => __( 'Cover Image', 'buddypress' ),
'slug' => 'group-cover-image',
'position' => 25,
), $default_params );
}
$sub_nav[] = array_merge( array(
'name' => __( 'Members', 'buddypress' ),
'slug' => 'manage-members',
'position' => 30,
), $default_params );
if ( 'private' == $this->current_group->status ) {
$sub_nav[] = array_merge( array(
'name' => __( 'Requests', 'buddypress' ),
'slug' => 'membership-requests',
'position' => 40,
), $default_params );
}
$sub_nav[] = array_merge( array(
'name' => __( 'Delete', 'buddypress' ),
'slug' => 'delete-group',
'position' => 1000,
), $default_params );
}
foreach ( $sub_nav as $nav ) {
bp_core_new_subnav_item( $nav, 'groups' );
}
}
if ( isset( $this->current_group->user_has_access ) ) {
/**
* Fires at the end of the groups navigation setup if user has access.
*
* @since 1.0.2
*
* @param bool $user_has_access Whether or not user has access.
*/
do_action( 'groups_setup_nav', $this->current_group->user_has_access );
} else {
/** This action is documented in bp-groups/bp-groups-loader.php */
do_action( 'groups_setup_nav');
}
}
Changelog Changelog
| Version | Description |
|---|---|
| 1.5.0 | Introduced. |