BuddyPress BuddyLinks does three things really well:
- BuddydMenu BuddyPress menu widget.
- BuddyMenu BuddyPress menu shortcode.
- BuddyLinks BuddyPress dynamic link shortcode.
Put a BuddyPress menu or dynamic user link in your sidebar, post, page, widget, footer or anywhere else. Needs BuddyPress to work. There is no need to network activate in WP Multisite. Does not display to logged out users.
BuddyPress menus are dynamic. Their URLs change for each logged in user. This makes it difficult for most community admins and webmasters to add links to areas in their BuddyPress sites. Unless you know how, you can’t create a welcome page and send new users to their profile page with a link in the welcome page because the link will be different for each user.
For example, a link to a user’s own activity stream would look like http://example.com/members/[USERNAME]/activity/.
The [USERNAME] bit of the URL is added dynamically by BuddyPress. This means you need to use pictures, videos, diagrams and lots of text to send people to different locations within a BP site or you can use the widget and shortcodes this BuddyMenu BuddyLinks provides.
See ‘Other Notes’ section usage guide.
The BuddyMenu Widget displays the main BP menus items:
- Edit Profile
- Change Avatar
- Custom Links
BuddyMenu Widget’s Features
- Choose which menu tabs to display.
1 Choose display order of menu tabs.
- Custom menu items.
- You can specify anchor text for each link.
- You can choose to display the menu as a vertical list or as a horizontal bar.
- The widget displays to those who are logged in only. Logged out users do not see the menu.
- Beautiful and stylish menu icons next to each menu link.
- Customize icons.
- Choose whether to display icons or not.
- Customize menu tab titles.
As easy to use as going to Appearance > Widgets and dragging the BuddyMenu widget into your sidebar or any other widget area.
BuddyMenu Shortcode displays the BuddyPress menus tabs. Being a shortcode, it can be embedded in any page or post. If you use Ultimate TinyMCE you can even put the shortcode in a widget.
The BuddyMenu Shortcode Features
- Configurable menu titles, just like the widget.
- Vertical or horizontal alignment.
- Menu items can be switched off.
- Menu icons can be enabled or disabled.
- Menu icons can be customized.
This is for adding single links within page and post content. Ideal for linking to a user’s profile, settings, personal activity stream or any other other BuddyPress page from within a post. For example, you’ve written a getting started guide for new members and you want to send them to upload an avatar; you can use the BuddyLinks shortcode to link to new users’ avatar upload page. The dynamic slug is created by BuddyLinks.
- In context BuddyPress linking.
- Ease of use.
- Link title and link anchor configuration.
- Quick links to each of the 8 pages found in the BuddyMenus.
- Configurable text for logged out visitors – tell them to login to follow the link or make the text non-clickable.
- Icons can be added to links. Use shortcode attributes to use icons from the default icon set or use a URL to a custom icon.
- Go to Appearance > Settings
- Find the BuddyMenu widget
- Drag it into a widget area
- Configure the menus to display, their titles, their icons and whether to display the menu horizontally or vertically.
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.
- `bmedproi=”” sets the edit profile icon.
- `bmchavi=”” sets the change avatar icon.
bmseti="" sets the settings icon.
- `bmicons=”0″ Disables all icons.
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.
blicon="" 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.