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. |