This plugin adds useful admin links and resources for the bbPress 2.x Forum Plugin to the WordPress Toolbar / Admin Bar.
This small and lightweight plugin just adds a lot bbPress 2.x related resources to your toolbar / admin bar. Also links to all setting/ tab pages of the plugin are added making life for forum administrators/ moderators a lot easier. So you might just switch from the fontend of your site to your ‘Forums’, ‘Topics’ or ‘Main Settings’ page or even plugin extensions etc.
As the name suggests this plugin is intended towards forum admins/ webmasters and moderators. The new admin bar entries will only be displayed if the current user has the bbPress/ WordPress capability of moderate
. (Note: I am open for suggestions here if this should maybe changed to a more suitable capability.)
At this time my plugin out of the box supports also links to settings pages of some bbPress 2.x specific plugins:
At this time my plugin out of the box supports also links to settings pages of some bbPress specific/supporting themes or frameworks:
bbpaba.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 awesome “WooThemes Admin Bar Addition” plugin.
A plugin from deckerweb.de and GenesisThemes
Enjoy using bbPress Admin Bar Addition? Please consider making a small donation to support the project’s continued development.
/wp-content/languages/bbpress-admin-bar-addition/
(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 bbpaba-en_US.mo/.po
to achieve that (for creating one see the following tools).Easy plugin translation platform with GlotPress tool:Translate “bbPress Admin Bar Addition”…
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 bbPress Forum managers out there to make their daily forum admin life a bit easier. I’ll try to add more plugin/theme support if it makes some sense. So stay tuned :).
bbpress-admin-bar-addition
folder to the /wp-content/plugins/
directory — or just upload the ZIP package via ‘Plugins > Add New > Upload’ in your WP AdminMultisite 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/bbpress-admin-bar-addition/
(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 bbpaba-en_US.mo/.po
to achieve that (for creating one see the tools on “Other Notes”).
bbPress Admin Bar Addition in action - primary level - default state (running with bbPress 2.1-bleeding and WordPress 3.3+ here)
bbPress Admin Bar Addition in action - second level - main settings
bbPress Admin Bar Addition in action - third level - forums - view frontend forums plus edit/add forums
bbPress Admin Bar Addition in action - second level - users (also with some extensions hooking in)
bbPress Admin Bar Addition in action - third level - extensions support
bbPress Admin Bar Addition in action - second level - resources: documentation stuff
bbPress Admin Bar Addition in action - second level - resources: bbPress HQ stuff
bbPress Admin Bar Addition in action - language specific links at the bottom - for example: German locale
Yes, this plugin works really fine with WordPress 3.3+!
It also works great with WP 3.2 branch – and also should with WP 3.1 branch – but we only tested extensively with WP 3.3+ and 3.2 branch. So you always should run the latest WordPress version for a lot of reasons.
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 bbPress 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!)
Simple answer: The settings of these add-ons are added directly to the bbPress main settings page and have no anchor to link to. So linking/ adding is just not possible.
Yes, it is! 🙂 Works really fine in Multisite invironment – here I just recommend to activate on a per site basis so to load things only where and when needed.
Yes, you could. — However, it doesn’t make much sense. The plugin is intented for a per site use as the admin links refer to the special settings, plugin-support and theme-support for that certain site/blog. So if you have a Multisite install with 5 sites but only 3 would run “bbPress 2.x” the the other 2 sites will only see support links in the Toolbar / Admin Bar… I guess, you got it? 🙂
Though intended for a per site use it could make some sense in such an edge case: if all of the sites in Multisite use bbPress 2.x and have lots of bbPress-specific plugins in common and use the same theme/framework. This might be the case if you use Multisite for multilingual projects, especially via that awesome plugin: https://wordpress.org/extend/plugins/multilingual-press/
Yes, this is possible since version 1.5 of the plugin! There are 5 action hooks available for hooking custom menu items in — bbpaba_custom_main_items
for the main section, bbpaba_custom_forum_items
for the Forums sub-level section (frontend links), bbpaba_custom_extension_items
for the exentensions section, bbpaba_custom_theme_items
for the theme section plus bbpaba_custom_group_items
for the resource group section. Here’s an example code:
add_action( 'bbpaba_custom_group_items', 'bbpaba_custom_additional_group_item' ); /** * bbPress Admin Bar Addition: Custom Resource Group Items * * @global mixed $wp_admin_bar */ function bbpaba_custom_additional_group_item() { global $wp_admin_bar; $wp_admin_bar->add_menu( array( 'parent' => 'ddw-bbpress-bbpgroup', '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: “Extensions” area (all items) / “Theme” (all items!) / “Resources link group” at the bottom (all items) / “German language stuff” (all items)
To achieve this add one, some or all of the following constants to your theme’s/child theme’s functions.php
file:
/** bbPress Admin Bar Addition: Remove Extensions Items */ define( 'BBPABA_EXTENSIONS_DISPLAY', FALSE ); /** bbPress Admin Bar Addition: Remove Theme Items */ define( 'BBPABA_THEME_DISPLAY', FALSE ); /** bbPress Admin Bar Addition: Remove Resource Items */ define( 'BBPABA_RESOURCES_DISPLAY', FALSE ); /** bbPress Admin Bar Addition: Remove German Language Items */ define( 'BBPABA_DE_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 “bbPress Admin Bar Addition” items for all user roles of “Editor” please use this code:
/** bbPress Admin Bar Addition: Remove all items for "Editor" user role */ if ( current_user_can( 'editor' ) ) { define( 'BBPABA_DISPLAY', FALSE ); }
To hide only from the user with a user ID of “2”:
/** bbPress Admin Bar Addition: Remove all items for user ID 2 */ if ( 2 == get_current_user_id() ) { define( 'BBPABA_DISPLAY', FALSE ); }
To hide items only in frontend use this code:
/** bbPress Admin Bar Addition: Remove all items from frontend */ if ( ! is_admin() ) { define( 'BBPABA_DISPLAY', FALSE ); }
In general, use this constant do hide any “bbPress Admin Bar Addition” items:
/** bbPress Admin Bar Addition: Remove all items */ define( 'BBPABA_DISPLAY', FALSE );
Yes, this is also possible! Since v1.5+ of my plugin support for GD bbPress Tools” and “GD bbPress Toolbox (Pro)” (both by Milan Petrovic of Dev4Press) is included so if you only want his stuff to appear within “bbPress Admin Bar Addition” just add this constant to your active theme’s/child theme’s functions.php file
or functionality plugin:
/** bbPress Admin Bar Addition: Remove original GD bbPress Tools items */ define( 'BBPABA_REMOVE_GDBBPRESSTOOLS_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.
bbpaba_filter_capability_all
moderate
(bbPress admin stuff should only be done by at least “Moderators”, right?!)7 Predefined helper functions:
__bbpaba_admin_only
— returns 'administrator'
role — usage:add_filter( ‘bbpaba_filter_capability_all’, ‘__bbpaba_admin_only’ );
__bbpaba_role_editor
— returns 'editor'
role — usage:add_filter( ‘bbpaba_filter_capability_all’, ‘__bbpaba_role_editor’ );
__bbpaba_role_bbp_moderator
— returns 'bbp_moderator'
role — usage:add_filter( ‘bbpaba_filter_capability_all’, ‘__bbpaba_role_bbp_moderator’ );
__bbpaba_cap_moderate
— returns 'moderate'
capability — usage:add_filter( ‘bbpaba_filter_capability_all’, ‘__bbpaba_cap_moderate’ );
__bbpaba_cap_manage_options
— returns 'manage_options'
capability — usage:add_filter( ‘bbpaba_filter_capability_all’, ‘__bbpaba_cap_manage_options’ );
__bbpaba_cap_install_plugins
— returns 'install_plugins'
capability — usage:add_filter( ‘bbpaba_filter_capability_all’, ‘__bbpaba_cap_install_plugins’ );
__bbpaba_cap_edit_theme_options
— returns 'edit_theme_options'
capability — usage:add_filter( ‘bbpaba_filter_capability_all’, ‘__bbpaba_cap_edit_theme_options’ );
Another example:
add_filter( ‘bbpaba_filter_capability_all’, ‘custom_bbpaba_capability_all’ );
/**
–> Changes the capability to activate_plugins
bbpaba_filter_main_icon
10 Predefined helper functions for the 10 included colored icons, returning special colored icon values – the helper function always has this name: __bbpaba_colornamehere_icon()
this results in the following filters ready for usage:
add_filter( ‘bbpaba_filter_main_icon’, ‘__bbpaba_blue_icon’ );
add_filter( ‘bbpaba_filter_main_icon’, ‘__bbpaba_brown_icon’ );
add_filter( ‘bbpaba_filter_main_icon’, ‘__bbpaba_gray_icon’ );
add_filter( ‘bbpaba_filter_main_icon’, ‘__bbpaba_green_icon’ );
add_filter( ‘bbpaba_filter_main_icon’, ‘__bbpaba_khaki_icon’ );
add_filter( ‘bbpaba_filter_main_icon’, ‘__bbpaba_orange_icon’ );
add_filter( ‘bbpaba_filter_main_icon’, ‘__bbpaba_pink_icon’ );
add_filter( ‘bbpaba_filter_main_icon’, ‘__bbpaba_red_icon’ );
add_filter( ‘bbpaba_filter_main_icon’, ‘__bbpaba_turquoise_icon’ );
add_filter( ‘bbpaba_filter_main_icon’, ‘__bbpaba_alternate_icon’ );
add_filter( ‘bbpaba_filter_main_icon’, ‘__bbpaba_theme_images_icon’ );
–> Where the 2nd to last “alternate” icon returns the same icon as in the left-hand “Forums” menu!
–> Where the last helper function returns the icon file (icon-bbpaba.png
) found in your current theme’s/child theme’s /images/
subfolder
Example for using with current child theme:
add_filter( ‘bbpaba_filter_main_icon’, ‘custom_bbpaba_main_icon’ );
/**
–> Uses a custom image from your active child theme’s /images/
folder
–> Recommended dimensions are 16px x 16px
bbpaba_filter_main_icon_display
icon-bbpress
(class is: .icon-bbpress
)1 Predefined helper function:
__bbpaba_no_icon_display()
— usage:add_filter( ‘bbpaba_filter_main_icon_display’, ‘__bbpaba_no_icon_display’ );
–> This way you can REMOVE the icon!
Another example:
add_filter( ‘bbpaba_filter_main_icon_display’, ‘custom_bbpaba_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
bbpaba_filter_main_item_title
Example code for your theme’s/child theme’s functions.php
file:
add_filter( ‘bbpaba_filter_main_item_title’, ‘custom_bbpaba_main_item_title’ );
/**
bbpaba_filter_main_item_title_tooltip
Example code for your theme’s/child theme’s functions.php
file:
add_filter( ‘bbpaba_filter_main_item_title_tooltip’, ‘custom_bbpaba_main_item_title_tooltip’ );
/**
bbpaba_filter_bbpress_name and bbpaba_filter_bbpress_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 theme/child theme changes etc.
All the custom & branding stuff code above can also be found as a Gist on Github: https://gist.github.com/2721186 (you can also add your questions/ feedback there 🙂
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/bbpaba/
(just create this folder) – this enables you to use fully custom wording or translations