This plugin adds useful admin links and resources for BuddyPress 1.5+/1.6+/1.7+ to the WordPress Toolbar / Admin Bar.
This small and lightweight plugin just adds a lot BuddyPress related resources to your toolbar / admin bar. Also links to all setting/ tab pages of the plugin are added making life for community managers/ administrators a lot easier. So you might just switch from the fontend of your site to ‘Activity Moderating’ (BP 1.6+), ‘Groups Admin’ (BP 1.7+) or the ‘Main Settings’ page etc.
The plugin is fully compatible with the latest WordPress version 3.4+/ 3.5+ and therefore with BuddyPress 1.6+ and 1.7+. It’s also still compatible with former BP branch 1.5 (and WP 3.3+) but we always recommend to run the latest versions. The plugin dynamically supports the different admin settings links in BOTH BuddyPress versions! — So, just go and manage your community. Use this time saver! π
As the name suggests this plugin is intended towards community managers/ webmasters and administrators. The new toolbar / admin bar items will only be displayed if the current user has the WordPress role/cabability of administrator
. (Note: This can be customized via helper functions/constants, see FAQ here.)
At this time my plugin out of the box supports also links to settings pages of some BuddyPress specific plugins:
At this time my plugin out of the box supports also links to settings pages of some BuddyPress specific/supporting themes or frameworks:
buddypress-toolbar.pot
) for translators is also always included πCredit where credit is due: This plugin here is inspired and based on the work of Remkus de Vries @defries and his original “WooThemes Admin Bar Addition” plugin.
A plugin from deckerweb.de and GenesisThemes
Enjoy using BuddyPress Toolbar? Please consider making a small donation to support the project’s continued development.
/wp-content/languages/buddypress-toolbar/
(just create this folder) – This enables you to use fully custom translations that won’t be overridden on plugin updates. Also, complete custom English wording is possible with that, just use a language file like buddypress-toolbar-en_US.mo/.po
to achieve that (for creating one see the following tools).Easy plugin translation platform with GlotPress tool:Translate “BuddyPress Toolbar”…
Note: All my plugins are internationalized/ translateable by default. This is very important for all users worldwide. So please contribute your language to the plugin to make it even more useful. For translating I recommend the awesome “Codestyling Localization” plugin and for validating the “Poedit Editor”, which works fine on Windows, Mac and Linux.
Idea Behind / Philosophy: Just a little leightweight plugin for all the BuddyPress community managers out there to make their daily community admin life a bit easier. I’ll try to add more plugin/theme support if it makes some sense. So stay tuned :).
buddypress-toolbar
folder to the /wp-content/plugins/
directory — or just upload the ZIP package via ‘Plugins > Add New > Upload’ in your WP AdminIMPORTANT NOTE: Please do only install with latest BuddyPress branches – that is v1.6+. The plugin is also compatible with the former 1.5 branch, though. Do never ever install this plugin together with older versions of BuddyPress! It will break your site. So, you’ve been warned.
Multisite install: Yes, it’s fully compatible but have a look in the FAQ section here for more info π
Own translation/wording: For custom and update-secure language files please upload them to /wp-content/languages/buddypress-toolbar/
(just create this folder) – This enables you to use fully custom translations that won’t be overridden on plugin updates. Also, complete custom English wording is possible with that, just use a language file like buddypress-toolbar-en_US.mo/.po
to achieve that (for creating one see the tools on “Other Notes”).
BuddyPress Toolbar in action - primary level - default state. (Click here for larger version of screenshot)
BuddyPress Toolbar in action - second level - BP settings/components and frondend roots pages of active components. (Click here for larger version of screenshot)
BuddyPress Toolbar in action - second level - BP user field groups (plus some specific extensions). (Click here for larger version of screenshot)
BuddyPress Toolbar in action - third level - BP users management (plus some specific extensions). (Click here for larger version of screenshot)
BuddyPress Toolbar in action - second level - optinal BP Groups management group (only if supporting plugins are active!). (Click here for larger version of screenshot)
BuddyPress Toolbar in action - third level - extensions support (here with a huge list of active plugins :). (Click here for larger version of screenshot)
BuddyPress Toolbar in action - second level - resource links group. (Click here for larger version of screenshot)
BuddyPress Toolbar in action - translations/language specific links at the bottom - for example: German locale. (Click here for larger version of screenshot)
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.)
Yes, it is! π Works really fine in Multisite invironment.
Yes, you could. — It fully supports all Multisite aware settings pages, Multisite Blogs and also Multisite admin pages of supported plugins.
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.
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!)
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' ) ) ) ); }
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 );
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 );
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 );
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
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’ );
/**
–> Changes the capability to activate_plugins
bptb_filter_main_icon
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’ );
/**
–> Uses a custom image from your active child theme’s /images/
folder
–> Recommended dimensions are 16px x 16px
bptb_filter_main_icon_display
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’ );
/**
–> 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
Example code for your theme’s/child theme’s functions.php
file:
add_filter( ‘bptb_filter_main_item_title’, ‘custom_bptb_main_item_title’ );
/**
bptb_filter_main_item_title_tooltip
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’ );
/**
bptb_filter_buddypress_name and bptb_filter_buddypress_name_tooltip
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 π
yoursite.com/groups
— this includes “Blogs/Sites” support for Multisite/Networks!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)/wp-content/languages/buddypress-toolbar/
(just create this folder) – this enables you to use complete custom wording or translations.