BuddyPress menu widget and menu shortcode. Does three things really well: BuddyPress menu widget, BuddyPress menu shortcode and BuddyPress dynamic lin
This menu is not visible to visitors who are not logged in.
BuddyMenu Shortcode displays a vertical or horizontal menu. You can change the anchor text of each menu tab. The link title tooltip will always be the same as the anchor text. Any of the menu tabs can be disabled. This menu is not visible to visitors who are not logged in.
New in version 2: Customize the menu icons
Enter the shortcode in any page, post or widget area (if you are set up to use shortcodes in widget areas).
The shortcode for the menu is:
The basic options/attributes are:
bmact=""to change the activity tab
bmfor=""to change the forum tab
bmfri=""to change the friends tab
bmmsg=""to change the messages tab
bmpro=""to change the profile tab
bmedpro=""to change the edit profile tab
bmchav=""to change the change avatar tab
bmset=""to change the settings tab
bmlay=""to change the layout from horizontal to vertical
If no option is set, the full menu is displayed as a horizontal row. For example, using [buddymenu] will display the full menu where the shorcode is placed.
Setting any option to -1 will disable that option's menu item.
Any text entered within the quotes of an option will become the link anchor text and the link title for that option's menu item.
To show the full menu horizontally:
To show the full menu as a vertical list:
To show the menu without the activity tab:
To show the menu with the message tab text changed to Inbox:
To show a horizontal menu with the settings tab changed to Configs:
[buddymenu bmset="Configs" bmlay="horizontal"]
This menu is very useful in horizontal widget areas in multilingual environments.
The icon customization attributes are:
bmacti=""sets the activity icon.
bmfori=""sets the forum icon.
bmfrii=""sets the friends icon.
bmmsgi=""sets the messages icon.
bmproi=""sets the profile icon.
bmseti=""sets the settings icon.
Put the URL to any image into an link icon attribute to use that image as the icon for that link.
[buddymenu bmicons="0"] Disables all icons.
[buddymenu bmacti="http://example.com/icon.png"] Will replace the default activity icon with the image at http://example.com/icon.png.
The BuddyLinks shortcode provides a stub URL that is dynamically generated by BuddyPress. This URL looks like example.com/members/[USERNAME]/. You need to provide the path that follows the username (represented by the asterisk in this case).
This shortcode is good for putting links to your network users' pages in the content of your pages and posts.
None logged in users see the text "login to view this link" which links to the WordPress login page. This text link is configurable.
BuddyLinks has four main options/attributes:
bllink=""for setting the link
bltitle=""for setting the tooltip title
bltext=""for setting the anchor text that users click
blicon=""for configuring an icon for the link
If you provide no attributes, the shortcode returns a link to a user's profile page with the anchor text "your profile", no tool-tip title and no icon.
can be used to display a custom icon or an icon from the plugin's default icon set. Accepted values are activity, friends, messages, profile, edit-profile, avatar and settings or any URL to an image.
To link to a logged in user's activity page:
[buddylink bmlink="activity" bltext="your activity page"]
To link to a logged in user's message inbox:
[buddylink bmlink="messages/inbox" bltext="view your inbox"]
To link to a logged in user's message inbox with an icon accompanying the link:
[buddylink bmlink="messages/inbox" bltext="view your inbox" blicon="messages"]
There are three options for controlling what non logged in users see:
blolink=""for setting the link
blotitle=""for setting the title
blotext=""for setting the anchor text
By default, a non logged in user will see a link to your site's login/registration page. To change that destination you could do something like this:
[buddylink bmlink="messages/inbox" bltext="view your inbox" blolink="http://example.com/reasons-to-register" blotext="reasons to register"]
BuddyLinks has quicklinks built into it to facilitate quick placement of links to common BuddyPress areas.
Used with the [buddylink] shortcode, the options are:
blq="act"to link to 'activity'
blq="for"to link to 'forums'
blq="fri"to link to 'friends'
blq="msg"to link to 'messages'
blq="pro"to link to 'profile'
blq="edpro"to link to 'edit profile'
blq="chav"to link to 'change avatar'
blq="set"to link to 'settings'
Quicklinks can be used in conjuction with the blicon="" attribute.
To link to a user's activity page:
To link to a user's activity page and print a custom message to non logged in users:
[buddylink blq="act" blotext="You can't go here because you're not logged in!"]
QuickLinks do not accept custom title and link attributes except for those intended for non logged in users.
I'm getting a space between the BuddyLink and my punctuation marks, why is this?
This is a known bug with BuddyLinks. I am working on a fix. In the meantime, put the punctuation (fullstop, period, comma) in the bltext="" attribute. For example,
bltext="click here." instead of
[General support]http://journalxtra.com/websiteadvice/wordpress/use-buddypress-dynamic-links-in-your-network-with-buddymenu-buddylinks/ and [Commercial support]http://vizred.com/
Requires: 3.0 or higher
Compatible up to: 3.7.1
Last Updated: 2013-10-25
1 of 5 support threads in the last two months have been resolved.
Got something to say? Need help?