Codex Home → Developer Resources → Navigation API
Navigation API
BuddyPress』s Navigation API (BP 2.6+) provides an interface for developers to modify BP』s nav menus in group and user contexts.
Examples
Changing the position of the user』s Notifications nav item
function bpcodex_change_notifications_nav_position() {
buddypress()->members->nav->edit_nav( array(
'position' => 999,
), 'notifications' );
}
add_action( 'bp_setup_nav', 'bpcodex_change_notifications_nav_position', 100 );
Changing the name of the Unread subnav item of the user』s Notifications nav menu
function bpcodex_change_unread_nav_name() {
buddypress()->members->nav->edit_nav( array(
'name' => 'My Unread Notifications',
), 'unread', 'notifications' );
}
add_action( 'bp_setup_nav', 'bpcodex_change_unread_nav_name', 100 );
Listing all navigation items belonging to the current group
function bpcodex_get_current_group_nav_items() {
// Group nav items are technically subnavs of the top-level item with the current group's slug.
return buddypress()->groups->nav->get_secondary( array(
'parent_slug' => bp_get_current_group_slug(),
) );
}
Change item names of user』s and group』s nav menus
Profile menu
function bpcodex_rename_profile_tabs() {
buddypress()->members->nav->edit_nav( array( 'name' => __( 'My Buddy Forums', 'textdomain' ) ), 'forums' );
buddypress()->members->nav->edit_nav( array( 'name' => __( 'My Buddy Groups', 'textdomain' ) ), 'groups' );
}
add_action( 'bp_actions', 'bpcodex_rename_profile_tabs' );
Group menu
function bpcodex_rename_group_tabs() {
if ( ! bp_is_group() ) {
return;
}
buddypress()->groups->nav->edit_nav( array( 'name' => __( 'Group Discussion', 'buddypress' ) ), 'forum', bp_current_item() );
}
add_action( 'bp_actions', 'bpcodex_rename_group_tabs' );
Changing the position of group』s nav items
function bpcodex_group_tab_reorder() {
if( bp_is_group() ) {
buddypress()->groups->nav->edit_nav( array( 'position' => 1 ), 'forum', bp_current_item() );
buddypress()->groups->nav->edit_nav( array( 'position' => 2 ), 'send-invites', bp_current_item() );
buddypress()->groups->nav->edit_nav( array( 'position' => 4 ), 'home', bp_current_item() );
}
}
add_action( 'bp_actions', 'bpcodex_group_tab_reorder' );
Remove subnav tabs from Group Settings
function bpcodex_remove_group_manager_subnav_tabs() {
// site admin will see all tabs
if ( ! bp_is_group() || ! ( bp_is_current_action( 'admin' ) && bp_action_variable( 0 ) ) || is_super_admin() ) {
return;
}
// all subnav items are listed here.
// comment those you want to show
$hide_tabs = array(
// 'group-settings' => 1,
'delete-group' => 1,
'group-avatar' => 1,
// 'group-invites' => 1,
'manage-members' => 1,
// 'forum' => 1,
// 'group-cover-image' => 1
);
$parent_nav_slug = bp_get_current_group_slug() . '_manage';
//Remove the nav items
foreach ( array_keys( $hide_tabs ) as $tab ) {
bp_core_remove_subnav_item( $parent_nav_slug, $tab, 'groups' );
}
}
add_action( 'bp_actions', 'bpcodex_remove_group_manager_subnav_tabs' );