BuddyPress Toolbar

1. 

   BuddyPress Toolbar in action - primary level - default state. (Click here for larger version of screenshot)

2. 

   BuddyPress Toolbar in action - second level - BP settings/components and frondend roots pages of active components. (Click here for larger version of screenshot)

3. 

   BuddyPress Toolbar in action - second level - BP user field groups (plus some specific extensions). (Click here for larger version of screenshot)

4. 

   BuddyPress Toolbar in action - third level - BP users management (plus some specific extensions). (Click here for larger version of screenshot)

5. 

   BuddyPress Toolbar in action - second level - optinal BP Groups management group (only if supporting plugins are active!). (Click here for larger version of screenshot)

6. 

   BuddyPress Toolbar in action - third level - extensions support (here with a huge list of active plugins :). (Click here for larger version of screenshot)

7. 

   BuddyPress Toolbar in action - second level - resource links group. (Click here for larger version of screenshot)

8. 

   BuddyPress Toolbar in action - translations/language specific links at the bottom - for example: German locale. (Click here for larger version of screenshot)

Does this plugin work with the latest WP version and also older versions?

Indeed, it does! And it does only run with WordPress 3.4 or higher! Therefore, you can only run it with BuddyPress 1.6+ (or former branch 1.5 and WP 3.3+ but NOT lower than this! Otherwise it will break your site. So, you’ve been warned.)

Is this plugin Multisite compatible?

Yes, it is! 🙂 Works really fine in Multisite invironment.

In Multisite, could I “network enable” this plugin?

Yes, you could. — It fully supports all Multisite aware settings pages, Multisite Blogs and also Multisite admin pages of supported plugins.

How are new resources being added to the admin bar?

Just drop me a note on my Twitter @deckerweb or via my contact page and I’ll add the link if it is useful for admins/ webmasters and the BuddyPress community.

How could my plugin/extension or theme options page be added to the admin bar links?

This is possible of course and highly welcomed! Just drop me a note on my Twitter @deckerweb or via my contact page and we sort out the details!
Particularly, I need the admin url for the primary options page (like so wp-admin/admin.php?page=foo) – this is relevant for both, plugins and themes. For themes then I also need the correct name defined in the stylesheet (like so Footheme) and the correct folder name (like so footheme-folder) because this would be the template name when using with child themes. (I don’t own all the premium stuff myself yet so you’re more than welcomed to help me out with these things. Thank you!)

There are still some other plugins for BuddyPress out there why aren’t these included by default?

• Simple answer: The settings of these add-ons have no settings page to link to. So linking/ adding is just not possible.
• Note: More plugin and theme support will be added from time to time.

Can custom menu items be hooked in via theme or other plugins?

Yes, this is possible since version 1.2 of the plugin! There are 4 action hooks available for hooking custom menu items in — bptb_custom_main_items for the main section, bptb_custom_extension_items for the exentensions section, bptb_custom_theme_items for the theme section plus bptb_custom_group_items for the resource group section. Here’s an example code:

add_action( 'bptb_custom_group_items', 'bptb_custom_additional_group_item' );
/**
 * BuddyPress Toolbar: Custom Resource Group Items
 *
 * @global mixed $wp_admin_bar
 */
function bptb_custom_additional_group_item() {

    global $wp_admin_bar;

    $wp_admin_bar->add_menu( array(
        'parent' => 'ddw-buddypress-bpgroup',
        'id'     => 'your-unique-item-id',
        'title'  => __( 'Custom Menu Item Name', 'your-textdomain' ),
        'href'   => 'http://deckerweb.de/',
        'meta'   => array( 'title' => __( 'Custom Menu Item Name Tooltip', 'your-textdomain' ) )
    ) );
}

Can certain sections be removed?

Yes, this is possible! You can remove the following sections: “Manage Groups” group (all items) / “Extensions” area (all items) / “Theme” (all items!) / “Resources link group” at the bottom (all items) / “German language stuff” (all items) / “Translations” (all items)

To achieve this add one, some or all of the following constants to your theme’s/child theme’s functions.php file:

/** BuddyPress Toolbar: Remove Manage Content Items */
define( 'BPTB_MANAGE_GROUPS_DISPLAY', FALSE );

/** BuddyPress Toolbar: Remove Extensions Items */
define( 'BPTB_EXTENSIONS_DISPLAY', FALSE );

/** BuddyPress Toolbar: Remove Theme Items */
define( 'BPTB_THEME_DISPLAY', FALSE );

/** BuddyPress Toolbar: Remove Resource Items */
define( 'BPTB_RESOURCES_DISPLAY', FALSE );

/** BuddyPress Toolbar: Remove German Language Items */
define( 'BPTB_DE_DISPLAY', FALSE );

/** BuddyPress Toolbar: Remove Translations Items */
define( 'BPTB_TRANSLATIONS_DISPLAY', FALSE );

Can the the whole toolbar entry be removed, especially for certain users?

Yes, that’s also possible! This could be useful if your site has special user roles/capabilities or other settings that are beyond the default WordPress stuff etc. For example: if you want to disable the display of any “BuddyPress Toolbar” items for all user roles of “Editor” please use this code:

/** BuddyPress Toolbar: Remove all items for "Editor" user role */
if ( current_user_can( 'editor' ) ) {
    define( 'BPTB_DISPLAY', FALSE );
}

To hide only from the user with a user ID of “2”:

/** BuddyPress Toolbar: Remove all items for user ID 2 */
if ( 2 == get_current_user_id() ) {
    define( 'BPTB_DISPLAY', FALSE );
}

To hide items only in frontend use this code:

/** BuddyPress Toolbar: Remove all items from frontend */
if ( ! is_admin() ) {
    define( 'BPTB_DISPLAY', FALSE );
}

In general, use this constant do hide any “BuddyPress Toolbar” items:

/** BuddyPress Toolbar: Remove all items */
define( 'BPTB_DISPLAY', FALSE );

Can I remove the original Toolbar items for BuddyPress Media plugin?

Yes, this is also possible! Since v1.5.0 – so if you only want that plugin stuff to appear within “BuddyPress Toolbar” just add this constant to your active theme’s/ child theme’s functions.php file or a functionality plugin:

/** BuddyPress Toolbar: Remove original BuddyPress Media items */
define( 'BPTB_REMOVE_BPMEDIA_TOOLBAR', TRUE );

Available Filters to Customize More Stuff

All filters are listed with the filter name in bold and the below additional info, helper functions (if available) as well as usage examples.

bptb_filter_capability_all

• Default value: administrator (BuddyPress admin stuff should only be done by admins, right?!)

• 4 Predefined helper functions:

  • __bptb_role_editor — returns 'editor' role — usage:

  add_filter( ‘bptb_filter_capability_all’, ‘__bptb_role_editor’ );

  • __bptb_cap_edit_theme_options — returns 'edit_theme_options' capability — usage:

  add_filter( ‘bptb_filter_capability_all’, ‘__bptb_cap_edit_theme_options’ );

  • __bptb_cap_manage_options — returns 'manage_options' capability — usage:

  add_filter( ‘bptb_filter_capability_all’, ‘__bptb_cap_manage_options’ );

  • __bptb_cap_install_plugins — returns 'install_plugins' capability — usage:

  add_filter( ‘bptb_filter_capability_all’, ‘__bptb_cap_install_plugins’ );

• Another example:

  add_filter( ‘bptb_filter_capability_all’, ‘custom_bptb_capability_all’ );
  /**

  • BuddyPress Toolbar: Change Main Capability
    */
    function custom_bptb_capability_all() {
    return ‘activate_plugins’;
    }

–> Changes the capability to activate_plugins

bptb_filter_main_icon

• Default value: BuddyPress logo (favicon) with some kind of orange/red touch… 🙂

• 11 Predefined helper functions for the 11 included colored icons, returning special colored icon values – the helper function always has this name: __bptb_colornamehere_icon() this results in the following filters ready for usage:

  add_filter( ‘bptb_filter_main_icon’, ‘__bptb_blue_icon’ );

  add_filter( ‘bptb_filter_main_icon’, ‘__bptb_brown_icon’ );

  add_filter( ‘bptb_filter_main_icon’, ‘__bptb_gray_icon’ );

  add_filter( ‘bptb_filter_main_icon’, ‘__bptb_green_icon’ );

  add_filter( ‘bptb_filter_main_icon’, ‘__bptb_khaki_icon’ );

  add_filter( ‘bptb_filter_main_icon’, ‘__bptb_orange_icon’ );

  add_filter( ‘bptb_filter_main_icon’, ‘__bptb_pink_icon’ );

  add_filter( ‘bptb_filter_main_icon’, ‘__bptb_red_icon’ );

  add_filter( ‘bptb_filter_main_icon’, ‘__bptb_turquoise_icon’ );

  add_filter( ‘bptb_filter_main_icon’, ‘__bptb_yellow_icon’ );

  add_filter( ‘bptb_filter_main_icon’, ‘__bptb_yellowtwo_icon’ );

  add_filter( ‘bptb_filter_main_icon’, ‘__bptb_theme_images_icon’ );

–> Where the last helper function returns the icon file (icon-bptb.png) found in your current theme’s/child theme’s /images/ subfolder

• Example for using with current child theme:

  add_filter( ‘bptb_filter_main_icon’, ‘custom_bptb_main_icon’ );
  /**

  • BuddyPress Toolbar: Change Main Icon
    */
    function custom_bptb_main_icon() {
    return get_stylesheet_directory_uri() . ‘/images/custom-icon.png’;
    }

–> Uses a custom image from your active child theme’s /images/ folder

–> Recommended dimensions are 16px x 16px

bptb_filter_main_icon_display

• Returning the CSS class for the main item icon
• Default value: icon-buddypress (class is: .icon-buddypress)

• 1 Predefined helper function:

  • __bptb_no_icon_display() — usage:

  add_filter( ‘bptb_filter_main_icon_display’, ‘__bptb_no_icon_display’ );

–> This way you can REMOVE the icon!

• Another example:

  add_filter( ‘bptb_filter_main_icon_display’, ‘custom_bptb_main_icon_display_class’ );
  /**

  • BuddyPress Toolbar: Change Main Icon CSS Class
    */
    function custom_bptb_main_icon_display_class() {
    return ‘your-custom-icon-class’;
    }

–> You then have to define CSS rules in your theme/child theme stylesheet for your own custom class .your-custom-icon-class

–> Recommended dimensions are 16px x 16px

bptb_filter_main_item_title

• Default value: “BuddyPress”

• Example code for your theme’s/child theme’s functions.php file:

  add_filter( ‘bptb_filter_main_item_title’, ‘custom_bptb_main_item_title’ );
  /**

  • BuddyPress Toolbar: Change Main Item Name
    */
    function custom_bptb_main_item_title() {
    return __( ‘Your custom main item title’, ‘your-textdomain’ );
    }

bptb_filter_main_item_title_tooltip

• Default value: “BuddyPress”

• Example code for your theme’s/child theme’s functions.php file:

  add_filter( ‘bptb_filter_main_item_title_tooltip’, ‘custom_bptb_main_item_title_tooltip’ );
  /**

  • BuddyPress Toolbar: Change Main Item Name’s Tooltip
    */
    function custom_bptb_main_item_title_tooltip() {
    return __( ‘Your custom main item title tooltip’, ‘your-textdomain’ );
    }

bptb_filter_buddypress_name and bptb_filter_buddypress_name_tooltip

• Default value for both: “BuddyPress”
• Used for some items within toolbar links to enable proper branding
• Change things like in the other examples/principles shown above

Final note: If you don’t like to add your customizations to your theme’s/child theme’s functions.php file you can also add them to a functionality plugin or an mu-plugin. This way you can also use this better for Multisite environments. In general you are then more independent from child theme changes etc.

All the custom & branding stuff code above can also be found as a Gist on Github: https://gist.github.com/2643807 (you can also add your questions/ feedback there 🙂

1.6.0 (2013-04-11)

• NEW: Added support for Groups admin settings introduced with BuddyPress v1.7+.
• Extended plugin support:
  • NEW: Added support for “BuddyBox” (free, by Imath).
  • NEW: Added support for “BuddyPress Group Folders” (free, by Rudolf Enberg).
  • UPDATE: Improved support for “BuddyPress Media” plugin.
  • UPDATE: Improved support for “Achievements” plugin.
• CODE: Code/documentation updates & improvements.
• UPDATE: Updated German translations and also the .pot file for all translators!
• UPDATE: Moved screenshots to ‘assets’ folder in WP.org SVN to reduce plugin package size.

1.5.0 / 1.5.1 (2012-11-15)

• Extended plugin support:
  • NEW: Added support for “BuddyPress BP Gallery” (free, by Caevan Sachinwalla).
  • NEW: Added support for “BuddyPress Custom Profile Menu” (free, by Sensible Plugins) (free lite version!).
  • NEW: Added support for “BuddyPress Relate Groups to Blogs” (free, by spurge).
  • NEW: Added support for “BP Trunk Junc” (free, by modemlooper) – Beta Tester plugin.
  • NEW: Added support for “Members Import” (free, by Manish Kumar Agarwal).
  • NEW: Added support for “BP Menus” (free, by modemlooper).
  • UPDATE: Updated support for “BuddyPress Media” plugin – 2 more settings pages, plus: Constant for removing this plugin’s toolbar items (see FAQ here).
• Other stuff and maintenance:
  • CODE: Minor code/documentation updates & improvements.
  • UPDATE: Updated German translations and also the .pot file for all translators!
  • UPDATE: Initiated new three digits versioning, starting with this version.
  • v1.5.1: Corrects a small syntax error. — Sorry!

1.4.1 (2012-08-29)

• Maintenance release
• UPDATE: Added additional ‘function_exists’ checks to avoid possible compatibility issues on upgrades.
• UPDATE: Updated readme.txt file here.

1.4.0 (2012-08-13)

• New features:
  • NEW: Added help tab on all official BuddyPress settings pages.
• Extended plugin support:
  • NEW: Added support for “BP Checkins 1.0+” (free, by Imath) – note: only for version 1.0 or higher of the plugin!
  • NEW: Added support for “BP Polls 1.2+” (free, by Themekraft).
  • NEW: Added support for “BuddyPress Extended Settings” (free, by modemlooper).
  • NEW: Added support for “BuddyPress Mobile” (aka BuddyMobile) (free, by modemlooper).
  • NEW: Added support for “BuddyPress Share It” (aka BuddyShare) (free, by modemlooper).
  • NEW: Added support for “BuddyPress Media Component 2.0+” (free, by rtCamp).
  • UPDATE: Enhanced plugin support for “BuddyPress Portfolio”.
  • UPDATE: Updated support support for “BuddyPress MyMood 1.6+” (note: as this plugin has no proper Multisite support yet, so it only works within single installs or in Multisite within a subsite dashboard).
• Extended theme support:
  • NEW: Added theme support for “NewYorker” (free, by milo317).
• Other stuff and maintenance:
  • UPDATE: Minor tweaks/updates to ensure full BuddyPress v1.6+ compatibility.
  • UPDATE: Corrected and updated readme.txt file here.
  • UPDATE: Updated German translations and also the .pot file for all translators!

1.3.0 (2012-06-15)

• Maintenance release
• Extended plugin support:
  • NEW: Added support for “BP Profile Search” (free, by Andrea Tarantini).
  • NEW: Added support for “BuddyPress Portfolio” (free, by Nicolas Crocfer).
  • NEW: Added support for “BuddyPress Login Redirect” (free, by Jatinder Pal Singh).
  • NEW: Added support for “BP Profile as Homepage” (free, by Jatinder Pal Singh).
• Other stuff and maintenance:
  • UPDATE: Improved behavior of constants for removing sections (or all), so that setting to “FALSE” removes stuff, and setting to “TRUE” displays stuff. (This does not affect existing behavior as explained in the FAQ but introduces ability to use the boolean “TRUE” to bring stuff back in favor of removing the code lines – great for testing purposes etc.)
  • UPDATE: Added one more check for Groups component to avoid crashes when running BuddyPress update wizard (single & Multisite installs).
  • CODE: Minor code/documentation updates & improvements.
  • UPDATE: Updated German translations and also the .pot file for all translators!

1.2.0 (2012-05-10)

• New features:
  • NEW: Fully Multisite compatible! Plugin dynamically changes admin URLs whether or not you are in Multisite invironment – of course supported plugins are included in this behavior (and if these plugins support Multisite)!
  • NEW: Full capability support – wherever a BuddyPress, a plugin or theme settings page depends on user capabilities or roles BuddyPress Toolbar now fully respects and inherits that! – In other words: A user who won’t see a special admin page without my plugin also won’t if my plugin is active!
  • NEW: Added links to active component’s frontend root pages, for example yoursite.com/groups — this includes “Blogs/Sites” support for Multisite/Networks!
  • NEW: Now built-in search form for BuddyPress Codex – just type in a search directly in your toolbar menu!
  • COOL: Plugin can now be branded and customized a lot more!
  • NEW: Added 7 filters to change icon graphic, main item name, main capability and more! For these cases there are now the new built-in filters and helper functions available! (See “FAQ” section here)
  • NEW: Added 4 action hooks for hooking custom menu items in — for all main sections plus the resource group section (see FAQ section here for more info on that).
  • NEW: Almost all sections can now be removed for special needs, capabilities etc. — all done via constants in your active theme/child theme — this way you can customize for your staff members if you need some more users with extended or restricted admin bar/toolbar access (See “FAQ” section here)
  • NEW: Added possibility for custom and update-secure language files for this plugin – just upload them to /wp-content/languages/buddypress-toolbar/ (just create this folder) – this enables you to use complete custom wording or translations.
• Extended plugin support:
  • NEW: Added support for “BP Group Management” (free, by Boone Gorges)
  • NEW: Added support for “BP Profiles Statistics 1.1+” (premium, by slaFFik)
  • NEW: Added support for “BuddyPress Docs” (free, by Boone Gorges)
  • NEW: Added support for “BuddyPress MyMood 1.6+” (free, by Ayush)
  • NEW: Added support for “BuddyPress xProfiles ACL” Lite (free, by NetTantra)
  • NEW: Added support for “SeoPress” (free, by Sven Lehnert + Sven Wagener at ThemeKraft)
  • NEW: Added support for “CollabPress” (free, by WebDevStudios)
  • NEW: Added support for “BBG Record Blog Roles Changes” (free, by Boone Gorges + slaFFik)
  • NEW: Added support for “CD BuddyPress Avatar Bubble” (free, by slaFFik + valant)
  • NEW: Added support for “sxss Buddypress Shared Friends” (free, by sxss)
  • NEW: Added support for “Breadcrumbs Everywhere 1.1+” (free, by Betsy Kimak)
  • UPDATE: Improved “WangGuard” plugin support.
  • UPDATE: Improved “Achievements” plugin support – added link to component’s frondend root page.
  • UPDATE: Added proper capabilities to the settings links display to follow original settings of the supported plugins itself.
• Extended theme support:
  • NEW: Added theme support for “Buddies” (premium, by Chris Paul/ZenThemes)
  • NEW: Added theme support for “Visual” (premium) and “Fanwood 0.1.6+” (free) (both by DevPress)
  • NEW: Added theme support for 10 themes from 3oneseven.com (all free, by milo317)
  • UPDATE: Added proper capabilities to the settings links display to follow original setting of the supported theme itself (only where available, or I had access to this data!).
• Other stuff and maintenance:
  • UPDATE: Added full compatibility with WordPress 3.4+ (tested since 3.4-beta1 up to latest trunk version).
  • CODE: Successfully tested against BuddyPress 1.5+ and 1.6-alpha branches plus WordPress 3.3 branch and new 3.4 branch. Also successfully tested in WP_DEBUG mode (no notices or warnings).
  • UPDATE: Updated readme.txt file
  • UPDATE: Updated all existing and added some new screenshots.
  • UPDATE: Updated German translations and also the .pot file for all translators!
  • UPDATE: Extended GPL License info in readme.txt as well as main plugin file.
  • NEW: Easy plugin translation platform with GlotPress tool: Translate “BuddyPress Toolbar”…

1.1.0 (2012-02-19)

• NEW: Added a few new BP Codex sub-level links
• NEW: Added BuddyPress News Planet feed link to resource links – you can also access this from here: http://friendfeed.com/buddypress-news
• NEW: Added new community resource “BP-Tricks.com”
• Extended plugin support:
  • Added plugin support for “BuddyPress Group Extras” (free, by slaFFik)
  • Added plugin support for “BP GTM System” (free, by slaFFik, valant)
  • Added plugin support for “Buddypress User Account Type Lite” (free, by Rimon Habib)
  • Added plugin support for “BuddyStream” (free, by Peter Hofman)
  • Added plugin support for “BuddyPress Group Default Avatar” (free, by Vernon Fowler)
  • Added plugin support for “BuddyPress Achievements” (free, by Paul Gibbs)
  • Added plugin support for “BuddyPress Twitter” (free, by Charl Kruger)
  • Added plugin support for “BuddyPress Group Email Subscription” (free, by Deryk Wenaus + Boone Gorges)
  • Added plugin support for “BP Code Snippets” (free, by imath)
  • Added plugin support for “Invite Anyone” (free, by Boone Gorges)
  • Added plugin support for “Events Manager” (free, by Marcus Sykes)
• Extended theme support:
  • Added theme support for “Builder Framework” via “Builder BuddyPress” plugin (premium, by iThemes)
  • Added theme support for “Infinity (Anti-) Framework” via “BP Template Pack” plugin (free/beta, by PressCrew)
  • Added theme support for “Gratitude” (premium, by Chris Paul/ZenThemes)
  • Added theme support for “Business Services” and “BuddyPress Corporate” (both free, by WPMU DEV)
• CODE: No longer loading css styles or menu items for not logged-in users when plugins like “GD Press Tools” are active (which have options to show toolbar / admin bar also for visitors…)
• UPDATE: Updated German translations and also the .pot file for all translators!
• NEW: Added banner image on WordPress.org for better plugin branding 🙂

1.0.0 (2012-02-07)

• Initial release